<<海闻电子发票接口 ESB 封装文档>>

章节目录结构:

  1. 发票验证接口
  2. 发票开具接口

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

mail

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 封装文档>>的更多相关文章

  1. 简单物联网:外网访问内网路由器下树莓派Flask服务器

    最近做一个小东西,大概过程就是想在教室,宿舍控制实验室的一些设备. 已经在树莓上搭了一个轻量的flask服务器,在实验室的路由器下,任何设备都是可以访问的:但是有一些限制条件,比如我想在宿舍控制我种花 ...

  2. 利用ssh反向代理以及autossh实现从外网连接内网服务器

    前言 最近遇到这样一个问题,我在实验室架设了一台服务器,给师弟或者小伙伴练习Linux用,然后平时在实验室这边直接连接是没有问题的,都是内网嘛.但是回到宿舍问题出来了,使用校园网的童鞋还是能连接上,使 ...

  3. 外网访问内网Docker容器

    外网访问内网Docker容器 本地安装了Docker容器,只能在局域网内访问,怎样从外网也能访问本地Docker容器? 本文将介绍具体的实现步骤. 1. 准备工作 1.1 安装并启动Docker容器 ...

  4. 外网访问内网SpringBoot

    外网访问内网SpringBoot 本地安装了SpringBoot,只能在局域网内访问,怎样从外网也能访问本地SpringBoot? 本文将介绍具体的实现步骤. 1. 准备工作 1.1 安装Java 1 ...

  5. 外网访问内网Elasticsearch WEB

    外网访问内网Elasticsearch WEB 本地安装了Elasticsearch,只能在局域网内访问其WEB,怎样从外网也能访问本地Elasticsearch? 本文将介绍具体的实现步骤. 1. ...

  6. 怎样从外网访问内网Rails

    外网访问内网Rails 本地安装了Rails,只能在局域网内访问,怎样从外网也能访问本地Rails? 本文将介绍具体的实现步骤. 1. 准备工作 1.1 安装并启动Rails 默认安装的Rails端口 ...

  7. 怎样从外网访问内网Memcached数据库

    外网访问内网Memcached数据库 本地安装了Memcached数据库,只能在局域网内访问,怎样从外网也能访问本地Memcached数据库? 本文将介绍具体的实现步骤. 1. 准备工作 1.1 安装 ...

  8. 怎样从外网访问内网CouchDB数据库

    外网访问内网CouchDB数据库 本地安装了CouchDB数据库,只能在局域网内访问,怎样从外网也能访问本地CouchDB数据库? 本文将介绍具体的实现步骤. 1. 准备工作 1.1 安装并启动Cou ...

  9. 怎样从外网访问内网DB2数据库

    外网访问内网DB2数据库 本地安装了DB2数据库,只能在局域网内访问,怎样从外网也能访问本地DB2数据库? 本文将介绍具体的实现步骤. 1. 准备工作 1.1 安装并启动DB2数据库 默认安装的DB2 ...

  10. 怎样从外网访问内网OpenLDAP数据库

    外网访问内网OpenLDAP数据库 本地安装了OpenLDAP数据库,只能在局域网内访问,怎样从外网也能访问本地OpenLDAP数据库? 本文将介绍具体的实现步骤. 1. 准备工作 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 ...

  2. 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 ...

  3. Win8环境下 IIS6部署MVC网站出现的无法显示此网页错误

    在Win7环境下做好的网站,新的Win8环境发布出现如下图错误: 解决方法如下: 运行:

  4. Web程序员最常用的11款PHP框架

    PHP框架是Web程序员和开发人员最为有用的工具. PHP框架可以帮助用户更快地开发项目. 今天我将为开发人员带来几款最好的PHP框架,希望能对你有用. 1.Agavi Agavi是一款强大的,可扩展 ...

  5. ubuntu搭建DNS

    ubuntu搭建DNS 一.     bind简介: BIND是Domain Name System (DNS) 协议的一个实现,提供了DNS主要功能的开放实现,主要包括以下三种: *域名服务器 *D ...

  6. BZOJ 2151 种树

    贪心+priority_queue. #include<iostream> #include<cstdio> #include<cstring> #include& ...

  7. [反汇编练习] 160个CrackMe之026

    [反汇编练习] 160个CrackMe之026. 本系列文章的目的是从一个没有任何经验的新手的角度(其实就是我自己),一步步尝试将160个CrackMe全部破解,如果可以,通过任何方式写出一个类似于注 ...

  8. jQuery.validate API

  9. TextView及其子类

    1.TextView控件(TextView是EditView.Button等类的父类) <1>android:id   给当前控件定义了一个唯一标识符 <2>android:l ...

  10. 如何自定义一个优雅的ContentProvider

    最近在code review的时候发现很多人的provider定义的不是很好,写的很粗糙 以至于代码健壮性不够好,可读性也不强 但是你既然写了content provider 就是要给别人调用的,如果 ...