Sign in

v1

latestOpenAPI 3.1.12026-07-2371254470.9 KB
Títulos bancários

Antecipação de título bancário em lote (TB002)

Registra antecipação (resgate antecipado ou recompra) sobre título emitido. Encaminhado ao serviço tio-external-api (tio-csd-external-api), path canónico /csd-assets/v1/tb/anticipation.

post/v1/api/tb/anticipation

Request body

externalReferencestring required

Unique event code generated by the participant's system, used for operation traceability.

assetIdstring required

Identifier of the asset on which the anticipation will be performed.

anticipationType'1' | '2' required

Type of anticipation operation.

  • 1 = Redemption (early redemption by the investor)
  • 2 = Repurchase (buyback by the issuer)
counterpartyDocumentstring nullable

CNPJ or CPF of the counterparty agent involved in the anticipation operation, digits only, no punctuation.

settlementType'1' | '2' | '3' required

Financial settlement type for the operation.

  • 1 = NoSettlement (no settlement) — settlementAgentExternalRef must be omitted
  • 2 = GrossSettlement (real-time gross settlement)
  • 3 = NetSettlement (deferred net settlement)
settlementAgentExternalRefstring nullable

External reference of the institution responsible for the financial settlement of the operation.

  • Must be omitted when settlementType = 1
ownerAgentDocumentstring nullable

CNPJ of the counterparty's agent (holder) of the securities involved in the anticipation, digits only, no punctuation.

ownerDocumentstring nullable

CNPJ or CPF of the investor (end holder) of the securities subject to the anticipation, digits only, no punctuation.

Response

Multi-Status

externalReferencestring required

Unique reference code generated by the participant's system, echoed from the request.

operationDatestring date-time required

Date and time of operation processing in yyyy-MM-ddThh:mm:ss.sss format.

protocolstring required

Internal tracking identifier generated by the CERC system, used for processing traceability.

assetIdstring nullable

Asset identifier generated by CERC. Populated only when the operation results in the creation of a new asset.

status'1' | '2' required

Operation processing status.

  • 1 = ACCEPTED
  • 2 = REJECTED