# QI Tech — Investment-as-a-Service › Emissões Documentação da QI Tech em texto corrido, para colar em um LLM. Fonte: https://docs.qitech.com.br 4 página(s). Índice: - Emissões - Integralização (/documentation/iaas/emissoes/cadastrar_boleta) - Cadastro de Ativos - Emissões (/documentation/iaas/emissoes/cadastro_ativo) - Confirmação de Emissão (/documentation/iaas/emissoes/confirmacao_emissao) - Introdução (/documentation/iaas/emissoes/inicio) --- # Emissões - Integralização URL: /documentation/iaas/emissoes/cadastrar_boleta --- ## Integralização Utilizando o endpoint a seguir, é possível iniciar a integralização em uma emissão. ### Request ENDPOINT /trade_security/fund_class/FUND_CLASS_KEY/integralization MÉTODO POST ```json title="Request Body" { "security_external_id": "a23c006c-befd-40e0-bc3d-fbd2dfbbea5d", "bookkeeper_document_number": "00.000.000/0000-00", "security_key": "272a394a-e3d0-4484-b00e-e18a4e22bb5e", "unit_price": "2.00", "number_of_units": "100.00", "external_id": "90b679c0-2674-4cad-917a-5c786b0bf992", "integralization_date": "2025-05-27", "payment": { "target_account": { "account_branch": "0001", "account_digit": "0", "account_number": "12345", "financial_institution_code": "329", "financial_institution_ispb": "32402502" } } } ``` ### Definições #### Operação de Compra | Campo | Tipo | Descrição | Obrigatório | | ------------------------------| ------ | ------------------------------------------------ | ----------- | | `security_external_id` | string | Identificador externo do ativo | Sim* | | `bookkeeper_document_number` | string | Número do CNPJ do escriturador | Sim* | | `security_key` | string | Chave interna do ativo | Sim* | | `unit_price` | float | Valor unitário na integralização | Sim | | `number_of_units` | float | Número de unidades compradas | Sim | | `external_id` | string | Identificador externo da operação de compra | Sim | | `integralization_date` | string | Data da integralização | Sim | | `payment` | dict | Objeto de [pagamento](#pagamento) para liquidação| Sim | :::note ⚠️ **Importante** ( * ) A identificação do ativo estruturado pode ser feita de duas formas: 1. Informando o campo `security_key` **(chave interna)**; **ou** 2. Informando **ambos** os campos `security_external_id` e `bookkeeper_document_number`. Pelo menos **uma das formas de identificação** deve estar presente no payload. Caso ambas estejam presentes, será considerada a chave interna como prioritária. ::: ##### Pagamento | Campo | Tipo | Descrição | Obrigatório | | ---------------------------- | ------ | --------------------------------------------------- | ----------- | | `target_account` | string | Objeto de [conta bancária](#conta-bancária) para liquidação | Sim | ##### Conta bancária | Campo | Tipo | Descrição | Obrigatório | | ---------------------------- | ------ | --------------------------------------------------- | ----------- | | `account_branch` | string | Agência da conta bancária | Sim | | `account_digit` | string | Dígito verificador da conta | Sim | | `account_number` | string | Número da conta bancária | Sim | | `financial_institution_code` | string | Código da instituição financeira | Sim | | `financial_institution_ispb` | string | Código ISPB da instituição financeira | Sim | ### Response STATUS 201 ```json title='Response Body' { "integralization_key": "1568b67b-088e-43be-938b-0f817b805f7a", "external_id": "90b679c0-2674-4cad-917a-5c786b0bf992", "status": "pending_administrator_approval", } ``` --- # Cadastro de Ativos - Emissões URL: /documentation/iaas/emissoes/cadastro_ativo --- ## Criação - Nota Comercial Utilizando o endpoint a seguir, é possível cadastrar uma nova nota no orquestrador de ativos estruturados. Os ativos cadastrados surgem no status **pre_operational** para que sejam submetidos os documentos relacionados ao ativo. Deste modo, é possível pré cadastrar um ativo e habilitá-lo para operação somente após as devidas formalizações estarem concluídas, como detalhado no próximo segmento. A seguir consta uma listagem explicativa dos campos, e o detalhamento de suas obrigatoriedades e tipos. ### Request ENDPOINT /security/security MÉTODO POST ```json title='Request Body' { "external_id": "string", "asset_type": "commercial_paper", "b3_code":"25M000000", "isin_code":"BR00ABCDE000", "contract_number": "SCR12345", "ipoc_code": "string", "maturity_date": "YYYY-MM-DD", "allowed_managers": ["00.000.000/0000-00", "00.000.000/0000-00", "00.000.000/0000-00"], "allowed_consultants": ["00.000.000/0000-00", "00.000.000/0000-00", "00.000.000/0000-00"], "issuer_document_number": "00.000.000/0000-00", "bookkeeper_document_number": "00.000.000/0000-00", "number_of_units": 1, "principal_unit_price": 1000000.00, "issue_value": 1000000.00, "issue_unit_price": 1000000.00, "issue_date": "YYYY-MM-DD", "amortization_type": "sac", "installments": [ { "installment_number": 1, "maturity_date": "YYYY-MM-DD", "principal_unit_price": 1000000.00, "face_unit_price": 1010000.00, "amortization_percentage": 1 } ], "delay": { "fine": { "fine_type": "percentage", "percentage_value": 0.0 }, "interest": { "method": "compound", "pre_fixed": { "monthly_rate": 0.0, "calendar_base": "calendar_360" } } }, "pre_fixed": { "monthly_rate": 0.01, "calendar_base": "calendar_360" }, "post_fixed": { "lag": { "amount": 1, "reference": "daily" }, "rate": 1, "indexer": "di", "calendar_base": "workdays" } } ``` ## Definições ### Objeto Ativo (Request Body) | Campo | Tipo | Descrição | Obrigatório | | ------------------------------| ------ | ------------------------------------------------ | ----------- | | `asset_type` | string | Enumerador que determina o [Tipo de Ativo](#enumerador-tipo-de-ativo) | Sim | | `external_id` | string | Identificador externo do ativo; Chave utilizada para acessar a entidade | Sim | | `b3_code` | string | Código cetip do ativo | Não | | `isin_code` | string | Código ISIN (International Securities Identification Number) | Não | | `ipoc_code` | string | Código IPOC do ativo | Não | | `allowed_managers` | list | Lista com CNPJ's de gestores com permissão de operar na emissão | Não | | `allowed_consultants` | list | Lista com CNPJ's de consultores com permissão de operar na emissão | Não | | `issuer_document_number` | string | Número do CNPJ ou CPF do emissor | Sim | | `bookkeeper_document_number` | string | Número do CNPJ do escriturador | Sim | | `number_of_units` | float | Número de unidades | Sim | | `issue_unit_price` | float | Preço unitário na emissão | Sim | | `issue_value` | float | Valor do ativo na emissão | Sim | | `principal_unit_price` | float | Valor unitário de princial do ativo na emissão | Sim | | `issue_date` | string | Data de emissão no formato `YYYY-MM-DD` | Sim | | `disbursement_date` | string | Data de emissão no formato `YYYY-MM-DD` | Sim | | `amortization_type` | string | Enumerador de [Tipo de Amortização](#enumerador-tipo-de-amortização) | Sim | | `contract_number` | string | Número do contrato | Sim | | `maturity_date` | string | Data de vencimento do ativo | Sim | | `installments` | dict | Objeto de [parcelas](#objeto-de-parcela) | Sim | | `delay` | dict | Objeto de [atraso](#objeto-atraso) | Sim | | `pre_fixed` | dict | Objeto de [pré fixado](#objeto-pré-fixado) | Sim | | `post_fixed` | dict | Objeto de [pós fixado](#objeto-pós-fixado) | Não | #### Enumerador Tipo de Ativo | Enumerador | Descrição | |--------------|---------------| | **commercial_paper** | Ativo do tipo Nota Comercial | | **debenture** | Ativo do tipo Debênture | | **cri** | Ativo do tipo CRI | | **cra** | Ativo do tipo CRA | #### Enumerador Tipo de Amortização | Enumerador | Descrição | |--------------|---------------| | **sac** | Amortização do tipo SAC | | **price** | Amortização do tipo Price | #### Objeto de Parcela | Campo | Tipo | Descrição | Obrigatório | | ------------------------------- | ------ | -------------------------------------------| ----------- | | `installment_number` | int | Número da Parcela | Sim | | `maturity_date` | string | Data de Vencimento no formato `YYYY-MM-DD` | Sim | | `principal_unit_price` | float | Valor de principal unitário do ativo | Sim | | `face_unit_price` | float | Valor de face unitário do ativo | Sim | | `amortization_percentage` | float | Porcentagem de Amortização | Não | #### Objeto Atraso | Campo | Tipo | Descrição | Obrigatório | |-|-|-|-| | `fine` | object | Objeto da multa no vencimento. Ver **[Objeto Multa de Atraso](#objeto-multa-de-atraso)**. | Sim | | `interest` | object | Objeto do juros de mora. Ver **[Objeto Juros de Mora](#objeto-juros-de-mora)**. | Sim | #### Objeto Multa de Atraso | Campo | Tipo | Descrição | Obrigatório | |-|-|-|-| | `fine_type` | string | Tipo de Multa. | Sim | | `percentage_value` | number | Valor da Multa, se tipo da multa for `percentage`. Unidade de medida: de 0 à 1, considerando 0 à 100% | Sim | | `amount` | number | Valor da Multa, se tipo de multa for `fixed`. | Sim | ##### Enumerador Tipo da Multa | Enumerador | Descrição | |----------------|-------------------------------------------| | **percentage** | Multa percentual sobre o valor da parcela | | **fixed** | Valor fixo de Multa | #### Objeto Juros de Mora | Campo | Tipo | Descrição | Obrigatório | |-|-|-|-| | `method` * | string | Ver **[Enumerador Método do Juros de Mora](#enumerador-método-do-juros-de-mora)**. | Sim | | `pre_fixed` * | object | Ver **[Objeto de Pré Fixado](#objeto-pré-fixado)**. | Sim | ##### Enumerador Método do Juros de Mora | Enumerador | Descrição | |--------------|-----------------------------| | **compound** | Para juros de mora composto | | **simple** | Para juros de mora simples | #### Objeto Pré Fixado | Campo | Tipo | Descrição | Obrigatório | |-|-|-|-| | `calendar_base` *| string | A base de cálculo utilizada. | enumerator | | `monthly_rate` * | number | A taxa mensal do contrato. Para 1% usar 0.01 | Até 8 casas decimais | #### Objeto Pós Fixado | Campo | Tipo | Descrição | Obrigatório | |---------------|--------|-----------------------------------------------------|-------------| | rate | int | Taxa fixa aplicada | Sim | | indexer | string | Índice de referência da correção (di, ipca) | Sim | | calendar_base | string | Tipo de calendário considerado | Sim | #### Objeto de Lag | Campo | Tipo | Descrição | Obrigatório | |-----------|--------|------------------------------------------------|-------------| | amount | int | Quantidade de unidades de defasagem | Sim | | reference | string | Unidade de tempo de defasagem | Sim | #### Enumerador Base de Cálculo | Enumerador | Descrição | |--------------|---------------| | **daily** | Para valores diários de atraso | | **monthly** | Para valores mensais de atraso | #### Enumerador Referência de Atraso | Enumerador | Descrição | |--------------|---------------| | **workdays** | Para base de cálculo dias úteis (252) | | **calendar_365** | Para base de cálculos 365 | | **calendar_360** | Para base de cálculos 360 | ### Response STATUS 201 ```json title='Response Body' { "security_key": "41d6ff41-1dac-4df7-9e50-d15210ec57f3", "status": "pre_operational", } ``` --- # Confirmação de Emissão URL: /documentation/iaas/emissoes/confirmacao_emissao ## Confirmação - Nota Comercial Após ter finalizado todas formalizações, e registrar os devidos documentos no ativo, é possível aprová-lo, sinalizando que está pronto para seguir com operações. Vale ressaltar que operações de compra podem ser lançadas em ativos pré operacionais, mas estas não poderão ser liquidadas até que a emissão do ativo esteja confirmada. ### Request ENDPOINT /security/security/EXTERNAL_ID/confirm MÉTODO PUT ```json title="Request Body" { "bookkeeper_document_number": "00.000.000/0000-00" } ``` | Campo | Tipo | Descrição | Obrigatório | | ------------------------------| ------ | ---------------------------------------------------- | ----------- | | `bookkeeper_document_number` | string | CNPJ do escriturador para a identificação da emissão | Sim | #### Definição ### Response STATUS 202 ```json title='Response Body' { "security_key": "41d6ff41-1dac-4df7-9e50-d15210ec57f3", "status": "active", } ``` --- # Introdução URL: /documentation/iaas/emissoes/inicio O ecossistema de emissões é o responsável pela criação, compra, venda e pagamentos de ativos como Notas Comerciais, Debêntures, CRIs e CRAs. As funcionalidades disponíveis para utilização são: - Cadastrar um novo ativo pré operacional; - Confirmar a emissão; - Criar boleta de compra ou venda; Esta documentação fornece uma visão detalhada sobre como utilizar o sistema de emissões, incluindo seus principais recursos e fluxos. Para começar a utilizar o sistema, navegue pelos tópicos disponíveis nesta documentação para entender melhor cada aspecto do módulo de cotas de fundo.