Agora no Bluesoft ERP, é possível realizar consultas de duplicatas via API utilizando intervalos de datas para os campos de emissão e de última alteração via API

Objetivo

O objetivo desta melhoria é permitir que sistemas integrados consultem duplicatas geradas em períodos específicos, facilitando processos como o fechamento de folha de pagamento e a sincronização contínua de dados, sem a limitação de consultas por uma única data exata.

Como Irá Funcionar a Partir de Agora?

Foram implementados novos parâmetros de consulta (Query Parameters) que permitem a definição de intervalos de tempo:

  • Range de Emissão: Utilizando os campos dataEmissaoInicial e dataEmissaoFinal.
  • Range de Alteração: O campo dataAtualizacaoFinal foi adicionado para trabalhar em conjunto com o campo legado dataAtualizacaoInicial.

Regras de Negócio e Comportamento:

  • Filtros de Emissão: Ao informar a dataEmissaoInicial, o sistema considera registros a partir das 00:00 da data informada. Para a dataEmissaoFinal, a consulta busca registros até as 23:59.
  • Filtros de Alteração: O novo campo dataAtualizacaoFinal respeita a precisão de minutos (HH:MM), garantindo que nenhum registro seja perdido em processos de integração contínua.
  • Padrão de Formato: Todos os campos de data e hora informados devem seguir rigorosamente o padrão DD/MM/AAAA.

Observações / Validações

  • Limitação de Intervalo: Para garantir a performance do banco de dados, o intervalo entre a data inicial e a data final (tanto para emissão quanto para alteração) não pode ultrapassar 31 dias. Caso o limite seja excedido, a API retornará um erro de validação (HTTP 400).
  • Suporte Legado: A consulta por uma única data exata através do parâmetro dataEmissao continua disponível, desde que os campos de range não sejam preenchidos.

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 r367.55