微伴助手OpenAPI

批量同步订单信息v2

POST/open-api/order/import_order_v2

批量同步订单信息，根据order_id匹配订单是否存在，根据item_id匹配当前订单的商品，根据shop_id匹配当前订单的商店，不存在的订单将会新建，已存在的数据条目将会被更新。调用此接口需购买基础席位。

错误码	说明
21006	导入订单失败
21007	shop_id非法，不存在对应店铺
21008	item_id非法，不存在对应商品
21009	unionid非法，找不到对应客户

请求参数

order_list

array [object {17}]

必需

订单列表，最多支持传入100个订单

shop_id

string

必需

店铺id，为店铺的唯一编号，需要通过“获取店铺信息列表”这个接口获取

item_id

string

商品id，唯一标识

必需

item_name

string

商品名称

必需

item_price

string

商品价格

必需

amount

integer

购买数量

必需

payment_amount

string

购买总金额

必需

discount_amount

number

优惠金额

必需

payment_channel

string

支付渠道

必需

string

订单号

必需

order_status

string

订单状态

必需

create_time

integer

订单创建时间

必需

paid_time

integer

订单支付时间

必需

unionid

string

必需

客户的unionid

openid

string

可选

客户的openid， 2022年8月1号之后注册的企业openid为必填

phone_num

string

可选

客户的手机号，对于2022年8月1号之后注册的企业需要传入unionid&openid或者phone_num，之前的企业需传入unionid或phone_num

order_type

string

必需

订单类型，限制长度不超过18，此参数对应侧边栏的订单名称的显示

order_fields

array [object {2}]

必需

订单信息自定义字段，非订单基本字段列表。

{
  "order_list": [
    {
      "shop_id": "xj184389276493",
      "item_id": "11111",
      "item_name": "商品名称",
      "item_price": "100",
      "amount": 2,
      "payment_amount": "40",
      "discount_amount": 4.04,
      "payment_channel": "支付宝",
      "id": "100000004",
      "order_status": "已付款，待发货",
      "create_time": 1593565941,
      "paid_time": 1593565949,
      "unionid": "omefmtxc4m4_-bCvMvsbQOsTxFP0",
      "openid": "orxxxxxxxxxxxxxxxxx-xxxxxxxx",
      "order_type": "夜莺商店",
      "order_fields": [
        {
          "field_name": "订单备注",
          "value": "发邮箱123@qq.com"
        },
        {
          "field_name": "买家手机号",
          "value": "173****9527"
        }
      ]
    },
    {
      "shop_id": "1111222223333444",
      "item_id": "22222",
      "item_name": "商品名称2",
      "item_price": "100",
      "amount": 2,
      "payment_amount": "40",
      "discount_amount": 4.04,
      "payment_channel": "支付宝",
      "id": "100000005",
      "order_status": "已付款，待发货",
      "create_time": 1593565941,
      "paid_time": 1593565949,
      "unionid": "omefmtxc4m4_-bCvMvsbQOsTxFP0",
      "order_type": "夜莺",
      "order_fields": [
        {
          "field_name": "订单备注",
          "value": "发邮箱123@qq.com"
        },
        {
          "field_name": "买家手机号",
          "value": "173****9527"
        }
      ]
    }
  ]
}

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

errcode

integer

必需

状态码，0为正常，非0代表错误。

errmsg

string

必需

错误信息，成功时为'ok'，错误时会以中文方式显示错误原因

{
  "errcode": 0,
  "errmsg": "ok"
}

最后修改时间： 9 个月前