诺云开放平台

Appearance

订单更新推送 ​

推送参数 ​

其他默认推送参数文档，参考消息推送-使用说明。
支持下单、支付成功通知，退款申请、成功通知。
拼团订单，拼团成功后通知支付成功。
订单信息、订单商品信息是推送时获取当前订单信息进行推送。
参数必选类型描述
msg_type是string消息类型：event-事件
event是string事件类型 :orderChange--订单更新
data是object消息内容

data 参数结构

参数必选类型描述
room_id否string直播间id
wechat_user_space_id是string用户ID
action是string订单更新事件类型：order_create--订单创建，order_pay--订单支付成功，order_refund_apply--订单退款申请，order_refund_success--订单退款成功，order_express_update --订单物流更新，order_refund_update --退款订单更新
order_info否object订单信息
order_goods_list否array订单商品信息
third_wechat_info否array客户公众号下用户信息
third_user_info否object客户系统下用户信息

order_info 参数结构

参数必选类型描述
order_id是integer订单id
app_id是integer直播间ID
wechat_user_space_id是integer用户ID
order_type是string订单类型：normal--普通订单，groupon--拼团订单，bargain--砍价订单，points--积分订单，reward--观看奖励
goods_type是string商品类型：goods--实体商品，virtual--虚拟商品
order_status是integer订单状态： 1--待发货，2--待收货，3--申请退款，4--已退款，5--已完成，6--待付款，7--超时关闭， 8--待成团，9--砍价中
is_settle是integer订单结算：1--已结算，2--待结算
create_time是integer下单时间
payment_time是string支付时间
order_sn是string订单号
payment_no是string交易单号（微信单号）
total_number是integer商品总数
total_price是string订单总价
payment_money是string订单实付
postage是string邮费
leftover_money是string订单尾款
refund_money是string已退款金额
shipping_name是string收货人姓名
shipping_mobile是string收货人手机号
address是string收货地址
deliver_time是integer发货时间
exp_id是interget物流公司ID
exp_order是string发货物流单号
channel_invite_info否object门店邀请信息（注：当action为order_create或order_pay时返回）
room_invite_info否object门店邀请信息（注：当action为order_create或order_pay时返回）

channel_invite_info 参数结构

参数必选类型描述
channel_sale_name是string销售员名称
channel_sale_wechat_user_space_id是integer销售员用户id
channel_name是string门店名称
channel_id是integer门店id
channel_director_name是string负责人名称
channel_director_wechat_user_space_id是integer负责人用户id
channel_invite_name是string邀请人名称
channel_invite_wechat_user_space_id是integer邀请人用户id

room_invite_info 参数结构

参数必选类型描述
invited_wechat_user_space_id是integer邀请人id
invited_name是string邀请人昵称

order_goods_list 参数结构

参数必选类型描述
goods_no是string商品编号
goods_id是string商品id
goods_name是string商品名称
goods_cnt是string商品购买数量
goods_price是string商品单价
total_price是string商品总价
postage是string邮费
payment_money是string商品实付金额
refund_money是string商品已退款金额
refund_cnt是string商品已退款数量
goods_attribute是string商品选择属性。json字符串。
goods_encode是string商品/货品编码
goods_specs_encode是string商家编码
sku_encode是stringSKU编码
verify_code_list否array核销码列表（虚拟商品专属字段，实体商品返回空数组）

verify_code_list 参数结构

参数必选类型描述
verify_no是string核销码
is_verify是int核销状态：1-已核销，2-未核销，3-已失效

third_wechat_info 参数结构

参数必选类型描述
authorizer_appid是string客户公众号appid
openid是string客户openid
unionid否string客户unionid

third_user_info 参数结构

参数必选类型描述
third_uuid是string客户系统用户ID
third_attach是string客户系统用户附属信息。json字符串

推送示例 ​


{
    "key": "示例key",
    "msg_id": "示例msg_id",
    "msg_type": "event",
    "event": "orderChange",
    "uid": 1234567890,
    "push_msg_url": "https://example.com/push/orderChange",
    "data": {
        "room_id": 12345,
        "wechat_user_space_id": 67890,
        "action": "order_pay",
        "order_info": {
            "order_id": 10001,
            "app_id": 10000001,
            "wechat_user_space_id": 10002,
            "order_type": "normal",
            "goods_type": "virtual",
            "order_status": 7,
            "is_settle": 2,
            "create_time": 1710840005,
            "payment_time": "2024-01-01 10:00:00",
            "order_sn": "20240101100000000001",
            "payment_no": "PAY202401010001",
            "total_number": 1,
            "total_price": "99.00",
            "payment_money": "99.00",
            "postage": "0.00",
            "leftover_money": "0.00",
            "refund_money": "0.00",
            "shipping_name": "张三",
            "shipping_mobile": "13800000000",
            "deliver_time": 1710843600,
            "exp_id": 1,
            "exp_order": "SF123456789CN",
            "address": "北京市朝阳区示例路1号",
            "channel_invite_info": {
                "channel_sale_name": "销售A",
                "channel_sale_wechat_user_space_id": 20001,
                "channel_name": "示例门店",
                "channel_id": 30001,
                "channel_director_name": "负责人B",
                "channel_director_wechat_user_space_id": 20002,
                "channel_invite_name": "邀请人C",
                "channel_invite_wechat_user_space_id": 20003
            },
            "room_invite_info": {
                "invited_wechat_user_space_id": 20004,
                "invited_name": "邀请人D"
            }
        },
        "order_goods_list": [
            {
                "id": 50001,
                "goods_no": "G20240101",
                "goods_id": "170869",
                "goods_name": "示例商品A",
                "goods_cnt": "2",
                "goods_price": "49.50",
                "total_price": "99.00",
                "postage": "0.00",
                "payment_money": "99.00",
                "refund_money": "0.00",
                "refund_cnt": "0",
                "goods_attribute": "{\"颜色\":\"红色\",\"尺码\":\"L\"}",
                "goods_encode": "GOODS20240101",
                "goods_specs_encode": "SPECS20240101",
                "sku_encode": "SKU20240101",
                "verify_code_list": [
                        {"verify_no": "VC20240101001", "is_verify": 2},
                        {"verify_no": "VC20240101002", "is_verify": 1}
                    ]
            }
        ],
        "third_wechat_info": [
            {
                "authorizer_appid": "wx1234567890abcdef",
                "openid": "oKFTf0TEfzfg1234567890",
                "unionid": "o8-ysv1234567890abcdef"
            }
        ],
        "third_user_info": {
            "third_uuid": "user-123456",
            "third_attach": "{\"site\":\"KD13\"}"
        }
    }
}