通用电子缴税客户端软件POS机通讯接口规范.docVIP

附件 通用电子缴税客户端软件POS机通讯接口规范 使用COMPOS作为通用电子缴税的外围硬件设备。COMPOS将接受通用电子缴税客户端程序(Client)传递的各类命令，按照命令以及命令的参数指示，完成银行端扣款操作和其他辅助功能。 一、硬件接口 税务征管系统客户端与COMPOS 使用RS232异步通信协议通信。波特率9600，8 数据位，1 停止位，无奇偶校验。 （一）超时设定 会话过程 超时时间 银行卡缴税客户端发送指令等待POS应答 90秒 POS等待银行卡缴税客户端发送下一条指令 90秒 （二）通讯结构 1.通信结构为： STX (1byte) LEN (2byte) PATH (1byte) TIME (14byte) CMD (1byte) RESCODE (2byte) RESMSG (40byte) POSID (35byte) CONT (n byte) LRC (1byte) ETX (1byte) 2.说明 STX：报文起始标志符号，用0x02标识报文起始。 LEN：报文长度，代表从PATH报文域开始到CONT报文域结束的长度之和,2字节长度意义为左边第一字节为len/256，第二字节为len%256。 PATH: 数据流向属性，代表从一个节点流向另外一个节点。目前只有两个值，税务征管系统客户端到COMPOS为0x01，COMPOS到税务征管系统客户端为0x02。 TIME：发送节点的发送时间，便于查找交易，POS返回时不修改，格式为yyyymmddHHMMSS。 CMD：报文指令，用0x00，0x01，0x02等等标识不同含义的指令。 RESCODE：返回码，字符类型，右补空格，银联应答码， 请求时填充为空格；应答时，00代表交易成功，正确填写数据内容；其他代表交易失败，不填写数据内容，具体原因查看返回信息。 RESMSG：返回信息，字符类型，右补空格，银联应答码翻译信息。请求时填充为空格；应答时，返回错误原因描述。 POSID：POS机序列号，字符类型，右补空格，必须是唯一的。请求时填充为空格；应答时必须填写为POS机序列号。 CONT: 数据内容（有的指令数据内容是数字信封，有的指令数据内容不是数字信封），各种指令的数据内容不同。 LRC: 校验位，从PATH报文域开始到CONT报文域结束所有字节按位异或得到的结果。 ETX: 报文终止标志符号，用0x03标识报文结束。 二、指令报文 指令报文由通用电子缴税客户端程序发往COMPOS表示开始，COMPOS 成功接纳指令报文后，进行相应的操作，如果COMPOS不能成功接纳指令（如LRC 错误等）或者不能识别指令，则会将数据直接抛弃。 每次数据交互都要使用一种报文指令，不同业务需求对应的报文指令不同，报文指令说明如下： 指令类型 指令名字 备注 0x00 连接测试指令 PC客户端发送测试内容到COMPOS，COMPOS收到以后在COMPOS屏幕上显示收到的内容，然后回应信息。 0x01 认证请求 PC客户端发送客户端认证请求指令，COMPOS收到以后，调用PSAM卡生成客户端认证请求。 0x02 生成客户认证凭据 PC客户端发送验证数据包指令，COMPOS收到以后，对接收到的服务器响应数据包进行认证后，调用PSAM卡生成客户端验证数据包 0x03 取加密证书 PC客户端发送取加密证书指令，COMPOS收到以后，返回从PSAM卡中取出的加密证书和POS机序列号。 0x04 保存服务器加密证书指令 PC客户端发送保存服务器加密证书指令，COMPOS调用PSAM卡将认证服务器加密证书保存至POS机Flash中。 0x05 应征指令 PC客户端通过数字信封把业务内容发送给COMPOS，COMPOS通过银联网络查询应征信息，然后通过数字信封返回给PC客户端。 0x06 扣款指令 PC客户端通过数字信封把业务内容发送给COMPOS，COMPOS解开数字信封，根据是否扣款通过银联网络进行扣款，然后通过数字信封把扣款结果返回给PC客户端。 （0x00、0x01、0x02、0x03、0x04指令都不需要使用数字信封，业务内容是按照固定格式直接放在数据内容域，0x05、0x06指令是通过数字信封传送业务内容。） (一)连接测试指令 1.发送信息 发送方式：由银行卡缴税客户端程序(Client)通过RS232串行接口向COMPOS发送。 功能：用于测试银行卡缴税客户端与POS机链路的连通性 CMD： 类型 长度 值 备注 指令 1 0x00 CONT： 类型 长度 值 备注 信息内容 60 可以让操作员输入，也可以设为定值，在POS机屏幕显示,收到信息：（换行）内容 2.返回信息 发送方式：由COMPOS通过RS232串行接口