地市自带平台IVR业务接入方案

1、概述根据2011年10月25日～27日会议与各地市分公司沟通了解到的情况，目前地市合作业务根据平台的计费情况分为联通计费和合作方计费两种情况：对于联通负责计费的情况，可以保持原有方式不变，对于合作方计费的业务，建议将业务和计费、结算等纳入平台管理，需要合作方平台与综增/VAC进行对接，对接原则如下：对固网用户开放的业务，与综增平台进行对接；对移动网开放的用户，与VAC平台进行对接；同时对固网和移动网用户开发的业务，同时与综增平台和VAC对接，并且根据用户类型进行分别到综增平台或VAC平台进行鉴权。2、业务管理目标：2.1对固网用户开放业务将合作伙伴信息、业务信息、鉴权、定购关系、计费等纳入综增平台进行管理：合作伙伴、业务信息由综增平台进行管理；鉴权由业务平台通过综增的鉴权接口进行鉴权；定购关系由综增平台进行集中管理，以综增平台为准，产品的定购/退定由业务平台通过定购关系接口实现，产品定购关系不在业务平台保存，判断用户是否定购通过鉴权接口进行；计费包月费用由综增平台根据定购关系生成计费话单，点播业务由业务平台生成原始话单传递给综增平台进行批价后传递给计费系统综增平台将在今年进行四期扩容改造工程，工程完成后将能够完全支持上诉管理目标，在综增平台四期工程完成之前，暂时按照下面的过渡方案处理。在综增平台四期工程完成之前，可以采用下面的渡方案：合作伙伴、业务信息由综增平台进行管理；鉴权按照现有综增平台与168/自带平台鉴权方式进行；定购关系按照综增平台与168/自带平台现有方式实现双向同步；计费包月费用割接到168平台上的业务由168平台生成包月话单，与综增平台对接的业务由综增平台生成包月话单，点播业务由168平台或者合作方平台生成原始话单交给综增平台批价；2.2对移动网用户开放业务将合作伙伴信息、业务信息、鉴权、定购关系、计费等纳入PRM/VAC/CRM/BILLING进行管理：合作伙伴、业务信息由PRM/CRM进行管理；鉴权计费由业务平台通过VAC的鉴权计费接口进行；定购关系由VAC/CRM管理，以VAC/CRM为准，产品的定购/退定由业务平台通过鉴权接口实现，产品定购关系不在业务平台保存，判断用户是否定购通过鉴权接口进行；计费包月费用由BSS系统进行收取，点播业务由VAC平台根据鉴权记录生成原始话单传送给BSS系统进行批价。对于漏话通业务割接到综增合：目前漏话通业务对外服务的形式是采用中继分群方式，免费群是用于提醒功能，被叫是本地固话，主叫为全国任何电话（移动、联通、电信）。计费群是用于二次外呼，主叫是本地固话，被叫是全国任何电话（三大运营商）。业务计费是由联通交换机生成话单作为基础语音费进行计费。系统割接到综增平台上后，对于中继部分。3、接入方案3.1对固网用户开放业务1）SP/业务/产品信息管理：由综增平台进行管理，通过综增平台录入业务信息，为鉴权和计费提供基础数据。2）认证/鉴权：业务平台按照综增平台的接口规范实现相关接口，接口方式Socket，为综增平台为服务端，业务平台为客户端，接口协议为SMGP扩展协议。3）定购关系：业务平台按照综增平台接口规范实现定购关系同步接口，定购关系接口为双向接口，业务平台产生定购/退定时，业务平台通过综增平台提供的接口发送给综增平台，综增平台为服务端，业务平台为客户端；综增平台产生的定购/退定时，综增平台通过业务平台提供的接口发送给业务平台，业务平台为服务端，综增平台客户端，接口方式为HttpPost，消息格式为XML字符串。4）计费话单：对于包月话单，可以由综增平台根据定购关系数据生成包月话单传递给计费系统，对于按次、按时长业务，由业务平台按照综增平台指定的话单格式定时生成话单文件通过FTP传送到综增平台的话单服务器，综增平台进行入库批价后传递给计费系统。3.2对移动网用户开放业务1）SP/业务/产品信息管理：由PRM进行管理，合作伙伴通过PRM进行申请，业务部门进行审核并在CRM上配置产品。2）认证/鉴权：业务平台按照VAC平台的接口规范实现相关接口，接口方式Socket，为VAC为服务端，业务平台为客户端，接口协议见相关接口。3）定购关系：定购关系由VAC/BSS进行管理，定购/退订/使用鉴权由鉴权接口进行。4）计费话单：包月业务由BSS负责收取费用，点播业务由VAC根据鉴权生成原始话单交给BSS进行批价。4、相关接口4.1综增平台接口4.1.1鉴权接口4.1.1.1SMGP扩展协议概述消息结构：MessageHeader消息头(所有消息公共包头)MessageBody消息体消息头结构字段长度（字节）数据类型说明参考PacketLength4Integer数据包长度RequestID4Integer请求标识SequenceID4Integer消息流水号RequestID请求标识说明：请求名称请求标识说明Login0x00000001客户端登录LoginResp0x80000001客户端登录应答ActiveTest0x00000004链路检测（30秒内没有任何请求消息或回应消息，客户端需要发送链路检测包）ActiveTestResp0x80000004链路检测应答OffOrdAuth0x00000040点播鉴权OffOrdAuthResp0x80000040点播鉴权回应ServEnd0x00000041点播结束ServEndResp0x80000041点播结束回应4.1.1.24.1.1.3点播鉴权用户选择按时长或按次使用业务时，业务系统向综合增值业务管理平台发送点播鉴权的请求，由综合增值业务管理平台判断用户能否使用此业务。请求方向：业务平台―――＞综合增值业务管理平台参数名必选/可选长度注释billingRefIdO32呼叫流水号，和计费话单文件中相对应。systemIdM4请求信息平台编号，增值业务管理平台通过它知道请求方是哪一个平台，回应到相应的客户端。infoOnwerIdM4信息属主（000或311等）svcItemNumberM16服务项目编码spidO24SP企业编号callTypeM2(Integer)呼叫类型：1呼入、1呼出callerNumM24主叫号码calledNumM32被叫号码feePhoneM24支付费用户号码usePhoneM24使用业务用户号码productPgIDO16组合包ID,0表示没有通过组合包进行订购orderModeO2（Integer）订购方式1、168等方式2、综合语音门户3、综合WEB门户4、综合短信门户5、综合门户人工6、其它方式回应消息：参数名必选/可选长度注释retCodeM2(Integer)结果：0成功1、限额、2、余额不够3、黑名单retDescO48错误信息描述usePhoneM24使用业务用户号码durationM16时长，以秒为单位，如果0表示不限时长。如，在WEB化10元钱买25分钟（可以分多次使用）balanceM16余额，用户本次可使用的金额（以分单位）0表示不以金额限制feeTypeM2(Integer)资费类型(‘1’包月、’2’按次、’3’按时长、’4’、体验期)feeInfoM16资费金额，如果按时填写费率productPgIDO16组合包ID,0表示没有通过组合包进行订购productPgMemo032包说明或优惠说明feePhone024计费号码feePhonePayType02（int）2表示后付费，1表示预付费4.1.1.44.1.1.5点播结束针对按时长业务，用户结束这一个业务之后，用户挂机或进入其它业务；则168系统发送点播结束的消息请求。168在写话单时同时发起这一个服务。请求方向：业务平台―――＞综合增值业务管理平台参数名必选/可选长度注释billingRefIdO32呼叫流水号，和计费话单文件中相对应。systemIdM4请求信息平台编号，增值业务管理平台通过它知道请求方是哪一个平台，回应到相应的客户端。infoOnwerIdM4信息属主（000或311等）svcItemNumberM16服务项目编码spidO24SP企业编号feeTypeM2(Integer)资费类型(‘1’包月、2按次、3按时长、体验期)FeeInfoM8信息费usePhoneM24使用业务的号码feePhoneM24支付费用号码startTimeM15开始时间(YYYYMMDDHH24MNSS)endTimeM15结束时间(YYYYMMDDHH24MNSS)durationM16时长(秒)productPkgIdO16组合包ID,0表示没有通过组合包进行订购productPkgMemoO32包说明或优惠说明回应消息：参数名必选/可选长度注释usePhone24使用业务的号码retCodeM2(Integer)结果：0成功，11其它错误retDescO32错误信息描述4.1.1.64.1.2定购关系接口4.1.2.1定购关系接口概述接口请求通过HTTPPost的方式发送，采用gb2312编码XML格式。格式如下例：?xmlversion=1.0encoding=gb2312?requestreqId/reqIdspid/spidtime/timePhone/Phoneneedpwd/needpwdpwd/pwdinfoOwner/infoOwnersvcItemNum/svcItemNum/request4.1.2.2正向接口用户通过综合增值业务管理平台的门户(语音、WEB、短信、人工)订购或者注销了包月业务。由综合管理平台实时的发送消息通增值业务平台系统。综合增值业务管理平台收从综服系统中收到用户拆机信息后，自动触发并通过正向订购接口通知增值业务取消此用户的订购关系。请求方向：综合增值业务管理平台――＞增值业务平台(此服务由增值业务平台提供)请求参数：参数名必选/可选类型注释requestidMString只需要在回应消息返回相同的值timeMString时间infoowneridMString信息属主（000或311等）svcitemnumberMString服务项目编码spidMStringSP企业编号opertypeMInteger1表示退订0表示订购feephoneMString计费号码usephoneMString使用方号码，赠送时为受赠的号码callnumOString主叫号码。(也可以通过WEB发起，WEB登录的号码)callednumOString被叫号码productpkgidOString本字段填产品ID或套餐ID(0表示没有通过组合包进行订购)validstartdateOString包月开始日期validenddateOString包月结束日期ordermodeOString订购方式1、168等方式2、综合语音门户3、综合WEB门户4、综合短信门户5、综合门户人工6、其它方式feePhonePayTypeInteger付费类型：2表示后付费，1表示预付费返回参数参数名必选/可选类型注释requestid和请求消息中值相同time时间和请求包中相同feephone和请求消息中值相同resultcodeMInteger结果：0成功1、限额、2、余额不够3、黑名单、4号码不合法、11其它错误resultdescriptionOString错误信息描述4.1.2.3反向接口用户通过业务平台可以直接订购其平台的业务，业务平台通过反向订购的接口完成业务的鉴权和订购关系的同步。请求方向：业务平台――＞综合增值业务管理平台请求参数：参数名必选/可选类型注释infoowneridMString信息属主（000或311等）svcitemnumberMString服务项目编码spidOStringSP企业编号opertypeMI