CFT-周大福
  1. 积分场景
CFT-周大福
在线API
  • 在线API
  • 接口鉴权说明
  • 接口说明
  • 会员场景
    • 会员绑定
      POST
    • 国家代码查询
      POST
    • 手机号修改
      POST
    • 会员修改
      POST
    • 会员卡号查询Global ID
      POST
    • 会员注册
      POST
    • 会员解绑
      POST
    • 会员查询
      POST
    • 会员扩展数据辅助表查询
      POST
    • 会员注销
      POST
    • 会员查询绑定
      POST
    • 会员查询(批量分页)
      POST
    • 会员跨境
      POST
    • 会员沟通渠道
      POST
  • 等级场景
    • 查询等级配置列表
      POST
    • 等级查询
      POST
    • 明细查询
      POST
  • mdm场景
    • 组织结构同步
    • 商品同步
    • 门店列表
    • 门店同步
  • 积分场景
    • 积分膨胀
      • 门店是否满足积分膨胀活动
      • 积分膨胀
      • 积分膨胀-取消
      • 积分膨胀资格扣分
      • 积分膨胀资格扣分-取消
    • 互动类活动
      • 互动类活动加分
      • 互动类活动扣分
      • 取消互动类活动加分
      • 取消互动类活动扣分
    • 积分抵现
      • 积分抵现
      • 取消 - 积分抵现
    • 积分券抵现
      • 积分券抵现
      • 取消 - 积分券抵现
      • 积分券加赠券派分
      • 取消-积分券加赠券派分
    • 积分兑礼
      • 积分兑礼
      • 取消 - 积分兑礼
    • 其他积分操作
      • 积分冻结
      • 积分解冻
      • 积分交易撤销
      • 消耗已冻结积分
      • 拆分积分分批冻结
    • 积分查询
      • 积分查询
      • 积分比例查询
      • 积分有效期明细
    • 积分变更接口
      POST
    • 明细查询
      POST
  • 标签场景
    • 标签目录列表
    • 标签列表
    • 打标
    • 去标
    • 用户标签列表
    • 分组下用户标签列表
    • 标签导入通知
  • 销售场景
    • 退单同步
    • 订单同步
    • 订单查询
    • 查询销售单会员
    • 查询会员消费件数
    • 线上订单(60580)通知计算积分
    • 订单换渠道ID
  • 权益场景
    • 自研礼券
      • 自研礼券项目同步Loyalty
      • 自研礼券 实例同步Loyalty
    • 权益礼品同步
    • 权益礼品详情查询
    • 核销
    • 优惠券列表
    • 已领取礼品列表查询
    • 会员可用券列表
    • 积分商城订单同步
    • 反核销
    • 券查询
    • 卡券发放
    • 券项目查询
    • 券项目列表
  • 活动场景
    • 微信报名活动
      • 微信活动详情
      • 微信活动报名
      • 微信活动签到
      • 根据memberId分页查询微信活动参与记录列表
      • 分页查询微信活动列表
    • 积分券活动
      • 积分券活动查询
    • 邀请有礼活动
      • 分页查询邀请有礼活动列表
      • 邀请有礼活动-绑定会员邀请申请码
      • 邀请有礼活动-详情
      • 邀请有礼活动资格验证
    • 互动类积分活动详情和参与记录
  • 企点
    • 积分变更接口
    • 券项目列表
    • 卡券批量发放
    • 标签导入通知
  1. 积分场景

积分变更接口

POST
/fast-service/v1/0.0/api/point/modify
积分场景
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api-vpjq75s2e4.kylin.shuyun.com/fast-service/v1/0.0/api/point/modify' \
--header 'X-Caller-Service: ' \
--header 'X-Caller-sign: ' \
--header 'X-Caller-Timestamp: ' \
--header 'X-Caller-Sign: ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "bizCode": "CTFCN",
    "requestChannel": "in esse sunt Duis aute",
    "requestSystem": "enim commodo ad nostrud nulla",
    "transactionId": "54",
    "description": "指之道采反成天到道速义之老压济收。市参求济几将其约维场金清。原知共千持没处工严需度党亲好元省。",
    "identify": {
        "channel": "dolore adipisicing ea id cillum",
        "memberId": "10",
        "userId": "14"
    },
    "modifyType": "cupidatat Duis",
    "operationType": "elit consequat sunt eu consectetur",
    "point": 81,
    "pointBizType": "proident amet deserunt",
    "actionName": "领四西儿",
    "KZZD1": "Duis dolor occaecat ad Excepteur",
    "expiredTime": "2003-09-15 21:12:27",
    "shopCode": "73",
    "effectTime": "1992-07-20 02:02:25",
    "KZZD3": "irure in ipsum",
    "KZZD2": "eu"
}'
响应示例响应示例
{
  "success": true,
  "code": "string",
  "message": "string",
  "data": {}
}

请求参数

Authorization
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
Header 参数
X-Caller-Service
string 
可选
默认值:
{{caller}}
X-Caller-sign
string 
可选
默认值:
{{sign}}
X-Caller-Timestamp
string 
可选
默认值:
{{currentTime}}
X-Caller-Sign
string 
网关签名
可选
默认值:
{{sign}}
Body 参数application/json
bizCode
string 
业务代码
必需
大陆:CTFCN,港澳系统:CTF
requestChannel
string 
请求渠道
必需
淘宝(TAOBAO)
京东(JD)
抖音(DOUYIN)
官方商城(OFFICIAL_MALL)
港澳官网(GW)
CRM后台(KYLIN_CRM)
Sales APP(SalesAPP)
Experience APP(ExperienceAPP)
鸿蒙APP(HarmonyAPP)
会员中心小程序(WX)
快捷H5(HJH5)
港澳APP(VIPAPP)
CTFMall微信小程序(OFFICIAL_MALL_WX)
CTFMall M站(OFFICIAL_MALL_M)
CTFMall支付宝小程序(OFFICIAL_MALL_ZFB)
企点CDP(QD)
ADOBE(Adobe)
requestSystem
string 
请求系统
必需
淘宝(TAOBAO)
京东(JD)
抖音(DOUYIN)
官方商城(OFFICIAL_MALL)
港澳官网(GW)
CRM后台(KYLIN_CRM)
Sales APP(SalesAPP)
Experience APP(ExperienceAPP)
鸿蒙APP(HarmonyAPP)
会员中心小程序(WX)
快捷H5(HJH5)
港澳APP(VIPAPP)
CTFMall微信小程序(OFFICIAL_MALL_WX)
CTFMall M站(OFFICIAL_MALL_M)
CTFMall支付宝小程序(OFFICIAL_MALL_ZFB)
企点CDP(QD)
ADOBE(Adobe)
transactionId
string 
事务ID
必需
TX2024030490569
description
string 
备注
必需
identify
object 
会员身份识别对象
必需
channel
string 
识别渠道 POS;WECHAT:微信 非必输(如果不传默认取requestChannel)
必需
memberId
string  | null 
GlobalId
可选
userId
string 
渠道用户id。POS渠道:pos卡号(不能为手机号);微信:appId_openId;淘宝渠道:ouid;京东:xid;抖店:openid.其他渠道唯一id等等
必需
modifyType
string 
变更类型
必需
发放:SEND 扣减:DEDUCT
operationType
string 
操作类型
可选
操作类型与活动类型二选一,可选值:
1 销售
10 退货
14 升级/续约加分
15 奖励加分
16 撤销换取礼品加分
3 客诉补分
4 特殊扣分
40 活动报名
41 活动报名失败
44 积分抵现
45 取消积分抵现
46 手续分值
47 积分活动奖分
48 取消积分活动奖分
49 销售预扣分
5 换取礼品减分
50 撤销销售预扣分
51 销售补录
53 入会奖分
54 撤销入会奖分
55 客诉补偿
56 过期失效积分
57 其他失效积分
68 积分优惠购
69 取消积分优惠购
73 GLP抵现派分
74 GLP抵现用分
75 GLP退货派分
76 GLP退货用分
78 积分膨胀资格扣分
79 积分膨胀资格还分
80 积分膨胀抵现
81 积分膨胀派分
82 取消积分膨胀抵现
83 取消积分膨胀派分
84 积分抵用券派分
85 积分抵用券抵现
86 取消积分抵用券抵现
87 取消积分抵用券派分
88 KDP积分转换扣分
89 KDP积分转换加分
90 取消KDP积分转换加分
91 活动扣分
92 取消活动扣分
93 取消销售补录
94 线下积分抵用券派分
95 线下积分抵用券抵现
96 取消线下积分抵用券抵现
97 取消线下积分抵用券派分
98 活动加分
99 取消活动加分
activityType
string 
活动类型
可选
操作类型与活动类型二选一,可选值
销售
销售退货
客诉补分
微信报名活动
互动类派分
商友合作派分
营销活动派分
生日赠分派分
Smart tray 专享活动
初始消费派分
初始消费派分(最后一单)
新版邀请有礼(老带新)派分
CTFMALL专享活动
云柜台专享活动
积分券派分
营销积分活动(实时)
客诉补偿(退货补分)
积分膨胀活动
积分抵用券活动
point
integer 
变更积分值
必需
30
pointBizType
string 
积分业务类型
必需
积分业务类型,
大陆积分账户:POINTCN
港澳积分账户:POINTHK
actionName
string 
活动名称
可选
actionId
string 
活动ID
必需
effectTime
string 
积分生效时间
可选
8时区积分生效时间(扣减场景无需传入),格式为:yyyy-MM-dd HH:mm:ss
expiredTime
string 
积分过期时间
可选
8时区积分过期时间(扣减场景无需传入),格式为:yyyy-MM-dd HH:mm:ss
shopCode
string 
分店Code
可选
KZZD1
string 
扩展字段1
可选
KZZD3
string 
扩展字段2
可选
KZZD2
string 
扩展字段3
可选
示例

返回响应

🟢200成功
application/json
modify_1 200 response
Body
success
boolean 
是否成功:true 表示成功 false 表示失败
可选
code
string 
000000 表示成功,其余编码表示具体错误编码
可选
message
string 
可选
data
object (Void) 
可选
上一页
积分有效期明细
下一页
明细查询
Built with