开发票
接口说明: 开发票接口。开发票接口需要支持幂等,支持多次重复调用,确保不会重复开出发票
接口提供方: 合作方
请求地址: https://{$domain}/partner/createInvoice
服务协议: HTTPS/POST
请求参数:
参数名称 | 类型 | 必选 | 说明 |
---|---|---|---|
channel | string | 是 | 分配的合作方的标识,每个合作方一个, 对应分配给合作方的client_id |
timestamp | long | 是 | 请求时间,Unix Timestamp单位毫秒 |
sign | string | 是 | 签名 |
title | string | 是 | 发票抬头(最多50个中文字符) |
invoiceItem | string | 是 | 发票内容:客运服务费等 |
buyerType | int | 是 | 开票类型,1:个人,2:单位 |
taxNumber | string | 是 | 税号(单位发票必填,个人发票不填;15、18、20位大写字母或者数字) |
receiveOrders | string | 是 | 合作方订单号列表,订单间使用英文逗号(ASCII值0x2C)分割 |
invoiceType | int | 是 | 发票类型,2:电子 |
amount | int | 是 | 开票金额(单位:分) |
receiveName | string | 否 | 收件人姓名(最多10个中文字符)纸质必填 |
receiveMobile | string | 否 | 收件人手机号(最多13个字符)纸质必填 |
receiveEmail | string | 否 | 收件人邮箱。电子票必填 |
postProvince | string | 否 | 收件人所在省(纸质发票必填) |
postCity | string | 否 | 收件人所在市(纸质发票必填) |
postDistrict | string | 否 | 收件人所在区(纸质发票必填) |
postRegion | string | 否 | 收件人地区(x省x市x区/县)(纸质发票必填) |
postStreet | string | 否 | 收件人街道(纸质发票必填;最多50个中文字符) |
registerAddress | String | 否 | 注册地址(最多50个中文字符) |
registerPhone | String | 否 | 注册手机号(最多13个字符) |
openBank | String | 否 | 开户银行(最多60个中文字符) |
bankAccount | String | 否 | 银行账户号码(最多30个字符) |
remark | String | 否 | 备注(最多50个中文字符) |
orderInvoiceAmountsJson | list | 否 | 每个订单对应的可开发票金额对象列表 |
orderInvoiceAmountsJson.partnerOrderId | String | 否 | 合作方订单号 |
orderInvoiceAmountsJson.orderPriceAmount | int | 否 | 订单对应的可开发票金额(单位:分) |
响应data参数:
参数名称 | 类型 | 必选 | 说明 |
---|---|---|---|
result | int | 是 | 服务响应状态 |
message | string | 是 | 服务响应状态说明 |
data | object | 是 | 返回数据 |
data.requestId | string | 是 | 申请请求受理号 |