开发指南 – 百旺税通

《开发指南》

1、所有的调用都采用POST方式。

2、除了获取token接口外，都需要带参数token（小写）或者将token放到Header。

3、本文档api说明是以表单方式传值编写，body内容为：参数1=值1&参数2=值…… 方式传送。

4、系统支持表单形式传报文，也支持json格式传报文：

4.1 表单形式传报文时：Content-Type：application/x-www-form-urlencoded;charset=UTF-8。

本api说明是以表单的形式进行说明。

4.2 json形式传报文时：Content-Type：application/json;charset=UTF-8。

当采用json传报文时，url需要带上 spid及token(token可放到Authorization中），

示例：获取开票结果url:

url: https://mycst.cn/NEWKP/KPGL/KPJG?spid=XXX&token=[XXX]

body:

{

“fpzl”:”021″,

“xtlsh”:”1111″,

“ver”:”2″

}

5、返回值是以JSON形式返回，返回值中都有Result和Message节点，Result=1时，表示调用成功，0表示失败，Message,为调用信息。

6、请求体的参数字都是用小写，报文中参数字段用大写。

7、参数字段说明中，如果没有 “是否必需” 这一列，说明是必需要有的。

8、所有用到Base64的地方，都采用utf-8字符集加密。

9、有效期为一年，每次新的获取token，在原有token没失效的情况下，返回的是原来的有效token，在调用业务api时，如果Code返回2001-2009，那么需要重新获取一次token

注：在一些业务接口调用中，不一定会有Code节点，但在失效时，肯定有Code节点

token失效的返回报文如下：

{

“Result”: “0”,

“Code”: “2003”,

“Message”: “会话超时”

}

10、当参数需要进行base64编码时，base64报文后加[]括号起来，如：data=[W3sieHRsc2giOiIwMDAxMzI2MDQzIiwiZnB6bCI6IjAyMSJ9XQ==]

11、涉及到的日期格式，由票帮手返回的格式都是yyyy-MM-dd HH:MM:ss或yyyy-MM-dd，业务系统传过来的日期格式可以是yyyy-mm-dd HH:mm:ss也可以是 mm/dd/yyyy HH:mm:ss，也即是说，不限定格式，票帮手会自动进行解析。

12、由业务系统传给票帮手的字段，可以按字符来传值，金额，数量，税额等数值，货币相关的内容，当然也可以按数值形式来传，票帮手自动做转换。

《开票流程》

《省份代码》

《特定业务信息》

1、开特定业务时需填写，填写地区或某些类型内容，可点击查看下载特定业务内容选项表格。

《税收分类编码》

1、开具发票每个产品需填写税收分类编码(FLBM)，可点击查看下载税收分类编码表格。

《发票种类》

序号	税局编码	票帮手编码	类型	票种说明
1	81	020	数电	数电票（增值税专用发票）
2	82	021	数电	数电票（普通发票）
3	83	035	数电	数电（机动车销售发票）
4	87	036	数电	数电纸质发票（机动车销售统一发票）
5	84	037	数电	数电（二手车统一销售发票）
6	88	038	数电	数电纸质发票（二手车销售统一发票）
7	85	022	数电	数电纸质发票（增值税专用发票）
8	86	023	数电	数电纸质发票（普通发票）
9	08	028		增值税电子专用发票
10	10	026		增值税电子普通发票
11	01	004		增值税专用发票
12	04	007		增值税普通发票
13	03	005		机动车销售统一发票
14	15	006		二手车销售统一发票
15	11	008		增值税普通发票（卷式）
16	14	009		道路通行费电子普通发票
17	61	011	数电	数电票（航空运输电子客票行程单）
18	51	012	数电	数电票（铁路电子客票）
19	59	013	数电	数电票（通行费发票）