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

Consulta o desfecho das duplicatas

GET
/erp/v1/duplicatas
É aqui que o IUD chega. O envio devolve um protocolo de lote e nada mais; o
identificador do título só existe depois que a Escrituradora escritura, e ela não avisa
ninguém quando termina. Quem pergunta é o seu ERP.
Varra por atualizadoDesde, não por data de criação. Guarde o maior atualizadoEm
que você recebeu e devolva-o na chamada seguinte. O corte é inclusivo: duas
duplicatas do mesmo lote costumam ter o mesmo instante, e um corte exclusivo perderia a
segunda para sempre. Em troca, a última página repete — e repetir é inofensivo, porque
você grava por referencia.
A referencia é como você reencontra o seu título. O id é do HubDE e não significa
nada do seu lado; o iud só existe depois do desfecho.
situacao é o andamento no HubDE; situacaoEscrituradora é o texto dela. A primeira
tem três valores e é estável. A segunda vem sem tradução e sem catálogo publicado —
trate-a como texto para exibir, nunca como condição de if.
Sem filtro de data, a consulta devolve tudo o que o cliente tem, da mais antiga para a
mais recente.
A página vem ordenada por atualizadoEm crescente — a mesma chave do cursor —, com
desempate por id.

Requisição

Parâmetros de Consulta

Respostas

🟢200
application/json
A página de desfechos.
Headers

Bodyapplication/json

🟠400
🟠401NaoAutenticada
🟠403Suspensa
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/erp/v1/duplicatas?atualizadoDesde=2026-10-27T15%3A39%3A00Z&documentoCedente=&situacao=&pagina=&tamanho='
Response Response Example
200 - Uma escriturada, uma em curso e uma recusada pela Escrituradora
{
    "pagina": 1,
    "tamanho": 100,
    "total": 3,
    "itens": [
        {
            "id": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
            "documentoCedente": "11222333000181",
            "referencia": "NF 12345 01",
            "numeroFatura": "FAT 2026 001",
            "parcela": 1,
            "situacao": "escriturada",
            "iud": "QESC2026000000000001",
            "emitidaEm": null,
            "protocolo": "8f3c1d2e-aaaa-bbbb-cccc-1234567890ab",
            "protocoloEm": "2026-10-27T15:39:12Z",
            "situacaoEscrituradora": null,
            "situacaoEscrituradoraDescricao": null,
            "escrituradoraId": "0199a1b2-0000-7000-8000-000000000001",
            "atualizadoEm": "2026-10-27T15:41:03Z"
        },
        {
            "id": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5c",
            "documentoCedente": "11222333000181",
            "referencia": "NF 12345 02",
            "numeroFatura": "FAT 2026 001",
            "parcela": 2,
            "situacao": "pendente",
            "iud": null,
            "emitidaEm": null,
            "protocolo": null,
            "protocoloEm": null,
            "situacaoEscrituradora": null,
            "situacaoEscrituradoraDescricao": null,
            "escrituradoraId": null,
            "atualizadoEm": "2026-10-27T15:39:00Z"
        },
        {
            "id": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5d",
            "documentoCedente": "11222333000181",
            "referencia": "NF 12345 03",
            "numeroFatura": "FAT 2026 001",
            "parcela": 3,
            "situacao": "recusada",
            "iud": null,
            "emitidaEm": null,
            "protocolo": "8f3c1d2e-aaaa-bbbb-cccc-1234567890ab",
            "protocoloEm": "2026-10-27T15:39:12Z",
            "situacaoEscrituradora": "Dados Inválidos",
            "situacaoEscrituradoraDescricao": "Sacador não está ativo na Base de Controle",
            "escrituradoraId": "0199a1b2-0000-7000-8000-000000000001",
            "atualizadoEm": "2026-10-27T15:42:20Z"
        }
    ]
}
Modificado em 2026-11-19 05:54:58
Página anterior
Envia as duplicatas de uma operação
Próxima página
Informa a liquidação de títulos
Built with