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
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 |