Submissão de Despesas

Esta seção documenta as APIs que viabilizam o processo de Submissão de Despesas para Fundos de Investimento administrados pela QI CTVM. Por meio dessas APIs, é possível registrar contratos com fornecedores, submeter despesas individuais e acompanhar o ciclo de aprovação de cada lançamento.

Fluxo de submissão

O diagrama abaixo ilustra as etapas do fluxo:

Passo a passo

0. Cadastro do Fornecedor (pré-requisito)

Antes de criar um contrato, o fornecedor que prestará serviços ao fundo deve estar cadastrado na plataforma. Esse cadastro é realizado pela equipe de operações da QI Tech. Após o cadastro, a vendor_key é disponibilizada para uso nos contratos.

Acessar documentação do cadastro de fornecedor | Consultar fornecedores cadastrados

1. Criação do Contrato

Crie um contrato vinculando o fundo a um fornecedor e definindo o tipo de despesa. O contrato é o contêiner que agrupa todas as despesas de uma mesma relação comercial.

Acessar documentação da criação do contrato

2. Submissão do Contrato para Aprovação

Após criar e revisar o contrato, submeta-o para análise da QI Tech. O contrato passará para o status pending_adm_approval até ser aprovado ou rejeitado.

Acessar documentação da submissão do contrato

3. Criação da Despesa

Com o contrato aprovado, crie as despesas individuais informando os dados de pagamento, período de competência e documentos comprobatórios. Ao incluir documentos na criação, a despesa é automaticamente encaminhada para revisão.

Acessar documentação da criação da despesa

4. Upload de Documentos (quando não incluídos na criação)

Caso os documentos não tenham sido incluídos na criação da despesa, faça o upload separadamente antes de submeter.

Acessar documentação de upload de documentos

5. Submissão da Despesa para Aprovação

Submeta a despesa para análise da QI Tech. É obrigatório que ao menos um documento esteja anexado antes da submissão.

Acessar documentação da submissão da despesa

Processamento interno

Após a aprovação da despesa pela QI Tech, o lançamento é processado internamente e registrado na carteira do fundo de forma automática.

Status do contrato

Status	Descrição
created	Contrato criado, aguardando submissão
pending_adm_approval	Submetido, aguardando análise da QI Tech
approved	Aprovado pela QI Tech
rejected	Rejeitado pela QI Tech
canceled	Cancelado pelo agente integrador

Status da despesa

Status	Descrição
created	Despesa criada, aguardando documentos ou submissão
pending_adm_approval	Submetida (ou criada com documentos), aguardando análise da QI Tech
approved	Aprovada pela QI Tech
rejected	Rejeitada pela QI Tech
canceled	Cancelada pelo agente integrador