中国联通预付费用户点到点短消息实时计费实现技术规范样本

中华人民共和国联通预付费顾客点到点短消息实时计费实现技术规范（试用V1.22）中华人民共和国联合通信有限公司.8修改记录日期Date修改描述changeDescription-01）将SMB补款话单中序列号字段更改为9字节；2）增长对网内点到点流程阐明；3）增长消息机制实现成果告知；4）修改顾客资料文献更新方式。-8-111)删除附录B智能业务属性拟定，有关内容定义到SCP接口文档中;2)修改扩展消息命令标志数值定义(参见4.3)3)修改2.2业务批价描述，明确规定所有批价都应当在PDSCP实现，不应在SCP实现。目录TOC\o"1-3"1 概述 PDSCPSMPP+SMSCPDSCPSMPP+SMSCSMPP+SMPP+SMSCSMSC图2：短信中心与PDSCP组网示意图预付费顾客点到点短消息业务也许由各种短消息中心提供，因而一种PDSCP需要具备与各种短消息中心连接能力。通信方式PDSCP与SMSC之间通信有两种类型：1)当PDSCP需接受SMSC消息时，PDSCP必要以RECEIVER方式连接到SMSC；2)当PDSCP积极向SMSC发送消息时，在这种状况下，PDSCP需以TRANSMITIER方式连接到SMSC；3)无论PDSCP积极发消息还是被动接受消息，PDSCP与SMSC之间连接方式采用TRANSCEIVER。当前采用第三种方式。PDSCP短消息中心之间通信端标语及IP地址：现场实行时再定。通信过程PDSCP与SMSC之间通信采用长连接方式且待应答命令不得超过32条（可以依照线路质量和服务器解决能力配备）。长连接方式详细请见附录E。在PDSCP以RECEIVER方式连接到SMSC状况下，SMSC与PDSCP通信开始后来，SMSC可以向PDSCP发送相应命令，PDSCP对收到命令返回应答。下图描述了PDSCP以REVEIVER方式和SMSC通信过程图3PDSCP以REVEIVER方式和SMSC通信过程样例PDSCP与SMSC间连接为长连接，PDSCP通过发送ENQUIRE_LINK来查询连接状况。在PDSCP以TRANSMITIER方式连接到SMSC状况下，需要发短消息时候,向SMSC发起SUBMIT_SM消息，SMSC返回祈求应答。下图描述了PDSCP以TRANSMITIER方式和SMSC通信过程图4PDSCP以TRANSMITIER方式和SMSC通信过程样例在PDSCP以TRANSCEIVER方式连接到SMSC状况下，PDSCP可以从SMSC接受或发送消息给SMSC。下图描述了PDSCP以TRANSCEIVER方式和SMSC通信过程。图5PDSCP以TRANSCEIVER方式和SMSC通信过程样例SMSC与PDSCP通信使用SMPP扩展消息鉴权描述当前联通预付费顾客点到点业务重要采用先发送后计费方式；被叫顾客成功收到消息后SMSC生成话单，再由计费中心解决。但要实现计费实时性，也即采用先计费后发送方式，SMSC必要要向PDSCP发送鉴权消息。鉴权祈求消息参数(auth_acc)合同版本号短信息中心标志来源地址目地址短消息ID短消息长度业务标志短信息内容方向： SMSC－>PDSCP参数阐明：SMPP合同版本号为长度1正整数，不分子版本。短消息中心标志，来源地址，为以NULL(0X0)结尾十进制字符串，最大长度不超过21位，用ASICA码表达每一位数字。短消息ID为最长为20字节C_HexString类型，用于和计费详单相应。是唯一标志鉴权消息。当SMSC生成补款话单时，通过短消息ID，可以判断对那个顾客进行补款。短消息ID建议由数字串构成。短消息长度为长度4字节正整数，按流量计费时使用。业务标志为长度4字节正整数，表达该条短消息使用了什么业务。鉴权祈求响应消息参数(auth_acc_resp)操作成果告知模式方向： SMSC<－PDSCP阐明：操作成果为长度为4整数，当前取值为： 0 操作成功 非0 操作不成功，当前详细取值如下：合同版本不支持2-9内部保存值 10 其她 11 顾客帐号不存在 12 顾客状态不对的 13 顾客金额局限性14 顾客帐号不支持增值业务15 顾客帐号是和约顾客注：该取值范畴依照业务需要将来也许扩充。告知模式为长度为1整数，当前取值为： 1 不论短消息发送成功或失败都告知PDSCP 2 仅当短消息发送失败时告知PDSCP 3 仅当短消息发送成功时告知PDSCP 4 不论短消息发送成功或失败都不告知PDSCP错误解决SMPP层错误在Command_status中统一定义，应用层错误在鉴权响应中鉴权成果中定义。对于操作超时，则SMSC记录日记，不必重发。如果错误是SMPP层错误或操作超时，则SMSC应当按照普通CDMA顾客解决(发送短消息)，如果是应用层错误，则不发送短消息，不走后续流程。状态报告描述由于预付费短消息计费方式采用先计费后发送方式，对于顾客不能成功发送短消息，需要对顾客进行补款，补款方式就是SMSC向PDSCP发送成果告知消息。此消息由PDSCP及SMSC协商使用。成果告知消息参数(sm_result_notify)短消息ID操作成果方向： SMSC－>PDSCP阐明：短消息发送成果为长度为4字节整数，当前取值为：0发送成功非0发送失败因素值，用于后来区别不同失败因素，如被叫顾客不可及、内存满、鉴权失败等因素。成果告知响应消息参数(sm_result_notify_resp)操作成果方向： SMSC<－PDSCP阐明：操作成果为长度为4整数，当前取值为： 0 操作成功 非0 操作不成功，当前详细取值如下：2-9内部保存值 10 其他 11 没有相应消息ID号错误解决应用层错误在成果告知响应成果中定义。顾客变更告知描述顾客变更告知消息是保证短消息中心实时懂得顾客智能属性更改信息顾客变更告知消息参数(user_chanage_noti)顾客号码顾客可用智能业务属性操作类型方向： PDSCP－>SMSC顾客变更告知响应消息参数(user_change_noti_resp)操作成果方向： PDSCP<－SMSC错误解决应用层错误在顾客变更告知响应成果中定义。通信合同PDSCP与SMSC之间消息PDSCP与SMSC之间通信支持如下消息：消息阐明BIND_RECEIVERPDSCP接受SMSC消息时，PDSCP向SMSC发送连接祈求消息BIND_RECEIVER_RESPPDSCP接受SMSC消息时，SMSC向PDSCP反馈连接祈求响应消息AUTH_ACC鉴权祈求消息，SMSC－>PDSCPAUTH_ACC_RESP鉴权响应消息，PDSCP－>SMSCSM_RESULT_NOTIFY短消息成果告知消息，SMSC－>PDSCPSM_RESULT_NOTIFY_RESP短消息成果告知响应消息，PDSCP－>SMSCUSER_CHANGE_NOTI顾客变更告知消息，PDSCP->SMSCUSER_CHANGE_NOTI_RESP顾客变更告知应答消息，SMSC->PDSCPBIND_TRANSMITIERPDSCP向SMSC发消息时，PDSCP向SMSC发送连接祈求消息BIND_TRANSMITIER_RESPPDSCP向SMSC发消息时，SMSC向PDSCP反馈连接祈求响应消息ENQUIRE_LINKPDSCP用于确认与SMSC连接消息ENQUIRE_LINK_RESPSMSC反馈给PDSCP确认连接响应消息UNBIND断开PDSCP与SMSC连接消息UNBIND_RESP断开PDSCP与SMSC连接响应消息SUBMIT_MSPDSCP向SMSC提交短消息消息SUBMIT_MS_RESPPDSCP向SMSC提交短消息响应消息消息定义定义消息由消息头和消息体构成。数据类型在如下语法阐明中，遵从如下规则：1.未使用字段，根据类型必要设立为0或NULL。2.消息由消息头和消息体构成。3.状态(Command_status)定义如下表：错误代码描述E_SUCCESS（0X00000000）成功E_OTHERERR（0X00000001）其她错误E_SMIDREPEAT（0X00000002）短消息ID重复（扩展代码）E_MSGLENERR（0X00000010）消息长度错误E_CMDLENERR（0X00000011）命令长度错误E_INVLDCMDID（0X00000012）消息ID无效E_NORIGHT（0X00000013）没有执行此命令权限E_INVLDSYSTEMID（0X00000020）无效SYSTEMIDE_INVLDPASSWORD（0X00000021）无效密码E_INVLDSYSTEMTYPE（0X00000022）无效SYSTEMTYPEE_ADDRERR（0X00000040）地址错误E_MOEXCEED（0X00000041）超过最大提交数E_MTEXCEED（0X00000042）超过最大下发数E_INVLDUSER（0X00000043）无效顾客E_INVLDDATAFMT（0X00000044）无效数据格式E_CREATEMSGFAILURE（0X00000045）创立消息失败E_INVLDMSGID（0X00000046）无效短消息IDE_DATABASEFAILURE（0X00000047）数据库失败E_INVLDORGTON（0X00000060）无效源地址TONE_INVLDORGNPI（0X00000061）无效源地址NPIE_ORGADDRERR（0X00000062）源地址错误E_INVLDDESTTON（0X00000063）无效目地址TONE_INVLDDESTNPI（0X00000064）无效目地址NPIE_DESTADDRERR（0X00000065）目地址错误E_INVLDSCHEDULE（0X00000066）无效定期时间E_INVLDEXPIRE（0X00000067）无效超时时间E_INVLDESM（0X00000068）无效ESM_CALSSE_INVLDUDLEN（0X00000069）无效UDLENE_INVLDPRI（0X0000006A）无效PRIE_INVLDRDF（0X0000006B）无效Registered_delivery_flagE_INVLDRPF（0X0000006C）无效Replace_if_present_flag其她保存在类型中，也许用到如下定义 *Integer :一定字节数所构成整数，高位在前，低位在后。例 如：1字节（BYTE），2字节（WORD)，4字节(DWORD 、6字节等等。 *C_String :以NULL结束ASCII字符串。 *C_DecString :以NULL结束ASCII字符串，它由一系列10进制字符 构成(‘0’‘9’ *C_OctetString :由任意8位字节构成数据流串。 *C_HexString :以NULL结束ASCII字符串，它由一系列16进制字符构成(‘0’‘9’，‘A’(‘a’)‘F’(‘f’ *C_UnicodeString：以NULL结束Unicode编码字符串。 *C_StringTime ：表达时间字符串，它格式为“YYMMDDhhmmsstnnp"，详细定义见GSM3.39。消息头格式字段长度（字节）类型阐明Command_Length4Integer消息包长度，涉及此字段Command_ID4Integer这个字段表白此条短消息类型，例如AUTH_ACC表达此消息为SMSC向PDSCP发送鉴权消息。Command_status4Integer此字段表达一种命令成功与失败，如失败，批示引起失败错误类型等信息，它在祈求中必要设为0。Sequence_No4Integer此字段表达消息序列号，它由消息源产生，它是消息和它应答之间相应标志，它数值在0到0XFFFFFFFF间必要保证严格单调递增，当达到0XFFFFFFFF时，从0开始下一循环。OptionalMessageBody可变混合此字段请见消息体某些消息体格式AUTH_ACC消息方向SMSC－－>PDSCP定期器medium，40s字段长度（字节）类型阐明Version1Integer合同版本SMSC_Address21C_DecString短信息中心地址Source_Address21C_DecString源地址Destination_Address21C_DecString目地址SM_ID9C_HexString短消息IDSM_Length4Integer短消息长度Service_ID4Integer业务标志AUTH_ACC_RESP消息字段长度（字节）类型阐明Operation_Result4Integer0 操作成功非0 操作不成功，取值如下：1 合同版本不支持10 其她11 顾客帐号不存在12 顾客状态不对的13 顾客金额局限性14 顾客增值业务不支持15顾客是和约顾客16顾客号码已挂失17顾客号码已处在保存期18顾客号码处在冷冻期短消息中心收到顾客帐号不存在时应删除该顾客信息Notify_Mode1Integer1不论成功或失败都发送2仅失败时发送3仅成功时发送4不论成功或失败都不发送缺省设立2SM_RESULT_NOTIFY消息字段长度（字节）类型阐明SM_ID20C_HexString短消息ID，和鉴权消息中短消息ID一一相应Result4Integer0：成功其他：失败SM_RESULT_NOTIFY_RESP消息字段长度（字节）类型阐明Operation_Result4Integer0 操作成功 非0 操作不成功，当前详细取值如下：2-9内部保存值 10 其他 11 没有相应消息ID号USER_CHANGE_NOTI消息方向PDSCP－－>SMSC定期器medium，40s字段长度（字节）类型阐明User_Address最大21C_DecString顾客号码Serv_Type1Integer顾客可用智能业务属性1.PPC2VPN3-7保存Oper_Type1Integer操作类型1激活智能属性2去激活3新增智能顾客4删除智能顾客默认值为3USER_CHANGE_NOTI_RESP消息字段长度（字节）类型阐明Operate_Result1Integer顾客变更告知成果：0 操作成功1 祈求消息参数错误2 顾客不存在3 系统错误5 其他错误6保存>6同5BIND_RECEIVER消息字段长度（字节）类型阐明System_id16C_String接口IDPassword9C_String密码System_type13C_String接口类型Interface_version1Integer接口版本号Ton1Integer保存，应设立为0Npi1Integer保存，应设立为0Address_range41C_DecString保存，应设立为NULLBIND_RECEIVER_RESP消息字段长度（字节）类型阐明System_id最大16C_String接口ID,状态取值范畴：E_SUCCESSE_OTHERERRE_CMDLENERRE_NORIGHTE_INVLDSYSTEMIDE_INVLDPASSWORDE_INVLDSYSTEMTYPEE_INVLDIFVERBIND_TRANSMITIER消息此命令和BIND_RECEIVER语法同样，只是在消息头里Command_ID为"bind_transmitter"。BIND_TRANSMITTER_RESP消息此命令和BIND_RECEIVER_RESP语法同样，只是在消息头里Command_ID为"bind_transmitter_resp"。状态取值范畴：同BIND_RECEIVER_RESP。UNBIND消息此命令用于断开PDSCP和SMSC之间连接。UNBIND语法此消息只有消息头，没有消息体，消息头中Command_ID是“unbind"。UNBIND_RESP消息UNBIND_RESP语法此消息只有消息头，没有消息体，消息头中Command_ID是“unbind_resp"。状态取值范畴：E_SUCCESSE_OTHERERRE_CMDLENERRE_NORIGHTSUBMIT_MS消息字段长度（字节）类型阐明Service_type6C_OctetString保存，必要设为0Source_address_ton1Integer源地址编码类型Source_address_npi1Integer源地址编码方案Source_address21C_DecString源地址Dest_address_ton1Integer目地址编码类型Dest_address_npi1Integer目地址编码方案Destination_address21C_DecString目地址Esm_class1Integer短消息类型Protocol_ID1IntegerGSM合同类型Priority_flag1Integer优先级Schedule_delivery_time17C_StringTime筹划下发短消息时间Validity_peroid17C_StringTime短消息最后有效期限Registered_delivery_flag1Integer注册短消息标志Replace_if_present_flag1Integer替代短消息标志。Data_coding1Integer数据编码方案Sm_default_msg_id1Integer预定义短消息IDSm_length1Integer短消息长度Short_message_text161可变短消息数据内容SUBMIT_MS_RESP消息字段长度（字节）类型阐明Message_id最大为9C_HexString短消息ID状态取值范畴：E_SUCCESSE_OTHERERRE_CMDLENERRE_NORIGHTE_ADDRERRE_MOEXCEEDE_MTEXCEEDE_INVLDUSERE_INVLDDATAFMTE_CREATEMSGFAILUREE_INVLDORGTONE_INVLDORGNPIE_ORGADDRERRE_INVLDDESTTONE_INVLDDESTNPIE_DESTADDRERRE_INVLDSCHEDULEE_INVLDEXPIREE_INVLDESME_INVLDUDLENE_INVLDPRIE_INVLDRDFE_INVLDRPFENQUIRE_LINK消息PDSCP定期用enquire_link来定期检查连接与否保持。enquire_link：方向：SMSC<－PDSCP；定期器medium，15s；若5次查询失败则重新建立连接。此命令只有消息头，没有消息体，消息头中Command_ID是"enquire_link"。ENQUIRE_LINK_RESP消息此命令只有消息头，没有消息体，消息头中Command_ID是"enquire_link_resp"。状态取值范畴：E_SUCCESSE_OTHERERRE_CMDLENERRE_NORIGHT命令标志数值定义1．原有消息命令宏定义数值阐明BIND_RECEIVER0X00000001PDSCP接受SMSC消息时，PDSCP向SMSC发送连接祈求消息BIND_RECEIVER_RESP0X80000001PDSCP接受SMSC消息时，SMSC向PDSCP反馈连接祈求响应消息BIND_TRANSMITIER0X00000002PDSCP向SMSC发消息时，PDSCP向SMSC发送连接祈求消息BIND_TRANSMITIER_RESP0X80000002PDSCP向SMSC发消息时，SMSC向PDSCP反馈连接祈求响应消息ENQUIRE_LINK0X00000015PDSCP用于确认与SMSC连接消息ENQUIRE_LINK_RESP0X80000015SMSC反馈给PDSCP确认连接响应消息UNBIND0X00000006断开PDSCP与SMSC连接消息UNBIND_RESP0X80000006断开PDSCP与SMSC连接响应消息SUBMIT_MS0X00000004PDSCP向SMSC提交短消息消息SUBMIT_MS_RESP0X80000004PDSCP向SMSC提交短消息响应消息2．扩展消息命令宏定义数值阐明AUTH_ACC0x01000001鉴权祈求消息AUTH_ACC_RESP0x81000001鉴权响应消息SM_RESULT_NOTIFY0X01000002成果告知消息。SM_RESULT_NOTIFY_RESP0X81000002成果告知响应消息USER_CHANGE_NOTI0X01000003顾客变更告知消息USER_CHANGE_NOTI_RESP0X81000003顾客变更告知响应消息附录A顾客状态报告PDSCP定期（可配备暂定为15分钟）到网桥SMB及短消息中心SMSC获取补款话单，并进行解决。SMSC及SMB必要支持FTP合同，并作为FTP服务器端，并开放一种存储补款话单目录以定期以定期生成补款话单。补款话单由SMSC及SMB产生，并且每隔15分钟生成一种文献。PDSCP具备读及删除文献权限。SMSC补款报告文献命名规则文献名命名为22位（含扩展名），规则为:网络标记(1)+长途区号(3)+文献创立时间(14)”.”+扩展名(3)各个字段含义如下：网络标记：一位，表达是G网还是C网，取值：C-CDMA网,G-GSM网长途区号：三位，该文献中顾客归属本地网区号，不涉及前缀0，局限性3位背面补0。文献创立时间。十四位，格式YYYYMMDDHHMMSS，年局限性四位、月、日、时分秒局限性两位，则左取零。以北京时间为准。文献后缀：三位，涉及：TMP-正在传送中，AVL-当前工作文献，OLD-旧资料文献。文献格式文献为原则文本格式文献，第一行为文献头，背面为文献内容，格式如下：文献头序号名称字节数备注网络类型1G-GSM,C-CDMA文献版本号200文献产生时间14YYYYMMDDHHMMSS总记录数12右对齐，左补0。分隔符1\n文献体序号名称字节数备注短消息中心标志21短消息中心标志，最大长度不超过21位；右对齐，左补0。计费顾客号码15A号码：以8613开头全数字，是被计费号码；右对齐，左补0。短消息ID9短消息ID为最长为9字节C_HexString类型，用于和计费详单相应。是唯一标志鉴权消息。通过短消息ID，可以判断与否需要对某顾