入門指南：利用 Shopify Draft Order API 創建和管理草稿訂單

開發環境設置

要開始使用Draft Order API，開發者需要設置相應的開發環境。這包括註冊和獲取API金鑰，配置開發工具，以及確保網絡連接穩定。通常，開發者可以通過官方文檔或開發者社區獲取相關的資源和指南。

現在如何拿到金鑰，就照著圖片的只是一步步操作，如果有任何問題也可以隨時看官方文檔（Create an app）！

1. 創建一個開發者app，並給予app名字

2. 開啟app想要使用的權限，現在我們開始draft order的權限

3. 安裝app

現在每個步驟都完成了，你會有這幾個重要的資訊API access token , API key,API secret key 。

發送和處理 API 請求

一旦開發環境設置完成，開發者就可以開始發送API請求。這些請求包括創建、編輯、查詢和刪除草稿訂單等操作。開發者需要熟悉API端點和請求格式，現在我們就來發送第一個新增Draft Order的吧！

準備 Postman，使用以下 URL 創建一個新的 POST 請求：

https://{API_key}:{admin_API_access_token}@{shop}.myshopify.com/admin/api/{api-version}/{resource}.json


{API_key} - 您生成的 API 金鑰。
{admin_API_access_token} - 您生成的管理員 API 訪問令牌。
{shop} - 您的開發商店的名稱。
{api-version} - 您想要使用的支持的 API 版本。
{resource} - 來自 REST 管理 API 的資源端點。

在 Postman 中要傳輸的body，可以在主體部分(body)，點擊原始(raw) → 選擇 JSON，然後輸入代碼。

以下是一個最基本的 body 範例，可以依據需求增添想要創建的 Draft Order 內容。

{
    "draft_order": {
        "line_items": [{
            "variant_id": 44901956681980,
            "quantity": 1
        }]
    }
}

以下為另一個比較複雜的案例：

{
    "draft_order": {
        "email":"zxcdd@gmail.com",
        "line_items": [{
            "variant_id": 44901956681980,
            "quantity": 1
        }], 
        "shipping_address":{
            "first_name":"Bob",
            "last_name":"Norman",
            "address1":"123 Main St",
            "phone":"555-555-5555"},
       "note_attributes": [
            {
                "name": "discord id",
                "value": "zx7"
            }
        ],
        "tags":"zxcdd@gmail.com"
    }
}

Ps. variant_id 指的是商品的 ID 唷，variant指的是你商品的各種分類，所以要找到對應分類的商品 ID 唷！

以下是如何找variant_id 的指示圖，從 product → 商品 →點選variant就可以進來這個畫面。

草稿訂單的管理與更新

一旦草稿訂單創建完成，開發者還需要能夠有效地管理和更新這些訂單。這可能包括查詢現有的草稿訂單、更改訂單細節、添加或刪除產品等。

現在我們就可以到商店的 Orders→Drafts 查看我們的訂單，會在最上面看到創建的時間跟資訊。

如果有東西沒有上傳到 Draft Order 也沒關係，可以透過後來進行編輯與修改，也可以刪除不要的Draft Order 。

正如您所看到的，Draft Order 草稿訂單已成功創建。

以上是使用 Postman 與 Shopify API 創建草稿訂單的所有步驟。如果您有任何問題，歡迎在下面評論，或參考我們的其他文章，此外，您可以在開發者文檔中查看更多 Shopify API 文檔（Shopify Draft Order API ）。

結語

Draft Order API為電子商務平台提供了更靈活和自動化的訂單管理解決方案，通過深入了解API的功能和使用方法，開發者可以更好地利用這一功能，提高平台的效率和用戶體驗，為自己的商店定製訂單！

-->

Draft Order API 簡介

草稿訂單是當客戶有購買意願但尚未付款時，店主可以為其建立的訂單初稿。這是由店主代替客戶創建的訂單，而非客戶自行創建的訂單！草稿訂單本質上是一份暫時的發票，讓商家在訂單最終確認之前，能夠先列出客戶的訂單詳情。這對於處理透過傳統線上商店以外管道的訂單非常有幫助，例如電話訂單、電子郵件邀請或活動現場面對面的訂單。

在當今的網路購物時代，電子商務平台越來越受到大眾的喜愛，而訂單管理系統則是這些平台必不可少的核心功能之一。为了提供店家更簡便、靈活的訂單管理方式，許多平台紛紛開發出了稱為 Draft Order API 的功能。

Draft Order API 是一種應用程式接口（API），透過此 API，開發者能於訂單管理系統中創建、編輯、管理被稱為「草稿訂單」的初階訂單，與此同時，開發者透過程式化的操作方式，不僅提升了訂單處理的效率，更增添了管理訂單的靈活度。

草稿訂單 (Draft Order)，指的是當消費者決定要購買特定商品，但尚未完成付款動作時，店家可以先行建立的訂單的初步版本，這不是由消費者自己建立的訂單，而是由店家為消費者建的，草稿訂單基本上可以視為是一份初步的發票，他讓商家可以在最終確認訂單前，先對客戶訂單的細節做一次總結。

接著進入我們今次的使用情境。今天我們想做一個抽獎，當店家希望從客戶那裡獲取更多的資料時，可能會要求客戶進一步留下資料，一旦這些資料被提交，我們的系統將自動將這些資訊轉化為一個草稿訂單，然後轉入後台儲存，之後，店家能夠在後台進行人工篩選，選定哪些客戶將會收到 Shopify 的發票，繼續藉由 Draft Order API，店家能靈活、效率地修改訂單資訊、進行訂單管理。

開發環境設置

現在如何拿到金鑰，就照著圖片的只是一步步操作，如果有任何問題也可以隨時看官方文檔（Create an app）！

1. 創建一個開發者app，並給予app名字

2. 開啟app想要使用的權限，現在我們開始draft order的權限

3. 安裝app

現在每個步驟都完成了，你會有這幾個重要的資訊API access token , API key,API secret key 。

發送和處理 API 請求

準備 Postman，使用以下 URL 創建一個新的 POST 請求：

https://{API_key}:{admin_API_access_token}@{shop}.myshopify.com/admin/api/{api-version}/{resource}.json


{API_key} - 您生成的 API 金鑰。
{admin_API_access_token} - 您生成的管理員 API 訪問令牌。
{shop} - 您的開發商店的名稱。
{api-version} - 您想要使用的支持的 API 版本。
{resource} - 來自 REST 管理 API 的資源端點。

在 Postman 中要傳輸的body，可以在主體部分(body)，點擊原始(raw) → 選擇 JSON，然後輸入代碼。

以下是一個最基本的 body 範例，可以依據需求增添想要創建的 Draft Order 內容。

{
    "draft_order": {
        "line_items": [{
            "variant_id": 44901956681980,
            "quantity": 1
        }]
    }
}

以下為另一個比較複雜的案例：

{
    "draft_order": {
        "email":"zxcdd@gmail.com",
        "line_items": [{
            "variant_id": 44901956681980,
            "quantity": 1
        }], 
        "shipping_address":{
            "first_name":"Bob",
            "last_name":"Norman",
            "address1":"123 Main St",
            "phone":"555-555-5555"},
       "note_attributes": [
            {
                "name": "discord id",
                "value": "zx7"
            }
        ],
        "tags":"zxcdd@gmail.com"
    }
}

Ps. variant_id 指的是商品的 ID 唷，variant指的是你商品的各種分類，所以要找到對應分類的商品 ID 唷！

以下是如何找variant_id 的指示圖，從 product → 商品 →點選variant就可以進來這個畫面。

草稿訂單的管理與更新

一旦草稿訂單創建完成，開發者還需要能夠有效地管理和更新這些訂單。這可能包括查詢現有的草稿訂單、更改訂單細節、添加或刪除產品等。

現在我們就可以到商店的 Orders→Drafts 查看我們的訂單，會在最上面看到創建的時間跟資訊。

如果有東西沒有上傳到 Draft Order 也沒關係，可以透過後來進行編輯與修改，也可以刪除不要的Draft Order 。

正如您所看到的，Draft Order 草稿訂單已成功創建。

Cart 0

No more products available for purchase

開發環境設置

發送和處理 API 請求

草稿訂單的管理與更新

結語

Draft Order API 簡介

開發環境設置

發送和處理 API 請求

草稿訂單的管理與更新

結語

Leave a comment