中国电信领航平台(ISMP-B)技术规范——省领航平台管理子系统产品接入接口(V3.0) 下载本文

Q/CT XXXX-2014

01:条(页) 02:秒 03:次 04:字节 消费标记 消费标记 0:普通用户 1:测试用户使用测试业务 2:红名单用户(公免帐号) 地区 市+地区 AreaCode Varchar2(5) ConsTag Number(2,0)

5.3.1.5 异常处理 5.3.1.5.1

文件级错误-拒收文件

? 拒收文件命名规则

首先进行文件级错误校验,如有文件级错误则在原文件名前加上5位拒收错误代码,如:产品平台上传的文件名UseProductID_YYMMDDRRRRRNNNNN,省领航平台(ISMP-B)检查的拒收错误代码为F1001,则拒收文件名为F1001 UseProductID_YYMMDDRRRRRNNNNN。拒收文件的内容不变,同原产品平台上传文件的内容。

? 文件名错误规则

表 35 FTP方式使用清单采集接口文件级错误-拒收文件文件名错误规则

错误代码 F8000 F8001 F8002 F8003 F8004 F1001 文件名格式错误 文件名中的日期不合法 文件名日期大于当前系统日期加一天(即:今天收到了后天及以后的话单,则F8002拒收) 文件名日期小于系统日期7天及以上(精确到日) 文件名序号不正确 话单文件重复上传 错误描述 ? 文件级错误校验规则

表 36 FTP方式使用清单采集接口文件级错误-拒收文件文件级错误校验规则

错误代码 F1200 F1300 F1400 F1401 F1700 头记录格式不正确。 头记录版本号不正确 文件名中的序号与头记录中的序号不一致 文件名中的记录总数与头记录中的记录总数不一致 头记录中的记录合计值与文件中的总数不等 错误描述 注:拒收文件的修复后上传是需要用新文件名。

43

Q/CT XXXX-2014

5.3.1.5.2

记录级错误-错误文件

? 错误文件命名规则

省领航平台(ISMP-B)收到一个没有文件级错误的话单文件,则对该文件进行话单级校验,若发现有严重错误,则系统自动产生错误话单文件,上传到FTP。文件命名方法为在原文件后加上后缀.ERR。

如:产品平台上传的文件名UseProductID_YYMMDDRRRRRNNNNN,则错误文件名为UseProductID_YYMMDDRRRRRNNNNN.ERR。错误文件的内容参照5.3.1.5.2.3。

? 错误文件校验规则

判断重单规则是:企业编号+客户ID+用户ID+产品编号+业务开始时间

表 37 FTP方式使用清单采集接口记录级错误-错误文件错误文件校验规则

错误代码 E0001 E0101 E0201 E1201 E1301 E1401 E1501 E1601 E1701 E1801 重单 CDRType值非0或1 ChargePartyType非0,1,2 BeginTime非日期时间格式 EndTime非日期时间格式 ServiceNum非数字 FeeType非01,02,03,04 Unit非01,02,03,04 ConsTag非0,1,2 AreaCode非法区号 错误描述

? 错误回执记录定义 a) 头记录

表 38 FTP方式使用清单采集接口记录级错误-错误文件错误回执记录定义头记录

字段名称 记录类型 发起方 接收方 文件序号 类型 INTEGER STRING STRING 最大长度 4 8 8 4 Tag 50 51 52 53 有效值 10 文件生成方。 文件接收方。 文件名中的序号; 从0001累加,按天循环; 文件产生日期 文件版本号 STRING INTEGER 14 4 54 55 YYYYMMDDHHMISS 10

b) )记录体

表 39 FTP方式使用清单采集接口记录级错误-错误文件错误回执记录定义记录体

字段名 RecordType Error Code 44

记录类型 错误代码 类型 INTEGER STRING 最大长度 4 4 有效值 01 话单级检验错码,参见5.3.1.5.2.2节各种 Q/CT XXXX-2014

格式的检验标准。 Error Line 错误行号 INTEGER 4

c) 尾记录

表 40 FTP方式使用清单采集接口记录级错误-错误文件错误回执记录定义尾记录

字段名称 记录类型 发起方 接收方 文件序号 错单数(包含重单) 类型 INTEGER STRING STRING STRING INTEGER 长度 4 8 8 4 4 Tag 50 51 52 53 72 90 文件生成方。 文件接收方。 文件名中的序号 有效值

5.3.2 业务使用情况采集接口 5.3.2.1 接口协议概述

? 接口名称:业务使用情况采集接口。

? 接口描述:省领航平台(ISMP-B)管理子系统以FTP服务端的方式提供产品平台上传业务使用情况

清单的文件。

? 接口协议:FTP 协议。

? 接口调用方向:产品平台? 省领航平台(ISMP-B)管理子系统。

? 触发条件:产品平台主动定时(可设置)向省领航平台(ISMP-B)管理子系统上传。 ? 文件文本格式:文件中各字段间采用分隔符(可配置,默认为半角分号“|”),清单与清单之间

采用回车换行(/n/r),每个字段的值不能包含有回车符或者“|”分隔符。 ? 核对文件结果:文件名.OK。

45

Q/CT XXXX-2014

5.3.2.2 接口流程

产产产产产产产产产(ISMP-B)产产产产产1产产产产产产产产产产2产产产产产产产产产产产产产产产产产产产产3产产产产产产产产4产产产产产产

图 11 FT P方式业务使用情况采集接口流程

1) 2) 3) 4)

产品平台导出业务使用情况清单上传到指定FTP文件夹; 省领航平台(ISMP-B)管理子系统定时下载业务使用情况清单; 省领航平台(ISMP-B)管理子系统采集处理业务使用情况清单; 返回并修改业务使用情况清单文件名。

5.3.2.3 文件命名和存放路径

? 文件命名:BusinessProductID_YYMMDDRRRRRNNNNN,其中YYMMDD为年月日时分秒;RRRRR为文件

记录条数,记录条数最大数为50000;NNNNN为序列号,序列号最大值为99999时,超过时,序号需再从1开始累计,每一个文件都比上个文件的文件名加1。

? 省领航平台(ISMP-B)管理子系统在获取清单后立即产生回执文件QC+QC文件生成时间+原文件名,

内容为空,同时将文件上传到指定ftp上,处理完成后,如正确则在原目录中将对应文件后添加后缀名OK即可。即原文件若为BusinessProductID_0903210000200001,更改为BusinessProductID_0903210000200001.OK。省领航平台(ISMP-B)管理子系统定期将已处理的文件移到其它文件夹当备份文件。如有错误则按照5.3.2.5异常处理方式,同时将文件上传到ftp上

? 目录: $BusinessProduct/ 5.3.2.4 数据信息定义

? 数据项名称:业务使用情况 ? 文件头定义:

表 41 FTP方式业务使用情况采集接口数据信息定义文件头定义

参数名 Sender 数据类型 String 出现次数 1 是否必填 是 长度 8 注释 发起方 SI编码 Receiver 46

String 1 是 8 接收方