[Novidade] Financeiro: Duplicatas – Inclusão e Consulta de Ocorrências de Duplicata via API

Agora no Bluesoft ERP, é possível consultar e incluir ocorrências vinculadas a duplicatas via API.

Como Irá Funcionar a Partir de Agora?

A integração passa a funcionar através de dois novos endpoints públicos estruturados no módulo de API Financeiro:

• Consulta de Ocorrências (GET): O endpoint GET /api/financeiro/duplicatas/{duplicataKey}/ocorrencias retorna a lista completa de ocorrências vinculadas à duplicata informada.
  • O retorno consolida a data e a hora em um atributo único chamado dataHora, no formato DD/MM/AAAA HH:MM, eliminando os campos separados de data e hora.
  • Exibe também os campos de mensagem e usuario.

• Inclusão de Ocorrências (POST): O endpoint POST /api/financeiro/duplicatas/{duplicataKey}/ocorrencias permite o registro de novas mensagens de histórico.
  • O campo mensagem é obrigatório e possui limite máximo de 400 caracteres.
  • O sistema registra de forma automática a data/hora da inclusão e vincula o usuário autenticado na API como o responsável pela ocorrência.

Observações e Validações

• Controle de Permissões: Foram criadas permissões específicas para garantir a segurança dos dados via API.
• Validação de Mensagem: Requisições de inclusão sem o texto da mensagem ou que ultrapassem o limite de 400 caracteres serão rejeitadas com o status 400 Bad Request.

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.