# Integração Cadastro de Solicitantes (Locais - CodLoc) com o ERP Senior.

Esta integração permite que os cadastros de locais (codLoc) sejam replicados do ERP Senior para a plataforma. <u>Esta integração é aplicável apenas para empresas que utilizarão a plataforma para gerenciar as manutenções internas.</u>

<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:** <span style="color: #808080;">`http://example.com/g5-senior-services/sapiens_Synccom_senior_g5_co_mct_pat_localizacaobem?wsdl`</span>

**Porta:** Exportar

**Documentação Senior:** [Clique aqui! ](https://documentacao.senior.com.br/gestaoempresarialerp/5.10.1/webservices/com_senior_g5_co_mct_pat_localizacaobem.htm "Documentação Integração Cadastro de Locais 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. O WebService é nativo e não necessita de ativação no ERP.

***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 “Solicitantes - Setor”;
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:** 38

**Vendor:** 3

**Status:** 1

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

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

**Comportamento do WebService:** O cliente é único para todas as empresas e filiais no ERP. Para poder utilizar um cliente é necessário vincular (conectar) a empresa e filial. Apenas os clientes conectados a empresa e filial serão integrados.

**Comportamento da plataforma:** Todo cliente integrado gerará um solicitante dentro da filial sincronizada.

Exemplo: Se um cliente estiver vinculado em 10 filiais no ERP a plataforma irá gerar um solicitante embaixo de cada filial integrada.

<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; text-align: justify;">ID ERP da Empresa.<span style="text-decoration: underline;"> A integração deverá ser rodada para todas as empresas configuradas no SISMETRO.</span></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: 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: 657px;"><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;">codFil</td><td style="width: 35.8643%; height: 31px;">ID ERP da filial.

<span style="text-decoration: underline;">Quando for codFil = 0 deverá ser registrado um codFil para cada filial. </span>

</td><td style="width: 19.2901%; height: 31px;">Não.</td><td style="width: 22.1296%; height: 31px;">Cadastro -&gt; Solicitante.</td></tr><tr style="height: 31px;"><td style="width: 22.716%; height: 31px;">codLoc</td><td style="width: 35.8643%; height: 31px;">ID ERP do solicitante.</td><td style="width: 19.2901%; height: 31px;">Não.</td><td style="width: 22.1296%; height: 31px;">Cadastro -&gt; Solicitante.</td></tr><tr style="height: 31px;"><td style="width: 22.716%; height: 31px;">nomLoc</td><td style="width: 35.8643%; height: 31px;">Razão social do solicitante.</td><td style="width: 19.2901%; height: 31px;">Sim.</td><td style="width: 22.1296%; height: 31px;">Cadastro -&gt; Solicitante.</td></tr><tr style="height: 31px;"><td style="width: 22.716%; height: 31px;">desLoc</td><td style="width: 35.8643%; height: 31px;">Mais informações.</td><td style="width: 19.2901%; height: 31px;">Sim.</td><td style="width: 22.1296%; height: 31px;">Cadastro -&gt; Solicitante.</td></tr><tr style="height: 31px;"><td style="width: 22.716%; height: 31px;">-</td><td style="width: 35.8643%; height: 31px;">CNPJ.\*

</td><td style="width: 19.2901%; height: 31px;">Sim.</td><td style="width: 22.1296%; height: 31px;">Cadastro -&gt; Solicitante.</td></tr><tr style="height: 60px;"><td style="width: 22.716%; height: 60px;">-</td><td style="width: 35.8643%; height: 60px;">Tipo do solicitante (Pessoa física, jurídica ou setor).   
Registrar = 2 (Setor)

</td><td style="width: 19.2901%; height: 60px;">Sim.</td><td style="width: 22.1296%; height: 60px;">Cadastro -&gt; Solicitante.</td></tr><tr style="height: 31px;"><td style="width: 22.716%; height: 31px;">-</td><td style="width: 35.8643%; height: 31px;">CEP do solicitante.\*</td><td style="width: 19.2901%; height: 31px;">Sim.</td><td style="width: 22.1296%; height: 31px;">Cadastro -&gt; Solicitante.</td></tr><tr style="height: 31px;"><td style="width: 22.716%; height: 31px;">-</td><td style="width: 35.8643%; height: 31px;">Endereço do solicitante.\*</td><td style="width: 19.2901%; height: 31px;">Sim.</td><td style="width: 22.1296%; height: 31px;">Cadastro -&gt; Solicitante.</td></tr><tr style="height: 31px;"><td style="width: 22.716%; height: 31px;">-</td><td style="width: 35.8643%; height: 31px;">CEP do solicitante.\*</td><td style="width: 19.2901%; height: 31px;">Sim.</td><td style="width: 22.1296%; height: 31px;">Cadastro -&gt; Solicitante.</td></tr><tr style="height: 31px;"><td style="width: 22.716%; height: 31px;">-</td><td style="width: 35.8643%; height: 31px;">Endereço do solicitante.\*</td><td style="width: 19.2901%; height: 31px;">Sim.</td><td style="width: 22.1296%; height: 31px;">Cadastro -&gt; Solicitante.</td></tr><tr style="height: 31px;"><td style="width: 22.716%; height: 31px;">-</td><td style="width: 35.8643%; height: 31px;">Número do solicitante.\*</td><td style="width: 19.2901%; height: 31px;">Sim.</td><td style="width: 22.1296%; height: 31px;">Cadastro -&gt; Solicitante.</td></tr><tr style="height: 31px;"><td style="width: 22.716%; height: 31px;">-</td><td style="width: 35.8643%; height: 31px;">Bairro do solicitante.\*</td><td style="width: 19.2901%; height: 31px;">Sim.</td><td style="width: 22.1296%; height: 31px;">Cadastro -&gt; Solicitante.</td></tr><tr style="height: 60px;"><td style="width: 22.716%; height: 60px;">-</td><td style="width: 35.8643%; height: 60px;">Complemento do endereço do solicitante.\*

</td><td style="width: 19.2901%; height: 60px;">Sim.</td><td style="width: 22.1296%; height: 60px;">Cadastro -&gt; Solicitante.</td></tr><tr style="height: 31px;"><td style="width: 22.716%; height: 31px;">-</td><td style="width: 35.8643%; height: 31px;">Email do solicitante.\*</td><td style="width: 19.2901%; height: 31px;">Sim.</td><td style="width: 22.1296%; height: 31px;">Cadastro -&gt; Solicitante.</td></tr><tr style="height: 36px;"><td style="width: 22.716%; height: 36px;">-</td><td style="width: 35.8643%; height: 36px;">Fone do solicitante.\*

</td><td style="width: 19.2901%; height: 36px;">Sim.</td><td style="width: 22.1296%; height: 36px;">Cadastro -&gt; Solicitante.</td></tr><tr style="height: 36px;"><td style="width: 22.716%; height: 36px;">-</td><td style="width: 35.8643%; height: 36px;">Código IBGE do solicitante.\*

</td><td style="width: 19.2901%; height: 36px;">Sim.</td><td style="width: 22.1296%; height: 36px;">Cadastro -&gt; Solicitante.</td></tr><tr style="height: 31px;"><td style="width: 22.716%; height: 31px;">-</td><td style="width: 35.8643%; height: 31px;">Cidade do solicitante.\*

</td><td style="width: 19.2901%; height: 31px;">Sim.</td><td style="width: 22.1296%; height: 31px;">Cadastro -&gt; Solicitante.</td></tr><tr style="height: 31px;"><td style="width: 22.716%; height: 31px;">-</td><td style="width: 35.8643%; height: 31px;">Estado do solicitante.\*

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

\* Capturar os dados do cadastro da filial do solicitante.

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

<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-"></div>