Agora no Bluesoft ERP, é possível informar a transportadora cadastrada no ERP nos dados de entrega ao criar um pedido via API de e-commerce (POST /api/venda/pedidovenda/e-commerce), permitindo que a informação fique vinculada e visível nas consultas operacionais de pedidos.

O objetivo desta melhoria é garantir que os pedidos de e-commerce gerados por integração contenham os dados logísticos completos do ERP, facilitando a consulta, o acompanhamento e a conferência operacional sem depender exclusivamente de mapeamentos por serviço de entrega.

O Que Mudou?

Como Era o Processo Antes?

Anteriormente, a API de e-commerce recebia informações de envio (como forma de envio, número, código externo e frete), porém não possuía um campo explícito para indicar a chave da transportadora cadastrada no ERP. Com isso, os pedidos criados por integração podiam ficar sem a indicação da transportadora nas telas de consulta do ERP, prejudicando o acompanhamento logístico e a filtragem de dados.

Agora, a estrutura do objeto dadosDeEntrega da API passa a aceitar a propriedade opcional transportadoraKey. Quando enviada com uma chave válida do ERP, a transportadora correspondente será vinculada diretamente ao pedido e exibida nas consultas do sistema.

Como Irá Funcionar a Partir de Agora?

  1. Inclusão do Campo na API:
    • No endpoint POST /api/venda/pedidovenda/e-commerce, dentro do objeto dadosDeEntrega, foi disponibilizado o campo numérico opcional transportadoraKey.
    • Exemplo de payload:
      "dadosDeEntrega": { "formaDeEnvio": "string", "numero": "string", "codigoTransportadora": "string", "transportadoraKey": 1510, "valorFrete": 5.00 }
  2. Comportamento na Criação do Pedido:
    • Com transportadoraKey Válida: O ERP vincula a transportadora ao pedido e ao frete, retornando sucesso na criação do pedido com o código 201.
    • Com transportadoraKey Inválida/Inexistente: A criação do pedido é interrompida e a API retorna uma mensagem de erro tratada (400 Bad Request), informando que a transportadora é inexistente ou inválida.
    • Sem transportadoraKey ou sem dadosDeEntrega: A API mantém a compatibilidade e o comportamento anterior, criando o pedido normalmente sem exigir a chave da transportadora.
  3. Consulta no ERP:
    • Após a criação do pedido balcão via API com a chave informada, a transportadora vinculada passa a ser exibida nas consultas do ERP (como na Central do Pedido de Venda – Balcão).

Observações Importantes!

  • Opcionalidade dos Campos: O objeto dadosDeEntrega e todos os seus campos internos continuam sendo opcionais.
  • Preservação de Papéis: O campo codigoTransportadora permanece destinado ao código externo do serviço de entrega da integração e não substitui o papel do transportadoraKey (que representa a chave cadastrada no ERP).
  • Escopo de Aplicação: A vinculação da transportadora explícita pelo campo transportadoraKey aplica-se aos cenários de e-commerce que geram Pedido de Venda Balcão.

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.

Disponível a partir da versão r372.11