导入承兑汇票 - 电子档案开放接口文档

该接口3.7.0版本上线

请求参数

Header 参数

Authorization

string

可选

默认值:

Content-Type

string

可选

默认值:

application/json

Body 参数application/json

array of:

billNo

string

票据号码

必需

businessEntityName

string

业务实体

必需

businessEntityId

string

业务实体编码

可选

billStatusText

string

必需

票据状态
SIGN("已签收"),
SETTLE("已结清"),
DISCOUNT("已贴现"),
ENDORSED("已背书");

billTypeText

string

必需

票据类型
EBANK_ACCEPTANCEBILL("银行承兑汇票"),
BUSINESS_ACCEPTANCEBILL("商业承兑汇票");

receiptPaymentTypeText

string

必需

票据收付类型
RECEIVABLE_BILL("应收票据"),
PAYABLE_BILL("应付票据");

issueDate

string

必需

出票日期
yyyy-MM-dd

expireDate

string

必需

汇票到日期
yyyy-MM-dd

billAmount

number

票据金额

必需

transferable

boolean

能否转让

必需

drawerName

string

出票人全称

必需

drawerNo

string

出票人账号

必需

drawerBankName

string

出票人开户银行

必需

recipientName

string

收票人全称

必需

recipientNo

string

收票人账号

必需

recipientBankName

string

收票人开户银行

必需

bearerNo

string

必需

持票人账号(改为我方账号)

bankName

string

银行

必需

acceptorName

string

承兑人全称

必需

acceptorNo

string

承兑人账号

必需

acceptorBankName

string

承兑人开户行名称

必需

contractNo

string

交易合同号

可选

acceptDate

string

必需

承兑日期
yyyy-MM-dd

discountDate

string

可选

贴现日期
yyyy-MM-dd

endorsementInfoList

array[object (EndorsementInfo) {7}]

必需

背书信息列表
不传入该参数时，根据
票据收付类型补全背书信息。
PAYABLE_BILL("应付票据")：出票人账号与持票人账号相同
RECEIVABLE_BILL("应收票据")收票人账号与持票人账号相同

endorsementType

string

背书类型

可选

endorserNo

string

必需

背书人账号
根据票据收付类型补全背书信息时：出票人账号 --> 背书人账号

endorserName

string

必需

背书人名称
根据票据收付类型补全背书信息时：出票人全称 --> 背书人名称

endorsedNo

string

必需

被背书人账号
根据票据收付类型补全背书信息时：收票人账号 --> 被背书人账号

endorsedName

string

可选

被背书人名称
根据票据收付类型补全背书信息时：收票人全称 --> 被背书人名称

transferable

boolean

不得转让标记

必需

endorsementDate

string

必需

背书日期
yyyy-MM-dd
根据票据收付类型补全背书信息时：出票日期 --> 背书时间

示例

[
    {
        "billNo": "string",
        "businessEntityName": "string",
        "businessEntityId": "string",
        "billStatusText": "string",
        "billTypeText": "string",
        "receiptPaymentTypeText": "string",
        "issueDate": "string",
        "expireDate": "string",
        "billAmount": 0,
        "transferable": true,
        "drawerName": "string",
        "drawerNo": "string",
        "drawerBankName": "string",
        "recipientName": "string",
        "recipientNo": "string",
        "recipientBankName": "string",
        "bearerNo": "string",
        "bankName": "string",
        "acceptorName": "string",
        "acceptorNo": "string",
        "acceptorBankName": "string",
        "contractNo": "string",
        "acceptDate": "string",
        "discountDate": "string",
        "endorsementInfoList": [
            {
                "endorsementType": "string",
                "endorserNo": "string",
                "endorserName": "string",
                "endorsedNo": "string",
                "endorsedName": "string",
                "transferable": true,
                "endorsementDate": "string"
            }
        ]
    }
]

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

com.maycur.cm.dto.OpenResultDto<com.maycur.cm.dto.OpenBatchResultDataDto,java.util.List<com.maycur.cm.dto.acceptanceBill.AcceptanceBillOpenImportResultDTO>>

errData

array[object (AcceptanceBillOpenImportResultDTO) {27}]

失败结果

可选

billNo

string

票据号码

可选

businessEntityId

string

业务实体编码

可选

billStatusText

string

票据状态

可选

billTypeText

string

票据类型

可选

receiptPaymentTypeText

string

票据收付类型

可选

issueDate

string

出票日期

可选

expireDate

string

汇票到日期

可选

billAmount

number

票据金额

可选

transferable

boolean

能否转让

可选

drawerName

string

出票人全称

可选

drawerNo

string

出票人账号

可选

drawerBankName

string

出票人开户银行

可选

recipientName

string

收票人全称

可选

recipientNo

string

收票人账号

可选

recipientBankName

string

收票人开户银行

可选

bearerNo

string

可选

持票人账号(改为我方账号)

bankName

string

银行

可选

acceptorName

string

承兑人全称

可选

acceptorBankName

string

承兑人开户行名称

可选

contractNo

string

交易合同号

可选

acceptDate

string

承兑日期

可选

acceptorNo

string

承兑人账号

可选

discountDate

string

贴现日期

可选

businessEntityName

string

可选

index

integer

数据在列表中索引

可选

code

integer

结果代码

可选

errorMsg

string

错误信息

可选

code

integer

结果代码

可选

message

string

结果信息

可选

errMsg

string

错误信息

可选

data

object (OpenBatchResultDataDto)

结果数据

可选

successAmount

integer | null

成功条数

可选

timestamp

string

时间戳

可选

示例

{
  "errData": [
    {
      "billNo": "",
      "businessEntityId": "",
      "billStatusText": "",
      "billTypeText": "",
      "receiptPaymentTypeText": "",
      "issueDate": "",
      "expireDate": "",
      "billAmount": 0.0,
      "transferable": false,
      "drawerName": "",
      "drawerNo": "",
      "drawerBankName": "",
      "recipientName": "",
      "recipientNo": "",
      "recipientBankName": "",
      "bearerNo": "",
      "bankName": "",
      "acceptorName": "",
      "acceptorBankName": "",
      "contractNo": "",
      "acceptDate": "",
      "acceptorNo": "",
      "discountDate": "",
      "businessEntityName": "",
      "index": 0,
      "code": 0,
      "errorMsg": ""
    }
  ],
  "code": 0,
  "message": "",
  "errMsg": "",
  "data": {
    "successAmount": 0
  },
  "timestamp": ""
}