<<海闻电子发票接口 ESB 封装文档>>
<<海闻电子发票接口 ESB 封装文档>>
章节目录结构:
ESB请求地址:
发票验证接口: | http://10.15.22.120:8866/4200000003/ValidateInvoice/V1 |
发票开具接口: | http://10.15.22.120:8866/4200000004/IssueElectronicInvoice/V1 |
正文
1.发票验证接口
功能说明:验证请求系统在json报文体中发送的信息是否有效.
1.1请求格式:
节点:{base}
说明:主要包含【发票号码,发票代码,开票日期,发票金额】等信息.
No. |
字段名 |
类型 |
大小 |
必填 |
默认值 |
参考值 |
说明 |
1 |
invoiceNumber |
String |
8 |
Y |
00020373 |
发票号码 |
|
2 |
invoiceCode |
String |
12 |
Y |
115000000000 |
发票代码 |
|
3 |
issueDate |
String |
10 |
Y |
2016-06-13 |
开票日期 格式YYYY-MM-DD |
|
4 |
totalInTax |
String |
18 |
Y |
156.00 |
发票金额 (海闻未说明具体精确值) |
|
5 |
tax_num |
String |
20 |
N |
500080000000020 |
税号 |
1.2返回格式:
节点:直接根节点下,因为返回时不受控制,直接是海闻返回的原始信息
说明:返回成功和失败等信息.
补充说明:下面两个节点虽然配置为非必反,但其实按海闻的意思是成功时只返回invoiceNumber,失败时只返回code
No. |
字段名 |
类型 |
大小 |
必反 |
默认值 |
参考值 |
说明 |
1 |
invoiceNumber |
V |
5 |
N |
false |
是否有效标志;参考代码 |
|
2 |
code |
V |
100 |
N |
INVOICE_QUERY_FACTORS_INCOMPLETE |
海闻错误说明;参考代码 |
1.3交互范文
1.31请求报文
{ "requestBody": { "base": { "invoiceNumber": "00020373", "invoiceCode": "115000000000", "issueDate": "2016-06-13", "totalInTax": "156.00", "tax_num": "500080000000020" } }, "requestHead": { "password": "123456", "userId": "50000002", "serviceNo": "4200000003", "flowId": "68123ff5-eb74-4f67-b078-52bf437d4650", "requestType": "" } }
1.32返回报文
成功时:
{"isValid": true}
失败时:
{"code": "INVOICE_QUERY_FACTORS_INCOMPLETE"}
2.发票开具接口
功能说明:请求系统发送的json报文体是否符合开电子发票的要求.
2.1请求格式:
节点:{base}
说明:主要包含【交易机构编码,保单号,批单号,手机号,邮箱地址,实现电子发票开具,短信或邮件】等信息.
No. |
字段名 |
类型 |
大小 |
必填 |
默认值 |
参考值 |
说明 |
1 |
qydjid |
String |
未说明 |
Y |
00 |
交易机构编码 |
|
2 |
bdh |
String |
未说明 |
Y |
299320903312016001291 |
保单号 |
|
3 |
pdh |
String |
未说明 |
N |
2016-06-13 |
批单号 |
|
4 |
mobile |
String |
未说明 |
CY |
13735375668 |
手机号码(手机号和邮箱二选一必传) |
|
5 |
|
String |
未说明 |
CY |
jbjin2@isoftstone.com |
邮箱地址(手机号和邮箱二选一必传) |
2.2返回格式:
节点:直接根节点下,因为返回时不受控制,直接是海闻返回的原始信息
说明:返回成功和失败等信息.
补充说明:下面两个节点虽然配置为非必反,但其实按海闻的意思是成功时只返回invoiceNumber,失败时只返回code
No. |
字段名 |
类型 |
大小 |
必反 |
默认值 |
参考值 |
说明 |
1 |
returncode |
V |
10 |
Y |
10011 |
返回代码;参考代码 |
|
2 |
returnmsg |
V |
100 |
Y |
电子发票开具成功, 邮件发送失败 |
返回信息 |
|
3 |
fpdm |
V |
12 |
CY |
115000000000 |
发票代码(成功时必返回) |
|
4 |
fphm |
V |
8 |
CY |
00020389 |
发票号码(成功时必返回) |
|
5 |
kprq |
V |
14 |
CY |
20160617101418 |
开票日期YYYYMMDDHHMMSS (成功时必返回) |
2.3交互范文
2.31请求报文
{ "requestBody":{ "base":{ "qydjid":"00", "bdh":"299320903312016001291", "pdh":"", "mobile":"13735375668", "mail":"jbjin2@isoftstone.com" } }, "requestHead": { "password": "123456", "userId": "50000002", "serviceNo": "4200000004", "flowId": "68123ff5-eb74-4f67-b078-52bf437d4650", "requestType": "" } }
2.32返回报文
成功时:
{ "returncode": "0000", "returnmsg": "电子发票开具成功,短信/邮件发送成功 ", "fpdm": "115000000000", "fphm": "00020389", "kprq": "20160617101418" }
失败时:
{ "returncode": "10011", "returnmsg": "电子发票开具成功, 邮件发送失败 ", "fpdm": "115000000000", "fphm": "00020389", "kprq": "20160617101418" }
<<海闻电子发票接口 ESB 封装文档>>的更多相关文章
- 简单物联网:外网访问内网路由器下树莓派Flask服务器
最近做一个小东西,大概过程就是想在教室,宿舍控制实验室的一些设备. 已经在树莓上搭了一个轻量的flask服务器,在实验室的路由器下,任何设备都是可以访问的:但是有一些限制条件,比如我想在宿舍控制我种花 ...
- 利用ssh反向代理以及autossh实现从外网连接内网服务器
前言 最近遇到这样一个问题,我在实验室架设了一台服务器,给师弟或者小伙伴练习Linux用,然后平时在实验室这边直接连接是没有问题的,都是内网嘛.但是回到宿舍问题出来了,使用校园网的童鞋还是能连接上,使 ...
- 外网访问内网Docker容器
外网访问内网Docker容器 本地安装了Docker容器,只能在局域网内访问,怎样从外网也能访问本地Docker容器? 本文将介绍具体的实现步骤. 1. 准备工作 1.1 安装并启动Docker容器 ...
- 外网访问内网SpringBoot
外网访问内网SpringBoot 本地安装了SpringBoot,只能在局域网内访问,怎样从外网也能访问本地SpringBoot? 本文将介绍具体的实现步骤. 1. 准备工作 1.1 安装Java 1 ...
- 外网访问内网Elasticsearch WEB
外网访问内网Elasticsearch WEB 本地安装了Elasticsearch,只能在局域网内访问其WEB,怎样从外网也能访问本地Elasticsearch? 本文将介绍具体的实现步骤. 1. ...
- 怎样从外网访问内网Rails
外网访问内网Rails 本地安装了Rails,只能在局域网内访问,怎样从外网也能访问本地Rails? 本文将介绍具体的实现步骤. 1. 准备工作 1.1 安装并启动Rails 默认安装的Rails端口 ...
- 怎样从外网访问内网Memcached数据库
外网访问内网Memcached数据库 本地安装了Memcached数据库,只能在局域网内访问,怎样从外网也能访问本地Memcached数据库? 本文将介绍具体的实现步骤. 1. 准备工作 1.1 安装 ...
- 怎样从外网访问内网CouchDB数据库
外网访问内网CouchDB数据库 本地安装了CouchDB数据库,只能在局域网内访问,怎样从外网也能访问本地CouchDB数据库? 本文将介绍具体的实现步骤. 1. 准备工作 1.1 安装并启动Cou ...
- 怎样从外网访问内网DB2数据库
外网访问内网DB2数据库 本地安装了DB2数据库,只能在局域网内访问,怎样从外网也能访问本地DB2数据库? 本文将介绍具体的实现步骤. 1. 准备工作 1.1 安装并启动DB2数据库 默认安装的DB2 ...
- 怎样从外网访问内网OpenLDAP数据库
外网访问内网OpenLDAP数据库 本地安装了OpenLDAP数据库,只能在局域网内访问,怎样从外网也能访问本地OpenLDAP数据库? 本文将介绍具体的实现步骤. 1. 准备工作 1.1 安装并启动 ...
随机推荐
- core--线程同步(内核模式)
什么是内核?windows操作系统为了更好的管理进程,线程,创建了很多数据结构,这些数据结构运行在windows的底层,并不开放给开发人员:所以开发人员称这些结构为内核,但是为了开发人员能够使用,wi ...
- Node Security
发一个很早之前做的一个小东西-安全管理软件-可以对U盘进行管理,对后台程序进行扫描.分析!
- windows 勾子简介
近段时间因朋友催促让试着写一个监控系统,主要是用来管理孩子使用电脑,帮助孩子合理使用电脑.在网上查询了相关内容发现没有这方面的资料,所以只有自已来试试,要用到钩子来对windows应用程序进行监控,也 ...
- [转] POJ图论入门
最短路问题此类问题类型不多,变形较少 POJ 2449 Remmarguts' Date(中等)http://acm.pku.edu.cn/JudgeOnline/problem?id=2449题意: ...
- [Swift 语法点滴]—— Struct Vs Class
摘自:stackoverflow.com/questions/24232799/why-choose-struct-over-class Structure instances are always ...
- 解决android sdk manage打开闪退的解决方法
在打开android sdk mangage.exe的时候,一闪而过,在eclipse中出现如下提示: [2015-07-20 13:42:23 - SDK Manager] [SDK Manager ...
- 用 Xcode 开发 Cydia Substrate 插件(二)
上次介绍了一个如何用 Xcode 来构建 Substrate 插件,但是开发的具体过程还没有涉及,而这往往又正是初学者最难下手的地方,所以有了本文的后续. 不过在开始之前你要先做好思想准备,相比较开发 ...
- 用xsd验证xml
using System; using System.Text; using System.Xml; namespace WebApplication1 { public partial class ...
- linux 修改时间 - [命令操作]
我们一般使用“date -s”命令来修改系统时间.比如将系统时间设定成1996年6月10日的命令如下. #date -s 06/10/96 将系统时间设定成下午1点12分0秒的命令如下. #date ...
- codeforces 340B Maximal Area Quadrilateral(叉积)
事实再一次证明:本小菜在计算几何上就是个渣= = 题意:平面上n个点(n<=300),问任意四个点组成的四边形(保证四条边不相交)的最大面积是多少. 分析: 1.第一思路是枚举四个点,以O(n4 ...