进项电子票据

---

说明 所有接口均采用JSON格式（UTF-8）交换数据。接口描述中<>（尖括号）表示占位符，需要替换为真实内容。查询采用采用不定数目的大写字母X表示。 <HOST>：服务的ip地址或者域名 <PORT>：端口

[TOC]

1、按号码代码查询票据信息

URL

POST

``http://:/yonbip-fi-taxgateway/input-tax/api/bill/vat/query?yht_access_token=XXXXX`

---

请头说明

参数	类型	是否必填	说明
yht_access_token	String	是	友互通yht_access_token

---

请求体

[
    {
        "fpDm": "011002200111",
        "fpHm": "02695329",
        "billType":"invoice"
    }
]

请求体说明

参数	类型	长度	是否必填	默认值	描述
fpDm	String		是		发票代码
fpHm	String		是		发票号码
billType	String		是		票据类型 目前仅支持（invoice增值税，custbook海关缴款书）

---

返回值

{
    "code": "0000",
    "datas": [
        {
            "bz": "",
            "fhr": null,
            "fpDm": "011002200111",
            "fpHm": "02695329",
            "fplx": "8",
            "gmfDzdh": "",
            "gmfMc": "用友网络科技股份有限公司",
            "gmfNsrsbh": "91110000600001760P",
            "gmfYhzh": "",
            "hjje": 176.99,
            "hjse": 23.01,
            "invoiceExt": {
                "accountStatus": 0,
                "archiveStatus": null,
                "busiFlag": 1,
                "compareStatus": 3,
                "declareStatus": null,
                "faceCompareStatus": null,
                "gatherModel": "ocr",
                "modifyStatus": null,
                "paymentStatus": 0,
                "receiveStatus": null,
                "reimburseMoney": 200.00,
                "reimburseStatus": 1,
                "reimburseTax": 23.01,
                "settleStatus": null,
                "signStatus": null,
                "srcBillcode": "业务系统单据号",
                "srcBillid": "业务系统单据ID",
                "srcBilltype": "来源业务系统",
                "srcChannel": "api",
                "srcSystem": "采购系统",
                "submitDate": "20220712",
                "submitStatus": 0,
                "submitter": "提交人",
                "suspectFlag": "1",
                "suspectRule": null,
                "suspectStatus": null,
                "thirdVerifyStatus": 0,
                "yyVerifyStatus": 1
            },
            "items": [
                {
                    "detailMotor": {
                        "cd": null,
                        "cgsmc": null,
                        "cjhm": null,
                        "cllx": null,
                        "cpxh": null,
                        "cpzh": null,
                        "djzh": null,
                        "dunwei": null,
                        "fdjhm": null,
                        "gfdh": null,
                        "gfdz": null,
                        "hgzh": null,
                        "jkzmsh": null,
                        "jydh": null,
                        "jydw": null,
                        "jydz": null,
                        "jysbh": null,
                        "jyyhzh": null,
                        "scdh": null,
                        "scdz": null,
                        "scmc": null,
                        "scqymc": null,
                        "scsbh": null,
                        "scyhzh": null,
                        "sfzhm": null,
                        "sjdh": null,
                        "swjgdm": null,
                        "swjgmc": null,
                        "wspzh": null,
                        "xcrs": null,
                        "xfdh": null,
                        "xfdw": null,
                        "xfdz": null,
                        "xfhm": null
                    },
                    "dw": "升",
                    "ggxh": "92号",
                    "se": 23.01,
                    "sl": 0.130000,
                    "xmdj": 6.7875665000,
                    "xmje": 176.99,
                    "xmmc": "*汽油*92号京标车用汽油(ⅥB)",
                    "xmsl": 26.0756193000
                }
            ],
            "jshj": 200.00,
            "jym": "71674645711950229631",
            "kpr": null,
            "kprq": "20220402",
            "nsrmc": "11134444",
            "nsrsbh": "111222333456333",
            "orgName": "百望333测试企业",
            "skr": null,
            "xsfDzdh": "北京市东城区广渠家园6号楼67006731",
            "xsfMc": "中国石化销售股份有限公司北京石油分公司",
            "xsfNsrsbh": "911100008011253056",
            "xsfYhzh": "中行使馆区支行 318156009857"
        }
    ],
    "msg": "查询成功"
}

返回值说明

参数	类型	长度	描述	说明
code	String		状态码	0000-操作成功;详见状态码说明
msg	String		信息说明
nsrsbh	String		受票企业税号
nsrmc	String		受票企业名称
orgName	String		受票组织名称
thirdVerifyStatus	Integer		第三方查验状态	0-未查验；1-已查验
accountStatus	Integer		记账状态	0-未记账, 5-部分已记账, 10-已记账
archiveStatus	Integer		归档状态	0-未归档 1-已归档
busiFlag	Integer		业务标识	0：报销；1：采购
compareStatus	Integer		下载比对状态	0-未比对,1-一致, 2-不一致
declareStatus	Integer		申报状态	0-未申报 1-已申报
faceCompareStatus	Integer		票面比对状态	0-未比对,1-一致, 2-不一致
gatherModel	String		票据采集方式	source_file-源文件解析,ocr-OCR识别,hand-手工录入,import-文件导入,wechat_scan-微信扫码,download-下载,api_collaboration-系统协同,wechat_card-微信卡包
modifyStatus	Integer		票面修改状态	0-未修改 1-已修改
paymentStatus	Integer		支付状态	0-未支付, 5-部分已支付, 10-已支付
receiveStatus	Integer		收票状态	0-未收票 1-已收票
reimburseMoney	BigDecimal		累计报账价税合计
reimburseStatus	Integer		报账状态	0-未报账，1-报账中,5-部分已报账, 10-已报账
reimburseTax	BigDecimal		累计报账税额合计
settleStatus	Integer		采购结算状态	0：未结算 1：已结算
signStatus	Integer		验签状态	0-未验签,1-完整,2-被修改,3-无签章,4-失败
srcBillcode	String		业务系统单据号
srcBillid	String		业务系统单据ID
srcBilltype	String		业务单据类型
srcChannel	String		票据来源渠道	platform-税务云平台,api-系统同步,personal-个人票夹提交,email-受票邮箱,tax_bureau-税局下载,bank-银行下载
srcSystem	String		票据来源系统	billcenter-电子票据中心, scm-供应链协同, buy_farm-开具收购发票, country_tax_bureau-国税总局, zhejiang_tax_bureau-浙江税局, deduct_plat-税局勾选抵扣平台, yinzhangtong-银账通, email-税务云企业受票邮箱, piaoyouji-票友记, person_web-税务云个人端, api-接口提交
submitDate	Date		提交日期
submitStatus	Integer		提交状态	0-未提交，1-已提交
submitter	String		提交人
suspectFlag			疑票标识	1：合规 2：存疑 3：不合规
suspectRule	String		疑票规则
suspectStatus	Integer		疑票状态	1.未通过2.已通过3.已禁止
yyVerifyStatus	Integer		用友查验状态	0-未查验；1-已查验
bz	String	200	备注
fhr	String	20	复核人
skr	String	20	收款人
kpr	String	20	开票人
kprq	String	10	开票日期	yyyyMMdd
fpDm	String	20	发票代码
fpHm	String	8	发票号码
fplx	String	4	发票类型	发票类型1增值税电子普通发票;3增值税普通发票;4增值税专用发票;5机动车销售统一发票;6货物运输业增值税专用发票;14通行费发票;8成品油电子发票;31电子发票(增值税专用发票);32电子发票(增值税普通发票)
gmfDzdh	String	100	购买方地址电话
gmfMc	String	100	购买方名称
gmfNsrsbh	String	20	购买方纳税人识别号
gmfYhzh	String	100	购买方银行账号
hjje	Double		合计金额
hjse	Double		合计税额
jshj	Double		价税合计
jym	String	20	校验码
xsfDzdh	String	100	销售方地址电话
xsfMc	String	100	销售方名称
xsfNsrsbh	String	20	销售方纳税人识别号
xsfYhzh	String	100	销售方银行账号
swjgdm	String	20	主管税务机关代码(机动车用)
swjgmc	String	200	主管税务机关名称(机动车用)
wspzh	String	32	完税凭证号(机动车用)
dw	String	20	单位
ggxh	String	100	规格型号
se	Double		税额
sl	Double		税率
xmdj	Double		单价
xmje	Double		金额
xmmc	String	90	项目名称
xmsl	Double		数量
cd	String	80	产地
hgzh	String	100	合格证号
jkzmsh	String	80	进口证明书号
sjdh	String	80	商检单号
fdjhm	String	120	发动机号码
cjhm	String	40	车架号码
dunwei	String	40	吨位
xcrs	String	40	限乘人数
cllx	String	40	车辆类型
cpxh	String	60	厂牌型号
scqymc	String	80	生产企业名称
sfzhm	String	22	身份证号码/组织机构代码
swjgdm	String	180	主管税务机关代码
swjgmc	String	255	主管税务机关名称(机动车用)
wspzh	String	40	完税凭证号
gfdz	String	310	买方单位/个人住址
gfdh	String	80	买方电话
cpzh	String	32	车牌照号
djzh	String	32	登记证号
cgsmc	String	310	转入地车辆车管所名称
xfdw	String	300	卖方单位/个人
xfhm	String	64	卖方单位代码/身份证号
xfdz	String	310	卖方单位/个人住址
xfdh	String	80	卖方电话
jydw	String	300	经营、拍卖单位
jydz	String	310	经营、拍卖单位地址
jysbh	String	26	经营、拍卖单位纳税人识别号
jyyhzh	String	250	开户银行及账号
jydh	String	80	经营、拍卖单位电话
scmc	String	300	二手车市场
scsbh	String	26	二手车市场纳税人识别号
scdz	String	310	二手车市场地址
scyhzh	String	250	二手车市场开户银行及账号
scdh	String	80	二手车市场电话

2、保存到进项电子票据中心

URL

POST

``http://:/yonbip-fi-taxgateway/input-tax/api/bill/saveonlytobillcenter?yht_access_token=XXXXX`

---

请头说明

参数	类型	是否必填	说明
yht_access_token	String	是	友互通yht_access_token

---

请求体

 
{
  "orgCode":"",
  "nsrsbh":"",
  "submitter":"提交人",
  "busiFlag":0,
  "srcBillType": "demoData",
  "srcBillCode": "demoData",
  "srcBillid": "demoData",
  "failMode": "0",
  "multiFileMode": "Y",
  "bills":[
    {
      "billType" : "invoice",
  	  "imageId" : 1234,
      "filePath":"",
      "data" : {},
      "attachs": [
        {
          "fileId":"1704423224656060416",
          "fileType":"zip",
          "businessType":"1"
        },
        {
          "fileId":"1704423224752529408",
          "fileType":"xml",
          "businessType":"2"
        }
      ]
    }
  ]
  
}

请求体说明

参数	类型	长度值	是否必填	默认值	描述	说明
orgCode	String		是		组织编码
nsrsbh	String		是		纳税人识别号
submitter	String		是		提交人
busiFlag	Integer		否	0：报销	业务标识	0- 报销，1-采购
failMode	String		否	batch	失败模式	batch- 批量成功/失败，single-逐条成功/失败
srcBillType	String		否		来源业务系统
srcBillCode	String		否		业务系统单据号
srcBillid	String		否		业务单据id
bills	Array		是		票据信息	数量必须小于等于100，超出请分批请求
billType	String		是		票据类型	目前仅支持 invoice增值税，custbook海关缴款书，nontax财政非税票据(根据票面信息的busiType判断具体业务类型 64-财政非税票据 65-进项医疗门诊票据 66-进项医疗住院票据)
imageId	Long		否		图片id（税务云返回的才可获取到对应的文件）	优先获取filePath，filePath为空是才会跟进imageid获取文件路径
filePath	String		否		文件路径	优先获取filePath，filePath为空是才会跟进imageid获取文件路径
multiFileMode	String		否	N	是否开启多附件模式	Y-开启，N-关闭 多附件模式：1.批量上传同一发票的多个版式文件 支持捏合 2.支持已有发票补传附件
data	Object		是		票面信息 详见附录票面json
attachs	Array		否		附件信息	由税务云解析接口/input-tax/api/invoice/parse返回，多附件模式下必填，需要根据attaches信息补充附件路径
fileId	String		否		文件Id
fileType	String		否		文件类型
businessType	String		否		源文件标识	0-源文件，1-凭证

返回值

{
    "code": "0000",
    "msg": "操作成功",
    "datas": []
}

返回值说明

参数	类型	描述	说明
code	String	状态码（全部成功/存在失败全部回滚）（存疑票据算成功）	详见状态码说明
msg	String	信息说明

3、进项电子票据查询-增值税发票

URL

POST

``http://:/yonbip-fi-taxgateway/input-tax/api/bill/queryvatbilllist?yht_access_token=XXXXX`

---

请头说明

参数	类型	是否必填	说明
yht_access_token	String	是	友互通yht_access_token

---

请求体

 
{
    "searchParam": {
        "orgcode": "",
        "invoiceCode": "",
        "invoiceNum": "",
        "billDateBegin": "",
        "billDateEnd": "",
        "submitter": "",
        "xsfMc": "",
        "xsfNsrsbh": "",
        "reimburseStatus": [0],
        "accountStatus": [0],
        "suspectFlag": ["1"],
        "suspectStatus": [0],
        "compareStatus": [0],
        "yyVerifyStatus": [0],
        "thirdVerifyStatus": [0],
        "signStatus": [0],
        "srcBilltype": "",
        "srcBillcode": "",
        "srcBillid": ""
    },
    "pagenum": 1,
    "pagesize": 20
}

请求体说明

参数	类型	长度值	是否必填	默认值	描述	说明
orgCode	String		否		组织编码
invoiceCode	String		否		发票代码
invoiceNum	String		否		发票号码
billDateBegin	String		是		开票日期段-开始时间	格式（yyyy-MM-dd）
billDateEnd	String		是		开票日期段-结束时间	格式（yyyy-MM-dd）
submitter	String		否		保存票据人
xsfMc	String		否		销售方名称
xsfNsrsbh	String		否		销售方税号
reimburseStatus	List		否		报账状态	0-未报账，1-报账中,5-部分已报账, 10-已报账
accountStatus	List		否		记账状态	0-未记账, 5-部分已记账, 10-已记账
suspectFlag	List		否		票据合规标识	1-合规 ，2-存疑， 3-不合规
suspectStatus	List		否		票据合规处理	1-未通过，2-已通过，3-已禁止
compareStatus	List		否		下载比对状态	0-未比对,1-相符, 2-不相符,3-未通过,4-失败
yyVerifyStatus	List		否		用友查验状态	0-未查验,1-相符, 2-不相符,3-未通过,4-失败
thirdVerifyStatus	List		否		第三查验状态	0-未查验,1-相符, 2-不相符,3-未通过,4-失败
signStatus	List		否		验签状态	0-未验签,1-完整,2-被修改,3-无签章,4-失败
srcBilltype	String		否		来源业务系统
srcBillcode	String		否		业务系统单据号
srcBillid	String		否		业务单据id
pagenum	Integer		是	1	页码
pagesize	Integer		是	20	每页显示条数

⭐️注意

​ 本接口是分页接口，查询时注意分页信息

返回值

{
    "code":"0000",
    "msg":"操作成功",
    "datas":[
        {
            "bills":[
                {
                    "nsrmc":"11134444",
                    "nsrsbh":"111222333456333",
                    "orgName":"百望333测试企业",
                    "fpDm":"011002200111",
                    "fpHm":"02695329",
                    "fplx":"8",
                    "gmfDzdh":"",
                    "gmfMc":"用友网络科技股份有限公司",
                    "gmfNsrsbh":"91110000600001760P",
                    "gmfYhzh":"",
                    "xsfDzdh":"北京市东城区广渠家园6号楼67006731",
                    "xsfMc":"中国石化销售股份有限公司北京石油分公司",
                    "xsfNsrsbh":"911100008011253056",
                    "xsfYhzh":"中行使馆区支行 318156009857",
                    "hjje":176.99,
                    "hjse":23.01,
                    "jshj":200,
                    "jym":"71674645711950229631",
                    "kpr":null,
                    "kprq":"20220402",
                    "skr":null,
                    "fhr":null,
                    "bz":"",
                    "agentMark":"0",
                    "companySeal":1,
                    "companySealName":"北京滴滴出行科技有限公司",
                    "companySealNsrsbh":"91110108MA01G0FB09",
                    "invoiceExt":{
                        "accountStatus":0,
                        "archiveStatus":null,
                        "busiFlag":1,
                        "declareStatus":null,
                        "faceCompareStatus":null,
                        "gatherModel":"ocr",
                        "modifyStatus":null,
                        "paymentStatus":0,
                        "receiveStatus":null,
                        "reimburseMoney":200,
                        "reimburseStatus":1,
                        "reimburseTax":23.01,
                        "settleStatus":null,
                        "signStatus":null,
                        "srcBillcode":"业务系统单据号",
                        "srcBillid":"业务系统单据ID",
                        "srcBilltype":"来源业务系统",
                        "srcChannel":"api",
                        "srcSystem":"采购系统",
                        "submitDate":"20220712",
                        "submitStatus":0,
                        "submitter":"提交人",
                        "suspectFlag":"1",
                        "suspectRule":null,
                        "suspectStatus":null,
                        "billStatus":0,
                        "compareStatus":3,
                        "thirdVerifyStatus":0,
                        "yyVerifyStatus":1
                    },
                    "items":[
                        {
                            "detailMotor":{
                                "cd":null,
                                "cgsmc":null,
                                "cjhm":null,
                                "cllx":null,
                                "cpxh":null,
                                "cpzh":null,
                                "djzh":null,
                                "dunwei":null,
                                "fdjhm":null,
                                "gfdh":null,
                                "gfdz":null,
                                "hgzh":null,
                                "jkzmsh":null,
                                "jydh":null,
                                "jydw":null,
                                "jydz":null,
                                "jysbh":null,
                                "jyyhzh":null,
                                "scdh":null,
                                "scdz":null,
                                "scmc":null,
                                "scqymc":null,
                                "scsbh":null,
                                "scyhzh":null,
                                "sfzhm":null,
                                "sjdh":null,
                                "swjgdm":null,
                                "swjgmc":null,
                                "wspzh":null,
                                "xcrs":null,
                                "xfdh":null,
                                "xfdw":null,
                                "xfdz":null,
                                "xfhm":null
                            },
                            "dw":"升",
                            "ggxh":"92号",
                            "se":23.01,
                            "sl":0.13,
                            "xmdj":6.7875665,
                            "xmje":176.99,
                            "xmmc":"*汽油*92号京标车用汽油(ⅥB)",
                            "xmsl":26.0756193
                        }
                    ]
                }
            ],
            "totalEntity":{
                "totalCount":3
            }
        }
    ]
}

返回值说明

参数	类型	长度	描述	说明
code	String		状态码	详见状态码说明
msg	String		信息说明
nsrsbh	String		受票企业税号
nsrmc	String		受票企业名称
orgName	String		受票组织名称
fpDm	String	20	发票代码
fpHm	String	8	发票号码
fplx	String	4	发票类型	发票类型1增值税电子普通发票;3增值税普通发票;4增值税专用发票;5机动车销售统一发票;6货物运输业增值税专用发票;14通行费发票;8成品油电子发票;31电子发票(增值税专用发票);32电子发票(增值税普通发票)
gmfDzdh	String	100	购买方地址电话
gmfMc	String	100	购买方名称
gmfNsrsbh	String	20	购买方纳税人识别号
gmfYhzh	String	100	购买方银行账号
xsfDzdh	String	100	销售方地址电话
xsfMc	String	100	销售方名称
xsfNsrsbh	String	20	销售方纳税人识别号
xsfYhzh	String	100	销售方银行账号
hjje	Double		合计金额
hjse	Double		合计税额
jshj	Double		价税合计
jym	String	20	校验码
kpr	String	20	开票人
kprq	String	10	开票日期	yyyyMMdd
fhr	String	20	复核人
skr	String	20	收款人
bz	String	200	备注
agentMark	String		代开标识	1代开票 0不是
companySeal	Integer		发票章标识	1有 0没有
companySealName	String		发票章公司名称
companySealNsrsbh	String		发票章公司税号
accountStatus	Integer		记账状态	0-未记账, 5-部分已记账, 10-已记账
archiveStatus	Integer		归档状态	0-未归档 1-已归档
busiFlag	Integer		业务标识	0：报销；1：采购
declareStatus	Integer		申报状态	0-未申报 1-已申报
faceCompareStatus	Integer		票面比对状态	0-未比对,1-一致, 2-不一致
gatherModel	String		票据采集方式	source_file-源文件解析,ocr-OCR识别,hand-手工录入,import-文件导入,wechat_scan-微信扫码,download-下载,api_collaboration-系统协同,wechat_card-微信卡包
modifyStatus	Integer		票面修改状态	0-未修改 1-已修改
paymentStatus	Integer		支付状态	0-未支付, 5-部分已支付, 10-已支付
receiveStatus	Integer		收票状态	0-未收票 1-已收票
reimburseMoney	BigDecimal		累计报账价税合计
reimburseStatus	Integer		报账状态	0-未报账，1-报账中,5-部分已报账, 10-已报账
reimburseTax	BigDecimal		累计报账税额合计
settleStatus	Integer		采购结算状态	0：未结算 1：已结算
signStatus	Integer		验签状态	0-未验签,1-完整,2-被修改,3-无签章,4-失败
srcBillcode	String		业务系统单据号
srcBillid	String		业务系统单据ID
srcBilltype	String		业务单据类型
srcChannel	String		票据来源渠道	platform-税务云平台,api-系统同步,personal-个人票夹提交,email-受票邮箱,tax_bureau-税局下载,bank-银行下载
srcSystem	String		票据来源系统	billcenter-电子票据中心, scm-供应链协同, buy_farm-开具收购发票, country_tax_bureau-国税总局, zhejiang_tax_bureau-浙江税局, deduct_plat-税局勾选抵扣平台, yinzhangtong-银账通, email-税务云企业受票邮箱, piaoyouji-票友记, person_web-税务云个人端, api-接口提交
submitDate	Date		保存票据日期
submitter	String		保存票据人
suspectFlag			疑票标识	1：合规 2：存疑 3：不合规
suspectRule	String		疑票规则
suspectStatus	Integer		疑票状态	1.未通过2.已通过3.已禁止
billStatus	Integer		发票状态	0-正常，1-失控，2-作废，3-红冲，4-异常
compareStatus	Integer		下载比对状态	0-未比对,1-一致, 2-不一致
thirdVerifyStatus	Integer		第三方查验状态	0-未查验；1-已查验
yyVerifyStatus	Integer		用友查验状态	0-未查验；1-已查验
cd	String	80	产地
cgsmc	String	310	转入地车辆车管所名称
cjhm	String	40	车架号码
cllx	String	40	车辆类型
cpxh	String	60	厂牌型号
cpzh	String	32	车牌照号
djzh	String	32	登记证号
dunwei	String	40	吨位
fdjhm	String	120	发动机号码
gfdh	String	80	买方电话
gfdz	String	310	买方单位/个人住址
hgzh	String	100	合格证号
jkzmsh	String	80	进口证明书号
jydw	String	300	经营、拍卖单位
jydz	String	310	经营、拍卖单位地址
jysbh	String	26	经营、拍卖单位纳税人识别号
jyyhzh	String	250	开户银行及账号
jydh	String	80	经营、拍卖单位电话
swjgdm	String	180	主管税务机关代码
swjgmc	String	255	主管税务机关名称(机动车用)
wspzh	String	32	完税凭证号(机动车用)
xfdw	String	300	卖方单位/个人
xfdz	String	310	卖方单位/个人住址
xfdh	String	80	卖方电话
xfhm	String	64	卖方单位代码/身份证号
dw	String	20	单位
ggxh	String	100	规格型号
se	Double		税额
sl	Double		税率
xmdj	Double		单价
xmje	Double		金额
xmmc	String	90	项目名称
xmsl	Double		数量
totalCount	Long		总条数

4、进项电子票据查询-全票种

URL

POST

``http://:/yonbip-fi-taxgateway/input-tax/api/bill/querybilllist?yht_access_token=XXXXX`

---

请头说明

参数	类型	是否必填	说明
yht_access_token	String	是	友互通yht_access_token

---

请求体

 
{
    "searchParam": {
        "billType":"",
        "busiType":"",
        "orgCode": "",
        "invoiceCode": "",
        "invoiceNum": "",
        "billDateBegin": "",
        "billDateEnd": "",
        "submitter": "",
        "xsfMc": "",
        "xsfNsrsbh": "",
        "reimburseStatus": [0],
        "accountStatus": [0],
        "suspectFlag": ["1"],
        "suspectStatus": [0],
        "compareStatus": [0],
        "yyVerifyStatus": [0],
        "thirdVerifyStatus": [0],
        "signStatus": [0],
        "srcBilltype": "",
        "srcBillcode": "",
        "srcBillid": "",
        "uniqueCode":"",
        "ticketNum":"",
        "receiptNumber":"",
        "printNumber":"",
        "number":"",
        "invoicingPartyName":"",
        "recName":""
    },
    "pagenum": 1,
    "pagesize": 20
}

请求体说明

参数	类型	长度值	是否必填	默认值	描述	说明
billType	String		是		票据种类	参考附录中的票据种类值
busiType	String		否		票据类型	参考附录中的票据类型值，查询非税票据时传该字段
orgCode	String		否		组织编码
invoiceCode	String		否		发票代码
invoiceNum	String		否		发票号码
billDateBegin	String		否		开票日期段-开始时间	格式（yyyy-MM-dd）
billDateEnd	String		否		开票日期段-结束时间	格式（yyyy-MM-dd）
submitter	String		否		保存票据人
xsfMc	String		否		销售方名称
xsfNsrsbh	String		否		销售方税号
reimburseStatus	List		否		报账状态	0-未报账，1-报账中,5-部分已报账, 10-已报账
accountStatus	List		否		记账状态	0-未记账, 5-部分已记账, 10-已记账
suspectFlag	List		否		票据合规标识	1-合规 ，2-存疑， 3-不合规
suspectStatus	List		否		票据合规处理	1-未通过，2-已通过，3-已禁止
compareStatus	List		否		下载比对状态	0-未比对,1-相符, 2-不相符,3-未通过,4-失败
yyVerifyStatus	List		否		用友查验状态	0-未查验,1-相符, 2-不相符,3-未通过,4-失败
thirdVerifyStatus	List		否		第三查验状态	0-未查验,1-相符, 2-不相符,3-未通过,4-失败
signStatus	List		否		验签状态	0-未验签,1-完整,2-被修改,3-无签章,4-失败
srcBilltype	String		否		来源业务系统
srcBillcode	String		否		业务系统单据号
srcBillid	String		否		业务单据id
pagenum	Integer		是	1	页码
pagesize	Integer		是	20	每页显示条数
uniqueCode	String		否		航空客票唯一码	查询航空客票时需要传该参数
ticketNum	String		否		航空客票电子客票号码
receiptNumber	String		否		航空客票行程单号
printNumber	String		否		航空客票印刷序号
number	String		否		火车票号
invoicingPartyName	String		否		开票单位名称
recName	String		否		收款单位名称

⭐️注意

​ 本接口是分页接口，查询时注意分页信息

返回值

{
    "code":"0000",
    "msg":"操作成功",
    "datas":[
        {
            "bills":[
                {
                    "nsrmc":"11134444",
                    "nsrsbh":"111222333456333",
                    "orgName":"百望333测试企业",
                    "fpDm":"011002200111",
                    "fpHm":"02695329",
                    "fplx":"8",
                    "gmfDzdh":"",
                    "gmfMc":"用友网络科技股份有限公司",
                    "gmfNsrsbh":"91110000600001760P",
                    "gmfYhzh":"",
                    "xsfDzdh":"北京市东城区广渠家园6号楼67006731",
                    "xsfMc":"中国石化销售股份有限公司北京石油分公司",
                    "xsfNsrsbh":"911100008011253056",
                    "xsfYhzh":"中行使馆区支行 318156009857",
                    "hjje":176.99,
                    "hjse":23.01,
                    "jshj":200,
                    "jym":"71674645711950229631",
                    "kpr":null,
                    "kprq":"20220402",
                    "skr":null,
                    "fhr":null,
                    "bz":"",
                    "agentMark":"0",
                    "companySeal":1,
                    "companySealName":"北京滴滴出行科技有限公司",
                    "companySealNsrsbh":"91110108MA01G0FB09",
                    "invoiceExt":{
                        "accountStatus":0,
                        "archiveStatus":null,
                        "busiFlag":1,
                        "declareStatus":null,
                        "faceCompareStatus":null,
                        "gatherModel":"ocr",
                        "modifyStatus":null,
                        "paymentStatus":0,
                        "receiveStatus":null,
                        "reimburseMoney":200,
                        "reimburseStatus":1,
                        "reimburseTax":23.01,
                        "settleStatus":null,
                        "signStatus":null,
                        "srcBillcode":"业务系统单据号",
                        "srcBillid":"业务系统单据ID",
                        "srcBilltype":"来源业务系统",
                        "srcChannel":"api",
                        "srcSystem":"采购系统",
                        "submitDate":"20220712",
                        "submitStatus":0,
                        "submitter":"提交人",
                        "suspectFlag":"1",
                        "suspectRule":null,
                        "suspectStatus":null,
                        "billStatus":0,
                        "compareStatus":3,
                        "thirdVerifyStatus":0,
                        "yyVerifyStatus":1
                    },
                    "items":[
                        {
                            "detailMotor":{
                                "cd":null,
                                "cgsmc":null,
                                "cjhm":null,
                                "cllx":null,
                                "cpxh":null,
                                "cpzh":null,
                                "djzh":null,
                                "dunwei":null,
                                "fdjhm":null,
                                "gfdh":null,
                                "gfdz":null,
                                "hgzh":null,
                                "jkzmsh":null,
                                "jydh":null,
                                "jydw":null,
                                "jydz":null,
                                "jysbh":null,
                                "jyyhzh":null,
                                "scdh":null,
                                "scdz":null,
                                "scmc":null,
                                "scqymc":null,
                                "scsbh":null,
                                "scyhzh":null,
                                "sfzhm":null,
                                "sjdh":null,
                                "swjgdm":null,
                                "swjgmc":null,
                                "wspzh":null,
                                "xcrs":null,
                                "xfdh":null,
                                "xfdw":null,
                                "xfdz":null,
                                "xfhm":null
                            },
                            "dw":"升",
                            "ggxh":"92号",
                            "se":23.01,
                            "sl":0.13,
                            "xmdj":6.7875665,
                            "xmje":176.99,
                            "xmmc":"*汽油*92号京标车用汽油(ⅥB)",
                            "xmsl":26.0756193
                        }
                    ]
                }
            ],
            "totalEntity":{
                "totalCount":3
            }
        }
    ]
}

返回值说明

参数	类型	长度	描述	说明
code	String		状态码	详见状态码说明
msg	String		信息说明
nsrsbh	String		受票企业税号
nsrmc	String		受票企业名称
orgName	String		受票组织名称
fpDm	String	20	发票代码
fpHm	String	8	发票号码
fplx	String	4	发票类型	发票类型1增值税电子普通发票;3增值税普通发票;4增值税专用发票;5机动车销售统一发票;6货物运输业增值税专用发票;14通行费发票;8成品油电子发票;31电子发票(增值税专用发票);32电子发票(增值税普通发票)
gmfDzdh	String	100	购买方地址电话
gmfMc	String	100	购买方名称
gmfNsrsbh	String	20	购买方纳税人识别号
gmfYhzh	String	100	购买方银行账号
xsfDzdh	String	100	销售方地址电话
xsfMc	String	100	销售方名称
xsfNsrsbh	String	20	销售方纳税人识别号
xsfYhzh	String	100	销售方银行账号
hjje	Double		合计金额
hjse	Double		合计税额
jshj	Double		价税合计
jym	String	20	校验码
kpr	String	20	开票人
kprq	String	10	开票日期	yyyyMMdd
fhr	String	20	复核人
skr	String	20	收款人
bz	String	200	备注
agentMark	String		代开标识	1代开票 0不是
companySeal	Integer		发票章标识	1有 0没有
companySealName	String		发票章公司名称
companySealNsrsbh	String		发票章公司税号
accountStatus	Integer		记账状态	0-未记账, 5-部分已记账, 10-已记账
archiveStatus	Integer		归档状态	0-未归档 1-已归档
busiFlag	Integer		业务标识	0：报销；1：采购
declareStatus	Integer		申报状态	0-未申报 1-已申报
faceCompareStatus	Integer		票面比对状态	0-未比对,1-一致, 2-不一致
gatherModel	String		票据采集方式	source_file-源文件解析,ocr-OCR识别,hand-手工录入,import-文件导入,wechat_scan-微信扫码,download-下载,api_collaboration-系统协同,wechat_card-微信卡包
modifyStatus	Integer		票面修改状态	0-未修改 1-已修改
paymentStatus	Integer		支付状态	0-未支付, 5-部分已支付, 10-已支付
receiveStatus	Integer		收票状态	0-未收票 1-已收票
reimburseMoney	BigDecimal		累计报账价税合计
reimburseStatus	Integer		报账状态	0-未报账，1-报账中,5-部分已报账, 10-已报账
reimburseTax	BigDecimal		累计报账税额合计
settleStatus	Integer		采购结算状态	0：未结算 1：已结算
signStatus	Integer		验签状态	0-未验签,1-完整,2-被修改,3-无签章,4-失败
srcBillcode	String		业务系统单据号
srcBillid	String		业务系统单据ID
srcBilltype	String		业务单据类型
srcChannel	String		票据来源渠道	platform-税务云平台,api-系统同步,personal-个人票夹提交,email-受票邮箱,tax_bureau-税局下载,bank-银行下载
srcSystem	String		票据来源系统	billcenter-电子票据中心, scm-供应链协同, buy_farm-开具收购发票, country_tax_bureau-国税总局, zhejiang_tax_bureau-浙江税局, deduct_plat-税局勾选抵扣平台, yinzhangtong-银账通, email-税务云企业受票邮箱, piaoyouji-票友记, person_web-税务云个人端, api-接口提交
submitDate	Date		保存票据日期
submitter	String		保存票据人
suspectFlag			疑票标识	1：合规 2：存疑 3：不合规
suspectRule	String		疑票规则
suspectStatus	Integer		疑票状态	1.未通过2.已通过3.已禁止
billStatus	Integer		发票状态	0-正常，1-失控，2-作废，3-红冲，4-异常
compareStatus	Integer		下载比对状态	0-未比对,1-一致, 2-不一致
thirdVerifyStatus	Integer		第三方查验状态	0-未查验；1-已查验
yyVerifyStatus	Integer		用友查验状态	0-未查验；1-已查验
cd	String	80	产地
cgsmc	String	310	转入地车辆车管所名称
cjhm	String	40	车架号码
cllx	String	40	车辆类型
cpxh	String	60	厂牌型号
cpzh	String	32	车牌照号
djzh	String	32	登记证号
dunwei	String	40	吨位
fdjhm	String	120	发动机号码
gfdh	String	80	买方电话
gfdz	String	310	买方单位/个人住址
hgzh	String	100	合格证号
jkzmsh	String	80	进口证明书号
jydw	String	300	经营、拍卖单位
jydz	String	310	经营、拍卖单位地址
jysbh	String	26	经营、拍卖单位纳税人识别号
jyyhzh	String	250	开户银行及账号
jydh	String	80	经营、拍卖单位电话
swjgdm	String	180	主管税务机关代码
swjgmc	String	255	主管税务机关名称(机动车用)
wspzh	String	32	完税凭证号(机动车用)
xfdw	String	300	卖方单位/个人
xfdz	String	310	卖方单位/个人住址
xfdh	String	80	卖方电话
xfhm	String	64	卖方单位代码/身份证号
dw	String	20	单位
ggxh	String	100	规格型号
se	Double		税额
sl	Double		税率
xmdj	Double		单价
xmje	Double		金额
xmmc	String	90	项目名称
xmsl	Double		数量
totalCount	Long		总条数

其它票据参考票据json的响应结构体

5、文件流式下载

URL

POST

``https://:/yonbip-fi-taxgateway/input-tax/api/bill/downloadFiles`

---

请求头说明

参数	类型	是否必填	说明
yht_access_token	String	是	友互通yht_access_token

---

请求体

 
{
    "filePath": ""
}

请求体说明

参数	类型	长度值	是否必填	默认值	描述	说明
filePath	String		是		文件路径	支持内网文件路径和外网文件路径

返回值

文件能正常访问的返回文件流

返回值说明

响应头：

Accept:application/octet-stream,application/json

文件能正常访问的，返回文件流

接收响应结果示例：

RestTemplate restTemplate = new RestTemplate();
Map<String, String> map = new HashMap<>();
map.put("filePath", "");
HttpHeaders headers = new HttpHeaders();
headers.add("yht_access_token", "");
headers.add(HttpHeaders.CONTENT_TYPE, MediaType.APPLICATION_JSON_VALUE);
headers.add(HttpHeaders.ACCEPT, MediaType.APPLICATION_OCTET_STREAM_VALUE);
HttpEntity httpEntity = new HttpEntity<>(map, headers);
ResponseEntity<byte[]> responseEntity = restTemplate.exchange("https://<HOST>:<PORT>/yonbip-fi-taxgateway/input-tax/api/bill/downloadFiles", HttpMethod.POST, getHttpEntity(map, ""), byte[].class);
byte[] bytes = responseEntity.getBody();

6、进项电子票据删除

URL

POST

``http://:/yonbip-fi-taxgateway/input-tax/api/bill/delete-bill?yht_access_token=XXXXX`

---

请头说明

参数	类型	是否必填	说明
yht_access_token	String	是	友互通yht_access_token

---

请求体

{
    "submitter" : "XXXXXX",
    "nsrsbh":"101011111111111",
    "orgcode":"rzs",
    "bills" : [
        {
            "invoiceCode" : "123456789123",
            "invoiceNum" : "78654536",
            "billType" : "invoice"
        }
    ]
}

请求体说明

参数	类型	长度值	是否必填	默认值	描述	说明
submitter	String		是		保存票据人
nsrsbh	String		否		纳税人识别号	nsrsbh和orgCode必填其一
orgCode	String		否		组织编码	nsrsbh和orgCode必填其一
invoiceCode	String		否		发票代码
invoiceNum	String		是		发票号码
billType	String		是		发票类型

返回值

{
    "code":"0000",
    "msg":"操作成功"
}

7、电子凭证查询

• 查询接口，供总账系统调用，查询电子会计凭证

URL

POST http://<HOST>:<PORT>/yonbip-fi-taxgateway/input-tax/api/evoucher/query?yht_access_token=XXXXX

---

请求头说明

参数	类型	是否必填	描述
sign	String	是	请求签名信息

---

请求体

    {
	    "bills":[
		    {
			    "billCode" : "150003527954",
			    "billNum" : "11550298",
                "billType":"invoice",
                "srcBillid": "1111",
                "srcBillType": "2222"
		    },
		    {
			    "billCode" : "150003527954",
			    "billNum" : "11550299",
                "billType":"invoice",
                "srcBillid": "3333",
                "srcBillType": "4444"
		    }
	    ]
    }

请求体说明

参数	类型	长度	是否必填	默认值	描述
srcBillid	String		否		单据PK (srcBillid和billcode/billNum不能同时为空)
srcBillType	String		否		来源单据类型（可与srcBillid联合确定唯一性）
billCode	String		否		发票代码 (srcBillid和billcode/billNum不能同时为空)
billNum	String		否		发票号码
billType	String		否		票据类型 (billcode+billNum+billType)确定唯一性
airType	String		否		航空类型 billType为air时选填，会根据此值计算航空客票的唯一码 。为空时唯一码默认为billNum 航空类型 1：ocr识别 ticketNum对应到(billNum)、checkCode字段必传 2：源文件解析 receiptNumber字段必传
checkCode	String		否		校验码
receiptNumber	String		否		行程单号码

---

返回值

    {
	    "code": "0000", 
	    "msg": "操作成功",
        "datas":[
            {
                "srcBillid":"1111",
                "srcBillType":"2222",
                "evoucherXml":"base64String",
                "uniqueCode":"",
                "billType":"invoice-1",
                "fplx":"1",
			    "billCode" : "150003527954",
			    "billNum" : "11550298",
                "xsfMc":"",
                "bred":0,
                "yyVerifyStatus":"",     
                "hjje":"",
                "hjse":"",
                "jshj":"",
                "kprq":""       
            },
            { 
                "srcBillid":"1111",
                "srcBillType":"2222",
                "evoucherXml":"base64String",
                "uniqueCode":"",
                "billType":"invoice-2",
                "fplx":"2",
			    "billCode" : "150003527954",
			    "billNum" : "11550298",
                "xsfMc":"",
                "bred":0,
                "yyVerifyStatus":"",
                "confirmUsage":"",
                "usage":"",
                "period":"",
                "existRollOut":0,
                "outMoney":null,
                "xsfNsrsbh":"",
                "hjje":"",
                "hjse":"",
                "jshj":"",
                "kprq":""
            },
            
            { 
                "srcBillid":"3333",
                "srcBillType":"4444",
                "evoucherXml":"base64String",
                "uniqueCode":"Number of air transport receipt",
                "billType":"air",
			    "billCode" : "150003527954",
			    "billNum" : "11550299",
                "issueParty":"",
                "bred":0,
                "yyVerifyStatus":"",
                "calculateVerifyStatus":"",
                "period":""  ,
                "date":"",
                "fare":""
            },        
            { 
                "srcBillid":"3333",
                "srcBillType":"4444",
                "evoucherXml":"base64String",
                "uniqueCode":"ElectronicInvoiceRailwayETicketNumber",
                "billType":"train",
			    "billNum" : "11550299",
                "issueParty":"",
                "bred":0,
                "calculateVerifyStatus":"",
                "period":"" ,        
                "date":"",
                "feeWithoutTax":"",
                "taxAmount":"",
                "sl":""
            },
            { 
                "srcBillid":"3333",
                "srcBillType":"4444",
                "evoucherXml":"base64String",
                "uniqueCode":"E-invoice id",
                "billType":"nontax",
                "fplx":"67",
			    "billCode" : "150003527954",
			    "billNum" : "11550299",
                "payeeName":"Name of payee",
                "bred":0,
                "yyVerifyStatus":"",
                "issumeDateTime":"",
                "totalAmount":""
            }
        ]
    }

返回值说明

参数	类型	描述	说明
code	String	状态码	0000-操作成功;详见状态码说明
msg	String	信息说明
datas	JsonArray	电子凭证列表
evoucherXml	String	电子凭证XML base64编码
uniqueCode	String	发票唯一标识 对应类型xml解析出的字段
billType	String	增值税发票的发票种类，非增值税发票的票据种类	增值税时，invoice-1、invoice-2、invoice-31、invoice-32 根据fplx为1、2、31、32来区分 1为 增值税电子普通发票、 2为增值税电子专用发票 31为数电票(增值税专用发票) 、 32为数电票(普通发票)
fplx	String	发票类型	billType 是 invoice或invoice-1或invoice-2时或invoice-31或invoice-32时，fplx 参考：发票类型 billType 是 nontax时，fplx 参考：业务类型
xsfMc	String	销售方名称
bred	Integer	是否红字发票	0-否 1-是
yyVerifyStatus	Integer	用友查验状态	0-未查验,1-相符, 2-不相符,3-未通过,4-失败
confirmUsage	Integer	是否已用途确认	0-否 1-是
usage	Integer	确认用途	1-抵扣 2-不抵扣 3-退税
existRollOut	Integer	是否进项税额转出	0-否 1-是
outMoney	BigDecimal	累计进项转出税额
issueParty	String	填开单位
calculateVerifyStatus	Integer	计算抵扣状态	1-不需认证；2-未勾选；3-已勾选；4-已认证
period	String	税款所属期
payeeName	String	收款方
srcBillid	String	来源单据id
srcBillType	String	来源单据类型
billCode	String	发票代码
billNum	String	发票号码
xsfNsrsbh	String	销售方纳税人识别号
hjje	String	金额
hjse	String	税额
jshj	String	价税合计
kprq	String	开票日期	yyyy-MM-dd
date	String	填开日期	yyyy-MM-dd
fare	String	票价
feeWithoutTax	String	不含税金额
sl	String	税率
issumeDateTime	String	开票日期	yyyy-MM-dd HH:mm:ss
totalAmount	String	缴款金额

附录

状态码

状态码	说明
0000	操作成功
9999	未知错误

票种类型

code	value	描述	备注
invoice	1	增值税发票
tolls	6	过路费
train	3	火车票
quota	5	定额发票
machine	4	机打发票
taxi	2	出租车发票
passenger	7	客运发票
air	8	航空电子行程单
other	9	其他发票
nontax	12	财政非税票据	（包含医疗门诊、住院）
custbook	13	海关缴款书

业务类型

code	描述	备注
64	财政非税票据	其他财政票据
65	医疗门诊票据	其他财政票据
66	医疗住院票据	其他财政票据
67	电子非税收入一般缴款书	电子非税收入一般缴款书

票据json

增值税发票

{
	"thirdVerifyStatus": 1,
	"bz": "",
	"classification": "111",
	"fhr": "复核人",
	"fpDm": "1234567890",
	"fpHm": "99445679",
	"fpMw": "发票密文",
	"fpjz": "0",
	"fplx": "3",
	"gmfDzdh": "购买方地址电话",
	"gmfMc": "XXX有限公司",
	"gmfNsrsbh": "9141XXXXXX05685704",
	"gmfYhzh": "购买方银行账号",
	"hjje": 100,
	"hjse": 10,
	"jqbh": "机器编码",
	"jshj": 110,
	"jym": "999999",
	"kplx": "1",
	"kpr": "开票人",
	"kprq": "20210514",
	"lslbz": null,
	"sgbz": null,
	"skr": "收款人",
	"srcBillCode": "来源单据号",
	"srcBillType": "来源单据类型",
   	"filepath": "https://s**/6159252dd42a2834d7a36c905ab5c9ea15cebf20.jpg",
    "voucherPath":"凭证文件路径",
    "taxpdffilepath":"版式pdf文件保存路径",
    "taxofdfilepath":"版式ofd文件保存路径",
    "taxxmlfilepath":"版式xml文件保存路径",
	"swjgdm": "",
	"swjgmc": "",
	"txfbz": null,
	"wspzh": "",
	"xsfDzdh": "销售方地址电话",
	"xsfMc": "销售方名称",
	"xsfNsrsbh": "1111111111",
	"xsfYhzh": "销售方银行账户",
	"yfpDm": "",
	"yfpHm": "",
    "companySealName": "发票章公司名称",
    "companySealNsrsbh": "发票章公司税号",
    "companySeal": 0,
  	"invoiceExt":
			{
				"numberConfirm": "99445679",
				"formName": "发票联",
				"signStatus": 0
			},
	"items": [{
		"dw": "",
		"ggxh": "",
		"se": 10,
		"sl": 0.1,
		"txfCph": "",
		"txfLx": "",
		"txfTxrqq": "",
		"txfTxrqz": "",
		"xmdj": 0,
		"xmje": 100,
		"xmjshj": 110,
		"xmmc": "*餐饮服务*餐饮服务",
		"xmsl": 1,
		"detailMotor": {
			"cd": "产地",
			"cgsmc": "二手车-转入地车辆车管所名称",
			"cjhm": "车架号码",
			"cllx": "车辆类型",
			"cpxh": "厂牌型号",
			"cpzh": "二手车-车牌照号",
			"djzh": "二手车-登记证号",
			"dunwei": "吨位",
			"fdjhm": "发动机号码",
			"gfdh": "二手车-买方电话",
			"gfdz": "二手车-买方单位/个人住址",
			"hgzh": "合格证号",
			"jkzmsh": "进口证明书号",
			"jydh": "二手车-经营、拍卖单位电话",
			"jydw": "二手车-经营、拍卖单位",
			"jydz": "二手车-经营、拍卖单位地址",
			"jysbh": "二手车-经营、拍卖单位纳税人识别号",
			"jyyhzh": "二手车-开户银行及账号",
			"scdh": "二手车-二手车市场电话",
			"scdz": "二手车-二手车市场地址",
			"scmc": "二手车-二手车市场",
			"scqymc": "生产企业名称",
			"scsbh": "二手车-二手车市场纳税人识别号",
			"scyhzh": "二手车-二手车市场开户银行及账号",
			"sfzhm": "身份证号码/组织机构代码",
			"sjdh": "商检单号",
			"swjgdm": "主管税务机关代码",
			"swjgmc": "主管税务机关名称(机动车用)",
			"wspzh": "完税凭证号",
			"xcrs": "限乘人数",
			"xfdh": "二手车-卖方电话",
			"xfdw": "二手车-卖方单位/个人",
			"xfdz": "二手车-卖方单位/个人住址",
			"xfhm": "二手车-卖方单位代码/身份证号"
		}
	}]
}

参数	类型	长度	是否必填	默认值	描述	说明
thirdVerifyStatus	Integer		否	0	第三方查验状态	0-未查验；1-已查验
bz	String	200	否		备注
classification	String	15	否		发票分类
fhr	String	20	否		复核人
skr	String	20	否		收款人
kpr	String	20	否		开票人
kprq	String	10	是		开票日期	yyyyMMdd
fpDm	String	12	是		发票代码
fpHm	String	8	是		发票号码
fpMw	String	200	否		发票密文
fpjz	String		否	0	发票介质	0-电子发票；1-纸质发票
fplx	String	4	是		发票类型	发票类型1增值税电子普通发票;3增值税普通发票;4增值税专用发票;5机动车销售统一发票;6货物运输业增值税专用发票;14通行费发票;8成品油电子发票
kplx	String	1	是		开票类型	0-蓝字发票;1-红字发票
gmfDzdh	String	100	否		购买方地址电话
gmfMc	String	100	是		购买方名称
gmfNsrsbh	String	20	否		购买方纳税人识别号
gmfYhzh	String	100	否		购买方银行账号
hjje	Double		是		合计金额
hjse	Double		否		合计税额
jqbh	String	12	否		税控设备编号
jshj	Double		是		价税合计
jym	String	20	否		校验码
xsfDzdh	String	100	否		销售方地址电话
xsfMc	String	100	是		销售方名称
xsfNsrsbh	String	20	是		销售方纳税人识别号
xsfYhzh	String	100	否		销售方银行账号
yfpDm	String	12	否		原发票代码	红字发票填写原蓝票代码
yfpHm	String	8	否		原发票号码	红字发票填写原蓝票号码
swjgdm	String	20	否		主管税务机关代码(机动车用)
swjgmc	String	200	否		主管税务机关名称(机动车用)
wspzh	String	32	否		完税凭证号(机动车用)
sgbz	String	1	否		农产品收购标志	2=农产品收购
filepath	String	200	否		附件路径
voucherPath	String	200	否		凭证文件路径
taxpdffilepath	String	200	否		版式pdf文件路径
taxofdfilepath	String	200	否		版式ofd文件路径
taxxmlfilepath	String	200	否		版式xml文件路径
txfbz	String	2	否		通行费标志(通行费发票用)	06-可抵扣通行费 07-不可抵扣同行费
lslbz	String	1	否		零税率标志(通行费发票用)	空-非零税率 1-免税 2-不征收 3-零税率
dw	String	20	否		单位
ggxh	String	100	否		规格型号
se	Double		否		税额
sl	Double		否		税率
xmdj	Double		否		单价
xmje	Double		是		金额
xmmc	String	90	是		项目名称
xmsl	Double		否		数量
xmjshj	Double		否		价税合计
txfCph	String	40	否		车牌号(通行费发票)
txfLx	String	32	否		类型(通行费发票)
txfTxrqq	String	32	否		通行日期起(通行费发票)
txfTxrqz	String	32	否		通行日期止(通行费发票)
cd	String	80	否		产地
hgzh	String	100	否		合格证号
jkzmsh	String	80	否		进口证明书号
sjdh	String	80	否		商检单号
fdjhm	String	120	否		发动机号码
cjhm	String	40	否		车架号码
dunwei	String	40	否		吨位
xcrs	String	40	否		限乘人数
cllx	String	40	否		车辆类型
cpxh	String	60	否		厂牌型号
scqymc	String	80	否		生产企业名称
sfzhm	String	22	否		身份证号码/组织机构代码
swjgdm	String	180	否		主管税务机关代码
swjgmc	String	255	否		主管税务机关名称(机动车用)
wspzh	String	40	否		完税凭证号
gfdz	String	310	否		买方单位/个人住址
gfdh	String	80	否		买方电话
cpzh	String	32	否		车牌照号
djzh	String	32	否		登记证号
cgsmc	String	310	否		转入地车辆车管所名称
xfdw	String	300	否		卖方单位/个人
xfhm	String	64	否		卖方单位代码/身份证号
xfdz	String	310	否		卖方单位/个人住址
xfdh	String	80	否		卖方电话
jydw	String	300	否		经营、拍卖单位
jydz	String	310	否		经营、拍卖单位地址
jysbh	String	26	否		经营、拍卖单位纳税人识别号
jyyhzh	String	250	否		开户银行及账号
jydh	String	80	否		经营、拍卖单位电话
scmc	String	300	否		二手车市场
scsbh	String	26	否		二手车市场纳税人识别号
scdz	String	310	否		二手车市场地址
scyhzh	String	250	否		二手车市场开户银行及账号
scdh	String	80	否		二手车市场电话
numberConfirm	String	8	否		编制发票号码	用来做ocr识别出的编制号码和打印号码的校验
formName	String	3	否		发票联次	用来做ocr识别出的发票联次的校验
signStatus	Integer		否	0	验签状态	0-未验签,1-完整,2-被修改,3-无签章,4-失败
companySealName	String	100	否		发票章公司名称
companySealNsrsbh	String	100	否		发票章公司税号
companySeal	Integer		否		发票章标识	1有 0没有

#

海关缴款书

  {
			"billingNo": "1234567890",
      "billingDate": "2018-04-12",
      "revenueOrg": null,
      "paymentOrg": "payment_org",
  		"totalTax": 100.00,
			"totalPrice": 12.0000000000,
			"customsCode": "1234",
			"customsName": "customs_name",
			"customsNo": "customs_no",
			"contractNo": "contract_no",
			"transportNo": "transport_no",
  		"cargoOwner": "cargo_owner",
			"operationEntity": "operation_entity",  
			"paymentPeriod": "payment_period",  
			"ladingNo": "lading_no", 
			"submitter": "submitter",
			"submitDate": "2018-04-12",
			"businessMan": "",
			"status": "",  
			"voucherId": "",
            "filePath":"",
			"srcType": 0  
		}

参数	类型	长度	描述
billingNo	String	30	专用缴款书号码，
billingDate	String	10	填发日期，"YYYY-MM-DD"
revenueOrg	String	20	收入机关，
paymentOrg	String	40	缴款单位( 人)，
totalPrice	decimal	decimal(20,10)	完税价格合计（需加总明细），
totalTax	decimal	decimal(15,2)	税款金额合计，
customsName	String	30	进口口岸名称，
customsCode	String	4	进口口岸代码（缴款书号前4 位），
applyOrgNo	String	20	申请单位编号，
customsNo	String	20	报关单编号，
transportNo	String	20	运输工具号，
contractNo	String	20	合同( 批文) 号，
cargoOwner	String	40	货主单位 ，
operationEntity	String	40	经营单位，
paymentPeriod	String	20	电子支付缴款期限，
ladingNo	String	30	提/ 装货单号，
submitter	String	50	提交人，
submitDate	String	10	提交日期，"YYYY-MM-DD"
businessMan	String	50	业务员，
checkStatus	String	1	稽核状态，
status	String	1	入账状态，
voucherId	String	32	凭证号，
filePath	String	200	附件文件路径
srcType	String		数据来源

财政非税票据

{
	"busiType": 66,
	"checker": "贾晴",
	"handlingPerson": "李文静",
	"invoiceCode": "13061121",
	"invoiceNum": "0000678848",
	"invoicingPartyName": "易县妇幼保健院",
	"issueDate": "2021-05-07",
	"payerPartyCode": "130633199309011067",
	"payerPartyName": "路超",
	"randomNumber": "547703",
	"recName": "易县妇幼保健院",
    "filePath":"附件路径",
	"remark": "",
	"totalAmount": 1446.84,
	"basicExt": {
		"accountPayAmount": 0.00,
		"caseNumber": "713546",
		"departmentName": "",
		"fundPayAmount": 0.00,
		"gender": "女",
		"hospitalizationNumber": "713546",
		"inhospitalDate": "2021-05-04",
		"medicalDate": null,
		"medicalInsuranceId": "",
		"medicalInsuranceType": "自费",
		"orgType": "妇幼保健院",
		"otherPayAmount": 0.00,
		"outhospitalDate": "2021-05-07",
		"ownPayAmount": 1446.84,
		"patientNumber": "",
		"prepayAmount": 2500.00,
		"rechargeAmount": 0.00,
		"refundAmount": 1053.16,
		"selfpaymentAmount": 0.00,
		"selfpaymentCost": 0.00
	},
	"details": [{
		"itemAmount": 277.50,
		"itemCode": "60102",
		"itemDetailName": null,
		"itemName": "检查费",
		"itemQuantity": 1.00,
		"itemStd": 277.50,
		"itemUnit": "元"
	}],
	"auxdetails": [{
		"auxItemAmount": 18.0000,
		"auxItemCode": "60102",
		"auxItemName": "检查费",
		"auxItemQuantity": 1.00,
		"auxItemRelatedCode": null,
		"auxItemRelatedName": null,
		"auxItemRemark": "",
		"auxItemStd": 18.0000,
		"auxItemUnit": ""
	}]
}

编码	名称	长度	类型	说明
busiType	业务类型		Integer	64-财政非税票据 65-进项医疗门诊票据 66-进项医疗住院票据
checker	复核人	20	String
handlingPerson	收款人	20	String
invoiceCode	发票代码	32	String
invoiceNum	发票号码	32	String
invoicingPartyName	开票单位	100	String
issueDate	开票日期	10	String	"YYYY-MM-DD"
payerPartyCode	交款人统一社会信用代码	100	String
payerPartyName	交款人	100	String
filePath	附件文件路径	200	String
randomNumber	校验码	32	String
recName	收款单位	100	String
remark	备注	500	String
totalAmount	总金额	decimal(15,2)	BigDecimal
basicExt	基本信息扩展
accountPayAmount	个人账户支付	decimal(15,2)	BigDecimal
caseNumber	病例号	50	String
departmentName	科别	50	String
fundPayAmount	医保统筹基金支付	decimal(15,2)	BigDecimal
gender	性别	8	String
hospitalizationNumber	住院号	50	String
inhospitalDate	住院日期	10	String	"YYYY-MM-DD"
medicalDate	就诊日期	10	String	"YYYY-MM-DD"
medicalInsuranceId	医保编号	50	String
medicalInsuranceType	医保类型	50	String
orgType	医疗机构类型	50	String
otherPayAmount	其他支付	decimal(15,2)	BigDecimal
outhospitalDate	出院日期	10	String	"YYYY-MM-DD"
ownPayAmount	个人现金支付	decimal(15,2)	BigDecimal
patientNumber	门诊号	50	String
prepayAmount	预缴金额	decimal(15,2)	BigDecimal
rechargeAmount	补缴金额	decimal(15,2)	BigDecimal
refundAmount	退费金额	decimal(15,2)	BigDecimal
selfpaymentAmount	个人自付	decimal(15,2)	BigDecimal
selfpaymentCost	个人自费	decimal(15,2)	BigDecimal
details	明细信息		Array
itemAmount	金额	decimal(15,2)	BigDecimal
itemCode	项目编码	50	String
itemDetailName	项目明细	200	String
itemName	项目名称	100	String
itemQuantity	数量	decimal(15,2)	BigDecimal
itemStd	标准	decimal(15,2)	BigDecimal
itemUnit	单位	50	String
auxdetails	辅助明细信息		Array
auxItemAmount	收费明细项目金额	decimal(15,2)	BigDecimal
auxItemCode	收费明细项目编码	50	String
auxItemName	收费明细项目名称	100	String
auxItemQuantity	收费明细项目数量	decimal(15,2)	BigDecimal
auxItemRelatedCode	对应项目编码	50	String
auxItemRelatedName	对应项目名称	100	String
auxItemRemark	收费明细项目备注	100	String
auxItemStd	收费明细项目标准	decimal(15,2)	BigDecimal
auxItemUnit	收费明细项目单位	decimal(15,2)	BigDecimal

#