中国电信综合业务管理平台ISMP接口规范(RC1.0.0)-门户接口

中国电信企业标准 CT CT/TCT/T SNSN RC1RC1 ISMPISMP V1.0.0V1.0.0 综合业务管理平台 ISMP 接口规范 -门户接口 2008-03 发布2008-03 实施 中国电信集团公司 综合业务管理平台 ISMP 接口规范-门户接口SN RC1 ISMP V1.0.0 - 2 - 目 录 1适用范围适用范围.4 2引用标准引用标准.5 3缩略语缩略语.6 4需求约束需求约束.7 5ISMP与用户门户之间的接口与用户门户之间的接口.8 5.1ISMP与用户门户组网.8 5.2终端信息查询接口.8 5.2.1流程.8 5.2.2概述.8 5.2.3消息.9 5.3功能调用接口.9 5.3.1用户管理接口.10 5.3.2认证与授权接口.16 5.3.3定购管理接口.19 5.4门户统一配置接口.31 5.4.1终端信息同步接口.32 5.4.2SP信息同步接口.39 5.4.3内容信息同步接口.40 5.4.4内容与产品关系同步接口.43 5.4.5业务类别同步接口.44 5.4.6业务信息同步接口.45 5.4.7产品信息同步接口.47 5.4.8套餐信息同步接口.49 5.4.9集团产品信息同步接口.51 5.4.10号段信息同步接口.52 5.4.11业务引擎URL信息同步接口.53 5.4.12回执文件.54 5.4.13业务小图标同步接口.54 附录附录A.业务能力编号及业务类型业务能力编号及业务类型.55 附录附录B.门户结果码定义门户结果码定义.56 综合业务管理平台 ISMP 接口规范-门户接口SN RC1 ISMP V1.0.0 - 3 - 前前 言言 本规范定义了中国电信综合业务管理平台 ISMP（Integrated Service Management Platform）的 接口规范，包括 ISMP 与 SS、ISAG、MSNMC、Portal、OCS、IN、运营支撑系统、CP/SP 之间的接口。 本规范解释权属于中国电信集团公司。 本规范起草单位：中国电信股份有限公司上海研究院。 本标准主要起草人：韩彬斌，王铮，任华，方燕萍，黄铖斌，杨迪，张亚玫、宋金晶、黄颂尧。 综合业务管理平台 ISMP 接口规范-门户接口SN RC1 ISMP V1.0.0 - 4 - 1 适用范围适用范围 本规范适用于中国电信综合业务管理平台（ISMP）产品的设计及研发，提供给为中国电信开发制 造 ISMP 的设备供应商。本规范是中国电信各级运营单位进行 ISMP 招标采购、工程设计、网络运营、 管理、维护等方面的技术依据。 综合业务管理平台 ISMP 接口规范-门户接口SN RC1 ISMP V1.0.0 - 5 - 2 引用标准引用标准 下列文件通过本文的参考而成为本规范的条款。凡是注日期的参考文件，其随后所有的修改单 （不包括勘误的内容）或修订版均不适用于本文，凡是不注日期的参考文件，其最新版本适用于本文。 附录 A. 中国电信移动增值业务网络技术体制 附录 B. 中国电信综合业务管理平台 ISMP 规范总册 附录 C. 中国电信综合业务管理平台 ISMP 设备规范 附录 D. 中国电信综合业务管理平台 ISMP 数据规范 综合业务管理平台 ISMP 接口规范-门户接口SN RC1 ISMP V1.0.0 - 6 - 3 缩略语缩略语 缩略语缩略语英文全名英文全名中文全名中文全名 3G3rd Generation第三代移动通信 AOMTApplication Originated Mobile Terminated应用发起终端结束 CPContent Provider 内容提供商 CRMCustomer Relation Management客户关系管理 CCGContent Charging GateWay内容计费网关 DRMDigital Rights Management数字版权管理 EOMTEmail Originated Mobile Terminatedemail 发起终端结束 IPInternet Protocol因特网协议 ISMAPIntegrated Service Management Access Protocol综合业务管理接入协议 ISMPIntegrated Service Management Platform综合业务管理平台 IVRInteractive Voice Response声讯系统 Java JavaJAVA 下载 LCSLocation Service定位业务 MMSMultimedia Message Service多媒体消息 MOATMobile Originated Application Terminated终端发起应用结束 MOETMobile Originated Email Terminated终端发起 email 结束 MOMTMobile Originated Mobile Terminated终端发起终端结束 MPSSMobile Payment Service System移动支付业务系统 MSOPMetropolis service operator platform 地市级业务操作平台 MSNMCMobile Service National Management Center移动业务全国管理中心 NMSNetwork management system网络管理系统 OMCOperating and Maitenance Center操作维护中心 PDUProtocol Data Unit协议数据单元 PHSPersonal handset system小灵通 PSOPProvince Service Operation Platform省级业务操作平台 RTBPReal Time Billing Protocol实时扣费协议 SAGService Access Gateway业务接入网关 SCPService Control Point业务控制点 SMGPShort Message Gateway Protocol短信网关协议 SMSShort Message Service短消息业务 SNMPSimple Network Management Protocol简单网管协议 SPService Provider业务提供商 SPMSSP Management SystemSP 管理系统（小灵通） SSOSingle Sign On单点接入 StreamingStreaming流媒体 TCPTransfer Control Protocol传输控制协议 WAPWireless Application Protocol无线应用协议 综合业务管理平台 ISMP 接口规范-门户接口SN RC1 ISMP V1.0.0 - 7 - 4 需求约束需求约束 1、 所有编码都使用 10 进制。 2、 所有长度都为建议长度。 综合业务管理平台 ISMP 接口规范-门户接口SN RC1 ISMP V1.0.0 - 8 - 5 ISMP 与用户门户之间的接口与用户门户之间的接口 5.1ISMP 与用户门户组网与用户门户组网 用户门户负责业务/产品/套餐展现，为用户提供增值业务自服务通道。用户门户和其归属的 ISMP 相连。 5.2终端信息查询接口终端信息查询接口 5.2.1 流程流程 源服务器归属ISMP 能力查询结果 能力查询 图 5.12.2 终端能力查询流程示意图 各网元匹配终端能力信息时，首先在本地终端能力信息数据库中匹配终端获取相应的能力信息。 若本地数据库中不存在对应该终端的能力信息数据，则各网元触发到归属平台上的终端能力信息 HTTP GET 请求，并将终端中的 Accept 和 User-Agent 字段发送给归属平台。归属平台在本地终端信息 数据库中寻找，如无相应的对应关系，查询结束不能获得终端能力信息，不再向更上级 ISMP 查询。 如查到对应关系，则将该本地所存储的终端能力信息 XML 文件作为 HTTP RESPONSE 的内容返回给 查询的网元，网元将该 XML 文件存于本地数据库中。 5.2.2 概述概述 触发条件：当门户在本地终端信息数据库无法匹配到对应的终端类型时，主动向 ISMP 发起终端 综合业务管理平台 ISMP 接口规范-门户接口SN RC1 ISMP V1.0.0 - 9 - 信息查询请求消息，以获得终端相信信息。 承载协议：http。 消息列表： 消息消息类型类型方向方向 单次查询请求消息请求门户-ISMP 单次查询响应消息响应ISMP-门户 5.2.3 消息消息 单次查询请求：单次查询请求： 使用 HTTP GET http:/UaHost 消息。 该消息用于向 ISMP 发起单次异步查询，其中 UaHost 为归属 ISMP 的主机域名。该消息参照标准 HTTP GET，需要扩展下列 Header 头： 字段名称字段名称类型类型描述描述 x-uahost-get-typestringOnceQuery：表示该 GET 请求为单次请求。 User-Agentstring终端对应的 User-Agent 值。 x-wap-profilestring终端对应的 UAProfile URL 地址。 单次查询响应：单次查询响应： 单次查询响应使用 HTTP GET RESPONSE 消息。 该消息参照标准 HTTP GET RESPONSE，如果没有查到对应的终端能力信息，返回成功（代表 ISMP 正确收到门户的查询申请并成功进行查询处理）和空消息体。如果查询到对应的终端能力信息， 向门户返回单次查询后获得的终端能力信息。其中返回的响应消息体为所查询的单个终端能力信息 XML 文件，该 XML 文件的格式同终端信息同步文件传送时的 XML 文件。 5.3功能调用接口功能调用接口 承载协议：WebService (Document Style), 综合业务管理平台 ISMP 接口规范-门户接口SN RC1 ISMP V1.0.0 - 10 - 5.3.1 用户管理用户管理接口接口 更改密码更改密码: modifyPassword() 接口方向：Portal-ISMP 触发条件：用户在门户发起 WEB 门户的密码更改请求 需求约束：用户修改密码时必须输入 2 遍新密码，由门户保证用户输入是否一致。 接口交互流程： 用户门户ISMP 用户在门户要求修改密码，输入旧密码和新密码 门户调用ISMP的用户更改密码接口 返回门户用户修改密码成功 返回用户修改密码成功 ISMP验证旧密码，保存新密码 图 1.更改密码 消息体定义 输入参数 参数名参数名类型类型出现次数出现次数 注释注释 streamingNoString1流水号，可用于调用提供双方 比较接口调用情况 60 位，从 0 开始，用满归零 srcDeviceTypeInteger1发端设备类型 参见中国电信综合业务管理平 台 ISMP 规范总册 srcDeviceIDString1发端设备 ID 综合业务管理平台 ISMP 接口规范-门户接口SN RC1 ISMP V1.0.0 - 11 - 参见中国电信综合业务管理平 台 ISMP 规范总册 userIDString1用户号码 userIDTypeInteger10：MSISDN 1：PHS 2：PSTN oldPasswordString1需要门户加密 (MD5) newPasswordString1需要门户加密 (MD5) 输出参数 参数名参数名类型类型出现次数出现次数 注释注释 streamingNoString1将调用的 StreamingNo 原样返回， 保证调用返回的同步 resultCodeInteger1参见附录 B 重设密码重设密码 resetPassword() 接口方向：Portal-ISMP 触发条件：用户在门户发起 WEB 门户的密码重设请求 需求约束：门户先验证手机与用户的对应关系（验证码） ，再允许用户重设密码，并调用本接口。 接口交互流程： 综合业务管理平台 ISMP 接口规范-门户接口SN RC1 ISMP V1.0.0 - 12 - 用户门户ISMP 用户在门户要求重设密码 门户下发验证码验证用户身份 门户调用ISMP的重设密码接口,携带用户新密码 ISMP保存用户新密码 返回门户用户重设密码成功 返回用户重设密码成功 图 2.重设密码 消息体定义 输入参数： 参数名参数名类型类型出现次数出现次数 注释注释 streamingNoString1流水号，可用于调用提供双方 比较接口调用情况 60 位，从 0 开始，用满归零 srcDeviceTypeInteger1发端设备类型 参见中国电信综合业务管理平 台 ISMP 规范总册 srcDeviceIDString1发端设备 ID 参见中国电信综合业务管理平 台 ISMP 规范总册 userIDString1用户号码 userIDTypeInteger10：MSISDN 1：PHS 2：PSTN newPasswordString1需要门户加密 (MD5) 输出参数： 综合业务管理平台 ISMP 接口规范-门户接口SN RC1 ISMP V1.0.0 - 13 - 参数名参数名类型类型出现次数出现次数 注释注释 streamingNoString1将调用的 StreamingNo 原样返回， 保证调用返回的同步 resultCodeInteger1参见附录 B 读取用户信息读取用户信息: readUser() 接口方向：Portal-ISMP 触发条件：门户发起查看基本信息请求 需求约束：用户必须通过认证之后才能读取用户信息。 接口交互流程： 用户门户ISMP 用户在门户要求查看基本信息 门户调用ISMP的读取用户信息接口 返回门户用户基本信息 展现用户基本信息 图 3.读取用户信息 消息体定义 输入参数 参数名参数名类型类型出现次数出现次数 注释注释 streamingNoString1流水号，可用于调用提供双方 比较接口调用情况 60 位，从 0 开始，用满归零 srcDeviceTypeInteger1发端设备类型 参见中国电信综合业务管理平 台 ISMP 规范总册 srcDeviceIDString1发端设备 ID 综合业务管理平台 ISMP 接口规范-门户接口SN RC1 ISMP V1.0.0 - 14 - 参见中国电信综合业务管理平 台 ISMP 规范总册 userIDString1用户号码 userIDTypeInteger10：MSISDN 1：PHS 2：PSTN 输出参数 参数名参数名类型类型出现次出现次 数数 注释注释 streamingNoString1将调用的 StreamingNo 原样返回，保证调用返 回的同步 resultCodeInteger1参见附录 B userNameString1用户姓名 EmailString1邮件地址 languagePrefInteger10：中文（默认） 1：英文 StateInteger10：正常 1：用户要求停机 2：欠费停机 3：欠费停机及用户要求停机 4：注销 userPayTypeInteger10：后付费用户 1：预付费用户 2：准预付费用户 userAgentString1终端类型 修改用户信息：修改用户信息： modifyUser() 接口方向：Portal-ISMP 触发条件：用户在门户发起修改基本信息请求 需求约束：用户必须通过门户认证之后才能修改用户信息，仅省门户可以发起该消息。 综合业务管理平台 ISMP 接口规范-门户接口SN RC1 ISMP V1.0.0 - 15 - 接口交互流程： 用户门户 ISMP 用户在门户要求修改基本信息 门户调用ISMP的修改用户信息接口 返回门户用户修改成功 返回门户用户修改成功 图 4.修改用户信息 消息体定义 输入参数 参数名参数名类型类型出现次数出现次数 注释注释 streamingNoString1流水号，可用于调用提供 双方比较接口调用情况 60 位，从 0 开始，用满归 零 srcDeviceTypeInteger1发端设备类型 参见中国电信综合业务管 理平台 ISMP 规范总册 srcDeviceIDString1发端设备 ID 参见中国电信综合业务管 理平台 ISMP 规范总册 userIDString1用户号码 userIDTypeInteger10：MSISDN 1：PHS 2：PSTN emailString1邮件地址 languagePrefString10：中文（默认） 1：英文 综合业务管理平台 ISMP 接口规范-门户接口SN RC1 ISMP V1.0.0 - 16 - 输出参数 参数名参数名类型类型出现次数出现次数 注释注释 streamingNoString1将调用的 StreamingNo 原 样返回，保证调用返回 的同步 resultCodeInteger1参见附录 B 5.3.2 认证与授权接口认证与授权接口 用户认证用户认证: authenticateUser() 接口方向：Portal-ISMP 触发条件：用户登录门户 需求约束：无 接口交互流程： 用户门户ISMP 用户登录门户 门户调用ISMP的用户认证接口 返回门户用户认证通过 返回认证通过 ISMP校验用户手机号，若用户从WEB接入则还要验证用户密码 图 5.用户认证 消息体定义 输入参数 参数名参数名类型类型出现次数出现次数 注释注释 streamingNoString1流水号，可用于调用提 供双方比较接口调用情况 综合业务管理平台 ISMP 接口规范-门户接口SN RC1 ISMP V1.0.0 - 17 - 60 位，从 0 开始，用满归 零 srcDeviceTypeInteger1发端设备类型 参见中国电信综合业务 管理平台 ISMP 规范总册 srcDeviceIDString1发端设备 ID 参见中国电信综合业务 管理平台 ISMP 规范总册 userIDString1用户号码 userIDTypeInteger10：MSISDN 1：PHS 2：PSTN passwordString1 userAgentString1用户终端类型，登陆 WAP 门户时必填 输出参数 参数名参数名类型类型出现次数出现次数 注释注释 streamingNoString1将调用的 StreamingNo 原样返回， 保证调用返回的同步 resultCodeInteger1参见附录 B RegisteredInteger10：未在 WEB 门户注册 1：已在 WEB 门户注册 SPIDString1该测试组可以测试的 SPID 运营商测试组，填 88888888 testUserTagInteger10：非测试用户 1：测试用户 corpTagInteger10：非集团成员 1：集团成员 corpIDString1集团编号 whiteListServiceNumInteger1用户属于白名单的业务数量 serviceIDListString0n白名单业务编号列表 综合业务管理平台 ISMP 接口规范-门户接口SN RC1 ISMP V1.0.0 - 18 - 用户授权用户授权: authorizeUser() 接口方向：Portal-ISMP 触发条件：用户在门户查看产品/套餐信息 需求约束：用户必须通过门户认证之后门户才能发起授权消息,门户需要根据 ISMP 返回的定购关 系状态决定是否给用户显示使用、退定。 接口交互流程：。 用户门户ISMP 用户在门户要求查看产品/套餐信息 门户调用ISMP的授权接口 返回门户授权结果 展现用户使用链接和退定链接 图 6.用户授权 消息体定义 输入参数 参数名参数名类型类型出现次数出现次数 注释注释 streamingNoString1流水号，可用于调用提供双 方比较接口调用情况 60 位，从 0 开始，用满归零 srcDeviceTypeInteger1发端设备类型 参见中国电信综合业务管理 平台 ISMP 规范总册 srcDeviceIDString1发端设备 ID 参见中国电信综合业务管理 平台 ISMP 规范总册 综合业务管理平台 ISMP 接口规范-门户接口SN RC1 ISMP V1.0.0 - 19 - userIDString1用户号码 userIDTypeInteger10：MSISDN 1：PHS 2：PSTN IDTypeInteger10:ProductID 1:PackageID 用户查看产品时此字段填写 0， 查看套餐时填写 1 IDString1IDType 为 0，本字段填产品 ID， IDType 为 1，本字段填套餐 ID 输出参数 参数名参数名类型类型出现次数出现次数 注释注释 streamingNoString1将调用的 StreamingNo 原样返回，保证调用返回的 同步 resultCodeInteger1参见附录 B statusInteger10：正常 1：待生效 2：暂停+待生效 3：暂停 4：待失效 5：暂停待失效 6：注销 5.3.3 定购管理接口定购管理接口 需求约束： 凡是接入到短信门户的短信 SMSGW 不通过 ISMAP 消息与 ISMP 交互，而是先到门户，通过门户接口 与 ISMP 交互；需要在 SMSGW 设置短信门户的接入号 定购接口定购接口: createSubscription() 接口方向：Portal-ISMP 综合业务管理平台 ISMP 接口规范-门户接口SN RC1 ISMP V1.0.0 - 20 - 触发条件：用户在门户发起定购请求 需求约束：用户必须通过门户认证之后门户才能发起定购消息，ISMP 先鉴权计费，再生成定购关 系，返回给门户，最后通知 SP；除短信门户外，本接口只提供省业务定购功能，要求仅对定购类产品 套餐且该用户未定购时显示定购链接。 接口交互流程： 用户门户ISMP 用户在门户进行定购操作 门户调用ISMP的用户定购操作接口 返回门户用户定购操作结果及其他信息 返回用户定购操作结果及其他信息 图 7.定购接口 消息体定义 输入参数 参数名参数名类型类型出现次数出现次数 注释注释 streamingNoString1流水号，可用于调用提供双 方比较接口调用情况 60 位，从 0 开始，用满归零 srcDeviceTypeInteger1发端设备类型 参见中国电信综合业务管理 平台 ISMP 规范总册 srcDeviceIDString1发端设备 ID 参见中国电信综合业务管理 平台 ISMP 规范总册 OAString1定购方用户号码 OATypeInteger10：MSISDN 综合业务管理平台 ISMP 接口规范-门户接口SN RC1 ISMP V1.0.0 - 21 - 1：PHS 2：PSTN DAString1使用方用户号码，默认与定购 方相同，用户赠送时为受赠方 号码 DATypeInteger10：MSISDN 1：PHS 2：PSTN FAString1付费方，本版本不使用 FATypeInteger10：MSISDN 1：PHS 2：PSTN IDTypeInteger10:ProductID 1:PackageID 用户查看产品时此字段填写 0， 查看套餐时填写 1 IDString1IDType 为 0，本字段填产品 ID， IDType 为 1，本字段填套餐 ID 输出参数 参数名参数名类型类型出现次数出现次数 注释注释 streamingNoString1将调用的 StreamingNo 原样返 回，保证调用返回的同步 resultCodeInteger1参见附录 B effectiveTimeDatetime1定购关系生效时间，不填表示 立即生效 expireTimeDatetime1定购关系失效时间，自动续订 的不填 subscriptionIDString 1定购关系的编号，唯一标识一 条定购关系。 编码规则：用户号码+序号， AAAAAAAAAAABBBBB 综合业务管理平台 ISMP 接口规范-门户接口SN RC1 ISMP V1.0.0 - 22 - 退定接口退定接口: withdrawSubscription() 接口方向：Portal-ISMP 触发条件：用户在门户发起退定请求 需求约束：用户必须通过门户认证之后门户才能发起退定消息，要求仅定购类产品定购关系状态 为正常、待生效、暂停及暂停待生效时门户可以为用户显示退定链接。 接口交互流程： 用户门户ISMP 用户在门户进行退定操作 门户调用ISMP的用户退定接口 返回门户用户退定结果及其他信息 返回用户退定结果及其他信息 图 8.退定接口 消息体定义 输入参数 参数名参数名类型类型出现次数出现次数 注释注释 streamingNoString1流水号，可用于调用提供双 方比较接口调用情况 60 位，从 0 开始，用满归零 srcDeviceTypeInteger1发端设备类型 参见中国电信综合业务管理 平台 ISMP 规范总册 srcDeviceIDString1发端设备 ID 参见中国电信综合业务管理 平台 ISMP 规范总册 综合业务管理平台 ISMP 接口规范-门户接口SN RC1 ISMP V1.0.0 - 23 - userIDString1用户号码 userIDTypeInteger10：MSISDN 1：PHS 2：PSTN IDTypeInteger10:ProductID 1:PackageID 用户查看产品时此字段填写 0， 查看套餐时填写 1 IDString1IDType 为 0，本字段填产品 ID， IDType 为 1，本字段填套餐 ID 输出参数 参数名参数名类型类型出现次数出现次数 注释注释 streamingNoString1将调用的 StreamingNo 原样返 回，保证调用返回的同步 resultCodeInteger1参见附录 B expireTimeDatetime1定购关系失效时间，不填表示 立即失效 获取定购关系获取定购关系: getSubscription() 接口方向：Portal-ISMP 触发条件：用户在门户发起浏览定购夹请求 需求约束：用户必须认证之后门户才能发起获取定购关系消息， ，获取用户所有定购关系，包括全 国业务和省业务的定购关系，以及受赠、赠送和集团定购的定购关系。 接口交互流程： 综合业务管理平台 ISMP 接口规范-门户接口SN RC1 ISMP V1.0.0 - 24 - 用户门户ISMP 用户在门户浏览定购夹 门户调用ISMP的获取定购关系接口 返回门户用户定购关系列表 展现定购夹 图 9.获取定购关系 消息体定义 输入参数 参数名参数名类型类型出现次数出现次数 注释注释 streamingNoString1流水号，可用于调用提供双 方比较接口调用情况 60 位，从 0 开始，用满归零 srcDeviceTypeInteger1发端设备类型 参见中国电信综合业务管理 平台 ISMP 规范总册 srcDeviceIDString1发端设备 ID 参见中国电信综合业务管理 平台 ISMP 规范总册 userIDString1用户号码 userIDTypeInteger10：MSISDN 1：PHS 2：PSTN 输出参数 参数名参数名类型类型出现次数出现次数 注释注释 streamingNoString1将调用的 StreamingNo 原样返 回，保证调用返回的同步 综合业务管理平台 ISMP 接口规范-门户接口SN RC1 ISMP V1.0.0 - 25 - resultCodeInteger1参见附录 B subInfoSubInfo0n定购及赠送、受赠的产品或套 餐列表 SubInfo 数据类型 参数名参数名类型类型出现出现 次数次数 注释注释 IDTypeInteger10:ProductID 1:PackageID 用户查看产品时此字段填写 0，查看套餐时填写 1 IDString1IDType 为 0，本字段填产品 ID， IDType 为 1，本字段填套餐 ID，用户单独定购产品 时此字段填写产品 ID，定购套餐时填写套餐 ID，不 填写该套餐内的产品 ID statusInteger10：正常 1：待生效 2：暂停+待生效 3：暂停 4：待失效 5：暂停待失效 6：注销 subscribeTimeDatetime1用户定购请求发起时间 effectiveTimeDatetime1定购关系生效时间 expireTimeDatetime1定购关系失效时间，自动续订的不填 suspendTimeDatetime1定购关系暂停生效时间 resumeTimeDatetime1定购关系暂停恢复生效时间 OAString1定购方用户号码 OATypeInteger10：MSISDN 1：PHS 2：PSTN DAString1使用方用户号码，默认与定购方相同，用户赠送时 为受赠方号码 DATypeInteger10：MSISDN 综合业务管理平台 ISMP 接口规范-门户接口SN RC1 ISMP V1.0.0 - 26 - 1：PHS 2：PSTN FAString1本版本不使用 FATypeInteger10：MSISDN 1：PHS 2：PSTN corpIDString1用户所属的集团 ID，集团为集团成员定购时填写 查询定购操作历史记录查询定购操作历史记录: querySubscriptionHistory() 接口方向：Portal-ISMP 触发条件：用户在门户发起查看定购操作历史记录请求 需求约束：用户必须认证之后门户才能发起查询定购操作历史记录消息，查询用户所有定购操作 历史关系，包括全国业务和省业务的定购历史记录，以及受赠、赠送和集团定购的定购操作历史记录。 接口交互流程： 用户门户ISMP 用户在门户查看定购历史记录 门户调用ISMP的查询定购历史记录接口 返回门户用户定购历史记录列表 展现定购历史记录列表 图 10. 查询定购操作历史记录 消息体定义 输入参数 综合业务管理平台 ISMP 接口规范-门户接口SN RC1 ISMP V1.0.0 - 27 - 参数名参数名类型类型出现次数出现次数 注释注释 streamingNoString1流水号，可用于调用提供双方比 较接口调用情况 60 位，从 0 开始，用满归零 srcDeviceTypeInteger1发端设备类型 参见中国电信综合业务管理平台 ISMP 规范总册 srcDeviceIDString1发端设备 ID 参见中国电信综合业务管理平台 ISMP 规范总册 userIDString1用户号码 userIDTypeInteger10：MSISDN 1：PHS 2：PSTN StartTimeDatetime1 endTimeDatetime1 都不填表示查所有历史记录，填 StartDate 表示查这之后所有定购历 史记录，填 EndDate 表示查这之前 所有定购历史记录 输出参数 参数名参数名类型类型出现次数出现次数 注释注释 streamingNoString1将调用的 StreamingNo 原样返回， 保证调用返回的同步 resultCodeInteger1参见附录 B subHistoryInfoSubHistory Info 0n定购历史记录信息 SubHistoryInfo 数据类型 参数名参数名类型类型出现次数出现次数注释注释 IDTypeInteger10:ProductID 1:PackageID 用户查看产品时此字段填写 0， 查看套餐时填写 1 IDString1IDType 为 0，本字段填产品 ID， IDType 为 1，本字段填套餐 ID， 综合业务管理平台 ISMP 接口规范-门户接口SN RC1 ISMP V1.0.0 - 28 - 用户单独定购产品时此字段填写 产品 ID，定购套餐时填写套餐 ID，不填写该套餐内的产品 ID operationTypeInteger10：定购 1：退定 2：暂停 3：暂停恢复 4：赠送 5：受赠 operationTimeDatetime1用户操作请求发起时间 取消所有定购取消所有定购: withdrawAllSubscription() 接口调用方向：Portal-ISMP 触发条件：用户在门户发起取消所有定购关系请求 需求约束：用户必须认证之后门户才能发起取消所有定购消息，不包括只能由集团管理员退定的 产品。要求 ISMP 立即应答门户的退定请求，异步方式处理用户退定，并通过短信方式将处理结果发送 给用户。 接口交互流程： 用户门户ISMP 用户在门户进行取消所有定购关系操作 门户调用ISMP的用户取消所有定购关系接口 返回门户用户取消所有定购关系结果及其他信息 返回用户取消所有定购关系结果及其他信息 图 11. 取消所有定购 消息体定义 综合业务管理平台 ISMP 接口规范-门户接口SN RC1 ISMP V1.0.0 - 29 - 输入参数 参数名参数名类型类型出现次数出现次数 注释注释 streamingNoString1流水号，可用于调用提供双方 比较接口调用情况 60 位，从 0 开始，用满归零 srcDeviceTypeInteger1发端设备类型 参见中国电信综合业务管理平 台 ISMP 规范总册 srcDeviceIDString1发端设备 ID 参见中国电信综合业务管理平 台 ISMP 规范总册 userIDString1用户号码