Skip to content

Xem danh sách đơn hàng

API : /api/integration/order.json

Method: GET

Request Header

keyvalue
X-pawdo-access-tokenAPI KEY

Query params (optional)

keytypenote
searchstringorder_number | order_code
fulfillment_statusstringunfulfilled|on_hold|ready|payment_awaiting|paid|pending|awaiting|processing|ship-out|delivered|pickup|exception|cancel|cancel-produce|cancel-ship|error
is_have_ticketbooltrue|false
is_shippingbooltrue|false
address_statusstringpending|valid|invalid|exception|unavailable
design_statusstringmissing|invalid_dim|error|incompleted|completed
tracking_statusstringmissing|incompleted|completed
start_timetime.TimeISO-8601
end_timetime.TimeISO-8601
start_time_shiptime.TimeISO-8601
end_time_shiptime.TimeISO-8601
filterstringsystem_warning_pending|system_warning_processing|system_warning_shipout
limitintdefault 10
pageintdefault 1

Example (Response)

json
{
  "message": "Success",
  "orders": [
    {
      "id": "21f4b47f-***-aee4-d2fa08889d9a",
      "created_at": "2026-02-12T16:47:42.064748+07:00",
      "updated_at": "2026-02-12T17:41:29.885613+07:00",
      "store_id": "349d524a-***-82a1-1afb49ca1d77",
      "external_order_id": "",
      "order_number": "bd-053",
      "order_code": "PD6-0077",
      "shipping_address": {
        "city": "Las Vegas",
        "name": "example",
        "email": "[email protected]",
        "state": "Nevada",
        "country": "United States of America",
        "address1": "1234 S Street",
        "postal_code": "89109",
        "country_code": "us",
        "province_code": "NV",
        "option_ship": "standard"
      },
      "design_status": "error",
      "validate_address": "pending",
      "fulfillment_status": "unfulfilled",
      "tracking_status": "incompleted",
      "fulfillment_type": "pod",

      "metadata": null,
      "is_have_ticket": true,
      "skip_verify_address": false,
      "fulfillment_cost": 50,
      "total_revenue": 0,
      "note": "",
      "request_fulfill_at": "2026-04-03T09:03:39.019041Z",
      "processed_at": "2026-04-03T09:03:18.28489Z",
      "fulfillment_cost_paid": "2026-04-03T09:03:33.359155Z",
      "cancel_at": "2026-04-06T09:52:01.197877Z",
      "push_at": "2026-04-03T09:03:22.565417Z",
      "tracking_status_updated_at": null,
      "address_validate_message": "",
      "design_validate_message": "",
      "region_validate": "us",
      "source_type": "",
      "seller_code": "PD-SELL-001",
      "total_weight_gram": 500,
      "packages": null,
      "has_packages": true,
      "has_error_item": false,
      "fulfillment_shipping": 0,
      "base_cost": 50,
      "external_transaction_id": ""
    }
  ],
  "status": true,
  "total": 77
}

Xem chi tiết đơn hàng

API : /api/integration/orders/query.json

Method: GET

Request Header

keyvalue
X-pawdo-access-tokenAPI KEY

Query params

keytypenote
iduuid(optional) ID nội bộ của order
order_namestring(optional)

Lưu ý

  • Request phải có ít nhất 1 trong 2 param: id hoặc order_name. Nếu không sẽ trả lỗi: either order id or order name is required.

Example (Response)

json
{
  "data": {
    "id": "b9a255e8-***-9a5d-59a1be77959a",
    "created_at": "2026-03-04T03:59:16.120299Z",
    "updated_at": "2026-03-04T04:02:45.539479Z",
    "store_id": "89090309-***-8743-6afeecb44b95", 
    "external_order_id": "", 
    "line_items": [
      {
        "id": "a86cad8e-***-b448-adb7532d7537",
        "created_at": "2026-03-04T03:59:16.154939Z", 
        "updated_at": "2026-03-04T04:02:36.91231Z", 
        "store_id": "89090309-***-8743-6afeecb44b95", 
        "order_id": "b9a255e8-***-9a5d-59a1be77959a", 
        "external_line_item_id": "REF-ABC-001", 
        "line_item_id_uniq": null, 
        "mockup1": "https://example.com/mockup1.jpg",
        "mockup2": "https://example.com/mockup2.jpg",
        "mockup3": "https://example.com/mockup3.jpg",
        "mockup4": "https://example.com/mockup4.jpg",
        "design1": "https://example.com/design1.jpg",
        "design2": "https://example.com/design2.jpg",
        "design3": "https://example.com/design3.jpg",
        "design4": "https://example.com/design4.jpg",
        "order_number": "#OD1001",
        "type": "",
        "title": "",
        "sku": "QTR-M",
        "system_sku": "QTR-M",
        "quantity": 2,
        "tag": "",
        "option1": "Red",
        "option2": "Medium",
        "option3": "Cotton",
        "gram": 100, 
        "cancelled_at": null, 
        "status": "open", 
        "total_basecost": 20,
        "catalog_variant_id": "b1e02429-***-983d-913424f52c2c", 
        "item_fulfills": [
          {
            "id": "3eab699a-***-a722-85106e60a73d",
            "created_at": "2026-03-04T04:02:34.212215Z", 
            "updated_at": "2026-03-04T04:04:22.11609Z", 
            "store_id": "89090309-***-8743-6afeecb44b95", 
            "order_id": "b9a255e8-***-9a5d-59a1be77959a", 
            "line_item_id": "a86cad8e-***-b448-adb7532d7537", 
            "reference_id2": "3eab699a-***-a722-85106e60a73d", 
            "reference_id": "b9a255e8-***-9a5d-59a1be77959a", 
            "order_name": "PD94-0001",
            "metadata": null, 
            "variant_code": "QTR-M",
            "brand_code": "", 
            "shipping_carrier": "JCW", 
            "quantity": 1,
            "status": "awaiting",
            "cancel_at": null, 
            "created_time": null, 
            "production_at": null, 
            "tracking_status": "", 
            "tracking_update_at": null, 
            "cancel_status": "", 
            "tracking_code": "JCW10000003247", 
            "mockup1": "https://example.com/mockup1.jpg",
            "design1": "https://example.com/design1.jpg",
            "design_sent1": "https://example.com/design1.jpg", 
            "option_ship": "standard",
            "basecost": 10,
            "seller_code": "PD-SELL-001",
            "warehouse_status": "awaiting",
            "group_product": "QTR", 
            "pack_id": 3247, 
            "warehouse_id": 1, 
            "variant_attribute": {
              
              "title": "M",
              "weight": 100,
              "code_info": {
                "x": 0,
                "y": 0,
                "size": 0,
                "angle": 0,
                "quality": 0
              },
              "ship_desc_cn": "餐桌布",
              "ship_desc_en": "Quilted Table Runner",
              "product_types": [
                {
                  "id": 47,
                  "note": "",
                  "title": "hàng thường-clothing",
                  "metadata": {
                    "has_battery": false
                  },
                  "priority": 1,
                  "created_at": "2026-01-15T11:36:57.662045Z",
                  "updated_at": "2026-01-21T04:03:55.739544Z"
                }
              ],
              "dropship_attribute": {}
            },
            "render_status": "done",
            "render_output": {
              
              "started_at": "2026-03-04T04:02:40.354Z",
              "finished_at": "2026-03-04T04:04:21.347Z",
              "output_design1": "https://example.com/out-design1.jpg",
              "pdf_path_design1": "https://example.com/path-design1.pdf"
            },
            "print_id": 15237,
            "fulfillment_type": "pod",
            "purchase_status": "new",
            "mail_status": "" 
          }

        ],
        "system_message": "", 
        "variant_id": null, 
        "is_custom_sku": false,
        "note": "Please print logo on front side."
      }

    ],
    "shipping_address": {
      "tax": 1.5, 
      "city": "Corryton",
      "name": "John Doe",
      "email": "[email protected]",
      "phone": "",
      "state": "Tennessee",
      "country": "United States",
      "address1": "1234 Whisper Ridge Lane",
      "address2": "4321 Whisper Ridge Lane",
      "label_ship": "https://example.com/...",
      "option_ship": "standard",
      "postal_code": "37721",
      "country_code": "US",
      "province_code": "TN"
    },
    "metadata": null, 
    "order_number": "#OD1001",
    "is_have_ticket": false, 
    "design_status": "completed",
    "validate_address": "valid",
    "fulfillment_status": "awaiting",
    "tracking_status": "completed",
    "skip_verify_address": false, 
    "fulfillment_cost": 20, 
    "total_revenue": 0, 
    "note": "",
    "request_fulfill_at": "2026-03-04T04:02:39.866349Z", 
    "processed_at": "2026-03-04T03:59:07.034726Z", 
    "fulfillment_cost_paid": "2026-03-04T04:02:34.189275Z",
    "tracking_status_updated_at": null, 
    "address_validate_message": "", 
    "design_validate_message": "", 
    "region_validate": "US", 
    "order_code": "PD94-0001", 
    "system_fulfillment_status": "", 
    "source_type": "csv", 
    "seller_code": "PD-SELL-001", 
    "total_weight_gram": 200, 
    "packages": null,
    "has_packages": true,
    "has_error_item": false, 
    "fulfillment_type": "pod",
    "fulfillment_shipping": 0, 
    "base_cost": 20, 
    "external_transaction_id": "TXN-123456789" 
   
  },
  "status": true
}

Nếu có bất kỳ vấn đề nào liên quan đến api đơn hàng, vui lòng liên hệ với bộ phận support của Pawdo qua Facebook để được hỗ trợ.