Skip to content

合晟对接方案

新增接口

查询sku

openapi/merchandise/sku/list

请求参数

参数名 类型 可选M/必选O 描述
salemenu_id string M 报价单id
category1_ids list O 一级分类id列表
category2_ids list O 二级分类id列表
pinlei_ids list O 品类id列表
offset int O 起始位置
limit int O 每页条数,最大值

返回参数:

{  
   "data":[  
      {  
         "stock_avg_price":null,
         "category_id_2":"B27509",
         "sale_price":100,
         "last_purchase_price":null,
         "over_suggest_price":false,
         "sale_unit_name":"斤",
         "std_unit_name":"斤",
         "spu_name":"江西野猪肉",
         "outer_id":"",
         "suggest_price_max":null,
         "last_in_stock_price":null,
         "last_quote_price":null,
         "category_name_1":"肉类",
         "state":1,
         "std_sale_price":100,
         "is_price_timing":false,
         "suggest_price_min":null,
         "spu_id":"C1665961",
         "sku_name":"广式野猪肉",
         "sku_id":"D7713295",
         "category_name_2":"猪肉",
         "pinlei_name":"乡村黑猪",
         "category_id_1":"A5047",
         "sale_ratio":1.0
      }
   ],
   "msg":"ok",
   "pagination":{  
      "limit":10,
      "count":6,
      "offset":0
   },
   "code":0
}

创建订单

openapi/order/create

请求参数

参数名 类型 可选M/必选O 描述
sid string M 客户id
details list O 商品详情,字段如下
— sku_id string M 商品id
— amount float M 商品数量
— unit_price int M 基础单位价格,单位分
— spu_remark string O 商品备注
— is_price_timing bool O 商品价格时价,用0/1表示
receive_begin_time datetime O 收货起始时间,形如:2019-01-01 00:00:00
receive_end_time datetime O 收货截止时间,形如:2019-01-01 00:00:00

返回:

{  
   "data":{  
      "order_id": "PL000001"
   },
   "msg":"ok",
   "code":0
}

消息推送

DB改动

openapi_user

appid
...
notify_url  【新增】消息通知地址

openapi_notify 【新增】

type
appid
data
desc
status
create_time
modify_time

消息推送系统

单次推送,不做自动补推

消息体

{
  "version": "",
  "type": "order_delivered",
  "data": {
    "order_no": "",
  },
  "desc": "",
  "appid": "",
  "ts": 1588888888,
  "sign": "",
}

签名方式

sign= MD5(GM{APPID}{APPSECRET}{TIMESTAMP})

手动补推

推送失败列表

openapi/notify/list

手动补推

openapi/notify/send