# 个人全票种
# OCR识别接口
# URL
POST
http://{IP}:{PORT}/piaoeda-web/api/bill/ocr/rqrecognise
# 请求体
{
"usermobile" : "13811111111",
"useremail" : "admin@admin.com",
"file" : "base64编码后的字符串",
"fileName" : "文件名.jpg"
}
# 请求体说明
参数 | 类型 | 长度 | 必输 | 说明 |
---|---|---|---|---|
usermobile | String | 否 | 手机号邮箱不能都为空,手机优先 | |
useremail | String | 否 | 手机号邮箱不能都为空,手机优先 | |
file | String | 是 | base64编码图片 | |
fileName | String | 是 | 文件名 |
# 返回值
{
"code": "0000",
"datas": [
{
"billType": "taxi",
"data": {
"date": "20181028",
"kind": "交通",
"filePath": null,
"carNum": null,
"invoiceCode": "132011881210",
"invoiceNum": "16329715",
"orgid": null,
"totalAmount": 24,
"purchaserStatus": null,
"startTime": "15:50",
"endTime": "15:58",
"id": null,
"place": "江苏省南京市",
"mileage": 8.3
},
"imageId": "1392",
"imagePath": null,
"exists": "0"
}
],
"msg": "解析成功"
}
# 返回值说明
编码 | 名称 | 类型 | 备注 |
---|---|---|---|
code | 状态码 | String | |
msg | 提示信息 | String | |
datas | OCR识别对象 | Array | |
imageId | 图片Id | ||
exists | 该ocr结果是否在个人票夹的该用户下已存在。0:不存在。1:已存在 | String | |
data | 识别结果 | Object | 详见各票种json示例 |
billtype | 票据类型 | String | 详见票种类型 |
# OCR识别接口V2
# URL
POST
http://{IP}:{PORT}/piaoeda-web/api/bill/ocr/v2/rqrecognise
# 请求体
{
"usermobile" : "13811111111",
"useremail" : "admin@admin.com",
"file" : "base64编码后的字符串",
"fileName" : "文件名.jpg",
"imageCut" : 1
}
# 请求体说明
参数 | 类型 | 长度 | 必输 | 说明 |
---|---|---|---|---|
usermobile | String | 否 | 手机号邮箱不能都为空,手机优先 | |
useremail | String | 否 | 手机号邮箱不能都为空,手机优先 | |
file | String | 是 | base64编码图片 | |
fileName | String | 是 | 文件名 | |
imageCut | Integer | 1 | 否 | 1:返回小图 2:返回大图(默认) |
# 返回值
{
"code": "0000",
"datas": [
{
"billType": "taxi",
"data": {
"date": "20181028",
"kind": "交通",
"filePath": null,
"carNum": null,
"invoiceCode": "132011881210",
"invoiceNum": "16329715",
"orgid": null,
"totalAmount": 24,
"purchaserStatus": null,
"startTime": "15:50",
"endTime": "15:58",
"id": null,
"place": "江苏省南京市",
"mileage": 8.3
},
"imageId": "1392",
"imagePath": null,
"exists": "0"
}
],
"msg": "解析成功"
}
# 返回值说明
编码 | 名称 | 类型 | 备注 |
---|---|---|---|
code | 状态码 | String | |
msg | 提示信息 | String | |
datas | OCR识别对象 | Array | |
imageId | 图片Id | ||
exists | 该ocr结果是否在个人票夹的该用户下已存在。0:不存在。1:已存在 | String | |
data | 识别结果 | Object | 详见各票种json示例 |
type | 票种类型 | String | 详见票种类型 |
# Ocr接口图片预览接口
# URL
GET
http://{IP}:{PORT}/piaoeda-web/api/bill/ocr/preview?imageId=1456
# 请求体说明
参数 | 类型 | 长度 | 必输 | 说明 |
---|---|---|---|---|
imageId | Long | 是 | ocr识别返回ImageId字段 |
# 返回值
{
"code" : "0000",
"msg" : "操作成功",
"datas" : "base64编码图片信息"
}
# 返回值说明
编码 | 名称 | 类型 | 说明 |
---|---|---|---|
code | 状态码 | String | |
msg | 提示信息 | String | |
datas | 图片 | String | Base64编码 |
# 发票源文件上传
# 请求说明
POST http://
: /piaoeda-web/api/einvoice/ybz/uploadpdf?appid=XXXXX 请求头说明 |参数| 类型 |是否必填| 描述 |sign |String |是 |请求签名信息
请求体
{
"useremail" : "yy@yy.com",
"usermobile" : "13311111111",
"nsrsbh":"101011111111111",
"orgcode":"321",
"pdfFiles" : [
{
"srcBillType" : "来源业务系统1",
"srcBillCode" : "业务系统单据号1",
"fileName" : "增值税.ofd",
"fileid":"源文件PK1",
"content" : "XXXXXXXXXXXXXXXXXXX1",
"classification":"通讯"
},
{
"srcBillType" : "来源业务系统2",
"srcBillCode" : "业务系统单据号2",
"fileName" : "增值税.zip",
"fileid":"源文件PK2",
"content" : "XXXXXXXXXXXXXXXXXXX2",
"classification":"通讯"
}
]
}
# 请求体说明
参数 类型 长度 是否必填 默认值 描述 说明 useremail String 否 用户邮箱 手机号、邮箱不能都为空 usermobile String 否 用户手机号 手机号、邮箱不能都为空 fileName String 是 发票文件名 fileid String 否 文件pk content String 是 对应发票文件 通过Base64编码字节流,转换为字符串 classification String 否 发票分类 设置发票分类,为空自动解析;目前支持:”交通”,”餐饮”,”通讯”,”其他” nsrsbh String 是 纳税人识别号 受票企业纳税人识别号;纳税人识别号与组织编码至少传入一项 orgcode String 否 组织编码 受票方企业在发票平台的组织编码纳税人识别号与组织编码至少传入一项 srcBillType String 否 来源业务系统 srcBillCode String 否 业务系统单据号 srcBillid String 否 业务系统单据ID
# 返回值
{
"code": "0000",
"datas": [
{
"type": "invoice",
"fileName": "增值税.ofd"
"invoice": {
"fpDm": "0110xxxxxxx1",
"fpHm": "xxxxxxx1",
"classification": "通讯",
"gmfMc": "梁XX",
"hjje": 4.8,
"jshj": 4.8,
"kpr": "Z000DZQD",
"kprq": "2016-07-01",
"xsfDzdh": "北京市西城区复兴门南大街6号,66155074",
"xsfMc": "中国联合网络通信有限公司北京市分公司",
"xsfNsrsbh": "110102801657272",
"busiType": null,
"fileid":"源文件PK1",
"voucherFileid":"源文件PK2",
}
}
],
"msg": "SUCCESS"
}
# 返回值说明
参数 类型 描述 说明 code String 状态码 0000-操作成功;详见状态码说明 msg String 信息说明 fileName String 文件名 fpDm String 发票代码 fpHm String 发票号码 classification String 发票分类 目前支持:”交通”,”餐饮”,”通讯”,”其他” gmfMc String 购买方名称 hjje double 合计金额 jshj double 价税合计 kpr String 开票人 kprq String 开票日期 xsfDzdh String 销售方地址电话 xsfMc String 销售方名称 xsfNsrsbh String 销售方纳税人识别号 type String 票据类型 invoice:增值税 voucher:电子凭证 machine:通用机打发票 nontax:非税 air:航空客票 train:火车票 fileid String 源文件PK voucherFileid String 会计凭证源文件PK 如果增值税匹配到电子会计凭证,此字段为电子会计凭证的fileid busiType 业务类型 非税发票使用 65-医疗门诊 66-医疗住院 64-财政非税票据 67-电子非税收入一般缴款书
# 个人票夹列表查询
# URL
POST
http://{IP}:{PORT}/piaoeda-web/api/bill/query?page={page}&size={size}
# 请求参数说明
编码 | 名称 | 类型 | 说明 |
---|---|---|---|
page | 当前页数 | int | |
size | 每页数量 | int |
# 请求体
{
"useremail" : "", //邮箱
"usermobile" : "", //手机
"keyword":"", //关键字
"date_begin":"", //开票日期开始
"date_end":"", //开票日期结束
"createtime_begin":"", //创建日期开始
"createtime_end":"", //创建日期结束
"classification":"", // 发票类别
"purchaserstatus":[-1,33], //报销状态
}
# 请求体说明
参数 | 类型 | 长度 | 是否必填 | 说明 |
---|---|---|---|---|
useremail | String | 否 | 手机邮箱必须有一个不为空,手机优先 | |
usermobile | String | 否 | 手机邮箱必须有一个不为空,手机优先 | |
keyword | String | 否 | 查询关键字。发票代码、号码、销售方、采购方模糊查询 | |
date_begin | String | 否 | 开票日期开始 | |
date_end | String | 否 | 开票日期结束 | |
createtime_begin | String | 否 | 收录日期开始 | |
createtime_end | String | 否 | 收录日期结束 | |
classification | String | 否 | 详见各票种json示例 | |
purchaserstatus | String | 否 | 报销状态,详见报销状态 |
# 返回值
{
"code": "0000",
"datas": {
"datas": [
{
"amount": 27,
"billId": null,
"buyerName": null,
"carNum": null,
"date": "20190114",
"destination": null,
"id": "4",
"inspectStatus": 0,
"invoiceCode": null,
"invoiceMedium": null,
"invoiceNum": "09997919",
"invoiceType": null,
"invoiceTypeStr" : null,
"origin": null,
"purchaserStatus": null,
"sellerName": null,
"time": null,
"trainNum": null,
"userId": "123"
}
],
"pageNum": 0,
"pageSize": 0,
"total": 1
},
"msg": "票据摘要列表"
# 返回值说明
编码 | 名称 | 类型 | 备注 |
---|---|---|---|
code | 状态码 | String | |
msg | 返回提示信息 | String | |
datas | 返回对象 | Array | |
id | 摘要主键 | Long | |
billId | 票据主键 | Long | |
invoiceType | 票种类型值 | int | 详见票种类型 |
invoiceTypeStr | 票种类型字符串 | String | 详见票种类型 |
invoiceMedium | 介质 | int | 0-电子发票1-纸质发票 |
invoiceCode | 发票代码 | String | |
invoiceNum | 发票号码 | String | |
date | 开票日期 | String | yyyyMmdd |
time | 时间 | String | |
amount | 金额 | Decimal | |
purchaserStatus | 报销状态 | int | 详见报销状态 |
inspectStatus | 查验状态 | int | 0-未查验1-已查验2-查验失败 |
buyerName | 购方名称 | String | |
sellerName | 销方名称 | String | |
carNum | 车牌号 | String | |
trainNum | 火车车次 | String | |
origin | 始发站 | String | |
destination | 终点站 | String | |
kind | 发票类别 | String | 通信、餐饮等 |
vatType | 增值税发票类型 | String | |
def1-10 | 自定义项 |
# 修改发票状态
# URL
POST
http://{IP}:{PORT}/piaoeda-web/api/bill/purchaser-status
# 请求体
{
"useremail":"admin@admin.com",
"usermobile":"13811111111",
"summaries":[{
"billType":"invoice",
"invoiceCode":"111001881001",
"invoiceNum":"15379485",
"purchaserStatus":33
},
...
]
}
# 请求参数说明
参数 | 类型 | 长度 | 必输 | 说明 |
---|---|---|---|---|
useremail | String | 否 | 用户邮箱(与手机号不能同时为空) | |
usermobile | String | 否 | 用户手机号(与用户邮箱不能同时为空) | |
billType | String | 是 | 票据类型(详见附录全票种) | |
invoiceCode | String | 否 | 发票代码 | |
invoiceNum | String | 否 | 发票号码 | |
purchaserStatus | Integer | 是 | 发票报销状态 | |
airType | String | 否 | 航空类型 1:ocr识别 invoiceNum字段必传 2:源文件解析 receiptNumber字段必传 | |
checkCode | String | 否 | 校验码 | |
receiptNumber | String | 否 | 行程单号码 |
# 返回值
{
"code" : "0000",
"msg" : "操作成功",
"datas": {
"carNum": null,
"date": "20180118",
"endTime": "04:51",
"filePath": "group1/M01/53/9B/wKg0Y1ynGC2AQH1RAAUV99Y6vW4.piaoyo",
"id": "90",
"invoiceCode": "111001881001",
"invoiceNum": "15379485",
"kind": "交通",
"mileage": 18.7,
"orgid": null,
"place": "北京市",
"purchaserStatus": 33,
"startTime": "04:21",
"totalAmount": 68
}
}
# 返回值说明
编码 | 名称 | 类型 | 说明 |
---|---|---|---|
code | 状态码 | String | |
msg | 提示信息 | String | |
data | 被修改发票信息 | Object |
# 根据号码代码获取信息
# URL
POST
http://{IP}:{PORT}/piaoeda-web/api/bill/summary
# 请求体
{
"useremail" : "admin@admin.com",
"usermobile" : "13811111111",
"summaries" : [
{
"invoiceCode" : "111111111",
"invoiceNum" : "111222",
"billType" : "tolls"
}
]
}
# 请求体说明
参数 | 类型 | 长度 | 必填 | 说明 |
---|---|---|---|---|
useremail | String | 否 | 手机号邮箱不能都为空,手机优先 | |
usermobile | String | 否 | 手机号邮箱不能都为空,手机优先 | |
invoiceCode | String | 否 | 发票代码 | |
invoiceNum | String | 是 | 发票号码 | |
billType | String | 是 | 详见票种类型 | |
airType | String | 否 | 航空类型 1:ocr识别 invoiceNum字段必传 2:源文件解析 receiptNumber字段必传 | |
checkCode | String | 否 | 校验码 | |
receiptNumber | String | 否 | 行程单号码 |
# 返回值
{
"code" : "0000",
"msg" : "操作成功",
"datas" : [{
"amount": 27,
"billId": null,
"buyerName": null,
"carNum": null,
"date": "20190114",
"destination": null,
"id": "4",
"inspectStatus": 0,
"invoiceCode": null,
"invoiceMedium": null,
"invoiceNum": "09997919",
"invoiceType": null,
"invoiceTypeStr" : null,
"origin": null,
"purchaserStatus": null,
"sellerName": null,
"time": null,
"trainNum": null,
"userId": "123"
}
]
}
# 返回值说明
编码 | 名称 | 类型 | 备注 |
---|---|---|---|
code | 状态码 | String | |
msg | 返回提示信息 | String | |
datas | 返回对象 | Array | |
id | 摘要主键 | Long | |
billId | 票据主键 | Long | |
invoiceType | 票种类型值 | int | 详见票种类型 |
invoiceTypeStr | 票种类型字符串 | String | 详见票种类型 |
invoiceMedium | 介质 | int | 0-电子发票1-纸质发票 |
invoiceCode | 发票代码 | String | |
invoiceNum | 发票号码 | String | |
date | 日期 | String | yyyyMmdd |
time | 时间 | String | |
amount | 金额 | Decimal | |
purchaserStatus | 报销状态 | int | 详见报销状态 |
inspectStatus | 查验状态 | int | 0-未查验1-已查验2-查验失败 |
buyerName | 购方名称 | String | |
sellerName | 销方名称 | String | |
carNum | 车牌号 | String | |
trainNum | 火车车次 | String | |
origin | 始发站 | String | |
destination | 终点站 | String | |
kind | 发票类别 | String | 通信、餐饮等 |
vatType | 增值税发票类型 | String |
# 个人票夹票据详情查询
返回数据根据摘要对应的票种类型显示不同的详情信息
# URL
POST
http://{IP}:{PORT}/piaoeda-web/api/bill/detail
# 请求参数说明
编码 | 名称 | 类型 | 说明 |
---|---|---|---|
id | 摘要ID | Long |
# 请求体
{
"useremail": "admin@admin.com",
"usermobile" : "13811111111",
"summary" : {
"invoiceCode" : "11112222",
"invoiceNum" : "1222333",
"billType" : "taxi"
}
}
# 请求体说明
参数 | 类型 | 长度 | 必填 | 说明 |
---|---|---|---|---|
useremail | String | 否 | 手机号邮箱不能都为空,手机优先 | |
usermobile | String | 否 | 手机号邮箱不能都为空,手机优先 | |
invoiceCode | String | 是 | 发票代码,没有代码时传空 | |
invoiceNum | String | 是 | 发票号码 | |
billType | String | 是 | 详见票种类型 | |
airType | String | 否 | 航空类型 1:ocr识别 invoiceNum字段必传 2:源文件解析 receiptNumber字段必传 | |
checkCode | String | 否 | 校验码 | |
receiptNumber | String | 否 | 行程单号码 |
# 返回值
{
"code" : "0000",
"msg" : "操作成功",
"datas" : {
"date": "20190101",
"destination": "北京",
"feeWithoutTax": 287.61,
"filePath": "group1/M01/53/9B/wKg0Y1ynGC2AQH1RAAUV99Y6vW4.piaoyo",
"id": "19",
"kind": "交通",
"level": null,
"name": "刘强",
"number": "F013549",
"origin": "哈尔滨北",
"purchaserStatus": 33,
"seatNo": "二等座",
"taxAmount": 25.89,
"time": "09:17",
"totalAmount": 313.5,
"trainNum": "D26"
}
}
# 返回值说明
编码 | 名称 | 类型 | 说明 |
---|---|---|---|
code | 状态码 | String | |
msg | 提示信息 | String | |
datas | 返回对应详情信息 | Object | 详见各票种json示例 |
# 个人票夹附件预览(pdf/images)
# URL
POST
http://{IP}:{PORT}/piaoeda-web/api/bill/preview
# 请求体
{
"useremail": "admin@admin.com",
"usermobile" : "13811111111",
"summary" : {
"invoiceCode" : "11112222",
"invoiceNum" : "1222333",
"billType" : "taxi"
}
}
# 请求体说明
参数 | 类型 | 长度 | 必输 | 说明 |
---|---|---|---|---|
useremail | String | 是 | 手机号邮箱不能都为空,手机优先 | |
usermobile | String | 是 | 手机号邮箱不能都为空,手机优先 | |
invoiceCode | String | 否 | 发票代码,没有时传空 | |
invoiceNum | String | 否 | 发票号码 | |
billType | String | 否 | 详见票种类型 | |
airType | String | 否 | 航空类型 1:ocr识别 invoiceNum字段必传 2:源文件解析 receiptNumber字段必传 | |
checkCode | String | 否 | 校验码 | |
receiptNumber | String | 否 | 行程单号码 |
# 返回值
{
"code" : "0000",
"msg" : "操作成功",
"datas" : "base64编码图片信息"
}
# 返回值说明
编码 | 名称 | 类型 | 说明 |
---|---|---|---|
code | 状态码 | String | |
msg | 提示信息 | String | |
datas | 图片 | String | Base64编码 |
# 个人票夹附件下载
# URL
POST
http://{IP}:{PORT}/piaoeda-web/api/bill/download
# 请求体
{
"useremail": "admin@admin.com",
"usermobile" : "13811111111",
"summary" : {
"invoiceCode" : "11112222",
"invoiceNum" : "1222333",
"billType" : "taxi"
}
}
# 请求体说明
参数 | 类型 | 长度 | 必输 | 说明 |
---|---|---|---|---|
useremail | String | 是 | 手机号邮箱不能都为空,手机优先 | |
usermobile | String | 是 | 手机号邮箱不能都为空,手机优先 | |
invoiceCode | String | 否 | 发票代码,没有时传空 | |
invoiceNum | String | 否 | 发票号码 | |
billType | String | 否 | 详见票种类型 | |
airType | String | 否 | 航空类型 1:ocr识别 invoiceNum字段必传 2:源文件解析 receiptNumber字段必传 | |
checkCode | String | 否 | 校验码 | |
receiptNumber | String | 否 | 行程单号码 |
# 返回值
附件二进制流数据
# 个人票夹新增
# URL
POST
http://{IP}:{PORT}/piaoeda-web/api/bill/add
# 请求体
{
"usermobile" : "13811111111",
"useremail" : "admin@admin.com",
"billList" : [{
"billType" : "train",
"imageId" : "300",
"imageContent" : "base64编码图片",
"imageName" : "eeee.jpg",
"data" : {
"date": "20190101",
"endTime": "13:47",
"invoiceCode": "111001881001",
"invoiceNum": "09997919",
"kind": "交通",
"mileage": 7.5,
"place": "北京市",
"startTime": "13:33",
"totalAmount": 27.00
},
"inspectStatus":0
}
]
}
# 请求体说明
参数 | 类型 | 长度 | 必输 | 描述 |
---|---|---|---|---|
usermobile | String | 否 | 手机号邮箱不能都为空,手机优先 | |
useremail | String | 否 | 手机号邮箱不能都为空,手机优先 | |
billType | String | 是 | 详见票种类型 | |
imageId | String | 否 | 图片ID,OCR查验得到的OCR | |
imageContent | String | 否 | 图片内容,Base64编码 | |
imageName | String | 否 | 图片名称,如果有图片内容则必输 | |
data | Object | 是 | 票据明细,详见详见各票种json示例 | |
inspectStatus | Integer | 否 | 第三方查验状态 0:未查验。1:已查验。2:查验失败 |
# 返回值
{
"code" : "0000",
"msg" : "操作成功"
}
# 返回值说明
编码 | 名称 | 类型 | 说明 |
---|---|---|---|
code | 状态码 | String | |
msg | 提示信息 | String |
# 个人票夹删除
# URL
POST
http://{IP}:{PORT}/piaoeda-web/api/bill/delete
# 请求体
{
"usermobile" : "13811111111",
"useremail" : "admin@admin.com",
"summarys" : [{
"invoiceCode" : "111111111",
"invoiceNum" : "111222",
"billType" : "tolls"
}
]
}
# 请求体说明
参数 | 类型 | 长度 | 必输 | 说明 |
---|---|---|---|---|
useremail | String | 是 | 手机号邮箱不能都为空,手机优先 | |
usermobile | String | 是 | 手机号邮箱不能都为空,手机优先 | |
summarys | Array | 是 | 根据号码代码和类型删除数据 | |
invoiceCode | String | 是 | 发票代码,没有时传空 | |
invoiceNum | String | 是 | 发票号码 | |
billType | String | 是 | 详见票种类型 | |
airType | String | 否 | 航空类型 1:ocr识别 invoiceNum字段必传 2:源文件解析 receiptNumber字段必传 | |
checkCode | String | 否 | 校验码 | |
receiptNumber | String | 否 | 行程单号码 |
# 返回值
{
"code" : "0000",
"msg" : "操作成功"
}
# 返回值说明
编码 | 名称 | 类型 | 说明 |
---|---|---|---|
code | 状态码 | String | |
msg | 提示信息 | String |
# 个人票夹修改
# URL
POST
http://{IP}:{PORT}/piaoeda-web/api/bill/update
# 请求体
{
"usermobile": "18800000000",
"useremail" : "admin@admin.com",
"invoiceNum" : "P026498",
"billType" : "train",
"newBillType": null,
"data" : {
"date": "20181031",
"kind": "交通",
"origin": "北京南1",
"destination": "上海虹桥2",
"number": "P026498",
"totalAmount": 553.00,
"trainNum": "G9",
"name": "王珊珊",
"time": "12:00",
"seatNo": "二等座"
}
}
# 请求体说明
参数 | 类型 | 长度 | 必输 | 描述 |
---|---|---|---|---|
usermobile | String | 否 | 手机号邮箱不能都为空,手机优先 | |
useremail | String | 否 | 手机号邮箱不能都为空,手机优先 | |
invoiceNum | String | 是 | 航空电子行程单的行程单号码/火车票的车票号码(车票左上角)/增值税发票、机打发票、过路费、定额发票、出租车发票、过路费发票的发票号码 | |
billType | String | 是 | 原票据类型。如进修改具体票据信息,不修改票据类型,则该字段为data数据的票据类型。详见票种类型 | |
newBillType | String | 否 | 如果需要更新的不仅是票据的数据,还有票据的类型。则该值需要传入data数据的票据类型。如票据类型不变,则该字段不传值。详见票种类型 | |
data | Object | 是 | 票据明细,详见各票种json示例 |
# 返回值
{
"code" : "0000",
"msg" : "操作成功"
}
# 返回值说明
编码 | 名称 | 类型 | 说明 |
---|---|---|---|
code | 状态码 | String | |
msg | 提示信息 | String |
# 提交至企业台账
提交至台账与V2接口一致,为全部提交全部回滚接口,默认最多支持50张票据提交,如果需要返回发票附件信息,则一次最多只能传10张发票;
# URL
POST
http://{IP}:{PORT}/piaoeda-web/api/bill/commit
# 请求体
{
"usermobile": "13811111111",
"useremail": "admin@admin.com",
"orgcode": "XXXXXX",
"nsrsbh": "101011111111111",
"submitter": "提交人",
"srcBillCode": "来源单据号",
"srcBillType": "来源单据类型",
"srcBillid":"业务系统单据ID",
"reimburseUser": "测试报销人1",
"returnEnclosure": "Y",
"returnSuspectMsg": "Y",
"contentType":"Y",
"busiOp":"1",
"summarys": [{
"invoiceNum": "11111111",
"invoiceCode": "111111111111",
"projectCode": "aaa",
"bsubinvoice": "Y",
"exportRebates": "Y",
"billType": "invoice"
},
{
"invoiceNum": "22222222",
"invoiceCode": "222222222222",
"billType": "air"
}
]
}
# 请求体说明
参数 类型 长度 是否必填 默认值 描述 nsrsbh String 是 纳税人识别号 orgcode String 否 组织编码 returnEnclosure String 是 N 返回接口是否包含发票附件 busiOp String 是 1 1:报销台账 srcBillCode String 否 来源单据号 srcBillType String 否 来源单据类型 srcBillid String 是 业务系统单据ID submitter String 否 提交人 invoiceNum String 是 发票号码 invoiceCode String 是 发票代码 reimburseUser String 否 报销人 billType String 是 票据类型 tolls-过路费;train-火车;quota-定额发票;machine-机打发票;taxi-出租车;passenger-客运;air-航空电子行程单;invoice-增值税发票;nontax-财政非税票据(包含医疗门诊、住院) usermobile String 是 手机号邮箱不能都为空,手机优先 useremail String 是 手机号邮箱不能都为空,手机优先 projectCode String 否 项目编码 bsubinvoice String 否 是否分包 Y:是 N:否 exportRebates String 否 出口退税Y:是 N:否 contentType String 否 N 是否返回附件扩展名 Y,N returnSuspectMsg String 否 N 是否返回疑票信息 Y,N
# 返回值
{
"code": "0000",
"msg": "操作成功",
"datas": [{
"fpDm": "111111111111",
"fpHm": "11111111",
"billType": "invoice",
"bill": {
"fpDm": "330xxxx",
"fpHm": "100xxx",
"kprq": "20171026",
"jym": "5277xxxxx",
"xsfDzdh": "浙江 11111",
"xsfMc": "浙江",
"xsfNsrsbh": "12345",
"xsfYhzh": "工商银行40002993",
"gmfDzdh": "北京 11xxx",
"gmfMc": "购买方名称",
"gmfNsrsbh": "11xxx",
"gmfYhzh": "中国工商银行11xxx",
"kpr": null,
"skr": null,
"fhr": null,
"jshj": 1660550.53,
"hjje": 1419273.96,
"hjse": 241276.57,
"bz": "备注",
"fplx": "4",
"items": [{
"xmmc": "电力",
"ggxh": "",
"dw": "千瓦时",
"xmsl": 1877814,
"xmdj": 0.755811788209566,
"xmje": 1419273.96,
"se": 241276.57,
"sl": 17
}],
"fileList":[
{
"type":"invoice",
"fileid":"源文件PK1",
"srcbillid":"业务系统单据ID1"
},
{
"type":"voucher",
"fileid":"源文件PK2",
"srcbillid":"业务系统单据ID1"
}
]
},
"issuspect": "Y",
"suspectRule": "节假日发票进入报销台账",
"contentType": "pdf",
"content": "xxx1"
},
{
"fpDm": "222222222222",
"fpHm": "22222222",
"billType": "air",
"bill": {
"date": "20190424",
"ticketNum": "电子客票号",
"checkCode": "验证码",
"agentCode": "销售单位代号",
"issueBy": "填开单位",
"fare": 100.88,
"tax": 8.88,
"fuelSurcharge": 8.88,
"caacDevelopFund": 8.88,
"insurance": 8.88,
"totalAmount": 200.88,
"feeWithoutTax": 200.88,
"taxAmount": 200.88,
"userName": "乘机人姓名",
"userId": "身份证号",
"purchaserStatus": 35,
"kind": "发票消费类型",
"filePath": "filePath",
"itemList": [{
"from": "出发",
"to": "到达",
"flightNumber": "航班号",
"carrier": "承运人",
"seat": "舱位",
"date": "20190424",
"time": "13:20"
}],
"fileList":[
{
"type":"air",
"fileid":"源文件PK1",
"srcbillid":"业务系统单据ID1"
}
]
},
"content": "xxx2"
},
{
"fpDm": "333",
"fpHm": "333",
"billType": "train",
"bill": {
"date": "20190424",
"time": "13:20",
"number": "票号",
"trainNum": "车次",
"origin": "始发站",
"destination": "终点站",
"level": "坐席",
"seatNo": "座位号",
"name": "姓名",
"totalAmount": 200.88,
"feeWithoutTax": 200.88,
"taxAmount": 200.88,
"purchaserStatus": 35,
"kind": "发票消费类型",
"filePath": "filePath",
"fileList":[
{
"type":"air",
"fileid":"源文件PK1",
"srcbillid":"业务系统单据ID1"
}
]
},
"content": "xxx2",
},
{
"fpDm": "444",
"fpHm": "444",
"billType": "passenger",
"bill": {
"invoiceCode": "发票代码",
"invoiceNum": "发票号码",
"date": "20190424",
"time": "13:20",
"entrance": "入口",
"exit": "出口",
"name": "姓名",
"totalAmount": 200.88,
"feeWithoutTax": 200.88,
"taxAmount": 200.88,
"purchaserStatus": 35,
"kind": "发票消费类型",
"filePath": "filePath"
},
"content": "xxx2",
"fileids":["fileid1"]
},
{
"fpDm": "555",
"fpHm": "555",
"billType": "tolls",
"bill": {
"invoiceCode": "发票代码",
"invoiceNum": "发票号码",
"date": "20190424",
"time": "13:20",
"entrance": "入口",
"exit": "出口",
"totalAmount": 200.88,
"purchaserStatus": 35,
"kind": "发票消费类型",
"filePath": "filePath"
},
"issuspect": "Y",
"suspectRule": "节假日发票进入报销台账",
"content": "xxx2"
},
{
"fpDm": "666",
"fpHm": "666",
"billType": "taxi",
"bill": {
"invoiceCode": "发票代码",
"invoiceNum": "发票号码",
"date": "20190424",
"carNum": "车牌号",
"mileage": 13.33,
"startTime": "13:42",
"endTime": "14:42",
"totalAmount": 200.88,
"purchaserStatus": 35,
"place": "发票所在地",
"kind": "发票消费类型",
"filePath": "filePath"
},
"issuspect": "Y",
"suspectRule": "节假日发票进入报销台账",
"content": "xxx2"
},
{
"fpDm": "777",
"fpHm": "777",
"billType": "machine",
"bill": {
"date": "20190424",
"time": "13:20",
"invoiceCode": "发票代码",
"invoiceNum": "发票号码",
"checkCode": "校验码",
"category": "种类,oil 表示是加油票",
"sellerName": "销售方名称",
"sellerTaxId": "销售方纳税人识别号",
"buyerName": "购买方名称",
"buyerTaxId": "购买方纳税人识别号",
"totalAmount": 200.88,
"purchaserStatus": 35,
"kind": "发票消费类型",
"filePath": "filePath",
"itemList": [{
"item": "项目",
"amount": 100.88
}]
},
"issuspect": "Y",
"suspectRule": "节假日发票进入报销台账",
"content": "xxx2"
},
{
"fpDm": "888",
"fpHm": "888",
"billType": "quota",
"bill": {
"invoiceCode": "发票代码",
"invoiceNum": "发票号码",
"productName": "商品项目名称",
"totalAmount": 200.88,
"purchaserStatus": 35,
"kind": "发票消费类型",
"filePath": "filePath"
},
"content": "xxx2"
},
{
"fpDm": "999",
"fpHm": "999",
"billType": "nontax",
"bill": {
"busiType": 65,
"checker": "10219",
"handlingPerson": "2522",
"invoiceCode": "13061021",
"invoiceNum": "0033445487",
"invoicingPartyName": "河北省中医院",
"issueDate": "2021-05-07",
"payerPartyCode": "130102194201142167",
"payerPartyName": "申秀梅",
"purchaserStatus": 36,
"randomNumber": "301957",
"recName": "2522",
"remark": "",
"totalAmount": 940.80,
"tags": [{
"tagname": "标签名称"
}],
"basicExt": {
"accountPayAmount": 0.00,
"caseNumber": "",
"departmentName": "急诊科",
"fundPayAmount": 0.00,
"gender": "女",
"hospitalizationNumber": "EP0000873224",
"inhospitalDate": "2021-05-07",
"medicalDate": "2021-05-07",
"medicalInsuranceId": "",
"medicalInsuranceType": "",
"orgType": "中医医院",
"otherPayAmount": 0.00,
"outhospitalDate": "2021-05-07",
"ownPayAmount": 940.80,
"patientNumber": "EP0000873224",
"prepayAmount": 0.00,
"rechargeAmount": 0.00,
"refundAmount": 0.00,
"selfpaymentAmount": 0.00,
"selfpaymentCost": 0.00
},
"details": [{
"itemAmount": 198.00,
"itemCode": "6",
"itemDetailName": null,
"itemName": "放射费",
"itemQuantity": null,
"itemStd": 198.00,
"itemUnit": ""
}],
"auxdetails": [{
"auxItemAmount": 90.00,
"auxItemCode": "化验费",
"auxItemName": "化验费",
"auxItemQuantity": 1.00,
"auxItemRelatedCode": null,
"auxItemRelatedName": null,
"auxItemRemark": "",
"auxItemStd": null,
"auxItemUnit": "次"
}]
},
"content": "xxx2"
}
]
}
# 返回值说明
invoice
参数 类型 描述 说明 code String 状态码 0000-操作成功;1001-数据不合法;详见状态码说明 msg String 信息说明 fpDm String 发票代码 fpHm String 发票号码 content String 发票附件 base64编码(PDF) fileids String[] 文件pk 增值税多附件返回多个,其他票种返回一个 contentType String 附件类型 pdf、ofd、jpg、gif、png、bmp issuspect String 是否疑票 Y/N suspectRule String 疑票规则
air
参数 | 类型 | 描述 | 说明 |
code | String | 状态码 | 0000-操作成功;1004-账号已经存在;详见状态码说明 (opens new window) |
msg | String | 信息说明 | |
fare | double | 票价 | |
tax | double | 税费 | |
fuelSurcharge | double | 燃油附加费 | |
caacDevelopFund | double | 民航发展基金 | |
insurance | double | 保险费 | |
totalAmount | double | 总金额 | |
feeWithoutTax | double | 金额(不含税) | |
taxAmount | double | 税额 | |
purchaserStatus | int | 报销状态 | -1-未设值;30-未收票;33-待提交;34-已归集;35-未报销;36-报销中;37-未记账;39-已报销;42-已记账; |
content | String | 发票附件 | base64编码后图片 |
train
参数 | 类型 | 描述 | 说明 |
code | String | 状态码 | 0000-操作成功;1004-账号已经存在;详见状态码说明 (opens new window) |
msg | String | 信息说明 | |
totalAmount | double | 总金额 | |
feeWithoutTax | double | 金额(不含税) | |
taxAmount | double | 税额 | |
purchaserStatus | int | 报销状态 | -1-未设值;30-未收票;33-待提交;34-已归集;35-未报销;36-报销中;37-未记账;39-已报销;42-已记账; |
content | String | 发票附件 | base64编码后图片 |
passenger
参数 | 类型 | 描述 | 说明 |
code | String | 状态码 | 0000-操作成功;1004-账号已经存在;详见状态码说明 (opens new window) |
msg | String | 信息说明 | |
totalAmount | double | 总金额 | |
feeWithoutTax | double | 金额(不含税) | |
taxAmount | double | 税额 | |
purchaserStatus | int | 报销状态 | -1-未设值;30-未收票;33-待提交;34-已归集;35-未报销;36-报销中;37-未记账;39-已报销;42-已记账; |
content | String | 发票附件 | base64编码后图片 |
tolls
参数 | 类型 | 描述 | 说明 |
code | String | 状态码 | 0000-操作成功;1004-账号已经存在;详见状态码说明 (opens new window) |
msg | String | 信息说明 | |
totalAmount | double | 总金额 | |
purchaserStatus | int | 报销状态 | -1-未设值;30-未收票;33-待提交;34-已归集;35-未报销;36-报销中;37-未记账;39-已报销;42-已记账; |
content | String | 发票附件 | base64编码后图片 |
issuspect | String | 是否疑票 | Y/N |
suspectRule | String | 疑票规则 |
taxi
参数 | 类型 | 描述 | 说明 |
code | String | 状态码 | 0000-操作成功;1004-账号已经存在;详见状态码说明 (opens new window) |
msg | String | 信息说明 | |
totalAmount | double | 总金额 | |
purchaserStatus | int | 报销状态 | -1-未设值;30-未收票;33-待提交;34-已归集;35-未报销;36-报销中;37-未记账;39-已报销;42-已记账; |
mileage | double | 公里数 | |
startTime | String | 上车时间 | |
endTime | String | 下车时间 | |
content | String | 发票附件 | base64编码后图片 |
issuspect | String | 是否疑票 | Y/N |
suspectRule | String | 疑票规则 |
machine
参数 | 类型 | 描述 | 说明 |
code | String | 状态码 | 0000-操作成功;1004-账号已经存在;详见状态码说明 (opens new window) |
msg | String | 信息说明 | |
amount | double | 金额 | |
taxAmount | double | 税额 | |
purchaserStatus | int | 报销状态 | -1-未设值;30-未收票;33-待提交;34-已归集;35-未报销;36-报销中;37-未记账;39-已报销;42-已记账; |
content | String | 发票附件 | base64编码后图片 |
issuspect | String | 是否疑票 | Y/N |
suspectRule | String | 疑票规则 |
quota
参数 | 类型 | 描述 | 说明 |
code | String | 状态码 | 0000-操作成功;1004-账号已经存在;详见状态码说明 (opens new window) |
msg | String | 信息说明 | |
totalAmount | double | 总金额 | |
purchaserStatus | int | 报销状态 | -1-未设值;30-未收票;33-待提交;34-已归集;35-未报销;36-报销中;37-未记账;39-已报销;42-已记账; |
content | String | 发票附件 | base64编码后图片 |
nontax
编码 | 名称 | 类型 | 说明 |
---|---|---|---|
busiType | 业务类型 | Integer | 64-财政非税票据 65-进项医疗门诊票据 66-进项医疗住院票据 |
checker | 复核人 | String | |
handlingPerson | 收款人 | String | |
invoiceCode | 发票代码 | String | |
invoiceNum | 发票号码 | String | |
invoicingPartyName | 开票单位 | String | |
issueDate | 开票日期 | String | |
payerPartyCode | 交款人统一社会信用代码 | String | |
payerPartyName | 交款人 | String | |
purchaserStatus | 报销状态 | Integer | (-1-未设值;30-未收票;33-待提交;34-已归集;35-未报销;36-报销中;37-未记账;39-已报销;42-已记账; |
randomNumber | 校验码 | String | |
recName | 收款单位 | String | |
remark | 备注 | String | |
totalAmount | 总金额 | BigDecimal | |
basicExt | 基本信息扩展 | ||
accountPayAmount | 个人账户支付 | BigDecimal | |
caseNumber | 病例号 | String | |
departmentName | 科别 | String | |
fundPayAmount | 医保统筹基金支付 | BigDecimal | |
gender | 性别 | String | |
hospitalizationNumber | 住院号 | String | |
inhospitalDate | 住院日期 | String | |
medicalDate | 就诊日期 | String | |
medicalInsuranceId | 医保编号 | String | |
medicalInsuranceType | 医保类型 | String | |
orgType | 医疗机构类型 | String | |
otherPayAmount | 其他支付 | BigDecimal | |
outhospitalDate | 出院日期 | String | |
ownPayAmount | 个人现金支付 | BigDecimal | |
patientNumber | 门诊号 | String | |
prepayAmount | 预缴金额 | BigDecimal | |
rechargeAmount | 补缴金额 | BigDecimal | |
refundAmount | 退费金额 | BigDecimal | |
selfpaymentAmount | 个人自付 | BigDecimal | |
selfpaymentCost | 个人自费 | BigDecimal | |
details | 明细信息 | Array | |
itemAmount | 金额 | BigDecimal | |
itemCode | 项目编码 | String | |
itemDetailName | 项目明细 | String | |
itemName | 项目名称 | String | |
itemQuantity | 数量 | BigDecimal | |
itemStd | 标准 | BigDecimal | |
itemUnit | 单位 | String | |
auxdetails | 辅助明细信息 | Array | |
auxItemAmount | 收费明细项目金额 | BigDecimal | |
auxItemCode | 收费明细项目编码 | String | |
auxItemName | 收费明细项目名称 | String | |
auxItemQuantity | 收费明细项目数量 | BigDecimal | |
auxItemRelatedCode | 对应项目编码 | String | |
auxItemRelatedName | 对应项目名称 | String | |
auxItemRemark | 收费明细项目备注 | String | |
auxItemStd | 收费明细项目标准 | BigDecimal | |
auxItemUnit | 收费明细项目单位 | BigDecimal | |
tags | 标签 | Array | |
tagname | 标签名称 | String |
# 台账报销
# URL
POST
http://{IP}:{PORT}/input-tax/api/bill-collections/reimbursed
请移步 进项-报销台账全票种 - 台账报销 查看
# 台账取消报销
# URL
POST
http://{IP}:{PORT}/input-tax/api/bill-collections/cancel-reimbursed
请移步 进项-报销台账全票种 - 台账取消报销 查看
# 台账记账
# URL
POST
http://{IP}:{PORT}/input-tax/api/bill-collections/account
请移步 进项-报销台账全票种 - 台账记账 查看
# 台账取消记账
# URL
POST
http://{IP}:{PORT}/input-tax/api/bill-collections/cancel-account
请移步 进项-报销台账全票种 - 台账取消记账 查看
# 报销台账删除
# URL
POST
http://{IP}:{PORT}/input-tax/api/bill-collections/delete
请移步 进项-报销台账全票种 - 报销台账删除 查看
# 个人票夹行程单预览(images)
# URL
POST
http://{IP}:{PORT}/piaoeda-web/api/bill/itinerary/preview
# 请求体
{
"useremail": "admin@admin.com",
"usermobile" : "13811111111",
"pagenum" : 1,
"summary" : {
"invoiceCode" : "11112222",
"invoiceNum" : "1222333",
"billType" : "invoice"
}
}
# 请求体说明
参数 | 类型 | 长度 | 必输 | 说明 |
---|---|---|---|---|
useremail | String | 是 | 手机号邮箱不能都为空,手机优先 | |
usermobile | String | 是 | 手机号邮箱不能都为空,手机优先 | |
pagenum | Integer | 是 | 页码,取值为1至n,n为pdf总页数 | |
invoiceCode | String | 否 | 发票代码,没有时传空 | |
invoiceNum | String | 否 | 发票号码 | |
billType | String | 否 | 详见票种类型 |
# 返回值
{
"code": "0000",
"datas": {
"imageBas64": "base64编码图片信息",
"pageCount": 3
},
"msg": "SUCCESS"
}
# 返回值说明
编码 | 名称 | 类型 | 说明 |
---|---|---|---|
code | 状态码 | String | |
msg | 提示信息 | String | |
imageBas64 | 图片 | String | Base64编码 |
pageCount | pdf总页数 | Integer |
# 个人票夹行程单下载
# URL
POST
http://{IP}:{PORT}/piaoeda-web/api/bill/itinerary/download
# 请求体
{
"useremail": "admin@admin.com",
"usermobile" : "13811111111",
"summary" : {
"invoiceCode" : "11112222",
"invoiceNum" : "1222333",
"billType" : "invoice"
}
}
# 请求体说明
参数 | 类型 | 长度 | 必输 | 说明 |
---|---|---|---|---|
useremail | String | 是 | 手机号邮箱不能都为空,手机优先 | |
usermobile | String | 是 | 手机号邮箱不能都为空,手机优先 | |
invoiceCode | String | 否 | 发票代码,没有时传空 | |
invoiceNum | String | 否 | 发票号码 | |
billType | String | 否 | 详见票种类型 |
# 返回值
附件二进制流数据
# 个人票夹发票提交到采购台账
# 接口说明
个人票夹发票提交到采购台账,根据参数返回发票的全票面信息以及发票附件,本接口一次最多允许提交5张
# URL
POST
http://{HOST}:{PORT}/piaoeda-web/api/einvoice/v2/fetchPurchase?appid=XXXXXX
# 请求体
{
"orgcode": "XXXXXX",
"nsrsbh": "101011111111111",
"srcBillCode":"来源单据号",
"invoices": [{
"returnEnclosure": "Y",
"fpHm": "11111111",
"fpDm": "111111111111",
"projectCode": "aaa",
"bsubinvoice": "Y",
"exportRebates": "Y",
"usercode" : "123123",
"purchaser" : "abc",
"email":"",
"mobil":"",
"headfield" :[
"fpDm",
"fpHm",
"kprq",
"jym",
"xsfNsrsbh",
"xsfMc",
"xsfDzdh",
"xsfYhzh",
"gmfNsrsbh",
"gmfMc",
"gmfDzdh",
"gmfYhzh",
"kpr",
"skr",
"fhr",
"yfpDm",
"yfpHm",
"jshj",
"hjje",
"hjse",
"bz",
"fplx"
],
"itemfield":[
"xmmc",
"ggxh",
"dw",
"xmsl",
"xmdj",
"xmje",
"sl",
"se"
]
},
{
"returnEnclosure": "Y",
"fpHm": "22222222",
"fpDm": "222222222222",
"usercode" : "123123",
"purchaser" : "abc",
"email":"",
"mobil":"",
"headfield" :[
"fpDm",
"fpHm",
"kprq",
"jym",
"xsfNsrsbh",
"xsfMc",
"xsfDzdh",
"xsfYhzh",
"gmfNsrsbh",
"gmfMc",
"gmfDzdh",
"gmfYhzh",
"kpr",
"skr",
"fhr",
"yfpDm",
"yfpHm",
"jshj",
"hjje",
"hjse",
"bz",
"fplx"
]
"itemfield":[
"xmmc",
"ggxh",
"dw",
"xmsl",
"xmdj",
"xmje",
"sl",
"se"
]
}
]
}
# 请求体说明
参数 | 类型 | 必填 | 默认值 | 描述 | 说明 |
---|---|---|---|---|---|
nsrsbh | String | 是 | 纳税人识别号 | 受票企业纳税人识别号;纳税人识别号与 组织编码至少传入一项 | |
orgcode | String | 否 | 组织编码 | 受票方企业在发票平台的组织编码纳税人识别号与组织编码至少传入一项 | |
returnEnclosure | String | 是 | Y | 返回接口是否包含发票附件 | 返回结果包含附件会增加网络流量,调用 发票过多是容易产生超时。Y:返回结果 包含附件,N:返回结果不包含附件 |
srcBillCode | String | 否 | 来源单据号 | ||
srcBillType | String | 否 | 来源单据类型 | ||
fpHm | String | 是 | 发票号码 | ||
purchaser | String | 否 | 采购人 | ||
fpDm | String | 是 | 发票代码 | ||
headfield | array | 是 | 发票头字段名 | 调用时选择需要返回的字段,可以根据需要的字段输入 | |
fpDm | String | 发票代码 | 发票头字段名 | ||
fpHm | String | 发票号码 | 发票头字段名 | ||
kprq | String | 开票日期 | 发票头字段名 | ||
jym | String | 校验码 | 发票头字段名 | ||
xsfNsrsbh | String | 销售方纳税人识别号 | 发票头字段名 | ||
xsfMc | String | 销售方名称 | 发票头字段名 | ||
xsfDzdh | String | 销售方地址电话 | 发票头字段名 | ||
xsfYhzh | String | 销售方银行账户 | 发票头字段名 | ||
gmfNsrsbh | String | 购买方纳税人识别号 | 发票头字段名 | ||
gmfMc | String | 购买方名称 | 发票头字段名 | ||
gmfDzdh | String | 购买方地址电话 | 发票头字段名 | ||
gmfYhzh | String | 购买方银行账户 | 发票头字段名 | ||
kpr | String | 开票人 | 发票头字段名 | ||
skr | String | 收款人 | 发票头字段名 | ||
fhr | String | 复核人 | 发票头字段名 | ||
yfpDm | String | 原发票代码 | 发票头字段名 | ||
yfpHm | String | 原发票号码 | 发票头字段名 | ||
jshj | String | 价税合计 | 发票头字段名 | ||
hjje | String | 合计金额 | 发票头字段名 | ||
hjse | String | 合计税额 | 发票头字段名 | ||
bz | String | 备注 | 发票头字段名 | ||
fplx | String | 发票类型 | 发票头字段名(1:电子普通发票,3增值税普通发票,4增值税专用发票) | ||
itemfield | array | 否 | 发票明细字段名 | 调用时选择需要返回的字段,可以根据需要的字段输入 | |
xmmc | String | 项目名称 | 发票明细字段名 | ||
ggxh | String | 规格型号 | 发票明细字段名 | ||
dw | String | 单位 | 发票明细字段名 | ||
xmsl | String | 项目数量 | 发票明细字段名 | ||
xmdj | String | 项目单价 | 发票明细字段名 | ||
xmje | String | 项目金额 | 发票明细字段名 | ||
sl | String | 税率 | 发票明细字段名 | ||
se | String | 税额 | 发票明细字段名 | ||
projectCode | String | 否 | 项目编码 | ||
bsubinvoice | String | 否 | 是否分包 Y:是 N:否 | ||
exportRebates | String | 否 | 出口退税Y:是 N:否 | ||
usercode | String | 否 | 用户编码 | 用户编码,用户邮箱,用户手机号必须有一个 | |
String | 否 | 用户邮箱 | 用户编码,用户邮箱,用户手机号必须有一个 | ||
mobil | String | 否 | 用户手机号 | 用户编码,用户邮箱,用户手机号必须有一个 |
# 返回值
{
"code": "0000",
"msg": "操作成功",
"datas": [
{
"invoiceInfo" :
{
"fpDm": "0110xxxxxxx1",
"fpHm": "xxxxxxx1",
"classification":"通讯",
"kprq": "2016-07-01",
"fpMw":"15<*026+848686",
"jym":"57644233870940613901",
"xsfNsrsbh":"xxxxxx",
"xsfMc":"江苏圆周电子商务有限公司北京分公司",
"xsfDzdh":"北京市海淀区北清路68号用友软件园2号楼3层 62434888",
"xsfYhzh":"11001048600052502301",
"gmfNsrsbh":"xxxx",
"gmfMc":"北京某公司",
"gmfDzdh":"北京某公司地址电话",
"gmfYhzh":"北京某公司银行账号",
"kpr":"开票人",
"skr":"收款人",
"fhr":"复核人",
"yfpDm":"xxxxxxx",
"yfpHm":"xxxxxx",
"jshj": 5.0,
"hjje": 4.0,
"hjse": 1.0,
"kpr": "Z000DZQD",
"bz":"备注",
"items": [
{
"xmmc": "笔记本",
"ggxh": "14寸",
"dw": "台",
"xmsl": 1,
"xmdj": 4.8,
"xmje": 4.8,
"sl": 0.17,
"se": 0.82
}
]
},
"invoiceEnclosure" : "base64编码的图片"
},
{
"invoiceInfo" :
{
"fpDm": "0110xxxxxxx1",
"fpHm": "xxxxxxx1",
"classification":"通讯",
"kprq": "2016-07-01",
"fpMw":"15<*026+848686",
"jym":"57644233870940613901",
"xsfNsrsbh":"xxxxxx",
"xsfMc":"江苏圆周电子商务有限公司北京分公司",
"xsfDzdh":"北京市海淀区北清路68号用友软件园2号楼3层 62434888",
"xsfYhzh":"11001048600052502301",
"gmfNsrsbh":"xxxx",
"gmfMc":"北京某公司",
"gmfDzdh":"北京某公司地址电话",
"gmfYhzh":"北京某公司银行账号",
"kpr":"开票人",
"skr":"收款人",
"fhr":"复核人",
"yfpDm":"xxxxxxx",
"yfpHm":"xxxxxx",
"jshj": 5.0,
"hjje": 4.0,
"hjse": 1.0,
"kpr": "Z000DZQD",
"bz":"备注",
"items": [
{
"xmmc": "笔记本",
"ggxh": "14寸",
"dw": "台",
"xmsl": 1,
"xmdj": 4.8,
"xmje": 4.8,
"sl": 0.17,
"se": 0.82
}
]
},
"invoiceEnclosure" : "base64编码的图片"
}
]
}
# 返回值说明
参数 | 类型 | 描述 | 说明 |
---|---|---|---|
code | String | 状态码 | 0000-操作成功详见状态码说明 |
msg | String | 信息说明 | |
datas | Array | 返回数据 | |
invoiceInfo | 发票信息 | 发票信息 | 发票的全票面信息 |
invoiceEnclosure | String | Base64编码的字符串 | 发票附件 |