批量同步订单信息v2

POST

/open-api/order/import_order_v2

openapi

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

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

请求参数

Query 参数

access_token

string

调用接口凭证

必需

默认值:

Body 参数application/json

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"
        }
      ]
    }
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://open.weibanzhushou.com/open-api/order/import_order_v2?access_token=' \
--header 'Content-Type: application/json' \
--data-raw '{
  "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成功

application/json

Body

errcode

integer

必需

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

errmsg

string

必需

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

示例

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

🟢200正常返回

修改于 2024-03-07 07:01:36

批量同步商品信息

批量删除商品信息