Integração REST

A chave de integração é responsável pela parametrização dos diretórios de importação e exportação de produtos, embalagens, pedidos e etc. Sendo assim para ter acesso aos serviços disponíveis será preciso ter uma APIKey a ser disponibilizada pelo armazém contratado pelo depositante.

Gerando a chave de Importação

Acesse Gestão de Armazenagem | WMS Senior > Configuração > Configuração de Integração > clique em Cadastrar

1. Na tela que abre informe o campo Armazém, com a entidade desejada;
2. No campo Depositante ou Transportadora selecione a entidade do depositante para qual será gerado a APIKey;
3. Em seguida, habilite o parâmetro Integração via Serviço Rest;
4. Escolha o Armazém para fazer o vínculo;
5. Habilite o parâmetro Integração via Serviço Rest;
6. Após Salvar o sistema cria automaticamente um número de APIKey tanto para o armazém quanto para o depositante selecionado;
7. A chave de identificação é criada no campo Chave para integração via Serviço Rest;
8. Na aba de Diretórios, o sistema preenche as informações com os dados do Tomcat. Nenhuma alteração é necessária.

Gerando a chave de exportação

A mesma APIKey gerada para o processo de Importação também será utilizada para o processo de Exportação, portanto, não é necessário gerar uma nova APIKey.

Para enviar uma integração ao Gestão de Armazenagem | WMS Senior, a URL a ser utilizada sempre deve ser a URL da aplicação, acrescido do caminho /webresources/rest/, mais o serviço REST desejado. Segue exemplo abaixo:

• URL da Aplicação: http://wmstraining.seniorcloud.com.br:8080/siltwms
• Caminho: /webresources/rest/
• Serviço Rest: importacao/integrar
• Resultdo da URL de importação: http://wmstraining.seniorcloud.com.br:8080/siltwms/webresources/rest/importacao/integrar

Após criar a chave APIKey e construir a URL das importações o Gestão de Armazenagem | WMS Senior já está pronto para receber as integrações. A APIKey deve ser enviada no cabeçalho da requisição desejada.

Para realizar a importação de informações ao Gestão de Armazenagem | WMS Senior, o arquivo de integração deve ser enviado em formato JSON com a identificação do que deseja importar, e com as informações que serão importadas.

Para conferir as importações possíveis e como deve ser o formato do JSON clique aqui.

Nesta tela é possivel escolher o modelo de integração e em que momento será gerado o arquivo de exportação.

Para seguir com esse procedimento Acesse Gestão de Armazenagem | WMS Senior > Cadastro > Depositante

1. Selecione o Depositante desejado e em seguida clique no botão Alterar;
2. Nas opções ao lado esquerdo da tela clique em Exportação e ative as exportações desejadas.

No Gestão de Armazenagem | WMS Senior para realizar a exportação é necessário cadastrar os serviços de assinatura de ganchos, que servirá para o Depositante registrar para qual URL de um serviço REST o Gestão de Armazenagem | WMS Senior deve enviar a exportação desejada.

Desta forma, quando ocorrer uma exportação no Gestão de Armazenagem | WMS Senior o mesmo irá devolver para o gancho correspondente. Assim sendo, evita que o sistema terceiro fique consultando de tempo em tempos se uma determinada exportação foi realizada, ficando a cargo do Gestão de Armazenagem | WMS Senior retornar somente quando o evento ocorre.

• URL da aplicação do WMS acrescido do caminho rest/documentacao
  • por exemplo: http://wmstraining.seniorcloud.com.br:8080/siltwms/rest/documentacao

1. Ao entrar no portal insira a APIKey do depositante. Em seguida, na opção Exportação clicar em POST/assinaturas/Ganchos;
2. Informe o tipoIntegração, que neste caso é o tipo de exportação;
3. Insira a URL de serviço REST na qual o Gestão de Armazenagem | WMS Senior enviará o Json;
4. Após preencher todos os dados, clique no botão Try it out para registrar a ligação.

Para que o ERP receba as exportações do Gestão de Armazenagem | WMS Senior, é realizado (Post) para o ERP utilizando a URL cadastrada no ganho.

Para que essa comunicação entre WMS > ERP aconteça é necessário o cadastro da URL.

/t/senior.com.br/bridge/1.0/rest/erp_isl/int_integrador/signals/movimentoEstoque nas seguintes integrações:

• EXPORTACAO_REST_CTRLAVARIA_MODMOV("Controle de Avaria Modelo MOV - Via Rest")
• EXP_AJUSTEMOVTO_REST_MV("Envio Ajuste Movimentação Rest modelo MOV")
• EXPORTACAO_RETPRODRECUP_REST_MODMOV("Envio Retorno de Produto Recuperado TXT modelo MOV - Via Rest")
• EXP_REMANEJAMENTO_MOV_REST("Exportar Remanejamento Entre Setores Modelo MOV - REST")
• EXPORTACAO_BLOQDESBL_REST("Movimentação de Estoque - Bloqueio e Desbloqueio de Lote")

/t/senior.com.br/bridge/1.0/rest/erp_isl/int_integrador/signals/processarAndamentoSeparacao nas seguintes integrações

• EXP_ANDAMENTO_PED_REST("Exportação do Andamento do Pedido ou Nota Fiscal - REST")

/t/senior.com.br/bridge/1.0/rest/erp_isl/int_integrador/signals/processarCancelamentoWMS nas seguintes integrações:

• EXP_CONFIRMACAO_CANCELAMENTO("Exportação da confirmação do cancelamento da nota fiscal")
• EXPORTACAO_CANCELAMENTO_REST("Cancelamento NF - Via Rest")

Observação: o endereço da URL deve ser avaliado na implantação da integração, se será utilizado o platform.senior.com.br ou cloud-leaf.senior.com.br.

Nesta tela é possível efetuar o acompanhamento de status dos processos de integrações de formato REST / Texto / XML.

Para isso acesse Gestão de Armazenagem | WMS Senior Integração > Integração de Arquivo

1. Ao entrar na tela, o sistema traz as informações referente ao processo de importação. Para visualizar as integrações referente ao processo de Exportação, basta clicar em Exibir e ativar a opção Exportação.

Reenvio de arquivos de exportação

Ainda na tela de Integração de Arquivo é possível reenviar exportação com status de concluída ou com erro, para isso, basta selecionar o agrupador desejado e clicar em Integrar Novamente. Somente um arquivo por vez é reenviado.

Nesta tela é possível verificar diversas informações sobre o conteúdo da integração referente ao agrupador selecionado.

Para isso acesse Gestão de Armazenagem | WMS Senior Integração > Log de integração