# Integração Cadastro de Centro de Custos com o ERP Senior.

Esta integração permite que os cadastros de centro de custos sejam replicados do ERP Senior para a plataforma.

<p class="callout info">**MÓDULO**</p>

Gestão Inteligente de Manutenção.

<p class="callout info">**ESPECIFICAÇÕES TÉCNICAS**</p>

**Sentido:** Mão única ERP Senior -&gt; UPSIM

**Consulta:** Plataforma consome *WebService* para receber cadastros pendentes de sincronia

**Mecanismo:** XML

**WSDL:** `http://example.com/g5-senior-services/sapiens_Synccom_senior_g5_co_ger_cad_centrocusto?wsdl `

**Porta:** Exportar\_2

**Documentação Senior:** [Clique aqui! ](https://documentacao.senior.com.br/gestaoempresarialerp/5.8.10/#webservices/com_senior_g5_co_ger_cad_centrocusto.htm "Documentação Integração Cadastro de Centro de Custos com o ERP Senior")

<p class="callout info">**PROCEDIMENTO CLIENTE**</p>

***Cadastro do sistema integrado***

1. Cadastro do sistema integrado no ERP. Para mais informações. [Clique aqui!](https://doc.sismetro.com/books/erp-senior/page/cadastro-de-sistema-integrado-no-erp-senior "Cadastro de Sistema Integrado no ERP Senior")

<span style="text-decoration: underline;">EXECUTAR O PROCEDIMENTO ABAIXO EM TODAS AS FILIAS QUE SERÃO INTEGRADAS.</span>

***Configurações da integração no ERP***

1. No menu principal clique “Cadastro”;
2. Clique em “Integrações”;
3. Clique em “Configurações de Tipos de Informações” (Código da Tela:<u> F000SXT</u>);
4. No campo “Sistema” clique no ícone lupa;
5. A lista de sistemas integrados será exibida. Clique duas vezes na linha do cadastro do sistema UPSIM;
6. No campo “Filial” clique no ícone lupa;
7. A lista de filiais será exibida. Clique duas vezes na linha do cadastro da filial que deseja integrar;
8. No campo “Informação” selecione a opção “Centro Custo";
9. Clique em “Mostrar”;
10. Marque o *check box* da linha “Tipo de Informação” com a descrição “Centro Custos”;
11. Na coluna “Situação” insira “A”;
12. Tecle “Tab”;
13. O ERP emitirá a mensagem “Deseja Atribuir Valores Para os Itens Selecionados”; Clique na opção “Item atual”;
14. Clique em “Processar”;
15. O ERP emitirá mensagem “Processo realizado com sucesso”;
16. Clique em “OK”.

![](https://doc.sismetro.com/uploads/images/gallery/2019-12-Dec/scaled-840-0/image-1576249779305.png)

*Tela de configurações de tipos de informações (Código da Tela: F000SXT) no ERP Senior*

***Ativação do Web Service no ERP***

1. No menu principal clique “Cadastro”;
2. Clique em “Integrações”;
3. Clique em “Configuração de Web Service” (Código da Tela:<u> F000CWS</u>);
4. No campo “Código” digite “0”;
5. Tecla “Tab”;
6. No campo “Empresa” clique no ícone lupa;
7. A lista de empresas será exibida. Clique duas vezes na linha do cadastro da empresa desejada;
8. No campo “Filial” clique no ícone lupa;
9. A lista de filiais será exibida. Clique duas vezes na linha do cadastro da filial desejada;
10. No campo “Sistema” clique no ícone lupa;
11. A lista de sistemas integrados será exibida. Clique duas vezes na linha do cadastro do sistema UPSIM;
12. No campo “Web Service” selecione a opção “com.senior.g5.co.ger.cad.centrocusto”;
13. No campo “Porta” selecione a opção “Exportar2”;
14. Utilize a caixa *where* para implementar filtros para evitar a exportação de cadastros que não tem aplicação para a plataforma.   
      
    Exemplo 1:  
      
    No menu lateral “Campos Exportados Pelo Web Service” selecione todas as opções;
15. Clique em “Processar”;
16. O ERP emitirá mensagem “Confirmar o Processamento das Configurações do Web Service?”;
17. Clique “Sim”;
18. O ERP emitirá mensagem “Configurações do Web Service Gravadas com Sucesso”; Clique em “OK”.

![](https://doc.sismetro.com/uploads/images/gallery/2019-12-Dec/scaled-840-0/image-1576249072030.png)

*Tela de configuração de Web Service (Código da Tela: F000CWS) no ERP Senior*

***Ativação da Integração no UPSIM***

1. Solicite a equipe de suporte UPSIM que ative a integração;
2. Informe os seguintes os dados abaixo;
    
    
    1. Sigla do sistema no ERP Senior (deverá ser a mesma sigla cadastrada dentro do cadastro de sistemas integrados no ERP Senior);
    2. Usuário responsável Integração no ERP Senior;
    3. Password do usuário responsável pela integração no ERP Senior;
    4. Listagem de empresas e filiais que serão integradas (Nome e ID ERP);
    5. URL do Web Service de produção (Exemplo: `<a class="_2qJYG" href="https://web03.senior.com.br:39301/" rel="noreferrer noopener" target="_top">https://web03.senior.com.br:39301</a>`). Caso o usuário não tenha esta informação deve ser aberto um chamado na Senior solicitando a mesma.

<p class="callout info">**PROCEDIMENTO EQUIPE SUPORTE**</p>

***Cadastramento das empresas e filiais na plataforma***

1. Acesse as configurações da unidade (Menu engrenagem);
2. Cadastre as empresas e filiais que serão integradas. Somente empresas e filiais com ID ERP serão integradas;
3. Cliquem em "salvar".

***Ativar a integração na plataforma***

1. Acesse o cadastro da unidade do cliente;
2. Clique em “Integrações”;
3. Clique em “Adicionar”;
4. Selecione o tipo de integração “Centro Custo”;
5. Selecione o Vendor/ERP “Senior”;
6. Insira a Sigla "UPSIM";
7. Insira a URL do cliente no campo EndPoint WebService. Exemplo:   
      
    `<a href="https://web03.senior.com.br:39301/g5-senior-services/sapiens_Synccom_senior_g5_co_int_varejo_clientes">https://web03.senior.com.br:39301</a>`
8. Insira a URL do cliente no campo EndPoint Confirmação. Exemplo:   
      
    `<a href="https://web03.senior.com.br:39301/g5-senior-services/sapiens_Synccom_senior_g5_co_int_geral_exportacao">https://web03.senior.com.br:39301</a>`
9. Insira o EndPoint UPSIM. Exemplo:   
      
    `<a class="_2qJYG" href="http://dev.sismetro.com:5000/" rel="noreferrer noopener" target="_top">http://dev.sismetro.com:5000</a>`
10. Insira as observações da integração;
11. Selecione o tipo da integração: “Total”;
12. Ative a opção “Registrar Logs”;
13. Clique em “Salvar”.

*Observações*

- Não é necessário inserir o EndPoint no final da URL;
- A primeira sincronia com o ERP deverá ser realizada com o tipo de integração“Total” ativada. Após a sincronia total ser realizada a integração deverá ser alterada para "Parcial".

<p class="callout info">**GATILHOS DE EXECUÇÃO DO SERVIÇO**</p>

**Temporal:** O serviço é executado a cada 2 (Duas) horas.

<p class="callout info">**VALIDAÇÃO DE EXECUÇÃO DA INTEGRAÇÃO**</p>

**Tipo da integração:** 25

**Vendor:** 3

**Status:** 1

<p class="callout info">**CHAVE DE UNICIDADE DE REGISTRO**</p>

**Chave de unicidade no ERP:** codCcu

**Chave de unicidade na plataforma:** unit + codCcu

**Chave de unicidade de conexão com empresa no ERP:** codCcu + codEmp

**Chave de unicidade de conexão de centro custo com empresa na plataforma:** unit + codEmp + codCcu

**Comportamento do WebService:** O centro de custo é único para todas as empresas e filiais no ERP. Para poder utilizar um centro de custo é necessário vincular (conectar) a empresa. Apenas os centro de custos conectados a empresa serão integrados. Se um mesmo centro de custo estiver conectado em várias empresas o mesmo será exportado em todas elas.

**Comportamento da plataforma:** O centro de custo (codCcu) é cadastrado na tabela de centros de custo e vinculado a empresa correspondente.

<p class="callout info">**PARÂMETROS DE REQUISIÇÃO**</p>

<table border="1" id="bkmrk-par%C3%A2metro-de-requis" style="border-collapse: collapse; width: 100%; height: 244px;"><tbody><tr style="height: 31px;"><td style="width: 24.074%; height: 31px;">**Parâmetro de Requisição**</td><td style="width: 37.8396%; height: 31px;">**Campo**</td><td style="width: 38.0864%; height: 31px;">**Tela**</td></tr><tr style="height: 31px;"><td style="width: 24.074%; height: 31px;">user</td><td style="width: 37.8396%; height: 31px;">Usuário.</td><td style="width: 38.0864%; height: 31px;">Cadastro unidade -&gt; Integrações.</td></tr><tr style="height: 31px;"><td style="width: 24.074%; height: 31px;">password</td><td style="width: 37.8396%; height: 31px;">Password.</td><td style="width: 38.0864%; height: 31px;">Cadastro unidade -&gt; Integrações.</td></tr><tr style="height: 31px;"><td style="width: 24.074%; height: 31px;">IdentificacaoSistema</td><td style="width: 37.8396%; height: 31px;">Sigla.</td><td style="width: 38.0864%; height: 31px;">Cadastro unidade -&gt; Integrações.</td></tr><tr style="height: 31px;"><td style="width: 24.074%; height: 31px;">CodEmp</td><td style="width: 37.8396%; height: 31px;">ID ERP da Empresa.</td><td style="width: 38.0864%; height: 31px;">Configurações -&gt; Empresa.

A integração será disparada para todas as empresas e filiais que possuírem idErp configurado.

</td></tr><tr style="height: 31px;"><td style="width: 24.074%; height: 31px;">CodFil</td><td style="width: 37.8396%; height: 31px;">ID ERP da Filial.</td><td style="width: 38.0864%; height: 31px;">Configurações -&gt; Filial.

A integração será disparada para a primeira filial que possuir idErp configurado. O parâmetro é obrigatório na requisição, porém não é aplicado como filtro.

</td></tr><tr style="height: 58px;"><td style="width: 24.074%; height: 58px;">TipoIntegracao</td><td style="width: 37.8396%; height: 58px;">Integrar total ou parcial.

(T = Todos, A = Somente Alterados).

</td><td style="width: 38.0864%; height: 58px;">Cadastro unidade -&gt; Integrações.

</td></tr></tbody></table>

<p class="callout info">**ATRIBUTOS DE RESPOSTA REGISTRADOS**</p>

<table border="1" id="bkmrk-par%C3%A2metro-de-respos" style="border-collapse: collapse; width: 100%; height: 492px;"><tbody><tr style="height: 31px;"><td style="width: 22.716%; height: 31px;">**Parâmetro de Resposta**</td><td style="width: 34.7532%; height: 31px;">**Campo**</td><td style="width: 13.858%; height: 31px;">**Atualização Cadastral**</td><td style="width: 28.6728%; height: 31px;">**Tela**</td></tr><tr style="height: 31px;"><td style="width: 22.716%; height: 31px;">centrosCusto.codCcu</td><td style="width: 34.7532%; height: 31px;">ID ERP do centro de custo.</td><td style="width: 13.858%; height: 31px;">Não.</td><td style="width: 28.6728%; height: 31px;">Cadastro -&gt; Centro do Custo.</td></tr><tr style="height: 31px;"><td style="width: 22.716%; height: 31px;">centrosCusto.abrCcu</td><td style="width: 34.7532%; height: 31px;">Nome do centro de custo.

Concatenar separado por traço centrosCusto.abrCcu - centrosCusto.desCcu

</td><td style="width: 13.858%; height: 31px;">Sim.</td><td style="width: 28.6728%; height: 31px;">Cadastro -&gt; Centro do Custo.</td></tr><tr style="height: 31px;"><td style="width: 22.716%; height: 31px;">centrosCusto.desCcu</td><td style="width: 34.7532%; height: 31px;">Nome do centro de custo.

Concatenar separado por traço centrosCusto.abrCcu - centrosCusto.desCcu

</td><td style="width: 13.858%; height: 31px;">Sim.</td><td style="width: 28.6728%; height: 31px;">Cadastro -&gt; Centro do Custo.</td></tr><tr><td style="width: 22.716%;">centrosCusto.anaSin</td><td style="width: 34.7532%; height: 31px;">Tipo do centro de custo.

1. Analítico;
2. Sintético;

</td><td style="width: 13.858%; height: 31px;">Sim.</td><td style="width: 28.6728%; height: 31px;">Cadastro -&gt; Centro de Custo.</td></tr><tr style="height: 31px;"><td style="width: 22.716%; height: 31px;">centrosCusto.ccuPai</td><td style="width: 34.7532%; height: 31px;">Centro de custo pai.

</td><td style="width: 13.858%; height: 31px;">Sim.</td><td style="width: 28.6728%; height: 31px;">Cadastro -&gt; Centro de custo.</td></tr><tr style="height: 31px;"><td style="width: 22.716%; height: 31px;">-</td><td style="width: 34.7532%; height: 31px;">Filial.

Filial enviada no parâmetro CodFil da requisição\*

Registro realizado em tabela de relacionamento centro de custo com filial.

</td><td style="width: 13.858%; height: 31px;">Sim.</td><td style="width: 28.6728%; height: 31px;">Cadastro -&gt; Centro de custo.</td></tr></tbody></table>

<p class="callout warning">**DÚVIDAS**</p>

\- As integrações Totais agendadas (que definimos pela configuração da integração manualmente) iniciam às 03h01, 11h01 e 19h01 todos os dias para este tipo de integração;  
\- As integrações de Alterações são iniciadas a cada 30 minutos, ou seja, elas são chamadas para execução a cada 30 minutos o que seguem até o fim da integração e param.   
\- Nas madrugadas de Domingo, Terça e Sexta, todas as integrações ativas desse tipo, exceto as que estão com "IgnoraTotal" no Parâmetro 4, são colocadas para rodar em Total e rodam uma integração total, inciando às 04h10 da manhã.

Cadastro de empresa deve possuir o ID SISMETRO da Filial Padrão no campo "ID Filial padrão para integração de Centro de Custo".

Este campo é apenas usado para a requisição, não sendo usado para armazenar no SISMETRO.

<table border="1" id="bkmrk-d%C3%BAvida-solu%C3%A7%C3%A3o-di" style="height: 165px; width: 808px;"><tbody><tr style="height: 29px;"><td style="width: 325.556px; height: 29px;">**Dúvidas**</td><td style="width: 408.889px; height: 29px;">**Solução**</td><td style="width: 72.2222px; height: 29px;">**Direito**</td></tr><tr style="height: 47px;"><td style="width: 325.556px; height: 47px; text-align: justify;">É necessário contatar a equipe de suporte da Senior para esta operação?</td><td style="width: 408.889px; height: 47px; text-align: justify;">Não. O usuário do ERP pode efetuar a operação sozinho.</td><td class="align-center" style="width: 72.2222px; height: 47px;">-</td></tr><tr style="height: 29px;"><td style="width: 325.556px; height: 29px; text-align: justify;">Esta documentação é válida para GO UP e ERP Full?

</td><td style="width: 408.889px; height: 29px; text-align: justify;">Sim. O procedimento é o mesmo para ambos.</td><td class="align-center" style="width: 72.2222px; height: 29px;">-</td></tr><tr><td style="width: 325.556px; text-align: justify;">É necessário reiniciar o servidor após efetuar o procedimento?

</td><td style="width: 408.889px; text-align: justify;">Não.</td><td class="align-center" style="width: 72.2222px;">-</td></tr><tr><td style="width: 325.556px; text-align: justify;">O WebService precisa estar visível para a web?

</td><td style="width: 408.889px; text-align: justify;">Não. O WebService deverá estar visível para os IP fixos da plataforma. Solicite a equipe de suporte a listagem de IP Fixo.</td><td class="align-center" style="width: 72.2222px;">-</td></tr><tr><td style="width: 325.556px; text-align: justify;">Ao excluir um cadastro no ERP o mesmo é replicado para a plataforma?

</td><td style="width: 408.889px; text-align: justify;">Não. Quando um cadastro é "excluído" do ERP não é gerado sincronia para a plataforma.</td><td class="align-center" style="width: 72.2222px;">-</td></tr></tbody></table>

<div id="bkmrk--1"></div>