河北增值税电子发票对接说明版本122017年6月-一诺云网.PDFVIP

——————————河北航天信息技术有限公司—————————— 河北增值税电子发票 对接说明 （版本1.2） 2017年6月 第1页,共5页 ——————————河北航天信息技术有限公司—————————— 一、准备阶段 1.部署前置应用 联系当地航信业务人员，进行前置应用的部署，前置服务器需能访问外网 （如果企业 ERP 由第三方进行开发，前置服务器需可以由外网访问），部署完成后以下地址均能正常访 问： 1.前置服务器能访问 /csdzfp_jk/services/dzfpWebService?Wsdl （80端口） 2.开发人员及开票人员能访问 http://IP:port/dzfp_qyqz_heb/services/dzfpWebService?wsdl （此地址为接口地址，所有请求均发送到此地址，IP地址为前置服务器IP地址；port为前 置应用端口，默认9001，可根据实际情况修改） 2.下载相关文档 打开“一诺云-河北电子发票服务平台”首页 （/dzfp），下载 相关技术文档。 1.河北增值税电子发票接口规范V1.2.pdf 2.测试示例报文--发票开具.xml 3.测试示例报文--后置开票.xml 二、开发调试阶段 此阶段主要为企业 ERP 与电子发票接口调试阶段，所涉及请求报文和返回报文均参照 “河北增值税电子发票接口规范V1.2.pdf”进行编写，请求报文由外层报文和内层报文组 成，其中外层报文中非必填项的节点也要一起发送至接口。 发票开具报文格式可参考 “测试示例报文--发票开具.xml”。 使用“测试示例报文--发票开具.xml”时，只需修改外层报文中dataExchangeId和内 层报文中FPQQLSH节点内容，其他节点无需修改，并将修改后的报文内容发送至接口地址， 即可成功开具发票，之后对接企业可根据自身情况逐步修改报文内容进行测试。 当接口返回“qz_9005”时，说明请求报文格式有误，请参照接口文档认真核对。 当接口返回“9010”时，请核对外层报文中的税号、平台编码、纳税人授权码等是否正 确。 第2页,共5页 ——————————河北航天信息技术有限公司—————————— 当接口返回其他错误代码时，请参考接口文档中错误代码认证核对。 1.外层报文 企业调用以下接口时，外层报文格式不变，内层报文 （content部分）根据不同接口进 行编写，其中taxpayerId（纳税人识别号）、userName （平台编码）、authorizationCode（纳 税人授权码）测试阶段无需修改，正式上线时需向航信业务人员索取。 正式上线后，外层报文可以固定写死的节点： 1.terminalCode终端类型标识(0:B/S请求来源；1:C/S请求来源)：根据情况选择。 2.appId应用标识：根据情况选择。 3.version接口版本：接口版本，当前2.0。 4.userName平台编码：向航信业务人员索取。 5.passWord密码:根据接口文档标注的规则自行生成。 6.taxpayerId纳税人识别号：正式纳税人识别号。（测试阶段固定为130100999999088） 7.authorizationCode纳税人授权码：向航信业务人员索取。 8.requestCode数据交换请求发起方代码：用平台编码。 9.fjh分机号：详询财务人员。 10.jqbh机器编号：向航信业务人员索取。 2.发票开具接口 此接口可开具蓝票 （正票）和红票 （负票），开具成功后接口会返回发票基本信息和PDF 下载地址，其中发票请求流水号不能重复，不能超过20位，企业可根据情况自定义流水号 组成规则；同一张发票以相同流水号重复开具时，系统默认此操作为查询发票信息，接口会 返回这张发票的基本信息和PDF下载地址，和第一次开具成功时相同。 当发票明细行超过8行时，会自动生成销货清单，最多允许1000行明细，票面商品名 称自动改为“（详见销货清单）” ，如果清单中所有商品税率一致，则发票票面显示税率， 否则不显示。 以下为