---
title: "Emissão de título bancário em lote (TB001)"
method: POST
path: "/v1/api/tb/issue"
tags: ["Títulos bancários"]
---

# Emissão de título bancário em lote (TB001)

`POST /v1/api/tb/issue`

Registra a emissão de um título bancário com alocação ao investidor.
Encaminhado ao serviço `tio-external-api` (tio-csd-external-api), path canónico `/csd-assets/v1/tb/issue`.

## Request body

- IssueRequest[]
  - `externalReference` string, required — Unique event code generated by the participant's system, used for operation traceability.
  - `assetId` string, nullable — Asset identifier generated by CERC, used for allocations after the asset has been registered. Leave blank when creating a new asset.
  - `assetType` '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8', required — Type of financial asset to be issued. - `1` = CDB (Certificate of Bank Deposit) - `2` = RDB (Bank Deposit Receipt) - `3` = LC (Bill of Exchange) - `4` = LF (Financial Bill) - `5` = LFSC (Convertible Subordinated Financial Bill) - `6` = LFSN (Non-Convertible Subordinated Financial Bill) - `7` = LCI (Real Estate Credit Bill) - `8` = LCA (Agribusiness Credit Bill)
  - `issuanceData` IssuanceData, required — Issuance-specific parameters for the issue operation.
    - `issueType` '1' | '2' | '3', required — Issue type. - `1` = MarketWithDistribution - `2` = MarketWithoutDistribution - `3` = Own
    - `regime` '1' | '2', required — Issue registration regime. - `1` = Register - `2` = Deposit
    - `settlementType` '1' | '2' | '3', required — Financial settlement type for the operation. - `1` = NoSettlement (no CERC settlement) — `settlementAgentExternalRef` must be omitted - `2` = GrossSettlement (real-time gross settlement via CERC) — `settlementAgentExternalRef` is required - `3` = NetSettlement (deferred net settlement via CERC) — `settlementAgentExternalRef` is required
  - `assetInfo` AssetInfo, required — General information about the asset being issued.
    - `operationValues` OperationValues, required — Financial values related to the TB issue operation (`assetInfo.operationValues`). Do not send `unitPrice` or `totalAmount` at the root of `IssueRequest`.
      - `quantity` integer — Total quantity of securities registered for this asset.
      - `unitPrice` number — Unit price of the security in BRL, with up to 8 decimal places and a maximum of 15 integer digits.
      - `totalAmount` number — Total financial value in BRL, with up to 2 decimal places and a maximum of 15 integer digits.
    - `issueDate` string, date, required — Security issue date in `yyyy-MM-dd` format. Must be earlier than the due date.
    - `dueDate` string, date, required — Security due date in `yyyy-MM-dd` format. Must be later than the issue date.
    - `wallet` string — Name of the asset wallet registered by the Issuing Participant in the CERC system.
    - `interestType` '1' | '2' | '3', required — Interest remuneration type. - `1` = Simple (single liquidity period) - `2` = Staggered (multiple liquidity periods with the same indexer throughout) - `3` = ParticipantCalculated (calculated by the participant)
    - `liquidityPeriods` LiquidityPeriod[], required — List of liquidity periods with their respective remuneration conditions.
      - `startDate` string, date, required — Start date of the liquidity period (`yyyy-MM-dd`). The first period must match the issue date.
      - `endDate` string, date, required — End date of the liquidity period (`yyyy-MM-dd`). The last period must match the due date. Must be later than `startDate`.
      - `indexer` '1' | '2' | '3', required — Reference indexer for the remuneration calculation in the period. - `1` = PRE (fixed rate) — `interestRate` is required; `correctionFrequency` must be omitted - `2` = DI (interbank rate) — `interestRate` must be omitted; `indexerPercentage` is required - `3` = IPCA (consumer price index) — `indexerPercentage` is required; `correctionFrequency` is required
      - `interestRate` number, nullable — Annual interest rate for the period, expressed as a percentage with up to 4 decimal places and a maximum of 4 integer digits. When `indexer` = `1` (PRE), must be greater than zero. - **Required** when `indexer` = `1` (PRE) - **Must be omitted** when `indexer` = `2` (DI)
      - `indexerPercentage` number, nullable — Percentage applied over the indexer, with up to 4 decimal places and a maximum of 4 integer digits. Must be greater than zero. **Required** when `indexer` = `2` (DI) or `3` (IPCA).
      - `correctionFrequency` '1' | '2', nullable — Frequency at which the monetary correction index is updated. - **Required** when `indexer` = `3` (IPCA) - **Must be omitted** when `indexer` = `1` or `2` - `1` = Monthly - `2` = Annual
    - `calculationModel` '1' | '2' | '3', required — Interest calculation model used for the security's remuneration. - `1` = 252E (Compound interest, annual basis of 252 business days) - `2` = 360E (Compound interest, annual basis of 360 calendar days) - `3` = 365E (Compound interest, annual basis of 365 calendar days)
    - `formOfPayment` '1', required — Payment method at maturity. - `1` = Final (single bullet payment at maturity)
    - `additionalDescription` string, nullable — Free-text field for supplementary information about the security.
  - `stakeholders` Stakeholders, required — Parties involved in the issuance operation.
    - `issuerDocument` string, required — Issuer's CNPJ or CPF, digits only, no punctuation.
    - `ownerAllocation` OwnerAllocation[], nullable — List of security allocations by creditor agent (holder agent).
      - `creditorAgentDocument` string, required — CNPJ of the creditor agent responsible for the allocation.
      - `creditorAgentQuantity` integer, required — Number of securities allocated to this agent. Must be less than or equal to the total issued quantity.
      - `creditorAgentSettlementRef` string, nullable — External reference of the settlement institution associated with this agent in the operation.
      - `allocation` Allocation[], nullable — List of end holders (investors) and their respective quantities within the agent's allocation. - **Required** when `issueType` = `1` (MarketWithDistribution)
        - `documentNumber` string, required — CNPJ or CPF of the end holder (investor) of the security, digits only, no punctuation.
        - `quantity` integer, required — Number of securities allocated to this end holder.
  - `settlementAgentExternalRef` string, nullable — External reference of the issuer's settlement institution in the settlement system. - **Required** when `settlementType` = `2` or `3` - **Must be omitted** when `settlementType` = `1`
  - `redemption` object, nullable — Early redemption condition parameters. **Required** for `assetType` = `1`, `2`, `3`, `7` or `8`.
    - `hasRedemptionCondition` '1' | '2' | '3', required — Indicates whether the security has early redemption conditions. - `1` = noCondition (no early redemption condition) - `2` = hasMarketCondition (market-based condition) — `redemptionConditions` is required - `3` = hasCondition (specific condition) — `redemptionConditions` is required
    - `redemptionConditions` RedemptionCondition[], nullable — Details of the early redemption conditions. **Required** when `hasRedemptionCondition` = `2` or `3`.
      - `startDate` string, date, required — Earliest date from which early redemption may be exercised (`yyyy-MM-dd`). Must be between `issueDate` and `dueDate`.
      - `indexerPercentage` number, required — Indexer percentage applicable on the redemption date. Maximum 4 integer digits and 4 decimal places. Must be greater than zero.
      - `interestRateOrSpread` number, required — Interest rate or spread applicable at the time of early redemption. Maximum 4 integer digits and 4 decimal places. Must be greater than zero.
  - `repurchaseAllowed` '1' | '2', nullable — Indicates whether the security allows repurchase by the issuer. **Required** for `assetType` = `5` or `6`. - `1` = Repurchase allowed — `repurchaseStartDate` may be provided - `2` = Repurchase not allowed — `repurchaseStartDate` must be omitted
  - `repurchaseStartDate` string, date, nullable — Earliest date from which the issuer may exercise the repurchase option (`yyyy-MM-dd`). - Must be between `issueDate` and `dueDate` - **Must be omitted** when `repurchaseAllowed` = `2`
  - `portfolioId` string, nullable — Identifier of the collateral portfolio linked to the security. - **Required** for `assetType` = `7` (LCI) or `8` (LCA) - **Must be omitted** for `assetType` other than `7` or `8`
  - `modalityType` '1' | '2' | '3', nullable — Regulatory modality type of the Financial Bill. **Required** for `assetType` = `4` (LF). - `1` = Linked — `linkedAsset` is required - `2` = Simple — `linkedAsset` must be omitted - `3` = Subordinated — `linkedAsset` must be omitted
  - `linkedAsset` string, nullable — Identifier of the asset to which the Financial Bill is linked. - **Required** when `modalityType` = `1` - **Must be omitted** when `modalityType` = `2` or `3`
  - `conversionClause` '1' | '2', nullable — Indicates the existence of a conversion or extinction clause. **Required** for `assetType` = `5` (LFSC) or `6` (LFSN). - `1` = Extinguishable — `maxConvertibilityLimit` and `convertibilityCriteria` must be omitted - `2` = Convertible — `maxConvertibilityLimit` and `convertibilityCriteria` are required
  - `maxConvertibilityLimit` integer, nullable — Maximum number of securities eligible for conversion into shares. - **Required** when `conversionClause` = `2` - **Must be omitted** when `conversionClause` = `1`
  - `convertibilityCriteria` string, nullable — Description of the rules and conditions governing the conversion of securities into shares. **Required** when `conversionClause` = `2`.

## Response `207`

Multi-Status

- object[]
  - `externalReference` string, required — Unique reference code generated by the participant's system, echoed from the request.
  - `operationDate` string, date-time, required — Date and time of operation processing in `yyyy-MM-ddThh:mm:ss.sss` format.
  - `protocol` string, required — Internal tracking identifier generated by the CERC system, used for processing traceability.
  - `assetId` string, nullable — Asset identifier generated by CERC. Populated only when the operation results in the creation of a new asset.
  - `errors` object[], nullable — Failure list when `status` = `2`, or additional information about the operation.
    - `code` string, required — Application error code.
    - `message` string, required — Error description.
  - `status` '1' | '2', required — Operation processing status. - `1` = ACCEPTED - `2` = REJECTED

## Other responses

- `401` — Unauthorized
- `404` — Not Found

---

[API](https://skmtc.net/cerc/apis/receb-veis-de-arranjo-de-pagamento-institui-es-financeiras-d.md) · [All operations](https://skmtc.net/cerc/apis/receb-veis-de-arranjo-de-pagamento-institui-es-financeiras-d/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cerc/receb-veis-de-arranjo-de-pagamento-institui-es-financeiras-d/revisions/98997c37ec38/schema)