Changelog do financeiro
Mudanças na API de integração do financeiro (/api/partner/v1/finance), da mais recente para a mais antiga. A política de versões está em Versões e depreciação.
Próxima publicação: valores exatos no fluxo de caixa
Rota: GET /api/partner/v1/finance/treasury/cash-flow.
Data de publicação: registrada aqui quando a mudança entrar em produção. Implementação e validação locais R35 em 07/10/2026.
Campos monetários _minor conservam a escala de centavos, os sinais e os cálculos. Inteiros no intervalo seguro JSON/JavaScript permanecem números; fora dele passam a texto decimal exato, inclusive totais maiores que bigint. Exemplo: "18446744073709551614". IDs, contagens e null de saldo ausente permanecem iguais. O schema específico do fluxo declara os dois tipos; clientes devem ler/calcular os valores textuais sem conversão para ponto flutuante.
Próxima publicação: recebimento que cita um crédito PIX
Rota: POST /api/partner/v1/finance/receivables/{id}/receipts.
Data de publicação: registrada aqui quando a mudança entrar em produção.
O que mudou. Recebimento cuja reference é o E2E de um crédito PIX recebido numa conta da instituição passa a ser conferido contra esse crédito, em qualquer channel: a data é a do crédito, a conta é a do crédito, o título precisa poder receber naquela conta, e os recebimentos ativos somados à parte devolvida ao pagador não passam do valor do crédito. Pedidos que antes eram aceitos agora podem ser recusados com:
| HTTP | error | detail |
|---|---|---|
422 | receipt_date_differs_from_credit | credit_date |
422 | credit_day_closed | credit_date |
422 | receipt_exceeds_credit | available_base_units |
422 | receipt_account_differs_from_credit | |
422 | credit_already_returned | |
422 | invalid_receipt_account | |
503 | credit_state_unavailable |
O significado e o que fazer em cada caso estão em Financeiro da instituição.
invalid_receipt_account vale para recebimento sem conta informada cujo crédito citado está numa conta da instituição que não está ativa. Antes, o pedido era aceito e o recebimento ficava sem conta (o account_id do relatório GET /api/partner/v1/finance/receivables/receipts mostrava a conta do título); agora o recebimento sem conta recebe a conta do crédito, que precisa estar ativa, e é ela que o relatório mostra.
Por que na /v1. É correção de integridade: sem ela, o mesmo dinheiro podia quitar dois títulos, ou quitar um título e voltar ao pagador.
Sem mudança para recebimento cuja referência não é E2E de crédito da instituição (documento, nosso número, texto livre): continua sendo declaração do integrador.