正向同步PROVISION接口消息定义
• 功能描述
此接口在MISC因为某种情况更新了用户订购关系(包括订购、取消、暂停、激活)的时候,通过此接口发起和SP的更新订购关系的交互。
消息名
消息类型
消息方向
SyncOrderRelationReq
Request
MISCàSP
SyncOrderRelationResp
Response
SPàMISC
• 接口内容描述
SyncOrderRelationReq消息字段描述:
返回定义
重要性
类型
说明
MsgType
必须
string
消息类型
TransactionID
必须
string
该消息编号
Version
必须
string
该接口消息的版本号,本次所有的接口消息的版本都
为“1.5.0”
Send_Address
必须
address_info_schema
发送方的地址
Dest_Address
必须
address_info_schema
接收方的地址
FeeUser_ID
必须
user_id_schema
计费用户标识
DestUser_ID
必须
user_id_schema
使用用户标识
LinkID
可选
string
临时订购关系的事务ID
ActionID
必须
integer
服务状态管理动作代码,具体值如下:
1:开通服务;
2:停止服务;
3:激活服务;
4:暂停服务;
ActionReasonID
必须
integer
产生服务状态管理动作原因的代码,具体值如下:
1:用户发起行为
2:Admin&1860发起行为
3:Boss停机
4:Boss开机
5:Boss过户
6:Boss销户
7:Boss改号
8:扣费失败导致的服务取消
9:其他
SPID
可选
string
SP的企业代码
SPServiceID
必须
string
SP中该服务的服务代码
AccessMode
可选
Integer
服务的访问方式
1:WEB
2:WAP
3:SMS
FeatureStr
可选
binary
服务订购参数(base64加密),内容是长号码+空格+用户发送内容
address_info_schema(地址信息)描述
字段名称
字段类型
字段描述
DeviceType
integer
设备类型
0:MISC
100:ISMG
101:WAP SP PROXY
1XX:其他业务网关
200:WAP PORTAL
201:WWW PORTAL
202:VOICE PORTAL
203:PDA PORTAL
2XX:其他门户
300:MMSC
301:KJAVA SERVER
302:LSP
3XX:其它应用平台
400:SP
DeviceID
string
设备编号,设备编号采用各设备的入网编号,例如短信网关使用网关ID、对SP使用其企业代码,该设备编号由MISC分配,并且在同一设备类型中该编号唯一
user_id_schema(用户标识)描述
字段名称
字段类型
字段描述
UserIDType
integer
用户标识类型
1:用手机号标识
2:用伪码标识
3:两者同时标识
MSISDN
string
用户手机号
PseudoCode
binary
用户伪码
4、正向同步接口应答包消息定义
SyncOrderRelationResp消息字段描述:
字段名
重要性
类型
说明
MsgType
必须
string
消息类型
TransactionID
必须
string
该消息编号
Version
必须
string
该接口消息的版本号,本次所有的接口消息的版本都
为“1.5.0”
hRet
必须
integer
返回值,主要错误如下:
0:成功
4007:MISC同步开通服务,但SP端已存在订购关系,且状态为开通
4008:MISC同步开通服务,且SP端不存在订购关系,但开通服务失败
4010:MISC同步停止服务,且SP端存在订购关系,但取消服务失败
4011:MISC同步停止服务,但SP端不存在订购关系
4012:MISC同步暂停服务,且SP端存在订购关系,但暂停服务失败
4013:MISC同步暂停服务,但SP端不存在订购关系
4015:MISC同步激活服务,但SP端已存在订购关系,且状态为开通
4016:MISC同步激活服务,但SP端不存在订购关系
其它错误请参见《MISC系统短信SP接入指南-接口改造分册》。
数据包例子:
1、SyncOrderRelationReq
<?xml version="1.0" encoding="utf-8"?><SOAP-ENV:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"><SOAP-ENV:Header> <TransactionID xmlns="http://www.monternet.com/dsmp/schemas/">00110318384464</TransactionID></SOAP-ENV:Header><SOAP-ENV:Body><SyncOrderRelationReq xmlns="http://www.monternet.com/dsmp/schemas/"><Version>1.5.0</Version>
<MsgType>SyncOrderRelationReq</MsgType><Send_Address><DeviceType>0</DeviceType>
<DeviceID>0011</DeviceID></Send_Address><Dest_Address><DeviceType>400</DeviceType><DeviceID>0</DeviceID></Dest_Address><FeeUser_ID><UserIDType>1</UserIDType>
<MSISDN>13456781234</MSISDN><PseudoCode></PseudoCode></FeeUser_ID>
<DestUser_ID><UserIDType>1</UserIDType><MSISDN>13456781234</MSISDN>
<PseudoCode></PseudoCode></DestUser_ID><LinkID>SP</LinkID><ActionID>1</ActionID>
<ActionReasonID>1</ActionReasonID><SPID>419000</SPID><SPServiceID>-YYXXYYXX</SPServiceID><AccessMode>3</AccessMode>
<FeatureStr>MTA2NjIxNDQgREE=</FeatureStr></SyncOrderRelationReq>
</SOAP-ENV:Body></SOAP-ENV:Envelope>
2、SyncOrderRelationResp
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:dsmp="http://www.monternet.com/dsmp/schemas/">
<SOAP-ENV:Header>
<dsmp:TransactionID xmlns:dsmp="http://www.monternet.com/dsmp/schemas/">
00110318384464
</dsmp:TransactionID>
</SOAP-ENV:Header>
<SOAP-ENV:Body>
<dsmp:SyncOrderRelationResp xmlns:dsmp="http://www.monternet.com/dsmp/schemas/">
<MsgType>SyncOrderRelationResp</MsgType>
<Version>1.5</Version>
<hRet>0</hRet>
</dsmp:SyncOrderRelationResp>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>