单据签收接口
POST
/billSubmit通过该接口通知客户系统单据的签收状态,并传递影像及其他相关信息。
请求参数
Body 参数application/json
flagRequest
string
幂等标记
paperCount
integer
纸张数,整型
thickness
number
单据厚度,浮点型
billTypeCode
string
单据类型编号,字符串
expenseItemCode
string
费用科目编码,字符串
dateStart
string
开始日期,字符串,格式为YYYY-MM-DD
dateEnd
string
结束日期,字符串,格式为YYYY-MM-DD
reimbursementAccount
string
报销人,字符串
billCode
string
单据编码,字符串
submitUseTime
integer
交单耗时,整型
boxList
array [object {2}]
进入箱号,数组
storeType
string
单据类型,字符串
boxCode
string
箱号,字符串
approveResult
string
审核结果,字符串
imageList
array [object {4}]
影像列表,数组
paperIndex
integer
纸张索引,整型
imageIndex
integer
图像索引,整型
url
string
图像URL,字符串
flagCover
integer
是否封面,整型,0表示不是,1表示是
ocrDataList
array [object {111}]
OCR数据,数组
id
string
发票id,字符串
url
string
发票URL,字符串
type
string
发票类型,字符串
typeLabel
string
发票类型名称,字符串
orientation
integer
旋转角度,整型,顺时针
region
array[integer]
单张发票区域,整数列表
code
string
印刷发票代码,字符串
number
string
印刷发票号码,字符串
codeConfirm
string
机打发票代码,字符串
numberConfirm
string
机打发票号码,字符串
date
string
开票日期,字符串,格式为YYYY-MM-DD
pretaxAmount
string
税前金额,字符串
total
string
价税合计(小写),字符串
totalCn
string
价税合计(大写),字符串
tax
string
税额,字符串
checkCode
string
校验码,字符串
machineCode
string
机器编号,字符串
seller
string
销售方名称,字符串
sellerTaxId
string
销售方纳税人识别号,字符串
sellerAddrTel
string
销售方地址、账号,字符串
sellerBankAccount
string
销售方银行账号,字符串
buyer
string
购买方,字符串
buyerTaxId
string
购买方纳税人识别号,字符串
buyerBankAccount
string
购买方银行账号,字符串
buyerAddrTel
string
购买方地址、账号,字符串
companySeal
string
可选
formType
string
发票是第几联,字符串
formName
string
发票联次,字符串
kind
string
发票消费类型,字符串
ciphertext
string
密码区,字符串,四行密码,每行以逗号隔开
travelTax
string
车船税,字符串
receiptor
string
收款人,字符串
reviewer
string
复核,字符串
issuer
string
开票人,字符串
province
string
省,字符串
city
string
市,字符串
serviceName
string
服务类型,字符串
remark
string
备注,字符串
itemNames
string
品名,字符串,每个以逗号隔开
agentMark
string
是否代开,字符串
acquisitionMark
string
是否收购,字符串
blockChain
string
区块链标记,字符串
electronicMark
string
是否为电子增票,字符串
transitMark
string
通行费标志,字符串
oilMark
string
成品油标志,字符串
vehicleMark
string
机动车标志,字符串
title
string
标题,字符串
timeGeton
string
上车时间,字符串
timeGetoff
string
下车时间,字符串
mileage
string
里程,字符串
place
string
发票所在地,字符串
licensePlate
string
车牌号,字符串
time
string
乘车时间,字符串
name
string
乘车人姓名,字符串
stationGeton
string
上车车站,字符串
stationGetoff
string
下车车站,字符串
trainNumber
string
车次,字符串
seat
string
座位类型,字符串
serialNumber
string
序列号,字符串
userId
string
身份证号,字符串
category
string
种类,字符串
entrance
string
入口,字符串
exit
string
出口,字符串
highwayFlag
string
高速标志,字符串
userName
string
乘机人姓名,字符串
agentcode
string
销售单位代号,字符串
issueBy
string
填开单位,字符串
fare
string
票价,字符串
fuelSurcharge
string
燃油附加费,字符串
caacDevelopmentFund
string
民航发展基金,字符串
insurance
string
保险费,字符串
internationalFlag
string
国内国际标签,字符串
printNumber
string
印刷序号,字符串
endorsement
string
签注,字符串
sellerId
string
卖方单位代码,字符串
sellerAddress
string
卖方单位,字符串
buyerId
string
买方单位代码,字符串
buyerAddress
string
买方单位,字符串
companyName
string
二手车市场,字符串
companyTaxId
string
二手车市场纳税人识别号,字符串
companyBankAccount
string
二手车市场开户银行、账号,字符串
companyPhone
string
二手车市场电话,字符串
companyAddress
string
二手车市场地址,字符串
registrationNumber
string
登记证号,字符串
carCode
string
车架号,字符串
carModel
string
厂牌型号,字符串
machineId
string
机器编号,字符串
machineNumber
string
机打号码,字符串
address
string
销货单位地址,字符串
phone
string
销货单位电话,字符串
account
string
销货单位账号,字符串
taxAuthorities
string
主管税务机关,字符串
taxAuthoritiesCode
string
主管税务机关代码,字符串
carEngineCode
string
发动机号码,字符串
certificateNumber
string
合格证号,字符串
taxRate
string
税率,字符串
carType
string
车辆类型,字符串
tonnage
string
吨位,字符串
taxNum
string
完税凭证号码,字符串
maxPeopleNum
string
限乘人数,字符串
origin
string
产地,字符串
storeName
string
店名,字符串
subtotal
string
小计,字符串
discount
string
折扣,字符串
tips
string
小费,字符串
currencyCode
string
币种,字符串
dateStart
string
行程开始时间,字符串,格式为YYYY-MM-DD
dateEnd
string
行程结束时间,字符串,格式为YYYY-MM-DD
surcharge
string
出租车发票,字符串
items
array [object {8}]
明细,数组
flights
array [object {7}]
航班,数组
示例
{
"flagRequest": "string", // 幂等标记
"paperCount": 100, // 纸张数,整型
"thickness": 0.05, // 单据厚度,浮点型
"billTypeCode": "string", // 单据类型编号,字符串
"expenseItemCode": "string", // 费用科目编码,字符串
"dateStart": "2024-07-01", // 开始日期,字符串,格式为YYYY-MM-DD
"dateEnd": "2024-07-31", // 结束日期,字符串,格式为YYYY-MM-DD
"reimbursementAccount": "string", // 报销人,字符串
"billCode": "string", // 单据编码,字符串
"submitUseTime": 120, // 交单耗时,整型
"boxList": [ // 进入箱号,数组
{
"storeType": "string", // 单据类型,字符串
"boxCode": "string" // 箱号,字符串
}
],
"approveResult": "string", // 审核结果,字符串
"imageList": [ // 影像列表,数组
{
"paperIndex": 1, // 纸张索引,整型
"imageIndex": 1, // 图像索引,整型
"url": "http://example.com/image.jpg", // 图像URL,字符串
"flagCover": 0 // 是否封面,整型,0表示不是,1表示是
}
],
"ocrDataList": [ // OCR数据,数组
{
"id": "string", // 发票id,字符串
"url": "http://example.com/invoice.pdf", // 发票URL,字符串
"type": "string", // 发票类型,字符串
"typeLabel": "string", // 发票类型名称,字符串
"orientation": 90, // 旋转角度,整型,顺时针
"region": [ // 单张发票区域,整数列表
1,
2,
3,
4
],
"code": "string", // 印刷发票代码,字符串
"number": "string", // 印刷发票号码,字符串
"codeConfirm": "string", // 机打发票代码,字符串
"numberConfirm": "string", // 机打发票号码,字符串
"date": "2024-07-15", // 开票日期,字符串,格式为YYYY-MM-DD
"pretaxAmount": "string", // 税前金额,字符串
"total": "string", // 价税合计(小写),字符串
"totalCn": "string", // 价税合计(大写),字符串
"tax": "string", // 税额,字符串
"checkCode": "string", // 校验码,字符串
"machineCode": "string", // 机器编号,字符串
"seller": "string", // 销售方名称,字符串
"sellerTaxId": "string", // 销售方纳税人识别号,字符串
"sellerAddrTel": "string", // 销售方地址、账号,字符串
"sellerBankAccount": "string", // 销售方银行账号,字符串
"buyer": "string", // 购买方,字符串
"buyerTaxId": "string", // 购买方纳税人识别号,字符串
"buyerBankAccount": "string", // 购买方银行账号,字符串
"buyerAddrTel": "string", // 购买方地址、账号,字符串
"companySeal": "0", // 是否有公司印章,字符串,"0"表示没有
"formType": "string", // 发票是第几联,字符串
"formName": "string", // 发票联次,字符串
"kind": "string", // 发票消费类型,字符串
"ciphertext": "string", // 密码区,字符串,四行密码,每行以逗号隔开
"travelTax": "string", // 车船税,字符串
"receiptor": "string", // 收款人,字符串
"reviewer": "string", // 复核,字符串
"issuer": "string", // 开票人,字符串
"province": "string", // 省,字符串
"city": "string", // 市,字符串
"serviceName": "string", // 服务类型,字符串
"remark": "string", // 备注,字符串
"itemNames": "string", // 品名,字符串,每个以逗号隔开
"agentMark": "string", // 是否代开,字符串
"acquisitionMark": "string", // 是否收购,字符串
"blockChain": "string", // 区块链标记,字符串
"electronicMark": "string", // 是否为电子增票,字符串
"transitMark": "string", // 通行费标志,字符串
"oilMark": "string", // 成品油标志,字符串
"vehicleMark": "string", // 机动车标志,字符串
"title": "string", // 标题,字符串
"timeGeton": "string", // 上车时间,字符串
"timeGetoff": "string", // 下车时间,字符串
"mileage": "string", // 里程,字符串
"place": "string", // 发票所在地,字符串
"licensePlate": "string", // 车牌号,字符串
"time": "string", // 乘车时间,字符串
"name": "string", // 乘车人姓名,字符串
"stationGeton": "string", // 上车车站,字符串
"stationGetoff": "string", // 下车车站,字符串
"trainNumber": "string", // 车次,字符串
"seat": "string", // 座位类型,字符串
"serialNumber": "string", // 序列号,字符串
"userId": "string", // 身份证号,字符串
"category": "string", // 种类,字符串
"entrance": "string", // 入口,字符串
"exit": "string", // 出口,字符串
"highwayFlag": "string", // 高速标志,字符串
"userName": "string", // 乘机人姓名,字符串
"agentcode": "string", // 销售单位代号,字符串
"issueBy": "string", // 填开单位,字符串
"fare": "string", // 票价,字符串
"fuelSurcharge": "string", // 燃油附加费,字符串
"caacDevelopmentFund": "string", // 民航发展基金,字符串
"insurance": "string", // 保险费,字符串
"internationalFlag": "string", // 国内国际标签,字符串
"printNumber": "string", // 印刷序号,字符串
"endorsement": "string", // 签注,字符串
"sellerId": "string", // 卖方单位代码,字符串
"sellerAddress": "string", // 卖方单位,字符串
"buyerId": "string", // 买方单位代码,字符串
"buyerAddress": "string", // 买方单位,字符串
"companyName": "string", // 二手车市场,字符串
"companyTaxId": "string", // 二手车市场纳税人识别号,字符串
"companyBankAccount": "string", // 二手车市场开户银行、账号,字符串
"companyPhone": "string", // 二手车市场电话,字符串
"companyAddress": "string", // 二手车市场地址,字符串
"registrationNumber": "string", // 登记证号,字符串
"carCode": "string", // 车架号,字符串
"carModel": "string", // 厂牌型号,字符串
"machineId": "string", // 机器编号,字符串
"machineNumber": "string", // 机打号码,字符串
"address": "string", // 销货单位地址,字符串
"phone": "string", // 销货单位电话,字符串
"account": "string", // 销货单位账号,字符串
"taxAuthorities": "string", // 主管税务机关,字符串
"taxAuthoritiesCode": "string", // 主管税务机关代码,字符串
"carEngineCode": "string", // 发动机号码,字符串
"certificateNumber": "string", // 合格证号,字符串
"taxRate": "string", // 税率,字符串
"carType": "string", // 车辆类型,字符串
"tonnage": "string", // 吨位,字符串
"taxNum": "string", // 完税凭证号码,字符串
"maxPeopleNum": "string", // 限乘人数,字符串
"origin": "string", // 产地,字符串
"storeName": "string", // 店名,字符串
"subtotal": "string", // 小计,字符串
"discount": "string", // 折扣,字符串
"tips": "string", // 小费,字符串
"currencyCode": "string", // 币种,字符串
"dateStart": "2024-07-01", // 行程开始时间,字符串,格式为YYYY-MM-DD
"dateEnd": "2024-07-31", // 行程结束时间,字符串,格式为YYYY-MM-DD
"surcharge": "string", // 出租车发票,字符串
"items": [ // 明细,数组
{
"name": "string", // 货物或应税劳务、服务名称,字符串
"specification": "string", // 规格型号,字符串
"unit": "string", // 单位,字符串
"quantity": "string", // 数量,字符串
"price": "string", // 单价,字符串
"total": "string", // 金额,字符串
"taxRate": "string", // 税率,字符串
"tax": "string" // 税额,字符串
}
],
"flights": [ // 航班,数组
{
"from": "string", // 出发站,字符串
"to": "string", // 到达站,字符串
"className": "string", // 舱位等级,字符串
"flightNumber": "string", // 航班号,字符串
"date": "2024-07-15", // 乘机日期,字符串,格式为YYYY-MM-DD
"time": "string", // 乘机时间,字符串
"seat": "string" // 座位等级,字符串
}
]
}
]
}
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
code
integer
编码
msg
string
消息
data
object
返回值
billCode
string
单号(智能填报时用到)
billUrl
string
单据跳转
示例
{
"code": 200,
"msg": "success",
"data": {
"billCode": "YGBX202407020003",
"billUrl": "http://ip/单据展示路径.jpg"
}
}
最后修改时间: 5 个月前