# 报销台账非全票种
# 文档说明
- 不能全面支持全票种,如需全票种,请移步 进项-报销台账全票种
# 查验并缓存
允许同一发票反复查验。
# URL
POST
``http://{HOST}:{PORT}/invoiceclient-web/api/reimburseCollection/ncc/verify_and_save?appid=XXXXX`
# 请头说明
参数 | 类型 | 是否必填 | 说明 |
---|---|---|---|
sign | String | 是 | 请求签名信息 |
# 请求体
{
"orgCode":"",
"nsrsbh":"",
"submitter":"提交人",
"invoices":[
{
"fpDm" : "1100154320",
"fpHm" : "25045336",
"kprq" : "20161010",
"hjje" : 100.00,
"jshj" : 106.00,
"jym" : "10221376566424011310",
"srcBillType" : "来源业务系统",
"srcBillCode" : "业务系统单据号",
"imageId": "1561601012319150080",
"srcapp":""
},
{
"fpDm" : "1100154320",
"fpHm" : "25045336",
"kprq" : "20161010",
"hjje" : 100.00,
"jshj" : 106.00,
"jym" : "10221376566424011310",
"srcBillType" : "来源业务系统",
"srcBillCode" : "业务系统单据号",
"imageId": "1561601012319150080",
"srcapp":""
}
]
}
# 请求体说明
参数 | 类型 | 长度值 | 是否必填 | 默认值 | 描述 | 说明 |
---|---|---|---|---|---|---|
orgCode | String | 是 | 组织编码 | |||
nsrsbh | String | 是 | 纳税人识别号 | |||
submitter | String | 是 | 提交人 | |||
fpDm | String | 否 | 发票代码 | 有发票代码必填 | ||
fpHm | String | 是 | 发票号码 | |||
kprq | String | 是 | 开票日期 | |||
hjje | Double | 是 | 合计金额 | |||
jshj | Double | 否 | 价税合计 | 全电发票必填 | ||
jym | String | 否 | 校验码 | 有校验码时必填 | ||
srcapp | String | 否 | 来源应用 | |||
srcBillType | String | 否 | 来源业务系统 | |||
srcBillCode | String | 否 | 业务系统单据号 | |||
imageId | String | 否 | OCR识别返回的imageId |
# 返回值
{
"code": "0000",
"msg": "操作成功",
"datas": [
{
"code": "3001",
"msg": "发票已经存在,发票代码:330xxxx,发票号码:100xxx的状态为报销中!",
"fpDm": "330xxxx",
"fpHm": "100xxx",
"saveToken": "xxxx1",
"invoice": {
"bz": "备注",
"fhr": null,
"fpDm": "330xxxx",
"fpHm": "100xxx",
"fpMw": null,
"fplx": "4",
"fpjz": "1",
"zfbz": "N",
"gmfDzdh": "北京 11xxx",
"gmfMc": "购买方名称",
"gmfNsrsbh": "11xxx",
"gmfYhzh": "中国工商银行11xxx",
"hjje": 1419273.96,
"hjse": 241276.57,
"jqbh": "6615xxxxx",
"jshj": 1660550.53,
"jym": "5277xxxxx",
"kpr": null,
"kprq": "20171026",
"skr": null,
"xsfDzdh": "浙江 11111",
"xsfMc": "浙江",
"xsfNsrsbh": "12345",
"xsfYhzh": "工商银行40002993",
"submitter": "提交人",
"hasExist": false,
"items": [
{
"dw": "千瓦时",
"ggxh": "",
"se": 241276.57,
"sl": 17,
"xmdj": 0.755811788209566,
"xmje": 1419273.96,
"xmmc": "电力",
"xmsl": 1877814,
"xmjshj": null
}
]
}
},
{
"code": "0000",
"msg": "操作成功",
"fpDm": "330xxxx",
"fpHm": "104xxx",
"saveToken": "xxxx2",
"invoice": {
"bz": "",
"fhr": null,
"fpDm": "330xxxx",
"fpHm": "104xxx",
"fpMw": null,
"fplx": "3",
"fpjz": "1",
"zfbz": "N",
"gmfDzdh": "北京 11xxx",
"gmfMc": "购买方名称",
"gmfNsrsbh": "11xxx",
"gmfYhzh": "中国工商银行11xxx",
"hjje": 1419273.96,
"hjse": 241276.57,
"jqbh": "6615xxxxx",
"jshj": 1660550.53,
"jym": "5277xxxxx",
"kpr": null,
"kprq": "20171026",
"skr": null,
"xsfDzdh": "浙江 11111",
"xsfMc": "浙江",
"xsfNsrsbh": "12345",
"xsfYhzh": "工商银行40002993",
"submitter": "提交人",
"items": [
{
"dw": "千瓦时",
"ggxh": "",
"se": 241276.57,
"sl": 17,
"xmdj": 0.755811788209566,
"xmje": 1419273.96,
"xmmc": "电力",
"xmsl": 1877814,
"xmjshj": null
}
]
}
}
]
}
# 返回值说明
参数 | 类型 | 描述 | 说明 |
---|---|---|---|
code | String | 状态码 | |
msg | String | 状态说明 | |
fpDm | String | 发票代码 | |
fpHm | String | 发票号码 | |
fplx | String | 发票类型 | 1:增值税电子普通发票;3:增值税普通发票;4:增值税专用发票 |
fpjz | String | 发票介质 | 0:电子发票1:纸质发票 |
fhr | String | 复核人 | |
xsfMc | String | 销售方名称 | |
xsfNsrsbh | String | 销售方纳税人识别号 | |
xsfYhzh | String | 销售方银行账号 | |
xsfDzdh | String | 销售方地址电话 | |
gmfMc | String | 购买方名称 | |
gmfNsrsbh | String | 购买方纳税人识别号 | |
gmfDzdh | String | 购买方地址电话 | |
gmfYhzh | String | 购买方银行账号 | |
jym | String | 发票校验码 | |
jqbh | String | 机器编号 | |
hjse | double | 合计税额 | |
jshj | double | 价税合计 | |
hjje | double | 合计金额 | |
zfbz | String | 作废标志 | Y:已作废;N:未作废 |
bz | String | 备注 | |
xmmc | String | 项目名称 | |
ggxh | String | 规格型号 | |
dw | String | 计量单位 | |
xmsl | double | 项目数量 | |
xmdj | double | 项目单价 | |
xmje | double | 项目金额 | |
xmjshj | double | 项目价税合计 | |
sl | double | 项目税率 | |
se | double | 项目税额 | |
saveToken | String | 保存token | 发票保存token;1张发票对应1个saveToken。此token有效期为10分钟,超过时长此token失效,需要重新查验。token只能使用一次。 |
# 从缓存提交保存到报销台账
# URL
POST
``http://{HOST}:{PORT}/invoiceclient-web/api/reimburseCollection/ncc/submit?appid=XXXXX`
# 请头说明
参数 | 类型 | 是否必填 | 说明 |
---|---|---|---|
sign | String | 是 | 请求签名信息 |
# 请求体
{
"orgCode":"",
"nsrsbh":"",
"submitter":"提交人",
"invoices":[
{
"fpDm" : "1100154320",
"fpHm" : "25045336",
"saveToken": "xxx1",
"srcBillType" : "来源业务系统",
"srcBillCode" : "业务系统单据号",
"srcapp":""
},
{
"fpDm" : "1100154320",
"fpHm" : "25045336",
"saveToken": "xxx2",
"srcBillType" : "来源业务系统",
"srcBillCode" : "业务系统单据号",
"srcapp":""
}
]
}
# 请求体说明
参数 | 类型 | 长度值 | 是否必填 | 默认值 | 描述 |
---|---|---|---|---|---|
orgCode | String | 50 | 是 | 组织编码 | |
nsrsbh | String | 20 | 是 | 纳税人识别号 | |
submitter | String | 20 | 是 | 提交人 | |
fpDm | String | 12 | 是 | 发票代码 | |
fpHm | String | 8 | 是 | 发票号码 | |
srcapp | String | 20 | 否 | 来源应用 | |
srcBillType | String | 10 | 否 | 来源业务系统 | |
srcBillCode | String | 30 | 否 | 业务系统单据号 | |
saveToken | String | 由税务云接口返回确定 | 是 | 发票保存token |
# 返回值
{
"code": "0000",
"msg": "操作成功",
"datas": [
{
"code": "3001",
"msg": "发票已经存在,发票代码:330xxxx,发票号码:100xxx的状态为报销中!",
"fpDm": "330xxxx",
"fpHm": "100xxx",
"saveToken": "xxxx1"
},
{
"code": "0000",
"msg": "操作成功",
"fpDm": "330xxxx",
"fpHm": "104xxx",
"saveToken": "xxxx2"
}
]
}
# 返回值说明
参数 | 类型 | 描述 | 说明 |
---|---|---|---|
code | String | 状态码 | 详见状态码说明 |
msg | String | 信息说明 |
# 报销台账发票上传返回全票面信息(PDF)
支持pdf、ofd格式增值税发票,pdf格式通用电子发票到机打发票 (状态变更为报销中)
推荐改用全票种下面的“源文件上传进项业务台账”(api/busi-collection/uploadpdf)接口
# URL
POST
http://{IP}:{PORT}/invoiceclient-web/api/reimburseCollection/v4/uploadpdf?appid=XXXXX
# 请求头说明
参数 | 类型 | 是否必填 | 描述 |
---|---|---|---|
sign | String | 是 | 请求签名信息 |
# 请求体
{
"usercode" : "XXXXXX",
"useremail" : "yy@yy.com",
"usermobile" : "13311111111",
"nsrsbh":"101011111111111",
"orgcode":"321",
"defaultOrgMode":"0",
"pdfFiles" : [
{
"srcBillType" : "来源业务系统",
"srcBillCode" : "业务系统单据号",
"fileName" : "通信费1.pdf",
"content" : "XXXXXXXXXXXXXXXXXXX1",
"classification":"通讯"
},
{
"srcBillType" : "来源业务系统",
"srcBillCode" : "业务系统单据号",
"fileName" : "通信费2.pdf",
"content" : "XXXXXXXXXXXXXXXXXXX2",
"classification":"通讯"
}
]
}
# 请求体说明
参数 | 类型 | 长度 | 是否必填 | 默认值 | 描述 | 说明 |
---|---|---|---|---|---|---|
usercode | String | 64 | 是 | 用户账号 | ||
useremail | String | 100 | 否 | 用户邮箱 | ||
usermobile | String | 20 | 否 | 用户手机号 | ||
fileName | String | 255 | 是 | 发票文件名 | ||
content | String | 不限 | 是 | 对应发票文件 | 通过Base64编码字节流,转换为字符串 | |
classification | String | 20 | 否 | 发票分类 | 设置发票分类(只支持增值税发票),为空自动解析;目前支持:”交通”,”餐饮”,”通讯”,”其他”; | |
nsrsbh | String | 20 | 否 | 纳税人识别号 | 受票企业纳税人识别号;(纳税人识别号与组织编码至少传入一项) 或 (默认组织模式设置为启用) | |
orgcode | String | 50 | 否 | 组织编码 | 受票方企业在发票平台的组织编码(纳税人识别号与组织编码至少传入一项) 或 (默认组织模式设置为启用) | |
defaultOrgMode | String | 1 | 否 | 0 | 默认组织模式 | 0:不开启默认组织模式 1:开启默认组织模式 (纳税人识别号与组织编码至少传入一项) 与 (默认组织模式设置为启用) 同时满足则取 (默认组织) |
srcBillType | String | 10 | 否 | 来源业务系统 | ||
srcBillCode | String | 30 | 否 | 业务系统单据号 |
# 返回值
{
"code": "0000",
"datas": [
{
"billType": "machine",
"fileName": "通信费1.pdf",
"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",
"fileName": "通信费2.pdf",
"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": "销售方银行账号"
}
}
],
"msg": "SUCCESS"
}
# 返回值说明
参数 | 类型 | 描述 | 说明 |
---|---|---|---|
code | String | 状态码 | 0000-操作成功;详见状态码说明 |
msg | String | 信息说明 | |
fileName | String | 文件名 | |
billType | String | 票种 | machine:机打发票 invoice:增值税发票 |
invoice | String | 票面信息 | 详见 各票种json示例 |
# 纸票查验进报销台账
# URL
POST http://{IP}:{PORT}/invoiceclient-web/api/reimburseCollection/verify_and_submit?appid=XXXXX
####请头说明
参数 | 类型 | 是否必填 | 说明 |
---|---|---|---|
sign | String | 是 | 请求签名信息 |
###请求体
{
"orgCode":"",
"nsrsbh":"",
"submitter":"提交人",
"taxRateExchange":1,
"invoices": [
{
"fpDm" : "1100154320",
"fpHm" : "25045336",
"kprq" : "20161010",
"hjje" : 100.00,
"jshj" : 106.00,
"jym" : "10221376566424011310",
"srcBillType" : "来源业务系统",
"srcBillCode" : "业务系统单据号",
"srcapp":"",
"imageId":""
},
{
"fpDm" : "1100154320",
"fpHm" : "25045336",
"kprq" : "20161010",
"hjje" : 100.00,
"jshj" : 106.00,
"jym" : "10221376566424011310",
"srcBillType" : "来源业务系统",
"srcBillCode" : "业务系统单据号",
"srcapp":"",
"imageId":""
}
]
}
# 请求体说明
参数 | 类型 | 长度值 | 是否必填 | 默认值 | 描述 | 说明 |
---|---|---|---|---|---|---|
orgCode | String | 50 | 是 | 组织编码 | ||
nsrsbh | String | 20 | 是 | 纳税人识别号 | ||
submitter | String | 20 | 是 | 提交人 | ||
taxRateExchange | Integer | 1 | 否 | 0 | 是否转换税率为小数 | 0-不转换 1-转换 |
fpDm | String | 12 | 否 | 发票代码 | 有发票代码时必填 | |
fpHm | String | 8 | 是 | 发票号码 | ||
kprq | String | 是 | 开票日期 | yyyyMMdd | ||
hjje | Double | 15,2 | 是 | 合计金额 | ||
jshj | Double | 15,2 | 否 | 价税合计 | 全电发票必填 | |
jym | String | 20 | 否 | 校验码 | 有校验码时必填 | |
srcapp | String | 20 | 否 | 来源应用 | ||
srcBillType | String | 10 | 否 | 来源业务系统 | ||
srcBillCode | String | 30 | 否 | 业务系统单据号 | ||
imageId | String | 由税务云接口返回确定 | 否 | ocr识别后返回的imageId | ||
numberConfirm | String | 否 | 纸质发票打印的发票号码 | 此值从ocr接口返回,取ocr返回结果,如果人工校正,传校正后的值。 |
# 返回值
{
"code": "0000",
"msg": "操作成功",
"datas": [
{
"code": "3001",
"msg": "发票已经存在,发票代码:330xxxx,发票号码:100xxx的状态为报销中!",
"fpDm": "330xxxx",
"fpHm": "100xxx",
"invoice": {
"bz": "备注",
"fhr": null,
"fpDm": "330xxxx",
"fpHm": "100xxx",
"fpMw": null,
"fplx": "4",
"fpjz": "1",
"zfbz": "N",
"gmfDzdh": "北京 11xxx",
"gmfMc": "购买方名称",
"gmfNsrsbh": "11xxx",
"gmfYhzh": "中国工商银行11xxx",
"hjje": 1419273.96,
"hjse": 241276.57,
"jqbh": "6615xxxxx",
"jshj": 1660550.53,
"jym": "5277xxxxx",
"kpr": null,
"kprq": "20171026",
"skr": null,
"xsfDzdh": "浙江 11111",
"xsfMc": "浙江",
"xsfNsrsbh": "12345",
"xsfYhzh": "工商银行40002993",
"submitter": "提交人",
"hasExist": false,
"items": [
{
"dw": "千瓦时",
"ggxh": "",
"se": 241276.57,
"sl": 17,
"xmdj": 0.755811788209566,
"xmje": 1419273.96,
"xmmc": "电力",
"xmsl": 1877814,
"xmjshj": null
}
]
}
},
{
"code": "0000",
"msg": "操作成功",
"fpDm": "330xxxx",
"fpHm": "104xxx",
"invoice": {
"bz": "",
"fhr": null,
"fpDm": "330xxxx",
"fpHm": "104xxx",
"fpMw": null,
"fplx": "3",
"fpjz": "1",
"zfbz": "N",
"gmfDzdh": "北京 11xxx",
"gmfMc": "购买方名称",
"gmfNsrsbh": "11xxx",
"gmfYhzh": "中国工商银行11xxx",
"hjje": 1419273.96,
"hjse": 241276.57,
"jqbh": "6615xxxxx",
"jshj": 1660550.53,
"jym": "5277xxxxx",
"kpr": null,
"kprq": "20171026",
"skr": null,
"xsfDzdh": "浙江 11111",
"xsfMc": "浙江",
"xsfNsrsbh": "12345",
"xsfYhzh": "工商银行40002993",
"submitter": "提交人",
"items": [
{
"dw": "千瓦时",
"ggxh": "",
"se": 241276.57,
"sl": 17,
"xmdj": 0.755811788209566,
"xmje": 1419273.96,
"xmmc": "电力",
"xmsl": 1877814,
"xmjshj": null
}
]
}
}
]
}
###返回值说明
参数 | 类型 | 描述 | 说明 |
---|---|---|---|
code | String | 状态码 | |
msg | String | 状态说明 | |
fpDm | String | 发票代码 | |
fpHm | String | 发票号码 | |
fplx | String | 发票类型 | 1:增值税电子普通发票;3:增值税普通发票;4:增值税专用发票 |
fpjz | String | 发票介质 | 0:电子发票1:纸质发票 |
fhr | String | 复核人 | |
xsfMc | String | 销售方名称 | |
xsfNsrsbh | String | 销售方纳税人识别号 | |
xsfYhzh | String | 销售方银行账号 | |
xsfDzdh | String | 销售方地址电话 | |
gmfMc | String | 购买方名称 | |
gmfNsrsbh | String | 购买方纳税人识别号 | |
gmfDzdh | String | 购买方地址电话 | |
gmfYhzh | String | 购买方银行账号 | |
jym | String | 发票校验码 | |
jqbh | String | 机器编号 | |
hjse | double | 合计税额 | |
jshj | double | 价税合计 | |
hjje | double | 合计金额 | |
zfbz | String | 作废标志 | Y:已作废;N:未作废 |
bz | String | 备注 | |
xmmc | String | 项目名称 | |
ggxh | String | 规格型号 | |
dw | String | 计量单位 | |
xmsl | double | 项目数量 | |
xmdj | double | 项目单价 | |
xmje | double | 项目金额 | |
xmjshj | double | 项目价税合计 | |
sl | double | 项目税率 | |
se | double | 项目税额 |
##附录
###状态码
状态码 | 说明 |
---|---|
0000 | 操作成功 |
1001 | 数据不合法,传入参数 |
1002 | 数据不存在 |
3002 | 发票解析出错 |
3003 | 发票查验不合法 |
3004 | 发票状态不正确 |
4001 | 发票已经上传,不能重复上传 |
9999 | 未知错误 |
# 不需要查验进入台账
客户从第三方系统获得增值税发票全票面信息,不需要通过税务云再次查验获得全票面信息,直接通过接口传入台账
# URL
POST
http://{HOST}:{PORT}/input-tax/api/reimburseCollection/direct-save?appid=XXXXX
# 请求头说明
参数 | 类型 | 是否必填 | 描述 |
---|---|---|---|
sign | String | 是 | 请求签名信息 |
# 请求体
{
"nsrsbh": "914100002aaa685704",
"orgCode": "ceshishanchu",
"submitter": "8888",
"invoices": [
{
"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": "产权证书/不动产权证号"
}
}
]
}
]
}
# 请求体说明
参数 | 类型 | 长度 | 是否必填 | 默认值 | 描述 | 说明 |
---|---|---|---|---|---|---|
nsrsbh | String | 20 | 是 | 纳税人识别号 | 受票企业纳税人识别号;纳税人识别号与组织编码至少传入一项 | |
orgCode | String | 20 | 否 | 组织编码 | 受票方企业在发票平台的组织编码纳税人识别号与组织编码至少传入一项 | |
submitter | String | 50 | 否 | 提交人 | ||
srcBillType | String | 10 | 否 | 来源单据类型 | ||
srcBillCode | String | 30 | 否 | 来源单据号 | ||
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没有 |
# 返回值
失败
{
"code": "9999",
"msg": "[{\"code\":\"9999\",\"fpDm\":\"1234567890\",\"fpHm\":\"99965679\",\"msg\":\"发票代码:1234567890,发票号码:99965679 已存在于疑票管理中。\"},{\"code\":\"9999\",\"fpDm\":\"1234567890\",\"fpHm\":\"99975679\",\"msg\":\"发票已存在于报销台账。发票代码:1234567890,发票号码:99975679,状态为报销中。\"}]"
}
成功
{
"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 | 成功发票信息 | |
# 状态码
状态码 | 说明 |
---|---|
0000 | 操作成功 |
1001 | 数据不合法,传入参数 |
1002 | 数据不存在 |
3001 | 发票已经报销 |
3002 | 发票解析出错 |
3003 | 发票查验不合法 |
3004 | 发票状态不正确 |
9999 | 未知错误 |