<<海闻电子发票接口 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 安装并启动 ...
随机推荐
- c#调用系统资源大集合-2
public static void 打开格式化对话框() { Process.Start("rundll32.exe"," shell32.dll,SHFormatDr ...
- laravel, Composer和autoloading
http://www.php-fig.org/psr/psr-4/ http://www.php-fig.org/psr/psr-0/ http://alanstorm.com/laravel_com ...
- R语言多重共现性的检测
1.kappa值 2. library(car)vif(lm.sol) 得到各个系数的方差膨胀因子,当0<VIF<10的时候,不存在多重共线性,当10<=VIF<100,存在较 ...
- Java中String 的equals 和==详解
一.Java中数据存储区域包括: 1.寄存器:最快的存储区,由编译器根据需求进行分配,我们在程序中无法控制. 2. 栈:存放基本类型的变量数据和对象的引用,但对象本身不存放在栈中,而是存放在堆(new ...
- 如何使用USB安装XenServer 6.x
在XenServer 5.6以前我们能够很容易的通过一些工具,直接制作USB安装介质,然后快速安装XenServer,但是我们发现,到XenServer6.0以后,通过工具直接制作的XenServer ...
- 使用NPOI创建Excel文件
Public Sub BuildExcel() '写入内容到Excel Dim hssfworkbook As HSSFWorkbook = WriteExcel() Dim destFileName ...
- (转)每天一个Linux命令(8): tar
通过SSH访问服务器,难免会要用到压缩,解压缩,打包,解包等,这时候tar命令就是是必不可少的一个功能强大的工具.linux中最流行的tar是麻雀虽小,五脏俱全,功能强大. tar命令可以为linux ...
- java中对浮点数精度的处理DecimalFormat
DecimalFormat是一个队浮点数进行格式化输出的利器,比如我们要输出一个保留一位小数的浮点数,可以键入如下代码: DecimalFormat df = new DecimalFormat(&q ...
- Struts2 的 helloworld
配置步骤: 1.在你的strut2目录下找到例子项目,把它的 lib 下的jar拷贝到你的项目.例如我的:struts-2.3.24\apps\struts2-blank 2.struts-2.3.2 ...
- 内存泄露(OOM)现象及举例
一.HeapSize OOM(堆空间内存溢出) A.eg:List.add(" ")在一个死循环中不断的调用add却没有remove. B.并发导致. 解决方法有:1.代码提速.这 ...