DSMP业务反向接口流程说明.doc

DSMP SP业务反向订购接口由于SP开展数据业务的多样化，对于某些特定的业务，在业务的管理上需要增加SP业务反向订购的功能，及必须由手机用户通过SP端提出业务订购申请。此接口为DSMP 与SP 之间的接口，SP可以通过该接口进行订购关系增加和取消。此接口同时适用于WAP SP，短信SP，以及后续的业务类型。此接口非缺省开放的接口，数据业务管理部门根据业务的需要决定向需要的SP开放。1、 数据处理流程描述反向订购流程描述： 反向订购是从SP发起的订购流程，MISC在处理来自SP的订购消息的时候，其处理流程和来自其他网元的消息一样处理，流程如下：1、 SP收到用户的定购请求后，向MISC发起订购请求SubscribeServiceReq，并等待MISC处理响应消息2、 MISC对消息中的业务鉴权接入鉴权，判断该业务是否允许进行反向订购3、 进行用户鉴权和订购关系鉴权，判断用户状态是否正确以及是否是重复定购等4、 MISC向SP发送订购关系同步请求SyncOrderRelationReq5、 SP收到同步请求后，对这个定购请求做相应的定购关系处理，并返回订购关系同步应答SyncOrderRelationResp6、 MISC收到响应后在MISC里面生成正式的定购关系，并返回SP反向定购处理响应SubscribeServiceResp，如果响应正确则转到87、 如果收到MISC的错误响应，则说明定购失败，SP必须对这个失败消息做相应处理，比如把生成的定购关系清除8、 如果收到MISC的正确响应，则SP可以不做任何处理2、服务订购接口消息定义(SubscribeServiceReq)1.1功能描述此接口用于用户通过SP订购数据业务的时候，SP先进行业务关系订购，再通过该接口向DSMP进行用户服务订购的请求。DSMP进行服务订购。消息名消息类型消息方向SubscribeServiceReqRequestSPDSMPSubscribeServiceRespResponseDSMPSP1.2接口内容描述SubscribeServiceReq消息字段描述：字段名重要性类型说明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使用用户标识当计费用户和使用用户为同个用户的时候，FeeUser_ID和DestUser_ID的值为相同，否则填为不同的用户Service_ID必须service_id_schema服务标识FeatureStr可选binary订购特征参数，订购业务需要携带的参数，可以携带文本/多媒体的相关信息SubscribeServiceResp消息字段描述：字段名重要性类型说明MsgType必须string消息类型TransactionID必须string该消息编号Version必须string该接口消息的版本号，本次所有的接口消息的版本都为“1.5.0”hRet必须integer返回值,见第9章的定义，如果返回成功，则下面几个参数必须存在，否则是可选的LinkID条件string临时订购关系的匹配码，用来鉴权一次点播请求等事务性的业务。当DSMP生成的订购关系为临时订购关系的时候，返回本字段，否则不填本字段。2、取消服务订购接口消息定义(UnSubscribeServiceReq)2.1功能描述此接口用于用户通过SP取消已订购的数据业务的时候，SP先通过该接口向DSMP进行用户取消服务订购的请求。DSMP进行取消服务订购成功后，SP才取消用户对应的业务订购关系。消息名消息类型消息方向UnSubscribeServiceReqRequestSPDSMPUnSubscribeServiceRespResponseDSMPSP2.2接口内容描述UnSubscribeServiceReq消息字段描述：字段名重要性类型说明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使用用户标识当使用用户和计费用户为同一用户的时候，FeeUser_ID和DestUser_ID的值相同。Service_ID必须service_id_schema服务标识UnSubscribeServiceResp消息字段描述：字段名重要性类型说明MsgType必须string消息类型TransactionID必须string该消息编号Version必须string该接口消息的版本号，本次所有的接口消息的版本都为“1.5.0”hRet必须integer返回值,见第9章的定义3、订购关系同步消息接口消息定义（SyncOrderRelationReq）3.1功能描述此接口在DSMP因为某种情况更新了用户订购关系（包括订购、取消、暂停、激活）的时候，通过此接口发起和SP的更新订购关系的交互。消息名消息类型消息方向SyncOrderRelationReqRequestDSMPSPSyncOrderRelationRespResponseSPDSMP3.2接口内容描述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临时订购关系的事务IDActionID必须integer服务状态管理动作代码，具体值如下：1： 开通服务；2： 停止服务；3： 激活服务；4： 暂停服务；ActionReasonID必须integer产生服务状态管理动作原因的代码，具体值如下：1：用户发起行为2：Admin&1860发起行为3：Boss停机4：Boss开机5：Boss过户6：Boss销户7：Boss改号8：扣费失败导致的服务取消9：其他SPID可选stringSP的企业代码SPServiceID必须stringSP中该服务的服务代码AccessMode可选Integer服务的访问方式1：WEB2：WAP3：SMSFeatureStr可选binary服务订购参数SyncOrderRelationResp消息字段描述：字段名重要性类型说明MsgType必须string消息类型TransactionID必须string该消息编号Version必须string该接口消息的版本号，本次所有的接口消息的版本都为“1.5.0”hRet必须integer返回值，详细定义见第9章3 附录B 返回值定义在HTTP 通信时的状态码请参见HTTP/1.1 协议中规定的状态码值，不包含在本规范的返回值统一定义中。具体描述如下：0 ： 成功1 ： 未知错误2-99：保留40004999 为DSMP 与SP 之间的接口消息中的错误代码：4000： 无效的msgtype4001： 无效的action_id；4002： 无效的action_reasonid；4003： 无效的SP ID4004： 无效的serviceID4005： 无效的pseudocode4006： 无效的accessmode4007： MISC 同步开通服务,但SP 端已存在订购关系,且状态为开通4008： MISC 同步开通服务,且SP 端不存在订购关系,但开通服务失败4009： MISC 同步开通服务,但SP 端已存在订购关系, 且状态为暂停4010： MISC 同步停止服务, 且SP 端存在订购关系, 但取消服务失败4011： MISC 同步停止服务, 但SP 端不存在订购关系4012： MISC 同步暂停服务, 且SP 端存在订购关系, 但暂停服务失败4013： MISC 同步暂停服务, 但SP 端不存在订购关系4014： MISC 同步暂停服务, 但SP 端已存在订购关系, 且状态为暂停4015： MISC 同步激活服务, 但SP 端已存在订购关系, 且状态为开通4016： MISC 同步激活服务, 但SP 端不存在订购关系4017： MISC 同步激活服务, 且SP 端存在订购关系, 但激活服务失败9000-9999 为系统级错误：9000： 系统磁盘读写错误9001： 网络异常9002： 网络错误9003： 业务网关忙，业务网关缓存9004： 业务网关忙，并且业务网关缓冲区满，DSMP 缓存，并暂时不要发送消息，等待一段时间重试。9005： DSMP 忙，DSMP 缓存9006： DSMP 忙，并且DSMP 缓冲区满，业务网关缓存，并暂时不要发送消息，等待一段时间重试。9007： 业务网关超过限制的流量9008： DSMP 异常，并不可用9009： 业务网关异常，并不可用9010： 该业务网关没有权限调用该接口消息9011： DSMP 没有权限发送该接口消息给业务网关9012： 版本不支持9013： 消息类型不对，系统不支持9014： 验证错误，无法解析SOAP 和XML 结构、缺少必须存在的字段，或者消息,格式不正确9015： 拒绝消息，服务器无法完成请求的服务4附录B： 接口实例4.1、SP订购请求包 00240301801050 1.5.0 SubscribeServiceReq 400 913002 0 0024 111 913002 -TQAAU 4.