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