# Integração de Serviços com o ERP Senior

Esta integração permite que os cadastros de serviços 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; Plataforma

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

***Mecanismo:*** XML

**WSDL:** http://example.com/g5-senior-services/sapiens\_Synccom\_senior\_g5\_co\_cad\_servicos?wsdl

**Porta:** Exportar

**Documentação Senior:** [Clique aqui! ](https://documentacao.senior.com.br/gestaoempresarialerp/5.8.11/#webservices/com_senior_g5_co_cad_servicos_exportar.htm "Documentação Integração Cadastro de Serviços 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")

***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 “Serviços";
9. Clique em “Mostrar”;
10. Marque o *check box* da linha “Tipo de Informação” com a descrição “Serviços”;
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”.

[![servicos-2.png](https://doc.sismetro.com/uploads/images/gallery/2019-11-Nov/scaled-840-0/servicos-2.png)](https://doc.sismetro.com/uploads/images/gallery/2019-11-Nov/servicos-2.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.cad.servicos”;
13. No campo “Porta” selecione a opção “Exportar”;
14. Utilize a caixa *where* para implementar filtros para evitar a exportação de cadastros que não tem aplicação para a plataforma.
15. No menu lateral “Campos Exportados Pelo Web Service” selecione todas as opções.
16. Clique em “Processar”;
17. O ERP emitirá mensagem “Confirmar o Processamento das Configurações do Web Service?”;
18. Clique “Sim”;
19. O ERP emitirá mensagem “Configurações do Web Service Gravadas com Sucesso”; Clique em “OK”.

[![SERVICOS-1.png](https://doc.sismetro.com/uploads/images/gallery/2019-11-Nov/scaled-840-0/SERVICOS-1.png)](https://doc.sismetro.com/uploads/images/gallery/2019-11-Nov/SERVICOS-1.png)

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

***Ativação da Integração na Plataforma***

1. Solicite a equipe de suporte da que ative a integração;
2. Informe os seguintes os dados abaixo;
3. Sigla do sistema no ERP Senior (deverá ser a mesma sigla cadastrada dentro do cadastro de sistemas integrados no ERP Senior);
4. Usuário responsável Integração no ERP Senior;
5. Password do usuário responsável Integração no ERP Senior;
6. Empresa cadastrada no ERP Senior;
7. Filial cadastrada no ERP Senior;
8. URL dos 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>

***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 “Serviços”;
5. Selecione o Vendor/ERP “Senior”;
6. Insira a Sigla "UPSIM";
7. Insira o código da empresa (informado pelo cliente);
8. Insira o código da filial (informado pelo cliente);
9. Insira o EndPoint WebService. 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>`
10. Insira a 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>`
11. Insira o EndPoint da plataforma. Exemplo:  
      
    `<a class="_2qJYG" href="http://dev.sismetro.com:5000/" rel="noreferrer noopener" target="_top">http://dev.sismetro.com:5000</a>`
12. Insira as observações da integração;
13. Selecione o tipo da integração: “Total”;
14. Ative a opção “Registrar Logs”;
15. Clique em “Salvar”.

*Observações*

- Substituir o início da URL pelos dados fornecidos pelo cliente
- 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 DO SERVIÇO**</p>

**Tipo de integração:** 24

**Vendor:** 3

<span style="font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Oxygen, Ubuntu, Roboto, Cantarell, 'Fira Sans', 'Droid Sans', 'Helvetica Neue', sans-serif; font-size: 15px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400;">**Status:** 1</span>

<span style="font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Oxygen, Ubuntu, Roboto, Cantarell, 'Fira Sans', 'Droid Sans', 'Helvetica Neue', sans-serif; font-size: 15px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400;">A chamada será realizada para o endpoint configurado no cadastro da integração.</span>

<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: 186px;"><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;">Cadastro unidade -&gt; Integrações</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;">Cadastro unidade -&gt; Integrações</td></tr><tr><td style="width: 24.074%;">TipoIntegracao</td><td style="width: 37.8396%;">Integrar total ou parcial

(T = Todos, A = Somente Alterados).

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

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

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

**Chave de unicidade no ERP:** codEmp + codSer  
  
**Chave de unicidade na plataforma:** unit + codEmp + codSer

**Comportamento do WS:** Todos os serviços da empresa serão exportados

<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: 186px;"><tbody><tr style="height: 31px;"><td style="width: 22.716%; height: 31px;">**Parâmetro de Resposta**</td><td style="width: 35.8643%; height: 31px;">**Campo**</td><td style="width: 19.2901%; height: 31px;">**Atualização Cadastral**</td><td style="width: 22.1296%; height: 31px;">**Tela**</td></tr><tr style="height: 31px;"><td style="width: 22.716%; height: 31px;">codSer</td><td style="width: 35.8643%; height: 31px;">ID no ERP.</td><td style="width: 19.2901%; height: 31px;">Sim.</td><td style="width: 22.1296%; height: 31px;">Cadastro -&gt; Patrimônio.</td></tr><tr style="height: 31px;"><td style="width: 22.716%; height: 31px;">desSer</td><td style="width: 35.8643%; height: 31px;">Nome do Serviço</td><td style="width: 19.2901%; height: 31px;">Sim.</td><td style="width: 22.1296%; height: 31px;">Cadastro -&gt; Patrimônio.</td></tr><tr style="height: 31px;"><td style="width: 22.716%; height: 31px;">obsSer</td><td style="width: 35.8643%; height: 31px;">Observações.</td><td style="width: 19.2901%; height: 31px;">Sim.</td><td style="width: 22.1296%; height: 31px;">Cadastro -&gt; Patrimônio.</td></tr><tr style="height: 31px;"><td style="width: 22.716%; height: 31px;"> </td><td style="width: 35.8643%; height: 31px;">Categoria.

Será atribuído ao serviço o ID da categoria configurada no "Parâmetro 1" da integração de serviços no cadastro da unidade.

</td><td style="width: 19.2901%; height: 31px;">Sim.</td><td style="width: 22.1296%; height: 31px;">Cadastro -&gt; Patrimônio.</td></tr><tr><td style="width: 22.716%;"> </td><td style="width: 35.8643%; height: 31px;">Ocupação/Função.

Será atribuído ao serviço o ID da ocupação/função configurada no "Parâmetro 2" da integração de serviços no cadastro da unidade.

</td><td style="width: 19.2901%; height: 31px;">Sim.</td><td style="width: 22.1296%; height: 31px;">Cadastro -&gt; Patrimônio.</td></tr></tbody></table>

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

<table border="1" id="bkmrk-d%C3%BAvida-solu%C3%A7%C3%A3o-di" style="height: 525px; width: 808px;"><tbody><tr style="height: 29px;"><td style="width: 326px; height: 29px;">**Dúvida**</td><td style="width: 397px; height: 29px;">**Solução**</td><td style="width: 84px; height: 29px;">**Direito**</td></tr><tr style="height: 47px;"><td style="width: 326px; height: 47px; text-align: justify;">É necessário contatar a equipe de suporte da Senior para esta operação?</td><td style="width: 397px; 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: 84px; height: 47px;">-</td></tr><tr style="height: 29px;"><td style="width: 326px; height: 29px; text-align: justify;">Esta documentação é válida para GO UP e ERP Full?

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

</td><td style="width: 397px; height: 60px; text-align: justify;">Não.</td><td class="align-center" style="width: 84px; height: 60px;">-</td></tr><tr style="height: 60px;"><td style="width: 326px; height: 60px; text-align: justify;">Ao excluir um cadastro no ERP o mesmo é replicado para a plataforma?

</td><td style="width: 397px; height: 60px; 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: 84px; height: 60px;">-</td></tr><tr style="height: 50px;"><td style="width: 326px; height: 50px; text-align: justify;">É obrigatório implementar um *where*?

</td><td style="width: 397px; height: 50px; text-align: justify;">Não, porém é altamente recomendado para evitar a exportação de cadastros desnecessários.</td><td class="align-center" style="width: 84px; height: 50px;">-</td></tr></tbody></table>

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