Ir para o conteúdo principal

Integração Pedido por Transação com SS Existente com o ERP Senior.

Esta integração permite que os pedidos no ERP Senior que possuem determinada transação (produto e/ou serviço) e que estão vinculados a uma SS (no ERP) sejam integrados na plataforma SISMETRO. Cada pedido integrado será vinculado a SS correspondente.

MÓDULO

Gestão Inteligente de Manutenção.

ESPECIFICAÇÕES TÉCNICAS

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

Consulta: Plataforma consome WebService para obter os itens dos pedidos.

Mecanismo: XML

WSDL: http://example.com/g5-senior-services/sapiens_Synccom_senior_g5_co_mcm_ven_pedidos?wsdl

Porta:
ExportarPedidos

Documentação Senior: Clique aqui! 

PROCEDIMENTO CLIENTE

Cadastro do sistema integrado

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

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

 

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

  9. Clique em “Mostrar”;

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

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

 

 

Tela de configurações de tipos de informações (Código da Tela: F000SXT) 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. Código da transação de produto (ID ERP) que deverá abrir SS no SISMETRO. TODOS OS PEDIDOS COM ESSA TRANSAÇÃO GERARÃO SS NO SISMETRO;
    6. Código da transação de serviço (ID ERP) que deverá abrir SS no SISMETRO. TODOS OS PEDIDOS COM ESSA TRANSAÇÃO GERARÃO SS NO SISMETRO;
    7. Nome do campo de usuário retornado no atributo "dadosGerais.usuario.cmpUsu" que corresponde ao ID da SS retornado no campo "dadosGerais.usuario.vlrUsu";
    8. 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 “Pedidos Obter Itens”;

  5. Selecione o Vendor/ERP “Senior”;

  6. Insira o "Usuário" e "Password";
  7. Insira a Sigla "UPSIM";

  8. Insira no "parâmetro 1" o ID da transação de produto que abrirá SS. TODOS OS PEDIDOS COM ESSA TRANSAÇÃO GERARÃO SS NO SISMETRO;
  9. Insira no "parâmetro 2" o ID da transação de serviço que abrirá SS. TODOS OS PEDIDOS COM ESSA TRANSAÇÃO GERARÃO SS NO SISMETRO;
  10. Insira no "parâmetro 3" o nome do campo de usuário retornado no atributo "dadosGerais.usuario.cmpUsu" que corresponde ao ID da SS retornado no campo "dadosGerais.usuario.vlrUsu";
  11. Insira a URL do cliente no campo EndPoint WebService. Exemplo:

    https://web03.senior.com.br:39301

  12. Insira a URL do cliente no campo EndPoint Confirmação. Exemplo:

    https://web03.senior.com.br:39301

  13. Insira o EndPoint UPSIM. Exemplo:

    http://dev.sismetro.com:5000

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

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

  16. Ative a opção “Registrar Logs”;

  17. 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 5 (Cinco) minutos.

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

Tipo da integração: 31

Vendor: 3

Status: 1

CHAVE DE UNICIDADE DE REGISTRO

Chave de unicidade no ERP: ID da SS retornando no campo de usuário.

Chave de unicidade na plataforma: ID da SS.

Comportamento do WebService: O pedido é único por empresa e filial. O WS exporta todos os itens do pedido requisitado.

Comportamento da plataforma: O integrador consulta no WS todos os pedidos e vincula os pedidos que possuem uma SS registrada no campo de usuário correspondente (Parâmetro 3) e que pertencem a transação de produto e/ou serviço configuradas na integração (Parâmetro 1 e Parâmetro 2).

Na consulta de pedidos alterados a plataforma consulta todos os pedidos e registra as alterações dos pedidos que estão na plataforma (Pedidos que não estão na plataforma são desprezados).

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.

Configurações -> Empresa.

CodFil ID ERP da Filial.

Configurações -> Filial.

ATRIBUTOS DE RESPOSTA REGISTRADOS

Parâmetro de Resposta Campo Atualização Cadastral Tela
dadosGerais.numPed Número do Pedido. Sim. SS -> Pedidos.
dadosGerais.tipPed Tipo do pedido. Sim. SS -> Pedidos.
dadosGerais.tnsPro Transação de produto. Sim. SS -> Pedidos.
dadosGerais.tnsSer Transação de serviço. Sim. SS -> Pedidos.
dadosGerais.datEmi Data de emissão. Sim. SS -> Pedidos.
dadosGerais.codCli Cliente.

A SS é aberta para o cliente do pedido de acordo com os parâmetros configurados nos parâmetros da integração.
Sim. SS -> Inclusão
dadosGerais.obsPed Observações do pedido.  Sim. SS -> Pedidos.
sequenciaItem Item do pedido. Sim. SS -> Pedidos.
codigoProdutoServico

ID ERP do produto ou serviço. 

 

Quando produto ou serviço é encontrado na plataforma o ID SISMETRO também é registrado.

Sim. SS -> Pedidos.
DescricaoProdutoServico Descrição do produto ou serviço. Sim. SS -> Pedidos.
DescricaoDerivacao Concatenado com a descrição do produto (Separado por traço). Sim. SS -> Pedidos.
precoUnitario Preço unitário. Sim. SS -> Pedidos.
quantidadePedida Quantidade. Sim. SS -> Pedidos.
unidadeMedida Unidade. Sim. SS -> Pedidos.
dataEntrega Previsão. Sim. SS -> Pedidos.
complemento Complemento. Sim. SS -> Pedidos.

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