单多啦平台
  1. 标准接口
单多啦平台
  • 基本介绍
  • 快速开始
    • 鉴权说明
  • 标准接口
    • 登录/身份校验接口
      POST
    • 获取单据详情接口
      POST
    • 单据签收接口
      POST
    • 更新实物状态接口
      POST
    • 消息通知接口
      POST
    • 实物状态变更接口
      POST
    • 获取待投递单据列表接口
      POST
  • 智能填报
    • 获取单据类型接口
      POST
    • 获取费用科目接口
      POST
  • 可选接口
  1. 标准接口

单据签收接口

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成功
application/json
Body
code
integer 
编码
必需
msg
string 
消息
必需
data
object 
返回值
必需
billCode
string 
单号(智能填报时用到)
必需
billUrl
string 
单据跳转
必需
示例
{
    "code": 0,
    "msg": "string",
    "data": {
        "billCode": "string",
        "billUrl": "string"
    }
}
修改于 2024-08-02 08:31:46
上一页
获取单据详情接口
下一页
更新实物状态接口
Built with