SP 短信开发PROVISION接口实现1

 

1. 正向同步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接入指南－接口改造分册》。

    
2. 数据包例子：

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>

作者Blog：http://blog.csdn.net/cutemouse/