Concilia títulos ou transferências com um lançamento bancário ou de adquirente
POST/accounts/bank-statement
Vincula um conjunto de títulos a pagar/receber ou de transferências entre contas a um único lançamento — bancário ou de adquirente. O corpo deve identificar exatamente uma das duas conciliações em IDBankStatementConciliation (conciliação bancária) ou IDAccountsPayableReceivableConciliation (conciliação de adquirente), e também exatamente uma das listas: Accounts[] para títulos a pagar/receber, ou Transfers[] para transferências entre contas já lançadas.
Fluxo:
- Conciliação de adquirente com
Accounts[]: cria os lançamentos no extrato interno (AccountsPayableReceivableBankStatement) para cada título, vincula viaAccountsPayableReceivableConciliationMatche marca a conciliação de adquirente comoConciliationStatus=3(Manual). - Conciliação bancária com
Accounts[]: o status final depende dos valores —3quando o total dos títulos bate com o valor bancário,4(parcial) quando ainda falta reconciliar. - Quando o título já tem lançamento com a mesma data da conciliação, o lançamento existente é reaproveitado em vez de criar novo. Lançamentos já vinculados a outra conciliação bloqueiam a operação.
Transfers[]liga transferências entre contas pré-lançadas (sem título associado) à conciliação. Transferências já conciliadas são rejeitadas.
O valor total das contas não pode ultrapassar o valor do lançamento de conciliação (comparação em módulo, para suportar estornos).
Request
Responses
- 200
- 400
- 500
Conciliação efetuada. Retorna um array com 1 item — a conciliação resultante com os lançamentos vinculados e o status final.
Erros de validação (prefixo [BadRequest]):
Lançamento de conciliação não selecionadoInforme apenas uma conciliação: bancária ou de adquirenteConta bancária não selecionadaContas a receber/pagar é obrigatório e deve ser um array com pelo menos um itemTransferência é obrigatória e deve ser um array com pelo menos um itemAccounts[<i>]. Conta a pagar/receber não informada ou inválidaTransfers[<i>]. Transferência não informada ou inválidaEmpresa não encontradaLançamento de conciliação de adquirente não encontradoLançamento conciliação bancária não encontradoConta bancária não encontradaContas não encontradas: <ids>O valor total dos lançamentos (<x>) é maior que o valor do título (<y>). Código do título: <id>. Lançamentos: <detalhes>Divergência na data dos pagamentos realizados e a data do <lançamento de conciliação de adquirente|lançamento bancário>Título <id> já esta conciliado na conciliação bancária código: <id>O valor total das contas (<x>) é maior que o valor do <lançamento de conciliação de adquirente|lançamento bancário> (<y>). Não é possível conciliar.Transferência(s) não encontradas ou já conciliadas: <ids>Falha ao processar conciliação
Erro interno (prefixo Error:).