Manuais Operacionais / Administrativos > Integração > Integração REST

Integração REST

Rest de Integração

API Rest de integracao do Senior WMS

Funcionamento da Integração

Para acessar esta funcionalidade criada a partir da versão 8.8.3.0, faz necessário na linha de comando inserir a informação rest/documentacao

Por exemplo: http://10.7.0.30/test/siltwms para http://10.7.0.30/test/siltwms/rest/documentacao

Este serviço é mais uma das portas de entradas e saídas das informações que o Senior WMS oferece para importação e exportação de produtos, embalagens, pedidos e etc. Sendo assim para ter acesso aos serviços disponíveis será necessário ter a API Key a ser disponibilizada pelo armazém contratado pelo depositante.

Uma vez com a API Key em mãos, a mesma deverá ser enviada no cabeçalho da requisição desejada.

Para realizar a importação de informações deverá ser enviado em formato json com a identificação do que deseja importar e as informações que serão importadas. Pode-se conferir as importações possíveis e como deverá ser o formato do json na sessão Importação .

Já para realizar um exportação deverá ser utilizado os serviços de assinatura de ganchos, que servirá para o depositante registrar para qual URL de um serviço REST do mesmo que devemos retornar a exportação desejada. Dessa forma quando ocorrer uma exportação no WMS o mesmo irá devolver para o gancho correspondente. Esse forma evita que o sistema de terceiro tenha que vir consultar de tempos em tempos se aconteceu a exportação desejada, ficando a cargo do WMS retornar somente quando o evento ocorre. Pode-se conferir as exportações possíveis e como será o formato do json retornado para o gancho na sessão Exportação.

Esta funcionalidade irá comportar as integração via Cloud, por isso:

Adicionamos os campos Integração via Serviço Rest e Chave para Integração via Serviço Rest a partir da tela Configuração de Integração > sub Menu Configurar Integração.

Caso a opção Integração via Serviço Rest esteja marcada, o sistema gerará os arquivos automaticamente, pois os campos: diretórios estarão desabilitados.

Para o campo Chave para Integração via Serviço Rest, foi criado método que irá gerar a chave, com base no padrão SHA-256, referente a integração modelo REST.

Inserimos a opção REST - Modelo WMS na Configuração Geral > sub Menu Integração > campo Entidade, que estará vinculada ao campo Email do Cadastro da Entidade.

Importação

Todas as informações referente a cada layout de importação disponível abaixo possui as mesmas informações da importação via texto, portanto ao ser enviado para o serviço REST irá gerar um arquivo texto correspondente a chave do layout que se deseja importar e o mesmo será gravado na pasta temporária do servidor para que a importação seja agendada e executada pelo sistema.

Exportação

Todas as informações referente a cada layout de exportação disponível abaixo possui as mesmas informações da integração via texto, portanto irá gerar um json correspondente a chave do layout que se deseja receber e retornar para o serviço REST do depositante cadastrado no gancho.

Na tela do Cadastro de Depositante, sub Menu Exportação, adicionamos a opção REST - Modelo WMS para os campos abaixo informados:

Produto;
Embalagem;
Cancelamento;
Nota Fiscal de Remessa e Retorno de Armazenagem;
Retorno de Movimentação de Entrada;
Retorno de Movimentação de Saída;
Retorno de Recebimento, e houve acréscimo das opções:
- REST - Modelo WMS Lote;
- REST - Modelo WMS Lote Setor;
- REST - Modelo WMS Nota Fiscal e
- REST - Modelo WMS MOV.
Retorno de Faturamento Automático, com a inserção da alternativa REST - Modelo WMS Lote;
Autorização de Embarque;
Inventário, com o acréscimo da opção REST - Modelo WMS Lote;
Ajuste de Movimentação , com a inserção da alternativa REST - Modelo WMS Lote;
Controle de Avaria;
Retorno Produto Recuperado;
Bloqueio e Desbloqueio de Lote;
Saldo de Estoque por Produto, foram também adicionados as opções abaixo exibidas:
- REST - Modelo WMS Lote e
- REST - Modelo WMS Lote Setor.

Tipo de Exportação

A lista abaixo corresponde a cada Tipo de Exportação que o sistema trabalha, cabendo você saber qual deseja receber para que seja enviada no campo tipoIntegracao do gancho a ser cadastrado.

EXPORTACAO_XML_NFE_REST("XML NF-e")
EXPORTACAO_ENTIDADE_REST("Entidade")
EXPORTACAO_PRODUTO_REST("Produto")
EXPORTACAO_EMBALAGEM_REST("Embalagem")
EXPORTACAO_CANCELAMENTO_REST("Cancelamento de Nota Fiscal")
EXPORTACAO_RET_MOVARM_ENT_REST("Retorno Movimentação de Entrada")
EXPORT_RET_MOVARM_ENT_DET_REST("Itens Retorno Movimentação de Entrada")
REMARMAZENAGEM_REST("Cabeçalho Nota Fiscal de Remessa de Armazenagem")
REMARMAZENAGEMDET_REST("Itens Nota Fiscal de Remessade Armazenagem")
RETARMAZENAGEM_REST("Cabeçalho Nota Fiscal de Retorno de Armazenagem")
RETARMAZENAGEMDET_REST("Itens Nota Fiscal de Retorno de Armazenagem")
RETARMAZENAGEM_COMPLETO_REST("Cabeçalho Nota Fiscal Retorno de Armazenagem Completo")
RETARMAZENAGEM2_REST("Modelo 2 Cabeçalho Nota Fiscal Retorno de Armazenagem")
RETARMAZENAGEMDETCOMPLETO_REST("Itens Nota Fiscal Retorno de Armazenagem Completo")
EXPORTA_ARMAZENAGEM_MOD2_REST("Nota Fiscal de Retorno de Armazenagem EDI 9")
EXPORTACAO_RET_MOVARM_SDA_REST("Retorno Movimentação de Saída")
EXPORT_RET_MOVARM_SDA_DET_REST("Itens Retorno Movimentação de Saída")
EXPORT_RET_MOVARM_SDA_M2_REST("Modelo 2 Retorno Movimentação de Saída")
EXP_FATURAMENTO_REST("Cabeçalho do Faturamento")
EXP_FATURAMENTODET_REST("Itens do Faturamento")
EXP_FATURAMENTOESPEC_REST("Informação Específica do Faturamento")
EXP_FATURAMENTO_LOTE_REST("Cabeçalho do Faturamento com Lote Indústria")
EXP_FATURAMENTODET_LOTE_REST("Itens do Faturamento com Lote Indústria")
EXP_FATURAMENTOESPEC_LOTE_REST("Informação Específica do Faturamento com Lote Indústria")
EXPORT_ORDEM_RECEBIMENT_H_REST("Cabeçalho Ordem de Recebimento")
EXPORT_ORDEM_RECEBIMENT_I_REST("Itens Ordem de Recebimento")
EXPORT_ORDEM_RECEBIMENT_N_REST("Nota Fiscal Ordem de Recebimento")
INTEGRACAO_OR_REST("Informação Específica da Ordem de Recebimento")
EXPORT_OR_LTIND_H_REST("Cabeçalho com Lote Indústria Ordem de Recebimento")
EXPORT_OR_LTIND_I_REST("Itens com Lote Indústria Ordem de Recebimento")
EXPORT_OR_LTIND_N_REST("Nota Fiscal com Lote Indústria Ordem de Recebimento")
INTEGRACAO_OR_L_REST("Informação Específica com Lote Indústria da Ordem de Recebimento")
EXPORT_ORDEM_RECEB_NF_RDE_REST("Cabeçalho Nota Fiscal de Retorno da Ordem de Recebimento")
INTEGRACAO_OR_NOTA_REST("Itens Nota Fiscal de Retorno da Ordem de Recebimento")
EXP_OR_MODELO_MOV_REST("Movimentação de Estoque - Ordem de Recebimento")
CARGA_EMBARQUE_REST("Cabeçalho Confirmação de Embarque")
CARGA_EMBARQUE_DET_REST("Itens Confirmação de Embarque")
INVENTARIO_REST("Cabeçalho Inventário")
INVENTARIOINFOESP_REST("Informação Específica Inventário")
INTEGRACAO_INVENTARIO_LOTEINDUSTRIA_REST("Cabeçalho Inventário com Lote Indústria")
INTEGRACAO_INVINFOESP_L_REST("Informação Específica Inventário com Lote Indústria")
EXP_REST_CTRAVARIA_MODMOV("Movimentação de Estoque - Controle de Avaria")
INTEGRACAO_AJUSTEMOVTO_L_REST("Ajuste de Movimentação com Lote Indústria")
EXP_AJUSTEMOVTO_REST_MV("Movimentação de Estoque - Ajuste de Movimentação")
EXPORTACAO_BLOQDESBL_REST("Movimentação de Estoque - Bloqueio e Desbloqueio de Lote")
EXP_RET_PRODRECUP_REST_MV("Movimentação de Estoque- Retorno Produto Recuperado")
EXP_SALDO_ESTOQPROD_REST("Saldo de Estoque")
EXP_SALDO_ESTOQPROD_REST_LOTE("Saldo de Estoque com Lote Indústria")
EXP_SALDO_ESTOQPROD_REST_SETOR("Saldo de Estoque com Setor")
RETARMAZENAGEM2_DET_REST("Modelo 2 Itens Nota Fiscal Retorno de Armazenagem")