发票查验接口文档V1 3深圳航信

深深圳圳航航信信发发票票查查验验 接接口口规规范范 V1.3 （版本：1.3） （保密文件） 深深 圳圳 航航 天天 信信 息息 有有 限限 公公 司司 201 8 年年 03 月月 版本号更改日期更改方法/内容/原因编制审核批准 V1.02018-03-06 发票查验接口贺家源邓常识李频 V1.12018-03-15 批量查验接口刘烨邓常识李频 V1.22018-03-27 更新 OCR 查验接口刘烨邓常识李频 V1.32018-05-25 增加 key，https 协议刘烨 第 1 章 概述 1.1 目的 本文档旨在编写一个面向开发者的完整的接口规范， 供需要调用航天信息发票查验功能 的开发者使用；本文档不包括具体的实现细节。 1.2 适用范围 本文档适用阅读人员包括： 发票查验功能的设计、开发人员，公司内部合作部门成员。 本文档的接口也仅限于公司内部应用使用。 1.3 支持种类 目前支持： 0：专用发票 2：普通发票 11：货运发票 12：机动车票 51：电子发票 第 2 章 接口说明 文中出现的请求参数 key 通过我司获取。 2.1 单张发票查询 接口请求说明：HTTPS 请求方式：POST 内部测试人员调用格式： 42:8176/fpcy/service 查询规则： 发票代码、发票号码、开票日期不能为空； （1）当发票为纸质专用发票时：不含税金额不为空； （2）当发票为纸质普通发票时：校验码后 6 位不为空； （3）当发票为电子普通发票时：校验码后 6 位不为空； （4）当发票为机动车销售统一发票时：不含税金额不为空。 调用格式 “fpdm”:”发票代码” , “fphm”:”发票号码”, “kprq”:”开票日期”, “jym”:”校验码”, “kpje”:”开票金额”, “qysh”:”企业税号”, “key”:”授权的 key” 参数描述： 参数是否必须描述 fpdm是发票代码 fphm是发票号码 kprq是开票日期 jym校验码后六位，如普票则必填 kpje不含税金额，如非普票则必填（必须 保留两位小数。如 0.90；80.00） qysh是授权企业税号 key是授权企业 key 返回结果： 发票主体信息:invoices 发票明细信息： 专普票invoiceMxList机动车发票此项为“” 机动车票 invoiceBike专普票此项为“” 返回的数据结构为 json 类型, 专票或普票数据格式如下: invoice: fphm: 06765385,/发票代码 fpdm: 3400163130,/发票号码 kprq: 2017-09-15,/开票日期 fpje: 2366.04,/发票不含税金额 fpse: 141.96,/发票含税金额 jshj:2508.00,/价税合计 gfmc: 华为技术服务有限公司,/购方名称 gfsh: 911310016636709451,/购方税号 gfdzdh: 廊坊*街*号 0316-*,/购方地址电话 gfyhzh: 中国*银行*支行 0410*878,/购方银行账户 xfyhzh: 中国*银行*支行 1312*163,/销方银行账户 xfdzdh: 安徽省*号 0557-*,/销方地址电话 xfmc: 宿州市*有限公司,/销方名称 xfsh: 91341302557848017K,/销方税号 bz: ,/备注 retCode: , retMsg: , invoiceBike: ,/机动车发票信息 invoiceMxList: id: 10000815319, dj: 215.0943396226415,/单价 sl: 11,/数量 je: 2366.04,/不含税金额 se: 141.96,/税额 slv: 0.06,/税率 jldw:,/单位 ggxh:,/规格型号 spmc: 住宿费,/商品名称 zbid: 10000098581 , fpzl: 2,/发票种类 zfbz:N/作废标志，Y 为作废发票，N 为未作废发票 ,/专普票明细数据清单数据类型为 list 类型 code: 1,/状态码,详细状态码见附录 msg: 查验成功/ msg 为查验结束返回的信息见附录 auth_count: 0/剩余可以查询的授权数量 返回数据结构为 json 格式, 机动车发票数据格式如下 （主要对机动车发票中的 invoiceBike 进行 说明）: invoice: fphm: 00694666, fpdm: 144031624160, kprq: 2017-09-06, fpje: 449346.15, fpse: 76388.85, jshj: 525735.00, gfmc: 上海华为技术有限公司, gfsh: 91310000703099764Y, gfdzdh: , gfyhzh: , xfyhzh: , xfdzdh: , xfmc: 深圳市深业丰田汽车销售服务有限公司, xfsh: , bz: , retCode: , retMsg: , invoiceBike: id: 10000430238, zgswjg: 深圳市南山区国家税务局税源管理九科, cd: 成都,/产地 sjdh: /,/商检单号 clsbh: LFMG1E729HS023936,/车辆识别号 jkzmsh: /,/进口证明书号 xhdwdh:/销货单位电话 slv: 0.17,/税率 fdjhm: N023948,/发动机号码 cpxh: 丰田牌 SCT6484GR7,/车票型号 khyh: 汇丰银行（中国）有限公司深圳分行,/开户银行 dz: 深圳市南山区*街道 88 号,/地址 jqbm: 661710896962,/机器编码 gfzzjgdm: 622166304011,/购方组织机构代码 xfyhzh: 622166304011,/消防银行账户 zgswjgdm:/主管税务机关代码 cllx: 多用途乘用车/车辆类型 , invoiceMxList: , fpzl: 12, zfbz: , code: 1, msg: 查验成功 auth_count: 0/剩余可以查询的授权数量 2.2 批量发票查询 接口请求说明：HTTPS 请求方式：POST 内部测试人员调用格式： 42:8176/fpcy/multiservice 查询规则： 发票代码、发票号码、开票日期不能为空； （1）当发票为纸质专用发票时：不含税金额不为空； （2）当发票为纸质普通发票时：校验码后 6 位不为空； （3）当发票为电子普通发票时：校验码后 6 位不为空； （4）当发票为机动车销售统一发票时：不含税金额不为空。 （5）每次查询数不能超过 100 张。 调用格式 invoiceQueryList: fpdm: 031001700111, fphm: 23965920, jym: 497861, kpje: 9433.96, kprq: 20171022 , fpdm: 4403172130, fphm: 07485795, jym: , kpje: 92761.64, kprq: 20170913 , qysh: 9144030032629079XF, “key”:”1231241251235” 返回格式： code: 1, msg: 查询成功，成功 2 张, 失败 0 张, suc_count: 2,/成功数量 err_count: 0,/没查询成功数量 auth_count: 1,/剩余可以查询的授权数量 invoiceInfo: invoice: fphm: 46165993, fpdm: 4403172130, kprq: 20171228, fpje: 9433.96, fpse: 566.04, jshj: 10000.00, gfmc: 阜新双橡工矿橡塑制品有限公司, gfsh: 91210904771427029U, gfdzdh: 辽宁省阜新市太平区兴泉路 179 号 gfyhzh: 阜新银行 12001000001416, xfyhzh: 珠海华润银行股份有限公司深圳福田支行, xfdzdh: 深圳市前海深港合作区前海一路 1 号 A 栋 201 室 xfmc: 守正招标有限公司, xfsh: 914403003426144591, bz: 002643, retCode: , invoiceMxList: dj: 9433.962264150943, ggxh: , id: 10000009319, je: 9433.96, jldw: , se: 566.04, sl: 1, slv: 0.06, spmc: 招标代理费 , retMsg: , invoiceBike: , fpzl: 0, zfbz: N , code: 1, msg: 查验成功, auth_count: , invoice: fphm: 07485795, fpdm: 4403172130, kprq: 20170913, fpje: 92761.64, fpse: 15769.48, jshj: 108531.12, gfmc: 深圳航天信息有限公司, gfsh: 9144030032629079XF, gfdzdh: 深圳市福田区梅林街道下梅林北环大道 7018 号 701 航天信息 0755-95113，32993339, gfyhzh: 中国工商银行股份有限公司深圳鸿翔支行 4000028809200263475, xfyhzh: 广发银行深圳分行龙岗支行 102041512010009503, xfdzdh: 深圳市龙岗区龙岗街道龙东社区龙东汽车站旁润达工业区 5 栋 4 楼 xfmc: 深圳市车保仕电子科技有限公司, xfsh: 91440300691191490T, bz: , retCode: , invoiceMxList: dj: 5.300665288888889, ggxh: , id: 10000008235, je: 92761.64, jldw: 条, se: 15769.48, sl: 17500, slv: 0.17, spmc: 超声波探头电子线 , retMsg: , invoiceBike: , fpzl: 0, zfbz: N , code: 1, msg: 查验成功, auth_count: 2.3 OCR 发票查询 接口请求说明：HTTPS 请求方式：POST 返回报文： 专票或普票数据格式如下: invoice: fphm: 06765385,/发票代码 fpdm: 3400163130,/发票号码 kprq: 2017-09-15,/开票日期 fpje: 2366.04,/发票不含税金额 fpse: 141.96,/发票含税金额 jshj:2508.00,/价税合计 gfmc: 华为技术服务有限公司,/购方名称 gfsh: 911310016636709451,/购方税号 gfdzdh: 廊坊*街*号 0316-*,/购方地址电话 gfyhzh: 中国*银行*支行 0410*878,/购方银行账户 xfyhzh: 中国*银行*支行 1312*163,/销方银行账户 xfdzdh: 安徽省*号 0557-*,/销方地址电话 xfmc: 宿州市*有限公司,/销方名称 xfsh: 91341302557848017K,/销方税号 bz: ,/备注 retCode: , retMsg: , invoiceBike: ,/机动车发票信息 invoiceMxList: id: 10000815319, dj: 215.0943396226415,/单价 sl: 11,/数量 je: 2366.04,/不含税金额 se: 141.96,/税额 slv: 0.06,/税率 jldw:,/单位 ggxh:,/规格型号 spmc: 住宿费,/商品名称 zbid: 10000098581 , fpzl: 2,/发票种类 zfbz:N/作废标志，Y 为作废发票，N 为未作废发票 ,/专普票明细数据清单数据类型为 list 类型 code: 1,/状态码,详细状态码见附录 msg: 查验成功/ msg 为查验结束返回的信息见附录 auth_count: 1/授权可以查询的数量 附附录录： msg : 错误信息 code : 错误代码 c co od de em