Criação do Contrato

Este é o primeiro passo do fluxo de submissão de despesas pelo agente integrador. O contrato define a relação comercial entre o fundo e um fornecedor, estabelecendo o tipo de despesa e as condições de pagamento.

Pré-requisitos

Antes de criar um contrato, você precisa ter em mãos:

• fund_class_key — chave única do fundo, fornecida pela QI Tech
• vendor_key — chave do fornecedor cadastrado. Consulte a listagem de fornecedores para obtê-la

Para mais detalhes sobre o fluxo completo, consulte a página de introdução.

Atenção

O campo submission_nature = rebate só pode ser utilizado em conjunto com expense_type = distribution_fee. Para todos os demais tipos de despesa, use submission_nature = manual_submission.

Request

ENDPOINT

/expense_submission/fund_class/{fund_class_key}/contract

MÉTODO

POST

Path params

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

Request Body

{
    "name": "Contrato de Auditoria - Exercício 2026",
    "vendor_key": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "expense_type": "audit_tax",
    "submission_nature": "manual_submission",
    "contract_value": 50000.00,
    "validity_date": "2026-12-31",
    "contract_key": "contrato-auditoria-2026"
}

Atributos do body

Campo	Tipo	Obrigatoriedade	Descrição
name	string	obrigatório	Nome do contrato. Máximo de 255 caracteres.
vendor_key	string	obrigatório	Chave única do fornecedor (máximo 255 caracteres).
expense_type	string	obrigatório	Tipo de despesa. Ver Tipos de despesa.
submission_nature	string	obrigatório	Natureza de submissão: manual_submission ou rebate.
contract_value	number	opcional	Valor máximo do contrato. Quando informado, a soma das despesas não pode exceder este valor. Mínimo: 0.
validity_date	string	opcional	Data de validade do contrato no formato YYYY-MM-DD. Após esta data, nenhuma nova despesa pode ser criada.
contract_key	string	opcional	Identificador personalizado do contrato no sistema do parceiro. Máximo de 255 caracteres. Quando não informado, um UUID é gerado automaticamente.

Tipos de despesa

Valor	Descrição
cvm_tax	Taxa CVM
cetip_tax	Taxa CETIP
anbima_tax	Taxa ANBIMA
notary	Cartório
audit_tax	Taxa de auditoria
administration_tax	Taxa de administração
management_tax	Taxa de gestão
bank_account	Conta bancária
selic_tax	Taxa SELIC
consulting_fee	Honorários de consultoria
custody_tax	Taxa de custódia
performance_fee	Taxa de performance
bankslip_fee	Taxa de boleto
sale_commission_tax	Comissão de venda
certifier_fee	Honorários de certificador
rating_agency_fee	Taxa de agência de rating
lawyer_fee	Honorários advocatícios
bookkeeping_fee	Taxa de escrituração
distribution_fee	Taxa de distribuição
insurance_fee	Taxa de seguro
collection_agent_fee	Honorários de agente de cobrança
servicing_fee	Taxa de serviços
fund_structuring_fee	Taxa de estruturação do fundo
credit_rights_registration_fee	Taxa de registro de direitos creditórios
origination_fee	Taxa de originação

Response

STATUS

201

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": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "name": "AUDITORES EXEMPLO S.A.",
        "document_number": "12.345.678/0001-90",
        "requires_invoice": "True"
    },
    "expense_type": "audit_tax",
    "status": "created",
    "contract_value": 50000.00,
    "validity_date": "2026-12-31",
    "submission_nature": "manual_submission"
}

Atributos da resposta

Campo	Tipo	Descrição
name	string	Nome do contrato.
contract_key	string	Chave única do contrato. Guarde este valor para as próximas etapas.
fund_class	object	Dados do fundo associado. Veja Atributos de fund_class.
vendor	object	Dados do fornecedor. Veja Atributos de vendor.
expense_type	string	Tipo de despesa do contrato.
status	string	Status inicial do contrato. Sempre retorna created.
contract_value	number	Valor máximo do contrato, ou null quando não informado.
validity_date	string	Data de validade no formato YYYY-MM-DD, ou null quando não informada.
submission_nature	string	Natureza de submissão do contrato.

Atributos de fund_class

Campo	Tipo	Descrição
name	string	Nome do fundo.
manager	object	Dados do gestor do fundo.
manager.name	string	Nome do gestor.
manager.manager_key	string	Chave única do gestor (UUID).
manager.document_number	string	CNPJ do gestor.
fund_class_key	string	Chave única do fundo (UUID).
document_number	string	CNPJ do fundo.

Atributos de vendor

Campo	Tipo	Descrição
vendor_key	string	Chave única do fornecedor.
name	string	Nome do fornecedor.
document_number	string	CPF ou CNPJ do fornecedor.
requires_invoice	string	Indica se o fornecedor exige nota fiscal ("True" ou "False").

Possíveis erros

STATUS

404

Fundo não encontrado

A fund_class_key informada na URL não corresponde a nenhum fundo cadastrado.

{
  "title": "Fund Class Not Found",
  "description": "Fund Class with key {fund_class_key} was not found.",
  "translation": "O Fundo com chave {fund_class_key} nao foi encontrado.",
  "code": "ESB000005"
}

Fornecedor não encontrado

A vendor_key informada no body não corresponde a nenhum fornecedor cadastrado.

{
  "title": "Vendor Not Found",
  "description": "Vendor with key {vendor_key} was not found.",
  "translation": "O fornecedor com a chave {vendor_key} nao foi encontrado.",
  "code": "ESB000008"
}

STATUS

409

Contract key duplicada

Já existe um contrato com a contract_key informada neste fundo. Use um identificador diferente ou omita o campo para gerar um UUID automaticamente.

{
  "title": "Contract Key Already Exists",
  "description": "A Contract with key {contract_key} already exists.",
  "translation": "Um contrato com a chave {contract_key} já existe.",
  "code": "ESB000012"
}

STATUS

400

Tipo de despesa incompatível com a natureza de submissão

O valor rebate em submission_nature só é válido quando expense_type é distribution_fee.

{
  "title": "Invalid Expense Type",
  "description": "The expense type {expense_type} is not valid for submission nature {submission_nature}.",
  "translation": "O tipo de despesa {expense_type} não é válido para a natureza de submissão {submission_nature}.",
  "code": "ESB000031"
}

Próximos passos

Após criar o contrato, o fluxo continua com:

1. Submissão do contrato — envie o contrato para análise e aprovação pela QI Tech.
2. Atualização do contrato — edite os dados do contrato enquanto ele ainda estiver em status created.