Submissão do Contrato

Após criar o contrato, submeta-o para análise da QI Tech. A submissão encaminha o contrato para revisão manual e muda seu status para pending_adm_approval.

Atenção

Após a submissão, o contrato não pode mais ser editado. Verifique todos os dados antes de prosseguir. Caso precise fazer alterações, utilize o endpoint de atualização enquanto o status ainda for created.

Request

ENDPOINT

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

MÉTODO

PUT

Path params

Parâmetro	Tipo	Descrição
fund_class_key	string	Chave única do fundo (UUID)
contract_key	string	Chave única do contrato

Este endpoint não requer body na requisição.

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

Atributos da resposta

Campo	Tipo	Descrição
status	string	Novo status do contrato. Sempre retorna pending_adm_approval após a submissão bem-sucedida.

Os demais campos seguem a mesma estrutura da criação do contrato.

Possíveis erros

STATUS

404

Contrato não encontrado

O par fund_class_key + contract_key não corresponde a nenhum contrato cadastrado.

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

Transição de status inválida

O contrato não pode ser submetido a partir do status atual. A submissão só é permitida quando o contrato está no status created.

{
  "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"
}

Próximos passos

Após submeter o contrato, aguarde a análise da QI Tech. Enquanto isso, você pode:

1. Consultar o contrato — acompanhe o status do contrato.
2. Criar despesas — despesas podem ser criadas mesmo enquanto o contrato aguarda aprovação (exceto contratos com status rejected).