跳到主要内容

带过滤条件的 DDA 银行票据通知列表

允许列出在 DDA 中注册账户的银行票据，支持按状态和时间范围过滤的方法。

Request​

ENDPOINT
/account/ACCOUNT_KEY/dda/bank_slips
MÉTODO
GET

Path Params​

字段类型描述字符数
account_keystring在 DDA 中注册的账户标识键36

QUERY PARAMS​

字段描述
status银行票据状态
start_date列表开始日期。
end_date列表结束日期。
page_number当前查询的页码
page_size每页结果数量

Response​

STATUS
200
Response Body
{
  "data": [
    {
        "barcode": "00193000000001000000500000001234567890123456",
        "digitable_line": "00193000000001000000500000001234567890123456123",
        "status": "registered",
        "nominal_amount": 1050,
        "total_amount": 999,
        "total_payment_amount": null,
        "partial_payment_allowed": true,
        "paid_fine": null,
        "paid_interest": null,
        "discount_amount": null,
        "expiration": "2024-07-19",
        "max_payment_date": "2024-09-02",
        "beneficiary": {
            "name": "Tech Solutions Ltda.",
            "bank_code": "123",
            "bank_ispb": "12345678",
            "person_type": "legal",
            "document_number": "12345678000100"
        },
        "payer": {
            "name": "João Carlos",
            "person_type": "natural",
            "document_number": "12345678900"
        },
        "guarantor": { 
            "name": "Maria Junior", 
            "person_type": "natural",
            "document_number": "03903984900" 
        },
        "rebate_amount": 30.00,
        "interest": [
            {
                "interest_amount_type": "workdays_daily_amount",
                "interest_billing_start_date": "2024-07-21",
                "interest_amount": 10.00
            }
        ],
        "fine": [
            {
                "fine_billing_start_date": "2024-07-29",
                "fine_amount_type": "absolute",
                "fine_amount": 100.00
            }
        ],
        "discounts": [
            {
                "discount_limit_date": "2024-07-05",
                "discount_type": "absolute",
                "discount_amount": 50.00
            }
        ],
        "calculations": [],
        "calculation_model": "01",
    },
    {
        "barcode": "00193000000001000000500000001234567890123457",
        "digitable_line": "00193000000001000000500000001234567890123456123",
        "status": "paid",
        "nominal_amount": 1050,
        "total_amount": 1200,
        "total_payment_amount": 1200,
        "partial_payment_allowed": false,
        "paid_fine": 150,
        "paid_interest": 50,
        "discount_amount": 0,
        "expiration": "2024-05-30",
        "max_payment_date": "2024-07-01",
        "beneficiary": {
            "name": "Tech Solutions Ltda.",
            "bank_code": "123",
            "bank_ispb": "12345678",
            "person_type": "legal",
            "document_number": "12345678000100"
        },
        "payer": {
            "name": "João Carlos",
            "person_type": "natural",
            "document_number": "12345678900"
        },
        "guarantor": { 
            "name": "Maria Junior", 
            "person_type": "natural",
            "document_number": "03903984900" 
        },
        "rebate_amount": 30.00,
        "interest": [
            {
                "interest_amount_type": "workdays_daily_amount",
                "interest_billing_start_date": "2024-05-21",
                "interest_amount": 10.00
            }
        ],
        "fine": [
            {
                "fine_billing_start_date": "2024-05-29",
                "fine_amount_type": "absolute",
                "fine_amount": 100.00
            }
        ],
        "discounts": [
            {
                "discount_limit_date": "2024-05-05",
                "discount_type": "absolute",
                "discount_amount": 50.00
            }
        ],
        "calculations": [],
        "calculation_model": "01",
    }
  ],
  "pagination": {
    "current_page": 1,
    "next_page": null,
    "rows_per_page": 10
  }
}

Body Params​

字段类型描述字符数
barcodestring银行票据条形码。44
digitable_linestring银行票据可输入行。47
statusenum银行票据状态枚举值。-
nominal_amountfloat银行票据票面金额。-
total_amountfloat银行票据计算后金额。-
total_payment_amountfloat银行票据支付金额。-
partial_payment_allowedboolean是否接受部分付款的指标。-
paid_finefloat支付银行票据时实际发生的罚款总额，从总金额计算。-
paid_interestfloat支付银行票据时实际发生的利息总额，从总金额计算。-
discount_amountfloat支付银行票据时的折扣总额，从总金额计算。-
expirationstring银行票据到期日期。10
max_payment_datestring银行票据最终支付日期。10
payerobject银行票据付款人对象。-
beneficiaryobject银行票据受益人对象。-
guarantorobject银行票据担保人对象。-
rebate_amountfloat折扣金额。-
interestlist利息对象列表。-
finelist罚款对象列表。-
discountslist折扣对象列表。-
calculationslist银行票据计算组列表。-
calculation_modelstring银行票据当前金额的计算方法。2

状态枚举值​

枚举值描述
registered已注册的银行票据条形码。
paid已支付的银行票据。
partially_paid部分支付的银行票据。
written_off已注销的银行票据。

Payer 对象​

字段类型描述字符数
namestring付款人姓名。-
person_typestring付款人的人员类型。7
document_numberstring付款人的文件号码。14

Beneficiary 对象​

字段类型描述字符数
namestring受益人姓名。-
person_typestring受益人的人员类型。7
document_numberstring受益人的文件号码。14
bank_codestring受益人银行代码。3
bank_ispbstring受益人银行的 ISPB。8

guarantor 对象​

字段类型描述字符数
namestring担保人姓名。-
person_typestring担保人的人员类型。7
document_numberstring担保人的文件号码。14

interest 对象​

字段类型描述字符数
interest_billing_start_datestring利息开始日期。10
interest_amount_typestring利息类型。-
interest_amountstring利息金额。-

fine 对象​

字段类型描述字符数
fine_billing_start_datestring罚款开始日期。10
fine_amount_typestring罚款类型。-
fine_amountstring罚款金额。-

discount 对象​

字段类型描述字符数
discount_limit_datestring折扣截止日期。10
discount_typestring折扣类型。-
discount_amountstring折扣金额。-