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

<<海闻电子发票接口 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"
}