# Integração Obter Itens do Pedido com o ERP Senior.

Esta integração permite que os itens dos pedidos sejam replicados do ERP Senior para a plataforma.

<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 obter os itens dos pedidos.

**Mecanismo:** XML

**WSDL:** `<a href="https://web03.senior.com.br:39301/g5-senior-services/sapiens_Synccom_senior_g5_co_mcm_ven_pedidos?wsdl">https://web03.senior.com.br:39301/g5-senior-services/sapiens_Synccom_senior_g5_co_mcm_ven_pedidos?wsdl<br></br></a>` **Porta:** OberItensPedido\_2

**Documentação Senior:** [Clique aqui! ](https://documentacao.senior.com.br/gestaoempresarialerp/5.8.10/#webservices/com_senior_g5_co_mcm_ven_pedidos.htm#obterItensPedido2 "Documentação Integração Obter Itens do Pedido 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")

<span style="text-decoration: underline;">EXECUTAR OS PROCEDIMENTO ABAIXO EM TODAS AS FILIAS QUE SERÃO INTEGRADAS.  
  
</span>

***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:<u> F000SXT</u>);
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”.

![](https://doc.sismetro.com/uploads/images/gallery/2020-03-Mar/scaled-840-0/image-1583782784503.png)

*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. 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 “Pedidos Obter Itens”;
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 5 (Cinco) minutos.

<p class="callout info">**VALIDAÇÃO DE EXECUÇÃO DA INTEGRAÇÃO**</p>

**Tipo da integração:** 26

**Vendor:** 3

**Status:** 1

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

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

**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 identificados como pendentes de sincronia na plataforma. A pendência é gerada na abertura da SS e também via integração de consulta de pedidos alterados. Todos os itens do pedido são atualizados (Subescritos) independe de número sequencial.

<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: 214px;"><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;">ID ERP da Empresa da SS.</td><td style="width: 38.0864%; height: 31px;">Configurações -&gt; Empresa.

</td></tr><tr style="height: 31px;"><td style="width: 24.074%; height: 31px;">CodFil</td><td style="width: 37.8396%; height: 31px;">ID ERP da Filial da SS.</td><td style="width: 38.0864%; height: 31px;">Configurações -&gt; Filial.

</td></tr><tr style="height: 58px;"><td style="width: 24.074%; height: 28px;">numeroPedido</td><td style="width: 37.8396%; height: 28px;">ID ERP do pedido associado a SS.</td><td style="width: 38.0864%; height: 28px;">SS -&gt; Pedidos.

</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: 492px;"><tbody><tr style="height: 31px;"><td style="width: 22.716%; height: 31px;">**Parâmetro de Resposta**</td><td style="width: 39.4445%; height: 31px;">**Campo**</td><td style="width: 15.7099%; 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;">sequenciaItem</td><td style="width: 39.4445%; height: 31px;">Item do pedido.</td><td style="width: 15.7099%; height: 31px;">Sim.</td><td style="width: 22.1296%; height: 31px;">SS -&gt; Pedidos.</td></tr><tr style="height: 31px;"><td style="width: 22.716%; height: 31px;">codigoProdutoServico</td><td style="width: 39.4445%; height: 31px;">ID ERP do produto ou serviço.

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

</td><td style="width: 15.7099%; height: 31px;">Sim.</td><td style="width: 22.1296%; height: 31px;">SS -&gt; Pedidos.</td></tr><tr style="height: 31px;"><td style="width: 22.716%; height: 31px;">DescricaoProdutoServico</td><td style="width: 39.4445%; height: 31px;">Descrição do produto ou serviço.</td><td style="width: 15.7099%; height: 31px;">Sim.</td><td style="width: 22.1296%; height: 31px;">SS -&gt; Pedidos.</td></tr><tr style="height: 31px;"><td style="width: 22.716%; height: 31px;">DescricaoDerivacao</td><td style="width: 39.4445%; height: 31px;">Concatenado com a descrição do produto (Separado por traço).</td><td style="width: 15.7099%; height: 31px;">Sim.</td><td style="width: 22.1296%; height: 31px;">SS -&gt; Pedidos.</td></tr><tr style="height: 31px;"><td style="width: 22.716%; height: 31px;">precoUnitario</td><td style="width: 39.4445%; height: 31px;">Preço unitário.</td><td style="width: 15.7099%; height: 31px;">Sim.</td><td style="width: 22.1296%; height: 31px;">SS -&gt; Pedidos.</td></tr><tr style="height: 31px;"><td style="width: 22.716%; height: 31px;">quantidadePedida</td><td style="width: 39.4445%; height: 31px;">Quantidade.</td><td style="width: 15.7099%; height: 31px;">Sim.</td><td style="width: 22.1296%; height: 31px;">SS -&gt; Pedidos.</td></tr><tr style="height: 31px;"><td style="width: 22.716%; height: 31px;">unidadeMedida</td><td style="width: 39.4445%; height: 31px;">Unidade.</td><td style="width: 15.7099%; height: 31px;">Sim.</td><td style="width: 22.1296%; height: 31px;">SS -&gt; Pedidos.</td></tr><tr style="height: 31px;"><td style="width: 22.716%; height: 31px;">dataEntrega</td><td style="width: 39.4445%; height: 31px;">Previsão.</td><td style="width: 15.7099%; height: 31px;">Sim.</td><td style="width: 22.1296%; height: 31px;">SS -&gt; Pedidos.</td></tr><tr style="height: 31px;"><td style="width: 22.716%; height: 31px;">complemento</td><td style="width: 39.4445%; height: 31px;">Complemento.</td><td style="width: 15.7099%; height: 31px;">Sim.</td><td style="width: 22.1296%; height: 31px;">SS -&gt; Pedidos.</td></tr></tbody></table>

<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. Para consultar a listagem [clique aqui!](https://doc.sismetro.com/books/erp-senior/page/especifica%C3%A7%C3%B5es-de-libera%C3%A7%C3%A3o-de-servidores-de-integra%C3%A7%C3%A3o "Especificações de Liberação de Servidores de Integração").</td><td class="align-center" style="width: 72.2222px;">-</td></tr></tbody></table>

<div id="bkmrk--0"></div>