茂阳
  1. 异步通知
茂阳
  • 蔬东坡开放平台API文档
    • 什么是蔬东坡开放平台
    • 开发入门
      • API调用协议
      • 签名生成规则
    • 基础数据接口
      • 获得全部站点
      • 发货时间段列表
      • 用户类型列表
      • 商品分类列表
      • 获得全部仓库
      • 业务员新增
      • 获取采购员、供应商数据
      • 区域列表
      • 供应商新增
      • 商品单位列表
      • 业务员列表
    • 库房
      • 订单发货出库
      • 批次库存列表
    • 商品
      • 商品标签
      • 编辑商品分类
      • 新增商品分类
      • 删除商品分类
      • 新建商品
      • 搜索商品
      • 更新商品
    • 订单
      • 新增实收变更
      • 订单标签
      • 查询实收变更详情
      • 订单商品标签查询
      • 搜索订单
      • 批量创建订单
      • 新建订单
      • 完成订单
      • 订单关闭
      • 获取配送信息
    • 采购单
      • 新增采购单
      • 采购单收货
      • 采购单查询
      • 编辑采购单
    • 客户协议价
      • 客户类型列表
      • 协议价详情
      • 客户协议价列表
    • 客户
      • 获取下单商品信息
      • 获取线路列表
      • 新增客户
      • 获取集团列表
      • 搜索客户
    • 异步通知
      • 通知参数说明
    • 订单-退货单
      • 退货单列表
      • 退货单详情
      • 创建退货单
      • 审核拒绝退货单
    • 商品-溯源
      • 查询商品溯源
    • 出、入库单查询
      • 入库单查询
      • 出库单查询
    • 客户类型
      • 获得可下单商品列表
    • 现有库存查询
      • 现有库存查询
    • 库房-分拣
      • 分拣条形码获取订单明细
    • 采购-退货单
      • 搜索采购退货单
      • 保存采购退货单
    • 财务
      • 采购结算单列表
      • 客户结算单列表
  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公共回传参数,如果请求时传递了该参数,则返回给商户时会在异步通知时将该参数原样返回
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订单完成
订单商品信息说明:
参数参数名称类型必填范例
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
服务器异步通知页面特性:
必须保证服务器异步通知页面(notify_url)上无任何字符,如空格、HTML 标签、开发系统自带抛出的异常提示信息等;
系统是用 POST 方式发送json数据格式通知信息,获取POST原始数据,如php通过file_get_contents("php://input")获取
程序执行完后必须打印输出success。如果商户反馈给系统的字符不是 success 这7个字符,系统会不断重发通知
程序执行完成后,该页面不能执行页面跳转。如果执行页面跳转,系统会收不到 success 字符,会被服务器判定为该页面程序运行出现异常,而重发处理结果通知;
**异步返回结果的验签 **
通知参数中包含时间戳无需额外生成
参照鉴权签名生成规则
上一页
搜索客户
下一页
退货单列表
Built with