Ir para o conteúdo principal

Integração de Requisição de Estoque (Porta Agrupada Composta) com o ERP Senior

Esta integração permite que a plataforma envie requisições de estoque (De produtos inseridos em SS Solicitações de Serviços) de forma agrupada (de uma só vez vários itens de produtos e serviços) para o ERP Senior,
Identificador de tipo: 56

Com esta integração, a plataforma consegue enviar N produtos e serviços de uma só vez sem suporte a Projeto e Fase. Ela não é compatível em paralelo com a integração individual.

Para enviar requisições ao ERP não é necessário efetuar nenhuma ativação. Porém para realizar consulta do andamento da aquisição é necessário.

MÓDULO

Gestão Inteligente de Manutenção

ESPECIFICAÇÕES TÉCNICAS

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

Consulta: UPSIM consome WS para receber cadastros pendentes de sincronia

Chave de unicidade no ERP: Requisição por empresa

Chave de unicidade na plataforma: Requisição gera um ID único para a unidade


Comportamento do WS: A plataforma realiza requisições unitárias e consulta periodicamente o andamento do atendimento

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

Mecanismo: XML

Documentação Senior: Clique aqui! 

PROCEDIMENTO CLIENTE

Cadastro do sistema integrado

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

IMPORTANTE! Pode haver configurações a mais para configurar a integração para receber Requisições de Estoque Agrupadas, o qual pode não estar nesta seção. Caso haja algo a mais recomenda-se consultar seu canal de atendimento Senior. Abaixo está a configuração geral para a integração da Requisição de Estoque.

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 “Requisição de Estoque Eletrônica";

  9. Clique em “Mostrar”;

  10. Marque o check box da linha “Tipo de Informação” com a descrição “Requisição de Estoque Eletrônica”;

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

Requisições-1.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.mcm.est.requisicoes”;

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

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


Requisições-Consulta.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ção no ERP Senior;

  6. Empresa cadastrada no ERP Senior;

  7. Filial cadastrada no ERP Senior;

  8. Código da transação de requisição de estoque no ERP Senior;
  9. 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 “Requisição de Estoque Agrupada - 56”;

  5. Selecione o Vendor/ERP “Senior”;

  6. Insira a Sigla "UPSIM";

  7. Insira o usuário (informado pelo cliente);

  8. Insira o password (informado pelo cliente);

  9. Insira o código da empresa (informado pelo cliente);

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

  11. Insira a key da unidade (cadastro da unidade);
  12. Insira o password (informado pelo cliente);
  13. Insira no campo "Parâmetro 1" o código da transação (informado pelo cliente). Quando o código não é informado a integração utiliza o código padrão 90250;
  14. Insira o EndPoint WebService. Exemplo:

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

  15. Insira o EndPoint UPSIM. Exemplo:

    http://dev.sismetro.com:5000

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

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

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

  19. 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";
  • Caso haja algum problema de integração e o protocolo seja HTTPS do Webservice, insira "IgnoraSSL" no Parâmetro 5;
  • Caso o Webservice esteja parametrizado para receber algum valor nos rateios, preencha um valor padrão no Parâmetro 3;
  • Caso necessite que o valor seja importado para a requisição na consulta do ERP, ou seja, obtido o valor unitário de cada produto e serviço requisitado para ser importado na Solicitação de serviço, use "IntegrarValorExportar" no Parämetro 4.

DÚVIDAS

Dúvida 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. O WebService necessita estar publicado e visível na na web.  -

É possível liberar apenas os domínios dos servidores da plataforma para consumir o WebService?

Sim. Se o firewall permitir a liberação por domínio o usuário 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 possuem IP fixo. Portanto não é possível liberar o consumo para IP´s específicos.  -

Ao excluir uma requisição no ERP a mesmo é replicada para a plataforma?

Não. Quando uma requisição é "excluída" no ERP não é gerado sincronia para a plataforma. O usuário deverá "cancelar" para que a sincronia seja realizada. -

É possível realizar requisições agrupadas?

Não. A plataforma realiza apenas requisições unitárias. -

ENVIO DA REQUISIÇÃO

Tipo: SOAP/XML
Nomenclatura: CamelCase
Variáveis: Case Sensitive

Exemplo da requisição:
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
    xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://services.senior.com.br"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <SOAP-ENV:Body>
        <ns1:requisicaoAgrupadaComposta_7>
            <user>SISMETRO</user>
            <password>XXYYYZZZ</password>
            <encryption>0</encryption>
            <parameters>
                <dadosGerais>
                    <codEmp>6</codEmp>
                    <codFil>7</codFil>
                    <identificadorExterno>111222</identificadorExterno>
                    <itens>
                        <codDer>OLH10</codDer>
                        <codPro>12005975</codPro>
                        <codTns>90250</codTns>
                        <datEme>23/07/2025</datEme>
                        <obsEme>SISMETRO SS nº 112233 - https://smtr.io/abc</obsEme>
                        <preEme xsi:nil="true"/>
                        <qtdEme>1</qtdEme>
                    </itens>
                    <itens>
                        <codDer>U</codDer>
                        <codPro>10003946</codPro>
                        <codTns>90250</codTns>
                        <datEme>23/07/2025</datEme>
                        <obsEme>SISMETRO SS nº 112233 - https://smtr.io/abc</obsEme>
                        <preEme xsi:nil="true"/>
                        <qtdEme>1</qtdEme>
                    </itens>
                    <tipoOperacao>R</tipoOperacao>
                    <tipoProcessamento>1</tipoProcessamento>
                </dadosGerais>
                <identificadorSistema>SISMETRO</identificadorSistema>
            </parameters>
        </ns1:requisicaoAgrupadaComposta_7>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

DEFINIÇÃO DE VALORES

Atributo Tipo Obrigatório Exemplo Tamanho Descrição
identificadorSistema String Sim "SISMETRO" 10 Identificador do sistema
identificadorExterno Int Sim 12345 9 Identificador da Requisição do sistema parceiro
codEmp String Sim Ex: "001" 20 Código da empresa no ERP
codFil String Sim Ex: "01" 3

Código da filial no ERP

codPro String -

Ex: "12345"

14 Código do produto 
codDer String - Ex: "der01" 7 Código da Derivação
codSer String - Ex: "12345" 14 Código do serviço
codTns Numérico Sim Ex: "90251" 14 Código da transação (parametrizável, padrão 90251)
datEme Data atual Sim "dd/mm/yyyy" 10 Data de movimento 
datPrv Data atual Não "dd/mm/yyyy" 10 Data de previsão de entrega
obsEme String Não Texto livre 250 Observação (SS, usuário, observação extra)
preEme Float Sim Ex: "99.99" 15,5 Preço da requisição utilizado para o controle de aprovação multinível e atualização de projetos
qtdEme Float Sim "1.0" 14,5 Quantidade (sempre 1.0 para serviço)
tipoOperacao String Sim "R"
R = Requisitar, D = Devolver
tipoProcessamento Int Sim "1" 1 Tipo de processamento (sempre 1)
datahora Date Time Sim "dd/mm/yyyy"

10

Data e hora do cadastro do produto no ERP (Formato ISO).

* A requisição deve ser única para o tipo Produto ou Serviço, não pode conter ambos os itens!