# QI Tech — Investment-as-a-Service › Recompra e venda de ativos Documentação da QI Tech em texto corrido, para colar em um LLM. Fonte: https://docs.qitech.com.br 4 página(s). Índice: - Criação de um ativo a ser recomprado/vendido (/documentation/iaas/venda_ativos/asset/criacao_recompra) - Criação de um lote de recompra (/documentation/iaas/venda_ativos/assignment/criacao_recompra) - Encerrar Inserção de Ativos (/documentation/iaas/venda_ativos/assignment/fechamento_recompra) - Recompra e Venda de Ativos (/documentation/iaas/venda_ativos/inicio) --- # Criação de um ativo a ser recomprado/vendido URL: /documentation/iaas/venda_ativos/asset/criacao_recompra --- ### Request ENDPOINT /trade_resolve/fund_class/FUND_CLASS_KEY/assignment/EXTERNAL_ID/asset MÉTODO POST ```json title='Request Body' { "external_id": "931e9437-d025-41ab-bb53-6b94e10fd361", "sale_value": 1234.56 } ``` :::info O external_id informado na payload deve corresponder ao external_id de um ativo que está presente na carteira do fundo. ::: #### Body Params | Campo | Tipo | Descrição | Caracteres | |-|-|-|-| | `external_id` * | string | Chave única de identificação do ativo a ser recomprado/vendido informada pelo parceiro. | Até 50 | | `sale_value` *| float | Valor pelo qual o ativo será baixado | 2 casas decimais | ### Response STATUS 201 ```json title='Response Body' { "assignment_key": "41d6ff41-1dac-4df7-9e50-d15210ec57f3", "status": "pending_assets_insertion", } ``` --- # Criação de um lote de recompra URL: /documentation/iaas/venda_ativos/assignment/criacao_recompra --- ### Request ENDPOINT /trade_resolve/fund_class/FUND_CLASS_KEY/assignment MÉTODO POST ```json title='Request Body' { "external_id": "931e9437-d025-41ab-bb53-6b94e10fd361", "assignment_date": "2024-04-01", "assignment_configuration_key": "d9308a2b-21fa-4724-9bbe-59ae65287b10", "source_account":{ "document_number": "95.031.521/0001-12" } } ``` #### Body Params | Campo | Tipo | Descrição | Caracteres | |-|-|-|-| | `external_id` * | string | Chave única de identificação deste lote no sistema do parceiro integrador. | Até 50 | | `assignment_date` *| string | Data da recompra | YYYY-MM-DD | | `assignment_configuration_key` *| string | Chave única fornecida pela CTVM | 36 | | `source_account` *| objeto | Objeto da conta que irá realizar o pagamento ao fundo | - | ### Objeto de source account | Campo | Tipo | Descrição | Caracteres | |-|-|-|-| | `document_number` * | string | Número do documento da conta que irá realizar o pagamento ao fundo. | Até 18 | ### Response STATUS 201 ```json title='Response Body' { "assignment_key": "41d6ff41-1dac-4df7-9e50-d15210ec57f3", "status": "pending_assets_insertion", } ``` --- # Encerrar Inserção de Ativos URL: /documentation/iaas/venda_ativos/assignment/fechamento_recompra ### Request ENDPOINT /trade_resolve/fund_class/FUND_CLASS_KEY/assignment/EXTERNAL_ID MÉTODO PUT ```json title='Request Body' { "assignment_status": "completed_assets_insertion" } ``` ### Response STATUS 201 ```json title='Response Body' { "assignment_key": "41d6ff41-1dac-4df7-9e50-d15210ec57f3", "status": "completed_assets_insertion", } ``` --- # Recompra e Venda de Ativos URL: /documentation/iaas/venda_ativos/inicio Esta seção documenta as APIs que viabilizam a **venda e a recompra de direitos creditórios** já encarteirados nos fundos administrados pela QI CTVM. O fluxo abrange desde a criação do lote até a baixa dos ativos da carteira do fundo. :::tip Contexto Este serviço apenas **baixa os ativos da carteira** do fundo. Ele não envia dados para outras administradoras. Existem dois conceitos fundamentais: o **lote** (`assignment`) e o **ativo** (`asset`). Um lote é composto por um ou mais ativos, e cada ativo inserido precisa já estar na carteira do fundo. ::: :::info Pré-requisitos - Para ter acesso a esses serviços, entre em contato com [integracao.dtvm@qitech.com.br](mailto:integracao.dtvm@qitech.com.br) para liberação dos ambientes de Homologação (Sandbox) e Produção. - Você precisará da `fund_class_key` (chave do fundo), que compõe a URL base de todos os endpoints desta API, e da `assignment_configuration_key` (chave da configuração), informada na criação do lote: ``` /trade_resolve/fund_class/{fund_class_key} ``` ::: ## Fluxo de venda/recompra O diagrama abaixo mostra o caminho principal, as bifurcações e o status resultante de cada etapa. Passe o mouse em um nó para ver o endpoint e clique para abrir a documentação. 5%', dashed: true }, { from: 'validacao', to: 'encerramento', label: 'confirmado', dashed: true }, { from: 'ativos', to: 'encerramento' }, { from: 'encerramento', to: 'descartado', label: 'discarded', tone: 'end' }, { from: 'encerramento', to: 'termo', label: 'encerrado', tone: 'ok' }, { from: 'termo', to: 'credito', label: 'assinado' }, { from: 'credito', to: 'baixa', label: 'pago' }, ]} /> ## Passo a passo ### 1. Criação do Lote Crie o lote informando um identificador único (`external_id`), a data da operação e a conta que fará o pagamento ao fundo. O lote nasce em `pending_assets_insertion` e é o contêiner de todos os ativos que serão baixados. **[Acessar documentação da criação do lote](/documentation/iaas/venda_ativos/assignment/criacao_recompra)** ### 2. Inserção dos Ativos Insira um ativo por requisição, identificando-o pelo mesmo `external_id` com que ele foi encarteirado. O ativo precisa estar **ativo** na carteira do fundo no momento da inserção. **[Acessar documentação da inserção de ativos](/documentation/iaas/venda_ativos/asset/criacao_recompra)** :::caution Divergência de preço acima de 5% Se o preço de venda informado divergir em **mais de 5%** do valor justo contábil do ativo, o ativo não segue automaticamente: ele fica em `pending_validation` e exige uma confirmação explícita do integrador antes de entrar na baixa. Divergências de até 5% seguem direto para `pending_wallet_sale`. O endpoint de confirmação ainda não está documentado nesta seção — se o seu fluxo pode gerar divergências acima de 5%, alinhe o procedimento com [integracao.dtvm@qitech.com.br](mailto:integracao.dtvm@qitech.com.br). ::: ### 3. Encerramento do Lote Após inserir todos os ativos, encerre o lote. É necessário ter ao menos um ativo não descartado. Opcionalmente, você pode enviar `number_of_assets` e `total_value` para que a API confira a quantidade e o valor total consolidados antes de aceitar o encerramento. O descarte do lote está disponível **até esta etapa**: depois que o termo entra em circulação, o lote não pode mais ser descartado. **[Acessar documentação do encerramento](/documentation/iaas/venda_ativos/assignment/fechamento_recompra)** ### 4. Termo de Recompra O responsável pela emissão do Termo de Recompra depende da configuração do lote: - **Termo interno** — a QI Tech gera o termo e coleta as assinaturas das partes. Nenhuma ação do integrador é necessária. - **Termo externo** — o lote passa para `pending_signed_term_submission` e o integrador precisa enviar o termo já assinado para que o fluxo prossiga. Em ambos os casos, com o termo assinado o lote passa a `pending_payment`, aguardando o crédito na conta do fundo. ### 5. Pagamento e Baixa dos Ativos As etapas finais são automatizadas: a QI Tech confirma o crédito na conta do fundo, os ativos são baixados da carteira e, quando todos os ativos são concluídos, o lote é encerrado em `completed`.