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; } } ~~~