跳到主要内容

Submissão da Despesa

Encaminhe uma despesa para análise da QI Tech. A submissão só é necessária quando a despesa foi criada sem documentos — caso contrário, a despesa já é automaticamente encaminhada durante a criação.

Atenção
  • É obrigatório ter ao menos um documento anexado à despesa antes de submeter.
  • Somente despesas no status created podem ser submetidas por este endpoint. Despesas que já passaram pela criação com documentos estarão no status pending_adm_approval e não precisam ser submetidas novamente.

Request​

ENDPOINT
/expense_submission/fund_class/{fund_class_key}/contract/{contract_key}/expense/{expense_key}/submit
MÉTODO
PUT

Path params​

ParâmetroTipoDescrição
fund_class_keystringChave única do fundo (UUID)
contract_keystringChave única do contrato
expense_keystringChave única da despesa (UUID)

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

Response​

STATUS
200
Response Body
{
    "expense_key": "7f3e9a1b-2c4d-5e6f-8901-abcdef234567",
    "contract_key": "contrato-auditoria-2026",
    "status": "pending_adm_approval",
    "payment_method": "transfer",
    "start_deferral_date": "2026-06-02",
    "end_deferral_date": "2026-06-30",
    "description": "Honorários de auditoria referente ao 1º semestre de 2026",
    "payment": {
        "target": {
            "name": "AUDITORES EXEMPLO S.A.",
            "document_number": "12.345.678/0001-90"
        },
        "target_account": {
            "account_number": "123456",
            "account_branch": "0001",
            "account_digit": "0",
            "financial_institution_code": "341"
        },
        "transfer_type": "wire_transfer",
        "source_account": {
            "account_key": "5e621ba2-b4ac-4ddd-9893-82d220e1577e"
        }
    },
    "payment_value": 15000.00,
    "payment_date": "2026-07-01",
    "rebate_expense_key": null,
    "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"
    }
}

Atributos da resposta​

CampoTipoDescrição
statusstringNovo status da despesa. Sempre retorna pending_adm_approval após a submissão bem-sucedida.

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

Possíveis erros​

STATUS
404
Despesa não encontrada

O conjunto fund_class_key + contract_key + expense_key não corresponde a nenhuma despesa cadastrada.

{
  "title": "Expense Not Found",
  "description": "Expense with key {expense_key} was not found.",
  "translation": "A despesa com chave {expense_key} não foi encontrada.",
  "code": "ESB000016"
}
STATUS
400
Despesa sem documentos

Não há documentos anexados à despesa. Faça o upload de ao menos um documento antes de submeter.

{
  "title": "Submission Must Have At Least One Pending Analysis Document",
  "description": "Expense {expense_key} must have at least one document in pending_adm_approval or approved status.",
  "translation": "A despesa {expense_key} deve ter ao menos um documento em status pending_adm_approval ou approved.",
  "code": "ESB000025"
}
Transição de status inválida

A despesa não está no status created e não pode ser submetida por este endpoint.

{
  "title": "Cannot Update Expense In This Status",
  "description": "Expense {expense_key} cannot be updated with status {current_status}.",
  "translation": "A despesa {expense_key} não pode ser atualizada com o status {current_status}.",
  "code": "ESB000023"
}

Próximos passos​

Após submeter a despesa, aguarde a análise da QI Tech. Você pode acompanhar o status via:

Consultar a despesa — verifique o status atual da despesa.