数电票开具能力

数电销项发票是一套完整的增值税发票全面数字化电子发票（简称：数电票）的开放平台API，采用云端接口的方式提供了数电票自动化开具的能力，为企业业务系统的发票开具、查询、下载等需求提供快速的API接入服务。

业务场景

推荐应用示例：自持登录开票模式

数电票统一报文格式

1、说明

销项发票接口统一使用本接口所描述报文格式。

2、HTTP REST API接入方式

HTTP接口调用方法，请参考开放平台接口调用接入介绍。

3、JAVA SDK接入方式

参数名称	参数类型	是否必填	说明
appKey	String	是	您在企享云申请的appkey
secret	String	是	您在企享云申请的secret
apiHost	String	是	企享云API地址，分开发环境、测试环境、生产环境
path	String	是	接口路径，详见各个接口介绍中的接口地址示例1: /v2/invoice/qdfp/fpkj_zzs, 则path传 /v2/invoice/qdfp/fpkj_zzs 示例2：/v2/invoice/qdfp/fpcx，则path传 /v2/invoice/qdfp/fpcx
reqStr	String	是	请求的业务结构体JSON格式，详见本节第4点：传入参数

4、传入参数

参数说明
请求参数为JSON格式:

参数名称	参数类型	是否必填	说明
action	String	否	操作类型代码，详见各接口的参数描述，如您已对接的是最新的接口定义，则接口路径中已包含操作类型代码，可省略该action参数
nsrsbh	String	是	您需要开具或查询全电发票的税号
async	String	否	是否异步模式true-异步;false-同步，异步模式下，所有接口访问将立即反回一个请求ID，后续您可以通过请求ID查询业务处理结果，包含两种方式： 1、主动查询：调用方主动调用异步请求结果查询接口获取结果； 2、回调通知：企享云在业务处理完毕后会将结果主动推送到您的回调网址。
data	String	是	业务参数数据，详见各接口的传入参数描述

请求参数示例

5、返回结果

返回结果为JSON格式:

参数名称	参数类型	是否必填	说明
reqId	String	是	请求时的全局ID(可用于日志记录，无其他作用)
success	Boolean	是	业务处理是否成功
code	String	是	结果代码, 参考本节第7部份错误代码介绍
message	String	是	业务处理失败的详细信息
data	Object	是	发票业务结果数据， success=true时有值具体的返回数据，详见各接口的返回数据描述

1)、同步请求成功后的返回结果示例

2)、异步请求成功后的返回结果示例

(异步调用时，请求发送到云端立即返回，后续请使用回调监听或主动查询业务处理结果)

3)、请求失败后的返回结果示例

6、操作类型(action)

详见各接口的url(操作类型代码)参数。

7、错误码代码

code码分类说明：

2000：业务成功

2001：同转异，返回requestId需要走异步查询结果轮询或回调通知

720010：开票调用电子税局超时，返回requestId需要走异步查询结果轮询或回调通知

其他7开头的：业务失败，具体失败看msg

个别特殊可能遇到的场景：服务波动网关超时导致异步没有返回requestId，这种视为异常，重新请求开具一定不要更换来源订单编号即可

错误代码	错误信息	说明
2000	业务成功	业务正常返回无错误
2001	任务成功	发票请求超时，针对同步转异步的情况
~~000000~~	业务成功	v1版本表示业务成功，v2已弃用
720000	常规错误	具体错误信息参考message字段信息
720002	参数错误	传入的参数不符合要求
720004	数据已存在	开具发票时，相同的订单只能调用一次
720005	局端返回未知错误	通常是局端500错误等
720006	开票员不在线或登录失效	未成功登录平台
720016	登录失败	未成功登录平台
720007	开票员须扫脸认证
710001	与局端HTTP通讯异常
710002	局端返回已知错误	具体错误信息参考message字段
710003	开具金额较大，请确认是否开具	具体错误信息参考message字段
710004	当前未查询到购买方纳税人信息，请确认是否继续开具	具体错误信息参考message字段
710005	尊敬的纳税人，从贵公司开具的农产品收购发票分析，可能存在农产品收购发票开具不规范的情况，请按照《中华人民共和国增值税暂行条例》及其实施细则、《中华人民共和国发票管理办法》及其实施细则等规定开具农产品收购发票。	ncpzrcgzConfirm 确认参数传 1 后，重试开具
710021	红字申请时原蓝票不存在或没有可红冲的金额
710024	该发票存在进行中的红字确认单
710022	红字发票开具失败
730001	内部调用失败	企享云内部服务异常
700000	异步请求已发起不可重复发起
700001	异步请求失败
700002	异步请求超时
700003	业务异步请求时回写结果失败
700009	业务异步请求时系统正忙
720010	开票调用电子税局超时
720030	小规模纳税人开具3%征收率发票,请选择放弃享受减按1%征收率原因!
720031	建筑服务发生地与销售方注册地址未在同一县市，您当前选择的跨地市标志为“否”，请确认是否开具?
720032	税务局系统升级后限制了频繁切换企业或身份的操作，您当前小时切换次数已用完，请1小时后再试
720033	税务局系统升级后限制了登录发短信次数，您当前小时发短信次数已用完，请1小时后再试
720034	税务局系统升级后限制了频繁切换企业或身份的操作，您当前切换次数已用完，请稍后再办理业务
其他代码	网关接入错误，请参考message返回信息

开票-接入示例

业务场景#

推荐应用示例：自持登录开票模式#

数电票统一报文格式#

1、说明#

2、HTTP REST API接入方式#

3、JAVA SDK接入方式#

4、传入参数#

5、返回结果#

1)、同步请求成功后的返回结果示例#

2)、异步请求成功后的返回结果示例#

3)、请求失败后的返回结果示例#

6、操作类型(action)#

7、错误码代码#