# 报销台账(全票种)

# 对接流程

1558937474466

ocr支持全票中识别,返回结果中会包含文件路径id。

  • 对于增值税发票,需要使用发票五要素(发票代码、发票号码、开票日期、校验码、不含税金额)进行查验后保存至报销台账
  • 对于非增值税发票(机打发票、航空电子行程单、火车票、出租车发票、定额发票、过路费、客运汽车票),直接保存台账,此时必须传入ocr识别中返回的imageid,否则数据无法显示附件信息。

# OCR识别接口

# URL

POST

http://{IP}:{PORT}/input-tax/api/ocr/v2/recognise

# 请求体

{
	"nsrsbh": "101011111111111",
	"orgcode": "321",
	"file": "*******************"
}

# 请求体说明

参数 类型 长度 必输 说明
nsrsbh String 组织编码和纳税人识别号不能同时为空
orgcode String 组织编码和纳税人识别号不能同时为空
file String base64编码图片

# 返回值

{
    "code": "0000",
    "datas": [{
        "imageId": "1360",
        "data": {
            "date": "20181028",

            "kind": "交通",
            "filePath": null,
            "carNum": null,
            "invoiceCode": "132011881210",
            "invoiceNum": "16329715",
            "totalAmount": 24,
            "purchaserStatus": null,
            "startTime": "15:50",
            "endTime": "15:58",
            "place": "江苏省南京市",
            "mileage": 8.3
        },
        "imagePath": null,
        "billType": "taxi"
    }],
    "msg": "解析成功"
}

# 返回值说明

编码 名称 类型 备注
code 状态码 String
msg 提示信息 String
datas OCR识别对象 Array
imageId 图片Id
data 识别结果 Object 详见各票种json示例
billType 票种类型 String 详见票种类型

# 识别结果保存台账

# URL

POST

http://{IP}:{PORT}/input-tax/api/bill-collections/ocr-save

# 请求体

{
	"nsrsbh": "111222333456111",
	"orgcode": "xxx",
    "submitter":"xxx",
    "srcBillCode":"xxx",
    "srcBillType":"xxx",
    "bills": [{
        "imageId": "1360",
        "data": {
            "date": "20181028",
            "kind": "交通",
            "filePath": null,
            "carNum": null,
            "invoiceCode": "132011881210",
            "invoiceNum": "16329715",
            "totalAmount": 24,
            "purchaserStatus": null,
            "startTime": "15:50",
            "endTime": "15:58",
            "place": "江苏省南京市",
            "mileage": 8.3
        },
        "billType": "taxi"
    }]
}

# 请求体说明

参数 类型 长度 必输 说明
nsrsbh String 组织编码和纳税人识别号不能同时为空
orgcode String 组织编码和纳税人识别号不能同时为空
imageId String 图片Id
data Object 详见各票种json示例
billType String 详见票种类型
submitter String 提交人
srcBillCode String 来源单据号
srcBillType String 来源系统

# 返回值

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

# 返回值说明

编码 名称 类型 说明
code 状态码 String
msg 提示信息 String

# 源文件上传进项业务台账

pdf、ofd格式增值税发票,增值税发票的zip格式电子会计凭证;

pdf格式通用电子发票到机打发票;

pdf、png格式财政非税票据源文件;

ofd格式航空客票;

ofd格式火车票;

pdf格式海关缴款书;

(状态变更为报账中)

最大支持20张票据

# URL

POST http://<HOST>:<PORT>/input-tax/api/busi-collection/uploadpdf?appid=XXXXX


# 请求头说明

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

# 请求体

    {
	    "submitter" : "XXXXXX",
	    "busiFlag" : "1",
      	"nsrsbh":"101011111111111",
      	"orgcode":"321",
        "saveMode":"1",
        "multiFileMode": "Y",
	    "pdfFiles" : [
		    {
			    "srcBillType" : "来源业务系统1",
			    "srcBillCode" : "业务系统单据号1",
			    "srcBillid" : "来源单据id1",
			    "fileName" : "通用机打1.pdf",
			    "fileid" : "源文件PK1",
			    "content" : "XXXXXXXXXXXXXXXXXXX1"
		    },
		    {
			    "srcBillType" : "来源业务系统2",
			    "srcBillCode" : "业务系统单据号2",
			    "srcBillid" : "来源单据id2",
			    "fileName" : "增值税2.pdf",
			    "fileid" : "源文件PK2",
			    "content" : "XXXXXXXXXXXXXXXXXXX2"
		    },
		    {
			    "srcBillType" : "来源业务系统2-1",
			    "srcBillCode" : "业务系统单据号2-1",
			    "srcBillid" : "来源单据id2-1",
			    "fileName" : "增值税2-1.zip",
			    "fileid" : "源文件PK2-1",
			    "content" : "XXXXXXXXXXXXXXXXXXX2-1"
		    },
		    {
			    "srcBillType" : "来源业务系统3",
			    "srcBillCode" : "业务系统单据号3",
			    "srcBillid" : "来源单据id3",
			    "fileName" : "财政非税3.png",
			    "fileid" : "源文件PK3",
			    "content" : "XXXXXXXXXXXXXXXXXXX3"
		    },
		    {
			    "srcBillType" : "来源业务系统4",
			    "srcBillCode" : "业务系统单据号4",
			    "srcBillid" : "来源单据id4",
			    "fileName" : "机票4.ofd",
			    "fileid" : "源文件PK4",
			    "content" : "XXXXXXXXXXXXXXXXXXX4"
		    },
		    {
			    "srcBillType" : "来源业务系统5",
			    "srcBillCode" : "业务系统单据号5",
			    "srcBillid" : "来源单据id5",
			    "fileName" : "火车票5.pdf",
			    "fileid" : "源文件PK5",
			    "content" : "XXXXXXXXXXXXXXXXXXX5"
		    },
		    {
			    "srcBillType" : "来源业务系统6",
			    "srcBillCode" : "业务系统单据号6",
			    "srcBillid" : "来源单据id6",
			    "fileName" : "海关缴款书6.pdf",
			    "fileid" : "源文件PK6",
			    "content" : "XXXXXXXXXXXXXXXXXXX6"
		    }
	    ]
    }

# 请求体说明

参数 类型 长度 是否必填 默认值 描述 说明
submitter String 50 提交人
busiFlag String 1 业务标识 0:报销;1:采购
saveMode String 1 0 保存模式 0:同时保存发票到票据中心和台账;1:进保存到票据中心
fileName String 发票文件名
content String 对应发票文件 通过Base64编码字节流,转换为字符串
nsrsbh String 纳税人识别号 受票企业纳税人识别号;纳税人识别号与组织编码至少传入一项
orgcode String 组织编码 受票方企业在发票平台的组织编码纳税人识别号与组织编码至少传入一项
multiFileMode String N 是否开启多附件模式 Y-开启,N-关闭 多附件模式:1.批量上传同一发票的多个版式文件 支持捏合 2.支持已有发票补传附件
srcBillType String 50 来源单据类型
srcBillCode String 200 业务系统单据号
srcBillid String 100 来源单据id
fileid String 源文件PK 税务云不保存,和票面一起返回

# 返回值

{
    "code": "0000",
    "datas": [
      {
            "billType": "air",
			"srcBillid" : "来源单据id4",
			"fileName" : "机票4.ofd",
			"fileid" : "源文件PK4",
            "invoice": {
                    "issuspect": "Y",
                    "date": "20181020",
                    "fare": 2000.00,
                    "agentCode": "HKK068,08688003",
                    "issueBy": "成都携程旅行社有限公司北京分社",
                    "kind": "交通",
                    "userName": "王**",
                    "userId": "37****198****20527",
                    "caacDevelopFund": 50.00,
                    "checkCode": "9668",
                    "totalAmount": 2080.00,
                    "ticketNum": "8802175000276",
                    "itemList": [{
                        "airId" : "1111",
                        "date": "20181019",
                        "seat": "Y",
                        "carrier": "海航",
                        "from": "杭州",
                        "time": "19:00",
                        "to": "北京",
                        "flightNumber": "HU7678"
                    }],
                    "fuelSurcharge": 30.00
                }
        },
        {
            "billType": "train",
			"srcBillid" : "来源单据id5",
			"fileName" : "火车票5.pdf",
			"fileid" : "源文件PK5",
            "invoice": {
                  "issuspect": "Y",
                  "date": "20181030",
                  "kind": "交通",
                  "origin": "北京南",
                  "destination": "上海虹桥",
                  "number": "P026491",
                  "totalAmount": 553.00,
                  "trainNum": "G9",
                  "name": "XXXX",
                  "idNumber": "123456789012345678",
                  "time": "12:00",
                  "seatNo": "二等座"
              }
        },
        {
            "billType": "machine",
		   "srcBillid" : "来源单据id1",
		   "fileName" : "通用机打1.pdf",
			"fileid" : "源文件PK1",
            "invoice": {
                "buyerName": "更麻烦名称",
                "buyerTaxId": "购买方税号",
                "checkCode": "1353713460632420",
                "date": "2020-04-30",
                "invoiceCode": "233001900888",
                "invoiceNum": "10502088",
                "issuspect": "Y",
                "itemList": [
                    {
                        "amount": 159.22,
                        "item": "*其他服装*工作服",
                        "num": 2,
                        "price": 82.00,
                        "taxAmount": 4.78,
                        "taxRate": 0.03
                    }
                ],
                "sellerName": "销售方名称",
                "sellerTaxId": "销售方税号",
                "totalAmount": 164.00
            }
        },
        {
            "billType": "invoice",
			"srcBillid" : "来源单据id2",
			"fileName" : "增值税2.pdf",
			"fileid" : "源文件PK2",
          	"voucherFileid":"源文件PK2-1",
		    "voucherSrcBillid" : "来源单据id2-1",
            "invoice": {
                "bz": "备注",
                "fhr": "郑立芳",
                "fpDm": "044032000888",
                "fpHm": "15489888",
                "fpMw": "8<5<4+2/97/-8+0*2-85<1*21-7225396678<7/9991-2>442648+55+--62<94**<64/68+8-2+95<6<30>/30735-05+/710+803+<2//6",
                "fplx": "1",
                "gmfDzdh": "",
                "gmfMc": "购买方名称",
                "gmfNsrsbh": "购买方税号",
                "gmfYhzh": "",
                "hjje": 8849.34,
                "hjse": 1150.41,
                "issuspect": "Y",
                "items": [
                    {
                        "dw": "台",
                        "ggxh": "HD-I8690E",
                        "se": 1150.41,
                        "sl": 0.130000,
                        "xmdj": 35397.3451320000,
                        "xmje": 8849.34,
                        "xmmc": "*计算机外部设备*鸿合(HiteVision)H",
                        "xmsl": 0.250000
                    }
                ],
                "jqbh": "661546928634",
                "jshj": 9999.75,
                "jym": "46818504421635130105",
                "kpr": "何爱巧",
                "kprq": "2020-08-26",
                "skr": "刘慧",
                "xsfDzdh": "销售方地址电话",
                "xsfMc": "销售方名称",
                "xsfNsrsbh": "销售方税号",
                "xsfYhzh": "销售方银行账号"
            }
        },
      	{
            "billType": "nontax",
			"srcBillid" : "来源单据id3",
			"fileName" : "财政非税3.png",
			"fileid" : "源文件PK3",
            "invoice": {
                "busiType": 66,
                "checker": "贾晴",
                "handlingPerson": "李文静",
                "invoiceCode": "13061121",
                "invoiceNum": "0000678848",
                "invoicingPartyName": "易县妇幼保健院",
                "issueDate": "2021-05-07",
                "payerPartyCode": "130633199309011067",
                "payerPartyName": "路超",
                "randomNumber": "547703",
                "recName": "易县妇幼保健院",
                "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": ""
                    }
                ]
            }
        },
        {
			"srcBillid" : "来源单据id6",
			"fileName" : "海关缴款书6.pdf",
			"fileid" : "源文件PK6",
            "voucherFileid": null,
            "voucherSrcBillid": null,
            "billType": "custbook",
            "invoice": {
                "customsCode": null,
                "customsName": "鲅鱼圈",
                "billingDate": "2019-07-11",
                "incomeSystem": null,
                "billingNo": "09502ssssss-L01",
                "revenueOrg": "中央金库",
                "account": "进口增值税",
                "budgetaryLevels": "中央",
                "revenueTreasury": "国家金库鲅鱼圈支库632",
                "treasuryBank": null,
                "paymentOrg": "aaa有限公司",
                "paymentAccount": "2bbbb",
                "paymentBank": "中国建设银行股份有限公司",
                "totalTax": 58735243.06,
                "totalPrice": 451809562.00,
                "applyOrgNo": "4343437",
                "customsNo": "0953435002957",
                "contractNo": "2019H4354J0199",
                "transportNo": "AQUILA",
                "cargoOwner": null,
                "operationEntity": null,
                "paymentPeriod": "2019年7月26日前",
                "ladingNo": "874350",
                "vnote": "一般贸易 照章征税 2019-7-10系统类别:01国标代码912310817",
                "billingMaker": "9999",
                "reviewer": null,
                "customsBookBs": [
                    {
                        "taxNo": "1.270900",
                        "itemName": "收拾收拾",
                        "currency": null,
                        "exchangeRate": null,
                        "price": 451809562.00,
                        "taxRate": 13.0000,
                        "tax": 58735243.06,
                        "count": 130796150.00,
                        "unit": "千克"
                    }
                ]
            },
            "fileNames": null
        }
    ],
    "msg": "SUCCESS"
}

# 返回值说明

参数 类型 描述 说明
code String 状态码 0000-操作成功;详见状态码说明
msg String 信息说明
fileName String 文件名
billType String 票种 machine:机打发票 invoice:增值税发票 nontax:财政非税票据 air:航空客票 train:火车票 custbook:海关缴款书
billType为nontax时 根据票面信息的busiType判断具体业务类型 64-财政非税票据 65-进项医疗门诊票据 66-进项医疗住院票据
invoice String 票面信息 详见 各票种json示例
fileid String 源文件PK
srcBillid String 来源单据id
voucherFileid String 会计凭证源文件PK
voucherSrcBillid String 会计凭证来源单据id

# 各票种json示例

# 机打发票

编码 名称 类型 摘要字段 说明
issuspect 是否疑票 String
date 开票日期 String yyyy-MM-dd
invoiceCode 发票代码 String invoiceCode 必输
invoiceNum 发票号码 String invoiceNum 必输
checkCode 校验码 String
totalAmount 合计金额 BigDecimal amount
sellerName 销方名称 String sellerName
sellerTaxId 销方税号 String
buyerName 购方名称 String buyerName
buyerTaxId 购方税号 String
itemList 机打发票明细行 Array
taxRate 税率 BigDecimal
taxAmount 税额 BigDecimal
num 数量 BigDecimal
price 单价 BigDecimal
item 项目 String
amount 金额 BigDecimal

# 增值税发票

参数 类型 描述 说明
issuspect String 是否疑票 Y.是 N.否
fpDm String 发票代码
fpHm String 发票号码
gmfMc String 购买方名称
gmfNsrsbh String 购买方纳税人识别号
gmfYhzh String 购买方银行账号
gmfDzdh String 购买方地址电话
hjje double 合计金额
jshj double 价税合计
fplx String 发票类型 1:增值税电子普通发票;2:增值税电子专用发票;3:增值税普通发票;4:增值税专用发票;5:机动车销售统一发票;6:货物运输业增值税专用发票;8:增值税电子普通发票(成品油);9:成品油普通发票(卷式);10:增值税普通发票(成品油);11:增值税专用发票(成品油);12:增值税普通发票(卷式)14:通行费增值税电子普通发票
kpr String 开票人
skr String 收款人
fhr String 复核人
kprq String 开票日期 格式:yyyy-MM-dd
xsfDzdh String 销售方地址电话
xsfMc String 销售方名称
xsfYhzh String 销售方银行账号
xsfNsrsbh String 销售方纳税人识别号
jym String 校验码
fpMw String 发票密文
bz String 备注
xmmc String 项目名称 货物或应税劳务、服务名称
ggxh String 规格型号
dw String 单位
xmsl double 数量
xmdj double 单价
xmje double 金额
sl double 税率
se double 税额

# 财政非税票据

编码 名称 类型 说明
busiType 业务类型 Integer 64-财政非税票据 65-进项医疗门诊票据 66-进项医疗住院票据
checker 复核人 String
handlingPerson 收款人 String
invoiceCode 发票代码 String
invoiceNum 发票号码 String
invoicingPartyName 开票单位 String
issueDate 开票日期 String
payerPartyCode 交款人统一社会信用代码 String
payerPartyName 交款人 String
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

# 航空客票

编码 名称 类型 摘要字段 说明
id 行程单主键 Long billId
date 填开日期 String date yyyyMMdd
ticketNum 电子客票号码 String invoiceNum
checkCode 验证码 String
agentCode 销售单位代码 String
issueBy 填开单位 String sellerName
fare 票夹 BigDecimal
tax 税费 BigDecimal
fuelSurcharge 燃油附加费 BigDeciaml
caacDevelopFund 民航发展基金 BigDecimal
insurance 保险费 BigDecimal
totalAmount 总金额 BigDecimal amount
userName 乘机人姓名 String
userId 身份证号 String
purchaserStatus 报销状态 Int purchaserStatus 详见报销状态
kind 消费类型 String kind
feeWithoutTax 金额(不含税) BigDecimal
taxAmount 税额 BigDecimal
itemList 行程单明细 Array
id 行程单明细ID Long
airId 行程单主表ID Long
from 出发 String
to 到达 String
flightNumber 航班号 String
carrier 承运人 String
seat 仓位 String
date 乘机日期 String yyyyMMdd
time 乘机时间 String HH:mm

# 火车票

编码 名称 类型 摘要字段 说明
id 火车票主键 Long billId
number 号码 String invoiceNum
date 日期 String date yyyyMMdd
time 时间 String HH:mm
trainNum 车次 String trainNum
origin 始发站 String origin
destination 终点站 String destination
level 坐席 String
seatNo 座位号 String
name 姓名 String
idNumber 身份证号码 String
totalAmount 金额 BigDecimal amount
feeWithoutTax 金额(不含税) BigDecimal
taxAmount 税额 BigDecimal
purchaserStatus 报销状态 int purchaserStatus 详见报销状态
kind 消费类型 String kind

# 海关缴款书

参数 类型 长度 描述
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 提/ 装货单号,
billingMaker String 10 制单人
reviewer String 10 复核人
businessMan String 50 业务员,
incomeSystem String 20 收入系统
account String 10 收入科目
budgetaryLevels String 10 预算级次
revenueTreasury String 200 收款国库
treasuryBank String 20 收入国库银行
paymentAccount String 30 缴款账号
paymentBank String 20 缴款单位-银行
applyOrgNo String 20 申请单位编号
vnote String 130 备注
customsBookBs Array 海关缴款书货物行
taxNo String 20 税号
itemName String 50 货物名称
currency String 10 币种
exchangeRate decimal(15,8) 汇率
price decimal(20,10) 完税价格
taxRate decimal(8,6) 税率
tax decimal(15,2) 税款金额
count decimal(15,2) 数量
unit String 10 单位

#

# 全票种不查验进台账

# URL

POST

http://{IP}:{PORT}/input-tax/api/bill-collections/direct-save

# 请求体

{
	"nsrsbh": "111222333456111",
	"orgcode": "xxx",
    "submitter":"xxx",
    "srcBillCode":"xxx",
    "srcBillType":"xxx",
    "bills": [{
        "data": {
            "date": "20181028",
            "kind": "交通",
            "filePath": null,
            "carNum": null,
            "invoiceCode": "132011881210",
            "invoiceNum": "16329715",
            "totalAmount": 24,
            "purchaserStatus": null,
            "startTime": "15:50",
            "endTime": "15:58",
            "place": "江苏省南京市",
            "mileage": 8.3
        },
        "billType": "taxi",
        "filePath":"",
        "imageId": 123243543654,
        "busiFlag": 0
    }]
}

# 请求体说明

参数 类型 长度 必输 说明
nsrsbh String 20 组织编码和纳税人识别号不能同时为空
orgcode String 50 组织编码和纳税人识别号不能同时为空
data Object 最大100张票据
billType String 详见票种类型
submitter String 50 提交人
srcBillCode String 200 来源单据号
srcBillType String 50 来源单据类型
billDate String 制单日期 yyyy-MM-dd
imageId Long 20 税务云OCR识别返回的imageId
thirdVerifyStatus Integer 参看增值税发票请求体说明,如调用接口前已经查验,建议赋值已查验
filePath String 500 公网可永久访问到的http或https的文件下载地址
busiFlag Integer 业务标识 0:报销;1:采购 不填时默认为报销

#

# 机打发票

{
	"thirdVerifyStatus": 1,
    "invoiceCode": "144001601211",
    "invoiceNum": "04964432",
    "date": "20190425",
    "time": "10:53",
    "checkCode": "",
    "sellerName": "顺德北浩敏跃渝聚食府",
    "sellerTaxId": "92440606MA4VP01G84",
    "buyerName": "用友网络科技股份有限公司佛山分公司",
    "buyerTaxId": "914406064748033814Q",
    "totalAmount": 139.00,
    "itemList": [{
        "item": "餐饮费",
        "amount": 139.00
    }]
}
编码 名称 类型 长度 是否必填 默认值 说明
date 开票日期 String yyyyMMdd
time 开票时间 String 20
invoiceCode 发票代码 String 12
invoiceNum 发票号码 String 8
checkCode 校验码 String 32
totalAmount 金额 BigDecimal(15,2)
sellerName 销方名称 String 40
sellerTaxId 销方税号 String 20
buyerName 购方名称 String 40
buyerTaxId 购方税号 String 20
thirdVerifyStatus 第三方查验状态 Integer 0 0-未查验;1-已查验
itemList 机打发票明细行 Array
item 项目 String 100
amount 金额 BigDecimal(15,2)

# 增值税发票

{
	"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": "来源单据类型",
	"swjgdm": "",
	"swjgmc": "",
	"txfbz": null,
	"wspzh": "",
	"xsfDzdh": "销售方地址电话",
	"xsfMc": "销售方名称",
	"xsfNsrsbh": "1111111111",
	"xsfYhzh": "销售方银行账户",
	"yfpDm": "",
	"yfpHm": "",
    "companySealName": "发票章公司名称",
    "companySealNsrsbh": "发票章公司税号",
    "companySeal": 0,
    "invoiceExt": {
		"thirdVerifyStatus": 1,
		"numberConfirm": "99445679",
		"formName": "发票联",
		"signStatus": 0,
        "bdcdz": "不动产地址",
        "zlqq": "租赁期起日期 例:2022-11-18",
        "zlqz": "租赁期止日期 例:2023-11-18",
        "kdsbz": "跨地(市)标志 Y:是 N:否",
        "tdzzsxmbh": "土地增值税项目编号",
        "bdcdwdm": "不动产单元代码",
        "wqhtbabh": "网签合同备案编号",
        "hdjsjg": "核定计税价格",
        "sjcjhsje": "实际成交含税金额",
        "bxdh": "保险单号",
        "cphcbdjh": "车牌号/船舶登记号",
        "skssq": "税款所属期",
        "dsccsje": "代收车船税金额",
        "znj": "滞纳金金额",
        "jehj": "金额合计",
        "cjh": "车辆识别代码/车架号码"
      },
      "tspz": "特殊票种-建筑服务:E03、不动产经营租赁:E06、货物运输服务发票:E04",
      "tspzs": [{
        "ysgjzl": "运输工具种类",
        "ysgjph": "运输工具牌号",
        "yshwmc": "运输货物名称",
        "qyd": "起运地",
        "ddd": "到达地",
        "cxr": "出行人",
        "sfzjhm": "有效身份证件号码",
        "chuxrq":"出行日期",
        "cfd": "出发地",
        "lkddd": "到达地",
        "zwdj": "等级",
        "jtgjlxDm": "交通工具类型"
      }],
	"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": "二手车-卖方单位代码/身份证号",
            "jzfwfsd": "建筑服务发生地",
            "jzxmmc": "建筑项目名称",
            "cqzsbh": "产权证书/不动产权证号"
		}
	}]
}
参数 类型 长度 是否必填 默认值 描述 说明
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=农产品收购
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 二手车市场电话
jzfwfsd String 150 建筑服务发生地
jzxmmc String 100 建筑项目名称
cqzsbh String 50 产权证书/不动产权证号
tspz String 3 特殊票种 详见特殊票种类型
qyd String 60 起运地
ddd String 240 到达地
ysgjzl String 80 运输工具种类
ysgjph String 40 运输工具牌号
yshwmc String 80 运输货物名称
bdcdz String 310 不动产地址
zlqq String 50 租赁期起日期 例:2022-11-18
zlqz String 50 租赁期止日期 例:2022-11-18
kdsbz String 1 跨地(市)标志 Y:是 N:否
tdzzsxmbh String 20 土地增值税项目编号
sfzjhm String 有效身份证件号码
chuxrq String 出行日期
cfd String 出发地
lkddd String 旅客到达地
zwdj String 等级
jtgjlxDm String 交通工具类型
bdcdwdm String 不动产单元代码
wqhtbabh String 网签合同备案编号
hdjsjg String 核定计税价格
sjcjhsje String 实际成交含税金额
bxdh String 保险单号
cphcbdjh String 车牌号/船舶登记号
skssq String 税款所属期
dsccsje String 代收车船税金额
znj String 滞纳金金额
jehj String 金额合计
cjh String 车辆识别代码/车架号码
thirdVerifyStatus Integer 0 第三方查验状态 0-未查验;1-已查验
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没有

# 航空电子行程单

{
	"thirdVerifyStatus": 1,
	"airportType": 1,
    "ticketNum": "8802175000276",
    "date": "20181020",
    "issueBy": "成都携程旅行社有限公司北京分社",
    "userName": "aaa",
    "userId": "2132143243",
    "checkCode": "9668",
    "agentCode": "HKK068,08688003",
    "fare": 2000.00,
    "tax": 1.00,
    "fuelSurcharge": 30.00,
    "caacDevelopFund": 50.00,
    "insurance": 100.00,
    "totalAmount": 2080.00,
    "itemList": [{
        "from": "杭州",
        "to": "北京",
        "flightNumber": "HU7678",
        "date": "20181019",
        "time": "19:00",
        "seat": "Y"
    }]
}
编码 名称 类型 长度 是否必填 默认值 说明
airportType 机票类型 Integer 机票类型不能为空,此值影响价税分离
1-国内机票,2-国际机票
date 填开日期 String yyyyMMdd
ticketNum 电子客票号码 String 15
checkCode 验证码 String 20
agentCode 销售单位代码 String 20
issueBy 填开单位 String 60
fare 票价 BigDecimal(15,2)
tax 税费 BigDecimal(15,2)
fuelSurcharge 燃油附加费 BigDeciaml(15,2)
caacDevelopFund 民航发展基金 BigDecimal(15,2)
insurance 保险费 BigDecimal(15,2)
totalAmount 总金额 BigDecimal(15,2)
userName 乘机人姓名 String 60
userId 身份证号 String 18
thirdVerifyStatus 第三方查验状态 Integer 0 0-未查验;1-已查验
itemList 行程单明细 Array
from 出发 String 60
to 到达 String 60
flightNumber 航班号 String 40
seat 仓位 String 40
date 乘机日期 String yyyyMMdd
time 乘机时间 String 20 HH:mm

# 火车票

{
	"thirdVerifyStatus": 1,
    "number": "P026491",
    "date": "20181030",
    "origin": "北京南",
    "destination": "上海虹桥",
    "trainNum": "G9",
    "seatNo": "二等座""name": "XXXX",
    "idNumber": "123456789012345678",
    "totalAmount": 553.00
}
编码 名称 类型 长度 是否必填 默认值 说明
number 号码 String 12
date 日期 String yyyyMMdd
trainNum 车次 String 10
origin 始发站 String 20
destination 终点站 String 20
seatNo 座位号 String 20
name 姓名 String 20
idNumber 身份证号码 String 30
totalAmount 金额 BigDecimal(15,2)
thirdVerifyStatus 第三方查验状态 Integer 0 0-未查验;1-已查验

# 出租车

{
	"thirdVerifyStatus": 1,
    "invoiceCode": "211001111012",
    "invoiceNum": "87650531",
    "date": "20120916",
    "carNum": "京aaaa",
    "startTime": "21:22",
    "endTime": "22:01",
    "totalAmount": 451.00,
    "amount": 450.00,
    "fuelSurcharge": 1.00
}
编码 名称 类型 长度 是否必输 默认值 说明
date 开票日期 String yyyyMMdd
invoiceCode 发票代码 String 12
invoiceNum 发票名称 String 8
carNum 车牌号 String 20
fuelSurcharge 燃油附加 BigDecimal(15,2)
startTime 上车时间 String 20
endTime 下车时间 String 20
totalAmount 发票金额 BigDecimal(15,2)
amount 金额 BigDecima(15,2) 详见报销状态
thirdVerifyStatus 第三方查验状态 Integer 0 0-未查验;1-已查验

# 定额发票

{
	"thirdVerifyStatus": 1,
    "totalAmount": 10.00,
    "productName": "交通",
    "invoiceCode": "15101185D001",
    "invoiceNum": "01509840"
}
编码 名称 类型 长度 是否必输 默认值 说明
invoiceCode 发票代码 String 40
invoiceNum 发票号码 String 40
totalAmount 金额 BigDecimal(15,2)
productName 商品项目名称 String 20
thirdVerifyStatus 第三方查验状态 Integer 0 0-未查验;1-已查验

# 过路费

{
	"thirdVerifyStatus": 1,
    "invoiceCode": "133061801021",
    "invoiceNum": "01545541",
    "date": "20180711",
    "time": "12:05:22",
    "entrance": "诸暨浣东",
    "exit": "兰亭",
    "totalAmount": 15.00
}
编码 名称 类型 长度 是否必输 默认值 说明
invoiceCode 发票代码 String 12
invoiceNum 发票号码 String 20
date 日期 String yyyyMMdd
time 时间 String 20
entrance 入口 String 30
exit 出口 String 30
totalAmount 金额 BigDecimal(15,2)
thirdVerifyStatus 第三方查验状态 Integer 0 0-未查验;1-已查验

# 客运汽车票

{
	"thirdVerifyStatus": 1,
    "invoiceCode": "244011219112",
    "invoiceNum": "26755417",
    "date": "20120929",
    "time": "16:20",
    "exit": "隆同",
    "entrance": "广州",
    "totalAmount": 255.00,
    "insurance": 255.00,
    "name": "楼号",
}
编码 名称 类型 长度 是否必输 默认值 说明
invoiceCode 发票代码 String 12
invoiceNum 发票号码 String 16
date 日期 String yyyyMMdd
time 时间 String 20
entrance 到达 String 60
exit 出发 String 60
name 姓名 String 20
totalAmount 金额 BigDecimal(15,2)
insurance 保险费 BigDecimal(15,2) 详见报销状态
thirdVerifyStatus 第三方查验状态 Integer 0 0-未查验;1-已查验

# 其他发票

{
	"thirdVerifyStatus": 1,
    "totalAmount": 10.00,
    "date": "20120929",
    "invoiceCode": "15101185D001",
    "invoiceNum": "01509840"
}
编码 名称 类型 长度 是否必输 默认值 说明
invoiceCode 发票代码 String 32
invoiceNum 发票号码 String 32
totalAmount 金额 BigDecimal(15,2)
date 日期 String yyyyMMdd
thirdVerifyStatus 第三方查验状态 Integer 0 0-未查验;1-已查验

# 财政非税票据

{
	"busiType": 66,
	"checker": "贾晴",
	"handlingPerson": "李文静",
	"invoiceCode": "13061121",
	"invoiceNum": "0000678848",
	"invoicingPartyName": "易县妇幼保健院",
	"issueDate": "2021-05-07",
	"payerPartyCode": "130633199309011067",
	"payerPartyName": "路超",
	"randomNumber": "547703",
	"recName": "易县妇幼保健院",
	"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
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

# 海关缴款书

{
	"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": ""
}
参数 类型 长度 是否必输 描述
billingNo String 30 是(saveMode=2时必填) 专用缴款书号码,
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 业务员,

#

# 返回值

失败1

{
    "code": "9999",
    "msg": "代码144001901550号码9999的机打发票已存在"
}

失败2

{
    "code": "1001",
    "msg": "火车票P026466金额不能为空"
}

成功

{
    "code": "0000",
    "datas": [
        {
            "code": "9001",
            "fpDm": "1234567890",
            "fpHm": "99965679",
            "msg": "发票代码1234567890,发票号码:99965679的发票进入疑票,匹配规则:1112"
        },
        {
            "code": "0000",
            "fpDm": "1234567890",
            "fpHm": "99975679",
            "msg": "保存报销台账成功"
        }
    ],
    "msg": "操作成功"
}

# 返回值说明

参数 类型 描述 说明
code String 状态码 0000-操作成功;详见状态码说明
msg String 信息说明
datas String 成功发票信息

#

# 台账报销

# URL

POST

http://{IP}:{PORT}/input-tax/api/bill-collections/reimbursed

# 请求体

{
	"nsrsbh": "111222333456111",
	"orgcode": "xxx",
	"bills": [{
		"invoiceCode": "111111111",
		"invoiceNum": "111222",
		"billType": "tolls",
         "reimburseDate": "2020-08-31",
		"reimburseUser": "xxx"
	}]
}

# 请求体说明

参数 类型 长度 必输 说明
nsrsbh String 组织编码、税号不能同时为空
orgcode String 组织编码、税号不能同时为空
invoiceCode String 票据代码,没有时传空
invoiceNum String 票据号码
billType String 票据类型
reimburseUser String 报销人
reimburseDate String 报销日期 “yyyy-MM-dd”

# 返回值

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

# 返回值说明

编码 名称 类型 说明
code 状态码 String
msg 提示信息 String

# 台账取消报销

# URL

POST

http://{IP}:{PORT}/input-tax/api/bill-collections/cancel-reimbursed

# 请求体

{
	"nsrsbh": "111222333456111",
	"orgcode": "xxx",
	"bills": [{
		"invoiceCode": "111111111",
		"invoiceNum": "111222",
		"billType": "tolls"
	}]
}

# 请求体说明

参数 类型 长度 必输 说明
nsrsbh String 组织编码、税号不能同时为空
orgcode String 组织编码、税号不能同时为空
invoiceCode String 票据代码,没有时传空
invoiceNum String 票据号码
billType String 票据类型

# 返回值

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

# 返回值说明

编码 名称 类型 说明
code 状态码 String
msg 提示信息 String

# 台账记账

# URL

POST

http://{IP}:{PORT}/input-tax/api/bill-collections/account

# 请求体

{
	"nsrsbh": "111222333456111",
	"orgcode": "xxx",
    "checkallerror" : "1",
	"bills": [{
		"invoiceCode": "111111111",
		"invoiceNum": "111222",
		"billType": "tolls",
		"accountUser":"记账人",
		"accountNote":"记账备注",
		"accountPeriod":"202008",      
         "accountTime":"2019-11-17 10:00:11",
		"voucherid":"凭证号"
	}]
}

# 请求体说明

参数 类型 长度 必输 说明
nsrsbh String 组织编码、税号不能同时为空
orgcode String 组织编码、税号不能同时为空
checkallerror String 是否返回所有票据错误 0. 否 1.是(遇到错误不停止,继续返回所有错误) ;默认 0
bills Array 票据数组
- invoiceCode String 票据代码,没有时传空
- invoiceNum String 票据号码
- billType String 票据类型
- accountUser String 记账人
- accountNote String 记账备注
- voucherid String 凭证号
- accountPeriod String 记账会计期间,yyyyMM格式
- accountTime String 记账日期 "yyyy-MM-dd hh:mm:ss"公司

# 返回值

{
    "code": "9999",
    "msg": "记账错误,部分发票数据错误,请查看错误明细",
    "datas":{
        "bills":[
            {
                "billType": "invoice",
                "errmsg": "取消记账失败,发票台账不存在!发票代码:022002000111,发票号码:56014466",
                "invoiceCode": "022002000111",
                "invoiceNum": "56014466"
            },
            {
                "billType": "invoice",
                "errmsg": "取消记账失败,发票台账不存在!发票代码:033002000113,发票号码:1",
                "invoiceCode": "033002000113",
                "invoiceNum": "1"
            },
            {
                "billType": "invoice",
                "errmsg": "企业不匹配",
                "invoiceCode": "010011652011",
                "invoiceNum": "65425134"
            },
            {
                "billType": "invoice",
                "errmsg": "取消记账失败,发票台账不存在!发票代码:033002000113,发票号码:3",
                "invoiceCode": "033002000113",
                "invoiceNum": "3"
            },
            {
                "billType": "invoice",
                "errmsg": "取消记账失败,发票不是已记账状态!发票代码:010011652011,发票号码:87241599",
                "invoiceCode": "010011652011",
                "invoiceNum": "87241599"
            },
            {
                "billType": "invoice",
                "errmsg": "取消记账失败,发票不是已记账状态!发票代码:033002000113,发票号码:11585164",
                "invoiceCode": "033002000113",
                "invoiceNum": "11585164"
            }
        ]
    }
}

# 返回值说明

编码 名称 类型 说明
code 状态码 String
msg 提示信息 String
datas 返回数据 Object 入参 checkallerror 为1 才返回
- bills 错误明细 Array
-- billType 票据类型 String
-- errmsg 票据类型 String
-- invoiceCode 票据代码 String
-- invoiceNum 票据号码 String

# 台账取消记账

# URL

POST

http://{IP}:{PORT}/input-tax/api/bill-collections/cancel-account

# 请求体

{
	"nsrsbh": "111222333456111",
	"orgcode": "xxx",
    "checkallerror" : "1",
	"bills": [{
		"invoiceCode": "111111111",
		"invoiceNum": "111222",
		"billType": "tolls"
	}]
}

# 请求体说明

参数 类型 长度 必输 说明
nsrsbh String 组织编码、税号不能同时为空
orgcode String 组织编码、税号不能同时为空
checkallerror String 是否返回所有票据错误 0. 否 1.是(遇到错误不停止,继续返回所有错误) ;默认 0
bills Array 票据数组
- invoiceCode String 票据代码,没有时传空
- invoiceNum String 票据号码
- billType String 票据类型

# 返回值

{
    "code": "9999",
    "msg": "取消记账错误,部分发票数据错误,请查看错误明细",
    "datas":{
        "bills":[
            {
                "billType": "invoice",
                "errmsg": "取消记账失败,发票台账不存在!发票代码:022002000111,发票号码:56014466",
                "invoiceCode": "022002000111",
                "invoiceNum": "56014466"
            },
            {
                "billType": "invoice",
                "errmsg": "取消记账失败,发票台账不存在!发票代码:033002000113,发票号码:1",
                "invoiceCode": "033002000113",
                "invoiceNum": "1"
            },
            {
                "billType": "invoice",
                "errmsg": "企业不匹配",
                "invoiceCode": "010011652011",
                "invoiceNum": "65425134"
            },
            {
                "billType": "invoice",
                "errmsg": "取消记账失败,发票台账不存在!发票代码:033002000113,发票号码:3",
                "invoiceCode": "033002000113",
                "invoiceNum": "3"
            },
            {
                "billType": "invoice",
                "errmsg": "取消记账失败,发票不是已记账状态!发票代码:010011652011,发票号码:87241599",
                "invoiceCode": "010011652011",
                "invoiceNum": "87241599"
            },
            {
                "billType": "invoice",
                "errmsg": "取消记账失败,发票不是已记账状态!发票代码:033002000113,发票号码:11585164",
                "invoiceCode": "033002000113",
                "invoiceNum": "11585164"
            }
        ]
    }
}

# 返回值说明

编码 名称 类型 说明
code 状态码 String 0000 成功,其他失败
msg 提示信息 String
datas 返回数据 Object 入参 checkallerror 为1 才返回
- bills 错误明细 Array
-- billType 票据类型 String
-- errmsg 票据类型 String
-- invoiceCode 票据代码 String
-- invoiceNum 票据号码 String

# 报销台账删除

# URL

POST

http://{IP}:{PORT}/input-tax/api/bill-collections/delete

# 请求体

{
    "nsrsbh" : "91110000600001760P",
    "orgcode" : "10000",
    "bills" : [{
        "billType" : "taxi",
        "invoiceCode" : "11111111",
        "invoiceNum" : "11212",
	    "checkCode":"2456",
		"airType":"1",
		"receiptNumber":""
    }]
}

# 请求体说明

参数 类型 长度 必输 说明
nsrsbh String 组织编码、税号不能同时为空
orgcode String 组织编码、税号不能同时为空
invoiceCode String 票据代码,没有时传空
invoiceNum String 票据号码
airType String 航空行程单类型1:普通航空行程单,tickectNum必传,uniqueCode=ticketNum+checkCode 2:电子行程单,receiptNumber必传,uniqueCode=receiptNumber
checkCode String 校验码
receiptNumber String 行程单号码
billType String 票据类型

# 返回值

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

# 返回值说明

编码 名称 类型 说明
code 状态码 String
msg 提示信息 String

# 报销台账查询附件(全票种)

本服务提供发票展现链接,用来展现发票,查看发票附件;

链接有效时间为30分钟

# URL

POST http://<HOST>:<PORT>/input-tax/api/reimburseCollection/V2/view-url?appid=XXXXX


# 请求头说明

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

# 请求体

{
	"orgcode": "XXXXXX",
	"nsrsbh": "101011111111111",
	"bills": [{
            "billType" : "invoice",
			"invoiceNum": "11111111",
			"invoiceCode": "111111111111"
		},
		{
            "billType" : "invoice",
			"invoiceNum": "22222222",
			"invoiceCode": "222222222222"
		}
	]
}

# 请求体说明

参数 类型 长度 是否必填 默认值 描述 说明
nsrsbh String 纳税人识别号 受票企业纳税人识别号;纳税人识别号与组织编码至少传入一项
orgcode String 组织编码 受票方企业在发票平台的组织编码纳税人识别号与组织编码至少传入一项
bills Array
- billType String 发票类型 invoice-增值税发票;quota-定额发票;machine-机打发票;taxi-出租车发票; train-火车票;passenger-客运汽车票;air-航空运输电子客票行程单;tolls-过路费发票; other-其他发票
- invoiceNum String 发票号码
- invoiceCode String 发票代码

# 返回值

{
	"code": "0000",
	"msg": "操作成功",
	"datas": "https://xxx.xxx.com/xxx/xxx?viewid=yyy"
}

# 返回值说明

参数 类型 描述 说明
code String 状态码 0000-操作成功;1001-数据不合法;详见状态码说明
msg String 信息说明
datas String 发票附件链接 链接有效时间为30分钟

# 其他发票台账查询

# URL

POST

http://{IP}:{PORT}/input-tax/api/bill-collections/other?pagenum=1&pagesize=15

# 请求体

{
	"orgcode": "10000",
	"submitDate_begin": "2019-07-01",
	"submitDate_end": "2019-07-09"
}

# 请求体说明

参数 类型 长度 必输 说明
orgcode String 组织编码、税号不能同时为空
submitDate_begin String 提交时间-起
submitDate_end String 提交时间-止

# 返回值

{
	"code": "0000",
	"datas": {
		"bills": [{			
             "totalAmount": 10.00,
             "invoiceCode": "15101185D001",
             "invoiceNum": "01509840",       
             "date": "2021-01-01",       
             "purchaserstatus": "3",       
             "submitter": "gyr01",       
             "reimburseMoney": 10.00,       
             "voucherid": "凭证号",       
             "accountPeriod": "202101",       
             "submitDate": "2021-01-01",       
             "accountNote": "vtest",
             "xsfMc": "成都携程旅行社有限公司北京分社"
		}],
		"totalEntity": {
			"totalCount": 1,
			"totalHjseSum": 1093.71,
			"totalJeSum": 12242.29,
			"totalJshjSum": 13336.0   
		}
	},
	"msg": "SUCCESS"
}

# 返回值说明

编码 名称 类型 说明
code 状态码 String
msg 提示信息 String
datas Object
-bills Array
--totalAmount 合计金额 Decimal
--invoiceCode 发票代码 String
--invoiceNum 发票号码 String
--date 提交票夹日期 String yyyy-MM-dd
--purchaserstatus 报销状态 String 详见报销状态
--submitter 台账提交人 String
--reimburseMoney 报销金额 Decimal
--voucherid 凭证号 String
--accountPeriod 会计期间 String yyyyMMdd
--submitDate 发票号码 String
--accountNote 记账备注 String
--xsfMc 销方名称 String

# 飞机票台账查询

# URL

POST

http://{IP}:{PORT}/input-tax/api/bill-collections/air?pagenum=1&pagesize=15

# 请求体

{
	"orgcode": "10000",
	"submitDate_begin": "2019-07-01",
	"submitDate_end": "2019-07-09"
}

# 请求体说明

参数 类型 长度 必输 说明
orgcode String 组织编码、税号不能同时为空
submitDate_begin String 提交时间-起
submitDate_end String 提交时间-止

# 返回值

{
	"code": "0000",
	"datas": {
		"bills": [{
			"number": "0742497183958",
			"totalAmount": 13336.0,
			"feeWithoutTax": 12242.29,
			"taxAmount": 1093.71,
			"date": "2019-06-29 16:56:44",
			"issueBy": "国航信信息服务柜台",
			"userName": "HANG/WENSHUO",
			"manualVerifyStatus": 1.0,
			"paymentStatus": 1.0,
			"purchaserstatus": 39.0,  
             "voucherid": "凭证号", 
			"reimburseDate": "2019-06-29 00:00:00",
			"reimburseMoney": 13336.0,
			"reimburseUser": "111",
			"submitDate": "2019-04-10 13:59:17",
			"submitter": "冠益乳r12",
			"vnote": "111",
			"fare": 10600.0,
			"fuelSurcharge": 2646.0,
			"caacDevelopFund": 90.0
		}],
		"totalEntity": {
			"totalCount": 1,
			"totalHjseSum": 1093.71,
			"totalJeSum": 12242.29,
			"totalJshjSum": 13336.0
		}
	},
	"msg": "SUCCESS"
}

# 返回值说明

编码 名称 类型 说明
code 状态码 String
msg 提示信息 String

# 火车票台账查询

# URL

POST

http://{IP}:{PORT}/input-tax/api/bill-collections/train?pagenum=1&pagesize=15

# 请求体

{
	"orgcode": "10000",
	"submitDate_begin": "2019-07-01",
	"submitDate_end": "2019-07-09"
}

# 请求体说明

参数 类型 长度 必输 说明
orgcode String 组织编码、税号不能同时为空
submitDate_begin String 提交时间-起
submitDate_end String 提交时间-止

# 返回值

{
	"code": "0000",
	"datas": {
		"bills": [{
			"number": "F013549",
			"totalAmount": 313.5,
			"feeWithoutTax": 287.61,
			"taxAmount": 25.89,
			"date": "2019-01-01 00:00:00",
			"manualVerifyStatus": 2.0,
			"purchaserstatus": 39.0,  
             "voucherid": "凭证号", 
			"reimburseUser": "sw",
			"submitDate": "2019-05-08 10:33:28",
			"submitter": "徐二彬123",
			"origin": "哈尔滨北",
			"destination": "北京",
			"trainNum": "D26",
			"name": "刘强"
		}],
		"totalEntity": {
			"totalCount": 1,
			"totalHjseSum": 25.89,
			"totalJeSum": 287.61,
			"totalJshjSum": 313.5
		}
	},
	"msg": "SUCCESS"
}

# 返回值说明

编码 名称 类型 说明
code 状态码 String
msg 提示信息 String

# 出租车台账查询

# URL

POST

http://{IP}:{PORT}/input-tax/api/bill-collections/taxi?pagenum=1&pagesize=15

# 请求体

{
	"orgcode": "10000",
	"submitDate_begin": "2019-07-01",
	"submitDate_end": "2019-07-09"
}

# 请求体说明

参数 类型 长度 必输 说明
orgcode String 组织编码、税号不能同时为空
submitDate_begin String 提交时间-起
submitDate_end String 提交时间-止

# 返回值

{
	"code": "0000",
	"datas": {
		"bills": [{
			"invoiceCode": "111001811001",
			"invoiceNum": "02421676",
			"totalAmount": 27.0,
			"date": "2019-04-01 00:00:00",
			"paymentStatus": 1.0,
			"purchaserstatus": 36.0,  
             "voucherid": "凭证号", 
			"submitDate": "2019-05-23 17:06:17",
			"carNum": "1",
			"startTime": "11:24",
			"endTime": "11:40",
			"suspectStatus": 1.0,
			"suspectType": 9.0
		}],
		"totalEntity": {
			"totalCount": 1,
			"totalJshjSum": 27.0
		}
	},
	"msg": "SUCCESS"
}

# 返回值说明

编码 名称 类型 说明
code 状态码 String
msg 提示信息 String

# 机打发票台账查询

# URL

POST

http://{IP}:{PORT}/input-tax/api/bill-collections/machine?pagenum=1&pagesize=15

# 请求体

{
	"orgcode": "10000",
	"submitDate_begin": "2019-07-01",
	"submitDate_end": "2019-07-09"
}

# 请求体说明

参数 类型 长度 必输 说明
orgcode String 组织编码、税号不能同时为空
submitDate_begin String 提交时间-起
submitDate_end String 提交时间-止

# 返回值

{
	"code": "0000",
	"datas": {
		"bills": [{
			    "invoiceCode": "111001371014",
                "invoiceNum": "06554631",
                "totalAmount": 311233.0,  
             	"voucherid": "凭证号", 
                "date": "2014-05-13 00:00:00",
                "sellerName": "北京姿彩万千商贸有限责任公司"
		}],
		"totalEntity": {
			"totalCount": 1,
			"totalHjseSum": 25.89,
			"totalJeSum": 287.61,
			"totalJshjSum": 313.5
		}
	},
	"msg": "SUCCESS"
}

# 返回值说明

编码 名称 类型 说明
code 状态码 String
msg 提示信息 String

# 定额发票台账查询

# URL

POST

http://{IP}:{PORT}/input-tax/api/bill-collections/quota?pagenum=1&pagesize=15

# 请求体

{
	"orgcode": "10000",
	"submitDate_begin": "2019-07-01",
	"submitDate_end": "2019-07-09"
}

# 请求体说明

参数 类型 长度 必输 说明
orgcode String 组织编码、税号不能同时为空
submitDate_begin String 提交时间-起
submitDate_end String 提交时间-止

# 返回值

{
	"code": "0000",
	"datas": {
		"bills": [{			
             "totalAmount": 10.00,  
             "voucherid": "凭证号", 
             "invoiceCode": "15101185D001",
             "invoiceNum": "01509840"          
		}],
		"totalEntity": {
			"totalCount": 1,
			"totalHjseSum": 25.89,
			"totalJeSum": 287.61,
			"totalJshjSum": 313.5
		}
	},
	"msg": "SUCCESS"
}

# 返回值说明

编码 名称 类型 说明
code 状态码 String
msg 提示信息 String

# 过路费发票台账查询

# URL

POST

http://{IP}:{PORT}/input-tax/api/bill-collections/tolls?pagenum=1&pagesize=15

# 请求体

{
	"orgcode": "10000",
	"submitDate_begin": "2019-07-01",
	"submitDate_end": "2019-07-09"
}

# 请求体说明

参数 类型 长度 必输 说明
orgcode String 组织编码、税号不能同时为空
submitDate_begin String 提交时间-起
submitDate_end String 提交时间-止

# 返回值

{
	"code": "0000",
	"datas": {
		"bills": [{			 
             "date": "20180711",
             "exit": "兰亭",
             "totalAmount": 15.00,    
             "voucherid": "凭证号",          
             "time": "12:05:22",
             "entrance": "诸暨浣东",
             "invoiceCode": "133061801021",
             "invoiceNum": "01545541"            
		}],
		"totalEntity": {
			"totalCount": 1,
			"totalHjseSum": 25.89,
			"totalJeSum": 287.61,
			"totalJshjSum": 313.5
		}
	},
	"msg": "SUCCESS"
}

# 返回值说明

编码 名称 类型 说明
code 状态码 String
msg 提示信息 String

# 客运汽车发票台账查询

# URL

POST

http://{IP}:{PORT}/input-tax/api/bill-collections/passenger?pagenum=1&pagesize=15

# 请求体

{
	"orgcode": "10000",
	"submitDate_begin": "2019-07-01",
	"submitDate_end": "2019-07-09"
}

# 请求体说明

参数 类型 长度 必输 说明
orgcode String 组织编码、税号不能同时为空
submitDate_begin String 提交时间-起
submitDate_end String 提交时间-止

# 返回值

{
	"code": "0000",
	"datas": {
		"bills": [{		
             "date": "20120929",
             "kind": "交通",
             "invoiceCode": "244011219112",
             "invoiceNum": "26755417",
             "exit": "隆同",
             "totalAmount": 255.00,  
             "voucherid": "凭证号", 
             "name": "楼号",
             "time": "16:20",
             "entrance": "广州"          
		}],
		"totalEntity": {
			"totalCount": 1,
			"totalHjseSum": 25.89,
			"totalJeSum": 287.61,
			"totalJshjSum": 313.5
		}
	},
	"msg": "SUCCESS"
}

# 返回值说明

编码 名称 类型 说明
code 状态码 String
msg 提示信息 String

# 医疗门诊查询

# URL

POST

http://{IP}:{PORT}/input-tax/api/bill-collections/outpatient?pagenum=1&pagesize=15

# 请求体

{
	"orgcode": "10000",
	"submitDate_begin": "2019-07-01",
	"submitDate_end": "2019-07-09"
}

# 请求体说明

参数 类型 长度 必输 说明
orgcode String 组织编码
submitDate_begin String 提交时间-起
submitDate_end String 提交时间-止

# 返回值

{
    "code": "0000",
    "datas": {
        "bills": [
            {
                "accountNote": null,
                "accountPeriod": null,
                "reimburseMoney": null,
                "voucherid": null,
                "purchaserstatus": 36.0,
                "submitDate": "2019-05-23 17:06:17",
                "submitter": "XXXXXX",
                "randomNumber": "301957",
                "invoiceCode": "13061021",
                "invoiceNum": "0033445487",
                "payerPartyName": "申秀梅",
                "invoicingPartyName": "河北省中医院",
                "recName": "2522",
                "payerPartyCode": "130102194201142167",
                "totalAmount": 940.8,
                "issueDate": "2021-05-07"
            },
            {
                "accountNote": null,
                "accountPeriod": null,
                "reimburseMoney": null,
                "voucherid": null,
                "purchaserstatus": 36.0,
                "submitDate": "2019-05-23 17:06:17",
                "submitter": "冠益乳r12",
                "randomNumber": "2a3da6",
                "invoiceCode": "52060121",
                "invoiceNum": "0009826631",
                "payerPartyName": "杜金洲",
                "invoicingPartyName": "贵阳市南明区人民医院",
                "recName": "贵阳市南明区人民医院",
                "payerPartyCode": "",
                "totalAmount": 130.0,
                "issueDate": "2021-05-07"
            }
        ],
        "totalEntity": {
            "totalCount": 2,
            "totalHjseSum": null,
            "totalJeSum": null,
            "totalJshjSum": 1070.80
        }
    },
    "msg": "SUCCESS"
}

# 返回值说明

编码 名称 类型 说明
code 状态码 String
msg 提示信息 String
datas 结果数据
bills 票据信息
purchaserstatus 报销状态 String 详见报销状态
accountNote 记账备注 String
accountPeriod 记账期间 String
reimburseMoney 报销金额 BigDecimal
voucherid 凭证号 String
submitDate 提交日期 String
submitter 提交人 String
randomNumber 校验码 String
invoiceCode 发票代码 String
invoiceNum 发票号码 String
payerPartyName 交款人 String
invoicingPartyName 开票单位 String
recName 收款单位 String
payerPartyCode 交款人统一社会信用代码 String
totalAmount 总金额 BigDecimal
issueDate 开票日期 String
totalEntity 合计信息
totalCount 合计数量 BigDecimal
totalHjseSum 合计税额 BigDecimal
totalJeSum 合计金额 BigDecimal
totalJshjSum 合计价税合计 BigDecimal

# 医疗住院查询

# URL

POST

http://{IP}:{PORT}/input-tax/api/bill-collections/hospital?pagenum=1&pagesize=15

# 请求体

{
	"orgcode": "10000",
	"submitDate_begin": "2019-07-01",
	"submitDate_end": "2019-07-09"
}

# 请求体说明

参数 类型 长度 必输 说明
orgcode String 组织编码
submitDate_begin String 提交时间-起
submitDate_end String 提交时间-止

# 返回值

{
    "code": "0000",
    "datas": {
        "bills": [
            {
                "accountNote": null,
                "accountPeriod": null,
                "reimburseMoney": null,
                "voucherid": null,
                "purchaserstatus": 36.0,
                "submitDate": "2019-05-23 17:06:17",
                "submitter": "XXXXXX",
                "randomNumber": "547703",
                "invoiceCode": "13061121",
                "invoiceNum": "0000678848",
                "payerPartyName": "路超",
                "invoicingPartyName": "易县妇幼保健院",
                "recName": "易县妇幼保健院",
                "payerPartyCode": "130633199309011067",
                "totalAmount": 1446.84,
                "issueDate": "2021-05-07"
            }
        ],
        "totalEntity": {
            "totalCount": 1,
            "totalHjseSum": null,
            "totalJeSum": null,
            "totalJshjSum": 1446.84
        }
    },
    "msg": "SUCCESS"
}

# 返回值说明

#

编码 名称 类型 说明
code 状态码 String
msg 提示信息 String
datas 结果数据
bills 票据信息
purchaserstatus 报销状态 String 详见报销状态
accountNote 记账备注 String
accountPeriod 记账期间 String
reimburseMoney 报销金额 BigDecimal
voucherid 凭证号 String
submitDate 提交日期 String
submitter 提交人 String
randomNumber 校验码 String
invoiceCode 发票代码 String
invoiceNum 发票号码 String
payerPartyName 交款人 String
invoicingPartyName 开票单位 String
recName 收款单位 String
payerPartyCode 交款人统一社会信用代码 String
totalAmount 总金额 BigDecimal
issueDate 开票日期 String
totalEntity 合计信息
totalCount 合计数量 BigDecimal
totalHjseSum 合计税额 BigDecimal
totalJeSum 合计金额 BigDecimal
totalJshjSum 合计价税合计 BigDecimal

# 财政非税票据查询

# URL

POST

http://{IP}:{PORT}/input-tax/api/bill-collections/nontax?pagenum=1&pagesize=15

# 请求体

{
	"orgcode": "10000",
	"submitDate_begin": "2019-07-01",
	"submitDate_end": "2019-07-09"
}

# 请求体说明

参数 类型 长度 必输 说明
orgcode String 组织编码
submitDate_begin String 提交时间-起
submitDate_end String 提交时间-止

# 返回值

{
    "code": "0000",
    "datas": {
        "bills": [
            {
                "accountNote": null,
                "accountPeriod": null,
                "invoiceCode": "11070121",
                "invoiceNum": "0000072720",
                "invoicingPartyName": "北京证券业协会",
                "issueDate": "2021-05-07",
                "payerPartyCode": "",
                "payerPartyName": "山西证券股份有限公司北京分公司",
                "purchaserstatus": 36,
                "randomNumber": "SyDeAU",
                "recName": "北京证券业协会",
                "reimburseMoney": null,
                "submitDate": "2019-05-23 17:06:17",
                "submitter": "XXXXXX",
                "totalAmount": 6000.00,
                "voucherid": null
            }
        ],
        "totalEntity": {
            "totalCount": 1,
            "totalHjseSum": null,
            "totalJeSum": null,
            "totalJshjSum": 6000.00
        }
    },
    "msg": "SUCCESS"
}

# 返回值说明

#

编码 名称 类型 说明
code 状态码 String
msg 提示信息 String
datas 结果数据
bills 票据信息
purchaserstatus 报销状态 String 详见报销状态
accountNote 记账备注 String
accountPeriod 记账期间 String
reimburseMoney 报销金额 BigDecimal
voucherid 凭证号 String
submitDate 提交日期 String
submitter 提交人 String
randomNumber 校验码 String
invoiceCode 发票代码 String
invoiceNum 发票号码 String
payerPartyName 交款人 String
invoicingPartyName 开票单位 String
recName 收款单位 String
payerPartyCode 交款人统一社会信用代码 String
totalAmount 总金额 BigDecimal
issueDate 开票日期 String
totalEntity 合计信息
totalCount 合计数量 BigDecimal
totalHjseSum 合计税额 BigDecimal
totalJeSum 合计金额 BigDecimal
totalJshjSum 合计价税合计 BigDecimal

#

# 增值税发票台账查询

# URL

POST

http://{IP}:{PORT}/input-tax/api/bill-collections/reimburse?pagenum=1&pagesize=15

# 请求体

{
	"orgcode": "10000",
	"submitDate_begin": "2019-07-01",
	"submitDate_end": "2019-07-09"
}

# 请求体说明

参数 类型 长度 必输 说明
orgcode String 组织编码、税号不能同时为空
submitDate_begin String 提交时间-起
submitDate_end String 提交时间-止

# 返回值

{
	"code": "0000",
	"datas": {
		"bills": [{		
             "fpHm": "55941164",
                "fpDm": "011001800111",
                "kprq": "2019-10-08",
                "fplx": "1",
                "xsfMc": "北京京港地铁有限公司",
                "jshj": 4.0,
                "purchaserstatus": 36.0,  
             	"voucherid": "凭证号", 
                "hasattache": false,
                "gmfMc": "用友网络科技股份有限公司",
                "gmfNsrsbh": "91110000600001760P",
                "xsfNsrsbh": "91110000717862580H",
                "hjje": 3.88    
		}],
		"totalEntity": {
			"totalCount": 1,
			"totalHjseSum": 25.89,
			"totalJeSum": 287.61,
			"totalJshjSum": 313.5
		}
	},
	"msg": "SUCCESS"
}

# 返回值说明

编码 名称 类型 说明
code 状态码 String
msg 提示信息 String

# 报销台账查询详情信息接口

查询报销台账中票据的详情信息

# URL

POST http://<HOST>:<PORT>/input-tax/api/bill-collections/detail?appid=XXXXXX

# 请求体

{
    "billCode": "12345678",
    "billNum": "1234567812",
    "billType": "invoice",
}

# 请求头说明

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

# 请求体

参数 类型 是否必输 描述 说明
billCode String 发票代码
billNum String 发票号码
billType String 发票类型 invoice-增值税发票;quota-定额发票;machine-机打发票;taxi-出租车发票; train-火车票;passenger-客运汽车票;air-航空运输电子客票行程单;tolls-过路费发票;nontax-财政非税票据(包含医疗门诊、住院)

# 返回值说明

参数 类型 是否必输 描述 说明
code string 交易码
msg string 交易信息
data object 票详情信息 详情如下

# 返回值

{
    "code": "0000",
    "msg": "操作成功""data":{
           "id":
           "date":
           "time":
           .....
    
    }
}

data信息

# 机打发票

编码 名称 类型 说明
id 机打发票主键 Long
date 开票日期 String yyyyMMdd
time 开票时间 String
invoiceCode 发票代码 String
invoiceNum 发票号码 String
checkCode 校验码 String
category 种类 String
totalAmount 合计金额 BigDecimal
sellerName 销方名称 String
sellerTaxId 销方税号 String
buyerName 购方名称 String
buyerTaxId 购方税号 String
purchaserStatus 报销状态 Int
kind 消费类型 String
itemList 机打发票明细行 Array
id 机打发票明细ID Long
machineId 机打发票主表ID Long
item 项目 String
amount 金额 BigDecimal
paymentStatus 支付状态 String 1:未支付,2:已支付
voucherid 凭证号 String
suspectStatus 业务合规处理 String 1-未处理 2-已放行 3-已禁止
suspectFlag 业务合规标识 String 1:合规 2:存疑 3:不合规
suspectRule 业务合规判定规则 String

# 增值税发票

编码 名称 类型 说明
pkInvoice 发票Id int
bz 备注 String
fpDm 发票代码 String
fpHm 发票号码 String
fpMw 发票密文 String
fplx 发票类型 String
zsfs 征税方式 String
fpjz 发票介质 String 0-电子1-纸质
zfbz 作废标志 String N-未作废Y-已作废
gmfDzdh 购方地址电话 String
gmfMc 购方名称 String
gmfNsrsbh 购方纳税人识别号 String
gmfYhzh 购方银行账号 String
hjje 合计金额 BigDecimal
hjse 合计税额 BigDecimal
jqbh 税控设备编号 String
jshj 加税合计 BigDecimal
jym 校验码 String
kplx 开票类型 String 0-蓝字1-红字
kpr 开票人 String
kprq 开票日期 String yyyyMMdd
skr 收款人 String
xsfDzdh 销方地址电话 String
xsfMc 销方名称 String
xsfNsrsbh 销方纳税人识别号 String
xsfYhzh 销方银行账号 String
yfpDm 原发票代码 String
yfpHm 原发票号码 String
ewm 二维码 String
sgbz 收购标识 String 2-农产品收购
purchaserStatus 报销状态 String
kind 消费类型 String
items 表体明细行 Array
xmmc 项目名称 String
ggxh 规格型号 String
dw 单位 String
spbm 商品税收分类编码 String
lslbs 零税率标识 String
xmsl 项目数量 BigDecimal
xmdj 项目单价 BigDecimal
xmje 项目金额 BigDecimal
xmjshj 项目加税合计 BigDecimal
sl 税率 BigDecimal
se 税额 BigDecimal
hh 行号 String 有折扣行时必输
yhzcbs 优惠政策标识 int 0:不使用,1:使用
zzstsgl 优惠政策说明 String
kce 扣除额 BigDecimal
paymentStatus 支付状态 String 1:未支付,2:已支付
voucherid 凭证号 String
suspectStatus 业务合规处理 String 1-未处理 2-已放行 3-已禁止
suspectFlag 业务合规标识 String 1:合规 2:存疑 3:不合规
suspectRule 业务合规判定规则 String

# 航空电子发票

编码 名称 类型 说明
id 行程单主键 Long
date 填开日期 String yyyyMMdd
ticketNum 电子客票号码 String
checkCode 验证码 String
agentCode 销售单位代码 String
issueBy 填开单位 String
fare 票夹 BigDecimal
tax 税费 BigDecimal
fuelSurcharge 燃油附加费 BigDeciaml
caacDevelopFund 民航发展基金 BigDecimal
insurance 保险费 BigDecimal
totalAmount 总金额 BigDecimal
userName 乘机人姓名 String
userId 身份证号 String
purchaserStatus 报销状态 Int
kind 消费类型 String
feeWithoutTax 金额(不含税) BigDecimal
taxAmount 税额 BigDecimal
itemList 行程单明细 Array
id 行程单明细ID Long
airId 行程单主表ID Long
from 出发 String
to 到达 String
flightNumber 航班号 String
carrier 承运人 String
seat 仓位 String
date 乘机日期 String yyyyMMdd
time 乘机时间 String HH:mm
paymentStatus 支付状态 String 1:未支付,2:已支付
voucherid 凭证号 String
suspectStatus 业务合规处理 String 1-未处理 2-已放行 3-已禁止
suspectFlag 业务合规标识 String 1:合规 2:存疑 3:不合规
suspectRule 业务合规判定规则 String

# 火车票

编码 名称 类型 说明
id 火车票主键 Long
number 号码 String
date 日期 String yyyyMMdd
time 时间 String HH:mm
trainNum 车次 String
origin 始发站 String
destination 终点站 String
level 坐席 String
seatNo 座位号 String
name 姓名 String
totalAmount 金额 BigDecimal
feeWithoutTax 金额(不含税) BigDecimal
taxAmount 税额 BigDecimal
purchaserStatus 报销状态 int
kind 消费类型 String
paymentStatus 支付状态 String 1:未支付,2:已支付
voucherid 凭证号 String
suspectStatus 业务合规处理 String 1-未处理 2-已放行 3-已禁止
suspectFlag 业务合规标识 String 1:合规 2:存疑 3:不合规
suspectRule 业务合规判定规则 String

# 出租车

编码 名称 类型 说明
id 出租车票ID Long
date 开票日期 String date yyyyMMdd
invoiceCode 发票代码 String
invoiceNum 发票名称 String
carNum 车牌号 String
mileage 里程 BigDecimal
startTime 上车时间 String
endTime 下车时间 String
totalAmount 金额 BigDecimal
purchaserStatus 报销状态 Int
place 发票所在地 String
kind 消费类型 String
paymentStatus 支付状态 String 1:未支付,2:已支付
voucherid 凭证号 String
suspectStatus 业务合规处理 String 1-未处理 2-已放行 3-已禁止
suspectFlag 业务合规标识 String 1:合规 2:存疑 3:不合规
suspectRule 业务合规判定规则 String

# 定额发票

编码 名称 类型 说明
id 定额发票ID Long
invoiceCode 发票代码 String
invoiceNum 发票号码 String
totalAmount 金额 BigDecimal
purchaserStatus 报销状态 Int
kind 消费类型 String
productName 商品项目名称 String
paymentStatus 支付状态 String 1:未支付,2:已支付
voucherid 凭证号 String
suspectStatus 业务合规处理 String 1-未处理 2-已放行 3-已禁止
suspectFlag 业务合规标识 String 1:合规 2:存疑 3:不合规
suspectRule 业务合规判定规则 String

# 过路费

编码 名称 类型 说明
id 过路费ID Long
invoiceCode 发票代码 String
invoiceNum 发票号码 String
date 日期 String date yyyyMMdd
time 时间 String
entrance 入口 String
exit 出口 String
totalAmount 金额 BigDecimal
purchaserStatus 报销状态 Int
kind 消费类型 String kind
paymentStatus 支付状态 String 1:未支付,2:已支付
voucherid 凭证号 String
suspectStatus 业务合规处理 String 1-未处理 2-已放行 3-已禁止
suspectFlag 业务合规标识 String 1:合规 2:存疑 3:不合规
suspectRule 业务合规判定规则 String

# 客运汽车票

编码 名称 类型 说明
id 客运汽车票ID Long
invoiceCode 发票代码 String
invoiceNum 发票号码 String
date 日期 String date yyyyMMdd
time 时间 String
entrance 入口 String
exit 出口 String
name 姓名 String
totalAmount 金额 BigDecimal
purchaserStatus 报销状态 Int
kind 消费类型 String
feeWithoutTax 合计金额(不含税) BigDecimal
taxAmount 税额 BigDecimal
paymentStatus 支付状态 String 1:未支付,2:已支付
voucherid 凭证号 String
suspectStatus 业务合规处理 String 1-未处理 2-已放行 3-已禁止
suspectFlag 业务合规标识 String 1:合规 2:存疑 3:不合规
suspectRule 业务合规判定规则 String

# 财政非税票据

{ 
	"busiType": 65,
    "checker": "10219",
    "handlingPerson": "2522",
    "invoiceCode": "13061021",
    "invoiceNum": "0033445487",
    "invoicingPartyName": "河北省中医院",
    "issueDate": "2021-05-07",
    "payerPartyCode": "130102194201142167",
    "payerPartyName": "申秀梅",
    "paymentStatus": "1",
    "randomNumber": "301957",
    "recName": "2522",
    "remark": "",
    "totalAmount": 940.80,
    "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": "次"
        }
    ]
}
编码 名称 类型 说明
busiType 业务类型 Integer 64-财政非税票据 65-进项医疗门诊票据 66-进项医疗住院票据
checker 复核人 String
handlingPerson 收款人 String
invoiceCode 发票代码 String
invoiceNum 发票号码 String
invoicingPartyName 开票单位 String
issueDate 开票日期 String
payerPartyCode 交款人统一社会信用代码 String
payerPartyName 交款人 String
paymentStatus 支付状态 Integer 1:未支付 2:已支付
voucherid 凭证号 String
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
suspectStatus 业务合规处理 String 1-未处理 2-已放行 3-已禁止
suspectFlag 业务合规标识 String 1:合规 2:存疑 3:不合规
suspectRule 业务合规判定规则 String

#

# 报销台账置支付状态接口

# URL

POST

http://{IP}:{PORT}/input-tax/api/bill-collections/paid

# 请求体

{
    "billCode": "12345678",
    "billNum": "1234567812",
    "billType": "invoice",
}

# 请求体说明

参数 类型 是否必输 描述 说明
billCode String 发票代码
billNum String 发票号码
billType String 发票类型 invoice-增值税发票;quota-定额发票;machine-机打发票;taxi-出租车发票; train-火车票;passenger-客运汽车票;air-航空运输电子客票行程单;tolls-过路费发票

# 返回值

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

# 返回值说明

编码 名称 类型 说明
code 状态码 String
msg 提示信息 String

# 报销台账取消支付状态接口

# URL

POST

http://{IP}:{PORT}/input-tax/api/bill-collections/cancel-paid

# 请求体

{
    "billCode": "12345678",
    "billNum": "1234567812",
    "billType": "invoice",
}

# 请求体说明

参数 类型 是否必输 描述 说明
billCode String 发票代码
billNum String 发票号码
billType String 发票类型 invoice-增值税发票;quota-定额发票;machine-机打发票;taxi-出租车发票; train-火车票;passenger-客运汽车票;air-航空运输电子客票行程单;tolls-过路费发票

# 返回值

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

# 返回值说明

编码 名称 类型 说明
code 状态码 String
msg 提示信息 String

# 报销台账更新凭证号接口

# URL

POST

http://{IP}:{PORT}/input-tax/api/bill-collections/update-voucherid

# 请求体

{
    "nsrsbh": "xxx",
    "orgcode":"xxxx",
    "bills":[
        {
            "billType":"other",
            "voucherid":"ceshi",
            "invoiceNum":"051696",
            "invoiceCode":"A10906246428",
            "srcBillType":"tims-server",
            "srcBillCode":"BX1905260023"
        },
        {
            "billType":"other",
            "voucherid":"ceshi",
            "srcBillType":"tims-server",
            "srcBillCode":"BX1905260023"
        },
        {
            "billType":"other",
            "voucherid":"ceshi",
            "invoiceNum":"051696",
            "invoiceCode":"A10906246428"
        }
    ]
}

# 请求体说明

参数 类型 是否必输 描述 说明
nsrsbh String 纳税人识别号 组织编码和纳税人识别号不能同时为空
orgcode String 组织编码 组织编码和纳税人识别号不能同时为空
bills Array 待更新列表 待更新列表,不可为空
- voucherid String 凭证号
- invoiceNum String 发票号码 invoiceNum/invoiceCode 必须一起出现 , 且 "代码+号码" 与 "来源类型+来源单据号" 两对必须出现一对,同时出现以 "代码+号码“为准
- invoiceCode String 发票代码 invoiceNum/invoiceCode 必须一起出现 , 且 "代码+号码" 与 "来源类型+来源单据号" 两对必须出现一对,同时出现以 "代码+号码"为准
- srcBillType String 来源类型 srcBillType/srcBillCode 必须一起出现 , 且 "代码+号码" 与 "来源类型+来源单据号" 两对必须出现一对,同时出现以 "代码+号码"为准
- srcBillCode String 来源单据号 srcBillType/srcBillCode 必须一起出现 , 且 "代码+号码" 与 "来源类型+来源单据号" 两对必须出现一对,同时出现以 "代码+号码"为准
- billType String 发票类型 invoice-增值税发票;quota-定额发票;machine-机打发票;taxi-出租车发票; train-火车票;passenger-客运汽车票;air-航空运输电子客票行程单;tolls-过路费发票

# 返回值

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

{
    "code": "9999",
    "msg": "凭证号不能为空,出问题的发票是{票据类型=增值税发票,发票代码=null,发票号码=null,来源类型=null,来源单据号=null,凭证号=}"
}

{
    "code": "9999",
    "msg": "更新凭证号失败,报销台账中该发票不存在! 发票代码=,发票号码=,来源类型=来源单据类型,来源单据号=来源单据号"
}

{
    "code": "9999",
    "msg": "参数错误,[发票代码+发票号码] 与 [来源类型+来源单据号] 必须出现一组!"
}

{
    "code": "9999",
    "msg": "更新凭证号失败,只有已记账的台账才能更新凭证号!发票代码011002100211,发票号码99293053"
}

# 返回值说明

编码 名称 类型 说明
code 状态码 String
msg 提示信息 String

# 报销台账更新来源单据号接口

# URL

POST

http://{IP}:{PORT}/input-tax/api/bill-collections/update-srcbill

# 请求体

{
    "nsrsbh": "xxx",
    "orgcode":"xxxx",
    "bills":[
        {
        "invoiceCode": "061001605111",
        "invoiceNum": "59989597",
        "billType": "invoice",   
        "srcBillType":"srcBillType",
        "srcBillCode":"srcBillCode"
        }
    ]
}

# 请求体说明

参数 类型 是否必输 描述 说明
nsrsbh String 纳税人识别号 组织编码和纳税人识别号不能同时为空
orgcode String 组织编码 组织编码和纳税人识别号不能同时为空
srcBillType String 来源业务系统
srcBillCode String 来源单据号
invoiceNum String 发票号码
invoiceCode String 发票代码
billType String 发票类型 invoice-增值税发票;quota-定额发票;machine-机打发票;taxi-出租车发票; train-火车票;passenger-客运汽车票;air-航空运输电子客票行程单;tolls-过路费发票

# 返回值

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

# 返回值说明

编码 名称 类型 说明
code 状态码 String
msg 提示信息 String

# 报销台账设置项目

# URL

POST

http://{IP}:{PORT}/input-tax/api/reimburseCollection/project/update

# 请求体

{
    "nsrsbh": "111222333456111",
    "orgcode": "xxx",
    "projectCode":"xxx",
    "bSubInvoice":"N",
    "collectionProjectParams":[
        {
            "fpHm":"29466710",
            "fpDm":"1100182130",
            "billType":"invoice"
        }
    ]

}

# 请求体说明

参数 类型 是否必输 描述 说明
nsrsbh String 纳税人识别号 组织编码和纳税人识别号不能同时为空
orgcode String 组织编码 组织编码和纳税人识别号不能同时为空
projectCode String 项目编码
bSubInvoice String 是否分包发票 Y-分包;N-不分包
collectionProjectParams Array 发票列表
-fpHm String 发票号码
-fpDm String 发票代码
-billType String 票据类型 详见票种类型

# 返回值

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

# 返回值说明

编码 名称 类型 说明
code 状态码 String
msg 提示信息 String

# 附录

#

# 机打发票

{
    "date": "20190425",
    "kind": "餐饮",
    "filePath": null,
    "sellerName": "顺德北浩敏跃渝聚食府",
    "buyerName": "用友网络科技股份有限公司佛山分公司",
    "invoiceCode": "144001601211",
    "invoiceNum": "04964432",
    "buyerTaxId": "914406064748033814Q",
    "checkCode": "",
    "totalAmount": 139.00,
    "purchaserStatus": null,
    "sellerTaxId": "92440606MA4VP01G84",
    "itemList": null,
    "id": null,
    "time": "",
    "category": null
}
编码 名称 类型 摘要字段 说明
id 机打发票主键 Long billId
date 开票日期 String yyyyMMdd
time 开票时间 String
invoiceCode 发票代码 String invoiceCode
invoiceNum 发票号码 String invoiceNum
checkCode 校验码 String
category 种类 String
totalAmount 合计金额 BigDecimal amount
sellerName 销方名称 String sellerName
sellerTaxId 销方税号 String
buyerName 购方名称 String buyerName
buyerTaxId 购方税号 String
purchaserStatus 报销状态 Int purchaserStatus 详见报销状态
kind 消费类型 String kind
itemList 机打发票明细行 Array
id 机打发票明细ID Long
machineId 机打发票主表ID Long
item 项目 String
amount 金额 BigDecimal

# 增值税发票

{
	"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",
	"swjgdm": "",
	"swjgmc": "",
	"txfbz": null,
	"wspzh": "",
	"xsfDzdh": "销售方地址电话",
	"xsfMc": "销售方名称",
	"xsfNsrsbh": "1111111111",
	"xsfYhzh": "销售方银行账户",
	"yfpDm": "",
	"yfpHm": "",
    "invoiceExt": {
      "bdcdz": "不动产地址",
      "zlqq": "租赁期起日期 例:2022-11-18",
      "zlqz": "租赁期止日期 例:2023-11-18",
      "kdsbz": "跨地(市)标志 Y:是 N:否",
      "tdzzsxmbh": "土地增值税项目编号"
    },
    "tspz": "特殊票种-建筑服务:E03、不动产经营租赁:E06、货物运输服务发票:E04",
    "tspzs": [{
        "ysgjzl": "运输工具种类",
        "ysgjph": "运输工具牌号",
        "yshwmc": "运输货物名称",
        "qyd": "起运地",
        "ddd": "到达地"
    }],
	"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": "二手车-卖方单位代码/身份证号",
            "jzfwfsd": "建筑服务发生地",
            "jzxmmc": "建筑项目名称",
            "cqzsbh": "产权证书/不动产权证号"
		}
	}]
}
参数 类型 长度 是否必填 默认值 描述 说明
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 附件路径
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 二手车市场电话
jzfwfsd String 150 建筑服务发生地
jzxmmc String 100 建筑项目名称
cqzsbh String 50 产权证书/不动产权证号
tspz String 3 特殊票种-建筑服务:E03、不动产经营租赁:E06、货物运输服务发票:E04
qyd String 60 起运地
ddd String 240 到达地
ysgjzl String 80 运输工具种类
ysgjph String 40 运输工具牌号
yshwmc String 80 运输货物名称
bdcdz String 310 不动产地址
zlqq String 50 租赁期起日期 例:2022-11-18
zlqz String 50 租赁期止日期 例:2022-11-18
kdsbz String 1 跨地(市)标志 Y:是 N:否
tdzzsxmbh String 20 土地增值税项目编号

# 航空电子行程单

{
    "id" : "1111",
    "date": "20181020",
    "fare": 2000.00,
    "agentCode": "HKK068,08688003",
  	"filePath": "https://**/6159252dd42a2834d7a36c905ab5c9ea15cebf20.jpg",    
    "issueBy": "成都携程旅行社有限公司北京分社",
    "kind": "交通",
    "userName": "王珊珊",
    "userId": "371102198004020527",
    "caacDevelopFund": 50.00,
    "checkCode": "9668",
    "totalAmount": 2080.00,
    "ticketNum": "8802175000276",
	"uniqueCode":"88021750002769668",
	"airType":"1",
	"receiptNumber":"",
    "itemList": [{
        "id" : "11111",
        "airId" : "1111",
        "date": "20181019",
        "seat": "Y",
        "carrier": "海航",
        "from": "杭州",
        "time": "19:00",
        "to": "北京",
        "flightNumber": "HU7678"
    }],
    "fuelSurcharge": 30.00
}
编码 名称 类型 摘要字段 说明
id 行程单主键 Long billId
date 填开日期 String date yyyyMMdd
ticketNum 电子客票号码 String invoiceNum
uniqueCode 航空行程单唯一码 String
airType 航空行程单类型 String 1:普通航空行程单,tickectNum必传,uniqueCode=ticketNum+checkCode 2:电子行程单,receiptNumber必传,uniqueCode=receiptNumber
receiptNumber 行程单号码 String
checkCode 验证码 String
agentCode 销售单位代码 String
issueBy 填开单位 String sellerName
fare 票夹 BigDecimal
tax 税费 BigDecimal
fuelSurcharge 燃油附加费 BigDeciaml
caacDevelopFund 民航发展基金 BigDecimal
insurance 保险费 BigDecimal
totalAmount 总金额 BigDecimal amount
userName 乘机人姓名 String
userId 身份证号 String
purchaserStatus 报销状态 Int purchaserStatus 详见报销状态
kind 消费类型 String kind
feeWithoutTax 金额(不含税) BigDecimal
taxAmount 税额 BigDecimal
itemList 行程单明细 Array
id 行程单明细ID Long
airId 行程单主表ID Long
from 出发 String
to 到达 String
flightNumber 航班号 String
carrier 承运人 String
seat 仓位 String
date 乘机日期 String yyyyMMdd
time 乘机时间 String HH:mm
filePath 附件路径 String

# 火车票

{
    "id" : "1111",
    "date": "20181030",
    "kind": "交通",
    "origin": "北京南",
    "destination": "上海虹桥",
    "number": "P026491",
    "totalAmount": 553.00,
    "trainNum": "G9",
  	"filePath": "https://**/6159252dd42a2834d7a36c905ab5c9ea15cebf20.jpg",    
    "name": "王珊珊",
    "time": "12:00",
    "seatNo": "二等座"
}
编码 名称 类型 摘要字段 说明
id 火车票主键 Long billId
number 号码 String invoiceNum
date 日期 String date yyyyMMdd
time 时间 String HH:mm
trainNum 车次 String trainNum
origin 始发站 String origin
destination 终点站 String destination
level 坐席 String
seatNo 座位号 String
name 姓名 String
totalAmount 金额 BigDecimal amount
feeWithoutTax 金额(不含税) BigDecimal
taxAmount 税额 BigDecimal
purchaserStatus 报销状态 int purchaserStatus 详见报销状态
kind 消费类型 String kind
filePath 附件路径 String

# 出租车

{
    "id" : "1111",
    "date": "20120916",
    "kind": "交通",
    "invoiceCode": "211001111012",
    "invoiceNum": "87650531",
    "totalAmount": 451.00,
    "startTime": "21:22",
    "endTime": "22:01",
  	"filePath": "https://**/6159252dd42a2834d7a36c905ab5c9ea15cebf20.jpg",    
    "place": "北京市",
    "mileage": 153.8
}
编码 名称 类型 摘要字段 说明
id 出租车票ID Long billId
date 开票日期 String date yyyyMMdd
invoiceCode 发票代码 String invoiceCode
invoiceNum 发票名称 String invoiceNum
carNum 车牌号 String carNum
mileage 里程 BigDecimal
startTime 上车时间 String
endTime 下车时间 String
totalAmount 金额 BigDecimal
purchaserStatus 报销状态 Int purchaserStatus 详见报销状态
place 发票所在地 String
kind 消费类型 String kind
filePath 附件路径 String

# 定额发票

{
    "id" : "1111",
    "totalAmount": 10.00,
    "kind": "交通",
  	"filePath": "https://**/6159252dd42a2834d7a36c905ab5c9ea15cebf20.jpg",    
    "invoiceCode": "15101185D001",
    "invoiceNum": "01509840"
}
编码 名称 类型 摘要字段 说明
id 定额发票ID Long billId
invoiceCode 发票代码 String invoiceCode
invoiceNum 发票号码 String invoiceNum
totalAmount 金额 BigDecimal amount
purchaserStatus 报销状态 Int purchaserStatus 详见报销状态
kind 消费类型 String kind
productName 商品项目名称 String
filePath 附件路径 String

# 过路费

{
    "id" : "1111",
    "date": "20180711",
    "exit": "兰亭",
    "totalAmount": 15.00,
    "kind": "交通",
    "time": "12:05:22",
    "entrance": "诸暨浣东",
  	"filePath": "https://**/6159252dd42a2834d7a36c905ab5c9ea15cebf20.jpg",    
    "invoiceCode": "133061801021",
    "invoiceNum": "01545541"
}
编码 名称 类型 摘要字段 说明
id 过路费ID Long billId
invoiceCode 发票代码 String invoiceCode
invoiceNum 发票号码 String invoiceNum
date 日期 String date yyyyMMdd
time 时间 String
entrance 入口 String
exit 出口 String
totalAmount 金额 BigDecimal amount
purchaserStatus 报销状态 Int purchaserStatus 详见报销状态
kind 消费类型 String kind
filePath 附件路径 String

# 客运汽车票

{
    "id" : "1111",
    "date": "20120929",
    "kind": "交通",
    "invoiceCode": "244011219112",
    "invoiceNum": "26755417",
    "exit": "隆同",
    "totalAmount": 255.00,
    "name": "楼号",
  	"filePath": "https://**/6159252dd42a2834d7a36c905ab5c9ea15cebf20.jpg",    
    "time": "16:20",
    "entrance": "广州"
}
编码 名称 类型 摘要字段 说明
id 客运汽车票ID Long billId
invoiceCode 发票代码 String invoiceCode
invoiceNum 发票号码 String invoiceNum
date 日期 String date yyyyMMdd
time 时间 String
entrance 入口 String
exit 出口 String destination
name 姓名 String
totalAmount 金额 BigDecimal amount
purchaserStatus 报销状态 Int purchaserStatus 详见报销状态
kind 消费类型 String kind
feeWithoutTax 合计金额(不含税) BigDecimal
taxAmount 税额 BigDecimal
filePath 附件路径 String

# 财政非税票据

{
	"busiType": 66,
	"checker": "贾晴",
	"handlingPerson": "李文静",
	"invoiceCode": "13061121",
	"invoiceNum": "0000678848",
	"invoicingPartyName": "易县妇幼保健院",
	"issueDate": "2021-05-07",
	"payerPartyCode": "130633199309011067",
	"payerPartyName": "路超",
	"randomNumber": "547703",
	"recName": "易县妇幼保健院",
	"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
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

#

# 枚举定义

# 票种类型

code value 描述 备注
invoice 1 增值税发票
tolls 6 过路费
train 3 火车票
quota 5 定额发票
machine 4 机打发票
taxi 2 出租车发票
passenger 7 客运发票
air 8 航空电子行程单
other 9 其他发票
nontax 12 财政非税票据 票据,非发票,发票场景不需考虑

# 报销状态

code 描述 备注
-1 未设值
30 未收票
33 待提交
34 已归集
35 未报销
36 报销中
37 未记账
39 已报销
42 已记账

# 发票类型

code 描述 备注
1 增值税电子普通发票
2 增值税电子专用发票
3 增值税普通发票
4 增值税专用发票
5 机动车销售统一发票
6 货物运输业增值税专用发票
8 增值税电子普通发票(成品油)
9 成品油普通发票(卷式)
10 增值税普通发票(成品油)
11 增值税专用发票(成品油)
12 增值税普通发票(卷式)
14 通行费增值税电子普通发票

# 征税方式

code 描述 备注
0 普通征税
2 差额征税

# 零税率标识

code 描述 备注
非零税率
0 出口退税
1 免税
2 不征收
3 普通零税率

# 状态码

状态码 说明
0000 操作成功
1001 数据不合法,传入参数
1002 数据不存在
3001 发票已经报销
3002 发票解析出错
3003 发票查验不合法
3004 发票状态不正确
9999 未知错误
Last Updated: 2/26/2024, 2:50:25 PM