English
Español
Dúvidas sobre o REST
Para mais detalhes sobre a integração REST, acesse.
O objetivo fundamental da integração entre o ERP Senior e o WMS na logística é garantir a atualização contínua de ambos os sistemas, minimizando possíveis fontes de erros.
Este manual é dedicado exclusivamente à integração mais antiga com o ERP Senior, que utiliza um método de integração baseado em API REST, mas adota a estrutura do layout de integração de arquivo. Além disso, envolve um terceiro sistema intermediário na arquitetura. Para uma comunicação mais eficiente, foi introduzido um novo modelo que utiliza a arquitetura de Sinal Senior. Caso deseje explorar o modelo mais recente de integração entre os sistemas ERP Senior e WMS, por favor, consulte a API de Integração ERP Senior x WMS Senior.
Para realizar uma exportação deve ser utilizado os serviços de assinatura de ganchos, que servem 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 devolve 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 é o formato do json retornado para o gancho na sessão Exportação.
Como montar a URL para enviar uma integração para o WMS?Para enviar uma integração para o WMS, a URL a ser utilizada sempre deve ser o contexto da aplicação, acrescido do caminho “/webresources/rest/” mais o serviço REST desejado, por exemplo: http://10.7.0.31/test/siltwms/webresources/rest/importacao/integrar
Quais são as URL’s de integração do WMS?Assumindo o exemplo acima: http://10.7.0.31/test/siltwms/webresources/rest/
Cadastrar Gancho (POST): assinatura/ganchos
- Integração NF-e (POST): importacao/integrarNFe
- Demais integrações (POST): importacao/integrar
Alterar Gancho (PUT): assinatura/ganchos/{id}
Excluir Gancho (DELETE): assinatura/ganchos/{id}
Consultar Ganchos (GET): assinatura/ganchos
- Consultar protocolo (GET): importacao/consultar/{protocolo}
Consultar Gancho pelo Id (GET): assinatura/ganchos/{id}
É necessário credenciais para efetuar chamadas, quais são elas?Sim. Ao criar uma configuração de integração por serviço REST, é gerada uma ApiKey que deve ser enviada no cabeçalho das requisições REST aos serviços do WMS para importação de dados.
Cada depositante tem uma URL ou é a mesmo URL para todos os clientes?A URL de entrada de dados para o WMS (importação) é a mesma para todos. O sistema diferencia por meio da ApiKey que é passada no cabeçalho da requisição REST.
Na aplicação WMS precisamos efetuar alguma configuração para utilizar essa integração. Além da ativação da Integração via Serviço REST que está na configuração de integração?Para importação apenas a configuração de integração é suficiente. Para a exportação, é necessário que o depositante seja configurado para utilizar algum modelo REST de exportação (movimentação de estoque, retorno de recebimento, etc).
Qual é o padrão de Codificação que os clientes da Senior utilizam (UTF-8 ou ISO-8859-1)?Para exportação, o padrão é UTF-8.
Qual é o padrão de Exportação REST que os clientes da Senior utilizam (APPLICATION / JSON ou TEXT / PLAIN)?O padrão é APPLICATION / JSON, porém a definição é do cliente durante a implementação do serviço que recebe as exportações do WMS.
Método de requisição: GETPor exemplo: http://10.7.0.30/test/siltwms para http://10.7.0.30/test/siltwms/webresources/rest/assinatura/ganchos
Método de requisição: POSTPor exemplo: http://10.7.0.30/test/siltwms para http://10.7.0.30/test/siltwms/webresources/rest/assinatura/ganchos
Método de requisição: DELETEPor exemplo: http://10.7.0.30/test/siltwms para http://10.7.0.30/test/siltwms/webresources/rest/assinatura/ganchos/{id}
Observação: {id} substituir pelo id do gancho cadastrado, consultar no GET.
Método de requisição: GETPor exemplo: http://10.7.0.30/test/siltwms para http://10.7.0.30/test/siltwms/webresources/rest/assinatura/ganchos/{id}
Observação: {id} substituir pelo id do gancho cadastrado, consultar no GET.
Método de requisição: PUTPor exemplo: http://10.7.0.30/test/siltwms para http://10.7.0.30/test/siltwms/webresources/rest/assinatura/ganchos/{id}
Observação: {id} substituir pelo id do gancho cadastrado, consultar no GET.
Integração da Nota Fiscal eletrônicaPor exemplo: http://10.7.0.30/test/siltwms para http://10.7.0.30/test/siltwms/webresources/rest/importacao/integrarNFe
Representa o XML da NF-e oficial da SEFAZ.
Demais importaçõesPor exemplo: http://10.7.0.30/test/siltwms para http://10.7.0.30/test/siltwms/webresources/rest/importacao/integrar
Reenvio de Integrações e ResultadosProcesso de reintegração de arquivos para execução em lote e implementamos a API REST para consulta de Log de Integração, a partir da versão 8.12.0.0.
(Referente ao WMSCT2-314)
A documentação do desenvolvimento está disponível no: <endereçosiltwms>/rest/documentacao#!/Importacao/get_importacao_logintegracao.
Tipo de ExportaçãoTodas as informações referente a cada layout de exportação disponível abaixo possui as mesmas informações da integração via texto, portanto gera um JSON correspondente a chave do layout que se deseja receber e retornar para o serviço REST do depositante cadastrado no gancho no campo tipoIntegracao.
English
Español
