电子发票 - 电子服务平台接口.pdf

概述

电子发票服务平台支持增值税管理系统（开票管理系统），提供相关业务数据处理能力以及各种

增值服务，同时提供各种接口方便各种系统与平台间集成。

接口规范遵循以下标准：

1.所有接口采用https协议保证传输安全。

2.电子发票生成接口采用授权码方式进行访问控制。

3.查询接口采用OAuth2认证方式，保证接口访问的安全性。

4.接口采用Restfulweb服务，支持XML和JSON数据格式。

相关报文见《第一章接口规范》。

1.接口规范

1.1.接口描述

本节详细描述电子发票服务平台提供的与税控发票开票软件（或增值税管理系统）和其他

业务系统之间的数据接口格式规范。

1.2.数据交互接口规范

接口设计为以XML或JSON格式字符串作为参数传递和返回格式。具体格式请以具体接

口描述为准。

1.2.1.电子发票开具接口

请求地址：

POSThttp://x.x.x.x:port/einvoice/handle/save

此服务是前置系统的服务，是内网，所以不需要认证

请求体：

索引ID名称长度必须说明

1对应唯一一笔开票业务，

LSH交易流水号20是

20位数字

2ZDDH订单号码20是

3KPLX开票类型4否0-蓝字发票；1-红字发票

4XSF_NSRS销售方纳税人识别号20是

BH

5XSF_MC销售方名称100是

6XSF_DZ销售方地址100是

7XSF_DH销售方电话100是

8XSF_YHZH销售方银行账号100否

9GMF_NSRS购买方纳税人识别号20否

BH

10GMF_MC购买方名称100是

11GMF_DZ购买方地址100否

12GMF_DH购买方电话100否

13GMF_YHZH购买方银行账号100否

14KPR开票人8是

15SKR收款人8否

16FHR复核人8否

17YFP_DM原发票代码12否红字发票时不可为空

18YFP_HM原发票号码8否红字发票时不可为空

19JSHJ价税合计是单位：元（2位小数）

20HJJE合计金额否不含税，单位：元（2位

小数）

21HJSE合计税额