福建联通分公司代理商管理系统数据接口设计

《福建联通分公司代理商管理系统数据接口设计》由会员分享，可在线阅读，更多相关《福建联通分公司代理商管理系统数据接口设计（30页珍藏版）》请在金锄头文库上搜索。

1、福建联通分公司代理商管理系统福建联通分公司代理商管理系统数据接口设计数据接口设计数据接口设计数据接口设计（软件）（软件）V1.0深圳市新宇龙信息科技地 址：深圳市福田区天安数码城天祥大厦 A 座 13 楼电 话：0755-82924488传 真：0755-82924449E-mail： 文档建立、修改文档建立、修改记录记录修改日期修改日期作者作者修订版本修订版本备注备注2004-11-25王廷炫0. 4修订2004-11-26华德演0. 4修订目目 录录1、 引言引言.71-1、 项目背景.71-2、 文档目的.72、 接口文件说明接口文件说明.82-1、 接口基本情况说明.82-1-1、 接

2、口方式.82-2、 接口实现.82-2-1、 文件命名规范.82-2-2、 接口文件编码.82-2-3、 接口文件内容说明.102-2-4、 数据提取时间.12用户信息接口用户信息接口.132-2-5、 接口信息总体描述.132-2-6、 接口传递周期.132-2-7、 GSM用户信息接口数据格式.132-2-8、 CDMA用户信息接口数据格式.142-2-9、 193长途用户信息接口数据格式.142-2-10、 智能网用户信息接口数据格式.142-3、 CDMA 担保信息接口.142-3-1、 接口信息总体描述.142-3-2、 接口传递周期.142-3-3、 CDMA担保信息接口数据格式.

3、142-4、 CDMA 用户资料（手机）信息接口.152-4-1、 接口信息总体描述.152-4-2、 接口传递周期.152-4-3、 CDMA用户资料（手机）信息接口数据格式.152-5、 营业收费项目信息接口.162-5-1、 接口信息总体描述.162-5-2、 接口传递周期.162-5-3、 营业收费项目接口数据格式.162-6、 营业收退银信息接口.172-6-1、 接口信息总体描述.172-6-2、 接口传递周期.172-6-3、 营业收退银信息数据格式.172-7、 用户详细帐单接口.182-7-1、 接口信息总体描述.182-7-2、 接口传递周期.182-7-3、 GSM用户详

4、细帐单数据格式.182-7-4、 CDMA用户详细帐单数据格式.182-7-5、 193长途用户详细帐单数据格式.192-7-6、 智能网用户详细帐单数据格式.192-8、 用户帐单销帐接口.192-8-1、 接口信息总体描述.192-8-2、 接口传递周期.192-8-3、 GSM用户帐单销帐数据格式.192-8-4、 CDMA用户帐单销帐数据格式.202-8-5、 193长途用户帐单销帐数据格式.202-8-6、 智能网用户帐单销帐数据格式.202-9、 补卡资料接口.202-9-1、 接口信息总体描述.202-9-2、 接口传递周期.202-9-3、 补卡资料接口数据格式.202-10、

5、 换卡资料接口.212-10-1、 接口信息总体描述.212-10-2、 接口传递周期.212-10-3、 换卡资料接口数据格式.212-11、 套餐变更记录接口.222-11-1、 接口信息总体描述.222-11-2、 接口传递周期.222-11-3、 套餐变更记录接口数据格式.222-12、 操作员工号信息接口.222-12-1、 接口信息总体描述.222-12-2、 接口传递周期.232-12-3、 操作员工号信息接口数据格式.232-13、 营业地信息接口.232-13-1、 接口信息总体描述.232-13-2、 接口传递周期.232-13-3、 营业地信息接口数据格式.232-14、

6、 套餐信息接口.242-14-1、 接口信息总体描述.242-14-2、 接口传递周期.242-14-3、 GSM套餐信息接口数据格式.242-14-4、 CDMA套餐信息接口数据格式.242-14-5、 193长途套餐信息接口数据格式.242-14-6、 智能网套餐信息接口数据格式.252-15、 欠费信息接口.252-15-1、 接口信息总体描述.252-15-2、 接口传递周期.252-15-3、 欠费信息接口数据格式.252-16、 用户资料（客户化优惠）信息接口.262-16-1、 接口信息总体描述.262-16-2、 接口传递周期.262-16-3、 G网用户资料（客户化优惠）信息

7、接口数据格式.262-16-4、 C网用户资料（客户化优惠）信息接口数据格式.262-17、 套餐优惠（客户化优惠）信息接口.262-17-1、 接口信息总体描述.262-17-2、 接口传递周期.262-17-3、 G网套餐优惠（客户化优惠）信息接口数据格式.262-17-4、 C网套餐优惠（客户化优惠）信息接口数据格式.272-18、 设备名称接口.282-18-1、 接口信息总体描述.282-18-2、 接口传递周期.282-18-3、 设备名称接口数据格式.282-19、 设备型号接口.282-19-1、 接口信息总体描述.282-19-2、 接口传递周期.292-19-3、 设备型号

8、接口数据格式.292-20、 预存款明细接口.292-20-1、 接口信息总体描述.292-20-2、 接口传递周期.292-20-3、 CDMA预存款明细接口数据格式.291、引言引言1-1、项目背景项目背景1-2、文档目的文档目的2、接口文件说明接口文件说明2-1、接口基本情况说明接口基本情况说明2-1-12-1-1、接口方式接口方式数据文件定时入库为主，数据文件手工入库作为备用；采取由专业系统利用 SQLLOAD 入库的方式实现。2-2、接口实现接口实现2-2-12-2-1、文件命名规范文件命名规范序号名 称字节数备 注1dls3 byte代理商文件标志2连接符1 byte_3接口信息编

9、号1 byte见信息接口编号4连接符1 byte_5文件时间标志8 bytes日期为 8 位日期格式：YYYYMMDD6文件名字分隔符1 byte.7后缀3 bytesTxt2-2-22-2-2、接口文件编码接口文件编码2-2-2-12-2-2-1、接口信息编号接口信息编号接口名称子接口名称接口编号备注GSM 用户信息接口0001CDMA 用户信息接口0002193 长途用户信息接口0003用户信息接口智能网用户信息接口0004CDMA 担保信息接口0101CDMA 用户资料（手机）接口0201营业收费项目信息接口0301营业收退银信息接口0401GSM 用户详细帐单接口0501CDMA 用户

10、详细帐单接口0502193 长途用户详细帐单接口0503用户详细帐单接口智能网用户详细帐单接口0504GSM 用户帐单销帐接口0601CDMA 用户帐单销帐接口0602193 长途用户帐单销帐接口0603用户帐单销帐接口智能网用户帐单销帐接口0604补卡资料接口0701换卡资料接口0801套餐变更记录接口0901操作员工号信息接口1001营业地信息接口1101GSM 套餐信息接口1201CDMA 套餐信息接口1202193 长途套餐信息接口1203套餐信息接口智能网套餐信息接口1204欠费信息接口1301GSM 用户资料（客户化优惠）信息接口1401用户资料（客户化优惠）信息接口CDMA 用户

11、资料（客户化优惠）信息接口1402GSM 套餐优惠（客户化优惠）信息接口1501套餐优惠（客户化优惠）信息接口CDMA 套餐优惠（客户化优惠）信息接口1502设备名称接口1601设备型号接口1701预存款明细接口CDMA 预存款明细接口18011. “接口信息编号”编号规则为：编号长度为 4 位，前两位表示接口类型编码，后两位为子接口编码。例如 1204，12 表示接口类型为套餐信息接口，04 表示其子接口为智能网业务。2. “文件时间标志”目前接口中的传送周期均为“月传”，如果 2004 年2 月 10 日上传的应该是 2002 年 1 月的数据，则该文件名此字段的取值应该为 2000401

12、00。例： DLS_0001_20040300.Txt，即 0001 号接口文件(GSM 用户信息)2004年 3 月的数据。 DLS_0901_20040300.Txt，即 2004 年 3 月的套餐变更记录数据。 DLS_1204_20040400.Txt，即 2004 年 4 月的智能网套餐信息。2-2-32-2-3、接口文件内容说明接口文件内容说明2-2-3-12-2-3-1、文件头文件头每个接口数据文件的第一行为文件头部分，格式如下序号名 称字节数备 注1.接口编码4 bytes如：0001 为 G 网用户资料2.空格2 byte3.文件产生日期8 bytesYYYYMMDD4.空格

13、2 byte5.统计起始日期8 bytesYYYYMMDD6.空格1 byte7.统计起始时间6 bytesHHMMSS8.空格2 byte9.统计终止日期8 bytesYYYYMMDD10.空格1 byte11.统计终止时间6 bytesHHMMSS12.空格2 byte13.本文件中记录数目10 bytes不含首记录。 右对齐，左补 014.空格2bytes15.文件体中分隔符1byte16.回车1 byte17.换行1 byte注：1.“文件产生日期”开始生成该接口文件的日期如果该接口文件为日报，则文件产生日期为 YYYYMMDD；如果该接口文件是月报，则文件产生日期为 YYYYMM00

14、；2.“统计起始日期”、“统计起始时间”接口文件所包含的数据的起始日期、时间。如果该接口文件是日报，则统计起始日期为 YYYYMMDD，统计起始时间为 000000；如果该接口文件是月报，则统计起始日期可以为 YYYYMM00，统计起始时间为 000000；3.“统计终止日期”、“统计终止时间”接口文件所包含的数据的终止日期、时间。如果该接口文件为日报，则统计终止日期为 YYYYMMDD，统计终止时间为 235959；如果该接口文件为月报，则统计终止日期为 YYYYMM00，统计终止时间为000000；4.“本文件中记录数目”接口文件中做包含的数据记录数目，用来判别文件中的数据是否完整。“文件

15、中分隔符”接口文件文件体中的字段分隔符号。2-2-3-22-2-3-2、文件体文件体1.文件体部分的格式参见各信息接口的描述2.文件体部分的每一行对应一条完整的数据，不支持将一条数据分成两行。3.一条完整数据中的每个字段采取不定长的方式，字段之间采取 TAB 符号进行分隔（举例：AA TAB 键 0 x09AA TAB 键 0 x09AA），每行之间用“换行符 0 x0a”分隔字段具体内容参见各信息接口中的规定。（时间类型还得需要定长）4.文件体中字段内容全部采用字符串类型；源表字段与文件中字段类型转换对照文件体中数据类型定义：文件体中数据类型定义：源表字段文件字段时间（Date）CHAR(1

16、9)形如：YYYY-MM-DD HH24:MM:SS；对于只有日期（YYYY-MM-DD）的情况，则时间（HH24:MM:SS）取（00:00:00）实型（Float）采用标准型（例如：1234.57）,不采用科学计数法2-2-3-32-2-3-3、文件尾文件尾文件尾的格式为序号名 称字节数备 注1.ASCII(27)1 byte数据文件的结束符2-2-42-2-4、数据入库时间数据入库时间月传数据的数据入库时间为每月的 8 日早 5 时。日传数据的数据入库时间为每日晚 10 时 30 分。2-3、用户信息接口用户信息接口2-3-12-3-1、接口信息总体描述接口信息总体描述在系统进行割接时传递某一个时点的全部用户信息，以后的接口中的信息是本接口在一个传递周期内发生变更的用户部分信息。数据来源于综合营帐的用户资料表，不同的业务类型的数据来源于不同的表。2-3-22-3-2、接口传递周期接口传递周期以天为单位入库数据。2-3-32-3-3、GSMGSM 用户信息接口数据格式用户信息接口数据格式字段英文名字段名称参数类型可否为空主键说 明OFFICE发展营业地N营业地类型（04、05、08