Expense Submission
This section documents the APIs that enable the Expense Submission process for Investment Funds managed by QI CTVM. Through these APIs, you can register contracts with vendors, submit individual expenses and track the approval cycle of each entry.
Submission flow
The diagram below illustrates the steps of the flow:
Step by step
0. Vendor Registration (prerequisite)
Before creating a contract, the vendor that will provide services to the fund must be registered on the platform. This registration is performed by the QI Tech operations team. After registration, the vendor_key is made available for use in contracts.
Access the vendor registration documentation | Query registered vendors
1. Contract Creation
Create a contract linking the fund to a vendor and defining the expense type. The contract is the container that groups all expenses of the same business relationship.
Access the contract creation documentation
2. Submitting the Contract for Approval
After creating and reviewing the contract, submit it for QI Tech analysis. The contract will move to the pending_adm_approval status until it is approved or rejected.
Access the contract submission documentation
3. Expense Creation
With the contract approved, create the individual expenses providing the payment data, accrual period and supporting documents. When documents are included at creation, the expense is automatically forwarded for review.
Access the expense creation documentation
4. Document Upload (when not included at creation)
If the documents were not included when the expense was created, upload them separately before submitting.
Access the document upload documentation
5. Submitting the Expense for Approval
Submit the expense for QI Tech analysis. At least one document must be attached before submission.
Access the expense submission documentation
After the expense is approved by QI Tech, the entry is processed internally and automatically recorded in the fund's portfolio.
Contract status
| Status | Description |
|---|---|
created | Contract created, awaiting submission |
pending_adm_approval | Submitted, awaiting QI Tech analysis |
approved | Approved by QI Tech |
rejected | Rejected by QI Tech |
canceled | Canceled by the integrating agent |
Expense status
| Status | Description |
|---|---|
created | Expense created, awaiting documents or submission |
pending_adm_approval | Submitted (or created with documents), awaiting QI Tech analysis |
approved | Approved by QI Tech |
rejected | Rejected by QI Tech |
canceled | Canceled by the integrating agent |