# 报销台账(全票种)
# 对接流程
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 | 单位 |
# 完税证明
编码 | 名称 | 类型 | 说明 |
---|---|---|---|
title | 发票标题 | String | |
kprq | 填发日期 | String | yyyyMMdd格式 |
invoiceCode | 发票代码 | String | |
invoiceNum | 发票号码 | String | |
totalAmount | 合计金额 | BigDecimal | |
gmfMc | 纳税人名称 | String | |
gmfNsrsbh | 纳税人识别号 | String | |
taxAuthorities | 税务机关 | String | |
qrCode | 二维码 | String | 票面上的二维码信息 |
currencyType | 币种 | String | CNY、USD、GBP、EUR、JPY |
billType | 票据类型 | String | |
bz | 备注 | String | |
items | 明细行信息 | Array | |
originalNumber | 原凭证号 | String | |
taxType | 税种 | String | |
name | 品目名称 | String | |
taxPeriod | 税款所属时期 | String | |
entryDate | 入(退)库日期 | String | yyyyMMdd格式 |
actualPaidAmount | 实(退)缴金额 | BigDecimal |
#
# 全票种不查验进台账
# 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 | 财政非税票据 | 票据,非发票,发票场景不需考虑 |
custbook | 海关缴款书 | ||
tax_payment_proof | 完税证明 |
# 报销状态
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 | 未知错误 |