各业务消息参数说明

订单业务消息

订单业务消息格式为 JSON 字符串

订单状态变更消息

消息结构体说明

字段 类型 必须 示例值 说明
msgType String 是 固定 "ORDER_STATUS_CHANGE" 消息类型
orderSn String 是 210000001000001 订单号，全局唯一，不会重复
orderStatus String 是 CREATED 订单状态，详见下方枚举说明
storeSn String 是 21590000001192570 门店号
updateTime Number 是 1700318325713 状态变更的时间戳 
{
    "msgType": "ORDER_STATUS_CHANGE",
    "orderSn": "210000001000001",
    "orderStatus": "CREATED",
    "storeSn": "21590000001192570",
    "updateTime": 1700318325713
}

订单状态 orderStatus 枚举说明

值 含义
CREATED 订单生效
ACCEPTED 商家接单
CANCELED 订单置为无效
FINISHED 订单完成
取消单退单消息

消息体结构说明

字段 类型 必须 示例值 说明
msgType String 是 固定 "ORDER_REFUND" 消息类型
storeSn String 是 21590000001192570 门店号
orderSn String 是 210000001000001 订单号
refundStatus String 是 C_REFUND_APPLY 退款状态，枚举详见下方说明
refundMethod String 是 BY_AMOUNT 退款方式，枚举详见下方说明
refundReason String 否 不好吃 退款原因
goods Array 否 退款商品列表，按金额退款无此字段
refundAmount Number 是 1200 退款金额
updateTime Number 是 1700318325713 事件发生时间戳

退款商品列表结构说明

字段 类型 必须 示例值 说明
id String 是 4e351201-9ae2-4142-9863-1a3500ac7857 商品唯一ID
name String 是 苹果 商品名称
quantity Number 是 1 退款数量，最多 3 位小数
amount Number 是 100 金额

完整消息体示例

{
    "msgType": "ORDER_REFUND",
    "orderSn": "210000001000001",
    "refundStatus": "C_REFUND_APPLY",
    "refundMethod": "BY_GOODS",
    "refundReason": "不好吃",
    "goodsList": [
        {
            "id": "4e351201-9ae2-4142-9863-1a3500ac7857",
            "name":"苹果",
            "quantity": 1,
            "amount": 100
        },
        {
            "id": "4e351201-9ae2-4142-9863-1a3500ac7857",
            "name":"香蕉",
            "quantity": 2,
            "amount": 200
        }
    ],
    "refundAmout": 1200,
    "storeSn": "21590000001192570",
    "updateTime": 1700318325713
}

退单状态 refundStatus 枚举说明

值 含义
C_CANCEL 商家接单一分钟内用户无责取消
C_REFUND_APPLY 用户申请退款
C_REFUND_APPLY_REVOKE 用户撤销退款申请
C_REFUND_APPLY_AUTO_AGREE 用户申请退款超时自动通过
C_REFUND_APPLY_MERCHANT_AGREE 商家同意退款成功
C_REFUND_APPLY_MERCHANT_REJECT 商家拒绝退款
MERCHANT_REFUND 商家主动退款成功

退款方式 refundMethod 枚举说明

值 含义
BY_GOODS 按商品退款
BY_AMOUNT 按金额退款

results matching ""

    No results matching ""