中国移动天津公司NGcrm经分互动接口

中国移中国移动动天津公司天津公司 经经分互分互动动接口接口 单单行本行本 V0.2 中国移动天津公司 二九年七月 一级 BOSS 枢纽接口规范 中国移动通信公司 2 文档变更记录文档变更记录 序号变更内容说明版本号版本日期执笔人 1.初稿 0.12009-7-29 张涛 2. 1：目标客户群接口中客户列表文件名的约束 由 1 改为+ 0.12009-7-29 张涛 3. 1:增加了所有父元素、子元素的英文标签 2：将所有的“日切”英文标签统一改成 cutoffday 0.22009-8-3 张涛 4.增加规则元素子类型 0.22009-8-11 张涛 5. Touch_type 取值为 B:内容删除。 Touch_type 取值为 D: rule_type 为取值 （1：产品，2：包，3：包元素 4：购机， 5：亲情业务 6：业务类型） 0.22009-8-12 张涛 6.增加资费 ID 0.32009-8-28 张涛 7.增加新业务 0.32009-8-28 张涛 8 增加事件 EVENT 有效开始时间 0.32009-8-28 张涛 9 增加事件 EVENT 有效结束时间 0.32009-8-28 张涛 10 增加事件子类型 0.42009-8-30 张涛 11 1：将“事件编码”改为“事件发生器编 码” 2：将“事件参数”取值约束由“1”改 为“？” 3：增加“事件发生器编码”，“事件编 0.82009-9-2 张涛 一级 BOSS 枢纽接口规范 中国移动通信公司 3 码”的描述。 4：增加“渠道标示”，“副手段 ID”取 值说明的描述。 12 1：基本信息 BASE_INFO 修改为 F2，描述 修改。 2：CAMPN_TYPE 修改为 F4，描述修改。 3：REL_RULE_RESULT 修改为 F6，描述修 改。 4：REL_RULE_VACIL 修改为 F4，描述修 改。 5：REL_RULE_REFUSE 修改为 F4，描述修 改。 6：CHNL_ID 增加 EMAIL，彩信，打印编 码。 7：SUB_DICTION_ID 增加彩信，打印编 码。 8：TOUCH_TYPE 取值与取值描述的修改。 9：将 Rule_type 与 Rule_type_sub 合并。 0.92009-9-3 张涛 13 1：重新定义事件触发时机。10 2009-9-4 张涛 14 1：事件参数 2 PARAM_type_2 增加渠道 标示 02 10 2009-9-12 张涛 15 1：方案类型编码 CAMPN_TYPE 取值定义 2：创建分公司 CITY_CODE 取值定义 3：方式 CAMPN_MODE 取值定义 4：营销按优先级 CAMPN_EMERGENCY 取值定义 5：依赖犹豫原因 REL_RULE_VACIL取值定 义 6：依赖拒绝原因 REL_RULE_REFUSE取值 定义 7：客户属性标识 ATTR_ID 增加取值注解 8：主用语 MAIN_INFO 变量增加 1.12009-9-15 高静 一级 BOSS 枢纽接口规范 中国移动通信公司 4 9：事件有效开始时间 START_DATE 增加 取值注解 10：事件参数类型 1P1_type 增加取值注 解 11: 事件参数类型 2 P2_type 渠道标识 取值为 30 12：失败理由编码 REFUSE_CODE 取值定 义 13：犹豫类型编码 VACIL_CODE取值定义 16 1：政企重要客户标记字段 ATTACH_FLAG 置 0 1.22009-9-16 高静 17 1、 将营销案的方案类型编码进行扩充以满 足 CRM 用户开户需要单独判断的要求 2、将目标客户的动态规则做限制，以附件 形式提供在此文档中 3、目标客户的动态规则中增加属性 0 所有 客户的标记。 4、对目标客户群接口的目标客户范围标记 的 BI 抽取逻辑做说明 1.32009-9-17 及晓梅 18 手段和用语中标注营销变量在测试的时候 发现和 java 的语义有冲突，改为 1.42009-9-18 及晓梅 19 修改接触时机规则 1.52009-9-24 孙亮 周伟 20 删除营销反馈接口中“执行状态字段”、定 义“执行结果”取值 1.62009-9-29 高静 21 增加公益短信编码 1.7 2009-10- 16 高静 22 增加目标客户范围标记，F：导入号码 1.8 2009-10- 17 高静 23 增加拒绝、无反馈子分支 1.9 2009-10- 28 高静 24 在反馈接口中增加反馈工号，无反馈类 2.02009-12-3 高静 一级 BOSS 枢纽接口规范 中国移动通信公司 5 型 25 在反馈接口中增加执行日期 2.1 2009-12- 17 高静 26 在反馈接口中增加“其他用户 ID” 2.12010-1-5 张涛 27 在反馈接口中增加“成功办理明细” 2.12010-1-5 张涛 28 在营销案接口中的方案类型编码添加短 信营业厅专用营销 5,此流程同营销 1 流程 2.22010-1-26 高静 29 增加辅助短信手段 2，3，4 在 SUB_DICTION 2.12010-2-23 孙亮 30 在营销案接口中的方案类型短信营业厅专 用营销 5 中添加 508务工短信 2.32010-3-1 高静 31 在营销案接口中的渠道设计增加短信有 效期 2.42010-4-6 陈国瑛 32 增加异常活动处理接口 2.52010-4-14 孙亮 目 录 文档变更记录文档变更记录.2 1. 综述综述 .4 1.1. 范围.4 1.2. 参考文档.4 2. 经分互动接口经分互动接口 .5 2.1. 营销案接口.5 2.1.1. 命名规则.5 2.1.2. 接口内容.5 2.2. 目标客户群接口.9 2.2.1. 命名规则.9 2.2.2. 接口内容.9 2.3. 事件接口.10 2.3.1. 命名规则.10 一级 BOSS 枢纽接口规范 中国移动通信公司 6 2.3.2. 接口内容.10 2.4. 营销反馈接口.12 2.4.1. 命名规则.12 2.4.2. 接口内容.12 2.5. 对帐接口.13 2.5.1. 命名规则.13 2.5.2. 接口内容.13 2.6. 客户列表（普通文件接口）.14 2.6.1. 命名规则.14 2.6.2. 接口内容.14 一级 BOSS 枢纽接口规范 中国移动通信公司 7 1. 综述综述 1.1. 范围范围 本接口规范描述 NG-bASS 与 NG-CRM 之间的接口操作，包括其功能、流程和相关交易的接口报文定义。 名词解释 1.2. 参考文档参考文档 一级 BOSS 枢纽接口规范 中国移动通信公司 8 2. 经分互动接口经分互动接口 2.1. 营销案接口营销案接口 2.1.1. 命名规则命名规则 I70001yyyymmddXXXXXX.AVL 备注：XXXX 每天从 0000 到 9999 循环不能重复。 1.1.1. 接口内容接口内容 父元 素名 称 英文标签名元 素 名 称 英文标签名约 束 类型宽度描述取值说明 营 销 服 务 方 案 CAMPN 日 切 时 间 cutoffday1dateF8 用于对明细对账 一级 BOSS 枢纽接口规范 中国移动通信公司 9 营 销 服 务 方 案 CAMPN 基 本 信 息 BASE_INFO1 基 本 信 息 BASE_INFO 名 称 CAMPN_NAME1stringV64 基 本 信 息 BASE_INFO 营 销 服 务 方 案 ID CAMPN_ID1string V12 BI 生成的 ID 不可重复 基 本 信 息 BASE_INFO 方 案 类 型 编 码 CAMPN_TYPE1string F4 一位营销 1,服务 2，广告 3，调查 4 ，短信营业厅专用营销 5， 公益 6 扩充为三位 第一位仍然是营销 1,服务 2，广告 3，调查 4 ，公益 6 第二三位代表活动的子类型 当第一位是 1 时，二三位的含义如下 01 普通营销 02 开户营销 当第一位是 2 时，二三位的含义如下 03 服务 当第一位是 3 时，二三位的含义如下 04 广告 当第一位是 4 时，二三位的含义如下 05 调查 当第一位是 6 时，二三位的含义如下 06 公益 一级 BOSS 枢纽接口规范 中国移动通信公司 10 当第一位是 7 时，二三位的含义如下 07短信营业厅专用营销 08务工短信 基 本 信 息 BASE_INFO 创 建 人 CREATE_STAFF_ID1string v24 待定 基 本 信 息 BASE_INFO 创 建 分 公 司 CITY_CODE1string V5 双方约定。张涛补充和目前一致。主动式的时候在营销分派时 候具有此分公司权限的工号可见。每个分公司有一个总管理员 （单独角色编码）。 天津市：A B1和平河西 B2南开红桥 B3河北河东 B4滨海 B5西青 B6东丽 B7北辰 B8武清 B9津南 BA大港 BB静海 BC蓟县 BD宝坻 BE宁河 BF汉沽 BG其他 1 BH其他 2 一级 BOSS 枢纽接口规范 中国移动通信公司 11 基 本 信 息 BASE_INFO 创 建 时 间 CREATE_TIME1charF8 例如 基 本 信 息 BASE_INFO 定 量 目 标 CAMPN_TARGET？string V200 基 本 信 息 BASE_INFO 定 性 目 标 CAMPN_TARGET_1？string V200 基 本 信 息 BASE_INFO 方 式 CAMPN_MODE1string F2 A 主动 B 接触式 C 事件式主动 D 事件式接触式 基 本 信 息 BASE_INFO 活 动 开 始 时 间 DEMAND_BEGIN_TIME1charF8 默认到每日 00 点 00 分 00 秒 基 本 信 息 BASE_INFO 活 动 结 束 时 间 DEMAND_END_TIME1charF8 默认到每日 23 点 59 分 59 秒 基 本 信 息 BASE_INFO 营 销 按 优 先 级 CAMPN_EMERGENCY1charV2 1-9（低-高） 一级 BOSS 枢纽接口规范 中国移动通信公司 12 营 销 服 务 方 案 CAMPN 营 销 服 务 方 案 关 系 CMAPN_REL? 营 销 服 务 方 案 关 系 CMAPN_REL 互 斥 关 系 LIMIT_REL_TYPE? 互 斥 关 系 LIMIT_REL_TYPE1 互 斥 ID CAMPN_REL_ID*string V12 例如 A 设定的互斥为 C，D 那么当 Acd 都符合营销触发条件的 时候，将 Cd 失效。执行 A。 营 销 服 务 方 案 关 系 CMAPN_REL 依 赖 关 系 LIMIT_REL? 依 赖 关 系 LIMIT_REL_TYPE2 依 赖 ID CAMPN_REL_ID_11string V12 例如 A 设定的依赖为 C 那么当 c 符合营销触发条件的时候，也 将 A 触发执行。同基本信息里面的“营销服务方案 ID” 一级 BOSS 枢纽接口规范 中国移动通信公司 13 依 赖 关 系 LIMIT_REL_TYPE2 依 赖 执 行 结 果 REL_RULE_RESULT1stringF6 服务预约，订单预受理，订单受理，犹豫，拒绝 ，无反馈 例如表示为这几种情况都执行。0 表示不依赖，1 表示依赖。 依 赖 关 系 LIMIT_REL_TYPE2 依 赖 犹 豫 原 因 REL_RULE_VACIL*stringF4 401 402 403 404 依 赖 关 系 LIMIT_REL_TYPE2 依 赖 拒 绝 原 因 REL_RULE_REFUSE*stringF4 501 502 503 504 营 销 服 务 方 案 CAMPN 营 销 内 容 CAMPN_OBJECT1 营 销 内 容 CAMPN_OBJECT 产 品 PRODUCT_ID*string 待定需要 BI 和 CRM 约定的参数 营 销 内 容 CAMPN_OBJECT 服 务 ID SERVRER_ID*string 待定例如业务到期提醒，话费信息推送，话费异动预警。需要 BI 和 CRM 约定的参数 一级 BOSS 枢纽接口规范 中国移动通信公司 14 营 销 内 容 CAMPN_OBJECT 资 费 ID Discnt_id*string 营 销 内 容 CAMPN_OBJECT 新 业 务 SP_SVC_ID*string TD_B_PLATSVC 营 销 内 容 CAMPN_OBJECT 提 示 用 语 HINT_INFO ？string V200 营 销 内 容 CAMPN_OBJECT 礼 品 列 表 GIFT_LIST ？string V200 礼 品 列 表 CAMPN_OBJECT 礼 品 GIFT* 礼 品 GIFT 礼 品 类 型 编 码 GIFT_CODE1string V5 礼 品 GIFT 礼 品 名 称 GIFT_NAME1string V5 营 销 CAMPN 客 户 CUST_ATTR_TYPE ？ 一级 BOSS 枢纽接口规范 中国移动通信公司 15 服 务 方 案 信 息 设 计 客 户 信 息 设 计 CUST_ATTR_TYPE 客 户 属 性 CUST_ATTR+ 客 户 属 性 CUST_ATTR 客 户 属 性 标 识 ATTR_ID1string V16 需要 BI 和 CRM 约定的参数，用于展示在营业厅，客服营销界 面 详见客户推荐信息参数 客 户 属 性 CUST_ATTR 客 户 属 性 顺 序 号 ORDER_NO1string v2 营 销 服 务 方 案 CAMPN 渠 道 设 计 CHNL1 渠 道 设 CHNL 渠 道 标 CHNL_ID1string V2 0001 外呼 0002 客户经理回访 T000 实体营业厅 一级 BOSS 枢纽接口规范 中国移动通信公司 16 计识 ID E001 电话营业厅 E002 短信营业厅 E003 网上营业厅 E004 WAP 营业厅 E005 自助终端 E006 掌上营业厅 E007 门户网站 E008 代理商 WEB 营业厅 E009 手机营业厅（短信 STK） E010 集团门户 E011 EMAIL E012 彩信 E021 打印 渠 道 设 计 CHNL 短 信 有 效 期 VALID_TIME ？number 5 短信在网关保存的有效 期 为空时默认为 48 小时，非空时所填数值单位为小时 手 段 和 用 语 CHNL 主 用 语 MAIN_INFO1string V20000 用语可以存在客户属性变量【CUSTOMER】和事件属性变量 【EVENT】由联创替换。例如客户属性.客户姓名的变量语法是： “CUSTOMER.NAME” 渠 道 设 计 CHNL 副 手 段 和 用 语 DICTION1 手 段 和 DICTION 副 手 段 SUB_DICTION* 一级 BOSS 枢纽接口规范 中国移动通信公司 17 用 语 副 手 段 SUB_DICTION 副 手 段 ID SUB_DICTION_ID1string F1 0001 外呼 E002 短信 1 E0022 短信 2 E0023 短信 3 E0024 短信 4 E012 彩信 E011 E-mail E021 打印 副 手 段 SUB_DICTION 副 手 段 用 语 SUB_DICTION_INFO1string V20000 营 销 服 务 方 案 CAMPN 接 触 式 触 发 时 机 TOUCH_OCCISA? 接 触 式 触 发 时 机 TOUCH_OCCISA 渠 道 范 围 CHNL_AREA? 代表营销渠道范围 渠 道 范 CHNL_AREA 部 门 ROLE_CODE+string V20 BOSS 编码 当出现实体渠道范围的时候：营业厅，角色，员工总记录数不 能为零。需要和 BI 开发接口 规则：部门下有工号以工号为准，部门下没有工号以部门为准。 一级 BOSS 枢纽接口规范 中国移动通信公司 18 围 Depart_id,staff_id. 渠 道 范 围 CHNL_AREA 工 号 STAFF_ID*string V10 BOSS 编码 接 触 式 触 发 时 机 TOUCH_OCCISA 接 触 式 触 发 类 型 TOUCH_TYPE1String V2 接口描述 1 接触开始触发 2 界面打开触发 3 交易提交触发（包括业务办理提交，客户信息查询提交） 4 界面元素触发 CRM 后台参数 1 提交业务触发（办理业务,应用于销售,需要传入 trade_id） 2 签权(网上营业厅登录或者 IVR 号码拨入或者销售办理 业务通过号码校验) 3 元素触发（客服的来电原因） 4 菜单触发（账务的输入号码点击查询，网上营业厅的界 面打开） 接 触 式 触 发 时 机 TOUCH_ OCCISA 时 机 规 则 组 Rule_group* 当触发类型为：界面打开，交易提交，界面元素使用。规则组 之间的关系是或 or 的关系 时 机 规 则 rule_group 规 则 Rule- -规则之间的关系是并且“and” 一级 BOSS 枢纽接口规范 中国移动通信公司 19 组 规则Rule 规 则 元 素 类 型 Rule_type1String V10 Touch_type 取值为 A 该字段不存在： Touch_type 取值为 B: Touch_type 取值为 c: rule_type 为界面编码 rule_value 取 值为界面元素编码（目前支持来电原因的类型）； Touch_type 取值为 D: rule_type 为取值（1：产品，2：包元 素 3：业务类型 trade_type_code）rule_value 产品包包 元素/购机类型/取值。 渠道编号 0001 外呼 0002 客户经理回访 T000 实体营业厅 E001 电话营业厅 E002 短信营业厅 E003 网上营业厅 E004 WAP 营业厅 E005 自助终端 E006 掌上营业厅 E007 门户网站 E008 代理商 WEB 营业厅 E009 手机营业厅（短信 STK） E010 集团门户 E011 EMAIL E012 彩信 E021 打印 界面名称编号 “梦网清单(ASM001) 用户清单查询(ASM002) 免费分钟数查询(ASM003) 一级 BOSS 枢纽接口规范 中国移动通信公司 20 返款查询(ASM004) 账单查询(ASM005) 缴费(ASM006)“ TOUCH_TYPE=4 时候。 Rule_type=1. TOUCH_TYPE=1 时候(BI: 接触开始触发;CRM: 签权)： (代表空值) Touch_type 取值为 A 该字段不存在： Touch_type 取值为 B: Touch_type 取值为 c: rule_type 为界面编码 rule_value 取 值为界面元素编码（目前支持来电原因的类型）； Touch_type 取值为 D: rule_type 为取值（1：产品，2：包元 素 3：业务类型 trade_type_code）rule_value 产品包包 元素/购机类型/取值。 TOUCH_TYPE=2 时候(BI:界面打开触发;CRM: 菜单触发)： Rule_type = 30 代表渠道 Rule_value = 渠道编号 Rule_type = 51 代表界面名称； Rule_value = 界面名称编号； TOUCH_TYPE=3 时候(BI: 交易提交触发;CRM: 提交业务触发)： Rule_type = 01 业务类型 Rule_value = 业务类型 id； Rule_type = （推荐内容类型） 10 产品 20 优惠 21 服务 22 新业务服务 一级 BOSS 枢纽接口规范 中国移动通信公司 21 Rule_value = 推荐内容 id； Rule_type=11 变更类型 Rule_type =0，1，2（新增，删除，变更） TOUCH_TYPE=4 时候(BI: 界面元素触发;CRM: 元素触发)： Rule_type = E1 来电原因 Rule_value = 来电原因 id 规则Rule 规 则 元 素 子 类 型 Rule_type_sub？String V10 当 rule_type 取值为 2 的时候此值为 A：资费类包元素； B：新业务类包元素； C：服务类包元素 Rule_type 取值为其他时候此元素不需要 规则Rule 规 则 元 素 参 数 值 Rule_value1String V10 营 销 服 务 方 案 CAMPN 事 件 触 发 时 机 EVENT_TOUCH？ 一级 BOSS 枢纽接口规范 中国移动通信公司 22 事件 触发 时机 EVENT_TOUCH 事 件 发 生 器 类 型 EVENT_TYPE1string V50 BI(代表事件触发器为经分)|CRM（代表事件触发器为 CRm） +A(接触后事件触发)|B（特定统计）|C（基于信令）|D（基于 日期）|E（基于计费） 目前有 CRMA，CRMD 事件 触发 时机 EVENT_TOUCH 事 件 发 生 器 编 码 EVENT_CODE1string V20事件判断条件 需要和事件发生器共同确定 命名规则：事件发生器类型_编码 例如：CRMD_BIRTHDAY 例如：CRMA_TRADE 事件 触发 时机 EVENT_TOUCH 事 件 有 效 开 始 时 间 START_DATE1string V10 相对时间（单位秒）系 统当前时间+事件有效 开始时间=事件发生时 间=系统当前时间+事 件有效结束时间都可以 做营销 可以为负值 ，接口值为小时，如生日，-1 到-24 代表提前 一天 事件 触发 时机 EVENT_TOUCH 事 件 有 效 结 束 时 间 END_DATE1string v10 相对时间（单位秒） 事件 触发 时机 EVENT_TOUCH 事 件 PARAM ? ？ - 需要和事件发生器共同确定 EVENT_CODE= CRMD_birthday 无此参数。 一级 BOSS 枢纽接口规范 中国移动通信公司 23 参 数 事 件 参 数 PARAM 事 件 参 数 组 PARAM_group*- 组间为或 事 件 参 数 组 PARAM_group 事 件 规 则 PARAM_group_rule+- 事件规则之间是并且 事 件 规 则事 件触 发时 机 PARAM_group_rule PARAM 事 件 参 数 类 型 1 P1_ty pe ？string V100 当 EVENT_CODE 为 CRMA_TRADE 时 param_type_1 取值为:0新增；1删除；2修改 如果没值不传此字段，例如：仅选开户多个 prarm_type 关系 为 and 1：产品，2：包元素 3：业务类型 trade_type_code 4：操作类型 事 件 规 则 PARAM_group_rule 事 件 参 数 类 型 2 P2_type1string V100 当 EVENT_CODE 为 CRMA_TRADE 时 param_type_2 时为: 01业务类型 30 渠道标识 10 产品 20 优惠 21 服务 22 SP 服务 事 件 规 则 PARAM_group_rule 事 件 参 数 P2_value1string V2000 当 EVENT_CODE 为 CRMA_TRADE 时 param_type_3 时为值(多个产品，优惠，服务， sp 服务的时候用,分割)关系为 in 一级 BOSS 枢纽接口规范 中国移动通信公司 24 值 事 件 规 则 PARAM_group_rule 事 件 参 数 类 型 4 PARAM_type_41string V100 事 件 规 则 PARAM_group_rule 事 件 参 数 类 型 5 PARAM_type_51string V100 事 件 规 则 PARAM_group_rule 事 件 参 数 类 型 6 PARAM_type_61string V100 事件 触发 时机 PARAM_type 事 件 参 数 值 PARAM_value+string