码迷,mamicode.com
首页 > 其他好文 > 详细

接口系统

时间:2016-07-08 18:19:04      阅读:587      评论:0      收藏:0      [点我收藏+]

标签:

<<数据同步系统文档>>

数据同步系统主要用作 源系统 和 目标系统 两边系统进行数据的异步通信形式的同步.

主要任务:

  • 源系统以http形式发送报文A给本系统,本系统定时把报文A发送给目标系统.
  • 目标系统进入本系统进行定时任务的配置,本系统根据该配置定时向目标系统触发http请求,让目标系统进行自同步.

章节目录结构:

头部

  1. .HEAD规范.....

正文

  1. .保存数据接口(http通信).....
  2. ...口....

其它

  1. 定时任务配置

头部

1.HEAD规范

 

正文

1.保存数据接口(http通信)

功能说明: 源系统发送符合规范的报文给数据同步系统 数据同步系统把报文入库,每隔一段时间会把该报文发送给目标系统进行数据同步.

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": "50000001",
        "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

8

Y

 

00020373

交易机构编码

2

bdh

String

12

Y

 

115000000000

保单号

3

pdh

String

10

N

 

2016-06-13   

批单号

4

mobile

String

18

CY

 

156.00

手机号码(手机号和邮箱二选一必传)

5

mail

String

20

CY

 

500080000000020

邮箱地址(手机号和邮箱二选一必传)

 

 

 

 

 

 

 

 

 

 

 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": {
            "invoiceNumber": "00020373",
            "invoiceCode": "115000000000",
            "issueDate": "2016-06-13",
            "totalInTax": "156.00",
            "tax_num": "500080000000020"
        }
    },
    "requestHead": {
        "password": "123456",
        "userId": "50000001",
        "serviceNo": "4200000004",
        "flowId": "98123ff5-4b74-4f67-b178-58tf437d4458",
        "requestType": ""
    }
}

 

2.32返回报文

成功时:

{
    "returncode": "0000",
    "returnmsg": "电子发票开具成功,短信/邮件发送成功  ",
    "fpdm": "115000000000",
    "fphm": "00020389",
    "kprq": "20160617101418"
}

 

失败时:

{
    "returncode": "10011",
    "returnmsg": "电子发票开具成功, 邮件发送失败  ",
    "fpdm": "115000000000",
    "fphm": "00020389",
    "kprq": "20160617101418"
}

 

 

 

 

 

张建新 17:46:57

请求报文:
<?xml version="1.0" encoding="UTF-8"?>
<PACKET>
<HEAD>
<SERVICE_NAME>syncData</SERVICE_NAME>
</HEAD>

<BODY>
<C_DATA>
<![CDATA[
<example>do something</example>
]]>
</C_DATA>
<C_CRT_CDE>sys01</C_CRT_CDE>
<C_BIZ_ID>policypremiumfincall</C_BIZ_ID>接口编号
<C_BIZ_CODE>602199911992016000004</C_BIZ_CODE>业务单号
</BODY>

</PACKET>

返回报文:

<?xml version="1.0" encoding="UTF-8" ?>
<PACKET>
<HEAD>
<ERROR_CODE>0000</ERROR_CODE>
<ERROR_MESSAGE>同步成功</ERROR_MESSAGE>
</HEAD>
</PACKET>

<?xml version="1.0" encoding="UTF-8" ?>
<PACKET>
<HEAD>
<ERROR_CODE>1001</ERROR_CODE>
<ERROR_MESSAGE>Error on line 1 of document : 元素类型“C_DATA”必须用匹配的结束标记“</C_DATA>”终止。 Nested exception: 元素类型“C_DATA”必须用匹配的结束标记“</C_DATA>”终止。</ERROR_MESSAGE>
</HEAD>
</PACKET>
张建新 17:49:32

请求报文:
<?xml version="1.0" encoding="UTF-8"?>
<PACKET>
<HEAD>
<SERVICE_NAME>syncData</SERVICE_NAME>
</HEAD>

<BODY>
<C_DATA>
<![CDATA[
<example>do something</example>
]]>
</C_DATA>
<C_CRT_CDE>sys01</C_CRT_CDE>
<C_BIZ_ID>policypremiumfincall</C_BIZ_ID>接口注册编号<C_REGISTER_NO>
<C_BIZ_CODE>602199911992016000004</C_BIZ_CODE>业务单号
</BODY>

</PACKET>

返回报文:

<?xml version="1.0" encoding="UTF-8" ?>
<PACKET>
<HEAD>
<ERROR_CODE>0000</ERROR_CODE>
<ERROR_MESSAGE>同步成功</ERROR_MESSAGE>
</HEAD>
</PACKET>

<?xml version="1.0" encoding="UTF-8" ?>
<PACKET>
<HEAD>
<ERROR_CODE>1001</ERROR_CODE>
<ERROR_MESSAGE>Error on line 1 of document : 元素类型“C_DATA”必须用匹配的结束标记“</C_DATA>”终止。 Nested exception: 元素类型“C_DATA”必须用匹配的结束标记“</C_DATA>”终止。</ERROR_MESSAGE>
</HEAD>
</PACKET>

接口系统

标签:

原文地址:http://www.cnblogs.com/bobo1713930654/p/5654165.html

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!