蔬东坡开放平台V2版本
  1. 异步通知
蔬东坡开放平台V2版本
  • 蔬东坡开发平台V2版本文档
    • 什么是蔬东坡开放平台
    • 开发指南
      • 接入说明
      • API调用协议
    • API列表
      • 鉴权
        • 获取access_token
      • 商品
        • 新增分类
        • 编辑分类
        • 删除分类
        • 获取分类
        • 获取商品单位
        • 新增商品
        • 获取商品SPU
        • 编辑商品
        • 获取商品客户类型价
      • 客户
        • 新增客户
        • 获取客户列表
        • 获取客户类型列表
        • 集团列表
      • 采购员
        • 获取采购员
        • 新增采购员
      • 供应商
        • 新增供应商
        • 获取供应商
      • 库房
        • 现有库存查询
        • 入库列表
        • 出库详情
        • 出库列表
        • 入库详情
      • 订单
        • 创建订单
        • 获取订单列表
        • 获取订单详情
        • 获取订单标签
        • 完成订单
        • 关闭订单
        • 实收变更列表
        • 批量创建订单
        • 创建实收变更
        • 实收变更详情
      • 配送
        • 获取区域列表
        • 获取线路列表
        • 获取区域线路关系列表
        • 获取送货时间段
      • 采购
        • 采购列表
      • 系统
      • 基础数据接口
        • 获得全部站点
        • 业务员列表
        • 获取所有仓库
      • 订单-退货单
        • 创建退货单
        • 退货单列表
        • 退货单详情
        • 编辑退货单
      • 财务
        • 客户对账列表
        • 采购对账列表
        • 客户对账详情
        • 采购对账详情
        • 支付列表
        • 客户结算
        • 采购结算
      • 客户商品
        • 获取客户商品价格
      • 采购-退货单
        • 采购退货单列表
      • 协议价
        • 客户协议价
        • 客户协议价详情
        • 采购协议价
        • 采购协议价详情
      • 异步通知
        • 通知参数说明
    • API主要场景
      • 如何创建一个商品
      • 如何创建订单
      • 创建商城订单
    • 常见问题
  • 数据模型
    • 11
  1. 异步通知

通知参数说明

简要描述:
对于接口产生的订单,系统会根据原始订单 API 中传入的异步通知地址 notify_url,通过 POST 请求发送json数据形式将订单结果作为参数通知到商户系统。
基础数据变更通知请联系业务经理
请求方式:
POST 请求json数据
异步通知参数:
参数名必填类型说明
timestamp是timestamp当前时间戳
notify_type是String通知类型 详见下表类型表说明
appid是String系统分配给开发者的应用Id
sign是String签名
user_code是String用户编码
delivery_date是Date发货日期
order_no是String订单号|
order_remark是String订单备注|
order_price是Number(9,2)下单金额
delivery_price是Number(9,2)发货金额
return_no否String退货号
return_remark退货原因String是
return_price否Number(9,2)本次退货金额
modify_no否String实收变更记录单号
version是int版本号
passback_params否String公共回传参数,如果请求时传递了该参数,则返回给商户时会在异步通知时将该参数原样返回
user_name是String用户名
receive_name是String收货人
receive_tel是String收货电话
address_detail是String订单地址
split_source_order_no是String拆单源单号,16.8.0版本后才支持
third_party_order_no是String第三方订单号,16.8.0版本后才支持
commodity_list是String详见下表 订单商品信息说明[{"commodity_id":10117,"order_amount":1,"delivery_amount":1,"return_amount":"","unit":"斤","unit_price":"0.01","order_price":"12","delivery_price":'',"return_price":'0.00',"sort_amount":11,"unit_convert":"Y","unit_sell":"斤","modify_amount":2}]
通知类型说明:
枚举名称枚举说明
ORDER_CREATE订单创建
ORDER_CLOSE订单关闭
ORDER_DELIVERY订单发货
ORDER_RETURN订单退货审核
ORDER_RETURN_REFUSE订单退货拒绝
ORDER_MODIFY_AUDIT订单实收变更审核
ORDER_MODIFY_CLOSE订单实收变更关闭
ORDER_COMPLETE订单完成
ORDER_BRUSH_PRICE订单刷价
ORDER_AUDIT订单审核
订单商品信息说明:
参数参数名称类型必填范例
commodity_id商品idInt是99999
commodity_code商品编码String是D001
commodity_name商品名称String是测试商品
order_commodity_remark订单商品备注String是测试商品
order_amount下单数量Number(9,2)是2.02
delivery_amount发货数量Number(9,2)是1.02
sort_amount分拣数量Number(9,2)是1.02
return_amount本次退货数量Number(9,2)是0.00
modify_amount本次实收变更数量Number(9,2)是0.00
unit单位String是斤
summary商品描述String是斤
unit_convert是否按基础单位分拣String是Y
unit_sell发货单位String是斤
in_price出库成本Number(9,2)是2.02
unit_num商品转换系数Number(9,2)是2.02
tax_rate商品税率Number(9,2)是20
unit_price单价Number(9,2)是0.02
order_price下单小计Number(9,2)是3.02
delivery_price发货小计Number(9,2)是1.02
return_price本次退货小计Number(9,2)是0.00
cloud_origin_url商品溯源数据String是
服务器异步通知页面特性:
必须保证服务器异步通知页面(notify_url)上无任何字符,如空格、HTML 标签、开发系统自带抛出的异常提示信息等;
系统是用 POST 方式发送json数据格式通知信息,获取POST原始数据,如php通过file_get_contents("php://input")获取
程序执行完后必须打印输出success。如果商户反馈给系统的字符不是 success 这7个字符,系统会不断重发通知
程序执行完成后,该页面不能执行页面跳转。如果执行页面跳转,系统会收不到 success 字符,会被服务器判定为该页面程序运行出现异常,而重发处理结果通知;
**异步返回结果的验签 **
通知参数中包含时间戳无需额外生成
参照鉴权签名生成规则
修改于 2025-11-17 02:09:55
上一页
采购协议价详情
下一页
如何创建一个商品
Built with