发票发送

发送发票会将当前有效的合并分析提交给 QI Tech 核对。发送前，请先将发票和其他文件附加到分析。

发送发票

适用范围

角色	主机	所需权限
管理人	manager-api	写入
顾问	consultant-api	录入和编辑费用或提交合并

各主机的 Base URL：环境（主机）。

ENDPOINT

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

方法

PUT

将当前有效的分析发送给 QI Tech 核对。适用于分析处于 pending_submission、费用处于 pre_approved 或 in_provision 的情形。

对于管理人或顾问录入的费用，请求体为可选：不提供时，沿用费用金额和当前的收款目标。如需提供不同的金额或更换收款目标，请使用请求体。

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

字段	类型	是否必填	描述
payment_value	number	条件必填	发票金额，大于零。对由 QI Tech 计算的费用为必填；对管理人或顾问录入的费用，默认为费用金额。
payment_method	string	条件必填	transfer、pix 或 bank_slip。更换收款目标时，与 payment 一起发送。
payment	object	条件必填	新的收款目标，规则与录入相同：target_account、vendor_bank_account_key、target_pix_key 或 bank_slip.digitable_line。如需更换收款人，请提供 target；不提供则保留当前收款人。原有的收款目标会被丢弃。不接受 pix_qrcode、source_account 和 conciliation_metadata。

发送规则：

• 发票。 分析中必须有一个未取消的 invoice；无合同的类型为 invoice 或 bank_slip。cvm_tax 和 anbima_tax 不需要发票。
• 金额不同。 所需文件取决于费用的来源：
  • 管理人或顾问录入的费用：payment_value 与分析金额不同时需要 variance_justification。
  • 由 QI Tech 计算的费用：金额与计提金额比较（费用没有计提金额时，与已确认金额比较）。consulting_fee 始终需要 calculation_memory。定期费用金额不同时需要 calculation_memory。其他费用金额不同时需要 variance_justification（管理费则为 settlement_term）。
• 报销。 分析中须有 payment_receipt。
• 收款目标。 不提供 payment 时，沿用当前的收款目标。如果以 TED 或 Pix 付款的费用没有账户、密钥或二维码，API 会使用合同供应商的有效主账户。自动扣款的费用不能更换收款目标。
• 收款人。 提供 payment 时，收款人（新的 target 或当前收款人）须符合录入时的谁可以收款规则。收款人必须是：
  • 合同供应商，使用 vendor_bank_account_key 时除外；
  • 对于 cvm_tax、anbima_tax、cetip_tax 和 selic_tax，该类型的固定机构；
  • 报销时，按 reimbursement_recipient，管理人或与基金有有效关联的顾问。
• 管理费与返佣。
  • payment_value 是支付给管理人的净额，已扣除返佣。
  • 该管理费的返佣总额（不含已取消或被拒绝的）记录在 total_rebate_value 中。
  • 与计提金额比较的是 payment_value + total_rebate_value。存在差额时需要 variance_justification 或 settlement_term。
  • 处于 pre_approved 且分析处于 pending_submission 的返佣会一并发送。
  • 返佣的发票不能单独发送：请发送管理费的发票。

STATUS

200

返回 status: in_manual_analysis 的分析，结构与分析的属性相同，不含 rebates。

错误

状态	code	发生情形
400	EXP000164	该费用不接受合并分析，或分析或费用不处于发送所要求的状态。
400	EXP000165	发送时缺少所需的发票。错误信息会列出可接受的类型。
400	EXP000167	金额不同，但缺少说明文件。
400	EXP000169	由 QI Tech 计算的费用未提供 payment_value。
400	EXP000138	QI Tech 计算的费用：consulting_fee 没有计算说明，或定期费用金额不同但没有计算说明。
400	EXP000135	报销没有付款凭证。
400	EXP000205	发送了返佣的发票。请改为发送管理费的发票。
400	EXP000203	提供了 payment 但未提供 payment_method，或提供了 payment_method 但未提供 payment。
400	EXP000200	在自动扣款的费用中更换收款目标。
400	EXP000202	收款目标与付款方式不匹配：Boleto 使用了账户或 Pix，或 TED 和 Pix 使用了 Boleto。
400	EXP000201	没有收款目标，而供应商也没有有效的主账户。
400	EXP000208	收款人不是合同供应商。
400	EXP000209	报销的收款人不是管理人。
400	EXP000210	报销的收款人不是与基金关联的顾问。
400	EXP000211	CVM、ANBIMA、CETIP 或 SELIC 费用的收款人既不是相应机构，也不是 QI Tech 集团。
400	EXP000085	缺少收款人。
400	EXP000036	缺少收款目标：TED 没有账户，或 Pix 没有账户、密钥或二维码。
400	EXP000043	Boleto 没有数字行。
400	EXP000104	Pix 有多个收款目标。
400	EXP000175	TED 带有 Pix 密钥。
400	EXP000178 至 EXP000183	供应商账户或银行存在问题，详见付款数据。
400	QIT000001	请求体无效：缺少必填字段、payment_method 不在列表中、payment_value 不为正数、payment 中的字段格式错误（收款人的 CPF 或 CNPJ、可读行长度不是 47 或 48 个字符）或包含未定义的字段。
400	EXP000069	该基金类别不属于该管理人。
403	EXP000156	该费用不是您录入的：由顾问录入而调用方为管理人，或反之。只有录入方可以发送发票。
404	EXP000010	该费用在基金中不存在。

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

认证、权限和主机相关错误：参见 API 错误。