# 个人全票种

# 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 用户编码 用户编码,用户邮箱,用户手机号必须有一个
email 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编码的字符串 发票附件
Last Updated: 3/28/2024, 1:31:00 PM