跳到主要内容

从资产到 Boleto

当转让配置启用 Boleto 收款时，QI Tech 会为每个已转让的信用权利自动在 QI SCD 登记一张 Boleto。Boleto 的数据来自您插入资产时发送的内容。本页说明每个字段的来源，以及您可用哪些字段在自己的系统中识别和对账 Boleto。

适用于以下信用权利：duplicata mercantil、duplicata de serviços、CT-e 和贴现合同。每个资产生成一张 Boleto。贴现合同中每个资产是一期，因此每一期都有自己的 Boleto。

Boleto 何时登记​

Boleto 不在插入资产时登记，而是在转让付款后、资产进入基金组合时登记。登记确认在下一个工作日处理银行回执文件时到达。完整流程见 Boleto——开始。

因此，Boleto 的字段必须在插入时就正确。资产转让后，对 Boleto 的修改（到期日、利息、罚金、减免）通过 Boleto 指令完成，而不是重新发送资产。

Boleto 的到期日不是资产的到期日

修改到期日的指令只改变 Boleto。资产在基金组合、持仓报告和逾期计算中仍保留原到期日。如需同时修改资产的到期日，请在资产结算中上报延期（asset_extension，并提供 new_maturity_date）。延期适用于信用权利（包括贴现合同），分期合同不支持延期。

各字段的来源​

下列路径均相对于插入请求体中的 discounted_credit_right 对象。

客户控制字段​

这些字段由您自由选择，并会在查询 Boleto 时返回。用它们将 Boleto 与您系统中的记录关联。

资产字段Boleto 字段规则
participant_control_number参与方控制编号最多 25 个字符。仅保留字母、数字和 _，其他字符会被移除。在收款账户中必须唯一。
order_number单据编号（seu número）Boleto 只接收最后 10 个字符。完整值保留在资产上。
bankslip.our_number.numberNosso número可选。仅当您的收款账户约定由客户生成 nosso número 时发送。未发送时，登记时自动生成。
带 Boleto 的转让中请始终发送 participant_control_number

该字段在插入资产时是可选的，但在收款中它是 Boleto 的键：收款账户不接受两张控制编号相同的 Boleto，而未发送该字段的资产彼此之间视为重复。实际上，只有第一个没有控制编号的资产会登记 Boleto。请为每个资产生成唯一值，最多 25 个字母数字字符，例如由您的 external_id 派生。

金额、到期日和费用​

资产字段Boleto 字段规则
face_valueBoleto 金额
maturity_date到期日
delay.fine罚金必须为百分比（fine_type: percentage）。percentage_value 为零的罚金不会加入 Boleto。
delay.interest.pre_fixed逾期利息按逾期天数以金额计收：face_value × 日利率。如发送 monthly_rate，将按所给 calendar_base 换算为单利日利率。利率为零时不会加入 Boleto。

如果资产未包含 delay，Boleto 使用基金收款配置中登记的罚金和利息。

付款人与担保人​

来源Boleto 字段规则
borrower.name、borrower.document_number、borrower.person_type付款人证件号码去除标点后发送。
borrower.address付款人地址仅当 street、number、neighborhood、postal_code、city 和 uf 全部填写时才发送到 Boleto。缺少任何一项时，Boleto 登记时不带地址。complement 为可选。
转让配置中的转让方担保人（sacador/avalista）来自转让方登记信息，而非请求体。当收款账户约定转让方为担保人时出现。

不进入 Boleto 的字段​

以下字段保留在资产上，并在资产查询中返回，但不会出现在 Boleto 上：

  • external_id——请用 participant_control_number 作为 Boleto 与资产之间的桥梁；
  • installment_number；
  • 贴现合同的 contract 对象（number、issue_date、total_face_value、number_of_installments）；
  • duplicata 和 CT-e 的 invoice 对象。

示例​

在带 Boleto 的转让中插入的一份贴现合同片段：

{
    "discounted_credit_right": {
        "external_id": "parcela-958431587-01",
        "face_value": 1231.21,
        "maturity_date": "2025-12-10",
        "installment_number": 1,
        "participant_control_number": "CT958431587P01",
        "order_number": "2023000958431587",
        "delay": {
            "fine": { "fine_type": "percentage", "percentage_value": 0.02 },
            "interest": {
                "method": "pre_fixed",
                "pre_fixed": { "monthly_rate": 0.01, "calendar_base": "calendar_360" }
            }
        }
    }
}

在 QI SCD 登记的 Boleto 如下：

Boleto 字段值原因
金额R$ 1.231,21face_value
到期日2025-12-10maturity_date
参与方控制编号CT958431587P01participant_control_number，按原样发送（仅含字母和数字）
单据编号0958431587order_number 的最后 10 个字符
罚金2%fine.percentage_value 为 0.02
逾期利息每逾期一天 R$ 0,41月利率 1% × 12 ÷ 360 天 × R$ 1.231,21

external_id、installment_number 和 contract 对象都不会出现在 Boleto 上。要从 Boleto 找到资产，请使用参与方控制编号。

核对 Boleto​

在获取 Boleto 及副本中查询已登记的 Boleto。响应包含两个控制编号：

  • external_participant_control_number——与您发送时完全一致的值；
  • participant_control_number——字符清理后的值，即 Boleto 上的值。

关于登记、付款和注销通知，请参见 Boleto webhook。