开发指南

简述

本能力接口所用环境地址和请求方式，与收票产品略有不同，本文针对这些不同点做描述。

适用范围

适用于航天信息金税盘或百望税控盘设备, 或已经对接本接口但想开数电票的客户。
适用发票云组件版本： 1.2.4或更新

环境地址

• 测试环境：https://api-sit.piaozone.com/test/bill-websocket/v3/invoicewebsocket/push
• 生产环境：https://api.piaozone.com/bill-websocket/v3/invoicewebsocket/push

注意：如果用本api平台做测试，请选择用“wss测试环境v3”或“wss生产环境v3”

请求方式

本能力的所有API在同一个环境下的调用地址都是相同的（地址如上节所示），不同API是通过body参数中的request_path进行区分。

连接方式（只针对税盘）

有两种连接方式：

1. IP直连方式
   适用于局域网内的HTTP调用方式，默认端口为 61624

2. 通过接口长连接方式调用
   这种方式下，税盘下票需要增加name参数，参数值=client_secret+盘号。
   例子：

• 接口地址：https://api.piaozone.com/bill-websocket/invoicewebsocket/push
• client_secret（发票云授权信息） ：3de1f420ed08409bbc3d4b9a156b4945
• 盘号为：3312345667
  则链接地址为https://api.piaozone.com/bill-websocket/invoicewebsocket/push?name=3de1f420ed08409bbc3d4b9a156b49453312345667