Agora no Bluesoft ERP, é possível retornar os dados da transportadora e realizar consultas filtradas pelo código da transportadora via API.

Como Irá Funcionar a Partir de Agora?

A partir desta atualização, a integração passa a contar com o alinhamento completo entre as regras de negócio da tela e os endpoints da API pública.

  • Exibição de dados no retorno: Ao consultar os detalhes de um pedido ou listar pedidos que possuam frete com transportadora vinculada, a resposta da API incluirá o objeto "transportadora" preenchido com seu respectivo código e nome cadastrado: JSON"transportadora": { "transportadoraKey": 181355, "nome": "FONSECA MILL COMERCIO" }
  • Tratamento para pedidos sem vínculo: Caso o pedido de venda balcão consultado não possua uma transportadora associada ao frete, o objeto "transportadora" será omitido da estrutura, respeitando o padrão da API para campos opcionais.
  • Novo parâmetro de filtro: O endpoint GET /api/venda/pedidovenda recebeu o parâmetro opcional transportadoraKey (tipo Inteiro). Ao utilizá-lo, o sistema retornará exclusivamente os registros vinculados à transportadora informada.
  • Combinação de filtros e regressão: O novo filtro funciona de forma combinada aos parâmetros que já existiam (como lojaKey, tipoDeEntrega e pedidoVendaStatus). Se o parâmetro transportadoraKey for enviado vazio, o comportamento legado da listagem é preservado sem restrições.

Observações Importantes!

  • Permissão de Acesso: Para realizar as consultas aos endpoints atualizados da API pública de Pedido de venda balcão, o usuário/integrador necessita possuir a permissão 4109 ativa no sistema.

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 r369.69