pointsIn · COSCIA 开发手册

### 新增积分日志 **位置：** Common\Lib\PointsLogLib.class.php **参数：** @param $points_in_log $points_in_log['cid'] 客户ID $points_in_log['card_no'] CRM系统卡号 $points_in_log['mobile_phone'] 手机号 $points_in_log['sync_type'] 积分同步类型 1、有赞->CRM->驿氪 2、CRM向有赞和驿氪同步 3、驿氪->CRM->有赞 $points_in_log['scene_code'] 场景代码 $points_in_log['description'] 积分变动场景描述 $points_in_log['original'] 原积分 $points_in_log['diff'] 变动的积分 $points_in_log['after'] 变动后可用积分 $points_in_log['api_step'] 当前API进行步骤成功传1，不成功传0 $points_in_log['detail_json'] 新增积分日志详情 * 其中，CRM新增中积分变动场景有如下几种： 1、POS收银加积分 2、POS退货减积分 3、POS积分抵现减积分 4、ORP电商订单加积分（除有赞和代发平台） 5、ORP电商订单退货减积分（除有赞和代发平台） 6、POS售后服务积分抵现减积分 7、POS积分兑换商品减积分有赞新增积分变动场景：详情见有赞手册驿氪新增积分变动场景：详情见驿氪手册 **调用：** * 组件文件外调用 ~~~ $ptl = new PointsLogLib(); $points_in_log['cid'] = 134; // 客户CID $points_in_log['card_no'] = 'Y0045953'; // 客户卡号 $points_in_log['mobile_phone'] = '13454334566'; // 客户手机号 $points_in_log['sync_type'] = 2； // 积分同步类型 $points_in_log['scene_code'] = 9; // 积分变化场景代码 $points_in_log['description'] = '调整积分'; // 积分变化场景描述 $points_in_log['original'] = 59; // 原有积分 $points_in_log['diff'] = -10; // 变动积分 $points_in_log['after'] = 49; // 变动后可用积分 $points_in_log['api_step'] = '1'; // 当前API进行步骤，成功传1，不成功传0 $points_in_log['detail_json'] = "crm_in:{}"; // CRM变化推送详情 $res = $ptl->pointsIn($points_in_log); ~~~ **返回：** 成功时返回日志ID 失败时候返回对应的错误数组 **完整代码：** ~~~ /** * 新增积分日志 * @param $points_in_log * $points_in_log['cid'] 客户ID * $points_in_log['card_no'] CRM系统卡号 * $points_in_log['mobile_phone'] 手机号 * $points_in_log['sync_type'] 积分同步类型 1、有赞->CRM->驿氪 2、CRM向有赞和驿氪同步 3、驿氪->CRM->有赞 * $points_in_log['scene_code'] 场景代码 * $points_in_log['description'] 积分变动场景描述 * $points_in_log['original'] 原积分 * $points_in_log['diff'] 变化的积分 * $points_in_log['after'] 变动后可用积分 * $points_in_log['api_step'] API进行步骤 * $points_in_log['detail_json'] 新增积分日志详情 * @return array|Integer * 失败返回错误 * 成功返回日志ID * * 其中ERP积分变动场景 * 1、POS收银加积分 * 2、POS退货减积分 * 3、POS积分抵现减积分 * 4、ORP电商订单加积分（除有赞和代发平台） * 5、ORP电商订单退货减积分（除有赞和代发平台） * 6、POS售后服务积分抵现减积分 * 7、POS积分兑换商品减积分 */ public function pointsIn($points_in_log) { // 如果CID为空，默认赋0值 if (empty($points_in_log['cid'])) { $points_in_log['cid'] = 0; } // 如果卡号为空，默认赋空值 if (empty($points_in_log['card_no'])) { $points_in_log['card_no'] = NULL; } // 如果手机号为空，默认赋空值 if (empty($points_in_log['mobile_phone'])) { $points_in_log['mobile_phone'] = NULL; } // 根据传入的当前API进行步骤，拼接出实际的API步骤字段 if ($points_in_log['sync_type'] == 2) { // 当同步为CRM发起时分5步 $points_in_log['api_step'] = $points_in_log['api_step'].'-0-0-0-0'; } else { // 有赞和驿氪发起时分4步 $points_in_log['api_step'] = $points_in_log['api_step'].'-0-0-0'; } $points_in_log['create_time'] = time(); // 创建时间 $points_in_log['is_delete'] = 0; // 是否删除，0否，1是 // 日志写入 $log_id = M('points_log')->add($points_in_log); if (!is_numeric($log_id)) { return array('success' => false, 'code' => -200, 'msg'=> '新增积分日志写入失败！'); } else { return $log_id; } } ~~~