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
    • 门店列表
      POST
    • 门店同步
      POST
  • 积分场景
    • 积分膨胀
      • 门店是否满足积分膨胀活动
      • 积分膨胀
      • 积分膨胀-取消
      • 积分膨胀资格扣分
      • 积分膨胀资格扣分-取消
    • 互动类活动
      • 互动类活动加分
      • 互动类活动扣分
      • 取消互动类活动加分
      • 取消互动类活动扣分
    • 积分抵现
      • 积分抵现
      • 取消 - 积分抵现
    • 积分券抵现
      • 积分券抵现
      • 取消 - 积分券抵现
      • 积分券加赠券派分
      • 取消-积分券加赠券派分
    • 积分兑礼
      • 积分兑礼
      • 取消 - 积分兑礼
    • 其他积分操作
      • 积分冻结
      • 积分解冻
      • 积分交易撤销
      • 消耗已冻结积分
      • 拆分积分分批冻结
    • 积分查询
      • 积分查询
      • 积分比例查询
      • 积分有效期明细
    • 积分变更接口
    • 明细查询
  • 标签场景
    • 标签目录列表
    • 标签列表
    • 打标
    • 去标
    • 用户标签列表
    • 分组下用户标签列表
    • 标签导入通知
  • 销售场景
    • 退单同步
      POST
    • 订单同步
      POST
    • 订单查询
      POST
    • 查询销售单会员
      POST
    • 查询会员消费件数
      POST
    • 线上订单(60580)通知计算积分
      POST
    • 订单换渠道ID
      POST
  • 权益场景
    • 自研礼券
      • 自研礼券项目同步Loyalty
      • 自研礼券 实例同步Loyalty
    • 权益礼品同步
    • 权益礼品详情查询
    • 核销
    • 优惠券列表
    • 已领取礼品列表查询
    • 会员可用券列表
    • 积分商城订单同步
    • 反核销
    • 券查询
    • 卡券发放
    • 券项目查询
    • 券项目列表
  • 活动场景
    • 微信报名活动
      • 微信活动详情
      • 微信活动报名
      • 微信活动签到
      • 根据memberId分页查询微信活动参与记录列表
      • 分页查询微信活动列表
    • 积分券活动
      • 积分券活动查询
    • 邀请有礼活动
      • 分页查询邀请有礼活动列表
      • 邀请有礼活动-绑定会员邀请申请码
      • 邀请有礼活动-详情
      • 邀请有礼活动资格验证
    • 互动类积分活动详情和参与记录
  • 企点
    • 积分变更接口
    • 券项目列表
    • 卡券批量发放
    • 标签导入通知
  1. 销售场景

退单同步

POST
/fast-service/v1/0.0/api/trade/refund/sync
销售场景
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api-vpjq75s2e4.kylin.shuyun.com/fast-service/v1/0.0/api/trade/refund/sync' \
--header 'Authorization;' \
--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": "WECHAT",
    "requestSystem": "WECHAT_MALL",
    "transactionId": "TX2024030490569",
    "identify": {
        "memberId": "string",
        "channel": "string",
        "userId": "wxd678efh567hg6787_oGPAG5rdBP78jh_3cmJ1en8FvZlo"
    },
    "refund": {
        "memberId": "string",
        "extData": {
            "property1": "string",
            "property2": "string"
        },
        "orderId": "087989aaf6af4e58897794d18axxxxx",
        "salesOrderNo": "087989aaf6af4e58897794d18axxxxx",
        "originOrderId": "087989aaf6af4e58897794d18axxxxx",
        "cardNo": "T000001",
        "shopCode": "100",
        "orderSourceBranch": "100",
        "orderSourceOrder": "20241022024-1",
        "totalQuantity": 1,
        "totalFee": 100.2,
        "payment": 1,
        "orderArea": "CTFCN",
        "exchangeRate": 0.8,
        "grade": "CTFCN",
        "payMode": [
            {
                "payWayCode": "1",
                "payWayName": "现金",
                "payment": 1
            }
        ],
        "operationType": "lntestorder",
        "couponFee": 99,
        "guideCode": "001",
        "orderSource": "lntestorder",
        "orderSourceDesc": "lntestorder",
        "description": "无",
        "orderTime": "2019-08-24T14:15:22.123Z",
        "stockoutTime": "2019-08-24T14:15:22.123Z",
        "refundOrderItems": [
            {
                "extData": {
                    "property1": "string",
                    "property2": "string"
                },
                "orderItemId": "bf3a654f1afa4859bb5c0e8846bxxxxx",
                "originOrderItemId": "bf3a654f1afa4859bb5c0e8846bxxxxx",
                "orderId": "087989aaf6af4e58897794d18axxxxx",
                "productCode": "P001",
                "productName": "P001",
                "productSeries": "P001",
                "jewelryType": "P001",
                "materialNatureSume": "P001",
                "marketSegmentation": "P001",
                "productBrand": "P001",
                "promotionPriceFlag": "P001",
                "stockType": "P001",
                "stockGroup": "P001",
                "stockCreateDomain": "P001",
                "stockNo": "P001",
                "mouldType": "P001",
                "mouldNo": "P001",
                "shopCode": "SHOP001",
                "shopName": "SHOP001",
                "couponNo": "85",
                "payment": 85,
                "saleMode": "lntestorder",
                "status": "FINISHED",
                "updateTime": "2019-08-24T14:15:22.123Z",
                "shopTypeCode": "TAOBAO",
                "finishTime": "2019-08-24T14:15:22.123Z",
                "quantity": 1,
                "skuId": "S001",
                "picture": "[\"https://allpro.saas.top/FsB-uzzX4WtCzpDu-Vuwqp2OdNbQ?e=1547742055&token=yNjhOp7gnH4St9yP72OlwuQ6JUNQf49pxAuGWYFt:1eZIUjRKIekGuMGG-c-s7UqNF1Y=;\"]"
            }
        ],
        "freight": 10,
        "receiverName": "abc",
        "receiverMobile": "18900000000",
        "receiverTelephone": "18900000000",
        "receiverProvince": "上海",
        "receiverCity": "上海",
        "receiverDistrict": "浦东新区",
        "receiverAddress": "南京东路100号",
        "receiverZipCode": "200000",
        "pointFlag": 1,
        "refundTime": "2019-08-24T14:15:22.123Z",
        "finishTime": "2019-08-24T14:15:22.123Z",
        "isInternal": "N"
    }
}'
响应示例响应示例
{
  "success": true,
  "code": "string",
  "message": "string",
  "data": {}
}

请求参数

Authorization
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
Header 参数
Authorization
string 
必需
默认值:
Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiJicmFuY2hfMzgxMCIsImF1ZCI6InNtYXJ0X3BvcnRhbF91YXQiLCJpc3MiOiJzc28iLCJpcF9hZGRyZXNzIjoiMTAuMjAwLjE4MC43NiIsImV4cCI6MTczOTc5ODIzMCwiYnJhbmNoIjoiMzgxMCIsImlhdCI6MTczOTc5MTAzMH0.jqwTnQ0ah3k94Yjpn7hw91QtmKwsvXhjyibZpXDrGifaBcvzPdz8MjCg66FUohyKTS4ciZILl6xXJ5a1pQ_iIg
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 
业务代码
必需
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)
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)
transactionId
string 
事务ID
必需
identify
object 
会员识别信息
必需
memberId
string 
GlobalId
可选
channel
string 
识别渠道
可选
userId
string 
渠道用户id
可选
refund
object 
退单数据
必需
salesOrderNo
string 
自研CRM主退单号
必需
1234567
cardNo
string 
会员卡号
必需
CN12324
shopCode
string 
消费门店code
必需
104
shopName
string 
消费门店名称
必需
测试店铺104
orderSourceBranch
string 
订单来源分店
必需
104
orderSourceOrder
string 
订单来源单号
必需
1234567999989
originalSalesOrderNo
string 
原始销售单单号
必需
正向销售订单单号(自研CRM单号)
originalShopCode
string 
原始销售分店
必需
正向销售订单分店Code
totalQuantity
integer 
商品总数
必需
1
totalFee
number 
订单应付总金额
必需
100.00
payment
number 
退款金额
必需
100.00
orderArea
string 
订单区域(CN:大陆;HKM:港澳)
必需
CN
grade
string 
会员等级
必需
60086
operationType
string 
操作类型
必需
10
operationTypeDesc
string 
操作类型描述
必需
couponFee
number 
总用劵金额
必需
19.9
guideCode
string 
订单对应导购
可选
10086
orderSource
string 
订单来源
可选
lntestorder
orderSourceDesc
string 
订单来源描述
可选
description
string 
退单备注
可选
实打实大师大尾巴v个帮他赫然
orderTime
string 
下单时间(格式: yyyy-MM-dd HH:mm:ss)
必需
2024-12-01 00:00:00
stockoutTime
string 
出账时间(格式: yyyy-MM-dd HH:mm:ss)
必需
2024-12-01 00:00:00
operationTime
string 
操作时间(格式: yyyy-MM-dd HH:mm:ss)
必需
2024-12-01 00:00:00
ifTradeIn
boolean 
是否以旧换新单
可选
tradeInAmount
number 
旧金金额
可选
refundOrderItems
array [object {30}] 
子退单列表
必需
freight
number 
运费
可选
10.00
receiverName
string 
收货人姓名
可选
张三
receiverMobile
string 
收货人手机号
可选
15599999999
receiverTelephone
string 
收货人固定电话
可选
0925-12345678
receiverProvince
string 
省
可选
陕西省
receiverCity
string 
市
可选
西安市
receiverDistrict
string 
区/县
可选
雁塔区
receiverAddress
string 
收货人地址
可选
高新三路9号
receiverZipCode
string 
邮编
可选
720000
pointFlag
integer 
是否计算积分(默认为1)
可选
0-不计算积分, 1- 计算积分
refundTime
string 
8时区退货时间(格式: yyyy-MM-dd HH:mm:ss)
可选
2024-12-01 00:00:00
finishTime
string 
8时区退货完成时间(格式: yyyy-MM-dd HH:mm:ss)
可选
2024-12-01 00:00:00
isInternal
string 
是否是内部订单(默认为N)
可选
Y:否 N:是
示例

返回响应

🟢200成功
application/json
refundSync 200 response
Body
success
boolean 
是否成功:true 表示成功 false 表示失败
可选
code
string 
000000 表示成功,其余编码表示具体错误编码
可选
message
string 
可选
data
object (Void) 
可选
上一页
标签导入通知
下一页
订单同步
Built with