下单
下单
/order/create 创建订单
Method: POST
Class: OrderCreateV1View
请求:
customer M dict 商户信息
{
uid M str 用户ID
address_id M str 店铺ID
address M str 店铺地址
address_sign_id M str 区域ID
receiver_name M str 收货人姓名
receiver_phone M str 收货人电话
settle_way M int 结算方式
district_code M str 城市码
supply_station_id O str 供应站点ID
extender M str 扩展信息{resname: 店铺名,order_pay_method: 付款方式}
receive_begin_time M str 收货开始时间(%Y-%d-%m %H:%M)
receive_end_time M str 收货结束时间(%Y-%d-%m %H:%M)
}
station_id M str 站点ID
products M list 商品信息
[{
sku_id M str 商品sku ID
amount M float 下单数量
spu_id O str 商品spu id
spu_remark O str 商品备注
unit_price O float 商品单价(分)
is_price_timing O int 是否时价
}]
time_config_id M str 服务时间配置ID
client O int 下单客户端
remark O str 订单备注
out_order_id O str 外部订单ID
coupon_dict O dict 优惠券信息
{
coupon_id M int 优惠券id
coupon_max_discount_percent M float 最大优惠比
coupon_amount M float 优惠金额
coupon_min_total_price M float 满减条件
}
reward_skus O list 积分商品信息
[{
reward_sku_id M str 积分商品
quantity M float 数量
sku_cost_point M int 花费积分
sku_name M str 商品名
sale_unit M str 积分商城sku的单位
sku_cost M int 成本价
}]
响应:
code M int 0为成功，其它为失败
msg M string 错误提示信息
data M str 返回的订单ID
eg: {"data": "PL6711967", "msg": "ok", "code": 0}
逻辑:
检测商品库存
生成订单数据
扣减库存
创建订单
发送消息通知
/order/detail/update 更新订单商品
接口名: /order/detail/update
Method: POST
Class: OrderDetailsUpdateV1View
请求:
order_id M str 订单ID
products M list 商品信息
[{
sku_id M str 商品sku ID
amount M float 下单数量
spu_id O str 商品spu id
spu_remark O str 商品备注
unit_price O float 商品单价(分)
is_price_timing O int 是否时价
}]
is_delta O bool 是否增量更新商品数量(默认是False)
remark O str 订单备注
receive_begin_time O str 收货开始时间(YYYY-MM-DD HH:MM)
receive_end_time O str 收货结束时间(YYYY-MM-DD HH:MM)
operator O str 操作人
reward_skus O list 积分商品信息
[{
reward_sku_id M str 积分商品
quantity M float 数量
sku_cost_point M int 花费积分
sku_name M str 商品名
sale_unit M str 积分商城sku的单位
sku_cost M int 成本价
}]
响应:
code M int 0为成功，其它为失败
msg M string 错误提示信息
data M str 返回的订单ID
eg: {"data": "PL6711967", "msg": "ok", "code": 0}
逻辑:
检测商品库存
生成订单数据
更新订单
扣减库存
发送通知
/order/detail/calculate 获取修改后的订单详情(不会真正更新订单)
Method：Get
Class: TransportOrdersQueryView
请求：
order_id M str 订单ID
is_delta O bool 是否增量
products M list 商品信息
[{
sku_id M str 商品sku ID
amount M float 下单数量
spu_id O str 商品spu id
spu_remark O str 商品备注
unit_price O float 商品单价(分)
is_price_timing O int 是否时价
}]
响应：
code M int 返回码，0表示成功，其他表示错误
msg M string 错误信息
data M dict
abnormal_money M float 异常金额
real_price M float 出库金额
should_refund_money M float 应退金额
freight M float 运费
示例：
{"code": 0, "msg": "ok", "data": {"abnormal_money": 0, "real_price": 184635.0, "should_refund_money": 0, "freight": 0}}
/order/delete 删除订单
接口名: /order/delete
Method: POST
Class: OrderDeleteView
请求:
order_id M str 订单ID
group_id M int group id
响应:
code M int 0为成功，其它为失败
msg M string 错误提示信息
data M str
eg: {"data": null, "msg": "ok", "code": 0}
逻辑:
检测订单状态
删除订单
恢复库存
发送通知
/order/supply/update 供应单更新
接口名: /order/supply/update
Method: POST
Class: OrderSupplyUpdate
请求:
group_id M int group id
origin_order_id M str 源订单ID
customer M dict 商户信息
{
uid M str 用户ID
address_id M str 店铺ID
address M str 店铺地址
address_sign_id M str 区域ID
receiver_name M str 收货人姓名
receiver_phone M str 收货人电话
settle_way M int 付款方式
district_code M str 城市码
supply_station_id O str 供应站点ID
receive_begin_time M str 收货开始时间(%Y-%d-%m %H:%M)
receive_end_time M str 收货结束时间(%Y-%d-%m %H:%M)
}
station_id M str 站点ID
products M list 商品信息
[{
sku_id M str 商品sku ID
origins M dict 源商品信息
[{
order_id M str 订单ID
sku_id M str 商品ID
amount M float 下单数量
split_flag M int 分切标识
is_weigh M bool 是否称重
}]
}]
time_config_id M str 服务时间配置ID
aggregate_type M int 聚合类型
响应:
code M int 0为成功，其它为失败
msg M string 错误提示信息
data M str 返回的订单ID
eg: {"data": "PL6711967", "msg": "ok", "code": 0}
逻辑:
查询合单信息
生成订单数据
更新订单
发送通知
/order/freeze/update 修改订单锁定状态
接口名: /order/freeze/update
Method: POST
Class: OrderFreezeUpdateView
请求:
order_ids M list 订单ID列表
freeze O bool 是否锁定(true: 锁定;false: 解锁)默认为true
响应:
code M int 0为成功，其它为失败
msg M string 错误提示信息
data M str
eg: {"data": null, "msg": "ok", "code": 0}
逻辑:
判断订单状态
锁定或者解锁
/order/status/update 修改订单状态
接口名: /order/status/update
Method: POST
Class: BatchUpdateOrderStatusView
请求:
order_ids M list 订单ID列表
status M int 状态
响应:
code M int 0为成功，其它为失败
msg M string 错误提示信息
data M str
eg: {"data": null, "msg": "ok", "code": 0}
逻辑:
判断订单状态
修改订单状态
/order/update 订单修改
Method: POST
Class: OrderUpdateView
请求:
update_dict
响应:
code M int 0为成功，其它为失败
msg M string 错误提示信息
data M str
/order/bulk_update 订单批量修改
Method: POST
Class: OrderBulkUpdateView
请求:
update_dict list<dict> 更新的内容
filter M dict 查询的内容
_id M str 订单id
details.id O str 商品id
data M dict 更新的内容
details.$.spu_remark O str 商品备注
details.$.tax_rate O float 税率
batch_remark O str 分拣备注
distribute_time O datetime 配送时间
status O int 状态
响应:
code M int 0为成功，其它为失败
msg M string 错误提示信息
data M str
请求示例：
[{"filter": {"_id": "PL7599320"}, "data": {"status": 15}}]
detail_sku_sort/update 商品排序
Method: POST
Class: OrderDetailSortView
请求:
id M str 订单号
sku_sort M list 商品排序好的id
响应:
code M int 0为成功，其它为失败
msg M string 错误提示信息
data M str
请求示例：
id=PL7619072&sku_sort=["D9792814", "D9791785", "D9790796"]
update/increase 订单字段自增
Method: POST
Class: OrderUpdateIncrease
请求:
ids M list 订单号
update_dict M dict 更新的字段
print_times O str 打印次数
响应:
code M int 0为成功，其它为失败
msg M string 错误提示信息
data M str
请求示例：
ids=["PL7604186"]&update_dict={"print_times": 1}