Ir para o conteúdo principal

Integração Cadastro de Solicitantes (Clientes) com o ERP Senior.

Esta integração permite que os cadastros de solicitantes (clientes) sejam replicados do ERP Senior para a plataforma.

Esta integração é aplicável apenas para empresas que utilizarão a plataforma para gerenciar a prestação de serviços para seus clientes.

MÓDULO

Gestão Inteligente de Manutenção

ESPECIFICAÇÕES TÉCNICAS

Sentido: Mão única ERP Senior -> UPSIM

Consulta: UPSIMPlataforma consome WS para receber cadastros pendentes de sincronia

ChaveMecanismo: de unicidade no ERP: XML

Chave de unicidade na plataforma:WSDL: ID único para a unidadehttp://example.com/g5-senior-services/sapiens_Synccom_senior_g5_co_cad_clientes

Comportamento do WS: Todos os clientes conectados na empresa são exportados

Gatilhos de consulta:Porta: UPSIM consome o WS periodicamente (por tempo) ou quando solicitado via tela

Mecanismo: XMLExportar_3

Documentação Senior: Clique aqui! 

PROCEDIMENTO CLIENTE

EXECUTAR ESTE PROCEDIMENTO EM TODAS AS FILIAS QUE SERÃO INTEGRADAS.

 

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. No menu principal clique “Cadastro”;

  2. Clique em “Integrações”;

  3. Clique em “Configurações de Tipos de Informações” (Código da Tela: F000SXT);

  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 “Cliente";

  9. Clique em “Mostrar”;

  10. Marque o check box da linha “Tipo de Informação” com a descrição “Cliente”;

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

 

Cliente.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: F000CWS);

  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.clientes”;

  13. No campo “Porta” selecione a opção “Exportar”;

  14. 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”.

 

clientes-configuracao.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;

  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çãopela integração no ERP Senior;

  6. EmpresaListagem cadastradade noempresas ERPe Senior;

    filiais
que serão

Filial cadastrada no ERP Senior;integradas;

URL dos 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

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 “Cliente”Cliente Heroku”;

  5. Selecione o Vendor/ERP “Senior”;

  6. Insira a Sigla "UPSIM";

  7. Insira oa códigoURL dado empresacliente (informadono pelo cliente);

Insira o código da filial (informado pelo cliente);

Insira ocampo EndPoint WebService. Exemplo:

https://web03.senior.com.br:39301/g5-senior-services/sapiens_Synccom_senior_g5_co_int_varejo_clientes39301

Insira a EndPoint Confirmação. Exemplo:

https://web03.senior.com.br:39301/g5-senior-services/sapiens_Synccom_senior_g5_co_int_geral_exportacao39301

Insira o EndPoint UPSIM. Exemplo:

http://dev.sismetro.com:5000

Insira as observações da integração;

Selecione o tipo da integração: “Total”;

Ative a opção “Registrar Logs”;

Clique em “Salvar”.

Observações

  • SubstituirNão é necessário inserir o inícioEndPoint no final da URL pelos dados fornecidos pelo clienteURL;
  • 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".

DúvidasGATILHOS DE EXECUÇÃO DO SERVIÇO

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

VALIDAÇÃO DE EXECUÇÃO DE SERVIÇO

Configuração da integração na unidade

Tipo da integração: 23 

Vendor: 3

Status: 1

CHAVE DE UNICIDADE DE REGISTRO

Chave de unicidade no ERP: codCli

Chave de unicidade na plataforma: unit + codEmp + codFil + codCli

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

PARÂMETROS DE REQUISIÇÃO

DúvidaParâ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

Configurações -> Empresa

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

CodFil ID ERP da Filial

Configurações -> Filial

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 Bens.CodBem ID ERP do patrimônio. Não. Cadastro -> Patrimônio. Bens.DesBem Observação. Sim. Cadastro -> Patrimônio. Bens.DatAqi Data da compra. Sim. Cadastro -> Patrimônio. Bens.FilLoc

Filial e solicitante.

 

O patrimônio será atribuído ao solicitante padrão selecionado nas configurações da filial retornada neste parâmetro. Caso o atributo retorne vazio, o patrimônio será atribuído ao solicitante padrão da filial enviada na requisição (CodFil).

Sim. Apenas quando houver alteração de filial.  Cadastro -> Patrimônio. Bens.CodFor Fornecedor. Sim. Cadastro -> Patrimônio. Bens.CodSnf Série da Nota Fiscal de Entrada. Sim. Cadastro -> Patrimônio. Bens.NumDoc N° da nota. Sim. Cadastro -> Patrimônio. Bens.DatGar Garantia até. Sim. Cadastro -> Patrimônio. Bens.VlrBas Valor pago. Sim. Cadastro -> Patrimônio. Bens.DatBai

Data baixa.

 

Quando o patrimônio possuir data de baixa o status será alterado para 5 (Baixado) e motivo para 4 (Outro).

  Cadastro -> Patrimônio. Bens.CodCcu Centro de custo. Sim. Cadastro -> Patrimônio. Bens.ImgBem

Imagem.

Sim. Cadastro -> Patrimônio -> Galeria de fotos.

 

Detalhes.

 

Todos os parâmetros de usuários são salvos no campo detalhes no seguinte formato:

 

Nome do campo: Conteúdo

Nome do campo: Conteúdo

Sim. Cadastro -> Patrimônio.

CamposUsuario

CamposUsuario.campo

CamposUsuario.valor

Detalhes.

 

Todos os parâmetros de usuários são salvos no campo detalhes no seguinte formato:

 

Nome do campo: Conteúdo

Nome do campo: Conteúdo

Sim. Cadastro -> Patrimônio.  

Tipo de tecnologia.

 

O patrimônio possuirá o tipo de tecnologia inserido no parâmetro 1 na configuração da integração no cadastro da unidade.

Não. Cadastro -> Patrimônio.  

Categoria.

 

O patrimônio possuirá a categoria inserida no campo no parâmetro 2 na configuração da integração no cadastro da unidade.

Não. Cadastro -> Patrimônio.  

Usuário.

 

Todos os patrimônios serão lançados como usuário rotina automática ID 10.

Sim. Cadastro -> Patrimônio.  

Marca.

 

Todos os patrimônios serão lançados como sem marca ID 1.

 

Regra válida apenas para inclusões cadastrais, edições não geram alterações neste campo.

Não Cadastro -> Patrimônio.  

Modelo.

 

Todos os patrimônios serão lançados como sem modelo ID 1.

 

Regra válida apenas para inclusões cadastrais, edições não geram alterações neste campo.

Não. Cadastro -> Patrimônio.  

Gravidade.

 

Todos os patrimônios receberão gravidade ID 1 (Sem gravidade).

Não. Cadastro -> Patrimônio.

 

 

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?

Sim.Não. O WebService necessitadeverá estar publicado e visível na na web.  -

É possível liberar apenaspara os domínios dos servidoresIP da plataformaplataforma. para consumir o WebService?

Sim. Se o firewall permitirSolicite a liberaçãoequipe porde domíniosuporte oa usuáriolistagem deverá liberar os seguintes domínios:

 

dev.sismetro.com

br.sismetro.com 

-

É possível liberar apenas os IP´s dos servidores da plataforma para consumir o WebService?

Não. A plataforma é hospedada em servidores na AWS e não possuemde IP fixo. Portanto não é possível liberar o consumo para IP´s específicos. 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. -

 

 

 

 

 

 

Voltar ao topo