# 报销台账非全票种

# 文档说明

# 查验并缓存

允许同一发票反复查验。

# 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 未知错误
Last Updated: 12/4/2023, 10:37:09 AM