<<海闻电子发票接口 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 安装并启动 ...
随机推荐
- As of ADT 14, resource fields cannot be used as switch cases
在导入Android Sample的ApiDemos的时候,发现R.id.xx的文件不能够在 switch cases 中使用 在google查询了下,找到以下答案: As of ADT 14 ...
- in command-line: path> mvn eclipse:clean path> mvn -Dwtpversion=1.5 eclipse:eclipse path> mvn eclipse:eclipse in eclipse: Project / clean...
原因:tomcat已经启动了 2007-10-9 12:26:16 org.apache.coyote.http11.Http11AprProtocol init严重: Error initializ ...
- Win8环境下 IIS6部署MVC网站出现的无法显示此网页错误
在Win7环境下做好的网站,新的Win8环境发布出现如下图错误: 解决方法如下: 运行:
- Web程序员最常用的11款PHP框架
PHP框架是Web程序员和开发人员最为有用的工具. PHP框架可以帮助用户更快地开发项目. 今天我将为开发人员带来几款最好的PHP框架,希望能对你有用. 1.Agavi Agavi是一款强大的,可扩展 ...
- ubuntu搭建DNS
ubuntu搭建DNS 一. bind简介: BIND是Domain Name System (DNS) 协议的一个实现,提供了DNS主要功能的开放实现,主要包括以下三种: *域名服务器 *D ...
- BZOJ 2151 种树
贪心+priority_queue. #include<iostream> #include<cstdio> #include<cstring> #include& ...
- [反汇编练习] 160个CrackMe之026
[反汇编练习] 160个CrackMe之026. 本系列文章的目的是从一个没有任何经验的新手的角度(其实就是我自己),一步步尝试将160个CrackMe全部破解,如果可以,通过任何方式写出一个类似于注 ...
- jQuery.validate API
- TextView及其子类
1.TextView控件(TextView是EditView.Button等类的父类) <1>android:id 给当前控件定义了一个唯一标识符 <2>android:l ...
- 如何自定义一个优雅的ContentProvider
最近在code review的时候发现很多人的provider定义的不是很好,写的很粗糙 以至于代码健壮性不够好,可读性也不强 但是你既然写了content provider 就是要给别人调用的,如果 ...