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. Esta integração é aplicável apenas para empresas que utilizarão a plataforma para gerenciar as manutenções internas.

MÓDULO

Gestão Inteligente de Manutenção.

ESPECIFICAÇÕES TÉCNICAS

Sentido: Mão única ERP Senior -> 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_mct_pat_localizacaobem?wsdl

Porta: Exportar

Documentação Senior: Clique aqui! 

PROCEDIMENTO CLIENTE

Cadastro do sistema integrado

1. Cadastro do sistema integrado no ERP. Para mais informações. Clique aqui!

 

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: https://web03.senior.com.br:39301). Caso o usuário não tenha esta informação deve ser aberto um chamado na Senior solicitando a mesma.

PROCEDIMENTO EQUIPE SUPORTE

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:
   
   https://web03.senior.com.br:39301
   
   

8. Insira a URL do cliente no campo EndPoint Confirmação. Exemplo:
   
   https://web03.senior.com.br:39301
   
   

9. Insira o EndPoint UPSIM. Exemplo:
   
   http://dev.sismetro.com:5000
   
   

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".

GATILHOS DE EXECUÇÃO DO SERVIÇO

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

VALIDAÇÃO DE EXECUÇÃO DA INTEGRAÇÃO

Tipo da integração: 38 

Vendor: 3

Status: 1

CHAVE DE UNICIDADE DE REGISTRO

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.

PARÂMETROS DE REQUISIÇÃO

Parâmetro de Requisição	Campo	Tela
user	Usuário.	Cadastro unidade -> Integrações.
password	Password.	Cadastro unidade -> Integrações.
IdentificacaoSistema	Sigla.	Cadastro unidade -> Integrações.
CodEmp	ID ERP da Empresa. A integração deverá ser rodada para todas as empresas configuradas no SISMETRO.	Configurações -> Empresa. A integração será disparada para todas as empresas e filiais que possuírem idErp configurado.
TipoIntegracao	Integrar total ou parcial. (T = Todos, A = Somente Alterados).	Cadastro unidade -> Integrações.

ATRIBUTOS DE RESPOSTA REGISTRADOS

Parâmetro de Resposta	Campo	Atualização Cadastral	Tela
codFil	ID ERP da filial. Quando for codFil = 0 deverá ser registrado um codFil para cada filial.	Não.	Cadastro -> Solicitante.
codLoc	ID ERP do solicitante.	Não.	Cadastro -> Solicitante.
nomLoc	Razão social do solicitante.	Sim.	Cadastro -> Solicitante.
desLoc	Mais informações.	Sim.	Cadastro -> Solicitante.
-	CNPJ.*	Sim.	Cadastro -> Solicitante.
-	Tipo do solicitante (Pessoa física, jurídica ou setor). Registrar = 2 (Setor)	Sim.	Cadastro -> Solicitante.
-	CEP do solicitante.*	Sim.	Cadastro -> Solicitante.
-	Endereço do solicitante.*	Sim.	Cadastro -> Solicitante.
-	CEP do solicitante.*	Sim.	Cadastro -> Solicitante.
-	Endereço do solicitante.*	Sim.	Cadastro -> Solicitante.
-	Número do solicitante.*	Sim.	Cadastro -> Solicitante.
-	Bairro do solicitante.*	Sim.	Cadastro -> Solicitante.
-	Complemento do endereço do solicitante.*	Sim.	Cadastro -> Solicitante.
-	Email do solicitante.*	Sim.	Cadastro -> Solicitante.
-	Fone do solicitante.*	Sim.	Cadastro -> Solicitante.
-	Código IBGE do solicitante.*	Sim.	Cadastro -> Solicitante.
-	Cidade do solicitante.*	Sim.	Cadastro -> Solicitante.
-	Estado do solicitante.*	Sim.	Cadastro -> Solicitante.

* Capturar os dados do cadastro da filial do solicitante. 

DÚVIDAS

Dúvidas	Solução	Direito
É necessário contatar a equipe de suporte da Senior para esta operação?	Não. O usuário do ERP pode efetuar a operação sozinho.	-
Esta documentação é válida para GO UP e ERP Full?	Sim. O procedimento é o mesmo para ambos.	-
É necessário reiniciar o servidor após efetuar o procedimento?	Não.	-
O WebService precisa estar visível para a web?	Não. O WebService deverá estar visível para os IP fixos da plataforma. Solicite a equipe de suporte a listagem de IP Fixo.	-
Ao excluir um cadastro no ERP o mesmo é replicado para a plataforma?	Não. Quando um cadastro é "excluído" do ERP não é gerado sincronia para a plataforma.	-