Criação de ativo — cheque e nota promissória

Insere num lote de cessão um cheque (check) ou uma nota promissória (promissory_note). Os dois usam o mesmo endpoint e o mesmo corpo; muda só o nome do objeto do título.

Cheque e nota promissória são títulos de crédito: o próprio papel é a prova da dívida, sem nota fiscal por trás. O cheque (Lei 7.357/1985) é uma ordem de pagamento do emitente ao banco; no comércio, circula como cheque pré-datado e é cedido pela data combinada para o depósito. A nota promissória (Lei Uniforme, Decreto 57.663/1966) é uma promessa de pagamento do emitente ao credor, comum em vendas a prazo e em confissões de valor. Em ambos o devedor é o emitente, que nesta API é o sacado (borrower).

Disponível em

Perfil	Host	Permissão exigida
Gestora	manager-api	Escrita
Consultoria	consultant-api	Lotes
Cedente	assignor-api	Escrita

URL base de cada host: Ambientes (Hosts).

Onde estou no fluxo?

Este é o 2º passo do fluxo de cessão. Antes, você deve ter criado o lote numa configuração de cessão do tipo check ou promissory_note. Depois, envie o lastro de cada título e encerre a inserção.

O que muda em relação à duplicata

	Duplicata	Cheque e nota promissória
Documento do recebível	objeto invoice (nota fiscal), obrigatório	objeto check ou promissory_note, obrigatório; invoice e contract são recusados
order_number	número do pedido	número do título no seu sistema, obrigatório
Registro em registradora	conforme a configuração	não há registradora: a configuração usa sempre skip_registry
Boleto e multa/juros por atraso	aceitos	não se aplicam: não envie bankslip nem delay
Recompra e termo de cessão	identificados pela nota	identificados pelo número do título (check.number ou promissory_note.number)

O cheque e a nota promissória têm um vencimento por ativo: cada título é um ativo, com um face_value e um maturity_date.

Request

ENDPOINT

/trade_receivables/fund_class/{fund_class_key}/assignment_configuration/{assignment_configuration_key}/assignment/{assignment_external_id}/asset

MÉTODO

POST

Request Body — cheque

{
    "asset_type": "check",
    "total_purchase_value": 918.72,
    "discounted_credit_right": {
        "external_id": "CHQ-0003848171",
        "originator_document_number": "11.222.333/0001-81",
        "order_number": "0003848171",
        "face_value": 937.01,
        "maturity_date": "2026-12-10",
        "participant_control_number": "CHQ0003848171",
        "check": {
            "number": "3848171",
            "issue_date": "2026-08-26",
            "bank_code": "341",
            "agency": "01234",
            "account": "123456"
        },
        "borrower": {
            "name": "Empresa Exemplo Ltda",
            "document_number": "11.444.777/0001-61",
            "person_type": "legal_person",
            "email": "financeiro@exemplo.com.br",
            "address": {
                "street": "Avenida Paulista",
                "number": "1000",
                "neighborhood": "Bela Vista",
                "city": "São Paulo",
                "uf": "SP",
                "postal_code": "01310-100",
                "country": "BRA"
            },
            "phone": {
                "area_code": "11",
                "number": "36360268"
            }
        }
    }
}

Para uma nota promissória, troque o asset_type e o objeto do título. A nota promissória não tem banco, agência nem conta:

Request Body — nota promissória (trecho que muda)

{
    "asset_type": "promissory_note",
    "total_purchase_value": 4750.00,
    "discounted_credit_right": {
        "external_id": "NP-000123",
        "order_number": "NP-000123",
        "face_value": 5000.00,
        "maturity_date": "2027-02-15",
        "promissory_note": {
            "number": "000123",
            "issue_date": "2026-11-05"
        }
    }
}

O restante do discounted_credit_right (originador, sacado) é igual ao do cheque.

Atributos do body

Campo	Tipo	Obrigatoriedade	Descrição
asset_type	string	obrigatório	check ou promissory_note. Precisa ser o tipo da configuração de cessão.
total_purchase_value	number	obrigatório	Quanto o fundo paga pelo título. Até 2 casas decimais.
discounted_credit_right	object	obrigatório	Dados do título. Veja abaixo.

Atributos de discounted_credit_right

Campo	Tipo	Obrigatoriedade	Descrição
external_id	string	obrigatório	Identificador do título no seu sistema, até 50 caracteres. Não confunda com o external_id do lote.
originator_document_number	string	obrigatório	CPF ou CNPJ formatado do originador. Precisa estar cadastrado na QI Tech (TRC000019).
order_number	string	obrigatório	Número do título no seu sistema, até 45 caracteres (TRC000183).
face_value	number	obrigatório	Valor de face: quanto o emitente paga no vencimento.
maturity_date	string	obrigatório	Vencimento, em YYYY-MM-DD. No cheque pré-datado, a data combinada para o depósito.
check	object	obrigatório em check	Dados do cheque. Veja Atributos de check.
promissory_note	object	obrigatório em promissory_note	Dados da nota promissória. Veja Atributos de promissory_note.
participant_control_number	string	opcional	Número de controle do título no seu sistema, até 25 caracteres. No cheque, é obrigatório quando o lastro da sua configuração é conferido por certificadora externa; na dúvida, envie sempre, com valor único.
person_type	string	opcional	Tipo de pessoa do sacado: natural_person ou legal_person.
borrower	object	obrigatório	O emitente do título. Consulte os Atributos de borrower.

Não envie invoice nem contract: com qualquer um dos dois o ativo é recusado com TRC000076.

Atributos de check

Campo	Tipo	Obrigatoriedade	Descrição
number	string	obrigatório	Número do cheque, 1 a 20 caracteres (TRC000182).
issue_date	string	opcional	Data de emissão, em YYYY-MM-DD. A elegibilidade usa esta data nas regras que dependem da emissão do título; envie sempre que tiver.
bank_code	string	opcional	Código do banco sacado, até 3 caracteres.
agency	string	opcional	Agência, até 5 caracteres.
account	string	opcional	Conta, até 20 caracteres.

Campos fora desta lista são recusados com QIT000001.

Atributos de promissory_note

Campo	Tipo	Obrigatoriedade	Descrição
number	string	obrigatório	Número da nota promissória, 1 a 20 caracteres (TRC000182).
issue_date	string	opcional	Data de emissão, em YYYY-MM-DD. Envie sempre que tiver, pelo mesmo motivo do cheque.

Só esses dois campos são aceitos: banco, agência e conta são recusados com QIT000001.

Response

STATUS

201

Response Body

{
    "asset_key": "41d6ff41-1dac-4df7-9e50-d15210ec57f3",
    "external_id": "CHQ-0003848171",
    "status": "pending_eligibility"
}

Campo	Tipo	Descrição
asset_key	string	Identificador do ativo na QI Tech (UUID).
external_id	string	O external_id enviado no discounted_credit_right.
status	string	Sempre pending_eligibility: o ativo foi inserido e aguarda a elegibilidade.

Depois da cessão

• Consulta pelo número do título. Na consulta de ativos do lote, o filtro de número de contrato também encontra o cheque e a nota promissória pelo number do título.
• Pagamento. Sem boleto, a liquidação é informada por você em Liquidação de ativos, com o asset_type check ou promissory_note.
• Recompra e substituição. Como nos demais títulos, a recompra é do título inteiro: veja Criação do Ativo — Substituição.
• Por arquivo. O mesmo lote pode ser enviado de uma vez por CNAB 444 ou pelo CSV de duplicatas e títulos.

Erros

Status	Código	Quando acontece
400	QIT000001	O body não segue o formato: campo com tipo ou tamanho inválido, ou campo não aceito no objeto do título.
404	TRC000015	O asset_type não existe.
400	TRC000075	Falta o objeto do título: check num cheque, promissory_note numa nota promissória.
400	TRC000182	Falta o number dentro do objeto do título.
400	TRC000183	Falta o order_number.
400	TRC000076	O título veio com invoice ou contract.
400	TRC000025	O asset_type é diferente do tipo da configuração de cessão.
400	TRC000022	O lote não aceita mais ativos: a inserção já foi encerrada.
404	TRC000018	Não existe lote com esse assignment_external_id nesta configuração.
400	TRC000009	CPF ou CNPJ inválido no originador ou no sacado pessoa física.
404	TRC000019	Não há originador cadastrado com o originator_document_number.
409	TRC000054	Já existe um ativo com esse external_id neste lote.
409	TRC100026	Já existe um direito creditório com esse external_id para o mesmo cedente na carteira do fundo.
4xx	TRC1000xx	A validação financeira do ativo recusou o título. Exemplo: TRC100017 (409), o fundo não compra ativos vencidos.

O corpo de erro e a orientação de reenvio são os mesmos da Criação de Ativo — Duplicata. Erros de autenticação, permissão e host: Erros da API.

Aviso Importante!

Não use dados reais de pessoas físicas ou jurídicas (CPF, CNPJ, números de cheque) em sandbox.