{ "info": { "_postman_id": "adfa2418-5cc2-49a7-8180-1778a14fe11d", "name": "integration", "description": "TEMP_IGNORE", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "_exporter_id": "47157994" }, "item": [ { "name": "integration", "item": [ { "name": "get store info", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "X-pawdo-access-token", "value": "eyJ...", "type": "text" } ], "body": { "mode": "raw", "raw": "" }, "url": { "raw": "{{DOMAIN}}/api/integration/store/info.json", "host": [ "{{DOMAIN}}" ], "path": [ "api", "integration", "store", "info.json" ] }, "description": "### Get store information\n\nLấy thông tin của store hiện tại thông qua Integration API.\n\n---\n\nMethod: GET\n\nURL: \n`{{DOMAIN}}/api/integration/store/info.json`\n\n---\n\nAuthentication\n\nGửi access token trong header:\n\n```\nX-pawdo-access-token: {{pd-access-token}}\n\n ```\n\n---\n\nExample request\n\n``` json\n{\n \"status\": true,\n \"store\": {\n \"id\": \"89090309-8dc5-4b8c-8743-6afeecb44b95\",\n \"created_at\": \"2026-03-04T03:08:42.727806Z\",\n \"updated_at\": \"2026-03-04T03:21:40.017163Z\",\n \"name\": \"Pawdo Store\",\n \"status\": \"active\",\n \"user_id\": \"0ef2c5e3-f146-43e1-98ea-8fcc1bd4e7c2\",\n \"phone\": \"\",\n \"support_email\": \"example@gmail.com\",\n \"time_zone\": \"Africa/Abidjan\",\n \"currency\": \"USD\",\n \"fulfillment_type\": \"pod\",\n \"address\": {\n \"zip\": null,\n \"city\": null,\n \"address\": null,\n \"country\": null,\n \"show_in_footer\": false,\n \"legal_name_of_business\": null\n },\n \"metadata\": {\n \"logo\": null,\n \"banner\": null,\n \"favicon\": null\n },\n \"admin_id\": \"ccd8cbf7-6668-4c7e-9397-42045ddcb51b\",\n \"allow_pick_stock\": false,\n \"is_developer_store\": false,\n \"prefix\": 94,\n \"callback_api\": \"\",\n \"admin\": {\n \"id\": \"0ef2c5e3-f146-43e1-98ea-8fcc1bd4e7c2\",\n \"created_at\": \"2026-01-16T08:14:21.367316Z\",\n \"updated_at\": \"2026-03-09T01:40:52.070469Z\",\n \"name\": \"John Doe\",\n \"email\": \"example@gmail.com\",\n \"phone\": \"\",\n \"status\": \"active\",\n \"avatar\": \"https://example.com/avatar.jpg\",\n \"sso_id\": \"105241007658723394637\",\n \"last_login\": \"2026-03-09T01:40:52.06942Z\"\n }\n }\n}\n\n ```\n\n---" }, "response": [ { "name": "unauthorize", "originalRequest": { "method": "GET", "header": [ { "key": "X-pawdo-access-token", "value": "eyJ...", "type": "text" } ], "url": { "raw": "{{DOMAIN}}/api/integration/store/info.json", "host": [ "{{DOMAIN}}" ], "path": [ "api", "integration", "store", "info.json" ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "Text", "header": [ { "key": "Date", "value": "Tue, 24 Feb 2026 07:43:51 GMT" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Content-Length", "value": "49" }, { "key": "X-Pawdo-Trace-Id", "value": "12f969174ffcc9d93839fe378722ee5b" }, { "key": "X-Ratelimit-Limit", "value": "40" }, { "key": "X-Ratelimit-Remaining", "value": "39" }, { "key": "X-Ratelimit-Reset", "value": "26" } ], "cookie": [], "body": "{\n \"message\": \"signature is invalid\",\n \"status\": false\n}" }, { "name": "success", "originalRequest": { "method": "GET", "header": [ { "key": "X-pawdo-access-token", "value": "eyJ...", "type": "text" } ], "body": { "mode": "raw", "raw": "" }, "url": { "raw": "{{DOMAIN}}/api/integration/store/info.json", "host": [ "{{DOMAIN}}" ], "path": [ "api", "integration", "store", "info.json" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": null, "header": [ { "key": "Date", "value": "Wed, 04 Mar 2026 03:27:31 GMT" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Transfer-Encoding", "value": "chunked" }, { "key": "Connection", "value": "keep-alive" }, { "key": "Server", "value": "cloudflare" }, { "key": "Nel", "value": "{\"report_to\":\"cf-nel\",\"success_fraction\":0.0,\"max_age\":604800}" }, { "key": "X-Pawdo-Trace-Id", "value": "cef89e873b9d6c0f0119fe99c6ebb6bd" }, { "key": "X-Ratelimit-Limit", "value": "40" }, { "key": "X-Ratelimit-Remaining", "value": "39" }, { "key": "X-Ratelimit-Reset", "value": "60" }, { "key": "X-Served-By", "value": "stag-api.pawdo.com" }, { "key": "cf-cache-status", "value": "DYNAMIC" }, { "key": "Report-To", "value": "{\"group\":\"cf-nel\",\"max_age\":604800,\"endpoints\":[{\"url\":\"https://a.nel.cloudflare.com/report/v4?s=Iasihk%2BWneygtMfgl4o41P51LlNmRmfgEnGjuJq9vOOrKXt4P61PLxf34o8SOgvq490EC6mlmNAB57HxpfoDLFoUenjONzMXMIlCdgQluV0SJQ%3D%3D\"}]}" }, { "key": "Content-Encoding", "value": "br" }, { "key": "CF-RAY", "value": "9d6dc91f99c684b8-HKG" }, { "key": "alt-svc", "value": "h3=\":443\"; ma=86400" } ], "cookie": [], "body": "{\n \"status\": true,\n \"store\": {\n \"id\": \"89090309-8dc5-4b8c-8743-6afeecb44b95\",\n \"created_at\": \"2026-03-04T03:08:42.727806Z\",\n \"updated_at\": \"2026-03-04T03:21:40.017163Z\",\n \"name\": \"Pawdo Store\",\n \"status\": \"active\",\n \"user_id\": \"0ef2c5e3-f146-43e1-98ea-8fcc1bd4e7c2\",\n \"phone\": \"\",\n \"support_email\": \"example@gmail.com\",\n \"time_zone\": \"Africa/Abidjan\",\n \"currency\": \"USD\",\n \"fulfillment_type\": \"pod\",\n \"address\": {\n \"zip\": null,\n \"city\": null,\n \"address\": null,\n \"country\": null,\n \"show_in_footer\": false,\n \"legal_name_of_business\": null\n },\n \"metadata\": {\n \"logo\": null,\n \"banner\": null,\n \"favicon\": null\n },\n \"admin_id\": \"ccd8cbf7-6668-4c7e-9397-42045ddcb51b\",\n \"is_developer_store\": false,\n \"prefix\": 94,\n \"callback_api\": \"\",\n \"admin\": {\n \"id\": \"0ef2c5e3-f146-43e1-98ea-8fcc1bd4e7c2\",\n \"created_at\": \"2026-01-16T08:14:21.367316Z\",\n \"updated_at\": \"2026-03-04T03:07:43.902924Z\",\n \"name\": \"John Doe\",\n \"email\": \"example@gmail.com\",\n \"phone\": \"\",\n \"status\": \"active\",\n \"avatar\": \"https://example.com/avatar.png\",\n \"sso_id\": \"105241007658723394637\",\n \"last_login\": \"2026-03-04T03:07:43.901383Z\"\n }\n }\n}" } ] }, { "name": "get orders", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "X-pawdo-access-token", "value": "{{pd-access-token}}", "type": "text" } ], "body": { "mode": "raw", "raw": "" }, "url": { "raw": "{{DOMAIN}}/api/integration/order.json", "host": [ "{{DOMAIN}}" ], "path": [ "api", "integration", "order.json" ], "query": [ { "key": "search", "value": "%23PD0123", "description": "(string)order_number|order_code", "disabled": true }, { "key": "fulfillment_status", "value": "ready", "description": "(string)unfulfilled|on_hold|ready|payment_awaiting|paid|pending|awaiting|processing|ship-out|delivered|pickup|exception", "disabled": true }, { "key": "is_have_ticket", "value": "true", "description": "(bool)", "disabled": true }, { "key": "is_shipping", "value": "true", "description": "(bool)", "disabled": true }, { "key": "address_status", "value": "pending", "description": "(string)pending|valid|invalid|exception|unavailable", "disabled": true }, { "key": "design_status", "value": "missing", "description": "(string)missing|invalid_dim|error|incompleted|completed", "disabled": true }, { "key": "tracking_status", "value": null, "description": "(string)inforeceived|transit|pickup|undelivered|delivered|\texception|expired|notfound|pending", "disabled": true }, { "key": "start_time", "value": "2026-02-02T17:00:00.000Z", "description": "(time.Time)", "disabled": true }, { "key": "end_time", "value": "2026-02-02T17:00:00.000Z", "description": "(time.Time)", "disabled": true }, { "key": "start_time_ship", "value": "2026-02-02T17:00:00.000Z", "description": "(time.Time)", "disabled": true }, { "key": "end_time_ship", "value": "2026-02-02T17:00:00.000Z", "description": "(time.Time)", "disabled": true }, { "key": "filter", "value": null, "description": "(string)system_warning_pending|system_warning_processing|system_warning_shipout", "disabled": true }, { "key": "limit", "value": null, "description": "(int)", "disabled": true }, { "key": "page", "value": null, "description": "(int)", "disabled": true } ] }, "description": "## GET /api/integration/order.json — Lấy danh sách đơn hàng\n\n### Mục đích\n\nEndpoint dùng để **lấy danh sách order** theo nhiều điều kiện lọc (search, trạng thái fulfill, shipping, ticket, address, design, tracking, khoảng thời gian...).\n\n### URL\n\n- `{{DOMAIN}}`/api/integration/order.json\n \n\n### Header\n\n- `X-pawdo-access-token` _(bắt buộc)_: Access token để xác thực.\n \n\n### Query params\n\n> Ghi chú: Tùy hệ thống, một số param có thể là tuỳ chọn. Các param dưới đây được liệt kê theo đúng tên đang sử dụng trong request. \n \n\n- `search` _(optional)(string)_: Từ khoá tìm kiếm. Ví dụ `#PD0123` (order_number|order_code).\n \n- `fulfillment_status` _(optional)(string)_: Trạng thái xử lý fulfill của đơn.(unfulfilled|on_hold|ready|payment_awaiting|paid|pending|awaiting|processing|ship-out|delivered|pickup|exception)\n \n- `is_have_ticket` _(optional)(bool)_: Lọc đơn **có ticket** (`true|false`).\n \n- `is_shipping` _(optional)(bool)_: Lọc đơn **có shipping** (`true|false`).\n \n- `address_status` _(optional)(string)_: Trạng thái địa chỉ (pending|valid|invalid|exception|unavailable).\n \n- `design_status` _(optional)(string)_: Trạng thái thiết kế (missing|invalid_dim|error|incompleted|completed).\n \n- `tracking_status` _(optional)(string)_: Trạng thái tracking.(inforeceived|transit|pickup|undelivered|delivered|exception|expired|notfound|pending)\n \n- `start_time` _(optional)(time.Time)_: Khoảng thời gian (ISO-8601) để lọc theo mốc thời gian nghiệp vụ của order.\n \n- `end_time` _(optional)(time.Time)_: Khoảng thời gian (ISO-8601) để lọc theo mốc thời gian nghiệp vụ của order.\n \n- `start_time_ship` _(optional)(time.Time)_: Khoảng thời gian (ISO-8601) để lọc theo mốc thời gian shipping.\n \n- `end_time_ship` _(optional)(time.Time)_: Khoảng thời gian (ISO-8601) để lọc theo mốc thời gian shipping.\n \n- `filter` _(optional:_ (system_warning_pending|system_warning_processing|system_warning_shipout)\n \n- `page` _(optional)(default:1)_:\n \n- `limit` _(optional)(default:10)_:\n \n\n### Danh sách fulfillment status\n\n| GIÁ TRỊ | MÔ TẢ |\n| --- | --- |\n| `unfulfilled` | Đơn mới import, chưa tác động gì |\n| `on_hold` | Tạm ngưng fulfill để update order info / artwork |\n| `ready` | Đã validate xong artwork, khoá address; không cho đổi order |\n| `payment_awaiting` | Đang chờ thanh toán |\n| `paid` | Đã thanh toán |\n| `pending` | Đang chờ request fulfill |\n| `awaiting` | Đã fulfill thành công |\n| `processing` | Đang xử lý (in production) |\n| `ship-out` | Đơn đã giao cho đơn vị vận chuyển |\n| `delivered` | Đã giao tới khách hàng thành công |\n| `pickup` | Buyer chưa nhận được hàng, cần tới điểm PO của bên vận chuyển để lấy |\n\n### Response\n\n{ \n\"message\": \"Success\", \n\"orders\": \\[ \n{ \n\"id\": \"21f4b47f-e5c7-4e71-aee4-d2fa08889d9a\", \n\"created_at\": \"2026-02-12T16:47:42.064748+07:00\", \n\"updated_at\": \"2026-02-12T17:41:29.885613+07:00\", \n\"store_id\": \"349d524a-5b95-4384-82a1-1afb49ca1d77\", \n\"external_order_id\": \"\", \n\"shipping_address\": { \n\"tax\": 0, \n\"city\": \"Las Vegas\", \n\"name\": \"John Doe\", \n\"email\": \"example@gmail.com\", \n\"phone\": \"\", \n\"state\": \"Nevada\", \n\"country\": \"United States of America\", \n\"address1\": \"3799 S Las Vegas Blvd\", \n\"address2\": \"\", \n\"label_ship\": \"\", \n\"option_ship\": \"standard\", \n\"postal_code\": \"89109\", \n\"country_code\": \"us\", \n\"province_code\": \"NV\" \n}, \n\"metadata\": null, \n\"order_number\": \"bd-053\", \n\"is_have_ticket\": false, \n\"design_status\": \"error\", \n\"validate_address\": \"pending\", \n\"fulfillment_status\": \"unfulfilled\", \n\"tracking_status\": \"incompleted\", \n\"skip_verify_address\": false, \n\"fulfillment_cost\": 0, \n\"total_revenue\": 0, \n\"note\": \"\", \n\"processed_at\": \"2026-02-12T16:47:42.059489+07:00\", \n\"push_at\": \"2026-02-12T17:31:42.953863+07:00\", \n\"tracking_status_updated_at\": null, \n\"fulfillment_service\": \"\", \n\"system_fulfillment_message\": \"\", \n\"address_validate_message\": \"address pending for validation\", \n\"design_validate_message\": \"could not validate artwork specification due to SKU invalidity\", \n\"region_validate\": \"us\", \n\"order_code\": \"PD6-0077\", \n\"history\": null, \n\"system_fulfillment_status\": \"\", \n\"source_type\": \"\", \n\"seller_code\": \"\", \n\"total_weight_gram\": 0, \n\"packages\": null, \n\"has_packages\": false, \n\"has_error_item\": false, \n\"fulfillment_type\": \"pod\", \n\"fulfillment_shipping\": 0, \n\"base_cost\": 0, \n\"external_transaction_id\": \"\", \n\"mail_status\": \"\" \n} \n\\], \n\"status\": true, \n\"total\": 77 \n}" }, "response": [ { "name": "success", "originalRequest": { "method": "GET", "header": [ { "key": "X-pawdo-access-token", "value": "eyJ...", "type": "text" } ], "body": { "mode": "raw", "raw": "" }, "url": { "raw": "{{DOMAIN}}/api/integration/order.json", "host": [ "{{DOMAIN}}" ], "path": [ "api", "integration", "order.json" ], "query": [ { "key": "search", "value": "%23PD0123", "description": "(string)order_number|order_code", "disabled": true }, { "key": "fulfillment_status", "value": "ready", "description": "(string)unfulfilled|on_hold|ready|payment_awaiting|paid|pending|awaiting|processing|ship-out|delivered|pickup|exception", "disabled": true }, { "key": "is_have_ticket", "value": "true", "description": "(bool)", "disabled": true }, { "key": "is_shipping", "value": "true", "description": "(bool)", "disabled": true }, { "key": "address_status", "value": "pending", "description": "(string)pending|valid|invalid|exception|unavailable", "disabled": true }, { "key": "design_status", "value": "missing", "description": "(string)missing|invalid_dim|error|incompleted|completed", "disabled": true }, { "key": "tracking_status", "value": null, "description": "(string)inforeceived|transit|pickup|undelivered|delivered|\texception|expired|notfound|pending", "disabled": true }, { "key": "start_time", "value": "2026-02-02T17:00:00.000Z", "description": "(time.Time)", "disabled": true }, { "key": "end_time", "value": "2026-02-02T17:00:00.000Z", "description": "(time.Time)", "disabled": true }, { "key": "start_time_ship", "value": "2026-02-02T17:00:00.000Z", "description": "(time.Time)", "disabled": true }, { "key": "end_time_ship", "value": "2026-02-02T17:00:00.000Z", "description": "(time.Time)", "disabled": true }, { "key": "filter", "value": null, "description": "(string)system_warning_pending|system_warning_processing|system_warning_shipout", "disabled": true }, { "key": "limit", "value": null, "description": "(int)", "disabled": true }, { "key": "page", "value": null, "description": "(int)", "disabled": true } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": null, "header": [ { "key": "Date", "value": "Wed, 04 Mar 2026 04:05:21 GMT" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Transfer-Encoding", "value": "chunked" }, { "key": "Connection", "value": "keep-alive" }, { "key": "Server", "value": "cloudflare" }, { "key": "Nel", "value": "{\"report_to\":\"cf-nel\",\"success_fraction\":0.0,\"max_age\":604800}" }, { "key": "X-Pawdo-Trace-Id", "value": "21e4513edfb5fb912224f33f7daa0310" }, { "key": "X-Ratelimit-Limit", "value": "40" }, { "key": "X-Ratelimit-Remaining", "value": "39" }, { "key": "X-Ratelimit-Reset", "value": "60" }, { "key": "X-Served-By", "value": "stag-api.pawdo.com" }, { "key": "cf-cache-status", "value": "DYNAMIC" }, { "key": "Report-To", "value": "{\"group\":\"cf-nel\",\"max_age\":604800,\"endpoints\":[{\"url\":\"https://a.nel.cloudflare.com/report/v4?s=oBBPj8OWObE%2FSrZp1QiDru4sykeab%2FWPKMtvRF8x2Ke7N%2B80AVo3WbwVJOZkA6G1ygNil%2F9IdnybbMwsnfdYWPmFPqlP%2B8W0pLXwSHR9uNXONw%3D%3D\"}]}" }, { "key": "Content-Encoding", "value": "br" }, { "key": "CF-RAY", "value": "9d6e0088ea800399-HKG" }, { "key": "alt-svc", "value": "h3=\":443\"; ma=86400" } ], "cookie": [], "body": "{\n \"message\": \"Success\",\n \"orders\": [\n {\n \"id\": \"b9a255e8-ac4a-4b42-9a5d-59a1be77959a\",\n \"created_at\": \"2026-03-04T03:59:16.120299Z\",\n \"updated_at\": \"2026-03-04T04:02:45.539479Z\",\n \"store_id\": \"89090309-8dc5-4b8c-8743-6afeecb44b95\",\n \"external_order_id\": \"\",\n \"shipping_address\": {\n \"tax\": 1.5,\n \"city\": \"Corryton\",\n \"name\": \"John Doe\",\n \"email\": \"test@example.com\",\n \"phone\": \"\",\n \"state\": \"Tennessee\",\n \"country\": \"United States\",\n \"address1\": \"4321 Whisper Ridge Lane\",\n \"address2\": \"1234 Whisper Ridge Lane\",\n \"label_ship\": \"https://example.com/...\",\n \"option_ship\": \"standard\",\n \"postal_code\": \"37721\",\n \"country_code\": \"US\",\n \"province_code\": \"TN\"\n },\n \"metadata\": null,\n \"order_number\": \"#OD1001\",\n \"is_have_ticket\": false,\n \"design_status\": \"completed\",\n \"validate_address\": \"valid\",\n \"fulfillment_status\": \"awaiting\",\n \"tracking_status\": \"completed\",\n \"skip_verify_address\": false,\n \"fulfillment_cost\": 20,\n \"total_revenue\": 0,\n \"note\": \"\",\n \"request_fulfill_at\": \"2026-03-04T04:02:39.866349Z\",\n \"processed_at\": \"2026-03-04T03:59:07.034726Z\",\n \"fulfillment_cost_paid\": \"2026-03-04T04:02:34.189275Z\",\n \"tracking_status_updated_at\": null,\n \"fulfillment_service\": \"\",\n \"system_fulfillment_message\": \"\",\n \"address_validate_message\": \"\",\n \"design_validate_message\": \"\",\n \"region_validate\": \"US\",\n \"order_code\": \"PD94-0001\",\n \"history\": null,\n \"system_fulfillment_status\": \"\",\n \"source_type\": \"csv\",\n \"seller_code\": \"PD-SELL-001\",\n \"total_weight_gram\": 200,\n \"packages\": null,\n \"has_packages\": true,\n \"has_error_item\": false,\n \"fulfillment_type\": \"pod\",\n \"fulfillment_shipping\": 0,\n \"base_cost\": 20,\n \"external_transaction_id\": \"TXN-123456789\",\n \"mail_status\": \"\"\n }\n ],\n \"status\": true,\n \"total\": 1\n}" } ] }, { "name": "get orders query", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "X-pawdo-access-token", "value": "{{pd-access-token}}", "type": "text" } ], "body": { "mode": "raw", "raw": "" }, "url": { "raw": "{{DOMAIN}}/api/integration/orders/query.json?id=6ef955cf-809f-4e35-bd0f-6262d7715222", "host": [ "{{DOMAIN}}" ], "path": [ "api", "integration", "orders", "query.json" ], "query": [ { "key": "order_name", "value": "", "description": "(string)", "disabled": true }, { "key": "id", "value": "6ef955cf-809f-4e35-bd0f-6262d7715222" } ] }, "description": "## GET {{DOMAIN}}/api/integration/orders/query.json — Query đơn hàng theo `id` / `order_name`\n\n### Mục đích\n\nEndpoint dùng để **truy vấn thông tin chi tiết đơn hàng** theo 1 trong 2 tiêu chí:\n\n- `id` (UUID nội bộ của order)\n \n- `order_name` (mã đơn, ví dụ: `PD6-0076`)\n \n\n> Có thể truyền **một trong hai** hoặc **cả hai** tham số để lọc chính xác hơn. \n \n\n---\n\n### URL\n\n- `{{DOMAIN}}`/api/integration/orders/query.json\n \n\n---\n\n### Header\n\n| Tên | Bắt buộc | Kiểu | Mô tả |\n| --- | --- | --- | --- |\n| `X-pawdo-access-token` | required | string | Access token để xác thực request |\n\n---\n\n### Query params\n\n| Param | Bắt buộc | Kiểu | Mô tả |\n| --- | --- | --- | --- |\n| `id` | optional | uuid | ID nội bộ của order. Ví dụ: `72664810-96a6-48be-9745-5dac8c82e767` |\n| `order_name` | optional | string | Mã đơn cần query. **Lưu ý:** phải truyền **giá trị** cho param này (ví dụ `PD6-0076`). |\n\n---\n\n### Response:\n\n---\n\n#### JSON example\n\n``` json\n{\n \"data\": {\n \"id\": \"9d43540c-dd65-430f-b8e5-817c63dc9ec5\",\n \"created_at\": \"2026-03-04T04:19:37.874885Z\",\n \"updated_at\": \"2026-03-04T04:24:55.298386Z\",\n \"store_id\": \"89090309-8dc5-4b8c-8743-6afeecb44b95\",\n \"external_order_id\": \"\",\n \"line_items\": [\n {\n \"id\": \"48ad78ad-1697-40fc-90a3-de78ca438589\",\n \"created_at\": \"2026-03-04T04:19:37.890682Z\",\n \"updated_at\": \"2026-03-04T04:24:48.114923Z\",\n \"store_id\": \"89090309-8dc5-4b8c-8743-6afeecb44b95\",\n \"order_id\": \"9d43540c-dd65-430f-b8e5-817c63dc9ec5\",\n \"external_line_item_id\": \"REF-ABC-001\",\n \"line_item_id_uniq\": null,\n \"mockup1\": \"https://example.com/mockup1.jpg\",\n \"mockup2\": \"\",\n \"mockup3\": \"\",\n \"mockup4\": \"\",\n \"design1\": \"https://example.com/design1.jpg\",\n \"design2\": \"\",\n \"design3\": \"\",\n \"design4\": \"\",\n \"order_number\": \"#OD1002\",\n \"type\": \"\",\n \"title\": \"\",\n \"sku\": \"QTR-M\",\n \"system_sku\": \"QTR-M\",\n \"quantity\": 2,\n \"tag\": \"\",\n \"option1\": \"Red\",\n \"option2\": \"Medium\",\n \"option3\": \"Cotton\",\n \"gram\": 100,\n \"cancelled_at\": null,\n \"status\": \"open\",\n \"total_basecost\": 20,\n \"catalog_variant_id\": \"b1e02429-d826-483a-983d-913424f52c2c\",\n \"item_fulfills\": [\n {\n \"id\": \"33c76ad5-9ad5-46f8-81fb-a9a54e73f441\",\n \"created_at\": \"2026-03-04T04:24:46.075389Z\",\n \"updated_at\": \"2026-03-04T04:24:51.893224Z\",\n \"store_id\": \"89090309-8dc5-4b8c-8743-6afeecb44b95\",\n \"order_id\": \"9d43540c-dd65-430f-b8e5-817c63dc9ec5\",\n \"line_item_id\": \"48ad78ad-1697-40fc-90a3-de78ca438589\",\n \"reference_id2\": \"33c76ad5-9ad5-46f8-81fb-a9a54e73f441\",\n \"reference_id\": \"9d43540c-dd65-430f-b8e5-817c63dc9ec5\",\n \"order_name\": \"PD94-0002\",\n \"metadata\": null,\n \"variant_code\": \"QTR-M\",\n \"brand_code\": \"\",\n \"shipping_carrier\": \"JCW\",\n \"quantity\": 1,\n \"status\": \"awaiting\",\n \"cancel_at\": null,\n \"created_time\": null,\n \"production_at\": null,\n \"tracking_status\": \"\",\n \"tracking_update_at\": null,\n \"cancel_status\": \"\",\n \"tracking_code\": \"JCW10000003248\",\n \"mockup1\": \"https://example.com/mockup1.jpg\",\n \"design1\": \"https://example.com/design1.jpg\",\n \"design_sent1\": \"https://example.com/design1.jpg\",\n \"option_ship\": \"standard\",\n \"basecost\": 10,\n \"seller_code\": \"PD-SELL-001\",\n \"warehouse_status\": \"awaiting\",\n \"group_product\": \"QTR\",\n \"pack_id\": 3248,\n \"warehouse_id\": 1,\n \"variant_attribute\": {\n \"title\": \"M\",\n \"weight\": 100,\n \"code_info\": {\n \"x\": 0,\n \"y\": 0,\n \"size\": 0,\n \"angle\": 0,\n \"quality\": 0\n },\n \"ship_desc_cn\": \"餐桌布\",\n \"ship_desc_en\": \"Quilted Table Runner\",\n \"product_types\": [\n {\n \"id\": 47,\n \"note\": \"\",\n \"title\": \"hàng thường-clothing\",\n \"metadata\": {\n \"has_battery\": false\n },\n \"priority\": 1,\n \"created_at\": \"2026-01-15T11:36:57.662045Z\",\n \"updated_at\": \"2026-01-21T04:03:55.739544Z\"\n }\n ],\n \"dropship_attribute\": {}\n },\n \"render_status\": \"queued\",\n \"render_output\": null,\n \"print_id\": 15245,\n \"fulfillment_type\": \"pod\",\n \"purchase_status\": \"new\"\n },\n {\n \"id\": \"91b2e655-47d6-4ec9-9c6b-a5c2ddb5982e\",\n \"created_at\": \"2026-03-04T04:24:46.075389Z\",\n \"updated_at\": \"2026-03-04T04:24:51.893224Z\",\n \"store_id\": \"89090309-8dc5-4b8c-8743-6afeecb44b95\",\n \"order_id\": \"9d43540c-dd65-430f-b8e5-817c63dc9ec5\",\n \"line_item_id\": \"48ad78ad-1697-40fc-90a3-de78ca438589\",\n \"reference_id2\": \"91b2e655-47d6-4ec9-9c6b-a5c2ddb5982e\",\n \"reference_id\": \"9d43540c-dd65-430f-b8e5-817c63dc9ec5\",\n \"order_name\": \"PD94-0002\",\n \"metadata\": null,\n \"variant_code\": \"QTR-M\",\n \"brand_code\": \"\",\n \"shipping_carrier\": \"JCW\",\n \"quantity\": 1,\n \"status\": \"awaiting\",\n \"cancel_at\": null,\n \"created_time\": null,\n \"production_at\": null,\n \"tracking_status\": \"\",\n \"tracking_update_at\": null,\n \"cancel_status\": \"\",\n \"tracking_code\": \"JCW10000003248\",\n \"mockup1\": \"https://example.com/mockup1.jpg\",\n \"design1\": \"https://example.com/design1.jpg\",\n \"design_sent1\": \"https://example.com/design1.jpg\",\n \"option_ship\": \"standard\",\n \"basecost\": 10,\n \"seller_code\": \"PD-SELL-001\",\n \"warehouse_status\": \"awaiting\",\n \"group_product\": \"QTR\",\n \"pack_id\": 3248,\n \"warehouse_id\": 1,\n \"variant_attribute\": {\n \"title\": \"M\",\n \"weight\": 100,\n \"code_info\": {\n \"x\": 0,\n \"y\": 0,\n \"size\": 0,\n \"angle\": 0,\n \"quality\": 0\n },\n \"ship_desc_cn\": \"餐桌布\",\n \"ship_desc_en\": \"Quilted Table Runner\",\n \"product_types\": [\n {\n \"id\": 47,\n \"note\": \"\",\n \"title\": \"hàng thường-clothing\",\n \"metadata\": {\n \"has_battery\": false\n },\n \"priority\": 1,\n \"created_at\": \"2026-01-15T11:36:57.662045Z\",\n \"updated_at\": \"2026-01-21T04:03:55.739544Z\"\n }\n ],\n \"dropship_attribute\": {}\n },\n \"render_status\": \"queued\",\n \"render_output\": null,\n \"print_id\": 15246,\n \"fulfillment_type\": \"pod\",\n \"purchase_status\": \"new\"\n }\n ],\n \"system_message\": \"\",\n \"variant_id\": null,\n \"is_custom_sku\": false,\n \"note\": \"Please print logo on front side.\"\n }\n ],\n \"shipping_address\": {\n \"tax\": 0,\n \"city\": \"Corryton\",\n \"name\": \"John Doe\",\n \"email\": \"test@example.com\",\n \"phone\": \"\",\n \"state\": \"Tennessee\",\n \"country\": \"United States\",\n \"address1\": \"6056 Whisper Ridge Lane\",\n \"address2\": \"1234 Whisper Ridge Lane\",\n \"label_ship\": \"https://example.com/...\",\n \"option_ship\": \"standard\",\n \"postal_code\": \"37721\",\n \"country_code\": \"US\",\n \"province_code\": \"TN\"\n },\n \"metadata\": null,\n \"order_number\": \"#OD1002\",\n \"is_have_ticket\": false,\n \"design_status\": \"completed\",\n \"validate_address\": \"valid\",\n \"fulfillment_status\": \"awaiting\",\n \"tracking_status\": \"completed\",\n \"skip_verify_address\": false,\n \"fulfillment_cost\": 20,\n \"total_revenue\": 0,\n \"note\": \"\",\n \"request_fulfill_at\": \"2026-03-04T04:24:50.363781Z\",\n \"processed_at\": \"2026-03-04T04:19:37.862429Z\",\n \"fulfillment_cost_paid\": \"2026-03-04T04:24:46.064629Z\",\n \"push_at\": \"2026-03-04T04:24:37.176074Z\",\n \"tracking_status_updated_at\": null,\n \"fulfillment_service\": \"\",\n \"system_fulfillment_message\": \"\",\n \"address_validate_message\": \"\",\n \"design_validate_message\": \"\",\n \"region_validate\": \"US\",\n \"order_code\": \"PD94-0002\",\n \"history\": null,\n \"system_fulfillment_status\": \"\",\n \"source_type\": \"\",\n \"seller_code\": \"PD-SELL-001\",\n \"total_weight_gram\": 200,\n \"packages\": null,\n \"has_packages\": true,\n \"has_error_item\": false,\n \"fulfillment_type\": \"pod\",\n \"fulfillment_shipping\": 0,\n \"base_cost\": 20,\n \"external_transaction_id\": \"\",\n \"mail_status\": \"\"\n },\n \"status\": true\n}\n\n ```" }, "response": [ { "name": "get failed", "originalRequest": { "method": "GET", "header": [ { "key": "X-pawdo-access-token", "value": "eyJ...", "type": "text" } ], "url": { "raw": "{{DOMAIN}}/api/integration/orders/query.json?id=72664810-96a6-48be-9745-5dac8c82e767", "host": [ "{{DOMAIN}}" ], "path": [ "api", "integration", "orders", "query.json" ], "query": [ { "key": "id", "value": "72664810-96a6-48be-9745-5dac8c82e767", "description": "(uuid)" }, { "key": "order_name", "value": null, "description": "(string)", "disabled": true } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Date", "value": "Tue, 24 Feb 2026 08:55:13 GMT" }, { "key": "Content-Type", "value": "application/json", "description": "", "type": "text" }, { "key": "Content-Length", "value": "70" }, { "key": "X-Pawdo-Trace-Id", "value": "f7b4dc7e2cbb9056222ba91874e48d09" }, { "key": "X-Ratelimit-Limit", "value": "40" }, { "key": "X-Ratelimit-Remaining", "value": "37" }, { "key": "X-Ratelimit-Reset", "value": "24" } ], "cookie": [], "body": "{\n \"message\": \"either order id or order name is required\",\n \"status\": false\n}" }, { "name": "success", "originalRequest": { "method": "GET", "header": [ { "key": "X-pawdo-access-token", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpYXQiOjE3NzI1OTM3OTIsInN0b3JlX2lkIjoiODkwOTAzMDktOGRjNS00YjhjLTg3NDMtNmFmZWVjYjQ0Yjk1IiwidXNlcl9pZCI6IjBlZjJjNWUzLWYxNDYtNDNlMS05OGVhLThmY2MxYmQ0ZTdjMiJ9.s-9HbBISlzWjtJ95WhWDdqerq1Vsq3Rc0_qRRucw7Yo", "type": "text" } ], "body": { "mode": "raw", "raw": "" }, "url": { "raw": "{{DOMAIN}}/api/integration/orders/query.json?id=b9a255e8-ac4a-4b42-9a5d-59a1be77959a", "host": [ "{{DOMAIN}}" ], "path": [ "api", "integration", "orders", "query.json" ], "query": [ { "key": "id", "value": "b9a255e8-ac4a-4b42-9a5d-59a1be77959a", "description": "(uuid)" }, { "key": "order_name", "value": null, "description": "(string)", "disabled": true } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": null, "header": [ { "key": "Date", "value": "Wed, 04 Mar 2026 04:07:37 GMT" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Transfer-Encoding", "value": "chunked" }, { "key": "Connection", "value": "keep-alive" }, { "key": "Server", "value": "cloudflare" }, { "key": "Nel", "value": "{\"report_to\":\"cf-nel\",\"success_fraction\":0.0,\"max_age\":604800}" }, { "key": "X-Pawdo-Trace-Id", "value": "81c5afa9dc45352c82b26b63c425501d" }, { "key": "X-Ratelimit-Limit", "value": "40" }, { "key": "X-Ratelimit-Remaining", "value": "38" }, { "key": "X-Ratelimit-Reset", "value": "50" }, { "key": "X-Served-By", "value": "stag-api.pawdo.com" }, { "key": "cf-cache-status", "value": "DYNAMIC" }, { "key": "Report-To", "value": "{\"group\":\"cf-nel\",\"max_age\":604800,\"endpoints\":[{\"url\":\"https://a.nel.cloudflare.com/report/v4?s=i5XkGs4nh97hArZ5y95j7%2FHdwy4jGo8mEh%2Fva1T27ksjDpwi43gq4LOxRrXANu%2FA6E%2BjhmfLRZPeFN7GlWBjUQ7IWitV5ehZ724SzQRO%2BUAMrA%3D%3D\"}]}" }, { "key": "Content-Encoding", "value": "br" }, { "key": "CF-RAY", "value": "9d6e03da9aa1d671-HKG" }, { "key": "alt-svc", "value": "h3=\":443\"; ma=86400" } ], "cookie": [], "body": "{\n \"data\": {\n \"id\": \"b9a255e8-ac4a-4b42-9a5d-59a1be77959a\",\n \"created_at\": \"2026-03-04T03:59:16.120299Z\",\n \"updated_at\": \"2026-03-04T04:02:45.539479Z\",\n \"store_id\": \"89090309-8dc5-4b8c-8743-6afeecb44b95\",\n \"external_order_id\": \"\",\n \"line_items\": [\n {\n \"id\": \"a86cad8e-b0ed-4535-b448-adb7532d7537\",\n \"created_at\": \"2026-03-04T03:59:16.154939Z\",\n \"updated_at\": \"2026-03-04T04:02:36.91231Z\",\n \"store_id\": \"89090309-8dc5-4b8c-8743-6afeecb44b95\",\n \"order_id\": \"b9a255e8-ac4a-4b42-9a5d-59a1be77959a\",\n \"external_line_item_id\": \"REF-ABC-001\",\n \"line_item_id_uniq\": null,\n \"mockup1\": \"https://example.com/mockup1.jpg\",\n \"mockup2\": \"https://example.com/mockup2.jpg\",\n \"mockup3\": \"https://example.com/mockup3.jpg\",\n \"mockup4\": \"https://example.com/mockup4.jpg\",\n \"design1\": \"https://example.com/design1.jpg\",\n \"design2\": \"https://example.com/design2.jpg\",\n \"design3\": \"https://example.com/design3.jpg\",\n \"design4\": \"https://example.com/design4.jpg\",\n \"order_number\": \"#OD1001\",\n \"type\": \"\",\n \"title\": \"\",\n \"sku\": \"QTR-M\",\n \"system_sku\": \"QTR-M\",\n \"quantity\": 2,\n \"tag\": \"\",\n \"option1\": \"Red\",\n \"option2\": \"Medium\",\n \"option3\": \"Cotton\",\n \"gram\": 100,\n \"cancelled_at\": null,\n \"status\": \"open\",\n \"total_basecost\": 20,\n \"catalog_variant_id\": \"b1e02429-d826-483a-983d-913424f52c2c\",\n \"item_fulfills\": [\n {\n \"id\": \"3eab699a-dfce-46b4-a722-85106e60a73d\",\n \"created_at\": \"2026-03-04T04:02:34.212215Z\",\n \"updated_at\": \"2026-03-04T04:04:22.11609Z\",\n \"store_id\": \"89090309-8dc5-4b8c-8743-6afeecb44b95\",\n \"order_id\": \"b9a255e8-ac4a-4b42-9a5d-59a1be77959a\",\n \"line_item_id\": \"a86cad8e-b0ed-4535-b448-adb7532d7537\",\n \"reference_id2\": \"3eab699a-dfce-46b4-a722-85106e60a73d\",\n \"reference_id\": \"b9a255e8-ac4a-4b42-9a5d-59a1be77959a\",\n \"order_name\": \"PD94-0001\",\n \"metadata\": null,\n \"variant_code\": \"QTR-M\",\n \"brand_code\": \"\",\n \"shipping_carrier\": \"JCW\",\n \"quantity\": 1,\n \"status\": \"awaiting\",\n \"cancel_at\": null,\n \"created_time\": null,\n \"production_at\": null,\n \"tracking_status\": \"\",\n \"tracking_update_at\": null,\n \"cancel_status\": \"\",\n \"tracking_code\": \"JCW10000003247\",\n \"mockup1\": \"https://example.com/mockup1.jpg\",\n \"design1\": \"https://example.com/design1.jpg\",\n \"design_sent1\": \"https://example.com/design1.jpg\",\n \"option_ship\": \"standard\",\n \"basecost\": 10,\n \"seller_code\": \"PD-SELL-001\",\n \"warehouse_status\": \"awaiting\",\n \"group_product\": \"QTR\",\n \"pack_id\": 3247,\n \"warehouse_id\": 1,\n \"variant_attribute\": {\n \"title\": \"M\",\n \"weight\": 100,\n \"code_info\": {\n \"x\": 0,\n \"y\": 0,\n \"size\": 0,\n \"angle\": 0,\n \"quality\": 0\n },\n \"ship_desc_cn\": \"餐桌布\",\n \"ship_desc_en\": \"Quilted Table Runner\",\n \"product_types\": [\n {\n \"id\": 47,\n \"note\": \"\",\n \"title\": \"hàng thường-clothing\",\n \"metadata\": {\n \"has_battery\": false\n },\n \"priority\": 1,\n \"created_at\": \"2026-01-15T11:36:57.662045Z\",\n \"updated_at\": \"2026-01-21T04:03:55.739544Z\"\n }\n ],\n \"dropship_attribute\": {}\n },\n \"render_status\": \"done\",\n \"render_output\": {\n \"started_at\": \"2026-03-04T04:02:40.354Z\",\n \"finished_at\": \"2026-03-04T04:04:21.347Z\",\n \"output_design1\": \"https://example.com/out-design1.jpg\",\n \"pdf_path_design1\": \"https://example.com/path-design1.pdf\",\n },\n \"print_id\": 15237,\n \"fulfillment_type\": \"pod\",\n \"purchase_status\": \"new\"\n },\n {\n \"id\": \"6590cbe8-58c5-4466-9666-2242f8bd1fbc\",\n \"created_at\": \"2026-03-04T04:02:34.212215Z\",\n \"updated_at\": \"2026-03-04T04:04:23.626073Z\",\n \"store_id\": \"89090309-8dc5-4b8c-8743-6afeecb44b95\",\n \"order_id\": \"b9a255e8-ac4a-4b42-9a5d-59a1be77959a\",\n \"line_item_id\": \"a86cad8e-b0ed-4535-b448-adb7532d7537\",\n \"reference_id2\": \"6590cbe8-58c5-4466-9666-2242f8bd1fbc\",\n \"reference_id\": \"b9a255e8-ac4a-4b42-9a5d-59a1be77959a\",\n \"order_name\": \"PD94-0001\",\n \"metadata\": null,\n \"variant_code\": \"QTR-M\",\n \"brand_code\": \"\",\n \"shipping_carrier\": \"JCW\",\n \"quantity\": 1,\n \"status\": \"awaiting\",\n \"cancel_at\": null,\n \"created_time\": null,\n \"production_at\": null,\n \"tracking_status\": \"\",\n \"tracking_update_at\": null,\n \"cancel_status\": \"\",\n \"tracking_code\": \"JCW10000003247\",\n \"mockup1\": \"https://example.com/mockup1.jpg\",\n \"design1\": \"https://example.com/design1.jpg\",\n \"design_sent1\": \"https://example.com/design1.jpg\",\n \"option_ship\": \"standard\",\n \"basecost\": 10,\n \"seller_code\": \"PD-SELL-001\",\n \"warehouse_status\": \"awaiting\",\n \"group_product\": \"QTR\",\n \"pack_id\": 3247,\n \"warehouse_id\": 1,\n \"variant_attribute\": {\n \"title\": \"M\",\n \"weight\": 100,\n \"code_info\": {\n \"x\": 0,\n \"y\": 0,\n \"size\": 0,\n \"angle\": 0,\n \"quality\": 0\n },\n \"ship_desc_cn\": \"餐桌布\",\n \"ship_desc_en\": \"Quilted Table Runner\",\n \"product_types\": [\n {\n \"id\": 47,\n \"note\": \"\",\n \"title\": \"hàng thường-clothing\",\n \"metadata\": {\n \"has_battery\": false\n },\n \"priority\": 1,\n \"created_at\": \"2026-01-15T11:36:57.662045Z\",\n \"updated_at\": \"2026-01-21T04:03:55.739544Z\"\n }\n ],\n \"dropship_attribute\": {}\n },\n \"render_status\": \"done\",\n \"render_output\": {\n \"started_at\": \"2026-03-04T04:02:40.359Z\",\n \"finished_at\": \"2026-03-04T04:04:23.585Z\",\n \"output_design1\": \"https://example.com/out-design1.jpg\",\n \"pdf_path_design1\": \"https://example.com/path-design1.pdf\",\n },\n \"print_id\": 15238,\n \"fulfillment_type\": \"pod\",\n \"purchase_status\": \"new\"\n }\n ],\n \"system_message\": \"\",\n \"variant_id\": null,\n \"is_custom_sku\": false,\n \"note\": \"Please print logo on front side.\"\n }\n ],\n \"shipping_address\": {\n \"tax\": 1.5,\n \"city\": \"Corryton\",\n \"name\": \"John Doe\",\n \"email\": \"test@example.com\",\n \"phone\": \"\",\n \"state\": \"Tennessee\",\n \"country\": \"United States\",\n \"address1\": \"1234 Whisper Ridge Lane\",\n \"address2\": \"4321 Whisper Ridge Lane\",\n \"label_ship\": \"https://example.com/...\",\n \"option_ship\": \"standard\",\n \"postal_code\": \"37721\",\n \"country_code\": \"US\",\n \"province_code\": \"TN\"\n },\n \"metadata\": null,\n \"order_number\": \"#OD1001\",\n \"is_have_ticket\": false,\n \"design_status\": \"completed\",\n \"validate_address\": \"valid\",\n \"fulfillment_status\": \"awaiting\",\n \"tracking_status\": \"completed\",\n \"skip_verify_address\": false,\n \"fulfillment_cost\": 20,\n \"total_revenue\": 0,\n \"note\": \"\",\n \"request_fulfill_at\": \"2026-03-04T04:02:39.866349Z\",\n \"processed_at\": \"2026-03-04T03:59:07.034726Z\",\n \"fulfillment_cost_paid\": \"2026-03-04T04:02:34.189275Z\",\n \"tracking_status_updated_at\": null,\n \"fulfillment_service\": \"\",\n \"system_fulfillment_message\": \"\",\n \"address_validate_message\": \"\",\n \"design_validate_message\": \"\",\n \"region_validate\": \"US\",\n \"order_code\": \"PD94-0001\",\n \"history\": null,\n \"system_fulfillment_status\": \"\",\n \"source_type\": \"csv\",\n \"seller_code\": \"PD-SELL-001\",\n \"total_weight_gram\": 200,\n \"packages\": null,\n \"has_packages\": true,\n \"has_error_item\": false,\n \"fulfillment_type\": \"pod\",\n \"fulfillment_shipping\": 0,\n \"base_cost\": 20,\n \"external_transaction_id\": \"TXN-123456789\",\n \"mail_status\": \"\"\n },\n \"status\": true\n}" } ] }, { "name": "import order", "request": { "method": "POST", "header": [ { "key": "X-pawdo-access-token", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpYXQiOjE3NzI1OTM3OTIsInN0b3JlX2lkIjoiODkwOTAzMDktOGRjNS00YjhjLTg3NDMtNmFmZWVjYjQ0Yjk1IiwidXNlcl9pZCI6IjBlZjJjNWUzLWYxNDYtNDNlMS05OGVhLThmY2MxYmQ0ZTdjMiJ9.s-9HbBISlzWjtJ95WhWDdqerq1Vsq3Rc0_qRRucw7Yo", "type": "text" } ], "body": { "mode": "raw", "raw": "{\r\n \"data\": [\r\n {\r\n \"mockup1\": \"https://example.com/mockup1.jpg\",\r\n \"mockup2\": \"https://example.com/mockup2.jpg\",\r\n \"mockup3\": \"https://example.com/mockup3.jpg\",\r\n \"mockup4\": \"https://example.com/mockup4.jpg\",\r\n\r\n \"design1\": \"https://example.com/design1.jpg\",\r\n \"design2\": \"https://example.com/design2.jpg\",\r\n \"design3\": \"https://example.com/design3.jpg\",\r\n \"design4\": \"https://example.com/design4.jpg\",\r\n\r\n \"order_number\": \"#OD1001\",\r\n // \"type\": \"tshirt\",\r\n // \"title\": \"Custom T-Shirt\",\r\n \"sku\": \"QTR-M\",\r\n \"system_sku\": \"QTR-M\",\r\n \"quantity\": 2,\r\n // \"tag\": \"summer-collection\",\r\n\r\n \"option1\": \"Red\",\r\n \"option2\": \"Medium\",\r\n \"option3\": \"Cotton\",\r\n\r\n \"name\": \"John Doe\",\r\n \"option_ship\": \"standard\",\r\n \"label_ship\": \"https://example.com/label_ship.pdf\",\r\n \"address1\": \"6056 Whisper Ridge Lane\",\r\n \"address2\": \"1234 Whisper Ridge Lane\",\r\n \"city\": \"Corryton\",\r\n \"state\": \"Tennessee\",\r\n \"province_code\": \"TN\",\r\n \"country\": \"United States\",\r\n \"country_code\": \"US\",\r\n \"postal_code\": \"37721\",\r\n \"email\": \"test@example.com\",\r\n \"phone\": \"\",\r\n \"tax\": 1.5,\r\n\r\n \"thank_card\": \"Yes\",\r\n \"brand_kit_a5\": \"Included\",\r\n \"brand_kit_a5_clothes\": \"Included\",\r\n \"brand_kit_a6\": \"Not Included\",\r\n \"note\": \"Please print logo on front side.\",\r\n\r\n \"external_transaction_id\": \"TXN-123456789\",\r\n \"reference_id2\": \"REF-ABC-001\"\r\n }\r\n ],\r\n \"note\":\"\"\r\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{DOMAIN}}/api/integration/orders/import.json", "host": [ "{{DOMAIN}}" ], "path": [ "api", "integration", "orders", "import.json" ] }, "description": "## POST `{{DOMAIN}}/api/integration/orders/import.json` — Import đơn hàng\n\n### Mục đích\n\nEndpoint dùng để **import (đẩy) danh sách đơn hàng** từ hệ thống bên ngoài vào hệ thống (theo dạng batch). \nAPI sẽ **validate dữ liệu từng order** trong mảng `data` và trả về kết quả gồm:\n\n- tổng số bản ghi nhận được (`total`)\n \n- số bản ghi hợp lệ (`valid`)\n \n- số bản ghi không hợp lệ (`invalid`)\n \n- danh sách các order lỗi kèm `error` mô tả (`invalid_orders`)\n \n\n---\n\n### Base URL\n\n- `{{DOMAIN}}`\n \n\n---\n\n### Authentication / Header\n\n| Tên | Bắt buộc | Kiểu | Mô tả |\n| --- | --- | --- | --- |\n| `X-pawdo-access-token` | required | string | Access token để xác thực request |\n\nVí dụ:\n\n```\nX-pawdo-access-token: {{access_token}}\n\n ```\n\n---\n\n### Content-Type\n\nRequest body dạng JSON:\n\n```\nContent-Type: application/json\n\n ```\n\n---\n\n## Request Body\n\n### Schema tổng quát\n\n```\n{ \"data\": [ { \"...\": \"order fields\" } ], \"note\": \"\"}\n\n ```\n\n| Field | Bắt buộc | Kiểu | Mô tả |\n| --- | --- | --- | --- |\n| `data` | required | array | Danh sách order/line item cần import |\n| `note` | optional | string | Ghi chú chung cho batch (nếu có) |\n\n---\n\n### Chi tiết từng phần tử trong `data[]`\n\n#### 1) Thông tin sản phẩm / item\n\n| Field | Bắt buộc | Kiểu | Mô tả |\n| --- | --- | --- | --- |\n| `order_number` | recommended | string | Mã đơn phía ngoài (ví dụ: `ORDER-10001`) |\n| `type` | optional | string | Loại sản phẩm (ví dụ: `tshirt`) |\n| `title` | optional | string | Tên sản phẩm |\n| `sku` | optional | string | SKU hiển thị |\n| `system_sku` | optional | string | SKU hệ thống |\n| `quantity` | required | number | Số lượng |\n| `tag` | optional | string | Tag/nhãn phân loại |\n| `option1` / `option2` / `option3` | optional | string | Thuộc tính biến thể (màu/size/chất liệu…) |\n\n#### 2) Mockup / Design URLs\n\n| Field | Bắt buộc | Kiểu | Mô tả |\n| --- | --- | --- | --- |\n| `mockup1..mockup4` | optional | string (url) | Link ảnh mockup |\n| `design1..design4` | optional | string (url) | Link ảnh design |\n\n#### 3) Thông tin người nhận & địa chỉ\n\n| Field | Bắt buộc | Kiểu | Mô tả |\n| --- | --- | --- | --- |\n| `name` | required | string | Tên người nhận |\n| `email` | optional | string | Email người nhận |\n| `phone` | optional | string | SĐT người nhận |\n| `address1` | required | string | Địa chỉ dòng 1 |\n| `address2` | optional | string | Địa chỉ dòng 2 |\n| `city` | required | string | Thành phố |\n| `state` | optional | string | Quận/huyện (hoặc vùng) |\n| `province_code` | optional | string | Mã tỉnh/thành (ví dụ: `HCM`) |\n| `country` | required | string | Quốc gia (ví dụ: `Vietnam`) |\n| `country_code` | required | string | Mã quốc gia (ví dụ: `VN`) |\n| `postal_code` | optional | string | Mã bưu chính |\n\n#### 4) Vận chuyển / thuế / ghi chú\n\n| Field | Bắt buộc | Kiểu | Mô tả |\n| --- | --- | --- | --- |\n| `option_ship` | optional | string | Gói vận chuyển (ví dụ: `standard`) |\n| `label_ship` | optional | string | Mã/nhãn vận chuyển (nếu có). **Lưu ý**: phải đúng định dạng hệ thống yêu cầu, sai sẽ trả lỗi validate |\n| `tax` | optional | number | Thuế |\n| `thank_card` | optional | string | Thông tin thiệp cảm ơn |\n| `brand_kit_a5` / `brand_kit_a5_clothes` / `brand_kit_a6` | optional | string | Tuỳ chọn brand kit |\n| `note` | optional | string | Ghi chú cho từng order/item |\n\n#### 5) Tham chiếu ngoài (idempotency / mapping)\n\n| Field | Bắt buộc | Kiểu | Mô tả |\n| --- | --- | --- | --- |\n| `external_transaction_id` | optional | string | Mã giao dịch ngoài (để đối soát) |\n| `reference_id2` | optional | string | Mã tham chiếu bổ sung |\n\n---\n\n## Example Request\n\n```\ncurl --location '{{DOMAIN}}/api/integration/orders/import.json' \\--header 'Content-Type: application/json' \\--header 'X-pawdo-access-token: {{access_token}}' \\--data '{ \"data\": [ { \"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\": \"ORDER-10001\", \"type\": \"tshirt\", \"title\": \"Custom T-Shirt\", \"sku\": \"TS-RED-M\", \"system_sku\": \"SYS-TS-0001\", \"quantity\": 2, \"tag\": \"summer-collection\", \"option1\": \"Red\", \"option2\": \"Medium\", \"option3\": \"Cotton\", \"name\": \"Nguyen Van A\", \"option_ship\": \"standard\", \"label_ship\": \"123\", \"address1\": \"123 Nguyen Trai\", \"address2\": \"Ward 5\", \"city\": \"Ho Chi Minh\", \"state\": \"District 1\", \"province_code\": \"HCM\", \"country\": \"Vietnam\", \"country_code\": \"VN\", \"postal_code\": \"700000\", \"email\": \"test@example.com\", \"phone\": \"0901234567\", \"tax\": 1.5, \"thank_card\": \"Yes\", \"brand_kit_a5\": \"Included\", \"brand_kit_a5_clothes\": \"Included\", \"brand_kit_a6\": \"Not Included\", \"note\": \"Please print logo on front side.\", \"external_transaction_id\": \"TXN-123456789\", \"reference_id2\": \"REF-ABC-001\" } ], \"note\": \"\"}'\n\n ```\n\n---\n\n## Response\n\n#### Ý nghĩa\n\n- `status`: trạng thái xử lý request (thường `true` nếu server xử lý được batch, dù có item invalid)\n \n- `message`: thông điệp\n \n- `data.total`: tổng số item nhận vào\n \n- `data.valid`: số item hợp lệ\n \n- `data.invalid`: số item không hợp lệ\n \n- `data.invalid_orders[]`: danh sách item lỗi, có field `error`\n \n\n#### Example\n\n```\n{ \"data\": { \"total\": 1, \"valid\": 0, \"invalid\": 1, \"invalid_orders\": [ { \"order_number\": \"ORDER-10001\", \"label_ship\": \"123\", \"error\": \"Invalid data: LabelShip must be a valid ...\" } ] }, \"message\": \"ok\", \"status\": true}\n\n ```\n\n---\n\n## Notes / Validation\n\n- Nếu có item không hợp lệ, API sẽ đưa item đó vào `invalid_orders` và mô tả lỗi ở `error` (ví dụ lỗi liên quan `label_ship`)." }, "response": [ { "name": "invalid label ship", "originalRequest": { "method": "POST", "header": [ { "key": "X-pawdo-access-token", "value": "eyJ...", "type": "text" } ], "body": { "mode": "raw", "raw": "{\r\n \"data\": [\r\n {\r\n \"mockup1\": \"https://example.com/mockup1.jpg\",\r\n \"mockup2\": \"https://example.com/mockup2.jpg\",\r\n \"mockup3\": \"https://example.com/mockup3.jpg\",\r\n \"mockup4\": \"https://example.com/mockup4.jpg\",\r\n\r\n \"design1\": \"https://example.com/design1.jpg\",\r\n \"design2\": \"https://example.com/design2.jpg\",\r\n \"design3\": \"https://example.com/design3.jpg\",\r\n \"design4\": \"https://example.com/design4.jpg\",\r\n\r\n \"order_number\": \"ORDER-10001\",\r\n \"type\": \"tshirt\",\r\n \"title\": \"Custom T-Shirt\",\r\n \"sku\": \"QTR-M\",\r\n \"system_sku\": \"QTR-M\",\r\n \"quantity\": 2,\r\n \"tag\": \"summer-collection\",\r\n\r\n \"option1\": \"Red\",\r\n \"option2\": \"Medium\",\r\n \"option3\": \"Cotton\",\r\n\r\n \"name\": \"Nguyen Van A\",\r\n \"option_ship\": \"standard\",\r\n \"label_ship\": \"123\",\r\n \"address1\": \"123 Nguyen Trai\",\r\n \"address2\": \"Ward 5\",\r\n \"city\": \"Ho Chi Minh\",\r\n \"state\": \"District 1\",\r\n \"province_code\": \"HCM\",\r\n \"country\": \"Vietnam\",\r\n \"country_code\": \"VN\",\r\n \"postal_code\": \"700000\",\r\n \"email\": \"test@example.com\",\r\n \"phone\": \"\",\r\n \"tax\": 1.5,\r\n\r\n \"thank_card\": \"Yes\",\r\n \"brand_kit_a5\": \"Included\",\r\n \"brand_kit_a5_clothes\": \"Included\",\r\n \"brand_kit_a6\": \"Not Included\",\r\n \"note\": \"Please print logo on front side.\",\r\n\r\n \"external_transaction_id\": \"TXN-123456789\",\r\n \"reference_id2\": \"REF-ABC-001\"\r\n }\r\n ],\r\n \"note\":\"\"\r\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{DOMAIN}}/api/integration/orders/import.json", "host": [ "{{DOMAIN}}" ], "path": [ "api", "integration", "orders", "import.json" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Date", "value": "Tue, 24 Feb 2026 09:29:55 GMT" }, { "key": "Content-Type", "value": "application/json", "description": "", "type": "text" }, { "key": "Content-Length", "value": "1228" }, { "key": "X-Pawdo-Trace-Id", "value": "511fd1ce0ce1632709a9c55884d56191" }, { "key": "X-Ratelimit-Limit", "value": "40" }, { "key": "X-Ratelimit-Remaining", "value": "38" }, { "key": "X-Ratelimit-Reset", "value": "10" } ], "cookie": [], "body": "{\n \"data\": {\n \"total\": 1,\n \"valid\": 0,\n \"invalid\": 1,\n \"invalid_orders\": [\n {\n \"mockup1\": \"https://example.com/mockup1.jpg\",\n \"mockup2\": \"https://example.com/mockup2.jpg\",\n \"mockup3\": \"https://example.com/mockup3.jpg\",\n \"mockup4\": \"https://example.com/mockup4.jpg\",\n \"design1\": \"https://example.com/design1.jpg\",\n \"design2\": \"https://example.com/design2.jpg\",\n \"design3\": \"https://example.com/design3.jpg\",\n \"design4\": \"https://example.com/design4.jpg\",\n \"order_number\": \"ORDER-10001\",\n \"type\": \"tshirt\",\n \"title\": \"Custom T-Shirt\",\n \"sku\": \"TS-RED-M\",\n \"system_sku\": \"SYS-TS-0001\",\n \"quantity\": 2,\n \"tag\": \"summer-collection\",\n \"option1\": \"Red\",\n \"option2\": \"Medium\",\n \"option3\": \"Cotton\",\n \"name\": \"Nguyen Van A\",\n \"option_ship\": \"standard\",\n \"label_ship\": \"123\",\n \"address1\": \"123 Nguyen Trai\",\n \"address2\": \"Ward 5\",\n \"city\": \"Ho Chi Minh\",\n \"state\": \"District 1\",\n \"province_code\": \"HCM\",\n \"country\": \"Vietnam\",\n \"country_code\": \"VN\",\n \"postal_code\": \"700000\",\n \"email\": \"test@example.com\",\n \"phone\": \"0901234567\",\n \"tax\": 1.5,\n \"thank_card\": \"Yes\",\n \"brand_kit_a5\": \"Included\",\n \"brand_kit_a5_clothes\": \"Included\",\n \"brand_kit_a6\": \"Not Included\",\n \"note\": \"Please print logo on front side.\",\n \"external_transaction_id\": \"TXN-123456789\",\n \"reference_id2\": \"REF-ABC-001\",\n \"error\": \"Invalid data: LabelShip must be a valid URL\"\n }\n ]\n },\n \"message\": \"ok\",\n \"status\": true\n}" }, { "name": "success", "originalRequest": { "method": "POST", "header": [ { "key": "X-pawdo-access-token", "value": "eyJ...", "type": "text" } ], "body": { "mode": "raw", "raw": "{\r\n \"data\": [\r\n {\r\n \"mockup1\": \"https://example.com/mockup1.jpg\",\r\n \"mockup2\": \"https://example.com/mockup2.jpg\",\r\n \"mockup3\": \"https://example.com/mockup3.jpg\",\r\n \"mockup4\": \"https://example.com/mockup4.jpg\",\r\n\r\n \"design1\": \"https://example.com/design1.jpg\",\r\n \"design2\": \"https://example.com/design2.jpg\",\r\n \"design3\": \"https://example.com/design3.jpg\",\r\n \"design4\": \"https://example.com/design4.jpg\",\r\n\r\n \"order_number\": \"#OD1001\",\r\n \"type\": \"tshirt\",\r\n \"title\": \"Custom T-Shirt\",\r\n \"sku\": \"QTR-M\",\r\n \"system_sku\": \"QTR-M\",\r\n \"quantity\": 2,\r\n \"tag\": \"summer-collection\",\r\n\r\n \"option1\": \"Red\",\r\n \"option2\": \"Medium\",\r\n \"option3\": \"Cotton\",\r\n\r\n \"name\": \"John Doe\",\r\n \"option_ship\": \"standard\",\r\n \"label_ship\": \"https://example.com/...\",\r\n \"address1\": \"4321 Whisper Ridge Lane\",\r\n \"address2\": \"1234 Whisper Ridge Lane\",\r\n \"city\": \"Corryton\",\r\n \"state\": \"Tennessee\",\r\n \"province_code\": \"TN\",\r\n \"country\": \"United States\",\r\n \"country_code\": \"US\",\r\n \"postal_code\": \"37721\",\r\n \"email\": \"test@example.com\",\r\n \"phone\": \"\",\r\n \"tax\": 1.5,\r\n\r\n \"thank_card\": \"Yes\",\r\n \"brand_kit_a5\": \"Included\",\r\n \"brand_kit_a5_clothes\": \"Included\",\r\n \"brand_kit_a6\": \"Not Included\",\r\n \"note\": \"Please print logo on front side.\",\r\n\r\n \"external_transaction_id\": \"TXN-123456789\",\r\n \"reference_id2\": \"REF-ABC-001\"\r\n }\r\n ],\r\n \"note\":\"\"\r\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{DOMAIN}}/api/integration/orders/import.json", "host": [ "{{DOMAIN}}" ], "path": [ "api", "integration", "orders", "import.json" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": null, "header": [ { "key": "Date", "value": "Wed, 04 Mar 2026 03:59:07 GMT" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Transfer-Encoding", "value": "chunked" }, { "key": "Connection", "value": "keep-alive" }, { "key": "Server", "value": "cloudflare" }, { "key": "Nel", "value": "{\"report_to\":\"cf-nel\",\"success_fraction\":0.0,\"max_age\":604800}" }, { "key": "X-Pawdo-Trace-Id", "value": "6b90906ee8ded27d3e0545685cc6c9d1" }, { "key": "X-Ratelimit-Limit", "value": "40" }, { "key": "X-Ratelimit-Remaining", "value": "38" }, { "key": "X-Ratelimit-Reset", "value": "44" }, { "key": "X-Served-By", "value": "stag-api.pawdo.com" }, { "key": "cf-cache-status", "value": "DYNAMIC" }, { "key": "Report-To", "value": "{\"group\":\"cf-nel\",\"max_age\":604800,\"endpoints\":[{\"url\":\"https://a.nel.cloudflare.com/report/v4?s=67n8SbBu%2FI8TkqS47rHY1QqA1PxShkMfNi0IFOVnCzTIuivwKmgu4hQvfivWWn0bp6t1f%2BDTAjjNRMPe0FLBls7UYA8F4aXqtVM3qdhbFTHfwg%3D%3D\"}]}" }, { "key": "Content-Encoding", "value": "br" }, { "key": "CF-RAY", "value": "9d6df764c80cdc87-HKG" }, { "key": "alt-svc", "value": "h3=\":443\"; ma=86400" } ], "cookie": [], "body": "{\n \"data\": {\n \"total\": 1,\n \"valid\": 1,\n \"invalid\": 0,\n \"invalid_orders\": []\n },\n \"status\": true\n}" } ] }, { "name": "create order", "request": { "method": "POST", "header": [ { "key": "X-pawdo-access-token", "value": "{{pd-access-token}}", "type": "text" } ], "body": { "mode": "raw", "raw": "{\r\n \"order_number\": \"#OD1005\", // required, uniq\r\n \"external_transaction_id\": \"TS-9283023922\",\r\n \"skip_verify_address\": true,\r\n \"line_items\": [ // required, <= 500\r\n {\r\n \"sku\": \"\",\r\n \"system_sku\": \"QTR-M\",\r\n \"quantity\": 5, // required, > 0 and < 1000\r\n \"title\": \"\",\r\n \"note\": \"\",\r\n \"mockup1\": \"https://example.com/mockup1.jpg\",\r\n \"mockup2\": \"\",\r\n \"mockup3\": \"\",\r\n \"mockup4\": \"\",\r\n \"design1\": \"https://example.com/design1.jpg\",\r\n \"design2\": \"\",\r\n \"design3\": \"\",\r\n \"design4\": \"\",\r\n \"option1\": \"\",\r\n \"option2\": \"\",\r\n \"option3\": \"\",\r\n \"external_line_item_id\": \"LI-1048273843\"\r\n }\r\n ],\r\n \"address\": { // required\r\n \"tax\": 0,\r\n \"city\": \"Mountain View\",\r\n \"name\": \"John Doe\", // required\r\n \"email\": \"example@gmail.com\",\r\n \"phone\": \"\",\r\n \"state\": \"Alabama\",\r\n \"country\": \"United States of America\",\r\n \"address1\": \"1600 Amphitheatre Parkway\",\r\n \"address2\": \"\",\r\n \"label_ship\": \"\", // url\r\n \"option_ship\": \"standard\", // required\r\n \"postal_code\": \"94043\",\r\n \"country_code\": \"us\", // required\r\n \"province_code\": \"AL\"\r\n }\r\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{DOMAIN}}/api/integration/orders.json", "host": [ "{{DOMAIN}}" ], "path": [ "api", "integration", "orders.json" ] }, "description": "## Create Order\n\nTạo đơn hàng mới trong hệ thống integration.\n\n**Method:** `POST` \n**URL:** `{{DOMAIN}}/api/integration/orders.json`\n\n### Authentication\n\nGửi access token trong header:\n\n```\nX-pawdo-access-token: {{TOKEN}}\n\n ```\n\n### Variables used\n\n- `{{DOMAIN}}` — base domain của API host.\n \n\n### Request body (JSON)\n\nContent-Type: `application/json`\n\n#### Required top-level fields\n\n- `order_number` (string) — **required**, **unique**.\n \n- `line_items` (array) — **required**, max **500** items.\n \n- `address` (object) — **required**.\n \n\n#### Optional top-level fields\n\n- `external_transaction_id` (string)\n \n- `skip_verify_address` (boolean)\n \n\n#### `line_items[]` fields\n\nFor each line item:\n\n- `sku` (string)\n \n- `system_sku` (string)\n \n- `quantity` (number/integer) — **required**, `> 0` and `< 1000`.\n \n- `title` (string)\n \n- `note` (string)\n \n- `mockup1..mockup4` (string, URL)\n \n- `design1..design4` (string, URL)\n \n- `option1..option3` (string)\n \n- `external_line_item_id` (string)\n \n\n#### `address` fields\n\n- `name` (string) — **required**\n \n- `option_ship` (string) — **required** (e.g. `standard`)\n \n- `label_ship` (string)\n \n- `address1` (string)\n \n- `address2` (string)\n \n- `city` (string)\n \n- `province_code` (string)\n \n- `country` (string)\n \n- `country_code` (string) — **required**\n \n- `postal_code` (string)\n \n- `email` (string)\n \n- `phone` (string)\n \n\n### Constraints / validation notes\n\n- `order_number` **unique** (acts as a de-duplication key).\n \n- `line_items` số lượng tối đa `<= 500`.\n \n- Each line item `quantity` must be `> 0` and `< 1000`.\n \n\n### Example request\n\n``` json\n{\n \"order_number\": \"#PD930087\",\n \"external_transaction_id\": \"TS-9283023921\",\n \"skip_verify_address\": true,\n \"line_items\": [\n {\n \"sku\": \"N_POD\",\n \"system_sku\": \"N_POD\",\n \"quantity\": 5,\n \"title\": \"\",\n \"note\": \"\",\n \"mockup1\": \"https://example.com/mockup1.jpg\",\n \"mockup2\": \"\",\n \"mockup3\": \"\",\n \"mockup4\": \"\",\n \"design1\": \"https://example.com/design1.jpg\",\n \"design2\": \"\",\n \"design3\": \"\",\n \"design4\": \"\",\n \"option1\": \"\",\n \"option2\": \"\",\n \"option3\": \"\",\n \"external_line_item_id\": \"LI-1048273842\"\n }\n ],\n \"address\": {\n \"name\": \"John Doe\",\n \"option_ship\": \"standard\",\n \"label_ship\": \"\",\n \"address1\": \"123 Main Street\",\n \"address2\": \"Apartment 4B\",\n \"city\": \"Los Angeles\",\n \"province_code\": \"CA\",\n \"country\": \"United States\",\n \"country_code\": \"US\",\n \"postal_code\": \"90001\",\n \"email\": \"john.doe@example.com\",\n \"phone\": \"+1 213 555 1234\"\n }\n}\n\n ```\n\n### Example success response (200)\n\n``` json\n{\n \"data\": {\n \"order_id\": \"d33e0745-e700-4d49-9fb1-01ac3e5135c3\"\n },\n \"message\": \"ok\",\n \"status\": true\n}\n\n ```\n\n### Idempotency / uniqueness notes\n\n- `order_number` được dùng như **idempotency key**. Nếu gửi lại cùng `order_number`, server có thể từ chối hoặc trả về đơn hàng đã tồn tại tùy theo cách triển khai phía server.\n \n- Hãy đảm bảo `line_items` không vượt quá giới hạn **500 phần tử** để tránh lỗi validation hoặc timeout." }, "response": [ { "name": "create order", "originalRequest": { "method": "POST", "header": [ { "key": "X-pawdo-access-token", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpYXQiOjE3NTg4NzgxOTIsInN0b3JlX2lkIjoiMzQ5ZDUyNGEtNWI5NS00Mzg0LTgyYTEtMWFmYjQ5Y2ExZDc3IiwidXNlcl9pZCI6IjU3MDI1OTAyLWEzYWYtNDQ4MS05NGRiLTg1ZmVlNjY2ZjRkNSJ9.DjQ1tvo8S_mkAg0Z5IsGf3A7OQoFdH8dcmK_L2-0Zfw", "type": "text" } ], "body": { "mode": "raw", "raw": "{\r\n \"order_number\": \"#PD-087\", // required, uniq\r\n \"external_transaction_id\": \"TS-9283023921\",\r\n \"skip_verify_address\": true,\r\n \"line_items\": [ // required, <= 500\r\n {\r\n \"sku\": \"N_POD\",\r\n \"system_sku\": \"N_POD\",\r\n \"quantity\": 5, // required, > 0 and < 1000\r\n \"title\": \"\",\r\n \"note\": \"\",\r\n \"mockup1\": \"https://example.com/mockup1.jpg\",\r\n \"mockup2\": \"\",\r\n \"mockup3\": \"\",\r\n \"mockup4\": \"\",\r\n \"design1\": \"https://example.com/design1.jpg\",\r\n \"design2\": \"\",\r\n \"design3\": \"\",\r\n \"design4\": \"\",\r\n \"option1\": \"\",\r\n \"option2\": \"\",\r\n \"option3\": \"\",\r\n \"external_line_item_id\": \"LI-1048273842\"\r\n }\r\n ],\r\n \"address\": { // required\r\n \"name\": \"John Doe\", // required\r\n \"option_ship\": \"standard\", // required\r\n \"label_ship\": \"\",\r\n \"address1\": \"123 Main Street\",\r\n \"address2\": \"Apartment 4B\",\r\n \"city\": \"Los Angeles\",\r\n \"province_code\": \"CA\",\r\n \"country\": \"United States\",\r\n \"country_code\": \"US\", // required\r\n \"postal_code\": \"90001\",\r\n \"email\": \"john.doe@example.com\",\r\n \"phone\": \"+1 213 555 1234\"\r\n }\r\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{DOMAIN}}/api/integration/orders.json", "host": [ "{{DOMAIN}}" ], "path": [ "api", "integration", "orders.json" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "", "header": [ { "key": "Date", "value": "Fri, 06 Mar 2026 01:59:05 GMT" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Content-Length", "value": "89" }, { "key": "X-Pawdo-Trace-Id", "value": "04afa288e48f6cb057b26e2f1ef7fa70" }, { "key": "X-Ratelimit-Limit", "value": "500" }, { "key": "X-Ratelimit-Remaining", "value": "499" }, { "key": "X-Ratelimit-Reset", "value": "60" } ], "cookie": [ { "expires": "Invalid Date", "domain": "", "path": "" } ], "body": "{\n \"data\": {\n \"order_id\": \"d33e0745-e700-4d49-9fb1-01ac3e5135c3\"\n },\n \"message\": \"ok\",\n \"status\": true\n}" } ] }, { "name": "cancel order", "request": { "method": "PATCH", "header": [ { "key": "X-pawdo-access-token", "value": "{{pd-access-token}}", "type": "text" } ], "body": { "mode": "raw", "raw": "{\r\n \"order_id\":\"b9a255e8-ac4a-4b42-9a5d-59a1be77959a\",\r\n \"lineitem_ids\":[\r\n \"3eab699a-dfce-46b4-a722-85106e60a73d\"\r\n ]\r\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{DOMAIN}}/api/integration/orders/cancel.json", "host": [ "{{DOMAIN}}" ], "path": [ "api", "integration", "orders", "cancel.json" ] }, "description": "## Cancel order (partial / by line items)\n\nHủy đơn hàng (toàn bộ hoặc theo từng line item) thông qua Integration API.\n\n**Method:** `PATCH` \n**URL:** `{{DOMAIN}}/api/integration/orders/cancel.json`\n\n---\n\n## Authentication\n\nEndpoint này yêu cầu access token trong header:\n\n- `X-pawdo-access-token: {{your_access_token}}`\n \n\n---\n\n## Request body\n\nContent-Type: JSON (raw)\n\n| Field | Type | Required | Description |\n| --- | --- | --- | --- |\n| `order_id` | `string` (UUID) | Yes | ID của đơn hàng cần hủy |\n| `lineitem_ids` | `string[]` (UUID array) | No / Optional\\* | Một hoặc nhiều ID của line item cần hủy |\n\n\\*Hành vi phụ thuộc vào cách backend xử lý:\n\n- Nếu **lineitem_ids được truyền vào**: chỉ hủy các line item được chỉ định (hoặc hủy đơn dựa trên các line item đó).\n \n- Nếu **không truyền hoặc để trống**: có thể hủy **toàn bộ đơn hàng**. \n \n \n\n---\n\n## Example request\n\n\\`\\`\\`json \n{ \n\"order_id\": \"425ec1f5-3527-48b0-9acc-4093811a8ced\", \n\"lineitem_ids\": \\[\"c10d3fff-3a6f-488b-90ac-3714a74da0e7\"\\] \n}" }, "response": [ { "name": "success", "originalRequest": { "method": "PATCH", "header": [ { "key": "X-pawdo-access-token", "value": "eyJ...", "type": "text" } ], "body": { "mode": "raw", "raw": "{\r\n \"order_id\":\"b9a255e8-ac4a-4b42-9a5d-59a1be77959a\",\r\n \"lineitem_ids\":[\r\n \"3eab699a-dfce-46b4-a722-85106e60a73d\"\r\n ]\r\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{DOMAIN}}/api/integration/orders/cancel.json", "host": [ "{{DOMAIN}}" ], "path": [ "api", "integration", "orders", "cancel.json" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": null, "header": [ { "key": "Date", "value": "Wed, 04 Mar 2026 04:18:39 GMT" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Transfer-Encoding", "value": "chunked" }, { "key": "Connection", "value": "keep-alive" }, { "key": "Server", "value": "cloudflare" }, { "key": "Nel", "value": "{\"report_to\":\"cf-nel\",\"success_fraction\":0.0,\"max_age\":604800}" }, { "key": "X-Pawdo-Trace-Id", "value": "30cfd2c171b8b05cfc91d7bc7e3c1012" }, { "key": "X-Ratelimit-Limit", "value": "40" }, { "key": "X-Ratelimit-Remaining", "value": "38" }, { "key": "X-Ratelimit-Reset", "value": "45" }, { "key": "X-Served-By", "value": "stag-api.pawdo.com" }, { "key": "cf-cache-status", "value": "DYNAMIC" }, { "key": "Report-To", "value": "{\"group\":\"cf-nel\",\"max_age\":604800,\"endpoints\":[{\"url\":\"https://a.nel.cloudflare.com/report/v4?s=5EhYumX2V7m1%2Bzwv%2BB%2BXQzrCrTIz8d69koUlR5d0%2Bjxb6cSZCt2FKLkGJnb7Cmf0112KRkMBDRMfi32M9CePFAWYhi3O%2BdySL%2BDEGH%2FYZCY%3D\"}]}" }, { "key": "Content-Encoding", "value": "br" }, { "key": "CF-RAY", "value": "9d6e1405b8cfdd32-HKG" }, { "key": "alt-svc", "value": "h3=\":443\"; ma=86400" } ], "cookie": [], "body": "{\n \"message\": \"order cancelled\",\n \"status\": true\n}" } ] }, { "name": "update order", "request": { "method": "PATCH", "header": [ { "key": "X-pawdo-access-token", "value": "{{pd-access-token}}", "type": "text" } ], "body": { "mode": "raw", "raw": "{\r\n \"skip_verify_address\": true,\r\n \"shipping_address\": {\r\n \"tax\": 0,\r\n \"city\": \"Mountain View\",\r\n \"name\": \"John Doe\",\r\n \"email\": \"example@gmail.com\",\r\n \"phone\": \"\",\r\n \"state\": \"Alabama\",\r\n \"country\": \"United States of America\",\r\n \"address1\": \"1600 Amphitheatre Parkway\",\r\n \"address2\": \"\",\r\n \"label_ship\": \"\",\r\n \"option_ship\": \"standard\",\r\n \"postal_code\": \"94043\",\r\n \"country_code\": \"us\",\r\n \"province_code\": \"AL\"\r\n },\r\n \"line_items\": [\r\n {\r\n \"id\": \"371ff573-476a-46b8-8aa6-223f5ff8e736\",\r\n \"sku\": \"\",\r\n \"system_sku\": \"QTR-XS2\",\r\n \"title\": \"no title\",\r\n \"note\": \"bom ne\",\r\n \"mockup1\": \"https://example.com/mockup1.jpg\",\r\n \"mockup2\": \"\",\r\n \"mockup3\": \"\",\r\n \"mockup4\": \"\",\r\n \"design1\": \"https://example.com/design1.jpg\",\r\n \"design2\": \"\",\r\n \"design3\": \"\",\r\n \"design4\": \"\",\r\n \"quantity\": 5\r\n }\r\n ]\r\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{DOMAIN}}/api/integration/orders/:id.json", "host": [ "{{DOMAIN}}" ], "path": [ "api", "integration", "orders", ":id.json" ], "variable": [ { "key": "id", "value": "6ef955cf-809f-4e35-bd0f-6262d7715222" } ] }, "description": "## Update order (PATCH)\n\nCập nhật đơn hàng hiện có (thường là thông tin giao hàng và danh sách sản phẩm) thông qua Integration API.\n\n### Endpoint\n\n`PATCH {{DOMAIN}}/api/integration/orders/:id.json`\n\n### Authentication\n\nGửi access token trong header sau:\n\n- `X-pawdo-access-token: {{pd-access-token}}`\n \n\n### Path parameter\n\n- `id` (string/UUID): ID của đơn hàng cần cập nhật.\n \n\n### Request body (JSON)\n\nTop-level fields:\n\n- `skip_verify_address` (boolean): Khi đặt `true`, hệ thống sẽ bỏ qua hoặc nới lỏng bước kiểm tra địa chỉ (hành vi cụ thể phụ thuộc vào backend).\n \n- `shipping_address` (object): Thông tin địa chỉ giao hàng.\n \n- `line_items` (array of objects): Danh sách sản phẩm trong đơn cần cập nhật.\n \n\n#### `shipping_address` object fields\n\n- `tax` (number/integer)\n \n- `city` (string)\n \n- `name` (string)\n \n- `email` (string)\n \n- `phone` (string)\n \n- `state` (string)\n \n- `country` (string)\n \n- `address1` (string)\n \n- `address2` (string)\n \n- `label_ship` (string)\n \n- `option_ship` (string) (e.g., `standard`)\n \n- `postal_code` (string)\n \n- `country_code` (string) (e.g., `us`)\n \n- `province_code` (string) (e.g., `AL`)\n \n\n#### `line_items[]` item fields\n\n- `id` (string/UUID): Line item identifier.\n \n- `sku` (string)\n \n- `system_sku` (string)\n \n- `title` (string)\n \n- `note` (string)\n \n- `mockup1` (string URL)\n \n- `mockup2` (string URL)\n \n- `mockup3` (string URL)\n \n- `mockup4` (string URL)\n \n- `design1` (string URL)\n \n- `design2` (string URL)\n \n- `design3` (string URL)\n \n- `design4` (string URL)\n \n- `quantity` (number/integer)\n \n\n### Example cURL\n\n``` bash\ncurl --request PATCH \"{{DOMAIN}}/api/integration/orders/:id.json\" \\\n --header \"X-pawdo-access-token: {{pd-access-token}}\" \\\n --header \"Content-Type: application/json\" \\\n --data 'JSON_BODY_HERE'\n\n ```" }, "response": [ { "name": "success", "originalRequest": { "method": "PATCH", "header": [ { "key": "X-pawdo-access-token", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpYXQiOjE3NzI1OTM3OTIsInN0b3JlX2lkIjoiODkwOTAzMDktOGRjNS00YjhjLTg3NDMtNmFmZWVjYjQ0Yjk1IiwidXNlcl9pZCI6IjBlZjJjNWUzLWYxNDYtNDNlMS05OGVhLThmY2MxYmQ0ZTdjMiJ9.s-9HbBISlzWjtJ95WhWDdqerq1Vsq3Rc0_qRRucw7Yo", "type": "text" } ], "body": { "mode": "raw", "raw": "{\r\n \"shipping_address\": {\r\n \"tax\": 1.2,\r\n \"city\": \"Corryton\",\r\n \"name\": \"John Doe\",\r\n \"email\": \"test@example.com\",\r\n \"phone\": \"\",\r\n \"state\": \"Tennessee\",\r\n \"country\": \"United States\",\r\n \"address1\": \"6056 Whisper Ridge Lane\",\r\n \"address2\": \"1234 Whisper Ridge Lane\",\r\n \"label_ship\": \"https://example.com/...\",\r\n \"option_ship\": \"standard\",\r\n \"postal_code\": \"37721\",\r\n \"country_code\": \"US\",\r\n \"province_code\": \"TN\"\r\n },\r\n \"line_item\": [\r\n {\r\n \"id\": \"b6828234-82ec-47df-88f5-9bc9a81b6ba6\",\r\n \"mockup1\": \"https://example.com/mockup1.jpg\",\r\n \"mockup2\": \"\",\r\n \"mockup3\": \"\",\r\n \"mockup4\": \"\",\r\n \"design1\": \"https://example.com/design1.jpg\",\r\n \"design2\": \"\",\r\n \"design3\": \"\",\r\n \"design4\": \"\",\r\n \"quantity\": 13\r\n }\r\n ]\r\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{DOMAIN}}/api/integration/orders/:id.json", "host": [ "{{DOMAIN}}" ], "path": [ "api", "integration", "orders", ":id.json" ], "variable": [ { "key": "id", "value": "6ffb1835-d671-4671-9a3e-aa6d8f096cf1", "description": "6ffb1835-d671-4671-9a3e-aa6d8f096cf1" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": null, "header": [ { "key": "Date", "value": "Wed, 04 Mar 2026 05:01:46 GMT" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Transfer-Encoding", "value": "chunked" }, { "key": "Connection", "value": "keep-alive" }, { "key": "Server", "value": "cloudflare" }, { "key": "Nel", "value": "{\"report_to\":\"cf-nel\",\"success_fraction\":0.0,\"max_age\":604800}" }, { "key": "X-Pawdo-Trace-Id", "value": "b97a3656d1b96245d01a0065a3d54f1f" }, { "key": "X-Ratelimit-Limit", "value": "40" }, { "key": "X-Ratelimit-Remaining", "value": "39" }, { "key": "X-Ratelimit-Reset", "value": "60" }, { "key": "X-Served-By", "value": "stag-api.pawdo.com" }, { "key": "cf-cache-status", "value": "DYNAMIC" }, { "key": "Report-To", "value": "{\"group\":\"cf-nel\",\"max_age\":604800,\"endpoints\":[{\"url\":\"https://a.nel.cloudflare.com/report/v4?s=OsgwSec8H2BumrS8QI6bJjwmDdkDnzJ1uAu1zIZn7N3Dutssp8bO8cv5x%2BCWYIFlP%2BL5LNtPcxAst5lxcWLjYpI8Fml4b%2Fib%2FH2ToA7B21lDLQ%3D%3D\"}]}" }, { "key": "Content-Encoding", "value": "br" }, { "key": "CF-RAY", "value": "9d6e532d397d3eb0-HKG" }, { "key": "alt-svc", "value": "h3=\":443\"; ma=86400" } ], "cookie": [], "body": "{\n \"message\": \"order updated\",\n \"status\": true\n}" } ] } ] } ] }