本地SP接口协议_all_20100621.docVIP

本地SP二次确认外部接口协议 (V1.0) 2010年6月 文档变更记录 序号 变更内容说明 版本号 版本日期 作者 1 初稿 1.0.0 2010-6-11 王建伟 目 录 文档变更记录 i 1. 概述 1 1.1. 文档概述 1 1.2. 接口列表 1 2. 接口数据格式 1 2.1. 数据描述约定 1 2.1.1. 约束符号 1 2.2. 数据文件格式定义 1 2.2.1. 数据文件命名规则 1 2.2.2. 数据文件内容格式 2 3. 订购信息 3 3.1. 文件接口 3 3.1.1. 个人订购本地SP信息 3 3.1.2. 个人订购本地SP信息确认 3 3.1.3. CRM侧本地SP业务订购取消同步接口（预留） 4 3.1.4. CRM侧本地SP业务订购取消同步接口确认（预留） 5 4. 数据一致性 6 4.1. 按天同步接口 6 5. 附件 7 5.1. 附件1 字典编码列表 7 概述 文档概述 该协议作为甘肃BOSS系统与本地SP的外部接口规范，后继开发和联调以该接口约定为准。 本文的后续部分将分别描述这些接口的功能、流程、属性和接口报文格式。 接口列表 章节 接口名称 接口类型 对端系统 3.1.1 订购信息同步 本地SP 接口数据格式 数据描述约定 约束符号 在本文档中以表格的形式表示XML格式，以下为表格中对元素约束（出现次数）的表示方法的描述： 符号 含义 ? 0..1，可选项* 0..n，可以没有，也可以有多项+ 1..n，至少有1项，也可以有多项1 数字1，代表必须且只能填1项”.”为以外,其他字段之间以”_”连接. 文件名称全用大写，扩展名为小写。 字段名称 字段长度(字符) 字段说明 取值说明 方向 3 描述方向 C2L：CRM至本地SP L2C：本地SP至CRM 业务 4 描述本数据文件是针对什么业务的 业务人员自己商量确定,要明确清晰表明。默认为SP代码，固定为6位。 日期 14 文件产生的时间 格式:yyyymmddhhmiss 序号 3 每天的文件从0000开始 从0001到9999，请求文件与响应文件的序号不要求完成一致。 后缀 3 描述文件类型 req 请求,res响应 最终的文件名称如下: 请求文件: 方向业务日期序号.req，如：L2C_六位SP代码_20100611233001_0103.req 响应文件: 方向业务日期序号.res，如：L2C_六位SP代码_20100611233511_0103.res 建议: 请求文件和响应文件除了后缀不一样以外,其他完全一样. 数据文件内容格式 业务人员根据业务需求自行确定. 在业务接口里体现. 订购信息 文件接口 个人订购本地SP信息 文件生成频次：5分钟生成一个 传送方向：从SP平台到CRM系统 文件生成粒度：一次同步生成一个文件 文件名格式约定：(参见2。2.1) 文件名举例： L2C_六位SP代码_20100611233001_0103.req 文件内容格式约定： 文件头：无 文件体：每行数据内容如下：分割符号：竖线“|” ，首字段前和尾字段后无需分割符号，每行换行使用回车换行符，第行只显示一条订购信息，若同一用户订购多项业务，需分行列出。 元素名称 约束 类型 宽度 参数描述 备注 V16 编号 唯一标识，在同一天的文件中不允许重复。若有重复，则认为为同一订购，覆盖前面的记录。 Oper_type 1 string F2 操作类型 01：订购 03：取消 phone 1 string V20 手机号码 必填 Sp_code 1 string V32 企业代码 必填，可为0 Serv_code 1 string V64 业务代码 必填，可为0 Apply_type 1 string F2 订购渠道 长度不足左填0，默认为01 Busi_type 1 string F4 业务类型：默认为9999 Bill_flag string F2 收费标识，默认为02 Service_id string V64 服务代码，默认为0 Order_date 1 string F14 yyyymmddhh24miss 用户订购时间如:20100611171412 Send_date 1 string F14 yyyymmddhh24miss 接口传送时间如20100601171412 Ext_hold1 1 string V64 预留字段，可不填 Ext_hold2 1 string V64 预留字段，可不填 个人订购