Agora no Bluesoft ERP, é possível enviar informações completas de entrega e transportadora diretamente na criação de pedidos via API, abrangendo tanto a integração de Pedido de Venda Balcão quanto a de Pedido de Venda Separado.
O objetivo desta melhoria é automatizar o preenchimento das informações logísticas no ERP logo no momento da integração. Isso garante que os dados de frete, serviço de entrega e transportadora fiquem imediatamente disponíveis para consulta, evitando ajustes manuais.
O Que Mudou?
O Problema (Como Era):
Antes, as integrações de Pedido Balcão e Pedido Separado não possuíam o objeto dadosDeEntrega em seu layout de importação. Com isso, informações logísticas como forma de envio, número de rastreio, código da transportadora e valor do frete não eram repassadas ao ERP durante a criação. Esse cenário dificultava o registro direto dos dados logísticos da venda e gerava a necessidade de inserção manual.
A Solução (Agora):
A API foi atualizada para aceitar o objeto dadosDeEntrega de forma opcional em ambas as rotas. Quando enviado, o ERP captura e grava essas informações automaticamente no pedido, consolidando a transportadora, o valor do frete e o tipo de envio.
Benefícios:
- Automação na entrada de dados logísticos para vendas integradas por API.
- Eliminação do retrabalho manual.
- Consultas mais ricas e centralizadas no ERP para rastreio e acompanhamento de entrega.
Como Irá Funcionar?
- Durante a requisição para as APIs de Pedido de Venda Balcão ou Pedido de Venda. Separado, o sistema integrador poderá incluir o novo objeto opcional dadosDeEntrega.
- Dentro do objeto dadosDeEntrega , é possível enviar os seguintes campos (todos opcionais):
- formaDeEnvio : Texto que indica a modalidade de envio.
- numero : Texto que representa o código de rastreamento da entrega.
- codigoTransportadora : Texto utilizado para indicar o código externo ou serviço da entrega.
- transportadoraKey : Numérico, utilizado para identificar a chave da transportadora já cadastrada no ERP.
- valorFrete : Numérico (não negativo) referente ao valor do envio.
- Se o campo transportadoraKey for preenchido, o ERP fará a validação do cadastro da transportadora. Se for informada uma chave inválida, o sistema irá bloquear a criação do pedido e retornará um erro tratado ao integrador .
- O valor do frete repassado dentro do novo objeto será gravado no campo de frete do pedido recém-criado.
- No caso da API de Pedido de Venda Separado, se o integrador enviar simultaneamente o campo legado valor_frete e o novo dadosDeEntrega.valorFrete , o valor contido no novo objeto assumirá a precedência.
Observações e Validações Importantes:
O envio do objeto dadosDeEntrega é opcional, assim como o envio parcial de seus campos, desde que os valores informados sejam válidos.
Retrocompatibilidade: Os pedidos criados pelo payload antigo, sem os dados de entrega, continuarão funcionando sem bloqueios e mantendo os comportamentos legados de fechamento, faturamento e criação de duplicatas.
Para conhecer mais sobre como é a utilização dessa ferramenta, clique aqui.
Para saber mais sobre a utilização das APIs do ERP, clique aqui.