联通在信接入注意事项V1.2

联通在信全网新增SP接入注意事项（Ver1.2）联通宽带在线有限公司增值业务测试部2009年3月目录第一部分资料提交.................................................................................1第二部分网关连接.................................................................................5第三部分业务流程.................................................................................8第四部分业务实现...............................................................................11附录集中网关常见错误代码表..................................................18联通在信全网新增SP接入注意事项联通新时讯通信有限公司系统运行部1第一部分资料提交一、概述企业资料XML文档、业务资料TXT文档和SP服务器信息文档是SP开展业务必要的技术文档。中国联通在对SP合作资格与业务审核通过后，根据该文档进行业务数据导入。虽然新增业务可以线上直接申报并生成业务资料TXT文档，但新接入的SP，部分资料仍需要手工填写，线下提交，因此须严格注意格式。二、填写依据业务资料填写依据为：《中国联通全国性联通在信业务SP管理系统SP资料导入规范》三、SP管理系统对业务的处理要点1．业务类型1）每个业务必须申报，设定一个唯一的业务代码（计费代码），业务代码不区分大小写，全部转换为大写；2）订制类业务必须用户订制后才能给用户下行，业务开展中SP可在订制用户没有上行的情况下下行，订制类业务不允许第三方付费；3）点播类业务必须用户上行点播后才能下行，目前允许发送给第三方；4）仅0000和ERROR业务代码不需要申报，其他业务均需要申报，联通在信全网新增SP接入注意事项联通新时讯通信有限公司系统运行部2目前只有点播（免费或按次计费）和包月订制两种类型，同一业务的不同类型分别申请业务代码。2．命令字1）每个业务必须申报命令字，点播类申报一个或多个点播命令字，订制类申报一个订制命令字和一个退订命令字2）命令字只能包含a-z、A-Z、0-9和-_共64个字符，其他字符如空格和#等系统都认为是命令字的结束符3）每个SP的命令字不应重复，全部为大写，每个命令字只能属于一个业务3．长号码1）SP管理系统支持长号码的上下行，但SP申报业务时必须全以短号码申报，SP管理系统以短号码对上下行进行匹配2）点播业务如欲使用长号码，SPNUMBER字段填写短号码，但OperateDesc字段应对实际使用的长号码进行提示，使业务拨测能正确进行3）订制业务时的二次确认，用户收到的提示是发送命令字到短号码四、填写注意事项1。软件能查出的格式正确。主要包括：规定不能填空的字段应填写、业务资料不同字段之间以“TAB”键而不是空格分隔；2。对于企业资料XML文件，除扫描不应为空的字段外，还应注意：联通在信全网新增SP接入注意事项联通新时讯通信有限公司系统运行部31)必须为XML格式的文档2)保存的文档格式要用UTF-8格式3)时间的填写必须为:YYYY-MM-DD,中间用-分隔4)注册资金只需填数字,默认单位是元5）固定电话为不超过12位；6）联系人手机应为联通130、131、132、156号；7）主营业务介绍不超过120字节；8）接入省份和城市代码应参照《SP资料导入规范》中6.1、6.2的“联通省份、地市代码列表”。3。对于业务资料，应注意；1)各字段之间以TAB键分隔,如果某个字段为空,该字段与其他字段之间的TAB分隔符不能省略:如:业务资料中的第14,15,16字段(业务接入时间,短信方式退订命令字,WEB方式点播/订制/退订地址),分别为:2004-02-28,空,则这几条记录的填写应该为:2004-02-28“TAB”)时间的填写格式必须为:YYYY-MM-DD,中间用-分隔;3)明确标明不能填空的字段一定要填写,比如MT发送频率,业务名称字段等。有条件不为空的字段，如定制业务的退订指令不得空缺;联通在信全网新增SP接入注意事项联通新时讯通信有限公司系统运行部44。业务资料的其他匹配情况：1）业务类别信息费计费类型信息费11，2不高于20023不高于15002）点播最大回复MT数不得大于53）业务命令字不得为“####”（点播业务经BSSC批准的除外）4）业务描述不得超过120字节5）同一批业务资料中，业务代码、业务指令不能重复，且不得与以前申报的业务重复6）命令字段只能为命令字本身，不能为“发送QXAB”之类的操作说明填写业务资料时，业务名称、代码、命令字、业务类别、资费类型、信息费值等主要内容应与申报材料完全一致。如果发现其不一致，不论有意或无意，均会作为违规处理。联通在信全网新增SP接入注意事项联通新时讯通信有限公司系统运行部5第二部分网关连接一.集中网关信息(固定不变)集中网关IP地址：211.94.164.35集中网关开放给SP服务器的端口：8804SP服务器登陆集中网关的用户名/密码：接入号/W+企业代码集中网关登陆SP服务器的用户名/密码：openet/openet(需要SP服务器上开通此帐号)SP节点编码：30000+企业代码集中网关短信限速：500条/秒行业短信网关IP地址：211.94.164.35IS网关端口8881SP服务器登陆集中网关的用户名/密码：接入号/W+企业代码SP节点编码：30000+企业代码二.SP服务器信息(需要SP填写信息)SP全称：SP企业代码：联通在信全网新增SP接入注意事项联通新时讯通信有限公司系统运行部6SP接入号：SP服务器IP地址：SP服务器开放给集中网关的端口：三.相关工作流程1．SP在申报工作中，将以上服务器信息以TXT文件（命名为XX公司服务器信息，内容无格式要求）连同企业资料XML文档、业务资料TXT文档一起在规定时间内发到[e-mail]；2．OA状态置为“业务审核通过，等待测试”之后，联通运维部门按照SP提供的服务器信息进行路由配置工作。路由配置与业务数据导入完成后，将OA状态置为“测试中”；3．联通在信测试组发送测试通知后，SP应按照《联通在信业务开发规范v3.0》要求（集中网关信息用本节的），进行网关连接与相关数据包收发调试，测试环境正常后向测试组提交《测试环境准备单》；4．联通在信测试组收到《测试环境准备单》后，按测试操作流程分别进行相关的接口测试、业务测试和计费格式测试。四.特别问题处理1．SP因故需要修改服务器IP时，应提前向中国联通走申请流程。如修联通在信全网新增SP接入注意事项联通新时讯通信有限公司系统运行部7改IP时已处于测试中状态，应同时通知测试组；2．部分外地接入SP反映，本地路由不通，难以进行测试准备。原因为各省路由开通进度不一致，只要北京的路由开通即可以北京测试卡开始测试，其他省请耐心等待。联通在信全网新增SP接入注意事项联通新时讯通信有限公司系统运行部8第三部分业务流程一．用户从手机发起订制的流程1)用户手机发起业务订制请求，SMG接收到Deliver包；2)SMG下发确认通知给用户；3)用户按提示重发订制命令；4)SMG处理后，将Deliver包附上LinkID后转发给SP；5)SP收到Deliver包后，下发MT包时带上LinkID；6)SMG发鉴权失败Report包给SP（由平台统一通知用户）；7)SMG模拟SP发送订制成功信息下发给用户。流程图如下：用户SMGSP1-DeliverDeliverRespDeliverRespSubmitResp5Submit(linkid)3-Deliver(用户确认)2submit确认通知SubmitRespDeliverResp4-Deliver(带linkid)6-Report_Resp7submit定制成功SubmitResp联通在信全网新增SP接入注意事项联通新时讯通信有限公司系统运行部9SPMS开通后，对以上流程的补充描述为：用户发起业务订制请求－SPMS生成临时订制关系，向用户下发订制确认短信－用户重新回复命令字确认订制－SPMS转发Deliver包给SP（带LinkID）－SP下发订制成功/失败通知包给用户(需要带LinkID，失败通知包用业务代码ERROR下发，此业务代码不用申报)－SPMS根据通知包生成正式订制关系，拦截SP的订制成功通知，采用平台统一格式下发订制成功通知，返回错误代码44－SP根据订制规则向用户下发业务消息（不带LinkID）－SPMS根据用户订制关系进行鉴权。二．用户发退订命令字或0000短信取消订制流程1）用户手机发起业务退订请求，SMG接收到Deliver包；2）SMG下发退订成功通知给用户；3）鉴权成功后，SMG将用户退订包给SP；4）SP下发通知包给SMG（带linkid）；5）SMG发鉴权失败Report包给SP（由平台统一通知用户）。流程图如下：用户SMGSP1-DeliverDeliverResp2submit?退定通知SubmitRespDeliverResp2'-Deliver(退定)SubmitResp3'-Submit(退定通知)4'-ReportRespSPMS开通后，对以上流程的补充描述为：联通在信全网新增SP接入注意事项联通新时讯通信有限公司系统运行部10用户发起业务退订请求－SPMS退订用户业务，转发Deliver包给SP（带LinkID）－SP收到Deliver包，进行退订处理。三．用户从手机发起点播的流程1.用户手机发起业务点播请求，SMG接收到Deliver包。2.SMG将Deliver包附上LinkID后转发给SP。3.SP收到Deliver包后，下发MT包时带上LinkID。4.SMG鉴权成功后，将MT包转发给用户。用户将Report报告返回给SMG。5.SMG将Report包转发给SP。流程图如下：用户SMGSP1-DeliverDeliverResp2-Deliver(linkid)DeliverRespSubmitResp3-Submit(linkid)SubmitResp4-Submit5-ReportReportResp6-ReportReportRespSPMS开通后，对以上流程的补充描述为：用户发起MO业务点播请求－SPMS生成点播关系及LinkID－SP在下发的Submit包中填写对应Deliver包中的LinkID－SPMS根据LinkID及点播关系进行鉴权。联通在信全网新增SP接入注意事项联通新时讯通信有限公司系统运行部11第四部分业务实现一．业务基本流程从业务实现角度，以上业务流程描述为：1．MO订制流程1）发订制命令字到分配给Sp接入号；2）鉴权中心鉴权通过后SP会收到一条USERNUMBER为测试手机的短信，内容用户发送的订制命令字，此时该条MO短信的RESERVED字段内带有LINKID；3）SP如果处理该条订制业务成功则发一条订制成功的通知信息给用户，注意该通知MT必须带上步骤3中返回的LINKID，且ServiceType一定是该用户订制业务对应的ServiceType；如果SP处理该订制业务不成功则发一条订制失败的通知信息给用户，通知失败的MT的SERVIECTYPE必须填‘ERROR‘，CHARGENUMBER填21个0；4）测试手机会收到您下发的订制成功或失败通知，流程结束。2．MO退订的流程流程和MO订制一样，不同的只是命令字不同。3．MO点播流程1）发点播命令字到分配给Sp接入号；2）鉴权中心鉴权通过后SP会收到一条USERNU