电子发票签章系统数据规范接口文档

电子发票签章系统数据规范 1.1公共请求参数 31.2公共返回参数 41.3API接口列表及参数说明 51.3.1版式文件生成接口 5 HA 1.API接口1.1公共请求参数{odezipCode根据数据包大小判断是否进行压缩)",nntypeurespanId识"}称g一样，详见下面接口列表g1tCodeg1CA加密gg接口，对私有请求报文进行加密BASE64.encode(ZIP压缩(CA加密(json明文)))CA解密(ZIP解压缩(BASE64.decode(json密gHMacSHA。gceCodezipCodeencryptCodeaccesstoken+datagram+signtype内容进行字符串拼识g1.2公共返回参数{emsgodezipCode根据数据包大小判断是否进行压缩)",nntypeure}称ggg1tCodeg1CA加密gg的接口，对私有请求报文进行加密BASE64.encode(ZIP压缩(CA加密(json明文)))CA解密(ZIP解压缩(BASE64.decode(json密文)))egHMacSHA'。ginterfaceCode开始，按照先后顺序做字符串拼1.3API接口列表及参数说明编码名称1接口发票版式文件签章功能版式文件生成接口3.接口编码：51.formatfile.build请求报文示例与数据项说明{"kj":{rrrmz"kjmxs":[{w},{w}请求数据项说明据项名称名称1识VARCHAR是2VARCHAR1是5-增值税电子专用发票(电专)3ionARCHAR否4VARCHAR是流水号保证唯一5NUMBER1是蓝字废票61是71否Y购发票发票8mbbbhVARCHAR是91是项目名称VARCHAR否项清单标识(QD_BZ)为1时必填。nsrsbh别号VARCHAR是mcVARCHAR是zdh销售方地址、电话VARCHAR是hzh号VARCHAR否bh税人识别号VARCHAR否名称VARCHAR是购买方地址、电话VARCHAR否银行账号VARCHAR否gmf_sj手机VARCHAR否购买方手机号与购买方邮箱不能号码:13[0-9],14[5,7,9],15[0,1,2,3,4,5,6,7,8,9],16[5,6],17[0,1,6,7,8],18[0-9]动号段:134,135,136,137,138,139,147,148,150,151,152,154,157,158,159,165,170,172,178,182,183,184,187,188,198通号段:130,131,132,145,146,155,156,166,167,170,171,175,176,185,186:133,149,153,170,173,177,180,181,189,191,199*70[1700/1701/1702(电信)、1703/1705/1706(移动)、1704/1707/1708/1709(联通)]、171(联通)星通信]:1349邮箱VARCHAR否箱地址命名规则填写购买方手机号与购买方邮箱不能空VARCHAR1否请按需填写，禁止写死手机或邮VARCHAR是VARCHAR否VARCHAR否yfp_dmVARCHAR否VARCHAR8否OUBLE是额+合计税额eOUBLE是开票合计金额与明细行所有致eOUBLE是开票合计税额与明细行所有要一致VARCHAR否增值税发票红字发票开具时，备注要求:增值税发票代开发票开具时，备注要求:XYYYYYYYYXY开企业名称。增值税发票红字发票(专票)开具时，备注要求:开具负数发票，必须在备注中注明“开具红字增值税专用发票信息表编号ZZZZZZZZZZZZZZZZ”字样，其中“Z”为开具红字增值税专用发票所需要的长度为16位信息表编号。差额征税发票开具时，备注要求:须在备注中注明“差额征税：X。”字样，其中“X”为差额值。红票必须在备注中注明“差额征税”编号ARCHAR是dmVARCHAR是VARCHAR8是TETIME是VARCHAR是VARCHAR是NUMBER1是wjlxVARCHAR3是VARCHAR否purlVARCHAR否空，则不再生成方式的选择1VARCHAR是商品进行折扣，折扣行紧数Y(X.XXX%)”字样，其中“Y”2VARCHAR否复用作为通行费发票的‘类型’3VARCHAR否复用作为通行费发票的‘车牌号’4OUBLE否U时，本字段复用作为通行费发01804255OUBLE否不含税单价=含税单价/(1+税U时，本字段复用作为通行费发01804256OUBLE是不含税金额=含税金额/(1+税率)，并保留两位小数7OUBLE是如果税率为0，表示免税(正常8OUBLE是数9zVARCHAR1是目单价和项目金额是否含1是VARCHAR是商品编码版本：必填VARCHAR否s标识VARCHAR1是商品编码版本：必填VARCHAR1否理VARCHAR否OUBLE否额1.差额征税的发票如果没有折扣2.具体差额征税发票的计算方法不含税差额=不含税金额-扣返回报文示例与数据项说明{}项说明称fpdm是fp_hm8是e否下载方式(XZFS字段)为1、必填；流否下载方式(XZFS字段)为2、必填；发票，共服务平台发票x3是atform校验规则单行商品明细|单价×数量-金额|<=0.01元【单价×数量的结果保留两位小数】【不含税金额×税率的结果保留两位小数】的不含税金额乘以税率，按照实际相乘结果进行相加。与明细行所有金额加起来要一致；与明细行所有税额加起来要一致；被折扣行金额。多行折扣情况下，折扣行金额不能大于各被折扣正数发票金额为负的商品行(即折扣行)，其上一行商品金额必须为正。单价必须是合法数字折扣行税率相同。多行折扣情况下，各被折扣行税率相同，且与与明细行所有金额加起来要一致；与明细行所有税额加起来要一致；单价必须是合法数字11234567812行费”标识。345录的通行日期。6的通行日期。78ETC写“不征税”。3%”。9。1税率率税率税率税率税率税率税率税率税率税率2.1HMACSHA256加密签名asecurityInvalidKeyExceptionsecurityNoSuchAlgorithmExceptionxcryptoMacavaxcryptospecSecretKeySpecpublicclassHMacSHA256Util{publicstaticStringHMACSHA256(byte[]data,byte[]key){try{SecretKeySpecsigningKeynewSecretKeySpeckey,"HmacSHA256");Macmac=Mac.getInstance("HmacSHA256");initsigningKeyytehexmacdoFinaldatacatchNoSuchAlgorithmExceptione){tStackTracecatchInvalidKeyExceptione){tStackTrace}}privatestaticStringbyte2hex(byte[]b){tringBuilderhsnewStringBuildertmpfor(intn=0;b!=null&&n<b.length;n++){stmpIntegertoHexStringbnXFFifstmplengthendtmp}hstoStringtoUpperCase}publicstaticvoidmain(String[]args){System.out.println(HMACSHA256("航天信息股份有限公司".getBytes(),"12345678".getBytes()));}}1.BB2DBF98C94988269586CBDF83A5AABC8F65ABBCA9A931B11DAFFDC6A3D0F6252.2压缩/解压缩aioByteArrayInputStreamaioByteArrayOutputStreamaioInputStreamaioOutputStreamautilzipGZIPInputStreamautilzipGZIPOutputStreampublicclassGZipUtils{publicstaticintBUFFER;publicstaticStringEXTgzpublicstaticbyte[]compress(byte[]data)throwsException{outputnullteArrayInputStreambaisnewByteArrayInputStreamdataeArrayOutputStreambaosnewByteArrayOutputStreambaisbaosoutputbaostoByteArray;}publicstaticvoidcompressInputStreamisOutputStreamos)throwsException{GZIPOutputStreamgosnewGZIPOutputStream(os);bytedatanewbyteBUFFERwhile((count=is.read(data,0,BUFFER))!=-1){goswritedatacount);}inishflushclose}publicstaticbytedecompressbytedata)throwsException{eArrayInputStreambaisnewByteArrayInputStreamdataeArrayOutputStreambaosnewByteArrayOutputStreamompressbaisbaostabaostoByteArray3.}}publicstaticvoiddecompress(InputStreamis,OutputStreamos)throwsException{GZIPInputStreamgisnewGZIPInputStream(is);bytedatanewbyte