Agora no Bluesoft ERP, é possível realizar a consulta de pedidos de compra usando filtros de data de entrega via API.

Objetivo

O objetivo desta melhoria é otimizar o fluxo de integração e os processos de logística, permitindo que o cliente filtre os pedidos por data de entrega já na consulta, evitando o processamento desnecessário de dados fora do período de interesse.

Como Era o Processo Antes?

Anteriormente, as APIs de consulta de pedidos de compra permitiam filtros apenas por parâmetros como dataEmissao e dataAtualizacaoInicial. Embora os campos de data de entrega (dataEntregaInicial e dataEntregaFinal) fossem retornados no JSON de resposta, não era possível utilizá-los como critérios de busca. Isso obrigava os sistemas integradores a consumirem uma carga maior de dados para realizar o filtro manualmente após o recebimento da resposta.

Como Irá Funcionar a Partir de Agora?

Foram adicionados dois novos parâmetros opcionais do tipo Query String nos endpoints de consulta:

  • Endpoints Afetados:
    • GET /api/compras/pedidos-de-compra
    • GET /api/compras/pedidos-de-compra/edi
  • Novos Parâmetros:
    • dataEntregaInicial: Filtra pedidos onde pelo menos uma entrega tenha data inicial maior ou igual à informada.
    • dataEntregaFinal: Filtra pedidos onde pelo menos uma entrega tenha data final menor ou igual à informada.

Regras de Uso:

  1. Lógica Combinada (AND): Ao utilizar ambos os filtros, o sistema retornará pedidos que possuam intersecção dentro do range estipulado.
  2. Limite de Range: O intervalo entre as datas informadas deve ser de, no máximo, 30 dias. Caso o período seja superior, a API retornará um erro informando a limitação.
  3. Consistência: A dataEntregaInicial não pode ser posterior à dataEntregaFinal.

Observações / Validações

  • Performance: Foi estabelecida uma trava de 30 dias para garantir a performance das consultas.
  • Permissões: O acesso aos endpoints segue as permissões já existentes para o módulo de Compras.

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 r368.01