订单

一. 订单数据推送

提供方构建数据结构并推送到对接方.

1.1 准备工作

  • 对接方提供接口, 数据由提供方主动推送给对接方.
  • 接口尽可能做授权, 以防滥用.

1.2 授权流程 ()

实际对接过程中以对接方验签流程为主.

二. 订单数据结构

以下数据结构采取通用部分作为展示, 完整对接整体数据.

整体结构

需要其他数据请联系提供方


// 数据结构以json数据为准

// order
{
    "member_id": 1,
    "mobile": "17620803841",
    "uniacid": 1,
    "order_sn": "SN2412311741FDC53E",
    "price": "0.00",
    "dispatch_price": "0.00",
    "discount_price": "0.00",
    "deduction_price": "70.00",
    "deduction_point": "700.00",
    "status": -1,
    "status_name": "已关闭",
    "pay_type_id": 54,
    "pay_type_name": "确认",
    "refund_id": 12,
    "create_time": "2024-12-31 17:41:03",
    "pay_time": "2024-12-31 17:41:05",
    "send_time": "",
    "finish_time": "",
    "cancel_time": "2024-12-31 17:51:34",
    "order_cancel_deduct_return": "0.00",
    "order_goods": [
        {
            "total": 7,
            "price": "70.00",
            "thumb": "http://localhost:8000/static/upload/newimage/2e47887207499205182a44db24d9cd0a.jpg",
            "goods_price": "70.00",
            "goods_option_title": "",
            "discount_price": "0.00",
            "deduction_amount": "1.00",
            "deduction_point": "20.00",
            "payment_amount": "70.00",
            "discounts": [
                {
                    "discount_code": "优惠代码",
                    "name": "优惠",
                    "amount": "70.00",
                }
            ],
            "deductions": [
                {
                    "code": "point",
                    "name": "积分",
                    "used_amount": "70.00",
                    "used_coin": "70.00"
                }
            ]
        }
    ],
    "order_pay": {
        "pay_type_id": 54,
        "pay_time": "2024-12-31 17:41:05",
        "pay_sn": "PN24123117410091AA",
        "amount": "0.00",
        "status": 2,
        "status_name": "已退款"
    },
    "order_address": {
        "realname": "吴1",
        "mobile": "17620803841",
        "address": "北京市 北京市 东城区 123123",
        "province_id": 110000,
        "city_id": 110100,
        "district_id": 110101
    },
    "expresses": [
        {
            "express_company_name": "其他快递",
            "express_sn": "SN12312323",
            "express_code": "",
            "created_at": "2025-01-09 21:06:32"
        }
    ],
    "refund_apply": [
        {
            "refund_sn": "RN20241231175134FX",
            "status": 7,
            "status_name": "已手动退款",
            "refund_type": 0,
            "refund_type_name": "退款",
            "price": "0.00",
            "reason": "订单关闭并退款",
            "receive_status": 0,
            "receive_status_name": "未收到货",
            "part_refund": 4,
            "create_time": "2024-12-31 17:51:34",
            "refund_time": "2024-12-31 17:51:34",
            "refund_goods": [
                {
                    "id": 1,
                    "order_id": 1,
                    "refund_id": 1,
                    "refund_total": "10.00",
                    "refund_price": "10.00"
                }
            ],
            "deduct_price": "0.00",
            "deduct_return": "0.00"
        }
    ]
}

订单主体

参数类型说明
member_idint会员唯一id
mobilestring手机号
uniacidint站点值
order_snstring订单号
pricedecimal支付金额
dispatch_pricedecimal运费
discount_pricedecimal抵扣总金额
deduction_pricedecimal抵扣积分比例金额
deduction_pointdecimal抵扣积分
statusint订单状态
status_namestring状态名称
pay_type_idint支付类型
pay_type_namestring支付类型名称
refund_idint退款id (当status = 0, refund_id > 0, 那么此订单是退款订单)
create_timestring创建时间
pay_timestring支付时间
send_timestring发货时间
finish_timestring完成时间
cancel_timestring取消时间
order_goodsArray(object)订单商品
order_payobject支付单信息
order_addressobject订单地址
expressesArray(object)订单物流
refund_applyArray(object)订单售后
order_cancel_deduct_returndecimal订单取消积分返还数值

订单商品

参数类型说明
totalstring数量
pricedecimal支付金额
titlestring商品名称
thumbstring商品图
goods_pricedecimal商品现价
goods_option_titleint商品规格名称(无规格默认为空)
discount_pricedecimal优惠总金额
deduction_amountdecimal抵扣积分比例金额
deduction_pointdecimal抵扣实际积分
payment_amountdecimal实际支付金额
discountsArray(object)优惠
deductionsArray(object)折扣

商品优惠

参数类型说明
discount_codestring优惠标识
namestring优惠名称
amountstring优惠金额

商品折扣

参数类型说明
codestring抵扣标识
namestring名称
used_amountdecimal抵扣数值
used_coindecimal抵扣金额

支付单

参数类型说明
pay_type_idint支付类型id
pay_timestring支付时间
pay_snstring支付单号 (订单会有很多支付单关联, 只会锁定支付的单号. 否则返回空)
amountdecimal支付金额
statusint状态
status_namestring状态名称

订单地址

参数类型说明
realnamestring下单时填写的名称
mobilestring手机号
addressstring地址
province_idint省行政代码
city_idint市行政代码
district_idint区行政代码

订单物流

有些订单是多个包裹.

参数类型说明
express_company_namestring物流名称
express_snstring物流单号
express_codestring物流代码
created_atstring创建时间

订单售后

参数类型说明
idstring退款单id
refund_snstring退款单
statusint售后单状态
status_namestring售后状态名称
refund_typeint售后类型
refund_type_namestring售后类型名称
pricedecimal退款金额
reasonstring退款原因
receive_statusint收货状态
receive_status_namestring收货状态名称
part_refundint部分退款状态
create_timestring创建时间
refund_timestring完成时间
refund_goodsarray(object)订单售后商品
deduct_returndecimal积分返还
deduct_returndecimal积分抵扣金额

订单售后商品

参数类型说明
idintid
order_idint订单id
refund_idint退款单id
refund_totalstring数量
refund_pricedecimal商品退款总金额

三. 状态说明

订单状态

状态类型状态类型名称
-1已关闭
0待付款
1已支付 | 待发货 | 待确认
2已发货 | 待收货
3完成 | 交易完成

售后单状态

状态类型状态类型名称
-3关闭
-2用户取消
-1驳回
0待审核
1待退货
2待收货/用户发货
3重新发货
4重新收货/商家发货
5待打款
6已完成
7手动退款