一、前置準(zhǔn)備（必須完成）

1. 開(kāi)放平臺(tái)基礎(chǔ)配置

注冊(cè) / 登錄：1688 開(kāi)放平臺(tái)，完成企業(yè)實(shí)名認(rèn)證（個(gè)人賬號(hào)無(wú)訂單接口權(quán)限）。

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

申請(qǐng)權(quán)限：在「權(quán)限管理」申請(qǐng)以下核心訂單接口權(quán)限（免費(fèi)，審核 1-2 個(gè)工作日）：

2. 授權(quán)與令牌獲取

訂單接口需用戶授權(quán)（即綁定你的 1688 采購(gòu)賬號(hào)），通過(guò) OAuth2.0 獲取access_token（有效期 24 小時(shí)，需定時(shí)刷新）：

引導(dǎo)用戶訪問(wèn)授權(quán)鏈接：

plaintext

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

用戶授權(quán)后，回調(diào)地址會(huì)返回code，用code換取access_token：

bash

運(yùn)行

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=授權(quán)碼&redirect_uri=回調(diào)地址

保存access_token和refresh_token（用于過(guò)期后自動(dòng)刷新）。

二、核心流程：訂單同步全步驟（API 調(diào)用）

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

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

json

{
  "buyer_nick": "采購(gòu)賬號(hào)昵稱(chēng)",
  "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,  // 采購(gòu)數(shù)量
      "price": 9.9    // 商品單價(jià)（需與1688供應(yīng)商報(bào)價(jià)一致）
    }
  ],
  "payment_type": "online",  // 支付方式：online/ offline
  "remark": "加急發(fā)貨"       // 訂單備注
}

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

這是「訂單同步」的核心接口，將自有平臺(tái)訂單轉(zhuǎn)為 1688 官方采購(gòu)單。

1. 接口基礎(chǔ)信息

請(qǐng)求地址：https://gw.open.1688.com/openapi/param2/1/alibaba.order/create

請(qǐng)求方式：POST

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

頻率限制：?jiǎn)螒?yīng)用 QPS≤5，日調(diào)用≤1000 次

2. Python 調(diào)用示例（含簽名 + 驗(yàn)簽）

python

運(yùn)行

import requests
import hashlib
import time
import json

# 配置信息（替換為你的實(shí)際值）
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采購(gòu)訂單"""
    # 1. 構(gòu)造公共參數(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. 構(gòu)造業(yè)務(wù)參數(shù)（需轉(zhuǎn)為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請(qǐng)求
    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

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

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

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

python

運(yùn)行

# 簡(jiǎn)化示例（核心參數(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ā)送請(qǐng)求并解析狀態(tài)（paid/ shipped/ received）

同步物流軌跡：供應(yīng)商發(fā)貨后，調(diào)用alibaba.logistics.trace獲取物流單號(hào)和軌跡，回傳至自有平臺(tái)：

python

運(yùn)行

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ù)
    }
    # 解析返回的物流軌跡（快遞公司、單號(hào)、節(jié)點(diǎn)信息）

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

買(mǎi)家確認(rèn)收貨后，調(diào)用alibaba.trade.receive完成訂單閉環(huán)；

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

三、關(guān)鍵避坑點(diǎn)（新手必看）

簽名錯(cuò)誤：

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

時(shí)間戳為 13 位毫秒級(jí)，避免請(qǐng)求過(guò)期。

權(quán)限問(wèn)題：

訂單接口僅對(duì)企業(yè)認(rèn)證賬號(hào)開(kāi)放，個(gè)人賬號(hào)調(diào)用會(huì)返回 403；

需確保access_token未過(guò)期（建議每 23 小時(shí)刷新一次）。

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

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

單價(jià)需與供應(yīng)商報(bào)價(jià)匹配，避免價(jià)格異常導(dǎo)致訂單被攔截。

限流處理：

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

四、替代方案（無(wú)代碼 / 低代碼）

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

工具推薦：店小秘、通途、牽牛分銷(xiāo)助手；

操作流程：

綁定 1688 賬號(hào)和自有電商平臺(tái)（淘寶 / 抖音等）；

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

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

總結(jié)

1688 訂單同步的核心是通過(guò)alibaba.order.create接口將自有訂單轉(zhuǎn)為 1688 采購(gòu)單，需先完成開(kāi)放平臺(tái)認(rèn)證、權(quán)限申請(qǐng)和 OAuth 授權(quán)。

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

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

審核編輯 黃宇