银行流水同步

新增/更新

  • 接口：common/transSerialDeliveries/batch
  • Method：POST
  • 数据格式：JSON
  • 接口说明
    • 该接口用作银行流水同步，在整批数据中如果只有几条数据因为其他原因失败，那么只有这几条数据不会被处理，其他数据仍会被正常处理
    • 本方公司编码为选填项，若填写则以填写值匹配后导入，若不填写则后台匹配后导入（后台匹配到唯一值时才自动赋值）
    • 若同一个本方账户信息在多个分公司下维护（银行账号、银行账户名称在各分公司下需维护一致，否则导入失败），则公司代码可不填写，此时导入的银行流水公司名称为空
    • 其中 (customer_account_name 和 customer_account_num) 与 (supplier_account_name 和 supplier_account_num) 两组至少填一组
    • 若不知道是 customer 还是 supplier 时, 可两组都填, 但 customer_account_name 与 supplier_account_name, customer_account_num 和 supplier_account_num 的值需要一致
    • 若根据以上组合无法获取唯一 customer_id 或 supplier_id 时, 会根据 customer_account_number 和 customer_name 尝试获取
    • 若依然无法获取唯一, 则只根据 customer_name 获取
    • supplier_id 只会根据组合 supplier_account_name 和 supplier_account_num 进行获取
  • 其他补充信息：单次数据量过大时候(超过200条)会全部转为异步处理，具体参考回调示例

请求参数

字段名称 字段类型 字段描述 是否必填 长度限制(字节)
bizId String 业务唯一识别码 是 64
timestamp Long 时间戳 是 13
data.code String 交易流水号 是 64
data.company_code String 本方公司编码 否 16
data.company_account_num String 本方银行账号 是 64
data.company_account_name String 本方银行账号名称 是 64
data.customer_account_name String 对方客户银行账号名称, 若 supplier_account_name 也存在时, 两者需一致 否 64
data.customer_account_num String 对方客户银行账号, 若 supplier_account_num 也存在时, 两者需一致 否 64
data.customer_name String 对方客户名称 否 64
data.supplier_account_name String 对方供应商银行账号名称, 若 customer_account_name 也存在时, 两者需一致 否 64
data.supplier_account_num String 对方供应商银行账号, 若 customer_account_num 也存在时, 两者需一致 否 64
data.supplier_name String 对方供应商名称 否 64
data.rec_pay_id String 收付标记 01标识收；02标识付 是 4
data.receipt_currency String 币种 是 16
data.receipt_amount BigDecimal 交易金额 是 16
data.trans_method_id String 交易方式(须事先维护值列表基础数据类型 Transaction Type) 是 4
data.receipt_date Long 交易日期 是 13
data.status String 状态(01 启用, 04 废弃) 是 4
data.customer_bank_name String 客户银行名称 否 64
data.comments String 摘要 否 64
data.remarks String 备注 否 64
data.balance_amount BigDecimal 待认领金额 否 16
data.receipt_num String 票据号码 否 64
data.drawer String 出票人 否 64
data.payer String 交款人 否 64
data.business_type String 业务类型：7105（举例） 否 16
data.draft_date Long 出票日期 否 0
data.end_date Long 到期日 否 0
data.trans_method_id String 交易方式 01-现金；02-电汇；03-应付承兑汇票；04-应收承兑汇票；05-支票；06-信用证；07-支付宝；08-微信支付 否 64
data.tenor String 票据期限 否 64
data.due_days String 到期天数 否 64
data.acceptor String 承兑人 否 255
data.remote_holder String 前手 否 255
data.previous_hand String 前一手 否 255
data.drawer_city String 汇票出票人的城市 否 64
data.area String 地区 否 64
data.acceptor_city String 汇票受票人的城市 否 64
data.payment_destination String 指定支付地点 否 64
data.central_bank_location String 中央银行位置 否 64
data.customer_bank_name String 对方银行名称 否 255
data.company_bank_name String 本方银行名称 否 255
### 示例 
{
  "timestamp": 1671004109000,
  "bizId": "4ffd1b69-6220-487f-8ca2-303911a24574",
  "data": [
    {
      "code": "1RH9MUW5BNSY00104",
      "rec_pay_id": "01",
      "receipt_currency": "01",
      "company_account_num": "832937476636212",
      "company_account_name": "安吉汽车租赁有限公司",
      "trans_method_id": "02",
      "receipt_date": "2022-12-13 14:26:15",
      "receipt_amount": "64.74",
      "status": "01"
    }

  ]
}

返回参数

字段名称 字段类型 字段描述
resCode String 状态码
resMsg String 描述
bizId String 业务唯一标识
data.validatorErrors String 错误信息
data.created String 新增数据信息
data.warnings.code String 警告数据编码
data.warnings.messages String 警告信息
data.dbErrors String 数据库错误信息
data.updated String 更新数据信息

示例

{
  "resCode": 200000,
  "resMsg": "success",
  "bizId": "4ffd1b69-6220-487f-8ca2-303911a24574",
  "data": {
    "validatorErrors": [],
    "created": "此次请求新建成功了1条数据",
    "warnings": [],
    "dbErrors": [],
    "updated": "此次请求更新成功了0条数据"
  }
}

results matching ""

    No results matching ""