Integre seu ERP, sistema de balança ou aplicação ao Narte. Autenticação por token,
dados em JSON e recursos para pedido de venda, ordem de carga e romaneio de entrada.
Esta documentação tem por finalidade auxiliar a integração entre APIs e facilitar a usabilidade da plataforma Narte, que se dispõe a fornecer um meio de integração via REST com outros sistemas de forma fácil e independente de tecnologia.
1.2 Endpoint
O endpoint da conexão com a API REST JSON possui sempre o mesmo padrão, independente do serviço a ser utilizado: http[s]://[nome_ou_ip_do_servidor][:7700]/rest/api/recurso
Todos os dados enviados e recebidos pela API estão/deverão ser em formato JSON (application/json).
Nota importante!
Como no exemplo acima, todos os exemplos utilizam uma URL fictícia que deve sempre ser substituída pela URL real, fornecida pela empresa utilizadora das soluções Narte. A porta usada nos exemplos é a 7700(padrão).
1.4 Recursos disponíveis
Atualmente existem os seguintes recursos abaixo que você pode manipular através dos métodos GET, POST, PUT e DELETE:
Pedido de Venda
Ordem de Carga
1.5 Autenticação
Para poder trabalhar com os métodos disponíveis e assim fazer a integração é necessário primeiro realizar a autenticação utilizando um serviço específico, informando usuário, senha (Criptografia MD5) e código da empresa, previamente cadastrados no sistema. Recomenda-se fortemente criar um usuário específico para cada sistema que venha a utilizar estes serviços, facilitando o controle e auditoria dos dados imputados e lidos por estes.
Para consultar Pedido de Venda você pode passar o parâmetro opcional {pve_id} na url do endpoint a fim de trazer o resultado de um único pedido. Ao não informar o parâmetro, serão retornados os dados de todos os pedidos, sendo no máximo 100 itens por requisição.
Todos os pedidos: https://seu-servidor:7700/rest/api/pedidovenda
Para alterar um Pedido de Venda é preciso passar no body do Json o PVE_ID (Número do Pedido de Venda que será alterado). Apenas pedidos com status: AB - Aberto poderão serem excluídos
Para excluir um Pedido de Venda é preciso passar o parâmetro obrigatóriol {pve_id} na url do endpoint a fim de excluir um único pedido. Apenas pedidos com status: AB - Aberto poderão serem excluídos
PP - Produtos do Pedido TP- Produtos do Pallet do Pedido
OCA_STATUS
AB - Aberta CA - Carregando FE - Fechada EX - Expedida
Romaneio de Entrada
1.0 - Cabeçalho
Campo
Valor do Campo
ROE_TIPOFRETE
PP - Próprio TR - Terceiros PR - Produtor
Suporte à integração
Dúvidas durante a implantação? Fale com a equipe técnica pelo e-mail
suporte@narte.com.br ou pelo WhatsApp
(27) 2103-9009.
Sugestões de melhoria também são bem-vindas.
A coleção completa, com exemplos executáveis, está disponível no
Postman.