Envio da nota fiscal

O envio da nota fiscal leva a análise de consolidação vigente para a conferência da QI Tech. Antes, anexe a nota fiscal e os demais documentos à análise.

Enviar a nota fiscal

Disponível em

Perfil	Host	Permissão exigida
Gestora	manager-api	Escrita
Consultoria	consultant-api	Lançar e Editar Despesas ou Enviar Consolidações

URL base de cada host: Ambientes (Hosts).

ENDPOINT

/expense/fund_class/{fund_class_key}/expense/{expense_key}/consolidation_analysis/submit

MÉTODO

PUT

Envia a análise vigente para a conferência da QI Tech. Vale com a análise em pending_submission e a despesa em pre_approved ou in_provision.

Nas despesas lançadas pela gestora ou consultoria, o corpo é opcional: sem ele, valem o valor da despesa e o destino atual. Use o corpo para informar um valor diferente ou trocar o destino do pagamento.

Corpo da requisição — valor diferente e boleto

{
    "payment_value": 14800.00,
    "payment_method": "bank_slip",
    "payment": {
        "target": {
            "name": "AUDITORES EXEMPLO S.A.",
            "document_number": "44.555.666/0001-81"
        },
        "bank_slip": {
            "digitable_line": "34191090086352151004791020150008110010000148000"
        }
    }
}

Campo	Tipo	Obrigatório	Descrição
payment_value	number	Condicional	Valor da nota, maior que zero. Obrigatório em despesas calculadas pela QI Tech; nas lançadas pela gestora ou consultoria, o padrão é o valor da despesa.
payment_method	string	Condicional	transfer, pix ou bank_slip. Para trocar o destino, envie junto com payment.
payment	object	Condicional	Novo destino, nas regras do lançamento: target_account, vendor_bank_account_key, target_pix_key ou bank_slip.digitable_line. Para trocar o favorecido, inclua target; sem ele, fica o atual. O destino anterior é descartado. Não aceita pix_qrcode, source_account nem conciliation_metadata.

Regras do envio:

• Nota fiscal. A análise precisa ter uma invoice não cancelada; nos tipos sem contrato, invoice ou bank_slip. cvm_tax e anbima_tax não exigem nota.
• Valor diferente. O documento exigido depende da origem da despesa:
  • Lançada pela gestora ou consultoria: payment_value diferente do valor da análise exige variance_justification.
  • Calculada pela QI Tech: o valor é comparado ao provisionado (ao reconhecido, se a despesa não tem provisionado). consulting_fee sempre exige calculation_memory. Nas recorrentes, valor diferente exige calculation_memory. Nas demais, valor diferente exige variance_justification (ou settlement_term, na taxa de gestão).
• Reembolso. Exige payment_receipt na análise.
• Destino. Sem payment, vale o destino atual. Se a despesa paga por TED ou Pix não tem conta, chave nem QR Code, a API usa a conta principal ativa do fornecedor do contrato. Despesa por débito automático não troca de destino.
• Favorecido. Com payment, o favorecido (o novo target ou o atual) segue as regras de quem pode receber do lançamento. Ele precisa ser:
  • o fornecedor do contrato, exceto com vendor_bank_account_key;
  • em cvm_tax, anbima_tax, cetip_tax e selic_tax, a entidade fixa do tipo;
  • no reembolso, a gestora ou uma consultoria com vínculo ativo com o fundo, conforme reimbursement_recipient.
• Taxa de gestão e rebates.
  • payment_value é o valor líquido pago à gestora, já sem os rebates.
  • A soma dos rebates da taxa (sem os cancelados ou reprovados) é gravada em total_rebate_value.
  • O valor comparado ao provisionado é payment_value + total_rebate_value. Diferença exige variance_justification ou settlement_term.
  • Os rebates pre_approved com análise em pending_submission são enviados junto.
  • A nota de um rebate não é enviada sozinha: envie a da taxa de gestão.

STATUS

200

A análise com status: in_manual_analysis, na estrutura de atributos da análise, sem rebates.

Erros

Status	code	Quando acontece
400	EXP000164	A despesa não aceita análise de consolidação, ou a análise ou a despesa não está no status que o envio exige.
400	EXP000165	Envio sem a nota fiscal exigida. A mensagem lista os tipos aceitos.
400	EXP000167	Valor diferente sem o documento de justificativa.
400	EXP000169	Despesa calculada pela QI Tech sem payment_value.
400	EXP000138	Despesa calculada pela QI Tech: consulting_fee sem memória de cálculo, ou recorrente com valor diferente sem memória de cálculo.
400	EXP000135	Reembolso sem comprovante de pagamento.
400	EXP000205	Envio da nota de um rebate. Envie a nota da taxa de gestão.
400	EXP000203	payment sem payment_method, ou payment_method sem payment.
400	EXP000200	Troca de destino numa despesa por débito automático.
400	EXP000202	O destino não combina com o meio de pagamento: boleto com conta ou Pix, ou TED e Pix com boleto.
400	EXP000201	Sem destino, e o fornecedor não tem conta principal ativa.
400	EXP000208	O favorecido não é o fornecedor do contrato.
400	EXP000209	O favorecido do reembolso não é a gestora.
400	EXP000210	O favorecido do reembolso não é uma consultoria vinculada ao fundo.
400	EXP000211	O favorecido da taxa CVM, ANBIMA, CETIP ou SELIC não é a entidade nem o grupo QI Tech.
400	EXP000085	Falta o favorecido.
400	EXP000036	Falta o destino: TED sem conta, ou Pix sem conta, chave ou QR Code.
400	EXP000043	Boleto sem linha digitável.
400	EXP000104	Pix com mais de um destino.
400	EXP000175	TED com chave Pix.
400	EXP000178 a EXP000183	Problemas com a conta do fornecedor ou o banco, detalhados em Dados de pagamento.
400	QIT000001	Corpo inválido: campo obrigatório ausente, payment_method fora da lista, payment_value não positivo, campo de payment fora do formato (CPF ou CNPJ do favorecido, linha digitável fora de 47 ou 48 caracteres) ou campo não previsto.
400	EXP000069	A classe de fundo não é da gestora.
403	EXP000156	Você não lançou a despesa: a consultoria lançou e quem chama é a gestora, ou o contrário. Só quem lançou envia a nota.
404	EXP000010	A despesa não existe no fundo.

Exemplo

{
  "title": "Invoice Required For Consolidation Analysis",
  "description": "The consolidation analysis requires one of the documents ['invoice'] to be submitted.",
  "translation": "A analise de consolidacao exige um dos documentos ['invoice'] para ser enviada.",
  "code": "EXP000165"
}

Erros de autenticação, permissão e host: veja Erros da API.