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

福建联通分公司代理商管理系统数据接口设计内容摘要：

营业收费项目信息接口 0301 营业收退银信息接口 0401 用户详细帐单接口 GSM 用户详细帐单接口 0501 CDMA用户详细帐单接口 0502 193 长途用户详细帐单接口 0503 智能网用户详细帐单接口 0504 用户帐单销帐接口 GSM 用户帐单销帐接口 0601 CDMA用户帐单销帐接口 0602 193 长途用户帐单销帐接口 0603 智能网用户帐单销帐接口 0604 补卡资料接口 0701 换卡资料接口 0801 套餐变更记录接口 0901 操作员工号信息接口 1001 营业地信息接口 1101 套餐信息接口 GSM 套餐信息接口 1201 CDMA套餐信息接口 1202 193 长途套餐信息接口 1203 智能网套餐信息接口 1204 欠费信息接口 1301 用户资料（客户化优惠）信息接口 GSM 用户资料（客户化优惠）信息接口 1401 CDMA用户资料（客户化优惠）信息接口 1402 套餐优惠（客户化优惠）信息接口 GSM 套餐优惠（客户化优惠）信息接口 1501 CDMA套餐优惠（客户化优惠）信息接口 1502 设备名称接口 1601 设备型号接口 1701 预存款明细接口 CDMA预存款明细接口 1801 1. “接口信息编号” —— 编号规则为：编号长度为 4 位，前两位表示接口类型YLFJA2020 福建联通代理商管理系统 数据接口设计 10－ 30 编码，后两位为子接口编码。 例如 1204， 12 表示接口类型为套餐信息接口，04 表示其子接口为智能网业务。 2. “文件时间标志” —— 目前接口中 的传送周期均为“月传”，如果 2020 年 2月 10 日上传的应该是 2020 年 1 月的数据，则该文件名此字段的取值应该为202040100。 例：  ，即 0001 号接口文件 (GSM 用户信息 )2020 年3 月的数据。  ，即 2020 年 3 月的套餐变更记录数据。  ，即 2020 年 4 月的智能网套餐信息。 22 接口文件内容说明 223 文件头 每个接口数据文件的第一行为文件头部分，格式如下 序号 名 称 字节数 备 注 1. 接口编码 4 bytes 如： 0001 为 G 网用户资料 2. 空格 2 byte 3. 文件产生日期 8 bytes YYYYMMDD 4. 空格 2 byte 5. 统计起始日期 8 bytes YYYYMMDD 6. 空格 1 byte 7. 统计起始时间 6 bytes HHMMSS 8. 空格 2 byte 9. 统计终止日期 8 bytes YYYYMMDD 10. 空格 1 byte 11. 统计终止时间 6 bytes HHMMSS 12. 空格 2 byte 13. 本文件中记录数目 10 bytes 不含首记录。 右对齐，左补 0 14. 空格 2bytes 15. 文件体中分隔符 1byte 16. 回车 1 byte 17. 换行 1 byte YLFJA2020 福建联通代理商管理系统 数据接口设计 11－ 30 注： 1.“文件产生日期” —— 开始生成该接口文件的日期 如果该接口文件为日报，则文件产生日期为 YYYYMMDD； 如果该接口文件是月报，则文件产生日期为 YYYYMM00； 2.“统计起始日期”、“统计起始时间” —— 接口文件所包含的数据的起始日期、时间。 如果该接口文件是日报，则统计起始日期为 YYYYMMDD，统计起始时间为000000； 如果该接口文件是月报， 则统计起始日期可以为 YYYYMM00，统计起始时间为 000000； 3.“统计终止日期”、“统计终止时间” —— 接口文件所包含的数据的终止日期、时间。 如果该接口文件为日报，则统计终止日期为 YYYYMMDD，统计终止时间为235959； 如果该接口文件为月报，则统计终止日期为 YYYYMM00，统计终止时间为000000； 4.“本文件中记录数目” —— 接口文件中做包含的数据记录数目，用来判别文件中的数据是否完整。 “文件中分隔符”――接口文件文件体中的字段分隔符号。 223 文件体 1. 文件体部分的格式参见各信息接口的描述 2. 文件 体部分的每一行对应一条完整的数据，不支持将一条数据分成两行。 3. 一条完整数据中的每个字段采取不定长的方式，字段之间采取 TAB 符号进行分隔（举例： AA TAB 键 0x09AA TAB 键 0x09AA）， 每行之间用 “换行符 0x0a” 分隔 字段具体内容参见各信息接口中的规定。 （时间类型还得需要定长） 4. 文件体中字段内容全部采用字符串类型；源表字段与文件中字段类型转换对照 YLFJA2020 福建联通代理商管理系统 数据接口设计 12－ 30 文件体中数据类型定义： 源表字段 文件字段 时间（ Date） CHAR(19) 形如：‘ YYYYMMDD HH24:MM:SS’； 对于只有日期（ YYYYMMDD）的情况，则时间（ HH24:MM:SS）取（ 00:00:00） 实型（ Float） 采用标准型（例如： ） ,不采用科学计数法 223 文件尾 文件尾的格式为 序号 名 称 字节数 备 注 1. ASCII(27) 1 byte 数据文件的结束符 22 数据 入库 时间 月传数据的数据 入库 时间为每月的 8 日 早 5 时。 日传数据的数据入库时间为每日晚 10 时 30 分。 2 用户信息接口 23 接口信息总体描述 在系统进行割接时传递某一个时点的全部用户信息，以后的接口中的信息是本接口在一个传递周期内发生变更的用户部分信息。 数据来源于综合营帐的用户资料表，不同的业务类型的数据来源于不同的表。 23 接口传递周期 以 天 为单位 入库 数据。 23 GSM 用户信息接口数据格式 字段英文名 字段名称 参数类型 可否为空 主键 说 明 OFFICE 发展营业地 N 营业地类型（ 0 0 08）定为代理商 OPTOR2 受理员工工号 CHAR(6) 操作员工号 ID_USER ID_用户 CHAR(10) N Y 指营帐中用 以唯一标识用户的编号 YLFJA2020 福建联通代理商管理系统 数据接口设计 13－ 30 TELNUM 用户号码 CHAR(15) N BUSI_MAN 经办人姓名 VARCHAR2(10) PRE_INNET_TM 开户时间 DATE USER_STA 用户状态 CHAR(2) 代理商系统提取用户状态类型包含（ 39。 IN39。 , 39。 OP39。 , 39。 ON39。 , 39。 FP39。 ,39。 YX39。 ,39。 BL39。 ,39。 LD39。 ） AREA 归属地区 CHAR(2) 号码所在区域编号，如：福 州 FZ(大写 ) PACK_BASE 资费套餐 CHAR(6) N PACK_SERV 服务优惠套餐 CHAR(6) INNET_TM 入网时间 DATE 用于判断用户是否入网的标志 UPDATE_TM 最近变更时间 DATE N OPTOR 发展人姓名 CHAR(7) 仅在 C 网用户资料中有该项 ACT_RESN 最近开停原因 CHAR(1) OUTNET_TM 离网时间 DATE 用户离网的时间 BUSINESS_TYPE 业务类型 CHAR(7) 保留 PROC_FLAG 处理标志 CHAR(1) 保留 PROC_DATE 处理时间 DATE 保留 数据来源： 目标表名： TIO_USER_INFO_G 23 CDMA用户信息接口数据格式 格式同 233 数据来源： 目标表名： TIO_USER_INFO_C 23 193 长途用户信息接口数据格式 格式同 233 数据来源： 目标表名： TIO_USER_INFO_L YLFJA2020 福建联通代理商管理系统 数据接口设计 14－ 30 23 智能 网用户信息接口数据格式 格式同 233 数据来源： 目标表名： TIO_USER_INFO_R 2 CDMA 担保信息接口 24 接口信息总体描述 用户的担保信息，主要提供用户所采用的担保类型信息以及用户的月最底消费金额等数据，作为与此信息相关的佣金结算的判断依据。 提取的数据为提取时间点所有的数据。 24 接口传递周期 以月为单位传递数据。 24 CDMA担保信息接口数据格式 字段英文名 字段名称 参数类型 可否为空 主键 说 明 ID_USER ID_用户 CHAR(10) N Y BUSI_TYPE 业务标识 CHAR(1) N Y WRNT_TYPE 担保类型 CHAR(2) N YZ_PR_WRNT_TYPE 中对担保类型进行描述 LASTFEE 月最低消费金额 NUMBER N WRNT_NAME 担保人或单位名称 VARCHAR2(60) N WRNT_DT 担保开始时间 DATE N END_DT 预计终止时间 DATE N WRNT_BANK 担保银行名称 VARCHAR2(80) WRNT_ACC 担保银行帐号 VARCHAR2(50) MPFEE_YN 是否缴纳购机款 CHAR(1) N MP_MODEL 手机机型 VARCHAR2(50) N MEMO 备注 VARCHAR2(150) AREA 地区编码 CHAR(2) N UPDATE_TM 最近变更时间 DATE N YLFJA2020 福建联通代理商管理系统 数据接口设计 15－ 30 END_DT2 实际终止时间 DATE LASTFEE2 累计最低消费 NUMBER COST_STA 消费标志 CHAR(1) N 数据来源： 目标表名： TIO_AR_USER_WRNTINFO 2 CDMA 用户资料（手机）信息接口 25 接口信息总体描述 用户入网方式及手机设备相关的信息 ，主要提供用户的入网方式，作为与入网方式有关的佣金规则结算的依据，提供入网用户手机的设备信息，作为与手机设备信息相关的佣金规则结算的数据。 每月提供全量数据。 25 接口传递周期 以月为单位传递数据。 25 CDMA用户资料（手机）信息接口数据格式 字段英文名 字段名称 参数类型 可否为空 主键 说 明 ID_USER ID_用户 CHAR(10) N Y EQPT_TYPE 手机类型编码 CHAR(4) N EQPT_NAME 手机品名编码 CHAR(4) N EQPT_MODEL 手机型号编码 CHAR(4) N EQPT_NUM 国际移动用户识别号 (手机串号 ) CHAR(20) N SALE_TM 销售时间 DATE N REPAIR_DT 保修期限（月） NUMBER(2) N SEND_YN 租送购标志 CHAR(1) N Y YZ_PR_INNET_TYPE中对租送购方式进行描述 UPDATE_TM 最近变更时间 DATE MANUF 供货商名称 CHAR(50) 数据来源： 目标表名： TIO_AR_USER_WRNTINFO YLFJA2020 福建联通代理商管理系统 数据接口设计 16－ 30 2 营业收费项目信息接口 26 接口信息总。