1. Duplicatas
HubDE
  • Instruções Gerais
    • Como começar
  • Integração para ERPs e Portais do Cedente
    • Integração para ERPs e Portais do Cedente
    • Cadastro do cedente
      • Cria a sessão de cadastro do cedente
      • Cria a sessão de acompanhamento
      • Consulta o cliente da credencial
      • Lista as escrituradoras disponíveis
    • Duplicatas
      • Envia as duplicatas de uma operação
        POST
      • Consulta o desfecho das duplicatas
        GET
      • Informa a liquidação de títulos
        POST
    • Acompanhamento
      • Consulta a situação dos cedentes
  1. Duplicatas

Informa a liquidação de títulos

POST
/erp/v1/duplicatas/liquidacoes
Informe assim que o título for baixado. O HubDE comunica a Escrituradora pelo canal dela, e é
essa informação que faz o registro refletir o pagamento.
Só duplicata já escriturada aceita liquidação. O que se informa é o pagamento de um
título que a Escrituradora constituiu, identificado pelo IUD. Enquanto a situacao da
duplicata não for escriturada, a liquidação volta recusada — consulte
GET /erp/v1/duplicatas antes.
total baixa o título. Na B3, informar liquidação total baixa a duplicata
automaticamente; não há um segundo passo.
Reenviar o mesmo pagamento não duplica nada, e não precisa de Idempotency-Key. O
mesmo tipo, valor, data e instrumento sobre a mesma duplicata volta aceita sem efeito
novo. Valores diferentes sobre uma duplicata que já tem liquidação voltam recusados
com duplicata.liquidacao_divergente: corrigir um pagamento já informado à Escrituradora
não é reenvio, é assunto de operação.
A referencia é como você identifica o título, junto com o documentoCedente — a
mesma dupla do envio. O Hub não espera o id dele.

Requisição

Parâmetros Bodyapplication/jsonNecessário

Examples

Respostas

🟢200
application/json
Todas as liquidações entraram.
Headers

Bodyapplication/json

🟢207
🟠400
🟠409
🟠422NaoAutenticada
🟠401NaoAutenticada
🟠403Suspensa
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location '/erp/v1/duplicatas/liquidacoes' \
--header 'Content-Type: application/json' \
--data '{
    "liquidacoes": [
        {
            "documentoCedente": "11222333000181",
            "referencia": "NF 12345 01",
            "tipo": "total",
            "valor": 1400,
            "dataPagamento": "2026-11-17",
            "tipoInstrumento": 3
        },
        {
            "documentoCedente": "11222333000181",
            "referencia": "NF 12345 02",
            "tipo": "total",
            "valor": 900,
            "dataPagamento": "2026-11-17",
            "tipoInstrumento": 2
        }
    ]
}'
Response Response Example
200 - Exemplo 1
{
    "aceitas": [
        {
            "duplicataId": "4c989e37-87c2-4506-92e7-61e689172999",
            "documentoCedente": "string",
            "referencia": "string"
        }
    ],
    "recusadas": [
        {
            "indice": 0,
            "documentoCedente": "string",
            "referencia": "string",
            "codigo": "string",
            "mensagem": "string"
        }
    ]
}
Modificado em 2026-11-19 05:54:58
Página anterior
Consulta o desfecho das duplicatas
Próxima página
Consulta a situação dos cedentes
Built with