接口服务器说明书

AISINO增值税管理系统销售单接口说明书AISINO增值税管理系统数据接口说明书编写：校对：标检：审核：会签：批准：防伪税控事业部大客户二部2016-04

目录TOC\o"1-7"\h\uAISINO增值税管理系统 接口设计本部分对接口的具体格式、内容等做详细说明。发票操作接口代码示例获取库存信息publicStringqueryInventory(Stringxml);发票开具publicStringissueInvoice(Stringxml);发票打印publicStringprintInvoice(Stringxml);发票作废publicStringinvalidInvoice(Stringxml);清单打印publicStringprintList(Stringxml);发票上传publicStringuploadInvoice(Stringxml);发票状态更新publicStringupdateInvoiceStatus(Stringxml);空白发票作废publicStringinvalidBlankInvoice(Stringxml);金税盘状态查询publicStringqueryJSPInfo(Stringxml);打印参数设置publicStringprintParams(Stringxml);红字信息表上传publicStringuploadRedInfo(Stringxml);汇总抄报publicStringcopyTax(Stringxml);远程清卡publicStringclearCard(Stringxml);红字信息表下载publicStringdownloadRedInfo(Stringxml);功能列表序号请求ID名称功能解释备注1SID="0"获取库存信息SID为“0”，查询金税盘库存信息。2SID="1"发票开具SID为“1”，开具发票。3SID="2"发票打印SID为“2”，打印发票。4SID="4"发票作废SID为“4”，作废发票。5SID="3"清单打印SID为“3”，清单打印。6SID="15"发票上传SID为“15”，发票上传。7SID="16"发票状态更新SID为“16”，发票状态更新。8SID="KBZF"空白发票作废SID为“KBZ”，作废空白发票。9SID="JSPXX"金税盘状态查询SID为“JSPXX”，设置打印参数。10SID="DYCS"打印参数设置SID为“DYCS”，查询金税盘状态。11SID="HZXXSC"红字信息表上传SID为“HZXXSC”，上传红字信息表。12SID="HZCB"汇总抄报SID为“HZCB”，用于抄报税。13SID="YCQK"远程清卡SID为“YCQK”，用于远程清卡。14SID="HZXXXZ"红字信息表下载SID为“HXXXXZ”，下载红字信息表。请求报文XML获取库存信息向服务器发送XML格式的字符流请求，格式如下：<?xmlversion="1.0"encoding="UTF-8"?><service> <sid>0</sid> <ip></ip> <port></port> <datacount="2"> <record> <FPZL>0</FPZL> </record> <record>...</record> </data></service>说明：XML数据编码格式为GBK；<service>：根元素；<sid>：标识功能类别；<ip>：客户端控制台ip地址；<port>：客户端控制台端口；<data>：数据信息；<record>：一种发票信息的库存查询。发票开具向服务器发送XML格式的字符流请求，格式如下：<?xmlversion="1.0"encoding="UTF-8"?><service> <sid>1</sid> <ip></ip> <port></port> <datacount="2"> <record> <fp> <FPZL></FPZL> <GFMC></GFMC> <GFSH></GFSH> <GFDZDH></GFDZDH> <GFYHZH></GFYHZH> <BZ></BZ> <SKR></SKR> <FHR></FHR> <KPR></KPR> <XFYHZH></XFYHZH> <XFDZDH></XFDZDH> <QDBZ></QDBZ> <XSDJBH></XSDJBH> <KPBZ></KPBZ> </fp> <group> <fpmx> <SPMC></SPMC> <HSBZ></HSBZ> <SLV></SLV> <JE></JE> <DJ></DJ> <JLDW></JLDW> <GGXH></GGXH> <SE></SE> <SL></SL> <BMBBH></BMBBH> <SSFLBM></SSFLBM> <YHZC></YHZC> <YHZCNR></YHZCNR> <LSLBS></LSLBS> <QYZBM></QYZBM> <KCE></KCE> </fpmx> <fpmx>...</fpmx> </group> </record> <record>...</record> </data></service>说明：XML数据编码格式为GBK；<service>：根元素；<sid>：标识功能类别；<ip>：客户端控制台ip地址；<port>：客户端控制台端口；<data>：数据信息；<record>：一条具体的信息；<fp>：发票头信息；<group>：发票明细集合；<fpmx>：一条发票明细信息。发票打印向服务器发送XML格式的字符流请求，格式如下：<?xmlversion="1.0"encoding="UTF-8"?><service> <sid>2</sid> <ip></ip> <port></port> <datacount="2"> <record> <FPZL></FPZL> <FPHM></FPHM> <FPDM></FPDM> <TCBZ></TCBZ> </record> <record>...</record> </data></service>说明：XML数据编码格式为GBK；<service>：根元素；<sid>：标识功能类别；<ip>：客户端控制台ip地址；<port>：客户端控制台端口；<data>：数据信息。发票作废向服务器发送XML格式的字符流请求，格式如下：<?xmlversion="1.0"encoding="UTF-8"?><service> <sid>4</sid> <ip></ip> <port></port> <datacount="2"> <record> <FPZL></FPZL> <FPHM></FPHM> <FPDM></FPDM> </record> <record>...</record> </data></service>说明：XML数据编码格式为GBK；<service>：根元素；<sid>：标识功能类别；<ip>：客户端控制台ip地址；<port>：客户端控制台端口；<data>：数据信息。清单打印向服务器发送XML格式的字符流请求，格式如下：<?xmlversion="1.0"encoding="UTF-8"?><service> <sid>2</sid> <ip></ip> <port></port> <datacount="2"> <record> <FPZL></FPZL> <FPHM></FPHM> <FPDM></FPDM> </record> <record>...</record> </data></service>说明：XML数据编码格式为UTF-8；<service>：根元素；<sid>：标识功能类别；<ip>：客户端控制台ip地址；<port>：客户端控制台端口；<data>：数据信息。发票上传向服务器发送XML格式的字符流请求，格式如下：<?xmlversion="1.0"encoding="UTF-8"?><service> <sid>15</sid> <ip></ip> <port></port> <datacount="2"> <record> <FPHM></FPHM> <FPDM></FPDM> </record> <record>...</record> </data></service>说明：XML数据编码格式为UTF-8；<service>：根元素；<sid>：标识功能类别；<ip>：客户端控制台ip地址；<port>：客户端控制台端口；<data>：数据信息。发票状态更新向服务器发送XML格式的字符流请求，格式如下：<?xmlversion="1.0"encoding="UTF-8"?><service> <sid>16</sid> <ip></ip> <port></port></service>说明：XML数据编码格式为UTF-8；<service>：根元素；<sid>：标识功能类别；<ip>：客户端控制台ip地址；<port>：客户端控制台端口。空白发票作废向服务器发送XML格式的字符流请求，格式如下：<?xmlversion="1.0"encoding="UTF-8"?><service> <sid>KBZF</sid> <ip></ip> <port></port> <datacount="2"> <record> <FPZL></FPZL> </record> <record>...</record> </data></service>说明：XML数据编码格式为UTF-8；<service>：根元素；<sid>：标识功能类别；<ip>：客户端控制台ip地址；<port>：客户端控制台端口；<data>：数据信息。金税盘状态查询向服务器发送XML格式的字符流请求，格式如下：<?xmlversion="1.0"encoding="UTF-8"?><service> <sid>JSPXX</sid> <ip></ip> <port></port></service>说明：XML数据编码格式为UTF-8；<service>：根元素；<sid>：标识功能类别；<ip>：客户端控制台ip地址；<port>：客户端控制台端口。打印参数设置向服务器发送XML格式的字符流请求，格式如下：<?xmlversion="1.0"encoding="UTF-8"?><service> <sid>DYCS</sid> <ip></ip> <port></port> <data> <DYJMC></DYJMC> <QDDYFS></QDDYFS> <LEFT></LEFT> <TOP></TOP> </data></service>说明：XML数据编码格式为GBK；<service>：根元素；<sid>：标识功能类别；<ip>：客户端控制台ip地址；<port>：客户端控制台端口；<data>：数据信息。红字信息表上传向服务器发送XML格式的字符流请求，格式如下：<?xmlversion="1.0"encoding="UTF-8"?><service> <sid>HZXXSC</sid> <ip></ip> <port></port> <datacount="2"> <record> <fp> <SQFSH></SQFSH> <KPDH></KPDH> <SBBH></SBBH> <XXBLSH></XXBLSH> <XXBLX></XXBLX> <DYLPDM></DYLPDM> <DYLPHM></DYLPHM> <SZLB></SZLB> <DSLBZ></DSLBZ> <TKRQ></TKRQ> <GFMC></GFMC> <GFSH></GFSH> <XFMC></XFMC> <XFSH></XFSH> <HJJE></HJJE> <SLV></SLV> <HJSE></HJSE> <SQSM></SQSM> </fp> <group> <fpmx> <SPMC></SPMC> <JLDW></JLDW> <GGXH></GGXH> <DJ></DJ> <SL></SL> <JE></JE> <SLV></SLV> <SE></SE> <HSBZ></HSBZ> </fpmx> <fpmx>...</fpmx> </group> </record> <record>...</record> </data></service>说明：XML数据编码格式为GBK；<service>：根元素；<sid>：标识功能类别；<ip>：客户端控制台ip地址；<port>：客户端控制台端口；<data>：数据信息；<record>：一条具体的信息；<fp>：发票头信息；<group>：发票明细集合；<fpmx>：一条发票明细信息。汇总抄报向服务器发送XML格式的字符流请求，格式如下：<?xmlversion="1.0"encoding="UTF-8"?><service> <sid>HZCB</sid> <ip></ip> <port></port></service>说明：XML数据编码格式为UTF-8；<service>：根元素；<sid>：标识功能类别；<ip>：客户端控制台ip地址；<port>：客户端控制台端口。远程清卡向服务器发送XML格式的字符流请求，格式如下：<?xmlversion="1.0"encoding="UTF-8"?><service> <sid>YCQK</sid> <ip></ip> <port></port></service>说明：XML数据编码格式为UTF-8；<service>：根元素；<sid>：标识功能类别；<ip>：客户端控制台ip地址；<port>：客户端控制台端口。红字信息表下载向服务器发送XML格式的字符流请求，格式如下：<?xmlversion="1.0"encoding="UTF-8"?><service> <sid>HZXXXZ</sid> <ip></ip> <port></port> <data> <NSRSBH></NSRSBH> <JSPH></JSPH> <KPDH></KPDH> <YQZT></YQZT> <TKRQQ></TKRQQ> <TKRQZ></TKRQZ> <GFSH></GFSH> <XFSH></XFSH> <XXBBH></XXBBH> <XXBFW></XXBFW> <YH></YH> <MYJLS></MYJLS> </data></service>说明：XML数据编码格式为UTF-8；<service>：根元素；<sid>：标识功能类别；<ip>：客户端控制台ip地址；<port>：客户端控制台端口；<data>：下载条件。内容和格式定义各功能报文公用字段如下：序号字段名注释数据类型最大长度是否必填说明sid功能类别字符10是ip控制台ip地址字符15是port控制台端口字符5是获取库存信息序号字段名注释数据类型最大长度是否必填说明FPZL发票种类字符2是固定值：0：专用发票2：普通发票11：货运发票12：机动车票51：电子发票发票开具发票头序号字段名注释数据类型最大长度是否必填说明FPZL发票种类字符2是固定值：0：专用发票2：普通发票11：货运发票12：机动车票51：电子发票GFMC购方名称字符100是GFSH购方税号字符20是GFDZDH购方地址电话字符100否GFYHZH购方银行账户字符100否BZ备注字符230否专票开具红字发票时，该字段需要填写如下内容：开具红字增值税专用发票信息表编号XXXXXXXXXXXXXXXXXXXX表示信息表编号，备注内容为以上那句话，不能有差错，否则无法开具红字发票。普票开具负数发票时，该字段需要填写如下内容：对应正数发票代码:YYYYYYYY号码:ZZZZZZYYYYY：是发票代码ZZZZ:是发票号码普票负数票备注除这句内容外可以有其他内容SKR收款人字符8是8个字节，4个汉字FHR复核人字符8是8个字节，4个汉字KPR开票人字符8是8个字节，4个汉字XFYHZH销方银行账户字符100否XFDZDH销方地址电话字符100否QDBZ清单标志字符2是固定值0：不开具清单1：开具清单XSDJBH销售单据编号字符100否开具红字发票时，该字段填写信息表编号，为必填项KPBZ开票标志字符2是固定值0：开票1：校验发票明细序号字段名注释数据类型最大长度是否必填说明SPMC商品名称字符92是HSBZ含税标志字符2是固定值0：不含税1：含税SLV税率数值10,6是JE金额数值16,2是DJ单价数值36,15否JLDW计量单位字符22否GGXH规格型号字符40否SE税额数值16,2是SL数量数值36,15否BMBBH编码版本号字符是详见国税局网站发布的分类编码表格SSFLBM税收分类编码字符是详见国税局网站发布的分类编码表格YHZC是否享受优惠政策字符是固定值0：不享受1：享受YHZCNR享受优惠政策内容字符否如果不享受优惠政策，该字段为空；如果享受优惠政策，该字段不能为空，内容填写为对应的优惠政策LSLBS零税率标识字符否固定值空：非零税率0：出口退税1：免税2：不征收3：普通零税率QYZBM企业自编码字符否企业内部自编的商品编码，可以为空KCE扣除额数值否差额税使用，非差额税可以为空发票打印序号字段名注释数据类型最大长度是否必填说明FPZL发票种类字符2是固定值：0：专用发票2：普通发票11：货运发票12：机动车票51：电子发票FPHM发票号码字符20是FPDM发票代码字符20是TCBZ弹窗标志字符2否固定值0：不弹出参数设置窗口1：弹出参数设置窗口发票作废序号字段名注释数据类型最大长度是否必填说明FPZL发票种类字符2是固定值：0：专用发票2：普通发票11：货运发票12：机动车票51：电子发票FPHM发票号码字符20是FPDM发票代码字符20是清单打印序号字段名注释数据类型最大长度是否必填说明FPZL发票种类字符2是固定值：0：专用发票2：普通发票11：货运发票12：机动车票51：电子发票FPHM发票号码字符20是FPDM发票代码字符20是发票上传序号字段名注释数据类型最大长度是否必填说明FPHM发票号码字符20是FPDM发票代码字符20是发票状态更新发票状态更新报文只有公共节点，详见发票状态更新报文5.3.1.7。空白发票作废序号字段名注释数据类型最大长度是否必填说明FPZL发票种类字符2是固定值：0：专用发票2：普通发票11：货运发票12：机动车票51：电子发票金税盘状态查询金税盘状态查询报文只有公共节点，详见金税盘查询报文5.3.1.9。打印参数设置序号字段名注释数据类型最大长度是否必填说明DYJMC打印机名称字符92否为空时使用开票软件默认打印机QDDYFS清单打印方式字符2是固定值：1：全打0：套打LEFT左右偏移量数值16,2否为空时默认为0TOP上下偏移量数值10,6否为空时默认为0红字信息表上传红字信息表头序号字段名注释数据类型最大长度是否必填说明SQFSH申请方税号字符20KPDH申请方开票点号字符SBBH申请方设备编号字符12XXBLSH信息表流水号字符24XXBLX信息表类型字符2固定值：0：正常DYLPDM对应蓝票代码字符DYLPHM对应蓝票号码字符SZLB税种类别字符2固定值1：增值税DSLBZ多税率标志字符2固定值0：一票一税率；1：一票多税率TKRQ填开日期日期10格式：yyyy-MM-ddGFMC购方名称字符GFSH购方税号字符20XFMC销方名称字符XFSH销方税号字符20HJJE合计金额数值16,2SLV税率数值10,6多税率时为空HJSE合计税额数值16,2SQSM申请说明字符十位数字表示的申请说明，含正常和逾期，固定值，详见说明。说明：红字信息表头中申请说明节点的取值表：申请方申请原因开票软件管理系统购方申请已抵扣110000000011未抵扣无法认证1011000000121纳税人识别号认证不符1010100000122增值税专用发票代码、号码认证不符1010010000123所供货物或劳务、服务不属于增值税扣税项目范围1010001000124销方申请因开票有误，购买方拒收的000000011021因开票有误等原因尚未交付的000000010122红字信息表明细序号字段名注释数据类型最大长度是否必填说明SPMC商品名称字符92是JLDW计量单位字符22否GGXH规格型号字符40否DJ单价数值36,15否SL数量数值36,15否JE金额数值16,2是SLV税率数值10,6是SE税额数值16,2是HSBZ含税标志字符2是固定值N：不含税Y：含税汇总抄报汇总抄报报文只有公共节点，详见汇总抄报报文5.3.1.12。远程清卡远程清卡报文只有公共节点，详见远程清卡报文5.3.1.13。红字信息表下载序号字段名注释数据类型最大长度是否必填说明NSRSBH纳税人识别号字符2是JSPH金税盘号字符100是KPDH开票点号字符20是YQZT逾期状态字符2是固定值：N：非逾期Y：逾期TKRQQ填开日期起日期10否格式：yyyy-MM-ddTKRQZ填开日期止日期10否格式：yyyy-MM-ddGFSH购方税号字符20否XFSH销方税号字符20否XXBBH信息表编号字符100否XXBFW信息表下载范围字符2是固定值：0：全部1：本企业申请2：其他企业申请YH页号字符10是从1开始MYJLS每页记录数字符10是返回内容XML获取库存信息返回报文服务器返回处理结果XML格式的字符流，格式如下：<?xmlversion="1.0"encoding="UTF-8"?><service> <errcount="2"> <refp> <RETCODE></RETCODE> <RETMSG></RETMSG> <FPHM></FPHM> <FPDM></FPDM> <KCFPSL></KCFPSL> <JSSBRQ></JSSBRQ> <XFSH></XFSH> <SCFS></SCFS> <KPDH></KPDH> <CSQBZ></CSQBZ> <SSQBZ></SSQBZ> <KPFS></KPFS> <KPFWQH></KPFWQH> <JSPH></JSPH> <XFMC></XFMC> </refp> <refp>...</refp> </err></service>说明：<service>：根元素；<err>：错误信息；<refp>：每一张发票的具体返回信息。发票开具返回报文服务器返回处理结果XML格式的字符流，格式如下：<?xmlversion="1.0"encoding="UTF-8"?><service> <errcount="2"> <refp> <RETCODE></RETCODE> <RETMSG></RETMSG> <JE></JE> <SE></SE> <KPRQ></KPRQ> <FPDM></FPDM> <FPHM></FPHM> <SYZFPDM></SYZFPDM> <SYZFPHM></SYZFPHM> <SYZFPZL></SYZFPZL> </refp> <refp>...</refp> </err></service>说明：<service>：根元素；<err>：错误信息；<refp>：每一张发票的具体返回信息。发票打印返回报文服务器返回处理结果XML格式的字符流，格式如下：<?xmlversion="1.0"encoding="UTF-8"?><service> <errcount="2"> <refp> <RETCODE></RETCODE> <RETMSG></RETMSG> <FPZL></FPZL> <FPHM></FPHM> <FPDM></FPDM> </refp> <refp>...</refp> </err></service>说明：<service>：根元素；<err>：错误信息；<refp>：每一张发票的具体返回信息。发票作废返回报文服务器返回处理结果XML格式的字符流，格式如下：<?xmlversion="1.0"encoding="UTF-8"?><service> <errcount="2"> <refp> <RETCODE></RETCODE> <RETMSG></RETMSG> <FPZL></FPZL> <FPHM></FPHM> <FPDM></FPDM> </refp> <refp>...</refp> </err></service>说明：<service>：根元素；<err>：错误信息；<refp>：每一张发票的具体返回信息。清单打印返回报文服务器返回处理结果XML格式的字符流，格式如下：<?xmlversion="1.0"encoding="UTF-8"?><service> <errcount="2"> <refp> <RETCODE></RETCODE> <RETMSG></RETMSG> <FPZL></FPZL> <FPHM></FPHM> <FPDM></FPDM> </refp> <refp>...</refp> </err></service>说明：<service>：根元素；<err>：错误信息；<refp>：每一张发票的具体返回信息。发票上传返回报文服务器返回处理结果XML格式的字符流，格式如下：<?xmlversion="1.0"encoding="UTF-8"?><service> <errcount="2"> <refp> <RETCODE></RETCODE> <RETMSG></RETMSG> <FPHM></FPHM> <FPDM></FPDM> </refp> <refp>...</refp> </err></service>说明：<service>：根元素；<err>：错误信息；<refp>：每一张发票的具体返回信息。发票状态更新返回报文服务器返回处理结果XML格式的字符流，格式如下：<?xmlversion="1.0"encoding="UTF-8"?><service> <err> <RETCODE></RETCODE> <RETMSG></RETMSG> </err> <info> <succ> <fp> <FPDM></FPDM> <FPHM></FPHM> <XLH></XLH> </fp> <fp>...</fp> </succ> <fail> <fp> <FPDM></FPDM> <FPHM></FPHM> <XLH></XLH> <CODE></CODE> <MESS></MESS> </fp> <fp>...</fp> </fail> </info></service>说明：<service>：根元素；<err>：错误信息；<refp>：每一张发票的具体返回信息。空白发票作废返回报文服务器返回处理结果XML格式的字符流，格式如下：<?xmlversion="1.0"encoding="UTF-8"?><service> <errcount="2"> <refp> <RETCODE></RETCODE> <RETMSG></RETMSG> <FPZL></FPZL> <FPDM></FPDM> <FPHM></FPHM> </refp> <refp>...</refp> </err></service>说明：<service>：根元素；<err>：错误信息；<refp>：每一张发票的具体返回信息。金税盘状态查询返回报文服务器返回处理结果XML格式的字符流，格式如下：<?xmlversion="1.0"encoding="UTF-8"?><service> <err> <RETCODE></RETCODE> <RETMSG></RETMSG> </err> <!--金税设备状态查询--> <Jssbztcx> <!--金税设备信息--> <Jssbxx> <!--纳税人识别号--> <Nsrsbh></Nsrsbh> <!--本开票机类型--> <Bkpjlx></Bkpjlx> <!--分开票机数目--> <Fkpjsm></Fkpjsm> <!—开票点号--> <Kpdh></Kpdh> <!--金税设备当前日期--> <Jssbdqrq></Jssbdqrq> <!--发票是否用完--> <Fpsfyw></Fpsfyw> <!--上传截止日期--> <Scjzrq></Scjzrq> <!--离线时限--> <Lxsx></Lxsx> <!--驱动程序版本号--> <Qdcxbbh></Qdcxbbh> <!--底层程序版本号--> <Dccxbbh></Dccxbbh> <!--金税盘编号--> <Jspbh></Jspbh> <!--报税盘编号--> <Bspbh></Bspbh> <!--报税盘底层版本号--> <Bspdcbbh></Bspdcbbh> <!--汉字防伪授权--> <Hzfwsq></Hzfwsq> <!--发行授权信息--> <Fxsqxx></Fxsqxx> <!--报税盘容量--> <Bsprl></Bsprl> </Jssbxx> <!--增值税专用发票及增值税普通发票--> <Zzszyptfp> <!--是否到抄税期--> <Sfdcsq></Sfdcsq> <!--是否到锁死期--> <Sfdssq></Sfdssq> <!--专用发票离线限额--> <Zyfplxxe></Zyfplxxe> <!--普通发票离线限额--> <Ptfplxxe></Ptfplxxe> <!--专用发票离线剩余金额--> <Zyfplxsyje></Zyfplxsyje> <!--普通发票离线剩余金额--> <Ptfplxsyje></Ptfplxsyje> <!--专用发票开票限额--> <Zyfpkpxe></Zyfpkpxe> <!--普通发票开票限额--> <Ptfpkpxe></Ptfpkpxe> <!--锁死日期--> <Ssrq></Ssrq> <!--上次报税日期--> <Sccbrq></Sccbrq> <!--抄税起始日期--> <Csqsrq></Csqsrq> <!--报税资料--> <Bszl></Bszl> <!--报税成功标志--> <Bscgbz></Bscgbz> <!--购入发票信息--> <Grfpxx></Grfpxx> <!--退回发票信息--> <Thfpxx></Thfpxx> </Zzszyptfp> <!--货物运输业增值税专用发票--> <Hwysyzzszyfp> <!--是否到抄税期--> <Sfdcsq></Sfdcsq> <!--是否到锁死期--> <Sfdssq></Sfdssq> <!--离线限额--> <Lxxe></Lxxe> <!--离线剩余金额--> <Lxsyje></Lxsyje> <!--单张开票限额--> <Dzkpxe></Dzkpxe> <!--锁死日期--> <Ssrq></Ssrq> <!--上次报税日期--> <Scbsrq></Scbsrq> <!--抄税起始日期--> <Csqsrq></Csqsrq> <!--报税资料--> <Bszl></Bszl> <!--报税成功标志--> <Bscgbz></Bscgbz> <!--购入发票信息--> <Grfpxx></Grfpxx> <!--退回发票信息--> <Thfpxx></Thfpxx> </Hwysyzzszyfp> <!--机动车销售统一发票--> <Jdcxstyfp> <!--是否到抄税期--> <Sfdcsq></Sfdcsq> <!--是否到锁死期--> <Sfdssq></Sfdssq> <!--离线限额--> <Lxxe></Lxxe> <!--离线剩余金额--> <Lxsyje></Lxsyje> <!--单张开票限额--> <Dzkpxe></Dzkpxe> <!--月累计开票限额--> <Yljkpxx></Yljkpxx> <!--月累计退票限额--> <Yljtpxx></Yljtpxx> <!--本月已开发票金额--> <Byykfpje></Byykfpje> <!--本月已开发退票金额--> <Byyktpje></Byyktpje> <!--锁死日期--> <Ssrq></Ssrq> <!--上次报税日期--> <Scbsrq></Scbsrq> <!--抄税起始日期--> <Csqsrq></Csqsrq> <!--报税资料--> <Bszl></Bszl> <!--报税成功标志--> <Bscgbz></Bscgbz> <!--购入发票信息--> <Grfpxx></Grfpxx> <!--退回发票信息--> <Thfpxx></Thfpxx> </Jdcxstyfp> <!--电子发票--> <Dzfp> <!--是否到抄税期--> <Sfdcsq></Sfdcsq> <!--是否到锁死期--> <Sfdssq></Sfdssq> <!--离线限额--> <Lxxe></Lxxe> <!--离线剩余金额--> <Lxsyje></Lxsyje> <!--单张开票限额--> <Dzkpxe></Dzkpxe> <!--锁死日期--> <Ssrq></Ssrq> <!--上次报税日期--> <Scbsrq></Scbsrq> <!--抄税起始日期--> <Csqsrq></Csqsrq> <!--报税资料--> <Bszl></Bszl> <!--报税成功标志--> <Bscgbz></Bscgbz> <!--购入发票信息--> <Grfpxx></Grfpxx> <!--退回发票信息--> <Thfpxx></Thfpxx> </Dzfp> </Jssbztcx></service>说明：<service>：根元素；<err>：错误信息；<refp>：每一张发票的具体返回信息；<Jssbztcx>：若查询成功，该节点存在；若查询失败，则该节点不存在；<Zzszyptfp>：若该税盘中发行有专用发票、普通发票，则该节点存在；否则节点不存在；<Hwysyzzszyfp>：若该税盘中发行货运发票，则该节点存在；否则节点不存在；<Jdcxstyfp>：若该税盘中发行有机动车票，则该节点存在；否则节点不存在；<Dzfp>：若该税盘中发行有电子发票，则该节点存在；否则节点不存在。打印参数设置返回报文服务器返回处理结果XML格式的字符流，格式如下：<?xmlversion="1.0"encoding="UTF-8"?><service> <err> <RETCODE></RETCODE> <RETMSG></RETMSG> </err></service>说明：<service>：根元素；<err>：错误信息。红字信息表上传返回报文服务器返回处理结果XML格式的字符流，格式如下：<?xmlversion="1.0"encoding="UTF-8"?><service> <err> <RETCODE></RETCODE> <RETMSG></RETMSG> </err> <redatacount="2"> <refp> <XXBLSH></XXBLSH> <XXBBH></SYZFPDM> <XXBZTDM></XXBZTDM> <XXBZTMS></XXBZTMS> </refp> <refp>...</refp> </redata></service>说明：<service>：根元素；<err>：错误信息；<redata>：返回的数据；<reft>：每张信息表的具体返回信息。汇总抄报返回报文服务器返回处理结果XML格式的字符流，格式如下：<?xmlversion="1.0"encoding="UTF-8"?><service> <err> <RETCODE></RETCODE> <RETMSG></RETMSG> </err></service>说明：<service>：根元素；<err>：错误信息。远程清卡返回报文服务器返回处理结果XML格式的字符流，格式如下：<?xmlversion="1.0"encoding="UTF-8"?><service> <err> <RETCODE></RETCODE> <RETMSG></RETMSG> </err></service>说明：<service>：根元素；<err>：错误信息。红字信息表下载服务器返回处理结果XML格式的字符流，格式如下：<?xmlversion="1.0"encoding="UTF-8"?><service> <err> <RETCODE></RETCODE> <RETMSG></RETMSG> </err> <redatacount="2"> <refp> <XXBLSH></XXBLSH> <XXBBH></XXBBH> <XXBZTDM></XXBZTDM> <XXBZTMS></XXBZTMS> <XXBLX></XXBLX> <LPDM></LPDM> <LPHM></LPHM> <SZLB></SZLB> <DSLBZ></DSLBZ> <TKRQ></TKRQ> <GFMC></GFMC> <GFSH></GFSH> <XFMC></XFMC> <XFSH></XFSH> <HJJE></HJJE> <SLV></SLV> <HJSE></HJSE> <SQSM></SQSM> <refpMx> <mx> <SPMC></SPMC> <JLDW></JLDW> <GGXH></GGXH> <DJ></DJ> <SL></SL> <JE></JE> <SLV></SLV> <SE></SE> <HSBZ></HSBZ> </mx> <mx>...</mx> </refpMx> </refp> <refp>...</refp> </redata></service>说明：<service>：根元素；<err>：错误信息；<redata>：返回数据；<refp>：一张红字信息表信息；<refpMx>：红字信息表明细；<mx>：一条具体的明细信息。内容和格式定义发票操作返回报文公用节点如下：序号字段名注释数据类型最大长度是否必填说明RETCODE错误代码字符100是RETMSG错误信息字符100是获取库存信息序号字段名注释数据类型最大长度是否必填说明FPHM发票号码字符20FPDM发票代码字符20KCFPSL发票库存数量数值JSSBRQ金税设备日期日期19格式yyyy-MM-ddhh:mm:ss年月日的格式以本地短时间格式为准XFSH销方税号字符20SCFS上传方式字符2固定值0：手动上传1：自动上传KPDH开票点号字符3CSQBZ是否已到抄税期字符2固定值0：未到抄税期1：已到抄税期SSQBZ是否已到锁死期字符2固定值0：未到抄税期1：已到锁死期KPFS开票方式字符2固定值0：单机开票1：服务器开票KPFWQH开票服务器号字符3JSPH金税盘号字符20XFMC销方名称字符100发票开具序号字段名注释数据类型最大长度是否必填说明JE金额数值16,2SE税额数值16,2KPRQ开票日期日期10格式yyyy-MM-ddFPDM发票代码字符20FPHM发票号码字符20SYZFPDM上一张发票代码字符20SYZFPHM上一张发票号码字符20SYZFPZL上一张发票种类字符2固定值：0：专用发票2：普通发票11：货运发票12：机动车票51：电子发票发票打印序号字段名注释数据类型最大长度是否必填说明FPZL发票种类字符2固定值：0：专用发票2：普通发票11：货运发票12：机动车票51：电子发票FPHM发票号码字符20FPDM发票代码字符20发票作废序号字段名注释数据类型最大长度是否必填说明FPZL发票种类字符2固定值：0：专用发票2：普通发票11：货运发票12：机动车票51：电子发票FPHM发票号码字符20FPDM发票代码字符20清单打印序号字段名注释数据类型最大长度是否必填说明FPZL发票种类字符2固定值：0：专用发票2：普通发票11：货运发票12：机动车票51：电子发票FPHM发票号码字符20FPDM发票代码字符20发票上传序号字段名注释数据类型最大长度是否必填说明FPHM发票号码字符20FPDM发票代码字符20发票状态更新序号字段名注释数据类型最大长度是否必填说明FPDM发票代码字符20FPHM发票号码字符20XLH序列号字符CODE错误代码字符MESS错误信息字符空白发票作废序号字段名注释数据类型最大长度是否必填说明FPZL发票种类字符2固定值：0：专用发票2：普通发票11：货运发票12：机动车票51：电子发票FPDM发票代码字符15FPHM发票号码字符15金税盘状态查询序号字段名注释数据类型最大长度是否必填说明Nsrsbh纳税人识别号字符20Bkpjlx本开票机类型字符1固定值0：主开票机1：开票机Fkpjsm分开票机数目字符100Kpdh开票点号字符100单机版时，是开票机号服务器版时，是服务器号Jssbdqrq金税设备当前日期日期8格式为yyyy-MM-ddFpsfyw发票是否用完字符1固定值0：无可用发票1：有可用发票Scjzrq上传截止日期字符1001至31例如：20，指每月20日Lxsx离线时限字符100单位：小时Qdcxbbh驱动程序版本号字符100Dccxbbh底层程序版本号字符100Jspbh金税盘编号字符20Bspbh报税盘编号字符20Bspdcbbh报税盘底层版本号字符100Hzfwsq汉字防伪授权字符1固定值0：非汉字防伪1：汉字防伪Fxsqxx发行授权信息字符1固定值0：无1：有Bsprl报税盘容量字符100Sfdcsq是否到抄税期字符1固定值0：未到抄税期1：已到抄税期Sfdssq是否到锁死期字符1固定值0：未到锁死期1：已到锁死期Zyfplxxe专用发票离线限额数值16,2Ptfplxxe普通发票离线限额数值16,2Zyfplxsyje专用发票离线剩余金额数值16,2Ptfplxsyje普通发票离线剩余金额数值16,2Zyfpkpxe专用发票开票限额数值16,2Ptfpkpxe普通发票开票限额数值16,2Ssrq锁死日期日期8格式为yyyy-MM-ddSccbrq上次报税日期日期12格式为yyyy-MM-ddHH:mmCsqsrq抄税起始日期日期8格式为yyyy-MM-ddBszl报税资料字符1固定值0：无1：有Bscgbz报税成功标志字符1固定值0：无1：有Grfpxx购入发票信息字符1固定值0：无1：有Thfpxx退回发票信息字符1固定值0：无1：有Lxxe离线限额数值16,2Lxsyje离线剩余金额数值16,2Dzkpxe单张开票限额数值16,2Yljkpxx月累计开票限额数值16,2Yljtpxx月累计退票限额数值16,2Byykfpje本月已开发票金额数值16,2Byyktpje本月已开发退票金额数值16,2打印参数设置打印参数设置返回报文只有公共节点，详见打印参数设置返回报文5.4.1.10。红字信息表上传序号字段名注释数据类型最大长度是否必填说明XXBLSH信息表流水号字符24XXBBH信息表编号字符XXBZTDM信息表状态代码字符TZD0000、TZD1000表示可以填开红票XXBZTMS信息表状态描述字符汇总抄报汇总抄报返回报文只有公共节点，详见汇总抄报返回报文5.4.1.12。远程清卡远程清卡返回报文只有公共节点，详见远程清卡返回报文5.4.1.13。红字信息表下载红字信息表头序号字段名注释数据类型最大长度是否必填说明XXBLSH信息表流水号字符24XXBBH信息表编号字符XXBZTDM信息表状态字符TZD0000、TZD1000表示可以填开红票XXBZTMS信息表描述字符XXBLX信息表类型字符2固定值：0：正常；

1：逾期(仅销方开具)LPDM对应蓝票代码字符LPHM对应蓝票号码字符SZLB税种类别字符2固定值1：增值税DSLBZ多税率标志字符2固定值0：一票一税率；1：一票多税率TKRQ填开日期日期10格式：yyyy-MM-ddGFMC购方名称字符GFSH购方税号字符20XFMC销方名称字符XFSH销方税号字符20HJJE合计金额数值16,2SLV税率数值10,6多税率时为空HJSE合计税额数值16,2SQSM申请说明字符十位数字表示的申请说明，含正常和逾期，固定值，详见说明。说明：红字信息表头中申请说明节点的取值表：申请方申请原因开票软件管理系统购方申请已抵扣110000000011未抵扣无法认证1011000000121纳税人识别号认证不符1010100000122增值税专用发票代码、号码认证不符1010010000123所供货物或劳务、服务不属于增值税扣税项目范围1010001000124销方申请因开票有误，购买方拒收的000000011021因开票有误等原因尚未交付的000000010122红字信息表明细序号字段名注释数据类型最大长度是否必填说明SPMC商品名称字符92是JLDW计量单位字符22否GGXH规格型号字符40否DJ单价数值36,15否SL数量数值36,15否JE金额数值16,2是SLV税率数值10,6是SE税额数值16,2是HSBZ含税标志字符2是固定值N：不含税Y：含税错误代码表序号错误代码错误原因-1控制台异常信息-2连接控制台异常！-3控制台ip或端口号为空！0操作成功关于本章节接口的特别说明关于发票上传接口和发票状态更新接口因为新版开票软件提供自动上传功能，该功能会自动将开具的发票状态上传到税局，如果上传失败，会一直执行上传动作，直至上传成功；并且会每隔一段时间自动轮询税局环境的发票状态，如果发票状态有更新，会自动下载发票状态，并更新客户端的发票状态；所以发票上传接口和发票状态更新接口，在新版开票软件中将不会使用到这两个接口，请知悉。开票服务器操作接口功能列表本接口提供的功能有：序号接口名称功能解释接口代码示例备注1开票服务器已开具发票明细查询接口实现开票服务器已开发票的查询功能publicStringqueryInvoice(Stringxml);2开票服务器发票卷分配退回历史信息查询接口实现开票服务器发票卷分配退回历史信息查询功能publicStringtrackSource(Stringxml);3开票服务器发票卷库存查询接口实现开票服务器发票卷库存查询功能publicStringqueryStock(Stringxml);4开票服务器发票作废接口实现开票服务发票作废功能publicStringwasteInvoice(Stringxml);5开票服务器发票分配接口实现开票服务器往终端分配发票的功能publicStringdistributeInvoice(Stringxml)6开票服务器发票退回接口实现终端往开票服务器退回发票的功能publicStringreturnInvoice(Stringxml)请求报文请求报文内容调用服务器接口，向服务器发送请求格式如下：序号接口名称请求报文样例1开票服务器已开具发票明细查询接口2开票服务器发票卷分配退回历史信息查询接口3开票服务器发票卷库存查询接口4开票服务器发票作废接口5开票服务器发票分配接口6开票服务器发票退回接口内容格式定义开票服务器已开具发票明细查询接口请求数据格式序号字段名注释数据类型最大长度说明1.IPIp地址字符2.PORT开票服务器端口字符3.NSRSBH纳税人识别号字符204.KPFWQH开票服务器号字符100表示主服务器5.KPDH开票点号字符106.FPZL发票种类数值20-增值税专用发票；2-增值税普通发票；11-货物运输业增值税专用发票；12-机动车销售统一发票7.StartDate起始开票日期字符10格式为“YYYY-MM-DD”8.EndDate截止开票日期字符10格式为“YYYY-MM-DD”9.FPDM发票代码字符2010.StartNO起始发票号码字符2011.EndNO截止发票号码字符2012.GFSH购方税号字符2013.GFMC购方名称字符10014.IsBlue1蓝字发票；0红字发票字符1蓝字发票；0红字发票15.ZFBZ作废标志字符1默认值是0，1表示已经作废，0.表示正常16.DYBZ打印标志字符1默认值是0，0：未打印，1：已打印17.QDBZ清单标志字符1默认值是0，0：无清单，1：有清单18.XSDJBH销售单据编号字符100若该发票是合并销售单开具的，则具有多个销售单据编号,销售单据编号间将用西文逗号隔开19.BSZT报送状态字符10：未报送，1：已报送，2：报送失败，3：报送中，4：验签失败20.StartIndex分页查询：起始索引号(从0开始)数值分页查询：起始索引号(从0开始)21.QueryCount分页查询：每页记录数，为空时查询全部数值分页查询：每页记录数，为空时查询全部开票服务器发票卷分配退回历史信息查询接口请求数据格式序号字段名注释数据类型最大长度说明1.IPIp地址字符2.PORT开票服务器端口字符3.NSRSBH纳税人识别号字符204.KPFWQH开票服务器号字符100表示主服务器5.FPZL发票种类数值20-增值税专用发票；2-增值税普通发票；11-货物运输业增值税专用发票；12-机动车销售统一发票6.StartDate起始开票日期字符10格式为“YYYY-MM-DD”7EndDate截止开票日期字符10格式为“YYYY-MM-DD”8.FPDM发票代码字符209.StartIndex分页查询：起始索引号(从0开始)数值分页查询：起始索引号(从0开始)10.QueryCount分页查询：每页记录数，为空时查询全部数值分页查询：每页记录数，为空时查询全部开票服务器发票卷库存查询接口请求数据格式序号字段名注释数据类型最大长度说明1.IPIp地址字符2.PORT开票服务器端口字符3.NSRSBH纳税人识别号字符204.KPFWQH开票服务器号字符100表示主服务器5.KPDH开票点号字符10开票服务器发票作废接口请求数据格式序号字段名注释数据类型最大长度说明1.IPIp地址字符2.PORT开票服务器端口字符3.NSRSBH纳税人识别号字符204.KPFWQH开票服务器号字符100表示主服务器5.KPDH开票点号字符106.FPDM发票代码字符207.FPHM发票号码字符20开票服务器发票分配接口请求数据格式序号字段名注释数据类型最大长度说明1.IPIp地址字符2.PORT开票服务器端口字符3.NSRSBH纳税人