Contract Submission

After creating the contract, submit it for QI Tech analysis. The submission forwards the contract for manual review and changes its status to pending_adm_approval.

Attention

After submission, the contract can no longer be edited. Check all the data before proceeding. If you need to make changes, use the update endpoint while the status is still created.

Request

ENDPOINT

/expense_submission/fund_class/{fund_class_key}/contract/{contract_key}/submit

METHOD

PUT

Path params

Parameter	Type	Description
fund_class_key	string	Unique key of the fund (UUID)
contract_key	string	Unique key of the contract

This endpoint does not require a request body.

Response

STATUS

200

Response Body

{
    "name": "Contrato de Auditoria - Exercício 2026",
    "contract_key": "contrato-auditoria-2026",
    "fund_class": {
        "name": "FUNDO DE INVESTIMENTO EM DIREITOS CREDITÓRIOS EXEMPLO",
        "manager": {
            "name": "EXEMPLO GESTORA LTDA",
            "manager_key": "a7498c6c-1893-42ec-a8f3-bc6ad0c6b52c",
            "document_number": "45.585.471/0001-47"
        },
        "fund_class_key": "4b8377d0-58ec-479f-8ee9-9f963d5c47ad",
        "document_number": "60.910.091/0001-24"
    },
    "vendor": {
        "vendor_key": "3571e292-3a83-4011-904d-20ee963022ef",
        "name": "AUDITORES EXEMPLO S.A.",
        "document_number": "12.345.678/0001-90",
        "requires_invoice": "True"
    },
    "expense_type": "audit_tax",
    "status": "pending_adm_approval",
    "contract_value": 50000.00,
    "validity_date": "2026-12-31",
    "submission_nature": "manual_submission"
}

Response attributes

Field	Type	Description
status	string	New status of the contract. Always returns pending_adm_approval after a successful submission.

The remaining fields follow the same structure as the contract creation.

Possible errors

STATUS

404

Contract not found

The fund_class_key + contract_key pair does not correspond to any registered contract.

{
  "title": "Contract Not Found",
  "description": "Contract with key {contract_key} and fund class {fund_class_key} was not found.",
  "translation": "O contrato com chave {contract_key} do fundo {fund_class_key} não foi encontrado.",
  "code": "ESB000011"
}

STATUS

400

Invalid status transition

The contract cannot be submitted from its current status. Submission is only allowed when the contract is in the created status.

{
  "title": "Invalid Contract Status Change",
  "description": "It is not possible to change the contract status from {current_status} to {new_status}.",
  "translation": "Não é possível alterar o status do contrato de {current_status} para {new_status}.",
  "code": "ESB000013"
}

Next steps

After submitting the contract, wait for the QI Tech analysis. In the meantime, you can:

1. Query the contract — track the contract status.
2. Create expenses — expenses can be created even while the contract awaits approval (except for contracts with the rejected status).