一、前置準備（必須完成）

1. 開放平臺基礎配置

注冊 / 登錄：1688 開放平臺，完成企業(yè)實名認證（個人賬號無訂單接口權限）。

創(chuàng)建應用：在「應用管理」創(chuàng)建應用，獲取app_key（應用 ID）、app_secret（應用密鑰）。

申請權限：在「權限管理」申請以下核心訂單接口權限（免費，審核 1-2 個工作日）：

2. 授權與令牌獲取

訂單接口需用戶授權（即綁定你的 1688 采購賬號），通過 OAuth2.0 獲取access_token（有效期 24 小時，需定時刷新）：

引導用戶訪問授權鏈接：

plaintext

https://open.1688.com/oauth/authorize?client_id=你的app_key&response_type=code&redirect_uri=你的回調地址&state=隨機字符串

用戶授權后，回調地址會返回code，用code換取access_token：

bash

運行

POST https://open.1688.com/openapi/param2/1/system.oauth2/getToken
參數(shù)：
client_id=你的app_key&client_secret=你的app_secret&grant_type=authorization_code&code=授權碼&redirect_uri=回調地址

保存access_token和refresh_token（用于過期后自動刷新）。

二、核心流程：訂單同步全步驟（API 調用）

步驟 1：自有平臺訂單數(shù)據(jù)整理（待同步數(shù)據(jù)）

先將你的電商平臺（淘寶 / 抖音 / 自有商城）訂單整理為 1688 API 要求的格式，核心字段示例：

json

{
  "buyer_nick": "采購賬號昵稱",
  "receiver_name": "張三",
  "receiver_mobile": "138xxxx1234",
  "receiver_address": "浙江省杭州市濱江區(qū)XX街道XX小區(qū)1棟1單元101",
  "products": [
    {
      "product_id": "1688商品ID",  // 需提前綁定1688商品
      "sku_id": "1688商品規(guī)格ID",
      "quantity": 2,  // 采購數(shù)量
      "price": 9.9    // 商品單價（需與1688供應商報價一致）
    }
  ],
  "payment_type": "online",  // 支付方式：online/ offline
  "remark": "加急發(fā)貨"       // 訂單備注
}

步驟 2：調用alibaba.order.create創(chuàng)建 1688 采購單（核心）

這是「訂單同步」的核心接口，將自有平臺訂單轉為 1688 官方采購單。

1. 接口基礎信息

請求地址：https://gw.open.1688.com/openapi/param2/1/alibaba.order/create

請求方式：POST

數(shù)據(jù)格式：JSON

頻率限制：單應用 QPS≤5，日調用≤1000 次

2. Python 調用示例（含簽名 + 驗簽）

python

運行

import requests
import hashlib
import time
import json

# 配置信息（替換為你的實際值）
APP_KEY = "你的app_key"
APP_SECRET = "你的app_secret"
ACCESS_TOKEN = "你的access_token"
API_URL = "https://gw.open.1688.com/openapi/param2/1/alibaba.order/create"

def generate_1688_sign(params, app_secret):
    """生成1688 API簽名（MD5）"""
    # 按參數(shù)名ASCII升序排序
    sorted_params = sorted(params.items())
    # 拼接參數(shù)字符串（key+value）
    param_str = ''.join([f"{k}{v}" for k, v in sorted_params])
    # 首尾拼接app_secret并MD5加密
    sign_str = app_secret + param_str + app_secret
    return hashlib.md5(sign_str.encode()).hexdigest().upper()

def create_1688_order(order_data):
    """創(chuàng)建1688采購訂單"""
    # 1. 構造公共參數(shù)
    public_params = {
        "app_key": APP_KEY,
        "timestamp": str(int(time.time() * 1000)),
        "format": "json",
        "v": "2.0",
        "sign_method": "md5",
        "access_token": ACCESS_TOKEN,
        "method": "alibaba.order.create"  # 接口方法名
    }
    
    # 2. 構造業(yè)務參數(shù)（需轉為JSON字符串）
    biz_params = {
        "order_param": json.dumps(order_data, ensure_ascii=False)
    }
    
    # 3. 合并參數(shù)并生成簽名
    all_params = {**public_params, **biz_params}
    all_params["sign"] = generate_1688_sign(all_params, APP_SECRET)
    
    # 4. 發(fā)送POST請求
    try:
        response = requests.post(
            API_URL,
            data=all_params,
            headers={"Content-Type": "application/x-www-form-urlencoded"},
            timeout=30
        )
        response.raise_for_status()
        result = response.json()
        return result
    except Exception as e:
        print(f"創(chuàng)建訂單失敗：{str(e)}")
        return None

# 測試調用（替換為你的訂單數(shù)據(jù)）
if __name__ == "__main__":
    # 待同步的訂單數(shù)據(jù)
    test_order = {
        "buyer_nick": "你的1688賬號昵稱",
        "receiver_name": "張三",
        "receiver_mobile": "13800001234",
        "receiver_address": "浙江省杭州市濱江區(qū)網(wǎng)商路699號",
        "products": [
            {
                "product_id": "1234567890",  # 替換為真實1688商品ID
                "sku_id": "1122334455",     # 替換為真實規(guī)格ID
                "quantity": 2,
                "price": 19.9
            }
        ],
        "payment_type": "online",
        "remark": "測試訂單同步"
    }
    
    # 創(chuàng)建訂單
    order_result = create_1688_order(test_order)
    if order_result:
        print("訂單創(chuàng)建結果：", json.dumps(order_result, indent=2, ensure_ascii=False))
        # 成功后保存1688訂單號，用于后續(xù)查詢/履約
        if "result" in order_result and "order_id" in order_result["result"]:
            print(f"同步成功，1688訂單號：{order_result['result']['order_id']}")

步驟 3：訂單狀態(tài)與物流同步

拉取訂單狀態(tài)：調用alibaba.order.get，傳入order_id獲取訂單支付 / 發(fā)貨 / 收貨狀態(tài)：

python

運行

# 簡化示例（核心參數(shù)）
def get_order_status(order_id):
    params = {
        "app_key": APP_KEY,
        "timestamp": str(int(time.time() * 1000)),
        "access_token": ACCESS_TOKEN,
        "method": "alibaba.order.get",
        "order_id": order_id,
        # 其他公共參數(shù)+簽名（同創(chuàng)建訂單邏輯）
    }
    # 發(fā)送請求并解析狀態(tài)（paid/ shipped/ received）

同步物流軌跡：供應商發(fā)貨后，調用alibaba.logistics.trace獲取物流單號和軌跡，回傳至自有平臺：

python

運行

def get_logistics_trace(order_id):
    params = {
        "app_key": APP_KEY,
        "timestamp": str(int(time.time() * 1000)),
        "access_token": ACCESS_TOKEN,
        "method": "alibaba.logistics.trace",
        "order_id": order_id,
        # 簽名等參數(shù)
    }
    # 解析返回的物流軌跡（快遞公司、單號、節(jié)點信息）

步驟 4：訂單履約閉環(huán)（確認收貨 / 售后）

買家確認收貨后，調用alibaba.trade.receive完成訂單閉環(huán)；

若有售后需求，調用alibaba.order.refund.create創(chuàng)建退款單，同步售后狀態(tài)。

三、關鍵避坑點（新手必看）

簽名錯誤：

業(yè)務參數(shù)需轉為 JSON 字符串，且參數(shù)排序必須按 ASCII 升序；

時間戳為 13 位毫秒級，避免請求過期。

權限問題：

訂單接口僅對企業(yè)認證賬號開放，個人賬號調用會返回 403；

需確保access_token未過期（建議每 23 小時刷新一次）。

數(shù)據(jù)一致性：

商品 ID / 規(guī)格 ID 必須與 1688 供應商商品一致，否則創(chuàng)建訂單失敗；

單價需與供應商報價匹配，避免價格異常導致訂單被攔截。

限流處理：

批量同步訂單時，需控制 QPS（≤5 次 / 秒），建議分批次調用，失敗后指數(shù)退避重試。

四、替代方案（無代碼 / 低代碼）

若你無開發(fā)能力，可使用 1688 官方合作的 ERP 工具（無需調用 API）：

工具推薦：店小秘、通途、牽牛分銷助手；

操作流程：

綁定 1688 賬號和自有電商平臺（淘寶 / 抖音等）；

配置商品關聯(lián)規(guī)則（自有商品→1688 商品）；

開啟「訂單自動同步」，系統(tǒng)自動創(chuàng)建 1688 采購單并同步物流。

總結

1688 訂單同步的核心是通過alibaba.order.create接口將自有訂單轉為 1688 采購單，需先完成開放平臺認證、權限申請和 OAuth 授權。

關鍵步驟：整理訂單數(shù)據(jù)→創(chuàng)建采購單→同步訂單狀態(tài) / 物流→完成履約閉環(huán)，核心要保證簽名正確、數(shù)據(jù)一致、遵守限流規(guī)則。

無開發(fā)能力可選擇官方合作 ERP 工具，低成本快速落地訂單同步。

審核編輯 黃宇