{"openapi":"3.1.0","info":{"title":"Pancake POS Open API","version":"1.0.0","description":"API documentation for POS system.\n\n## Account Authentication\n\n### Create API Key\n\nGo to website **Setting -> Advance -> Third-party connection -> Webhook/API**. On frame `API KEY`, click `Create`.\n","x-description-i18n":{"vie":"Tài liệu API cho hệ thống POS.\n\n## Xác thực Tài khoản\n\n### Tạo API Key\n\nVào giao diện **Cấu hình -> Nâng cao -> Kết nối bên thứ 3 -> Webhook/API**. Trong khung `API KEY`, click `Thêm mới`.\n"}},"servers":[{"url":"https://pos.pages.fm/api/v1","description":"Production server"}],"paths":{"/shops":{"get":{"summary":"Shop information","x-summary-i18n":{"vie":"Thông tin cửa hàng"},"description":"Get shop information","x-description-i18n":{"vie":"Lấy thông tin cửa hàng"},"tags":["Shop"],"x-tags-i18n":{"vie":["Cửa hàng"]},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"shops":{"type":"array","items":{"type":"object","properties":{"avatar_url":{"type":"string","description":"Avatar image link","x-description-i18n":{"vie":"Link hình đại diện"}},"name":{"type":"string","description":"Shop name","x-description-i18n":{"vie":"Tên cửa hàng"}},"id":{"type":"integer","description":"Shop ID","x-description-i18n":{"vie":"Mã cửa hàng"}},"preferred_shop":{"type":["integer","null"],"description":"User-specific preferred shop rank. Lower values have higher priority","x-description-i18n":{"vie":"Thứ tự ưu tiên cửa hàng của người dùng. Giá trị nhỏ hơn có độ ưu tiên cao hơn"}},"pages":{"type":"array","description":"Pages information in shop","x-description-i18n":{"vie":"Thông tin pages được gộp trong shop"},"items":{"type":"object","properties":{"id":{"type":"string","description":"Page ID","x-description-i18n":{"vie":"Mã trang liên kết"}},"name":{"type":"string","description":"Page name","x-description-i18n":{"vie":"Tên trang"}},"platform":{"type":"string","description":"Platform (e.g., facebook)","x-description-i18n":{"vie":"Nền tảng (ví dụ: facebook)"}},"settings":{"type":"object","description":"Page settings","x-description-i18n":{"vie":"Cài đặt trang"},"properties":{"auto_create_order":{"type":"boolean","description":"Auto create order","x-description-i18n":{"vie":"Tự động tạo đơn"}}}},"shop_id":{"type":"integer","description":"Shop ID","x-description-i18n":{"vie":"Mã cửa hàng"}}}}},"link_post_marketer":{"type":"array","description":"Information of link post / source / AD account with marketer","x-description-i18n":{"vie":"Thông tin liên kết bài viết / nguồn đơn / TK QC với marketer"},"items":{"type":"object","properties":{"ad_account_id":{"type":"string","description":"AD account ID","x-description-i18n":{"vie":"ID tài khoản QC"}},"id":{"type":"string","description":"Link ID","x-description-i18n":{"vie":"ID liên kết"}},"inserted_at":{"type":"string","format":"date-time","description":"Inserted at","x-description-i18n":{"vie":"Thời điểm tạo"}},"marketer":{"type":"string","description":"Marketer ID","x-description-i18n":{"vie":"Mã nhân viên marketer"}},"multiple_post":{"type":"array","description":"Post ID","x-description-i18n":{"vie":"ID bài viết"},"items":{"type":"string"}},"multiple_source":{"type":"array","description":"Source information","x-description-i18n":{"vie":"Thông tin nguồn đơn"},"items":{"type":"object","properties":{"account":{"type":"string","description":"Order source account ID","x-description-i18n":{"vie":"Mã TK nguồn đơn hàng"}},"key":{"type":"string","description":"Key","x-description-i18n":{"vie":"Khóa"}},"page_id":{"type":"string","description":"Facebook page ID","x-description-i18n":{"vie":"Mã Facebook page"}}}}},"shop_id":{"type":"integer","description":"Shop ID","x-description-i18n":{"vie":"Mã cửa hàng"}},"type":{"type":"string","description":"Type of link (post: \"Post\", source: \"Source\", ad_account_id: \"AD account\")","x-description-i18n":{"vie":"Loại liên kết (post: \"Bài viết\", source: \"Nguồn đơn\", ad_account_id: \"Tài khoản quảng cáo\")"}}}}}}}},"success":{"type":"boolean"}}},"examples":{"default":{"value":{"shops":[{"avatar_url":"https://statics.pancake.vn/user-content-dev2.pancake.vn/2022/7/6/8678250807b2285e2752ac2cbbf43925f19a677c.jpeg","name":"Shop thời trang","id":6036602,"link_post_marketer":[{"ad_account_id":null,"id":"949f1396-f6fa-45d9-93b6-4c37503a9950","inserted_at":"2025-08-21T03:02:04","marketer":"cee3c05e-5f85-43c4-b27e-889b99c50097","multiple_post":[],"multiple_source":[{"account":"2284322048329488","key":"-1","page_id":"2284322048329488"}],"shop_id":6036602,"type":"source"}],"pages":[{"id":"104438181227821","name":"Quần áo","platform":"facebook","settings":{"auto_create_order":true},"shop_id":20}]}],"success":true}}}}}}}}},"/geo/provinces":{"get":{"summary":"List of provinces and cities","x-summary-i18n":{"vie":"Danh sách tỉnh thành phố"},"description":"Get list of provinces and cities","x-description-i18n":{"vie":"Lấy danh sách tỉnh thành phố"},"tags":["Address"],"x-tags-i18n":{"vie":["Địa chỉ"]},"parameters":[{"name":"country_code","in":"query","required":true,"schema":{"type":"string","default":"84","example":"84"},"description":"Country code (for example, Vietnam country code is 84)","x-description-i18n":{"vie":"Mã quốc gia (ví dụ mã quốc gia Viet Nam là 84)"},"example":"84"},{"name":"is_new","in":"query","required":false,"schema":{"type":"boolean","default":false,"example":false},"description":"New province (for country Viet Nam)","x-description-i18n":{"vie":"Tỉnh thành mới (với quốc gia Viet Nam)"},"example":false},{"name":"all","in":"query","required":false,"schema":{"type":"boolean","default":false,"example":false},"description":"All provinces including old and new (for country Viet Nam)","x-description-i18n":{"vie":"Tỉnh thành gồm cả cũ và mới (với quốc gia Viet Nam)"},"example":false}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Province ID","x-description-i18n":{"vie":"Mã tỉnh thành phố"}},"name":{"type":"string","description":"Province name","x-description-i18n":{"vie":"Tên tỉnh thành"}},"name_en":{"type":"string","description":"Province name in English","x-description-i18n":{"vie":"Tên tiếng Anh"}},"new_id":{"type":"string","description":"New province ID (for country Viet Nam)","x-description-i18n":{"vie":"Mã tỉnh thành mới (với quốc gia Viet Nam)"}}}}}}},"examples":{"default":{"value":{"data":[{"id":"101","name":"Hà Nội","name_en":"ha noi","new_id":"84_VN101"},{"id":"701","name":"Hồ Chí Minh","name_en":"ho chi minh","new_id":"84_VN129"}]}}}}}}}}},"/geo/districts":{"get":{"summary":"List of districts","x-summary-i18n":{"vie":"Danh sách quận huyện"},"description":"Get list of districts","x-description-i18n":{"vie":"Lấy danh sách quận huyện"},"tags":["Address"],"x-tags-i18n":{"vie":["Địa chỉ"]},"parameters":[{"name":"province_id","in":"query","required":true,"schema":{"type":"string","example":"101"},"description":"Province ID of districts you want to retrieve. Get province ID in api GET /geo/provinces","x-description-i18n":{"vie":"Mã tỉnh thành phố của các quận huyện bạn muốn lấy. Lấy mã tỉnh thành phố trong api GET /geo/provinces"},"example":"101"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"District ID","x-description-i18n":{"vie":"Mã quận huyện"}},"name":{"type":"string","description":"District name","x-description-i18n":{"vie":"Tên quận huyện"}},"name_en":{"type":"string","description":"District name in English","x-description-i18n":{"vie":"Tên tiếng Anh"}},"province_id":{"type":"string","description":"Province ID","x-description-i18n":{"vie":"Mã tỉnh thành phố"}}}}}}},"examples":{"default":{"value":{"data":[{"id":"10101","name":"Quận Ba Đình","name_en":"ba dinh","province_id":"101"}]}}}}}}}}},"/geo/communes":{"get":{"summary":"List of communes","x-summary-i18n":{"vie":"Danh sách phường xã"},"description":"Get list of communes","x-description-i18n":{"vie":"Lấy danh sách phường xã"},"tags":["Address"],"x-tags-i18n":{"vie":["Địa chỉ"]},"parameters":[{"name":"district_id","in":"query","required":true,"schema":{"type":"string"},"description":"District ID of communes you want to retrieve. Get district ID in api GET /geo/districts","x-description-i18n":{"vie":"Mã quận huyện của các phường xã bạn muốn lấy. Lấy mã quận huyện trong api GET /geo/districts"},"example":"10101"},{"name":"province_id","in":"query","required":true,"schema":{"type":"string"},"description":"Province ID of communes you want to retrieve. Get province ID in api GET /geo/provinces","x-description-i18n":{"vie":"Mã tỉnh thành phố của các phường xã bạn muốn lấy. Lấy mã tỉnh thành phố trong api GET /geo/provinces"},"example":"101"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Commune ID","x-description-i18n":{"vie":"Mã phường xã"}},"name":{"type":"string","description":"Commune name","x-description-i18n":{"vie":"Tên xã phường"}},"name_en":{"type":"string","description":"Commune name in English","x-description-i18n":{"vie":"Tên tiếng Anh"}},"district_id":{"type":"string","description":"District ID","x-description-i18n":{"vie":"Mã quận huyện"}},"province_id":{"type":"string","description":"Province ID","x-description-i18n":{"vie":"Mã tỉnh thành phố"}},"new_id":{"type":"string","description":"New commune/ward ID (for country Viet Nam)","x-description-i18n":{"vie":"Mã xã phường mới (với quốc gia Viet Nam)"}},"postcode":{"type":"string","description":"Postal code","x-description-i18n":{"vie":"Mã bưu điện"}}}}}}},"examples":{"default":{"value":{"data":[{"district_id":"10101","id":"1010115","name":"Phường Cống Vị","name_en":"cong vi","new_id":null,"postcode":null,"province_id":"101"}]}}}}}}}}},"/shops/{SHOP_ID}/warehouses":{"get":{"summary":"Warehouse list","x-summary-i18n":{"vie":"Danh sách kho hàng"},"description":"Get list of warehouses","x-description-i18n":{"vie":"Lấy danh sách kho hàng"},"tags":["Warehouse"],"x-tags-i18n":{"vie":["Kho hàng"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","description":"Warehouses list","x-description-i18n":{"vie":"Danh sách kho hàng"},"properties":{"data":{"type":"array","description":"List of warehouses","x-description-i18n":{"vie":"Danh sách kho hàng"},"items":{"$ref":"#/components/schemas/Warehouse"}}}},"examples":{"default":{"value":{"data":[{"id":"b4cb5897-6e56-4581-96cc-2f12677c7bd8","name":"kho test ecod","address":"hâhhha","full_address":"hâhhha, Xã Bình Trung, Huyện Châu Đức, Bà Rịa-Vũng Tàu","phone_number":"0999999999","province_id":"717","district_id":"71705","commune_id":"7170510","country_code":"84","shop_id":26290,"allow_create_order":true,"custom_id":null,"affiliate_shop_id":26290,"affiliate_warehouse":"Kho gia dụng"},{"id":"644b0063-e9a8-43cd-ba08-66a8066d462e","name":"kho 2","address":"19/349 Minh Khai , Hai bà Trưng, Hà Nội","full_address":"19/349 Minh Khai , Hai bà Trưng, Hà Nội, Phường Minh Khai, Quận Hai Bà Trưng, Hà Nội","phone_number":"01655809949","province_id":"101","district_id":"10107","commune_id":"1010735","country_code":"84","shop_id":26290,"allow_create_order":false,"custom_id":null}]}}}}}}}},"post":{"summary":"Create warehouse","x-summary-i18n":{"vie":"Tạo kho hàng"},"description":"Create warehouses","x-description-i18n":{"vie":"Tạo kho hàng"},"tags":["Warehouse"],"x-tags-i18n":{"vie":["Kho hàng"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name","shelf_config"],"properties":{"name":{"type":"string","description":"Warehouse name","x-description-i18n":{"vie":"Tên kho hàng"}},"address":{"type":"string","description":"Warehouse address","x-description-i18n":{"vie":"Địa chỉ chi tiết kho hàng(số nhà, đường, ...)"}},"phone_number":{"type":"string","description":"Warehouse phone number","x-description-i18n":{"vie":"Số điện thoại kho hàng"}},"province_id":{"type":"string","description":"Province ID. Get by API GET /geo/provinces","x-description-i18n":{"vie":"Mã tỉnh thành phố. Lấy từ API GET /geo/provinces"}},"district_id":{"type":"string","description":"District ID. Get by API GET /geo/districts","x-description-i18n":{"vie":"Mã quận huyện. Lấy từ API GET /geo/districts"}},"commune_id":{"type":"string","description":"Commune ID. Get by API GET /geo/communes","x-description-i18n":{"vie":"Mã phường xã. Lấy từ API GET /geo/communes"}},"country_code":{"type":"string","description":"Country code","x-description-i18n":{"vie":"Mã quốc gia"}},"shelf_config":{"type":"object","description":"Shelf config","x-description-i18n":{"vie":"Cấu hình kệ"},"properties":{"col":{"type":"string","description":"Column","x-description-i18n":{"vie":"Cột"}}}},"batch_config":{"type":"object","description":"Batch config","x-description-i18n":{"vie":"Cấu hình lô"},"properties":{"col":{"type":"string","description":"Column"},"line":{"type":"string","description":"Line"},"row":{"type":"string","description":"Row"}}},"custom_shelf_config":{"type":"object","description":"Custom shelf config","x-description-i18n":{"vie":"Cấu hình kệ tùy chỉnh"},"properties":{"custom_config":{"type":"object","description":"Custom config"}}},"custom_batch_config":{"type":"object","description":"Custom batch config","x-description-i18n":{"vie":"Cấu hình lô tùy chỉnh"},"properties":{"custom_config":{"type":"object","description":"Custom config"}}},"hide_config_batch_shelf":{"type":"boolean","description":"Open custom batch shelf config","x-description-i18n":{"vie":"Mở cấu hình lô kệ tùy chỉnh"}}},"example":{"name":"kho 2","address":"19/349 Minh Khai , Hai bà Trưng, Hà Nội","phone_number":"098765432","province_id":"101","district_id":"10107","commune_id":"1010735","country_code":"84","shelf_config":{"col":"3"},"batch_config":{"col":"0","line":"3","row":"3"},"custom_batch_config":{"custom_config":{"0":"lô 1"}},"custom_shelf_config":{"custom_config":{"0":"1.1","1":"1.2","2":"1.3","3":"1.4"}},"hide_config_batch_shelf":false}}}},"description":"Request body containing warehouse information to create","x-description-i18n":{"vie":"Thông tin yêu cầu chứa thông tin kho hàng cần tạo"}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Warehouse"},"examples":{"default":{"value":{"id":"b4cb5897-6e56-4581-96cc-2f12677c7bd8","name":"kho test ecod","address":"hâhhha","full_address":"hâhhha, Xã Bình Trung, Huyện Châu Đức, Bà Rịa-Vũng Tàu","phone_number":"0999999999","province_id":"717","district_id":"71705","commune_id":"7170510","country_code":"84","shop_id":26290,"allow_create_order":true,"custom_id":null}}}}}}}}},"/shops/{SHOP_ID}/warehouses/{WAREHOUSE_ID}":{"put":{"summary":"Update warehouse","x-summary-i18n":{"vie":"Cập nhật kho hàng"},"description":"Update warehouse","x-description-i18n":{"vie":"Cập nhật kho hàng"},"tags":["Warehouse"],"x-tags-i18n":{"vie":["Kho hàng"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},{"name":"WAREHOUSE_ID","in":"path","required":true,"schema":{"type":"string","example":"b4cb5897-6e56-4581-96cc-2f12677c7bd8"},"description":"Warehouse ID","x-description-i18n":{"vie":"Mã kho hàng"}}],"requestBody":{"required":true,"description":"Request body containing warehouse information to update","x-description-i18n":{"vie":"Thông tin yêu cầu chứa thông tin kho hàng cần cập nhật"},"content":{"application/json":{"schema":{"type":"object","required":["name","shelf_config"],"properties":{"name":{"type":"string","description":"Warehouse name","x-description-i18n":{"vie":"Tên kho hàng"}},"address":{"type":"string","description":"Warehouse address","x-description-i18n":{"vie":"Địa chỉ chi tiết kho hàng(số nhà, đường, ...)"}},"phone_number":{"type":"string","description":"Warehouse phone number","x-description-i18n":{"vie":"Số điện thoại kho hàng"}},"province_id":{"type":"string","description":"Province ID. Get by API GET /geo/provinces","x-description-i18n":{"vie":"Mã tỉnh thành phố. Lấy từ API GET /geo/provinces"}},"district_id":{"type":"string","description":"District ID. Get by API GET /geo/districts","x-description-i18n":{"vie":"Mã quận huyện. Lấy từ API GET /geo/districts"}},"commune_id":{"type":"string","description":"Commune ID. Get by API GET /geo/communes","x-description-i18n":{"vie":"Mã phường xã. Lấy từ API GET /geo/communes"}},"country_code":{"type":"string","description":"Country code","x-description-i18n":{"vie":"Mã quốc gia"}},"shelf_config":{"type":"object","description":"Shelf config","x-description-i18n":{"vie":"Cấu hình kệ"},"properties":{"col":{"type":"string","description":"Column","x-description-i18n":{"vie":"Cột"}}}},"batch_config":{"type":"object","description":"Batch config","x-description-i18n":{"vie":"Cấu hình lô"},"properties":{"col":{"type":"string","description":"Column"},"line":{"type":"string","description":"Line"},"row":{"type":"string","description":"Row"}}},"custom_shelf_config":{"type":"object","description":"Custom shelf config","x-description-i18n":{"vie":"Cấu hình kệ tùy chỉnh"},"properties":{"custom_config":{"type":"object","description":"Custom config"}}},"custom_batch_config":{"type":"object","description":"Custom batch config","x-description-i18n":{"vie":"Cấu hình lô tùy chỉnh"},"properties":{"custom_config":{"type":"object","description":"Custom config"}}},"hide_config_batch_shelf":{"type":"boolean","description":"Open custom batch shelf config","x-description-i18n":{"vie":"Mở cấu hình lô kệ tùy chỉnh"}}},"example":{"name":"Kho mặc định","address":"190 La Thành","phone_number":"0366452565","province_id":"101","district_id":"10113","commune_id":"1011309","country_code":"84","shelf_config":{"col":"3"},"batch_config":{"col":"0","line":"3","row":"3"},"custom_batch_config":{"custom_config":{"0":"lô 1"}},"custom_shelf_config":{"custom_config":{"0":"1.1","1":"1.2","2":"1.3","3":"1.4"}},"hide_config_batch_shelf":false}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Warehouse"},"examples":{"default":{"value":{"id":"b4cb5897-6e56-4581-96cc-2f12677c7bd8","name":"kho test ecod","address":"SCB","full_address":"SCB, Xã Bình Trung, Huyện Châu Đức, Bà Rịa-Vũng Tàu","phone_number":"0999999999","province_id":"717","district_id":"71705","commune_id":"7170510","country_code":"84","shop_id":26290,"allow_create_order":true,"custom_id":null}}}}}}}}},"/shops/{SHOP_ID}/inventory_histories":{"get":{"summary":"Inventory histories","x-summary-i18n":{"vie":"Lịch sử xuất nhập kho"},"description":"Get inventory history","x-description-i18n":{"vie":"Lấy lịch sử xuất nhập kho"},"tags":["Warehouse"],"x-tags-i18n":{"vie":["Kho hàng"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},{"name":"page","in":"query","required":true,"schema":{"type":"integer","default":1,"example":1},"description":"Page number","x-description-i18n":{"vie":"Số trang"}},{"name":"page_size","in":"query","required":true,"schema":{"type":"integer","default":30,"example":30},"description":"Page size","x-description-i18n":{"vie":"Kích thước trang"}},{"name":"warehouse_id","in":"query","required":false,"schema":{"type":"string","example":"b4cb5897-6e56-4581-96cc-2f12677c7bd8"},"description":"Warehouse ID","x-description-i18n":{"vie":"Mã kho"}},{"name":"variation_ids[]","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"},"example":["415040f4-ab63-465e-8699-e9ebfff4c6c7"]},"description":"Variation IDs","x-description-i18n":{"vie":"Danh sách mã mẫu mã"}},{"name":"startDate","in":"query","required":false,"schema":{"type":"integer","example":0},"description":"Start date (unix timestamp)","x-description-i18n":{"vie":"Ngày bắt đầu"}},{"name":"endDate","in":"query","required":false,"schema":{"type":"integer","example":0},"description":"End date (unix timestamp)","x-description-i18n":{"vie":"Ngày kết thúc"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","description":"List of inventory histories","x-description-i18n":{"vie":"Danh sách lịch sử xuất nhập kho"},"items":{"type":"object","properties":{"avg_price":{"type":"integer","description":"Average import price","x-description-i18n":{"vie":"Giá nhập trung bình"}},"current_inventory":{"type":"array","description":"Current inventory information","x-description-i18n":{"vie":"Thông tin tồn kho hiện tại"},"items":{"type":"object","properties":{"actual_remain_quantity":{"type":"integer","description":"Actual remain quantity","x-description-i18n":{"vie":"Số lượng tồn thực tế"}},"avg_price":{"type":"number","description":"Average price","x-description-i18n":{"vie":"Giá trung bình"}},"id":{"type":"string","description":"Warehouse ID","x-description-i18n":{"vie":"Mã kho"}},"name":{"type":"string","description":"Warehouse name","x-description-i18n":{"vie":"Tên kho"}},"remain_quantity":{"type":"integer","description":"Remain quantity","x-description-i18n":{"vie":"Số lượng tồn"}},"total_quantity":{"type":"integer","description":"Total quantity","x-description-i18n":{"vie":"Tổng số lượng"}}}}},"editor_id":{"type":"string","description":"Updated employee ID","x-description-i18n":{"vie":"Mã nhân viên cập nhật"}},"id":{"type":"integer","description":"Inventory history ID","x-description-i18n":{"vie":"Mã xuất nhập kho"}},"inserted_at":{"type":"string","format":"date-time","description":"Inserted at","x-description-i18n":{"vie":"Thời điểm tạo"}},"quantity":{"type":"integer","description":"Change quantity","x-description-i18n":{"vie":"Số lượng thay đổi"}},"ref_display_id":{"type":"string","description":"Reference display ID","x-description-i18n":{"vie":"Mã hiển thị tham chiếu"}},"remain_quantity":{"type":"integer","description":"In stock","x-description-i18n":{"vie":"Tồn kho"}},"table_name":{"type":"string","description":"Table name","x-description-i18n":{"vie":"Tên bảng"}},"type":{"type":"string","description":"Type","x-description-i18n":{"vie":"Loại"}},"variation_now":{"type":"object","description":"Variation information","x-description-i18n":{"vie":"Thông tin mẫu mã"},"properties":{"barcode":{"type":"string"},"display_id":{"type":"string"},"fields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"keyValue":{"type":"string"},"name":{"type":"string"},"value":{"type":"string"}}}},"id":{"type":"string"},"images":{"type":"array","items":{"type":"string","format":"uri"}},"is_hidden":{"type":"boolean"},"is_locked":{"type":"boolean"},"is_sell_negative_variation":{"type":"boolean"},"last_imported_price":{"type":"integer"},"product_id":{"type":"string"},"retail_price":{"type":"integer"},"weight":{"type":"integer"}}},"warehouse":{"type":"object","description":"Warehouse change inventory","x-description-i18n":{"vie":"Kho thay đổi tồn"},"properties":{"custom_id":{"type":"string"},"ffm_id":{"type":"string"},"full_address":{"type":"string"},"id":{"type":"string"},"name":{"type":"string"},"phone_number":{"type":"string"}}}}}},"page_number":{"type":"integer","description":"Page number","x-description-i18n":{"vie":"Số trang"}},"page_size":{"type":"integer","description":"Page size","x-description-i18n":{"vie":"Kích thước trang"}},"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}},"total_entries":{"type":"integer","description":"Total entries","x-description-i18n":{"vie":"Tổng số bản ghi"}},"total_pages":{"type":"integer","description":"Total pages","x-description-i18n":{"vie":"Tổng số trang"}}}},"examples":{"default":{"value":{"success":true,"data":[{"avg_price":1,"current_inventory":[{"actual_remain_quantity":1,"avg_price":1,"id":"b4cb5897-6e56-4581-96cc-2f12677c7bd8","name":"kho test ecod","remain_quantity":1,"total_quantity":1}],"editor_id":"cee3c05e-5f85-43c4-b27e-889b99c50097","id":1,"inserted_at":"2024-01-01T00:00:00Z","quantity":1,"ref_display_id":"12345","remain_quantity":1,"table_name":"Purchase","type":"import","variation_now":{"barcode":"BARCODE123","display_id":"13109","fields":[{"id":"field-id-1","keyValue":"Màu","name":"Màu","value":"Trắng"}],"id":"415040f4-ab63-465e-8699-e9ebfff4c6c7","images":["https://statics.pancake.vn/user-content.pancake.vn/2021/8/5/fccd6.jpg"],"is_hidden":true,"is_locked":true,"is_sell_negative_variation":true,"last_imported_price":1,"product_id":"3487e126-b0d9-4dae-89a9-ee60bef2f4e9","retail_price":1,"weight":1},"warehouse":{"custom_id":null,"ffm_id":null,"full_address":"hâhhha, Xã Bình Trung, Huyện Châu Đức, Bà Rịa-Vũng Tàu","id":"b4cb5897-6e56-4581-96cc-2f12677c7bd8","name":"kho test ecod","phone_number":"0999999999"}}]}}}}}}}}},"/shops/{SHOP_ID}/orders":{"get":{"summary":"List of orders","x-summary-i18n":{"vie":"Danh sách đơn hàng"},"description":"Get list of orders. Get information of specific order","x-description-i18n":{"vie":"Lấy danh sách đơn hàng thông tin từng đơn hàng cụ thể"},"tags":["Order"],"x-tags-i18n":{"vie":["Đơn hàng"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","default":30,"example":30},"description":"Page size","x-description-i18n":{"vie":"Kích thước trang"},"example":100},{"name":"page_number","in":"query","required":false,"schema":{"type":"integer","default":1,"example":1},"description":"Page number","x-description-i18n":{"vie":"Số trang"},"example":1},{"name":"search","in":"query","required":false,"schema":{"type":"string","example":"0999999999"},"description":"Phone number, name of customer, note, ....","x-description-i18n":{"vie":"Số điện thoại, tên khách hàng, ghi chú, ..."},"example":"0999999999"},{"name":"filter_status[]","in":"query","required":false,"schema":{"type":"array","items":{"type":"integer"},"example":[1,2]},"description":"Order status","x-description-i18n":{"vie":"Trạng thái đơn hàng"},"example":[0,1]},{"name":"include_removed","in":"query","required":false,"schema":{"type":"integer","example":0},"description":"Include removed orders","x-description-i18n":{"vie":"Bao gồm đơn đã xóa"},"example":1},{"name":"updateStatus","in":"query","required":false,"schema":{"type":"string","default":"inserted_at","enum":["inserted_at","updated_at","partner_inserted_at","paid_at","estimate_delivery_date","picked_up_at","first_delivery_at","transfer_proof","time_assign_seller","time_assign_care","time_assign_marketer","-1","0","11","20","1","12","13","8","9","2","3","16","4","15","5"],"x-enum-descriptions":["Order creation time","Last update time","Time sent to courier","Reconciliation time","Estimate delivery time","Courier picked up at","First delivery at","Transfer proof","Time assign seller","Time assign care","Time assign marketer","Last status update","New","Restocking","Purchased","Confirmed","Wait for printing","Printed","Packaging","Waiting for pick up","Shipped","Received","Collected money","Returning","Partial return","Returned"],"x-enum-descriptions-i18n":{"vie":["Thời điểm tạo đơn","Thời điểm cập nhật cuối","Thời điểm gửi đơn vị vận chuyển","Thời điểm đối soát","Thời gian giao hàng dự kiến","Thời điểm đơn vị vận chuyển lấy hàng","Thời điểm giao hàng lần đầu","Chứng từ chuyển khoản","Thời điểm phân công người bán","Thời điểm phân công chăm sóc","Thời điểm phân công marketer","Cập nhật trạng thái cuối","Mới","Chờ hàng","Đã đặt hàng","Đã xác nhận","Chờ in","Đã in","Đang đóng hàng","Chờ chuyển hàng","Đã gửi hàng","Đã nhận","Đã thu tiền","Đang hoàn","Hoàn một phần","Đã hoàn"]},"example":"inserted_at"},"description":"Filter orders by time","x-description-i18n":{"vie":"Lọc đơn hàng theo thời gian"},"x-enum-descriptions-i18n":{"vie":["Thời điểm tạo đơn","Thời điểm cập nhật cuối","Thời điểm gửi đơn vị vận chuyển","Thời điểm đối soát","Thời gian giao hàng dự kiến","Thời điểm đơn vị vận chuyển lấy hàng","Thời điểm giao hàng lần đầu","Chứng từ chuyển khoản","Thời điểm phân công người bán","Thời điểm phân công chăm sóc","Thời điểm phân công marketer","Cập nhật trạng thái cuối","Mới","Chờ hàng","Đã đặt hàng","Đã xác nhận","Chờ in","Đã in","Đang đóng hàng","Chờ chuyển hàng","Đã gửi hàng","Đã nhận","Đã thu tiền","Đang hoàn","Hoàn một phần","Đã hoàn"]}},{"name":"startDateTime","in":"query","required":false,"schema":{"type":"integer","format":"int64","example":0},"description":"Start date (unix timestamp)","x-description-i18n":{"vie":"Ngày bắt đầu"},"example":1699635600},{"name":"endDateTime","in":"query","required":false,"schema":{"type":"integer","format":"int64","example":0},"description":"End date (unix timestamp)","x-description-i18n":{"vie":"Ngày kết thúc"},"example":1699635600},{"name":"option_sort","in":"query","required":false,"schema":{"type":"string","default":"inserted_at_desc","enum":["inserted_at_desc","inserted_at_asc","last_updated_order_desc","last_updated_order_asc","last_update_status_at_desc","last_update_status_at_asc","order_valuation_desc","order_valuation_asc","product_quantity_desc","product_quantity_asc","product_name_desc","product_name_asc","sub_status_sort_desc","sub_status_sort_asc","first_undeliverable_at_desc","first_undeliverable_at_asc","customer_sort_desc","customer_sort_asc","estimate_delivery_date_desc","estimate_delivery_date_asc","order_source_desc","order_source_asc"],"x-enum-descriptions":["Order creation time gradually decreases","Order creation time gradually increases","Last updated order gradually decreases","Last updated order gradually increases","Last update status at gradually decreases","Last update status at gradually increases","Order value gradually decreases","Order value gradually increases","Product quantity gradually decreases","Product quantity gradually increases","Product name gradually decreases","Product name gradually increases","Delivery delay update gradually decreases","Delivery delay update gradually increases","First undeliverable at gradually decreases","First undeliverable at gradually increases","Customer name gradually decreases","Customer name gradually increases","Estimate delivery date gradually decreases","Estimate delivery date gradually increases","Order source gradually decreases","Order source gradually increases"],"x-enum-descriptions-i18n":{"vie":["Thời điểm tạo đơn giảm dần","Thời điểm tạo đơn tăng dần","Cập nhật đơn hàng cuối giảm dần","Cập nhật đơn hàng cuối tăng dần","Cập nhật trạng thái cuối giảm dần","Cập nhật trạng thái cuối tăng dần","Giá trị đơn hàng giảm dần","Giá trị đơn hàng tăng dần","Số lượng sản phẩm giảm dần","Số lượng sản phẩm tăng dần","Tên sản phẩm giảm dần","Tên sản phẩm tăng dần","Cập nhật chậm giao hàng giảm dần","Cập nhật chậm giao hàng tăng dần","Lần đầu không giao được giảm dần","Lần đầu không giao được tăng dần","Tên khách hàng giảm dần","Tên khách hàng tăng dần","Ngày giao hàng dự kiến giảm dần","Ngày giao hàng dự kiến tăng dần","Nguồn đơn hàng giảm dần","Nguồn đơn hàng tăng dần"]},"example":"inserted_at_desc"},"description":"Orders sequence","x-description-i18n":{"vie":"Thứ tự đơn hàng"},"x-enum-descriptions-i18n":{"vie":["Thời điểm tạo đơn giảm dần","Thời điểm tạo đơn tăng dần","Cập nhật đơn hàng cuối giảm dần","Cập nhật đơn hàng cuối tăng dần","Cập nhật trạng thái cuối giảm dần","Cập nhật trạng thái cuối tăng dần","Giá trị đơn hàng giảm dần","Giá trị đơn hàng tăng dần","Số lượng sản phẩm giảm dần","Số lượng sản phẩm tăng dần","Tên sản phẩm giảm dần","Tên sản phẩm tăng dần","Cập nhật chậm giao hàng giảm dần","Cập nhật chậm giao hàng tăng dần","Lần đầu không giao được giảm dần","Lần đầu không giao được tăng dần","Tên khách hàng giảm dần","Tên khách hàng tăng dần","Ngày giao hàng dự kiến giảm dần","Ngày giao hàng dự kiến tăng dần","Nguồn đơn hàng giảm dần","Nguồn đơn hàng tăng dần"]}},{"name":"fields[]","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"}},"description":"Response fields","x-description-i18n":{"vie":"Các trường trả về"},"example":["id","bill_phone_number"]},{"name":"partner_id[]","in":"query","required":false,"schema":{"type":"array","items":{"type":"integer"}},"description":"Shipping partner ID on Pancake system","x-description-i18n":{"vie":"ID đơn vị vận chuyển trên hệ thống Pancake"},"example":[1,3]},{"name":"shop_partner_account","in":"query","required":false,"schema":{"type":"integer"},"description":"Filter by shipping account ID connected to the shop","x-description-i18n":{"vie":"Lọc theo mã tài khoản vận chuyển đã kết nối với shop"},"example":46036},{"name":"customer_id","in":"query","required":false,"schema":{"type":"string"},"description":"Customer ID","x-description-i18n":{"vie":"Mã khách hàng"},"example":"96a8e283-3fba-492e-a35a-970f72a30a02"},{"name":"order_sources[]","in":"query","required":false,"schema":{"type":"array","items":{"type":"array","items":{"type":"string"}}},"description":"Order sources. Format: [[order_source_id, account_id], ...]\nExample: [[\"-1\", \"314\"], [\"-3\"]]\n","x-description-i18n":{"vie":"Nguồn đơn hàng. Định dạng: [[mã_nguồn_đơn, mã_tài_khoản], ...]\nVí dụ: [[\"-1\", \"314\"], [\"-3\"]]\n"},"example":[["-1","314"],["-3"]]},{"name":"is_filter_exclude_source","in":"query","required":false,"schema":{"type":"boolean","default":false},"description":"Exclude order source","x-description-i18n":{"vie":"Loại trừ nguồn đơn hàng"},"example":true},{"name":"ad_ids[]","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"}},"description":"Advertising IDs","x-description-i18n":{"vie":"Mã quảng cáo"},"example":["1784439461476385","1784439461473489"]},{"name":"project_ids","in":"query","required":false,"schema":{"type":"integer"},"description":"Project ID","x-description-i18n":{"vie":"Mã dự án"},"example":1},{"name":"extra_fields[]","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","enum":["return_rate","conversation_note"],"x-enum-descriptions":["Return rate","Conversation note"],"x-enum-descriptions-i18n":{"vie":["Tỉ lệ đổi hàng","Ghi chú trao đổi"]}}},"description":"Extra fields","x-description-i18n":{"vie":"Các trường bổ sung"},"example":["return_rate","conversation_note"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","description":"List of orders","x-description-i18n":{"vie":"Danh sách đơn hàng"},"items":{"type":"object","properties":{"id":{"type":"integer","description":"Order ID","x-description-i18n":{"vie":"Mã đơn hàng"}},"system_id":{"type":"integer","description":"System ID","x-description-i18n":{"vie":"Mã hệ thống"}},"shop_id":{"type":"integer","description":"Shop ID","x-description-i18n":{"vie":"Mã cửa hàng"}},"inserted_at":{"type":"string","format":"date-time","description":"Order creation time","x-description-i18n":{"vie":"Thời điểm tạo đơn"}},"updated_at":{"type":"string","format":"date-time","description":"Order update time","x-description-i18n":{"vie":"Thời điểm cập nhật đơn"}},"status":{"type":"integer","description":"Order status","x-description-i18n":{"vie":"Trạng thái đơn hàng"},"enum":[0,17,11,12,13,20,1,8,9,2,3,16,4,15,5,6,7],"x-enum-descriptions":["New","Waiting for confirmation","Restocking","Wait for printing","Printed","Purchased","Confirmed","Packaging","Waiting for pick up","Shipped","Received","Collected money","Returning","Partial return","Returned","Canceled","Deleted recently"],"x-enum-descriptions-i18n":{"vie":["Mới","Chờ xác nhận","Chờ hàng","Chờ in","Đã in","Đã đặt hàng","Đã xác nhận","Đang đóng hàng","Chờ chuyển hàng","Đã gửi hàng","Đã nhận","Đã thu tiền","Đang hoàn","Hoàn một phần","Đã hoàn","Đã hủy","Đã xóa"]}},"status_name":{"type":"string","description":"Order status name","x-description-i18n":{"vie":"Tên trạng thái đơn hàng"}},"bill_full_name":{"type":"string","description":"Customer name","x-description-i18n":{"vie":"Tên khách hàng"}},"bill_phone_number":{"type":"string","description":"Phone number of customer","x-description-i18n":{"vie":"SĐT khách hàng"}},"bill_email":{"type":"string","description":"Customer email","x-description-i18n":{"vie":"Email khách hàng"}},"conversation_id":{"type":"string","description":"Conversation ID","x-description-i18n":{"vie":"Mã hội thoại"}},"page_id":{"type":"string","description":"Facebook page ID","x-description-i18n":{"vie":"Mã Facebook page"}},"post_id":{"type":"string","description":"Post ID","x-description-i18n":{"vie":"Mã bài viết"}},"ad_id":{"type":"string","description":"Ad ID","x-description-i18n":{"vie":"Mã quảng cáo"}},"shipping_fee":{"type":"integer","description":"Shipping fee","x-description-i18n":{"vie":"Phí vận chuyển"}},"partner_fee":{"type":"integer","description":"Fee from shipping partner","x-description-i18n":{"vie":"Phí vận chuyển từ ĐVVC"}},"fee_marketplace":{"type":"integer","description":"Fees from e-commerce platforms","x-description-i18n":{"vie":"Phí sàn"}},"customer_pay_fee":{"type":"boolean","description":"Customer pay shipping fee","x-description-i18n":{"vie":"Khách trả phí ship"}},"is_free_shipping":{"type":"boolean","description":"Free shipping","x-description-i18n":{"vie":"Miễn phí vận chuyển"}},"is_livestream":{"type":"boolean","description":"Is livestream order","x-description-i18n":{"vie":"Đơn hàng từ livestream"}},"is_live_shopping":{"type":"boolean","description":"Is live shopping order","x-description-i18n":{"vie":"Đơn hàng từ live shopping"}},"is_smc":{"type":"boolean","description":"Shopping on Messenger","x-description-i18n":{"vie":"Đơn hàng từ mua sắm trên Messenger"}},"received_at_shop":{"type":"boolean","description":"true: Sales at counter, false: Sell online","x-description-i18n":{"vie":"true: Bán tại quầy, false: Bán online"}},"total_discount":{"type":"integer","description":"Discount total","x-description-i18n":{"vie":"Tổng tiền giảm giá"}},"note":{"type":"string","description":"Internal note","x-description-i18n":{"vie":"Ghi chú nội bộ"}},"note_print":{"type":"string","description":"Note for printing","x-description-i18n":{"vie":"Ghi chú đơn hàng"}},"returned_reason":{"type":"integer","description":"Return reason code (1: Customer, 2: Staff, 3: Defective product, 4: Shipping carrier, 5: Exchange). Other values are shop-defined custom reasons, see returned_reason_name for the display name","x-description-i18n":{"vie":"Mã lý do hoàn hàng (1: Do khách hàng, 2: Do nhân viên, 3: Do sản phẩm lỗi, 4: Do đơn vị vận chuyển, 5: Do đổi hàng). Mã khác là lý do tùy chỉnh theo từng shop, xem tên hiển thị tại returned_reason_name"}},"returned_reason_name":{"type":"string","description":"Return reason name","x-description-i18n":{"vie":"Tên lý do hoàn hàng"}},"sub_status":{"type":"integer","description":"Reason for delivery delay","x-description-i18n":{"vie":"Lý do delay giao hàng"}},"warehouse_id":{"type":"string","description":"Warehouse ID","x-description-i18n":{"vie":"Mã kho hàng"}},"warehouse_info":{"type":"object","description":"Warehouse information","x-description-i18n":{"vie":"Thông tin kho hàng"},"properties":{"name":{"type":"string","description":"Warehouse name","x-description-i18n":{"vie":"Tên kho hàng"}},"phone_number":{"type":"string","description":"Warehouse phone number","x-description-i18n":{"vie":"Số điện thoại kho hàng"}},"full_address":{"type":"string","description":"Warehouse full address","x-description-i18n":{"vie":"Địa chỉ đầy đủ kho hàng"}},"address":{"type":"string","description":"Warehouse address","x-description-i18n":{"vie":"Địa chỉ chi tiết kho hàng"}},"province_id":{"type":"string","description":"Province ID","x-description-i18n":{"vie":"Mã tỉnh thành phố"}},"district_id":{"type":"string","description":"District ID","x-description-i18n":{"vie":"Mã quận huyện"}},"commune_id":{"type":"string","description":"Commune ID","x-description-i18n":{"vie":"Mã phường xã"}},"affiliate_id":{"type":"string","description":"Affiliate ID","x-description-i18n":{"vie":"Mã đại lý"}},"ffm_id":{"type":"string","description":"FFM ID","x-description-i18n":{"vie":"Mã FFM"}},"has_snappy_service":{"type":"boolean","description":"Has Snappy service","x-description-i18n":{"vie":"Có dịch vụ Snappy"}},"custom_id":{"type":"string","description":"Custom ID","x-description-i18n":{"vie":"Mã tùy chỉnh"}}}},"creator_id":{"type":"string","description":"Creator ID","x-description-i18n":{"vie":"Mã người tạo"}},"creator":{"type":"object","description":"Order creator","x-description-i18n":{"vie":"Thông tin người tạo đơn"},"properties":{"id":{"type":"string","description":"Creator ID","x-description-i18n":{"vie":"Mã người tạo"}},"fb_id":{"type":"string","description":"Facebook ID of creator","x-description-i18n":{"vie":"ID facebook người tạo đơn"}},"name":{"type":"string","description":"Creator name","x-description-i18n":{"vie":"Tên người tạo đơn"}},"avatar_url":{"type":"string","description":"Creator avatar URL","x-description-i18n":{"vie":"Link avatar người tạo"}}}},"items":{"type":"array","description":"Product list. When creating or updating an order, each entry must include `variation_id` and `quantity`. `variation_info` is optional — if omitted, the backend treats it as an empty object; send it (with `retail_price`) when you need the line price to be explicit.","x-description-i18n":{"vie":"Danh sách sản phẩm. Khi tạo hoặc cập nhật đơn, mỗi phần tử cần có `variation_id` và `quantity`. `variation_info` không bắt buộc — nếu thiếu, backend coi như object rỗng; nên gửi kèm (cùng `retail_price`) khi muốn giá dòng hàng tường minh."},"items":{"type":"object","required":["variation_id","quantity"],"properties":{"product_id":{"type":"string","description":"Product ID","x-description-i18n":{"vie":"Mã sản phẩm"}},"quantity":{"type":"integer","description":"Quantity","x-description-i18n":{"vie":"Số lượng"}},"returned_count":{"type":"integer","description":"Returned count","x-description-i18n":{"vie":"Số lượng đã trả"}},"assigning_seller_id":{"type":"string","description":"Assigning seller ID","x-description-i18n":{"vie":"Mã nhân viên được phân công"}},"quantity_by_combo_products":{"type":"array","description":"Quantity by combo products","x-description-i18n":{"vie":"Số lượng theo combo sản phẩm"},"items":{"type":"object"}},"discount_each_product":{"type":"integer","description":"Discount for each product","x-description-i18n":{"vie":"Giảm giá cho từng sản phẩm"}},"is_bonus_product":{"type":"boolean","description":"Is bonus product","x-description-i18n":{"vie":"Sản phẩm tặng kèm"}},"is_discount_percent":{"type":"boolean","description":"Is discount by percent","x-description-i18n":{"vie":"Giảm giá theo phần trăm"}},"is_wholesale":{"type":"boolean","description":"Is wholesale","x-description-i18n":{"vie":"Bán sỉ"}},"is_composite":{"type":"boolean","description":"Is composite product","x-description-i18n":{"vie":"Sản phẩm composite"}},"one_time_product":{"type":"boolean","description":"One time product","x-description-i18n":{"vie":"Sản phẩm một lần"}},"note":{"type":"string","description":"Product note","x-description-i18n":{"vie":"Ghi chú sản phẩm"}},"note_product":{"type":"string","description":"Product note","x-description-i18n":{"vie":"Ghi chú sản phẩm"}},"inserted_at":{"type":"string","format":"date-time","description":"Inserted at","x-description-i18n":{"vie":"Thời điểm tạo"}},"measure_group_id":{"type":"integer","description":"Measure group ID","x-description-i18n":{"vie":"Mã nhóm đơn vị tính"}},"variation_info":{"type":"object","description":"Variation information. Optional when creating/updating an order (the backend defaults it to an empty object if omitted). Its inner fields are not individually required, but sending `retail_price` is recommended so the line price is correct.","x-description-i18n":{"vie":"Thông tin biến thể. Không bắt buộc khi tạo/cập nhật đơn (backend tự coi là object rỗng nếu thiếu). Các field bên trong không bắt buộc riêng lẻ, nhưng nên gửi `retail_price` để giá dòng hàng đúng."},"properties":{"id":{"type":"string","description":"Variation ID","x-description-i18n":{"vie":"Mã biến thể"}},"name":{"type":"string","description":"Product name","x-description-i18n":{"vie":"Tên sản phẩm"}},"product_id":{"type":"string","description":"Product ID","x-description-i18n":{"vie":"Mã sản phẩm"}},"retail_price":{"type":"integer","description":"Retail price. Not strictly required, but recommended when creating/updating an order so the line price is correct.","x-description-i18n":{"vie":"Giá bán lẻ. Không bắt buộc, nhưng nên gửi khi tạo/cập nhật đơn để giá dòng hàng chính xác."}},"detail":{"type":"string","description":"Variation detail","x-description-i18n":{"vie":"Chi tiết biến thể"}},"images":{"type":"array","description":"Variation images","x-description-i18n":{"vie":"Hình ảnh biến thể"},"items":{"type":"string","format":"uri"}},"fields":{"type":"array","description":"Variation fields","x-description-i18n":{"vie":"Thuộc tính biến thể"},"items":{"type":"object","properties":{"id":{"type":"string","description":"Field ID","x-description-i18n":{"vie":"Mã thuộc tính"}},"name":{"type":"string","description":"Field name","x-description-i18n":{"vie":"Tên thuộc tính"}},"value":{"type":"string","description":"Field value","x-description-i18n":{"vie":"Giá trị thuộc tính"}},"keyValue":{"type":"string","description":"Key value","x-description-i18n":{"vie":"Giá trị khóa"}}}}},"barcode":{"type":"string","description":"Barcode","x-description-i18n":{"vie":"Mã barcode"}},"brand_id":{"type":"string","description":"Brand ID","x-description-i18n":{"vie":"Mã thương hiệu"}},"category_ids":{"type":"array","description":"Category IDs","x-description-i18n":{"vie":"Danh sách mã danh mục"},"items":{"type":"integer"}},"display_id":{"type":"string","description":"Display ID","x-description-i18n":{"vie":"Mã hiển thị"}},"product_display_id":{"type":"string","description":"Product display ID","x-description-i18n":{"vie":"Mã hiển thị sản phẩm"}},"last_imported_price":{"type":"integer","description":"Last imported price","x-description-i18n":{"vie":"Giá nhập hàng cuối"}},"is_upsale_product":{"type":"boolean","description":"Upsale product","x-description-i18n":{"vie":"Sản phẩm upsale"}},"weight":{"type":"integer","description":"Weight","x-description-i18n":{"vie":"Khối lượng"}},"measure_info":{"type":"object","description":"Measure information","x-description-i18n":{"vie":"Thông tin đơn vị tính"},"properties":{"measure_id":{"type":"integer","description":"Measure ID","x-description-i18n":{"vie":"Mã đơn vị tính"}},"exchange_value":{"type":"integer","description":"Exchange value","x-description-i18n":{"vie":"Giá trị quy đổi"}}}},"avg_price":{"type":"integer","description":"Average import price","x-description-i18n":{"vie":"Giá nhập trung bình"}}}},"components":{"type":"array","description":"Product components","x-description-i18n":{"vie":"Thành phần sản phẩm"},"items":{"type":"object","properties":{"component_id":{"type":"string","description":"Component ID","x-description-i18n":{"vie":"Mã thành phần"}},"quantity":{"type":"integer","description":"Quantity","x-description-i18n":{"vie":"Số lượng"}},"variation_id":{"type":"string","description":"Variation ID","x-description-i18n":{"vie":"Mã biến thể"}},"variation_info":{"type":"object","description":"Variation information","x-description-i18n":{"vie":"Thông tin biến thể"}}}}},"id":{"type":"integer","description":"Item ID","x-description-i18n":{"vie":"Mã sản phẩm trong đơn"}},"variation_id":{"type":"string","description":"Variation ID","x-description-i18n":{"vie":"Mã biến thể"}}}}},"partner":{"type":"object","description":"Partner information","x-description-i18n":{"vie":"Thông tin đơn vị vận chuyển"},"properties":{"partner_id":{"type":"integer","description":"Partner ID","x-description-i18n":{"vie":"ID đơn vị vận chuyển trên hệ thống Pancake"}},"cod":{"type":"integer","description":"Reconciliation COD","x-description-i18n":{"vie":"Đối soát tiền thu hộ"}},"extend_code":{"type":"string","description":"Shipping order ID on partner system","x-description-i18n":{"vie":"Mã vận đơn"}},"total_fee":{"type":"integer","description":"Total fee","x-description-i18n":{"vie":"Tổng phí"}},"updated_at":{"type":"string","format":"date-time","description":"Updated at","x-description-i18n":{"vie":"Thời điểm cập nhật"}},"delivery_name":{"type":"string","description":"Shipper name","x-description-i18n":{"vie":"Tên người giao hàng"}},"delivery_tel":{"type":"string","description":"Delivery phone","x-description-i18n":{"vie":"Số điện thoại người giao hàng"}},"picked_up_at":{"type":"string","format":"date-time","description":"Picked up at","x-description-i18n":{"vie":"Thời điểm lấy hàng"}},"sort_code":{"type":"string","description":"Sort code","x-description-i18n":{"vie":"Mã phân loại"}},"paid_at":{"type":"string","format":"date-time","description":"Paid at","x-description-i18n":{"vie":"Thời điểm thanh toán"}},"system_created":{"type":"boolean","description":"System created","x-description-i18n":{"vie":"Được tạo bởi hệ thống"}},"extend_update":{"type":"array","description":"Update from courier","x-description-i18n":{"vie":"Cập nhật từ đơn vị vận chuyển"},"items":{"type":"object","properties":{"key":{"type":"string","description":"Update key","x-description-i18n":{"vie":"Mã cập nhật"}},"status":{"type":"string","description":"Status","x-description-i18n":{"vie":"Trạng thái"}},"tracking_id":{"type":"string","description":"Partner extend code","x-description-i18n":{"vie":"Mã đơn hàng đối tác"}},"note":{"type":"string","description":"Courier notes","x-description-i18n":{"vie":"Ghi chú từ đơn vị vận chuyển"}},"update_at":{"type":"string","format":"date-time","description":"Updated at","x-description-i18n":{"vie":"Thời điểm cập nhật"}}}}},"partner_status":{"type":"string","nullable":true,"description":"Partner shipping status","x-description-i18n":{"vie":"Trạng thái vận chuyển"},"enum":["waiting","request_received","processing_picked_up","picking_up","delay_pickup","picked_up","waiting_on_the_way","on_the_way","contact_delivery_company","out_for_delivery","delay_delivery","inform_recipient","undeliverable","waiting_for_return","delivered","delivered_cod","returning","returned","returned_cod","canceled"],"x-enum-descriptions":["Waiting for processing","Carrier received the request","Processing pickup","Picking up","Delayed pickup","Picked up","Waiting for transit","In transit","Contact the carrier","Out for delivery","Delayed delivery","Notify the recipient","Undeliverable","Waiting for return","Delivered","Delivered, COD reconciled","Returning","Returned","Returned, COD reconciled","Canceled"],"x-enum-descriptions-i18n":{"vie":["Chờ xử lý","ĐVVC đã tiếp nhận đơn","Đang xử lý lấy hàng","Đang lấy hàng","Trễ lấy hàng","Đã lấy hàng","Chờ trung chuyển","Đang trung chuyển","Liên hệ ĐVVC","Đang giao hàng","Trễ giao hàng","Thông báo cho người nhận","Giao không thành","Chờ chuyển hoàn","Đã giao hàng","Đã giao hàng, đã đối soát COD","Đang chuyển hoàn","Đã chuyển hoàn","Đã chuyển hoàn, đã đối soát COD","Đã hủy vận đơn"]}},"partner_name":{"type":"string","nullable":true,"description":"Partner name","x-description-i18n":{"vie":"Tên đơn vị vận chuyển"}},"first_delivery_at":{"type":"string","format":"date-time","nullable":true,"description":"First delivery time","x-description-i18n":{"vie":"Thời điểm giao hàng lần đầu"}},"first_undeliverable_at":{"type":"string","format":"date-time","nullable":true,"description":"First failed delivery time","x-description-i18n":{"vie":"Thời điểm giao hàng thất bại lần đầu"}},"order_number_vtp":{"type":"string","nullable":true,"description":"Viettel Post tracking number","x-description-i18n":{"vie":"Mã vận đơn Viettel Post"}},"printed_form":{"type":"object","nullable":true,"description":"Printed form","x-description-i18n":{"vie":"Mẫu in"}}}},"shipping_address":{"$ref":"#/components/schemas/ShippingAddress"},"payment_purchase_histories":{"type":"array","description":"Payment histories","x-description-i18n":{"vie":"Lịch sử thanh toán"},"items":{"type":"object","properties":{"amount":{"type":"integer","description":"Amount of money","x-description-i18n":{"vie":"Số tiền"}},"type":{"type":"string","description":"Payment type","x-description-i18n":{"vie":"Loại thanh toán"}},"inserted_at":{"type":"string","format":"date-time","description":"Transaction time","x-description-i18n":{"vie":"Thời điểm giao dịch"}},"result_code":{"type":"string","description":"Result code","x-description-i18n":{"vie":"Mã kết quả"}},"ipn_reply":{"type":"boolean","description":"IPN reply","x-description-i18n":{"vie":"Phản hồi IPN"}},"voucher_amount":{"type":"integer","description":"Voucher amount","x-description-i18n":{"vie":"Số tiền voucher"}},"tags":{"type":"array","description":"Tags","x-description-i18n":{"vie":"Thẻ"},"items":{"type":"string"}}}}},"tags":{"type":"array","description":"Tags list","x-description-i18n":{"vie":"Danh sách thẻ đơn hàng"},"items":{"type":"object","properties":{"id":{"type":"integer","description":"Tag ID","x-description-i18n":{"vie":"Mã thẻ đơn hàng"}},"name":{"type":"string","description":"Tag name","x-description-i18n":{"vie":"Tên thẻ đơn hàng"}}}}},"marketer":{"type":"object","description":"Marketer information","x-description-i18n":{"vie":"Thông tin marketer"},"properties":{"id":{"type":"string","description":"Marketer ID","x-description-i18n":{"vie":"Mã marketer"}},"name":{"type":"string","description":"Marketer name","x-description-i18n":{"vie":"Tên marketer"}},"email":{"type":"string","description":"Marketer email","x-description-i18n":{"vie":"Email marketer"}},"phone_number":{"type":"string","description":"Marketer phone number","x-description-i18n":{"vie":"Số điện thoại marketer"}},"fb_id":{"type":"string","description":"Marketer Facebook ID","x-description-i18n":{"vie":"Facebook ID marketer"}},"avatar_url":{"type":"string","description":"Marketer avatar URL","x-description-i18n":{"vie":"Link avatar marketer"}}}},"pke_mkter":{"type":"string","description":"Marketer ID","x-description-i18n":{"vie":"Mã nhân viên marketer"}},"activated_combo_products":{"type":"object","description":"Activated combo products information","x-description-i18n":{"vie":"Thông tin combo sản phẩm được kích hoạt"},"properties":{"combo_product_id":{"type":"integer","description":"Combo product ID","x-description-i18n":{"vie":"Mã combo sản phẩm"}},"quantity_combo_activated":{"type":"integer","description":"Quantity combo activated","x-description-i18n":{"vie":"Số lượng combo được kích hoạt"}},"combo_product_info":{"type":"object","description":"Combo product information","x-description-i18n":{"vie":"Thông tin combo sản phẩm"}}}},"activated_promotion_advances":{"type":"array","description":"Activated promotion advances information","x-description-i18n":{"vie":"Thông tin khuyến mãi được kích hoạt"},"items":{"type":"object","properties":{"id":{"type":"integer","description":"ID","x-description-i18n":{"vie":"Mã"}},"promotion_advance_id":{"type":"string","description":"Promotion advance ID","x-description-i18n":{"vie":"Mã khuyến mãi"}},"promotion_advance_info":{"type":"object","description":"Promotion advance information","x-description-i18n":{"vie":"Thông tin khuyến mãi"}}}}},"invoice_info_list":{"type":"array","description":"Invoice information list","x-description-i18n":{"vie":"Danh sách thông tin hóa đơn"},"items":{"type":"object","properties":{"error":{"type":"string","description":"Error message if any","x-description-i18n":{"vie":"Thông báo lỗi nếu có"}},"invoice_detail":{"type":"object","description":"Invoice detail information","x-description-i18n":{"vie":"Chi tiết thông tin hóa đơn"},"properties":{"company_address":{"type":"string","description":"Company address","x-description-i18n":{"vie":"Địa chỉ công ty"}},"company_address_breakdown":{"type":"object","description":"Company address breakdown","x-description-i18n":{"vie":"Chi tiết địa chỉ công ty"},"properties":{"company_additional_info":{"type":"string","description":"Company additional information","x-description-i18n":{"vie":"Thông tin bổ sung công ty"}},"company_barangay":{"type":"string","description":"Company barangay","x-description-i18n":{"vie":"Phường/xã công ty"}},"company_city":{"type":"string","description":"Company city","x-description-i18n":{"vie":"Thành phố công ty"}},"company_detailed_address":{"type":"string","description":"Company detailed address","x-description-i18n":{"vie":"Địa chỉ chi tiết công ty"}},"company_district":{"type":"string","description":"Company district","x-description-i18n":{"vie":"Quận/huyện công ty"}},"company_full_address":{"type":"string","description":"Company full address","x-description-i18n":{"vie":"Địa chỉ đầy đủ công ty"}},"company_postcode":{"type":"string","description":"Company postcode","x-description-i18n":{"vie":"Mã bưu điện công ty"}},"company_province":{"type":"string","description":"Company province","x-description-i18n":{"vie":"Tỉnh công ty"}},"company_region":{"type":"string","description":"Company region","x-description-i18n":{"vie":"Vùng/khu vực công ty"}},"company_state":{"type":"string","description":"Company state","x-description-i18n":{"vie":"Bang/tỉnh công ty"}},"company_town":{"type":"string","description":"Company town","x-description-i18n":{"vie":"Thị trấn/phường công ty"}}}},"company_email":{"type":"string","description":"Company email","x-description-i18n":{"vie":"Email công ty"}},"company_name":{"type":"string","description":"Company name","x-description-i18n":{"vie":"Tên công ty"}},"company_tax_id":{"type":"string","description":"Company tax ID","x-description-i18n":{"vie":"Mã số thuế công ty"}}}},"invoice_type":{"type":"string","description":"Invoice type","x-description-i18n":{"vie":"Loại hóa đơn"}},"is_requested":{"type":"boolean","description":"Request for invoice","x-description-i18n":{"vie":"Yêu cầu xuất hóa đơn"}},"order_sn":{"type":"string","description":"Order code on the marketplace","x-description-i18n":{"vie":"Mã đơn hàng trên sàn"}}}}},"reports_by_phone":{"type":"object","description":"Reports by phone number","x-description-i18n":{"vie":"Báo cáo theo số điện thoại"},"properties":{"order_fail":{"type":"integer","description":"Number of failed orders","x-description-i18n":{"vie":"Số đơn thất bại"}},"order_success":{"type":"integer","description":"Number of successful orders","x-description-i18n":{"vie":"Số đơn thành công"}},"warning":{"type":"integer","description":"Number of warnings orders","x-description-i18n":{"vie":"Số đơn cảnh báo"}}},"example":{"+639175706297":{"order_fail":29,"order_success":20,"warning":0}}},"tracking_link":{"type":"string","description":"Link confirm order","x-description-i18n":{"vie":"Link xác nhận đơn hàng"}},"ads_source":{"type":"string","description":"Advertising source","x-description-i18n":{"vie":"Nguồn quảng cáo"}},"bank_payments":{"type":"object","description":"Payment method","x-description-i18n":{"vie":"Phương thức thanh toán"}},"transfer_proofs":{"type":"array","description":"Bank transfer payment proofs, including verification time, amount and receipt images","x-description-i18n":{"vie":"Danh sách chứng từ xác thực chuyển khoản, gồm ngày giờ xác thực, số tiền và ảnh chứng từ"},"items":{"type":"object","properties":{"id":{"type":"integer","description":"Transfer proof ID","x-description-i18n":{"vie":"Mã chứng từ chuyển khoản"}},"order_id":{"type":"integer","description":"Order ID","x-description-i18n":{"vie":"Mã đơn hàng"}},"shop_id":{"type":"integer","description":"Shop ID","x-description-i18n":{"vie":"Mã cửa hàng"}},"payment_id":{"type":"string","description":"Bank payment method ID (matches a key in `bank_payments`)","x-description-i18n":{"vie":"Mã phương thức thanh toán ngân hàng (trùng với key trong `bank_payments`)"}},"amount":{"type":"integer","description":"Transferred amount","x-description-i18n":{"vie":"Số tiền chuyển khoản"}},"images":{"type":"array","description":"Transfer receipt images","x-description-i18n":{"vie":"Danh sách ảnh chứng từ chuyển khoản"},"items":{"type":"string"}},"note":{"type":"string","nullable":true,"description":"Note","x-description-i18n":{"vie":"Ghi chú"}},"is_income":{"type":"boolean","description":"Money received (true) or paid out (false)","x-description-i18n":{"vie":"Là khoản tiền nhận vào (true) hay chi ra (false)"}},"is_verify":{"type":"boolean","description":"Whether the transfer has been verified","x-description-i18n":{"vie":"Chứng từ đã được xác thực hay chưa"}},"verify_at":{"type":"string","format":"date-time","nullable":true,"description":"Verification time","x-description-i18n":{"vie":"Thời điểm xác thực chuyển khoản"}},"verifier":{"type":"object","nullable":true,"description":"Verifier information","x-description-i18n":{"vie":"Thông tin người xác thực"},"properties":{"id":{"type":"string","description":"Verifier ID","x-description-i18n":{"vie":"Mã người xác thực"}},"name":{"type":"string","description":"Verifier name","x-description-i18n":{"vie":"Tên người xác thực"}},"fb_id":{"type":"string","description":"Facebook ID of verifier","x-description-i18n":{"vie":"Facebook ID người xác thực"}},"avatar_url":{"type":"string","description":"Verifier avatar URL","x-description-i18n":{"vie":"Link avatar người xác thực"}}}},"creator":{"type":"object","nullable":true,"description":"Creator information","x-description-i18n":{"vie":"Thông tin người tạo chứng từ"},"properties":{"id":{"type":"string","description":"Creator ID","x-description-i18n":{"vie":"Mã người tạo"}},"name":{"type":"string","description":"Creator name","x-description-i18n":{"vie":"Tên người tạo"}},"fb_id":{"type":"string","description":"Facebook ID of creator","x-description-i18n":{"vie":"Facebook ID người tạo"}},"avatar_url":{"type":"string","description":"Creator avatar URL","x-description-i18n":{"vie":"Link avatar người tạo"}}}},"last_editor":{"type":"object","nullable":true,"description":"Last editor information","x-description-i18n":{"vie":"Thông tin người chỉnh sửa cuối"},"properties":{"id":{"type":"string","description":"Editor ID","x-description-i18n":{"vie":"Mã người chỉnh sửa"}},"name":{"type":"string","description":"Editor name","x-description-i18n":{"vie":"Tên người chỉnh sửa"}},"fb_id":{"type":"string","description":"Facebook ID of editor","x-description-i18n":{"vie":"Facebook ID người chỉnh sửa"}},"avatar_url":{"type":"string","description":"Editor avatar URL","x-description-i18n":{"vie":"Link avatar người chỉnh sửa"}}}},"order_info":{"type":"object","nullable":true,"description":"Additional order information","x-description-i18n":{"vie":"Thông tin đơn hàng bổ sung"}},"inserted_at":{"type":"string","format":"date-time","description":"Transfer proof creation time","x-description-i18n":{"vie":"Thời điểm tạo chứng từ"}},"updated_at":{"type":"string","format":"date-time","description":"Transfer proof update time","x-description-i18n":{"vie":"Thời điểm cập nhật chứng từ"}}}}},"shopify_order_id":{"type":"string","description":"Shopify order ID","x-description-i18n":{"vie":"Mã đơn hàng Shopify"}},"shopify_abandon_checkout_id":{"type":"integer","description":"Shopify abandon checkout ID","x-description-i18n":{"vie":"Mã Shopify abandon checkout"}},"is_abandoned_order":{"type":"boolean","description":"Abandoned-cart flag for creating or updating an order. Send it directly in the request body, not inside `third_party` or `third_party_infomation`.\nAn explicit value, including `false`, takes precedence over automatic detection. If omitted on creation, the flag is determined automatically; if omitted on update, the current value is preserved.\nOnly boolean `true` or string `\"true\"` is normalized to `true`; all other submitted values become `false`.\n","x-description-i18n":{"vie":"Cờ đơn chưa hoàn tất khi tạo hoặc cập nhật đơn. Truyền trực tiếp trong body, không bọc trong `third_party` hoặc `third_party_infomation`.\nGiá trị truyền lên, kể cả `false`, được ưu tiên hơn kết quả nhận diện tự động. Nếu bỏ qua khi tạo đơn, cờ được xác định tự động; nếu bỏ qua khi cập nhật, giữ nguyên giá trị hiện tại.\nChỉ boolean `true` hoặc chuỗi `\"true\"` được chuẩn hóa thành `true`; mọi giá trị khác được gửi lên đều thành `false`.\n"},"example":true},"cod":{"type":"integer","description":"Cash on delivery","x-description-i18n":{"vie":"Tiền thu hộ"}},"cash":{"type":"integer","description":"Cash payment","x-description-i18n":{"vie":"Tiền mặt"}},"account":{"type":"integer","description":"Order source ID","x-description-i18n":{"vie":"Mã nguồn đơn hàng"}},"account_name":{"type":"string","description":"Order source name","x-description-i18n":{"vie":"Tên mã nguồn đơn"}},"advanced_platform_fee":{"type":"object","description":"Fees from e-commerce platforms","x-description-i18n":{"vie":"Phí từ sàn thương mại điện tử"},"properties":{"ads_top_up":{"type":"integer","description":"Ads wallet top-up","x-description-i18n":{"vie":"Ví quảng cáo"}},"affiliate_commission":{"type":"integer","description":"Affiliate commission","x-description-i18n":{"vie":"Phí hoa hồng (Sàn TMĐT)"}},"diff_shipping_fee":{"type":"integer","description":"Difference shipping fee","x-description-i18n":{"vie":"Chênh lệch phí vận chuyển (Sàn TMĐT)"}},"marketplace_voucher":{"type":"integer","description":"Marketplace voucher","x-description-i18n":{"vie":"Sàn trợ giá"}},"payment_fee":{"type":"integer","description":"Payment fee","x-description-i18n":{"vie":"Phí cố định, giao dịch (Sàn TMĐT)"}},"platform_commission":{"type":"integer","description":"Platform commission","x-description-i18n":{"vie":"Phí hoa hồng nền tảng (Sàn TMĐT)"}},"seller_transaction_fee":{"type":"integer","description":"Seller transaction fee","x-description-i18n":{"vie":"Phí thanh toán (Sàn TMĐT)"}},"service_fee":{"type":"integer","description":"Service fee","x-description-i18n":{"vie":"Phí dịch vụ (Sàn TMĐT)"}},"sfp_service_fee":{"type":"integer","description":"SFP service fee","x-description-i18n":{"vie":"Phí dịch vụ SFP (Sàn TMĐT)"}}}},"printing_count":{"type":"integer","description":"Printing count","x-description-i18n":{"vie":"Số lần in"}},"money_to_collect":{"type":"integer","description":"Money to collect","x-description-i18n":{"vie":"Số tiền cần thu"}},"marketplace_id":{"type":"string","description":"Marketplace ID","enum":["-2","-3","-4","-9","-16","-17","-20","-25","-27","-28"],"x-enum-descriptions":{"-2":"Tiki","-3":"Shopee","-4":"Lazada","-9":"TikTok","-16":"WooCommerce","-17":"Shopify","-20":"Line Shopping","-25":"Tokopedia","-27":"Mercado Libre","-28":"Tiendanube"},"x-description-i18n":{"vie":"Mã sàn thương mại điện tử"}},"total_price":{"type":"integer","description":"Total price","x-description-i18n":{"vie":"Tổng giá trị sản phẩm"}},"shop_customer_address_id":{"type":"string","description":"Customer address ID","x-description-i18n":{"vie":"Mã địa chỉ khách hàng"}},"customer":{"type":"object","description":"Customer information","x-description-i18n":{"vie":"Thông tin khách hàng"},"properties":{"fb_id":{"type":"string","description":"Customer Facebook ID","x-description-i18n":{"vie":"Facebook ID khách hàng"}},"id":{"type":"string","description":"Customer ID","x-description-i18n":{"vie":"Mã khách hàng"}},"name":{"type":"string","description":"Customer name","x-description-i18n":{"vie":"Tên khách hàng"}},"page_id":{"type":"string","description":"Page ID","x-description-i18n":{"vie":"Mã trang"}}}},"total_quantity":{"type":"integer","description":"Total quantity","x-description-i18n":{"vie":"Tổng số lượng"}},"time_assign_marketer":{"type":"string","format":"date-time","description":"Time assign marketer","x-description-i18n":{"vie":"Thời điểm phân công marketer"}},"p_utm_source":{"type":"string","description":"UTM Source","x-description-i18n":{"vie":"UTM Source"}},"p_utm_medium":{"type":"string","description":"UTM Medium","x-description-i18n":{"vie":"UTM Medium"}},"p_utm_campaign":{"type":"string","description":"UTM Campaign","x-description-i18n":{"vie":"UTM Campaign"}},"p_utm_term":{"type":"string","description":"UTM Term","x-description-i18n":{"vie":"UTM Term"}},"p_utm_content":{"type":"string","description":"UTM Content","x-description-i18n":{"vie":"UTM Content"}},"p_utm_id":{"type":"string","description":"UTM ID","x-description-i18n":{"vie":"UTM ID"}},"utm_affiliate":{"type":"string","description":"Affiliate","x-description-i18n":{"vie":"Affiliate"}},"link":{"type":"string","description":"Link","x-description-i18n":{"vie":"Link"}},"status_history":{"type":"array","description":"Status update history","x-description-i18n":{"vie":"Lịch sử cập nhật trạng thái"},"items":{"type":"object","properties":{"avatar_url":{"type":"string","description":"Avatar URL","x-description-i18n":{"vie":"Link avatar"}},"editor":{"type":"object","description":"Editor information","x-description-i18n":{"vie":"Thông tin người chỉnh sửa"}},"editor_fb":{"type":"string","description":"Editor Facebook ID","x-description-i18n":{"vie":"Facebook ID người chỉnh sửa"}},"editor_id":{"type":"string","description":"Editor ID","x-description-i18n":{"vie":"Mã người chỉnh sửa"}},"name":{"type":"string","description":"Name","x-description-i18n":{"vie":"Tên"}},"old_status":{"type":"integer","description":"Old status","x-description-i18n":{"vie":"Trạng thái cũ"}},"status":{"type":"integer","description":"Status","x-description-i18n":{"vie":"Trạng thái"}},"updated_at":{"type":"string","format":"date-time","description":"Updated at","x-description-i18n":{"vie":"Thời điểm cập nhật"}}}}},"duplicated_phone":{"type":"boolean","description":"Duplicated phone","x-description-i18n":{"vie":"Số điện thoại trùng lặp"}},"order_currency":{"type":"string","description":"Order currency","x-description-i18n":{"vie":"Loại tiền tệ"}},"charged_by_vnpay":{"type":"integer","description":"Charged by VNPay","x-description-i18n":{"vie":"Số tiền thanh toán qua VNPay"}},"charged_by_qrpay":{"type":"integer","description":"Charged by QRPay","x-description-i18n":{"vie":"Số tiền khách thanh toán qua QRPAY"}},"custom_id":{"type":"string","description":"Custom ID","x-description-i18n":{"vie":"Mã tùy chỉnh"}},"last_editor":{"type":"object","description":"Last editor information","x-description-i18n":{"vie":"Thông tin người chỉnh sửa cuối cùng đơn hàng"},"properties":{"id":{"type":"string","description":"Editor ID","x-description-i18n":{"vie":"Mã người chỉnh sửa"}},"fb_id":{"type":"string","description":"Facebook ID of editor","x-description-i18n":{"vie":"Facebook ID người chỉnh sửa"}},"name":{"type":"string","description":"Editor name","x-description-i18n":{"vie":"Tên người chỉnh sửa"}},"email":{"type":"string","description":"Editor email","x-description-i18n":{"vie":"Email người chỉnh sửa"}},"avatar_url":{"type":"string","description":"Editor avatar URL","x-description-i18n":{"vie":"Link avatar người chỉnh sửa"}},"phone_number":{"type":"string","description":"Editor phone number","x-description-i18n":{"vie":"Số điện thoại người chỉnh sửa"}}}},"last_editor_id":{"type":"string","description":"Last editor ID","x-description-i18n":{"vie":"Mã người sửa cuối"}},"charged_by_momo":{"type":"integer","description":"Charged by MoMo","x-description-i18n":{"vie":"Số tiền khách thanh toán qua MOMO"}},"prepaid_by_point":{"type":"object","description":"Prepaid by point","x-description-i18n":{"vie":"Thanh toán bằng điểm thưởng"},"properties":{"money":{"type":"integer","description":"Money amount","x-description-i18n":{"vie":"Số tiền"},"example":15000},"point":{"type":"integer","description":"Point amount","x-description-i18n":{"vie":"Số điểm"},"example":15}},"example":{"money":15000,"point":15}},"bank_transfer_images":{"type":"array","description":"Bank transfer images","x-description-i18n":{"vie":"Hình ảnh chuyển khoản"},"items":{"type":"string","format":"uri"}},"transfer_money":{"type":"integer","description":"Transfer money","x-description-i18n":{"vie":"Số tiền khách chuyển khoản"}},"lock_order_by_user":{"type":"string","description":"Lock order by user ID","x-description-i18n":{"vie":"Mã người dùng khóa đơn hàng"}},"assigning_care":{"type":"object","description":"Assigning care information","x-description-i18n":{"vie":"Nhân viên chăm sóc"},"properties":{"id":{"type":"string","description":"Care ID","x-description-i18n":{"vie":"Mã người chăm sóc"}},"fb_id":{"type":"string","description":"Facebook ID of care","x-description-i18n":{"vie":"Facebook ID người chăm sóc"}},"name":{"type":"string","description":"Care name","x-description-i18n":{"vie":"Tên người chăm sóc"}},"email":{"type":"string","description":"Care email","x-description-i18n":{"vie":"Email người chăm sóc"}},"avatar_url":{"type":"string","description":"Care avatar URL","x-description-i18n":{"vie":"Link avatar người chăm sóc"}},"phone_number":{"type":"string","description":"Care phone number","x-description-i18n":{"vie":"Số điện thoại người chăm sóc"}}}},"assigning_care_id":{"type":"string","description":"Assigning care ID","x-description-i18n":{"vie":"Mã nhân viên chăm sóc"}},"time_assign_care":{"type":"string","format":"date-time","description":"Time assign care","x-description-i18n":{"vie":"Thời điểm phân công chăm sóc"}},"assigning_seller":{"type":"object","description":"Assigning seller information","x-description-i18n":{"vie":"Nhân viên được phân công"},"properties":{"id":{"type":"string","description":"Seller ID","x-description-i18n":{"vie":"Mã người bán"}},"fb_id":{"type":"string","description":"Facebook ID of seller","x-description-i18n":{"vie":"Facebook ID người bán"}},"name":{"type":"string","description":"Seller name","x-description-i18n":{"vie":"Tên người bán"}},"email":{"type":"string","description":"Seller email","x-description-i18n":{"vie":"Email người bán"}},"avatar_url":{"type":"string","description":"Seller avatar URL","x-description-i18n":{"vie":"Link avatar người bán"}},"phone_number":{"type":"string","description":"Seller phone number","x-description-i18n":{"vie":"Số điện thoại người bán"}}}},"einvoices":{"type":"array","items":{"$ref":"#/components/schemas/EInvoice"}},"charged_by_card":{"type":"integer","description":"Charged by card","x-description-i18n":{"vie":"Số tiền khách quẹt thẻ"}},"estimate_delivery_date":{"type":"string","format":"date-time","description":"Estimate delivery date","x-description-i18n":{"vie":"Ngày giao hàng dự kiến"}},"order_sources":{"type":"string","description":"Order sources ID","x-description-i18n":{"vie":"Mã nguồn đơn hàng"}},"charged_by_fundiin":{"type":"integer","description":"Charged by Fundiin","x-description-i18n":{"vie":"Số tiền thanh toán qua Fundiin"}},"surcharge":{"type":"integer","description":"Surcharge","x-description-i18n":{"vie":"Phụ thu"}},"is_linked_partner":{"type":"boolean","description":"Is linked partner","x-description-i18n":{"vie":"Đã liên kết đối tác"}},"call_laters":{"type":"array","description":"Call laters","x-description-i18n":{"vie":"Gọi lại sau"},"items":{"type":"object"}},"last_update_status_at":{"type":"string","format":"date-time","description":"Last update status at","x-description-i18n":{"vie":"Thời điểm cập nhật trạng thái cuối"}},"discount_by_customer_level":{"type":"integer","description":"Discount by customer level","x-description-i18n":{"vie":"Giảm giá theo cấp độ khách hàng"}},"viewing":{"type":"array","description":"Viewing","x-description-i18n":{"vie":"NV đang xem"},"items":{"type":"object"}},"additional_info":{"type":"object","description":"Additional info","x-description-i18n":{"vie":"Thông tin bổ sung"},"properties":{"service_partner":{"type":"string","description":"Service partner","x-description-i18n":{"vie":"Dịch vụ vận chuyển"},"enum":["instant"],"x-enum-descriptions":["Instant"],"x-enum-descriptions-i18n":{"vie":["Hỏa tốc"]}},"delivery_deadline":{"type":"string","format":"date-time","description":"Delivery deadline (ISO8601, no timezone). Send null to clear.","x-description-i18n":{"vie":"Hạn giao hàng (ISO8601, không kèm timezone). Gửi null để xóa."},"example":"2026-06-03T10:00:00"}}},"order_returned_ids":{"type":"string","description":"Order returned IDs","x-description-i18n":{"vie":"Mã đơn hàng đổi trả"}},"cost_surcharge":{"type":"integer","description":"Cost surcharge","x-description-i18n":{"vie":"Phụ phí"}},"time_send_partner":{"type":"string","format":"date-time","description":"Time send partner","x-description-i18n":{"vie":"Thời điểm gửi đơn vị vận chuyển"}},"charged_by_kredivo":{"type":"integer","description":"Charged by Kredivo","x-description-i18n":{"vie":"Số tiền thanh toán qua Kredivo"}},"discount":{"type":"integer","description":"Discount","x-description-i18n":{"vie":"Giảm giá"}},"histories":{"type":"array","description":"Histories","x-description-i18n":{"vie":"Lịch sử"},"items":{"type":"object"}},"duplicated_customer":{"type":"boolean","description":"Duplicated customer","x-description-i18n":{"vie":"Khách hàng trùng lặp"}},"customer_referral_code":{"type":"object","description":"Customer referral code","x-description-i18n":{"vie":"Mã giới thiệu khách hàng"},"properties":{"active":{"type":"string","description":"Active status","x-description-i18n":{"vie":"Trạng thái kích hoạt"},"example":"true"},"customer_id":{"type":"string","format":"uuid","description":"Customer ID","x-description-i18n":{"vie":"Mã khách hàng"},"example":"09bb9399-45f3-4897-a53a-85dde2f886fe"},"discount":{"type":"string","description":"Discount value","x-description-i18n":{"vie":"Giá trị giảm giá"},"example":"10"},"format":{"type":"string","description":"Referral code format","x-description-i18n":{"vie":"Định dạng mã giới thiệu"},"example":"{PHONE_NUMBER}"},"free_products_priced_between_approx":{"type":"object","description":"Free products priced between approximately","x-description-i18n":{"vie":"Miễn phí cho khách mới sản phẩm có giá"},"properties":{"active":{"type":"string","description":"Active status","x-description-i18n":{"vie":"Trạng thái kích hoạt"},"example":"true"},"operator":{"type":"string","description":"Comparison operator","x-description-i18n":{"vie":"Toán tử so sánh"},"example":"GreaterOrEqual"},"price":{"type":"string","description":"Price threshold","x-description-i18n":{"vie":"Ngưỡng giá"},"example":"150000"}}},"is_percent":{"type":"string","description":"Discount is percentage","x-description-i18n":{"vie":"Giảm giá theo phần trăm"},"example":"true"},"only_customers_with_level_will_have_referral_code":{"type":"string","description":"Only customers with level will have referral code","x-description-i18n":{"vie":"Chỉ khách hàng có cấp độ mới có mã giới thiệu"},"example":"true"},"referral_code":{"type":"string","description":"Referral code","x-description-i18n":{"vie":"Mã giới thiệu"},"example":"982843759"},"reward_points_for_old_customers":{"type":"object","description":"Reward points for customers","x-description-i18n":{"vie":"Điểm thưởng khách hàng"},"properties":{"active":{"type":"string","description":"Active status","x-description-i18n":{"vie":"Trạng thái kích hoạt"},"example":"true"},"money":{"type":"string","description":"Money reward","x-description-i18n":{"vie":"Tiền thưởng"},"example":"10000"},"point":{"type":"string","description":"Point reward","x-description-i18n":{"vie":"Điểm thưởng"},"example":"1"}}},"shop_customer_id":{"type":"string","format":"uuid","description":"Shop customer ID","x-description-i18n":{"vie":"Mã khách hàng shop"},"example":"f8160a4c-dfa7-4ee8-b540-d245755ea1f1"}},"example":{"active":"true","customer_id":"09bb9399-45f3-4897-a53a-85dde2f886fe","discount":"10","format":"{PHONE_NUMBER}","free_products_priced_between_approx":{"active":"true","operator":"GreaterOrEqual","price":"150000"},"is_percent":"true","only_customers_with_level_will_have_referral_code":"true","referral_code":"982843759","reward_points_for_old_customers":{"active":"true","money":"10000","point":"1"},"shop_customer_id":"f8160a4c-dfa7-4ee8-b540-d245755ea1f1"}},"tax":{"type":"integer","description":"Tax","x-description-i18n":{"vie":"Thuế"}},"is_from_ecommerce":{"type":"boolean","description":"Is from e-commerce","x-description-i18n":{"vie":"Đơn hàng từ sàn thương mại điện tử"}},"note_image":{"type":"array","description":"Note images","x-description-i18n":{"vie":"Link hình ảnh ghi chú"},"items":{"type":"string","format":"uri"}},"shopify_draft_order_id":{"type":"string","description":"Shopify draft order ID","x-description-i18n":{"vie":"Mã đơn hàng nháp Shopify"}},"display_id":{"type":"integer","description":"Display ID","x-description-i18n":{"vie":"Mã hiển thị"}},"shop_partner_id":{"type":"integer","description":"Shop partner ID","x-description-i18n":{"vie":"Mã đối tác shop"}},"is_locked":{"type":"boolean","description":"Order lock","x-description-i18n":{"vie":"Khóa đơn hàng"}},"merge_order":{"type":"boolean","description":"Allows merging orders","x-description-i18n":{"vie":"Cho phép gộp đơn"}}}}},"page_number":{"type":"integer","description":"Page number","x-description-i18n":{"vie":"Số trang"}},"page_size":{"type":"integer","description":"Page size","x-description-i18n":{"vie":"Kích thước trang"}},"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}},"total_entries":{"type":"integer","description":"Total entries","x-description-i18n":{"vie":"Tổng số bản ghi"}},"total_pages":{"type":"integer","description":"Total pages","x-description-i18n":{"vie":"Tổng số trang"}}}},"examples":{"default":{"value":{"data":[{"id":1418,"system_id":1,"shop_id":4,"inserted_at":"2020-05-12T04:51:42","updated_at":"2020-05-12T04:51:54","status":0,"status_name":"new","bill_full_name":"Hoang Anh","bill_phone_number":"0999999999","bill_email":"customer@example.com","conversation_id":"117967746266487_9306266852780716","page_id":"256469571178082","post_id":"185187094667903_477083092110915","ad_id":"23851252560290199","shipping_fee":0,"cod":0,"cash":0,"account":1,"total_discount":0,"note":"","note_print":null,"received_at_shop":false,"is_free_shipping":false,"is_locked":false,"creator_id":"8fbe2a6f-b0b2-4227-a698-19d18c43f7c8","creator":{"id":"8fbe2a6f-b0b2-4227-a698-19d18c43f7c8","fb_id":"2042723249341651","name":"Hoang Anh","avatar_url":null},"items":[],"partner":{"partner_id":1,"cod":0,"extend_code":"S58824.MB25.C3.500020713","total_fee":0,"updated_at":"2020-05-12T05:18:16","delivery_name":null,"delivery_tel":null,"picked_up_at":null,"sort_code":null,"paid_at":null,"system_created":true,"partner_status":"request_received","partner_name":"Shopee Xpress","first_delivery_at":null,"first_undeliverable_at":"2025-06-30T06:41:44","order_number_vtp":null,"printed_form":null,"extend_update":[{"key":"status","status":"delivered","tracking_id":"S58824.MB25.C3.500020713","note":"","update_at":"2020-05-12T05:18:16","webhook_params":null}]},"shipping_address":{"full_name":"Hoang Anh","phone_number":"0999999999","address":"90 Cầu Giấy","full_address":"90 Cầu Giấy, Phường Dịch Vọng, Quận Cầu Giấy, Hà Nội","province_id":"101","district_id":"10113","commune_id":"1011309"},"additional_info":{"service_partner":"instant"},"invoice_info_list":[{"error":"","invoice_detail":{"company_address":"85 lê quý đôn, phường nam định, tỉnh Ninh Bình","company_address_breakdown":{"company_additional_info":"","company_barangay":"","company_city":"","company_detailed_address":"85 lê quý đôn, phường nam định, tỉnh Ninh Bình","company_district":"Phường Nam Định","company_full_address":"85 lê quý đôn, phường nam định, tỉnh Ninh Bình","company_postcode":"","company_province":"","company_region":"VietNam","company_state":"Ninh Bình","company_town":"Phường Nam Định"},"company_email":"acb@gmail.com","company_name":"Công ty cổ phần tư vấn xây dựng điện Hoàng Phát","company_tax_id":"0601043840"},"invoice_type":"company","is_requested":true,"order_sn":"251121BVGU6RVE"}],"reports_by_phone":{"+639175706297":{"order_fail":29,"order_success":20,"warning":0}},"p_utm_source":"fb","p_utm_medium":"paid","p_utm_campaign":"120236828168640593","p_utm_term":"120236828168790593","p_utm_content":"120236828168960593","link":"https://www.myfahathai.com/doc?fbclid=IwZXh0bgNhZW0BMABhZGlkAasqwhnoX"}],"page_number":1,"page_size":100,"success":true,"total_entries":1418,"total_pages":15}}}}}}}},"post":{"summary":"Create order","x-summary-i18n":{"vie":"Tạo đơn hàng"},"description":"Create order","x-description-i18n":{"vie":"Tạo đơn hàng"},"tags":["Order"],"x-tags-i18n":{"vie":["Đơn hàng"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}}],"requestBody":{"required":true,"description":"Order information to create","x-description-i18n":{"vie":"Thông tin đơn hàng cần tạo"},"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"integer","description":"Order ID","x-description-i18n":{"vie":"Mã đơn hàng"}},"system_id":{"type":"integer","description":"System ID","x-description-i18n":{"vie":"Mã hệ thống"}},"shop_id":{"type":"integer","description":"Shop ID","x-description-i18n":{"vie":"Mã cửa hàng"}},"inserted_at":{"type":"string","format":"date-time","description":"Order creation time","x-description-i18n":{"vie":"Thời điểm tạo đơn"}},"updated_at":{"type":"string","format":"date-time","description":"Order update time","x-description-i18n":{"vie":"Thời điểm cập nhật đơn"}},"status":{"type":"integer","description":"Order status","x-description-i18n":{"vie":"Trạng thái đơn hàng"},"enum":[0,17,11,12,13,20,1,8,9,2,3,16,4,15,5,6,7],"x-enum-descriptions":["New","Waiting for confirmation","Restocking","Wait for printing","Printed","Purchased","Confirmed","Packaging","Waiting for pick up","Shipped","Received","Collected money","Returning","Partial return","Returned","Canceled","Deleted recently"],"x-enum-descriptions-i18n":{"vie":["Mới","Chờ xác nhận","Chờ hàng","Chờ in","Đã in","Đã đặt hàng","Đã xác nhận","Đang đóng hàng","Chờ chuyển hàng","Đã gửi hàng","Đã nhận","Đã thu tiền","Đang hoàn","Hoàn một phần","Đã hoàn","Đã hủy","Đã xóa"]}},"status_name":{"type":"string","description":"Order status name","x-description-i18n":{"vie":"Tên trạng thái đơn hàng"}},"bill_full_name":{"type":"string","description":"Customer name","x-description-i18n":{"vie":"Tên khách hàng"}},"bill_phone_number":{"type":"string","description":"Phone number of customer","x-description-i18n":{"vie":"SĐT khách hàng"}},"bill_email":{"type":"string","description":"Customer email","x-description-i18n":{"vie":"Email khách hàng"}},"conversation_id":{"type":"string","description":"Conversation ID","x-description-i18n":{"vie":"Mã hội thoại"}},"page_id":{"type":"string","description":"Facebook page ID","x-description-i18n":{"vie":"Mã Facebook page"}},"post_id":{"type":"string","description":"Post ID","x-description-i18n":{"vie":"Mã bài viết"}},"ad_id":{"type":"string","description":"Ad ID","x-description-i18n":{"vie":"Mã quảng cáo"}},"shipping_fee":{"type":"integer","description":"Shipping fee","x-description-i18n":{"vie":"Phí vận chuyển"}},"partner_fee":{"type":"integer","description":"Fee from shipping partner","x-description-i18n":{"vie":"Phí vận chuyển từ ĐVVC"}},"fee_marketplace":{"type":"integer","description":"Fees from e-commerce platforms","x-description-i18n":{"vie":"Phí sàn"}},"customer_pay_fee":{"type":"boolean","description":"Customer pay shipping fee","x-description-i18n":{"vie":"Khách trả phí ship"}},"is_free_shipping":{"type":"boolean","description":"Free shipping","x-description-i18n":{"vie":"Miễn phí vận chuyển"}},"is_livestream":{"type":"boolean","description":"Is livestream order","x-description-i18n":{"vie":"Đơn hàng từ livestream"}},"is_live_shopping":{"type":"boolean","description":"Is live shopping order","x-description-i18n":{"vie":"Đơn hàng từ live shopping"}},"is_smc":{"type":"boolean","description":"Shopping on Messenger","x-description-i18n":{"vie":"Đơn hàng từ mua sắm trên Messenger"}},"received_at_shop":{"type":"boolean","description":"true: Sales at counter, false: Sell online","x-description-i18n":{"vie":"true: Bán tại quầy, false: Bán online"}},"total_discount":{"type":"integer","description":"Discount total","x-description-i18n":{"vie":"Tổng tiền giảm giá"}},"note":{"type":"string","description":"Internal note","x-description-i18n":{"vie":"Ghi chú nội bộ"}},"note_print":{"type":"string","description":"Note for printing","x-description-i18n":{"vie":"Ghi chú đơn hàng"}},"returned_reason":{"type":"integer","description":"Return reason code (1: Customer, 2: Staff, 3: Defective product, 4: Shipping carrier, 5: Exchange). Other values are shop-defined custom reasons, see returned_reason_name for the display name","x-description-i18n":{"vie":"Mã lý do hoàn hàng (1: Do khách hàng, 2: Do nhân viên, 3: Do sản phẩm lỗi, 4: Do đơn vị vận chuyển, 5: Do đổi hàng). Mã khác là lý do tùy chỉnh theo từng shop, xem tên hiển thị tại returned_reason_name"}},"returned_reason_name":{"type":"string","description":"Return reason name","x-description-i18n":{"vie":"Tên lý do hoàn hàng"}},"sub_status":{"type":"integer","description":"Reason for delivery delay","x-description-i18n":{"vie":"Lý do delay giao hàng"}},"warehouse_id":{"type":"string","description":"Warehouse ID","x-description-i18n":{"vie":"Mã kho hàng"}},"warehouse_info":{"type":"object","description":"Warehouse information","x-description-i18n":{"vie":"Thông tin kho hàng"},"properties":{"name":{"type":"string","description":"Warehouse name","x-description-i18n":{"vie":"Tên kho hàng"}},"phone_number":{"type":"string","description":"Warehouse phone number","x-description-i18n":{"vie":"Số điện thoại kho hàng"}},"full_address":{"type":"string","description":"Warehouse full address","x-description-i18n":{"vie":"Địa chỉ đầy đủ kho hàng"}},"address":{"type":"string","description":"Warehouse address","x-description-i18n":{"vie":"Địa chỉ chi tiết kho hàng"}},"province_id":{"type":"string","description":"Province ID","x-description-i18n":{"vie":"Mã tỉnh thành phố"}},"district_id":{"type":"string","description":"District ID","x-description-i18n":{"vie":"Mã quận huyện"}},"commune_id":{"type":"string","description":"Commune ID","x-description-i18n":{"vie":"Mã phường xã"}},"affiliate_id":{"type":"string","description":"Affiliate ID","x-description-i18n":{"vie":"Mã đại lý"}},"ffm_id":{"type":"string","description":"FFM ID","x-description-i18n":{"vie":"Mã FFM"}},"has_snappy_service":{"type":"boolean","description":"Has Snappy service","x-description-i18n":{"vie":"Có dịch vụ Snappy"}},"custom_id":{"type":"string","description":"Custom ID","x-description-i18n":{"vie":"Mã tùy chỉnh"}}}},"creator_id":{"type":"string","description":"Creator ID","x-description-i18n":{"vie":"Mã người tạo"}},"creator":{"type":"object","description":"Order creator","x-description-i18n":{"vie":"Thông tin người tạo đơn"},"properties":{"id":{"type":"string","description":"Creator ID","x-description-i18n":{"vie":"Mã người tạo"}},"fb_id":{"type":"string","description":"Facebook ID of creator","x-description-i18n":{"vie":"ID facebook người tạo đơn"}},"name":{"type":"string","description":"Creator name","x-description-i18n":{"vie":"Tên người tạo đơn"}},"avatar_url":{"type":"string","description":"Creator avatar URL","x-description-i18n":{"vie":"Link avatar người tạo"}}}},"items":{"type":"array","description":"Product list","x-description-i18n":{"vie":"Danh sách sản phẩm"},"items":{"type":"object","required":["variation_id","quantity"],"properties":{"product_id":{"type":"string","description":"Product ID","x-description-i18n":{"vie":"Mã sản phẩm"}},"quantity":{"type":"integer","description":"Quantity","x-description-i18n":{"vie":"Số lượng"}},"returned_count":{"type":"integer","description":"Returned count","x-description-i18n":{"vie":"Số lượng đã trả"}},"assigning_seller_id":{"type":"string","description":"Assigning seller ID","x-description-i18n":{"vie":"Mã nhân viên được phân công"}},"quantity_by_combo_products":{"type":"array","description":"Quantity by combo products","x-description-i18n":{"vie":"Số lượng theo combo sản phẩm"},"items":{"type":"object"}},"discount_each_product":{"type":"integer","description":"Discount for each product","x-description-i18n":{"vie":"Giảm giá cho từng sản phẩm"}},"is_bonus_product":{"type":"boolean","description":"Is bonus product","x-description-i18n":{"vie":"Sản phẩm tặng kèm"}},"is_discount_percent":{"type":"boolean","description":"Is discount by percent","x-description-i18n":{"vie":"Giảm giá theo phần trăm"}},"is_wholesale":{"type":"boolean","description":"Is wholesale","x-description-i18n":{"vie":"Bán sỉ"}},"is_composite":{"type":"boolean","description":"Is composite product","x-description-i18n":{"vie":"Sản phẩm composite"}},"one_time_product":{"type":"boolean","description":"One time product","x-description-i18n":{"vie":"Sản phẩm một lần"}},"note":{"type":"string","description":"Product note","x-description-i18n":{"vie":"Ghi chú sản phẩm"}},"note_product":{"type":"string","description":"Product note","x-description-i18n":{"vie":"Ghi chú sản phẩm"}},"inserted_at":{"type":"string","format":"date-time","description":"Inserted at","x-description-i18n":{"vie":"Thời điểm tạo"}},"measure_group_id":{"type":"integer","description":"Measure group ID","x-description-i18n":{"vie":"Mã nhóm đơn vị tính"}},"variation_info":{"type":"object","description":"Variation information. Optional when creating/updating an order (the backend defaults it to an empty object if omitted). Its inner fields are not individually required, but sending `retail_price` is recommended so the line price is correct.","x-description-i18n":{"vie":"Thông tin biến thể. Không bắt buộc khi tạo/cập nhật đơn (backend tự coi là object rỗng nếu thiếu). Các field bên trong không bắt buộc riêng lẻ, nhưng nên gửi `retail_price` để giá dòng hàng đúng."},"properties":{"id":{"type":"string","description":"Variation ID","x-description-i18n":{"vie":"Mã biến thể"}},"name":{"type":"string","description":"Product name","x-description-i18n":{"vie":"Tên sản phẩm"}},"product_id":{"type":"string","description":"Product ID","x-description-i18n":{"vie":"Mã sản phẩm"}},"retail_price":{"type":"integer","description":"Retail price. Not strictly required, but recommended when creating/updating an order so the line price is correct.","x-description-i18n":{"vie":"Giá bán lẻ. Không bắt buộc, nhưng nên gửi khi tạo/cập nhật đơn để giá dòng hàng chính xác."}},"detail":{"type":"string","description":"Variation detail","x-description-i18n":{"vie":"Chi tiết biến thể"}},"images":{"type":"array","description":"Variation images","x-description-i18n":{"vie":"Hình ảnh biến thể"},"items":{"type":"string","format":"uri"}},"fields":{"type":"array","description":"Variation fields","x-description-i18n":{"vie":"Thuộc tính biến thể"},"items":{"type":"object","properties":{"id":{"type":"string","description":"Field ID","x-description-i18n":{"vie":"Mã thuộc tính"}},"name":{"type":"string","description":"Field name","x-description-i18n":{"vie":"Tên thuộc tính"}},"value":{"type":"string","description":"Field value","x-description-i18n":{"vie":"Giá trị thuộc tính"}},"keyValue":{"type":"string","description":"Key value","x-description-i18n":{"vie":"Giá trị khóa"}}}}},"barcode":{"type":"string","description":"Barcode","x-description-i18n":{"vie":"Mã barcode"}},"brand_id":{"type":"string","description":"Brand ID","x-description-i18n":{"vie":"Mã thương hiệu"}},"category_ids":{"type":"array","description":"Category IDs","x-description-i18n":{"vie":"Danh sách mã danh mục"},"items":{"type":"integer"}},"display_id":{"type":"string","description":"Display ID","x-description-i18n":{"vie":"Mã hiển thị"}},"product_display_id":{"type":"string","description":"Product display ID","x-description-i18n":{"vie":"Mã hiển thị sản phẩm"}},"last_imported_price":{"type":"integer","description":"Last imported price","x-description-i18n":{"vie":"Giá nhập hàng cuối"}},"is_upsale_product":{"type":"boolean","description":"Upsale product","x-description-i18n":{"vie":"Sản phẩm upsale"}},"weight":{"type":"integer","description":"Weight","x-description-i18n":{"vie":"Khối lượng"}},"measure_info":{"type":"object","description":"Measure information","x-description-i18n":{"vie":"Thông tin đơn vị tính"},"properties":{"measure_id":{"type":"integer","description":"Measure ID","x-description-i18n":{"vie":"Mã đơn vị tính"}},"exchange_value":{"type":"integer","description":"Exchange value","x-description-i18n":{"vie":"Giá trị quy đổi"}}}},"avg_price":{"type":"integer","description":"Average import price","x-description-i18n":{"vie":"Giá nhập trung bình"}}}},"components":{"type":"array","description":"Product components","x-description-i18n":{"vie":"Thành phần sản phẩm"},"items":{"type":"object","properties":{"component_id":{"type":"string","description":"Component ID","x-description-i18n":{"vie":"Mã thành phần"}},"quantity":{"type":"integer","description":"Quantity","x-description-i18n":{"vie":"Số lượng"}},"variation_id":{"type":"string","description":"Variation ID","x-description-i18n":{"vie":"Mã biến thể"}},"variation_info":{"type":"object","description":"Variation information","x-description-i18n":{"vie":"Thông tin biến thể"}}}}},"variation_id":{"type":"string","description":"Variation ID (SKU of the variation can also be used)","x-description-i18n":{"vie":"Mã mẫu mã (có thể dùng SKU của mẫu mã)"}}}}},"partner":{"type":"object","description":"Partner information","x-description-i18n":{"vie":"Thông tin đơn vị vận chuyển"},"properties":{"partner_id":{"type":"integer","description":"Partner ID","x-description-i18n":{"vie":"ID đơn vị vận chuyển trên hệ thống Pancake"}},"cod":{"type":"integer","description":"Reconciliation COD","x-description-i18n":{"vie":"Đối soát tiền thu hộ"}},"extend_code":{"type":"string","description":"Shipping order ID on partner system","x-description-i18n":{"vie":"Mã vận đơn"}},"total_fee":{"type":"integer","description":"Total fee","x-description-i18n":{"vie":"Tổng phí"}},"updated_at":{"type":"string","format":"date-time","description":"Updated at","x-description-i18n":{"vie":"Thời điểm cập nhật"}},"delivery_name":{"type":"string","description":"Shipper name","x-description-i18n":{"vie":"Tên người giao hàng"}},"delivery_tel":{"type":"string","description":"Delivery phone","x-description-i18n":{"vie":"Số điện thoại người giao hàng"}},"picked_up_at":{"type":"string","format":"date-time","description":"Picked up at","x-description-i18n":{"vie":"Thời điểm lấy hàng"}},"sort_code":{"type":"string","description":"Sort code","x-description-i18n":{"vie":"Mã phân loại"}},"paid_at":{"type":"string","format":"date-time","description":"Paid at","x-description-i18n":{"vie":"Thời điểm thanh toán"}},"system_created":{"type":"boolean","description":"System created","x-description-i18n":{"vie":"Được tạo bởi hệ thống"}},"extend_update":{"type":"array","description":"Update from courier","x-description-i18n":{"vie":"Cập nhật từ đơn vị vận chuyển"},"items":{"type":"object","properties":{"key":{"type":"string","description":"Update key","x-description-i18n":{"vie":"Mã cập nhật"}},"status":{"type":"string","description":"Status","x-description-i18n":{"vie":"Trạng thái"}},"tracking_id":{"type":"string","description":"Partner extend code","x-description-i18n":{"vie":"Mã đơn hàng đối tác"}},"note":{"type":"string","description":"Courier notes","x-description-i18n":{"vie":"Ghi chú từ đơn vị vận chuyển"}},"update_at":{"type":"string","format":"date-time","description":"Updated at","x-description-i18n":{"vie":"Thời điểm cập nhật"}}}}},"partner_status":{"type":"string","nullable":true,"description":"Partner shipping status","x-description-i18n":{"vie":"Trạng thái vận chuyển"},"enum":["waiting","request_received","processing_picked_up","picking_up","delay_pickup","picked_up","waiting_on_the_way","on_the_way","contact_delivery_company","out_for_delivery","delay_delivery","inform_recipient","undeliverable","waiting_for_return","delivered","delivered_cod","returning","returned","returned_cod","canceled"],"x-enum-descriptions":["Waiting for processing","Carrier received the request","Processing pickup","Picking up","Delayed pickup","Picked up","Waiting for transit","In transit","Contact the carrier","Out for delivery","Delayed delivery","Notify the recipient","Undeliverable","Waiting for return","Delivered","Delivered, COD reconciled","Returning","Returned","Returned, COD reconciled","Canceled"],"x-enum-descriptions-i18n":{"vie":["Chờ xử lý","ĐVVC đã tiếp nhận đơn","Đang xử lý lấy hàng","Đang lấy hàng","Trễ lấy hàng","Đã lấy hàng","Chờ trung chuyển","Đang trung chuyển","Liên hệ ĐVVC","Đang giao hàng","Trễ giao hàng","Thông báo cho người nhận","Giao không thành","Chờ chuyển hoàn","Đã giao hàng","Đã giao hàng, đã đối soát COD","Đang chuyển hoàn","Đã chuyển hoàn","Đã chuyển hoàn, đã đối soát COD","Đã hủy vận đơn"]}},"partner_name":{"type":"string","nullable":true,"description":"Partner name","x-description-i18n":{"vie":"Tên đơn vị vận chuyển"}},"first_delivery_at":{"type":"string","format":"date-time","nullable":true,"description":"First delivery time","x-description-i18n":{"vie":"Thời điểm giao hàng lần đầu"}},"first_undeliverable_at":{"type":"string","format":"date-time","nullable":true,"description":"First failed delivery time","x-description-i18n":{"vie":"Thời điểm giao hàng thất bại lần đầu"}},"order_number_vtp":{"type":"string","nullable":true,"description":"Viettel Post tracking number","x-description-i18n":{"vie":"Mã vận đơn Viettel Post"}},"printed_form":{"type":"object","nullable":true,"description":"Printed form","x-description-i18n":{"vie":"Mẫu in"}}}},"shipping_address":{"$ref":"#/components/schemas/ShippingAddress"},"payment_purchase_histories":{"type":"array","description":"Payment histories","x-description-i18n":{"vie":"Lịch sử thanh toán"},"items":{"type":"object","properties":{"amount":{"type":"integer","description":"Amount of money","x-description-i18n":{"vie":"Số tiền"}},"type":{"type":"string","description":"Payment type","x-description-i18n":{"vie":"Loại thanh toán"}},"inserted_at":{"type":"string","format":"date-time","description":"Transaction time","x-description-i18n":{"vie":"Thời điểm giao dịch"}},"result_code":{"type":"string","description":"Result code","x-description-i18n":{"vie":"Mã kết quả"}},"ipn_reply":{"type":"boolean","description":"IPN reply","x-description-i18n":{"vie":"Phản hồi IPN"}},"voucher_amount":{"type":"integer","description":"Voucher amount","x-description-i18n":{"vie":"Số tiền voucher"}},"tags":{"type":"array","description":"Tags","x-description-i18n":{"vie":"Thẻ"},"items":{"type":"string"}}}}},"tags":{"type":"array","description":"Tags list","x-description-i18n":{"vie":"Danh sách thẻ đơn hàng"},"items":{"type":"object","properties":{"id":{"type":"integer","description":"Tag ID","x-description-i18n":{"vie":"Mã thẻ đơn hàng"}},"name":{"type":"string","description":"Tag name","x-description-i18n":{"vie":"Tên thẻ đơn hàng"}}}}},"marketer":{"type":"object","description":"Marketer information","x-description-i18n":{"vie":"Thông tin marketer"},"properties":{"id":{"type":"string","description":"Marketer ID","x-description-i18n":{"vie":"Mã marketer"}},"name":{"type":"string","description":"Marketer name","x-description-i18n":{"vie":"Tên marketer"}},"email":{"type":"string","description":"Marketer email","x-description-i18n":{"vie":"Email marketer"}},"phone_number":{"type":"string","description":"Marketer phone number","x-description-i18n":{"vie":"Số điện thoại marketer"}},"fb_id":{"type":"string","description":"Marketer Facebook ID","x-description-i18n":{"vie":"Facebook ID marketer"}},"avatar_url":{"type":"string","description":"Marketer avatar URL","x-description-i18n":{"vie":"Link avatar marketer"}}}},"pke_mkter":{"type":"string","description":"Marketer ID","x-description-i18n":{"vie":"Mã nhân viên marketer"}},"activated_combo_products":{"type":"object","description":"Activated combo products information","x-description-i18n":{"vie":"Thông tin combo sản phẩm được kích hoạt"},"properties":{"combo_product_id":{"type":"integer","description":"Combo product ID","x-description-i18n":{"vie":"Mã combo sản phẩm"}},"quantity_combo_activated":{"type":"integer","description":"Quantity combo activated","x-description-i18n":{"vie":"Số lượng combo được kích hoạt"}},"combo_product_info":{"type":"object","description":"Combo product information","x-description-i18n":{"vie":"Thông tin combo sản phẩm"}}}},"activated_promotion_advances":{"type":"array","description":"Activated promotion advances information","x-description-i18n":{"vie":"Thông tin khuyến mãi được kích hoạt"},"items":{"type":"object","properties":{"id":{"type":"integer","description":"ID","x-description-i18n":{"vie":"Mã"}},"promotion_advance_id":{"type":"string","description":"Promotion advance ID","x-description-i18n":{"vie":"Mã khuyến mãi"}},"promotion_advance_info":{"type":"object","description":"Promotion advance information","x-description-i18n":{"vie":"Thông tin khuyến mãi"}}}}},"invoice_info_list":{"type":"array","description":"Invoice information list","x-description-i18n":{"vie":"Danh sách thông tin hóa đơn"},"items":{"type":"object","properties":{"error":{"type":"string","description":"Error message if any","x-description-i18n":{"vie":"Thông báo lỗi nếu có"}},"invoice_detail":{"type":"object","description":"Invoice detail information","x-description-i18n":{"vie":"Chi tiết thông tin hóa đơn"},"properties":{"company_address":{"type":"string","description":"Company address","x-description-i18n":{"vie":"Địa chỉ công ty"}},"company_address_breakdown":{"type":"object","description":"Company address breakdown","x-description-i18n":{"vie":"Chi tiết địa chỉ công ty"},"properties":{"company_additional_info":{"type":"string","description":"Company additional information","x-description-i18n":{"vie":"Thông tin bổ sung công ty"}},"company_barangay":{"type":"string","description":"Company barangay","x-description-i18n":{"vie":"Phường/xã công ty"}},"company_city":{"type":"string","description":"Company city","x-description-i18n":{"vie":"Thành phố công ty"}},"company_detailed_address":{"type":"string","description":"Company detailed address","x-description-i18n":{"vie":"Địa chỉ chi tiết công ty"}},"company_district":{"type":"string","description":"Company district","x-description-i18n":{"vie":"Quận/huyện công ty"}},"company_full_address":{"type":"string","description":"Company full address","x-description-i18n":{"vie":"Địa chỉ đầy đủ công ty"}},"company_postcode":{"type":"string","description":"Company postcode","x-description-i18n":{"vie":"Mã bưu điện công ty"}},"company_province":{"type":"string","description":"Company province","x-description-i18n":{"vie":"Tỉnh công ty"}},"company_region":{"type":"string","description":"Company region","x-description-i18n":{"vie":"Vùng/khu vực công ty"}},"company_state":{"type":"string","description":"Company state","x-description-i18n":{"vie":"Bang/tỉnh công ty"}},"company_town":{"type":"string","description":"Company town","x-description-i18n":{"vie":"Thị trấn/phường công ty"}}}},"company_email":{"type":"string","description":"Company email","x-description-i18n":{"vie":"Email công ty"}},"company_name":{"type":"string","description":"Company name","x-description-i18n":{"vie":"Tên công ty"}},"company_tax_id":{"type":"string","description":"Company tax ID","x-description-i18n":{"vie":"Mã số thuế công ty"}}}},"invoice_type":{"type":"string","description":"Invoice type","x-description-i18n":{"vie":"Loại hóa đơn"}},"is_requested":{"type":"boolean","description":"Request for invoice","x-description-i18n":{"vie":"Yêu cầu xuất hóa đơn"}},"order_sn":{"type":"string","description":"Order code on the marketplace","x-description-i18n":{"vie":"Mã đơn hàng trên sàn"}}}}},"reports_by_phone":{"type":"object","description":"Reports by phone number","x-description-i18n":{"vie":"Báo cáo theo số điện thoại"},"properties":{"order_fail":{"type":"integer","description":"Number of failed orders","x-description-i18n":{"vie":"Số đơn thất bại"}},"order_success":{"type":"integer","description":"Number of successful orders","x-description-i18n":{"vie":"Số đơn thành công"}},"warning":{"type":"integer","description":"Number of warnings orders","x-description-i18n":{"vie":"Số đơn cảnh báo"}}},"example":{"+639175706297":{"order_fail":29,"order_success":20,"warning":0}}},"tracking_link":{"type":"string","description":"Link confirm order","x-description-i18n":{"vie":"Link xác nhận đơn hàng"}},"ads_source":{"type":"string","description":"Advertising source","x-description-i18n":{"vie":"Nguồn quảng cáo"}},"bank_payments":{"type":"object","description":"Payment method","x-description-i18n":{"vie":"Phương thức thanh toán"}},"transfer_proofs":{"type":"array","description":"Bank transfer payment proofs, including verification time, amount and receipt images","x-description-i18n":{"vie":"Danh sách chứng từ xác thực chuyển khoản, gồm ngày giờ xác thực, số tiền và ảnh chứng từ"},"items":{"type":"object","properties":{"id":{"type":"integer","description":"Transfer proof ID","x-description-i18n":{"vie":"Mã chứng từ chuyển khoản"}},"order_id":{"type":"integer","description":"Order ID","x-description-i18n":{"vie":"Mã đơn hàng"}},"shop_id":{"type":"integer","description":"Shop ID","x-description-i18n":{"vie":"Mã cửa hàng"}},"payment_id":{"type":"string","description":"Bank payment method ID (matches a key in `bank_payments`)","x-description-i18n":{"vie":"Mã phương thức thanh toán ngân hàng (trùng với key trong `bank_payments`)"}},"amount":{"type":"integer","description":"Transferred amount","x-description-i18n":{"vie":"Số tiền chuyển khoản"}},"images":{"type":"array","description":"Transfer receipt images","x-description-i18n":{"vie":"Danh sách ảnh chứng từ chuyển khoản"},"items":{"type":"string"}},"note":{"type":"string","nullable":true,"description":"Note","x-description-i18n":{"vie":"Ghi chú"}},"is_income":{"type":"boolean","description":"Money received (true) or paid out (false)","x-description-i18n":{"vie":"Là khoản tiền nhận vào (true) hay chi ra (false)"}},"is_verify":{"type":"boolean","description":"Whether the transfer has been verified","x-description-i18n":{"vie":"Chứng từ đã được xác thực hay chưa"}},"verify_at":{"type":"string","format":"date-time","nullable":true,"description":"Verification time","x-description-i18n":{"vie":"Thời điểm xác thực chuyển khoản"}},"verifier":{"type":"object","nullable":true,"description":"Verifier information","x-description-i18n":{"vie":"Thông tin người xác thực"},"properties":{"id":{"type":"string","description":"Verifier ID","x-description-i18n":{"vie":"Mã người xác thực"}},"name":{"type":"string","description":"Verifier name","x-description-i18n":{"vie":"Tên người xác thực"}},"fb_id":{"type":"string","description":"Facebook ID of verifier","x-description-i18n":{"vie":"Facebook ID người xác thực"}},"avatar_url":{"type":"string","description":"Verifier avatar URL","x-description-i18n":{"vie":"Link avatar người xác thực"}}}},"creator":{"type":"object","nullable":true,"description":"Creator information","x-description-i18n":{"vie":"Thông tin người tạo chứng từ"},"properties":{"id":{"type":"string","description":"Creator ID","x-description-i18n":{"vie":"Mã người tạo"}},"name":{"type":"string","description":"Creator name","x-description-i18n":{"vie":"Tên người tạo"}},"fb_id":{"type":"string","description":"Facebook ID of creator","x-description-i18n":{"vie":"Facebook ID người tạo"}},"avatar_url":{"type":"string","description":"Creator avatar URL","x-description-i18n":{"vie":"Link avatar người tạo"}}}},"last_editor":{"type":"object","nullable":true,"description":"Last editor information","x-description-i18n":{"vie":"Thông tin người chỉnh sửa cuối"},"properties":{"id":{"type":"string","description":"Editor ID","x-description-i18n":{"vie":"Mã người chỉnh sửa"}},"name":{"type":"string","description":"Editor name","x-description-i18n":{"vie":"Tên người chỉnh sửa"}},"fb_id":{"type":"string","description":"Facebook ID of editor","x-description-i18n":{"vie":"Facebook ID người chỉnh sửa"}},"avatar_url":{"type":"string","description":"Editor avatar URL","x-description-i18n":{"vie":"Link avatar người chỉnh sửa"}}}},"order_info":{"type":"object","nullable":true,"description":"Additional order information","x-description-i18n":{"vie":"Thông tin đơn hàng bổ sung"}},"inserted_at":{"type":"string","format":"date-time","description":"Transfer proof creation time","x-description-i18n":{"vie":"Thời điểm tạo chứng từ"}},"updated_at":{"type":"string","format":"date-time","description":"Transfer proof update time","x-description-i18n":{"vie":"Thời điểm cập nhật chứng từ"}}}}},"shopify_order_id":{"type":"string","description":"Shopify order ID","x-description-i18n":{"vie":"Mã đơn hàng Shopify"}},"shopify_abandon_checkout_id":{"type":"integer","description":"Shopify abandon checkout ID","x-description-i18n":{"vie":"Mã Shopify abandon checkout"}},"is_abandoned_order":{"type":"boolean","description":"Abandoned-cart flag for creating or updating an order. Send it directly in the request body, not inside `third_party` or `third_party_infomation`.\nAn explicit value, including `false`, takes precedence over automatic detection. If omitted on creation, the flag is determined automatically; if omitted on update, the current value is preserved.\nOnly boolean `true` or string `\"true\"` is normalized to `true`; all other submitted values become `false`.\n","x-description-i18n":{"vie":"Cờ đơn chưa hoàn tất khi tạo hoặc cập nhật đơn. Truyền trực tiếp trong body, không bọc trong `third_party` hoặc `third_party_infomation`.\nGiá trị truyền lên, kể cả `false`, được ưu tiên hơn kết quả nhận diện tự động. Nếu bỏ qua khi tạo đơn, cờ được xác định tự động; nếu bỏ qua khi cập nhật, giữ nguyên giá trị hiện tại.\nChỉ boolean `true` hoặc chuỗi `\"true\"` được chuẩn hóa thành `true`; mọi giá trị khác được gửi lên đều thành `false`.\n"},"example":true},"cod":{"type":"integer","description":"Cash on delivery","x-description-i18n":{"vie":"Tiền thu hộ"}},"cash":{"type":"integer","description":"Cash payment","x-description-i18n":{"vie":"Tiền mặt"}},"account":{"type":"integer","description":"Order source ID","x-description-i18n":{"vie":"Mã nguồn đơn hàng"}},"account_name":{"type":"string","description":"Order source name","x-description-i18n":{"vie":"Tên mã nguồn đơn"}},"advanced_platform_fee":{"type":"object","description":"Fees from e-commerce platforms","x-description-i18n":{"vie":"Phí từ sàn thương mại điện tử"},"properties":{"ads_top_up":{"type":"integer","description":"Ads wallet top-up","x-description-i18n":{"vie":"Ví quảng cáo"}},"affiliate_commission":{"type":"integer","description":"Affiliate commission","x-description-i18n":{"vie":"Phí hoa hồng (Sàn TMĐT)"}},"diff_shipping_fee":{"type":"integer","description":"Difference shipping fee","x-description-i18n":{"vie":"Chênh lệch phí vận chuyển (Sàn TMĐT)"}},"marketplace_voucher":{"type":"integer","description":"Marketplace voucher","x-description-i18n":{"vie":"Sàn trợ giá"}},"payment_fee":{"type":"integer","description":"Payment fee","x-description-i18n":{"vie":"Phí cố định, giao dịch (Sàn TMĐT)"}},"platform_commission":{"type":"integer","description":"Platform commission","x-description-i18n":{"vie":"Phí hoa hồng nền tảng (Sàn TMĐT)"}},"seller_transaction_fee":{"type":"integer","description":"Seller transaction fee","x-description-i18n":{"vie":"Phí thanh toán (Sàn TMĐT)"}},"service_fee":{"type":"integer","description":"Service fee","x-description-i18n":{"vie":"Phí dịch vụ (Sàn TMĐT)"}},"sfp_service_fee":{"type":"integer","description":"SFP service fee","x-description-i18n":{"vie":"Phí dịch vụ SFP (Sàn TMĐT)"}}}},"printing_count":{"type":"integer","description":"Printing count","x-description-i18n":{"vie":"Số lần in"}},"money_to_collect":{"type":"integer","description":"Money to collect","x-description-i18n":{"vie":"Số tiền cần thu"}},"marketplace_id":{"type":"string","description":"Marketplace ID","enum":["-2","-3","-4","-9","-16","-17","-20","-25","-27","-28"],"x-enum-descriptions":{"-2":"Tiki","-3":"Shopee","-4":"Lazada","-9":"TikTok","-16":"WooCommerce","-17":"Shopify","-20":"Line Shopping","-25":"Tokopedia","-27":"Mercado Libre","-28":"Tiendanube"},"x-description-i18n":{"vie":"Mã sàn thương mại điện tử"}},"total_price":{"type":"integer","description":"Total price","x-description-i18n":{"vie":"Tổng giá trị sản phẩm"}},"shop_customer_address_id":{"type":"string","description":"Customer address ID","x-description-i18n":{"vie":"Mã địa chỉ khách hàng"}},"customer":{"type":"object","description":"Customer information","x-description-i18n":{"vie":"Thông tin khách hàng"},"properties":{"fb_id":{"type":"string","description":"Customer Facebook ID","x-description-i18n":{"vie":"Facebook ID khách hàng"}},"id":{"type":"string","description":"Customer ID","x-description-i18n":{"vie":"Mã khách hàng"}},"name":{"type":"string","description":"Customer name","x-description-i18n":{"vie":"Tên khách hàng"}},"page_id":{"type":"string","description":"Page ID","x-description-i18n":{"vie":"Mã trang"}}}},"total_quantity":{"type":"integer","description":"Total quantity","x-description-i18n":{"vie":"Tổng số lượng"}},"time_assign_marketer":{"type":"string","format":"date-time","description":"Time assign marketer","x-description-i18n":{"vie":"Thời điểm phân công marketer"}},"p_utm_source":{"type":"string","description":"UTM Source","x-description-i18n":{"vie":"UTM Source"}},"p_utm_medium":{"type":"string","description":"UTM Medium","x-description-i18n":{"vie":"UTM Medium"}},"p_utm_campaign":{"type":"string","description":"UTM Campaign","x-description-i18n":{"vie":"UTM Campaign"}},"p_utm_term":{"type":"string","description":"UTM Term","x-description-i18n":{"vie":"UTM Term"}},"p_utm_content":{"type":"string","description":"UTM Content","x-description-i18n":{"vie":"UTM Content"}},"p_utm_id":{"type":"string","description":"UTM ID","x-description-i18n":{"vie":"UTM ID"}},"utm_affiliate":{"type":"string","description":"Affiliate","x-description-i18n":{"vie":"Affiliate"}},"link":{"type":"string","description":"Link","x-description-i18n":{"vie":"Link"}},"status_history":{"type":"array","description":"Status update history","x-description-i18n":{"vie":"Lịch sử cập nhật trạng thái"},"items":{"type":"object","properties":{"avatar_url":{"type":"string","description":"Avatar URL","x-description-i18n":{"vie":"Link avatar"}},"editor":{"type":"object","description":"Editor information","x-description-i18n":{"vie":"Thông tin người chỉnh sửa"}},"editor_fb":{"type":"string","description":"Editor Facebook ID","x-description-i18n":{"vie":"Facebook ID người chỉnh sửa"}},"editor_id":{"type":"string","description":"Editor ID","x-description-i18n":{"vie":"Mã người chỉnh sửa"}},"name":{"type":"string","description":"Name","x-description-i18n":{"vie":"Tên"}},"old_status":{"type":"integer","description":"Old status","x-description-i18n":{"vie":"Trạng thái cũ"}},"status":{"type":"integer","description":"Status","x-description-i18n":{"vie":"Trạng thái"}},"updated_at":{"type":"string","format":"date-time","description":"Updated at","x-description-i18n":{"vie":"Thời điểm cập nhật"}}}}},"duplicated_phone":{"type":"boolean","description":"Duplicated phone","x-description-i18n":{"vie":"Số điện thoại trùng lặp"}},"order_currency":{"type":"string","description":"Order currency","x-description-i18n":{"vie":"Loại tiền tệ"}},"charged_by_vnpay":{"type":"integer","description":"Charged by VNPay","x-description-i18n":{"vie":"Số tiền thanh toán qua VNPay"}},"charged_by_qrpay":{"type":"integer","description":"Charged by QRPay","x-description-i18n":{"vie":"Số tiền khách thanh toán qua QRPAY"}},"custom_id":{"type":"string","description":"Custom ID","x-description-i18n":{"vie":"Mã tùy chỉnh"}},"last_editor":{"type":"object","description":"Last editor information","x-description-i18n":{"vie":"Thông tin người chỉnh sửa cuối cùng đơn hàng"},"properties":{"id":{"type":"string","description":"Editor ID","x-description-i18n":{"vie":"Mã người chỉnh sửa"}},"fb_id":{"type":"string","description":"Facebook ID of editor","x-description-i18n":{"vie":"Facebook ID người chỉnh sửa"}},"name":{"type":"string","description":"Editor name","x-description-i18n":{"vie":"Tên người chỉnh sửa"}},"email":{"type":"string","description":"Editor email","x-description-i18n":{"vie":"Email người chỉnh sửa"}},"avatar_url":{"type":"string","description":"Editor avatar URL","x-description-i18n":{"vie":"Link avatar người chỉnh sửa"}},"phone_number":{"type":"string","description":"Editor phone number","x-description-i18n":{"vie":"Số điện thoại người chỉnh sửa"}}}},"last_editor_id":{"type":"string","description":"Last editor ID","x-description-i18n":{"vie":"Mã người sửa cuối"}},"charged_by_momo":{"type":"integer","description":"Charged by MoMo","x-description-i18n":{"vie":"Số tiền khách thanh toán qua MOMO"}},"prepaid_by_point":{"type":"object","description":"Prepaid by point","x-description-i18n":{"vie":"Thanh toán bằng điểm thưởng"},"properties":{"money":{"type":"integer","description":"Money amount","x-description-i18n":{"vie":"Số tiền"},"example":15000},"point":{"type":"integer","description":"Point amount","x-description-i18n":{"vie":"Số điểm"},"example":15}},"example":{"money":15000,"point":15}},"bank_transfer_images":{"type":"array","description":"Bank transfer images","x-description-i18n":{"vie":"Hình ảnh chuyển khoản"},"items":{"type":"string","format":"uri"}},"transfer_money":{"type":"integer","description":"Transfer money","x-description-i18n":{"vie":"Số tiền khách chuyển khoản"}},"lock_order_by_user":{"type":"string","description":"Lock order by user ID","x-description-i18n":{"vie":"Mã người dùng khóa đơn hàng"}},"assigning_care":{"type":"object","description":"Assigning care information","x-description-i18n":{"vie":"Nhân viên chăm sóc"},"properties":{"id":{"type":"string","description":"Care ID","x-description-i18n":{"vie":"Mã người chăm sóc"}},"fb_id":{"type":"string","description":"Facebook ID of care","x-description-i18n":{"vie":"Facebook ID người chăm sóc"}},"name":{"type":"string","description":"Care name","x-description-i18n":{"vie":"Tên người chăm sóc"}},"email":{"type":"string","description":"Care email","x-description-i18n":{"vie":"Email người chăm sóc"}},"avatar_url":{"type":"string","description":"Care avatar URL","x-description-i18n":{"vie":"Link avatar người chăm sóc"}},"phone_number":{"type":"string","description":"Care phone number","x-description-i18n":{"vie":"Số điện thoại người chăm sóc"}}}},"assigning_care_id":{"type":"string","description":"Assigning care ID","x-description-i18n":{"vie":"Mã nhân viên chăm sóc"}},"time_assign_care":{"type":"string","format":"date-time","description":"Time assign care","x-description-i18n":{"vie":"Thời điểm phân công chăm sóc"}},"assigning_seller":{"type":"object","description":"Assigning seller information","x-description-i18n":{"vie":"Nhân viên được phân công"},"properties":{"id":{"type":"string","description":"Seller ID","x-description-i18n":{"vie":"Mã người bán"}},"fb_id":{"type":"string","description":"Facebook ID of seller","x-description-i18n":{"vie":"Facebook ID người bán"}},"name":{"type":"string","description":"Seller name","x-description-i18n":{"vie":"Tên người bán"}},"email":{"type":"string","description":"Seller email","x-description-i18n":{"vie":"Email người bán"}},"avatar_url":{"type":"string","description":"Seller avatar URL","x-description-i18n":{"vie":"Link avatar người bán"}},"phone_number":{"type":"string","description":"Seller phone number","x-description-i18n":{"vie":"Số điện thoại người bán"}}}},"einvoices":{"type":"array","items":{"$ref":"#/components/schemas/EInvoice"}},"charged_by_card":{"type":"integer","description":"Charged by card","x-description-i18n":{"vie":"Số tiền khách quẹt thẻ"}},"estimate_delivery_date":{"type":"string","format":"date-time","description":"Estimate delivery date","x-description-i18n":{"vie":"Ngày giao hàng dự kiến"}},"order_sources":{"type":"string","description":"Order sources ID","x-description-i18n":{"vie":"Mã nguồn đơn hàng"}},"charged_by_fundiin":{"type":"integer","description":"Charged by Fundiin","x-description-i18n":{"vie":"Số tiền thanh toán qua Fundiin"}},"surcharge":{"type":"integer","description":"Surcharge","x-description-i18n":{"vie":"Phụ thu"}},"is_linked_partner":{"type":"boolean","description":"Is linked partner","x-description-i18n":{"vie":"Đã liên kết đối tác"}},"call_laters":{"type":"array","description":"Call laters","x-description-i18n":{"vie":"Gọi lại sau"},"items":{"type":"object"}},"last_update_status_at":{"type":"string","format":"date-time","description":"Last update status at","x-description-i18n":{"vie":"Thời điểm cập nhật trạng thái cuối"}},"discount_by_customer_level":{"type":"integer","description":"Discount by customer level","x-description-i18n":{"vie":"Giảm giá theo cấp độ khách hàng"}},"viewing":{"type":"array","description":"Viewing","x-description-i18n":{"vie":"NV đang xem"},"items":{"type":"object"}},"additional_info":{"type":"object","description":"Additional info","x-description-i18n":{"vie":"Thông tin bổ sung"},"properties":{"service_partner":{"type":"string","description":"Service partner","x-description-i18n":{"vie":"Dịch vụ vận chuyển"},"enum":["instant"],"x-enum-descriptions":["Instant"],"x-enum-descriptions-i18n":{"vie":["Hỏa tốc"]}},"delivery_deadline":{"type":"string","format":"date-time","description":"Delivery deadline (ISO8601, no timezone). Send null to clear.","x-description-i18n":{"vie":"Hạn giao hàng (ISO8601, không kèm timezone). Gửi null để xóa."},"example":"2026-06-03T10:00:00"}}},"order_returned_ids":{"type":"string","description":"Order returned IDs","x-description-i18n":{"vie":"Mã đơn hàng đổi trả"}},"cost_surcharge":{"type":"integer","description":"Cost surcharge","x-description-i18n":{"vie":"Phụ phí"}},"time_send_partner":{"type":"string","format":"date-time","description":"Time send partner","x-description-i18n":{"vie":"Thời điểm gửi đơn vị vận chuyển"}},"charged_by_kredivo":{"type":"integer","description":"Charged by Kredivo","x-description-i18n":{"vie":"Số tiền thanh toán qua Kredivo"}},"discount":{"type":"integer","description":"Discount","x-description-i18n":{"vie":"Giảm giá"}},"histories":{"type":"array","description":"Histories","x-description-i18n":{"vie":"Lịch sử"},"items":{"type":"object"}},"duplicated_customer":{"type":"boolean","description":"Duplicated customer","x-description-i18n":{"vie":"Khách hàng trùng lặp"}},"customer_referral_code":{"type":"object","description":"Customer referral code","x-description-i18n":{"vie":"Mã giới thiệu khách hàng"},"properties":{"active":{"type":"string","description":"Active status","x-description-i18n":{"vie":"Trạng thái kích hoạt"},"example":"true"},"customer_id":{"type":"string","format":"uuid","description":"Customer ID","x-description-i18n":{"vie":"Mã khách hàng"},"example":"09bb9399-45f3-4897-a53a-85dde2f886fe"},"discount":{"type":"string","description":"Discount value","x-description-i18n":{"vie":"Giá trị giảm giá"},"example":"10"},"format":{"type":"string","description":"Referral code format","x-description-i18n":{"vie":"Định dạng mã giới thiệu"},"example":"{PHONE_NUMBER}"},"free_products_priced_between_approx":{"type":"object","description":"Free products priced between approximately","x-description-i18n":{"vie":"Miễn phí cho khách mới sản phẩm có giá"},"properties":{"active":{"type":"string","description":"Active status","x-description-i18n":{"vie":"Trạng thái kích hoạt"},"example":"true"},"operator":{"type":"string","description":"Comparison operator","x-description-i18n":{"vie":"Toán tử so sánh"},"example":"GreaterOrEqual"},"price":{"type":"string","description":"Price threshold","x-description-i18n":{"vie":"Ngưỡng giá"},"example":"150000"}}},"is_percent":{"type":"string","description":"Discount is percentage","x-description-i18n":{"vie":"Giảm giá theo phần trăm"},"example":"true"},"only_customers_with_level_will_have_referral_code":{"type":"string","description":"Only customers with level will have referral code","x-description-i18n":{"vie":"Chỉ khách hàng có cấp độ mới có mã giới thiệu"},"example":"true"},"referral_code":{"type":"string","description":"Referral code","x-description-i18n":{"vie":"Mã giới thiệu"},"example":"982843759"},"reward_points_for_old_customers":{"type":"object","description":"Reward points for customers","x-description-i18n":{"vie":"Điểm thưởng khách hàng"},"properties":{"active":{"type":"string","description":"Active status","x-description-i18n":{"vie":"Trạng thái kích hoạt"},"example":"true"},"money":{"type":"string","description":"Money reward","x-description-i18n":{"vie":"Tiền thưởng"},"example":"10000"},"point":{"type":"string","description":"Point reward","x-description-i18n":{"vie":"Điểm thưởng"},"example":"1"}}},"shop_customer_id":{"type":"string","format":"uuid","description":"Shop customer ID","x-description-i18n":{"vie":"Mã khách hàng shop"},"example":"f8160a4c-dfa7-4ee8-b540-d245755ea1f1"}},"example":{"active":"true","customer_id":"09bb9399-45f3-4897-a53a-85dde2f886fe","discount":"10","format":"{PHONE_NUMBER}","free_products_priced_between_approx":{"active":"true","operator":"GreaterOrEqual","price":"150000"},"is_percent":"true","only_customers_with_level_will_have_referral_code":"true","referral_code":"982843759","reward_points_for_old_customers":{"active":"true","money":"10000","point":"1"},"shop_customer_id":"f8160a4c-dfa7-4ee8-b540-d245755ea1f1"}},"tax":{"type":"integer","description":"Tax","x-description-i18n":{"vie":"Thuế"}},"is_from_ecommerce":{"type":"boolean","description":"Is from e-commerce","x-description-i18n":{"vie":"Đơn hàng từ sàn thương mại điện tử"}},"note_image":{"type":"array","description":"Note images","x-description-i18n":{"vie":"Link hình ảnh ghi chú"},"items":{"type":"string","format":"uri"}},"shopify_draft_order_id":{"type":"string","description":"Shopify draft order ID","x-description-i18n":{"vie":"Mã đơn hàng nháp Shopify"}},"display_id":{"type":"integer","description":"Display ID","x-description-i18n":{"vie":"Mã hiển thị"}},"shop_partner_id":{"type":"integer","description":"Shop partner ID","x-description-i18n":{"vie":"Mã đối tác shop"}},"is_locked":{"type":"boolean","description":"Order lock","x-description-i18n":{"vie":"Khóa đơn hàng"}},"merge_order":{"type":"boolean","description":"Allows merging orders","x-description-i18n":{"vie":"Cho phép gộp đơn"}}},"required":["shop_id"]},"example":{"is_abandoned_order":true,"bill_full_name":"Hoang Anh","bill_phone_number":"0999999999","conversation_id":"117967746266487_9306266852780716","is_free_shipping":false,"received_at_shop":false,"page_id":"256469571178082","account":4,"account_name":"facebook321","assigning_seller_id":"340644fc-314d-450e-a45f-33343678cab6","items":[{"discount_each_product":0,"is_bonus_product":false,"is_discount_percent":false,"is_wholesale":false,"one_time_product":false,"quantity":1,"variation_id":"415040f4-ab63-465e-8699-e9ebfff4c6c7","product_id":"3487e126-b0d9-4dae-89a9-ee60bef2f4e9","variation_info":{"detail":null,"fields":null,"display_id":null,"name":"aaaaaa","product_display_id":null,"retail_price":100000,"weight":100}}],"note":"","note_print":null,"merge_order":false,"returned_reason":1,"warehouse_id":"630744ef-4614-4a70-988c-52e6d78c953c","shipping_address":{"address":"aaaaa","commune_id":"2210941","country_code":null,"district_id":"22109","full_address":"aaaaa, Xã Bắc Lý, Huyện Hiệp Hòa, Bắc Giang","full_name":"hoang anh","phone_number":"0999999999","post_code":null,"province_id":"221"},"shipping_fee":0,"shop_id":4,"total_discount":0,"warehouse_info":{"district_id":"10111","full_address":"kakakaka, Phường Khương Trung, Quận Thanh Xuân, Hà Nội","name":"snappy","phone_number":"0999999999","province_id":"101"},"custom_id":"Ma0001","activated_promotion_advances":[{"promotion_advance_id":"fb056b32-9cf6-4c5a-92de-0eb94db71121","is_activated":true}],"status":0,"cash":0}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"integer","description":"Order ID","x-description-i18n":{"vie":"Mã đơn hàng"}},"system_id":{"type":"integer","description":"System ID","x-description-i18n":{"vie":"Mã hệ thống"}},"shop_id":{"type":"integer","description":"Shop ID","x-description-i18n":{"vie":"Mã cửa hàng"}},"inserted_at":{"type":"string","format":"date-time","description":"Order creation time","x-description-i18n":{"vie":"Thời điểm tạo đơn"}},"updated_at":{"type":"string","format":"date-time","description":"Order update time","x-description-i18n":{"vie":"Thời điểm cập nhật đơn"}},"status":{"type":"integer","description":"Order status","x-description-i18n":{"vie":"Trạng thái đơn hàng"},"enum":[0,17,11,12,13,20,1,8,9,2,3,16,4,15,5,6,7],"x-enum-descriptions":["New","Waiting for confirmation","Restocking","Wait for printing","Printed","Purchased","Confirmed","Packaging","Waiting for pick up","Shipped","Received","Collected money","Returning","Partial return","Returned","Canceled","Deleted recently"],"x-enum-descriptions-i18n":{"vie":["Mới","Chờ xác nhận","Chờ hàng","Chờ in","Đã in","Đã đặt hàng","Đã xác nhận","Đang đóng hàng","Chờ chuyển hàng","Đã gửi hàng","Đã nhận","Đã thu tiền","Đang hoàn","Hoàn một phần","Đã hoàn","Đã hủy","Đã xóa"]}},"status_name":{"type":"string","description":"Order status name","x-description-i18n":{"vie":"Tên trạng thái đơn hàng"}},"bill_full_name":{"type":"string","description":"Customer name","x-description-i18n":{"vie":"Tên khách hàng"}},"bill_phone_number":{"type":"string","description":"Phone number of customer","x-description-i18n":{"vie":"SĐT khách hàng"}},"bill_email":{"type":"string","description":"Customer email","x-description-i18n":{"vie":"Email khách hàng"}},"conversation_id":{"type":"string","description":"Conversation ID","x-description-i18n":{"vie":"Mã hội thoại"}},"page_id":{"type":"string","description":"Facebook page ID","x-description-i18n":{"vie":"Mã Facebook page"}},"post_id":{"type":"string","description":"Post ID","x-description-i18n":{"vie":"Mã bài viết"}},"ad_id":{"type":"string","description":"Ad ID","x-description-i18n":{"vie":"Mã quảng cáo"}},"shipping_fee":{"type":"integer","description":"Shipping fee","x-description-i18n":{"vie":"Phí vận chuyển"}},"partner_fee":{"type":"integer","description":"Fee from shipping partner","x-description-i18n":{"vie":"Phí vận chuyển từ ĐVVC"}},"fee_marketplace":{"type":"integer","description":"Fees from e-commerce platforms","x-description-i18n":{"vie":"Phí sàn"}},"customer_pay_fee":{"type":"boolean","description":"Customer pay shipping fee","x-description-i18n":{"vie":"Khách trả phí ship"}},"is_free_shipping":{"type":"boolean","description":"Free shipping","x-description-i18n":{"vie":"Miễn phí vận chuyển"}},"is_livestream":{"type":"boolean","description":"Is livestream order","x-description-i18n":{"vie":"Đơn hàng từ livestream"}},"is_live_shopping":{"type":"boolean","description":"Is live shopping order","x-description-i18n":{"vie":"Đơn hàng từ live shopping"}},"is_smc":{"type":"boolean","description":"Shopping on Messenger","x-description-i18n":{"vie":"Đơn hàng từ mua sắm trên Messenger"}},"received_at_shop":{"type":"boolean","description":"true: Sales at counter, false: Sell online","x-description-i18n":{"vie":"true: Bán tại quầy, false: Bán online"}},"total_discount":{"type":"integer","description":"Discount total","x-description-i18n":{"vie":"Tổng tiền giảm giá"}},"note":{"type":"string","description":"Internal note","x-description-i18n":{"vie":"Ghi chú nội bộ"}},"note_print":{"type":"string","description":"Note for printing","x-description-i18n":{"vie":"Ghi chú đơn hàng"}},"returned_reason":{"type":"integer","description":"Return reason code (1: Customer, 2: Staff, 3: Defective product, 4: Shipping carrier, 5: Exchange). Other values are shop-defined custom reasons, see returned_reason_name for the display name","x-description-i18n":{"vie":"Mã lý do hoàn hàng (1: Do khách hàng, 2: Do nhân viên, 3: Do sản phẩm lỗi, 4: Do đơn vị vận chuyển, 5: Do đổi hàng). Mã khác là lý do tùy chỉnh theo từng shop, xem tên hiển thị tại returned_reason_name"}},"returned_reason_name":{"type":"string","description":"Return reason name","x-description-i18n":{"vie":"Tên lý do hoàn hàng"}},"sub_status":{"type":"integer","description":"Reason for delivery delay","x-description-i18n":{"vie":"Lý do delay giao hàng"}},"warehouse_id":{"type":"string","description":"Warehouse ID","x-description-i18n":{"vie":"Mã kho hàng"}},"warehouse_info":{"type":"object","description":"Warehouse information","x-description-i18n":{"vie":"Thông tin kho hàng"},"properties":{"name":{"type":"string","description":"Warehouse name","x-description-i18n":{"vie":"Tên kho hàng"}},"phone_number":{"type":"string","description":"Warehouse phone number","x-description-i18n":{"vie":"Số điện thoại kho hàng"}},"full_address":{"type":"string","description":"Warehouse full address","x-description-i18n":{"vie":"Địa chỉ đầy đủ kho hàng"}},"address":{"type":"string","description":"Warehouse address","x-description-i18n":{"vie":"Địa chỉ chi tiết kho hàng"}},"province_id":{"type":"string","description":"Province ID","x-description-i18n":{"vie":"Mã tỉnh thành phố"}},"district_id":{"type":"string","description":"District ID","x-description-i18n":{"vie":"Mã quận huyện"}},"commune_id":{"type":"string","description":"Commune ID","x-description-i18n":{"vie":"Mã phường xã"}},"affiliate_id":{"type":"string","description":"Affiliate ID","x-description-i18n":{"vie":"Mã đại lý"}},"ffm_id":{"type":"string","description":"FFM ID","x-description-i18n":{"vie":"Mã FFM"}},"has_snappy_service":{"type":"boolean","description":"Has Snappy service","x-description-i18n":{"vie":"Có dịch vụ Snappy"}},"custom_id":{"type":"string","description":"Custom ID","x-description-i18n":{"vie":"Mã tùy chỉnh"}}}},"creator_id":{"type":"string","description":"Creator ID","x-description-i18n":{"vie":"Mã người tạo"}},"creator":{"type":"object","description":"Order creator","x-description-i18n":{"vie":"Thông tin người tạo đơn"},"properties":{"id":{"type":"string","description":"Creator ID","x-description-i18n":{"vie":"Mã người tạo"}},"fb_id":{"type":"string","description":"Facebook ID of creator","x-description-i18n":{"vie":"ID facebook người tạo đơn"}},"name":{"type":"string","description":"Creator name","x-description-i18n":{"vie":"Tên người tạo đơn"}},"avatar_url":{"type":"string","description":"Creator avatar URL","x-description-i18n":{"vie":"Link avatar người tạo"}}}},"items":{"type":"array","description":"Product list. When creating or updating an order, each entry must include `variation_id` and `quantity`. `variation_info` is optional — if omitted, the backend treats it as an empty object; send it (with `retail_price`) when you need the line price to be explicit.","x-description-i18n":{"vie":"Danh sách sản phẩm. Khi tạo hoặc cập nhật đơn, mỗi phần tử cần có `variation_id` và `quantity`. `variation_info` không bắt buộc — nếu thiếu, backend coi như object rỗng; nên gửi kèm (cùng `retail_price`) khi muốn giá dòng hàng tường minh."},"items":{"type":"object","required":["variation_id","quantity"],"properties":{"product_id":{"type":"string","description":"Product ID","x-description-i18n":{"vie":"Mã sản phẩm"}},"quantity":{"type":"integer","description":"Quantity","x-description-i18n":{"vie":"Số lượng"}},"returned_count":{"type":"integer","description":"Returned count","x-description-i18n":{"vie":"Số lượng đã trả"}},"assigning_seller_id":{"type":"string","description":"Assigning seller ID","x-description-i18n":{"vie":"Mã nhân viên được phân công"}},"quantity_by_combo_products":{"type":"array","description":"Quantity by combo products","x-description-i18n":{"vie":"Số lượng theo combo sản phẩm"},"items":{"type":"object"}},"discount_each_product":{"type":"integer","description":"Discount for each product","x-description-i18n":{"vie":"Giảm giá cho từng sản phẩm"}},"is_bonus_product":{"type":"boolean","description":"Is bonus product","x-description-i18n":{"vie":"Sản phẩm tặng kèm"}},"is_discount_percent":{"type":"boolean","description":"Is discount by percent","x-description-i18n":{"vie":"Giảm giá theo phần trăm"}},"is_wholesale":{"type":"boolean","description":"Is wholesale","x-description-i18n":{"vie":"Bán sỉ"}},"is_composite":{"type":"boolean","description":"Is composite product","x-description-i18n":{"vie":"Sản phẩm composite"}},"one_time_product":{"type":"boolean","description":"One time product","x-description-i18n":{"vie":"Sản phẩm một lần"}},"note":{"type":"string","description":"Product note","x-description-i18n":{"vie":"Ghi chú sản phẩm"}},"note_product":{"type":"string","description":"Product note","x-description-i18n":{"vie":"Ghi chú sản phẩm"}},"inserted_at":{"type":"string","format":"date-time","description":"Inserted at","x-description-i18n":{"vie":"Thời điểm tạo"}},"measure_group_id":{"type":"integer","description":"Measure group ID","x-description-i18n":{"vie":"Mã nhóm đơn vị tính"}},"variation_info":{"type":"object","description":"Variation information. Optional when creating/updating an order (the backend defaults it to an empty object if omitted). Its inner fields are not individually required, but sending `retail_price` is recommended so the line price is correct.","x-description-i18n":{"vie":"Thông tin biến thể. Không bắt buộc khi tạo/cập nhật đơn (backend tự coi là object rỗng nếu thiếu). Các field bên trong không bắt buộc riêng lẻ, nhưng nên gửi `retail_price` để giá dòng hàng đúng."},"properties":{"id":{"type":"string","description":"Variation ID","x-description-i18n":{"vie":"Mã biến thể"}},"name":{"type":"string","description":"Product name","x-description-i18n":{"vie":"Tên sản phẩm"}},"product_id":{"type":"string","description":"Product ID","x-description-i18n":{"vie":"Mã sản phẩm"}},"retail_price":{"type":"integer","description":"Retail price. Not strictly required, but recommended when creating/updating an order so the line price is correct.","x-description-i18n":{"vie":"Giá bán lẻ. Không bắt buộc, nhưng nên gửi khi tạo/cập nhật đơn để giá dòng hàng chính xác."}},"detail":{"type":"string","description":"Variation detail","x-description-i18n":{"vie":"Chi tiết biến thể"}},"images":{"type":"array","description":"Variation images","x-description-i18n":{"vie":"Hình ảnh biến thể"},"items":{"type":"string","format":"uri"}},"fields":{"type":"array","description":"Variation fields","x-description-i18n":{"vie":"Thuộc tính biến thể"},"items":{"type":"object","properties":{"id":{"type":"string","description":"Field ID","x-description-i18n":{"vie":"Mã thuộc tính"}},"name":{"type":"string","description":"Field name","x-description-i18n":{"vie":"Tên thuộc tính"}},"value":{"type":"string","description":"Field value","x-description-i18n":{"vie":"Giá trị thuộc tính"}},"keyValue":{"type":"string","description":"Key value","x-description-i18n":{"vie":"Giá trị khóa"}}}}},"barcode":{"type":"string","description":"Barcode","x-description-i18n":{"vie":"Mã barcode"}},"brand_id":{"type":"string","description":"Brand ID","x-description-i18n":{"vie":"Mã thương hiệu"}},"category_ids":{"type":"array","description":"Category IDs","x-description-i18n":{"vie":"Danh sách mã danh mục"},"items":{"type":"integer"}},"display_id":{"type":"string","description":"Display ID","x-description-i18n":{"vie":"Mã hiển thị"}},"product_display_id":{"type":"string","description":"Product display ID","x-description-i18n":{"vie":"Mã hiển thị sản phẩm"}},"last_imported_price":{"type":"integer","description":"Last imported price","x-description-i18n":{"vie":"Giá nhập hàng cuối"}},"is_upsale_product":{"type":"boolean","description":"Upsale product","x-description-i18n":{"vie":"Sản phẩm upsale"}},"weight":{"type":"integer","description":"Weight","x-description-i18n":{"vie":"Khối lượng"}},"measure_info":{"type":"object","description":"Measure information","x-description-i18n":{"vie":"Thông tin đơn vị tính"},"properties":{"measure_id":{"type":"integer","description":"Measure ID","x-description-i18n":{"vie":"Mã đơn vị tính"}},"exchange_value":{"type":"integer","description":"Exchange value","x-description-i18n":{"vie":"Giá trị quy đổi"}}}},"avg_price":{"type":"integer","description":"Average import price","x-description-i18n":{"vie":"Giá nhập trung bình"}}}},"components":{"type":"array","description":"Product components","x-description-i18n":{"vie":"Thành phần sản phẩm"},"items":{"type":"object","properties":{"component_id":{"type":"string","description":"Component ID","x-description-i18n":{"vie":"Mã thành phần"}},"quantity":{"type":"integer","description":"Quantity","x-description-i18n":{"vie":"Số lượng"}},"variation_id":{"type":"string","description":"Variation ID","x-description-i18n":{"vie":"Mã biến thể"}},"variation_info":{"type":"object","description":"Variation information","x-description-i18n":{"vie":"Thông tin biến thể"}}}}},"id":{"type":"integer","description":"Item ID","x-description-i18n":{"vie":"Mã sản phẩm trong đơn"}},"variation_id":{"type":"string","description":"Variation ID","x-description-i18n":{"vie":"Mã biến thể"}}}}},"partner":{"type":"object","description":"Partner information","x-description-i18n":{"vie":"Thông tin đơn vị vận chuyển"},"properties":{"partner_id":{"type":"integer","description":"Partner ID","x-description-i18n":{"vie":"ID đơn vị vận chuyển trên hệ thống Pancake"}},"cod":{"type":"integer","description":"Reconciliation COD","x-description-i18n":{"vie":"Đối soát tiền thu hộ"}},"extend_code":{"type":"string","description":"Shipping order ID on partner system","x-description-i18n":{"vie":"Mã vận đơn"}},"total_fee":{"type":"integer","description":"Total fee","x-description-i18n":{"vie":"Tổng phí"}},"updated_at":{"type":"string","format":"date-time","description":"Updated at","x-description-i18n":{"vie":"Thời điểm cập nhật"}},"delivery_name":{"type":"string","description":"Shipper name","x-description-i18n":{"vie":"Tên người giao hàng"}},"delivery_tel":{"type":"string","description":"Delivery phone","x-description-i18n":{"vie":"Số điện thoại người giao hàng"}},"picked_up_at":{"type":"string","format":"date-time","description":"Picked up at","x-description-i18n":{"vie":"Thời điểm lấy hàng"}},"sort_code":{"type":"string","description":"Sort code","x-description-i18n":{"vie":"Mã phân loại"}},"paid_at":{"type":"string","format":"date-time","description":"Paid at","x-description-i18n":{"vie":"Thời điểm thanh toán"}},"system_created":{"type":"boolean","description":"System created","x-description-i18n":{"vie":"Được tạo bởi hệ thống"}},"extend_update":{"type":"array","description":"Update from courier","x-description-i18n":{"vie":"Cập nhật từ đơn vị vận chuyển"},"items":{"type":"object","properties":{"key":{"type":"string","description":"Update key","x-description-i18n":{"vie":"Mã cập nhật"}},"status":{"type":"string","description":"Status","x-description-i18n":{"vie":"Trạng thái"}},"tracking_id":{"type":"string","description":"Partner extend code","x-description-i18n":{"vie":"Mã đơn hàng đối tác"}},"note":{"type":"string","description":"Courier notes","x-description-i18n":{"vie":"Ghi chú từ đơn vị vận chuyển"}},"update_at":{"type":"string","format":"date-time","description":"Updated at","x-description-i18n":{"vie":"Thời điểm cập nhật"}}}}},"partner_status":{"type":"string","nullable":true,"description":"Partner shipping status","x-description-i18n":{"vie":"Trạng thái vận chuyển"},"enum":["waiting","request_received","processing_picked_up","picking_up","delay_pickup","picked_up","waiting_on_the_way","on_the_way","contact_delivery_company","out_for_delivery","delay_delivery","inform_recipient","undeliverable","waiting_for_return","delivered","delivered_cod","returning","returned","returned_cod","canceled"],"x-enum-descriptions":["Waiting for processing","Carrier received the request","Processing pickup","Picking up","Delayed pickup","Picked up","Waiting for transit","In transit","Contact the carrier","Out for delivery","Delayed delivery","Notify the recipient","Undeliverable","Waiting for return","Delivered","Delivered, COD reconciled","Returning","Returned","Returned, COD reconciled","Canceled"],"x-enum-descriptions-i18n":{"vie":["Chờ xử lý","ĐVVC đã tiếp nhận đơn","Đang xử lý lấy hàng","Đang lấy hàng","Trễ lấy hàng","Đã lấy hàng","Chờ trung chuyển","Đang trung chuyển","Liên hệ ĐVVC","Đang giao hàng","Trễ giao hàng","Thông báo cho người nhận","Giao không thành","Chờ chuyển hoàn","Đã giao hàng","Đã giao hàng, đã đối soát COD","Đang chuyển hoàn","Đã chuyển hoàn","Đã chuyển hoàn, đã đối soát COD","Đã hủy vận đơn"]}},"partner_name":{"type":"string","nullable":true,"description":"Partner name","x-description-i18n":{"vie":"Tên đơn vị vận chuyển"}},"first_delivery_at":{"type":"string","format":"date-time","nullable":true,"description":"First delivery time","x-description-i18n":{"vie":"Thời điểm giao hàng lần đầu"}},"first_undeliverable_at":{"type":"string","format":"date-time","nullable":true,"description":"First failed delivery time","x-description-i18n":{"vie":"Thời điểm giao hàng thất bại lần đầu"}},"order_number_vtp":{"type":"string","nullable":true,"description":"Viettel Post tracking number","x-description-i18n":{"vie":"Mã vận đơn Viettel Post"}},"printed_form":{"type":"object","nullable":true,"description":"Printed form","x-description-i18n":{"vie":"Mẫu in"}}}},"shipping_address":{"$ref":"#/components/schemas/ShippingAddress"},"payment_purchase_histories":{"type":"array","description":"Payment histories","x-description-i18n":{"vie":"Lịch sử thanh toán"},"items":{"type":"object","properties":{"amount":{"type":"integer","description":"Amount of money","x-description-i18n":{"vie":"Số tiền"}},"type":{"type":"string","description":"Payment type","x-description-i18n":{"vie":"Loại thanh toán"}},"inserted_at":{"type":"string","format":"date-time","description":"Transaction time","x-description-i18n":{"vie":"Thời điểm giao dịch"}},"result_code":{"type":"string","description":"Result code","x-description-i18n":{"vie":"Mã kết quả"}},"ipn_reply":{"type":"boolean","description":"IPN reply","x-description-i18n":{"vie":"Phản hồi IPN"}},"voucher_amount":{"type":"integer","description":"Voucher amount","x-description-i18n":{"vie":"Số tiền voucher"}},"tags":{"type":"array","description":"Tags","x-description-i18n":{"vie":"Thẻ"},"items":{"type":"string"}}}}},"tags":{"type":"array","description":"Tags list","x-description-i18n":{"vie":"Danh sách thẻ đơn hàng"},"items":{"type":"object","properties":{"id":{"type":"integer","description":"Tag ID","x-description-i18n":{"vie":"Mã thẻ đơn hàng"}},"name":{"type":"string","description":"Tag name","x-description-i18n":{"vie":"Tên thẻ đơn hàng"}}}}},"marketer":{"type":"object","description":"Marketer information","x-description-i18n":{"vie":"Thông tin marketer"},"properties":{"id":{"type":"string","description":"Marketer ID","x-description-i18n":{"vie":"Mã marketer"}},"name":{"type":"string","description":"Marketer name","x-description-i18n":{"vie":"Tên marketer"}},"email":{"type":"string","description":"Marketer email","x-description-i18n":{"vie":"Email marketer"}},"phone_number":{"type":"string","description":"Marketer phone number","x-description-i18n":{"vie":"Số điện thoại marketer"}},"fb_id":{"type":"string","description":"Marketer Facebook ID","x-description-i18n":{"vie":"Facebook ID marketer"}},"avatar_url":{"type":"string","description":"Marketer avatar URL","x-description-i18n":{"vie":"Link avatar marketer"}}}},"pke_mkter":{"type":"string","description":"Marketer ID","x-description-i18n":{"vie":"Mã nhân viên marketer"}},"activated_combo_products":{"type":"object","description":"Activated combo products information","x-description-i18n":{"vie":"Thông tin combo sản phẩm được kích hoạt"},"properties":{"combo_product_id":{"type":"integer","description":"Combo product ID","x-description-i18n":{"vie":"Mã combo sản phẩm"}},"quantity_combo_activated":{"type":"integer","description":"Quantity combo activated","x-description-i18n":{"vie":"Số lượng combo được kích hoạt"}},"combo_product_info":{"type":"object","description":"Combo product information","x-description-i18n":{"vie":"Thông tin combo sản phẩm"}}}},"activated_promotion_advances":{"type":"array","description":"Activated promotion advances information","x-description-i18n":{"vie":"Thông tin khuyến mãi được kích hoạt"},"items":{"type":"object","properties":{"id":{"type":"integer","description":"ID","x-description-i18n":{"vie":"Mã"}},"promotion_advance_id":{"type":"string","description":"Promotion advance ID","x-description-i18n":{"vie":"Mã khuyến mãi"}},"promotion_advance_info":{"type":"object","description":"Promotion advance information","x-description-i18n":{"vie":"Thông tin khuyến mãi"}}}}},"invoice_info_list":{"type":"array","description":"Invoice information list","x-description-i18n":{"vie":"Danh sách thông tin hóa đơn"},"items":{"type":"object","properties":{"error":{"type":"string","description":"Error message if any","x-description-i18n":{"vie":"Thông báo lỗi nếu có"}},"invoice_detail":{"type":"object","description":"Invoice detail information","x-description-i18n":{"vie":"Chi tiết thông tin hóa đơn"},"properties":{"company_address":{"type":"string","description":"Company address","x-description-i18n":{"vie":"Địa chỉ công ty"}},"company_address_breakdown":{"type":"object","description":"Company address breakdown","x-description-i18n":{"vie":"Chi tiết địa chỉ công ty"},"properties":{"company_additional_info":{"type":"string","description":"Company additional information","x-description-i18n":{"vie":"Thông tin bổ sung công ty"}},"company_barangay":{"type":"string","description":"Company barangay","x-description-i18n":{"vie":"Phường/xã công ty"}},"company_city":{"type":"string","description":"Company city","x-description-i18n":{"vie":"Thành phố công ty"}},"company_detailed_address":{"type":"string","description":"Company detailed address","x-description-i18n":{"vie":"Địa chỉ chi tiết công ty"}},"company_district":{"type":"string","description":"Company district","x-description-i18n":{"vie":"Quận/huyện công ty"}},"company_full_address":{"type":"string","description":"Company full address","x-description-i18n":{"vie":"Địa chỉ đầy đủ công ty"}},"company_postcode":{"type":"string","description":"Company postcode","x-description-i18n":{"vie":"Mã bưu điện công ty"}},"company_province":{"type":"string","description":"Company province","x-description-i18n":{"vie":"Tỉnh công ty"}},"company_region":{"type":"string","description":"Company region","x-description-i18n":{"vie":"Vùng/khu vực công ty"}},"company_state":{"type":"string","description":"Company state","x-description-i18n":{"vie":"Bang/tỉnh công ty"}},"company_town":{"type":"string","description":"Company town","x-description-i18n":{"vie":"Thị trấn/phường công ty"}}}},"company_email":{"type":"string","description":"Company email","x-description-i18n":{"vie":"Email công ty"}},"company_name":{"type":"string","description":"Company name","x-description-i18n":{"vie":"Tên công ty"}},"company_tax_id":{"type":"string","description":"Company tax ID","x-description-i18n":{"vie":"Mã số thuế công ty"}}}},"invoice_type":{"type":"string","description":"Invoice type","x-description-i18n":{"vie":"Loại hóa đơn"}},"is_requested":{"type":"boolean","description":"Request for invoice","x-description-i18n":{"vie":"Yêu cầu xuất hóa đơn"}},"order_sn":{"type":"string","description":"Order code on the marketplace","x-description-i18n":{"vie":"Mã đơn hàng trên sàn"}}}}},"reports_by_phone":{"type":"object","description":"Reports by phone number","x-description-i18n":{"vie":"Báo cáo theo số điện thoại"},"properties":{"order_fail":{"type":"integer","description":"Number of failed orders","x-description-i18n":{"vie":"Số đơn thất bại"}},"order_success":{"type":"integer","description":"Number of successful orders","x-description-i18n":{"vie":"Số đơn thành công"}},"warning":{"type":"integer","description":"Number of warnings orders","x-description-i18n":{"vie":"Số đơn cảnh báo"}}},"example":{"+639175706297":{"order_fail":29,"order_success":20,"warning":0}}},"tracking_link":{"type":"string","description":"Link confirm order","x-description-i18n":{"vie":"Link xác nhận đơn hàng"}},"ads_source":{"type":"string","description":"Advertising source","x-description-i18n":{"vie":"Nguồn quảng cáo"}},"bank_payments":{"type":"object","description":"Payment method","x-description-i18n":{"vie":"Phương thức thanh toán"}},"transfer_proofs":{"type":"array","description":"Bank transfer payment proofs, including verification time, amount and receipt images","x-description-i18n":{"vie":"Danh sách chứng từ xác thực chuyển khoản, gồm ngày giờ xác thực, số tiền và ảnh chứng từ"},"items":{"type":"object","properties":{"id":{"type":"integer","description":"Transfer proof ID","x-description-i18n":{"vie":"Mã chứng từ chuyển khoản"}},"order_id":{"type":"integer","description":"Order ID","x-description-i18n":{"vie":"Mã đơn hàng"}},"shop_id":{"type":"integer","description":"Shop ID","x-description-i18n":{"vie":"Mã cửa hàng"}},"payment_id":{"type":"string","description":"Bank payment method ID (matches a key in `bank_payments`)","x-description-i18n":{"vie":"Mã phương thức thanh toán ngân hàng (trùng với key trong `bank_payments`)"}},"amount":{"type":"integer","description":"Transferred amount","x-description-i18n":{"vie":"Số tiền chuyển khoản"}},"images":{"type":"array","description":"Transfer receipt images","x-description-i18n":{"vie":"Danh sách ảnh chứng từ chuyển khoản"},"items":{"type":"string"}},"note":{"type":"string","nullable":true,"description":"Note","x-description-i18n":{"vie":"Ghi chú"}},"is_income":{"type":"boolean","description":"Money received (true) or paid out (false)","x-description-i18n":{"vie":"Là khoản tiền nhận vào (true) hay chi ra (false)"}},"is_verify":{"type":"boolean","description":"Whether the transfer has been verified","x-description-i18n":{"vie":"Chứng từ đã được xác thực hay chưa"}},"verify_at":{"type":"string","format":"date-time","nullable":true,"description":"Verification time","x-description-i18n":{"vie":"Thời điểm xác thực chuyển khoản"}},"verifier":{"type":"object","nullable":true,"description":"Verifier information","x-description-i18n":{"vie":"Thông tin người xác thực"},"properties":{"id":{"type":"string","description":"Verifier ID","x-description-i18n":{"vie":"Mã người xác thực"}},"name":{"type":"string","description":"Verifier name","x-description-i18n":{"vie":"Tên người xác thực"}},"fb_id":{"type":"string","description":"Facebook ID of verifier","x-description-i18n":{"vie":"Facebook ID người xác thực"}},"avatar_url":{"type":"string","description":"Verifier avatar URL","x-description-i18n":{"vie":"Link avatar người xác thực"}}}},"creator":{"type":"object","nullable":true,"description":"Creator information","x-description-i18n":{"vie":"Thông tin người tạo chứng từ"},"properties":{"id":{"type":"string","description":"Creator ID","x-description-i18n":{"vie":"Mã người tạo"}},"name":{"type":"string","description":"Creator name","x-description-i18n":{"vie":"Tên người tạo"}},"fb_id":{"type":"string","description":"Facebook ID of creator","x-description-i18n":{"vie":"Facebook ID người tạo"}},"avatar_url":{"type":"string","description":"Creator avatar URL","x-description-i18n":{"vie":"Link avatar người tạo"}}}},"last_editor":{"type":"object","nullable":true,"description":"Last editor information","x-description-i18n":{"vie":"Thông tin người chỉnh sửa cuối"},"properties":{"id":{"type":"string","description":"Editor ID","x-description-i18n":{"vie":"Mã người chỉnh sửa"}},"name":{"type":"string","description":"Editor name","x-description-i18n":{"vie":"Tên người chỉnh sửa"}},"fb_id":{"type":"string","description":"Facebook ID of editor","x-description-i18n":{"vie":"Facebook ID người chỉnh sửa"}},"avatar_url":{"type":"string","description":"Editor avatar URL","x-description-i18n":{"vie":"Link avatar người chỉnh sửa"}}}},"order_info":{"type":"object","nullable":true,"description":"Additional order information","x-description-i18n":{"vie":"Thông tin đơn hàng bổ sung"}},"inserted_at":{"type":"string","format":"date-time","description":"Transfer proof creation time","x-description-i18n":{"vie":"Thời điểm tạo chứng từ"}},"updated_at":{"type":"string","format":"date-time","description":"Transfer proof update time","x-description-i18n":{"vie":"Thời điểm cập nhật chứng từ"}}}}},"shopify_order_id":{"type":"string","description":"Shopify order ID","x-description-i18n":{"vie":"Mã đơn hàng Shopify"}},"shopify_abandon_checkout_id":{"type":"integer","description":"Shopify abandon checkout ID","x-description-i18n":{"vie":"Mã Shopify abandon checkout"}},"is_abandoned_order":{"type":"boolean","description":"Abandoned-cart flag for creating or updating an order. Send it directly in the request body, not inside `third_party` or `third_party_infomation`.\nAn explicit value, including `false`, takes precedence over automatic detection. If omitted on creation, the flag is determined automatically; if omitted on update, the current value is preserved.\nOnly boolean `true` or string `\"true\"` is normalized to `true`; all other submitted values become `false`.\n","x-description-i18n":{"vie":"Cờ đơn chưa hoàn tất khi tạo hoặc cập nhật đơn. Truyền trực tiếp trong body, không bọc trong `third_party` hoặc `third_party_infomation`.\nGiá trị truyền lên, kể cả `false`, được ưu tiên hơn kết quả nhận diện tự động. Nếu bỏ qua khi tạo đơn, cờ được xác định tự động; nếu bỏ qua khi cập nhật, giữ nguyên giá trị hiện tại.\nChỉ boolean `true` hoặc chuỗi `\"true\"` được chuẩn hóa thành `true`; mọi giá trị khác được gửi lên đều thành `false`.\n"},"example":true},"cod":{"type":"integer","description":"Cash on delivery","x-description-i18n":{"vie":"Tiền thu hộ"}},"cash":{"type":"integer","description":"Cash payment","x-description-i18n":{"vie":"Tiền mặt"}},"account":{"type":"integer","description":"Order source ID","x-description-i18n":{"vie":"Mã nguồn đơn hàng"}},"account_name":{"type":"string","description":"Order source name","x-description-i18n":{"vie":"Tên mã nguồn đơn"}},"advanced_platform_fee":{"type":"object","description":"Fees from e-commerce platforms","x-description-i18n":{"vie":"Phí từ sàn thương mại điện tử"},"properties":{"ads_top_up":{"type":"integer","description":"Ads wallet top-up","x-description-i18n":{"vie":"Ví quảng cáo"}},"affiliate_commission":{"type":"integer","description":"Affiliate commission","x-description-i18n":{"vie":"Phí hoa hồng (Sàn TMĐT)"}},"diff_shipping_fee":{"type":"integer","description":"Difference shipping fee","x-description-i18n":{"vie":"Chênh lệch phí vận chuyển (Sàn TMĐT)"}},"marketplace_voucher":{"type":"integer","description":"Marketplace voucher","x-description-i18n":{"vie":"Sàn trợ giá"}},"payment_fee":{"type":"integer","description":"Payment fee","x-description-i18n":{"vie":"Phí cố định, giao dịch (Sàn TMĐT)"}},"platform_commission":{"type":"integer","description":"Platform commission","x-description-i18n":{"vie":"Phí hoa hồng nền tảng (Sàn TMĐT)"}},"seller_transaction_fee":{"type":"integer","description":"Seller transaction fee","x-description-i18n":{"vie":"Phí thanh toán (Sàn TMĐT)"}},"service_fee":{"type":"integer","description":"Service fee","x-description-i18n":{"vie":"Phí dịch vụ (Sàn TMĐT)"}},"sfp_service_fee":{"type":"integer","description":"SFP service fee","x-description-i18n":{"vie":"Phí dịch vụ SFP (Sàn TMĐT)"}}}},"printing_count":{"type":"integer","description":"Printing count","x-description-i18n":{"vie":"Số lần in"}},"money_to_collect":{"type":"integer","description":"Money to collect","x-description-i18n":{"vie":"Số tiền cần thu"}},"marketplace_id":{"type":"string","description":"Marketplace ID","enum":["-2","-3","-4","-9","-16","-17","-20","-25","-27","-28"],"x-enum-descriptions":{"-2":"Tiki","-3":"Shopee","-4":"Lazada","-9":"TikTok","-16":"WooCommerce","-17":"Shopify","-20":"Line Shopping","-25":"Tokopedia","-27":"Mercado Libre","-28":"Tiendanube"},"x-description-i18n":{"vie":"Mã sàn thương mại điện tử"}},"total_price":{"type":"integer","description":"Total price","x-description-i18n":{"vie":"Tổng giá trị sản phẩm"}},"shop_customer_address_id":{"type":"string","description":"Customer address ID","x-description-i18n":{"vie":"Mã địa chỉ khách hàng"}},"customer":{"type":"object","description":"Customer information","x-description-i18n":{"vie":"Thông tin khách hàng"},"properties":{"fb_id":{"type":"string","description":"Customer Facebook ID","x-description-i18n":{"vie":"Facebook ID khách hàng"}},"id":{"type":"string","description":"Customer ID","x-description-i18n":{"vie":"Mã khách hàng"}},"name":{"type":"string","description":"Customer name","x-description-i18n":{"vie":"Tên khách hàng"}},"page_id":{"type":"string","description":"Page ID","x-description-i18n":{"vie":"Mã trang"}}}},"total_quantity":{"type":"integer","description":"Total quantity","x-description-i18n":{"vie":"Tổng số lượng"}},"time_assign_marketer":{"type":"string","format":"date-time","description":"Time assign marketer","x-description-i18n":{"vie":"Thời điểm phân công marketer"}},"p_utm_source":{"type":"string","description":"UTM Source","x-description-i18n":{"vie":"UTM Source"}},"p_utm_medium":{"type":"string","description":"UTM Medium","x-description-i18n":{"vie":"UTM Medium"}},"p_utm_campaign":{"type":"string","description":"UTM Campaign","x-description-i18n":{"vie":"UTM Campaign"}},"p_utm_term":{"type":"string","description":"UTM Term","x-description-i18n":{"vie":"UTM Term"}},"p_utm_content":{"type":"string","description":"UTM Content","x-description-i18n":{"vie":"UTM Content"}},"p_utm_id":{"type":"string","description":"UTM ID","x-description-i18n":{"vie":"UTM ID"}},"utm_affiliate":{"type":"string","description":"Affiliate","x-description-i18n":{"vie":"Affiliate"}},"link":{"type":"string","description":"Link","x-description-i18n":{"vie":"Link"}},"status_history":{"type":"array","description":"Status update history","x-description-i18n":{"vie":"Lịch sử cập nhật trạng thái"},"items":{"type":"object","properties":{"avatar_url":{"type":"string","description":"Avatar URL","x-description-i18n":{"vie":"Link avatar"}},"editor":{"type":"object","description":"Editor information","x-description-i18n":{"vie":"Thông tin người chỉnh sửa"}},"editor_fb":{"type":"string","description":"Editor Facebook ID","x-description-i18n":{"vie":"Facebook ID người chỉnh sửa"}},"editor_id":{"type":"string","description":"Editor ID","x-description-i18n":{"vie":"Mã người chỉnh sửa"}},"name":{"type":"string","description":"Name","x-description-i18n":{"vie":"Tên"}},"old_status":{"type":"integer","description":"Old status","x-description-i18n":{"vie":"Trạng thái cũ"}},"status":{"type":"integer","description":"Status","x-description-i18n":{"vie":"Trạng thái"}},"updated_at":{"type":"string","format":"date-time","description":"Updated at","x-description-i18n":{"vie":"Thời điểm cập nhật"}}}}},"duplicated_phone":{"type":"boolean","description":"Duplicated phone","x-description-i18n":{"vie":"Số điện thoại trùng lặp"}},"order_currency":{"type":"string","description":"Order currency","x-description-i18n":{"vie":"Loại tiền tệ"}},"charged_by_vnpay":{"type":"integer","description":"Charged by VNPay","x-description-i18n":{"vie":"Số tiền thanh toán qua VNPay"}},"charged_by_qrpay":{"type":"integer","description":"Charged by QRPay","x-description-i18n":{"vie":"Số tiền khách thanh toán qua QRPAY"}},"custom_id":{"type":"string","description":"Custom ID","x-description-i18n":{"vie":"Mã tùy chỉnh"}},"last_editor":{"type":"object","description":"Last editor information","x-description-i18n":{"vie":"Thông tin người chỉnh sửa cuối cùng đơn hàng"},"properties":{"id":{"type":"string","description":"Editor ID","x-description-i18n":{"vie":"Mã người chỉnh sửa"}},"fb_id":{"type":"string","description":"Facebook ID of editor","x-description-i18n":{"vie":"Facebook ID người chỉnh sửa"}},"name":{"type":"string","description":"Editor name","x-description-i18n":{"vie":"Tên người chỉnh sửa"}},"email":{"type":"string","description":"Editor email","x-description-i18n":{"vie":"Email người chỉnh sửa"}},"avatar_url":{"type":"string","description":"Editor avatar URL","x-description-i18n":{"vie":"Link avatar người chỉnh sửa"}},"phone_number":{"type":"string","description":"Editor phone number","x-description-i18n":{"vie":"Số điện thoại người chỉnh sửa"}}}},"last_editor_id":{"type":"string","description":"Last editor ID","x-description-i18n":{"vie":"Mã người sửa cuối"}},"charged_by_momo":{"type":"integer","description":"Charged by MoMo","x-description-i18n":{"vie":"Số tiền khách thanh toán qua MOMO"}},"prepaid_by_point":{"type":"object","description":"Prepaid by point","x-description-i18n":{"vie":"Thanh toán bằng điểm thưởng"},"properties":{"money":{"type":"integer","description":"Money amount","x-description-i18n":{"vie":"Số tiền"},"example":15000},"point":{"type":"integer","description":"Point amount","x-description-i18n":{"vie":"Số điểm"},"example":15}},"example":{"money":15000,"point":15}},"bank_transfer_images":{"type":"array","description":"Bank transfer images","x-description-i18n":{"vie":"Hình ảnh chuyển khoản"},"items":{"type":"string","format":"uri"}},"transfer_money":{"type":"integer","description":"Transfer money","x-description-i18n":{"vie":"Số tiền khách chuyển khoản"}},"lock_order_by_user":{"type":"string","description":"Lock order by user ID","x-description-i18n":{"vie":"Mã người dùng khóa đơn hàng"}},"assigning_care":{"type":"object","description":"Assigning care information","x-description-i18n":{"vie":"Nhân viên chăm sóc"},"properties":{"id":{"type":"string","description":"Care ID","x-description-i18n":{"vie":"Mã người chăm sóc"}},"fb_id":{"type":"string","description":"Facebook ID of care","x-description-i18n":{"vie":"Facebook ID người chăm sóc"}},"name":{"type":"string","description":"Care name","x-description-i18n":{"vie":"Tên người chăm sóc"}},"email":{"type":"string","description":"Care email","x-description-i18n":{"vie":"Email người chăm sóc"}},"avatar_url":{"type":"string","description":"Care avatar URL","x-description-i18n":{"vie":"Link avatar người chăm sóc"}},"phone_number":{"type":"string","description":"Care phone number","x-description-i18n":{"vie":"Số điện thoại người chăm sóc"}}}},"assigning_care_id":{"type":"string","description":"Assigning care ID","x-description-i18n":{"vie":"Mã nhân viên chăm sóc"}},"time_assign_care":{"type":"string","format":"date-time","description":"Time assign care","x-description-i18n":{"vie":"Thời điểm phân công chăm sóc"}},"assigning_seller":{"type":"object","description":"Assigning seller information","x-description-i18n":{"vie":"Nhân viên được phân công"},"properties":{"id":{"type":"string","description":"Seller ID","x-description-i18n":{"vie":"Mã người bán"}},"fb_id":{"type":"string","description":"Facebook ID of seller","x-description-i18n":{"vie":"Facebook ID người bán"}},"name":{"type":"string","description":"Seller name","x-description-i18n":{"vie":"Tên người bán"}},"email":{"type":"string","description":"Seller email","x-description-i18n":{"vie":"Email người bán"}},"avatar_url":{"type":"string","description":"Seller avatar URL","x-description-i18n":{"vie":"Link avatar người bán"}},"phone_number":{"type":"string","description":"Seller phone number","x-description-i18n":{"vie":"Số điện thoại người bán"}}}},"einvoices":{"type":"array","items":{"$ref":"#/components/schemas/EInvoice"}},"charged_by_card":{"type":"integer","description":"Charged by card","x-description-i18n":{"vie":"Số tiền khách quẹt thẻ"}},"estimate_delivery_date":{"type":"string","format":"date-time","description":"Estimate delivery date","x-description-i18n":{"vie":"Ngày giao hàng dự kiến"}},"order_sources":{"type":"string","description":"Order sources ID","x-description-i18n":{"vie":"Mã nguồn đơn hàng"}},"charged_by_fundiin":{"type":"integer","description":"Charged by Fundiin","x-description-i18n":{"vie":"Số tiền thanh toán qua Fundiin"}},"surcharge":{"type":"integer","description":"Surcharge","x-description-i18n":{"vie":"Phụ thu"}},"is_linked_partner":{"type":"boolean","description":"Is linked partner","x-description-i18n":{"vie":"Đã liên kết đối tác"}},"call_laters":{"type":"array","description":"Call laters","x-description-i18n":{"vie":"Gọi lại sau"},"items":{"type":"object"}},"last_update_status_at":{"type":"string","format":"date-time","description":"Last update status at","x-description-i18n":{"vie":"Thời điểm cập nhật trạng thái cuối"}},"discount_by_customer_level":{"type":"integer","description":"Discount by customer level","x-description-i18n":{"vie":"Giảm giá theo cấp độ khách hàng"}},"viewing":{"type":"array","description":"Viewing","x-description-i18n":{"vie":"NV đang xem"},"items":{"type":"object"}},"additional_info":{"type":"object","description":"Additional info","x-description-i18n":{"vie":"Thông tin bổ sung"},"properties":{"service_partner":{"type":"string","description":"Service partner","x-description-i18n":{"vie":"Dịch vụ vận chuyển"},"enum":["instant"],"x-enum-descriptions":["Instant"],"x-enum-descriptions-i18n":{"vie":["Hỏa tốc"]}},"delivery_deadline":{"type":"string","format":"date-time","description":"Delivery deadline (ISO8601, no timezone). Send null to clear.","x-description-i18n":{"vie":"Hạn giao hàng (ISO8601, không kèm timezone). Gửi null để xóa."},"example":"2026-06-03T10:00:00"}}},"order_returned_ids":{"type":"string","description":"Order returned IDs","x-description-i18n":{"vie":"Mã đơn hàng đổi trả"}},"cost_surcharge":{"type":"integer","description":"Cost surcharge","x-description-i18n":{"vie":"Phụ phí"}},"time_send_partner":{"type":"string","format":"date-time","description":"Time send partner","x-description-i18n":{"vie":"Thời điểm gửi đơn vị vận chuyển"}},"charged_by_kredivo":{"type":"integer","description":"Charged by Kredivo","x-description-i18n":{"vie":"Số tiền thanh toán qua Kredivo"}},"discount":{"type":"integer","description":"Discount","x-description-i18n":{"vie":"Giảm giá"}},"histories":{"type":"array","description":"Histories","x-description-i18n":{"vie":"Lịch sử"},"items":{"type":"object"}},"duplicated_customer":{"type":"boolean","description":"Duplicated customer","x-description-i18n":{"vie":"Khách hàng trùng lặp"}},"customer_referral_code":{"type":"object","description":"Customer referral code","x-description-i18n":{"vie":"Mã giới thiệu khách hàng"},"properties":{"active":{"type":"string","description":"Active status","x-description-i18n":{"vie":"Trạng thái kích hoạt"},"example":"true"},"customer_id":{"type":"string","format":"uuid","description":"Customer ID","x-description-i18n":{"vie":"Mã khách hàng"},"example":"09bb9399-45f3-4897-a53a-85dde2f886fe"},"discount":{"type":"string","description":"Discount value","x-description-i18n":{"vie":"Giá trị giảm giá"},"example":"10"},"format":{"type":"string","description":"Referral code format","x-description-i18n":{"vie":"Định dạng mã giới thiệu"},"example":"{PHONE_NUMBER}"},"free_products_priced_between_approx":{"type":"object","description":"Free products priced between approximately","x-description-i18n":{"vie":"Miễn phí cho khách mới sản phẩm có giá"},"properties":{"active":{"type":"string","description":"Active status","x-description-i18n":{"vie":"Trạng thái kích hoạt"},"example":"true"},"operator":{"type":"string","description":"Comparison operator","x-description-i18n":{"vie":"Toán tử so sánh"},"example":"GreaterOrEqual"},"price":{"type":"string","description":"Price threshold","x-description-i18n":{"vie":"Ngưỡng giá"},"example":"150000"}}},"is_percent":{"type":"string","description":"Discount is percentage","x-description-i18n":{"vie":"Giảm giá theo phần trăm"},"example":"true"},"only_customers_with_level_will_have_referral_code":{"type":"string","description":"Only customers with level will have referral code","x-description-i18n":{"vie":"Chỉ khách hàng có cấp độ mới có mã giới thiệu"},"example":"true"},"referral_code":{"type":"string","description":"Referral code","x-description-i18n":{"vie":"Mã giới thiệu"},"example":"982843759"},"reward_points_for_old_customers":{"type":"object","description":"Reward points for customers","x-description-i18n":{"vie":"Điểm thưởng khách hàng"},"properties":{"active":{"type":"string","description":"Active status","x-description-i18n":{"vie":"Trạng thái kích hoạt"},"example":"true"},"money":{"type":"string","description":"Money reward","x-description-i18n":{"vie":"Tiền thưởng"},"example":"10000"},"point":{"type":"string","description":"Point reward","x-description-i18n":{"vie":"Điểm thưởng"},"example":"1"}}},"shop_customer_id":{"type":"string","format":"uuid","description":"Shop customer ID","x-description-i18n":{"vie":"Mã khách hàng shop"},"example":"f8160a4c-dfa7-4ee8-b540-d245755ea1f1"}},"example":{"active":"true","customer_id":"09bb9399-45f3-4897-a53a-85dde2f886fe","discount":"10","format":"{PHONE_NUMBER}","free_products_priced_between_approx":{"active":"true","operator":"GreaterOrEqual","price":"150000"},"is_percent":"true","only_customers_with_level_will_have_referral_code":"true","referral_code":"982843759","reward_points_for_old_customers":{"active":"true","money":"10000","point":"1"},"shop_customer_id":"f8160a4c-dfa7-4ee8-b540-d245755ea1f1"}},"tax":{"type":"integer","description":"Tax","x-description-i18n":{"vie":"Thuế"}},"is_from_ecommerce":{"type":"boolean","description":"Is from e-commerce","x-description-i18n":{"vie":"Đơn hàng từ sàn thương mại điện tử"}},"note_image":{"type":"array","description":"Note images","x-description-i18n":{"vie":"Link hình ảnh ghi chú"},"items":{"type":"string","format":"uri"}},"shopify_draft_order_id":{"type":"string","description":"Shopify draft order ID","x-description-i18n":{"vie":"Mã đơn hàng nháp Shopify"}},"display_id":{"type":"integer","description":"Display ID","x-description-i18n":{"vie":"Mã hiển thị"}},"shop_partner_id":{"type":"integer","description":"Shop partner ID","x-description-i18n":{"vie":"Mã đối tác shop"}},"is_locked":{"type":"boolean","description":"Order lock","x-description-i18n":{"vie":"Khóa đơn hàng"}},"merge_order":{"type":"boolean","description":"Allows merging orders","x-description-i18n":{"vie":"Cho phép gộp đơn"}}}},"examples":{"default":{"$ref":"#/components/examples/OrderBasic"}}}}}}}},"/shops/{SHOP_ID}/orders/{ORDER_ID}":{"get":{"summary":"Get order information","x-summary-i18n":{"vie":"Lấy thông tin 1 đơn hàng"},"description":"Get order information","x-description-i18n":{"vie":"Lấy thông tin 1 đơn hàng"},"tags":["Order"],"x-tags-i18n":{"vie":["Đơn hàng"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},{"name":"ORDER_ID","in":"path","required":true,"schema":{"type":"string","example":"1418"},"description":"Order ID","x-description-i18n":{"vie":"Mã đơn hàng"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"integer","description":"Order ID","x-description-i18n":{"vie":"Mã đơn hàng"}},"system_id":{"type":"integer","description":"System ID","x-description-i18n":{"vie":"Mã hệ thống"}},"shop_id":{"type":"integer","description":"Shop ID","x-description-i18n":{"vie":"Mã cửa hàng"}},"inserted_at":{"type":"string","format":"date-time","description":"Order creation time","x-description-i18n":{"vie":"Thời điểm tạo đơn"}},"updated_at":{"type":"string","format":"date-time","description":"Order update time","x-description-i18n":{"vie":"Thời điểm cập nhật đơn"}},"status":{"type":"integer","description":"Order status","x-description-i18n":{"vie":"Trạng thái đơn hàng"},"enum":[0,17,11,12,13,20,1,8,9,2,3,16,4,15,5,6,7],"x-enum-descriptions":["New","Waiting for confirmation","Restocking","Wait for printing","Printed","Purchased","Confirmed","Packaging","Waiting for pick up","Shipped","Received","Collected money","Returning","Partial return","Returned","Canceled","Deleted recently"],"x-enum-descriptions-i18n":{"vie":["Mới","Chờ xác nhận","Chờ hàng","Chờ in","Đã in","Đã đặt hàng","Đã xác nhận","Đang đóng hàng","Chờ chuyển hàng","Đã gửi hàng","Đã nhận","Đã thu tiền","Đang hoàn","Hoàn một phần","Đã hoàn","Đã hủy","Đã xóa"]}},"status_name":{"type":"string","description":"Order status name","x-description-i18n":{"vie":"Tên trạng thái đơn hàng"}},"bill_full_name":{"type":"string","description":"Customer name","x-description-i18n":{"vie":"Tên khách hàng"}},"bill_phone_number":{"type":"string","description":"Phone number of customer","x-description-i18n":{"vie":"SĐT khách hàng"}},"bill_email":{"type":"string","description":"Customer email","x-description-i18n":{"vie":"Email khách hàng"}},"conversation_id":{"type":"string","description":"Conversation ID","x-description-i18n":{"vie":"Mã hội thoại"}},"page_id":{"type":"string","description":"Facebook page ID","x-description-i18n":{"vie":"Mã Facebook page"}},"post_id":{"type":"string","description":"Post ID","x-description-i18n":{"vie":"Mã bài viết"}},"ad_id":{"type":"string","description":"Ad ID","x-description-i18n":{"vie":"Mã quảng cáo"}},"shipping_fee":{"type":"integer","description":"Shipping fee","x-description-i18n":{"vie":"Phí vận chuyển"}},"partner_fee":{"type":"integer","description":"Fee from shipping partner","x-description-i18n":{"vie":"Phí vận chuyển từ ĐVVC"}},"fee_marketplace":{"type":"integer","description":"Fees from e-commerce platforms","x-description-i18n":{"vie":"Phí sàn"}},"customer_pay_fee":{"type":"boolean","description":"Customer pay shipping fee","x-description-i18n":{"vie":"Khách trả phí ship"}},"is_free_shipping":{"type":"boolean","description":"Free shipping","x-description-i18n":{"vie":"Miễn phí vận chuyển"}},"is_livestream":{"type":"boolean","description":"Is livestream order","x-description-i18n":{"vie":"Đơn hàng từ livestream"}},"is_live_shopping":{"type":"boolean","description":"Is live shopping order","x-description-i18n":{"vie":"Đơn hàng từ live shopping"}},"is_smc":{"type":"boolean","description":"Shopping on Messenger","x-description-i18n":{"vie":"Đơn hàng từ mua sắm trên Messenger"}},"received_at_shop":{"type":"boolean","description":"true: Sales at counter, false: Sell online","x-description-i18n":{"vie":"true: Bán tại quầy, false: Bán online"}},"total_discount":{"type":"integer","description":"Discount total","x-description-i18n":{"vie":"Tổng tiền giảm giá"}},"note":{"type":"string","description":"Internal note","x-description-i18n":{"vie":"Ghi chú nội bộ"}},"note_print":{"type":"string","description":"Note for printing","x-description-i18n":{"vie":"Ghi chú đơn hàng"}},"returned_reason":{"type":"integer","description":"Return reason code (1: Customer, 2: Staff, 3: Defective product, 4: Shipping carrier, 5: Exchange). Other values are shop-defined custom reasons, see returned_reason_name for the display name","x-description-i18n":{"vie":"Mã lý do hoàn hàng (1: Do khách hàng, 2: Do nhân viên, 3: Do sản phẩm lỗi, 4: Do đơn vị vận chuyển, 5: Do đổi hàng). Mã khác là lý do tùy chỉnh theo từng shop, xem tên hiển thị tại returned_reason_name"}},"returned_reason_name":{"type":"string","description":"Return reason name","x-description-i18n":{"vie":"Tên lý do hoàn hàng"}},"sub_status":{"type":"integer","description":"Reason for delivery delay","x-description-i18n":{"vie":"Lý do delay giao hàng"}},"warehouse_id":{"type":"string","description":"Warehouse ID","x-description-i18n":{"vie":"Mã kho hàng"}},"warehouse_info":{"type":"object","description":"Warehouse information","x-description-i18n":{"vie":"Thông tin kho hàng"},"properties":{"name":{"type":"string","description":"Warehouse name","x-description-i18n":{"vie":"Tên kho hàng"}},"phone_number":{"type":"string","description":"Warehouse phone number","x-description-i18n":{"vie":"Số điện thoại kho hàng"}},"full_address":{"type":"string","description":"Warehouse full address","x-description-i18n":{"vie":"Địa chỉ đầy đủ kho hàng"}},"address":{"type":"string","description":"Warehouse address","x-description-i18n":{"vie":"Địa chỉ chi tiết kho hàng"}},"province_id":{"type":"string","description":"Province ID","x-description-i18n":{"vie":"Mã tỉnh thành phố"}},"district_id":{"type":"string","description":"District ID","x-description-i18n":{"vie":"Mã quận huyện"}},"commune_id":{"type":"string","description":"Commune ID","x-description-i18n":{"vie":"Mã phường xã"}},"affiliate_id":{"type":"string","description":"Affiliate ID","x-description-i18n":{"vie":"Mã đại lý"}},"ffm_id":{"type":"string","description":"FFM ID","x-description-i18n":{"vie":"Mã FFM"}},"has_snappy_service":{"type":"boolean","description":"Has Snappy service","x-description-i18n":{"vie":"Có dịch vụ Snappy"}},"custom_id":{"type":"string","description":"Custom ID","x-description-i18n":{"vie":"Mã tùy chỉnh"}}}},"creator_id":{"type":"string","description":"Creator ID","x-description-i18n":{"vie":"Mã người tạo"}},"creator":{"type":"object","description":"Order creator","x-description-i18n":{"vie":"Thông tin người tạo đơn"},"properties":{"id":{"type":"string","description":"Creator ID","x-description-i18n":{"vie":"Mã người tạo"}},"fb_id":{"type":"string","description":"Facebook ID of creator","x-description-i18n":{"vie":"ID facebook người tạo đơn"}},"name":{"type":"string","description":"Creator name","x-description-i18n":{"vie":"Tên người tạo đơn"}},"avatar_url":{"type":"string","description":"Creator avatar URL","x-description-i18n":{"vie":"Link avatar người tạo"}}}},"items":{"type":"array","description":"Product list. When creating or updating an order, each entry must include `variation_id` and `quantity`. `variation_info` is optional — if omitted, the backend treats it as an empty object; send it (with `retail_price`) when you need the line price to be explicit.","x-description-i18n":{"vie":"Danh sách sản phẩm. Khi tạo hoặc cập nhật đơn, mỗi phần tử cần có `variation_id` và `quantity`. `variation_info` không bắt buộc — nếu thiếu, backend coi như object rỗng; nên gửi kèm (cùng `retail_price`) khi muốn giá dòng hàng tường minh."},"items":{"type":"object","required":["variation_id","quantity"],"properties":{"product_id":{"type":"string","description":"Product ID","x-description-i18n":{"vie":"Mã sản phẩm"}},"quantity":{"type":"integer","description":"Quantity","x-description-i18n":{"vie":"Số lượng"}},"returned_count":{"type":"integer","description":"Returned count","x-description-i18n":{"vie":"Số lượng đã trả"}},"assigning_seller_id":{"type":"string","description":"Assigning seller ID","x-description-i18n":{"vie":"Mã nhân viên được phân công"}},"quantity_by_combo_products":{"type":"array","description":"Quantity by combo products","x-description-i18n":{"vie":"Số lượng theo combo sản phẩm"},"items":{"type":"object"}},"discount_each_product":{"type":"integer","description":"Discount for each product","x-description-i18n":{"vie":"Giảm giá cho từng sản phẩm"}},"is_bonus_product":{"type":"boolean","description":"Is bonus product","x-description-i18n":{"vie":"Sản phẩm tặng kèm"}},"is_discount_percent":{"type":"boolean","description":"Is discount by percent","x-description-i18n":{"vie":"Giảm giá theo phần trăm"}},"is_wholesale":{"type":"boolean","description":"Is wholesale","x-description-i18n":{"vie":"Bán sỉ"}},"is_composite":{"type":"boolean","description":"Is composite product","x-description-i18n":{"vie":"Sản phẩm composite"}},"one_time_product":{"type":"boolean","description":"One time product","x-description-i18n":{"vie":"Sản phẩm một lần"}},"note":{"type":"string","description":"Product note","x-description-i18n":{"vie":"Ghi chú sản phẩm"}},"note_product":{"type":"string","description":"Product note","x-description-i18n":{"vie":"Ghi chú sản phẩm"}},"inserted_at":{"type":"string","format":"date-time","description":"Inserted at","x-description-i18n":{"vie":"Thời điểm tạo"}},"measure_group_id":{"type":"integer","description":"Measure group ID","x-description-i18n":{"vie":"Mã nhóm đơn vị tính"}},"variation_info":{"type":"object","description":"Variation information. Optional when creating/updating an order (the backend defaults it to an empty object if omitted). Its inner fields are not individually required, but sending `retail_price` is recommended so the line price is correct.","x-description-i18n":{"vie":"Thông tin biến thể. Không bắt buộc khi tạo/cập nhật đơn (backend tự coi là object rỗng nếu thiếu). Các field bên trong không bắt buộc riêng lẻ, nhưng nên gửi `retail_price` để giá dòng hàng đúng."},"properties":{"id":{"type":"string","description":"Variation ID","x-description-i18n":{"vie":"Mã biến thể"}},"name":{"type":"string","description":"Product name","x-description-i18n":{"vie":"Tên sản phẩm"}},"product_id":{"type":"string","description":"Product ID","x-description-i18n":{"vie":"Mã sản phẩm"}},"retail_price":{"type":"integer","description":"Retail price. Not strictly required, but recommended when creating/updating an order so the line price is correct.","x-description-i18n":{"vie":"Giá bán lẻ. Không bắt buộc, nhưng nên gửi khi tạo/cập nhật đơn để giá dòng hàng chính xác."}},"detail":{"type":"string","description":"Variation detail","x-description-i18n":{"vie":"Chi tiết biến thể"}},"images":{"type":"array","description":"Variation images","x-description-i18n":{"vie":"Hình ảnh biến thể"},"items":{"type":"string","format":"uri"}},"fields":{"type":"array","description":"Variation fields","x-description-i18n":{"vie":"Thuộc tính biến thể"},"items":{"type":"object","properties":{"id":{"type":"string","description":"Field ID","x-description-i18n":{"vie":"Mã thuộc tính"}},"name":{"type":"string","description":"Field name","x-description-i18n":{"vie":"Tên thuộc tính"}},"value":{"type":"string","description":"Field value","x-description-i18n":{"vie":"Giá trị thuộc tính"}},"keyValue":{"type":"string","description":"Key value","x-description-i18n":{"vie":"Giá trị khóa"}}}}},"barcode":{"type":"string","description":"Barcode","x-description-i18n":{"vie":"Mã barcode"}},"brand_id":{"type":"string","description":"Brand ID","x-description-i18n":{"vie":"Mã thương hiệu"}},"category_ids":{"type":"array","description":"Category IDs","x-description-i18n":{"vie":"Danh sách mã danh mục"},"items":{"type":"integer"}},"display_id":{"type":"string","description":"Display ID","x-description-i18n":{"vie":"Mã hiển thị"}},"product_display_id":{"type":"string","description":"Product display ID","x-description-i18n":{"vie":"Mã hiển thị sản phẩm"}},"last_imported_price":{"type":"integer","description":"Last imported price","x-description-i18n":{"vie":"Giá nhập hàng cuối"}},"is_upsale_product":{"type":"boolean","description":"Upsale product","x-description-i18n":{"vie":"Sản phẩm upsale"}},"weight":{"type":"integer","description":"Weight","x-description-i18n":{"vie":"Khối lượng"}},"measure_info":{"type":"object","description":"Measure information","x-description-i18n":{"vie":"Thông tin đơn vị tính"},"properties":{"measure_id":{"type":"integer","description":"Measure ID","x-description-i18n":{"vie":"Mã đơn vị tính"}},"exchange_value":{"type":"integer","description":"Exchange value","x-description-i18n":{"vie":"Giá trị quy đổi"}}}},"avg_price":{"type":"integer","description":"Average import price","x-description-i18n":{"vie":"Giá nhập trung bình"}}}},"components":{"type":"array","description":"Product components","x-description-i18n":{"vie":"Thành phần sản phẩm"},"items":{"type":"object","properties":{"component_id":{"type":"string","description":"Component ID","x-description-i18n":{"vie":"Mã thành phần"}},"quantity":{"type":"integer","description":"Quantity","x-description-i18n":{"vie":"Số lượng"}},"variation_id":{"type":"string","description":"Variation ID","x-description-i18n":{"vie":"Mã biến thể"}},"variation_info":{"type":"object","description":"Variation information","x-description-i18n":{"vie":"Thông tin biến thể"}}}}},"id":{"type":"integer","description":"Item ID","x-description-i18n":{"vie":"Mã sản phẩm trong đơn"}},"variation_id":{"type":"string","description":"Variation ID","x-description-i18n":{"vie":"Mã biến thể"}}}}},"partner":{"type":"object","description":"Partner information","x-description-i18n":{"vie":"Thông tin đơn vị vận chuyển"},"properties":{"partner_id":{"type":"integer","description":"Partner ID","x-description-i18n":{"vie":"ID đơn vị vận chuyển trên hệ thống Pancake"}},"cod":{"type":"integer","description":"Reconciliation COD","x-description-i18n":{"vie":"Đối soát tiền thu hộ"}},"extend_code":{"type":"string","description":"Shipping order ID on partner system","x-description-i18n":{"vie":"Mã vận đơn"}},"total_fee":{"type":"integer","description":"Total fee","x-description-i18n":{"vie":"Tổng phí"}},"updated_at":{"type":"string","format":"date-time","description":"Updated at","x-description-i18n":{"vie":"Thời điểm cập nhật"}},"delivery_name":{"type":"string","description":"Shipper name","x-description-i18n":{"vie":"Tên người giao hàng"}},"delivery_tel":{"type":"string","description":"Delivery phone","x-description-i18n":{"vie":"Số điện thoại người giao hàng"}},"picked_up_at":{"type":"string","format":"date-time","description":"Picked up at","x-description-i18n":{"vie":"Thời điểm lấy hàng"}},"sort_code":{"type":"string","description":"Sort code","x-description-i18n":{"vie":"Mã phân loại"}},"paid_at":{"type":"string","format":"date-time","description":"Paid at","x-description-i18n":{"vie":"Thời điểm thanh toán"}},"system_created":{"type":"boolean","description":"System created","x-description-i18n":{"vie":"Được tạo bởi hệ thống"}},"extend_update":{"type":"array","description":"Update from courier","x-description-i18n":{"vie":"Cập nhật từ đơn vị vận chuyển"},"items":{"type":"object","properties":{"key":{"type":"string","description":"Update key","x-description-i18n":{"vie":"Mã cập nhật"}},"status":{"type":"string","description":"Status","x-description-i18n":{"vie":"Trạng thái"}},"tracking_id":{"type":"string","description":"Partner extend code","x-description-i18n":{"vie":"Mã đơn hàng đối tác"}},"note":{"type":"string","description":"Courier notes","x-description-i18n":{"vie":"Ghi chú từ đơn vị vận chuyển"}},"update_at":{"type":"string","format":"date-time","description":"Updated at","x-description-i18n":{"vie":"Thời điểm cập nhật"}}}}},"partner_status":{"type":"string","nullable":true,"description":"Partner shipping status","x-description-i18n":{"vie":"Trạng thái vận chuyển"},"enum":["waiting","request_received","processing_picked_up","picking_up","delay_pickup","picked_up","waiting_on_the_way","on_the_way","contact_delivery_company","out_for_delivery","delay_delivery","inform_recipient","undeliverable","waiting_for_return","delivered","delivered_cod","returning","returned","returned_cod","canceled"],"x-enum-descriptions":["Waiting for processing","Carrier received the request","Processing pickup","Picking up","Delayed pickup","Picked up","Waiting for transit","In transit","Contact the carrier","Out for delivery","Delayed delivery","Notify the recipient","Undeliverable","Waiting for return","Delivered","Delivered, COD reconciled","Returning","Returned","Returned, COD reconciled","Canceled"],"x-enum-descriptions-i18n":{"vie":["Chờ xử lý","ĐVVC đã tiếp nhận đơn","Đang xử lý lấy hàng","Đang lấy hàng","Trễ lấy hàng","Đã lấy hàng","Chờ trung chuyển","Đang trung chuyển","Liên hệ ĐVVC","Đang giao hàng","Trễ giao hàng","Thông báo cho người nhận","Giao không thành","Chờ chuyển hoàn","Đã giao hàng","Đã giao hàng, đã đối soát COD","Đang chuyển hoàn","Đã chuyển hoàn","Đã chuyển hoàn, đã đối soát COD","Đã hủy vận đơn"]}},"partner_name":{"type":"string","nullable":true,"description":"Partner name","x-description-i18n":{"vie":"Tên đơn vị vận chuyển"}},"first_delivery_at":{"type":"string","format":"date-time","nullable":true,"description":"First delivery time","x-description-i18n":{"vie":"Thời điểm giao hàng lần đầu"}},"first_undeliverable_at":{"type":"string","format":"date-time","nullable":true,"description":"First failed delivery time","x-description-i18n":{"vie":"Thời điểm giao hàng thất bại lần đầu"}},"order_number_vtp":{"type":"string","nullable":true,"description":"Viettel Post tracking number","x-description-i18n":{"vie":"Mã vận đơn Viettel Post"}},"printed_form":{"type":"object","nullable":true,"description":"Printed form","x-description-i18n":{"vie":"Mẫu in"}}}},"shipping_address":{"$ref":"#/components/schemas/ShippingAddress"},"payment_purchase_histories":{"type":"array","description":"Payment histories","x-description-i18n":{"vie":"Lịch sử thanh toán"},"items":{"type":"object","properties":{"amount":{"type":"integer","description":"Amount of money","x-description-i18n":{"vie":"Số tiền"}},"type":{"type":"string","description":"Payment type","x-description-i18n":{"vie":"Loại thanh toán"}},"inserted_at":{"type":"string","format":"date-time","description":"Transaction time","x-description-i18n":{"vie":"Thời điểm giao dịch"}},"result_code":{"type":"string","description":"Result code","x-description-i18n":{"vie":"Mã kết quả"}},"ipn_reply":{"type":"boolean","description":"IPN reply","x-description-i18n":{"vie":"Phản hồi IPN"}},"voucher_amount":{"type":"integer","description":"Voucher amount","x-description-i18n":{"vie":"Số tiền voucher"}},"tags":{"type":"array","description":"Tags","x-description-i18n":{"vie":"Thẻ"},"items":{"type":"string"}}}}},"tags":{"type":"array","description":"Tags list","x-description-i18n":{"vie":"Danh sách thẻ đơn hàng"},"items":{"type":"object","properties":{"id":{"type":"integer","description":"Tag ID","x-description-i18n":{"vie":"Mã thẻ đơn hàng"}},"name":{"type":"string","description":"Tag name","x-description-i18n":{"vie":"Tên thẻ đơn hàng"}}}}},"marketer":{"type":"object","description":"Marketer information","x-description-i18n":{"vie":"Thông tin marketer"},"properties":{"id":{"type":"string","description":"Marketer ID","x-description-i18n":{"vie":"Mã marketer"}},"name":{"type":"string","description":"Marketer name","x-description-i18n":{"vie":"Tên marketer"}},"email":{"type":"string","description":"Marketer email","x-description-i18n":{"vie":"Email marketer"}},"phone_number":{"type":"string","description":"Marketer phone number","x-description-i18n":{"vie":"Số điện thoại marketer"}},"fb_id":{"type":"string","description":"Marketer Facebook ID","x-description-i18n":{"vie":"Facebook ID marketer"}},"avatar_url":{"type":"string","description":"Marketer avatar URL","x-description-i18n":{"vie":"Link avatar marketer"}}}},"pke_mkter":{"type":"string","description":"Marketer ID","x-description-i18n":{"vie":"Mã nhân viên marketer"}},"activated_combo_products":{"type":"object","description":"Activated combo products information","x-description-i18n":{"vie":"Thông tin combo sản phẩm được kích hoạt"},"properties":{"combo_product_id":{"type":"integer","description":"Combo product ID","x-description-i18n":{"vie":"Mã combo sản phẩm"}},"quantity_combo_activated":{"type":"integer","description":"Quantity combo activated","x-description-i18n":{"vie":"Số lượng combo được kích hoạt"}},"combo_product_info":{"type":"object","description":"Combo product information","x-description-i18n":{"vie":"Thông tin combo sản phẩm"}}}},"activated_promotion_advances":{"type":"array","description":"Activated promotion advances information","x-description-i18n":{"vie":"Thông tin khuyến mãi được kích hoạt"},"items":{"type":"object","properties":{"id":{"type":"integer","description":"ID","x-description-i18n":{"vie":"Mã"}},"promotion_advance_id":{"type":"string","description":"Promotion advance ID","x-description-i18n":{"vie":"Mã khuyến mãi"}},"promotion_advance_info":{"type":"object","description":"Promotion advance information","x-description-i18n":{"vie":"Thông tin khuyến mãi"}}}}},"invoice_info_list":{"type":"array","description":"Invoice information list","x-description-i18n":{"vie":"Danh sách thông tin hóa đơn"},"items":{"type":"object","properties":{"error":{"type":"string","description":"Error message if any","x-description-i18n":{"vie":"Thông báo lỗi nếu có"}},"invoice_detail":{"type":"object","description":"Invoice detail information","x-description-i18n":{"vie":"Chi tiết thông tin hóa đơn"},"properties":{"company_address":{"type":"string","description":"Company address","x-description-i18n":{"vie":"Địa chỉ công ty"}},"company_address_breakdown":{"type":"object","description":"Company address breakdown","x-description-i18n":{"vie":"Chi tiết địa chỉ công ty"},"properties":{"company_additional_info":{"type":"string","description":"Company additional information","x-description-i18n":{"vie":"Thông tin bổ sung công ty"}},"company_barangay":{"type":"string","description":"Company barangay","x-description-i18n":{"vie":"Phường/xã công ty"}},"company_city":{"type":"string","description":"Company city","x-description-i18n":{"vie":"Thành phố công ty"}},"company_detailed_address":{"type":"string","description":"Company detailed address","x-description-i18n":{"vie":"Địa chỉ chi tiết công ty"}},"company_district":{"type":"string","description":"Company district","x-description-i18n":{"vie":"Quận/huyện công ty"}},"company_full_address":{"type":"string","description":"Company full address","x-description-i18n":{"vie":"Địa chỉ đầy đủ công ty"}},"company_postcode":{"type":"string","description":"Company postcode","x-description-i18n":{"vie":"Mã bưu điện công ty"}},"company_province":{"type":"string","description":"Company province","x-description-i18n":{"vie":"Tỉnh công ty"}},"company_region":{"type":"string","description":"Company region","x-description-i18n":{"vie":"Vùng/khu vực công ty"}},"company_state":{"type":"string","description":"Company state","x-description-i18n":{"vie":"Bang/tỉnh công ty"}},"company_town":{"type":"string","description":"Company town","x-description-i18n":{"vie":"Thị trấn/phường công ty"}}}},"company_email":{"type":"string","description":"Company email","x-description-i18n":{"vie":"Email công ty"}},"company_name":{"type":"string","description":"Company name","x-description-i18n":{"vie":"Tên công ty"}},"company_tax_id":{"type":"string","description":"Company tax ID","x-description-i18n":{"vie":"Mã số thuế công ty"}}}},"invoice_type":{"type":"string","description":"Invoice type","x-description-i18n":{"vie":"Loại hóa đơn"}},"is_requested":{"type":"boolean","description":"Request for invoice","x-description-i18n":{"vie":"Yêu cầu xuất hóa đơn"}},"order_sn":{"type":"string","description":"Order code on the marketplace","x-description-i18n":{"vie":"Mã đơn hàng trên sàn"}}}}},"reports_by_phone":{"type":"object","description":"Reports by phone number","x-description-i18n":{"vie":"Báo cáo theo số điện thoại"},"properties":{"order_fail":{"type":"integer","description":"Number of failed orders","x-description-i18n":{"vie":"Số đơn thất bại"}},"order_success":{"type":"integer","description":"Number of successful orders","x-description-i18n":{"vie":"Số đơn thành công"}},"warning":{"type":"integer","description":"Number of warnings orders","x-description-i18n":{"vie":"Số đơn cảnh báo"}}},"example":{"+639175706297":{"order_fail":29,"order_success":20,"warning":0}}},"tracking_link":{"type":"string","description":"Link confirm order","x-description-i18n":{"vie":"Link xác nhận đơn hàng"}},"ads_source":{"type":"string","description":"Advertising source","x-description-i18n":{"vie":"Nguồn quảng cáo"}},"bank_payments":{"type":"object","description":"Payment method","x-description-i18n":{"vie":"Phương thức thanh toán"}},"transfer_proofs":{"type":"array","description":"Bank transfer payment proofs, including verification time, amount and receipt images","x-description-i18n":{"vie":"Danh sách chứng từ xác thực chuyển khoản, gồm ngày giờ xác thực, số tiền và ảnh chứng từ"},"items":{"type":"object","properties":{"id":{"type":"integer","description":"Transfer proof ID","x-description-i18n":{"vie":"Mã chứng từ chuyển khoản"}},"order_id":{"type":"integer","description":"Order ID","x-description-i18n":{"vie":"Mã đơn hàng"}},"shop_id":{"type":"integer","description":"Shop ID","x-description-i18n":{"vie":"Mã cửa hàng"}},"payment_id":{"type":"string","description":"Bank payment method ID (matches a key in `bank_payments`)","x-description-i18n":{"vie":"Mã phương thức thanh toán ngân hàng (trùng với key trong `bank_payments`)"}},"amount":{"type":"integer","description":"Transferred amount","x-description-i18n":{"vie":"Số tiền chuyển khoản"}},"images":{"type":"array","description":"Transfer receipt images","x-description-i18n":{"vie":"Danh sách ảnh chứng từ chuyển khoản"},"items":{"type":"string"}},"note":{"type":"string","nullable":true,"description":"Note","x-description-i18n":{"vie":"Ghi chú"}},"is_income":{"type":"boolean","description":"Money received (true) or paid out (false)","x-description-i18n":{"vie":"Là khoản tiền nhận vào (true) hay chi ra (false)"}},"is_verify":{"type":"boolean","description":"Whether the transfer has been verified","x-description-i18n":{"vie":"Chứng từ đã được xác thực hay chưa"}},"verify_at":{"type":"string","format":"date-time","nullable":true,"description":"Verification time","x-description-i18n":{"vie":"Thời điểm xác thực chuyển khoản"}},"verifier":{"type":"object","nullable":true,"description":"Verifier information","x-description-i18n":{"vie":"Thông tin người xác thực"},"properties":{"id":{"type":"string","description":"Verifier ID","x-description-i18n":{"vie":"Mã người xác thực"}},"name":{"type":"string","description":"Verifier name","x-description-i18n":{"vie":"Tên người xác thực"}},"fb_id":{"type":"string","description":"Facebook ID of verifier","x-description-i18n":{"vie":"Facebook ID người xác thực"}},"avatar_url":{"type":"string","description":"Verifier avatar URL","x-description-i18n":{"vie":"Link avatar người xác thực"}}}},"creator":{"type":"object","nullable":true,"description":"Creator information","x-description-i18n":{"vie":"Thông tin người tạo chứng từ"},"properties":{"id":{"type":"string","description":"Creator ID","x-description-i18n":{"vie":"Mã người tạo"}},"name":{"type":"string","description":"Creator name","x-description-i18n":{"vie":"Tên người tạo"}},"fb_id":{"type":"string","description":"Facebook ID of creator","x-description-i18n":{"vie":"Facebook ID người tạo"}},"avatar_url":{"type":"string","description":"Creator avatar URL","x-description-i18n":{"vie":"Link avatar người tạo"}}}},"last_editor":{"type":"object","nullable":true,"description":"Last editor information","x-description-i18n":{"vie":"Thông tin người chỉnh sửa cuối"},"properties":{"id":{"type":"string","description":"Editor ID","x-description-i18n":{"vie":"Mã người chỉnh sửa"}},"name":{"type":"string","description":"Editor name","x-description-i18n":{"vie":"Tên người chỉnh sửa"}},"fb_id":{"type":"string","description":"Facebook ID of editor","x-description-i18n":{"vie":"Facebook ID người chỉnh sửa"}},"avatar_url":{"type":"string","description":"Editor avatar URL","x-description-i18n":{"vie":"Link avatar người chỉnh sửa"}}}},"order_info":{"type":"object","nullable":true,"description":"Additional order information","x-description-i18n":{"vie":"Thông tin đơn hàng bổ sung"}},"inserted_at":{"type":"string","format":"date-time","description":"Transfer proof creation time","x-description-i18n":{"vie":"Thời điểm tạo chứng từ"}},"updated_at":{"type":"string","format":"date-time","description":"Transfer proof update time","x-description-i18n":{"vie":"Thời điểm cập nhật chứng từ"}}}}},"shopify_order_id":{"type":"string","description":"Shopify order ID","x-description-i18n":{"vie":"Mã đơn hàng Shopify"}},"shopify_abandon_checkout_id":{"type":"integer","description":"Shopify abandon checkout ID","x-description-i18n":{"vie":"Mã Shopify abandon checkout"}},"is_abandoned_order":{"type":"boolean","description":"Abandoned-cart flag for creating or updating an order. Send it directly in the request body, not inside `third_party` or `third_party_infomation`.\nAn explicit value, including `false`, takes precedence over automatic detection. If omitted on creation, the flag is determined automatically; if omitted on update, the current value is preserved.\nOnly boolean `true` or string `\"true\"` is normalized to `true`; all other submitted values become `false`.\n","x-description-i18n":{"vie":"Cờ đơn chưa hoàn tất khi tạo hoặc cập nhật đơn. Truyền trực tiếp trong body, không bọc trong `third_party` hoặc `third_party_infomation`.\nGiá trị truyền lên, kể cả `false`, được ưu tiên hơn kết quả nhận diện tự động. Nếu bỏ qua khi tạo đơn, cờ được xác định tự động; nếu bỏ qua khi cập nhật, giữ nguyên giá trị hiện tại.\nChỉ boolean `true` hoặc chuỗi `\"true\"` được chuẩn hóa thành `true`; mọi giá trị khác được gửi lên đều thành `false`.\n"},"example":true},"cod":{"type":"integer","description":"Cash on delivery","x-description-i18n":{"vie":"Tiền thu hộ"}},"cash":{"type":"integer","description":"Cash payment","x-description-i18n":{"vie":"Tiền mặt"}},"account":{"type":"integer","description":"Order source ID","x-description-i18n":{"vie":"Mã nguồn đơn hàng"}},"account_name":{"type":"string","description":"Order source name","x-description-i18n":{"vie":"Tên mã nguồn đơn"}},"advanced_platform_fee":{"type":"object","description":"Fees from e-commerce platforms","x-description-i18n":{"vie":"Phí từ sàn thương mại điện tử"},"properties":{"ads_top_up":{"type":"integer","description":"Ads wallet top-up","x-description-i18n":{"vie":"Ví quảng cáo"}},"affiliate_commission":{"type":"integer","description":"Affiliate commission","x-description-i18n":{"vie":"Phí hoa hồng (Sàn TMĐT)"}},"diff_shipping_fee":{"type":"integer","description":"Difference shipping fee","x-description-i18n":{"vie":"Chênh lệch phí vận chuyển (Sàn TMĐT)"}},"marketplace_voucher":{"type":"integer","description":"Marketplace voucher","x-description-i18n":{"vie":"Sàn trợ giá"}},"payment_fee":{"type":"integer","description":"Payment fee","x-description-i18n":{"vie":"Phí cố định, giao dịch (Sàn TMĐT)"}},"platform_commission":{"type":"integer","description":"Platform commission","x-description-i18n":{"vie":"Phí hoa hồng nền tảng (Sàn TMĐT)"}},"seller_transaction_fee":{"type":"integer","description":"Seller transaction fee","x-description-i18n":{"vie":"Phí thanh toán (Sàn TMĐT)"}},"service_fee":{"type":"integer","description":"Service fee","x-description-i18n":{"vie":"Phí dịch vụ (Sàn TMĐT)"}},"sfp_service_fee":{"type":"integer","description":"SFP service fee","x-description-i18n":{"vie":"Phí dịch vụ SFP (Sàn TMĐT)"}}}},"printing_count":{"type":"integer","description":"Printing count","x-description-i18n":{"vie":"Số lần in"}},"money_to_collect":{"type":"integer","description":"Money to collect","x-description-i18n":{"vie":"Số tiền cần thu"}},"marketplace_id":{"type":"string","description":"Marketplace ID","enum":["-2","-3","-4","-9","-16","-17","-20","-25","-27","-28"],"x-enum-descriptions":{"-2":"Tiki","-3":"Shopee","-4":"Lazada","-9":"TikTok","-16":"WooCommerce","-17":"Shopify","-20":"Line Shopping","-25":"Tokopedia","-27":"Mercado Libre","-28":"Tiendanube"},"x-description-i18n":{"vie":"Mã sàn thương mại điện tử"}},"total_price":{"type":"integer","description":"Total price","x-description-i18n":{"vie":"Tổng giá trị sản phẩm"}},"shop_customer_address_id":{"type":"string","description":"Customer address ID","x-description-i18n":{"vie":"Mã địa chỉ khách hàng"}},"customer":{"type":"object","description":"Customer information","x-description-i18n":{"vie":"Thông tin khách hàng"},"properties":{"fb_id":{"type":"string","description":"Customer Facebook ID","x-description-i18n":{"vie":"Facebook ID khách hàng"}},"id":{"type":"string","description":"Customer ID","x-description-i18n":{"vie":"Mã khách hàng"}},"name":{"type":"string","description":"Customer name","x-description-i18n":{"vie":"Tên khách hàng"}},"page_id":{"type":"string","description":"Page ID","x-description-i18n":{"vie":"Mã trang"}}}},"total_quantity":{"type":"integer","description":"Total quantity","x-description-i18n":{"vie":"Tổng số lượng"}},"time_assign_marketer":{"type":"string","format":"date-time","description":"Time assign marketer","x-description-i18n":{"vie":"Thời điểm phân công marketer"}},"p_utm_source":{"type":"string","description":"UTM Source","x-description-i18n":{"vie":"UTM Source"}},"p_utm_medium":{"type":"string","description":"UTM Medium","x-description-i18n":{"vie":"UTM Medium"}},"p_utm_campaign":{"type":"string","description":"UTM Campaign","x-description-i18n":{"vie":"UTM Campaign"}},"p_utm_term":{"type":"string","description":"UTM Term","x-description-i18n":{"vie":"UTM Term"}},"p_utm_content":{"type":"string","description":"UTM Content","x-description-i18n":{"vie":"UTM Content"}},"p_utm_id":{"type":"string","description":"UTM ID","x-description-i18n":{"vie":"UTM ID"}},"utm_affiliate":{"type":"string","description":"Affiliate","x-description-i18n":{"vie":"Affiliate"}},"link":{"type":"string","description":"Link","x-description-i18n":{"vie":"Link"}},"status_history":{"type":"array","description":"Status update history","x-description-i18n":{"vie":"Lịch sử cập nhật trạng thái"},"items":{"type":"object","properties":{"avatar_url":{"type":"string","description":"Avatar URL","x-description-i18n":{"vie":"Link avatar"}},"editor":{"type":"object","description":"Editor information","x-description-i18n":{"vie":"Thông tin người chỉnh sửa"}},"editor_fb":{"type":"string","description":"Editor Facebook ID","x-description-i18n":{"vie":"Facebook ID người chỉnh sửa"}},"editor_id":{"type":"string","description":"Editor ID","x-description-i18n":{"vie":"Mã người chỉnh sửa"}},"name":{"type":"string","description":"Name","x-description-i18n":{"vie":"Tên"}},"old_status":{"type":"integer","description":"Old status","x-description-i18n":{"vie":"Trạng thái cũ"}},"status":{"type":"integer","description":"Status","x-description-i18n":{"vie":"Trạng thái"}},"updated_at":{"type":"string","format":"date-time","description":"Updated at","x-description-i18n":{"vie":"Thời điểm cập nhật"}}}}},"duplicated_phone":{"type":"boolean","description":"Duplicated phone","x-description-i18n":{"vie":"Số điện thoại trùng lặp"}},"order_currency":{"type":"string","description":"Order currency","x-description-i18n":{"vie":"Loại tiền tệ"}},"charged_by_vnpay":{"type":"integer","description":"Charged by VNPay","x-description-i18n":{"vie":"Số tiền thanh toán qua VNPay"}},"charged_by_qrpay":{"type":"integer","description":"Charged by QRPay","x-description-i18n":{"vie":"Số tiền khách thanh toán qua QRPAY"}},"custom_id":{"type":"string","description":"Custom ID","x-description-i18n":{"vie":"Mã tùy chỉnh"}},"last_editor":{"type":"object","description":"Last editor information","x-description-i18n":{"vie":"Thông tin người chỉnh sửa cuối cùng đơn hàng"},"properties":{"id":{"type":"string","description":"Editor ID","x-description-i18n":{"vie":"Mã người chỉnh sửa"}},"fb_id":{"type":"string","description":"Facebook ID of editor","x-description-i18n":{"vie":"Facebook ID người chỉnh sửa"}},"name":{"type":"string","description":"Editor name","x-description-i18n":{"vie":"Tên người chỉnh sửa"}},"email":{"type":"string","description":"Editor email","x-description-i18n":{"vie":"Email người chỉnh sửa"}},"avatar_url":{"type":"string","description":"Editor avatar URL","x-description-i18n":{"vie":"Link avatar người chỉnh sửa"}},"phone_number":{"type":"string","description":"Editor phone number","x-description-i18n":{"vie":"Số điện thoại người chỉnh sửa"}}}},"last_editor_id":{"type":"string","description":"Last editor ID","x-description-i18n":{"vie":"Mã người sửa cuối"}},"charged_by_momo":{"type":"integer","description":"Charged by MoMo","x-description-i18n":{"vie":"Số tiền khách thanh toán qua MOMO"}},"prepaid_by_point":{"type":"object","description":"Prepaid by point","x-description-i18n":{"vie":"Thanh toán bằng điểm thưởng"},"properties":{"money":{"type":"integer","description":"Money amount","x-description-i18n":{"vie":"Số tiền"},"example":15000},"point":{"type":"integer","description":"Point amount","x-description-i18n":{"vie":"Số điểm"},"example":15}},"example":{"money":15000,"point":15}},"bank_transfer_images":{"type":"array","description":"Bank transfer images","x-description-i18n":{"vie":"Hình ảnh chuyển khoản"},"items":{"type":"string","format":"uri"}},"transfer_money":{"type":"integer","description":"Transfer money","x-description-i18n":{"vie":"Số tiền khách chuyển khoản"}},"lock_order_by_user":{"type":"string","description":"Lock order by user ID","x-description-i18n":{"vie":"Mã người dùng khóa đơn hàng"}},"assigning_care":{"type":"object","description":"Assigning care information","x-description-i18n":{"vie":"Nhân viên chăm sóc"},"properties":{"id":{"type":"string","description":"Care ID","x-description-i18n":{"vie":"Mã người chăm sóc"}},"fb_id":{"type":"string","description":"Facebook ID of care","x-description-i18n":{"vie":"Facebook ID người chăm sóc"}},"name":{"type":"string","description":"Care name","x-description-i18n":{"vie":"Tên người chăm sóc"}},"email":{"type":"string","description":"Care email","x-description-i18n":{"vie":"Email người chăm sóc"}},"avatar_url":{"type":"string","description":"Care avatar URL","x-description-i18n":{"vie":"Link avatar người chăm sóc"}},"phone_number":{"type":"string","description":"Care phone number","x-description-i18n":{"vie":"Số điện thoại người chăm sóc"}}}},"assigning_care_id":{"type":"string","description":"Assigning care ID","x-description-i18n":{"vie":"Mã nhân viên chăm sóc"}},"time_assign_care":{"type":"string","format":"date-time","description":"Time assign care","x-description-i18n":{"vie":"Thời điểm phân công chăm sóc"}},"assigning_seller":{"type":"object","description":"Assigning seller information","x-description-i18n":{"vie":"Nhân viên được phân công"},"properties":{"id":{"type":"string","description":"Seller ID","x-description-i18n":{"vie":"Mã người bán"}},"fb_id":{"type":"string","description":"Facebook ID of seller","x-description-i18n":{"vie":"Facebook ID người bán"}},"name":{"type":"string","description":"Seller name","x-description-i18n":{"vie":"Tên người bán"}},"email":{"type":"string","description":"Seller email","x-description-i18n":{"vie":"Email người bán"}},"avatar_url":{"type":"string","description":"Seller avatar URL","x-description-i18n":{"vie":"Link avatar người bán"}},"phone_number":{"type":"string","description":"Seller phone number","x-description-i18n":{"vie":"Số điện thoại người bán"}}}},"einvoices":{"type":"array","items":{"$ref":"#/components/schemas/EInvoice"}},"charged_by_card":{"type":"integer","description":"Charged by card","x-description-i18n":{"vie":"Số tiền khách quẹt thẻ"}},"estimate_delivery_date":{"type":"string","format":"date-time","description":"Estimate delivery date","x-description-i18n":{"vie":"Ngày giao hàng dự kiến"}},"order_sources":{"type":"string","description":"Order sources ID","x-description-i18n":{"vie":"Mã nguồn đơn hàng"}},"charged_by_fundiin":{"type":"integer","description":"Charged by Fundiin","x-description-i18n":{"vie":"Số tiền thanh toán qua Fundiin"}},"surcharge":{"type":"integer","description":"Surcharge","x-description-i18n":{"vie":"Phụ thu"}},"is_linked_partner":{"type":"boolean","description":"Is linked partner","x-description-i18n":{"vie":"Đã liên kết đối tác"}},"call_laters":{"type":"array","description":"Call laters","x-description-i18n":{"vie":"Gọi lại sau"},"items":{"type":"object"}},"last_update_status_at":{"type":"string","format":"date-time","description":"Last update status at","x-description-i18n":{"vie":"Thời điểm cập nhật trạng thái cuối"}},"discount_by_customer_level":{"type":"integer","description":"Discount by customer level","x-description-i18n":{"vie":"Giảm giá theo cấp độ khách hàng"}},"viewing":{"type":"array","description":"Viewing","x-description-i18n":{"vie":"NV đang xem"},"items":{"type":"object"}},"additional_info":{"type":"object","description":"Additional info","x-description-i18n":{"vie":"Thông tin bổ sung"},"properties":{"service_partner":{"type":"string","description":"Service partner","x-description-i18n":{"vie":"Dịch vụ vận chuyển"},"enum":["instant"],"x-enum-descriptions":["Instant"],"x-enum-descriptions-i18n":{"vie":["Hỏa tốc"]}},"delivery_deadline":{"type":"string","format":"date-time","description":"Delivery deadline (ISO8601, no timezone). Send null to clear.","x-description-i18n":{"vie":"Hạn giao hàng (ISO8601, không kèm timezone). Gửi null để xóa."},"example":"2026-06-03T10:00:00"}}},"order_returned_ids":{"type":"string","description":"Order returned IDs","x-description-i18n":{"vie":"Mã đơn hàng đổi trả"}},"cost_surcharge":{"type":"integer","description":"Cost surcharge","x-description-i18n":{"vie":"Phụ phí"}},"time_send_partner":{"type":"string","format":"date-time","description":"Time send partner","x-description-i18n":{"vie":"Thời điểm gửi đơn vị vận chuyển"}},"charged_by_kredivo":{"type":"integer","description":"Charged by Kredivo","x-description-i18n":{"vie":"Số tiền thanh toán qua Kredivo"}},"discount":{"type":"integer","description":"Discount","x-description-i18n":{"vie":"Giảm giá"}},"histories":{"type":"array","description":"Histories","x-description-i18n":{"vie":"Lịch sử"},"items":{"type":"object"}},"duplicated_customer":{"type":"boolean","description":"Duplicated customer","x-description-i18n":{"vie":"Khách hàng trùng lặp"}},"customer_referral_code":{"type":"object","description":"Customer referral code","x-description-i18n":{"vie":"Mã giới thiệu khách hàng"},"properties":{"active":{"type":"string","description":"Active status","x-description-i18n":{"vie":"Trạng thái kích hoạt"},"example":"true"},"customer_id":{"type":"string","format":"uuid","description":"Customer ID","x-description-i18n":{"vie":"Mã khách hàng"},"example":"09bb9399-45f3-4897-a53a-85dde2f886fe"},"discount":{"type":"string","description":"Discount value","x-description-i18n":{"vie":"Giá trị giảm giá"},"example":"10"},"format":{"type":"string","description":"Referral code format","x-description-i18n":{"vie":"Định dạng mã giới thiệu"},"example":"{PHONE_NUMBER}"},"free_products_priced_between_approx":{"type":"object","description":"Free products priced between approximately","x-description-i18n":{"vie":"Miễn phí cho khách mới sản phẩm có giá"},"properties":{"active":{"type":"string","description":"Active status","x-description-i18n":{"vie":"Trạng thái kích hoạt"},"example":"true"},"operator":{"type":"string","description":"Comparison operator","x-description-i18n":{"vie":"Toán tử so sánh"},"example":"GreaterOrEqual"},"price":{"type":"string","description":"Price threshold","x-description-i18n":{"vie":"Ngưỡng giá"},"example":"150000"}}},"is_percent":{"type":"string","description":"Discount is percentage","x-description-i18n":{"vie":"Giảm giá theo phần trăm"},"example":"true"},"only_customers_with_level_will_have_referral_code":{"type":"string","description":"Only customers with level will have referral code","x-description-i18n":{"vie":"Chỉ khách hàng có cấp độ mới có mã giới thiệu"},"example":"true"},"referral_code":{"type":"string","description":"Referral code","x-description-i18n":{"vie":"Mã giới thiệu"},"example":"982843759"},"reward_points_for_old_customers":{"type":"object","description":"Reward points for customers","x-description-i18n":{"vie":"Điểm thưởng khách hàng"},"properties":{"active":{"type":"string","description":"Active status","x-description-i18n":{"vie":"Trạng thái kích hoạt"},"example":"true"},"money":{"type":"string","description":"Money reward","x-description-i18n":{"vie":"Tiền thưởng"},"example":"10000"},"point":{"type":"string","description":"Point reward","x-description-i18n":{"vie":"Điểm thưởng"},"example":"1"}}},"shop_customer_id":{"type":"string","format":"uuid","description":"Shop customer ID","x-description-i18n":{"vie":"Mã khách hàng shop"},"example":"f8160a4c-dfa7-4ee8-b540-d245755ea1f1"}},"example":{"active":"true","customer_id":"09bb9399-45f3-4897-a53a-85dde2f886fe","discount":"10","format":"{PHONE_NUMBER}","free_products_priced_between_approx":{"active":"true","operator":"GreaterOrEqual","price":"150000"},"is_percent":"true","only_customers_with_level_will_have_referral_code":"true","referral_code":"982843759","reward_points_for_old_customers":{"active":"true","money":"10000","point":"1"},"shop_customer_id":"f8160a4c-dfa7-4ee8-b540-d245755ea1f1"}},"tax":{"type":"integer","description":"Tax","x-description-i18n":{"vie":"Thuế"}},"is_from_ecommerce":{"type":"boolean","description":"Is from e-commerce","x-description-i18n":{"vie":"Đơn hàng từ sàn thương mại điện tử"}},"note_image":{"type":"array","description":"Note images","x-description-i18n":{"vie":"Link hình ảnh ghi chú"},"items":{"type":"string","format":"uri"}},"shopify_draft_order_id":{"type":"string","description":"Shopify draft order ID","x-description-i18n":{"vie":"Mã đơn hàng nháp Shopify"}},"display_id":{"type":"integer","description":"Display ID","x-description-i18n":{"vie":"Mã hiển thị"}},"shop_partner_id":{"type":"integer","description":"Shop partner ID","x-description-i18n":{"vie":"Mã đối tác shop"}},"is_locked":{"type":"boolean","description":"Order lock","x-description-i18n":{"vie":"Khóa đơn hàng"}},"merge_order":{"type":"boolean","description":"Allows merging orders","x-description-i18n":{"vie":"Cho phép gộp đơn"}}}},"examples":{"default":{"value":{"id":1,"system_id":1,"shop_id":1,"inserted_at":"2024-01-01T00:00:00Z","updated_at":"2024-01-01T00:00:00Z","status":1,"status_name":"Đã xác nhận","bill_full_name":"Hoang Anh","bill_phone_number":"0999999999","bill_email":"hoang@example.com","page_id":"104438181227821","post_id":"185187094667903_477083092110915","ad_id":"23851252560290199","shipping_fee":1,"partner_fee":1,"fee_marketplace":1,"customer_pay_fee":true,"is_free_shipping":true,"is_livestream":true,"is_live_shopping":true,"is_smc":true,"received_at_shop":true,"total_discount":1,"note":"","note_print":null,"returned_reason":1,"returned_reason_name":"Do khách hàng","sub_status":1,"warehouse_id":"b4cb5897-6e56-4581-96cc-2f12677c7bd8","warehouse_info":{"name":"kho test ecod","phone_number":"0999999999","full_address":"hâhhha, Xã Bình Trung, Huyện Châu Đức, Bà Rịa-Vũng Tàu","address":"hâhhha","province_id":"717","district_id":"71705","commune_id":"7170510","affiliate_id":null,"ffm_id":null,"has_snappy_service":true,"custom_id":null},"creator_id":"8fbe2a6f-b0b2-4227-a698-19d18c43f7c8","creator":{"id":"8fbe2a6f-b0b2-4227-a698-19d18c43f7c8","fb_id":"2042723249341651","name":"Hoang Anh","avatar_url":null},"items":[{"id":1,"product_id":"3487e126-b0d9-4dae-89a9-ee60bef2f4e9","variation_id":"415040f4-ab63-465e-8699-e9ebfff4c6c7","quantity":1,"returned_count":1,"assigning_seller_id":"340644fc-314d-450e-a45f-33343678cab6","quantity_by_combo_products":[],"discount_each_product":1,"is_bonus_product":true,"is_discount_percent":true,"is_wholesale":true,"is_composite":true,"one_time_product":true,"note":"","note_product":"","inserted_at":"2024-01-01T00:00:00Z","measure_group_id":1,"variation_info":{"id":"415040f4-ab63-465e-8699-e9ebfff4c6c7","name":"Ao so mi nam","product_id":"3487e126-b0d9-4dae-89a9-ee60bef2f4e9","retail_price":140000,"detail":"","images":["https://statics.pancake.vn/user-content.pancake.vn/2021/8/5/fccd6.jpg"],"fields":[{"id":"field-id-1","name":"Màu","value":"Trắng","keyValue":"Màu"}],"barcode":"BARCODE123","brand_id":null,"category_ids":[1290021044],"display_id":"13109","product_display_id":"a131092025","is_upsale_product":true,"last_imported_price":30000,"weight":0,"measure_info":{"measure_id":1,"exchange_value":1},"avg_price":30000},"components":[{"component_id":"3487e126-b0d9-4dae-89a9-ee60bef2f4e9","quantity":1,"variation_id":"415040f4-ab63-465e-8699-e9ebfff4c6c7"}]}],"partner":{"partner_id":1,"cod":0,"extend_code":"S58824.MB25.C3.500020713","total_fee":0,"updated_at":"2020-05-12T05:18:16","delivery_name":null,"delivery_tel":null,"picked_up_at":null,"sort_code":null,"paid_at":null,"system_created":true,"partner_status":"request_received","partner_name":"Shopee Xpress","first_delivery_at":null,"first_undeliverable_at":"2025-06-30T06:41:44","order_number_vtp":null,"printed_form":null,"extend_update":[{"key":"status","status":"delivered","tracking_id":"S58824.MB25.C3.500020713","note":"","update_at":"2020-05-12T05:18:16"}]},"shipping_address":{"full_name":"Hoang Anh","phone_number":"0999999999","address":"90 Cầu Giấy","full_address":"90 Cầu Giấy, Phường Dịch Vọng, Quận Cầu Giấy, Hà Nội","province_id":"101","district_id":"10113","commune_id":"1011309","commnue_name":"Phường Dịch Vọng","district_name":"Quận Cầu Giấy","province_name":"Hà Nội","country_code":"84","post_code":null},"payment_purchase_histories":[{"amount":1800000,"type":"cash","inserted_at":"2024-01-01T00:00:00Z","result_code":"00","ipn_reply":true,"voucher_amount":0,"tags":["payment"]}],"tags":[{"id":75,"name":"thẻ 4"}],"marketer":{"id":"cee3c05e-5f85-43c4-b27e-889b99c50097","name":"Marketer Name","email":"marketer@example.com","phone_number":"0999999999","fb_id":"2042723249341651","avatar_url":null},"pke_mkter":"cee3c05e-5f85-43c4-b27e-889b99c50097","activated_combo_products":{"combo_product_id":1,"quantity_combo_activated":1},"activated_promotion_advances":[{"id":1,"promotion_advance_id":"fb056b32-9cf6-4c5a-92de-0eb94db71121"}],"tracking_link":"https://tracking.example.com","ads_source":null,"shopify_order_id":null,"shopify_abandon_checkout_id":1,"is_abandoned_order":true,"cod":0,"cash":0,"account":1,"account_name":"facebook321","advanced_platform_fee":{"ads_top_up":1,"affiliate_commission":1,"diff_shipping_fee":1,"marketplace_voucher":1,"payment_fee":1,"platform_commission":1,"seller_transaction_fee":1,"service_fee":1,"sfp_service_fee":1},"printing_count":1,"marketplace_id":"-3","money_to_collect":1,"total_price":1,"shop_customer_address_id":"0fefd213-7d0c-4d5b-bdbf-35694da80857","customer":{"fb_id":null,"id":"96a8e283-3fba-492e-a35a-970f72a30a02","name":"Trần Văn Hoàng","page_id":"104438181227821"},"total_quantity":1,"time_assign_marketer":"2024-01-01T00:00:00Z","status_history":[{"avatar_url":null,"editor_fb":"2042723249341651","editor_id":"8fbe2a6f-b0b2-4227-a698-19d18c43f7c8","name":"Hoang Anh","old_status":0,"status":1,"updated_at":"2024-01-01T00:00:00Z"}],"duplicated_phone":true,"order_currency":"VND","charged_by_vnpay":1,"charged_by_qrpay":1,"custom_id":null,"last_editor":{"id":"8fbe2a6f-b0b2-4227-a698-19d18c43f7c8","fb_id":"2042723249341651","name":"Hoang Anh","email":"hoang@example.com","avatar_url":null,"phone_number":"0999999999"},"last_editor_id":"8fbe2a6f-b0b2-4227-a698-19d18c43f7c8","charged_by_momo":1,"bank_transfer_images":["https://statics.pancake.vn/user-content.pancake.vn/2021/8/5/fccd6.jpg"],"transfer_money":1,"transfer_proofs":[{"id":1,"order_id":1,"shop_id":1,"payment_id":"64e130e4-012a-45b1-bd88-51811f23ead8","amount":1,"images":["https://statics.pancake.vn/user-content.pancake.vn/2021/8/5/fccd6.jpg"],"note":null,"is_income":true,"is_verify":true,"verify_at":"2024-01-01T00:00:00Z","verifier":{"id":"8fbe2a6f-b0b2-4227-a698-19d18c43f7c8","fb_id":"2042723249341651","name":"Hoang Anh","avatar_url":null},"creator":{"id":"8fbe2a6f-b0b2-4227-a698-19d18c43f7c8","fb_id":"2042723249341651","name":"Hoang Anh","avatar_url":null},"last_editor":{"id":"8fbe2a6f-b0b2-4227-a698-19d18c43f7c8","fb_id":"2042723249341651","name":"Hoang Anh","avatar_url":null},"order_info":null,"inserted_at":"2024-01-01T00:00:00Z","updated_at":"2024-01-01T00:00:00Z"}],"lock_order_by_user":null,"assigning_care":{"id":"cee3c05e-5f85-43c4-b27e-889b99c50097","fb_id":"2042723249341651","name":"Care Name","email":"care@example.com","avatar_url":null,"phone_number":"0999999999"},"assigning_care_id":"cee3c05e-5f85-43c4-b27e-889b99c50097","time_assign_care":"2024-01-01T00:00:00Z","assigning_seller":{"id":"340644fc-314d-450e-a45f-33343678cab6","fb_id":"2042723249341651","name":"Seller Name","email":"seller@example.com","avatar_url":null,"phone_number":"0999999999"},"einvoices":[],"charged_by_card":1,"estimate_delivery_date":"2024-01-01T00:00:00Z","order_sources":"-1","charged_by_fundiin":1,"surcharge":1,"is_linked_partner":true,"call_laters":[],"last_update_status_at":"2024-01-01T00:00:00Z","discount_by_customer_level":1,"viewing":[],"order_returned_ids":null,"cost_surcharge":1,"time_send_partner":"2024-01-01T00:00:00Z","charged_by_kredivo":1,"discount":1,"histories":[],"duplicated_customer":true,"tax":1,"is_from_ecommerce":true,"note_image":["https://statics.pancake.vn/user-content.pancake.vn/2021/8/5/fccd6.jpg"],"shopify_draft_order_id":null,"display_id":1,"shop_partner_id":1,"is_locked":true,"additional_info":{"service_partner":"instant"},"invoice_info_list":[{"error":"","invoice_detail":{"company_address":"85 lê quý đôn, phường nam định, tỉnh Ninh Bình","company_address_breakdown":{"company_additional_info":"","company_barangay":"","company_city":"","company_detailed_address":"85 lê quý đôn, phường nam định, tỉnh Ninh Bình","company_district":"Phường Nam Định","company_full_address":"85 lê quý đôn, phường nam định, tỉnh Ninh Bình","company_postcode":"","company_province":"","company_region":"VietNam","company_state":"Ninh Bình","company_town":"Phường Nam Định","company_email":"acb@gmail.com","company_name":"Công ty cổ phần tư vấn xây dựng điện Hoàng Phát","company_tax_id":"0601043840"}},"invoice_type":"company","is_requested":true,"order_sn":"251121BVGU6RVE"}],"reports_by_phone":{"+639175706297":{"order_fail":29,"order_success":20,"warning":0}},"p_utm_source":"fb","p_utm_medium":"paid","p_utm_campaign":"120236828168640593","p_utm_term":"120236828168790593","p_utm_content":"120236828168960593","link":"https://www.myfahathai.com/doc?fbclid=IwZXh0bgNhZW0BMABhZGlkAasqwhnoX"}}}}}}}},"put":{"summary":"Update order","x-summary-i18n":{"vie":"Cập nhật đơn hàng"},"description":"Update order","x-description-i18n":{"vie":"Cập nhật đơn hàng"},"tags":["Order"],"x-tags-i18n":{"vie":["Đơn hàng"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},{"name":"ORDER_ID","in":"path","required":true,"schema":{"type":"string","example":"1418"},"description":"Order ID","x-description-i18n":{"vie":"Mã đơn hàng"}}],"requestBody":{"required":true,"description":"Order information to update","x-description-i18n":{"vie":"Thông tin đơn hàng cần cập nhật"},"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"integer","description":"Order ID","x-description-i18n":{"vie":"Mã đơn hàng"}},"system_id":{"type":"integer","description":"System ID","x-description-i18n":{"vie":"Mã hệ thống"}},"shop_id":{"type":"integer","description":"Shop ID","x-description-i18n":{"vie":"Mã cửa hàng"}},"inserted_at":{"type":"string","format":"date-time","description":"Order creation time","x-description-i18n":{"vie":"Thời điểm tạo đơn"}},"updated_at":{"type":"string","format":"date-time","description":"Order update time","x-description-i18n":{"vie":"Thời điểm cập nhật đơn"}},"status":{"type":"integer","description":"Order status","x-description-i18n":{"vie":"Trạng thái đơn hàng"},"enum":[0,17,11,12,13,20,1,8,9,2,3,16,4,15,5,6,7],"x-enum-descriptions":["New","Waiting for confirmation","Restocking","Wait for printing","Printed","Purchased","Confirmed","Packaging","Waiting for pick up","Shipped","Received","Collected money","Returning","Partial return","Returned","Canceled","Deleted recently"],"x-enum-descriptions-i18n":{"vie":["Mới","Chờ xác nhận","Chờ hàng","Chờ in","Đã in","Đã đặt hàng","Đã xác nhận","Đang đóng hàng","Chờ chuyển hàng","Đã gửi hàng","Đã nhận","Đã thu tiền","Đang hoàn","Hoàn một phần","Đã hoàn","Đã hủy","Đã xóa"]}},"status_name":{"type":"string","description":"Order status name","x-description-i18n":{"vie":"Tên trạng thái đơn hàng"}},"bill_full_name":{"type":"string","description":"Customer name","x-description-i18n":{"vie":"Tên khách hàng"}},"bill_phone_number":{"type":"string","description":"Phone number of customer","x-description-i18n":{"vie":"SĐT khách hàng"}},"bill_email":{"type":"string","description":"Customer email","x-description-i18n":{"vie":"Email khách hàng"}},"conversation_id":{"type":"string","description":"Conversation ID","x-description-i18n":{"vie":"Mã hội thoại"}},"page_id":{"type":"string","description":"Facebook page ID","x-description-i18n":{"vie":"Mã Facebook page"}},"post_id":{"type":"string","description":"Post ID","x-description-i18n":{"vie":"Mã bài viết"}},"ad_id":{"type":"string","description":"Ad ID","x-description-i18n":{"vie":"Mã quảng cáo"}},"shipping_fee":{"type":"integer","description":"Shipping fee","x-description-i18n":{"vie":"Phí vận chuyển"}},"partner_fee":{"type":"integer","description":"Fee from shipping partner","x-description-i18n":{"vie":"Phí vận chuyển từ ĐVVC"}},"fee_marketplace":{"type":"integer","description":"Fees from e-commerce platforms","x-description-i18n":{"vie":"Phí sàn"}},"customer_pay_fee":{"type":"boolean","description":"Customer pay shipping fee","x-description-i18n":{"vie":"Khách trả phí ship"}},"is_free_shipping":{"type":"boolean","description":"Free shipping","x-description-i18n":{"vie":"Miễn phí vận chuyển"}},"is_livestream":{"type":"boolean","description":"Is livestream order","x-description-i18n":{"vie":"Đơn hàng từ livestream"}},"is_live_shopping":{"type":"boolean","description":"Is live shopping order","x-description-i18n":{"vie":"Đơn hàng từ live shopping"}},"is_smc":{"type":"boolean","description":"Shopping on Messenger","x-description-i18n":{"vie":"Đơn hàng từ mua sắm trên Messenger"}},"received_at_shop":{"type":"boolean","description":"true: Sales at counter, false: Sell online","x-description-i18n":{"vie":"true: Bán tại quầy, false: Bán online"}},"total_discount":{"type":"integer","description":"Discount total","x-description-i18n":{"vie":"Tổng tiền giảm giá"}},"note":{"type":"string","description":"Internal note","x-description-i18n":{"vie":"Ghi chú nội bộ"}},"note_print":{"type":"string","description":"Note for printing","x-description-i18n":{"vie":"Ghi chú đơn hàng"}},"returned_reason":{"type":"integer","description":"Return reason code (1: Customer, 2: Staff, 3: Defective product, 4: Shipping carrier, 5: Exchange). Other values are shop-defined custom reasons, see returned_reason_name for the display name","x-description-i18n":{"vie":"Mã lý do hoàn hàng (1: Do khách hàng, 2: Do nhân viên, 3: Do sản phẩm lỗi, 4: Do đơn vị vận chuyển, 5: Do đổi hàng). Mã khác là lý do tùy chỉnh theo từng shop, xem tên hiển thị tại returned_reason_name"}},"returned_reason_name":{"type":"string","description":"Return reason name","x-description-i18n":{"vie":"Tên lý do hoàn hàng"}},"sub_status":{"type":"integer","description":"Reason for delivery delay","x-description-i18n":{"vie":"Lý do delay giao hàng"}},"warehouse_id":{"type":"string","description":"Warehouse ID","x-description-i18n":{"vie":"Mã kho hàng"}},"warehouse_info":{"type":"object","description":"Warehouse information","x-description-i18n":{"vie":"Thông tin kho hàng"},"properties":{"name":{"type":"string","description":"Warehouse name","x-description-i18n":{"vie":"Tên kho hàng"}},"phone_number":{"type":"string","description":"Warehouse phone number","x-description-i18n":{"vie":"Số điện thoại kho hàng"}},"full_address":{"type":"string","description":"Warehouse full address","x-description-i18n":{"vie":"Địa chỉ đầy đủ kho hàng"}},"address":{"type":"string","description":"Warehouse address","x-description-i18n":{"vie":"Địa chỉ chi tiết kho hàng"}},"province_id":{"type":"string","description":"Province ID","x-description-i18n":{"vie":"Mã tỉnh thành phố"}},"district_id":{"type":"string","description":"District ID","x-description-i18n":{"vie":"Mã quận huyện"}},"commune_id":{"type":"string","description":"Commune ID","x-description-i18n":{"vie":"Mã phường xã"}},"affiliate_id":{"type":"string","description":"Affiliate ID","x-description-i18n":{"vie":"Mã đại lý"}},"ffm_id":{"type":"string","description":"FFM ID","x-description-i18n":{"vie":"Mã FFM"}},"has_snappy_service":{"type":"boolean","description":"Has Snappy service","x-description-i18n":{"vie":"Có dịch vụ Snappy"}},"custom_id":{"type":"string","description":"Custom ID","x-description-i18n":{"vie":"Mã tùy chỉnh"}}}},"creator_id":{"type":"string","description":"Creator ID","x-description-i18n":{"vie":"Mã người tạo"}},"creator":{"type":"object","description":"Order creator","x-description-i18n":{"vie":"Thông tin người tạo đơn"},"properties":{"id":{"type":"string","description":"Creator ID","x-description-i18n":{"vie":"Mã người tạo"}},"fb_id":{"type":"string","description":"Facebook ID of creator","x-description-i18n":{"vie":"ID facebook người tạo đơn"}},"name":{"type":"string","description":"Creator name","x-description-i18n":{"vie":"Tên người tạo đơn"}},"avatar_url":{"type":"string","description":"Creator avatar URL","x-description-i18n":{"vie":"Link avatar người tạo"}}}},"items":{"type":"array","description":"Product list","x-description-i18n":{"vie":"Danh sách sản phẩm"},"items":{"type":"object","required":["variation_id","quantity"],"properties":{"product_id":{"type":"string","description":"Product ID","x-description-i18n":{"vie":"Mã sản phẩm"}},"quantity":{"type":"integer","description":"Quantity","x-description-i18n":{"vie":"Số lượng"}},"returned_count":{"type":"integer","description":"Returned count","x-description-i18n":{"vie":"Số lượng đã trả"}},"assigning_seller_id":{"type":"string","description":"Assigning seller ID","x-description-i18n":{"vie":"Mã nhân viên được phân công"}},"quantity_by_combo_products":{"type":"array","description":"Quantity by combo products","x-description-i18n":{"vie":"Số lượng theo combo sản phẩm"},"items":{"type":"object"}},"discount_each_product":{"type":"integer","description":"Discount for each product","x-description-i18n":{"vie":"Giảm giá cho từng sản phẩm"}},"is_bonus_product":{"type":"boolean","description":"Is bonus product","x-description-i18n":{"vie":"Sản phẩm tặng kèm"}},"is_discount_percent":{"type":"boolean","description":"Is discount by percent","x-description-i18n":{"vie":"Giảm giá theo phần trăm"}},"is_wholesale":{"type":"boolean","description":"Is wholesale","x-description-i18n":{"vie":"Bán sỉ"}},"is_composite":{"type":"boolean","description":"Is composite product","x-description-i18n":{"vie":"Sản phẩm composite"}},"one_time_product":{"type":"boolean","description":"One time product","x-description-i18n":{"vie":"Sản phẩm một lần"}},"note":{"type":"string","description":"Product note","x-description-i18n":{"vie":"Ghi chú sản phẩm"}},"note_product":{"type":"string","description":"Product note","x-description-i18n":{"vie":"Ghi chú sản phẩm"}},"inserted_at":{"type":"string","format":"date-time","description":"Inserted at","x-description-i18n":{"vie":"Thời điểm tạo"}},"measure_group_id":{"type":"integer","description":"Measure group ID","x-description-i18n":{"vie":"Mã nhóm đơn vị tính"}},"variation_info":{"type":"object","description":"Variation information. Optional when creating/updating an order (the backend defaults it to an empty object if omitted). Its inner fields are not individually required, but sending `retail_price` is recommended so the line price is correct.","x-description-i18n":{"vie":"Thông tin biến thể. Không bắt buộc khi tạo/cập nhật đơn (backend tự coi là object rỗng nếu thiếu). Các field bên trong không bắt buộc riêng lẻ, nhưng nên gửi `retail_price` để giá dòng hàng đúng."},"properties":{"id":{"type":"string","description":"Variation ID","x-description-i18n":{"vie":"Mã biến thể"}},"name":{"type":"string","description":"Product name","x-description-i18n":{"vie":"Tên sản phẩm"}},"product_id":{"type":"string","description":"Product ID","x-description-i18n":{"vie":"Mã sản phẩm"}},"retail_price":{"type":"integer","description":"Retail price. Not strictly required, but recommended when creating/updating an order so the line price is correct.","x-description-i18n":{"vie":"Giá bán lẻ. Không bắt buộc, nhưng nên gửi khi tạo/cập nhật đơn để giá dòng hàng chính xác."}},"detail":{"type":"string","description":"Variation detail","x-description-i18n":{"vie":"Chi tiết biến thể"}},"images":{"type":"array","description":"Variation images","x-description-i18n":{"vie":"Hình ảnh biến thể"},"items":{"type":"string","format":"uri"}},"fields":{"type":"array","description":"Variation fields","x-description-i18n":{"vie":"Thuộc tính biến thể"},"items":{"type":"object","properties":{"id":{"type":"string","description":"Field ID","x-description-i18n":{"vie":"Mã thuộc tính"}},"name":{"type":"string","description":"Field name","x-description-i18n":{"vie":"Tên thuộc tính"}},"value":{"type":"string","description":"Field value","x-description-i18n":{"vie":"Giá trị thuộc tính"}},"keyValue":{"type":"string","description":"Key value","x-description-i18n":{"vie":"Giá trị khóa"}}}}},"barcode":{"type":"string","description":"Barcode","x-description-i18n":{"vie":"Mã barcode"}},"brand_id":{"type":"string","description":"Brand ID","x-description-i18n":{"vie":"Mã thương hiệu"}},"category_ids":{"type":"array","description":"Category IDs","x-description-i18n":{"vie":"Danh sách mã danh mục"},"items":{"type":"integer"}},"display_id":{"type":"string","description":"Display ID","x-description-i18n":{"vie":"Mã hiển thị"}},"product_display_id":{"type":"string","description":"Product display ID","x-description-i18n":{"vie":"Mã hiển thị sản phẩm"}},"last_imported_price":{"type":"integer","description":"Last imported price","x-description-i18n":{"vie":"Giá nhập hàng cuối"}},"is_upsale_product":{"type":"boolean","description":"Upsale product","x-description-i18n":{"vie":"Sản phẩm upsale"}},"weight":{"type":"integer","description":"Weight","x-description-i18n":{"vie":"Khối lượng"}},"measure_info":{"type":"object","description":"Measure information","x-description-i18n":{"vie":"Thông tin đơn vị tính"},"properties":{"measure_id":{"type":"integer","description":"Measure ID","x-description-i18n":{"vie":"Mã đơn vị tính"}},"exchange_value":{"type":"integer","description":"Exchange value","x-description-i18n":{"vie":"Giá trị quy đổi"}}}},"avg_price":{"type":"integer","description":"Average import price","x-description-i18n":{"vie":"Giá nhập trung bình"}}}},"components":{"type":"array","description":"Product components","x-description-i18n":{"vie":"Thành phần sản phẩm"},"items":{"type":"object","properties":{"component_id":{"type":"string","description":"Component ID","x-description-i18n":{"vie":"Mã thành phần"}},"quantity":{"type":"integer","description":"Quantity","x-description-i18n":{"vie":"Số lượng"}},"variation_id":{"type":"string","description":"Variation ID","x-description-i18n":{"vie":"Mã biến thể"}},"variation_info":{"type":"object","description":"Variation information","x-description-i18n":{"vie":"Thông tin biến thể"}}}}},"variation_id":{"type":"string","description":"Variation ID","x-description-i18n":{"vie":"Mã biến thể"}}}}},"partner":{"type":"object","description":"Partner information","x-description-i18n":{"vie":"Thông tin đơn vị vận chuyển"},"properties":{"partner_id":{"type":"integer","description":"Partner ID","x-description-i18n":{"vie":"ID đơn vị vận chuyển trên hệ thống Pancake"}},"cod":{"type":"integer","description":"Reconciliation COD","x-description-i18n":{"vie":"Đối soát tiền thu hộ"}},"extend_code":{"type":"string","description":"Shipping order ID on partner system","x-description-i18n":{"vie":"Mã vận đơn"}},"total_fee":{"type":"integer","description":"Total fee","x-description-i18n":{"vie":"Tổng phí"}},"updated_at":{"type":"string","format":"date-time","description":"Updated at","x-description-i18n":{"vie":"Thời điểm cập nhật"}},"delivery_name":{"type":"string","description":"Shipper name","x-description-i18n":{"vie":"Tên người giao hàng"}},"delivery_tel":{"type":"string","description":"Delivery phone","x-description-i18n":{"vie":"Số điện thoại người giao hàng"}},"picked_up_at":{"type":"string","format":"date-time","description":"Picked up at","x-description-i18n":{"vie":"Thời điểm lấy hàng"}},"sort_code":{"type":"string","description":"Sort code","x-description-i18n":{"vie":"Mã phân loại"}},"paid_at":{"type":"string","format":"date-time","description":"Paid at","x-description-i18n":{"vie":"Thời điểm thanh toán"}},"system_created":{"type":"boolean","description":"System created","x-description-i18n":{"vie":"Được tạo bởi hệ thống"}},"extend_update":{"type":"array","description":"Update from courier","x-description-i18n":{"vie":"Cập nhật từ đơn vị vận chuyển"},"items":{"type":"object","properties":{"key":{"type":"string","description":"Update key","x-description-i18n":{"vie":"Mã cập nhật"}},"status":{"type":"string","description":"Status","x-description-i18n":{"vie":"Trạng thái"}},"tracking_id":{"type":"string","description":"Partner extend code","x-description-i18n":{"vie":"Mã đơn hàng đối tác"}},"note":{"type":"string","description":"Courier notes","x-description-i18n":{"vie":"Ghi chú từ đơn vị vận chuyển"}},"update_at":{"type":"string","format":"date-time","description":"Updated at","x-description-i18n":{"vie":"Thời điểm cập nhật"}}}}},"partner_status":{"type":"string","nullable":true,"description":"Partner shipping status","x-description-i18n":{"vie":"Trạng thái vận chuyển"},"enum":["waiting","request_received","processing_picked_up","picking_up","delay_pickup","picked_up","waiting_on_the_way","on_the_way","contact_delivery_company","out_for_delivery","delay_delivery","inform_recipient","undeliverable","waiting_for_return","delivered","delivered_cod","returning","returned","returned_cod","canceled"],"x-enum-descriptions":["Waiting for processing","Carrier received the request","Processing pickup","Picking up","Delayed pickup","Picked up","Waiting for transit","In transit","Contact the carrier","Out for delivery","Delayed delivery","Notify the recipient","Undeliverable","Waiting for return","Delivered","Delivered, COD reconciled","Returning","Returned","Returned, COD reconciled","Canceled"],"x-enum-descriptions-i18n":{"vie":["Chờ xử lý","ĐVVC đã tiếp nhận đơn","Đang xử lý lấy hàng","Đang lấy hàng","Trễ lấy hàng","Đã lấy hàng","Chờ trung chuyển","Đang trung chuyển","Liên hệ ĐVVC","Đang giao hàng","Trễ giao hàng","Thông báo cho người nhận","Giao không thành","Chờ chuyển hoàn","Đã giao hàng","Đã giao hàng, đã đối soát COD","Đang chuyển hoàn","Đã chuyển hoàn","Đã chuyển hoàn, đã đối soát COD","Đã hủy vận đơn"]}},"partner_name":{"type":"string","nullable":true,"description":"Partner name","x-description-i18n":{"vie":"Tên đơn vị vận chuyển"}},"first_delivery_at":{"type":"string","format":"date-time","nullable":true,"description":"First delivery time","x-description-i18n":{"vie":"Thời điểm giao hàng lần đầu"}},"first_undeliverable_at":{"type":"string","format":"date-time","nullable":true,"description":"First failed delivery time","x-description-i18n":{"vie":"Thời điểm giao hàng thất bại lần đầu"}},"order_number_vtp":{"type":"string","nullable":true,"description":"Viettel Post tracking number","x-description-i18n":{"vie":"Mã vận đơn Viettel Post"}},"printed_form":{"type":"object","nullable":true,"description":"Printed form","x-description-i18n":{"vie":"Mẫu in"}}}},"shipping_address":{"$ref":"#/components/schemas/ShippingAddress"},"payment_purchase_histories":{"type":"array","description":"Payment histories","x-description-i18n":{"vie":"Lịch sử thanh toán"},"items":{"type":"object","properties":{"amount":{"type":"integer","description":"Amount of money","x-description-i18n":{"vie":"Số tiền"}},"type":{"type":"string","description":"Payment type","x-description-i18n":{"vie":"Loại thanh toán"}},"inserted_at":{"type":"string","format":"date-time","description":"Transaction time","x-description-i18n":{"vie":"Thời điểm giao dịch"}},"result_code":{"type":"string","description":"Result code","x-description-i18n":{"vie":"Mã kết quả"}},"ipn_reply":{"type":"boolean","description":"IPN reply","x-description-i18n":{"vie":"Phản hồi IPN"}},"voucher_amount":{"type":"integer","description":"Voucher amount","x-description-i18n":{"vie":"Số tiền voucher"}},"tags":{"type":"array","description":"Tags","x-description-i18n":{"vie":"Thẻ"},"items":{"type":"string"}}}}},"tags":{"type":"array","description":"Tags list","x-description-i18n":{"vie":"Danh sách thẻ đơn hàng"},"items":{"type":"object","properties":{"id":{"type":"integer","description":"Tag ID","x-description-i18n":{"vie":"Mã thẻ đơn hàng"}},"name":{"type":"string","description":"Tag name","x-description-i18n":{"vie":"Tên thẻ đơn hàng"}}}}},"marketer":{"type":"object","description":"Marketer information","x-description-i18n":{"vie":"Thông tin marketer"},"properties":{"id":{"type":"string","description":"Marketer ID","x-description-i18n":{"vie":"Mã marketer"}},"name":{"type":"string","description":"Marketer name","x-description-i18n":{"vie":"Tên marketer"}},"email":{"type":"string","description":"Marketer email","x-description-i18n":{"vie":"Email marketer"}},"phone_number":{"type":"string","description":"Marketer phone number","x-description-i18n":{"vie":"Số điện thoại marketer"}},"fb_id":{"type":"string","description":"Marketer Facebook ID","x-description-i18n":{"vie":"Facebook ID marketer"}},"avatar_url":{"type":"string","description":"Marketer avatar URL","x-description-i18n":{"vie":"Link avatar marketer"}}}},"pke_mkter":{"type":"string","description":"Marketer ID","x-description-i18n":{"vie":"Mã nhân viên marketer"}},"activated_combo_products":{"type":"object","description":"Activated combo products information","x-description-i18n":{"vie":"Thông tin combo sản phẩm được kích hoạt"},"properties":{"combo_product_id":{"type":"integer","description":"Combo product ID","x-description-i18n":{"vie":"Mã combo sản phẩm"}},"quantity_combo_activated":{"type":"integer","description":"Quantity combo activated","x-description-i18n":{"vie":"Số lượng combo được kích hoạt"}},"combo_product_info":{"type":"object","description":"Combo product information","x-description-i18n":{"vie":"Thông tin combo sản phẩm"}}}},"activated_promotion_advances":{"type":"array","description":"Activated promotion advances information","x-description-i18n":{"vie":"Thông tin khuyến mãi được kích hoạt"},"items":{"type":"object","properties":{"id":{"type":"integer","description":"ID","x-description-i18n":{"vie":"Mã"}},"promotion_advance_id":{"type":"string","description":"Promotion advance ID","x-description-i18n":{"vie":"Mã khuyến mãi"}},"promotion_advance_info":{"type":"object","description":"Promotion advance information","x-description-i18n":{"vie":"Thông tin khuyến mãi"}}}}},"invoice_info_list":{"type":"array","description":"Invoice information list","x-description-i18n":{"vie":"Danh sách thông tin hóa đơn"},"items":{"type":"object","properties":{"error":{"type":"string","description":"Error message if any","x-description-i18n":{"vie":"Thông báo lỗi nếu có"}},"invoice_detail":{"type":"object","description":"Invoice detail information","x-description-i18n":{"vie":"Chi tiết thông tin hóa đơn"},"properties":{"company_address":{"type":"string","description":"Company address","x-description-i18n":{"vie":"Địa chỉ công ty"}},"company_address_breakdown":{"type":"object","description":"Company address breakdown","x-description-i18n":{"vie":"Chi tiết địa chỉ công ty"},"properties":{"company_additional_info":{"type":"string","description":"Company additional information","x-description-i18n":{"vie":"Thông tin bổ sung công ty"}},"company_barangay":{"type":"string","description":"Company barangay","x-description-i18n":{"vie":"Phường/xã công ty"}},"company_city":{"type":"string","description":"Company city","x-description-i18n":{"vie":"Thành phố công ty"}},"company_detailed_address":{"type":"string","description":"Company detailed address","x-description-i18n":{"vie":"Địa chỉ chi tiết công ty"}},"company_district":{"type":"string","description":"Company district","x-description-i18n":{"vie":"Quận/huyện công ty"}},"company_full_address":{"type":"string","description":"Company full address","x-description-i18n":{"vie":"Địa chỉ đầy đủ công ty"}},"company_postcode":{"type":"string","description":"Company postcode","x-description-i18n":{"vie":"Mã bưu điện công ty"}},"company_province":{"type":"string","description":"Company province","x-description-i18n":{"vie":"Tỉnh công ty"}},"company_region":{"type":"string","description":"Company region","x-description-i18n":{"vie":"Vùng/khu vực công ty"}},"company_state":{"type":"string","description":"Company state","x-description-i18n":{"vie":"Bang/tỉnh công ty"}},"company_town":{"type":"string","description":"Company town","x-description-i18n":{"vie":"Thị trấn/phường công ty"}}}},"company_email":{"type":"string","description":"Company email","x-description-i18n":{"vie":"Email công ty"}},"company_name":{"type":"string","description":"Company name","x-description-i18n":{"vie":"Tên công ty"}},"company_tax_id":{"type":"string","description":"Company tax ID","x-description-i18n":{"vie":"Mã số thuế công ty"}}}},"invoice_type":{"type":"string","description":"Invoice type","x-description-i18n":{"vie":"Loại hóa đơn"}},"is_requested":{"type":"boolean","description":"Request for invoice","x-description-i18n":{"vie":"Yêu cầu xuất hóa đơn"}},"order_sn":{"type":"string","description":"Order code on the marketplace","x-description-i18n":{"vie":"Mã đơn hàng trên sàn"}}}}},"reports_by_phone":{"type":"object","description":"Reports by phone number","x-description-i18n":{"vie":"Báo cáo theo số điện thoại"},"properties":{"order_fail":{"type":"integer","description":"Number of failed orders","x-description-i18n":{"vie":"Số đơn thất bại"}},"order_success":{"type":"integer","description":"Number of successful orders","x-description-i18n":{"vie":"Số đơn thành công"}},"warning":{"type":"integer","description":"Number of warnings orders","x-description-i18n":{"vie":"Số đơn cảnh báo"}}},"example":{"+639175706297":{"order_fail":29,"order_success":20,"warning":0}}},"tracking_link":{"type":"string","description":"Link confirm order","x-description-i18n":{"vie":"Link xác nhận đơn hàng"}},"ads_source":{"type":"string","description":"Advertising source","x-description-i18n":{"vie":"Nguồn quảng cáo"}},"bank_payments":{"type":"object","description":"Payment method","x-description-i18n":{"vie":"Phương thức thanh toán"}},"transfer_proofs":{"type":"array","description":"Bank transfer payment proofs, including verification time, amount and receipt images","x-description-i18n":{"vie":"Danh sách chứng từ xác thực chuyển khoản, gồm ngày giờ xác thực, số tiền và ảnh chứng từ"},"items":{"type":"object","properties":{"id":{"type":"integer","description":"Transfer proof ID","x-description-i18n":{"vie":"Mã chứng từ chuyển khoản"}},"order_id":{"type":"integer","description":"Order ID","x-description-i18n":{"vie":"Mã đơn hàng"}},"shop_id":{"type":"integer","description":"Shop ID","x-description-i18n":{"vie":"Mã cửa hàng"}},"payment_id":{"type":"string","description":"Bank payment method ID (matches a key in `bank_payments`)","x-description-i18n":{"vie":"Mã phương thức thanh toán ngân hàng (trùng với key trong `bank_payments`)"}},"amount":{"type":"integer","description":"Transferred amount","x-description-i18n":{"vie":"Số tiền chuyển khoản"}},"images":{"type":"array","description":"Transfer receipt images","x-description-i18n":{"vie":"Danh sách ảnh chứng từ chuyển khoản"},"items":{"type":"string"}},"note":{"type":"string","nullable":true,"description":"Note","x-description-i18n":{"vie":"Ghi chú"}},"is_income":{"type":"boolean","description":"Money received (true) or paid out (false)","x-description-i18n":{"vie":"Là khoản tiền nhận vào (true) hay chi ra (false)"}},"is_verify":{"type":"boolean","description":"Whether the transfer has been verified","x-description-i18n":{"vie":"Chứng từ đã được xác thực hay chưa"}},"verify_at":{"type":"string","format":"date-time","nullable":true,"description":"Verification time","x-description-i18n":{"vie":"Thời điểm xác thực chuyển khoản"}},"verifier":{"type":"object","nullable":true,"description":"Verifier information","x-description-i18n":{"vie":"Thông tin người xác thực"},"properties":{"id":{"type":"string","description":"Verifier ID","x-description-i18n":{"vie":"Mã người xác thực"}},"name":{"type":"string","description":"Verifier name","x-description-i18n":{"vie":"Tên người xác thực"}},"fb_id":{"type":"string","description":"Facebook ID of verifier","x-description-i18n":{"vie":"Facebook ID người xác thực"}},"avatar_url":{"type":"string","description":"Verifier avatar URL","x-description-i18n":{"vie":"Link avatar người xác thực"}}}},"creator":{"type":"object","nullable":true,"description":"Creator information","x-description-i18n":{"vie":"Thông tin người tạo chứng từ"},"properties":{"id":{"type":"string","description":"Creator ID","x-description-i18n":{"vie":"Mã người tạo"}},"name":{"type":"string","description":"Creator name","x-description-i18n":{"vie":"Tên người tạo"}},"fb_id":{"type":"string","description":"Facebook ID of creator","x-description-i18n":{"vie":"Facebook ID người tạo"}},"avatar_url":{"type":"string","description":"Creator avatar URL","x-description-i18n":{"vie":"Link avatar người tạo"}}}},"last_editor":{"type":"object","nullable":true,"description":"Last editor information","x-description-i18n":{"vie":"Thông tin người chỉnh sửa cuối"},"properties":{"id":{"type":"string","description":"Editor ID","x-description-i18n":{"vie":"Mã người chỉnh sửa"}},"name":{"type":"string","description":"Editor name","x-description-i18n":{"vie":"Tên người chỉnh sửa"}},"fb_id":{"type":"string","description":"Facebook ID of editor","x-description-i18n":{"vie":"Facebook ID người chỉnh sửa"}},"avatar_url":{"type":"string","description":"Editor avatar URL","x-description-i18n":{"vie":"Link avatar người chỉnh sửa"}}}},"order_info":{"type":"object","nullable":true,"description":"Additional order information","x-description-i18n":{"vie":"Thông tin đơn hàng bổ sung"}},"inserted_at":{"type":"string","format":"date-time","description":"Transfer proof creation time","x-description-i18n":{"vie":"Thời điểm tạo chứng từ"}},"updated_at":{"type":"string","format":"date-time","description":"Transfer proof update time","x-description-i18n":{"vie":"Thời điểm cập nhật chứng từ"}}}}},"shopify_order_id":{"type":"string","description":"Shopify order ID","x-description-i18n":{"vie":"Mã đơn hàng Shopify"}},"shopify_abandon_checkout_id":{"type":"integer","description":"Shopify abandon checkout ID","x-description-i18n":{"vie":"Mã Shopify abandon checkout"}},"is_abandoned_order":{"type":"boolean","description":"Abandoned-cart flag for creating or updating an order. Send it directly in the request body, not inside `third_party` or `third_party_infomation`.\nAn explicit value, including `false`, takes precedence over automatic detection. If omitted on creation, the flag is determined automatically; if omitted on update, the current value is preserved.\nOnly boolean `true` or string `\"true\"` is normalized to `true`; all other submitted values become `false`.\n","x-description-i18n":{"vie":"Cờ đơn chưa hoàn tất khi tạo hoặc cập nhật đơn. Truyền trực tiếp trong body, không bọc trong `third_party` hoặc `third_party_infomation`.\nGiá trị truyền lên, kể cả `false`, được ưu tiên hơn kết quả nhận diện tự động. Nếu bỏ qua khi tạo đơn, cờ được xác định tự động; nếu bỏ qua khi cập nhật, giữ nguyên giá trị hiện tại.\nChỉ boolean `true` hoặc chuỗi `\"true\"` được chuẩn hóa thành `true`; mọi giá trị khác được gửi lên đều thành `false`.\n"},"example":true},"cod":{"type":"integer","description":"Cash on delivery","x-description-i18n":{"vie":"Tiền thu hộ"}},"cash":{"type":"integer","description":"Cash payment","x-description-i18n":{"vie":"Tiền mặt"}},"account":{"type":"integer","description":"Order source ID","x-description-i18n":{"vie":"Mã nguồn đơn hàng"}},"account_name":{"type":"string","description":"Order source name","x-description-i18n":{"vie":"Tên mã nguồn đơn"}},"advanced_platform_fee":{"type":"object","description":"Fees from e-commerce platforms","x-description-i18n":{"vie":"Phí từ sàn thương mại điện tử"},"properties":{"ads_top_up":{"type":"integer","description":"Ads wallet top-up","x-description-i18n":{"vie":"Ví quảng cáo"}},"affiliate_commission":{"type":"integer","description":"Affiliate commission","x-description-i18n":{"vie":"Phí hoa hồng (Sàn TMĐT)"}},"diff_shipping_fee":{"type":"integer","description":"Difference shipping fee","x-description-i18n":{"vie":"Chênh lệch phí vận chuyển (Sàn TMĐT)"}},"marketplace_voucher":{"type":"integer","description":"Marketplace voucher","x-description-i18n":{"vie":"Sàn trợ giá"}},"payment_fee":{"type":"integer","description":"Payment fee","x-description-i18n":{"vie":"Phí cố định, giao dịch (Sàn TMĐT)"}},"platform_commission":{"type":"integer","description":"Platform commission","x-description-i18n":{"vie":"Phí hoa hồng nền tảng (Sàn TMĐT)"}},"seller_transaction_fee":{"type":"integer","description":"Seller transaction fee","x-description-i18n":{"vie":"Phí thanh toán (Sàn TMĐT)"}},"service_fee":{"type":"integer","description":"Service fee","x-description-i18n":{"vie":"Phí dịch vụ (Sàn TMĐT)"}},"sfp_service_fee":{"type":"integer","description":"SFP service fee","x-description-i18n":{"vie":"Phí dịch vụ SFP (Sàn TMĐT)"}}}},"printing_count":{"type":"integer","description":"Printing count","x-description-i18n":{"vie":"Số lần in"}},"money_to_collect":{"type":"integer","description":"Money to collect","x-description-i18n":{"vie":"Số tiền cần thu"}},"marketplace_id":{"type":"string","description":"Marketplace ID","enum":["-2","-3","-4","-9","-16","-17","-20","-25","-27","-28"],"x-enum-descriptions":{"-2":"Tiki","-3":"Shopee","-4":"Lazada","-9":"TikTok","-16":"WooCommerce","-17":"Shopify","-20":"Line Shopping","-25":"Tokopedia","-27":"Mercado Libre","-28":"Tiendanube"},"x-description-i18n":{"vie":"Mã sàn thương mại điện tử"}},"total_price":{"type":"integer","description":"Total price","x-description-i18n":{"vie":"Tổng giá trị sản phẩm"}},"shop_customer_address_id":{"type":"string","description":"Customer address ID","x-description-i18n":{"vie":"Mã địa chỉ khách hàng"}},"customer":{"type":"object","description":"Customer information","x-description-i18n":{"vie":"Thông tin khách hàng"},"properties":{"fb_id":{"type":"string","description":"Customer Facebook ID","x-description-i18n":{"vie":"Facebook ID khách hàng"}},"id":{"type":"string","description":"Customer ID","x-description-i18n":{"vie":"Mã khách hàng"}},"name":{"type":"string","description":"Customer name","x-description-i18n":{"vie":"Tên khách hàng"}},"page_id":{"type":"string","description":"Page ID","x-description-i18n":{"vie":"Mã trang"}}}},"total_quantity":{"type":"integer","description":"Total quantity","x-description-i18n":{"vie":"Tổng số lượng"}},"time_assign_marketer":{"type":"string","format":"date-time","description":"Time assign marketer","x-description-i18n":{"vie":"Thời điểm phân công marketer"}},"p_utm_source":{"type":"string","description":"UTM Source","x-description-i18n":{"vie":"UTM Source"}},"p_utm_medium":{"type":"string","description":"UTM Medium","x-description-i18n":{"vie":"UTM Medium"}},"p_utm_campaign":{"type":"string","description":"UTM Campaign","x-description-i18n":{"vie":"UTM Campaign"}},"p_utm_term":{"type":"string","description":"UTM Term","x-description-i18n":{"vie":"UTM Term"}},"p_utm_content":{"type":"string","description":"UTM Content","x-description-i18n":{"vie":"UTM Content"}},"p_utm_id":{"type":"string","description":"UTM ID","x-description-i18n":{"vie":"UTM ID"}},"utm_affiliate":{"type":"string","description":"Affiliate","x-description-i18n":{"vie":"Affiliate"}},"link":{"type":"string","description":"Link","x-description-i18n":{"vie":"Link"}},"status_history":{"type":"array","description":"Status update history","x-description-i18n":{"vie":"Lịch sử cập nhật trạng thái"},"items":{"type":"object","properties":{"avatar_url":{"type":"string","description":"Avatar URL","x-description-i18n":{"vie":"Link avatar"}},"editor":{"type":"object","description":"Editor information","x-description-i18n":{"vie":"Thông tin người chỉnh sửa"}},"editor_fb":{"type":"string","description":"Editor Facebook ID","x-description-i18n":{"vie":"Facebook ID người chỉnh sửa"}},"editor_id":{"type":"string","description":"Editor ID","x-description-i18n":{"vie":"Mã người chỉnh sửa"}},"name":{"type":"string","description":"Name","x-description-i18n":{"vie":"Tên"}},"old_status":{"type":"integer","description":"Old status","x-description-i18n":{"vie":"Trạng thái cũ"}},"status":{"type":"integer","description":"Status","x-description-i18n":{"vie":"Trạng thái"}},"updated_at":{"type":"string","format":"date-time","description":"Updated at","x-description-i18n":{"vie":"Thời điểm cập nhật"}}}}},"duplicated_phone":{"type":"boolean","description":"Duplicated phone","x-description-i18n":{"vie":"Số điện thoại trùng lặp"}},"order_currency":{"type":"string","description":"Order currency","x-description-i18n":{"vie":"Loại tiền tệ"}},"charged_by_vnpay":{"type":"integer","description":"Charged by VNPay","x-description-i18n":{"vie":"Số tiền thanh toán qua VNPay"}},"charged_by_qrpay":{"type":"integer","description":"Charged by QRPay","x-description-i18n":{"vie":"Số tiền khách thanh toán qua QRPAY"}},"custom_id":{"type":"string","description":"Custom ID","x-description-i18n":{"vie":"Mã tùy chỉnh"}},"last_editor":{"type":"object","description":"Last editor information","x-description-i18n":{"vie":"Thông tin người chỉnh sửa cuối cùng đơn hàng"},"properties":{"id":{"type":"string","description":"Editor ID","x-description-i18n":{"vie":"Mã người chỉnh sửa"}},"fb_id":{"type":"string","description":"Facebook ID of editor","x-description-i18n":{"vie":"Facebook ID người chỉnh sửa"}},"name":{"type":"string","description":"Editor name","x-description-i18n":{"vie":"Tên người chỉnh sửa"}},"email":{"type":"string","description":"Editor email","x-description-i18n":{"vie":"Email người chỉnh sửa"}},"avatar_url":{"type":"string","description":"Editor avatar URL","x-description-i18n":{"vie":"Link avatar người chỉnh sửa"}},"phone_number":{"type":"string","description":"Editor phone number","x-description-i18n":{"vie":"Số điện thoại người chỉnh sửa"}}}},"last_editor_id":{"type":"string","description":"Last editor ID","x-description-i18n":{"vie":"Mã người sửa cuối"}},"charged_by_momo":{"type":"integer","description":"Charged by MoMo","x-description-i18n":{"vie":"Số tiền khách thanh toán qua MOMO"}},"prepaid_by_point":{"type":"object","description":"Prepaid by point","x-description-i18n":{"vie":"Thanh toán bằng điểm thưởng"},"properties":{"money":{"type":"integer","description":"Money amount","x-description-i18n":{"vie":"Số tiền"},"example":15000},"point":{"type":"integer","description":"Point amount","x-description-i18n":{"vie":"Số điểm"},"example":15}},"example":{"money":15000,"point":15}},"bank_transfer_images":{"type":"array","description":"Bank transfer images","x-description-i18n":{"vie":"Hình ảnh chuyển khoản"},"items":{"type":"string","format":"uri"}},"transfer_money":{"type":"integer","description":"Transfer money","x-description-i18n":{"vie":"Số tiền khách chuyển khoản"}},"lock_order_by_user":{"type":"string","description":"Lock order by user ID","x-description-i18n":{"vie":"Mã người dùng khóa đơn hàng"}},"assigning_care":{"type":"object","description":"Assigning care information","x-description-i18n":{"vie":"Nhân viên chăm sóc"},"properties":{"id":{"type":"string","description":"Care ID","x-description-i18n":{"vie":"Mã người chăm sóc"}},"fb_id":{"type":"string","description":"Facebook ID of care","x-description-i18n":{"vie":"Facebook ID người chăm sóc"}},"name":{"type":"string","description":"Care name","x-description-i18n":{"vie":"Tên người chăm sóc"}},"email":{"type":"string","description":"Care email","x-description-i18n":{"vie":"Email người chăm sóc"}},"avatar_url":{"type":"string","description":"Care avatar URL","x-description-i18n":{"vie":"Link avatar người chăm sóc"}},"phone_number":{"type":"string","description":"Care phone number","x-description-i18n":{"vie":"Số điện thoại người chăm sóc"}}}},"assigning_care_id":{"type":"string","description":"Assigning care ID","x-description-i18n":{"vie":"Mã nhân viên chăm sóc"}},"time_assign_care":{"type":"string","format":"date-time","description":"Time assign care","x-description-i18n":{"vie":"Thời điểm phân công chăm sóc"}},"assigning_seller":{"type":"object","description":"Assigning seller information","x-description-i18n":{"vie":"Nhân viên được phân công"},"properties":{"id":{"type":"string","description":"Seller ID","x-description-i18n":{"vie":"Mã người bán"}},"fb_id":{"type":"string","description":"Facebook ID of seller","x-description-i18n":{"vie":"Facebook ID người bán"}},"name":{"type":"string","description":"Seller name","x-description-i18n":{"vie":"Tên người bán"}},"email":{"type":"string","description":"Seller email","x-description-i18n":{"vie":"Email người bán"}},"avatar_url":{"type":"string","description":"Seller avatar URL","x-description-i18n":{"vie":"Link avatar người bán"}},"phone_number":{"type":"string","description":"Seller phone number","x-description-i18n":{"vie":"Số điện thoại người bán"}}}},"einvoices":{"type":"array","items":{"$ref":"#/components/schemas/EInvoice"}},"charged_by_card":{"type":"integer","description":"Charged by card","x-description-i18n":{"vie":"Số tiền khách quẹt thẻ"}},"estimate_delivery_date":{"type":"string","format":"date-time","description":"Estimate delivery date","x-description-i18n":{"vie":"Ngày giao hàng dự kiến"}},"order_sources":{"type":"string","description":"Order sources ID","x-description-i18n":{"vie":"Mã nguồn đơn hàng"}},"charged_by_fundiin":{"type":"integer","description":"Charged by Fundiin","x-description-i18n":{"vie":"Số tiền thanh toán qua Fundiin"}},"surcharge":{"type":"integer","description":"Surcharge","x-description-i18n":{"vie":"Phụ thu"}},"is_linked_partner":{"type":"boolean","description":"Is linked partner","x-description-i18n":{"vie":"Đã liên kết đối tác"}},"call_laters":{"type":"array","description":"Call laters","x-description-i18n":{"vie":"Gọi lại sau"},"items":{"type":"object"}},"last_update_status_at":{"type":"string","format":"date-time","description":"Last update status at","x-description-i18n":{"vie":"Thời điểm cập nhật trạng thái cuối"}},"discount_by_customer_level":{"type":"integer","description":"Discount by customer level","x-description-i18n":{"vie":"Giảm giá theo cấp độ khách hàng"}},"viewing":{"type":"array","description":"Viewing","x-description-i18n":{"vie":"NV đang xem"},"items":{"type":"object"}},"additional_info":{"type":"object","description":"Additional info","x-description-i18n":{"vie":"Thông tin bổ sung"},"properties":{"service_partner":{"type":"string","description":"Service partner","x-description-i18n":{"vie":"Dịch vụ vận chuyển"},"enum":["instant"],"x-enum-descriptions":["Instant"],"x-enum-descriptions-i18n":{"vie":["Hỏa tốc"]}},"delivery_deadline":{"type":"string","format":"date-time","description":"Delivery deadline (ISO8601, no timezone). Send null to clear.","x-description-i18n":{"vie":"Hạn giao hàng (ISO8601, không kèm timezone). Gửi null để xóa."},"example":"2026-06-03T10:00:00"}}},"order_returned_ids":{"type":"string","description":"Order returned IDs","x-description-i18n":{"vie":"Mã đơn hàng đổi trả"}},"cost_surcharge":{"type":"integer","description":"Cost surcharge","x-description-i18n":{"vie":"Phụ phí"}},"time_send_partner":{"type":"string","format":"date-time","description":"Time send partner","x-description-i18n":{"vie":"Thời điểm gửi đơn vị vận chuyển"}},"charged_by_kredivo":{"type":"integer","description":"Charged by Kredivo","x-description-i18n":{"vie":"Số tiền thanh toán qua Kredivo"}},"discount":{"type":"integer","description":"Discount","x-description-i18n":{"vie":"Giảm giá"}},"histories":{"type":"array","description":"Histories","x-description-i18n":{"vie":"Lịch sử"},"items":{"type":"object"}},"duplicated_customer":{"type":"boolean","description":"Duplicated customer","x-description-i18n":{"vie":"Khách hàng trùng lặp"}},"customer_referral_code":{"type":"object","description":"Customer referral code","x-description-i18n":{"vie":"Mã giới thiệu khách hàng"},"properties":{"active":{"type":"string","description":"Active status","x-description-i18n":{"vie":"Trạng thái kích hoạt"},"example":"true"},"customer_id":{"type":"string","format":"uuid","description":"Customer ID","x-description-i18n":{"vie":"Mã khách hàng"},"example":"09bb9399-45f3-4897-a53a-85dde2f886fe"},"discount":{"type":"string","description":"Discount value","x-description-i18n":{"vie":"Giá trị giảm giá"},"example":"10"},"format":{"type":"string","description":"Referral code format","x-description-i18n":{"vie":"Định dạng mã giới thiệu"},"example":"{PHONE_NUMBER}"},"free_products_priced_between_approx":{"type":"object","description":"Free products priced between approximately","x-description-i18n":{"vie":"Miễn phí cho khách mới sản phẩm có giá"},"properties":{"active":{"type":"string","description":"Active status","x-description-i18n":{"vie":"Trạng thái kích hoạt"},"example":"true"},"operator":{"type":"string","description":"Comparison operator","x-description-i18n":{"vie":"Toán tử so sánh"},"example":"GreaterOrEqual"},"price":{"type":"string","description":"Price threshold","x-description-i18n":{"vie":"Ngưỡng giá"},"example":"150000"}}},"is_percent":{"type":"string","description":"Discount is percentage","x-description-i18n":{"vie":"Giảm giá theo phần trăm"},"example":"true"},"only_customers_with_level_will_have_referral_code":{"type":"string","description":"Only customers with level will have referral code","x-description-i18n":{"vie":"Chỉ khách hàng có cấp độ mới có mã giới thiệu"},"example":"true"},"referral_code":{"type":"string","description":"Referral code","x-description-i18n":{"vie":"Mã giới thiệu"},"example":"982843759"},"reward_points_for_old_customers":{"type":"object","description":"Reward points for customers","x-description-i18n":{"vie":"Điểm thưởng khách hàng"},"properties":{"active":{"type":"string","description":"Active status","x-description-i18n":{"vie":"Trạng thái kích hoạt"},"example":"true"},"money":{"type":"string","description":"Money reward","x-description-i18n":{"vie":"Tiền thưởng"},"example":"10000"},"point":{"type":"string","description":"Point reward","x-description-i18n":{"vie":"Điểm thưởng"},"example":"1"}}},"shop_customer_id":{"type":"string","format":"uuid","description":"Shop customer ID","x-description-i18n":{"vie":"Mã khách hàng shop"},"example":"f8160a4c-dfa7-4ee8-b540-d245755ea1f1"}},"example":{"active":"true","customer_id":"09bb9399-45f3-4897-a53a-85dde2f886fe","discount":"10","format":"{PHONE_NUMBER}","free_products_priced_between_approx":{"active":"true","operator":"GreaterOrEqual","price":"150000"},"is_percent":"true","only_customers_with_level_will_have_referral_code":"true","referral_code":"982843759","reward_points_for_old_customers":{"active":"true","money":"10000","point":"1"},"shop_customer_id":"f8160a4c-dfa7-4ee8-b540-d245755ea1f1"}},"tax":{"type":"integer","description":"Tax","x-description-i18n":{"vie":"Thuế"}},"is_from_ecommerce":{"type":"boolean","description":"Is from e-commerce","x-description-i18n":{"vie":"Đơn hàng từ sàn thương mại điện tử"}},"note_image":{"type":"array","description":"Note images","x-description-i18n":{"vie":"Link hình ảnh ghi chú"},"items":{"type":"string","format":"uri"}},"shopify_draft_order_id":{"type":"string","description":"Shopify draft order ID","x-description-i18n":{"vie":"Mã đơn hàng nháp Shopify"}},"display_id":{"type":"integer","description":"Display ID","x-description-i18n":{"vie":"Mã hiển thị"}},"shop_partner_id":{"type":"integer","description":"Shop partner ID","x-description-i18n":{"vie":"Mã đối tác shop"}},"is_locked":{"type":"boolean","description":"Order lock","x-description-i18n":{"vie":"Khóa đơn hàng"}},"merge_order":{"type":"boolean","description":"Allows merging orders","x-description-i18n":{"vie":"Cho phép gộp đơn"}}}},"example":{"is_abandoned_order":true,"bill_full_name":"Hoang Anh","bill_phone_number":"0999999999","is_free_shipping":false,"received_at_shop":false,"page_id":"256469571178082","account":4,"account_name":"facebook321","assigning_seller_id":"340644fc-314d-450e-a45f-33343678cab6","items":[{"discount_each_product":0,"is_bonus_product":false,"is_discount_percent":false,"is_wholesale":false,"one_time_product":false,"quantity":1,"variation_id":"415040f4-ab63-465e-8699-e9ebfff4c6c7","product_id":"3487e126-b0d9-4dae-89a9-ee60bef2f4e9","variation_info":{"detail":null,"fields":null,"display_id":null,"name":"aaaaaa","product_display_id":null,"is_upsale_product":true,"retail_price":100000,"weight":100}}],"note":"","note_print":null,"returned_reason":1,"warehouse_id":"630744ef-4614-4a70-988c-52e6d78c953c","shipping_address":{"address":"aaaaa","commune_id":"2210941","country_code":null,"district_id":"22109","full_address":"aaaaa, Xã Bắc Lý, Huyện Hiệp Hòa, Bắc Giang","full_name":"hoang anh","phone_number":"0999999999","post_code":null,"province_id":"221"},"shipping_fee":0,"shop_id":4,"total_discount":0,"warehouse_info":{"district_id":"10111","full_address":"kakakaka, Phường Khương Trung, Quận Thanh Xuân, Hà Nội","name":"snappy","phone_number":"0999999999","province_id":"101"},"custom_id":"Ma0001","activated_promotion_advances":[{"promotion_advance_id":"fb056b32-9cf6-4c5a-92de-0eb94db71121","is_activated":true}],"status":0,"cash":0}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"integer","description":"Order ID","x-description-i18n":{"vie":"Mã đơn hàng"}},"system_id":{"type":"integer","description":"System ID","x-description-i18n":{"vie":"Mã hệ thống"}},"shop_id":{"type":"integer","description":"Shop ID","x-description-i18n":{"vie":"Mã cửa hàng"}},"inserted_at":{"type":"string","format":"date-time","description":"Order creation time","x-description-i18n":{"vie":"Thời điểm tạo đơn"}},"updated_at":{"type":"string","format":"date-time","description":"Order update time","x-description-i18n":{"vie":"Thời điểm cập nhật đơn"}},"status":{"type":"integer","description":"Order status","x-description-i18n":{"vie":"Trạng thái đơn hàng"},"enum":[0,17,11,12,13,20,1,8,9,2,3,16,4,15,5,6,7],"x-enum-descriptions":["New","Waiting for confirmation","Restocking","Wait for printing","Printed","Purchased","Confirmed","Packaging","Waiting for pick up","Shipped","Received","Collected money","Returning","Partial return","Returned","Canceled","Deleted recently"],"x-enum-descriptions-i18n":{"vie":["Mới","Chờ xác nhận","Chờ hàng","Chờ in","Đã in","Đã đặt hàng","Đã xác nhận","Đang đóng hàng","Chờ chuyển hàng","Đã gửi hàng","Đã nhận","Đã thu tiền","Đang hoàn","Hoàn một phần","Đã hoàn","Đã hủy","Đã xóa"]}},"status_name":{"type":"string","description":"Order status name","x-description-i18n":{"vie":"Tên trạng thái đơn hàng"}},"bill_full_name":{"type":"string","description":"Customer name","x-description-i18n":{"vie":"Tên khách hàng"}},"bill_phone_number":{"type":"string","description":"Phone number of customer","x-description-i18n":{"vie":"SĐT khách hàng"}},"bill_email":{"type":"string","description":"Customer email","x-description-i18n":{"vie":"Email khách hàng"}},"conversation_id":{"type":"string","description":"Conversation ID","x-description-i18n":{"vie":"Mã hội thoại"}},"page_id":{"type":"string","description":"Facebook page ID","x-description-i18n":{"vie":"Mã Facebook page"}},"post_id":{"type":"string","description":"Post ID","x-description-i18n":{"vie":"Mã bài viết"}},"ad_id":{"type":"string","description":"Ad ID","x-description-i18n":{"vie":"Mã quảng cáo"}},"shipping_fee":{"type":"integer","description":"Shipping fee","x-description-i18n":{"vie":"Phí vận chuyển"}},"partner_fee":{"type":"integer","description":"Fee from shipping partner","x-description-i18n":{"vie":"Phí vận chuyển từ ĐVVC"}},"fee_marketplace":{"type":"integer","description":"Fees from e-commerce platforms","x-description-i18n":{"vie":"Phí sàn"}},"customer_pay_fee":{"type":"boolean","description":"Customer pay shipping fee","x-description-i18n":{"vie":"Khách trả phí ship"}},"is_free_shipping":{"type":"boolean","description":"Free shipping","x-description-i18n":{"vie":"Miễn phí vận chuyển"}},"is_livestream":{"type":"boolean","description":"Is livestream order","x-description-i18n":{"vie":"Đơn hàng từ livestream"}},"is_live_shopping":{"type":"boolean","description":"Is live shopping order","x-description-i18n":{"vie":"Đơn hàng từ live shopping"}},"is_smc":{"type":"boolean","description":"Shopping on Messenger","x-description-i18n":{"vie":"Đơn hàng từ mua sắm trên Messenger"}},"received_at_shop":{"type":"boolean","description":"true: Sales at counter, false: Sell online","x-description-i18n":{"vie":"true: Bán tại quầy, false: Bán online"}},"total_discount":{"type":"integer","description":"Discount total","x-description-i18n":{"vie":"Tổng tiền giảm giá"}},"note":{"type":"string","description":"Internal note","x-description-i18n":{"vie":"Ghi chú nội bộ"}},"note_print":{"type":"string","description":"Note for printing","x-description-i18n":{"vie":"Ghi chú đơn hàng"}},"returned_reason":{"type":"integer","description":"Return reason code (1: Customer, 2: Staff, 3: Defective product, 4: Shipping carrier, 5: Exchange). Other values are shop-defined custom reasons, see returned_reason_name for the display name","x-description-i18n":{"vie":"Mã lý do hoàn hàng (1: Do khách hàng, 2: Do nhân viên, 3: Do sản phẩm lỗi, 4: Do đơn vị vận chuyển, 5: Do đổi hàng). Mã khác là lý do tùy chỉnh theo từng shop, xem tên hiển thị tại returned_reason_name"}},"returned_reason_name":{"type":"string","description":"Return reason name","x-description-i18n":{"vie":"Tên lý do hoàn hàng"}},"sub_status":{"type":"integer","description":"Reason for delivery delay","x-description-i18n":{"vie":"Lý do delay giao hàng"}},"warehouse_id":{"type":"string","description":"Warehouse ID","x-description-i18n":{"vie":"Mã kho hàng"}},"warehouse_info":{"type":"object","description":"Warehouse information","x-description-i18n":{"vie":"Thông tin kho hàng"},"properties":{"name":{"type":"string","description":"Warehouse name","x-description-i18n":{"vie":"Tên kho hàng"}},"phone_number":{"type":"string","description":"Warehouse phone number","x-description-i18n":{"vie":"Số điện thoại kho hàng"}},"full_address":{"type":"string","description":"Warehouse full address","x-description-i18n":{"vie":"Địa chỉ đầy đủ kho hàng"}},"address":{"type":"string","description":"Warehouse address","x-description-i18n":{"vie":"Địa chỉ chi tiết kho hàng"}},"province_id":{"type":"string","description":"Province ID","x-description-i18n":{"vie":"Mã tỉnh thành phố"}},"district_id":{"type":"string","description":"District ID","x-description-i18n":{"vie":"Mã quận huyện"}},"commune_id":{"type":"string","description":"Commune ID","x-description-i18n":{"vie":"Mã phường xã"}},"affiliate_id":{"type":"string","description":"Affiliate ID","x-description-i18n":{"vie":"Mã đại lý"}},"ffm_id":{"type":"string","description":"FFM ID","x-description-i18n":{"vie":"Mã FFM"}},"has_snappy_service":{"type":"boolean","description":"Has Snappy service","x-description-i18n":{"vie":"Có dịch vụ Snappy"}},"custom_id":{"type":"string","description":"Custom ID","x-description-i18n":{"vie":"Mã tùy chỉnh"}}}},"creator_id":{"type":"string","description":"Creator ID","x-description-i18n":{"vie":"Mã người tạo"}},"creator":{"type":"object","description":"Order creator","x-description-i18n":{"vie":"Thông tin người tạo đơn"},"properties":{"id":{"type":"string","description":"Creator ID","x-description-i18n":{"vie":"Mã người tạo"}},"fb_id":{"type":"string","description":"Facebook ID of creator","x-description-i18n":{"vie":"ID facebook người tạo đơn"}},"name":{"type":"string","description":"Creator name","x-description-i18n":{"vie":"Tên người tạo đơn"}},"avatar_url":{"type":"string","description":"Creator avatar URL","x-description-i18n":{"vie":"Link avatar người tạo"}}}},"items":{"type":"array","description":"Product list. When creating or updating an order, each entry must include `variation_id` and `quantity`. `variation_info` is optional — if omitted, the backend treats it as an empty object; send it (with `retail_price`) when you need the line price to be explicit.","x-description-i18n":{"vie":"Danh sách sản phẩm. Khi tạo hoặc cập nhật đơn, mỗi phần tử cần có `variation_id` và `quantity`. `variation_info` không bắt buộc — nếu thiếu, backend coi như object rỗng; nên gửi kèm (cùng `retail_price`) khi muốn giá dòng hàng tường minh."},"items":{"type":"object","required":["variation_id","quantity"],"properties":{"product_id":{"type":"string","description":"Product ID","x-description-i18n":{"vie":"Mã sản phẩm"}},"quantity":{"type":"integer","description":"Quantity","x-description-i18n":{"vie":"Số lượng"}},"returned_count":{"type":"integer","description":"Returned count","x-description-i18n":{"vie":"Số lượng đã trả"}},"assigning_seller_id":{"type":"string","description":"Assigning seller ID","x-description-i18n":{"vie":"Mã nhân viên được phân công"}},"quantity_by_combo_products":{"type":"array","description":"Quantity by combo products","x-description-i18n":{"vie":"Số lượng theo combo sản phẩm"},"items":{"type":"object"}},"discount_each_product":{"type":"integer","description":"Discount for each product","x-description-i18n":{"vie":"Giảm giá cho từng sản phẩm"}},"is_bonus_product":{"type":"boolean","description":"Is bonus product","x-description-i18n":{"vie":"Sản phẩm tặng kèm"}},"is_discount_percent":{"type":"boolean","description":"Is discount by percent","x-description-i18n":{"vie":"Giảm giá theo phần trăm"}},"is_wholesale":{"type":"boolean","description":"Is wholesale","x-description-i18n":{"vie":"Bán sỉ"}},"is_composite":{"type":"boolean","description":"Is composite product","x-description-i18n":{"vie":"Sản phẩm composite"}},"one_time_product":{"type":"boolean","description":"One time product","x-description-i18n":{"vie":"Sản phẩm một lần"}},"note":{"type":"string","description":"Product note","x-description-i18n":{"vie":"Ghi chú sản phẩm"}},"note_product":{"type":"string","description":"Product note","x-description-i18n":{"vie":"Ghi chú sản phẩm"}},"inserted_at":{"type":"string","format":"date-time","description":"Inserted at","x-description-i18n":{"vie":"Thời điểm tạo"}},"measure_group_id":{"type":"integer","description":"Measure group ID","x-description-i18n":{"vie":"Mã nhóm đơn vị tính"}},"variation_info":{"type":"object","description":"Variation information. Optional when creating/updating an order (the backend defaults it to an empty object if omitted). Its inner fields are not individually required, but sending `retail_price` is recommended so the line price is correct.","x-description-i18n":{"vie":"Thông tin biến thể. Không bắt buộc khi tạo/cập nhật đơn (backend tự coi là object rỗng nếu thiếu). Các field bên trong không bắt buộc riêng lẻ, nhưng nên gửi `retail_price` để giá dòng hàng đúng."},"properties":{"id":{"type":"string","description":"Variation ID","x-description-i18n":{"vie":"Mã biến thể"}},"name":{"type":"string","description":"Product name","x-description-i18n":{"vie":"Tên sản phẩm"}},"product_id":{"type":"string","description":"Product ID","x-description-i18n":{"vie":"Mã sản phẩm"}},"retail_price":{"type":"integer","description":"Retail price. Not strictly required, but recommended when creating/updating an order so the line price is correct.","x-description-i18n":{"vie":"Giá bán lẻ. Không bắt buộc, nhưng nên gửi khi tạo/cập nhật đơn để giá dòng hàng chính xác."}},"detail":{"type":"string","description":"Variation detail","x-description-i18n":{"vie":"Chi tiết biến thể"}},"images":{"type":"array","description":"Variation images","x-description-i18n":{"vie":"Hình ảnh biến thể"},"items":{"type":"string","format":"uri"}},"fields":{"type":"array","description":"Variation fields","x-description-i18n":{"vie":"Thuộc tính biến thể"},"items":{"type":"object","properties":{"id":{"type":"string","description":"Field ID","x-description-i18n":{"vie":"Mã thuộc tính"}},"name":{"type":"string","description":"Field name","x-description-i18n":{"vie":"Tên thuộc tính"}},"value":{"type":"string","description":"Field value","x-description-i18n":{"vie":"Giá trị thuộc tính"}},"keyValue":{"type":"string","description":"Key value","x-description-i18n":{"vie":"Giá trị khóa"}}}}},"barcode":{"type":"string","description":"Barcode","x-description-i18n":{"vie":"Mã barcode"}},"brand_id":{"type":"string","description":"Brand ID","x-description-i18n":{"vie":"Mã thương hiệu"}},"category_ids":{"type":"array","description":"Category IDs","x-description-i18n":{"vie":"Danh sách mã danh mục"},"items":{"type":"integer"}},"display_id":{"type":"string","description":"Display ID","x-description-i18n":{"vie":"Mã hiển thị"}},"product_display_id":{"type":"string","description":"Product display ID","x-description-i18n":{"vie":"Mã hiển thị sản phẩm"}},"last_imported_price":{"type":"integer","description":"Last imported price","x-description-i18n":{"vie":"Giá nhập hàng cuối"}},"is_upsale_product":{"type":"boolean","description":"Upsale product","x-description-i18n":{"vie":"Sản phẩm upsale"}},"weight":{"type":"integer","description":"Weight","x-description-i18n":{"vie":"Khối lượng"}},"measure_info":{"type":"object","description":"Measure information","x-description-i18n":{"vie":"Thông tin đơn vị tính"},"properties":{"measure_id":{"type":"integer","description":"Measure ID","x-description-i18n":{"vie":"Mã đơn vị tính"}},"exchange_value":{"type":"integer","description":"Exchange value","x-description-i18n":{"vie":"Giá trị quy đổi"}}}},"avg_price":{"type":"integer","description":"Average import price","x-description-i18n":{"vie":"Giá nhập trung bình"}}}},"components":{"type":"array","description":"Product components","x-description-i18n":{"vie":"Thành phần sản phẩm"},"items":{"type":"object","properties":{"component_id":{"type":"string","description":"Component ID","x-description-i18n":{"vie":"Mã thành phần"}},"quantity":{"type":"integer","description":"Quantity","x-description-i18n":{"vie":"Số lượng"}},"variation_id":{"type":"string","description":"Variation ID","x-description-i18n":{"vie":"Mã biến thể"}},"variation_info":{"type":"object","description":"Variation information","x-description-i18n":{"vie":"Thông tin biến thể"}}}}},"id":{"type":"integer","description":"Item ID","x-description-i18n":{"vie":"Mã sản phẩm trong đơn"}},"variation_id":{"type":"string","description":"Variation ID","x-description-i18n":{"vie":"Mã biến thể"}}}}},"partner":{"type":"object","description":"Partner information","x-description-i18n":{"vie":"Thông tin đơn vị vận chuyển"},"properties":{"partner_id":{"type":"integer","description":"Partner ID","x-description-i18n":{"vie":"ID đơn vị vận chuyển trên hệ thống Pancake"}},"cod":{"type":"integer","description":"Reconciliation COD","x-description-i18n":{"vie":"Đối soát tiền thu hộ"}},"extend_code":{"type":"string","description":"Shipping order ID on partner system","x-description-i18n":{"vie":"Mã vận đơn"}},"total_fee":{"type":"integer","description":"Total fee","x-description-i18n":{"vie":"Tổng phí"}},"updated_at":{"type":"string","format":"date-time","description":"Updated at","x-description-i18n":{"vie":"Thời điểm cập nhật"}},"delivery_name":{"type":"string","description":"Shipper name","x-description-i18n":{"vie":"Tên người giao hàng"}},"delivery_tel":{"type":"string","description":"Delivery phone","x-description-i18n":{"vie":"Số điện thoại người giao hàng"}},"picked_up_at":{"type":"string","format":"date-time","description":"Picked up at","x-description-i18n":{"vie":"Thời điểm lấy hàng"}},"sort_code":{"type":"string","description":"Sort code","x-description-i18n":{"vie":"Mã phân loại"}},"paid_at":{"type":"string","format":"date-time","description":"Paid at","x-description-i18n":{"vie":"Thời điểm thanh toán"}},"system_created":{"type":"boolean","description":"System created","x-description-i18n":{"vie":"Được tạo bởi hệ thống"}},"extend_update":{"type":"array","description":"Update from courier","x-description-i18n":{"vie":"Cập nhật từ đơn vị vận chuyển"},"items":{"type":"object","properties":{"key":{"type":"string","description":"Update key","x-description-i18n":{"vie":"Mã cập nhật"}},"status":{"type":"string","description":"Status","x-description-i18n":{"vie":"Trạng thái"}},"tracking_id":{"type":"string","description":"Partner extend code","x-description-i18n":{"vie":"Mã đơn hàng đối tác"}},"note":{"type":"string","description":"Courier notes","x-description-i18n":{"vie":"Ghi chú từ đơn vị vận chuyển"}},"update_at":{"type":"string","format":"date-time","description":"Updated at","x-description-i18n":{"vie":"Thời điểm cập nhật"}}}}},"partner_status":{"type":"string","nullable":true,"description":"Partner shipping status","x-description-i18n":{"vie":"Trạng thái vận chuyển"},"enum":["waiting","request_received","processing_picked_up","picking_up","delay_pickup","picked_up","waiting_on_the_way","on_the_way","contact_delivery_company","out_for_delivery","delay_delivery","inform_recipient","undeliverable","waiting_for_return","delivered","delivered_cod","returning","returned","returned_cod","canceled"],"x-enum-descriptions":["Waiting for processing","Carrier received the request","Processing pickup","Picking up","Delayed pickup","Picked up","Waiting for transit","In transit","Contact the carrier","Out for delivery","Delayed delivery","Notify the recipient","Undeliverable","Waiting for return","Delivered","Delivered, COD reconciled","Returning","Returned","Returned, COD reconciled","Canceled"],"x-enum-descriptions-i18n":{"vie":["Chờ xử lý","ĐVVC đã tiếp nhận đơn","Đang xử lý lấy hàng","Đang lấy hàng","Trễ lấy hàng","Đã lấy hàng","Chờ trung chuyển","Đang trung chuyển","Liên hệ ĐVVC","Đang giao hàng","Trễ giao hàng","Thông báo cho người nhận","Giao không thành","Chờ chuyển hoàn","Đã giao hàng","Đã giao hàng, đã đối soát COD","Đang chuyển hoàn","Đã chuyển hoàn","Đã chuyển hoàn, đã đối soát COD","Đã hủy vận đơn"]}},"partner_name":{"type":"string","nullable":true,"description":"Partner name","x-description-i18n":{"vie":"Tên đơn vị vận chuyển"}},"first_delivery_at":{"type":"string","format":"date-time","nullable":true,"description":"First delivery time","x-description-i18n":{"vie":"Thời điểm giao hàng lần đầu"}},"first_undeliverable_at":{"type":"string","format":"date-time","nullable":true,"description":"First failed delivery time","x-description-i18n":{"vie":"Thời điểm giao hàng thất bại lần đầu"}},"order_number_vtp":{"type":"string","nullable":true,"description":"Viettel Post tracking number","x-description-i18n":{"vie":"Mã vận đơn Viettel Post"}},"printed_form":{"type":"object","nullable":true,"description":"Printed form","x-description-i18n":{"vie":"Mẫu in"}}}},"shipping_address":{"$ref":"#/components/schemas/ShippingAddress"},"payment_purchase_histories":{"type":"array","description":"Payment histories","x-description-i18n":{"vie":"Lịch sử thanh toán"},"items":{"type":"object","properties":{"amount":{"type":"integer","description":"Amount of money","x-description-i18n":{"vie":"Số tiền"}},"type":{"type":"string","description":"Payment type","x-description-i18n":{"vie":"Loại thanh toán"}},"inserted_at":{"type":"string","format":"date-time","description":"Transaction time","x-description-i18n":{"vie":"Thời điểm giao dịch"}},"result_code":{"type":"string","description":"Result code","x-description-i18n":{"vie":"Mã kết quả"}},"ipn_reply":{"type":"boolean","description":"IPN reply","x-description-i18n":{"vie":"Phản hồi IPN"}},"voucher_amount":{"type":"integer","description":"Voucher amount","x-description-i18n":{"vie":"Số tiền voucher"}},"tags":{"type":"array","description":"Tags","x-description-i18n":{"vie":"Thẻ"},"items":{"type":"string"}}}}},"tags":{"type":"array","description":"Tags list","x-description-i18n":{"vie":"Danh sách thẻ đơn hàng"},"items":{"type":"object","properties":{"id":{"type":"integer","description":"Tag ID","x-description-i18n":{"vie":"Mã thẻ đơn hàng"}},"name":{"type":"string","description":"Tag name","x-description-i18n":{"vie":"Tên thẻ đơn hàng"}}}}},"marketer":{"type":"object","description":"Marketer information","x-description-i18n":{"vie":"Thông tin marketer"},"properties":{"id":{"type":"string","description":"Marketer ID","x-description-i18n":{"vie":"Mã marketer"}},"name":{"type":"string","description":"Marketer name","x-description-i18n":{"vie":"Tên marketer"}},"email":{"type":"string","description":"Marketer email","x-description-i18n":{"vie":"Email marketer"}},"phone_number":{"type":"string","description":"Marketer phone number","x-description-i18n":{"vie":"Số điện thoại marketer"}},"fb_id":{"type":"string","description":"Marketer Facebook ID","x-description-i18n":{"vie":"Facebook ID marketer"}},"avatar_url":{"type":"string","description":"Marketer avatar URL","x-description-i18n":{"vie":"Link avatar marketer"}}}},"pke_mkter":{"type":"string","description":"Marketer ID","x-description-i18n":{"vie":"Mã nhân viên marketer"}},"activated_combo_products":{"type":"object","description":"Activated combo products information","x-description-i18n":{"vie":"Thông tin combo sản phẩm được kích hoạt"},"properties":{"combo_product_id":{"type":"integer","description":"Combo product ID","x-description-i18n":{"vie":"Mã combo sản phẩm"}},"quantity_combo_activated":{"type":"integer","description":"Quantity combo activated","x-description-i18n":{"vie":"Số lượng combo được kích hoạt"}},"combo_product_info":{"type":"object","description":"Combo product information","x-description-i18n":{"vie":"Thông tin combo sản phẩm"}}}},"activated_promotion_advances":{"type":"array","description":"Activated promotion advances information","x-description-i18n":{"vie":"Thông tin khuyến mãi được kích hoạt"},"items":{"type":"object","properties":{"id":{"type":"integer","description":"ID","x-description-i18n":{"vie":"Mã"}},"promotion_advance_id":{"type":"string","description":"Promotion advance ID","x-description-i18n":{"vie":"Mã khuyến mãi"}},"promotion_advance_info":{"type":"object","description":"Promotion advance information","x-description-i18n":{"vie":"Thông tin khuyến mãi"}}}}},"invoice_info_list":{"type":"array","description":"Invoice information list","x-description-i18n":{"vie":"Danh sách thông tin hóa đơn"},"items":{"type":"object","properties":{"error":{"type":"string","description":"Error message if any","x-description-i18n":{"vie":"Thông báo lỗi nếu có"}},"invoice_detail":{"type":"object","description":"Invoice detail information","x-description-i18n":{"vie":"Chi tiết thông tin hóa đơn"},"properties":{"company_address":{"type":"string","description":"Company address","x-description-i18n":{"vie":"Địa chỉ công ty"}},"company_address_breakdown":{"type":"object","description":"Company address breakdown","x-description-i18n":{"vie":"Chi tiết địa chỉ công ty"},"properties":{"company_additional_info":{"type":"string","description":"Company additional information","x-description-i18n":{"vie":"Thông tin bổ sung công ty"}},"company_barangay":{"type":"string","description":"Company barangay","x-description-i18n":{"vie":"Phường/xã công ty"}},"company_city":{"type":"string","description":"Company city","x-description-i18n":{"vie":"Thành phố công ty"}},"company_detailed_address":{"type":"string","description":"Company detailed address","x-description-i18n":{"vie":"Địa chỉ chi tiết công ty"}},"company_district":{"type":"string","description":"Company district","x-description-i18n":{"vie":"Quận/huyện công ty"}},"company_full_address":{"type":"string","description":"Company full address","x-description-i18n":{"vie":"Địa chỉ đầy đủ công ty"}},"company_postcode":{"type":"string","description":"Company postcode","x-description-i18n":{"vie":"Mã bưu điện công ty"}},"company_province":{"type":"string","description":"Company province","x-description-i18n":{"vie":"Tỉnh công ty"}},"company_region":{"type":"string","description":"Company region","x-description-i18n":{"vie":"Vùng/khu vực công ty"}},"company_state":{"type":"string","description":"Company state","x-description-i18n":{"vie":"Bang/tỉnh công ty"}},"company_town":{"type":"string","description":"Company town","x-description-i18n":{"vie":"Thị trấn/phường công ty"}}}},"company_email":{"type":"string","description":"Company email","x-description-i18n":{"vie":"Email công ty"}},"company_name":{"type":"string","description":"Company name","x-description-i18n":{"vie":"Tên công ty"}},"company_tax_id":{"type":"string","description":"Company tax ID","x-description-i18n":{"vie":"Mã số thuế công ty"}}}},"invoice_type":{"type":"string","description":"Invoice type","x-description-i18n":{"vie":"Loại hóa đơn"}},"is_requested":{"type":"boolean","description":"Request for invoice","x-description-i18n":{"vie":"Yêu cầu xuất hóa đơn"}},"order_sn":{"type":"string","description":"Order code on the marketplace","x-description-i18n":{"vie":"Mã đơn hàng trên sàn"}}}}},"reports_by_phone":{"type":"object","description":"Reports by phone number","x-description-i18n":{"vie":"Báo cáo theo số điện thoại"},"properties":{"order_fail":{"type":"integer","description":"Number of failed orders","x-description-i18n":{"vie":"Số đơn thất bại"}},"order_success":{"type":"integer","description":"Number of successful orders","x-description-i18n":{"vie":"Số đơn thành công"}},"warning":{"type":"integer","description":"Number of warnings orders","x-description-i18n":{"vie":"Số đơn cảnh báo"}}},"example":{"+639175706297":{"order_fail":29,"order_success":20,"warning":0}}},"tracking_link":{"type":"string","description":"Link confirm order","x-description-i18n":{"vie":"Link xác nhận đơn hàng"}},"ads_source":{"type":"string","description":"Advertising source","x-description-i18n":{"vie":"Nguồn quảng cáo"}},"bank_payments":{"type":"object","description":"Payment method","x-description-i18n":{"vie":"Phương thức thanh toán"}},"transfer_proofs":{"type":"array","description":"Bank transfer payment proofs, including verification time, amount and receipt images","x-description-i18n":{"vie":"Danh sách chứng từ xác thực chuyển khoản, gồm ngày giờ xác thực, số tiền và ảnh chứng từ"},"items":{"type":"object","properties":{"id":{"type":"integer","description":"Transfer proof ID","x-description-i18n":{"vie":"Mã chứng từ chuyển khoản"}},"order_id":{"type":"integer","description":"Order ID","x-description-i18n":{"vie":"Mã đơn hàng"}},"shop_id":{"type":"integer","description":"Shop ID","x-description-i18n":{"vie":"Mã cửa hàng"}},"payment_id":{"type":"string","description":"Bank payment method ID (matches a key in `bank_payments`)","x-description-i18n":{"vie":"Mã phương thức thanh toán ngân hàng (trùng với key trong `bank_payments`)"}},"amount":{"type":"integer","description":"Transferred amount","x-description-i18n":{"vie":"Số tiền chuyển khoản"}},"images":{"type":"array","description":"Transfer receipt images","x-description-i18n":{"vie":"Danh sách ảnh chứng từ chuyển khoản"},"items":{"type":"string"}},"note":{"type":"string","nullable":true,"description":"Note","x-description-i18n":{"vie":"Ghi chú"}},"is_income":{"type":"boolean","description":"Money received (true) or paid out (false)","x-description-i18n":{"vie":"Là khoản tiền nhận vào (true) hay chi ra (false)"}},"is_verify":{"type":"boolean","description":"Whether the transfer has been verified","x-description-i18n":{"vie":"Chứng từ đã được xác thực hay chưa"}},"verify_at":{"type":"string","format":"date-time","nullable":true,"description":"Verification time","x-description-i18n":{"vie":"Thời điểm xác thực chuyển khoản"}},"verifier":{"type":"object","nullable":true,"description":"Verifier information","x-description-i18n":{"vie":"Thông tin người xác thực"},"properties":{"id":{"type":"string","description":"Verifier ID","x-description-i18n":{"vie":"Mã người xác thực"}},"name":{"type":"string","description":"Verifier name","x-description-i18n":{"vie":"Tên người xác thực"}},"fb_id":{"type":"string","description":"Facebook ID of verifier","x-description-i18n":{"vie":"Facebook ID người xác thực"}},"avatar_url":{"type":"string","description":"Verifier avatar URL","x-description-i18n":{"vie":"Link avatar người xác thực"}}}},"creator":{"type":"object","nullable":true,"description":"Creator information","x-description-i18n":{"vie":"Thông tin người tạo chứng từ"},"properties":{"id":{"type":"string","description":"Creator ID","x-description-i18n":{"vie":"Mã người tạo"}},"name":{"type":"string","description":"Creator name","x-description-i18n":{"vie":"Tên người tạo"}},"fb_id":{"type":"string","description":"Facebook ID of creator","x-description-i18n":{"vie":"Facebook ID người tạo"}},"avatar_url":{"type":"string","description":"Creator avatar URL","x-description-i18n":{"vie":"Link avatar người tạo"}}}},"last_editor":{"type":"object","nullable":true,"description":"Last editor information","x-description-i18n":{"vie":"Thông tin người chỉnh sửa cuối"},"properties":{"id":{"type":"string","description":"Editor ID","x-description-i18n":{"vie":"Mã người chỉnh sửa"}},"name":{"type":"string","description":"Editor name","x-description-i18n":{"vie":"Tên người chỉnh sửa"}},"fb_id":{"type":"string","description":"Facebook ID of editor","x-description-i18n":{"vie":"Facebook ID người chỉnh sửa"}},"avatar_url":{"type":"string","description":"Editor avatar URL","x-description-i18n":{"vie":"Link avatar người chỉnh sửa"}}}},"order_info":{"type":"object","nullable":true,"description":"Additional order information","x-description-i18n":{"vie":"Thông tin đơn hàng bổ sung"}},"inserted_at":{"type":"string","format":"date-time","description":"Transfer proof creation time","x-description-i18n":{"vie":"Thời điểm tạo chứng từ"}},"updated_at":{"type":"string","format":"date-time","description":"Transfer proof update time","x-description-i18n":{"vie":"Thời điểm cập nhật chứng từ"}}}}},"shopify_order_id":{"type":"string","description":"Shopify order ID","x-description-i18n":{"vie":"Mã đơn hàng Shopify"}},"shopify_abandon_checkout_id":{"type":"integer","description":"Shopify abandon checkout ID","x-description-i18n":{"vie":"Mã Shopify abandon checkout"}},"is_abandoned_order":{"type":"boolean","description":"Abandoned-cart flag for creating or updating an order. Send it directly in the request body, not inside `third_party` or `third_party_infomation`.\nAn explicit value, including `false`, takes precedence over automatic detection. If omitted on creation, the flag is determined automatically; if omitted on update, the current value is preserved.\nOnly boolean `true` or string `\"true\"` is normalized to `true`; all other submitted values become `false`.\n","x-description-i18n":{"vie":"Cờ đơn chưa hoàn tất khi tạo hoặc cập nhật đơn. Truyền trực tiếp trong body, không bọc trong `third_party` hoặc `third_party_infomation`.\nGiá trị truyền lên, kể cả `false`, được ưu tiên hơn kết quả nhận diện tự động. Nếu bỏ qua khi tạo đơn, cờ được xác định tự động; nếu bỏ qua khi cập nhật, giữ nguyên giá trị hiện tại.\nChỉ boolean `true` hoặc chuỗi `\"true\"` được chuẩn hóa thành `true`; mọi giá trị khác được gửi lên đều thành `false`.\n"},"example":true},"cod":{"type":"integer","description":"Cash on delivery","x-description-i18n":{"vie":"Tiền thu hộ"}},"cash":{"type":"integer","description":"Cash payment","x-description-i18n":{"vie":"Tiền mặt"}},"account":{"type":"integer","description":"Order source ID","x-description-i18n":{"vie":"Mã nguồn đơn hàng"}},"account_name":{"type":"string","description":"Order source name","x-description-i18n":{"vie":"Tên mã nguồn đơn"}},"advanced_platform_fee":{"type":"object","description":"Fees from e-commerce platforms","x-description-i18n":{"vie":"Phí từ sàn thương mại điện tử"},"properties":{"ads_top_up":{"type":"integer","description":"Ads wallet top-up","x-description-i18n":{"vie":"Ví quảng cáo"}},"affiliate_commission":{"type":"integer","description":"Affiliate commission","x-description-i18n":{"vie":"Phí hoa hồng (Sàn TMĐT)"}},"diff_shipping_fee":{"type":"integer","description":"Difference shipping fee","x-description-i18n":{"vie":"Chênh lệch phí vận chuyển (Sàn TMĐT)"}},"marketplace_voucher":{"type":"integer","description":"Marketplace voucher","x-description-i18n":{"vie":"Sàn trợ giá"}},"payment_fee":{"type":"integer","description":"Payment fee","x-description-i18n":{"vie":"Phí cố định, giao dịch (Sàn TMĐT)"}},"platform_commission":{"type":"integer","description":"Platform commission","x-description-i18n":{"vie":"Phí hoa hồng nền tảng (Sàn TMĐT)"}},"seller_transaction_fee":{"type":"integer","description":"Seller transaction fee","x-description-i18n":{"vie":"Phí thanh toán (Sàn TMĐT)"}},"service_fee":{"type":"integer","description":"Service fee","x-description-i18n":{"vie":"Phí dịch vụ (Sàn TMĐT)"}},"sfp_service_fee":{"type":"integer","description":"SFP service fee","x-description-i18n":{"vie":"Phí dịch vụ SFP (Sàn TMĐT)"}}}},"printing_count":{"type":"integer","description":"Printing count","x-description-i18n":{"vie":"Số lần in"}},"money_to_collect":{"type":"integer","description":"Money to collect","x-description-i18n":{"vie":"Số tiền cần thu"}},"marketplace_id":{"type":"string","description":"Marketplace ID","enum":["-2","-3","-4","-9","-16","-17","-20","-25","-27","-28"],"x-enum-descriptions":{"-2":"Tiki","-3":"Shopee","-4":"Lazada","-9":"TikTok","-16":"WooCommerce","-17":"Shopify","-20":"Line Shopping","-25":"Tokopedia","-27":"Mercado Libre","-28":"Tiendanube"},"x-description-i18n":{"vie":"Mã sàn thương mại điện tử"}},"total_price":{"type":"integer","description":"Total price","x-description-i18n":{"vie":"Tổng giá trị sản phẩm"}},"shop_customer_address_id":{"type":"string","description":"Customer address ID","x-description-i18n":{"vie":"Mã địa chỉ khách hàng"}},"customer":{"type":"object","description":"Customer information","x-description-i18n":{"vie":"Thông tin khách hàng"},"properties":{"fb_id":{"type":"string","description":"Customer Facebook ID","x-description-i18n":{"vie":"Facebook ID khách hàng"}},"id":{"type":"string","description":"Customer ID","x-description-i18n":{"vie":"Mã khách hàng"}},"name":{"type":"string","description":"Customer name","x-description-i18n":{"vie":"Tên khách hàng"}},"page_id":{"type":"string","description":"Page ID","x-description-i18n":{"vie":"Mã trang"}}}},"total_quantity":{"type":"integer","description":"Total quantity","x-description-i18n":{"vie":"Tổng số lượng"}},"time_assign_marketer":{"type":"string","format":"date-time","description":"Time assign marketer","x-description-i18n":{"vie":"Thời điểm phân công marketer"}},"p_utm_source":{"type":"string","description":"UTM Source","x-description-i18n":{"vie":"UTM Source"}},"p_utm_medium":{"type":"string","description":"UTM Medium","x-description-i18n":{"vie":"UTM Medium"}},"p_utm_campaign":{"type":"string","description":"UTM Campaign","x-description-i18n":{"vie":"UTM Campaign"}},"p_utm_term":{"type":"string","description":"UTM Term","x-description-i18n":{"vie":"UTM Term"}},"p_utm_content":{"type":"string","description":"UTM Content","x-description-i18n":{"vie":"UTM Content"}},"p_utm_id":{"type":"string","description":"UTM ID","x-description-i18n":{"vie":"UTM ID"}},"utm_affiliate":{"type":"string","description":"Affiliate","x-description-i18n":{"vie":"Affiliate"}},"link":{"type":"string","description":"Link","x-description-i18n":{"vie":"Link"}},"status_history":{"type":"array","description":"Status update history","x-description-i18n":{"vie":"Lịch sử cập nhật trạng thái"},"items":{"type":"object","properties":{"avatar_url":{"type":"string","description":"Avatar URL","x-description-i18n":{"vie":"Link avatar"}},"editor":{"type":"object","description":"Editor information","x-description-i18n":{"vie":"Thông tin người chỉnh sửa"}},"editor_fb":{"type":"string","description":"Editor Facebook ID","x-description-i18n":{"vie":"Facebook ID người chỉnh sửa"}},"editor_id":{"type":"string","description":"Editor ID","x-description-i18n":{"vie":"Mã người chỉnh sửa"}},"name":{"type":"string","description":"Name","x-description-i18n":{"vie":"Tên"}},"old_status":{"type":"integer","description":"Old status","x-description-i18n":{"vie":"Trạng thái cũ"}},"status":{"type":"integer","description":"Status","x-description-i18n":{"vie":"Trạng thái"}},"updated_at":{"type":"string","format":"date-time","description":"Updated at","x-description-i18n":{"vie":"Thời điểm cập nhật"}}}}},"duplicated_phone":{"type":"boolean","description":"Duplicated phone","x-description-i18n":{"vie":"Số điện thoại trùng lặp"}},"order_currency":{"type":"string","description":"Order currency","x-description-i18n":{"vie":"Loại tiền tệ"}},"charged_by_vnpay":{"type":"integer","description":"Charged by VNPay","x-description-i18n":{"vie":"Số tiền thanh toán qua VNPay"}},"charged_by_qrpay":{"type":"integer","description":"Charged by QRPay","x-description-i18n":{"vie":"Số tiền khách thanh toán qua QRPAY"}},"custom_id":{"type":"string","description":"Custom ID","x-description-i18n":{"vie":"Mã tùy chỉnh"}},"last_editor":{"type":"object","description":"Last editor information","x-description-i18n":{"vie":"Thông tin người chỉnh sửa cuối cùng đơn hàng"},"properties":{"id":{"type":"string","description":"Editor ID","x-description-i18n":{"vie":"Mã người chỉnh sửa"}},"fb_id":{"type":"string","description":"Facebook ID of editor","x-description-i18n":{"vie":"Facebook ID người chỉnh sửa"}},"name":{"type":"string","description":"Editor name","x-description-i18n":{"vie":"Tên người chỉnh sửa"}},"email":{"type":"string","description":"Editor email","x-description-i18n":{"vie":"Email người chỉnh sửa"}},"avatar_url":{"type":"string","description":"Editor avatar URL","x-description-i18n":{"vie":"Link avatar người chỉnh sửa"}},"phone_number":{"type":"string","description":"Editor phone number","x-description-i18n":{"vie":"Số điện thoại người chỉnh sửa"}}}},"last_editor_id":{"type":"string","description":"Last editor ID","x-description-i18n":{"vie":"Mã người sửa cuối"}},"charged_by_momo":{"type":"integer","description":"Charged by MoMo","x-description-i18n":{"vie":"Số tiền khách thanh toán qua MOMO"}},"prepaid_by_point":{"type":"object","description":"Prepaid by point","x-description-i18n":{"vie":"Thanh toán bằng điểm thưởng"},"properties":{"money":{"type":"integer","description":"Money amount","x-description-i18n":{"vie":"Số tiền"},"example":15000},"point":{"type":"integer","description":"Point amount","x-description-i18n":{"vie":"Số điểm"},"example":15}},"example":{"money":15000,"point":15}},"bank_transfer_images":{"type":"array","description":"Bank transfer images","x-description-i18n":{"vie":"Hình ảnh chuyển khoản"},"items":{"type":"string","format":"uri"}},"transfer_money":{"type":"integer","description":"Transfer money","x-description-i18n":{"vie":"Số tiền khách chuyển khoản"}},"lock_order_by_user":{"type":"string","description":"Lock order by user ID","x-description-i18n":{"vie":"Mã người dùng khóa đơn hàng"}},"assigning_care":{"type":"object","description":"Assigning care information","x-description-i18n":{"vie":"Nhân viên chăm sóc"},"properties":{"id":{"type":"string","description":"Care ID","x-description-i18n":{"vie":"Mã người chăm sóc"}},"fb_id":{"type":"string","description":"Facebook ID of care","x-description-i18n":{"vie":"Facebook ID người chăm sóc"}},"name":{"type":"string","description":"Care name","x-description-i18n":{"vie":"Tên người chăm sóc"}},"email":{"type":"string","description":"Care email","x-description-i18n":{"vie":"Email người chăm sóc"}},"avatar_url":{"type":"string","description":"Care avatar URL","x-description-i18n":{"vie":"Link avatar người chăm sóc"}},"phone_number":{"type":"string","description":"Care phone number","x-description-i18n":{"vie":"Số điện thoại người chăm sóc"}}}},"assigning_care_id":{"type":"string","description":"Assigning care ID","x-description-i18n":{"vie":"Mã nhân viên chăm sóc"}},"time_assign_care":{"type":"string","format":"date-time","description":"Time assign care","x-description-i18n":{"vie":"Thời điểm phân công chăm sóc"}},"assigning_seller":{"type":"object","description":"Assigning seller information","x-description-i18n":{"vie":"Nhân viên được phân công"},"properties":{"id":{"type":"string","description":"Seller ID","x-description-i18n":{"vie":"Mã người bán"}},"fb_id":{"type":"string","description":"Facebook ID of seller","x-description-i18n":{"vie":"Facebook ID người bán"}},"name":{"type":"string","description":"Seller name","x-description-i18n":{"vie":"Tên người bán"}},"email":{"type":"string","description":"Seller email","x-description-i18n":{"vie":"Email người bán"}},"avatar_url":{"type":"string","description":"Seller avatar URL","x-description-i18n":{"vie":"Link avatar người bán"}},"phone_number":{"type":"string","description":"Seller phone number","x-description-i18n":{"vie":"Số điện thoại người bán"}}}},"einvoices":{"type":"array","items":{"$ref":"#/components/schemas/EInvoice"}},"charged_by_card":{"type":"integer","description":"Charged by card","x-description-i18n":{"vie":"Số tiền khách quẹt thẻ"}},"estimate_delivery_date":{"type":"string","format":"date-time","description":"Estimate delivery date","x-description-i18n":{"vie":"Ngày giao hàng dự kiến"}},"order_sources":{"type":"string","description":"Order sources ID","x-description-i18n":{"vie":"Mã nguồn đơn hàng"}},"charged_by_fundiin":{"type":"integer","description":"Charged by Fundiin","x-description-i18n":{"vie":"Số tiền thanh toán qua Fundiin"}},"surcharge":{"type":"integer","description":"Surcharge","x-description-i18n":{"vie":"Phụ thu"}},"is_linked_partner":{"type":"boolean","description":"Is linked partner","x-description-i18n":{"vie":"Đã liên kết đối tác"}},"call_laters":{"type":"array","description":"Call laters","x-description-i18n":{"vie":"Gọi lại sau"},"items":{"type":"object"}},"last_update_status_at":{"type":"string","format":"date-time","description":"Last update status at","x-description-i18n":{"vie":"Thời điểm cập nhật trạng thái cuối"}},"discount_by_customer_level":{"type":"integer","description":"Discount by customer level","x-description-i18n":{"vie":"Giảm giá theo cấp độ khách hàng"}},"viewing":{"type":"array","description":"Viewing","x-description-i18n":{"vie":"NV đang xem"},"items":{"type":"object"}},"additional_info":{"type":"object","description":"Additional info","x-description-i18n":{"vie":"Thông tin bổ sung"},"properties":{"service_partner":{"type":"string","description":"Service partner","x-description-i18n":{"vie":"Dịch vụ vận chuyển"},"enum":["instant"],"x-enum-descriptions":["Instant"],"x-enum-descriptions-i18n":{"vie":["Hỏa tốc"]}},"delivery_deadline":{"type":"string","format":"date-time","description":"Delivery deadline (ISO8601, no timezone). Send null to clear.","x-description-i18n":{"vie":"Hạn giao hàng (ISO8601, không kèm timezone). Gửi null để xóa."},"example":"2026-06-03T10:00:00"}}},"order_returned_ids":{"type":"string","description":"Order returned IDs","x-description-i18n":{"vie":"Mã đơn hàng đổi trả"}},"cost_surcharge":{"type":"integer","description":"Cost surcharge","x-description-i18n":{"vie":"Phụ phí"}},"time_send_partner":{"type":"string","format":"date-time","description":"Time send partner","x-description-i18n":{"vie":"Thời điểm gửi đơn vị vận chuyển"}},"charged_by_kredivo":{"type":"integer","description":"Charged by Kredivo","x-description-i18n":{"vie":"Số tiền thanh toán qua Kredivo"}},"discount":{"type":"integer","description":"Discount","x-description-i18n":{"vie":"Giảm giá"}},"histories":{"type":"array","description":"Histories","x-description-i18n":{"vie":"Lịch sử"},"items":{"type":"object"}},"duplicated_customer":{"type":"boolean","description":"Duplicated customer","x-description-i18n":{"vie":"Khách hàng trùng lặp"}},"customer_referral_code":{"type":"object","description":"Customer referral code","x-description-i18n":{"vie":"Mã giới thiệu khách hàng"},"properties":{"active":{"type":"string","description":"Active status","x-description-i18n":{"vie":"Trạng thái kích hoạt"},"example":"true"},"customer_id":{"type":"string","format":"uuid","description":"Customer ID","x-description-i18n":{"vie":"Mã khách hàng"},"example":"09bb9399-45f3-4897-a53a-85dde2f886fe"},"discount":{"type":"string","description":"Discount value","x-description-i18n":{"vie":"Giá trị giảm giá"},"example":"10"},"format":{"type":"string","description":"Referral code format","x-description-i18n":{"vie":"Định dạng mã giới thiệu"},"example":"{PHONE_NUMBER}"},"free_products_priced_between_approx":{"type":"object","description":"Free products priced between approximately","x-description-i18n":{"vie":"Miễn phí cho khách mới sản phẩm có giá"},"properties":{"active":{"type":"string","description":"Active status","x-description-i18n":{"vie":"Trạng thái kích hoạt"},"example":"true"},"operator":{"type":"string","description":"Comparison operator","x-description-i18n":{"vie":"Toán tử so sánh"},"example":"GreaterOrEqual"},"price":{"type":"string","description":"Price threshold","x-description-i18n":{"vie":"Ngưỡng giá"},"example":"150000"}}},"is_percent":{"type":"string","description":"Discount is percentage","x-description-i18n":{"vie":"Giảm giá theo phần trăm"},"example":"true"},"only_customers_with_level_will_have_referral_code":{"type":"string","description":"Only customers with level will have referral code","x-description-i18n":{"vie":"Chỉ khách hàng có cấp độ mới có mã giới thiệu"},"example":"true"},"referral_code":{"type":"string","description":"Referral code","x-description-i18n":{"vie":"Mã giới thiệu"},"example":"982843759"},"reward_points_for_old_customers":{"type":"object","description":"Reward points for customers","x-description-i18n":{"vie":"Điểm thưởng khách hàng"},"properties":{"active":{"type":"string","description":"Active status","x-description-i18n":{"vie":"Trạng thái kích hoạt"},"example":"true"},"money":{"type":"string","description":"Money reward","x-description-i18n":{"vie":"Tiền thưởng"},"example":"10000"},"point":{"type":"string","description":"Point reward","x-description-i18n":{"vie":"Điểm thưởng"},"example":"1"}}},"shop_customer_id":{"type":"string","format":"uuid","description":"Shop customer ID","x-description-i18n":{"vie":"Mã khách hàng shop"},"example":"f8160a4c-dfa7-4ee8-b540-d245755ea1f1"}},"example":{"active":"true","customer_id":"09bb9399-45f3-4897-a53a-85dde2f886fe","discount":"10","format":"{PHONE_NUMBER}","free_products_priced_between_approx":{"active":"true","operator":"GreaterOrEqual","price":"150000"},"is_percent":"true","only_customers_with_level_will_have_referral_code":"true","referral_code":"982843759","reward_points_for_old_customers":{"active":"true","money":"10000","point":"1"},"shop_customer_id":"f8160a4c-dfa7-4ee8-b540-d245755ea1f1"}},"tax":{"type":"integer","description":"Tax","x-description-i18n":{"vie":"Thuế"}},"is_from_ecommerce":{"type":"boolean","description":"Is from e-commerce","x-description-i18n":{"vie":"Đơn hàng từ sàn thương mại điện tử"}},"note_image":{"type":"array","description":"Note images","x-description-i18n":{"vie":"Link hình ảnh ghi chú"},"items":{"type":"string","format":"uri"}},"shopify_draft_order_id":{"type":"string","description":"Shopify draft order ID","x-description-i18n":{"vie":"Mã đơn hàng nháp Shopify"}},"display_id":{"type":"integer","description":"Display ID","x-description-i18n":{"vie":"Mã hiển thị"}},"shop_partner_id":{"type":"integer","description":"Shop partner ID","x-description-i18n":{"vie":"Mã đối tác shop"}},"is_locked":{"type":"boolean","description":"Order lock","x-description-i18n":{"vie":"Khóa đơn hàng"}},"merge_order":{"type":"boolean","description":"Allows merging orders","x-description-i18n":{"vie":"Cho phép gộp đơn"}}}},"examples":{"default":{"value":{"id":1,"system_id":1,"shop_id":1,"inserted_at":"2024-01-01T00:00:00Z","updated_at":"2024-01-01T00:00:00Z","status":1,"status_name":"Đã xác nhận","bill_full_name":"Hoang Anh","bill_phone_number":"0999999999","bill_email":"hoang@example.com","page_id":"104438181227821","post_id":"185187094667903_477083092110915","ad_id":"23851252560290199","shipping_fee":1,"partner_fee":1,"fee_marketplace":1,"customer_pay_fee":true,"is_free_shipping":true,"is_livestream":true,"is_live_shopping":true,"is_smc":true,"received_at_shop":true,"total_discount":1,"note":"","note_print":null,"returned_reason":1,"returned_reason_name":"Do khách hàng","sub_status":1,"warehouse_id":"b4cb5897-6e56-4581-96cc-2f12677c7bd8","warehouse_info":{"name":"kho test ecod","phone_number":"0999999999","full_address":"hâhhha, Xã Bình Trung, Huyện Châu Đức, Bà Rịa-Vũng Tàu","address":"hâhhha","province_id":"717","district_id":"71705","commune_id":"7170510","affiliate_id":null,"ffm_id":null,"has_snappy_service":true,"custom_id":null},"creator_id":"8fbe2a6f-b0b2-4227-a698-19d18c43f7c8","creator":{"id":"8fbe2a6f-b0b2-4227-a698-19d18c43f7c8","fb_id":"2042723249341651","name":"Hoang Anh","avatar_url":null},"items":[{"id":1,"product_id":"3487e126-b0d9-4dae-89a9-ee60bef2f4e9","variation_id":"415040f4-ab63-465e-8699-e9ebfff4c6c7","quantity":1,"returned_count":1,"assigning_seller_id":"340644fc-314d-450e-a45f-33343678cab6","quantity_by_combo_products":[],"discount_each_product":1,"is_bonus_product":true,"is_discount_percent":true,"is_wholesale":true,"is_composite":true,"one_time_product":true,"note":"","note_product":"","inserted_at":"2024-01-01T00:00:00Z","measure_group_id":1,"variation_info":{"id":"415040f4-ab63-465e-8699-e9ebfff4c6c7","name":"Ao so mi nam","product_id":"3487e126-b0d9-4dae-89a9-ee60bef2f4e9","retail_price":140000,"detail":"","images":["https://statics.pancake.vn/user-content.pancake.vn/2021/8/5/fccd6.jpg"],"fields":[{"id":"field-id-1","name":"Màu","value":"Trắng","keyValue":"Màu"}],"barcode":"BARCODE123","brand_id":null,"category_ids":[1290021044],"display_id":"13109","product_display_id":"a131092025","is_upsale_product":true,"last_imported_price":30000,"weight":0,"measure_info":{"measure_id":1,"exchange_value":1},"avg_price":30000},"components":[{"component_id":"3487e126-b0d9-4dae-89a9-ee60bef2f4e9","quantity":1,"variation_id":"415040f4-ab63-465e-8699-e9ebfff4c6c7"}]}],"partner":{"partner_id":1,"cod":0,"extend_code":"S58824.MB25.C3.500020713","total_fee":0,"updated_at":"2020-05-12T05:18:16","delivery_name":null,"delivery_tel":null,"picked_up_at":null,"sort_code":null,"paid_at":null,"system_created":true,"extend_update":[{"key":"status","status":"delivered","tracking_id":"S58824.MB25.C3.500020713","note":"","update_at":"2020-05-12T05:18:16"}]},"shipping_address":{"full_name":"Hoang Anh","phone_number":"0999999999","address":"90 Cầu Giấy","full_address":"90 Cầu Giấy, Phường Dịch Vọng, Quận Cầu Giấy, Hà Nội","province_id":"101","district_id":"10113","commune_id":"1011309","commnue_name":"Phường Dịch Vọng","district_name":"Quận Cầu Giấy","province_name":"Hà Nội","country_code":"84","post_code":null},"payment_purchase_histories":[{"amount":1800000,"type":"cash","inserted_at":"2024-01-01T00:00:00Z","result_code":"00","ipn_reply":true,"voucher_amount":0,"tags":["payment"]}],"tags":[{"id":75,"name":"thẻ 4"}],"marketer":{"id":"cee3c05e-5f85-43c4-b27e-889b99c50097","name":"Marketer Name","email":"marketer@example.com","phone_number":"0999999999","fb_id":"2042723249341651","avatar_url":null},"pke_mkter":"cee3c05e-5f85-43c4-b27e-889b99c50097","activated_combo_products":{"combo_product_id":1,"quantity_combo_activated":1},"activated_promotion_advances":[{"id":1,"promotion_advance_id":"fb056b32-9cf6-4c5a-92de-0eb94db71121"}],"tracking_link":"https://tracking.example.com","ads_source":null,"shopify_order_id":null,"shopify_abandon_checkout_id":1,"is_abandoned_order":true,"cod":0,"cash":0,"account":1,"account_name":"facebook321","advanced_platform_fee":{"ads_top_up":1,"affiliate_commission":1,"diff_shipping_fee":1,"marketplace_voucher":1,"payment_fee":1,"platform_commission":1,"seller_transaction_fee":1,"service_fee":1,"sfp_service_fee":1},"printing_count":1,"money_to_collect":1,"total_price":1,"shop_customer_address_id":"0fefd213-7d0c-4d5b-bdbf-35694da80857","customer":{"fb_id":null,"id":"96a8e283-3fba-492e-a35a-970f72a30a02","name":"Trần Văn Hoàng","page_id":"104438181227821"},"total_quantity":1,"time_assign_marketer":"2024-01-01T00:00:00Z","status_history":[{"avatar_url":null,"editor_fb":"2042723249341651","editor_id":"8fbe2a6f-b0b2-4227-a698-19d18c43f7c8","name":"Hoang Anh","old_status":0,"status":1,"updated_at":"2024-01-01T00:00:00Z"}],"duplicated_phone":true,"order_currency":"VND","charged_by_vnpay":1,"charged_by_qrpay":1,"custom_id":null,"last_editor":{"id":"8fbe2a6f-b0b2-4227-a698-19d18c43f7c8","fb_id":"2042723249341651","name":"Hoang Anh","email":"hoang@example.com","avatar_url":null,"phone_number":"0999999999"},"last_editor_id":"8fbe2a6f-b0b2-4227-a698-19d18c43f7c8","charged_by_momo":1,"bank_transfer_images":["https://statics.pancake.vn/user-content.pancake.vn/2021/8/5/fccd6.jpg"],"transfer_money":1,"lock_order_by_user":null,"assigning_care":{"id":"cee3c05e-5f85-43c4-b27e-889b99c50097","fb_id":"2042723249341651","name":"Care Name","email":"care@example.com","avatar_url":null,"phone_number":"0999999999"},"assigning_care_id":"cee3c05e-5f85-43c4-b27e-889b99c50097","time_assign_care":"2024-01-01T00:00:00Z","assigning_seller":{"id":"340644fc-314d-450e-a45f-33343678cab6","fb_id":"2042723249341651","name":"Seller Name","email":"seller@example.com","avatar_url":null,"phone_number":"0999999999"},"einvoices":[],"charged_by_card":1,"estimate_delivery_date":"2024-01-01T00:00:00Z","order_sources":"-1","charged_by_fundiin":1,"surcharge":1,"is_linked_partner":true,"call_laters":[],"last_update_status_at":"2024-01-01T00:00:00Z","discount_by_customer_level":1,"viewing":[],"order_returned_ids":null,"cost_surcharge":1,"time_send_partner":"2024-01-01T00:00:00Z","charged_by_kredivo":1,"discount":1,"histories":[],"duplicated_customer":true,"tax":1,"is_from_ecommerce":true,"note_image":["https://statics.pancake.vn/user-content.pancake.vn/2021/8/5/fccd6.jpg"],"shopify_draft_order_id":null,"display_id":1,"shop_partner_id":1,"is_locked":true}}}}}}}}},"/shops/{SHOP_ID}/orders/{ORDER_ID}/messages":{"get":{"summary":"Get order conversation messages","x-summary-i18n":{"vie":"Lấy tin nhắn hội thoại của đơn hàng"},"description":"Resolves the conversation associated with the order and returns messages from the entire conversation. Messages in each response are ordered chronologically (oldest to newest).\n\nPagination follows the Pancake web application semantics:\n- Omit `current_count` or set it to `0` to load up to 25 of the newest records, rendered in chronological order.\n- To load older records, set `current_count` to the total number of messages already loaded. After the first response use `25`; if the next response contains 30 messages, use `55`, and continue in the same way.\n- Calls with a positive `current_count` return up to 30 older messages.\n\nA valid order without an associated conversation returns `{\"success\":true,\"data\":[]}`.\n","x-description-i18n":{"vie":"Xác định hội thoại gắn với đơn hàng và trả về tin nhắn của toàn bộ hội thoại. Tin nhắn trong mỗi phản hồi được sắp xếp theo thứ tự thời gian từ cũ đến mới.\n\nPhân trang theo cơ chế hiện tại của ứng dụng Pancake web:\n- Bỏ qua `current_count` hoặc đặt bằng `0` để tải tối đa 25 bản ghi mới nhất, được hiển thị theo thứ tự thời gian.\n- Để tải các bản ghi cũ hơn, đặt `current_count` bằng tổng số tin nhắn đã tải. Sau phản hồi đầu tiên dùng `25`; nếu phản hồi tiếp theo có 30 tin nhắn thì dùng `55`, và tiếp tục tương tự.\n- Các lần gọi có `current_count` lớn hơn `0` trả về tối đa 30 tin nhắn cũ hơn.\n\nĐơn hàng hợp lệ nhưng không có hội thoại liên kết trả về `{\"success\":true,\"data\":[]}`.\n"},"tags":["Order"],"x-tags-i18n":{"vie":["Đơn hàng"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},{"name":"ORDER_ID","in":"path","required":true,"schema":{"type":"string","example":"SOICUN-12943-02"},"description":"Order ID","x-description-i18n":{"vie":"Mã đơn hàng"}},{"name":"current_count","in":"query","required":false,"schema":{"type":"integer","minimum":0,"maximum":2147483647,"default":0,"example":25},"description":"Number of messages already loaded. This is an offset count, not a cursor.","x-description-i18n":{"vie":"Số tin nhắn đã tải. Đây là số lượng dùng làm độ lệch, không phải con trỏ."}},{"name":"fields[]","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"}},"description":"Top-level message fields to include in each item. Repeat the query parameter for multiple fields, for example `fields[]=id&fields[]=message`. Omit it to return all fields.","x-description-i18n":{"vie":"Các trường cấp cao nhất cần trả về trong mỗi tin nhắn. Lặp lại tham số query để chọn nhiều trường, ví dụ `fields[]=id&fields[]=message`. Bỏ qua để trả về tất cả các trường."},"example":["id","message","inserted_at"]}],"responses":{"200":{"description":"Conversation messages, an empty data array when the valid order has no conversation, or a legacy authentication error returned with HTTP 200","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["success","data"],"properties":{"success":{"type":"boolean","enum":[true],"description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}},"data":{"type":"array","description":"Conversation messages in chronological order","x-description-i18n":{"vie":"Tin nhắn hội thoại theo thứ tự thời gian"},"items":{"$ref":"#/components/schemas/OrderMessage"}}}},{"$ref":"#/components/schemas/ErrorResponse"}]},"examples":{"default":{"value":{"success":true,"data":[{"id":"m_hULhobwR0nAa0NzuQaVc3O","type":"INBOX","message":"<div>Xin chào, shop còn size M không?</div>","original_message":"Xin chào, shop còn size M không?","message_tags":[],"from":{"id":"9306266852780716","name":"Nguyễn Văn A"},"seen":true,"can_like":false,"user_likes":false,"like_count":null,"can_comment":false,"comment_count":null,"can_remove":false,"is_removed":false,"is_hidden":false,"can_hide":false,"can_reply_privately":false,"private_reply_conversation":null,"attachments":[],"has_phone":false,"phone_info":[],"is_parent":false,"inserted_at":"2026-06-25T02:00:38.675576","page_id":"117967746266487","show_info":true,"parent_id":null,"is_parent_hidden":false,"edit_history":null,"removed_by":null,"rich_message":null,"conversation_id":"117967746266487_9306266852780716","is_livestream_order":null}]}},"authentication_required":{"value":{"success":false,"message":"Missing access_token","error_code":101}}}}}},"400":{"description":"The current_count parameter is invalid","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"success":false,"error":"invalid_parameters"}}}},"403":{"description":"The API key is invalid or disabled, or the authenticated user cannot access order management","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"invalid_api_key":{"value":{"success":false,"message":"api_key is invalid","error_code":105}},"missing_permission":{"value":{"success":false,"message":"Insufficient permissions","permission":"ql_donhang"}}}}}},"404":{"description":"The shop or order does not exist, or the order is not visible to the authenticated API client","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"success":false,"error":"order_not_found"}}}},"429":{"description":"The Open API request rate limit was reached","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"success":false,"message":"You have reached the limit of requests","error_code":106}}}},"502":{"description":"The upstream conversation service returned an error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"success":false,"error":"message_provider_error"}}}},"504":{"description":"The upstream conversation service timed out","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"success":false,"error":"message_provider_timeout"}}}}}}},"/shops/{SHOP_ID}/order_source":{"get":{"summary":"List of order sources","x-summary-i18n":{"vie":"Danh sách nguồn đơn hàng"},"description":"Get list of order sources","x-description-i18n":{"vie":"Lấy danh sách nguồn đơn hàng"},"tags":["Order"],"x-tags-i18n":{"vie":["Đơn hàng"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","description":"Order sources list","x-description-i18n":{"vie":"Danh sách nguồn đơn hàng"},"properties":{"data":{"type":"array","description":"List of order sources","x-description-i18n":{"vie":"Danh sách nguồn đơn hàng"},"items":{"type":"object","properties":{"id":{"type":"string","description":"Order source ID or page ID","x-description-i18n":{"vie":"Mã nguồn đơn hàng hoặc mã page"}},"name":{"type":"string","description":"Order source name or page name","x-description-i18n":{"vie":"Tên nguồn đơn hàng hoặc tên page"}},"parent_id":{"type":"integer","description":"Parent order source ID","x-description-i18n":{"vie":"Mã nguồn đơn hàng cha"}},"shop_id":{"type":"integer","description":"Shop ID","x-description-i18n":{"vie":"Mã cửa hàng"}},"inserted_at":{"type":"string","format":"date-time","description":"Created at","x-description-i18n":{"vie":"Thời điểm tạo"}},"updated_at":{"type":"string","format":"date-time","description":"Updated at","x-description-i18n":{"vie":"Thời điểm cập nhật"}},"link":{"type":"string","nullable":true,"description":"Fixed source link (Webcake landing link)","x-description-i18n":{"vie":"Link cố định của nguồn (link landing Webcake)"}}}}},"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}}}},"examples":{"default":{"value":{"data":[{"id":-3,"inserted_at":"2020-06-10T11:50:07","name":"Shopee","shop_id":7,"updated_at":"2020-06-10T11:50:07"},{"id":4,"inserted_at":"2020-06-17T08:41:54","name":"40999897","parent_id":-3,"shop_id":7,"updated_at":"2020-06-17T08:41:54"},{"id":"1471242102982974","inserted_at":"2021-04-22T08:33:15","name":"Pancake.vn","parent_id":-1,"shop_id":20,"updated_at":"2024-04-08T03:11:25"},{"id":"987654","inserted_at":"2024-05-01T08:00:00","link":"https://landing.example.com/source-abc","name":"Landing ABC","parent_id":-7,"shop_id":20,"updated_at":"2024-05-01T08:00:00"}],"success":true}}}}}}}}},"/shops/{SHOP_ID}/orders/tags":{"get":{"summary":"List of order tags","x-summary-i18n":{"vie":"Danh sách thẻ đơn hàng"},"description":"Get list of order tags","x-description-i18n":{"vie":"Lấy danh sách thẻ đơn hàng"},"tags":["Order tag"],"x-tags-i18n":{"vie":["Thẻ đơn hàng"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","description":"Order tags list","x-description-i18n":{"vie":"Danh sách thẻ đơn hàng"},"properties":{"data":{"type":"array","description":"List of order tags","x-description-i18n":{"vie":"Danh sách thẻ đơn hàng"},"items":{"type":"object","properties":{"id":{"type":"integer","description":"Tag ID","x-description-i18n":{"vie":"Mã thẻ đơn hàng"}},"name":{"type":"string","description":"Tag name","x-description-i18n":{"vie":"Tên thẻ đơn hàng"}},"color":{"type":"string","description":"Tag color code","x-description-i18n":{"vie":"Mã màu thẻ"}},"is_system_tag":{"type":"boolean","description":"Is system tag","x-description-i18n":{"vie":"Thẻ hệ thống"}},"groups":{"type":"array","description":"Tag group information","x-description-i18n":{"vie":"Thông tin nhóm thẻ"},"items":{"type":"object","properties":{"id":{"type":"integer","description":"Group ID","x-description-i18n":{"vie":"Mã nhóm"}},"name":{"type":"string","description":"Group name","x-description-i18n":{"vie":"Tên nhóm"}}}}}}}},"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}}}},"examples":{"default":{"value":{"data":[{"id":75,"name":"thẻ 4","color":"#123123","is_system_tag":false,"groups":[{"id":13,"name":"nhom 1"},{"id":16,"name":"nhom 2"}]},{"id":1,"name":"Giao không thành","color":"#f04134","is_system_tag":true,"groups":[{"id":-1,"name":"Delivery Group"},{"id":13,"name":"nhom 1"}]},{"id":2,"name":"Chờ cọc","color":"#096dd9","is_system_tag":true,"groups":[]}],"success":true}}}}}}}},"post":{"summary":"Create order tag","x-summary-i18n":{"vie":"Tạo thẻ đơn hàng"},"description":"Create a new order tag","x-description-i18n":{"vie":"Tạo mới thẻ đơn hàng"},"tags":["Order tag"],"x-tags-i18n":{"vie":["Thẻ đơn hàng"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}}],"requestBody":{"required":true,"description":"Request body containing order tag information to create","x-description-i18n":{"vie":"Thông tin yêu cầu chứa thông tin thẻ đơn hàng cần tạo"},"content":{"application/json":{"schema":{"type":"object","required":["name"],"properties":{"name":{"type":"string","description":"Tag name","x-description-i18n":{"vie":"Tên thẻ đơn hàng"}},"tag_color":{"type":"string","description":"Tag color code","x-description-i18n":{"vie":"Mã màu thẻ"}},"groups":{"type":"array","description":"List of tag group IDs. Get by API GET /shops/{SHOP_ID}/orders/tag_groups","x-description-i18n":{"vie":"Danh sách mã nhóm thẻ. Lấy từ API GET /shops/{SHOP_ID}/orders/tag_groups"},"items":{"type":"integer"}},"statuses":{"type":"array","description":"List of order statuses to apply the tag","x-description-i18n":{"vie":"Danh sách trạng thái đơn hàng áp dụng thẻ"},"items":{"type":"integer"}}},"example":{"name":"test 5.1","tag_color":"#000","groups":[1],"statuses":[1,2,3]}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","description":"Created order tag information","x-description-i18n":{"vie":"Thông tin thẻ đơn hàng đã tạo"},"properties":{"id":{"type":"integer","description":"Tag ID","x-description-i18n":{"vie":"Mã thẻ đơn hàng"}},"name":{"type":"string","description":"Tag name","x-description-i18n":{"vie":"Tên thẻ đơn hàng"}},"tag_color":{"type":"string","description":"Tag color code","x-description-i18n":{"vie":"Mã màu thẻ"}},"groups":{"type":"array","description":"List of tag group IDs","x-description-i18n":{"vie":"Danh sách mã nhóm thẻ"},"items":{"type":"integer"}},"statuses":{"type":"array","description":"List of order statuses to apply the tag","x-description-i18n":{"vie":"Danh sách trạng thái đơn hàng áp dụng thẻ"},"items":{"type":"integer"}}}},"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}}}},"examples":{"default":{"value":{"data":{"id":50,"name":"test 5.1","tag_color":"#000","groups":[1],"statuses":[1,2,3]},"success":true}}}}}}}}},"/shops/{SHOP_ID}/orders/tags/{TAG_ID}":{"put":{"summary":"Update order tag","x-summary-i18n":{"vie":"Cập nhật thẻ đơn hàng"},"description":"Update an order tag. Only applies to tags that are not system tags (is_system_tag = false)","x-description-i18n":{"vie":"Cập nhật thẻ đơn hàng. Chỉ áp dụng cho các thẻ không phải là thẻ hệ thống (is_system_tag = false)"},"tags":["Order tag"],"x-tags-i18n":{"vie":["Thẻ đơn hàng"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},{"name":"TAG_ID","in":"path","required":true,"schema":{"type":"integer","example":45},"description":"Tag ID","x-description-i18n":{"vie":"Mã thẻ đơn hàng"}}],"requestBody":{"required":true,"description":"Request body containing order tag information to update","x-description-i18n":{"vie":"Thông tin yêu cầu chứa thông tin thẻ đơn hàng cần cập nhật"},"content":{"application/json":{"schema":{"type":"object","required":["name"],"properties":{"name":{"type":"string","description":"Tag name","x-description-i18n":{"vie":"Tên thẻ đơn hàng"}},"tag_color":{"type":"string","description":"Tag color code","x-description-i18n":{"vie":"Mã màu thẻ"}},"groups":{"type":"array","description":"List of tag group IDs. Get by API GET /shops/{SHOP_ID}/orders/tag_groups","x-description-i18n":{"vie":"Danh sách mã nhóm thẻ. Lấy từ API GET /shops/{SHOP_ID}/orders/tag_groups"},"items":{"type":"integer"}},"statuses":{"type":"array","description":"List of order statuses to apply the tag","x-description-i18n":{"vie":"Danh sách trạng thái đơn hàng áp dụng thẻ"},"items":{"type":"integer"}}},"example":{"name":"test 4.4","tag_color":"#000","groups":[1,2],"statuses":[1,2,3]}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","description":"Updated order tag information","x-description-i18n":{"vie":"Thông tin thẻ đơn hàng đã cập nhật"},"properties":{"id":{"type":"integer","description":"Tag ID","x-description-i18n":{"vie":"Mã thẻ đơn hàng"}},"name":{"type":"string","description":"Tag name","x-description-i18n":{"vie":"Tên thẻ đơn hàng"}},"tag_color":{"type":"string","description":"Tag color code","x-description-i18n":{"vie":"Mã màu thẻ"}},"groups":{"type":"array","description":"List of tag group IDs","x-description-i18n":{"vie":"Danh sách mã nhóm thẻ"},"items":{"type":"integer"}},"statuses":{"type":"array","description":"List of order statuses to apply the tag","x-description-i18n":{"vie":"Danh sách trạng thái đơn hàng áp dụng thẻ"},"items":{"type":"integer"}}}},"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}}}},"examples":{"default":{"value":{"data":{"id":45,"name":"test 4.4","tag_color":"#000","groups":[2,1],"statuses":[1,2,3]},"success":true}}}}}}}}},"/shops/{SHOP_ID}/orders/tag_groups":{"get":{"summary":"List of order tag groups","x-summary-i18n":{"vie":"Danh sách nhóm thẻ đơn hàng"},"description":"Get list of order tag groups","x-description-i18n":{"vie":"Lấy danh sách nhóm thẻ đơn hàng"},"tags":["Order tag"],"x-tags-i18n":{"vie":["Thẻ đơn hàng"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","description":"Order tag groups list","x-description-i18n":{"vie":"Danh sách nhóm thẻ đơn hàng"},"properties":{"data":{"type":"array","description":"List of order tag groups","x-description-i18n":{"vie":"Danh sách nhóm thẻ đơn hàng"},"items":{"type":"object","properties":{"id":{"type":"integer","description":"Group ID","x-description-i18n":{"vie":"Mã nhóm thẻ"}},"name":{"type":"string","description":"Group name","x-description-i18n":{"vie":"Tên nhóm thẻ"}},"add_multiple_tags":{"type":"boolean","description":"Allow adding multiple tags of the group to an order","x-description-i18n":{"vie":"Cho phép gắn nhiều thẻ trong nhóm vào một đơn hàng"}},"tags":{"type":"array","description":"List of tag IDs in the group","x-description-i18n":{"vie":"Danh sách mã thẻ trong nhóm"},"items":{"type":"integer"}}}}},"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}}}},"examples":{"default":{"value":{"data":[{"id":1,"name":"nhóm 1","add_multiple_tags":true,"tags":[41,50,45]}],"success":true}}}}}}}}},"/shops/{SHOP_ID}/products/get_logistics_shipping_document":{"post":{"summary":"Get link print label","x-summary-i18n":{"vie":"Lấy liên kết in đơn"},"description":"Get link to print shipping label and packing slips","x-description-i18n":{"vie":"Lấy liên kết in nhãn vận chuyển và phiếu đóng gói"},"tags":["Order"],"x-tags-i18n":{"vie":["Đơn hàng"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},{"name":"document_type","in":"query","required":false,"schema":{"type":"string","enum":["SL_PL","SHIPPING_LABEL","PICK_LIST"],"x-enum-descriptions":["Shipping label + Packing slips","Shipping label","Packing slips"],"x-enum-descriptions-i18n":{"vie":["Nhãn vận chuyển + Phiếu đóng gói","Nhãn vận chuyển","Phiếu đóng gói"]},"example":"SL_PL"},"description":"Document type","x-description-i18n":{"vie":"Loại in"}}],"requestBody":{"required":true,"description":"Request body containing list of order IDs to print labels","x-description-i18n":{"vie":"Thông tin yêu cầu chứa danh sách mã đơn hàng cần in nhãn"},"content":{"application/json":{"schema":{"type":"object","required":["params"],"properties":{"params":{"type":"array","description":"List of order IDs","x-description-i18n":{"vie":"Danh sách mã đơn hàng"},"items":{"type":"object","required":["order_id"],"properties":{"order_id":{"type":"string","description":"Order ID","x-description-i18n":{"vie":"Mã đơn hàng"}}}}}},"example":{"params":[{"order_id":"576551803772635228"}]}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","description":"Print label links","x-description-i18n":{"vie":"Liên kết in nhãn"},"properties":{"data":{"type":"array","description":"List of print label URLs","x-description-i18n":{"vie":"Danh sách URL in nhãn"},"items":{"type":"string","format":"uri"}},"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}}}},"examples":{"default":{"value":{"data":["https://content.pancake.vn/2-25/2025/3/28/071edc2cc6c728f6c3fa493a2cb033e8f61fb11e.071edc2cc6c728f6c3fa493a2cb033e8f61fb11e"],"success":true}}}}}}}}},"/shops/{SHOP_ID}/orders/get_tracking_url":{"post":{"summary":"Get order confirm link","x-summary-i18n":{"vie":"Lấy liên kết xác nhận đơn hàng"},"description":"Get order confirm link","x-description-i18n":{"vie":"Lấy liên kết xác nhận đơn hàng"},"tags":["Order"],"x-tags-i18n":{"vie":["Đơn hàng"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}}],"requestBody":{"required":true,"description":"Request body containing system ID to get tracking URL","x-description-i18n":{"vie":"Thông tin yêu cầu chứa mã hệ thống để lấy URL theo dõi"},"content":{"application/json":{"schema":{"type":"object","required":["system_id"],"properties":{"system_id":{"type":"integer","description":"System ID","x-description-i18n":{"vie":"Mã hệ thống"}}},"example":{"system_id":862}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","description":"Tracking URL","x-description-i18n":{"vie":"URL theo dõi"},"properties":{"url":{"type":"string","format":"uri","description":"Order confirm link","x-description-i18n":{"vie":"Liên kết xác nhận đơn hàng"}},"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}}}},"examples":{"default":{"value":{"url":"https://pke.gg/99gjy3r","success":true}}}}}}}}},"/shops/{SHOP_ID}/orders/{ORDER_ID}/trigger_call":{"post":{"summary":"Trigger auto voice call for an order","x-summary-i18n":{"vie":"Kích hoạt cuộc gọi tự động cho đơn hàng"},"description":"Trigger an automated outbound call (Auto Voice) to the order's customer phone number and play the selected voice. Returns a background job id; the call outcome is delivered asynchronously. The SIP subscription must have the Auto Voice add-on enabled.","x-description-i18n":{"vie":"Kích hoạt cuộc gọi tự động (Auto Voice) tới số điện thoại khách của đơn hàng và phát lời thoại đã chọn. Trả về job id; kết quả cuộc gọi được trả về bất đồng bộ. Gói tổng đài phải có add-on Gọi tự động."},"tags":["Auto Voice"],"x-tags-i18n":{"vie":["Gọi tự động"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},{"name":"ORDER_ID","in":"path","required":true,"schema":{"type":"string","example":"1418"},"description":"Order ID","x-description-i18n":{"vie":"Mã đơn hàng"}}],"requestBody":{"required":true,"description":"Request body containing the voice id to play","x-description-i18n":{"vie":"Thông tin yêu cầu chứa mã lời thoại cần phát"},"content":{"application/json":{"schema":{"type":"object","required":["voice_id"],"properties":{"voice_id":{"type":"string","format":"uuid","description":"Voice id (copied from the voice management screen)","x-description-i18n":{"vie":"Mã lời thoại (copy từ màn quản lý lời thoại)"}}},"example":{"voice_id":"3f7c2b9a-1e4d-4a2b-9c8e-2b1d0a9f6e5c"}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}}}},"examples":{"default":{"value":{"success":true}}}}}}}}},"/shops/{SHOP_ID}/orders/arrange_shipment":{"post":{"summary":"Prepare order shipment","x-summary-i18n":{"vie":"Chuẩn bị hàng đơn sàn"},"description":"Prepare order shipment","x-description-i18n":{"vie":"Chuẩn bị hàng đơn sàn"},"tags":["Order"],"x-tags-i18n":{"vie":["Đơn hàng"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}}],"requestBody":{"required":true,"description":"Request body containing order IDs to prepare shipment","x-description-i18n":{"vie":"Thông tin yêu cầu chứa danh sách mã đơn hàng cần chuẩn bị hàng"},"content":{"application/json":{"schema":{"type":"object","required":["order_id"],"properties":{"order_id":{"type":"string","description":"Order ID","x-description-i18n":{"vie":"Mã đơn hàng"}},"pickup_shift":{"type":"string","description":"Pickup shift. Required for Shopee platform.","x-description-i18n":{"vie":"Ca nhận hàng. Bắt buộc cho sàn Shopee."},"enum":["closest","farthest"],"x-enum-descriptions":["closest","farthest"],"x-enum-descriptions-i18n":{"vie":["Ca gần nhất","Ca xa nhất"]},"example":"closest"},"pickup_method":{"type":"string","description":"Pickup method. Required for Shopee and TikTok platforms.","x-description-i18n":{"vie":"Phương thức nhận hàng. Bắt buộc cho sàn Shopee và TikTok."},"enum":["pick_up","drop_off"],"x-enum-descriptions":["ĐVVC lấy hàng","Mang hàng ra bưu cục"],"example":"pick_up"}},"example":{"order_id":"34123423498237","pickup_shift":"closest","pickup_method":"pick_up"}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","description":"Arrange shipment response","x-description-i18n":{"vie":"Phản hồi chuẩn bị hàng"},"properties":{"message":{"type":"string","description":"Response message","x-description-i18n":{"vie":"Thông báo phản hồi"}},"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}}}},"examples":{"default":{"value":{"message":"Arrange shipment successfully","success":true}}}}}}}}},"/shops/{SHOP_ID}/orders/get_promotion_advance_active":{"post":{"summary":"List of advanced promotions of order","x-summary-i18n":{"vie":"Danh sách khuyến mại nâng cao của đơn"},"description":"Get list of advanced promotions that can be applied to an order","x-description-i18n":{"vie":"Lấy danh sách khuyến mại nâng cao có thể áp dụng cho đơn hàng"},"tags":["Order"],"x-tags-i18n":{"vie":["Đơn hàng"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}}],"requestBody":{"required":true,"description":"Request body containing order information (existing order ID or new order details) to get active promotions","x-description-i18n":{"vie":"Thông tin yêu cầu chứa thông tin đơn hàng (mã đơn hàng đã tồn tại hoặc chi tiết đơn hàng mới) để lấy khuyến mại đang hoạt động"},"content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["order_id"],"properties":{"order_id":{"type":"string","description":"Order ID (for existing order)","x-description-i18n":{"vie":"Mã đơn hàng (cho đơn hàng đã tồn tại)"}}}},{"type":"object","required":["order"],"properties":{"order":{"type":"object","required":["shop_id","items"],"properties":{"shop_id":{"type":"integer","description":"Shop ID","x-description-i18n":{"vie":"Mã cửa hàng"}},"received_at_shop":{"type":"boolean","description":"Sales at counter","x-description-i18n":{"vie":"Bán tại quầy"}},"warehouse_id":{"type":"string","description":"Warehouse ID","x-description-i18n":{"vie":"Mã kho hàng"}},"order_currency":{"type":"string","description":"Order currency","x-description-i18n":{"vie":"Tiền tệ đơn hàng"}},"order_sources":{"type":"integer","description":"Order source ID","x-description-i18n":{"vie":"Mã nguồn đơn hàng"}},"customer":{"type":"object","description":"Customer information","x-description-i18n":{"vie":"Thông tin khách hàng"},"properties":{"shop_customer":{"type":"object","properties":{"tags":{"type":"array","items":{"type":"string"}}}}}},"items":{"type":"array","description":"Product list","x-description-i18n":{"vie":"Danh sách sản phẩm"},"items":{"type":"object","required":["product_id","variation_id"],"properties":{"product_id":{"type":"string","description":"Product ID","x-description-i18n":{"vie":"Mã sản phẩm"}},"variation_id":{"type":"string","description":"Variation ID","x-description-i18n":{"vie":"Mã biến thể"}},"quantity":{"type":"integer","description":"Quantity","x-description-i18n":{"vie":"Số lượng"}},"variation_info":{"type":"object","description":"Variation information","x-description-i18n":{"vie":"Thông tin biến thể"}}}}}}}}}],"examples":{"existing_order":{"value":{"order_id":"LMP0266310053VNA"}},"new_order":{"value":{"order":{"shop_id":224,"received_at_shop":false,"warehouse_id":"73c9505e-0f90-4a18-a1a1-13e1bdac21ee","order_currency":"VND","order_sources":-3,"customer":{"shop_customer":{"tags":["Tiềm năng"]}},"items":[{"product_id":"4a6fc152-5989-4202-83d4-a11a2ab28078","variation_id":"ad5a7194-034f-49cb-9d27-64fec1f30999","quantity":1,"variation_info":{"retail_price":500000,"category_ids":[1572],"product_tags":[196]}}]}}}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"integer","description":"Order ID","x-description-i18n":{"vie":"Mã đơn hàng"}},"system_id":{"type":"integer","description":"System ID","x-description-i18n":{"vie":"Mã hệ thống"}},"shop_id":{"type":"integer","description":"Shop ID","x-description-i18n":{"vie":"Mã cửa hàng"}},"inserted_at":{"type":"string","format":"date-time","description":"Order creation time","x-description-i18n":{"vie":"Thời điểm tạo đơn"}},"updated_at":{"type":"string","format":"date-time","description":"Order update time","x-description-i18n":{"vie":"Thời điểm cập nhật đơn"}},"status":{"type":"integer","description":"Order status","x-description-i18n":{"vie":"Trạng thái đơn hàng"},"enum":[0,17,11,12,13,20,1,8,9,2,3,16,4,15,5,6,7],"x-enum-descriptions":["New","Waiting for confirmation","Restocking","Wait for printing","Printed","Purchased","Confirmed","Packaging","Waiting for pick up","Shipped","Received","Collected money","Returning","Partial return","Returned","Canceled","Deleted recently"],"x-enum-descriptions-i18n":{"vie":["Mới","Chờ xác nhận","Chờ hàng","Chờ in","Đã in","Đã đặt hàng","Đã xác nhận","Đang đóng hàng","Chờ chuyển hàng","Đã gửi hàng","Đã nhận","Đã thu tiền","Đang hoàn","Hoàn một phần","Đã hoàn","Đã hủy","Đã xóa"]}},"status_name":{"type":"string","description":"Order status name","x-description-i18n":{"vie":"Tên trạng thái đơn hàng"}},"bill_full_name":{"type":"string","description":"Customer name","x-description-i18n":{"vie":"Tên khách hàng"}},"bill_phone_number":{"type":"string","description":"Phone number of customer","x-description-i18n":{"vie":"SĐT khách hàng"}},"bill_email":{"type":"string","description":"Customer email","x-description-i18n":{"vie":"Email khách hàng"}},"conversation_id":{"type":"string","description":"Conversation ID","x-description-i18n":{"vie":"Mã hội thoại"}},"page_id":{"type":"string","description":"Facebook page ID","x-description-i18n":{"vie":"Mã Facebook page"}},"post_id":{"type":"string","description":"Post ID","x-description-i18n":{"vie":"Mã bài viết"}},"ad_id":{"type":"string","description":"Ad ID","x-description-i18n":{"vie":"Mã quảng cáo"}},"shipping_fee":{"type":"integer","description":"Shipping fee","x-description-i18n":{"vie":"Phí vận chuyển"}},"partner_fee":{"type":"integer","description":"Fee from shipping partner","x-description-i18n":{"vie":"Phí vận chuyển từ ĐVVC"}},"fee_marketplace":{"type":"integer","description":"Fees from e-commerce platforms","x-description-i18n":{"vie":"Phí sàn"}},"customer_pay_fee":{"type":"boolean","description":"Customer pay shipping fee","x-description-i18n":{"vie":"Khách trả phí ship"}},"is_free_shipping":{"type":"boolean","description":"Free shipping","x-description-i18n":{"vie":"Miễn phí vận chuyển"}},"is_livestream":{"type":"boolean","description":"Is livestream order","x-description-i18n":{"vie":"Đơn hàng từ livestream"}},"is_live_shopping":{"type":"boolean","description":"Is live shopping order","x-description-i18n":{"vie":"Đơn hàng từ live shopping"}},"is_smc":{"type":"boolean","description":"Shopping on Messenger","x-description-i18n":{"vie":"Đơn hàng từ mua sắm trên Messenger"}},"received_at_shop":{"type":"boolean","description":"true: Sales at counter, false: Sell online","x-description-i18n":{"vie":"true: Bán tại quầy, false: Bán online"}},"total_discount":{"type":"integer","description":"Discount total","x-description-i18n":{"vie":"Tổng tiền giảm giá"}},"note":{"type":"string","description":"Internal note","x-description-i18n":{"vie":"Ghi chú nội bộ"}},"note_print":{"type":"string","description":"Note for printing","x-description-i18n":{"vie":"Ghi chú đơn hàng"}},"returned_reason":{"type":"integer","description":"Return reason code (1: Customer, 2: Staff, 3: Defective product, 4: Shipping carrier, 5: Exchange). Other values are shop-defined custom reasons, see returned_reason_name for the display name","x-description-i18n":{"vie":"Mã lý do hoàn hàng (1: Do khách hàng, 2: Do nhân viên, 3: Do sản phẩm lỗi, 4: Do đơn vị vận chuyển, 5: Do đổi hàng). Mã khác là lý do tùy chỉnh theo từng shop, xem tên hiển thị tại returned_reason_name"}},"returned_reason_name":{"type":"string","description":"Return reason name","x-description-i18n":{"vie":"Tên lý do hoàn hàng"}},"sub_status":{"type":"integer","description":"Reason for delivery delay","x-description-i18n":{"vie":"Lý do delay giao hàng"}},"warehouse_id":{"type":"string","description":"Warehouse ID","x-description-i18n":{"vie":"Mã kho hàng"}},"warehouse_info":{"type":"object","description":"Warehouse information","x-description-i18n":{"vie":"Thông tin kho hàng"},"properties":{"name":{"type":"string","description":"Warehouse name","x-description-i18n":{"vie":"Tên kho hàng"}},"phone_number":{"type":"string","description":"Warehouse phone number","x-description-i18n":{"vie":"Số điện thoại kho hàng"}},"full_address":{"type":"string","description":"Warehouse full address","x-description-i18n":{"vie":"Địa chỉ đầy đủ kho hàng"}},"address":{"type":"string","description":"Warehouse address","x-description-i18n":{"vie":"Địa chỉ chi tiết kho hàng"}},"province_id":{"type":"string","description":"Province ID","x-description-i18n":{"vie":"Mã tỉnh thành phố"}},"district_id":{"type":"string","description":"District ID","x-description-i18n":{"vie":"Mã quận huyện"}},"commune_id":{"type":"string","description":"Commune ID","x-description-i18n":{"vie":"Mã phường xã"}},"affiliate_id":{"type":"string","description":"Affiliate ID","x-description-i18n":{"vie":"Mã đại lý"}},"ffm_id":{"type":"string","description":"FFM ID","x-description-i18n":{"vie":"Mã FFM"}},"has_snappy_service":{"type":"boolean","description":"Has Snappy service","x-description-i18n":{"vie":"Có dịch vụ Snappy"}},"custom_id":{"type":"string","description":"Custom ID","x-description-i18n":{"vie":"Mã tùy chỉnh"}}}},"creator_id":{"type":"string","description":"Creator ID","x-description-i18n":{"vie":"Mã người tạo"}},"creator":{"type":"object","description":"Order creator","x-description-i18n":{"vie":"Thông tin người tạo đơn"},"properties":{"id":{"type":"string","description":"Creator ID","x-description-i18n":{"vie":"Mã người tạo"}},"fb_id":{"type":"string","description":"Facebook ID of creator","x-description-i18n":{"vie":"ID facebook người tạo đơn"}},"name":{"type":"string","description":"Creator name","x-description-i18n":{"vie":"Tên người tạo đơn"}},"avatar_url":{"type":"string","description":"Creator avatar URL","x-description-i18n":{"vie":"Link avatar người tạo"}}}},"items":{"type":"array","description":"Product list. When creating or updating an order, each entry must include `variation_id` and `quantity`. `variation_info` is optional — if omitted, the backend treats it as an empty object; send it (with `retail_price`) when you need the line price to be explicit.","x-description-i18n":{"vie":"Danh sách sản phẩm. Khi tạo hoặc cập nhật đơn, mỗi phần tử cần có `variation_id` và `quantity`. `variation_info` không bắt buộc — nếu thiếu, backend coi như object rỗng; nên gửi kèm (cùng `retail_price`) khi muốn giá dòng hàng tường minh."},"items":{"type":"object","required":["variation_id","quantity"],"properties":{"product_id":{"type":"string","description":"Product ID","x-description-i18n":{"vie":"Mã sản phẩm"}},"quantity":{"type":"integer","description":"Quantity","x-description-i18n":{"vie":"Số lượng"}},"returned_count":{"type":"integer","description":"Returned count","x-description-i18n":{"vie":"Số lượng đã trả"}},"assigning_seller_id":{"type":"string","description":"Assigning seller ID","x-description-i18n":{"vie":"Mã nhân viên được phân công"}},"quantity_by_combo_products":{"type":"array","description":"Quantity by combo products","x-description-i18n":{"vie":"Số lượng theo combo sản phẩm"},"items":{"type":"object"}},"discount_each_product":{"type":"integer","description":"Discount for each product","x-description-i18n":{"vie":"Giảm giá cho từng sản phẩm"}},"is_bonus_product":{"type":"boolean","description":"Is bonus product","x-description-i18n":{"vie":"Sản phẩm tặng kèm"}},"is_discount_percent":{"type":"boolean","description":"Is discount by percent","x-description-i18n":{"vie":"Giảm giá theo phần trăm"}},"is_wholesale":{"type":"boolean","description":"Is wholesale","x-description-i18n":{"vie":"Bán sỉ"}},"is_composite":{"type":"boolean","description":"Is composite product","x-description-i18n":{"vie":"Sản phẩm composite"}},"one_time_product":{"type":"boolean","description":"One time product","x-description-i18n":{"vie":"Sản phẩm một lần"}},"note":{"type":"string","description":"Product note","x-description-i18n":{"vie":"Ghi chú sản phẩm"}},"note_product":{"type":"string","description":"Product note","x-description-i18n":{"vie":"Ghi chú sản phẩm"}},"inserted_at":{"type":"string","format":"date-time","description":"Inserted at","x-description-i18n":{"vie":"Thời điểm tạo"}},"measure_group_id":{"type":"integer","description":"Measure group ID","x-description-i18n":{"vie":"Mã nhóm đơn vị tính"}},"variation_info":{"type":"object","description":"Variation information. Optional when creating/updating an order (the backend defaults it to an empty object if omitted). Its inner fields are not individually required, but sending `retail_price` is recommended so the line price is correct.","x-description-i18n":{"vie":"Thông tin biến thể. Không bắt buộc khi tạo/cập nhật đơn (backend tự coi là object rỗng nếu thiếu). Các field bên trong không bắt buộc riêng lẻ, nhưng nên gửi `retail_price` để giá dòng hàng đúng."},"properties":{"id":{"type":"string","description":"Variation ID","x-description-i18n":{"vie":"Mã biến thể"}},"name":{"type":"string","description":"Product name","x-description-i18n":{"vie":"Tên sản phẩm"}},"product_id":{"type":"string","description":"Product ID","x-description-i18n":{"vie":"Mã sản phẩm"}},"retail_price":{"type":"integer","description":"Retail price. Not strictly required, but recommended when creating/updating an order so the line price is correct.","x-description-i18n":{"vie":"Giá bán lẻ. Không bắt buộc, nhưng nên gửi khi tạo/cập nhật đơn để giá dòng hàng chính xác."}},"detail":{"type":"string","description":"Variation detail","x-description-i18n":{"vie":"Chi tiết biến thể"}},"images":{"type":"array","description":"Variation images","x-description-i18n":{"vie":"Hình ảnh biến thể"},"items":{"type":"string","format":"uri"}},"fields":{"type":"array","description":"Variation fields","x-description-i18n":{"vie":"Thuộc tính biến thể"},"items":{"type":"object","properties":{"id":{"type":"string","description":"Field ID","x-description-i18n":{"vie":"Mã thuộc tính"}},"name":{"type":"string","description":"Field name","x-description-i18n":{"vie":"Tên thuộc tính"}},"value":{"type":"string","description":"Field value","x-description-i18n":{"vie":"Giá trị thuộc tính"}},"keyValue":{"type":"string","description":"Key value","x-description-i18n":{"vie":"Giá trị khóa"}}}}},"barcode":{"type":"string","description":"Barcode","x-description-i18n":{"vie":"Mã barcode"}},"brand_id":{"type":"string","description":"Brand ID","x-description-i18n":{"vie":"Mã thương hiệu"}},"category_ids":{"type":"array","description":"Category IDs","x-description-i18n":{"vie":"Danh sách mã danh mục"},"items":{"type":"integer"}},"display_id":{"type":"string","description":"Display ID","x-description-i18n":{"vie":"Mã hiển thị"}},"product_display_id":{"type":"string","description":"Product display ID","x-description-i18n":{"vie":"Mã hiển thị sản phẩm"}},"last_imported_price":{"type":"integer","description":"Last imported price","x-description-i18n":{"vie":"Giá nhập hàng cuối"}},"is_upsale_product":{"type":"boolean","description":"Upsale product","x-description-i18n":{"vie":"Sản phẩm upsale"}},"weight":{"type":"integer","description":"Weight","x-description-i18n":{"vie":"Khối lượng"}},"measure_info":{"type":"object","description":"Measure information","x-description-i18n":{"vie":"Thông tin đơn vị tính"},"properties":{"measure_id":{"type":"integer","description":"Measure ID","x-description-i18n":{"vie":"Mã đơn vị tính"}},"exchange_value":{"type":"integer","description":"Exchange value","x-description-i18n":{"vie":"Giá trị quy đổi"}}}},"avg_price":{"type":"integer","description":"Average import price","x-description-i18n":{"vie":"Giá nhập trung bình"}}}},"components":{"type":"array","description":"Product components","x-description-i18n":{"vie":"Thành phần sản phẩm"},"items":{"type":"object","properties":{"component_id":{"type":"string","description":"Component ID","x-description-i18n":{"vie":"Mã thành phần"}},"quantity":{"type":"integer","description":"Quantity","x-description-i18n":{"vie":"Số lượng"}},"variation_id":{"type":"string","description":"Variation ID","x-description-i18n":{"vie":"Mã biến thể"}},"variation_info":{"type":"object","description":"Variation information","x-description-i18n":{"vie":"Thông tin biến thể"}}}}},"id":{"type":"integer","description":"Item ID","x-description-i18n":{"vie":"Mã sản phẩm trong đơn"}},"variation_id":{"type":"string","description":"Variation ID","x-description-i18n":{"vie":"Mã biến thể"}}}}},"partner":{"type":"object","description":"Partner information","x-description-i18n":{"vie":"Thông tin đơn vị vận chuyển"},"properties":{"partner_id":{"type":"integer","description":"Partner ID","x-description-i18n":{"vie":"ID đơn vị vận chuyển trên hệ thống Pancake"}},"cod":{"type":"integer","description":"Reconciliation COD","x-description-i18n":{"vie":"Đối soát tiền thu hộ"}},"extend_code":{"type":"string","description":"Shipping order ID on partner system","x-description-i18n":{"vie":"Mã vận đơn"}},"total_fee":{"type":"integer","description":"Total fee","x-description-i18n":{"vie":"Tổng phí"}},"updated_at":{"type":"string","format":"date-time","description":"Updated at","x-description-i18n":{"vie":"Thời điểm cập nhật"}},"delivery_name":{"type":"string","description":"Shipper name","x-description-i18n":{"vie":"Tên người giao hàng"}},"delivery_tel":{"type":"string","description":"Delivery phone","x-description-i18n":{"vie":"Số điện thoại người giao hàng"}},"picked_up_at":{"type":"string","format":"date-time","description":"Picked up at","x-description-i18n":{"vie":"Thời điểm lấy hàng"}},"sort_code":{"type":"string","description":"Sort code","x-description-i18n":{"vie":"Mã phân loại"}},"paid_at":{"type":"string","format":"date-time","description":"Paid at","x-description-i18n":{"vie":"Thời điểm thanh toán"}},"system_created":{"type":"boolean","description":"System created","x-description-i18n":{"vie":"Được tạo bởi hệ thống"}},"extend_update":{"type":"array","description":"Update from courier","x-description-i18n":{"vie":"Cập nhật từ đơn vị vận chuyển"},"items":{"type":"object","properties":{"key":{"type":"string","description":"Update key","x-description-i18n":{"vie":"Mã cập nhật"}},"status":{"type":"string","description":"Status","x-description-i18n":{"vie":"Trạng thái"}},"tracking_id":{"type":"string","description":"Partner extend code","x-description-i18n":{"vie":"Mã đơn hàng đối tác"}},"note":{"type":"string","description":"Courier notes","x-description-i18n":{"vie":"Ghi chú từ đơn vị vận chuyển"}},"update_at":{"type":"string","format":"date-time","description":"Updated at","x-description-i18n":{"vie":"Thời điểm cập nhật"}}}}},"partner_status":{"type":"string","nullable":true,"description":"Partner shipping status","x-description-i18n":{"vie":"Trạng thái vận chuyển"},"enum":["waiting","request_received","processing_picked_up","picking_up","delay_pickup","picked_up","waiting_on_the_way","on_the_way","contact_delivery_company","out_for_delivery","delay_delivery","inform_recipient","undeliverable","waiting_for_return","delivered","delivered_cod","returning","returned","returned_cod","canceled"],"x-enum-descriptions":["Waiting for processing","Carrier received the request","Processing pickup","Picking up","Delayed pickup","Picked up","Waiting for transit","In transit","Contact the carrier","Out for delivery","Delayed delivery","Notify the recipient","Undeliverable","Waiting for return","Delivered","Delivered, COD reconciled","Returning","Returned","Returned, COD reconciled","Canceled"],"x-enum-descriptions-i18n":{"vie":["Chờ xử lý","ĐVVC đã tiếp nhận đơn","Đang xử lý lấy hàng","Đang lấy hàng","Trễ lấy hàng","Đã lấy hàng","Chờ trung chuyển","Đang trung chuyển","Liên hệ ĐVVC","Đang giao hàng","Trễ giao hàng","Thông báo cho người nhận","Giao không thành","Chờ chuyển hoàn","Đã giao hàng","Đã giao hàng, đã đối soát COD","Đang chuyển hoàn","Đã chuyển hoàn","Đã chuyển hoàn, đã đối soát COD","Đã hủy vận đơn"]}},"partner_name":{"type":"string","nullable":true,"description":"Partner name","x-description-i18n":{"vie":"Tên đơn vị vận chuyển"}},"first_delivery_at":{"type":"string","format":"date-time","nullable":true,"description":"First delivery time","x-description-i18n":{"vie":"Thời điểm giao hàng lần đầu"}},"first_undeliverable_at":{"type":"string","format":"date-time","nullable":true,"description":"First failed delivery time","x-description-i18n":{"vie":"Thời điểm giao hàng thất bại lần đầu"}},"order_number_vtp":{"type":"string","nullable":true,"description":"Viettel Post tracking number","x-description-i18n":{"vie":"Mã vận đơn Viettel Post"}},"printed_form":{"type":"object","nullable":true,"description":"Printed form","x-description-i18n":{"vie":"Mẫu in"}}}},"shipping_address":{"$ref":"#/components/schemas/ShippingAddress"},"payment_purchase_histories":{"type":"array","description":"Payment histories","x-description-i18n":{"vie":"Lịch sử thanh toán"},"items":{"type":"object","properties":{"amount":{"type":"integer","description":"Amount of money","x-description-i18n":{"vie":"Số tiền"}},"type":{"type":"string","description":"Payment type","x-description-i18n":{"vie":"Loại thanh toán"}},"inserted_at":{"type":"string","format":"date-time","description":"Transaction time","x-description-i18n":{"vie":"Thời điểm giao dịch"}},"result_code":{"type":"string","description":"Result code","x-description-i18n":{"vie":"Mã kết quả"}},"ipn_reply":{"type":"boolean","description":"IPN reply","x-description-i18n":{"vie":"Phản hồi IPN"}},"voucher_amount":{"type":"integer","description":"Voucher amount","x-description-i18n":{"vie":"Số tiền voucher"}},"tags":{"type":"array","description":"Tags","x-description-i18n":{"vie":"Thẻ"},"items":{"type":"string"}}}}},"tags":{"type":"array","description":"Tags list","x-description-i18n":{"vie":"Danh sách thẻ đơn hàng"},"items":{"type":"object","properties":{"id":{"type":"integer","description":"Tag ID","x-description-i18n":{"vie":"Mã thẻ đơn hàng"}},"name":{"type":"string","description":"Tag name","x-description-i18n":{"vie":"Tên thẻ đơn hàng"}}}}},"marketer":{"type":"object","description":"Marketer information","x-description-i18n":{"vie":"Thông tin marketer"},"properties":{"id":{"type":"string","description":"Marketer ID","x-description-i18n":{"vie":"Mã marketer"}},"name":{"type":"string","description":"Marketer name","x-description-i18n":{"vie":"Tên marketer"}},"email":{"type":"string","description":"Marketer email","x-description-i18n":{"vie":"Email marketer"}},"phone_number":{"type":"string","description":"Marketer phone number","x-description-i18n":{"vie":"Số điện thoại marketer"}},"fb_id":{"type":"string","description":"Marketer Facebook ID","x-description-i18n":{"vie":"Facebook ID marketer"}},"avatar_url":{"type":"string","description":"Marketer avatar URL","x-description-i18n":{"vie":"Link avatar marketer"}}}},"pke_mkter":{"type":"string","description":"Marketer ID","x-description-i18n":{"vie":"Mã nhân viên marketer"}},"activated_combo_products":{"type":"object","description":"Activated combo products information","x-description-i18n":{"vie":"Thông tin combo sản phẩm được kích hoạt"},"properties":{"combo_product_id":{"type":"integer","description":"Combo product ID","x-description-i18n":{"vie":"Mã combo sản phẩm"}},"quantity_combo_activated":{"type":"integer","description":"Quantity combo activated","x-description-i18n":{"vie":"Số lượng combo được kích hoạt"}},"combo_product_info":{"type":"object","description":"Combo product information","x-description-i18n":{"vie":"Thông tin combo sản phẩm"}}}},"activated_promotion_advances":{"type":"array","description":"Activated promotion advances information","x-description-i18n":{"vie":"Thông tin khuyến mãi được kích hoạt"},"items":{"type":"object","properties":{"id":{"type":"integer","description":"ID","x-description-i18n":{"vie":"Mã"}},"promotion_advance_id":{"type":"string","description":"Promotion advance ID","x-description-i18n":{"vie":"Mã khuyến mãi"}},"promotion_advance_info":{"type":"object","description":"Promotion advance information","x-description-i18n":{"vie":"Thông tin khuyến mãi"}}}}},"invoice_info_list":{"type":"array","description":"Invoice information list","x-description-i18n":{"vie":"Danh sách thông tin hóa đơn"},"items":{"type":"object","properties":{"error":{"type":"string","description":"Error message if any","x-description-i18n":{"vie":"Thông báo lỗi nếu có"}},"invoice_detail":{"type":"object","description":"Invoice detail information","x-description-i18n":{"vie":"Chi tiết thông tin hóa đơn"},"properties":{"company_address":{"type":"string","description":"Company address","x-description-i18n":{"vie":"Địa chỉ công ty"}},"company_address_breakdown":{"type":"object","description":"Company address breakdown","x-description-i18n":{"vie":"Chi tiết địa chỉ công ty"},"properties":{"company_additional_info":{"type":"string","description":"Company additional information","x-description-i18n":{"vie":"Thông tin bổ sung công ty"}},"company_barangay":{"type":"string","description":"Company barangay","x-description-i18n":{"vie":"Phường/xã công ty"}},"company_city":{"type":"string","description":"Company city","x-description-i18n":{"vie":"Thành phố công ty"}},"company_detailed_address":{"type":"string","description":"Company detailed address","x-description-i18n":{"vie":"Địa chỉ chi tiết công ty"}},"company_district":{"type":"string","description":"Company district","x-description-i18n":{"vie":"Quận/huyện công ty"}},"company_full_address":{"type":"string","description":"Company full address","x-description-i18n":{"vie":"Địa chỉ đầy đủ công ty"}},"company_postcode":{"type":"string","description":"Company postcode","x-description-i18n":{"vie":"Mã bưu điện công ty"}},"company_province":{"type":"string","description":"Company province","x-description-i18n":{"vie":"Tỉnh công ty"}},"company_region":{"type":"string","description":"Company region","x-description-i18n":{"vie":"Vùng/khu vực công ty"}},"company_state":{"type":"string","description":"Company state","x-description-i18n":{"vie":"Bang/tỉnh công ty"}},"company_town":{"type":"string","description":"Company town","x-description-i18n":{"vie":"Thị trấn/phường công ty"}}}},"company_email":{"type":"string","description":"Company email","x-description-i18n":{"vie":"Email công ty"}},"company_name":{"type":"string","description":"Company name","x-description-i18n":{"vie":"Tên công ty"}},"company_tax_id":{"type":"string","description":"Company tax ID","x-description-i18n":{"vie":"Mã số thuế công ty"}}}},"invoice_type":{"type":"string","description":"Invoice type","x-description-i18n":{"vie":"Loại hóa đơn"}},"is_requested":{"type":"boolean","description":"Request for invoice","x-description-i18n":{"vie":"Yêu cầu xuất hóa đơn"}},"order_sn":{"type":"string","description":"Order code on the marketplace","x-description-i18n":{"vie":"Mã đơn hàng trên sàn"}}}}},"reports_by_phone":{"type":"object","description":"Reports by phone number","x-description-i18n":{"vie":"Báo cáo theo số điện thoại"},"properties":{"order_fail":{"type":"integer","description":"Number of failed orders","x-description-i18n":{"vie":"Số đơn thất bại"}},"order_success":{"type":"integer","description":"Number of successful orders","x-description-i18n":{"vie":"Số đơn thành công"}},"warning":{"type":"integer","description":"Number of warnings orders","x-description-i18n":{"vie":"Số đơn cảnh báo"}}},"example":{"+639175706297":{"order_fail":29,"order_success":20,"warning":0}}},"tracking_link":{"type":"string","description":"Link confirm order","x-description-i18n":{"vie":"Link xác nhận đơn hàng"}},"ads_source":{"type":"string","description":"Advertising source","x-description-i18n":{"vie":"Nguồn quảng cáo"}},"bank_payments":{"type":"object","description":"Payment method","x-description-i18n":{"vie":"Phương thức thanh toán"}},"transfer_proofs":{"type":"array","description":"Bank transfer payment proofs, including verification time, amount and receipt images","x-description-i18n":{"vie":"Danh sách chứng từ xác thực chuyển khoản, gồm ngày giờ xác thực, số tiền và ảnh chứng từ"},"items":{"type":"object","properties":{"id":{"type":"integer","description":"Transfer proof ID","x-description-i18n":{"vie":"Mã chứng từ chuyển khoản"}},"order_id":{"type":"integer","description":"Order ID","x-description-i18n":{"vie":"Mã đơn hàng"}},"shop_id":{"type":"integer","description":"Shop ID","x-description-i18n":{"vie":"Mã cửa hàng"}},"payment_id":{"type":"string","description":"Bank payment method ID (matches a key in `bank_payments`)","x-description-i18n":{"vie":"Mã phương thức thanh toán ngân hàng (trùng với key trong `bank_payments`)"}},"amount":{"type":"integer","description":"Transferred amount","x-description-i18n":{"vie":"Số tiền chuyển khoản"}},"images":{"type":"array","description":"Transfer receipt images","x-description-i18n":{"vie":"Danh sách ảnh chứng từ chuyển khoản"},"items":{"type":"string"}},"note":{"type":"string","nullable":true,"description":"Note","x-description-i18n":{"vie":"Ghi chú"}},"is_income":{"type":"boolean","description":"Money received (true) or paid out (false)","x-description-i18n":{"vie":"Là khoản tiền nhận vào (true) hay chi ra (false)"}},"is_verify":{"type":"boolean","description":"Whether the transfer has been verified","x-description-i18n":{"vie":"Chứng từ đã được xác thực hay chưa"}},"verify_at":{"type":"string","format":"date-time","nullable":true,"description":"Verification time","x-description-i18n":{"vie":"Thời điểm xác thực chuyển khoản"}},"verifier":{"type":"object","nullable":true,"description":"Verifier information","x-description-i18n":{"vie":"Thông tin người xác thực"},"properties":{"id":{"type":"string","description":"Verifier ID","x-description-i18n":{"vie":"Mã người xác thực"}},"name":{"type":"string","description":"Verifier name","x-description-i18n":{"vie":"Tên người xác thực"}},"fb_id":{"type":"string","description":"Facebook ID of verifier","x-description-i18n":{"vie":"Facebook ID người xác thực"}},"avatar_url":{"type":"string","description":"Verifier avatar URL","x-description-i18n":{"vie":"Link avatar người xác thực"}}}},"creator":{"type":"object","nullable":true,"description":"Creator information","x-description-i18n":{"vie":"Thông tin người tạo chứng từ"},"properties":{"id":{"type":"string","description":"Creator ID","x-description-i18n":{"vie":"Mã người tạo"}},"name":{"type":"string","description":"Creator name","x-description-i18n":{"vie":"Tên người tạo"}},"fb_id":{"type":"string","description":"Facebook ID of creator","x-description-i18n":{"vie":"Facebook ID người tạo"}},"avatar_url":{"type":"string","description":"Creator avatar URL","x-description-i18n":{"vie":"Link avatar người tạo"}}}},"last_editor":{"type":"object","nullable":true,"description":"Last editor information","x-description-i18n":{"vie":"Thông tin người chỉnh sửa cuối"},"properties":{"id":{"type":"string","description":"Editor ID","x-description-i18n":{"vie":"Mã người chỉnh sửa"}},"name":{"type":"string","description":"Editor name","x-description-i18n":{"vie":"Tên người chỉnh sửa"}},"fb_id":{"type":"string","description":"Facebook ID of editor","x-description-i18n":{"vie":"Facebook ID người chỉnh sửa"}},"avatar_url":{"type":"string","description":"Editor avatar URL","x-description-i18n":{"vie":"Link avatar người chỉnh sửa"}}}},"order_info":{"type":"object","nullable":true,"description":"Additional order information","x-description-i18n":{"vie":"Thông tin đơn hàng bổ sung"}},"inserted_at":{"type":"string","format":"date-time","description":"Transfer proof creation time","x-description-i18n":{"vie":"Thời điểm tạo chứng từ"}},"updated_at":{"type":"string","format":"date-time","description":"Transfer proof update time","x-description-i18n":{"vie":"Thời điểm cập nhật chứng từ"}}}}},"shopify_order_id":{"type":"string","description":"Shopify order ID","x-description-i18n":{"vie":"Mã đơn hàng Shopify"}},"shopify_abandon_checkout_id":{"type":"integer","description":"Shopify abandon checkout ID","x-description-i18n":{"vie":"Mã Shopify abandon checkout"}},"is_abandoned_order":{"type":"boolean","description":"Abandoned-cart flag for creating or updating an order. Send it directly in the request body, not inside `third_party` or `third_party_infomation`.\nAn explicit value, including `false`, takes precedence over automatic detection. If omitted on creation, the flag is determined automatically; if omitted on update, the current value is preserved.\nOnly boolean `true` or string `\"true\"` is normalized to `true`; all other submitted values become `false`.\n","x-description-i18n":{"vie":"Cờ đơn chưa hoàn tất khi tạo hoặc cập nhật đơn. Truyền trực tiếp trong body, không bọc trong `third_party` hoặc `third_party_infomation`.\nGiá trị truyền lên, kể cả `false`, được ưu tiên hơn kết quả nhận diện tự động. Nếu bỏ qua khi tạo đơn, cờ được xác định tự động; nếu bỏ qua khi cập nhật, giữ nguyên giá trị hiện tại.\nChỉ boolean `true` hoặc chuỗi `\"true\"` được chuẩn hóa thành `true`; mọi giá trị khác được gửi lên đều thành `false`.\n"},"example":true},"cod":{"type":"integer","description":"Cash on delivery","x-description-i18n":{"vie":"Tiền thu hộ"}},"cash":{"type":"integer","description":"Cash payment","x-description-i18n":{"vie":"Tiền mặt"}},"account":{"type":"integer","description":"Order source ID","x-description-i18n":{"vie":"Mã nguồn đơn hàng"}},"account_name":{"type":"string","description":"Order source name","x-description-i18n":{"vie":"Tên mã nguồn đơn"}},"advanced_platform_fee":{"type":"object","description":"Fees from e-commerce platforms","x-description-i18n":{"vie":"Phí từ sàn thương mại điện tử"},"properties":{"ads_top_up":{"type":"integer","description":"Ads wallet top-up","x-description-i18n":{"vie":"Ví quảng cáo"}},"affiliate_commission":{"type":"integer","description":"Affiliate commission","x-description-i18n":{"vie":"Phí hoa hồng (Sàn TMĐT)"}},"diff_shipping_fee":{"type":"integer","description":"Difference shipping fee","x-description-i18n":{"vie":"Chênh lệch phí vận chuyển (Sàn TMĐT)"}},"marketplace_voucher":{"type":"integer","description":"Marketplace voucher","x-description-i18n":{"vie":"Sàn trợ giá"}},"payment_fee":{"type":"integer","description":"Payment fee","x-description-i18n":{"vie":"Phí cố định, giao dịch (Sàn TMĐT)"}},"platform_commission":{"type":"integer","description":"Platform commission","x-description-i18n":{"vie":"Phí hoa hồng nền tảng (Sàn TMĐT)"}},"seller_transaction_fee":{"type":"integer","description":"Seller transaction fee","x-description-i18n":{"vie":"Phí thanh toán (Sàn TMĐT)"}},"service_fee":{"type":"integer","description":"Service fee","x-description-i18n":{"vie":"Phí dịch vụ (Sàn TMĐT)"}},"sfp_service_fee":{"type":"integer","description":"SFP service fee","x-description-i18n":{"vie":"Phí dịch vụ SFP (Sàn TMĐT)"}}}},"printing_count":{"type":"integer","description":"Printing count","x-description-i18n":{"vie":"Số lần in"}},"money_to_collect":{"type":"integer","description":"Money to collect","x-description-i18n":{"vie":"Số tiền cần thu"}},"marketplace_id":{"type":"string","description":"Marketplace ID","enum":["-2","-3","-4","-9","-16","-17","-20","-25","-27","-28"],"x-enum-descriptions":{"-2":"Tiki","-3":"Shopee","-4":"Lazada","-9":"TikTok","-16":"WooCommerce","-17":"Shopify","-20":"Line Shopping","-25":"Tokopedia","-27":"Mercado Libre","-28":"Tiendanube"},"x-description-i18n":{"vie":"Mã sàn thương mại điện tử"}},"total_price":{"type":"integer","description":"Total price","x-description-i18n":{"vie":"Tổng giá trị sản phẩm"}},"shop_customer_address_id":{"type":"string","description":"Customer address ID","x-description-i18n":{"vie":"Mã địa chỉ khách hàng"}},"customer":{"type":"object","description":"Customer information","x-description-i18n":{"vie":"Thông tin khách hàng"},"properties":{"fb_id":{"type":"string","description":"Customer Facebook ID","x-description-i18n":{"vie":"Facebook ID khách hàng"}},"id":{"type":"string","description":"Customer ID","x-description-i18n":{"vie":"Mã khách hàng"}},"name":{"type":"string","description":"Customer name","x-description-i18n":{"vie":"Tên khách hàng"}},"page_id":{"type":"string","description":"Page ID","x-description-i18n":{"vie":"Mã trang"}}}},"total_quantity":{"type":"integer","description":"Total quantity","x-description-i18n":{"vie":"Tổng số lượng"}},"time_assign_marketer":{"type":"string","format":"date-time","description":"Time assign marketer","x-description-i18n":{"vie":"Thời điểm phân công marketer"}},"p_utm_source":{"type":"string","description":"UTM Source","x-description-i18n":{"vie":"UTM Source"}},"p_utm_medium":{"type":"string","description":"UTM Medium","x-description-i18n":{"vie":"UTM Medium"}},"p_utm_campaign":{"type":"string","description":"UTM Campaign","x-description-i18n":{"vie":"UTM Campaign"}},"p_utm_term":{"type":"string","description":"UTM Term","x-description-i18n":{"vie":"UTM Term"}},"p_utm_content":{"type":"string","description":"UTM Content","x-description-i18n":{"vie":"UTM Content"}},"p_utm_id":{"type":"string","description":"UTM ID","x-description-i18n":{"vie":"UTM ID"}},"utm_affiliate":{"type":"string","description":"Affiliate","x-description-i18n":{"vie":"Affiliate"}},"link":{"type":"string","description":"Link","x-description-i18n":{"vie":"Link"}},"status_history":{"type":"array","description":"Status update history","x-description-i18n":{"vie":"Lịch sử cập nhật trạng thái"},"items":{"type":"object","properties":{"avatar_url":{"type":"string","description":"Avatar URL","x-description-i18n":{"vie":"Link avatar"}},"editor":{"type":"object","description":"Editor information","x-description-i18n":{"vie":"Thông tin người chỉnh sửa"}},"editor_fb":{"type":"string","description":"Editor Facebook ID","x-description-i18n":{"vie":"Facebook ID người chỉnh sửa"}},"editor_id":{"type":"string","description":"Editor ID","x-description-i18n":{"vie":"Mã người chỉnh sửa"}},"name":{"type":"string","description":"Name","x-description-i18n":{"vie":"Tên"}},"old_status":{"type":"integer","description":"Old status","x-description-i18n":{"vie":"Trạng thái cũ"}},"status":{"type":"integer","description":"Status","x-description-i18n":{"vie":"Trạng thái"}},"updated_at":{"type":"string","format":"date-time","description":"Updated at","x-description-i18n":{"vie":"Thời điểm cập nhật"}}}}},"duplicated_phone":{"type":"boolean","description":"Duplicated phone","x-description-i18n":{"vie":"Số điện thoại trùng lặp"}},"order_currency":{"type":"string","description":"Order currency","x-description-i18n":{"vie":"Loại tiền tệ"}},"charged_by_vnpay":{"type":"integer","description":"Charged by VNPay","x-description-i18n":{"vie":"Số tiền thanh toán qua VNPay"}},"charged_by_qrpay":{"type":"integer","description":"Charged by QRPay","x-description-i18n":{"vie":"Số tiền khách thanh toán qua QRPAY"}},"custom_id":{"type":"string","description":"Custom ID","x-description-i18n":{"vie":"Mã tùy chỉnh"}},"last_editor":{"type":"object","description":"Last editor information","x-description-i18n":{"vie":"Thông tin người chỉnh sửa cuối cùng đơn hàng"},"properties":{"id":{"type":"string","description":"Editor ID","x-description-i18n":{"vie":"Mã người chỉnh sửa"}},"fb_id":{"type":"string","description":"Facebook ID of editor","x-description-i18n":{"vie":"Facebook ID người chỉnh sửa"}},"name":{"type":"string","description":"Editor name","x-description-i18n":{"vie":"Tên người chỉnh sửa"}},"email":{"type":"string","description":"Editor email","x-description-i18n":{"vie":"Email người chỉnh sửa"}},"avatar_url":{"type":"string","description":"Editor avatar URL","x-description-i18n":{"vie":"Link avatar người chỉnh sửa"}},"phone_number":{"type":"string","description":"Editor phone number","x-description-i18n":{"vie":"Số điện thoại người chỉnh sửa"}}}},"last_editor_id":{"type":"string","description":"Last editor ID","x-description-i18n":{"vie":"Mã người sửa cuối"}},"charged_by_momo":{"type":"integer","description":"Charged by MoMo","x-description-i18n":{"vie":"Số tiền khách thanh toán qua MOMO"}},"prepaid_by_point":{"type":"object","description":"Prepaid by point","x-description-i18n":{"vie":"Thanh toán bằng điểm thưởng"},"properties":{"money":{"type":"integer","description":"Money amount","x-description-i18n":{"vie":"Số tiền"},"example":15000},"point":{"type":"integer","description":"Point amount","x-description-i18n":{"vie":"Số điểm"},"example":15}},"example":{"money":15000,"point":15}},"bank_transfer_images":{"type":"array","description":"Bank transfer images","x-description-i18n":{"vie":"Hình ảnh chuyển khoản"},"items":{"type":"string","format":"uri"}},"transfer_money":{"type":"integer","description":"Transfer money","x-description-i18n":{"vie":"Số tiền khách chuyển khoản"}},"lock_order_by_user":{"type":"string","description":"Lock order by user ID","x-description-i18n":{"vie":"Mã người dùng khóa đơn hàng"}},"assigning_care":{"type":"object","description":"Assigning care information","x-description-i18n":{"vie":"Nhân viên chăm sóc"},"properties":{"id":{"type":"string","description":"Care ID","x-description-i18n":{"vie":"Mã người chăm sóc"}},"fb_id":{"type":"string","description":"Facebook ID of care","x-description-i18n":{"vie":"Facebook ID người chăm sóc"}},"name":{"type":"string","description":"Care name","x-description-i18n":{"vie":"Tên người chăm sóc"}},"email":{"type":"string","description":"Care email","x-description-i18n":{"vie":"Email người chăm sóc"}},"avatar_url":{"type":"string","description":"Care avatar URL","x-description-i18n":{"vie":"Link avatar người chăm sóc"}},"phone_number":{"type":"string","description":"Care phone number","x-description-i18n":{"vie":"Số điện thoại người chăm sóc"}}}},"assigning_care_id":{"type":"string","description":"Assigning care ID","x-description-i18n":{"vie":"Mã nhân viên chăm sóc"}},"time_assign_care":{"type":"string","format":"date-time","description":"Time assign care","x-description-i18n":{"vie":"Thời điểm phân công chăm sóc"}},"assigning_seller":{"type":"object","description":"Assigning seller information","x-description-i18n":{"vie":"Nhân viên được phân công"},"properties":{"id":{"type":"string","description":"Seller ID","x-description-i18n":{"vie":"Mã người bán"}},"fb_id":{"type":"string","description":"Facebook ID of seller","x-description-i18n":{"vie":"Facebook ID người bán"}},"name":{"type":"string","description":"Seller name","x-description-i18n":{"vie":"Tên người bán"}},"email":{"type":"string","description":"Seller email","x-description-i18n":{"vie":"Email người bán"}},"avatar_url":{"type":"string","description":"Seller avatar URL","x-description-i18n":{"vie":"Link avatar người bán"}},"phone_number":{"type":"string","description":"Seller phone number","x-description-i18n":{"vie":"Số điện thoại người bán"}}}},"einvoices":{"type":"array","items":{"$ref":"#/components/schemas/EInvoice"}},"charged_by_card":{"type":"integer","description":"Charged by card","x-description-i18n":{"vie":"Số tiền khách quẹt thẻ"}},"estimate_delivery_date":{"type":"string","format":"date-time","description":"Estimate delivery date","x-description-i18n":{"vie":"Ngày giao hàng dự kiến"}},"order_sources":{"type":"string","description":"Order sources ID","x-description-i18n":{"vie":"Mã nguồn đơn hàng"}},"charged_by_fundiin":{"type":"integer","description":"Charged by Fundiin","x-description-i18n":{"vie":"Số tiền thanh toán qua Fundiin"}},"surcharge":{"type":"integer","description":"Surcharge","x-description-i18n":{"vie":"Phụ thu"}},"is_linked_partner":{"type":"boolean","description":"Is linked partner","x-description-i18n":{"vie":"Đã liên kết đối tác"}},"call_laters":{"type":"array","description":"Call laters","x-description-i18n":{"vie":"Gọi lại sau"},"items":{"type":"object"}},"last_update_status_at":{"type":"string","format":"date-time","description":"Last update status at","x-description-i18n":{"vie":"Thời điểm cập nhật trạng thái cuối"}},"discount_by_customer_level":{"type":"integer","description":"Discount by customer level","x-description-i18n":{"vie":"Giảm giá theo cấp độ khách hàng"}},"viewing":{"type":"array","description":"Viewing","x-description-i18n":{"vie":"NV đang xem"},"items":{"type":"object"}},"additional_info":{"type":"object","description":"Additional info","x-description-i18n":{"vie":"Thông tin bổ sung"},"properties":{"service_partner":{"type":"string","description":"Service partner","x-description-i18n":{"vie":"Dịch vụ vận chuyển"},"enum":["instant"],"x-enum-descriptions":["Instant"],"x-enum-descriptions-i18n":{"vie":["Hỏa tốc"]}},"delivery_deadline":{"type":"string","format":"date-time","description":"Delivery deadline (ISO8601, no timezone). Send null to clear.","x-description-i18n":{"vie":"Hạn giao hàng (ISO8601, không kèm timezone). Gửi null để xóa."},"example":"2026-06-03T10:00:00"}}},"order_returned_ids":{"type":"string","description":"Order returned IDs","x-description-i18n":{"vie":"Mã đơn hàng đổi trả"}},"cost_surcharge":{"type":"integer","description":"Cost surcharge","x-description-i18n":{"vie":"Phụ phí"}},"time_send_partner":{"type":"string","format":"date-time","description":"Time send partner","x-description-i18n":{"vie":"Thời điểm gửi đơn vị vận chuyển"}},"charged_by_kredivo":{"type":"integer","description":"Charged by Kredivo","x-description-i18n":{"vie":"Số tiền thanh toán qua Kredivo"}},"discount":{"type":"integer","description":"Discount","x-description-i18n":{"vie":"Giảm giá"}},"histories":{"type":"array","description":"Histories","x-description-i18n":{"vie":"Lịch sử"},"items":{"type":"object"}},"duplicated_customer":{"type":"boolean","description":"Duplicated customer","x-description-i18n":{"vie":"Khách hàng trùng lặp"}},"customer_referral_code":{"type":"object","description":"Customer referral code","x-description-i18n":{"vie":"Mã giới thiệu khách hàng"},"properties":{"active":{"type":"string","description":"Active status","x-description-i18n":{"vie":"Trạng thái kích hoạt"},"example":"true"},"customer_id":{"type":"string","format":"uuid","description":"Customer ID","x-description-i18n":{"vie":"Mã khách hàng"},"example":"09bb9399-45f3-4897-a53a-85dde2f886fe"},"discount":{"type":"string","description":"Discount value","x-description-i18n":{"vie":"Giá trị giảm giá"},"example":"10"},"format":{"type":"string","description":"Referral code format","x-description-i18n":{"vie":"Định dạng mã giới thiệu"},"example":"{PHONE_NUMBER}"},"free_products_priced_between_approx":{"type":"object","description":"Free products priced between approximately","x-description-i18n":{"vie":"Miễn phí cho khách mới sản phẩm có giá"},"properties":{"active":{"type":"string","description":"Active status","x-description-i18n":{"vie":"Trạng thái kích hoạt"},"example":"true"},"operator":{"type":"string","description":"Comparison operator","x-description-i18n":{"vie":"Toán tử so sánh"},"example":"GreaterOrEqual"},"price":{"type":"string","description":"Price threshold","x-description-i18n":{"vie":"Ngưỡng giá"},"example":"150000"}}},"is_percent":{"type":"string","description":"Discount is percentage","x-description-i18n":{"vie":"Giảm giá theo phần trăm"},"example":"true"},"only_customers_with_level_will_have_referral_code":{"type":"string","description":"Only customers with level will have referral code","x-description-i18n":{"vie":"Chỉ khách hàng có cấp độ mới có mã giới thiệu"},"example":"true"},"referral_code":{"type":"string","description":"Referral code","x-description-i18n":{"vie":"Mã giới thiệu"},"example":"982843759"},"reward_points_for_old_customers":{"type":"object","description":"Reward points for customers","x-description-i18n":{"vie":"Điểm thưởng khách hàng"},"properties":{"active":{"type":"string","description":"Active status","x-description-i18n":{"vie":"Trạng thái kích hoạt"},"example":"true"},"money":{"type":"string","description":"Money reward","x-description-i18n":{"vie":"Tiền thưởng"},"example":"10000"},"point":{"type":"string","description":"Point reward","x-description-i18n":{"vie":"Điểm thưởng"},"example":"1"}}},"shop_customer_id":{"type":"string","format":"uuid","description":"Shop customer ID","x-description-i18n":{"vie":"Mã khách hàng shop"},"example":"f8160a4c-dfa7-4ee8-b540-d245755ea1f1"}},"example":{"active":"true","customer_id":"09bb9399-45f3-4897-a53a-85dde2f886fe","discount":"10","format":"{PHONE_NUMBER}","free_products_priced_between_approx":{"active":"true","operator":"GreaterOrEqual","price":"150000"},"is_percent":"true","only_customers_with_level_will_have_referral_code":"true","referral_code":"982843759","reward_points_for_old_customers":{"active":"true","money":"10000","point":"1"},"shop_customer_id":"f8160a4c-dfa7-4ee8-b540-d245755ea1f1"}},"tax":{"type":"integer","description":"Tax","x-description-i18n":{"vie":"Thuế"}},"is_from_ecommerce":{"type":"boolean","description":"Is from e-commerce","x-description-i18n":{"vie":"Đơn hàng từ sàn thương mại điện tử"}},"note_image":{"type":"array","description":"Note images","x-description-i18n":{"vie":"Link hình ảnh ghi chú"},"items":{"type":"string","format":"uri"}},"shopify_draft_order_id":{"type":"string","description":"Shopify draft order ID","x-description-i18n":{"vie":"Mã đơn hàng nháp Shopify"}},"display_id":{"type":"integer","description":"Display ID","x-description-i18n":{"vie":"Mã hiển thị"}},"shop_partner_id":{"type":"integer","description":"Shop partner ID","x-description-i18n":{"vie":"Mã đối tác shop"}},"is_locked":{"type":"boolean","description":"Order lock","x-description-i18n":{"vie":"Khóa đơn hàng"}},"merge_order":{"type":"boolean","description":"Allows merging orders","x-description-i18n":{"vie":"Cho phép gộp đơn"}}}},"examples":{"default":{"$ref":"#/components/examples/OrderBasic"}}}}}}}},"/shops/{SHOP_ID}/bank_payments":{"get":{"summary":"List of payment methods","x-summary-i18n":{"vie":"Danh sách phương thức thanh toán"},"description":"Get list of payment methods","x-description-i18n":{"vie":"Lấy danh sách phương thức thanh toán"},"tags":["Order"],"x-tags-i18n":{"vie":["Đơn hàng"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","description":"Payment methods list","x-description-i18n":{"vie":"Danh sách phương thức thanh toán"},"properties":{"data":{"type":"array","description":"List of payment methods","x-description-i18n":{"vie":"Danh sách phương thức thanh toán"},"items":{"type":"object","properties":{"id":{"type":"string","description":"Payment method ID","x-description-i18n":{"vie":"Mã phương thức thanh toán"}},"name":{"type":"string","description":"Payment method name","x-description-i18n":{"vie":"Tên phương thức thanh toán"}},"creator_id":{"type":"string","description":"Creator ID","x-description-i18n":{"vie":"Mã người tạo"}},"shop_id":{"type":"integer","description":"Shop ID","x-description-i18n":{"vie":"Mã cửa hàng"}},"inserted_at":{"type":"string","format":"date-time","description":"Created at","x-description-i18n":{"vie":"Thời điểm tạo"}},"updated_at":{"type":"string","format":"date-time","description":"Updated at","x-description-i18n":{"vie":"Thời điểm cập nhật"}}}}},"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}}}},"examples":{"default":{"value":{"data":[{"id":"e01fed02-8680-4102-bdf4-343a7e1a00f5","creator_id":"cee3c05e-5f85-43c4-b27e-889b99c50097","name":"Tiền cọc","shop_id":224,"inserted_at":"2025-08-19T02:25:37","updated_at":"2025-08-19T02:25:37"}],"success":true}}}}}}}}},"/shops/{SHOP_ID}/orders_returned":{"get":{"summary":"List of return orders","x-summary-i18n":{"vie":"Danh sách đơn hàng đổi trả"},"description":"Get list of return orders","x-description-i18n":{"vie":"Lấy danh sách đơn hàng đổi trả"},"tags":["Order"],"x-tags-i18n":{"vie":["Đơn hàng"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"example":1},"description":"Page number","x-description-i18n":{"vie":"Số trang"},"example":1},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","default":30,"example":30},"description":"Page size","x-description-i18n":{"vie":"Kích thước trang"},"example":30},{"name":"status","in":"query","required":false,"schema":{"type":"integer","default":-1,"example":-1},"description":"Order status","x-description-i18n":{"vie":"Trạng thái đơn hàng"},"example":-1},{"name":"update_status","in":"query","required":false,"schema":{"type":"string","default":"inserted_at","enum":["inserted_at","updated_at","0","2","1","4"],"x-enum-descriptions":["Order creation time","Last update time","New","Shipped","Completed","Canceled"],"x-enum-descriptions-i18n":{"vie":["Thời điểm tạo đơn","Thời điểm cập nhật cuối","Mới","Đã gửi hàng","Đã nhận","Đã hủy"]},"example":"inserted_at"},"description":"Filter orders by time","x-description-i18n":{"vie":"Lọc đơn hàng theo thời gian"},"x-enum-descriptions-i18n":{"vie":["Thời điểm tạo đơn","Thời điểm cập nhật cuối","Mới","Đã gửi hàng","Đã nhận","Đã hủy"]}},{"name":"start_time","in":"query","required":false,"schema":{"type":"integer"},"description":"Start date (unix timestamp)","x-description-i18n":{"vie":"Ngày bắt đầu (unix timestamp)"},"example":1699635600},{"name":"end_time","in":"query","required":false,"schema":{"type":"integer"},"description":"End date (unix timestamp)","x-description-i18n":{"vie":"Ngày kết thúc (unix timestamp)"},"example":1699635600}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","description":"Return orders list","x-description-i18n":{"vie":"Danh sách đơn hàng đổi trả"},"properties":{"data":{"type":"array","description":"List of return orders","x-description-i18n":{"vie":"Danh sách đơn hàng đổi trả"},"items":{"$ref":"#/components/schemas/ReturnOrder"}},"page_number":{"type":"integer","description":"Page number","x-description-i18n":{"vie":"Số trang"}},"page_size":{"type":"integer","description":"Page size","x-description-i18n":{"vie":"Kích thước trang"}},"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}},"total_entries":{"type":"integer","description":"Total entries","x-description-i18n":{"vie":"Tổng số bản ghi"}}}},"examples":{"default":{"value":{"success":true,"data":[{"id":1,"display_id":1,"bill_full_name":"Hoang Anh","bill_phone_number":"0999999999","creator_id":"8fbe2a6f-b0b2-4227-a698-19d18c43f7c8","custom_id":null,"discount":1,"discount_from_order_to_returned":1,"inserted_at":"2024-01-01T00:00:00Z","updated_at":"2024-01-01T00:00:00Z","order_id":1,"order_id_to_returned":1,"order":{"id":1,"system_id":1,"shop_id":1,"inserted_at":"2024-01-01T00:00:00Z","updated_at":"2024-01-01T00:00:00Z","status":1,"status_name":"Đã xác nhận","bill_full_name":"Hoang Anh","bill_phone_number":"0999999999","bill_email":"hoang@example.com","page_id":"104438181227821","post_id":"185187094667903_477083092110915","ad_id":"23851252560290199","shipping_fee":1,"partner_fee":1,"fee_marketplace":1,"customer_pay_fee":true,"is_free_shipping":true,"is_livestream":true,"is_live_shopping":true,"is_smc":true,"received_at_shop":true,"total_discount":1,"note":"","note_print":null,"returned_reason":1,"returned_reason_name":"Do khách hàng","sub_status":1,"warehouse_id":"b4cb5897-6e56-4581-96cc-2f12677c7bd8","warehouse_info":{"name":"kho test ecod","phone_number":"0999999999","full_address":"hâhhha, Xã Bình Trung, Huyện Châu Đức, Bà Rịa-Vũng Tàu","address":"hâhhha","province_id":"717","district_id":"71705","commune_id":"7170510","affiliate_id":null,"ffm_id":null,"has_snappy_service":true,"custom_id":null},"creator_id":"8fbe2a6f-b0b2-4227-a698-19d18c43f7c8","creator":{"id":"8fbe2a6f-b0b2-4227-a698-19d18c43f7c8","fb_id":"2042723249341651","name":"Hoang Anh","avatar_url":null},"items":[{"id":1,"product_id":"3487e126-b0d9-4dae-89a9-ee60bef2f4e9","variation_id":"415040f4-ab63-465e-8699-e9ebfff4c6c7","quantity":1,"returned_count":1,"assigning_seller_id":"340644fc-314d-450e-a45f-33343678cab6","quantity_by_combo_products":[],"discount_each_product":1,"is_bonus_product":true,"is_discount_percent":true,"is_wholesale":true,"is_composite":true,"one_time_product":true,"note":"","note_product":"","inserted_at":"2024-01-01T00:00:00Z","measure_group_id":1,"variation_info":{"id":"415040f4-ab63-465e-8699-e9ebfff4c6c7","name":"Ao so mi nam","product_id":"3487e126-b0d9-4dae-89a9-ee60bef2f4e9","retail_price":140000,"detail":"","images":["https://statics.pancake.vn/user-content.pancake.vn/2021/8/5/fccd6.jpg"],"fields":[{"id":"field-id-1","name":"Màu","value":"Trắng","keyValue":"Màu"}],"barcode":"BARCODE123","brand_id":null,"category_ids":[1290021044],"display_id":"13109","product_display_id":"a131092025","last_imported_price":30000,"weight":0,"measure_info":{"measure_id":1,"exchange_value":1},"avg_price":30000},"components":[{"component_id":"3487e126-b0d9-4dae-89a9-ee60bef2f4e9","quantity":1,"variation_id":"415040f4-ab63-465e-8699-e9ebfff4c6c7"}]}],"partner":{"partner_id":1,"cod":0,"extend_code":"S58824.MB25.C3.500020713","total_fee":0,"updated_at":"2020-05-12T05:18:16","delivery_name":null,"delivery_tel":null,"picked_up_at":null,"sort_code":null,"paid_at":null,"system_created":true,"extend_update":[{"key":"status","status":"delivered","tracking_id":"S58824.MB25.C3.500020713","note":"","update_at":"2020-05-12T05:18:16"}]},"shipping_address":{"full_name":"Hoang Anh","phone_number":"0999999999","address":"90 Cầu Giấy","full_address":"90 Cầu Giấy, Phường Dịch Vọng, Quận Cầu Giấy, Hà Nội","province_id":"101","district_id":"10113","commune_id":"1011309","commnue_name":"Phường Dịch Vọng","district_name":"Quận Cầu Giấy","province_name":"Hà Nội","country_code":"84","post_code":null},"payment_purchase_histories":[{"amount":1800000,"type":"cash","inserted_at":"2024-01-01T00:00:00Z","result_code":"00","ipn_reply":true,"voucher_amount":0,"tags":["payment"]}],"tags":[{"id":75,"name":"thẻ 4"}],"marketer":{"id":"cee3c05e-5f85-43c4-b27e-889b99c50097","name":"Marketer Name","email":"marketer@example.com","phone_number":"0999999999","fb_id":"2042723249341651","avatar_url":null},"pke_mkter":"cee3c05e-5f85-43c4-b27e-889b99c50097","activated_combo_products":{"combo_product_id":1,"quantity_combo_activated":1},"activated_promotion_advances":[{"id":1,"promotion_advance_id":"fb056b32-9cf6-4c5a-92de-0eb94db71121"}],"tracking_link":"https://tracking.example.com","ads_source":null,"shopify_order_id":null,"shopify_abandon_checkout_id":1,"is_abandoned_order":true,"cod":0,"cash":0,"account":1,"account_name":"facebook321","advanced_platform_fee":{"ads_top_up":1,"affiliate_commission":1,"diff_shipping_fee":1,"marketplace_voucher":1,"payment_fee":1,"platform_commission":1,"seller_transaction_fee":1,"service_fee":1,"sfp_service_fee":1},"printing_count":1,"money_to_collect":1,"total_price":1,"shop_customer_address_id":"0fefd213-7d0c-4d5b-bdbf-35694da80857","customer":{"fb_id":null,"id":"96a8e283-3fba-492e-a35a-970f72a30a02","name":"Trần Văn Hoàng","page_id":"104438181227821"},"total_quantity":1,"time_assign_marketer":"2024-01-01T00:00:00Z","status_history":[{"avatar_url":null,"editor_fb":"2042723249341651","editor_id":"8fbe2a6f-b0b2-4227-a698-19d18c43f7c8","name":"Hoang Anh","old_status":0,"status":1,"updated_at":"2024-01-01T00:00:00Z"}],"duplicated_phone":true,"order_currency":"VND","charged_by_vnpay":1,"charged_by_qrpay":1,"custom_id":null,"last_editor":{"id":"8fbe2a6f-b0b2-4227-a698-19d18c43f7c8","fb_id":"2042723249341651","name":"Hoang Anh","email":"hoang@example.com","avatar_url":null,"phone_number":"0999999999"},"last_editor_id":"8fbe2a6f-b0b2-4227-a698-19d18c43f7c8","charged_by_momo":1,"bank_transfer_images":["https://statics.pancake.vn/user-content.pancake.vn/2021/8/5/fccd6.jpg"],"transfer_money":1,"lock_order_by_user":null,"assigning_care":{"id":"cee3c05e-5f85-43c4-b27e-889b99c50097","fb_id":"2042723249341651","name":"Care Name","email":"care@example.com","avatar_url":null,"phone_number":"0999999999"},"assigning_care_id":"cee3c05e-5f85-43c4-b27e-889b99c50097","time_assign_care":"2024-01-01T00:00:00Z","assigning_seller":{"id":"340644fc-314d-450e-a45f-33343678cab6","fb_id":"2042723249341651","name":"Seller Name","email":"seller@example.com","avatar_url":null,"phone_number":"0999999999"},"einvoices":[],"charged_by_card":1,"estimate_delivery_date":"2024-01-01T00:00:00Z","order_sources":"-1","charged_by_fundiin":1,"surcharge":1,"is_linked_partner":true,"call_laters":[],"last_update_status_at":"2024-01-01T00:00:00Z","discount_by_customer_level":1,"viewing":[],"order_returned_ids":null,"cost_surcharge":1,"time_send_partner":"2024-01-01T00:00:00Z","charged_by_kredivo":1,"discount":1,"histories":[],"duplicated_customer":true,"tax":1,"is_from_ecommerce":true,"note_image":["https://statics.pancake.vn/user-content.pancake.vn/2021/8/5/fccd6.jpg"],"shopify_draft_order_id":null,"display_id":1,"shop_partner_id":1,"is_locked":true},"order_to_returned":{"id":1,"system_id":1,"shop_id":1,"inserted_at":"2024-01-01T00:00:00Z","updated_at":"2024-01-01T00:00:00Z","status":1,"status_name":"Đã xác nhận","bill_full_name":"Hoang Anh","bill_phone_number":"0999999999","bill_email":"hoang@example.com","page_id":"104438181227821","post_id":"185187094667903_477083092110915","ad_id":"23851252560290199","shipping_fee":1,"partner_fee":1,"fee_marketplace":1,"customer_pay_fee":true,"is_free_shipping":true,"is_livestream":true,"is_live_shopping":true,"is_smc":true,"received_at_shop":true,"total_discount":1,"note":"","note_print":null,"returned_reason":1,"returned_reason_name":"Do khách hàng","sub_status":1,"warehouse_id":"b4cb5897-6e56-4581-96cc-2f12677c7bd8","warehouse_info":{"name":"kho test ecod","phone_number":"0999999999","full_address":"hâhhha, Xã Bình Trung, Huyện Châu Đức, Bà Rịa-Vũng Tàu","address":"hâhhha","province_id":"717","district_id":"71705","commune_id":"7170510","affiliate_id":null,"ffm_id":null,"has_snappy_service":true,"custom_id":null},"creator_id":"8fbe2a6f-b0b2-4227-a698-19d18c43f7c8","creator":{"id":"8fbe2a6f-b0b2-4227-a698-19d18c43f7c8","fb_id":"2042723249341651","name":"Hoang Anh","avatar_url":null},"items":[{"id":1,"product_id":"3487e126-b0d9-4dae-89a9-ee60bef2f4e9","variation_id":"415040f4-ab63-465e-8699-e9ebfff4c6c7","quantity":1,"returned_count":1,"assigning_seller_id":"340644fc-314d-450e-a45f-33343678cab6","quantity_by_combo_products":[],"discount_each_product":1,"is_bonus_product":true,"is_discount_percent":true,"is_wholesale":true,"is_composite":true,"one_time_product":true,"note":"","note_product":"","inserted_at":"2024-01-01T00:00:00Z","measure_group_id":1,"variation_info":{"id":"415040f4-ab63-465e-8699-e9ebfff4c6c7","name":"Ao so mi nam","product_id":"3487e126-b0d9-4dae-89a9-ee60bef2f4e9","retail_price":140000,"detail":"","images":["https://statics.pancake.vn/user-content.pancake.vn/2021/8/5/fccd6.jpg"],"fields":[{"id":"field-id-1","name":"Màu","value":"Trắng","keyValue":"Màu"}],"barcode":"BARCODE123","brand_id":null,"category_ids":[1290021044],"display_id":"13109","product_display_id":"a131092025","last_imported_price":30000,"weight":0,"measure_info":{"measure_id":1,"exchange_value":1},"avg_price":30000},"components":[{"component_id":"3487e126-b0d9-4dae-89a9-ee60bef2f4e9","quantity":1,"variation_id":"415040f4-ab63-465e-8699-e9ebfff4c6c7"}]}],"partner":{"partner_id":1,"cod":0,"extend_code":"S58824.MB25.C3.500020713","total_fee":0,"updated_at":"2020-05-12T05:18:16","delivery_name":null,"delivery_tel":null,"picked_up_at":null,"sort_code":null,"paid_at":null,"system_created":true,"extend_update":[{"key":"status","status":"delivered","tracking_id":"S58824.MB25.C3.500020713","note":"","update_at":"2020-05-12T05:18:16"}]},"shipping_address":{"full_name":"Hoang Anh","phone_number":"0999999999","address":"90 Cầu Giấy","full_address":"90 Cầu Giấy, Phường Dịch Vọng, Quận Cầu Giấy, Hà Nội","province_id":"101","district_id":"10113","commune_id":"1011309","commnue_name":"Phường Dịch Vọng","district_name":"Quận Cầu Giấy","province_name":"Hà Nội","country_code":"84","post_code":null},"payment_purchase_histories":[{"amount":1800000,"type":"cash","inserted_at":"2024-01-01T00:00:00Z","result_code":"00","ipn_reply":true,"voucher_amount":0,"tags":["payment"]}],"tags":[{"id":75,"name":"thẻ 4"}],"marketer":{"id":"cee3c05e-5f85-43c4-b27e-889b99c50097","name":"Marketer Name","email":"marketer@example.com","phone_number":"0999999999","fb_id":"2042723249341651","avatar_url":null},"pke_mkter":"cee3c05e-5f85-43c4-b27e-889b99c50097","activated_combo_products":{"combo_product_id":1,"quantity_combo_activated":1},"activated_promotion_advances":[{"id":1,"promotion_advance_id":"fb056b32-9cf6-4c5a-92de-0eb94db71121"}],"tracking_link":"https://tracking.example.com","ads_source":null,"shopify_order_id":null,"shopify_abandon_checkout_id":1,"is_abandoned_order":true,"cod":0,"cash":0,"account":1,"account_name":"facebook321","advanced_platform_fee":{"ads_top_up":1,"affiliate_commission":1,"diff_shipping_fee":1,"marketplace_voucher":1,"payment_fee":1,"platform_commission":1,"seller_transaction_fee":1,"service_fee":1,"sfp_service_fee":1},"printing_count":1,"money_to_collect":1,"total_price":1,"shop_customer_address_id":"0fefd213-7d0c-4d5b-bdbf-35694da80857","customer":{"fb_id":null,"id":"96a8e283-3fba-492e-a35a-970f72a30a02","name":"Trần Văn Hoàng","page_id":"104438181227821"},"total_quantity":1,"time_assign_marketer":"2024-01-01T00:00:00Z","status_history":[{"avatar_url":null,"editor_fb":"2042723249341651","editor_id":"8fbe2a6f-b0b2-4227-a698-19d18c43f7c8","name":"Hoang Anh","old_status":0,"status":1,"updated_at":"2024-01-01T00:00:00Z"}],"duplicated_phone":true,"order_currency":"VND","charged_by_vnpay":1,"charged_by_qrpay":1,"custom_id":null,"last_editor":{"id":"8fbe2a6f-b0b2-4227-a698-19d18c43f7c8","fb_id":"2042723249341651","name":"Hoang Anh","email":"hoang@example.com","avatar_url":null,"phone_number":"0999999999"},"last_editor_id":"8fbe2a6f-b0b2-4227-a698-19d18c43f7c8","charged_by_momo":1,"bank_transfer_images":["https://statics.pancake.vn/user-content.pancake.vn/2021/8/5/fccd6.jpg"],"transfer_money":1,"lock_order_by_user":null,"assigning_care":{"id":"cee3c05e-5f85-43c4-b27e-889b99c50097","fb_id":"2042723249341651","name":"Care Name","email":"care@example.com","avatar_url":null,"phone_number":"0999999999"},"assigning_care_id":"cee3c05e-5f85-43c4-b27e-889b99c50097","time_assign_care":"2024-01-01T00:00:00Z","assigning_seller":{"id":"340644fc-314d-450e-a45f-33343678cab6","fb_id":"2042723249341651","name":"Seller Name","email":"seller@example.com","avatar_url":null,"phone_number":"0999999999"},"einvoices":[],"charged_by_card":1,"estimate_delivery_date":"2024-01-01T00:00:00Z","order_sources":"-1","charged_by_fundiin":1,"surcharge":1,"is_linked_partner":true,"call_laters":[],"last_update_status_at":"2024-01-01T00:00:00Z","discount_by_customer_level":1,"viewing":[],"order_returned_ids":null,"cost_surcharge":1,"time_send_partner":"2024-01-01T00:00:00Z","charged_by_kredivo":1,"discount":1,"histories":[],"duplicated_customer":true,"tax":1,"is_from_ecommerce":true,"note_image":["https://statics.pancake.vn/user-content.pancake.vn/2021/8/5/fccd6.jpg"],"shopify_draft_order_id":null,"display_id":1,"shop_partner_id":1,"is_locked":true},"returned_items":[{"id":1,"product_id":"3487e126-b0d9-4dae-89a9-ee60bef2f4e9","variation_id":"415040f4-ab63-465e-8699-e9ebfff4c6c7","returned_quantity":1,"discount_each_product":1,"is_discount_percent":true}],"returned_fee":1,"shop_customer_id":"96a8e283-3fba-492e-a35a-970f72a30a02","shop_id":1,"status":1,"status_histories":[{"id":1,"editor_id":"8fbe2a6f-b0b2-4227-a698-19d18c43f7c8","old_status":0,"status":1,"inserted_at":"2024-01-01T00:00:00Z","updated_at":"2024-01-01T00:00:00Z"}],"tags":[1],"warehouse_id":"b4cb5897-6e56-4581-96cc-2f12677c7bd8"}]}}}}}}}},"post":{"summary":"Create return order","x-summary-i18n":{"vie":"Tạo đơn đổi trả"},"description":"Create return order","x-description-i18n":{"vie":"Tạo đơn đổi trả"},"tags":["Order"],"x-tags-i18n":{"vie":["Đơn hàng"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}}],"requestBody":{"required":true,"description":"Request body containing return order information","x-description-i18n":{"vie":"Thông tin yêu cầu chứa thông tin đơn đổi trả"},"content":{"application/json":{"schema":{"type":"object","required":["order_additional","returned_items","status","warehouse_id"],"properties":{"discount_from_order_to_returned":{"type":"integer","default":0,"description":"Discount from order to returned","x-description-i18n":{"vie":"Giảm giá từ đơn hàng đến đơn đổi trả"}},"order_additional":{"type":"object","description":"Exchange order information","x-description-i18n":{"vie":"Thông tin đơn đổi"},"required":["items","warehouse_id"],"properties":{"bill_email":{"type":"string","description":"Customer email","x-description-i18n":{"vie":"Email khách hàng"}},"bill_full_name":{"type":"string","description":"Customer name","x-description-i18n":{"vie":"Tên khách hàng"}},"bill_phone_number":{"type":"string","description":"Phone number of customer","x-description-i18n":{"vie":"SĐT khách hàng"}},"cash":{"type":"integer","default":0,"description":"Cash payment","x-description-i18n":{"vie":"Tiền mặt"}},"discount":{"type":"integer","default":0,"description":"Discount total","x-description-i18n":{"vie":"Tổng tiền giảm giá"}},"items":{"type":"array","description":"List of products in exchange order","x-description-i18n":{"vie":"Danh sách sản phẩm trong đơn đổi"},"items":{"type":"object","required":["product_id","variation_id","returned_quantity","variation_info"],"properties":{"discount_each_product":{"type":"integer","default":0,"description":"Discount for each product","x-description-i18n":{"vie":"Giảm giá cho từng sản phẩm"}},"product_id":{"type":"string","description":"Product ID","x-description-i18n":{"vie":"Mã sản phẩm"}},"quantity":{"type":"integer","default":1,"description":"Quantity","x-description-i18n":{"vie":"Số lượng"}},"returned_quantity":{"type":"integer","description":"Returned quantity","x-description-i18n":{"vie":"Số lượng trả"}},"variation_id":{"type":"string","description":"Variation ID","x-description-i18n":{"vie":"Mã biến thể"}},"variation_info":{"type":"object","description":"Variation information","x-description-i18n":{"vie":"Thông tin biến thể"},"required":["name","retail_price"],"properties":{"detail":{"type":"string","description":"Variation detail","x-description-i18n":{"vie":"Chi tiết biến thể"}},"fields":{"type":"array","description":"Variation fields","x-description-i18n":{"vie":"Các trường biến thể"},"items":{"type":"object","properties":{"id":{"type":"string","description":"Field ID"},"keyValue":{"type":"string","description":"Key value"},"name":{"type":"string","description":"Field name"},"value":{"type":"string","description":"Field value"}}}},"images":{"type":"array","description":"Variation images","x-description-i18n":{"vie":"Hình ảnh biến thể"},"items":{"type":"string","format":"uri"}},"name":{"type":"string","description":"Product name","x-description-i18n":{"vie":"Tên sản phẩm"}},"retail_price":{"type":"integer","description":"Retail price","x-description-i18n":{"vie":"Giá bán lẻ"}},"weight":{"type":"integer","description":"Weight","x-description-i18n":{"vie":"Trọng lượng"}}}}}}},"note":{"type":"string","description":"Internal note","x-description-i18n":{"vie":"Ghi chú nội bộ"}},"note_print":{"type":"string","description":"Note for printing","x-description-i18n":{"vie":"Ghi chú in"}},"order_currency":{"type":"string","description":"Order currency","x-description-i18n":{"vie":"Tiền tệ đơn hàng"}},"payment_from_customers_exchange_order":{"type":"integer","default":0,"description":"Payment from customers exchange order","x-description-i18n":{"vie":"Thanh toán từ khách hàng đơn đổi"}},"prepaid":{"type":"integer","default":0,"description":"Prepaid amount","x-description-i18n":{"vie":"Số tiền đã trả trước"}},"received_at_shop":{"type":"boolean","default":false,"description":"true: Sales at counter, false: Sell online","x-description-i18n":{"vie":"true: Bán tại quầy, false: Bán online"}},"shipping_address":{"type":"object","description":"Delivery address information","x-description-i18n":{"vie":"Thông tin địa chỉ giao hàng"},"properties":{"address":{"type":"string","description":"Address","x-description-i18n":{"vie":"Địa chỉ"}},"commune_id":{"type":"string","description":"Commune ID","x-description-i18n":{"vie":"Mã phường xã"}},"country_code":{"type":"string","description":"Country code","x-description-i18n":{"vie":"Mã quốc gia"}},"district_id":{"type":"string","description":"District ID","x-description-i18n":{"vie":"Mã quận huyện"}},"full_address":{"type":"string","description":"Full address","x-description-i18n":{"vie":"Địa chỉ đầy đủ"}},"full_name":{"type":"string","description":"Full name","x-description-i18n":{"vie":"Họ và tên"}},"new_full_address":{"type":"string","description":"New full address","x-description-i18n":{"vie":"Địa chỉ đầy đủ mới"}},"phone_number":{"type":"string","description":"Phone number","x-description-i18n":{"vie":"Số điện thoại"}},"province_id":{"type":"string","description":"Province ID","x-description-i18n":{"vie":"Mã tỉnh thành phố"}},"render_type":{"type":"string","description":"Render type","x-description-i18n":{"vie":"Loại render"}}}},"shipping_fee":{"type":"integer","default":0,"description":"Shipping fee","x-description-i18n":{"vie":"Phí vận chuyển"}},"shop_customer_id":{"type":"string","description":"Customer ID","x-description-i18n":{"vie":"Mã khách hàng"}},"surcharge":{"type":"integer","default":0,"description":"Surcharge","x-description-i18n":{"vie":"Phụ phí"}},"warehouse_id":{"type":"string","description":"Warehouse ID","x-description-i18n":{"vie":"Mã kho hàng"}}}},"order_to_returned":{"type":"object","description":"Order to be returned","x-description-i18n":{"vie":"Đơn hàng cần trả"},"properties":{"id":{"type":"string","description":"Order ID to returned","x-description-i18n":{"vie":"Mã đơn hàng cần trả"}}}},"returned_items":{"type":"array","description":"List of products in returned order","x-description-i18n":{"vie":"Danh sách sản phẩm trong đơn trả"},"items":{"type":"object","required":["product_id","variation_id","returned_quantity","variation_info"],"properties":{"product_id":{"type":"string","description":"Product ID","x-description-i18n":{"vie":"Mã sản phẩm"}},"returned_quantity":{"type":"integer","description":"Returned quantity","x-description-i18n":{"vie":"Số lượng trả"}},"variation_id":{"type":"string","description":"Variation ID","x-description-i18n":{"vie":"Mã biến thể"}},"variation_info":{"type":"object","description":"Variation information","x-description-i18n":{"vie":"Thông tin biến thể"},"required":["name","retail_price"],"properties":{"detail":{"type":"string","description":"Variation detail","x-description-i18n":{"vie":"Chi tiết biến thể"}},"fields":{"type":"array","description":"Variation fields","x-description-i18n":{"vie":"Các trường biến thể"},"items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"value":{"type":"string"}}}},"images":{"type":"array","description":"Variation images","x-description-i18n":{"vie":"Hình ảnh biến thể"},"items":{"type":"string","format":"uri"}},"name":{"type":"string","description":"Product name","x-description-i18n":{"vie":"Tên sản phẩm"}},"retail_price":{"type":"integer","description":"Retail price","x-description-i18n":{"vie":"Giá bán lẻ"}}}}}}},"shop_customer_id":{"type":"string","description":"Customer ID","x-description-i18n":{"vie":"Mã khách hàng"}},"status":{"type":"integer","description":"Order status","x-description-i18n":{"vie":"Trạng thái đơn hàng"}},"warehouse_id":{"type":"string","description":"Warehouse ID","x-description-i18n":{"vie":"Mã kho hàng"}}},"example":{"discount_from_order_to_returned":50000,"order_additional":{"bill_email":"","bill_full_name":"Lê Văn Tám","bill_phone_number":"0384596873","cash":1,"discount":20000,"items":[{"discount_each_product":0,"product_id":"db7cb77a-64c4-4572-9cca-86e846c0897c","quantity":1,"returned_quantity":1,"variation_id":"749f52be-2bd0-4e76-b9fd-a4914c53192a","variation_info":{"detail":"size: XL, color: blue","fields":[{"id":"25698fb6-158e-472f-a8a7-fa48250337ae","keyValue":"XL","name":"size","value":"XL"},{"id":"c414ff3c-cba7-497c-a6f8-13355605b391","keyValue":"BLUE","name":"color","value":"blue"}],"images":["https://content.pancake.vn/2/2022/1/19/18c4500c320cb2e993b3ff4b3be81165df64d3ba.png"],"name":"Sao chép Áo nam thời trang Pari","retail_price":500000,"weight":100}}],"note":"đơn trả hàng","note_print":"đơn trả hàng","order_currency":"VND","payment_from_customers_exchange_order":150000,"prepaid":123,"received_at_shop":false,"shipping_address":{"address":"BT2-12 ngõ 178910","commune_id":"1012129","country_code":"84","district_id":"10121","full_address":"BT2-12 ngõ 178, Phường Đại Mỗ, Quận Nam Từ Liêm, Hà Nội","full_name":"Nguyễn Hải Nhạn","new_full_address":"BT2-12 ngõ 178, Hà Nội","phone_number":"0384596873","province_id":"101","render_type":"old"},"shipping_fee":0,"shop_customer_id":"ef9fc5ef-b4b5-4682-a1b9-b7ea259ae353","surcharge":0,"warehouse_id":"4051d111-a6b6-44fb-aca1-61fb954298cb"},"order_to_returned":{"id":"123157"},"returned_items":[{"product_id":"6c998441-146b-4daa-b8e0-313a2a543623","returned_quantity":1,"variation_id":"efac90c8-0ba7-4aa0-bef6-8f4be3c0c6e6","variation_info":{"name":"[HỎA TỐC] Phồng Tôm Cà Mau VITOT Bánh Phồng Tôm Loại Cao Cấp Với Tỉ Lệ Tôm 48%, Đậm Đà Vị Tôm","retail_price":200000,"images":["https://content.pancake.vn/user-content-dev2.pancake.vn/2024/12/31/a549582c91f1bee856f8a4383408de4f10585fac.jpg"],"fields":[{"id":"995a0b6d-4e08-493e-b776-0afb2138e8a7","name":"PHÂN LOẠI","value":"1 HỘP CÀ MAU"}],"detail":"PHÂN LOẠI: 1 HỘP CÀ MAU"}}],"shop_customer_id":"ef9fc5ef-b4b5-4682-a1b9-b7ea259ae353","status":2,"warehouse_id":"4051d111-a6b6-44fb-aca1-61fb954298cb"}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReturnOrder"},"examples":{"default":{"value":{"id":1,"display_id":1,"bill_full_name":"Hoang Anh","bill_phone_number":"0999999999","creator_id":"8fbe2a6f-b0b2-4227-a698-19d18c43f7c8","custom_id":null,"discount":1,"discount_from_order_to_returned":1,"inserted_at":"2024-01-01T00:00:00Z","updated_at":"2024-01-01T00:00:00Z","order_id":1,"order_id_to_returned":1,"order":{"id":1,"system_id":1,"shop_id":1,"inserted_at":"2024-01-01T00:00:00Z","updated_at":"2024-01-01T00:00:00Z","status":1,"status_name":"Đã xác nhận","bill_full_name":"Hoang Anh","bill_phone_number":"0999999999","bill_email":"hoang@example.com","page_id":"104438181227821","post_id":"185187094667903_477083092110915","ad_id":"23851252560290199","shipping_fee":1,"partner_fee":1,"fee_marketplace":1,"customer_pay_fee":true,"is_free_shipping":true,"is_livestream":true,"is_live_shopping":true,"is_smc":true,"received_at_shop":true,"total_discount":1,"note":"","note_print":null,"returned_reason":1,"returned_reason_name":"Do khách hàng","sub_status":1,"warehouse_id":"b4cb5897-6e56-4581-96cc-2f12677c7bd8","warehouse_info":{"name":"kho test ecod","phone_number":"0999999999","full_address":"hâhhha, Xã Bình Trung, Huyện Châu Đức, Bà Rịa-Vũng Tàu","address":"hâhhha","province_id":"717","district_id":"71705","commune_id":"7170510","affiliate_id":null,"ffm_id":null,"has_snappy_service":true,"custom_id":null},"creator_id":"8fbe2a6f-b0b2-4227-a698-19d18c43f7c8","creator":{"id":"8fbe2a6f-b0b2-4227-a698-19d18c43f7c8","fb_id":"2042723249341651","name":"Hoang Anh","avatar_url":null},"items":[{"id":1,"product_id":"3487e126-b0d9-4dae-89a9-ee60bef2f4e9","variation_id":"415040f4-ab63-465e-8699-e9ebfff4c6c7","quantity":1,"returned_count":1,"assigning_seller_id":"340644fc-314d-450e-a45f-33343678cab6","quantity_by_combo_products":[],"discount_each_product":1,"is_bonus_product":true,"is_discount_percent":true,"is_wholesale":true,"is_composite":true,"one_time_product":true,"note":"","note_product":"","inserted_at":"2024-01-01T00:00:00Z","measure_group_id":1,"variation_info":{"id":"415040f4-ab63-465e-8699-e9ebfff4c6c7","name":"Ao so mi nam","product_id":"3487e126-b0d9-4dae-89a9-ee60bef2f4e9","retail_price":140000,"detail":"","images":["https://statics.pancake.vn/user-content.pancake.vn/2021/8/5/fccd6.jpg"],"fields":[{"id":"field-id-1","name":"Màu","value":"Trắng","keyValue":"Màu"}],"barcode":"BARCODE123","brand_id":null,"category_ids":[1290021044],"display_id":"13109","product_display_id":"a131092025","last_imported_price":30000,"weight":0,"measure_info":{"measure_id":1,"exchange_value":1},"avg_price":30000},"components":[{"component_id":"3487e126-b0d9-4dae-89a9-ee60bef2f4e9","quantity":1,"variation_id":"415040f4-ab63-465e-8699-e9ebfff4c6c7"}]}],"partner":{"partner_id":1,"cod":0,"extend_code":"S58824.MB25.C3.500020713","total_fee":0,"updated_at":"2020-05-12T05:18:16","delivery_name":null,"delivery_tel":null,"picked_up_at":null,"sort_code":null,"paid_at":null,"system_created":true,"extend_update":[{"key":"status","status":"delivered","tracking_id":"S58824.MB25.C3.500020713","note":"","update_at":"2020-05-12T05:18:16"}]},"shipping_address":{"full_name":"Hoang Anh","phone_number":"0999999999","address":"90 Cầu Giấy","full_address":"90 Cầu Giấy, Phường Dịch Vọng, Quận Cầu Giấy, Hà Nội","province_id":"101","district_id":"10113","commune_id":"1011309","commnue_name":"Phường Dịch Vọng","district_name":"Quận Cầu Giấy","province_name":"Hà Nội","country_code":"84","post_code":null},"payment_purchase_histories":[{"amount":1800000,"type":"cash","inserted_at":"2024-01-01T00:00:00Z","result_code":"00","ipn_reply":true,"voucher_amount":0,"tags":["payment"]}],"tags":[{"id":75,"name":"thẻ 4"}],"marketer":{"id":"cee3c05e-5f85-43c4-b27e-889b99c50097","name":"Marketer Name","email":"marketer@example.com","phone_number":"0999999999","fb_id":"2042723249341651","avatar_url":null},"pke_mkter":"cee3c05e-5f85-43c4-b27e-889b99c50097","activated_combo_products":{"combo_product_id":1,"quantity_combo_activated":1},"activated_promotion_advances":[{"id":1,"promotion_advance_id":"fb056b32-9cf6-4c5a-92de-0eb94db71121"}],"tracking_link":"https://tracking.example.com","ads_source":null,"shopify_order_id":null,"shopify_abandon_checkout_id":1,"is_abandoned_order":true,"cod":0,"cash":0,"account":1,"account_name":"facebook321","advanced_platform_fee":{"ads_top_up":1,"affiliate_commission":1,"diff_shipping_fee":1,"marketplace_voucher":1,"payment_fee":1,"platform_commission":1,"seller_transaction_fee":1,"service_fee":1,"sfp_service_fee":1},"printing_count":1,"money_to_collect":1,"total_price":1,"shop_customer_address_id":"0fefd213-7d0c-4d5b-bdbf-35694da80857","customer":{"fb_id":null,"id":"96a8e283-3fba-492e-a35a-970f72a30a02","name":"Trần Văn Hoàng","page_id":"104438181227821"},"total_quantity":1,"time_assign_marketer":"2024-01-01T00:00:00Z","status_history":[{"avatar_url":null,"editor_fb":"2042723249341651","editor_id":"8fbe2a6f-b0b2-4227-a698-19d18c43f7c8","name":"Hoang Anh","old_status":0,"status":1,"updated_at":"2024-01-01T00:00:00Z"}],"duplicated_phone":true,"order_currency":"VND","charged_by_vnpay":1,"charged_by_qrpay":1,"custom_id":null,"last_editor":{"id":"8fbe2a6f-b0b2-4227-a698-19d18c43f7c8","fb_id":"2042723249341651","name":"Hoang Anh","email":"hoang@example.com","avatar_url":null,"phone_number":"0999999999"},"last_editor_id":"8fbe2a6f-b0b2-4227-a698-19d18c43f7c8","charged_by_momo":1,"bank_transfer_images":["https://statics.pancake.vn/user-content.pancake.vn/2021/8/5/fccd6.jpg"],"transfer_money":1,"lock_order_by_user":null,"assigning_care":{"id":"cee3c05e-5f85-43c4-b27e-889b99c50097","fb_id":"2042723249341651","name":"Care Name","email":"care@example.com","avatar_url":null,"phone_number":"0999999999"},"assigning_care_id":"cee3c05e-5f85-43c4-b27e-889b99c50097","time_assign_care":"2024-01-01T00:00:00Z","assigning_seller":{"id":"340644fc-314d-450e-a45f-33343678cab6","fb_id":"2042723249341651","name":"Seller Name","email":"seller@example.com","avatar_url":null,"phone_number":"0999999999"},"einvoices":[],"charged_by_card":1,"estimate_delivery_date":"2024-01-01T00:00:00Z","order_sources":"-1","charged_by_fundiin":1,"surcharge":1,"is_linked_partner":true,"call_laters":[],"last_update_status_at":"2024-01-01T00:00:00Z","discount_by_customer_level":1,"viewing":[],"order_returned_ids":null,"cost_surcharge":1,"time_send_partner":"2024-01-01T00:00:00Z","charged_by_kredivo":1,"discount":1,"histories":[],"duplicated_customer":true,"tax":1,"is_from_ecommerce":true,"note_image":["https://statics.pancake.vn/user-content.pancake.vn/2021/8/5/fccd6.jpg"],"shopify_draft_order_id":null,"display_id":1,"shop_partner_id":1,"is_locked":true},"order_to_returned":{"id":1,"system_id":1,"shop_id":1,"inserted_at":"2024-01-01T00:00:00Z","updated_at":"2024-01-01T00:00:00Z","status":1,"status_name":"Đã xác nhận","bill_full_name":"Hoang Anh","bill_phone_number":"0999999999","bill_email":"hoang@example.com","page_id":"104438181227821","post_id":"185187094667903_477083092110915","ad_id":"23851252560290199","shipping_fee":1,"partner_fee":1,"fee_marketplace":1,"customer_pay_fee":true,"is_free_shipping":true,"is_livestream":true,"is_live_shopping":true,"is_smc":true,"received_at_shop":true,"total_discount":1,"note":"","note_print":null,"returned_reason":1,"returned_reason_name":"Do khách hàng","sub_status":1,"warehouse_id":"b4cb5897-6e56-4581-96cc-2f12677c7bd8","warehouse_info":{"name":"kho test ecod","phone_number":"0999999999","full_address":"hâhhha, Xã Bình Trung, Huyện Châu Đức, Bà Rịa-Vũng Tàu","address":"hâhhha","province_id":"717","district_id":"71705","commune_id":"7170510","affiliate_id":null,"ffm_id":null,"has_snappy_service":true,"custom_id":null},"creator_id":"8fbe2a6f-b0b2-4227-a698-19d18c43f7c8","creator":{"id":"8fbe2a6f-b0b2-4227-a698-19d18c43f7c8","fb_id":"2042723249341651","name":"Hoang Anh","avatar_url":null},"items":[{"id":1,"product_id":"3487e126-b0d9-4dae-89a9-ee60bef2f4e9","variation_id":"415040f4-ab63-465e-8699-e9ebfff4c6c7","quantity":1,"returned_count":1,"assigning_seller_id":"340644fc-314d-450e-a45f-33343678cab6","quantity_by_combo_products":[],"discount_each_product":1,"is_bonus_product":true,"is_discount_percent":true,"is_wholesale":true,"is_composite":true,"one_time_product":true,"note":"","note_product":"","inserted_at":"2024-01-01T00:00:00Z","measure_group_id":1,"variation_info":{"id":"415040f4-ab63-465e-8699-e9ebfff4c6c7","name":"Ao so mi nam","product_id":"3487e126-b0d9-4dae-89a9-ee60bef2f4e9","retail_price":140000,"detail":"","images":["https://statics.pancake.vn/user-content.pancake.vn/2021/8/5/fccd6.jpg"],"fields":[{"id":"field-id-1","name":"Màu","value":"Trắng","keyValue":"Màu"}],"barcode":"BARCODE123","brand_id":null,"category_ids":[1290021044],"display_id":"13109","product_display_id":"a131092025","last_imported_price":30000,"weight":0,"measure_info":{"measure_id":1,"exchange_value":1},"avg_price":30000},"components":[{"component_id":"3487e126-b0d9-4dae-89a9-ee60bef2f4e9","quantity":1,"variation_id":"415040f4-ab63-465e-8699-e9ebfff4c6c7"}]}],"partner":{"partner_id":1,"cod":0,"extend_code":"S58824.MB25.C3.500020713","total_fee":0,"updated_at":"2020-05-12T05:18:16","delivery_name":null,"delivery_tel":null,"picked_up_at":null,"sort_code":null,"paid_at":null,"system_created":true,"extend_update":[{"key":"status","status":"delivered","tracking_id":"S58824.MB25.C3.500020713","note":"","update_at":"2020-05-12T05:18:16"}]},"shipping_address":{"full_name":"Hoang Anh","phone_number":"0999999999","address":"90 Cầu Giấy","full_address":"90 Cầu Giấy, Phường Dịch Vọng, Quận Cầu Giấy, Hà Nội","province_id":"101","district_id":"10113","commune_id":"1011309","commnue_name":"Phường Dịch Vọng","district_name":"Quận Cầu Giấy","province_name":"Hà Nội","country_code":"84","post_code":null},"payment_purchase_histories":[{"amount":1800000,"type":"cash","inserted_at":"2024-01-01T00:00:00Z","result_code":"00","ipn_reply":true,"voucher_amount":0,"tags":["payment"]}],"tags":[{"id":75,"name":"thẻ 4"}],"marketer":{"id":"cee3c05e-5f85-43c4-b27e-889b99c50097","name":"Marketer Name","email":"marketer@example.com","phone_number":"0999999999","fb_id":"2042723249341651","avatar_url":null},"pke_mkter":"cee3c05e-5f85-43c4-b27e-889b99c50097","activated_combo_products":{"combo_product_id":1,"quantity_combo_activated":1},"activated_promotion_advances":[{"id":1,"promotion_advance_id":"fb056b32-9cf6-4c5a-92de-0eb94db71121"}],"tracking_link":"https://tracking.example.com","ads_source":null,"shopify_order_id":null,"shopify_abandon_checkout_id":1,"is_abandoned_order":true,"cod":0,"cash":0,"account":1,"account_name":"facebook321","advanced_platform_fee":{"ads_top_up":1,"affiliate_commission":1,"diff_shipping_fee":1,"marketplace_voucher":1,"payment_fee":1,"platform_commission":1,"seller_transaction_fee":1,"service_fee":1,"sfp_service_fee":1},"printing_count":1,"money_to_collect":1,"total_price":1,"shop_customer_address_id":"0fefd213-7d0c-4d5b-bdbf-35694da80857","customer":{"fb_id":null,"id":"96a8e283-3fba-492e-a35a-970f72a30a02","name":"Trần Văn Hoàng","page_id":"104438181227821"},"total_quantity":1,"time_assign_marketer":"2024-01-01T00:00:00Z","status_history":[{"avatar_url":null,"editor_fb":"2042723249341651","editor_id":"8fbe2a6f-b0b2-4227-a698-19d18c43f7c8","name":"Hoang Anh","old_status":0,"status":1,"updated_at":"2024-01-01T00:00:00Z"}],"duplicated_phone":true,"order_currency":"VND","charged_by_vnpay":1,"charged_by_qrpay":1,"custom_id":null,"last_editor":{"id":"8fbe2a6f-b0b2-4227-a698-19d18c43f7c8","fb_id":"2042723249341651","name":"Hoang Anh","email":"hoang@example.com","avatar_url":null,"phone_number":"0999999999"},"last_editor_id":"8fbe2a6f-b0b2-4227-a698-19d18c43f7c8","charged_by_momo":1,"bank_transfer_images":["https://statics.pancake.vn/user-content.pancake.vn/2021/8/5/fccd6.jpg"],"transfer_money":1,"lock_order_by_user":null,"assigning_care":{"id":"cee3c05e-5f85-43c4-b27e-889b99c50097","fb_id":"2042723249341651","name":"Care Name","email":"care@example.com","avatar_url":null,"phone_number":"0999999999"},"assigning_care_id":"cee3c05e-5f85-43c4-b27e-889b99c50097","time_assign_care":"2024-01-01T00:00:00Z","assigning_seller":{"id":"340644fc-314d-450e-a45f-33343678cab6","fb_id":"2042723249341651","name":"Seller Name","email":"seller@example.com","avatar_url":null,"phone_number":"0999999999"},"einvoices":[],"charged_by_card":1,"estimate_delivery_date":"2024-01-01T00:00:00Z","order_sources":"-1","charged_by_fundiin":1,"surcharge":1,"is_linked_partner":true,"call_laters":[],"last_update_status_at":"2024-01-01T00:00:00Z","discount_by_customer_level":1,"viewing":[],"order_returned_ids":null,"cost_surcharge":1,"time_send_partner":"2024-01-01T00:00:00Z","charged_by_kredivo":1,"discount":1,"histories":[],"duplicated_customer":true,"tax":1,"is_from_ecommerce":true,"note_image":["https://statics.pancake.vn/user-content.pancake.vn/2021/8/5/fccd6.jpg"],"shopify_draft_order_id":null,"display_id":1,"shop_partner_id":1,"is_locked":true},"returned_items":[{"id":1,"product_id":"3487e126-b0d9-4dae-89a9-ee60bef2f4e9","variation_id":"415040f4-ab63-465e-8699-e9ebfff4c6c7","returned_quantity":1,"discount_each_product":1,"is_discount_percent":true}],"returned_fee":1,"shop_customer_id":"96a8e283-3fba-492e-a35a-970f72a30a02","shop_id":1,"status":1,"status_histories":[{"id":1,"editor_id":"8fbe2a6f-b0b2-4227-a698-19d18c43f7c8","old_status":0,"status":1,"inserted_at":"2024-01-01T00:00:00Z","updated_at":"2024-01-01T00:00:00Z"}],"tags":[1],"warehouse_id":"b4cb5897-6e56-4581-96cc-2f12677c7bd8"}}}}}}}}},"/shops/{SHOP_ID}/partners":{"get":{"summary":"Partner list","x-summary-i18n":{"vie":"Danh sách đối tác"},"description":"Get list of shipping partners","x-description-i18n":{"vie":"Lấy danh sách đối tác vận chuyển"},"tags":["Order"],"x-tags-i18n":{"vie":["Đơn hàng"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","description":"List of partners","x-description-i18n":{"vie":"Danh sách đối tác"},"items":{"type":"object","properties":{"id":{"type":"integer","description":"Partner ID","x-description-i18n":{"vie":"Mã đối tác"}},"name":{"type":"string","description":"Partner name","x-description-i18n":{"vie":"Tên đối tác"}},"country_code":{"type":"string","description":"Country code","x-description-i18n":{"vie":"Mã quốc gia"}},"accounts":{"type":"array","description":"List of courier accounts connected to the shop","x-description-i18n":{"vie":"Danh sách tài khoản vận chuyển đã kết nối với shop"},"items":{"type":"object","properties":{"id":{"type":"integer","description":"Account ID","x-description-i18n":{"vie":"Mã tài khoản"}},"name":{"type":"string","description":"Account name","x-description-i18n":{"vie":"Tên tài khoản"}}}}}}}},"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}}}},"examples":{"default":{"value":{"data":[{"id":1,"name":"Giao hàng tiết kiệm","country_code":"84","accounts":[{"id":46036,"name":"sonvu8910-224"}]},{"id":2,"name":"EMS","country_code":"84","accounts":[]},{"id":3,"name":"VTP","country_code":"84","accounts":[{"id":10932,"name":"hà an"}]},{"id":4,"name":"247 Express","country_code":"84","accounts":[]}],"success":true}}}}}}}}},"/shops/{SHOP_ID}/projects":{"get":{"summary":"Project list","x-summary-i18n":{"vie":"Danh sách dự án"},"description":"Get list of projects","x-description-i18n":{"vie":"Lấy danh sách dự án"},"tags":["Order"],"x-tags-i18n":{"vie":["Đơn hàng"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Project"},"examples":{"default":{"value":{"data":[{"id":19,"image":null,"inserted_at":"2025-12-13T10:01:51","name":"Project 1","nodes":[{"custom_id":null,"id":292,"image":null,"inserted_at":"2024-03-28T04:52:28","link_source_id":null,"name":"Source order 1","nodes":[{"custom_id":null,"id":366,"image":null,"inserted_at":"2024-11-08T02:18:52","link_source_id":null,"name":"Source order 2","nodes":[],"parent_id":292,"project_id":null,"shop_id":20,"updated_at":"2025-07-02T02:52:14"}],"parent_id":null,"project_id":19,"shop_id":20,"updated_at":"2025-12-13T10:02:02"}],"shop_id":20,"updated_at":"2025-12-13T10:01:51"}],"success":true}}}}}}}}},"/shops/{SHOP_ID}/list_einvoices/":{"get":{"summary":"List of e-invoices","x-summary-i18n":{"vie":"Danh sách hóa đơn điện tử"},"description":"Get list of e-invoices","x-description-i18n":{"vie":"Lấy danh sách hóa đơn điện tử"},"tags":["E-Invoice"],"x-tags-i18n":{"vie":["Hóa đơn điện tử"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},{"name":"account_id","in":"query","required":false,"schema":{"type":"string","example":"2284322048329488"},"description":"Account ID","x-description-i18n":{"vie":"Mã tài khoản"}},{"name":"marketplace_id","in":"query","required":false,"schema":{"type":"string","example":"1"},"description":"Marketplace ID","x-description-i18n":{"vie":"Mã sàn thương mại điện tử"}},{"name":"name","in":"query","required":false,"schema":{"type":"string","example":"Shopee"},"description":"Account name","x-description-i18n":{"vie":"Tên tài khoản"}},{"name":"startDate","in":"query","required":false,"schema":{"type":"integer","example":1778518800},"description":"Start of creation time range (unix timestamp)","x-description-i18n":{"vie":"Thời điểm tạo (bắt đầu) (unix timestamp)"}},{"name":"endDate","in":"query","required":false,"schema":{"type":"integer","example":1778518800},"description":"End of creation time range (unix timestamp)","x-description-i18n":{"vie":"Thời điểm tạo (kết thúc) (unix timestamp)"}},{"name":"startDateRelease","in":"query","required":false,"schema":{"type":"integer","example":1778518800},"description":"Start of release time range (unix timestamp)","x-description-i18n":{"vie":"Thời điểm phát hành (bắt đầu) (unix timestamp)"}},{"name":"endDateRelease","in":"query","required":false,"schema":{"type":"integer","example":1778518800},"description":"End of release time range (unix timestamp)","x-description-i18n":{"vie":"Thời điểm phát hành (kết thúc) (unix timestamp)"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EInvoice"},"examples":{"default":{"value":{"success":true,"data":[{"actual_shipping_fee":30000,"adjust_amount":null,"adjustment_criteria":null,"adjustment_type":null,"allocation_discounts":[],"allocation_type":1,"bank_account_number":null,"bank_name":null,"budget_unit_code":null,"buyer_not_get_invoice":false,"creator":{"avatar_url":null,"fb_id":"377936050731194","id":"cee3c05e-5f85-43c4-b27e-889b99c50097","name":"Vũ Sơn"},"discount":100000,"display_id":754,"einvoice_account_id":66,"email":"acb@gmail.com","full_name":"C. Hạnh","id":1656,"identity_code":null,"included_tax":0,"invoice_no":"00000095","invoice_series":"C25TPA","invoice_type":1,"is_adjust_amount":false,"is_included_tax":false,"items":[{"adjust_amount":null,"discount":0,"id":3501,"is_calculation_tax":false,"is_component":false,"is_surcharge":null,"measure":null,"note":null,"order_id":124409,"order_item_id":70104,"quantity":1,"retail_price":200000,"tax":5,"type":1,"variation":{"custom_id":"TESTMATGREENS","display_id":16,"fields":[{"id":"b8a37fc1-4479-480a-937a-e18e1a588aec","keyValue":"RED","name":"Màu sắcaa","value":"red"},{"id":"786371f1-8d23-4a45-9e83-d944892ad3ce","keyValue":"L","name":"Sizeaaa","value":"L"}],"product":{"custom_id":"ANPR","display_id":13038,"name":"Áo nam Pari đẹp thời trang 123"},"product_id":"dee8f2c3-2ecc-4d9b-a9ff-603b5bde7e3d"},"variation_id":"573e9406-07dd-44f7-9c26-28f95da9ad47","variation_info":{"detail":"Màu sắcaa: red, Sizeaaa: L","diff_discount":null,"discount":10000000,"item_total_amount_with_tax":10500000,"item_total_amount_without_tax":10000000,"measure_info":null,"name":"Áo nam Pari đẹp thời trang 123","product_id":"dee8f2c3-2ecc-4d9b-a9ff-603b5bde7e3d","product_tags":[],"tax_amount":500000,"tax_rate":5,"unit_price":20000000}}],"key_search":"KICKFUYUPUAOFF8","last_editor_id":"d6e6a545-f102-439e-9943-8ac8369f9735","note":null,"order_id":124409,"order_info":{"account":null,"account_source":null,"cod":130500,"custom_id":null,"display_id":20456,"order_currency":"VND","order_sources":null,"page":{"id":"117967746266487","name":"Soicun","username":null},"page_id":"117967746266487","partner":{"extend_code":null,"partner_id":154},"shop_customer_id":"7869af18-f0f4-44d9-95e8-106c9731eef9","warehouse_id":"c52e67ad-d9d0-4276-abe4-e0c9f1f7d2da"},"original_einvoice":null,"payment_method":"TM/CK","phone_number":"0983924977","purchaser_tax_code":null,"purchaser_unit":null,"release_date":"2025-11-13T05:05:29.322669","release_type":1,"shipping_address":{"address":"123","commnue_name":"Phường Cống Vị","commune_id":"1010115","country_code":"84","district_id":"10101","district_name":"Quận Ba Đình","full_address":"123, Phường Cống Vị, Quận Ba Đình, Hà Nội","full_name":"C. Hạnh","new_full_address":"123, Hà Nội","new_province_id":"84_VN101","phone_number":"0983924977","post_code":"","province_id":"101","province_name":"Hà Nội","render_type":"old"},"shipping_fee":30000,"shop_id":20,"signature_type":0,"status":2,"tax":10,"template_code":"1","total_amount":130500,"verification_code":null,"voucher_book":null}]}}}}}}}}},"/shops/{SHOP_ID}/livestream_manager":{"get":{"summary":"List of livestream sessions","x-summary-i18n":{"vie":"Danh sách phiên livestream"},"description":"Get list of livestream sessions","x-description-i18n":{"vie":"Lấy danh sách phiên livestream"},"tags":["Livestream"],"x-tags-i18n":{"vie":["Livestream"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","example":1},"description":"Page number","x-description-i18n":{"vie":"Số trang"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","default":30,"example":30},"description":"Page size","x-description-i18n":{"vie":"Kích thước trang"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LivestreamManager"},"examples":{"default":{"value":{"success":true,"data":[{"creator":{"avatar_url":null,"fb_id":"101281316987922","id":"b0097b97-8520-4a16-a89b-4ddcd76c3ec8","name":"Trần Ngọc Hoa"},"end_time":"2026-01-23T10:10:21","finisher":{"avatar_url":null,"fb_id":"101281316987922","id":"b0097b97-8520-4a16-a89b-4ddcd76c3ec8","name":"Trần Ngọc Hoa"},"id":"60cc3e38-f4e7-44d7-ba30-911ce398b46a","inserted_at":"2026-01-22T12:26:13.000000","name":"Live tối 22/1","origin_post_id":null,"post_ids":["105112292515661_1080067970899442"],"remain_warehouse_ids":["e2f0f8db-9937-4293-88a6-67637c6f4c25"],"shop_id":4,"start_time":"2026-01-22T12:31:10","total_comments":753,"total_customers":262,"warehouse_id":"e2f0f8db-9937-4293-88a6-67637c6f4c25"}],"page_number":1,"page_size":30,"total_entries":1,"total_pages":1}}}}}}}}},"/shops/{SHOP_ID}/marketplace/get_account_info":{"get":{"summary":"eCommerce Platform Account","x-summary-i18n":{"vie":"Tài khoản sàn thương mại điện tử"},"description":"Get eCommerce platform account information","x-description-i18n":{"vie":"Lấy thông tin tài khoản sàn thương mại điện tử"},"tags":["eCommerce"],"x-tags-i18n":{"vie":["Sàn thương mại điện tử"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},{"name":"account_id","in":"query","required":false,"schema":{"type":"string","example":"2284322048329488"},"description":"Account ID","x-description-i18n":{"vie":"Mã tài khoản"}},{"name":"marketplace_id","in":"query","required":false,"schema":{"type":"string","example":"1"},"description":"Marketplace ID","x-description-i18n":{"vie":"Mã sàn thương mại điện tử"}},{"name":"name","in":"query","required":false,"schema":{"type":"string","example":"Shopee"},"description":"Account name","x-description-i18n":{"vie":"Tên tài khoản"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","description":"List of eCommerce platform accounts","x-description-i18n":{"vie":"Danh sách tài khoản sàn thương mại điện tử"},"items":{"type":"object","properties":{"id":{"type":"string","description":"eCommerce Platform Shop ID","x-description-i18n":{"vie":"Mã shop sàn thương mại điện tử"}},"marketplace_id":{"type":"string","description":"eCommerce Platform ID (-2: Tiki, -3: Shopee, -4: Lazada, -6: Sendo, -9: TikTok, -16: WooCommerce, -17: Shopify, -20: Line Shopping, -25: Tokopedia, -27: Mercado Libre)","x-description-i18n":{"vie":"Mã sàn thương mại điện tử (-2: Tiki, -3: Shopee, -4: Lazada, -6: Sendo, -9: TikTok, -16: WooCommerce, -17: Shopify, -20: Line Shopping, -25: Tokopedia, -27: Mercado Libre)"}},"name":{"type":"string","description":"Account name","x-description-i18n":{"vie":"Tên tài khoản"}},"shop_id":{"type":"integer","description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}}}}},"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}}}},"examples":{"default":{"value":{"success":true,"data":[{"id":"1","marketplace_id":"-3","name":"Shopee","shop_id":1}]}}}}}}}}},"/shops/{SHOP_ID}/marketplace/products":{"get":{"summary":"eCommerce Platform Products","x-summary-i18n":{"vie":"Sản phẩm sàn thương mại điện tử"},"description":"Get eCommerce platform products information","x-description-i18n":{"vie":"Lấy danh sách sản phẩm trên sàn thương mại điện tử"},"tags":["eCommerce"],"x-tags-i18n":{"vie":["Sàn thương mại điện tử"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"example":1},"description":"Page number","x-description-i18n":{"vie":"Số trang"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","default":30,"example":30},"description":"Page size","x-description-i18n":{"vie":"Kích thước trang"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/eCommerceProduct"},"examples":{"default":{"value":{"id":"46152996242","linked_product_custom_id":"ANPR","linked_product_name":"Áo nam Pari đẹp thời trang","marketplace_id":"-3","marketplace_shop_name":"Vũ Sơn shop","name":"Áo nam Pari đẹp thời trang","price":0,"sku":"ANPR","variations":[{"id":"375286372857","images":["https://content.pancake.vn/user-content-dev2.pancake.vn/2025/9/17/abad91b33fa9a051b86d415f6cf63aba00d360ac.jpg"],"linked_product_custom_id":"ANPR","linked_variation_custom_id":"TESTMATDOS","linked_variation_fields":[{"id":"2b61c249-35dc-4b79-a3aa-a173c63a8061","keyValue":"BLUE","name":"Màu sắcaa","value":"blue"},{"id":"b053dfb9-b7b6-4d8a-9fb4-197d7b0d7556","keyValue":"L","name":"Sizeaaa","value":"L"}],"linked_variation_price":150000,"name":"blue L","price":165000,"quantity":1025,"sku":"TESTMATDOS"}],"warehouse":"Kho HN"}}}}}}}}},"/shops/{SHOP_ID}/shopee/evaluate":{"get":{"summary":"Evaluation list","x-summary-i18n":{"vie":"Danh sách đánh giá"},"description":"Get list of evaluations on eCommerce platform","x-description-i18n":{"vie":"Lấy danh sách đánh giá trên sàn thương mại điện tử"},"tags":["eCommerce"],"x-tags-i18n":{"vie":["Sàn thương mại điện tử"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"example":1},"description":"Page number","x-description-i18n":{"vie":"Số trang"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","default":30,"example":30},"description":"Page size","x-description-i18n":{"vie":"Kích thước trang"}},{"name":"field_time","in":"query","required":false,"schema":{"type":"string","enum":["evaluation_time","last_evaluation_time"],"x-enum-descriptions":["Creation time","Last evaluation time"],"x-enum-descriptions-i18n":{"vie":["Thời điểm tạo","Thời điểm đánh giá mới nhất"]},"example":"evaluation_time"},"description":"Filter evaluations by time","x-description-i18n":{"vie":"Lọc đánh giá theo thời gian"}},{"name":"evaluation_time[]","in":"query","required":false,"schema":{"type":"array","items":{"type":"integer","format":"unix","example":[1762448400,1763139599]}},"description":"Filter time interval","x-description-i18n":{"vie":"Khoảng thời gian lọc"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","description":"List of evaluations","x-description-i18n":{"vie":"Danh sách đánh giá"},"items":{"type":"object","properties":{"buyer":{"type":"string","description":"Buyer","x-description-i18n":{"vie":"Người mua"}},"comment":{"type":"string","description":"Buyer comment","x-description-i18n":{"vie":"Bình luận người mua"}},"create_at":{"type":"string","format":"date-time","description":"Created at","x-description-i18n":{"vie":"Thời điểm tạo"}},"last_rating":{"type":"integer","description":"Latest evaluation","x-description-i18n":{"vie":"Đánh giá mới nhất"}},"order_id":{"type":"string","description":"Order ID","x-description-i18n":{"vie":"Mã đơn hàng"}},"product":{"type":"object","description":"Product information","x-description-i18n":{"vie":"Thông tin sản phẩm"},"properties":{"images":{"type":"array","description":"Product images","x-description-i18n":{"vie":"Hình ảnh sản phẩm"},"items":{"type":"string","format":"uri"}},"marketplace_product_name":{"type":"string","description":"Marketplace product name","x-description-i18n":{"vie":"Tên sản phẩm trên sàn"}}}},"product_name":{"type":"string","description":"Product name","x-description-i18n":{"vie":"Tên sản phẩm"}},"rating":{"type":"integer","description":"Evaluation","x-description-i18n":{"vie":"Đánh giá"}},"reply":{"type":"object","description":"Response information","x-description-i18n":{"vie":"Thông tin phản hồi"},"properties":{"hidden":{"type":"boolean","description":"Reply hidden","x-description-i18n":{"vie":"Ẩn phản hồi"}},"reply":{"type":"string","description":"Response content","x-description-i18n":{"vie":"Nội dung phản hồi"}}}},"shop_id":{"type":"integer","description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},"variation":{"type":"object","description":"Variation information","x-description-i18n":{"vie":"Thông tin mẫu mã"},"properties":{"images":{"type":"array","description":"Variation images","x-description-i18n":{"vie":"Hình ảnh mẫu mã"},"items":{"type":"string","format":"uri"}},"marketplace_sku":{"type":"string","description":"Marketplace SKU","x-description-i18n":{"vie":"SKU trên sàn"}}}},"marketplace":{"type":"object","description":"eCommerce Platform information","x-description-i18n":{"vie":"Thông tin sàn thương mại điện tử"},"properties":{"marketplace_shop_id":{"type":"string","description":"eCommerce Platform Shop ID","x-description-i18n":{"vie":"Mã shop sàn thương mại điện tử"}},"marketplace_shop_name":{"type":"string","description":"eCommerce Platform Shop Name","x-description-i18n":{"vie":"Tên shop sàn thương mại điện tử"}}}},"marketplace_id":{"type":"string","description":"eCommerce Platform ID","x-description-i18n":{"vie":"Mã sàn thương mại điện tử"}}}}},"page_number":{"type":"integer","description":"Page number","x-description-i18n":{"vie":"Số trang"}},"page_size":{"type":"integer","description":"Page size","x-description-i18n":{"vie":"Kích thước trang"}},"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}},"total_entries":{"type":"integer","description":"Total entries","x-description-i18n":{"vie":"Tổng số bản ghi"}},"total_pages":{"type":"integer","description":"Total pages","x-description-i18n":{"vie":"Tổng số trang"}}}},"examples":{"default":{"value":{"success":true,"data":[{"buyer":"Vu Son","comment":"Giao nhanh, gói cẩn thận Đúng loại và sản phẩm y như mô tả Mình mua nhiều lần rồi và rất ưng vị của shop","create_at":"2024-08-12T08:31:22Z","last_rating":3,"order_id":"240806J7RNCBUB","product":{"images":["https://content.pancake.vn/user-content-dev2.pancake.vn/2024/4/15/841a6d57f52f22176dea7a9a6fb35761c89fd4eb.jpg"],"marketplace_product_name":"Áo thun nam form rộng 12 con giáp tuổi Sửu ATD478 Miucho Iconic cotton cổ tròn in graphic"},"product_name":"Áo thun nam form rộng 12 con giáp tuổi Sửu ATD478 Miucho Iconic cotton cổ tròn in graphic","rating":5,"reply":{"hidden":false,"reply":"Cảm ơn quý khách đã mua hàng và đánh giá tốt cho shop!\nQuý khách thật tuyệt vời khi đã đặt hàng, nhận hàng và dành thời gian đánh giá tích cực.\nNếu có bất kể vấn đề gì quý khách cứ nhắn tin shop bảo đảm xử lý có lợi cho khách hàng.\nShop vô cùng cầu thị với mong muốn được phục vụ quý khách trong những đơn hàng tiếp theo.\nShop xin chúc quý khách cùng gia đình mạnh khoẻ, vui vẻ, may mắn, bình an!\n\n"},"shop_id":224,"variation":{"images":["https://content.pancake.vn/user-content-dev2.pancake.vn/2024/4/15/0636d7492a531270596064c3712b0e228a843c3b.jpg"],"marketplace_sku":"ATD478-2X-CC-M"},"marketplace":{"marketplace_shop_id":"20732730","marketplace_shop_name":"Vũ Sơn shop"},"marketplace_id":"-3"}]}}}}}}}}},"/shops/{SHOP_ID}/marketplace/reverse_order":{"get":{"summary":"List of reverse orders","x-summary-i18n":{"vie":"Danh sách đơn đổi trả"},"description":"Get list of reverse orders on eCommerce platform","x-description-i18n":{"vie":"Lấy danh sách đơn đổi trả trên sàn thương mại điện tử"},"tags":["eCommerce"],"x-tags-i18n":{"vie":["Sàn thương mại điện tử"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"example":1},"description":"Page number","x-description-i18n":{"vie":"Số trang"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","default":30,"example":30},"description":"Page size","x-description-i18n":{"vie":"Kích thước trang"}},{"name":"type_of_filter_time","in":"query","required":false,"schema":{"type":"string","enum":["inserted_at","updated_at"],"x-enum-descriptions":["Inserted at","Updated at"],"x-enum-descriptions-i18n":{"vie":["Thời điểm tạo","Thời điểm cập nhật"]},"example":"inserted_at"},"description":"Filter reverse orders by time","x-description-i18n":{"vie":"Lọc đơn hàng đổi trả theo thời gian"}},{"name":"time[]","in":"query","required":false,"schema":{"type":"array","items":{"type":"integer","format":"unix","example":[1762448400,1763139599]}},"description":"Filter time interval","x-description-i18n":{"vie":"Khoảng thời gian lọc"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","description":"List of reverse orders","x-description-i18n":{"vie":"Danh sách đơn hàng đổi trả"},"items":{"type":"object","properties":{"amount":{"type":"integer","description":"Refund amount","x-description-i18n":{"vie":"Số tiền hoàn trả"}},"buyer":{"type":"string","description":"Buyer","x-description-i18n":{"vie":"Người mua"}},"id":{"type":"integer","description":"Reverse order ID","x-description-i18n":{"vie":"Mã đơn hàng đổi trả"}},"inserted_at":{"type":"string","format":"date-time","description":"Inserted at","x-description-i18n":{"vie":"Thời điểm tạo"}},"items":{"type":"array","description":"List of refunded products","x-description-i18n":{"vie":"Danh sách sản phẩm hoàn trả"},"items":{"type":"object","properties":{"amount":{"type":"integer","description":"Amount","x-description-i18n":{"vie":"Số lượng"}},"images":{"type":"array","description":"Product images","x-description-i18n":{"vie":"Hình ảnh sản phẩm"},"items":{"type":"string","format":"uri"}},"item_id":{"type":"string","description":"Item ID","x-description-i18n":{"vie":"Mã sản phẩm"}},"item_price":{"type":"integer","description":"Item price","x-description-i18n":{"vie":"Giá sản phẩm"}},"item_sku":{"type":"string","description":"Item SKU","x-description-i18n":{"vie":"SKU sản phẩm"}},"model_id":{"type":"integer","description":"Model ID","x-description-i18n":{"vie":"Mã mãu mã"}},"name":{"type":"string","description":"Product name","x-description-i18n":{"vie":"Tên sản phẩm"}},"refund_amount":{"type":"integer","description":"Refund amount","x-description-i18n":{"vie":"Số tiền hoàn trả"}},"variation_sku":{"type":"string","description":"Variation SKU","x-description-i18n":{"vie":"SKU mẫu mã"}}}}},"marketplace_id":{"type":"string","description":"eCommerce Platform ID","x-description-i18n":{"vie":"Mã sàn thương mại điện tử"}},"marketplace_shop_name":{"type":"string","description":"eCommerce Platform Shop Name","x-description-i18n":{"vie":"Tên shop sàn thương mại điện tử"}},"note":{"type":"string","nullable":true,"description":"Note","x-description-i18n":{"vie":"Ghi chú"}},"order_id":{"type":"string","description":"Order ID","x-description-i18n":{"vie":"Mã đơn hàng"}},"original_order":{"type":"string","description":"Order ID to returned","x-description-i18n":{"vie":"Mã đơn hàng cần đổi trả"}},"reason":{"type":"string","description":"Reason for return","x-description-i18n":{"vie":"Lý do đổi trả"}},"shop_id":{"type":"integer","description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},"status":{"type":"string","description":"Status","x-description-i18n":{"vie":"Trạng thái"}},"tracking_number":{"type":"string","description":"Partner extend code","x-description-i18n":{"vie":"Mã vận đơn"}},"updated_at":{"type":"string","format":"date-time","description":"Updated at","x-description-i18n":{"vie":"Thời điểm cập nhật"}}}},"example":[{"amount":143834,"buyer":"phuongthaole28","id":21,"inserted_at":"2025-10-14T14:12:16","items":[{"amount":1,"images":["https://cf.shopee.sg/file/4ecbb6fa567e42c1b1e02993ad53df12"],"item_id":"ANPR","item_price":168630,"item_sku":"USB","model_id":297082992992,"name":"Áo nam Pari đẹp thời trang","refund_amount":143834,"variation_sku":"ANPR"}],"marketplace_id":"-3","marketplace_shop_name":"hoanganh230321131223","note":null,"order_id":"2408280F4HVBQRA","original_order":"HGL_RSO_1","reason":"DIFFERENT_DESCRIPTION","shop_id":20,"status":"completed","tracking_number":"fbjdnsdhuhwu","updated_at":"2025-10-24T08:04:56"}]},"page_number":{"type":"integer","description":"Page number","x-description-i18n":{"vie":"Số trang"}},"page_size":{"type":"integer","description":"Page size","x-description-i18n":{"vie":"Kích thước trang"}},"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}},"total_entries":{"type":"integer","description":"Total entries","x-description-i18n":{"vie":"Tổng số bản ghi"}},"total_pages":{"type":"integer","description":"Total pages","x-description-i18n":{"vie":"Tổng số trang"}}}}}}}}}},"/shops/{SHOP_ID}/order_call_laters":{"get":{"summary":"List of call later and remind","x-summary-i18n":{"vie":"Danh sách hẹn gọi & nhắc nhở"},"description":"Get list of call later and remind","x-description-i18n":{"vie":"Lấy danh sách hẹn gọi & nhắc nhở"},"tags":["Call Later"],"x-tags-i18n":{"vie":["Hẹn gọi & nhắc nhở"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},{"name":"page_number","in":"query","required":false,"schema":{"type":"integer","default":1},"description":"Page number","x-description-i18n":{"vie":"Số trang"},"example":1},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","default":30},"description":"Page size","x-description-i18n":{"vie":"Kích thước trang"},"example":30},{"name":"key","in":"query","required":false,"schema":{"type":"string","default":"today"},"description":"Key","x-description-i18n":{"vie":"Khóa"},"example":"today"},{"name":"status","in":"query","required":false,"schema":{"type":"integer","default":-1,"enum":[-1,0,3,1,2,7],"x-enum-descriptions":["All status","No process","Calling / Processing","Processed","Not listening / Unsuccessful","Removed"],"x-enum-descriptions-i18n":{"vie":["Tất cả trạng thái","Chưa xử lý","Đang gọi / Đang xử lý","Đã xử lý","Không nghe máy / Không thành công","Đã xóa"]},"example":-1},"description":"Status","x-description-i18n":{"vie":"Trạng thái"},"x-enum-descriptions-i18n":{"vie":["Tất cả trạng thái","Chưa xử lý","Đang gọi / Đang xử lý","Đã xử lý","Không nghe máy / Không thành công","Đã xóa"]}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","description":"List of call later and remind","x-description-i18n":{"vie":"Danh sách hẹn gọi & nhắc nhở"},"items":{"$ref":"#/components/schemas/CallLater"}},"key":{"type":"string","description":"Key","x-description-i18n":{"vie":"Khóa"}},"page_number":{"type":"integer","description":"Page number","x-description-i18n":{"vie":"Số trang"}},"page_size":{"type":"integer","description":"Page size","x-description-i18n":{"vie":"Kích thước trang"}},"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}},"total_entries":{"type":"integer","description":"Total entries","x-description-i18n":{"vie":"Tổng số bản ghi"}},"total_pages":{"type":"integer","description":"Total pages","x-description-i18n":{"vie":"Tổng số trang"}}}},"examples":{"default":{"value":{"success":true,"data":[{"called_at":"2024-01-30T01:54:17","creator":{"avatar_url":null,"email":"vuson897654@gmail.com","fb_id":"377936050731194","id":"cee3c05e-5f85-43c4-b27e-889b99c50097","name":"Vũ Sơn","phone_number":null},"display_id":70,"id":"1885d8d4-e210-4e56-bb32-683988a032f5","need_notify_users":["cee3c05e-5f85-43c4-b27e-889b99c50097"],"needs_call_at":"2024-01-30T02:20:48","notice_created":"Gọi lại cho khách","order_display_id":"SOICUN-12943-02","order_id":106703,"status":1,"type":"call"}],"key":"today","page_number":1,"page_size":30,"total_entries":3,"total_pages":1}}}}}}}},"post":{"summary":"Create call later and remind","x-summary-i18n":{"vie":"Tạo hẹn gọi & nhắc nhở"},"description":"Create call later and remind","x-description-i18n":{"vie":"Tạo hẹn gọi & nhắc nhở"},"tags":["Call Later"],"x-tags-i18n":{"vie":["Hẹn gọi & nhắc nhở"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}}],"requestBody":{"required":true,"description":"Request body containing call later and remind information","x-description-i18n":{"vie":"Thông tin yêu cầu chứa thông tin hẹn gọi & nhắc nhở"},"content":{"application/json":{"schema":{"type":"object","required":["order_call_later"],"properties":{"order_call_later":{"type":"object","required":["needs_call_at","phone_number"],"properties":{"status":{"type":"integer","description":"Status","x-description-i18n":{"vie":"Trạng thái"}},"need_notify_users":{"type":"array","description":"Process staff","x-description-i18n":{"vie":"Nhân viên xử lý"},"items":{"type":"string"}},"notice_created":{"type":"string","description":"Notice information","x-description-i18n":{"vie":"Thông tin thông báo"}},"needs_call_at":{"type":"string","format":"date-time","description":"Need call at","x-description-i18n":{"vie":"Thời điểm cần gọi"}},"phone_number":{"type":"string","description":"Phone number","x-description-i18n":{"vie":"Số điện thoại"}},"order_ids":{"type":"array","description":"Order IDs","x-description-i18n":{"vie":"Danh sách mã đơn hàng"},"items":{"type":"string"}}}}},"example":{"order_call_later":{"status":0,"need_notify_users":["cee3c05e-5f85-43c4-b27e-889b99c50097"],"notice_created":"Gọi lại xác nhận","needs_call_at":"2024-08-29T05:50:31.700Z","phone_number":"0929911922","order_ids":["106703"]}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}}}},"examples":{"default":{"$ref":"#/components/examples/SuccessResponse"}}}}}}}},"/shops/{SHOP_ID}/customers":{"get":{"summary":"Customer list","x-summary-i18n":{"vie":"Danh sách khách hàng"},"description":"Get list of customers","x-description-i18n":{"vie":"Lấy danh sách khách hàng"},"tags":["Customer"],"x-tags-i18n":{"vie":["Khách hàng"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","default":30,"example":30},"description":"Page size","x-description-i18n":{"vie":"Kích thước trang"}},{"name":"page_number","in":"query","required":false,"schema":{"type":"integer","default":1,"example":1},"description":"Page number","x-description-i18n":{"vie":"Số trang"}},{"name":"search","in":"query","required":false,"schema":{"type":"string","example":"0999999999"},"description":"Search keyword","x-description-i18n":{"vie":"Từ khóa tìm kiếm"}},{"name":"start_time_inserted_at","in":"query","required":false,"schema":{"type":"integer","example":0},"description":"Start time inserted","x-description-i18n":{"vie":"Thời điểm đầu tạo"}},{"name":"end_time_inserted_at","in":"query","required":false,"schema":{"type":"integer","example":0},"description":"End time inserted","x-description-i18n":{"vie":"Thời điểm cuối tạo"}},{"name":"start_time_updated_at","in":"query","required":false,"schema":{"type":"integer","example":0},"description":"Start time updated","x-description-i18n":{"vie":"Thời điểm đầu cập nhật"}},{"name":"end_time_updated_at","in":"query","required":false,"schema":{"type":"integer","example":0},"description":"End time updated","x-description-i18n":{"vie":"Thời điểm cuối cập nhật"}},{"name":"customer_ids","in":"query","required":false,"schema":{"type":"string","example":"96a8e283-3fba-492e-a35a-970f72a30a02,4c74b7cf-f87b-484e-8549-6872d964f78f"},"description":"Customer IDs (comma-separated)","x-description-i18n":{"vie":"Danh sách mã khách hàng (phân cách bằng dấu phẩy)"}},{"name":"selectedLevel[]","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"},"example":["508c9819-a681-4ae2-bcff-acf92bf4e5fa"]},"description":"Customer level IDs","x-description-i18n":{"vie":"Danh sách mã cấp độ khách hàng"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","description":"List of customers","x-description-i18n":{"vie":"Danh sách khách hàng"},"items":{"$ref":"#/components/schemas/Customer"}},"page_number":{"type":"integer","description":"Page number","x-description-i18n":{"vie":"Số trang"}},"page_size":{"type":"integer","description":"Page size","x-description-i18n":{"vie":"Kích thước trang"}},"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}},"total_entries":{"type":"integer","description":"Total entries","x-description-i18n":{"vie":"Tổng số bản ghi"}},"total_pages":{"type":"integer","description":"Total pages","x-description-i18n":{"vie":"Tổng số trang"}}}},"examples":{"default":{"value":{"success":true,"data":[{"id":"b0110315-b102-436b-8b3b-ed8d16740327","name":"Trần Văn Hoàng","gender":"male","emails":["thudo@gmail.com"],"phone_numbers":["0999999999"],"date_of_birth":"1999-09-01","reward_point":10,"is_discount_by_level":true,"tags":[],"is_block":false,"assigned_user_id":"cee3c05e-5f85-43c4-b27e-889b99c50097","level_id":null,"notes":[],"shop_customer_address":[{"id":"0fefd213-7d0c-4d5b-bdbf-35694da80857","country_code":null,"province_id":"101","district_id":"10101","commune_id":null,"address":"lê văn lương","full_address":"lê văn lương, Quận Ba Đình, Hà Nội","full_name":"test","phone_number":"0999999999"}],"order_count":108,"purchased_amount":0,"succeed_order_count":8,"last_order_at":"2020-04-01T10:18:41Z","conversation_link":"https://pancake.vn/2284322048329488?customer_id=fc0dda4f-8d2a-4e70-a34a-7a6a434c6475","referral_code":"1nw4geGA","fb_id":null,"customer_id":"96a8e283-3fba-492e-a35a-970f72a30a02","pages_customers":[{"id":256469571170000,"name":"Clonners","platform":"facebook"}]}]}}}}}}}},"post":{"summary":"Create customer","x-summary-i18n":{"vie":"Tạo khách hàng"},"description":"Create customer","x-description-i18n":{"vie":"Tạo khách hàng"},"tags":["Customer"],"x-tags-i18n":{"vie":["Khách hàng"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}}],"requestBody":{"required":true,"description":"Request body containing customer information to create","x-description-i18n":{"vie":"Thông tin yêu cầu chứa thông tin khách hàng cần tạo"},"content":{"application/json":{"schema":{"type":"object","required":["name","phoneNumber"],"properties":{"name":{"type":"string","description":"Customer name","x-description-i18n":{"vie":"Tên khách hàng"}},"phoneNumber":{"type":"string","description":"Phone number","x-description-i18n":{"vie":"Số điện thoại"}},"createType":{"type":"string","description":"Create type","x-description-i18n":{"vie":"Loại tạo"}},"dateOfBirth":{"type":"string","format":"date","description":"Date of birth","x-description-i18n":{"vie":"Ngày sinh"}},"last_order_at":{"type":"integer","description":"Last order timestamp","x-description-i18n":{"vie":"Thời điểm đơn hàng cuối"}},"shop_customer_address":{"type":"array","description":"Customer addresses","x-description-i18n":{"vie":"Danh sách địa chỉ khách hàng"},"items":{"type":"object","properties":{"full_address":{"type":"string","description":"Full address","x-description-i18n":{"vie":"Địa chỉ đầy đủ"}},"full_name":{"type":"string","description":"Full name","x-description-i18n":{"vie":"Họ tên đầy đủ"}},"phone_number":{"type":"string","description":"Phone number","x-description-i18n":{"vie":"Số điện thoại"}}}}}},"example":{"name":"Hoang","phoneNumber":"0909090909","createType":"force","dateOfBirth":"1995-02-01","last_order_at":1715878800,"shop_customer_address":[{"full_address":"190, phường dịch vọng, cầu giấy, hà nội","full_name":"hoang","phone_number":"0972868874"},{"full_address":"190, Mỹ đình 2, Nam từ liêm, hà nội","full_name":"hoang","phone_number":"0972868875"}]}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Customer"},"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}}}},"examples":{"default":{"value":{"success":true,"data":{"id":"9e749e68-142f-4587-a3b1-70279c30b5c2","name":"Nguyen Van Hoang","gender":null,"emails":[],"phone_numbers":["0903924956"],"date_of_birth":"1995-02-01","reward_point":0,"is_discount_by_level":true,"tags":[],"is_block":false,"assigned_user_id":"e4cec6de-96fa-4c16-9523-07910ddfee8e","level_id":null,"notes":[],"shop_customer_address":[{"id":"deeb419a-e7b6-42fd-9684-52ec6a72a41a","country_code":84,"province_id":null,"district_id":null,"commune_id":null,"address":null,"full_address":null,"full_name":null,"phone_number":"0903924956"}],"order_count":0,"purchased_amount":0,"succeed_order_count":0,"last_order_at":"2024-05-16T17:00:00Z","conversation_link":null,"referral_code":"gqo7ulKf","fb_id":null,"customer_id":"5b717afb-1856-48c9-9b6e-b8ac9db7d520"}}}}}}}}}},"/shops/{SHOP_ID}/customers/{CUSTOMER_ID}":{"get":{"summary":"Customer detail","x-summary-i18n":{"vie":"Thông tin chi tiết khách hàng"},"description":"Get detail information of a customer","x-description-i18n":{"vie":"Lấy thông tin chi tiết một khách hàng"},"tags":["Customer"],"x-tags-i18n":{"vie":["Khách hàng"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},{"name":"CUSTOMER_ID","in":"path","required":true,"schema":{"type":"string","example":"3f6e0e3c-7450-4af6-9a9f-50a6516e42e1"},"description":"Customer ID","x-description-i18n":{"vie":"Mã khách hàng"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Customer"},"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}}}},"examples":{"default":{"value":{"success":true,"data":[{"id":"b0110315-b102-436b-8b3b-ed8d16740327","name":"Trần Văn Hoàng","gender":"male","emails":["thudo@gmail.com"],"phone_numbers":["0999999999"],"date_of_birth":"1999-09-01","reward_point":10,"is_discount_by_level":true,"tags":[],"is_block":false,"assigned_user_id":"cee3c05e-5f85-43c4-b27e-889b99c50097","level_id":null,"notes":[],"shop_customer_address":[{"id":"0fefd213-7d0c-4d5b-bdbf-35694da80857","country_code":null,"province_id":"101","district_id":"10101","commune_id":null,"address":"lê văn lương","full_address":"lê văn lương, Quận Ba Đình, Hà Nội","full_name":"test","phone_number":"0999999999"}],"order_count":108,"purchased_amount":0,"succeed_order_count":8,"last_order_at":"2020-04-01T10:18:41Z","conversation_link":"https://pancake.vn/2284322048329488?customer_id=fc0dda4f-8d2a-4e70-a34a-7a6a434c6475","referral_code":"1nw4geGA","fb_id":null,"customer_id":"96a8e283-3fba-492e-a35a-970f72a30a02","pages_customers":[{"id":256469571170000,"name":"Clonners","platform":"facebook"}]}]}}}}}}}},"put":{"summary":"Update customer","x-summary-i18n":{"vie":"Cập nhật khách hàng"},"description":"Update customer","x-description-i18n":{"vie":"Cập nhật khách hàng"},"tags":["Customer"],"x-tags-i18n":{"vie":["Khách hàng"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},{"name":"CUSTOMER_ID","in":"path","required":true,"schema":{"type":"string","example":"96a8e283-3fba-492e-a35a-970f72a30a02"},"description":"Customer ID","x-description-i18n":{"vie":"Mã khách hàng"}}],"requestBody":{"required":true,"description":"Request body containing customer information to update","x-description-i18n":{"vie":"Thông tin yêu cầu chứa thông tin khách hàng cần cập nhật"},"content":{"application/json":{"schema":{"type":"object","required":["customer"],"properties":{"customer":{"$ref":"#/components/schemas/Customer"}},"example":{"customer":{"name":"Nguyễn Thị Hằng","gender":"female","emails":["pancake@gmail.com","hoang@gmail.com"],"phone_numbers":["0983925966"],"date_of_birth":"1995-03-04","reward_point":20,"is_discount_by_level":false,"tags":["Hay hoàn"],"is_block":false,"assigned_user_id":"cee3c05e-5f85-43c4-b27e-889b99c50097","level_id":"f8dced06-965d-4070-a765-dd8268373f1e","notes":[{"id":"8a6f5380-4674-44e9-aaf2-40d898d460f5","message":"Khách hàng thân thiết","images":[{"url":"https://content.pancake.vn/user-content-dev2.pancake.vn/2023/9/6/655ae9172118ba9ffde16fa129a7001a392d1fff.png"}]}],"shop_customer_address":[{"id":"df631f21-3841-4d1c-8204-b85a7ecfce0c","country_code":84,"province_id":"101","district_id":"10113","commune_id":"1011309","address":"190 Cầu Giấy","full_name":"sơn","phone_number":"0972868874"}],"order_count":7,"purchased_amount":1000000}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}}}},"examples":{"default":{"$ref":"#/components/examples/SuccessResponse"}}}}}}}},"/shops/{SHOP_ID}/customers/point_logs":{"get":{"summary":"Customer reward point history","x-summary-i18n":{"vie":"Lịch sử điểm thưởng khách hàng"},"description":"Get reward point history for a customer","x-description-i18n":{"vie":"Lấy lịch sử điểm thưởng của khách hàng"},"tags":["Customer"],"x-tags-i18n":{"vie":["Khách hàng"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},{"name":"shop_customer_id","in":"query","required":true,"schema":{"type":"string","example":"96a8e283-3fba-492e-a35a-970f72a30a02"},"description":"Customer ID","x-description-i18n":{"vie":"Mã khách hàng"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","default":30,"example":30},"description":"Page size","x-description-i18n":{"vie":"Kích thước trang"}},{"name":"page_number","in":"query","required":false,"schema":{"type":"integer","default":1,"example":1},"description":"Page number","x-description-i18n":{"vie":"Số trang"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","description":"List of point logs","x-description-i18n":{"vie":"Danh sách lịch sử điểm"},"items":{"type":"object","properties":{"amount":{"type":"number","description":"Number of points changed","x-description-i18n":{"vie":"Số điểm thay đổi"}},"creator":{"type":"object","description":"Creator information","x-description-i18n":{"vie":"Thông tin người tạo"},"properties":{"id":{"type":"string"},"name":{"type":"string"},"fb_id":{"type":"string"},"avatar_url":{"type":"string"}}},"current_point":{"type":"number","description":"Current point","x-description-i18n":{"vie":"Điểm hiện tại"}},"inserted_at":{"type":"string","format":"date-time","description":"Created at","x-description-i18n":{"vie":"Thời điểm tạo"}},"note":{"type":"string","description":"Reason for changing reward point","x-description-i18n":{"vie":"Lý do thay đổi điểm thưởng"}}}}},"page_number":{"type":"integer","description":"Page number","x-description-i18n":{"vie":"Số trang"}},"page_size":{"type":"integer","description":"Page size","x-description-i18n":{"vie":"Kích thước trang"}},"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}},"total_entries":{"type":"integer","description":"Total entries","x-description-i18n":{"vie":"Tổng số bản ghi"}},"total_pages":{"type":"integer","description":"Total pages","x-description-i18n":{"vie":"Tổng số trang"}}}},"examples":{"default":{"value":{"success":true,"data":[{"amount":10,"creator":{"id":"8fbe2a6f-b0b2-4227-a698-19d18c43f7c8","name":"Hoang Anh","fb_id":"2042723249341651","avatar_url":null},"current_point":100,"inserted_at":"2024-01-01T00:00:00Z","note":"Tích điểm từ đơn hàng"}]}}}}}}}}},"/shops/{SHOP_ID}/promotion_advance/create_multi":{"post":{"summary":"Create promotions by customer","x-summary-i18n":{"vie":"Tạo khuyến mãi theo khách hàng"},"description":"Create promotions for specific customers","x-description-i18n":{"vie":"Tạo khuyến mãi cho khách hàng cụ thể"},"tags":["Customer"],"x-tags-i18n":{"vie":["Khách hàng"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["promotion_advance"],"properties":{"promotion_advance":{"type":"object","required":["promotion","shop_customer_ids"],"properties":{"promotion":{"type":"object","required":["type","is_activated","promo_code_info"],"properties":{"start_time":{"type":"string","format":"date-time","description":"Start time","x-description-i18n":{"vie":"Thời điểm bắt đầu"}},"end_time":{"type":"string","format":"date-time","description":"End time","x-description-i18n":{"vie":"Thời điểm kết thúc"}},"warehouse_ids":{"type":"array","description":"Warehouse IDs to apply","x-description-i18n":{"vie":"Danh sách mã kho áp dụng"},"items":{"type":"string"}},"customer_tags":{"type":"array","description":"Customer tags","x-description-i18n":{"vie":"Thẻ khách hàng"},"items":{"type":"string"}},"type":{"type":"string","description":"Promotion type","x-description-i18n":{"vie":"Loại khuyến mãi"}},"is_activated":{"type":"boolean","description":"Activate","x-description-i18n":{"vie":"Kích hoạt"}},"promo_code_info":{"type":"object","required":["discount","is_percent"],"properties":{"discount":{"type":"integer","description":"Discount value","x-description-i18n":{"vie":"Giá trị giảm giá"}},"is_percent":{"type":"boolean","description":"Is percent","x-description-i18n":{"vie":"Là phần trăm"}},"max_discount_by_percent":{"type":"integer","description":"Maximum discount amount","x-description-i18n":{"vie":"Số tiền giảm giá tối đa"}},"disable":{"type":"boolean","description":"Disable","x-description-i18n":{"vie":"Vô hiệu hóa"}},"order_price_min":{"type":"integer","description":"Minimum order value","x-description-i18n":{"vie":"Giá trị đơn hàng tối thiểu"}},"order_price_max":{"type":"integer","description":"Maximum order value","x-description-i18n":{"vie":"Giá trị đơn hàng tối đa"}},"no_applied_products_in_other_promotions":{"type":"boolean","description":"Not applicable to products already included in other promotions","x-description-i18n":{"vie":"Không áp dụng cho sản phẩm đã có trong khuyến mãi khác"}},"discount_after_other_discount":{"type":"boolean","description":"Discount based on order value after deducting other discounts","x-description-i18n":{"vie":"Giảm giá dựa trên giá trị đơn hàng sau khi trừ các giảm giá khác"}}}}}},"shop_customer_ids":{"type":"array","description":"Customer IDs to apply","x-description-i18n":{"vie":"Danh sách mã khách hàng áp dụng"},"items":{"type":"string"}}}}},"example":{"promotion_advance":{"promotion":{"start_time":"2024-09-30T04:58:30.020Z","end_time":"2024-10-30T04:58:30.020Z","warehouse_ids":[],"customer_tags":[],"type":"discount_by_coupon_id","is_activated":true,"promo_code_info":{"discount":5,"is_percent":true,"max_discount_by_percent":100000,"disable":false,"order_price_min":2000000,"order_price_max":3000000,"no_applied_products_in_other_promotions":true,"discount_after_other_discount":true}},"shop_customer_ids":["a8c1113d-55c2-4f7e-b33a-d4ecd76668fd"]}}}}},"description":"Request body containing promotion information to create for customers","x-description-i18n":{"vie":"Thông tin yêu cầu chứa thông tin khuyến mãi cần tạo cho khách hàng"}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}}}},"examples":{"default":{"$ref":"#/components/examples/SuccessResponse"}}}}}}}},"/shops/{SHOP_ID}/customers/{CUSTOMER_ID}/load_customer_notes":{"get":{"summary":"List of notes","x-summary-i18n":{"vie":"Danh sách ghi chú"},"description":"Get list of customer notes","x-description-i18n":{"vie":"Lấy danh sách ghi chú khách hàng"},"tags":["Customer"],"x-tags-i18n":{"vie":["Khách hàng"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},{"name":"CUSTOMER_ID","in":"path","required":true,"schema":{"type":"string","example":"96a8e283-3fba-492e-a35a-970f72a30a02"},"description":"Customer ID","x-description-i18n":{"vie":"Mã khách hàng"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"customer_notes":{"type":"array","description":"List of customer notes","x-description-i18n":{"vie":"Danh sách ghi chú khách hàng"},"items":{"type":"object","properties":{"notes":{"type":"array","description":"Notes","x-description-i18n":{"vie":"Danh sách ghi chú"},"items":{"type":"object","properties":{"id":{"type":"string","description":"Note ID","x-description-i18n":{"vie":"Mã ghi chú"}},"message":{"type":"string","description":"Note content","x-description-i18n":{"vie":"Nội dung ghi chú"}},"images":{"type":"array","description":"Note images","x-description-i18n":{"vie":"Hình ảnh ghi chú"},"items":{"type":"string","format":"uri"}},"created_at":{"type":"integer","description":"Created at (unix timestamp)","x-description-i18n":{"vie":"Thời điểm tạo"}},"updated_at":{"type":"integer","description":"Updated at (unix timestamp)","x-description-i18n":{"vie":"Thời điểm cập nhật"}},"order_id":{"type":"string","description":"Order ID","x-description-i18n":{"vie":"Mã đơn hàng"}},"created_by":{"type":"object","description":"Creator information","x-description-i18n":{"vie":"Thông tin người tạo"},"properties":{"uid":{"type":"string"},"fb_id":{"type":"string"},"fb_name":{"type":"string"}}},"edit_history":{"type":"array","description":"Edit history","x-description-i18n":{"vie":"Lịch sử chỉnh sửa"},"items":{"type":"object"}}}}}}}}}},"examples":{"default":{"value":{"customer_notes":[{"notes":[{"id":"8a6f5380-4674-44e9-aaf2-40d898d460f5","message":"Khách hàng thân thiết","images":[{"url":"https://content.pancake.vn/user-content-dev2.pancake.vn/2023/9/6/655ae9172118ba9ffde16fa129a7001a392d1fff.png"}],"created_at":1693987200,"updated_at":1693987200,"order_id":"116947","created_by":{"uid":"cee3c05e-5f85-43c4-b27e-889b99c50097","fb_id":"377936050731194","fb_name":"Vũ Sơn"},"edit_history":[]}]}]}}}}}}}}},"/shops/{SHOP_ID}/customers/{CUSTOMER_ID}/create_note":{"post":{"summary":"Add note","x-summary-i18n":{"vie":"Thêm ghi chú"},"description":"Add a note to customer","x-description-i18n":{"vie":"Thêm ghi chú cho khách hàng"},"tags":["Customer"],"x-tags-i18n":{"vie":["Khách hàng"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},{"name":"CUSTOMER_ID","in":"path","required":true,"schema":{"type":"string","example":"96a8e283-3fba-492e-a35a-970f72a30a02"},"description":"Customer ID","x-description-i18n":{"vie":"Mã khách hàng"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"conversation_id":{"type":"string","description":"Conversation ID","x-description-i18n":{"vie":"Mã cuộc trò chuyện"}},"page_id":{"type":"string","description":"Page ID","x-description-i18n":{"vie":"Mã trang"}},"message":{"type":"string","description":"Note content","x-description-i18n":{"vie":"Nội dung ghi chú"}},"images":{"type":"array","description":"Note image information","x-description-i18n":{"vie":"Thông tin hình ảnh ghi chú"},"items":{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"Image URL","x-description-i18n":{"vie":"Link hình ảnh"}},"preview_url":{"type":"string","format":"uri","description":"Preview URL","x-description-i18n":{"vie":"Link xem trước"}},"name":{"type":"string","description":"Image name","x-description-i18n":{"vie":"Tên hình ảnh"}},"image_data":{"type":"object","properties":{"width":{"type":"integer"},"height":{"type":"integer"}}}}}},"order_id":{"type":"integer","description":"Order ID","x-description-i18n":{"vie":"Mã đơn hàng"}}},"example":{"conversation_id":"117967746266487_9306266852780716","page_id":"117967746266487","message":"khách hàng mua nhiều lần","images":[{"image_data":{"height":225,"width":225},"name":"iship thai.jpeg","preview_url":"https://content.pancake.vn/user-content-dev2.pancake.vn/2025/2/25/2488ecb12514520d9828390f695abc9db69a1452.jpg","url":"https://content.pancake.vn/user-content-dev2.pancake.vn/2025/2/25/2488ecb12514520d9828390f695abc9db69a1452.jpg"}],"order_id":116947}}}},"description":"Request body containing customer note information","x-description-i18n":{"vie":"Thông tin yêu cầu chứa thông tin ghi chú khách hàng"}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}}}},"examples":{"default":{"$ref":"#/components/examples/SuccessResponse"}}}}}}}},"/shops/{SHOP_ID}/customer_levels":{"get":{"summary":"Customer level list","x-summary-i18n":{"vie":"Danh sách cấp độ khách hàng"},"description":"Get list of customer levels","x-description-i18n":{"vie":"Lấy danh sách cấp độ khách hàng"},"tags":["Customer"],"x-tags-i18n":{"vie":["Khách hàng"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},{"name":"search","in":"query","required":false,"schema":{"type":"string","example":"Vip"},"description":"Customer level name","x-description-i18n":{"vie":"Tên cấp độ khách hàng"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","description":"List of customer levels","x-description-i18n":{"vie":"Danh sách cấp độ khách hàng"},"items":{"type":"object","properties":{"id":{"type":"string","description":"Level ID","x-description-i18n":{"vie":"Mã cấp độ"}},"name":{"type":"string","description":"Level name","x-description-i18n":{"vie":"Tên cấp độ"}},"color_customer_level":{"type":"string","description":"Color code of the level","x-description-i18n":{"vie":"Mã màu cấp độ"}},"discount":{"type":"integer","description":"Discount value","x-description-i18n":{"vie":"Giá trị giảm giá"}},"discount_type":{"type":"integer","description":"Discount type","x-description-i18n":{"vie":"Loại giảm giá"}},"shop_id":{"type":"integer","description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},"upgrade_by_order_count":{"type":"integer","description":"Upgrade by order count","x-description-i18n":{"vie":"Nâng cấp theo số lượng đơn hàng"}},"upgrade_by_point":{"type":"integer","description":"Upgrade by point","x-description-i18n":{"vie":"Nâng cấp theo điểm"}},"upgrade_by_total_purchase":{"type":"integer","description":"Upgrade by total purchase","x-description-i18n":{"vie":"Nâng cấp theo tổng giá trị mua"}}}}},"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}}}},"examples":{"default":{"value":{"success":true,"data":[{"id":"84fdef8b-8e4b-44e7-8d61-8553ee7f5833","name":"cap 1","color_customer_level":"#87d068","discount":5,"discount_type":3,"shop_id":20,"upgrade_by_order_count":10,"upgrade_by_point":100,"upgrade_by_total_purchase":30000000}]}}}}}}}}},"/shops/{SHOP_ID}/ads_manager/ad_accounts":{"get":{"summary":"List of ad accounts","x-summary-i18n":{"vie":"Danh sách tài khoản quảng cáo"},"description":"Get list of ad accounts","x-description-i18n":{"vie":"Lấy danh sách tài khoản quảng cáo"},"tags":["Ads Manager"],"x-tags-i18n":{"vie":["Quảng cáo"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":26290},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","example":1},"description":"Page number","x-description-i18n":{"vie":"Số trang"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","example":30},"description":"Number of records per page","x-description-i18n":{"vie":"Số bản ghi mỗi trang"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdAccount"},"examples":{"default":{"value":{"success":true,"data":[{"id":"786374497414442","name":"Jen Nhung","account_status":1,"currency":"VND","is_business":false,"sync_succeed_at":"2026-05-21T02:00:10","tags":["thẻ 2"]}],"page_number":1,"page_size":30,"total_entries":14,"total_pages":1}}}}}}}}},"/shops/{SHOP_ID}/ads_manager/campaigns_v2":{"get":{"summary":"List of ad campaigns","x-summary-i18n":{"vie":"Danh sách chiến dịch quảng cáo"},"description":"Get list of ad campaigns","x-description-i18n":{"vie":"Lấy danh sách chiến dịch quảng cáo"},"tags":["Ads Manager"],"x-tags-i18n":{"vie":["Quảng cáo"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":26290},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","example":1},"description":"Page number","x-description-i18n":{"vie":"Số trang"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","example":30},"description":"Number of records per page","x-description-i18n":{"vie":"Số bản ghi mỗi trang"}},{"$ref":"#/components/parameters/AdsStartTime"},{"$ref":"#/components/parameters/AdsEndTime"},{"$ref":"#/components/parameters/AdsSelectFields"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CampaignListResponse"},"examples":{"default":{"value":{"success":true,"data":[{"id":"120239433707310738","name":"Chiến dịch Valentine 2026","status":"ACTIVE","effective_status":"ACTIVE","objective":"OUTCOME_TRAFFIC","created_time":"2026-02-02T10:00:29","start_time":"2026-02-02T16:00:00","end_time":"2026-02-03T16:00:00","marketer_id":null,"product_id":"8d5e65f5-f1da-42bc-95b4-380f356388a9","product_category_id":null,"ad_account":{"id":"1427880307614733","name":"Quỳnh Dương","currency":"VND"},"insights":{"ad_ids":["120239433707300738"],"impressions":572,"clicks":14,"reach":512,"spend":59381,"cpc":4241.5,"cpm":103812.937063,"cpp":115978.515625,"ctr":2.44755244755245,"frequency":1.117188,"order_statistics":[{"id":0,"order_count":0},{"id":1,"order_count":0}]}}],"summary":{"impressions":11462,"clicks":19,"reach":11243,"spend":135140,"cpc":6827.631579,"cpm":11790.263479,"cpp":54927.700908,"ctr":0.165765137,"frequency":1.019478774},"page_number":1,"page_size":30,"total_entries":3,"total_pages":1}}}}}}}}},"/shops/{SHOP_ID}/ads_manager/ad_sets_v2":{"get":{"summary":"List of ad sets","x-summary-i18n":{"vie":"Danh sách nhóm quảng cáo"},"description":"Get list of ad sets","x-description-i18n":{"vie":"Lấy danh sách nhóm quảng cáo"},"tags":["Ads Manager"],"x-tags-i18n":{"vie":["Quảng cáo"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":26290},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","example":1},"description":"Page number","x-description-i18n":{"vie":"Số trang"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","example":30},"description":"Number of records per page","x-description-i18n":{"vie":"Số bản ghi mỗi trang"}},{"$ref":"#/components/parameters/AdsStartTime"},{"$ref":"#/components/parameters/AdsEndTime"},{"$ref":"#/components/parameters/AdsSelectFields"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdSetListResponse"},"examples":{"default":{"value":{"success":true,"data":[{"id":"120239433707290738","name":"Nhóm nam giới","status":"ACTIVE","effective_status":"ACTIVE","created_time":"2026-02-02T10:00:30","start_time":"2026-02-02T16:00:00","end_time":"2026-02-03T16:00:00","bid_amount":0,"bid_strategy":null,"billing_event":"IMPRESSIONS","daily_budget":0,"lifetime_budget":0,"destination_type":"FACEBOOK_PAGE","optimization_goal":"PROFILE_VISIT","marketer_id":null,"product_id":null,"product_category_id":null,"ad_account":{"id":"1427880307614733","name":"Quỳnh Dương","currency":"VND"},"ad_campaign":{"id":"120239433707310738","name":"Chiến dịch Valentine 2026"},"insights":{"ad_ids":["120239433707300738"],"impressions":572,"clicks":14,"reach":512,"spend":59381,"cpc":4241.5,"cpm":103812.937063,"cpp":115978.515625,"ctr":2.44755244755245,"frequency":1.117188},"targeting":{"age_min":18,"age_max":65,"age_range":[18,45],"genders":[1],"device_platforms":["mobile","desktop"],"publisher_platforms":["facebook"],"facebook_positions":["feed","facebook_reels","story"],"locales":[27],"geo_locations":{"countries":["VN"],"location_types":["home","recent"]},"flexible_spec":[{"interests":[{"id":"6003070856229","name":"Game (giải trí)"}],"behaviors":[{"id":"6002714895372","name":"Frequent Travelers"}],"life_events":[{"id":"6002714398172","name":"Newlywed (1 year)"}],"relationship_statuses":[2,4,3]}],"targeting_automation":{"advantage_audience":1}}}],"summary":{"impressions":11462,"clicks":19,"reach":11243,"spend":135140,"cpc":6827.631579,"cpm":11790.263479,"cpp":54927.700908,"ctr":0.165765137,"frequency":1.019478774},"page_number":1,"page_size":30,"total_entries":4,"total_pages":1}}}}}}}}},"/shops/{SHOP_ID}/ads_manager/ads_v2":{"get":{"summary":"List of ads","x-summary-i18n":{"vie":"Danh sách quảng cáo"},"description":"Get list of ads","x-description-i18n":{"vie":"Lấy danh sách quảng cáo"},"tags":["Ads Manager"],"x-tags-i18n":{"vie":["Quảng cáo"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":26290},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","example":1},"description":"Page number","x-description-i18n":{"vie":"Số trang"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","example":30},"description":"Number of records per page","x-description-i18n":{"vie":"Số bản ghi mỗi trang"}},{"$ref":"#/components/parameters/AdsStartTime"},{"$ref":"#/components/parameters/AdsEndTime"},{"$ref":"#/components/parameters/AdsSelectFields"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdListResponse"},"examples":{"default":{"value":{"success":true,"data":[{"id":"120238954106070738","name":"Quảng cáo sale nam giới","status":"ACTIVE","effective_status":"ACTIVE","created_time":"2026-01-21T09:12:15","marketer_id":null,"product_id":null,"product_category_id":null,"ad_account":{"id":"1427880307614733","name":"Quỳnh Dương","currency":"VND"},"ad_campaign":{"id":"120238946624470738","name":"Chiến dịch siêu sale tháng 2/2026"},"ad_set":{"id":"120238954106080738","name":"Nhóm nam giới"},"ad_creative":{"id":"1175732824344796","name":"✨ CƠ HỘI DUY NHẤT ĐỂ SỞ HỮU TRANG SỨC NIMORA VỚI ƯU ĐÃI ĐẾN 70% ✨","object_story_id":"926757717191948_122108102433202138","object_story_spec":null},"insights":{"ad_ids":["120238954106070738"],"impressions":8252,"clicks":4,"reach":8121,"spend":57381,"cpc":14345.25000025,"cpm":6953.58700888221,"cpp":7078.91138298451,"ctr":0.0484730974309258,"frequency":1.011012}}],"summary":{"impressions":11462,"clicks":19,"reach":11243,"spend":135140,"cpc":6827.631579,"cpm":11790.263479,"cpp":54927.700908,"ctr":0.165765137,"frequency":1.019478774},"page_number":1,"page_size":30,"total_entries":4,"total_pages":1}}}}}}}}},"/shops/{SHOP_ID}/debt":{"get":{"summary":"List of debt","x-summary-i18n":{"vie":"Danh sách công nợ"},"description":"Get list of debts","x-description-i18n":{"vie":"Lấy danh sách công nợ"},"tags":["Debt"],"x-tags-i18n":{"vie":["Công nợ"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"example":1},"description":"Page number","x-description-i18n":{"vie":"Số trang"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","default":30,"example":30},"description":"Page size","x-description-i18n":{"vie":"Kích thước trang"}},{"name":"status","in":"query","required":false,"schema":{"type":"integer","default":-1,"enum":[-1,0,1,2],"x-enum-descriptions":["All status","Not transacted / Partial payment","Traded","Canceled"],"x-enum-descriptions-i18n":{"vie":["Tất cả trạng thái","Chưa giao dịch / Thanh toán một phần","Đã giao dịch","Đã hủy"]},"example":-1},"description":"Status","x-description-i18n":{"vie":"Trạng thái"},"x-enum-descriptions-i18n":{"vie":["Tất cả trạng thái","Chưa giao dịch / Thanh toán một phần","Đã giao dịch","Đã hủy"]}},{"name":"shop_customer_id","in":"query","required":false,"schema":{"type":"string","example":"96a8e283-3fba-492e-a35a-970f72a30a02"},"description":"Customer ID","x-description-i18n":{"vie":"Mã khách hàng"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","description":"List of debts","x-description-i18n":{"vie":"Danh sách công nợ"},"items":{"$ref":"#/components/schemas/Debt"}},"page_number":{"type":"integer","description":"Page number","x-description-i18n":{"vie":"Số trang"}},"page_size":{"type":"integer","description":"Page size","x-description-i18n":{"vie":"Kích thước trang"}},"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}},"total_entries":{"type":"integer","description":"Total entries","x-description-i18n":{"vie":"Tổng số bản ghi"}},"total_pages":{"type":"integer","description":"Total pages","x-description-i18n":{"vie":"Tổng số trang"}},"sum":{"type":"integer","description":"Sum","x-description-i18n":{"vie":"Tổng"}}}},"examples":{"default":{"value":{"success":true,"data":[{"id":"3990cdc9-3f40-4086-9267-cd98a9d39a99","display_id":3597,"name_debt":"Công nợ tạo tự động","description":"Công nợ được tạo tự động từ tiền nợ khách đơn hàng #19872","status":1,"type":0,"money_must_pay_or_collect":100000,"money_payed_or_collected":100000,"currency":null,"shop_id":20,"shop_customer_id":"9f222ccc-920d-47f5-89b9-edd10b488b3b","shop_customer":{"id":"9f222ccc-920d-47f5-89b9-edd10b488b3b","name":"C. Hạnh","phone_numbers":["0334913933"],"customer":{"id":"6ef36ea4-08f6-42db-ba7b-6e5198ede786","name":"C. Hạnh","fb_id":null,"global_id":null,"psid":null}},"order_id":123106,"order":{"id":123106,"display_id":19872,"custom_id":null,"total_price":147485,"cod":-332536,"assigning_seller_id":"3b782812-babe-482c-b520-cd0bc9728062"},"purchase_id":null,"export_id":null,"supplier_products_id":null,"transaction_id":null,"partner_id":null,"creator_id":"cee3c05e-5f85-43c4-b27e-889b99c50097","last_editor_id":"cee3c05e-5f85-43c4-b27e-889b99c50097","user":{"id":"cee3c05e-5f85-43c4-b27e-889b99c50097","name":"Vũ Sơn","fb_id":"377936050731194","phone_number":null},"inserted_at":"2025-09-23T07:11:10Z","updated_at":"2025-09-23T07:11:10Z","expired_at":"2025-10-23T07:11:10Z","is_locked":null,"link":"https://pos.pancake.vn/shop/product/show-debt?link_key=c8a60d30-a147-4015-b5d8-3ad95f3a59aa"}]}}}}}}}}},"/shops/{SHOP_ID}/transactions":{"get":{"summary":"List of transaction","x-summary-i18n":{"vie":"Danh sách thu chi"},"description":"Get list of transactions","x-description-i18n":{"vie":"Lấy danh sách thu chi"},"tags":["Transaction"],"x-tags-i18n":{"vie":["Thu chi"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"example":1},"description":"Page number","x-description-i18n":{"vie":"Số trang"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","default":30,"example":30},"description":"Page size","x-description-i18n":{"vie":"Kích thước trang"}},{"name":"status","in":"query","required":false,"schema":{"type":"integer","default":-1,"enum":[-1,0,1,2,3],"x-enum-descriptions":["All status","New","Effective","Canceled","Deleted"],"x-enum-descriptions-i18n":{"vie":["Tất cả trạng thái","Mới","Có hiệu lực","Đã hủy","Đã xóa"]},"example":-1},"description":"Status","x-description-i18n":{"vie":"Trạng thái"},"x-enum-descriptions-i18n":{"vie":["Tất cả trạng thái","Mới","Có hiệu lực","Đã hủy","Đã xóa"]}},{"name":"startDateTime","in":"query","required":false,"schema":{"type":"integer","example":0},"description":"Start time","x-description-i18n":{"vie":"Thời điểm bắt đầu"}},{"name":"endDateTime","in":"query","required":false,"schema":{"type":"integer","example":0},"description":"End time","x-description-i18n":{"vie":"Thời điểm kết thúc"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","description":"List of transactions","x-description-i18n":{"vie":"Danh sách thu chi"},"items":{"$ref":"#/components/schemas/Transaction"}},"page_number":{"type":"integer","description":"Page number","x-description-i18n":{"vie":"Số trang"}},"page_size":{"type":"integer","description":"Page size","x-description-i18n":{"vie":"Kích thước trang"}},"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}},"total_entries":{"type":"integer","description":"Total entries","x-description-i18n":{"vie":"Tổng số bản ghi"}},"total_pages":{"type":"integer","description":"Total pages","x-description-i18n":{"vie":"Tổng số trang"}}}},"examples":{"default":{"value":{"success":true,"data":[{"id":"5b6bbae4-56b4-4189-a84d-d2ecfecead3e","display_id":"KH6815","name":"Giao dịch công nợ #1692 trả nhà cung cấp","note":"trả nhà cung cấp","amount":-70000,"status":1,"is_locked":false,"is_canceled":false,"is_accounting":false,"payment_debts_to_suppliers":false,"payments":["cash"],"tag_ids":["193a-e877-359a-b340-01d8-4d2e-2050","55f6-111c-2fd5-38e8-5b9d-009f-d3b1"],"supplier_products_id":293,"advertising_cost_id":null,"shop_id":20,"creator_id":"d6e6a545-f102-439e-9943-8ac8369f9735","creator":{"id":"d6e6a545-f102-439e-9943-8ac8369f9735","name":"vudzung12","fb_id":"1286585024855632","avatar_url":null},"images":["https://content.pancake.vn/user-content-dev2.pancake.vn/2022/7/7/eb376f0bf90f47d25396d49e4d547700f182981b.jpg"],"inserted_at":"2023-09-23T05:00:20Z","time_incurred":"2023-09-23T05:00:20Z","table_name":"debts","orderId":null}]}}}}}}}},"post":{"summary":"Create transaction","x-summary-i18n":{"vie":"Tạo phiếu thu chi"},"description":"Create transaction","x-description-i18n":{"vie":"Tạo phiếu thu chi"},"tags":["Transaction"],"x-tags-i18n":{"vie":["Thu chi"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["transaction"],"properties":{"transaction":{"type":"object","required":["name"],"properties":{"name":{"type":"string","description":"Transaction name","x-description-i18n":{"vie":"Tên giao dịch"}},"note":{"type":"string","description":"Note","x-description-i18n":{"vie":"Ghi chú"}},"amount":{"type":"integer","description":"Amount of money","x-description-i18n":{"vie":"Số tiền"}},"is_locked":{"type":"boolean","description":"Locked","x-description-i18n":{"vie":"Khóa"}},"tag_ids":{"type":"array","description":"Transaction tags","x-description-i18n":{"vie":"Thẻ giao dịch"},"items":{"type":"string"}},"payments":{"type":"array","description":"Payment method","x-description-i18n":{"vie":"Phương thức thanh toán"},"items":{"type":"string","enum":["cash","transfer_money","charged_by_card","charged_by_momo","charged_by_vnpay","charged_by_kredivo","charged_by_fundiin","charged_by_qrpay"],"x-enum-descriptions":["Cash","Transfer money","Charged by card","Momo","VNPay","Kredivo","Fundiin","QRpay"],"x-enum-descriptions-i18n":{"vie":["Tiền mặt","Chuyển khoản","Quẹt thẻ","Momo","VNPay","Kredivo","Fundiin","QRpay"]}}},"supplier_products_id":{"type":"integer","description":"Supplier products ID","x-description-i18n":{"vie":"Mã nhà cung cấp"}},"is_accounting":{"type":"boolean","description":"Financial accounting","x-description-i18n":{"vie":"Kế toán tài chính"}},"time_incurred":{"type":"string","format":"date-time","description":"Time incurred","x-description-i18n":{"vie":"Thời điểm phát sinh"}},"payment_debts_to_suppliers":{"type":"boolean","description":"Paying off debts to suppliers","x-description-i18n":{"vie":"Trả nợ nhà cung cấp"}},"images":{"type":"array","description":"Image links","x-description-i18n":{"vie":"Link hình ảnh"},"items":{"type":"string","format":"uri"}},"orderId":{"type":"string","description":"Order ID","x-description-i18n":{"vie":"Mã đơn hàng"}}}}},"example":{"transaction":{"name":"Thanh toán tiền hàng","note":"thanh toán tiền hàng","amount":-1000000,"is_locked":false,"tag_ids":["193a-e877-359a-b340-01d8-4d2e-2050"],"payments":["transfer_money"],"supplier_products_id":293,"is_accounting":true,"time_incurred":"2023-09-23T08:41:54.404Z","payment_debts_to_suppliers":true,"images":["https://content.pancake.vn/user-content-dev2.pancake.vn/2022/7/7/eb376f0bf90f47d25396d49e4d547700f182981b.jpg"],"orderId":"19785"}}}}},"description":"Request body containing transaction information to create","x-description-i18n":{"vie":"Thông tin yêu cầu chứa thông tin thu chi cần tạo"}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}}}},"examples":{"default":{"$ref":"#/components/examples/SuccessResponse"}}}}}}}},"/shops/{SHOP_ID}/adv_costs":{"post":{"summary":"Create advertising cost","x-summary-i18n":{"vie":"Tạo chi phí quảng cáo"},"description":"Create advertising cost","x-description-i18n":{"vie":"Tạo chi phí quảng cáo"},"tags":["Transaction"],"x-tags-i18n":{"vie":["Thu chi"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["params"],"properties":{"params":{"type":"object","required":["cost_date","transaction","items"],"properties":{"cost_date":{"type":"string","format":"date-time","description":"Cost date","x-description-i18n":{"vie":"Ngày chi phí"}},"transaction":{"type":"object","required":["name","status"],"properties":{"name":{"type":"string","description":"Transaction name","x-description-i18n":{"vie":"Tên giao dịch"}},"is_locked":{"type":"boolean","description":"Locked","x-description-i18n":{"vie":"Khóa"}},"note":{"type":"string","description":"Note","x-description-i18n":{"vie":"Ghi chú"}},"status":{"type":"string","description":"Status","x-description-i18n":{"vie":"Trạng thái"}},"time_incurred":{"type":"string","format":"date-time","description":"Time incurred","x-description-i18n":{"vie":"Thời điểm phát sinh"}},"tags":{"type":"array","description":"Advertising tags","x-description-i18n":{"vie":"Thẻ quảng cáo"},"items":{"type":"string"}}}},"items":{"type":"array","description":"Advertising items","x-description-i18n":{"vie":"Danh sách chi phí quảng cáo"},"items":{"type":"object","required":["cost"],"properties":{"cost":{"type":"integer","description":"Cost","x-description-i18n":{"vie":"Chi phí"}},"tax":{"type":"integer","description":"Tax percentage","x-description-i18n":{"vie":"Phần trăm thuế"}},"warehouse_id":{"type":"string","description":"Warehouse ID","x-description-i18n":{"vie":"Mã kho"}},"is_livestream":{"type":"boolean","description":"Is livestream","x-description-i18n":{"vie":"Là livestream"}},"product":{"type":"string","description":"Product ID","x-description-i18n":{"vie":"Mã sản phẩm"}},"pke_mkter":{"type":"string","description":"Marketer ID","x-description-i18n":{"vie":"Mã marketer"}},"source":{"type":"object","description":"Source","x-description-i18n":{"vie":"Nguồn"},"properties":{"key":{"type":"string"},"account":{"type":"string"}}},"is_wholesale":{"type":"boolean","description":"Wholesale","x-description-i18n":{"vie":"Bán sỉ"}},"post_ids":{"type":"array","description":"Post IDs","x-description-i18n":{"vie":"Danh sách mã bài đăng"},"items":{"type":"string"}}}}}}}},"example":{"params":{"cost_date":"2023-09-07 22:00:00","transaction":{"name":"Chi phí quảng cáo","is_locked":false,"note":"example","status":"0","time_incurred":"2023-09-07 15:00:00","tags":["Thẻ 1","Thẻ 2"]},"items":[{"cost":10000,"tax":5,"warehouse_id":"IS","is_livestream":true,"product":"1","pke_mkter":"test@gmail.com","source":{"key":"-3","account":"3"},"is_wholesale":true,"post_ids":["127967746288487_545680607828820"]}]}}}}},"description":"Request body containing advertising cost information to create","x-description-i18n":{"vie":"Thông tin yêu cầu chứa thông tin chi phí quảng cáo cần tạo"}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}}}},"examples":{"default":{"$ref":"#/components/examples/SuccessResponse"}}}}}}}},"/shops/{SHOP_ID}/payment_accounts/get_payment_histories":{"get":{"summary":"Transaction history","x-summary-i18n":{"vie":"Lịch sử giao dịch"},"description":"Get payment transaction history","x-description-i18n":{"vie":"Lấy lịch sử giao dịch thanh toán"},"tags":["Transaction"],"x-tags-i18n":{"vie":["Thu chi"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","description":"List of payment histories","x-description-i18n":{"vie":"Danh sách lịch sử thanh toán"},"items":{"type":"object","description":"Payment history information","x-description-i18n":{"vie":"Thông tin lịch sử thanh toán"}}},"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}}}},"examples":{"default":{"$ref":"#/components/examples/SuccessEmptyDataResponse"}}}}}}}},"/shops/{SHOP_ID}/products":{"post":{"summary":"Create product","x-summary-i18n":{"vie":"Tạo sản phẩm"},"description":"Create product","x-description-i18n":{"vie":"Tạo sản phẩm"},"tags":["Product"],"x-tags-i18n":{"vie":["Sản phẩm"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}}],"requestBody":{"required":true,"description":"Request body containing product information to create","x-description-i18n":{"vie":"Thông tin yêu cầu chứa thông tin sản phẩm cần tạo"},"content":{"application/json":{"schema":{"type":"object","required":["product"],"properties":{"product":{"$ref":"#/components/schemas/Product"}},"example":{"product":{"name":"Ao so mi nam","category_ids":[1290021044,201250699],"note_product":"Ghi chú sản phẩm","product_attributes":[{"name":"Màu","values":["Đen","Trắng","Đỏ"]},{"name":"Size","values":["S","M","L"]}],"tags":[193,51],"variations":[{"fields":[{"name":"Màu","value":"Trắng"},{"name":"Size","value":"M"}],"images":["https://statics.pancake.vn/user-content.pancake.vn/2021/8/5/fccd6.jpg"],"last_imported_price":30000,"retail_price":140000,"price_at_counter":123000,"weight":0,"barcode":"BARCODE123","custom_id":"VCUSTOMID","is_hidden":false,"variations_warehouses":[{"remain_quantity":10,"warehouse_id":"c52e67ad-d9d0-4276-abe4-e0c9f1f7d2da","batch_position":"lô 1","shelf_position":"1.2"}],"wholesale_price2":[{"levelProduct":"1","wholesalePrices":"100000"},{"levelProduct":"2","wholesalePrices":"200000"}]}],"weight":1,"custom_id":"PCUSTOMID","is_published":true,"materials":[182,193],"bonus_products":[{"quantity":1,"variation_id":"61fb5d14-107d-4b78-908d-8dc04f59d2d6","price_original":11000,"images":["https://statics.pancake.vn/user-content.pancake.vn/2021/8/5/fccd6.jpg"],"variation_info":{"id":"1","measure_group_id":"2220","measure_info":{"exchange_value":100000,"measure_id":2252},"name":"Combo 10 cây giống Cải nhún","product_id":"RAL10.2675","weight":1000}}],"keyword":"vai|cao cấp","brand_id":"c52e67ad-d9d0-4276-abe4-e0c9f1f7d2da"}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}}}},"examples":{"default":{"$ref":"#/components/examples/SuccessResponse"}}}}}}}},"/shops/{SHOP_ID}/products/{PRODUCT_ID}":{"put":{"summary":"Update product information","x-summary-i18n":{"vie":"Cập nhật thông tin sản phẩm"},"description":"Update product information","x-description-i18n":{"vie":"Cập nhật thông tin sản phẩm"},"tags":["Product"],"x-tags-i18n":{"vie":["Sản phẩm"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},{"name":"PRODUCT_ID","in":"path","required":true,"schema":{"type":"string","example":"3487e126-b0d9-4dae-89a9-ee60bef2f4e9"},"description":"Product ID","x-description-i18n":{"vie":"Mã sản phẩm"}}],"requestBody":{"required":true,"description":"Request body containing product information to update","x-description-i18n":{"vie":"Thông tin yêu cầu chứa thông tin sản phẩm cần cập nhật"},"content":{"application/json":{"schema":{"type":"object","required":["product"],"properties":{"product":{"$ref":"#/components/schemas/Product"}},"example":{"product":{"name":"Ao so mi nam","category_ids":[1290021044,201250699],"note_product":"Ghi chú sản phẩm","product_attributes":[{"name":"Màu","values":["Đen","Trắng","Đỏ"]},{"name":"Size","values":["S","M","L"]}],"variations":[{"id":"3c3aca82-030e-4708-a75b-b2eaf538a2f5","fields":[{"name":"Màu","value":"Trắng"},{"name":"Size","value":"M"}],"images":[],"last_imported_price":30000,"retail_price":140000,"price_at_counter":123000,"weight":0,"barcode":"BARCODE123","custom_id":"VCUSTOMID","is_hidden":false,"variations_warehouses":[{"remain_quantity":10,"warehouse_id":"c52e67ad-d9d0-4276-abe4-e0c9f1f7d2da","batch_position":"lô 1","shelf_position":"1.2"}],"wholesale_price2":[{"levelProduct":"1","wholesalePrices":"100000"},{"levelProduct":"2","wholesalePrices":"200000"}]},{"fields":[{"name":"Màu","value":"Đỏ"},{"name":"Size","value":"L"}],"images":["https://statics.pancake.vn/user-content.pancake.vn/2021/8/5/fccd6.jpg"],"last_imported_price":30000,"retail_price":140000,"price_at_counter":123000,"weight":0,"barcode":"BARCODE123","custom_id":"VCUSTOMID2","is_hidden":false,"variations_warehouses":[{"remain_quantity":10,"warehouse_id":"c52e67ad-d9d0-4276-abe4-e0c9f1f7d2da","batch_position":"lô 1","shelf_position":"1.2"}],"wholesale_price2":[{"levelProduct":"1","wholesalePrices":"100000"},{"levelProduct":"2","wholesalePrices":"200000"}]}],"weight":1,"custom_id":"PCUSTOMID","is_published":true,"tags":[193,51],"materials":[182,193],"bonus_products":[{"quantity":1,"variation_id":"61fb5d14-107d-4b78-908d-8dc04f59d2d6","price_original":11000,"images":["https://statics.pancake.vn/user-content.pancake.vn/2021/8/5/fccd6.jpg"],"variation_info":{"id":"1","measure_group_id":"2220","measure_info":{"exchange_value":100000,"measure_id":2252},"name":"Combo 10 cây giống Cải nhún","product_id":"RAL10.2675","weight":1000}}],"keyword":"vai|cao cấp"}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}}}},"examples":{"default":{"$ref":"#/components/examples/SuccessResponse"}}}}}}}},"/shops/{SHOP_ID}/variations/{VARIATION_ID}/update_quantity":{"post":{"summary":"Update inventory","x-summary-i18n":{"vie":"Cập nhật tồn kho"},"description":"Update inventory quantity for a variation","x-description-i18n":{"vie":"Cập nhật số lượng tồn kho cho mẫu mã"},"tags":["Product"],"x-tags-i18n":{"vie":["Sản phẩm"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},{"name":"VARIATION_ID","in":"path","required":true,"schema":{"type":"string","example":"415040f4-ab63-465e-8699-e9ebfff4c6c7"},"description":"Variation ID","x-description-i18n":{"vie":"Mã mẫu mã"}}],"requestBody":{"required":true,"description":"Request body containing inventory update information for a variation","x-description-i18n":{"vie":"Thông tin yêu cầu chứa thông tin cập nhật tồn kho cho mẫu mã"},"content":{"application/json":{"schema":{"type":"object","required":["variations_warehouses"],"properties":{"variations_warehouses":{"type":"array","description":"Warehouse info","x-description-i18n":{"vie":"Thông tin kho"},"items":{"type":"object","required":["remain_quantity","warehouse_id"],"properties":{"remain_quantity":{"type":"integer","description":"Remain quantity","x-description-i18n":{"vie":"Số lượng tồn"}},"warehouse_id":{"type":"string","description":"Warehouse ID","x-description-i18n":{"vie":"Mã kho"}}}}}},"example":{"variations_warehouses":[{"remain_quantity":20,"warehouse_id":"a41b5d73-9236-4a5d-9954-4db6d93242d1"},{"remain_quantity":20,"warehouse_id":"a41b5d73-9236-4a5d-9954-4db6d93242d4"},{"remain_quantity":20,"warehouse_id":"a41b5d73-9236-4a5d-9954-4db6d93242d5"}]}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}}}},"examples":{"default":{"$ref":"#/components/examples/SuccessResponse"}}}}}}}},"/shops/{SHOP_ID}/variations/update_quantity":{"post":{"summary":"Updated inventory of many variations","x-summary-i18n":{"vie":"Cập nhật tồn kho nhiều mẫu mã"},"description":"Update inventory quantity for multiple variations","x-description-i18n":{"vie":"Cập nhật số lượng tồn kho cho nhiều mẫu mã"},"tags":["Product"],"x-tags-i18n":{"vie":["Sản phẩm"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}}],"requestBody":{"required":true,"description":"Request body containing inventory update information for multiple variations","x-description-i18n":{"vie":"Thông tin yêu cầu chứa thông tin cập nhật tồn kho cho nhiều mẫu mã"},"content":{"application/json":{"schema":{"type":"object","required":["variations_warehouses"],"properties":{"is_actual_remain_quantity":{"type":"boolean","description":"true: Update inventory, false: Update sellable quantity","x-description-i18n":{"vie":"true: Cập nhật tồn kho, false: Cập nhật có thể bán"}},"variations_warehouses":{"type":"array","description":"Variations warehouses information","x-description-i18n":{"vie":"Thông tin tồn kho"},"items":{"type":"object","required":["variation_id","remain_quantity","warehouse_id"],"properties":{"variation_id":{"type":"string","description":"Variation ID","x-description-i18n":{"vie":"Mã mẫu mã"}},"remain_quantity":{"type":"integer","description":"Remain quantity","x-description-i18n":{"vie":"Số lượng tồn kho"}},"warehouse_id":{"type":"string","description":"Warehouse ID","x-description-i18n":{"vie":"Mã kho"}}}}}},"example":{"is_actual_remain_quantity":true,"variations_warehouses":[{"variation_id":"20e7d183-c70c-445e-8ce2-4d7e3a378e34","remain_quantity":15,"warehouse_id":"229102e4-39c3-4523-bd57-4ed0a45a85ba"},{"variation_id":"5f0cfb8d-aee9-4ec0-9ff0-b5668d3143d2","remain_quantity":15,"warehouse_id":"24c4447e-c35f-4acc-affa-70e49eb354d1"}]}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}}}},"examples":{"default":{"$ref":"#/components/examples/SuccessResponse"}}}}}}}},"/shops/{SHOP_ID}/variations/update_composite_product":{"post":{"summary":"Update composite product","x-summary-i18n":{"vie":"Cập nhật sản phẩm cấu thành"},"description":"Update composite product information","x-description-i18n":{"vie":"Cập nhật thông tin sản phẩm cấu thành"},"tags":["Product"],"x-tags-i18n":{"vie":["Sản phẩm"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}}],"requestBody":{"required":true,"description":"Request body containing composite product update information","x-description-i18n":{"vie":"Thông tin yêu cầu chứa thông tin cập nhật sản phẩm cấu thành"},"content":{"application/json":{"schema":{"type":"object","required":["variation_id","composite_products"],"properties":{"variation_id":{"type":"string","description":"Variation ID","x-description-i18n":{"vie":"Mã mẫu mã"}},"composite_products":{"type":"array","description":"Composite products","x-description-i18n":{"vie":"Danh sách sản phẩm cấu thành"},"items":{"type":"object","required":["quantity","component_id"],"properties":{"quantity":{"type":"integer","description":"Composite quantity","x-description-i18n":{"vie":"Số lượng cấu thành"}},"component_id":{"type":"string","description":"Composite variation ID","x-description-i18n":{"vie":"Mã mẫu mã cấu thành"}}}}}},"example":{"variation_id":"79aecce9-3b1e-4ad3-afe1-2ee658720687","composite_products":[{"quantity":1,"component_id":"67b19856-3226-457e-a746-df26e4ec1360"}]}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}}}},"examples":{"default":{"$ref":"#/components/examples/SuccessResponse"}}}}}}}},"/shops/{SHOP_ID}/products/variations":{"get":{"summary":"Product list","x-summary-i18n":{"vie":"Danh sách sản phẩm"},"description":"Get list of products and variations, including per-warehouse stock, selling speed (for low-stock detection), and suppliers.","x-description-i18n":{"vie":"Lấy danh sách sản phẩm và mẫu mã, kèm thông tin tồn kho theo từng kho, tốc độ bán (để phát hiện sản phẩm sắp hết hàng) và nhà cung cấp."},"tags":["Product"],"x-tags-i18n":{"vie":["Sản phẩm"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","default":30,"example":30},"description":"Page size","x-description-i18n":{"vie":"Kích thước trang"},"example":30},{"name":"page_number","in":"query","required":false,"schema":{"type":"integer","default":1,"example":1},"description":"Page number","x-description-i18n":{"vie":"Số trang"},"example":1},{"name":"search","in":"query","required":false,"schema":{"type":"string","example":"áo sơ mi"},"description":"Search keyword","x-description-i18n":{"vie":"Từ khóa tìm kiếm"},"example":"áo sơ mi"},{"name":"selling_status","in":"query","required":false,"schema":{"type":"string","enum":["none","bad","normal","star"],"x-enum-descriptions":["Testing","Sell slow","Normal","Sell fast"],"x-enum-descriptions-i18n":{"vie":["Thử nghiệm","Bán chậm","Bình thường","Bán nhanh"]},"example":"normal"},"description":"Selling speed","x-description-i18n":{"vie":"Tốc độ bán"}},{"name":"product_status","in":"query","required":false,"schema":{"type":"string","enum":["locked","not_locked"],"x-enum-descriptions":["Deactive","Active"],"x-enum-descriptions-i18n":{"vie":["Không hoạt động","Hoạt động"]},"example":"not_locked"},"description":"Product status","x-description-i18n":{"vie":"Trạng thái sản phẩm"}},{"name":"category_id[]","in":"query","required":false,"schema":{"type":"array","items":{"type":"integer"}},"description":"Category IDs","x-description-i18n":{"vie":"Danh sách mã danh mục"},"example":[1290021044,201250699]},{"name":"is_filter_categories_by_or","in":"query","required":false,"schema":{"type":"boolean","default":true},"description":"Filter category by \"or\" condition","x-description-i18n":{"vie":"Lọc danh mục theo điều kiện or"},"example":true},{"name":"filter_exclude_categories","in":"query","required":false,"schema":{"type":"boolean","default":false},"description":"Filter exclude category","x-description-i18n":{"vie":"Lọc loại trừ danh mục"},"example":false},{"name":"warehouse_until","in":"query","required":false,"schema":{"type":"string","format":"date-time"},"description":"Get inventory information at time","x-description-i18n":{"vie":"Lấy thông tin tồn kho tại 1 thời điểm"},"example":"2024-01-01T00:00:00Z"},{"name":"promotion_advance[]","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"}},"description":"Promotion advance ID","x-description-i18n":{"vie":"ID khuyến mãi nâng cao"},"example":["fb056b32-9cf6-4c5a-92de-0eb94db71121"]},{"name":"manipulationWarehouse[]","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"}},"description":"Manipulation warehouse ID","x-description-i18n":{"vie":"Mã kho thao tác"},"example":["a41b5d73-9236-4a5d-9954-4db6d93242d1"]},{"name":"startDate","in":"query","required":false,"schema":{"type":"integer"},"description":"Product creation start time","x-description-i18n":{"vie":"Thời điểm đầu tạo sản phẩm"},"example":1699635600},{"name":"endDate","in":"query","required":false,"schema":{"type":"integer"},"description":"Product creation end time","x-description-i18n":{"vie":"Thời điểm cuối tạo sản phẩm"},"example":1699635600},{"name":"start_time_update","in":"query","required":false,"schema":{"type":"integer"},"description":"Product update start time","x-description-i18n":{"vie":"Thời điểm đầu cập nhật sản phẩm"},"example":1699635600},{"name":"end_time_update","in":"query","required":false,"schema":{"type":"integer"},"description":"Product update end time","x-description-i18n":{"vie":"Thời điểm cuối cập nhật sản phẩm"},"example":1699635600},{"name":"included_composite","in":"query","required":false,"schema":{"type":"string","enum":["parent","children",false],"x-enum-descriptions":["Product is composed of other products","Composite product for other products","No filter"],"x-enum-descriptions-i18n":{"vie":["Sản phẩm được cấu thành từ sản phẩm khác","Sản phẩm cấu thành cho sản phẩm khác","Không lọc"]}},"description":"Filter composite products","x-description-i18n":{"vie":"Lọc sản phẩm cấu thành"},"x-enum-descriptions-i18n":{"vie":["Sản phẩm được cấu thành từ sản phẩm khác","Sản phẩm cấu thành cho sản phẩm khác","Không lọc"]},"example":"false"},{"name":"variation_ids[]","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"}},"description":"Filter by variation ID","x-description-i18n":{"vie":"Lọc theo mã sản phẩm"},"example":["20e7d183-c70c-445e-8ce2-4d7e3a378e34"]},{"name":"product_attributes[]","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"}},"description":"Filter by product attribute","x-description-i18n":{"vie":"Lọc theo thuộc tính sản phẩm"},"example":["blue"]},{"name":"remainQuantity","in":"query","required":false,"schema":{"type":"string","example":"{\"type\":\"smallerOrEqual\",\"value\":5,\"warehouseId\":\"all\"}"},"description":"Filter variations by **remaining (sellable) quantity** (`remain_quantity`). JSON-encoded object:\n  - `type`: `\"greaterOrEqual\"` | `\"smallerOrEqual\"` | `\"between\"`\n  - `value`: threshold for `greaterOrEqual` / `smallerOrEqual`\n  - `minValue`, `maxValue`: range for `between`\n  - `warehouseId`: `\"all\"` | a warehouse UUID | array of UUIDs — restricts which warehouses participate\n  - `isFilterTotal`: `false` (default) compares per-warehouse; `true` compares SUM across the selected warehouses\nWhen any quantity filter (`remainQuantity` / `actualQuantity` / `waittingQuantity` / `returningQuantity` / `pendingQuantity` / `totalQuantity`) is set, response variations include a `warehouse_ids` array listing the warehouses that matched.\n","x-description-i18n":{"vie":"Lọc theo **số tồn có thể bán** (`remain_quantity`). Truyền JSON dưới dạng chuỗi:\n  - `type`: `\"greaterOrEqual\"` | `\"smallerOrEqual\"` | `\"between\"`\n  - `value`: ngưỡng so sánh khi `type` là `greaterOrEqual` / `smallerOrEqual`\n  - `minValue`, `maxValue`: khoảng dùng khi `type` là `between`\n  - `warehouseId`: `\"all\"` | UUID kho | mảng UUID — giới hạn các kho tham gia lọc\n  - `isFilterTotal`: `false` (mặc định) so sánh từng kho; `true` so sánh TỔNG qua các kho được chọn\nKhi bất kỳ filter số lượng nào (`remainQuantity` / `actualQuantity` / `waittingQuantity` / `returningQuantity` / `pendingQuantity` / `totalQuantity`) được set, mỗi variation trong response sẽ có thêm trường `warehouse_ids` liệt kê các kho match điều kiện.\n"}},{"name":"actualQuantity","in":"query","required":false,"schema":{"type":"string","example":"{\"type\":\"greaterOrEqual\",\"value\":10,\"warehouseId\":\"all\"}"},"description":"Filter variations by **actual on-hand quantity** (`actual_remain_quantity`). Same JSON shape as `remainQuantity`.\n","x-description-i18n":{"vie":"Lọc theo **số tồn thực có trong kho** (`actual_remain_quantity`). Cùng cấu trúc JSON với `remainQuantity`.\n"}},{"name":"waittingQuantity","in":"query","required":false,"schema":{"type":"string","example":"{\"type\":\"greaterOrEqual\",\"value\":1,\"warehouseId\":\"all\"}"},"description":"Filter variations by **waiting/pending-to-ship quantity** (`waitting_quantity`). Same JSON shape as `remainQuantity`. (Note: param name keeps the `waitt-` spelling for backward compatibility with existing clients.)\n","x-description-i18n":{"vie":"Lọc theo **số lượng đang chờ giao** (`waitting_quantity`). Cùng cấu trúc JSON với `remainQuantity`. (Lưu ý: tên param giữ nguyên cách viết `waitt-` để tương thích với client hiện hữu.)\n"}},{"name":"returningQuantity","in":"query","required":false,"schema":{"type":"string","example":"{\"type\":\"greaterOrEqual\",\"value\":1,\"warehouseId\":\"all\"}"},"description":"Filter variations by **quantity in return process** (`returning_quantity`). Same JSON shape as `remainQuantity`.\n","x-description-i18n":{"vie":"Lọc theo **số lượng đang trả về kho** (`returning_quantity`). Cùng cấu trúc JSON với `remainQuantity`.\n"}},{"name":"pendingQuantity","in":"query","required":false,"schema":{"type":"string","example":"{\"type\":\"greaterOrEqual\",\"value\":1,\"warehouseId\":\"all\"}"},"description":"Filter variations by **reserved/pending quantity** (`pending_quantity`). Same JSON shape as `remainQuantity`.\n","x-description-i18n":{"vie":"Lọc theo **số lượng đang giữ chỗ** (`pending_quantity`). Cùng cấu trúc JSON với `remainQuantity`.\n"}},{"name":"totalQuantity","in":"query","required":false,"schema":{"type":"string","example":"{\"type\":\"between\",\"minValue\":1,\"maxValue\":100,\"warehouseId\":\"all\"}"},"description":"Filter variations by **total quantity** (`total_quantity`). Same JSON shape as `remainQuantity`.\n","x-description-i18n":{"vie":"Lọc theo **tổng số lượng** (`total_quantity`). Cùng cấu trúc JSON với `remainQuantity`.\n"}},{"name":"limit_quantity_to_warn","in":"query","required":false,"schema":{"type":"boolean","example":true},"description":"When `true`, return only products whose remaining stock has reached the per-product warning threshold — i.e. **\"running out of stock\"**. The threshold is configured per-product (`limit_quantity_to_warn` on Product or Variation, depending on the product's `warning_by_variation` setting).\n","x-description-i18n":{"vie":"Khi `true`, chỉ trả về sản phẩm có tồn kho đã chạm ngưỡng cảnh báo — tức **sản phẩm sắp hết hàng**. Ngưỡng được cấu hình theo từng sản phẩm (`limit_quantity_to_warn` trên Sản phẩm hoặc Mẫu mã, tùy theo cờ `warning_by_variation` của sản phẩm đó).\n"}},{"name":"defectQuantity","in":"query","required":false,"schema":{"type":"boolean","example":true},"description":"When `true`, return only variations that have **damaged/defective stock** (`defect_quantity > 0` in at least one warehouse).\n","x-description-i18n":{"vie":"Khi `true`, chỉ trả về mẫu mã có **hàng lỗi/hỏng** (`defect_quantity > 0` ở ít nhất một kho).\n"}},{"name":"nearly_out","in":"query","required":false,"schema":{"type":"boolean","example":true},"description":"When `true`, return only variations flagged as **nearly out of stock** in at least one warehouse (the precomputed `nearly_out` flag on the warehouse row). Similar to `limit_quantity_to_warn` but reads the stored per-warehouse flag instead of recomputing the threshold at query time.\n","x-description-i18n":{"vie":"Khi `true`, chỉ trả về mẫu mã được đánh dấu **sắp hết hàng** ở ít nhất một kho (cờ `nearly_out` đã tính sẵn trên row kho). Tương tự `limit_quantity_to_warn` nhưng đọc cờ đã lưu theo từng kho thay vì tính lại ngưỡng lúc query.\n"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","description":"List of products and variations","x-description-i18n":{"vie":"Danh sách sản phẩm và mẫu mã"},"items":{"type":"object","description":"Variation with product information","x-description-i18n":{"vie":"Mẫu mã kèm thông tin sản phẩm"},"properties":{"average_imported_price":{"type":"integer","description":"Average imported price","x-description-i18n":{"vie":"Giá nhập trung bình"}},"barcode":{"type":"string","nullable":true,"description":"Variation barcode","x-description-i18n":{"vie":"Mã barcode mẫu mã"}},"display_id":{"type":"string","description":"Display ID","x-description-i18n":{"vie":"Mã hiển thị"}},"is_hidden":{"type":"boolean","description":"Is hidden","x-description-i18n":{"vie":"Đã ẩn"}},"is_locked":{"type":"boolean","description":"Is locked","x-description-i18n":{"vie":"Đã khóa"}},"is_sell_negative_variation":{"type":"boolean","description":"Is sell negative variation","x-description-i18n":{"vie":"Cho phép bán âm"}},"fields":{"type":"array","description":"Variation fields","x-description-i18n":{"vie":"Thông tin thuộc tính mẫu mã"},"items":{"type":"object","properties":{"id":{"type":"string","description":"Field ID","x-description-i18n":{"vie":"Mã trường"}},"name":{"type":"string","description":"Field name","x-description-i18n":{"vie":"Tên trường"}},"value":{"type":"string","description":"Field value","x-description-i18n":{"vie":"Giá trị trường"}}}}},"id":{"type":"string","description":"Variation ID","x-description-i18n":{"vie":"Mã mẫu mã"}},"images":{"type":"array","description":"Variation images","x-description-i18n":{"vie":"Link hình ảnh mẫu mã"},"items":{"type":"string","format":"uri"}},"inserted_at":{"type":"string","format":"date-time","description":"Inserted at","x-description-i18n":{"vie":"Thời điểm tạo"}},"last_imported_price":{"type":"integer","description":"Last imported price","x-description-i18n":{"vie":"Giá nhập cuối"}},"price_at_counter":{"type":"integer","description":"Counter price","x-description-i18n":{"vie":"Giá tại quầy"}},"product_id":{"type":"string","description":"Product ID","x-description-i18n":{"vie":"Mã sản phẩm"}},"product":{"type":"object","description":"Product information","x-description-i18n":{"vie":"Thông tin sản phẩm"},"properties":{"note":{"type":"string","description":"Internal note","x-description-i18n":{"vie":"Ghi chú nội bộ"}},"note_product":{"type":"string","description":"Product note","x-description-i18n":{"vie":"Ghi chú sản phẩm"}},"categories":{"type":"array","description":"Categories","x-description-i18n":{"vie":"Danh mục"},"items":{"type":"object"}},"display_id":{"type":"string","description":"Display ID","x-description-i18n":{"vie":"Mã hiển thị"}},"image":{"type":"string","format":"uri","description":"Product image","x-description-i18n":{"vie":"Hình ảnh sản phẩm"}},"inserted_at":{"type":"string","format":"date-time","description":"Inserted at","x-description-i18n":{"vie":"Thời điểm tạo"}},"measure_group_id":{"type":"integer","description":"Measure group ID","x-description-i18n":{"vie":"Mã nhóm đơn vị tính"},"example":58},"name":{"type":"string","description":"Product name","x-description-i18n":{"vie":"Tên sản phẩm"}},"supplier_product_ids":{"type":"array","description":"Supplier product IDs","x-description-i18n":{"vie":"Danh sách mã sản phẩm nhà cung cấp"},"items":{"type":"integer"}},"tags":{"type":"array","description":"Product tags","x-description-i18n":{"vie":"Thẻ sản phẩm"},"items":{"type":"object","properties":{"id":{"type":"integer","description":"Tag ID","x-description-i18n":{"vie":"Mã thẻ"}},"note":{"type":"string","description":"Tag note","x-description-i18n":{"vie":"Ghi chú thẻ"}}}}},"is_published":{"type":"boolean","description":"Is published","x-description-i18n":{"vie":"Đã xuất bản"}},"manipulation_warehouses":{"type":"array","description":"Manipulation warehouses","x-description-i18n":{"vie":"Danh sách kho thao tác"},"items":{"type":"string"}},"product_attributes":{"type":"array","description":"Product attributes","x-description-i18n":{"vie":"Thông tin thuộc tính sản phẩm"},"items":{"type":"object","description":"Attribute","x-description-i18n":{"vie":"Thuộc tính"},"properties":{"name":{"type":"string","description":"Attribute name","x-description-i18n":{"vie":"Tên thuộc tính"}},"values":{"type":"array","description":"Attribute values","x-description-i18n":{"vie":"Giá trị thuộc tính"},"items":{"type":"string"}}}}},"brand_id":{"type":"string","format":"uuid","description":"Brand ID","x-description-i18n":{"vie":"Mã thương hiệu"}},"bonus_products":{"type":"array","description":"Bonus products","x-description-i18n":{"vie":"Sản phẩm tặng kèm"},"items":{"type":"object","properties":{"quantity":{"type":"integer","description":"Bonus product quantity","x-description-i18n":{"vie":"Số lượng sản phẩm tặng kèm"}},"variation_id":{"type":"string","description":"Variation ID of the bonus product","x-description-i18n":{"vie":"Mã mẫu mã của sản phẩm tặng kèm"}},"price_original":{"type":"integer","description":"Original price of the bonus product","x-description-i18n":{"vie":"Giá gốc của sản phẩm tặng kèm"}},"images":{"type":"array","description":"Bonus product images","x-description-i18n":{"vie":"Hình ảnh sản phẩm tặng kèm"},"items":{"type":"string","format":"uri"}},"variation_info":{"type":"object","description":"Variation information of the bonus product","x-description-i18n":{"vie":"Thông tin mẫu mã của sản phẩm tặng kèm"},"properties":{"id":{"type":"string","description":"Variation info ID","x-description-i18n":{"vie":"Mã thông tin mẫu mã"}},"measure_group_id":{"type":"string","description":"Measure group ID","x-description-i18n":{"vie":"Mã nhóm đơn vị tính"}},"measure_info":{"type":"object","description":"Measure unit information (present when measure_group_id exists)","x-description-i18n":{"vie":"Thông tin đơn vị tính (có khi có measure_group_id)"},"properties":{"exchange_value":{"type":"integer","description":"Exchange value","x-description-i18n":{"vie":"Giá trị quy đổi"}},"measure_id":{"type":"integer","description":"Measure ID","x-description-i18n":{"vie":"Mã đơn vị tính"}}}},"name":{"type":"string","description":"Variation name","x-description-i18n":{"vie":"Tên mẫu mã"}},"product_id":{"type":"string","description":"Product ID","x-description-i18n":{"vie":"Mã sản phẩm"}},"weight":{"type":"integer","description":"Weight","x-description-i18n":{"vie":"Trọng lượng"}}}}}}}}},"remain_quantity":{"type":"integer","description":"Remain quantity","x-description-i18n":{"vie":"Số lượng còn lại"}},"retail_price":{"type":"integer","description":"Retail price","x-description-i18n":{"vie":"Giá bán lẻ"}},"size":{"$ref":"#/components/schemas/VariationSize"},"total_purchase_price":{"type":"integer","description":"Total purchase price","x-description-i18n":{"vie":"Tổng giá mua"}},"variations_warehouses":{"type":"array","description":"Warehouse info","x-description-i18n":{"vie":"Thông tin tồn kho chi tiết"},"items":{"$ref":"#/components/schemas/VariationWarehouse"}},"warehouse_ids":{"type":"array","description":"Warehouse IDs that matched the active quantity filter. Only present in the response when one of `remainQuantity` / `actualQuantity` / `waittingQuantity` / `returningQuantity` / `pendingQuantity` / `totalQuantity` is set in the request.\n","x-description-i18n":{"vie":"Danh sách mã kho khớp với điều kiện lọc số lượng. Chỉ xuất hiện trong response khi request có set một trong các filter: `remainQuantity` / `actualQuantity` / `waittingQuantity` / `returningQuantity` / `pendingQuantity` / `totalQuantity`.\n"},"items":{"type":"string"}},"wholesale_price":{"type":"array","description":"Wholesale prices","x-description-i18n":{"vie":"Giá bán sỉ"},"items":{"type":"object"}},"price_table":{"type":"array","description":"Price table","x-description-i18n":{"vie":"Bảng giá"},"items":{"type":"object","properties":{"id":{"type":"string","description":"Price table ID","x-description-i18n":{"vie":"Mã bảng giá"}},"name":{"type":"string","description":"Price table name","x-description-i18n":{"vie":"Tên bảng giá"}},"price":{"type":"integer","description":"Price","x-description-i18n":{"vie":"Giá"}}}}},"keyword":{"type":"string","description":"Keyword"},"updated_at":{"type":"string","format":"date-time","description":"Updated at","x-description-i18n":{"vie":"Thời điểm cập nhật"}}}}},"page_number":{"type":"integer","description":"Page number","x-description-i18n":{"vie":"Số trang"}},"page_size":{"type":"integer","description":"Page size","x-description-i18n":{"vie":"Kích thước trang"}},"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}},"total_entries":{"type":"integer","description":"Total entries","x-description-i18n":{"vie":"Tổng số bản ghi"}},"total_pages":{"type":"integer","description":"Total pages","x-description-i18n":{"vie":"Tổng số trang"}}}},"examples":{"default":{"value":{"success":true,"data":[{"average_imported_price":50000,"barcode":null,"display_id":"ADXL","is_hidden":false,"is_locked":false,"is_sell_negative_variation":true,"fields":[{"id":"b032c515-3f71-4a1b-8e1d-77721ae72f37","name":"màu","value":"nâu"},{"id":"677c14b5-458f-4af6-8d73-08bcb2245547","name":"size","value":"s"}],"id":"e190db2b-1163-4cc3-b956-7a9528fbf5ef","images":["https://cf.shopee.vn/file/03e670d02803fcfbb17b2b719762ee17","https://cf.shopee.vn/file/9070bb1b0e6fcc84b46b6e5057544023"],"inserted_at":"2024-01-10T14:34:44.000000","last_imported_price":55000,"price_at_counter":123000,"product_id":"3b98a639-9d40-4faa-a692-6662f20e128d","product":{"note":"Dễ vỡ","note_product":"Ghi chú sản phẩm","categories":[],"display_id":"ADXL","image":"https://content.pancake.vn/user-content-dev2.pancake.vn/2024/11/7/1fdf82943574017240257bf9c88bc70a06a8813a.png","inserted_at":"2024-01-10T14:34:44","measure_group_id":58,"name":"ASOS đen XL","supplier_product_ids":[270],"tags":[{"id":51,"note":"the 3"},{"id":193,"note":"thẻ 1"}],"is_published":true,"manipulation_warehouses":["c52e67ad-d9d0-4276-abe4-e0c9f1f7d2da"],"product_attributes":[{"name":"Color","values":["black","white"]},{"name":"Size","values":["S","M"]}],"bonus_products":[{"quantity":1,"variation_id":"61fb5d14-107d-4b78-908d-8dc04f59d2d6","price_original":11000,"images":["https://statics.pancake.vn/user-content.pancake.vn/2021/8/5/fccd6.jpg"],"variation_info":{"id":"1","measure_group_id":"2220","measure_info":{"exchange_value":100000,"measure_id":2252},"name":"Combo 10 cây giống Cải nhún","product_id":"RAL10.2675","weight":1000}}]},"remain_quantity":20,"retail_price":140000,"size":{"length":10,"width":10,"height":10},"total_purchase_price":4500000,"variations_warehouses":[{"actual_remain_quantity":100,"pending_quantity":0,"remain_quantity":20,"returning_quantity":0,"selling_avg":0.23,"total_quantity":102,"warehouse_id":"a41b5d73-9236-4a5d-9954-4db6d93242d1"}],"wholesale_price":[],"price_table":[{"id":"a07c-3f7b-2db0-8002-6a88-7d4c-e7c3","name":"Giá bán sỉ","price":200000},{"id":"2251-43fa-9de5-765f-89ab-7246-c67b","name":"Giá bán lẻ","price":150000}],"keyword":"ANPR","updated_at":"2026-03-09T01:45:58.013616"}],"page_number":1,"page_size":30,"total_entries":751,"total_pages":26}}}}}}}}},"/shops/{SHOP_ID}/products/{PRODUCT_SKU}":{"get":{"summary":"Get product information","x-summary-i18n":{"vie":"Lấy thông tin 1 sản phẩm"},"description":"Get product information","x-description-i18n":{"vie":"Lấy thông tin 1 sản phẩm"},"tags":["Product"],"x-tags-i18n":{"vie":["Sản phẩm"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},{"name":"PRODUCT_SKU","in":"path","required":true,"schema":{"type":"string","example":"3487e126-b0d9-4dae-89a9-ee60bef2f4e9"},"description":"Product SKU or ID","x-description-i18n":{"vie":"Mã SKU hoặc ID sản phẩm"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Product"},"examples":{"default":{"value":{"measure_group_id":58,"name":"Ao so mi nam","category_ids":[1290021044,201250699],"note":"dễ vỡ","note_product":"Ghi chú sản phẩm","product_attributes":[{"name":"Color","values":["black","white"]},{"name":"Size","values":["s","m"]}],"tags":[193,51],"weight":1,"custom_id":"PCUSTOMID","is_published":true,"variations":[{"id":null,"fields":[{"name":"Màu","value":"Trắng"},{"name":"Size","value":"M"}],"images":["https://statics.pancake.vn/user-content.pancake.vn/2021/8/5/fccd6.jpg"],"last_imported_price":30000,"retail_price":140000,"price_at_counter":123000,"weight":0,"size":{"length":10,"width":10,"height":10},"barcode":"BARCODE123","custom_id":"VCUSTOMID","is_hidden":false,"variations_warehouses":[{"remain_quantity":10,"warehouse_id":"c52e67ad-d9d0-4276-abe4-e0c9f1f7d2da","batch_position":"lô 1","shelf_position":"1.2"}],"is_removed":false,"keyword":"VCUSTOMID"}],"variations_warehouses":[{"remain_quantity":10,"warehouse_id":"c52e67ad-d9d0-4276-abe4-e0c9f1f7d2da","batch_position":"lô 1","shelf_position":"1.2"}],"materials":[182,193],"bonus_products":[{"quantity":1,"variation_id":"61fb5d14-107d-4b78-908d-8dc04f59d2d6","price_original":11000,"images":["https://statics.pancake.vn/user-content.pancake.vn/2021/8/5/fccd6.jpg"],"variation_info":{"id":"1","measure_group_id":"2220","measure_info":{"exchange_value":100000,"measure_id":2252},"name":"Combo 10 cây giống Cải nhún","product_id":"RAL10.2675","weight":1000}}],"keyword":"vai|cao cấp"}}}}}}}}},"/shops/{SHOP_ID}/products/update_hide":{"put":{"summary":"Hide product","x-summary-i18n":{"vie":"Ẩn sản phẩm"},"description":"Hide product","x-description-i18n":{"vie":"Ẩn sản phẩm"},"tags":["Product"],"x-tags-i18n":{"vie":["Sản phẩm"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}}],"requestBody":{"required":true,"description":"Request body containing product hide/show information","x-description-i18n":{"vie":"Thông tin yêu cầu chứa thông tin ẩn/hiện sản phẩm"},"content":{"application/json":{"schema":{"type":"object","required":["is_hide","product_ids"],"properties":{"is_hide":{"type":"boolean","description":"Hide product","x-description-i18n":{"vie":"Ẩn sản phẩm"}},"product_ids":{"type":"array","description":"Product IDs","x-description-i18n":{"vie":"Danh sách mã sản phẩm"},"items":{"type":"string"}}},"example":{"is_hide":true,"product_ids":["3cbf2227-0205-446e-8c0e-584995f3cb23","36b1e64c-f1f7-4518-afeb-1f9d2edc0f3e"]}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}}}},"examples":{"default":{"$ref":"#/components/examples/SuccessResponse"}}}}}}}},"/shops/{SHOP_ID}/tags_products":{"post":{"summary":"Create product tag","x-summary-i18n":{"vie":"Tạo thẻ sản phẩm"},"description":"Create product tag","x-description-i18n":{"vie":"Tạo thẻ sản phẩm"},"tags":["Product"],"x-tags-i18n":{"vie":["Sản phẩm"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}}],"requestBody":{"required":true,"description":"Request body containing product tag information to create","x-description-i18n":{"vie":"Thông tin yêu cầu chứa thông tin thẻ sản phẩm cần tạo"},"content":{"application/json":{"schema":{"type":"object","required":["name"],"properties":{"name":{"type":"string","description":"Tag name","x-description-i18n":{"vie":"Tên thẻ"}}},"example":{"name":"Sản phẩm dễ vỡ"}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","description":"Product tag information","x-description-i18n":{"vie":"Thông tin thẻ sản phẩm"},"properties":{"id":{"type":"integer","description":"Tag ID","x-description-i18n":{"vie":"Mã thẻ"}},"name":{"type":"string","description":"Tag name","x-description-i18n":{"vie":"Tên thẻ"}},"note":{"type":"string","description":"Tag note","x-description-i18n":{"vie":"Ghi chú thẻ"}},"shop_id":{"type":"integer","description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},"inserted_at":{"type":"string","format":"date-time","description":"Created at","x-description-i18n":{"vie":"Thời điểm tạo"}},"updated_at":{"type":"string","format":"date-time","description":"Updated at","x-description-i18n":{"vie":"Thời điểm cập nhật"}}}},"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}}}},"examples":{"default":{"value":{"success":true,"data":{"id":368,"index":null,"inserted_at":"2025-09-19T10:26:38","note":"Sản phẩm dễ vỡ","shop_id":20,"updated_at":"2025-09-19T10:26:38"}}}}}}}}}},"/shops/{SHOP_ID}/categories":{"get":{"summary":"Product categories","x-summary-i18n":{"vie":"Danh mục sản phẩm"},"description":"Get list of product categories","x-description-i18n":{"vie":"Lấy danh sách danh mục sản phẩm"},"tags":["Product"],"x-tags-i18n":{"vie":["Sản phẩm"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","description":"List of categories","x-description-i18n":{"vie":"Danh sách danh mục"},"items":{"type":"object","properties":{"id":{"type":"integer","description":"Category ID","x-description-i18n":{"vie":"Mã danh mục"}},"text":{"type":"string","description":"Category name","x-description-i18n":{"vie":"Tên danh mục"}},"nodes":{"type":"array","description":"Sub-categories","x-description-i18n":{"vie":"Danh mục con"},"items":{"type":"object"}}}}},"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}}}},"examples":{"default":{"value":{"success":true,"data":[{"id":865301,"nodes":[],"text":"AirSense Áo Khoác Siêu Nhẹ"},{"id":30163,"nodes":[{"id":30167,"nodes":[],"text":"Áo Thun"},{"id":30169,"nodes":[{"id":865293,"nodes":[],"text":"Áo Thun In Họa Tiết"}],"text":"Áo Cardigan"},{"id":865292,"nodes":[],"text":"Áo Nỉ & Áo Hoodie"}],"text":"ÁO"}]}}}}}}}},"post":{"summary":"Create product category","x-summary-i18n":{"vie":"Tạo danh mục sản phẩm"},"description":"Create product category","x-description-i18n":{"vie":"Tạo danh mục sản phẩm"},"tags":["Product"],"x-tags-i18n":{"vie":["Sản phẩm"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}}],"requestBody":{"required":true,"description":"Request body containing product category information to create","x-description-i18n":{"vie":"Thông tin yêu cầu chứa thông tin danh mục sản phẩm cần tạo"},"content":{"application/json":{"schema":{"type":"object","required":["name"],"properties":{"name":{"type":"string","description":"Category name","x-description-i18n":{"vie":"Tên danh mục"}},"parent_id":{"type":"string","description":"Parent category ID","x-description-i18n":{"vie":"Mã danh mục cha"}}},"example":{"name":"Sản phẩm dễ vỡ","parent_id":30163}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Category"},"examples":{"default":{"value":{"success":true,"data":{"id":3299,"name":"Sản phẩm dễ vỡ"}}}}}}}}}},"/shops/{SHOP_ID}/brand":{"get":{"summary":"Product brand list","x-summary-i18n":{"vie":"Danh sách thương hiệu sản phẩm"},"description":"Get list of product brands","x-description-i18n":{"vie":"Lấy danh sách thương hiệu sản phẩm"},"tags":["Product"],"x-tags-i18n":{"vie":["Sản phẩm"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","example":1},"description":"Page number","x-description-i18n":{"vie":"Số trang"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","default":30,"example":30},"description":"Page size","x-description-i18n":{"vie":"Kích thước trang"}},{"name":"search","in":"query","required":false,"schema":{"type":"string","example":"Movado"},"description":"Search by brand name or brand ID","x-description-i18n":{"vie":"Tìm kiếm theo tên thương hiệu hoặc mã thương hiệu"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","description":"List of brands","x-description-i18n":{"vie":"Danh sách thương hiệu"},"items":{"$ref":"#/components/schemas/Brand"}}}},"examples":{"default":{"value":{"data":[{"id":"921f6676-4103-4b63-8503-78737fa74d11","name":"Movado","description":"Brand of Viet Nam","inserted_at":"2025-09-05T08:43:54","updated_at":"2025-09-05T08:43:54","shop_id":2044252,"display_id":170}]}}}}}}}}},"/shops/{SHOP_ID}/materials_products":{"get":{"summary":"Product material","x-summary-i18n":{"vie":"Chất liệu sản phẩm"},"description":"Get list of product materials","x-description-i18n":{"vie":"Lấy danh sách chất liệu sản phẩm"},"tags":["Product"],"x-tags-i18n":{"vie":["Sản phẩm"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","description":"List of materials","x-description-i18n":{"vie":"Danh sách chất liệu"},"items":{"type":"object","properties":{"description":{"type":"string","description":"Description","x-description-i18n":{"vie":"Mô tả"}},"id":{"type":"integer","description":"Material ID","x-description-i18n":{"vie":"Mã chất liệu"}},"name":{"type":"string","description":"Material name","x-description-i18n":{"vie":"Tên chất liệu"}},"nodes":{"type":"array","description":"Children materials","x-description-i18n":{"vie":"Chất liệu con"},"items":{"type":"object","properties":{"description":{"type":"string","description":"Description","x-description-i18n":{"vie":"Mô tả"}},"id":{"type":"integer","description":"Material ID","x-description-i18n":{"vie":"Mã chất liệu"}},"name":{"type":"string","description":"Material name","x-description-i18n":{"vie":"Tên chất liệu"}},"nodes":{"type":"array","description":"Children materials","x-description-i18n":{"vie":"Chất liệu con"},"items":{"type":"object"}}}}}}}},"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}}}},"examples":{"default":{"value":{"success":true,"data":[{"description":"cao cấp","id":180,"name":"vai","nodes":[{"description":"chất liệu bò","id":181,"name":"vải bò","nodes":[]}]}]}}}}}}}}},"/shops/{SHOP_ID}/product_measurements/get_measure":{"get":{"summary":"List of measure groups","x-summary-i18n":{"vie":"Danh sách nhóm đơn vị tính"},"description":"Get list of measure groups","x-description-i18n":{"vie":"Lấy danh sách nhóm đơn vị tính"},"tags":["Product"],"x-tags-i18n":{"vie":["Sản phẩm"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","description":"List of measure groups","x-description-i18n":{"vie":"Danh sách nhóm đơn vị tính"},"items":{"type":"object","properties":{"id":{"type":"integer","description":"Measure group ID","x-description-i18n":{"vie":"Mã nhóm ĐVT"}},"name":{"type":"string","description":"Measure group name","x-description-i18n":{"vie":"Tên nhóm ĐVT"}},"nodes":{"type":"array","description":"Measure group information","x-description-i18n":{"vie":"Thông tin ĐVT thuộc nhóm"},"items":{"type":"object","properties":{"exchange_value":{"type":"integer","description":"Exchange value","x-description-i18n":{"vie":"Tỷ lệ quy đổi"}},"id":{"type":"integer","description":"Measure ID","x-description-i18n":{"vie":"Mã ĐVT"}},"is_default":{"type":"boolean","description":"Default measure","x-description-i18n":{"vie":"ĐVT mặc định"}},"name":{"type":"string","description":"Measure name","x-description-i18n":{"vie":"Tên ĐVT"}},"parent_id":{"type":"integer","description":"Measure group ID","x-description-i18n":{"vie":"Mã nhóm ĐVT"}}}}},"shop_id":{"type":"integer","description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}}}}},"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}}}},"examples":{"default":{"value":{"success":true,"data":[{"id":58,"name":"Nước hoa 1","nodes":[{"exchange_value":30,"id":61,"is_default":false,"name":"30 ml","parent_id":58}],"shop_id":20}]}}}}}}}}},"/shops/{SHOP_ID}/supplier":{"get":{"summary":"Supplier list","x-summary-i18n":{"vie":"Danh sách nhà cung cấp"},"description":"Get list of suppliers","x-description-i18n":{"vie":"Lấy danh sách nhà cung cấp"},"tags":["Supplier"],"x-tags-i18n":{"vie":["Nhà cung cấp"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","description":"List of suppliers","x-description-i18n":{"vie":"Danh sách nhà cung cấp"},"items":{"type":"object","properties":{"address":{"type":"string","description":"Shipping address","x-description-i18n":{"vie":"Địa chỉ"}},"commune_id":{"type":"string","description":"Commune ID","x-description-i18n":{"vie":"Mã phường xã"}},"country_code":{"type":"integer","description":"Country code","x-description-i18n":{"vie":"Mã quốc gia"}},"custom_id":{"type":"string","description":"Supplier products ID","x-description-i18n":{"vie":"Mã nhà cung cấp"}},"debt_must_pay":{"type":"string","description":"Debt must pay","x-description-i18n":{"vie":"Công nợ phải trả"}},"description":{"type":"string","description":"Description","x-description-i18n":{"vie":"Mô tả"}},"district_id":{"type":"string","description":"District ID","x-description-i18n":{"vie":"Mã quận huyện"}},"full_address":{"type":"string","description":"Full address","x-description-i18n":{"vie":"Địa chỉ đầy đủ"}},"id":{"type":"integer","description":"Supplier ID","x-description-i18n":{"vie":"Mã nhà cung cấp"}},"images":{"type":"array","description":"Image links","x-description-i18n":{"vie":"Link hình ảnh"},"items":{"type":"string","format":"uri"}},"is_activated":{"type":"boolean","description":"Active status","x-description-i18n":{"vie":"Trạng thái kích hoạt"}},"name":{"type":"string","description":"Supplier name","x-description-i18n":{"vie":"Tên nhà cung cấp"}},"payment_info":{"type":"object","description":"Payment information","x-description-i18n":{"vie":"Thông tin thanh toán"},"properties":{"account_name":{"type":"string","description":"Account name","x-description-i18n":{"vie":"Tên tài khoản"}},"account_number":{"type":"string","description":"Account number","x-description-i18n":{"vie":"Số tài khoản"}},"partner_code":{"type":"string","description":"Partner code","x-description-i18n":{"vie":"Mã đối tác"}}}},"phone_number":{"type":"string","description":"Phone number","x-description-i18n":{"vie":"Số điện thoại"}},"province_id":{"type":"string","description":"Province ID","x-description-i18n":{"vie":"Mã tỉnh thành"}},"tags":{"type":"array","description":"Tags","x-description-i18n":{"vie":"Thẻ"},"items":{"type":"integer"}},"total_purchase":{"type":"string","description":"Total purchase","x-description-i18n":{"vie":"Tổng mua"}},"type":{"type":"integer","description":"Supplier type","x-description-i18n":{"vie":"Loại nhà cung cấp"}}}}},"page_number":{"type":"integer","description":"Page number","x-description-i18n":{"vie":"Số trang"}},"page_size":{"type":"integer","description":"Page size","x-description-i18n":{"vie":"Kích thước trang"}},"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}},"total_debt":{"type":"integer","description":"Total debt","x-description-i18n":{"vie":"Tổng công nợ"}},"total_entries":{"type":"integer","description":"Total entries","x-description-i18n":{"vie":"Tổng số bản ghi"}},"total_pages":{"type":"integer","description":"Total pages","x-description-i18n":{"vie":"Tổng số trang"}}}},"examples":{"default":{"value":{"success":true,"data":[{"address":"90 cầu giấy","commune_id":"1011309","country_code":84,"custom_id":"HH","debt_must_pay":"88334","description":null,"district_id":"10113","full_address":"90 cầu giấy, Phường Dịch Vọng, Quận Cầu Giấy, Hà Nội","id":988,"images":["https://content.pancake.vn/user-content-dev2.pancake.vn/2025/7/9/8029d570d92ca81812c6ed59465fe75db042e7f9.png"],"is_activated":true,"name":"CT TNHH Hồng Hà","payment_info":{"account_name":"THANG LONG","account_number":"123456789","partner_code":"CTG"},"phone_number":"0983239908","province_id":"101","tags":[5],"total_purchase":"344444","type":0}]}}}}}}}}},"/shops/{SHOP_ID}/purchases":{"get":{"summary":"List of purchases","x-summary-i18n":{"vie":"Danh sách phiếu nhập kho"},"description":"Get list of purchases","x-description-i18n":{"vie":"Lấy danh sách phiếu nhập kho"},"tags":["Purchase"],"x-tags-i18n":{"vie":["Phiếu nhập kho"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"example":1},"description":"Page number","x-description-i18n":{"vie":"Số trang"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","default":30,"example":30},"description":"Page size","x-description-i18n":{"vie":"Kích thước trang"}},{"name":"status","in":"query","required":false,"schema":{"type":"integer","default":-2,"enum":[-2,-1,0,1,2],"x-enum-descriptions":["All status","New","Confirmed","Imported goods","Canceled"],"x-enum-descriptions-i18n":{"vie":["Tất cả trạng thái","Mới","Đã xác nhận","Đã nhập hàng","Đã hủy"]},"example":-2},"description":"Status","x-description-i18n":{"vie":"Trạng thái"},"x-enum-descriptions-i18n":{"vie":["Tất cả trạng thái","Mới","Đã xác nhận","Đã nhập hàng","Đã hủy"]}},{"name":"type","in":"query","required":false,"schema":{"type":"string","default":"product","example":"product"},"description":"Type","x-description-i18n":{"vie":"Loại"}},{"name":"get_time_import","in":"query","required":false,"schema":{"type":"boolean","default":false,"example":true},"description":"Get time import","x-description-i18n":{"vie":"Lấy thời gian nhập hàng"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","description":"List of purchases","x-description-i18n":{"vie":"Danh sách phiếu nhập kho"},"items":{"$ref":"#/components/schemas/Purchase"}},"page_number":{"type":"integer","description":"Page number","x-description-i18n":{"vie":"Số trang"}},"page_size":{"type":"integer","description":"Page size","x-description-i18n":{"vie":"Kích thước trang"}},"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}},"total_entries":{"type":"integer","description":"Total entries","x-description-i18n":{"vie":"Tổng số bản ghi"}},"total_pages":{"type":"integer","description":"Total pages","x-description-i18n":{"vie":"Tổng số trang"}}}},"examples":{"default":{"value":{"success":true,"data":[{"id":"96bbc665-3fd5-4efc-9d8a-0110ecfa1754","display_id":6392,"status":0,"time_import":"2025-12-02T07:41:50.363889","total_quantity":1,"total_remain_quantity":1,"total_price":200000,"total_remain_price":200000,"note":"nhập kho sản phẩm","warehouse_id":"c52e67ad-d9d0-4276-abe4-e0c9f1f7d2da","supplier_products_id":293,"supplier":{"id":724,"name":"CT TNHH Hồng Hà","custom_id":"HH"},"discount":10000,"transport_fee":10000,"prepaid_debt":100000,"auto_create_debts":true,"not_create_transaction":true,"is_lock":null,"created_type":"actual_purchase","tags":[1],"tag_info":[{"id":1,"name":"Nhập hàng để bán"}],"items":[{"id":"02cb1ff3-9b21-4e1c-9288-a29c16bd907d","imported_price":200000,"gross_price":200000,"discount":10000,"quantity":1,"variation_id":"20e7d183-c70c-445e-8ce2-4d7e3a378e34","product_name":"Áo nam","note_purchase":"áo nam thời trang","selling_status":"bad","variation":{"id":"69416fa6-4c3d-451f-897d-9faa0420c060","display_id":"mauma1","barcode":"mauma1","product_id":"f210413c-dc84-45e5-b722-9dc72ff7c9af","retail_price":10000,"retail_price_after_discount":10000,"remain_quantity":9,"weight":0,"product":{"display_id":"Áo nam","name":"Áo nam"},"variations_warehouses":[]}}],"images":["https://content.pancake.vn/user-content-dev2.pancake.vn/2022/7/7/eb376f0bf90f47d25396d49e4d547700f182981b.jpg"],"bill_images":[],"user_id":"cee3c05e-5f85-43c4-b27e-889b99c50097","user":{"id":"cee3c05e-5f85-43c4-b27e-889b99c50097","name":"Vũ Sơn","fb_id":"377936050731194","avatar_url":null},"inserted_at":"2023-09-20T02:21:51Z","updated_at":"2023-09-20T02:22:05Z","received_at":"2023-09-21T00:00:00Z","separate_by_display_ids":null}]}}}}}}}},"post":{"summary":"Create purchase","x-summary-i18n":{"vie":"Tạo phiếu nhập kho"},"description":"Create purchase","x-description-i18n":{"vie":"Tạo phiếu nhập kho"},"tags":["Purchase"],"x-tags-i18n":{"vie":["Phiếu nhập kho"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["purchase"],"properties":{"purchase":{"type":"object","required":["status","warehouse_id","items"],"properties":{"note":{"type":"string","description":"Note","x-description-i18n":{"vie":"Ghi chú"}},"status":{"type":"integer","description":"Status","x-description-i18n":{"vie":"Trạng thái"}},"not_create_transaction":{"type":"boolean","description":"Not create transaction","x-description-i18n":{"vie":"Không tạo phiếu chi"}},"auto_create_debts":{"type":"boolean","description":"Auto create debts","x-description-i18n":{"vie":"Tạo công nợ theo nhà cung cấp"}},"supplier_products_id":{"type":"integer","description":"Supplier products ID","x-description-i18n":{"vie":"Mã nhà cung cấp"}},"shop_id":{"type":"integer","description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},"warehouse_id":{"type":"string","description":"Warehouse ID","x-description-i18n":{"vie":"Mã kho"}},"change_received_at":{"type":"boolean","description":"Change received at","x-description-i18n":{"vie":"Đổi ngày về dự kiến"}},"received_at":{"type":"integer","description":"Received at (unix timestamp)","x-description-i18n":{"vie":"Ngày về dự kiến"}},"images":{"type":"array","description":"Purchase images","x-description-i18n":{"vie":"Link hình ảnh nhập hàng"},"items":{"type":"string","format":"uri"}},"items":{"type":"array","description":"List of products","x-description-i18n":{"vie":"Danh sách sản phẩm"},"items":{"type":"object","required":["imported_price","quantity"],"properties":{"imported_price":{"type":"integer","description":"Imported price","x-description-i18n":{"vie":"Giá nhập"}},"gross_price":{"type":"integer","description":"Gross price","x-description-i18n":{"vie":"Giá gốc"}},"discount":{"type":"integer","description":"Discount on product","x-description-i18n":{"vie":"Chiết khấu trên sản phẩm"}},"quantity":{"type":"integer","description":"Import quantity","x-description-i18n":{"vie":"Số lượng nhập"}},"variation_id":{"type":"string","description":"Variation ID","x-description-i18n":{"vie":"Mã mẫu mã"}},"index":{"type":"integer","description":"Product sort order","x-description-i18n":{"vie":"Thứ tự sản phẩm"}}}}}}}},"example":{"purchase":{"note":"","status":1,"not_create_transaction":false,"auto_create_debts":true,"supplier_products_id":169,"shop_id":20,"warehouse_id":"c52e67ad-d9d0-4276-abe4-e0c9f1f7d2da","change_received_at":true,"received_at":1651683600,"images":["https://statics.pancake.vn/user-content-dev2.pancake.vn/2021/12/27/18c4500c320cb2e993b3ff4b3be81165df64d3ba.png"],"items":[{"imported_price":100000,"gross_price":100000,"discount":10000,"quantity":1,"variation_id":"29044dcf-2f4c-492f-a0a9-e447b20e21da","index":0}]}}}}},"description":"Request body containing purchase information to create","x-description-i18n":{"vie":"Thông tin yêu cầu chứa thông tin nhập hàng cần tạo"}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}}}},"examples":{"default":{"$ref":"#/components/examples/SuccessResponse"}}}}}}}},"/shops/{SHOP_ID}/purchases/{PURCHASE_ID}":{"put":{"summary":"Update purchase","x-summary-i18n":{"vie":"Cập nhật phiếu nhập kho"},"description":"Update purchase","x-description-i18n":{"vie":"Cập nhật phiếu nhập kho"},"tags":["Purchase"],"x-tags-i18n":{"vie":["Phiếu nhập kho"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},{"name":"PURCHASE_ID","in":"path","required":true,"schema":{"type":"string","example":"fb056b32-9cf6-4c5a-92de-0eb94db71121"},"description":"Purchase ID","x-description-i18n":{"vie":"Mã phiếu nhập kho"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["purchase"],"properties":{"purchase":{"type":"object","required":["warehouse_id"],"properties":{"note":{"type":"string","description":"Note","x-description-i18n":{"vie":"Ghi chú"}},"status":{"type":"integer","description":"Status","x-description-i18n":{"vie":"Trạng thái"},"enum":[-1,0,1,2],"x-enum-descriptions":["New","Confirmed","Imported goods","Canceled"],"x-enum-descriptions-i18n":{"vie":["Mới","Đã xác nhận","Đã nhập hàng","Đã hủy"]}},"not_create_transaction":{"type":"boolean","description":"Not create transaction","x-description-i18n":{"vie":"Không tạo phiếu chi"}},"auto_create_debts":{"type":"boolean","description":"Auto create debts","x-description-i18n":{"vie":"Tạo công nợ theo nhà cung cấp"}},"supplier_products_id":{"type":"integer","description":"Supplier products ID","x-description-i18n":{"vie":"Mã nhà cung cấp"}},"warehouse_id":{"type":"string","description":"Warehouse ID","x-description-i18n":{"vie":"Mã kho"}},"change_received_at":{"type":"boolean","description":"Change received at","x-description-i18n":{"vie":"Đổi ngày về dự kiến"}},"received_at":{"type":"integer","description":"Received at","x-description-i18n":{"vie":"Ngày về dự kiến"}},"images":{"type":"array","description":"Purchase images","x-description-i18n":{"vie":"Link hình ảnh nhập hàng"},"items":{"type":"string","format":"uri"}},"items":{"type":"array","description":"List of products","x-description-i18n":{"vie":"Danh sách sản phẩm"},"items":{"type":"object","required":["imported_price"],"properties":{"imported_price":{"type":"integer","description":"Imported price","x-description-i18n":{"vie":"Giá nhập"}},"quantity":{"type":"integer","description":"Import quantity","x-description-i18n":{"vie":"Số lượng nhập"}},"variation_id":{"type":"string","description":"Variation ID","x-description-i18n":{"vie":"Mã mẫu mã"}}}}}}}},"example":{"purchase":{"note":"","status":1,"not_create_transaction":false,"auto_create_debts":true,"supplier_products_id":169,"warehouse_id":"c52e67ad-d9d0-4276-abe4-e0c9f1f7d2da","change_received_at":true,"received_at":1651683600,"images":["https://statics.pancake.vn/user-content-dev2.pancake.vn/2021/12/27/18c4500c320cb2e993b3ff4b3be81165df64d3ba.png"],"items":[{"imported_price":100000,"quantity":1,"variation_id":"29044dcf-2f4c-492f-a0a9-e447b20e21da"}]}}}}},"description":"Request body containing purchase information to update","x-description-i18n":{"vie":"Thông tin yêu cầu chứa thông tin nhập hàng cần cập nhật"}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}}}},"examples":{"default":{"$ref":"#/components/examples/SuccessResponse"}}}}}}}},"/shops/{SHOP_ID}/purchases/separate":{"post":{"summary":"Separate purchase","x-summary-i18n":{"vie":"Tách phiếu nhập kho"},"description":"Separate a purchase into multiple purchases","x-description-i18n":{"vie":"Tách một phiếu nhập kho thành nhiều phiếu nhập kho"},"tags":["Purchase"],"x-tags-i18n":{"vie":["Phiếu nhập kho"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["newPurchase","oldPurchase"],"properties":{"newPurchase":{"type":"object","description":"New purchase information","x-description-i18n":{"vie":"Thông tin phiếu nhập kho mới"},"properties":{"auto_create_debts":{"type":"boolean","description":"Auto create debts","x-description-i18n":{"vie":"Tạo công nợ theo nhà cung cấp"}},"discount":{"type":"integer","description":"Discount","x-description-i18n":{"vie":"Giảm giá"}},"images":{"type":"array","description":"Purchase images","x-description-i18n":{"vie":"Link hình ảnh nhập hàng"},"items":{"type":"string","format":"uri"}},"items":{"type":"array","description":"List of products","x-description-i18n":{"vie":"Danh sách sản phẩm"},"items":{"type":"object","required":["imported_price","quantity","variation_id"],"properties":{"imported_price":{"type":"integer","description":"Imported price","x-description-i18n":{"vie":"Giá nhập"}},"quantity":{"type":"integer","description":"Import quantity","x-description-i18n":{"vie":"Số lượng nhập"}},"variation_id":{"type":"string","description":"Variation ID","x-description-i18n":{"vie":"Mã mẫu mã"}},"index":{"type":"integer","description":"Product sort order","x-description-i18n":{"vie":"Thứ tự sản phẩm"}}}}},"not_create_transaction":{"type":"boolean","description":"Not create transaction","x-description-i18n":{"vie":"Không tạo phiếu chi"}},"note":{"type":"string","description":"Note","x-description-i18n":{"vie":"Ghi chú"}},"prepaid_debt":{"type":"integer","description":"Prepaid debt","x-description-i18n":{"vie":"Trả trước NCC"}},"received_at":{"type":"integer","description":"Received at","x-description-i18n":{"vie":"Ngày về dự kiến"}},"status":{"type":"integer","description":"Status","x-description-i18n":{"vie":"Trạng thái"}},"supplier_products_id":{"type":"integer","description":"Supplier products ID","x-description-i18n":{"vie":"Mã nhà cung cấp"}},"tags":{"type":"array","description":"Tag IDs","x-description-i18n":{"vie":"Danh sách mã thẻ"},"items":{"type":"integer"}},"transport_fee":{"type":"integer","description":"Shipping fee","x-description-i18n":{"vie":"Phí vận chuyển"}},"warehouse_id":{"type":"string","description":"Warehouse ID","x-description-i18n":{"vie":"Mã kho"}}}},"oldPurchase":{"type":"object","description":"Old purchase information","x-description-i18n":{"vie":"Thông tin phiếu nhập kho cũ"},"required":["id"],"properties":{"id":{"type":"string","description":"Purchase ID","x-description-i18n":{"vie":"Mã phiếu nhập kho"}},"auto_create_debts":{"type":"boolean","description":"Auto create debts","x-description-i18n":{"vie":"Tạo công nợ theo nhà cung cấp"}},"discount":{"type":"integer","description":"Discount","x-description-i18n":{"vie":"Giảm giá"}},"images":{"type":"array","description":"Purchase images","x-description-i18n":{"vie":"Link hình ảnh nhập hàng"},"items":{"type":"string","format":"uri"}},"items":{"type":"array","description":"List of products","x-description-i18n":{"vie":"Danh sách sản phẩm"},"items":{"type":"object","required":["imported_price","quantity","variation_id"],"properties":{"imported_price":{"type":"integer","description":"Imported price","x-description-i18n":{"vie":"Giá nhập"}},"quantity":{"type":"integer","description":"Import quantity","x-description-i18n":{"vie":"Số lượng nhập"}},"variation_id":{"type":"string","description":"Variation ID","x-description-i18n":{"vie":"Mã mẫu mã"}},"index":{"type":"integer","description":"Product sort order","x-description-i18n":{"vie":"Thứ tự sản phẩm"}}}}},"not_create_transaction":{"type":"boolean","description":"Not create transaction","x-description-i18n":{"vie":"Không tạo phiếu chi"}},"note":{"type":"string","description":"Note","x-description-i18n":{"vie":"Ghi chú"}},"prepaid_debt":{"type":"integer","description":"Prepaid debt","x-description-i18n":{"vie":"Trả trước NCC"}},"received_at":{"type":"integer","description":"Received at","x-description-i18n":{"vie":"Ngày về dự kiến"}},"status":{"type":"integer","description":"Status","x-description-i18n":{"vie":"Trạng thái"}},"supplier_products_id":{"type":"integer","description":"Supplier products ID","x-description-i18n":{"vie":"Mã nhà cung cấp"}},"tags":{"type":"array","description":"Tag IDs","x-description-i18n":{"vie":"Danh sách mã thẻ"},"items":{"type":"integer"}},"transport_fee":{"type":"integer","description":"Shipping fee","x-description-i18n":{"vie":"Phí vận chuyển"}},"warehouse_id":{"type":"string","description":"Warehouse ID","x-description-i18n":{"vie":"Mã kho"}}}}},"example":{"newPurchase":{"auto_create_debts":true,"discount":500,"images":["https://statics.pancake.vn/user-content-dev2.pancake.vn/2021/12/27/18c4500c320cb2e993b3ff4b3be81165df64d3ba.png"],"items":[{"imported_price":100000,"quantity":1,"variation_id":"ddefd476-bc91-4151-8cd2-2cf5ad227f09","index":0}],"not_create_transaction":false,"note":"Tách phiếu nhập","prepaid_debt":20000,"received_at":1683997200,"status":0,"supplier_products_id":293,"tags":[1],"transport_fee":0,"warehouse_id":"c52e67ad-d9d0-4276-abe4-e0c9f1f7d2da"},"oldPurchase":{"auto_create_debts":true,"discount":500,"id":"0ecbdb3b-a376-4a3d-9b8a-174ae15ae886","images":["https://statics.pancake.vn/user-content-dev2.pancake.vn/2021/12/27/18c4500c320cb2e993b3ff4b3be81165df64d3ba.png"],"items":[{"imported_price":100000,"quantity":23,"variation_id":"ddefd476-bc91-4151-8cd2-2cf5ad227f09","index":0}],"not_create_transaction":false,"note":"Nhập hàng để bán","prepaid_debt":20000,"received_at":1683997200,"status":0,"supplier_products_id":293,"tags":[1],"transport_fee":0,"warehouse_id":"c52e67ad-d9d0-4276-abe4-e0c9f1f7d2da"}}}}},"description":"Request body containing purchase separation information","x-description-i18n":{"vie":"Thông tin yêu cầu chứa thông tin tách nhập hàng"}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}}}},"examples":{"default":{"$ref":"#/components/examples/SuccessResponse"}}}}}}}},"/shops/{SHOP_ID}/export":{"get":{"summary":"List of exports","x-summary-i18n":{"vie":"Danh sách phiếu xuất kho"},"description":"Get list of exports","x-description-i18n":{"vie":"Lấy danh sách phiếu xuất kho"},"tags":["Export"],"x-tags-i18n":{"vie":["Phiếu xuất kho"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"example":1},"description":"Page number","x-description-i18n":{"vie":"Số trang"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","default":30,"example":30},"description":"Page size","x-description-i18n":{"vie":"Kích thước trang"}},{"name":"status","in":"query","required":false,"schema":{"type":"integer","default":-1,"enum":[-1,0,1,2],"x-enum-descriptions":["All status","New","Completed","Canceled"],"x-enum-descriptions-i18n":{"vie":["Tất cả trạng thái","Mới","Đã hoàn thành","Đã hủy"]},"example":-1},"description":"Status","x-description-i18n":{"vie":"Trạng thái"},"x-enum-descriptions-i18n":{"vie":["Tất cả trạng thái","Mới","Đã hoàn thành","Đã hủy"]}},{"name":"type","in":"query","required":false,"schema":{"type":"integer","default":0,"enum":[0,1],"x-enum-descriptions":["Normal export","Product defect export"],"x-enum-descriptions-i18n":{"vie":["Phiếu xuất thường","Xuất hàng lỗi"]},"example":0},"description":"Type of export","x-description-i18n":{"vie":"Loại phiếu xuất kho"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","description":"List of exports","x-description-i18n":{"vie":"Danh sách phiếu xuất kho"},"items":{"$ref":"#/components/schemas/Export"}},"page_number":{"type":"integer","description":"Page number","x-description-i18n":{"vie":"Số trang"}},"page_size":{"type":"integer","description":"Page size","x-description-i18n":{"vie":"Kích thước trang"}},"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}},"total_entries":{"type":"integer","description":"Total entries","x-description-i18n":{"vie":"Tổng số bản ghi"}},"total_pages":{"type":"integer","description":"Total pages","x-description-i18n":{"vie":"Tổng số trang"}}}},"examples":{"default":{"value":{"success":true,"data":[{"id":"8095ca3c-a485-4378-9914-5013e1179d55","display_id":472,"status":0,"type":0,"total":1,"total_price":0,"note":"Xuất bán hàng","warehouse_id":"c52e67ad-d9d0-4276-abe4-e0c9f1f7d2da","supplier_products_id":400037328,"tags":[1],"export_items":[{"id":"78dfe47a-a3dd-4d47-8f8b-16eb1ccd69ee","imported_price":0,"quantity":1,"variation_id":"76887a5b-8a27-472c-a15a-661ea59434dd","display_id":0,"inserted_at":"2024-01-25T16:18:20Z"}],"images":["https://content.pancake.vn/user-content-dev2.pancake.vn/2022/7/7/eb376f0bf90f47d25396d49e4d547700f182981b.jpg"],"user_id":"d6e6a545-f102-439e-9943-8ac8369f9735","user":{"id":"d6e6a545-f102-439e-9943-8ac8369f9735","name":"vudzung12","fb_id":"1286585024855632","avatar_url":null},"inserted_at":"2024-01-25T16:18:20Z","updated_at":"2024-01-25T16:18:20Z"}]}}}}}}}},"post":{"summary":"Create export","x-summary-i18n":{"vie":"Tạo phiếu xuất kho"},"description":"Create export","x-description-i18n":{"vie":"Tạo phiếu xuất kho"},"tags":["Export"],"x-tags-i18n":{"vie":["Phiếu xuất kho"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["export_list"],"properties":{"export_list":{"type":"object","required":["status","warehouse_id","export_items"],"properties":{"note":{"type":"string","description":"Note","x-description-i18n":{"vie":"Ghi chú"}},"supplier_products_id":{"type":"integer","description":"Supplier products ID","x-description-i18n":{"vie":"Mã nhà cung cấp"}},"tags":{"type":"array","description":"Export tags","x-description-i18n":{"vie":"Thẻ phiếu xuất kho"},"items":{"type":"integer"}},"status":{"type":"integer","description":"Export status","x-description-i18n":{"vie":"Trạng thái phiếu xuất"},"enum":[0,1,2],"x-enum-descriptions":["New (type 0) / Defect export (type 1)","Completed (type 0) / Elimination export (type 1)","Canceled"],"x-enum-descriptions-i18n":{"vie":["Mới (type 0) / Xuất hàng lỗi (type 1)","Hoàn tất (type 0) / Xuất bỏ (type 1)","Đã hủy"]}},"type":{"type":"integer","description":"Type of export","x-description-i18n":{"vie":"Loại phiếu xuất kho"},"enum":[0,1],"x-enum-descriptions":["Normal export","Product defect export"],"x-enum-descriptions-i18n":{"vie":["Phiếu xuất thường","Xuất hàng lỗi"]}},"shop_id":{"type":"integer","description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},"warehouse_id":{"type":"string","description":"Warehouse ID","x-description-i18n":{"vie":"Mã kho"}},"change_inserted_at":{"type":"boolean","description":"Change date of create export","x-description-i18n":{"vie":"Đổi ngày tạo phiếu xuất kho"}},"inserted_at":{"type":"integer","description":"Date of create export (unix timestamp)","x-description-i18n":{"vie":"Ngày tạo phiếu xuất kho"}},"images":{"type":"array","description":"Export images","x-description-i18n":{"vie":"Link hình ảnh phiếu xuất kho"},"items":{"type":"string","format":"uri"}},"export_items":{"type":"array","description":"List of products","x-description-i18n":{"vie":"Danh sách sản phẩm"},"items":{"type":"object","required":["imported_price","quantity","variation_id"],"properties":{"id":{"type":"string","description":"Export item ID","x-description-i18n":{"vie":"Mã sản phẩm xuất kho"}},"imported_price":{"type":"integer","description":"Export price","x-description-i18n":{"vie":"Giá xuất kho"}},"quantity":{"type":"integer","description":"Export quantity","x-description-i18n":{"vie":"Số lượng xuất kho"}},"variation_id":{"type":"string","description":"Variation ID","x-description-i18n":{"vie":"Mã mẫu mã"}}}}}}}},"example":{"export_list":{"note":"","supplier_products_id":169,"tags":[1],"status":0,"type":0,"shop_id":20,"warehouse_id":"c52e67ad-d9d0-4276-abe4-e0c9f1f7d2da","change_inserted_at":true,"inserted_at":1651683600,"images":["https://statics.pancake.vn/user-content-dev2.pancake.vn/2021/12/27/18c4500c320cb2e993b3ff4b3be81165df64d3ba.png"],"export_items":[{"id":"13d7ddf6-4cd9-4e1f-a5c1-ac3cd7a7fc17","imported_price":100000,"quantity":1,"variation_id":"29044dcf-2f4c-492f-a0a9-e447b20e21da"}]}}}}},"description":"Request body containing export information to create","x-description-i18n":{"vie":"Thông tin yêu cầu chứa thông tin xuất kho cần tạo"}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}}}},"examples":{"default":{"$ref":"#/components/examples/SuccessResponse"}}}}}}}},"/shops/{SHOP_ID}/export/{EXPORT_ID}":{"put":{"summary":"Update export","x-summary-i18n":{"vie":"Cập nhật phiếu xuất kho"},"description":"Update export","x-description-i18n":{"vie":"Cập nhật phiếu xuất kho"},"tags":["Export"],"x-tags-i18n":{"vie":["Phiếu xuất kho"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},{"name":"EXPORT_ID","in":"path","required":true,"schema":{"type":"string","example":"8fbe2a6f-b0b2-4227-a698-19d18c43f7c8"},"description":"Export ID","x-description-i18n":{"vie":"Mã phiếu xuất kho"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["export_list"],"properties":{"export_list":{"type":"object","properties":{"images":{"type":"array","description":"Export images","x-description-i18n":{"vie":"Link hình ảnh phiếu xuất kho"},"items":{"type":"string","format":"uri"}},"inserted_at":{"type":"integer","description":"Date of create export (unix timestamp)","x-description-i18n":{"vie":"Ngày tạo phiếu xuất kho"}},"note":{"type":"string","description":"Note","x-description-i18n":{"vie":"Ghi chú"}},"status":{"type":"integer","description":"Export status","x-description-i18n":{"vie":"Trạng thái phiếu xuất"},"enum":[0,1,2],"x-enum-descriptions":["New (type 0) / Defect export (type 1)","Completed (type 0) / Elimination export (type 1)","Canceled"],"x-enum-descriptions-i18n":{"vie":["Mới (type 0) / Xuất hàng lỗi (type 1)","Hoàn tất (type 0) / Xuất bỏ (type 1)","Đã hủy"]}},"supplier_products_id":{"type":"integer","description":"Supplier products ID","x-description-i18n":{"vie":"Mã nhà cung cấp"}},"tags":{"type":"array","description":"Export tags","x-description-i18n":{"vie":"Thẻ phiếu xuất kho"},"items":{"type":"integer"}},"type":{"type":"integer","description":"Type of export","x-description-i18n":{"vie":"Loại phiếu xuất kho"},"enum":[0,1],"x-enum-descriptions":["Normal export","Product defect export"],"x-enum-descriptions-i18n":{"vie":["Phiếu xuất thường","Xuất hàng lỗi"]}},"export_items":{"type":"array","description":"List of products","x-description-i18n":{"vie":"Danh sách sản phẩm"},"items":{"type":"object","required":["id","imported_price","quantity","variation_id"],"properties":{"id":{"type":"string","description":"Export item ID","x-description-i18n":{"vie":"Mã sản phẩm xuất kho"}},"imported_price":{"type":"integer","description":"Export price","x-description-i18n":{"vie":"Giá xuất kho"}},"quantity":{"type":"integer","description":"Export quantity","x-description-i18n":{"vie":"Số lượng xuất kho"}},"variation_id":{"type":"string","description":"Variation ID","x-description-i18n":{"vie":"Mã mẫu mã"}}}}}}}},"example":{"export_list":{"images":["https://content.pancake.vn/user-content-dev2.pancake.vn/2022/5/27/ee3be79d1574735ed35539ca48f7f6e9d7137706.jpg"],"inserted_at":1695142800,"note":"xuất bán hàng","status":0,"supplier_products_id":319,"tags":[1],"export_items":[{"id":"13d7ddf6-4cd9-4e1f-a5c1-ac3cd7a7fc17","imported_price":1000,"quantity":1,"variation_id":"d1e522eb-2f6f-4d22-b8a1-ec25df4a33a4"}]}}}}},"description":"Request body containing export information to create","x-description-i18n":{"vie":"Thông tin yêu cầu chứa thông tin xuất kho cần tạo"}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}}}},"examples":{"default":{"$ref":"#/components/examples/SuccessResponse"}}}}}}}},"/shops/{SHOP_ID}/transfers":{"get":{"summary":"List of warehouse transfers","x-summary-i18n":{"vie":"Danh sách chuyển kho"},"description":"Get list of warehouse transfers","x-description-i18n":{"vie":"Lấy danh sách chuyển kho"},"tags":["Warehouse Transfer"],"x-tags-i18n":{"vie":["Chuyển kho"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"example":1},"description":"Page number","x-description-i18n":{"vie":"Số trang"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","default":30,"example":30},"description":"Page size","x-description-i18n":{"vie":"Kích thước trang"}},{"name":"status","in":"query","required":false,"schema":{"type":"integer","default":1,"enum":[0,1,2],"x-enum-descriptions":["Waiting for pick up","Shipping","Completed"],"x-enum-descriptions-i18n":{"vie":["Chờ chuyển hàng","Đang chuyển hàng","Hoàn tất"]},"example":1},"description":"Status","x-description-i18n":{"vie":"Trạng thái"},"x-enum-descriptions-i18n":{"vie":["Chờ chuyển hàng","Đang chuyển hàng","Hoàn tất"]}},{"name":"startDate","in":"query","required":false,"schema":{"type":"integer","example":0},"description":"Start date","x-description-i18n":{"vie":"Ngày bắt đầu"}},{"name":"endDate","in":"query","required":false,"schema":{"type":"integer","example":0},"description":"End date","x-description-i18n":{"vie":"Ngày kết thúc"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","description":"List of warehouse transfers","x-description-i18n":{"vie":"Danh sách chuyển kho"},"items":{"$ref":"#/components/schemas/WarehouseTransfer"}},"page_number":{"type":"integer","description":"Page number","x-description-i18n":{"vie":"Số trang"}},"page_size":{"type":"integer","description":"Page size","x-description-i18n":{"vie":"Kích thước trang"}},"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}},"total_entries":{"type":"integer","description":"Total entries","x-description-i18n":{"vie":"Tổng số bản ghi"}},"total_pages":{"type":"integer","description":"Total pages","x-description-i18n":{"vie":"Tổng số trang"}}}},"examples":{"default":{"value":{"success":true,"data":[{"id":"5c9ef4a6-2411-4d5f-9a91-1bc22dbb7eb1","display_id":309,"status":0,"from_warehouse_id":"c52e67ad-d9d0-4276-abe4-e0c9f1f7d2da","from_warehouse_name":"Kho HCM","to_warehouse_id":"229102e4-39c3-4523-bd57-4ed0a45a85ba","to_warehouse_name":"Cho tao cơm","total_quantity":1,"shipping_fee":30000,"note":"Chuyển kho bán hàng","items":[{"id":"f80bdc16-a000-4bf1-a979-c3fd4033f551","variation_id":"3b11fb7b-9081-42c0-9546-dfac62b9c9ca","quantity":3,"product_display_id":"áo nam","product_name":"áo nam","variation_display_id":"XANH-M","variation_fields":[{"id":"beb75502-5a50-48d6-bed8-89ea8ddc9a66","name":"màu","value":"xanh dương","keyValue":"xanh dương"},{"id":"8eee6f85-0a76-46da-9dd7-6668bc6d8729","name":"size","value":"M","keyValue":"M"}]}],"images":["https://content.pancake.vn/user-content-dev2.pancake.vn/2022/7/7/eb376f0bf90f47d25396d49e4d547700f182981b.jpg"],"shop_id":20,"creator_id":"cee3c05e-5f85-43c4-b27e-889b99c50097","inserted_at":"2023-09-13T09:34:37Z","updated_status_at":"2023-09-13T09:34:37Z"}]}}}}}}}}},"/shops/{SHOP_ID}/transfers/multi":{"post":{"summary":"Create warehouse transfer","x-summary-i18n":{"vie":"Tạo phiếu chuyển kho"},"description":"Create warehouse transfer","x-description-i18n":{"vie":"Tạo phiếu chuyển kho"},"tags":["Warehouse Transfer"],"x-tags-i18n":{"vie":["Chuyển kho"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["transfer"],"properties":{"transfer":{"type":"object","required":["from_warehouse_id","to_warehouse_ids","items"],"properties":{"from_warehouse_id":{"type":"string","description":"From warehouse ID","x-description-i18n":{"vie":"Mã kho đi"}},"to_warehouse_ids":{"type":"array","description":"To warehouse IDs","x-description-i18n":{"vie":"Danh sách mã kho đến"},"items":{"type":"string"}},"shipping_fee":{"type":"integer","description":"Shipping fee","x-description-i18n":{"vie":"Phí vận chuyển"}},"note":{"type":"string","description":"Note","x-description-i18n":{"vie":"Ghi chú"}},"images":{"type":"array","description":"Transfer images","x-description-i18n":{"vie":"Link hình ảnh chuyển kho"},"items":{"type":"string","format":"uri"}},"inserted_at":{"type":"string","format":"date-time","description":"Inserted at","x-description-i18n":{"vie":"Thời điểm tạo"}},"items":{"type":"array","description":"List of products","x-description-i18n":{"vie":"Danh sách sản phẩm"},"items":{"type":"object","required":["quantity","variation_id"],"properties":{"quantity":{"type":"integer","description":"Quantity","x-description-i18n":{"vie":"Số lượng"}},"variation_id":{"type":"string","description":"Variation ID","x-description-i18n":{"vie":"Mã mẫu mã"}}}}}}}},"example":{"transfer":{"from_warehouse_id":"c52e67ad-d9d0-4276-abe4-e0c9f1f7d2da","to_warehouse_ids":["229102e4-39c3-4523-bd57-4ed0a45a85ba"],"shipping_fee":20000,"items":[{"quantity":1,"variation_id":"20e7d183-c70c-445e-8ce2-4d7e3a378e34"}],"note":"đây là ghi chú","images":["https://content.pancake.vn/user-content-dev2.pancake.vn/2022/5/27/ee3be79d1574735ed35539ca48f7f6e9d7137706.jpg"],"inserted_at":"2025-03-11T09:24:42"}}}}},"description":"Request body containing warehouse transfer information to create","x-description-i18n":{"vie":"Thông tin yêu cầu chứa thông tin chuyển kho cần tạo"}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}}}},"examples":{"default":{"$ref":"#/components/examples/SuccessResponse"}}}}}}}},"/shops/{SHOP_ID}/transfers/{TRANSFER_ID}":{"put":{"summary":"Update warehouse transfer","x-summary-i18n":{"vie":"Cập nhật phiếu chuyển kho"},"description":"Update warehouse transfer","x-description-i18n":{"vie":"Cập nhật phiếu chuyển kho"},"tags":["Warehouse Transfer"],"x-tags-i18n":{"vie":["Chuyển kho"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},{"name":"TRANSFER_ID","in":"path","required":true,"schema":{"type":"string","example":"b482ae3a-b89a-4d64-9859-ed6e3af5a476"},"description":"Transfer ID","x-description-i18n":{"vie":"Mã chuyển kho"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["transfer"],"properties":{"transfer":{"type":"object","required":["status","from_warehouse_id"],"properties":{"status":{"type":"integer","description":"Status","x-description-i18n":{"vie":"Trạng thái"},"enum":[0,1,2],"x-enum-descriptions":["Waiting for pick up","Shipping","Completed"],"x-enum-descriptions-i18n":{"vie":["Chờ chuyển hàng","Đang chuyển hàng","Hoàn tất"]}},"from_warehouse_id":{"type":"string","description":"From warehouse ID","x-description-i18n":{"vie":"Mã kho đi"}},"shipping_fee":{"type":"integer","description":"Shipping fee","x-description-i18n":{"vie":"Phí vận chuyển"}},"note":{"type":"string","description":"Note","x-description-i18n":{"vie":"Ghi chú"}},"images":{"type":"array","description":"Transfer images","x-description-i18n":{"vie":"Link hình ảnh chuyển kho"},"items":{"type":"string","format":"uri"}},"inserted_at":{"type":"string","format":"date-time","description":"Inserted at","x-description-i18n":{"vie":"Thời điểm tạo"}},"change_inserted_at":{"type":"boolean","description":"Change creation time","x-description-i18n":{"vie":"Đổi thời điểm tạo"}},"items":{"type":"array","description":"List of products","x-description-i18n":{"vie":"Danh sách sản phẩm"},"items":{"type":"object","required":["variation_id","quantity"],"properties":{"variation_id":{"type":"string","description":"Variation ID","x-description-i18n":{"vie":"Mã mẫu mã"}},"quantity":{"type":"integer","description":"Transfer quantity","x-description-i18n":{"vie":"Số lượng chuyển kho"}}}}}}}},"example":{"transfer":{"status":1,"from_warehouse_id":"c52e67ad-d9d0-4276-abe4-e0c9f1f7d2da","shipping_fee":10000,"items":[{"variation_id":"51bb0bb7-77e9-407e-9f57-5072a0236cb4","quantity":1}],"note":"Chuyển kho bán hàng","images":["https://content.pancake.vn/user-content-dev2.pancake.vn/2024/8/30/7886ccd76d3629808d21fa3e59849c8e79a28162.png"],"inserted_at":"2025-03-11T09:24:42","change_inserted_at":true}}}}},"description":"Request body containing warehouse transfer information to update","x-description-i18n":{"vie":"Thông tin yêu cầu chứa thông tin chuyển kho cần cập nhật"}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}}}},"examples":{"default":{"$ref":"#/components/examples/SuccessResponse"}}}}}}}},"/shops/{SHOP_ID}/transfers/get_status_history/{TRANSFER_ID}":{"get":{"summary":"History of warehouse transfer status updates","x-summary-i18n":{"vie":"Lịch sử cập nhật trạng thái chuyển kho"},"description":"Get history of warehouse transfer status updates","x-description-i18n":{"vie":"Lấy lịch sử cập nhật trạng thái chuyển kho"},"tags":["Warehouse Transfer"],"x-tags-i18n":{"vie":["Chuyển kho"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},{"name":"TRANSFER_ID","in":"path","required":true,"schema":{"type":"string","example":"b482ae3a-b89a-4d64-9859-ed6e3af5a476"},"description":"Transfer ID","x-description-i18n":{"vie":"Mã chuyển kho"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","description":"List of status history","x-description-i18n":{"vie":"Danh sách lịch sử trạng thái"},"items":{"type":"object","description":"Status history information","x-description-i18n":{"vie":"Thông tin lịch sử trạng thái"},"properties":{"id":{"type":"string","description":"Status history ID","x-description-i18n":{"vie":"Mã lịch sử trạng thái"}},"old_status":{"type":"integer","description":"Old status","x-description-i18n":{"vie":"Trạng thái cũ"}},"status":{"type":"integer","description":"Updated status","x-description-i18n":{"vie":"Trạng thái cập nhật"}},"transfer_id":{"type":"string","description":"Warehouse transfer ID","x-description-i18n":{"vie":"Mã phiếu chuyển kho"}},"updated_at":{"type":"string","format":"date-time","description":"Updated at","x-description-i18n":{"vie":"Cập nhật trạng thái lúc"}},"user_id":{"type":"string","description":"Updated employee ID","x-description-i18n":{"vie":"Mã nhân viên cập nhật"}},"user":{"type":"object","description":"User information","x-description-i18n":{"vie":"Thông tin nhân viên"},"properties":{"avatar_url":{"type":"string","format":"uri","description":"Avatar URL","x-description-i18n":{"vie":"Link hình đại diện"}},"fb_id":{"type":"string","description":"Facebook ID","x-description-i18n":{"vie":"Facebook ID"}},"name":{"type":"string","description":"Name","x-description-i18n":{"vie":"Tên"}}}}}}},"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}}}},"examples":{"default":{"value":{"success":true,"data":[{"id":"4c961f28-9a1c-11f0-9d68-0242ac1a000a","old_status":0,"status":1,"transfer_id":"ed386c72-ba0c-4b2a-85dd-c8b1903badc2","updated_at":"2025-09-25T14:31:18Z","user_id":"cee3c05e-5f85-43c4-b27e-889b99c50097","user":{"avatar_url":null,"fb_id":"377936050731194","name":"Vũ Sơn"}}]}}}}}}}}},"/shops/{SHOP_ID}/stocktakings":{"get":{"summary":"Stocktaking list","x-summary-i18n":{"vie":"Danh sách kiểm hàng"},"description":"Get list of stocktakings","x-description-i18n":{"vie":"Lấy danh sách kiểm hàng"},"tags":["Stocktaking"],"x-tags-i18n":{"vie":["Kiểm hàng"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"example":1},"description":"Page number","x-description-i18n":{"vie":"Số trang"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","default":30,"example":30},"description":"Page size","x-description-i18n":{"vie":"Kích thước trang"}},{"name":"status","in":"query","required":false,"schema":{"type":"integer","default":-2,"enum":[-2,-1,0,1,2],"x-enum-descriptions":["All status","Creating","Stocktaking","Stocktook","Canceled"],"x-enum-descriptions-i18n":{"vie":["Tất cả trạng thái","Đang tạo","Đang kiểm hàng","Đã kiểm hàng","Đã hủy"]},"example":-2},"description":"Status","x-description-i18n":{"vie":"Trạng thái"},"x-enum-descriptions-i18n":{"vie":["Tất cả trạng thái","Đang tạo","Mới","Đã xác nhận","Đã nhập hàng"]}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","description":"List of stocktakings","x-description-i18n":{"vie":"Danh sách kiểm hàng"},"items":{"$ref":"#/components/schemas/Stocktaking"}},"page_number":{"type":"integer","description":"Page number","x-description-i18n":{"vie":"Số trang"}},"page_size":{"type":"integer","description":"Page size","x-description-i18n":{"vie":"Kích thước trang"}},"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}},"total_entries":{"type":"integer","description":"Total entries","x-description-i18n":{"vie":"Tổng số bản ghi"}},"total_pages":{"type":"integer","description":"Total pages","x-description-i18n":{"vie":"Tổng số trang"}}}},"examples":{"default":{"value":{"success":true,"data":[{"id":"4d0f479d-feab-489b-bc82-4a656902a20b","display_id":null,"status":0,"warehouse_id":"c52e67ad-d9d0-4276-abe4-e0c9f1f7d2da","stocktaking_by":"category_ids","stocktaking_by_value":["1315"],"stocktaking_at":"2023-10-11T08:24:56Z","progress":0,"note":"Kiểm hàng tồn","items":[{"id":"cb244b25-100e-4eaa-8b8f-0e72c5642631","variation_id":"27b3f94b-c945-4560-b694-a59526cae9a5","changed_quantity":12,"current_quantity":0,"note":null,"variation":{"id":"27b3f94b-c945-4560-b694-a59526cae9a5","display_id":"1","barcode":"12ml-6291107458328","product_id":"61894c4f-d759-45b7-acf7-ff5e88082016","retail_price":240000,"last_imported_price":20000,"weight":1000,"fields":[],"images":["https://statics.pancake.vn/user-content.pancake.vn/2023/4/12/05138842c6f772cde332fd8e1be1bff58245f19e.png"],"product":{"display_id":"12ml-6291107458328","name":"12ml Badee Al Oud","image":null,"note_product":""}},"inserted_at":"2024-12-02T10:42:39Z","updated_at":"2024-12-02T10:42:39Z"}],"shop_id":20,"creator_id":"cee3c05e-5f85-43c4-b27e-889b99c50097","inserted_at":"2023-10-11T08:25:18Z","updated_at":"2023-10-11T09:03:03Z","updated_status_at":"2023-10-11T08:25:18Z"}]}}}}}}}},"post":{"summary":"Create stocktaking","x-summary-i18n":{"vie":"Tạo phiếu kiểm hàng"},"description":"Create stocktaking","x-description-i18n":{"vie":"Tạo phiếu kiểm hàng"},"tags":["Stocktaking"],"x-tags-i18n":{"vie":["Kiểm hàng"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["stocktaking"],"properties":{"stocktaking":{"type":"object","required":["warehouse_id","items","status"],"properties":{"warehouse_id":{"type":"string","description":"Warehouse ID","x-description-i18n":{"vie":"Mã kho"}},"items":{"type":"array","description":"List of products","x-description-i18n":{"vie":"Danh sách sản phẩm"},"items":{"type":"object","required":["variation_id","changed_quantity"],"properties":{"variation_id":{"type":"string","description":"Variation ID","x-description-i18n":{"vie":"Mã mẫu mã"}},"changed_quantity":{"type":"integer","description":"Changed quantity","x-description-i18n":{"vie":"Số lượng thay đổi"}}}}},"note":{"type":"string","description":"Note","x-description-i18n":{"vie":"Ghi chú"}},"status":{"type":"integer","description":"Status","x-description-i18n":{"vie":"Trạng thái"}},"inserted_at":{"type":"string","format":"date-time","description":"Inserted at","x-description-i18n":{"vie":"Thời điểm tạo"}},"stocktaking_at":{"type":"string","format":"date-time","description":"Stocktaking at","x-description-i18n":{"vie":"Kiểm hàng lúc"}},"stocktaking_by":{"type":"string","description":"Stocktaking by","x-description-i18n":{"vie":"Kiểm hàng theo"}},"stocktaking_by_value":{"type":"array","description":"Category ID / Supplier products ID / Brand ID","x-description-i18n":{"vie":"Danh sách mã danh mục / nhà cung cấp / thương hiệu"},"items":{"type":"string"}}}}},"example":{"stocktaking":{"warehouse_id":"c52e67ad-d9d0-4276-abe4-e0c9f1f7d2da","items":[{"variation_id":"20e7d183-c70c-445e-8ce2-4d7e3a378e34","changed_quantity":-1}],"note":"Kiểm hàng tồn","status":0,"inserted_at":"2025-04-04T10:42:40.100Z","stocktaking_at":"2023-10-11T10:38:34.542Z","stocktaking_by":"category_ids","stocktaking_by_value":["1315"]}}}}},"description":"Request body containing stocktaking information to create","x-description-i18n":{"vie":"Thông tin yêu cầu chứa thông tin kiểm kê cần tạo"}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}}}},"examples":{"default":{"$ref":"#/components/examples/SuccessResponse"}}}}}}}},"/shops/{SHOP_ID}/stocktakings/{STOCKTAKING_ID}":{"get":{"summary":"Get stocktaking information","x-summary-i18n":{"vie":"Lấy thông tin 1 phiếu kiểm hàng"},"description":"Get stocktaking information","x-description-i18n":{"vie":"Lấy thông tin 1 phiếu kiểm hàng"},"tags":["Stocktaking"],"x-tags-i18n":{"vie":["Kiểm hàng"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},{"name":"STOCKTAKING_ID","in":"path","required":true,"schema":{"type":"string","example":"949f1396-f6fa-45d9-93b6-4c37503a9950"},"description":"Stocktaking ID","x-description-i18n":{"vie":"Mã phiếu kiểm"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Stocktaking"},"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}}}},"examples":{"default":{"value":{"success":true,"data":{"id":"4d0f479d-feab-489b-bc82-4a656902a20b","display_id":null,"status":0,"warehouse_id":"c52e67ad-d9d0-4276-abe4-e0c9f1f7d2da","stocktaking_by":"category_ids","stocktaking_by_value":["1315"],"stocktaking_at":"2023-10-11T08:24:56Z","progress":0,"note":"Kiểm hàng tồn","items":[{"id":"cb244b25-100e-4eaa-8b8f-0e72c5642631","variation_id":"27b3f94b-c945-4560-b694-a59526cae9a5","changed_quantity":12,"current_quantity":0,"note":null,"variation":{"id":"27b3f94b-c945-4560-b694-a59526cae9a5","display_id":"1","barcode":"12ml-6291107458328","product_id":"61894c4f-d759-45b7-acf7-ff5e88082016","retail_price":240000,"last_imported_price":20000,"weight":1000,"fields":[],"images":["https://statics.pancake.vn/user-content.pancake.vn/2023/4/12/05138842c6f772cde332fd8e1be1bff58245f19e.png"],"product":{"display_id":"12ml-6291107458328","name":"12ml Badee Al Oud","image":null,"note_product":""}},"inserted_at":"2024-12-02T10:42:39Z","updated_at":"2024-12-02T10:42:39Z"}],"shop_id":20,"creator_id":"cee3c05e-5f85-43c4-b27e-889b99c50097","inserted_at":"2023-10-11T08:25:18Z","updated_at":"2023-10-11T09:03:03Z","updated_status_at":"2023-10-11T08:25:18Z"}}}}}}}}},"put":{"summary":"Update stocktaking","x-summary-i18n":{"vie":"Cập nhật kiểm hàng"},"description":"Update stocktaking","x-description-i18n":{"vie":"Cập nhật kiểm hàng"},"tags":["Stocktaking"],"x-tags-i18n":{"vie":["Kiểm hàng"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},{"name":"STOCKTAKING_ID","in":"path","required":true,"schema":{"type":"string","example":"949f1396-f6fa-45d9-93b6-4c37503a9950"},"description":"Stocktaking ID","x-description-i18n":{"vie":"Mã phiếu kiểm"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["stocktaking"],"properties":{"stocktaking":{"type":"object","properties":{"items":{"type":"array","description":"List of products","x-description-i18n":{"vie":"Danh sách sản phẩm"},"items":{"type":"object","properties":{"id":{"type":"string","description":"Stocktaking item ID","x-description-i18n":{"vie":"Mã hạng mục kiểm hàng"}},"variation_id":{"type":"string","description":"Variation ID","x-description-i18n":{"vie":"Mã mẫu mã"}},"changed_quantity":{"type":"integer","description":"Changed quantity","x-description-i18n":{"vie":"Số lượng thay đổi"}},"note":{"type":"string","description":"Note","x-description-i18n":{"vie":"Ghi chú"}}}}},"note":{"type":"string","description":"Note","x-description-i18n":{"vie":"Ghi chú"}},"status":{"type":"integer","description":"Status","x-description-i18n":{"vie":"Trạng thái"}},"stocktaking_at":{"type":"string","format":"date-time","description":"Stocktaking at","x-description-i18n":{"vie":"Kiểm hàng lúc"}},"stocktaking_by":{"type":"string","description":"Stocktaking by","x-description-i18n":{"vie":"Kiểm hàng theo"}},"stocktaking_by_value":{"type":"array","description":"Category ID / Supplier products ID / Brand ID","x-description-i18n":{"vie":"Danh sách mã danh mục / nhà cung cấp / thương hiệu"},"items":{"type":"string"}}}}},"example":{"stocktaking":{"items":[{"id":"cb244b25-100e-4eaa-8b8f-0e72c5642631","variation_id":"27b3f94b-c945-4560-b694-a59526cae9a5","changed_quantity":12,"note":null}],"note":"Kiểm hàng tồn","status":0,"stocktaking_at":"2023-10-11T10:38:34","stocktaking_by":"category_ids","stocktaking_by_value":["1315"]}}}}},"description":"Request body containing stocktaking information to update","x-description-i18n":{"vie":"Thông tin yêu cầu chứa thông tin kiểm kê cần cập nhật"}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}}}},"examples":{"default":{"$ref":"#/components/examples/SuccessResponse"}}}}}}}},"/shops/{SHOP_ID}/promotion_advance":{"get":{"summary":"Get promotion product list","x-summary-i18n":{"vie":"Danh sách khuyến mãi"},"description":"Get list of promotions","x-description-i18n":{"vie":"Lấy danh sách khuyến mãi"},"tags":["Promotion"],"x-tags-i18n":{"vie":["Khuyến mãi"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"example":1},"description":"Page number","x-description-i18n":{"vie":"Số trang"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","default":10,"example":10},"description":"Page size","x-description-i18n":{"vie":"Kích thước trang"}},{"name":"textSearch","in":"query","required":false,"schema":{"type":"string","example":"áo sơ mi"},"description":"Text search","x-description-i18n":{"vie":"Tìm kiếm"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","description":"List of promotions","x-description-i18n":{"vie":"Danh sách khuyến mãi"},"items":{"$ref":"#/components/schemas/Promotion"}},"page_number":{"type":"integer","description":"Page number","x-description-i18n":{"vie":"Số trang"}},"page_size":{"type":"integer","description":"Page size","x-description-i18n":{"vie":"Kích thước trang"}},"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}},"total_entries":{"type":"integer","description":"Total entries","x-description-i18n":{"vie":"Tổng số bản ghi"}},"total_pages":{"type":"integer","description":"Total pages","x-description-i18n":{"vie":"Tổng số trang"}}}},"examples":{"default":{"value":{"success":true,"data":[{"id":"260a0d45-ba88-457b-8b31-afa3fda0ce0e","display_id":50,"name":"km 345","type":"discount_by_product","start_time":"2022-03-10T05:04:11Z","end_time":"2022-03-11T05:04:13Z","warehouse_ids":[],"customer_tags":[],"order_sources":[],"group_name":"Nhóm 1","is_activated":true,"is_variation":true,"is_used":null,"is_free_shipping":false,"is_discount_in_birthday_customer":false,"coupon_info":{"discount":0,"is_percent":false},"promo_code_info":{"discount":0,"is_percent":false,"max_discount_by_percent":0},"discount_by_quantity":1,"items":[{"id":"bd11e48a-6fec-4e3a-a1b7-8ef834a98dae","promotion_advance_id":"260a0d45-ba88-457b-8b31-afa3fda0ce0e","shop_id":3,"product_id":null,"variation_id":"2f3aea54-5c0c-44db-9f9b-2c987c298795","category_id":null,"product":null,"variation":{"id":"2f3aea54-5c0c-44db-9f9b-2c987c298795","display_id":"SB21-M-DEN","product_id":"d6d13d0b-320e-4651-a368-de2c9e30ae66","retail_price":250000,"retail_price_after_discount":238000},"level_info":[{"discount":30000,"is_percent":false,"from_quantity":1,"to_quantity":4}],"fixed_prices":0,"coupon_item_info":{"discount":0,"is_percent":false},"limited_quantity":0,"limited_quantity_used":0,"attachment_product_info":[],"discount_info_by_attachment_product":null}],"bonus_items":[],"total_quantity_bonus":0,"arr_level_promotion":[],"level_order_prices":[],"priority_level":null,"type_employee":"all","post_ids":[],"shop_id":3,"creator_id":"4eab0efc-2994-4b96-acf0-e4c847668555","inserted_at":"2022-03-10T05:04:33Z","updated_at":"2022-04-08T08:14:58Z"}]}}}}}}}},"post":{"summary":"Create promotion product","x-summary-i18n":{"vie":"Tạo khuyến mãi"},"description":"Create promotion","x-description-i18n":{"vie":"Tạo khuyến mãi"},"tags":["Promotion"],"x-tags-i18n":{"vie":["Khuyến mãi"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["promotion_advance"],"properties":{"promotion_advance":{"type":"object","required":["name","type"],"properties":{"name":{"type":"string","description":"Promotion name","x-description-i18n":{"vie":"Tên khuyến mãi"}},"start_time":{"type":"integer","description":"Start time","x-description-i18n":{"vie":"Thời điểm bắt đầu"}},"end_time":{"type":"integer","description":"End time","x-description-i18n":{"vie":"Thời điểm kết thúc"}},"warehouse_ids":{"type":"array","description":"Warehouse IDs","x-description-i18n":{"vie":"Danh sách mã kho"},"items":{"type":"string"}},"customer_tags":{"type":"array","description":"Customer tags","x-description-i18n":{"vie":"Thẻ khách hàng"},"items":{"type":"string"}},"order_sources":{"type":"array","description":"Order sources","x-description-i18n":{"vie":"Nguồn đơn hàng"},"items":{"type":"object"}},"type":{"type":"string","description":"Promotion type","x-description-i18n":{"vie":"Loại khuyến mãi"},"enum":["discount_by_product","discount_by_order_price","fixed_prices","coupon","double_reward_point","discount_by_coupon_id","discount_by_attachment_products"],"x-enum-descriptions":{"discount_by_product":"Giảm giá theo số lượng sản phẩm","discount_by_order_price":"Khuyến mãi theo giá trị đơn hàng","fixed_prices":"Đồng giá","coupon":"Khuyến mãi chung","double_reward_point":"Khuyến mãi x2 điểm thưởng","discount_by_coupon_id":"Mã khuyến mãi (voucher)","discount_by_attachment_products":"Khuyến mãi sản phẩm theo sản phẩm đính kèm"}},"group_name":{"type":"string","description":"Promotion group","x-description-i18n":{"vie":"Nhóm khuyến mãi"}},"is_activated":{"type":"boolean","description":"Is activated","x-description-i18n":{"vie":"Đã kích hoạt"}},"is_variation":{"type":"boolean","description":"Is variation","x-description-i18n":{"vie":"Là mẫu mã"}},"coupon_info":{"type":"object","description":"Coupon information","x-description-i18n":{"vie":"Thông tin coupon"},"properties":{"discount":{"type":"integer","description":"Discount","x-description-i18n":{"vie":"Giảm giá"}},"is_percent":{"type":"boolean","description":"Is percent","x-description-i18n":{"vie":"Là phần trăm"}},"is_categories":{"type":"boolean","description":"Is categories","x-description-i18n":{"vie":"Là danh mục"}},"category_ids":{"type":"array","description":"Category IDs","x-description-i18n":{"vie":"Danh sách ID danh mục"},"items":{"type":"integer"}}}},"promo_code_info":{"type":"object","description":"Promotion code information","x-description-i18n":{"vie":"Thông tin mã khuyến mãi"},"properties":{"discount":{"type":"integer","description":"Discount","x-description-i18n":{"vie":"Giảm giá"}},"is_percent":{"type":"boolean","description":"Is percent","x-description-i18n":{"vie":"Là phần trăm"}},"max_discount_by_percent":{"type":"integer","description":"Maximum discount by percent","x-description-i18n":{"vie":"Phần trăm giảm tối đa"}}}},"items":{"type":"array","description":"Promotion items","x-description-i18n":{"vie":"Danh sách sản phẩm khuyến mãi"},"items":{"type":"object","properties":{"variation_id":{"type":"string","description":"Variation ID","x-description-i18n":{"vie":"Mã mẫu mã"}},"product_id":{"type":"string","nullable":true,"description":"Product ID","x-description-i18n":{"vie":"Mã sản phẩm"}},"category_id":{"type":"string","nullable":true,"description":"Category ID","x-description-i18n":{"vie":"Mã danh mục"}},"category":{"type":"object","description":"Category","x-description-i18n":{"vie":"Danh mục"}},"level_info":{"type":"array","description":"Level info","x-description-i18n":{"vie":"Thông tin mức khuyến mãi theo sản phẩm"},"items":{"type":"object","properties":{"from_quantity":{"type":"integer","description":"From quantity","x-description-i18n":{"vie":"Từ số lượng"}},"to_quantity":{"type":"integer","description":"To quantity","x-description-i18n":{"vie":"Đến số lượng"}},"discount":{"type":"integer","description":"Discount","x-description-i18n":{"vie":"Giảm giá"}},"is_percent":{"type":"boolean","description":"Is percent","x-description-i18n":{"vie":"Là phần trăm"}}}}},"fixed_prices":{"type":"integer","description":"Fixed prices","x-description-i18n":{"vie":"Giá cố định"}},"coupon_item_info":{"type":"object","description":"Coupon item info","x-description-i18n":{"vie":"Thông tin coupon sản phẩm"},"properties":{"discount":{"type":"integer","description":"Discount","x-description-i18n":{"vie":"Giá trị giảm giá"}},"is_percent":{"type":"boolean","description":"Is percent","x-description-i18n":{"vie":"Phần trăm giảm giá"}},"max_discount_by_percent":{"type":"integer","description":"Maximum discount by percent","x-description-i18n":{"vie":"Số tiền tối đa giảm theo phần trăm"}}}}}}},"is_free_shipping":{"type":"boolean","description":"Is free shipping","x-description-i18n":{"vie":"Miễn phí vận chuyển"}},"discount_by_quantity":{"type":"integer","description":"Discount by quantity","x-description-i18n":{"vie":"Giảm giá theo số lượng"}},"bonus_items":{"type":"array","description":"Bonus items","x-description-i18n":{"vie":"Sản phẩm tặng kèm"},"items":{"type":"object"}},"is_discount_in_birthday_customer":{"type":"boolean","description":"Is discount in birthday customer","x-description-i18n":{"vie":"Giảm giá khách hàng sinh nhật"}},"arr_level_promotion":{"type":"array","description":"Level promotion array","x-description-i18n":{"vie":"Mức độ khuyến mãi"},"items":{"type":"object"}},"total_quantity_bonus":{"type":"integer","description":"Total quantity bonus","x-description-i18n":{"vie":"Tổng số lượng tặng"}},"priority_level":{"type":"integer","description":"Priority level","x-description-i18n":{"vie":"Mức độ ưu tiên"}},"type_employee":{"type":"string","description":"Type employee","x-description-i18n":{"vie":"Loại nhân viên"}},"free_products":{"type":"array","description":"Free products","x-description-i18n":{"vie":"Sản phẩm tặng kèm"},"items":{"type":"object","properties":{"is_active":{"type":"boolean","description":"Is active","x-description-i18n":{"vie":"Trạng thái kích hoạt"}},"products_count":{"type":"integer","description":"Products count","x-description-i18n":{"vie":"Số lượng sản phẩm"}},"count_free_products":{"type":"integer","description":"Count free products","x-description-i18n":{"vie":"Số lượng sản phẩm tặng"}},"type":{"type":"string","description":"Type","x-description-i18n":{"vie":"Loại"}}}}}}}}}}},"description":"Request body containing promotion information to create","x-description-i18n":{"vie":"Thông tin yêu cầu chứa thông tin khuyến mãi cần tạo"}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}}}},"examples":{"default":{"$ref":"#/components/examples/SuccessResponse"}}}}}}}},"/shops/{SHOP_ID}/promotion_advance/{PROMOTION_ID}":{"put":{"summary":"Update promotion product","x-summary-i18n":{"vie":"Cập nhật khuyến mãi"},"description":"Update promotion","x-description-i18n":{"vie":"Cập nhật khuyến mãi"},"tags":["Promotion"],"x-tags-i18n":{"vie":["Khuyến mãi"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},{"name":"PROMOTION_ID","in":"path","required":true,"schema":{"type":"string","example":"949f1396-f6fa-45d9-93b6-4c37503a9950"},"description":"Promotion ID","x-description-i18n":{"vie":"Mã khuyến mãi"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["promotion_advance"],"properties":{"promotion_advance":{"$ref":"#/components/schemas/Promotion"}}}}},"description":"Request body containing promotion information to update","x-description-i18n":{"vie":"Thông tin yêu cầu chứa thông tin khuyến mãi cần cập nhật"}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}}}},"examples":{"default":{"$ref":"#/components/examples/SuccessResponse"}}}}}}}},"/shops/{SHOP_ID}/promotion_advance/delete_multi":{"post":{"summary":"Activate/Deactivate/Delete promotions","x-summary-i18n":{"vie":"Kích hoạt/Vô hiệu hóa/Xóa khuyến mãi"},"description":"Activate, deactivate or delete multiple promotions","x-description-i18n":{"vie":"Kích hoạt, vô hiệu hóa hoặc xóa nhiều khuyến mãi"},"tags":["Promotion"],"x-tags-i18n":{"vie":["Khuyến mãi"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["ids","type_action"],"properties":{"ids":{"type":"array","description":"Promotion IDs","x-description-i18n":{"vie":"Danh sách mã khuyến mãi"},"items":{"type":"string"}},"type_action":{"type":"string","description":"Action type","x-description-i18n":{"vie":"Loại hành động"},"enum":["DEACTIVE_PROMOTIONS","ACTIVE_PROMOTIONS","DELETE_PROMOTIONS"],"x-enum-descriptions":["Deactivate promotions","Activate promotions","Delete promotions"],"x-enum-descriptions-i18n":{"vie":["Vô hiệu hóa khuyến mãi","Kích hoạt khuyến mãi","Xóa khuyến mãi"]}}},"example":{"ids":["0fe988a1-26a5-4772-b4b6-a9c17c9f40cd"],"type_action":"DEACTIVE_PROMOTIONS"}}}},"description":"Request body containing promotion IDs to delete","x-description-i18n":{"vie":"Thông tin yêu cầu chứa danh sách mã khuyến mãi cần xóa"}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}}}},"examples":{"default":{"$ref":"#/components/examples/SuccessResponse"}}}}}}}},"/shops/{SHOP_ID}/vouchers":{"get":{"summary":"List of voucher","x-summary-i18n":{"vie":"Danh sách phiếu giảm giá"},"description":"Get list of vouchers","x-description-i18n":{"vie":"Lấy danh sách phiếu giảm giá"},"tags":["Voucher"],"x-tags-i18n":{"vie":["Mã giảm giá"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","description":"List of vouchers","x-description-i18n":{"vie":"Danh sách phiếu giảm giá"},"items":{"$ref":"#/components/schemas/Voucher"}},"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}}}},"examples":{"default":{"value":{"success":true,"data":[{"id":"9589b791-013f-4a5b-b8d1-164fad73d84e","display_id":7,"name":"d5IvGYtj","type":"discount_by_coupon_id","start_time":"2021-12-09T04:27:23Z","end_time":"2021-12-10T04:27:26Z","promo_code_info":{"discount":4534,"is_percent":false,"max_discount_by_percent":0},"is_free_shipping":false,"is_activated":true,"is_used":null,"customer_tags":["Tiềm năng"],"shop_id":3,"creator_id":"d6e6a545-f102-439e-9943-8ac8369f9735","inserted_at":"2021-12-06T04:27:40Z","updated_at":"2021-12-10T02:26:59Z"}]}}}}}}}},"post":{"summary":"Create voucher","x-summary-i18n":{"vie":"Tạo phiếu giảm giá"},"description":"Create voucher","x-description-i18n":{"vie":"Tạo phiếu giảm giá"},"tags":["Voucher"],"x-tags-i18n":{"vie":["Mã giảm giá"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name","promo_code_info","start_time","end_time"],"properties":{"name":{"type":"string","description":"Voucher name","x-description-i18n":{"vie":"Mã giảm giá"}},"promo_code_info":{"type":"object","description":"Voucher promo code information","x-description-i18n":{"vie":"Thông tin giảm giá"},"required":["discount","is_percent"],"properties":{"discount":{"type":"integer","description":"Discount value","x-description-i18n":{"vie":"Số tiền giảm giá"}},"is_percent":{"type":"boolean","description":"Is percent","x-description-i18n":{"vie":"Giảm giá theo phần trăm"}},"max_discount_by_percent":{"type":"integer","description":"Maximum discount by percent","x-description-i18n":{"vie":"Phần trăm giảm tối đa"}}}},"is_free_shipping":{"type":"boolean","description":"Is free shipping","x-description-i18n":{"vie":"Miễn phí vận chuyển"}},"is_activated":{"type":"boolean","description":"Is activated","x-description-i18n":{"vie":"Đã kích hoạt"}},"customer_tags":{"type":"array","description":"Customer tags","x-description-i18n":{"vie":"Thẻ khách hàng"},"items":{"type":"string"}},"start_time":{"type":"string","format":"date-time","description":"Voucher start time","x-description-i18n":{"vie":"Ngày bắt đầu áp dụng"}},"end_time":{"type":"string","format":"date-time","description":"Voucher end time","x-description-i18n":{"vie":"Ngày kết thúc áp dụng"}}},"example":{"name":"test_voucher_5","promo_code_info":{"discount":53635,"is_percent":false},"is_free_shipping":false,"is_activated":true,"customer_tags":["New tag"],"start_time":"2021-12-09T04:27:23","end_time":"2021-12-10T04:27:26"}}}},"description":"Request body containing voucher information to create","x-description-i18n":{"vie":"Thông tin yêu cầu chứa thông tin voucher cần tạo"}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}}}},"examples":{"default":{"$ref":"#/components/examples/SuccessResponse"}}}}}}}},"/shops/{SHOP_ID}/vouchers/{VOUCHER_ID}":{"get":{"summary":"Get voucher info","x-summary-i18n":{"vie":"Lấy thông tin phiếu giảm giá"},"description":"Get voucher information","x-description-i18n":{"vie":"Lấy thông tin phiếu giảm giá"},"tags":["Voucher"],"x-tags-i18n":{"vie":["Mã giảm giá"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},{"name":"VOUCHER_ID","in":"path","required":true,"schema":{"type":"string","example":"949f1396-f6fa-45d9-93b6-4c37503a9950"},"description":"Voucher ID","x-description-i18n":{"vie":"Id phiếu giảm giá"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Voucher"},"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}}}},"examples":{"default":{"value":{"success":true,"data":{"id":"9589b791-013f-4a5b-b8d1-164fad73d84e","display_id":7,"name":"d5IvGYtj","type":"discount_by_coupon_id","start_time":"2021-12-09T04:27:23Z","end_time":"2021-12-10T04:27:26Z","promo_code_info":{"discount":4534,"is_percent":false,"max_discount_by_percent":0},"is_free_shipping":false,"is_activated":true,"is_used":null,"customer_tags":["Tiềm năng","Hay hoàn"],"shop_id":3,"creator_id":"d6e6a545-f102-439e-9943-8ac8369f9735","inserted_at":"2021-12-06T04:27:40Z","updated_at":"2021-12-06T04:27:40Z"}}}}}}}}}},"/shops/{SHOP_ID}/combo_products":{"get":{"summary":"Combo list","x-summary-i18n":{"vie":"Danh sách combo"},"description":"Get list of combo products","x-description-i18n":{"vie":"Lấy danh sách combo"},"tags":["Combo"],"x-tags-i18n":{"vie":["Combo"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","description":"List of combo products","x-description-i18n":{"vie":"Danh sách combo"},"items":{"type":"object","description":"Combo product information","x-description-i18n":{"vie":"Thông tin combo"}}},"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}}}},"examples":{"default":{"$ref":"#/components/examples/SuccessEmptyDataResponse"}}}}}}},"post":{"summary":"Create combo","x-summary-i18n":{"vie":"Tạo combo"},"description":"Create combo product","x-description-i18n":{"vie":"Tạo combo"},"tags":["Combo"],"x-tags-i18n":{"vie":["Combo"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["combo_product"],"properties":{"combo_product":{"type":"object","required":["name","order_types","is_value_combo","is_use_percent","is_variation"],"properties":{"name":{"type":"string","description":"Combo name","x-description-i18n":{"vie":"Tên combo"}},"currency":{"type":"string","description":"Currency","x-description-i18n":{"vie":"Tiền tệ"}},"start_time":{"type":"integer","description":"Start time","x-description-i18n":{"vie":"Thời điểm bắt đầu"}},"end_time":{"type":"integer","description":"End time","x-description-i18n":{"vie":"Thời điểm kết thúc"}},"order_sources":{"type":"array","description":"Order sources","x-description-i18n":{"vie":"Nguồn đơn hàng"},"items":{"type":"object"}},"order_types":{"type":"array","description":"Order types","x-description-i18n":{"vie":"Loại đơn hàng"},"items":{"type":"string","enum":["all","online","offline"]}},"livestream_manager_ids":{"type":"array","description":"Livestream manager IDs","x-description-i18n":{"vie":"Danh sách mã quản lý livestream"},"items":{"type":"string"}},"is_value_combo":{"type":"boolean","description":"Discount type (true: combo value / false: discount combo)","x-description-i18n":{"vie":"Loại giảm giá (true: giá trị combo / false: giảm giá combo)"}},"value_combo":{"type":"integer","description":"Combo value","x-description-i18n":{"vie":"Giá trị combo"}},"is_use_percent":{"type":"boolean","description":"Discount by percent","x-description-i18n":{"vie":"Giảm giá theo phần trăm"}},"discount_amount":{"type":"integer","description":"Discount value","x-description-i18n":{"vie":"Giá trị giảm giá"}},"discount_by_percent":{"type":"integer","description":"Percentage discount","x-description-i18n":{"vie":"Phần trăm giảm giá"}},"max_discount_by_percent":{"type":"integer","description":"Maximum discount value","x-description-i18n":{"vie":"Giá trị giảm giá tối đa"}},"is_free_shipping":{"type":"boolean","description":"Is free shipping","x-description-i18n":{"vie":"Miễn phí vận chuyển"}},"bonus_products":{"type":"array","description":"Bonus products","x-description-i18n":{"vie":"Sản phẩm tặng kèm"},"items":{"type":"object"}},"is_variation":{"type":"boolean","description":"Apply to variation (true) / Apply to product (false)","x-description-i18n":{"vie":"Áp dụng cho mẫu mã (true) / Áp dụng cho sản phẩm (false)"}},"variations":{"type":"array","description":"Applicable variation information","x-description-i18n":{"vie":"Thông tin mẫu mã áp dụng"},"items":{"type":"object","required":["count","product_id"],"properties":{"count":{"type":"integer","description":"Quantity","x-description-i18n":{"vie":"Số lượng"}},"product_id":{"type":"string","description":"Product ID","x-description-i18n":{"vie":"Mã sản phẩm"}},"variation_id":{"type":"string","description":"Variation ID","x-description-i18n":{"vie":"Mã mẫu mã"}}}}},"is_categories":{"type":"boolean","description":"Apply to category","x-description-i18n":{"vie":"Áp dụng cho danh mục"}},"categories":{"type":"array","description":"Applicable categories","x-description-i18n":{"vie":"Danh mục áp dụng"},"items":{"type":"object","properties":{"id":{"type":"string","description":"Category ID","x-description-i18n":{"vie":"Mã danh mục"}},"quantity":{"type":"integer","description":"Quantity","x-description-i18n":{"vie":"Số lượng"}}}}}}}},"example":{"combo_product":{"name":"Combo 1","currency":"VND","start_time":1745946000,"end_time":1746637199,"order_sources":[{"key":"-3","account":null},{"key":"-1","account":"406"}],"order_types":["all"],"is_value_combo":false,"value_combo":0,"is_use_percent":false,"discount_amount":100000,"discount_by_percent":5,"max_discount_by_percent":100000,"is_free_shipping":false,"is_variation":true,"variations":[{"count":1,"product_id":"0cffd0a6-0a06-4471-a139-cf81aa1fcc6f","variation_id":"821e1337-a04b-473a-b07c-805a572c465a"}]}}}}},"description":"Request body containing combo product information to create","x-description-i18n":{"vie":"Thông tin yêu cầu chứa thông tin combo sản phẩm cần tạo"}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}}}},"examples":{"default":{"$ref":"#/components/examples/SuccessResponse"}}}}}}}},"/shops/{SHOP_ID}/analytics/sale":{"get":{"summary":"Order statistics","x-summary-i18n":{"vie":"Thống kê đơn hàng"},"description":"Get order statistics","x-description-i18n":{"vie":"Lấy thống kê đơn hàng"},"tags":["Statistics"],"x-tags-i18n":{"vie":["Thống kê"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},{"name":"since","in":"query","required":false,"schema":{"type":"string","format":"date-time","example":"2024-01-01T00:00:00Z"},"description":"Start date","x-description-i18n":{"vie":"Thời gian bắt đầu thống kê"}},{"name":"until","in":"query","required":false,"schema":{"type":"string","format":"date-time","example":"2024-12-31T23:59:59Z"},"description":"End date","x-description-i18n":{"vie":"Thời gian kết thúc thống kê"}},{"name":"split_by[]","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","enum":["Time.hour","Time.day","Time.month","Time.year","Order.source","Order.order_sources","Order.status","Order.warehouse_id","Order.post_id","Order.partner_id","Order.marketplace_id","Order.country_code","Order.province_id","Order.district_id","Order.commune_id","Order.region_filter","Order.tag","Order.is_wholesale","Order.is_livestream","Order.livestream_manager_ids","Order.total_price","Order.ads_or_normal","Order.ad_account_id","Order.ad_id","User.id","User.sale_group","User.department_id","Customer.id","Customer.level_id","Customer.new","Variation.id","Variation.product_id","Variation.category","Variation.supplier","Variation.brand_id","Variation.tag","Variation.price_range","Variation.quantity_range","Variation.upsale","Variation.quantity","UTM.p_utm_source","UTM.p_utm_campaign","UTM.p_utm_medium","UTM.p_utm_term","UTM.p_utm_content","Promotion.default","Promotion.advance","Promotion.combo","Ads.ad_id","Ads.ad_set_id","Ads.ad_campaign_id"]},"example":["Time.day"]},"description":"Group statistics by one or more dimensions. Each value is a `<Table>.<field>` key.\n- `Time.hour` / `Time.day` / `Time.month` / `Time.year` — by date bucket\n- `Order.source` / `Order.order_sources` — by order source / account\n- `Order.status` — by order status code\n- `Order.warehouse_id` — by warehouse\n- `Order.post_id` — by Facebook post\n- `Order.partner_id` — by shipping carrier\n- `Order.marketplace_id` — by e-commerce marketplace\n- `Order.country_code` / `Order.province_id` / `Order.district_id` / `Order.commune_id` / `Order.region_filter` — by shipping geography\n- `Order.tag` — by order tag\n- `Order.is_wholesale` / `Order.is_livestream` — wholesale / livestream flag\n- `Order.livestream_manager_ids` — by livestream manager\n- `Order.total_price` — by order total price bucket\n- `Order.ads_or_normal` / `Order.ad_account_id` / `Order.ad_id` — ad partitioning\n- `User.id` / `User.sale_group` / `User.department_id` — by staff / sale group / department\n- `Customer.id` / `Customer.level_id` / `Customer.new` — by customer / level / new vs. old\n- `Variation.id` / `Variation.product_id` — by variation / product\n- `Variation.category` / `Variation.supplier` / `Variation.brand_id` / `Variation.tag` — by product taxonomy\n- `Variation.price_range` / `Variation.quantity_range` — by product price/quantity bucket\n- `Variation.upsale` / `Variation.quantity` — upsell flag / sold quantity\n- `UTM.p_utm_source` / `UTM.p_utm_campaign` / `UTM.p_utm_medium` / `UTM.p_utm_term` / `UTM.p_utm_content` — by UTM tag\n- `Promotion.default` / `Promotion.advance` / `Promotion.combo` — by promotion / combo\n- `Ads.ad_id` / `Ads.ad_set_id` / `Ads.ad_campaign_id` — by ad / ad set / campaign\n","x-description-i18n":{"vie":"Thống kê theo một hoặc nhiều chiều, mỗi giá trị là khoá `<Table>.<field>`.\n- `Time.hour` / `Time.day` / `Time.month` / `Time.year` — theo giờ / ngày / tháng / năm\n- `Order.source` / `Order.order_sources` — theo nguồn đơn / tài khoản\n- `Order.status` — theo trạng thái đơn\n- `Order.warehouse_id` — theo kho\n- `Order.post_id` — theo bài viết Facebook\n- `Order.partner_id` — theo đối tác vận chuyển\n- `Order.marketplace_id` — theo sàn TMĐT\n- `Order.country_code` / `Order.province_id` / `Order.district_id` / `Order.commune_id` / `Order.region_filter` — theo địa lý giao hàng\n- `Order.tag` — theo tag đơn hàng\n- `Order.is_wholesale` / `Order.is_livestream` — đơn buôn / đơn livestream\n- `Order.livestream_manager_ids` — theo người quản lý livestream\n- `Order.total_price` — theo khoảng tổng tiền đơn\n- `Order.ads_or_normal` / `Order.ad_account_id` / `Order.ad_id` — phân nhóm quảng cáo\n- `User.id` / `User.sale_group` / `User.department_id` — theo nhân viên / nhóm bán / phòng ban\n- `Customer.id` / `Customer.level_id` / `Customer.new` — theo khách hàng / hạng / khách mới\n- `Variation.id` / `Variation.product_id` — theo mẫu mã / sản phẩm\n- `Variation.category` / `Variation.supplier` / `Variation.brand_id` / `Variation.tag` — theo danh mục / NCC / thương hiệu / tag SP\n- `Variation.price_range` / `Variation.quantity_range` — theo khoảng giá / khoảng SL\n- `Variation.upsale` / `Variation.quantity` — cờ upsell / SL bán\n- `UTM.p_utm_source` / `UTM.p_utm_campaign` / `UTM.p_utm_medium` / `UTM.p_utm_term` / `UTM.p_utm_content` — theo UTM\n- `Promotion.default` / `Promotion.advance` / `Promotion.combo` — theo khuyến mại / combo\n- `Ads.ad_id` / `Ads.ad_set_id` / `Ads.ad_campaign_id` — theo ad / ad set / chiến dịch\n"}},{"name":"filter","in":"query","required":false,"schema":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}},"example":{"Variation.product_id":["4a6fc152-5989-4202-83d4-a11a2ab28078"],"Order.status":["3"]}},"description":"Filter applied to the order set. Object keyed by `<Table>.<field>`; each value is an array of strings.\nAppend `_exclude` to a key to negate it (e.g. `Order.status_exclude`, `Variation.category_exclude`).\nAppend `_and` to AND-combine multi-valued list filters (e.g. `Variation.tags_and`).\nCommon keys:\n- `Variation.id` / `Variation.product_id` — by variation / product\n- `Variation.category` / `Variation.supplier` / `Variation.brand_id` / `Variation.brand` — by product taxonomy\n- `Variation.tag` / `Variation.tags` / `Variation.attribute` — by product tag / attribute\n- `Variation.price_range` / `Variation.quantity_range` / `Variation.quantity` — by product price/quantity\n- `Variation.upsale` / `Variation.one_time_product` / `Variation.is_bonus_product` / `Variation.product_price_of_zero` / `Variation.unlink_ecommerce` — flag filters\n- `Order.source` / `Order.source_exclude` / `Order.order_sources` — order source\n- `Order.status` — order status code\n- `Order.warehouse_id` / `Order.post_id` / `Order.partner_id` / `Order.shop_partner_id` / `Order.marketplace_id` — operational filters\n- `Order.country_code` / `Order.province_id` / `Order.district_id` / `Order.commune_id` / `Order.region_filter` / `Order.region_filter_phil` — shipping geography\n- `Order.tag` / `Order.is_wholesale` / `Order.is_livestream` / `Order.received_at_shop` / `Order.is_upsale_order` — order flags\n- `Order.total_price` / `Order.revenue` — by total/revenue bucket\n- `Order.ad_id` / `Order.ads_source` / `Order.ad_account_id` / `Order.ads_or_normal` — ads filters\n- `Order.order_currency` — order currency\n- `Order.id` / `Order.project` — by order id / project\n- `Order.p_utm_source` / `Order.p_utm_campaign` / `Order.p_utm_medium` / `Order.p_utm_term` / `Order.p_utm_content` / `Order.utm_affiliate` / `Order.link` — UTM filters\n- `Order.instant` / `Order.N24H` / `Order.GSGN` — service partner filters\n- `Order.livestream_manager_id` / `Order.livestream_manager_ids` — livestream manager\n- `User.id` / `User.sale_group` / `User.department_id` / `User.pke_mkter` / `User.assigning_seller_id` / `User.assigning_care_id` / `User.item_assign_seller_id` — staff filters\n- `Customer.id` / `Customer.level_id` / `Customer.gender` / `Customer.tag` / `Customer.conversation_tags` / `Customer.new` / `Customer.referral_code` — customer filters\n- `Promotion.default` / `Promotion.advance` / `Promotion.id` / `Promotion.combo` — promotion filters\n","x-description-i18n":{"vie":"Bộ lọc áp dụng cho tập đơn hàng. Object có khoá dạng `<Table>.<field>`, giá trị là mảng chuỗi.\nThêm hậu tố `_exclude` để loại trừ (ví dụ `Order.status_exclude`, `Variation.category_exclude`).\nThêm hậu tố `_and` để AND-kết hợp các filter dạng danh sách (ví dụ `Variation.tags_and`).\nCác khoá thường dùng:\n- `Variation.id` / `Variation.product_id` — theo mẫu mã / sản phẩm\n- `Variation.category` / `Variation.supplier` / `Variation.brand_id` / `Variation.brand` — theo danh mục / NCC / thương hiệu\n- `Variation.tag` / `Variation.tags` / `Variation.attribute` — theo tag / thuộc tính SP\n- `Variation.price_range` / `Variation.quantity_range` / `Variation.quantity` — theo khoảng giá / khoảng SL\n- `Variation.upsale` / `Variation.one_time_product` / `Variation.is_bonus_product` / `Variation.product_price_of_zero` / `Variation.unlink_ecommerce` — các cờ SP\n- `Order.source` / `Order.source_exclude` / `Order.order_sources` — nguồn đơn\n- `Order.status` — mã trạng thái đơn\n- `Order.warehouse_id` / `Order.post_id` / `Order.partner_id` / `Order.shop_partner_id` / `Order.marketplace_id` — vận hành\n- `Order.country_code` / `Order.province_id` / `Order.district_id` / `Order.commune_id` / `Order.region_filter` / `Order.region_filter_phil` — địa lý giao hàng\n- `Order.tag` / `Order.is_wholesale` / `Order.is_livestream` / `Order.received_at_shop` / `Order.is_upsale_order` — cờ đơn\n- `Order.total_price` / `Order.revenue` — theo khoảng tổng tiền / doanh thu\n- `Order.ad_id` / `Order.ads_source` / `Order.ad_account_id` / `Order.ads_or_normal` — quảng cáo\n- `Order.order_currency` — tiền tệ đơn\n- `Order.id` / `Order.project` — theo mã đơn / dự án\n- `Order.p_utm_source` / `Order.p_utm_campaign` / `Order.p_utm_medium` / `Order.p_utm_term` / `Order.p_utm_content` / `Order.utm_affiliate` / `Order.link` — UTM\n- `Order.instant` / `Order.N24H` / `Order.GSGN` — dịch vụ vận chuyển\n- `Order.livestream_manager_id` / `Order.livestream_manager_ids` — người quản lý livestream\n- `User.id` / `User.sale_group` / `User.department_id` / `User.pke_mkter` / `User.assigning_seller_id` / `User.assigning_care_id` / `User.item_assign_seller_id` — nhân viên\n- `Customer.id` / `Customer.level_id` / `Customer.gender` / `Customer.tag` / `Customer.conversation_tags` / `Customer.new` / `Customer.referral_code` — khách hàng\n- `Promotion.default` / `Promotion.advance` / `Promotion.id` / `Promotion.combo` — khuyến mại / combo\n"}},{"name":"success_status","in":"query","required":false,"schema":{"type":"string","example":"send_to_partner"},"description":"Success status","x-description-i18n":{"vie":"'send_to_partner': Tính đơn chốt khi đẩy sang ĐVVC<br />'1': Tính đơn chốt khi cập nhật sang trạng thái đã xác nhận"}},{"name":"success_record","in":"query","required":false,"schema":{"type":"string","example":"inserted_at"},"description":"Success record","x-description-i18n":{"vie":"'inserted_at': Doanh thu cộng vào thời điểm tạo đơn<br />'updated_at': Doanh thu cộng vào thời điểm cập nhật trạng thái"}},{"name":"user_type","in":"query","required":false,"schema":{"type":"string","example":"create"},"description":"User type","x-description-i18n":{"vie":"Tính đơn cho nhân viên ('create': Tạo đơn, 'update': Cập nhật trạng thái, 'assign': NV được phân công, 'care': NV chăm sóc, 'marketer': NV Marketing)"}},{"name":"returned_record","in":"query","required":false,"schema":{"type":"string","example":"inserted_at"},"description":"Returned record","x-description-i18n":{"vie":"Doanh thu sẽ trừ vào thời điểm ('inserted_at': Tạo đơn, 'updated_at': Cập nhật trạng thái, 'success_record': Chốt đơn)"}},{"name":"select_fields[]","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"},"example":["cod","price","order_count"]},"description":"Select fields","x-description-i18n":{"vie":"Các số liệu cần lấy"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","description":"Statistics data","x-description-i18n":{"vie":"Dữ liệu thống kê"},"items":{"type":"object","description":"Statistics item. Fields depend on split_by and select_fields parameters","x-description-i18n":{"vie":"Mục thống kê. Các trường phụ thuộc vào tham số split_by và select_fields"},"additionalProperties":true,"properties":{"Time.day":{"type":"string","description":"Statistic day","x-description-i18n":{"vie":"Ngày thống kê"}},"returned":{"type":"object","nullable":true,"description":"Returned order statistics","x-description-i18n":{"vie":"Thông tin dữ liệu các đơn hoàn"},"additionalProperties":true,"properties":{"cod":{"type":"integer","description":"COD amount","x-description-i18n":{"vie":"Tổng tiền cần thu"}},"discount":{"type":"integer","description":"Discount total","x-description-i18n":{"vie":"Tổng tiền giảm giá"}},"order_count":{"type":"integer","description":"Order count","x-description-i18n":{"vie":"Số lượng đơn hàng"}},"price":{"type":"integer","description":"Goods price","x-description-i18n":{"vie":"Giá hàng"}},"avg_price":{"type":"integer","description":"Average price","x-description-i18n":{"vie":"Giá trung bình"}},"product_count":{"type":"integer","description":"Product count","x-description-i18n":{"vie":"Số lượng sản phẩm"}},"shipping_fee":{"type":"integer","description":"Shipping fee","x-description-i18n":{"vie":"Phí vận chuyển"}}}},"success":{"type":"object","description":"Success order statistics","x-description-i18n":{"vie":"Thông tin dữ liệu các đơn thành công"},"additionalProperties":true,"properties":{"cod":{"type":"integer","description":"COD amount","x-description-i18n":{"vie":"Tổng tiền cần thu"}},"discount":{"type":"integer","description":"Discount total","x-description-i18n":{"vie":"Tổng tiền giảm giá"}},"order_count":{"type":"integer","description":"Order count","x-description-i18n":{"vie":"Số lượng đơn hàng"}},"price":{"type":"integer","description":"Goods price","x-description-i18n":{"vie":"Giá hàng"}},"avg_price":{"type":"integer","description":"Average price","x-description-i18n":{"vie":"Giá trung bình"}},"product_count":{"type":"integer","description":"Product count","x-description-i18n":{"vie":"Số lượng sản phẩm"}},"shipping_fee":{"type":"integer","description":"Shipping fee","x-description-i18n":{"vie":"Phí vận chuyển"}}}}}}},"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}}}},"examples":{"default":{"value":{"success":true,"data":[{"Time.day":"2020-07-22","returned":null,"success":{"cod":1710000,"discount":0,"order_count":3,"price":1800000,"product_count":18,"shipping_fee":0,"custom_formula_d6ae-ad02-be3d-b26e-3f65-d497-33c4":1000000}},{"Time.day":"2020-07-27","returned":null,"success":{"cod":570000,"discount":0,"order_count":1,"price":600000,"avg_price":600000,"product_count":6,"shipping_fee":0,"custom_formula_d6ae-ad02-be3d-b26e-3f65-d497-33c4":1000000}},{"Time.day":"2020-07-28","returned":null,"success":{"cod":5130000,"discount":0,"order_count":9,"price":5400000,"avg_price":600000,"product_count":54,"shipping_fee":0,"custom_formula_d6ae-ad02-be3d-b26e-3f65-d497-33c4":1200000}},{"Time.day":"2020-07-30","returned":null,"success":{"cod":570000,"discount":0,"order_count":1,"price":600000,"avg_price":600000,"product_count":6,"shipping_fee":0,"custom_formula_d6ae-ad02-be3d-b26e-3f65-d497-33c4":1200000}}]}}}}}}}}},"/shops/{SHOP_ID}/analytics/get_list_formula":{"get":{"summary":"List of customized formulas","x-summary-i18n":{"vie":"Danh sách công thức tùy chỉnh"},"description":"Get list of customized formulas","x-description-i18n":{"vie":"Lấy danh sách công thức tùy chỉnh"},"tags":["Statistics"],"x-tags-i18n":{"vie":["Thống kê"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","description":"List of formulas","x-description-i18n":{"vie":"Danh sách công thức tùy chỉnh"},"items":{"type":"object","properties":{"formula":{"type":"string","description":"Formula","x-description-i18n":{"vie":"Công thức tính"}},"id":{"type":"string","description":"Formula ID","x-description-i18n":{"vie":"Mã công thức"}},"name":{"type":"string","description":"Formula name","x-description-i18n":{"vie":"Tên công thức"}},"unit":{"type":"string","description":"Unit","x-description-i18n":{"vie":"Đơn vị"}}}}},"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}}}},"examples":{"default":{"value":{"success":true,"data":[{"formula":"{price} - {shipping_fee}","id":"0ea7-bc72-ae51-0769-a7c9-ca34-fff6","name":"tien hang - phi ship","unit":"currency"},{"formula":"{revenue} + {transfer_money}","id":"3db3-72a7-c426-066a-4eed-a63b-be49","name":"doanh thu + ck$","unit":"currency"}]}}}}}}}}},"/shops/{SHOP_ID}/analytics/get_analytic_fields":{"get":{"summary":"List of analytic fields","x-summary-i18n":{"vie":"Danh sách số liệu mặc định"},"description":"Get list of analytic fields","x-description-i18n":{"vie":"Lấy danh sách số liệu mặc định"},"tags":["Statistics"],"x-tags-i18n":{"vie":["Thống kê"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","description":"List of analytic fields","x-description-i18n":{"vie":"Danh sách số liệu mặc định"},"items":{"type":"object","properties":{"id":{"type":"string","description":"Analytic field ID","x-description-i18n":{"vie":"Mã trường"}},"name":{"type":"string","description":"Analytic field name (localized via Accept-Language)","x-description-i18n":{"vie":"Tên trường (đa ngữ theo Accept-Language)"}},"description":{"type":"string","description":"Optional explanation of the field (localized via Accept-Language). Present only for fields that have a tooltip.","x-description-i18n":{"vie":"Mô tả ngắn của trường (đa ngữ theo Accept-Language). Chỉ có với các field có tooltip."}}}}},"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}}}},"examples":{"default":{"value":{"success":true,"data":[{"id":"price","name":"Tiền hàng"},{"id":"avg_price","name":"Giá bán trung bình"},{"id":"shipping_fee","name":"Phí VC thu của khách","description":"Tiền vận chuyển thu của khách."},{"id":"discount","name":"Chiết khấu","description":"Tổng số tiền giảm giá trên từng sản phẩm."},{"id":"product_count","name":"SL bán thực","description":"Hàng bán ra đã trừ SL hoàn/đổi trả"},{"id":"close_rate","name":"Tỷ lệ chốt","description":"Số đơn chốt / (Tổng số đơn - SL đơn xoá)."},{"id":"commissions","name":"Hoa hồng","description":"Hoa hồng cho nhân viên, có thể cài đặt trong phần cấu hình."}]}}}}}}}}},"/shops/{SHOP_ID}/statistic_custom/folders":{"get":{"summary":"List of custom statistic folders","x-summary-i18n":{"vie":"Danh sách thư mục báo cáo tùy chỉnh"},"description":"Get list of custom statistic folders and their report items (folder_items). Each folder groups related custom reports configured for the shop (e.g. revenue, orders, products, finance, debts).","x-description-i18n":{"vie":"Lấy danh sách thư mục báo cáo tùy chỉnh và các báo cáo bên trong (folder_items). Mỗi thư mục gom nhóm các báo cáo tùy chỉnh được cấu hình cho cửa hàng (ví dụ doanh thu, đơn hàng, sản phẩm, tài chính, công nợ)."},"tags":["Statistics"],"x-tags-i18n":{"vie":["Thống kê"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}},"folders":{"type":"array","description":"List of custom statistic folders","x-description-i18n":{"vie":"Danh sách thư mục báo cáo tùy chỉnh"},"items":{"type":"object","additionalProperties":true,"properties":{"name":{"type":"string","description":"Folder name (system key)","x-description-i18n":{"vie":"Tên hệ thống của thư mục"}},"label":{"type":"string","description":"Folder display label","x-description-i18n":{"vie":"Nhãn hiển thị của thư mục"}},"order":{"type":"integer","description":"Display order","x-description-i18n":{"vie":"Thứ tự hiển thị"}},"shop_id":{"type":"integer","description":"Shop ID","x-description-i18n":{"vie":"Mã cửa hàng"}},"creator_id":{"type":"string","nullable":true,"description":"Creator user ID (null for system default folders)","x-description-i18n":{"vie":"Mã người tạo (null đối với thư mục mặc định của hệ thống)"}},"last_editor_id":{"type":"string","nullable":true,"description":"Last editor user ID","x-description-i18n":{"vie":"Mã người chỉnh sửa cuối"}},"can_remove":{"type":"boolean","description":"Whether the folder can be removed","x-description-i18n":{"vie":"Thư mục có thể bị xóa hay không"}},"is_removed":{"type":"boolean","nullable":true,"description":"Whether the folder is removed","x-description-i18n":{"vie":"Thư mục đã bị xóa hay chưa"}},"setting":{"type":"object","nullable":true,"additionalProperties":true,"description":"Folder-level settings","x-description-i18n":{"vie":"Cấu hình ở cấp thư mục"}},"total_price_ranges":{"type":"array","nullable":true,"items":{"type":"object","additionalProperties":true},"description":"Price range buckets configured for the folder","x-description-i18n":{"vie":"Các khoảng giá được cấu hình cho thư mục"}},"inserted_at":{"type":"string","format":"date-time","description":"Created at","x-description-i18n":{"vie":"Thời gian tạo"}},"updated_at":{"type":"string","format":"date-time","description":"Updated at","x-description-i18n":{"vie":"Thời gian cập nhật"}},"folder_items":{"type":"array","description":"List of custom report items in the folder","x-description-i18n":{"vie":"Danh sách báo cáo tùy chỉnh trong thư mục"},"items":{"type":"object","additionalProperties":true,"properties":{"id":{"type":"string","description":"Report item ID","x-description-i18n":{"vie":"Mã báo cáo"}},"name":{"type":"string","description":"Report name (system key or custom title)","x-description-i18n":{"vie":"Tên báo cáo (khóa hệ thống hoặc tiêu đề tùy chỉnh)"}},"label":{"type":"string","nullable":true,"description":"Report display label","x-description-i18n":{"vie":"Nhãn hiển thị của báo cáo"}},"description":{"type":"string","nullable":true,"description":"Report description","x-description-i18n":{"vie":"Mô tả báo cáo"}},"folder_name":{"type":"string","description":"Parent folder system name","x-description-i18n":{"vie":"Tên hệ thống của thư mục cha"}},"parent_id":{"type":"string","nullable":true,"description":"Parent report item ID (for nested items)","x-description-i18n":{"vie":"Mã báo cáo cha (đối với báo cáo con)"}},"order":{"type":"integer","description":"Display order within the folder","x-description-i18n":{"vie":"Thứ tự hiển thị trong thư mục"}},"shop_id":{"type":"integer","description":"Shop ID","x-description-i18n":{"vie":"Mã cửa hàng"}},"creator_id":{"type":"string","nullable":true,"description":"Creator user ID","x-description-i18n":{"vie":"Mã người tạo"}},"last_editor_id":{"type":"string","nullable":true,"description":"Last editor user ID","x-description-i18n":{"vie":"Mã người chỉnh sửa cuối"}},"can_remove":{"type":"boolean","description":"Whether the report can be removed","x-description-i18n":{"vie":"Báo cáo có thể bị xóa hay không"}},"is_removed":{"type":"boolean","nullable":true,"description":"Whether the report is removed","x-description-i18n":{"vie":"Báo cáo đã bị xóa hay chưa"}},"attributes":{"type":"array","nullable":true,"items":{"type":"string"},"description":"Group-by attributes (e.g. \"Time.day\", \"Variation.product_id\", \"Order.source\")","x-description-i18n":{"vie":"Các thuộc tính dùng để nhóm dữ liệu (ví dụ \"Time.day\", \"Variation.product_id\", \"Order.source\")"}},"fields":{"type":"array","items":{"type":"string"},"description":"Selected metric fields (e.g. \"price\", \"revenue\", \"profit\")","x-description-i18n":{"vie":"Các trường số liệu được chọn (ví dụ \"price\", \"revenue\", \"profit\")"}},"filter":{"nullable":true,"description":"Report filter. Either an array of filter conditions or an object; each entry is keyed by attribute name with the filter value","x-description-i18n":{"vie":"Bộ lọc báo cáo. Có thể là mảng các điều kiện lọc hoặc object; mỗi mục có khóa là tên thuộc tính kèm giá trị lọc"},"oneOf":[{"type":"array","items":{"type":"object","additionalProperties":true}},{"type":"object","additionalProperties":true}]},"children":{"type":"array","items":{"type":"object","additionalProperties":true},"description":"Nested report items","x-description-i18n":{"vie":"Các báo cáo con"}},"charts":{"type":"array","nullable":true,"description":"Chart configurations rendered for this report","x-description-i18n":{"vie":"Cấu hình biểu đồ hiển thị cho báo cáo này"},"items":{"type":"object","additionalProperties":true,"properties":{"field":{"type":"string","description":"Metric field plotted by the chart","x-description-i18n":{"vie":"Trường số liệu hiển thị trên biểu đồ"}},"type":{"type":"string","description":"Chart type (e.g. \"bar-chart\", \"line-chart\")","x-description-i18n":{"vie":"Kiểu biểu đồ (ví dụ \"bar-chart\", \"line-chart\")"}},"top":{"type":"string","description":"Top-N filter (e.g. \"all\", \"10\")","x-description-i18n":{"vie":"Bộ lọc Top-N (ví dụ \"all\", \"10\")"}},"width":{"type":"integer","description":"Chart width in percent","x-description-i18n":{"vie":"Chiều rộng biểu đồ tính theo phần trăm"}}}}},"compare_ranges":{"type":"object","additionalProperties":true,"description":"Comparison range configuration","x-description-i18n":{"vie":"Cấu hình khoảng so sánh"},"properties":{"chart":{"type":"string","description":"Comparison chart type","x-description-i18n":{"vie":"Kiểu biểu đồ so sánh"}},"field":{"type":"string","nullable":true,"description":"Field to compare","x-description-i18n":{"vie":"Trường dữ liệu được so sánh"}},"ranges":{"type":"array","description":"Comparison ranges","x-description-i18n":{"vie":"Các khoảng so sánh"},"items":{"type":"object","properties":{"range":{"type":"string","description":"Range value","x-description-i18n":{"vie":"Giá trị khoảng"}}}}}}},"fill_color":{"type":"boolean","description":"Whether rows are color-filled in the report","x-description-i18n":{"vie":"Có tô màu các dòng trong báo cáo hay không"}},"setting":{"type":"object","additionalProperties":true,"description":"Per-report setting. Common keys:\n- `success_record` ('inserted_at' | 'updated_at' | 'success_record'): when revenue is counted\n- `success_status` (integer or string, e.g. 0, 1, 3, 'send_to_partner'): order status that counts as success\n- `returned_record` ('inserted_at' | 'updated_at' | 'success_record'): when returns are deducted\n- `returned_status` (integer): order status counted as returned\n- `user_type` ('create' | 'update' | 'assign' | 'care' | 'marketer'): how to attribute orders to staff\n- `product_price_range` (array): product price buckets\n","x-description-i18n":{"vie":"Cấu hình của từng báo cáo. Các khóa thường gặp:\n- `success_record` ('inserted_at' | 'updated_at' | 'success_record'): mốc tính doanh thu\n- `success_status` (số nguyên hoặc chuỗi, ví dụ 0, 1, 3, 'send_to_partner'): trạng thái đơn được tính là chốt\n- `returned_record` ('inserted_at' | 'updated_at' | 'success_record'): mốc trừ đơn hoàn\n- `returned_status` (số nguyên): trạng thái đơn được tính là hoàn\n- `user_type` ('create' | 'update' | 'assign' | 'care' | 'marketer'): cách quy đơn cho nhân viên\n- `product_price_range` (mảng): các khoảng giá sản phẩm\n"}},"sort_by_field":{"nullable":true,"description":"Sort configuration. Either a single sort object `{columnKey, field, order}`,\na multi-sort wrapper `{multi: [...]}`, or an empty object/null when not set.\n","x-description-i18n":{"vie":"Cấu hình sắp xếp. Có thể là một object sắp xếp đơn `{columnKey, field, order}`,\nobject đa sắp xếp `{multi: [...]}`, hoặc object rỗng/null khi chưa cấu hình.\n"},"oneOf":[{"type":"object","additionalProperties":true,"properties":{"columnKey":{"type":"string","description":"Column key being sorted","x-description-i18n":{"vie":"Khóa cột được sắp xếp"}},"field":{"type":"string","description":"Field being sorted","x-description-i18n":{"vie":"Trường được sắp xếp"}},"order":{"type":"string","enum":["ascend","descend"],"description":"Sort direction","x-description-i18n":{"vie":"Chiều sắp xếp"}},"multi":{"type":"array","description":"Multi-column sort definitions","x-description-i18n":{"vie":"Cấu hình sắp xếp nhiều cột"},"items":{"type":"object","properties":{"columnKey":{"type":"string"},"field":{"type":"string"},"order":{"type":"string","enum":["ascend","descend"]}}}}}}]},"time_range":{"type":"array","description":"Time range for the report. Values may be:\n- Number of days as string (e.g. \"1\", \"7\", \"30\", \"90\")\n- Keyword (e.g. \"monthAgo\")\n- Two ISO date-time strings for an explicit range\n- Empty array for no preset\n","x-description-i18n":{"vie":"Khoảng thời gian của báo cáo. Có thể là:\n- Số ngày dạng chuỗi (ví dụ \"1\", \"7\", \"30\", \"90\")\n- Từ khóa (ví dụ \"monthAgo\")\n- Hai chuỗi ngày giờ ISO cho khoảng tùy chỉnh\n- Mảng rỗng nếu không chọn preset\n"},"items":{"type":"string"}},"users_can_see":{"type":"array","nullable":true,"items":{"type":"string"},"description":"User IDs allowed to view this report (null means no restriction)","x-description-i18n":{"vie":"Danh sách mã người dùng được xem báo cáo (null nghĩa là không giới hạn)"}},"inserted_at":{"type":"string","format":"date-time","description":"Created at","x-description-i18n":{"vie":"Thời gian tạo"}},"updated_at":{"type":"string","format":"date-time","description":"Updated at","x-description-i18n":{"vie":"Thời gian cập nhật"}}}}}}}}}},"examples":{"default":{"value":{"success":true,"folders":[{"name":"OtherReports","label":"Báo cáo khác","order":-1,"shop_id":4,"creator_id":null,"last_editor_id":null,"can_remove":false,"is_removed":null,"setting":null,"total_price_ranges":null,"inserted_at":"2024-02-26T08:21:01","updated_at":"2024-02-26T08:21:01","folder_items":[{"id":"9d80f8b9-1c68-4026-81e6-70ed2381d360","name":"pages.shop.statistic.salesStatistics","label":"Doanh số","description":null,"folder_name":"employee","parent_id":null,"order":0,"shop_id":4,"creator_id":null,"last_editor_id":null,"can_remove":false,"is_removed":null,"attributes":null,"fields":["total_order_count","order_count","price","shipping_fee","discount","capital","product_count"],"filter":null,"children":[],"charts":null,"compare_ranges":{"chart":"bar-chart","field":"product_count","ranges":[{"range":"7"},{"range":"-7"}]},"fill_color":false,"setting":{"returned_record":"success_record","success_record":"inserted_at","success_status":0,"user_type":"assign"},"sort_by_field":null,"time_range":["90"],"users_can_see":null,"inserted_at":"2024-02-26T08:21:01","updated_at":"2024-02-26T08:21:01"}]},{"name":"Revenue","label":"Báo cáo doanh thu","order":1,"shop_id":4,"creator_id":null,"last_editor_id":null,"can_remove":false,"is_removed":null,"setting":null,"total_price_ranges":null,"inserted_at":"2023-09-20T03:01:25","updated_at":"2023-09-20T03:01:25","folder_items":[{"id":"9783d2e9-d973-4f6f-a735-f5883f4e678f","name":"commons.time","label":"Thời gian","description":null,"folder_name":"Revenue","parent_id":null,"order":0,"shop_id":4,"creator_id":null,"last_editor_id":null,"can_remove":false,"is_removed":null,"attributes":["Variation.product_id"],"fields":["success_order_count","returned_order_count","price","sales","revenue","capital","profit"],"filter":[],"children":[],"charts":[{"field":"success_order_count","top":"all","type":"bar-chart","width":100}],"compare_ranges":{"chart":"bar-chart","field":"profit","ranges":[{"range":"7"},{"range":"-7"}]},"fill_color":false,"setting":{"returned_record":"success_record","success_record":"updated_at","success_status":1,"user_type":"update"},"sort_by_field":{"multi":[{"columnKey":"product_count","field":"product_count","order":"descend"}]},"time_range":["30"],"users_can_see":null,"inserted_at":"2023-09-20T03:01:25","updated_at":"2026-05-05T04:33:58"}]}]}}}}}}}}},"/shops/{SHOP_ID}/inventory_analytics/inventory":{"get":{"summary":"Statistics by variant","x-summary-i18n":{"vie":"Báo cáo xuất nhập kho theo mẫu mã"},"description":"Get inventory statistics grouped by product variant","x-description-i18n":{"vie":"Lấy báo cáo xuất nhập kho theo mẫu mã"},"tags":["Statistics inventory analytics"],"x-tags-i18n":{"vie":["Báo cáo xuất nhập kho"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","example":1},"description":"Page number","x-description-i18n":{"vie":"Số trang hiện tại"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","example":30},"description":"Page size","x-description-i18n":{"vie":"Kích thước trang"}},{"name":"start_date","in":"query","required":true,"schema":{"type":"integer","format":"unix timestamp","example":1760720400},"description":"Start date (unix timestamp)","x-description-i18n":{"vie":"Thời gian bắt đầu (unix timestamp)"}},{"name":"end_date","in":"query","required":true,"schema":{"type":"integer","format":"unix timestamp","example":1763398799},"description":"End date (unix timestamp)","x-description-i18n":{"vie":"Thời gian kết thúc (unix timestamp)"}},{"name":"type","in":"query","required":true,"schema":{"type":"string","enum":["actual","remain"],"x-enum-descriptions":["inventory","Remain quantity"],"x-enum-descriptions-i18n":{"vie":["Tồn kho","Có thể bán"]},"example":"actual"},"description":"Statistics by","x-description-i18n":{"vie":"Báo cáo theo"},"x-enum-descriptions-i18n":{"vie":["Tồn kho","Có thể bán"]}},{"$ref":"#/components/parameters/InventoryAnalyticsWarehouseIds"},{"$ref":"#/components/parameters/InventoryAnalyticsVariationIds"},{"$ref":"#/components/parameters/InventoryAnalyticsIsExcludeVariation"},{"$ref":"#/components/parameters/InventoryAnalyticsProductIds"},{"$ref":"#/components/parameters/InventoryAnalyticsIsExcludeProduct"},{"$ref":"#/components/parameters/InventoryAnalyticsCategoryIds"},{"$ref":"#/components/parameters/InventoryAnalyticsBrandIds"},{"$ref":"#/components/parameters/InventoryAnalyticsProductTags"},{"$ref":"#/components/parameters/InventoryAnalyticsFilterExcludeTag"},{"$ref":"#/components/parameters/InventoryAnalyticsSupplierProductIds"},{"$ref":"#/components/parameters/InventoryAnalyticsIsFilterSupplierByOr"},{"$ref":"#/components/parameters/InventoryAnalyticsManipulationWarehouseIds"},{"$ref":"#/components/parameters/InventoryAnalyticsIsFilterManipulationWarehouseByOr"},{"$ref":"#/components/parameters/InventoryAnalyticsDataSort"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","description":"Statistics by variant","x-description-i18n":{"vie":"Thống kê theo mẫu mã"},"items":{"type":"object","properties":{"id":{"type":"string","description":"Variant ID","x-description-i18n":{"vie":"Mã mẫu mã"}},"begin_inventory":{"type":"number","format":"float","description":"Beginning inventory quantity","x-description-i18n":{"vie":"Tồn đầu kỳ"}},"begin_inventory_value":{"type":"integer","description":"Beginning inventory value","x-description-i18n":{"vie":"Giá trị tồn đầu kỳ"}},"end_inventory":{"type":"number","format":"float","description":"Ending inventory quantity","x-description-i18n":{"vie":"Tồn cuối kỳ"}},"end_inventory_value":{"type":"integer","description":"Ending inventory value","x-description-i18n":{"vie":"Giá trị tồn cuối kỳ"}},"purchase_import":{"type":"number","format":"float","description":"Purchase import quantity","x-description-i18n":{"vie":"Số lượng nhập từ phiếu nhập"}},"return_import":{"type":"number","format":"float","description":"Return import quantity","x-description-i18n":{"vie":"Số lượng nhập từ đơn trả hàng"}},"stocktaking_import":{"type":"number","format":"float","description":"Stocktaking import quantity","x-description-i18n":{"vie":"Số lượng nhập từ kiểm hàng"}},"transfer_import":{"type":"number","format":"float","description":"Transfer import quantity","x-description-i18n":{"vie":"Số lượng nhập từ chuyển kho"}},"total_import":{"type":"number","format":"float","description":"Total import quantity","x-description-i18n":{"vie":"Tổng số lượng nhập"}},"total_import_value":{"type":"integer","description":"Total import value","x-description-i18n":{"vie":"Tổng giá trị nhập"}},"purchase_export":{"type":"number","format":"float","description":"Purchase export quantity","x-description-i18n":{"vie":"Số lượng xuất từ phiếu nhập"}},"transfer_export":{"type":"number","format":"float","description":"Transfer export quantity","x-description-i18n":{"vie":"Số lượng xuất từ chuyển kho"}},"sell_export":{"type":"number","format":"float","description":"Sell export quantity","x-description-i18n":{"vie":"Số lượng xuất từ bán hàng"}},"stocktaking_export":{"type":"number","format":"float","description":"Stocktaking export quantity","x-description-i18n":{"vie":"Số lượng xuất từ kiểm hàng"}},"total_export":{"type":"number","format":"float","description":"Total export quantity","x-description-i18n":{"vie":"Tổng số lượng xuất"}},"total_export_value":{"type":"integer","description":"Total export value","x-description-i18n":{"vie":"Tổng giá trị xuất"}},"variation":{"type":"object","description":"Variant information","x-description-i18n":{"vie":"Thông tin mẫu mã"},"properties":{"id":{"type":"string","description":"Variant ID","x-description-i18n":{"vie":"Mã mẫu mã"}},"product_id":{"type":"string","description":"Product ID","x-description-i18n":{"vie":"Mã sản phẩm"}},"shop_id":{"type":"integer","description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},"custom_id":{"type":"string","description":"Custom ID","x-description-i18n":{"vie":"Mã tùy chỉnh"}},"display_id":{"type":"integer","description":"Display ID","x-description-i18n":{"vie":"Mã hiển thị"}},"barcode":{"type":"string","nullable":true,"description":"Barcode","x-description-i18n":{"vie":"Mã vạch"}},"images":{"type":"array","description":"Variant images","x-description-i18n":{"vie":"Hình ảnh mẫu mã"},"items":{"type":"string"}},"fields":{"type":"array","description":"Variant fields","x-description-i18n":{"vie":"Các trường thuộc tính"},"items":{"type":"object","properties":{"id":{"type":"string","description":"Field ID","x-description-i18n":{"vie":"Mã trường"}},"name":{"type":"string","description":"Field name","x-description-i18n":{"vie":"Tên trường"}},"value":{"type":"string","description":"Field value","x-description-i18n":{"vie":"Giá trị"}},"keyValue":{"type":"string","description":"Key value","x-description-i18n":{"vie":"Giá trị khóa"}}}}},"product":{"type":"object","description":"Product information","x-description-i18n":{"vie":"Thông tin sản phẩm"},"properties":{"id":{"type":"string","description":"Product ID","x-description-i18n":{"vie":"Mã sản phẩm"}},"name":{"type":"string","description":"Product name","x-description-i18n":{"vie":"Tên sản phẩm"}},"custom_id":{"type":"string","description":"Custom ID","x-description-i18n":{"vie":"Mã tùy chỉnh"}},"display_id":{"type":"integer","description":"Display ID","x-description-i18n":{"vie":"Mã hiển thị"}},"category_ids":{"type":"array","description":"Category IDs","x-description-i18n":{"vie":"Danh sách mã danh mục"},"items":{"type":"integer"}},"images":{"type":"array","description":"Product images","x-description-i18n":{"vie":"Hình ảnh sản phẩm"},"items":{"type":"string"}},"inserted_at":{"type":"string","format":"date-time","description":"Created at","x-description-i18n":{"vie":"Thời điểm tạo"}}}}}}}}},"page_number":{"type":"integer","description":"Current page number","x-description-i18n":{"vie":"Số trang hiện tại"}},"page_size":{"type":"integer","description":"Page size","x-description-i18n":{"vie":"Kích thước trang"}},"total_entries":{"type":"integer","description":"Total number of entries","x-description-i18n":{"vie":"Tổng số bản ghi"}},"total_pages":{"type":"integer","description":"Total number of pages","x-description-i18n":{"vie":"Tổng số trang"}},"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}}}},"examples":{"default":{"value":{"success":true,"data":[{"id":"d9005a9f-257b-4ce7-af6e-bad339598ea6","begin_inventory":1099,"begin_inventory_value":109900000,"end_inventory":1128,"end_inventory_value":112800000,"purchase_import":30,"return_import":0,"stocktaking_import":2,"transfer_import":5,"total_import":37,"total_import_value":3700000,"purchase_export":0,"transfer_export":-5,"sell_export":0,"stocktaking_export":0,"total_export":-8,"total_export_value":800000,"variation":{"id":"d9005a9f-257b-4ce7-af6e-bad339598ea6","product_id":"dee8f2c3-2ecc-4d9b-a9ff-603b5bde7e3d","shop_id":20,"custom_id":"TESTMATDOS","display_id":15,"barcode":null,"images":["https://content.pancake.vn/user-content-dev2.pancake.vn/2025/9/30/d05f44dcf2b9f96312d88b718da35aa5317242d6.jpg"],"fields":[{"id":"2b61c249-35dc-4b79-a3aa-a173c63a8061","keyValue":"BLUE","name":"Color","value":"blue"},{"id":"b053dfb9-b7b6-4d8a-9fb4-197d7b0d7556","keyValue":"L","name":"Size","value":"L"}],"product":{"category_ids":[567],"custom_id":"ANTT","display_id":13038,"images":[],"inserted_at":"2024-11-18T03:18:03","name":"Áo nam Pari đẹp thời trang"}}}],"page_number":1,"page_size":30,"total_entries":4,"total_pages":1}}}}}}}}},"/shops/{SHOP_ID}/inventory_analytics/inventory_by_product":{"get":{"summary":"Statistics by product","x-summary-i18n":{"vie":"Báo cáo xuất nhập kho theo sản phẩm"},"description":"Get inventory statistics grouped by product","x-description-i18n":{"vie":"Lấy báo cáo xuất nhập kho theo sản phẩm"},"tags":["Statistics inventory analytics"],"x-tags-i18n":{"vie":["Báo cáo xuất nhập kho"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","example":1},"description":"Page number","x-description-i18n":{"vie":"Số trang hiện tại"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","example":30},"description":"Page size","x-description-i18n":{"vie":"Kích thước trang"}},{"name":"start_date","in":"query","required":true,"schema":{"type":"integer","format":"unix timestamp","example":1760720400},"description":"Start date (unix timestamp)","x-description-i18n":{"vie":"Thời gian bắt đầu (unix timestamp)"}},{"name":"end_date","in":"query","required":true,"schema":{"type":"integer","format":"unix timestamp","example":1763398799},"description":"End date (unix timestamp)","x-description-i18n":{"vie":"Thời gian kết thúc (unix timestamp)"}},{"name":"type","in":"query","required":true,"schema":{"type":"string","enum":["actual","remain"],"x-enum-descriptions":["inventory","Remain quantity"],"x-enum-descriptions-i18n":{"vie":["Tồn kho","Có thể bán"]},"example":"actual"},"description":"Statistics by","x-description-i18n":{"vie":"Báo cáo theo"},"x-enum-descriptions-i18n":{"vie":["Tồn kho","Có thể bán"]}},{"$ref":"#/components/parameters/InventoryAnalyticsWarehouseIds"},{"$ref":"#/components/parameters/InventoryAnalyticsVariationIds"},{"$ref":"#/components/parameters/InventoryAnalyticsIsExcludeVariation"},{"$ref":"#/components/parameters/InventoryAnalyticsProductIds"},{"$ref":"#/components/parameters/InventoryAnalyticsIsExcludeProduct"},{"$ref":"#/components/parameters/InventoryAnalyticsCategoryIds"},{"$ref":"#/components/parameters/InventoryAnalyticsBrandIds"},{"$ref":"#/components/parameters/InventoryAnalyticsProductTags"},{"$ref":"#/components/parameters/InventoryAnalyticsFilterExcludeTag"},{"$ref":"#/components/parameters/InventoryAnalyticsSupplierProductIds"},{"$ref":"#/components/parameters/InventoryAnalyticsIsFilterSupplierByOr"},{"$ref":"#/components/parameters/InventoryAnalyticsManipulationWarehouseIds"},{"$ref":"#/components/parameters/InventoryAnalyticsIsFilterManipulationWarehouseByOr"},{"$ref":"#/components/parameters/InventoryAnalyticsDataSort"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","description":"Statistics by product","x-description-i18n":{"vie":"Thống kê theo sản phẩm"},"items":{"type":"object","properties":{"id":{"type":"string","description":"Product ID","x-description-i18n":{"vie":"Mã sản phẩm"}},"product_id":{"type":"string","description":"Product ID","x-description-i18n":{"vie":"Mã sản phẩm"}},"begin_inventory":{"type":"number","format":"float","description":"Beginning inventory quantity","x-description-i18n":{"vie":"Tồn đầu kỳ"}},"begin_inventory_value":{"type":"integer","description":"Beginning inventory value","x-description-i18n":{"vie":"Giá trị tồn đầu kỳ"}},"end_inventory":{"type":"number","format":"float","description":"Ending inventory quantity","x-description-i18n":{"vie":"Tồn cuối kỳ"}},"end_inventory_value":{"type":"integer","description":"Ending inventory value","x-description-i18n":{"vie":"Giá trị tồn cuối kỳ"}},"purchase_import":{"type":"number","format":"float","description":"Purchase import quantity","x-description-i18n":{"vie":"Số lượng nhập từ phiếu nhập"}},"return_import":{"type":"number","format":"float","description":"Return import quantity","x-description-i18n":{"vie":"Số lượng nhập từ đơn trả hàng"}},"stocktaking_import":{"type":"number","format":"float","description":"Stocktaking import quantity","x-description-i18n":{"vie":"Số lượng nhập từ kiểm hàng"}},"transfer_import":{"type":"number","format":"float","description":"Transfer import quantity","x-description-i18n":{"vie":"Số lượng nhập từ chuyển kho"}},"total_import":{"type":"number","format":"float","description":"Total import quantity","x-description-i18n":{"vie":"Tổng số lượng nhập"}},"total_import_value":{"type":"integer","description":"Total import value","x-description-i18n":{"vie":"Tổng giá trị nhập"}},"purchase_export":{"type":"number","format":"float","description":"Purchase export quantity","x-description-i18n":{"vie":"Số lượng xuất từ phiếu nhập"}},"transfer_export":{"type":"number","format":"float","description":"Transfer export quantity","x-description-i18n":{"vie":"Số lượng xuất từ chuyển kho"}},"sell_export":{"type":"number","format":"float","description":"Sell export quantity","x-description-i18n":{"vie":"Số lượng xuất từ bán hàng"}},"stocktaking_export":{"type":"number","format":"float","description":"Stocktaking export quantity","x-description-i18n":{"vie":"Số lượng xuất từ kiểm hàng"}},"total_export":{"type":"number","format":"float","description":"Total export quantity","x-description-i18n":{"vie":"Tổng số lượng xuất"}},"total_export_value":{"type":"integer","description":"Total export value","x-description-i18n":{"vie":"Tổng giá trị xuất"}},"product":{"type":"object","description":"Product information","x-description-i18n":{"vie":"Thông tin sản phẩm"},"properties":{"id":{"type":"string","description":"Product ID","x-description-i18n":{"vie":"Mã sản phẩm"}},"name":{"type":"string","description":"Product name","x-description-i18n":{"vie":"Tên sản phẩm"}},"custom_id":{"type":"string","description":"Custom ID","x-description-i18n":{"vie":"Mã tùy chỉnh"}},"display_id":{"type":"integer","description":"Display ID","x-description-i18n":{"vie":"Mã hiển thị"}},"category_ids":{"type":"array","description":"Category IDs","x-description-i18n":{"vie":"Danh sách mã danh mục"},"items":{"type":"integer"}},"images":{"type":"array","description":"Product images","x-description-i18n":{"vie":"Hình ảnh sản phẩm"},"items":{"type":"string"}},"inserted_at":{"type":"string","format":"date-time","description":"Created at","x-description-i18n":{"vie":"Thời điểm tạo"}}}}}}},"page_number":{"type":"integer","description":"Current page number","x-description-i18n":{"vie":"Số trang hiện tại"}},"page_size":{"type":"integer","description":"Page size","x-description-i18n":{"vie":"Kích thước trang"}},"total_entries":{"type":"integer","description":"Total number of entries","x-description-i18n":{"vie":"Tổng số bản ghi"}},"total_pages":{"type":"integer","description":"Total number of pages","x-description-i18n":{"vie":"Tổng số trang"}},"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}}}},"examples":{"default":{"value":{"success":true,"page_number":1,"page_size":30,"total_entries":1,"total_pages":1,"data":[{"id":"dee8f2c3-2ecc-4d9b-a9ff-603b5bde7e3d","product_id":"dee8f2c3-2ecc-4d9b-a9ff-603b5bde7e3d","begin_inventory":2597,"begin_inventory_value":259700000,"end_inventory":2870,"end_inventory_value":287000000,"purchase_import":130,"return_import":5,"stocktaking_import":2,"transfer_import":5,"total_import":296,"total_import_value":29600000,"purchase_export":0,"transfer_export":-5,"sell_export":-15,"stocktaking_export":0,"total_export":-23,"total_export_value":2300000,"product":{"category_ids":[567],"custom_id":"ANTT","display_id":13038,"images":[],"inserted_at":"2024-11-18T03:18:03","name":"Áo nam Pari đẹp thời trang"}}]}}}}}}}}},"/shops/{SHOP_ID}/customer_analytics/report":{"get":{"summary":"Customer overview report","x-summary-i18n":{"vie":"Báo cáo tổng quan khách hàng"},"description":"Get all figures of the Customer overview report (Statistics -> Customer screen) in a single call:\nnew/old customer counts and spending, gender, age groups, customer levels,\ndistribution by successful order count, purchase cycle and the paginated customer list.\n\nTo paginate / sort / search the customer list only (without recomputing the summary blocks),\ncall the same endpoint with `section=customer_orders` — the response then contains only `customer_orders`.\n","x-description-i18n":{"vie":"Lấy toàn bộ số liệu bảng Tổng quan khách hàng (màn Thống kê -> Khách hàng) trong một lần gọi:\nsố lượng & chi tiêu KH cũ/mới, giới tính, độ tuổi, cấp độ khách hàng,\nphân bố theo số đơn thành công, chu kỳ mua hàng và danh sách khách hàng (phân trang).\n\nNếu chỉ cần phân trang / sắp xếp / tìm kiếm danh sách khách hàng (không tính lại các khối tổng quan),\ngọi cùng endpoint với `section=customer_orders` — response khi đó chỉ chứa `customer_orders`.\n"},"tags":["Statistics customer analytics"],"x-tags-i18n":{"vie":["Báo cáo khách hàng"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},{"name":"startDate","in":"query","required":false,"schema":{"type":"integer","example":1784394000},"description":"Start of the reporting period (unix timestamp, seconds). Customers created from this time are counted as new customers.","x-description-i18n":{"vie":"Thời gian bắt đầu thống kê (unix timestamp, giây). Khách tạo từ thời điểm này được tính là khách mới."}},{"name":"endDate","in":"query","required":false,"schema":{"type":"integer","example":1787072399},"description":"End of the reporting period (unix timestamp, seconds)","x-description-i18n":{"vie":"Thời gian kết thúc thống kê (unix timestamp, giây)"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","example":1},"description":"Page number of the customer list (default 1)","x-description-i18n":{"vie":"Trang của danh sách khách hàng (mặc định 1)"}},{"name":"pageSize","in":"query","required":false,"schema":{"type":"integer","example":30},"description":"Number of customers per page (default 10)","x-description-i18n":{"vie":"Số khách hàng mỗi trang (mặc định 10)"}},{"name":"data_sort","in":"query","required":false,"schema":{"type":"string","example":"{\"asc_desc\":\"desc\",\"sort_by\":\"order_success_amount\"}"},"description":"Sort the customer list. JSON-encoded object:\n- `sort_by`: `order_count` | `order_success` | `order_return` | `order_success_amount` (default)\n- `asc_desc`: `asc` | `desc` (default)\n","x-description-i18n":{"vie":"Sắp xếp danh sách khách hàng. Object mã hoá JSON:\n- `sort_by`: `order_count` (số đơn) | `order_success` (số đơn thành công) | `order_return` (số đơn hoàn) | `order_success_amount` (số tiền đã chi — mặc định)\n- `asc_desc`: `asc` | `desc` (mặc định)\n"}},{"name":"search","in":"query","required":false,"schema":{"type":"string","example":"0999999999"},"description":"Search the customer list by customer name or phone number","x-description-i18n":{"vie":"Tìm kiếm danh sách khách hàng theo tên hoặc số điện thoại"}},{"name":"section","in":"query","required":false,"schema":{"type":"string","enum":["customer_orders"],"example":"customer_orders"},"description":"Set to `customer_orders` to return only the paginated customer list","x-description-i18n":{"vie":"Truyền `customer_orders` để chỉ trả về danh sách khách hàng (phân trang)"}},{"name":"sale_form","in":"query","required":false,"schema":{"type":"string","enum":["all","retail","wholesale"],"example":"all"},"description":"Filter by sale form (retail / wholesale customers, based on shop wholesale tag settings)","x-description-i18n":{"vie":"Lọc theo hình thức bán (khách lẻ / khách buôn, dựa trên cấu hình tag khách buôn của shop)"}},{"name":"warehouse_id[]","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"},"example":["fef177ba-1a5f-4c07-b1f4-e327ba71a596"]},"description":"Filter orders by warehouse","x-description-i18n":{"vie":"Lọc đơn theo kho hàng"}},{"name":"order_sources[]","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"},"example":["{\"order_sources\":\"-1\"}"]},"description":"Filter by order source. Each item is a JSON-encoded object `{\"order_sources\": \"<source>\", \"account\": \"<account_id>\"}`.\nSource values are the same as on web (see the `/shops/{SHOP_ID}/order_source` endpoint).\n","x-description-i18n":{"vie":"Lọc theo nguồn đơn. Mỗi phần tử là object mã hoá JSON `{\"order_sources\": \"<nguồn>\", \"account\": \"<mã tài khoản>\"}`.\nGiá trị nguồn giống trên web (xem endpoint `/shops/{SHOP_ID}/order_source`).\n"}},{"name":"is_filter_exclude_source","in":"query","required":false,"schema":{"type":"string","enum":["true","false"],"example":"false"},"description":"Exclude (instead of include) the sources in `order_sources[]`","x-description-i18n":{"vie":"Loại trừ (thay vì lọc theo) các nguồn trong `order_sources[]`"}},{"name":"order_tag[]","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"},"example":["1"]},"description":"Filter orders by order tag IDs. Special value `no_tag` filters orders without tags.","x-description-i18n":{"vie":"Lọc đơn theo mã tag đơn hàng. Giá trị đặc biệt `no_tag` lọc đơn không có tag."}},{"name":"is_filter_tag_by_or","in":"query","required":false,"schema":{"type":"string","enum":["true","false"],"example":"true"},"description":"`true` (default): order matches ANY tag in `order_tag[]`; `false`: order must contain ALL tags","x-description-i18n":{"vie":"`true` (mặc định): đơn chứa MỘT trong các tag ở `order_tag[]`; `false`: đơn phải chứa TẤT CẢ các tag"}},{"name":"is_filter_exclude","in":"query","required":false,"schema":{"type":"string","enum":["true","false"],"example":"false"},"description":"Exclude (instead of include) the tags in `order_tag[]`","x-description-i18n":{"vie":"Loại trừ (thay vì lọc theo) các tag trong `order_tag[]`"}},{"name":"selectedLevel[]","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"},"example":["2d058084-4219-4ef3-bf4c-e7b77889224c"]},"description":"Filter by customer level IDs (see the `/shops/{SHOP_ID}/customer_levels` endpoint)","x-description-i18n":{"vie":"Lọc theo mã cấp độ khách hàng (xem endpoint `/shops/{SHOP_ID}/customer_levels`)"}},{"name":"gender[]","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","enum":["male","female","none"]},"example":["male"]},"description":"Filter by customer gender (`none` = no gender information)","x-description-i18n":{"vie":"Lọc theo giới tính khách hàng (`none` = chưa có thông tin)"}},{"name":"typeCustomer[]","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","enum":["online","offline"]},"example":["online"]},"description":"Filter by customer type: `online` (has a linked social account) / `offline`","x-description-i18n":{"vie":"Lọc theo loại khách: `online` (có liên kết tài khoản MXH) / `offline`"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}},"data":{"type":"object","properties":{"customer":{"type":"object","description":"Customer counts. Old customers were created before `startDate`, new customers within the period. `old_customer` is null when `startDate` is not provided.","x-description-i18n":{"vie":"Số lượng khách hàng. KH cũ tạo trước `startDate`, khách mới tạo trong khoảng thống kê. `old_customer` là null nếu không truyền `startDate`."},"properties":{"new_customer":{"type":"integer","description":"Number of new customers","x-description-i18n":{"vie":"Số lượng khách mới"}},"old_customer":{"type":"integer","nullable":true,"description":"Number of old customers","x-description-i18n":{"vie":"Số lượng khách cũ"}}}},"customer_purchased":{"type":"object","description":"Spending of new vs old customers (numeric string)","x-description-i18n":{"vie":"Chi tiêu của khách mới / khách cũ (chuỗi số)"},"properties":{"new_customer":{"type":"string","nullable":true,"description":"Spending of new customers","x-description-i18n":{"vie":"Chi tiêu của khách mới"}},"old_customer":{"type":"string","nullable":true,"description":"Spending of old customers","x-description-i18n":{"vie":"Chi tiêu của khách cũ"}}}},"customer_gender":{"type":"object","description":"Customer counts by gender","x-description-i18n":{"vie":"Số lượng khách hàng theo giới tính"},"properties":{"male":{"type":"integer","description":"Male customers","x-description-i18n":{"vie":"Khách nam"}},"female":{"type":"integer","description":"Female customers","x-description-i18n":{"vie":"Khách nữ"}},"unknown":{"type":"integer","description":"Customers without gender information","x-description-i18n":{"vie":"Khách chưa có thông tin giới tính"}}}},"customer_age":{"type":"object","description":"Customer counts and revenue by age group (based on date of birth)","x-description-i18n":{"vie":"Số lượng khách và doanh thu theo nhóm tuổi (dựa trên ngày sinh)"},"properties":{"under_18":{"type":"integer","description":"Customers under 18","x-description-i18n":{"vie":"Khách dưới 18 tuổi"}},"revenue_under_18":{"type":"number","nullable":true,"description":"Revenue from customers under 18","x-description-i18n":{"vie":"Doanh thu từ khách dưới 18 tuổi"}},"from_18_to_24":{"type":"integer","description":"Customers aged 18-24","x-description-i18n":{"vie":"Khách từ 18 đến 24 tuổi"}},"revenue_from_18_to_24":{"type":"number","nullable":true,"description":"Revenue from customers aged 18-24","x-description-i18n":{"vie":"Doanh thu từ khách 18-24 tuổi"}},"from_25_to_34":{"type":"integer","description":"Customers aged 25-34","x-description-i18n":{"vie":"Khách từ 25 đến 34 tuổi"}},"revenue_from_25_to_34":{"type":"number","nullable":true,"description":"Revenue from customers aged 25-34","x-description-i18n":{"vie":"Doanh thu từ khách 25-34 tuổi"}},"from_35_to_44":{"type":"integer","description":"Customers aged 35-44","x-description-i18n":{"vie":"Khách từ 35 đến 44 tuổi"}},"revenue_from_35_to_44":{"type":"number","nullable":true,"description":"Revenue from customers aged 35-44","x-description-i18n":{"vie":"Doanh thu từ khách 35-44 tuổi"}},"from_45_to_54":{"type":"integer","description":"Customers aged 45-54","x-description-i18n":{"vie":"Khách từ 45 đến 54 tuổi"}},"revenue_from_45_to_54":{"type":"number","nullable":true,"description":"Revenue from customers aged 45-54","x-description-i18n":{"vie":"Doanh thu từ khách 45-54 tuổi"}},"over_55":{"type":"integer","description":"Customers over 55","x-description-i18n":{"vie":"Khách trên 55 tuổi"}},"revenue_over_55":{"type":"number","nullable":true,"description":"Revenue from customers over 55","x-description-i18n":{"vie":"Doanh thu từ khách trên 55 tuổi"}},"havent_birthday":{"type":"integer","description":"Customers without date of birth","x-description-i18n":{"vie":"Khách không có ngày sinh"}},"revenue_total":{"type":"number","nullable":true,"description":"Total revenue of all age groups","x-description-i18n":{"vie":"Tổng doanh thu của tất cả nhóm tuổi"}}}},"customer_level":{"type":"array","description":"Customer statistics by level. Customers having the shop's level-exclusion tags are not counted.","x-description-i18n":{"vie":"Thống kê khách hàng theo cấp độ. Khách có tag loại trừ cấp độ (theo cấu hình shop) không được tính."},"items":{"type":"object","properties":{"id":{"type":"string","nullable":true,"description":"Customer level ID (see `/shops/{SHOP_ID}/customer_levels`), null = no level","x-description-i18n":{"vie":"Mã cấp độ khách hàng (xem `/shops/{SHOP_ID}/customer_levels`), null = chưa có cấp độ"}},"count":{"type":"integer","description":"Number of customers in this level","x-description-i18n":{"vie":"Số lượng khách ở cấp độ này"}},"total_amount":{"type":"string","nullable":true,"description":"Spending of customers in this level (numeric string)","x-description-i18n":{"vie":"Chi tiêu của khách ở cấp độ này (chuỗi số)"}}}}},"customer_order_count":{"type":"array","description":"Distribution of customers by number of successful orders","x-description-i18n":{"vie":"Phân bố khách hàng theo số đơn thành công"},"items":{"type":"object","properties":{"order_success_quantity":{"type":"integer","description":"Number of successful orders","x-description-i18n":{"vie":"Số đơn thành công"}},"customer_count":{"type":"integer","description":"Number of customers with that many successful orders","x-description-i18n":{"vie":"Số khách có số đơn thành công tương ứng"}},"amount":{"type":"string","nullable":true,"description":"Total successful-order amount of those customers (numeric string)","x-description-i18n":{"vie":"Tổng tiền đơn thành công của nhóm khách đó (chuỗi số)"}}}}},"new_customer":{"type":"object","description":"New customer details","x-description-i18n":{"vie":"Chi tiết khách mới"},"properties":{"old_customer":{"type":"integer","nullable":true,"description":"Number of old customers","x-description-i18n":{"vie":"Số lượng khách cũ"}},"analytic_new_customer":{"type":"object","properties":{"count":{"type":"integer","description":"Number of new customers","x-description-i18n":{"vie":"Số lượng khách mới"}},"count_1":{"type":"integer","description":"New customers with exactly 1 order","x-description-i18n":{"vie":"Khách mới có đúng 1 đơn"}},"count_2":{"type":"integer","description":"New customers with more than 1 order","x-description-i18n":{"vie":"Khách mới có hơn 1 đơn"}},"count_tags":{"type":"integer","description":"New customers having tags","x-description-i18n":{"vie":"Khách mới có gắn tag"}}}}}},"customer_analytic":{"type":"array","description":"Purchase-cycle statistics. One row per cycle range:\n`range` = 0: single-purchase customers; 1 / 31 / 61: repeat customers with an average buying cycle of 1-30 / 31-60 / 61-90 days; 91: cycle over 90 days.\nWithin each row, customers are counted by days elapsed since their last order (compared to `endDate`).\n","x-description-i18n":{"vie":"Thống kê chu kỳ mua hàng. Mỗi phần tử ứng với một khoảng chu kỳ:\n`range` = 0: khách mua 1 lần; 1 / 31 / 61: khách mua lặp lại với chu kỳ trung bình 1-30 / 31-60 / 61-90 ngày; 91: chu kỳ trên 90 ngày.\nTrong mỗi phần tử, khách được đếm theo số ngày kể từ đơn gần nhất (so với `endDate`).\n"},"items":{"type":"object","properties":{"range":{"type":"integer","description":"Cycle range key (0, 1, 31, 61, 91)","x-description-i18n":{"vie":"Khoá khoảng chu kỳ (0, 1, 31, 61, 91)"}},"from_1_to_30":{"type":"integer","description":"Customers whose last order was 1-30 days ago","x-description-i18n":{"vie":"Khách có đơn gần nhất cách 1-30 ngày"}},"from_31_to_60":{"type":"integer","description":"Customers whose last order was 31-60 days ago","x-description-i18n":{"vie":"Khách có đơn gần nhất cách 31-60 ngày"}},"from_61_to_90":{"type":"integer","description":"Customers whose last order was 61-90 days ago","x-description-i18n":{"vie":"Khách có đơn gần nhất cách 61-90 ngày"}},"under_90":{"type":"integer","description":"Customers whose last order was more than 90 days ago","x-description-i18n":{"vie":"Khách có đơn gần nhất cách trên 90 ngày"}},"total":{"type":"integer","description":"Total customers in this cycle range","x-description-i18n":{"vie":"Tổng số khách trong khoảng chu kỳ này"}}}}},"customer_orders":{"type":"object","description":"Paginated customer list","x-description-i18n":{"vie":"Danh sách khách hàng (phân trang)"},"properties":{"page_number":{"type":"integer","description":"Current page","x-description-i18n":{"vie":"Trang hiện tại"}},"page_size":{"type":"integer","description":"Number of customers per page","x-description-i18n":{"vie":"Số khách mỗi trang"}},"total_entries":{"type":"integer","description":"Total number of customers","x-description-i18n":{"vie":"Tổng số khách hàng"}},"total_pages":{"type":"integer","nullable":true,"description":"Total number of pages","x-description-i18n":{"vie":"Tổng số trang"}},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Shop customer ID","x-description-i18n":{"vie":"Mã khách hàng trong shop"}},"name":{"type":"string","description":"Customer name","x-description-i18n":{"vie":"Tên khách hàng"}},"phone_number":{"type":"array","items":{"type":"string"},"description":"Customer phone numbers","x-description-i18n":{"vie":"Số điện thoại của khách"}},"currency":{"type":"string","nullable":true,"description":"Customer currency","x-description-i18n":{"vie":"Tiền tệ của khách"}},"order_count":{"type":"integer","description":"Number of orders","x-description-i18n":{"vie":"Số đơn hàng"}},"order_success_count":{"type":"integer","description":"Number of successful orders","x-description-i18n":{"vie":"Số đơn thành công"}},"order_return_count":{"type":"integer","description":"Number of returned orders","x-description-i18n":{"vie":"Số đơn hoàn"}},"order_success_amount":{"type":"number","description":"Amount spent on successful orders","x-description-i18n":{"vie":"Số tiền đã chi (đơn thành công)"}},"customer":{"type":"object","nullable":true,"description":"Linked global customer information","x-description-i18n":{"vie":"Thông tin khách hàng liên kết"},"properties":{"id":{"type":"string","description":"Customer ID","x-description-i18n":{"vie":"Mã khách hàng"}},"name":{"type":"string","description":"Customer name","x-description-i18n":{"vie":"Tên khách hàng"}},"fb_id":{"type":"string","nullable":true,"description":"Facebook ID","x-description-i18n":{"vie":"Mã Facebook"}},"psid":{"type":"string","nullable":true,"description":"Page-scoped ID","x-description-i18n":{"vie":"Mã PSID"}},"global_id":{"type":"string","nullable":true,"description":"Global customer ID","x-description-i18n":{"vie":"Mã khách hàng toàn cục"}}}}}}}}}}}}},"examples":{"default":{"value":{"success":true,"data":{"customer":{"new_customer":2,"old_customer":6},"customer_purchased":{"new_customer":"1006000","old_customer":"5870098"},"customer_gender":{"male":0,"female":0,"unknown":8},"customer_age":{"under_18":0,"revenue_under_18":null,"from_18_to_24":0,"revenue_from_18_to_24":null,"from_25_to_34":0,"revenue_from_25_to_34":null,"from_35_to_44":0,"revenue_from_35_to_44":null,"from_45_to_54":0,"revenue_from_45_to_54":null,"over_55":0,"revenue_over_55":null,"havent_birthday":8,"revenue_total":6824089},"customer_level":[{"id":"2d058084-4219-4ef3-bf4c-e7b77889224c","count":2,"total_amount":"4070000"},{"id":"6c7f0d31-4f5a-43b1-a0d6-b30081e48f5a","count":1,"total_amount":"1050000"},{"id":null,"count":5,"total_amount":"1756098"}],"customer_order_count":[{"order_success_quantity":0,"customer_count":8,"amount":"0"}],"new_customer":{"old_customer":6,"analytic_new_customer":{"count":2,"count_1":2,"count_2":0,"count_tags":0}},"customer_analytic":[{"range":0,"from_1_to_30":0,"from_31_to_60":7,"from_61_to_90":0,"under_90":121,"total":128},{"range":1,"from_1_to_30":0,"from_31_to_60":2,"from_61_to_90":0,"under_90":7,"total":9},{"range":31,"from_1_to_30":0,"from_31_to_60":2,"from_61_to_90":0,"under_90":3,"total":5},{"range":61,"from_1_to_30":0,"from_31_to_60":0,"from_61_to_90":0,"under_90":1,"total":1},{"range":91,"from_1_to_30":0,"from_31_to_60":0,"from_61_to_90":0,"under_90":3,"total":3}],"customer_orders":{"success":true,"page_number":1,"page_size":30,"total_entries":8,"total_pages":null,"data":[{"id":"330fdf15-7301-4d9c-86e6-f6ea21ed37bf","name":"khách colombia","currency":null,"phone_number":["0982342873"],"customer":{"id":"af55aee2-3846-43d7-8f46-13d768462731","name":"khách colombia","global_id":null,"fb_id":null,"psid":null},"order_count":1,"order_return_count":0,"order_success_amount":0,"order_success_count":0},{"id":"941e822e-fc98-4852-bdea-3a8f806cf362","name":"Hoang Anhbcde","currency":"VND","phone_number":["0999999999"],"customer":{"id":"db647f48-b20d-4fcf-95b4-eb277a2087b9","name":"Hoang Anh","global_id":null,"fb_id":null,"psid":null},"order_count":7,"order_return_count":0,"order_success_amount":0,"order_success_count":0}]}}}}}}}}}}},"/shops/{SHOP_ID}/users":{"get":{"summary":"Employee list","x-summary-i18n":{"vie":"Danh sách nhân viên"},"description":"Get list of employees","x-description-i18n":{"vie":"Lấy danh sách nhân viên"},"tags":["Employee"],"x-tags-i18n":{"vie":["Nhân viên"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","description":"List of employees","x-description-i18n":{"vie":"Danh sách nhân viên"},"items":{"type":"object","properties":{"department":{"type":"object","description":"Department information","x-description-i18n":{"vie":"Thông tin phòng ban"},"properties":{"id":{"type":"integer","description":"Department ID","x-description-i18n":{"vie":"Mã phòng ban"}},"name":{"type":"string","description":"Department name","x-description-i18n":{"vie":"Tên phòng ban"}}}},"shop_id":{"type":"integer","description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},"user_id":{"type":"string","description":"User ID","x-description-i18n":{"vie":"Mã người dùng"}},"user":{"type":"object","description":"User information","x-description-i18n":{"vie":"Thông tin người dùng"},"properties":{"email":{"type":"string","description":"User email","x-description-i18n":{"vie":"Email người dùng"}},"fb_id":{"type":"string","description":"Facebook ID","x-description-i18n":{"vie":"Facebook ID"}},"id":{"type":"string","description":"User ID","x-description-i18n":{"vie":"Mã người dùng"}},"name":{"type":"string","description":"User name","x-description-i18n":{"vie":"Tên người dùng"}},"phone_number":{"type":"string","description":"Phone number","x-description-i18n":{"vie":"Số điện thoại"}}}},"sale_group":{"type":"object","description":"Sale group information","x-description-i18n":{"vie":"Thông tin nhóm bán hàng"},"properties":{"id":{"type":"integer","description":"Sale group ID","x-description-i18n":{"vie":"Mã nhóm bán hàng"}},"name":{"type":"string","description":"Sale group name","x-description-i18n":{"vie":"Tên nhóm bán hàng"}}}}}}},"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}}}},"examples":{"default":{"value":{"success":true,"data":[{"department":{"id":933,"name":"Sales"},"shop_id":7,"user_id":"8fbe2a6f-b0b2-4227-a698-19d18c43f7c8","user":{"email":"2042723249341651@facebook.com","fb_id":"2042723249341651","id":"8fbe2a6f-b0b2-4227-a698-19d18c43f7c8","name":"Hoang Anh","phone_number":null},"sale_group":{"id":30,"name":"Ca sáng"}}]}}}}}}}}},"/shops/{SHOP_ID}":{"put":{"summary":"Webhook configuration","x-summary-i18n":{"vie":"Cấu hình Webhook"},"description":"Configure webhook settings. Go to **Setting -> Advance -> Third-party connection -> Webhook/API** to configure:\n- Webhook URL (Required)\n- Email error message\n- Request Headers\n- Webhook types: `orders`, `customers`, `products`, `variations_warehouses`, or `auto_call`\n\n## Webhook Response Types\n\nWhen webhook is enabled, the system sends POST requests to the configured URL. Response schema:\n\n- **`orders`**: See [WebhookOrderResponse](#model/WebhookOrderResponse) schema\n- **`customers`**: See [WebhookCustomerResponse](#model/WebhookCustomerResponse) schema\n- **`products`**: See [WebhookProductResponse](#model/WebhookProductResponse) schema\n- **`variations_warehouses`**: See [WebhookInventoryResponse](#model/WebhookInventoryResponse) schema\n- **`auto_call`**: See [WebhookAutoCallResponse](#model/WebhookAutoCallResponse) schema\n","x-description-i18n":{"vie":"Cấu hình thiết lập webhook. Vào **Cấu hình -> Nâng cao -> Kết nối bên thứ 3 -> Webhook/API** để cấu hình:\n- Webhook URL (Bắt buộc)\n- Email thông báo lỗi\n- Request Headers\n- Loại webhook: `orders`, `customers`, `products`, `variations_warehouses`, hoặc `auto_call`\n\n## Các Loại Phản Hồi Webhook\n\nKhi webhook được bật, hệ thống gửi yêu cầu POST đến URL đã cấu hình. Schema phản hồi:\n\n- **`orders`**: Xem schema [WebhookOrderResponse](#model/WebhookOrderResponse)\n- **`customers`**: Xem schema [WebhookCustomerResponse](#model/WebhookCustomerResponse)\n- **`products`**: Xem schema [WebhookProductResponse](#model/WebhookProductResponse)\n- **`variations_warehouses`**: Xem schema [WebhookInventoryResponse](#model/WebhookInventoryResponse)\n- **`auto_call`**: Xem schema [WebhookAutoCallResponse](#model/WebhookAutoCallResponse)\n"},"tags":["Webhook"],"x-tags-i18n":{"vie":["Webhook"]},"parameters":[{"name":"SHOP_ID","in":"path","required":true,"schema":{"type":"integer","example":4},"description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["shop"],"properties":{"shop":{"type":"object","properties":{"webhook_enable":{"type":"boolean","description":"Enable/Disable Webhook","x-description-i18n":{"vie":"Bật/Tắt Webhook"}},"webhook_url":{"type":"string","format":"uri","description":"Link URL","x-description-i18n":{"vie":"Link URL"}},"webhook_email":{"type":"string","format":"email","description":"Error message email","x-description-i18n":{"vie":"Email thông báo lỗi"}},"webhook_types":{"type":"array","description":"Webhook data","x-description-i18n":{"vie":"Dữ liệu Webhook"},"items":{"type":"string"}},"webhook_partner":{"type":"string","description":"Partner","x-description-i18n":{"vie":"Đối tác"}},"webhook_headers":{"type":"object","description":"Webhook headers","x-description-i18n":{"vie":"Header Webhook"},"additionalProperties":{"type":"string"}}}}},"example":{"shop":{"webhook_enable":true,"webhook_url":"https://test.com","webhook_email":"1234@gmail.com","webhook_types":["orders","customers","variations_warehouses"],"webhook_partner":"","webhook_headers":{"X-API-KEY":"elqsF9ERiFWGacWQO9Gg5XC4kXojot"}}}}}},"description":"Request body containing information to update","x-description-i18n":{"vie":"Thông tin yêu cầu chứa thông tin cần cập nhật"}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"shop":{"type":"object","description":"Shop information","x-description-i18n":{"vie":"Thông tin cửa hàng"},"properties":{"webhook_enable":{"type":"boolean","description":"Enable/Disable Webhook","x-description-i18n":{"vie":"Bật/Tắt Webhook"}},"webhook_url":{"type":"string","format":"uri","description":"Link URL","x-description-i18n":{"vie":"Link URL"}},"webhook_email":{"type":"string","format":"email","description":"Error message email","x-description-i18n":{"vie":"Email thông báo lỗi"}},"webhook_types":{"type":"array","description":"Webhook data","x-description-i18n":{"vie":"Dữ liệu Webhook"},"items":{"type":"string"}},"webhook_partner":{"type":"string","description":"Partner","x-description-i18n":{"vie":"Đối tác"}},"webhook_headers":{"type":"object","description":"Webhook headers","x-description-i18n":{"vie":"Header Webhook"}},"additionalProperties":{"type":"string"}}},"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}}}},"examples":{"default":{"$ref":"#/components/examples/SuccessResponse"}}}}}}}}},"components":{"examples":{"OrderBasic":{"value":{"id":1418,"system_id":1,"shop_id":4,"inserted_at":"2020-05-12T04:51:42","updated_at":"2020-05-12T04:51:54","status":0,"status_name":"new","bill_full_name":"Hoang Anh","bill_phone_number":"0999999999","bill_email":"customer@example.com","page_id":"256469571178082","post_id":"185187094667903_477083092110915","ad_id":"23851252560290199","shipping_fee":0,"cod":0,"cash":0,"account":1,"total_discount":0,"note":"","note_print":null,"received_at_shop":false,"is_free_shipping":false,"is_locked":false,"creator_id":"8fbe2a6f-b0b2-4227-a698-19d18c43f7c8","creator":{"id":"8fbe2a6f-b0b2-4227-a698-19d18c43f7c8","fb_id":"2042723249341651","name":"Hoang Anh","avatar_url":null},"items":[],"partner":{"partner_id":1,"cod":0,"extend_code":"S58824.MB25.C3.500020713","total_fee":0,"updated_at":"2020-05-12T05:18:16"},"shipping_address":{"full_name":"Hoang Anh","phone_number":"0999999999","address":"90 Cầu Giấy","full_address":"90 Cầu Giấy, Phường Dịch Vọng, Quận Cầu Giấy, Hà Nội","province_id":"101","district_id":"10113","commune_id":"1011309"}}},"SuccessResponse":{"value":{"success":true}},"SuccessEmptyDataResponse":{"value":{"success":true,"data":[]}}},"parameters":{"InventoryAnalyticsWarehouseIds":{"name":"warehouse_ids[]","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","format":"uuid"},"example":["b4cb5897-6e56-4581-96cc-2f12677c7bd8"]},"description":"Filter histories by warehouse ID(s). Restricts the inventory movements considered to the listed warehouses.","x-description-i18n":{"vie":"Lọc lịch sử theo mã kho. Chỉ tính các phát sinh xuất nhập thuộc các kho được liệt kê."}},"InventoryAnalyticsVariationIds":{"name":"variation_ids[]","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","format":"uuid"},"example":["d9005a9f-257b-4ce7-af6e-bad339598ea6"]},"description":"Filter by variation IDs. When `is_exclude_variation=true`, this list becomes an exclusion list.","x-description-i18n":{"vie":"Lọc theo mã mẫu mã. Khi `is_exclude_variation=true`, danh sách này trở thành danh sách loại trừ."}},"InventoryAnalyticsIsExcludeVariation":{"name":"is_exclude_variation","in":"query","required":false,"schema":{"type":"boolean","default":false,"example":false},"description":"When true, treat `variation_ids[]` as an exclusion list instead of an inclusion list.","x-description-i18n":{"vie":"Khi bật, coi `variation_ids[]` là danh sách loại trừ thay vì danh sách lọc vào."}},"InventoryAnalyticsProductIds":{"name":"product_ids[]","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","format":"uuid"},"example":["dee8f2c3-2ecc-4d9b-a9ff-603b5bde7e3d"]},"description":"Filter by product IDs. When `is_exclude_product=true`, this list becomes an exclusion list.","x-description-i18n":{"vie":"Lọc theo mã sản phẩm. Khi `is_exclude_product=true`, danh sách này trở thành danh sách loại trừ."}},"InventoryAnalyticsIsExcludeProduct":{"name":"is_exclude_product","in":"query","required":false,"schema":{"type":"boolean","default":false,"example":false},"description":"When true, treat `product_ids[]` as an exclusion list instead of an inclusion list.","x-description-i18n":{"vie":"Khi bật, coi `product_ids[]` là danh sách loại trừ thay vì danh sách lọc vào."}},"InventoryAnalyticsCategoryIds":{"name":"category_ids[]","in":"query","required":false,"schema":{"type":"array","items":{"type":"integer"},"example":[567]},"description":"Filter by category IDs. A single integer value is also accepted (`category_ids=567`).","x-description-i18n":{"vie":"Lọc theo mã danh mục. Có thể truyền một giá trị đơn (`category_ids=567`)."}},"InventoryAnalyticsBrandIds":{"name":"brand_ids[]","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"},"example":["7a2f5e0a-1111-2222-3333-444455556666"]},"description":"Filter by brand IDs (UUID). Special value `no_value` matches products without a brand.\n","x-description-i18n":{"vie":"Lọc theo mã thương hiệu (UUID). Giá trị đặc biệt `no_value` để lọc sản phẩm chưa gắn thương hiệu.\n"}},"InventoryAnalyticsProductTags":{"name":"product_tags[]","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"},"example":["12"]},"description":"Filter by product tag IDs (integers serialized as strings). Special value `no_value` matches products without any tag.\nCombine with `filter_exclude_tag=true` to negate the filter.\n","x-description-i18n":{"vie":"Lọc theo mã tag sản phẩm (số nguyên dạng chuỗi). Giá trị đặc biệt `no_value` để lọc sản phẩm chưa gắn tag.\nKết hợp với `filter_exclude_tag=true` để đảo lọc thành loại trừ.\n"}},"InventoryAnalyticsFilterExcludeTag":{"name":"filter_exclude_tag","in":"query","required":false,"schema":{"type":"boolean","default":false,"example":false},"description":"When true, treat `product_tags[]` as an exclusion list. Products with any of the listed tags are excluded.","x-description-i18n":{"vie":"Khi bật, coi `product_tags[]` là danh sách loại trừ. Loại bỏ các sản phẩm có chứa bất kỳ tag nào trong danh sách."}},"InventoryAnalyticsSupplierProductIds":{"name":"supplier_product_ids[]","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"},"example":["123"]},"description":"Filter by supplier IDs (integers serialized as strings). Special value `no_value` matches products without a supplier.\nBy default the product must contain ALL listed supplier IDs; set `is_filter_supplier_by_or=true` to match ANY.\n","x-description-i18n":{"vie":"Lọc theo mã nhà cung cấp (số nguyên dạng chuỗi). Giá trị đặc biệt `no_value` để lọc sản phẩm chưa gắn NCC.\nMặc định sản phẩm phải chứa TẤT CẢ các NCC được liệt kê; bật `is_filter_supplier_by_or=true` để khớp BẤT KỲ.\n"}},"InventoryAnalyticsIsFilterSupplierByOr":{"name":"is_filter_supplier_by_or","in":"query","required":false,"schema":{"type":"boolean","default":false,"example":false},"description":"When true, OR-combine the `supplier_product_ids[]` filter (match any) instead of AND (match all).","x-description-i18n":{"vie":"Khi bật, các giá trị trong `supplier_product_ids[]` được khớp theo OR (bất kỳ) thay vì AND (tất cả)."}},"InventoryAnalyticsManipulationWarehouseIds":{"name":"manipulation_warehouse_ids[]","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","format":"uuid"},"example":["b4cb5897-6e56-4581-96cc-2f12677c7bd8"]},"description":"Filter by manipulation warehouses configured on the product. By default the product must contain ALL listed warehouses;\nset `is_filter_manipulation_warehouse_by_or=true` to match ANY. Products without any manipulation warehouse are always included.\n","x-description-i18n":{"vie":"Lọc theo kho thao tác cấu hình trên sản phẩm. Mặc định sản phẩm phải chứa TẤT CẢ các kho được liệt kê;\nbật `is_filter_manipulation_warehouse_by_or=true` để khớp BẤT KỲ. Sản phẩm chưa cấu hình kho thao tác luôn được tính.\n"}},"InventoryAnalyticsIsFilterManipulationWarehouseByOr":{"name":"is_filter_manipulation_warehouse_by_or","in":"query","required":false,"schema":{"type":"boolean","default":false,"example":false},"description":"When true, OR-combine the `manipulation_warehouse_ids[]` filter (match any) instead of AND (match all).","x-description-i18n":{"vie":"Khi bật, các giá trị trong `manipulation_warehouse_ids[]` được khớp theo OR (bất kỳ) thay vì AND (tất cả)."}},"InventoryAnalyticsDataSort":{"name":"data_sort","in":"query","required":false,"schema":{"type":"string","example":"{\"sort_by\":\"product_name\",\"asc_desc\":\"desc\"}"},"description":"JSON-encoded sort spec `{\"sort_by\": <field>, \"asc_desc\": \"asc\"|\"desc\"}`. Supported `sort_by` values:\n`product_id`, `product_name`, `variation`, `purchase_import`, `purchase_export`, `return_import`,\n`transfer_import`, `transfer_export`, `sell_export`, `stocktaking_import`, `stocktaking_export`,\n`other_import`, `other_export`, `total_import_value`, `total_export_value`, `early_actual`,\n`late_actual`, `early_actual_value`, `late_actual_value`.\n","x-description-i18n":{"vie":"Bộ sắp xếp dạng JSON `{\"sort_by\": <trường>, \"asc_desc\": \"asc\"|\"desc\"}`. Các giá trị `sort_by` hỗ trợ:\n`product_id`, `product_name`, `variation`, `purchase_import`, `purchase_export`, `return_import`,\n`transfer_import`, `transfer_export`, `sell_export`, `stocktaking_import`, `stocktaking_export`,\n`other_import`, `other_export`, `total_import_value`, `total_export_value`, `early_actual`,\n`late_actual`, `early_actual_value`, `late_actual_value`.\n"}},"AdsSelectFields":{"name":"select_fields","in":"query","required":false,"schema":{"type":"string","example":"lead,website_lead,lead_conversion_value,cost_per_lead,omni_purchase,cost_per_omni_purchase"},"description":"Comma-separated list of additional `insights` fields to include in the response. When specified, only the listed fields are returned inside `insights` (in addition to the always-present base metrics).\n\n**Performance**\n- `ad_performance_session` — Overall performance\n- `spend` — Amount spent\n- `reach` — Instant Experience reach\n- `impressions` — Impressions\n- `clicks` — Clicks (all)\n- `frequency` — Frequency\n- `cpp` — CPP\n- `cpm` — CPM\n- `cpc` — CPC\n- `ctr` — CTR\n- `cost_per_1000_accounts_center_reach` — Cost per 1000 accounts center reach\n- `cost_per_result` — Cost per result\n- `avg_purchase_conversion_value` — Average purchase conversion value\n- `indicator_result` — Result\n- `result_roas` — Result ROAS\n\n**Engagement**\n- `ad_engagement_session` — Engagement\n- `link_click` — Link clicks\n- `like` — Facebook likes\n- `comment` — Post comments\n- `post_engagement` — Post engagements\n- `post_reaction` — Post reactions\n- `post` — Post shares\n- `onsite_conversion_post_save` — Post saves\n- `photo_view` — Photo views\n- `video_view` — Video plays (≥3s)\n- `inline_link_click_ctr` — CTR (link click-through rate)\n- `outbound_click` — Outbound clicks\n- `onsite_conversion_messaging_conversation_started_7d` — Messaging conversations started\n- `onsite_conversion_messaging_first_reply` — New messaging contacts\n- `onsite_conversion_messaging_block` — Messaging blocks\n- `video_thruplay_watched_actions` — ThruPlays\n- `video_play_actions` — Video plays\n- `video_p25_watched_actions` — Video plays at 25%\n- `video_p50_watched_actions` — Video plays at 50%\n- `video_p75_watched_actions` — Video plays at 75%\n- `video_p95_watched_actions` — Video plays at 95%\n- `video_p100_watched_actions` — Video plays at 100%\n- `estimated_ad_recallers` — Estimated ad recall lift (people)\n- `cost_per_outbound_click` — Cost per outbound click\n- `cost_per_thruplay` — Cost per ThruPlay\n- `outbound_clicks_ctr` — Outbound CTR\n- `cost_per_post_engagement` — Cost per post engagement\n- `estimated_ad_recall_rate` — Estimated ad recall lift rate\n- `cost_per_estimated_ad_recallers` — Cost per estimated ad recall lift\n- `cost_per_messaging_conversation_started` — Cost per messaging conversation started\n\n**Conversion**\n\n*Leads*\n- `lead` — Leads\n- `website_lead` — Website leads\n- `offline_lead` — Offline leads\n- `meta_lead` — Meta leads\n- `lead_conversion_value` — Lead conversion value\n- `website_lead_conversion_value` — Website lead conversion value\n- `offline_lead_conversion_value` — Offline lead conversion value\n- `meta_lead_conversion_value` — Meta lead conversion value\n- `cost_per_lead` — Cost per lead\n\n*Purchases*\n- `omni_purchase` — Purchases\n- `inapp_omni_purchase` — In-app purchases\n- `website_omni_purchase` — Website purchases\n- `offline_omni_purchase` — Offline purchases\n- `meta_omni_purchase` — Meta purchases\n- `omni_purchase_conversion_value` — Purchase conversion value\n- `inapp_omni_purchase_conversion_value` — In-app purchase conversion value\n- `website_omni_purchase_conversion_value` — Website purchase conversion value\n- `offline_omni_purchase_conversion_value` — Offline purchase conversion value\n- `meta_omni_purchase_conversion_value` — Meta purchase conversion value\n- `cost_per_omni_purchase` — Cost per purchase\n\n*Checkout initiated*\n- `omni_initiated_checkout` — Checkout initiated\n- `inapp_omni_initiated_checkout` — In-app checkout initiated\n- `website_omni_initiated_checkout` — Website checkout initiated\n- `offline_omni_initiated_checkout` — Offline checkout initiated\n- `meta_omni_initiated_checkout` — Meta checkout initiated\n- `omni_initiated_checkout_conversion_value` — Checkout initiation conversion value\n- `inapp_omni_initiated_checkout_conversion_value` — In-app checkout initiation conversion value\n- `website_omni_initiated_checkout_conversion_value` — Website checkout initiation conversion value\n- `offline_omni_initiated_checkout_conversion_value` — Offline checkout initiation conversion value\n- `meta_omni_initiated_checkout_conversion_value` — Meta checkout initiation conversion value\n- `cost_per_omni_initiated_checkout` — Cost per checkout initiated\n\n*Registrations completed*\n- `omni_complete_registration` — Registrations completed\n- `inapp_omni_complete_registration` — In-app registrations completed\n- `website_omni_complete_registration` — Website registrations completed\n- `offline_omni_complete_registration` — Offline registrations completed\n- `omni_complete_registration_conversion_value` — Registration completion conversion value\n- `inapp_omni_complete_registration_conversion_value` — In-app registration completion conversion value\n- `website_omni_complete_registration_conversion_value` — Website registration completion conversion value\n- `offline_omni_complete_registration_conversion_value` — Offline registration completion conversion value\n- `cost_per_omni_complete_registration` — Cost per registration completed\n\n*Content views*\n- `omni_view_content` — Content views\n- `inapp_omni_view_content` — In-app content views\n- `website_omni_view_content` — Website content views\n- `offline_omni_view_content` — Offline content views\n- `meta_omni_view_content` — Meta content views\n- `omni_view_content_conversion_value` — Content view conversion value\n- `inapp_omni_view_content_conversion_value` — In-app content view conversion value\n- `website_omni_view_content_conversion_value` — Website content view conversion value\n- `offline_omni_view_content_conversion_value` — Offline content view conversion value\n- `meta_omni_view_content_conversion_value` — Meta content view conversion value\n- `cost_per_omni_view_content` — Cost per content view\n\n*Searches*\n- `omni_search` — Searches\n- `inapp_omni_search` — In-app searches\n- `website_omni_search` — Website searches\n- `offline_omni_search` — Offline searches\n- `omni_search_conversion_value` — Search conversion value\n- `inapp_omni_search_conversion_value` — In-app search conversion value\n- `website_omni_search_conversion_value` — Website search conversion value\n- `offline_omni_search_conversion_value` — Offline search conversion value\n- `cost_per_omni_search` — Cost per search\n\n*Add to cart*\n- `omni_add_to_cart` — Add to cart\n- `inapp_omni_add_to_cart` — In-app add to cart\n- `website_omni_add_to_cart` — Website add to cart\n- `offline_omni_add_to_cart` — Offline add to cart\n- `meta_omni_add_to_cart` — Meta add to cart\n- `omni_add_to_cart_conversion_value` — Add-to-cart conversion value\n- `inapp_omni_add_to_cart_conversion_value` — In-app add-to-cart conversion value\n- `website_omni_add_to_cart_conversion_value` — Website add-to-cart conversion value\n- `offline_omni_add_to_cart_conversion_value` — Offline add-to-cart conversion value\n- `meta_omni_add_to_cart_conversion_value` — Meta add-to-cart conversion value\n- `cost_per_omni_add_to_cart` — Cost per add to cart\n\n*Add to wishlist*\n- `omni_add_to_wishlist` — Add to wishlist\n- `inapp_omni_add_to_wishlist` — In-app add to wishlist\n- `website_omni_add_to_wishlist` — Website add to wishlist\n- `offline_omni_add_to_wishlist` — Offline add to wishlist\n- `meta_omni_add_to_wishlist` — Meta add to wishlist\n- `omni_add_to_wishlist_conversion_value` — Add-to-wishlist conversion value\n- `inapp_omni_add_to_wishlist_conversion_value` — In-app add-to-wishlist conversion value\n- `website_omni_add_to_wishlist_conversion_value` — Website add-to-wishlist conversion value\n- `offline_omni_add_to_wishlist_conversion_value` — Offline add-to-wishlist conversion value\n- `meta_omni_add_to_wishlist_conversion_value` — Meta add-to-wishlist conversion value\n- `cost_per_omni_add_to_wishlist` — Cost per add to wishlist\n\n*Product customizations*\n- `customize_product_total` — Product customizations\n- `inapp_customize_product_total` — In-app product customizations\n- `website_customize_product_total` — Website product customizations\n- `offline_customize_product_total` — Offline product customizations\n- `customize_product_total_conversion_value` — Product customization conversion value\n- `inapp_customize_product_total_conversion_value` — In-app product customization conversion value\n- `website_customize_product_total_conversion_value` — Website product customization conversion value\n- `offline_customize_product_total_conversion_value` — Offline product customization conversion value\n- `cost_per_customize_product_total` — Cost per product customization\n\n*Trials started*\n- `start_trial_total` — Trials started\n- `inapp_start_trial_total` — In-app trials started\n- `website_start_trial_total` — Website trials started\n- `offline_start_trial_total` — Offline trials started\n- `start_trial_total_conversion_value` — Trial start conversion value\n- `inapp_start_trial_total_conversion_value` — In-app trial start conversion value\n- `website_start_trial_total_conversion_value` — Website trial start conversion value\n- `offline_start_trial_total_conversion_value` — Offline trial start conversion value\n- `cost_per_start_trial_total` — Cost per trial started\n\n*Subscriptions*\n- `subscribe_total` — Subscriptions\n- `inapp_subscribe_total` — In-app subscriptions\n- `website_subscribe_total` — Website subscriptions\n- `offline_subscribe_total` — Offline subscriptions\n- `subscribe_total_conversion_value` — Subscription conversion value\n- `inapp_subscribe_total_conversion_value` — In-app subscription conversion value\n- `website_subscribe_total_conversion_value` — Website subscription conversion value\n- `offline_subscribe_total_conversion_value` — Offline subscription conversion value\n- `cost_per_subscribe_total` — Cost per subscription\n\n*Applications submitted*\n- `submit_application_total` — Applications submitted\n- `inapp_submit_application_total` — In-app applications submitted\n- `website_submit_application_total` — Website applications submitted\n- `offline_submit_application_total` — Offline applications submitted\n- `meta_submit_application_total` — Meta applications submitted\n- `submit_application_total_conversion_value` — Application submission conversion value\n- `inapp_submit_application_total_conversion_value` — In-app application submission conversion value\n- `website_submit_application_total_conversion_value` — Website application submission conversion value\n- `offline_submit_application_total_conversion_value` — Offline application submission conversion value\n- `meta_submit_application_total_conversion_value` — Meta application submission conversion value\n- `cost_per_submit_application_total` — Cost per application submitted\n\n*Contacts*\n- `contact_total` — Contacts\n- `inapp_contact_total` — In-app contacts\n- `website_contact_total` — Website contacts\n- `offline_contact_total` — Offline contacts\n- `contact_total_conversion_value` — Contact conversion value\n- `inapp_contact_total_conversion_value` — In-app contact conversion value\n- `website_contact_total_conversion_value` — Website contact conversion value\n- `offline_contact_total_conversion_value` — Offline contact conversion value\n- `cost_per_contact_total` — Cost per contact\n\n*Landing page views*\n- `landing_page_view` — Landing page views\n- `inapp_landing_page_view` — In-app landing page views\n- `website_landing_page_view` — Website landing page views\n- `cost_per_landing_page_view` — Cost per landing page view\n\n*Orders*\n- `order_created` — Orders created\n- `order_shipped` — Orders shipped\n\n*Purchase ROAS*\n- `purchase_roas` — Purchase ROAS\n- `inapp_purchase_roas` — In-app purchase ROAS\n- `website_purchase_roas` — Website purchase ROAS\n","x-description-i18n":{"vie":"Danh sách các trường trong `insights` cần trả về, phân cách bằng dấu phẩy. Khi truyền tham số này, chỉ các trường được chỉ định mới xuất hiện trong `insights`.\n\n**Hiệu quả**\n- `ad_performance_session` — Hiệu quả\n- `spend` — Số tiền đã chi tiêu\n- `reach` — Số người tiếp cận Trải nghiệm tức thì\n- `impressions` — Lượt hiển thị\n- `clicks` — Số lần nhấp (tất cả)\n- `frequency` — Tần suất\n- `cpp` — CPP\n- `cpm` — CPM\n- `cpc` — CPC\n- `ctr` — CTR\n- `cost_per_1000_accounts_center_reach` — Chi phí trên mỗi 1000 tài khoản tiếp cận\n- `cost_per_result` — Chi phí trên mỗi kết quả\n- `avg_purchase_conversion_value` — Giá trị chuyển đổi trung bình của lượt mua\n- `indicator_result` — Kết quả\n- `result_roas` — Kết quả ROAS\n\n**Tương tác**\n- `ad_engagement_session` — Tương tác\n- `link_click` — Lượt click vào liên kết\n- `like` — Lượt thích trên Facebook\n- `comment` — Bình luận về bài viết\n- `post_engagement` — Lượt tương tác với bài viết\n- `post_reaction` — Cảm xúc về bài viết\n- `post` — Lượt chia sẻ bài viết\n- `onsite_conversion_post_save` — Lượt lưu bài viết\n- `photo_view` — Lượt xem ảnh\n- `video_view` — Lượt phát video trong tối thiểu 3 giây\n- `inline_link_click_ctr` — CTR (Tỷ lệ nhấp vào liên kết)\n- `outbound_click` — Lượt click ra ngoài\n- `onsite_conversion_messaging_conversation_started_7d` — Lượt bắt đầu cuộc trò chuyện qua tin nhắn\n- `onsite_conversion_messaging_first_reply` — Người liên hệ nhắn tin mới\n- `onsite_conversion_messaging_block` — Lượt chặn\n- `video_thruplay_watched_actions` — ThruPlays\n- `video_play_actions` — Lượt phát video\n- `video_p25_watched_actions` — Lượt phát 25% thời lượng video\n- `video_p50_watched_actions` — Lượt phát 50% thời lượng video\n- `video_p75_watched_actions` — Lượt phát 75% thời lượng video\n- `video_p95_watched_actions` — Lượt phát 95% thời lượng video\n- `video_p100_watched_actions` — Lượt phát 100% thời lượng video\n- `estimated_ad_recallers` — Độ cải thiện khả năng nhớ đến quảng cáo theo ước tính (Người)\n- `cost_per_outbound_click` — Chi phí trên mỗi lượt click ra ngoài\n- `cost_per_thruplay` — Chi phí trên mỗi lượt ThruPlay\n- `outbound_clicks_ctr` — CTR ra ngoài (Tỷ lệ nhấp)\n- `cost_per_post_engagement` — Chi phí trên mỗi lượt tương tác với bài viết\n- `estimated_ad_recall_rate` — Tỷ lệ độ cải thiện khả năng nhớ đến quảng cáo theo ước tính\n- `cost_per_estimated_ad_recallers` — Chi phí trên độ cải thiện khả năng nhớ đến quảng cáo theo ước tính (Người)\n- `cost_per_messaging_conversation_started` — Chi phí trên mỗi lượt bắt đầu cuộc trò chuyện qua tin nhắn\n\n**Chuyển đổi**\n\n*Khách hàng tiềm năng*\n- `lead` — Khách hàng tiềm năng\n- `website_lead` — Số khách hàng tiềm năng trên trang web\n- `offline_lead` — Số khách hàng tiềm năng offline\n- `meta_lead` — Khách hàng tiềm năng trên Meta\n- `lead_conversion_value` — Giá trị chuyển đổi khách hàng tiềm năng\n- `website_lead_conversion_value` — Giá trị chuyển đổi khách hàng tiềm năng trên trang web\n- `offline_lead_conversion_value` — Giá trị chuyển đổi khách hàng tiềm năng offline\n- `meta_lead_conversion_value` — Giá trị chuyển đổi khách hàng tiềm năng của Meta\n- `cost_per_lead` — Chi phí trên mỗi khách hàng tiềm năng\n\n*Lượt mua*\n- `omni_purchase` — Lượt mua\n- `inapp_omni_purchase` — Lượt khách hàng trong ứng dụng\n- `website_omni_purchase` — Lượt mua trên web\n- `offline_omni_purchase` — Lượt mua hàng offline\n- `meta_omni_purchase` — Lượt mua trên Meta\n- `omni_purchase_conversion_value` — Giá trị chuyển đổi từ lượt mua\n- `inapp_omni_purchase_conversion_value` — Giá trị chuyển đổi của lượt mua hàng trong ứng dụng\n- `website_omni_purchase_conversion_value` — Giá trị chuyển đổi của lượt mua trên web\n- `offline_omni_purchase_conversion_value` — Giá trị chuyển đổi từ lượt mua hàng offline\n- `meta_omni_purchase_conversion_value` — Giá trị chuyển đổi của lượt mua trên Meta\n- `cost_per_omni_purchase` — Chi phí trên mỗi lượt mua\n\n*Lượt bắt đầu thanh toán*\n- `omni_initiated_checkout` — Lượt bắt đầu thanh toán\n- `inapp_omni_initiated_checkout` — Lượt bắt đầu thanh toán trên ứng dụng di động\n- `website_omni_initiated_checkout` — Lượt bắt đầu thanh toán trên web\n- `offline_omni_initiated_checkout` — Lượt bắt đầu thanh toán offline\n- `meta_omni_initiated_checkout` — Lượt bắt đầu thanh toán trên Meta\n- `omni_initiated_checkout_conversion_value` — Giá trị của chuyển đổi bắt đầu thanh toán\n- `inapp_omni_initiated_checkout_conversion_value` — Giá trị chuyển đổi từ lượt bắt đầu thanh toán trong ứng dụng\n- `website_omni_initiated_checkout_conversion_value` — Giá trị chuyển đổi của số lượt bắt đầu thanh toán trên trang web\n- `offline_omni_initiated_checkout_conversion_value` — Giá trị chuyển đổi offline từ sự kiện bắt đầu thanh toán\n- `meta_omni_initiated_checkout_conversion_value` — Giá trị chuyển đổi từ lượt bắt đầu thanh toán trên Meta\n- `cost_per_omni_initiated_checkout` — Chi phí trên mỗi lượt bắt đầu thanh toán\n\n*Lượt hoàn tất đăng ký*\n- `omni_complete_registration` — Lượt hoàn tất đăng ký\n- `inapp_omni_complete_registration` — Lượt hoàn tất đăng ký trên ứng dụng di động\n- `website_omni_complete_registration` — Lượt hoàn tất đăng ký trên trang web\n- `offline_omni_complete_registration` — Lượt hoàn tất đăng ký offline\n- `omni_complete_registration_conversion_value` — Giá trị chuyển đổi từ lượt hoàn tất đăng ký\n- `inapp_omni_complete_registration_conversion_value` — Giá trị chuyển đổi từ lượt hoàn tất đăng ký trong ứng dụng\n- `website_omni_complete_registration_conversion_value` — Giá trị chuyển đổi từ lượt hoàn tất đăng ký trên trang web\n- `offline_omni_complete_registration_conversion_value` — Giá trị chuyển đổi từ lượt hoàn tất đăng ký offline\n- `cost_per_omni_complete_registration` — Chi phí trên mỗi lượt hoàn tất đăng ký\n\n*Lượt xem nội dung*\n- `omni_view_content` — Lượt xem nội dung\n- `inapp_omni_view_content` — Lượt xem nội dung trong ứng dụng\n- `website_omni_view_content` — Lượt xem nội dung trên trang web\n- `offline_omni_view_content` — Lượt xem nội dung offline\n- `meta_omni_view_content` — Lượt xem nội dung trên Meta\n- `omni_view_content_conversion_value` — Giá trị chuyển đổi từ lượt xem nội dung\n- `inapp_omni_view_content_conversion_value` — Giá trị chuyển đổi từ lượt xem nội dung trong ứng dụng\n- `website_omni_view_content_conversion_value` — Giá trị chuyển đổi từ lượt xem nội dung trên trang web\n- `offline_omni_view_content_conversion_value` — Giá trị chuyển đổi offline từ sự kiện xem nội dung\n- `meta_omni_view_content_conversion_value` — Giá trị chuyển đổi từ lượt xem nội dung trên Meta\n- `cost_per_omni_view_content` — Chi phí trên mỗi lượt xem nội dung\n\n*Tìm kiếm*\n- `omni_search` — Tìm kiếm\n- `inapp_omni_search` — Lượt tìm kiếm trong ứng dụng\n- `website_omni_search` — Lượt tìm kiếm trên trang web\n- `offline_omni_search` — Lượt tìm kiếm offline\n- `omni_search_conversion_value` — Giá trị chuyển đổi của tìm kiếm\n- `inapp_omni_search_conversion_value` — Giá trị chuyển đổi tìm kiếm ứng dụng di động\n- `website_omni_search_conversion_value` — Giá trị chuyển đổi của tìm kiếm trên trang web\n- `offline_omni_search_conversion_value` — Giá trị chuyển đổi từ lượt tìm kiếm offline\n- `cost_per_omni_search` — Chi phí trên mỗi lượt tìm kiếm\n\n*Lượt thêm vào giỏ hàng*\n- `omni_add_to_cart` — Lượt thêm vào giỏ hàng\n- `inapp_omni_add_to_cart` — Lượt thêm vào giỏ hàng trong ứng dụng\n- `website_omni_add_to_cart` — Lượt thêm vào giỏ hàng trên trang web\n- `offline_omni_add_to_cart` — Lượt thêm vào giỏ hàng offline\n- `meta_omni_add_to_cart` — Lượt thêm vào giỏ hàng trên Meta\n- `omni_add_to_cart_conversion_value` — Giá trị chuyển đổi từ lượt thêm vào giỏ hàng\n- `inapp_omni_add_to_cart_conversion_value` — Giá trị chuyển đổi từ lượt thêm ứng dụng vào giỏ hàng\n- `website_omni_add_to_cart_conversion_value` — Giá trị chuyển đổi từ lượt thêm vào giỏ hàng trên trang web\n- `offline_omni_add_to_cart_conversion_value` — Giá trị chuyển đổi offline từ các lượt thêm vào giỏ hàng\n- `meta_omni_add_to_cart_conversion_value` — Giá trị chuyển đổi từ lượt thêm vào giỏ hàng trên Meta\n- `cost_per_omni_add_to_cart` — Chi phí trên mỗi lượt thêm vào giỏ hàng\n\n*Thêm vào danh sách mong ước*\n- `omni_add_to_wishlist` — Thêm vào danh sách mong ước\n- `inapp_omni_add_to_wishlist` — Thêm vào danh sách mong ước trong ứng dụng di động\n- `website_omni_add_to_wishlist` — Thêm vào danh sách mong ước trên trang web\n- `offline_omni_add_to_wishlist` — Thêm vào danh sách mong ước offline\n- `meta_omni_add_to_wishlist` — Thêm vào danh sách mong ước trên Meta\n- `omni_add_to_wishlist_conversion_value` — Giá trị chuyển đổi từ lượt thêm vào danh sách mong ước\n- `inapp_omni_add_to_wishlist_conversion_value` — Giá trị chuyển đổi từ lượt thêm vào danh sách mong ước trong ứng dụng\n- `website_omni_add_to_wishlist_conversion_value` — Giá trị chuyển đổi từ lượt thêm vào danh sách mong ước trên trang web\n- `offline_omni_add_to_wishlist_conversion_value` — Giá trị chuyển đổi offline từ lượt thêm vào danh sách mong ước\n- `meta_omni_add_to_wishlist_conversion_value` — Giá trị chuyển đổi từ lượt thêm vào danh sách mong ước trên Meta\n- `cost_per_omni_add_to_wishlist` — Chi phí trên mỗi lượt thêm vào danh sách mong ước\n\n*Lượt tuỳ chỉnh sản phẩm*\n- `customize_product_total` — Lượt tuỳ chỉnh sản phẩm\n- `inapp_customize_product_total` — Lượt tuỳ chỉnh sản phẩm trong ứng dụng di động\n- `website_customize_product_total` — Lượt tuỳ chỉnh sản phẩm trên trang web\n- `offline_customize_product_total` — Lượt tuỳ chỉnh sản phẩm offline\n- `customize_product_total_conversion_value` — Giá trị chuyển đổi từ lượt tuỳ chỉnh sản phẩm\n- `inapp_customize_product_total_conversion_value` — Giá trị chuyển đổi từ lượt tuỳ chỉnh sản phẩm trong ứng dụng\n- `website_customize_product_total_conversion_value` — Giá trị chuyển đổi từ lượt tuỳ chỉnh sản phẩm trên trang web\n- `offline_customize_product_total_conversion_value` — Giá trị chuyển đổi từ lượt tuỳ chỉnh sản phẩm offline\n- `cost_per_customize_product_total` — Chi phí trên mỗi lượt tuỳ chỉnh sản phẩm\n\n*Lượt bắt đầu dùng thử*\n- `start_trial_total` — Lượt bắt đầu dùng thử\n- `inapp_start_trial_total` — Lượt bắt đầu dùng thử trong ứng dụng di động\n- `website_start_trial_total` — Lượt bắt đầu dùng thử trên trang web\n- `offline_start_trial_total` — Lượt bắt đầu dùng thử offline\n- `start_trial_total_conversion_value` — Giá trị chuyển đổi từ lượt bắt đầu dùng thử\n- `inapp_start_trial_total_conversion_value` — Giá trị chuyển đổi từ lượt bắt đầu dùng thử trong ứng dụng\n- `website_start_trial_total_conversion_value` — Giá trị chuyển đổi từ lượt bắt đầu dùng thử trên trang web\n- `offline_start_trial_total_conversion_value` — Giá trị chuyển đổi từ lượt bắt đầu dùng thử offline\n- `cost_per_start_trial_total` — Chi phí trên mỗi lượt bắt đầu dùng thử\n\n*Lượt đăng ký*\n- `subscribe_total` — Lượt đăng ký\n- `inapp_subscribe_total` — Lượt đăng ký trong ứng dụng di động\n- `website_subscribe_total` — Lượt đăng ký trên trang web\n- `offline_subscribe_total` — Lượt đăng ký offline\n- `subscribe_total_conversion_value` — Giá trị chuyển đổi từ lượt đăng ký\n- `inapp_subscribe_total_conversion_value` — Giá trị chuyển đổi từ lượt đăng ký trong ứng dụng\n- `website_subscribe_total_conversion_value` — Giá trị chuyển đổi từ lượt đăng ký trên trang web\n- `offline_subscribe_total_conversion_value` — Giá trị chuyển đổi từ lượt đăng ký offline\n- `cost_per_subscribe_total` — Chi phí trên mỗi lượt đăng ký\n\n*Lượt gửi đơn*\n- `submit_application_total` — Lượt gửi đơn\n- `inapp_submit_application_total` — Lượt gửi đơn trong ứng dụng di động\n- `website_submit_application_total` — Lượt gửi đơn trên trang web\n- `offline_submit_application_total` — Lượt gửi đơn offline\n- `meta_submit_application_total` — Lượt gửi đơn đăng ký trên Meta\n- `submit_application_total_conversion_value` — Giá trị chuyển đổi từ lượt gửi đơn\n- `inapp_submit_application_total_conversion_value` — Giá trị chuyển đổi từ lượt gửi đơn đăng ký trong ứng dụng\n- `website_submit_application_total_conversion_value` — Giá trị chuyển đổi từ lượt gửi đơn đăng ký trên trang web\n- `offline_submit_application_total_conversion_value` — Giá trị chuyển đổi từ lượt gửi đơn đăng ký offline\n- `meta_submit_application_total_conversion_value` — Giá trị chuyển đổi từ lượt gửi đơn đăng ký trên Meta\n- `cost_per_submit_application_total` — Chi phí trên mỗi lượt gửi đơn\n\n*Người liên hệ*\n- `contact_total` — Người liên hệ\n- `inapp_contact_total` — Người liên hệ trong ứng dụng di động\n- `website_contact_total` — Người liên hệ trên trang web\n- `offline_contact_total` — Người liên hệ offline\n- `contact_total_conversion_value` — Giá trị chuyển đổi từ người liên hệ\n- `inapp_contact_total_conversion_value` — Giá trị chuyển đổi từ người liên hệ trong ứng dụng\n- `website_contact_total_conversion_value` — Giá trị chuyển đổi từ người liên hệ trên trang web\n- `offline_contact_total_conversion_value` — Giá trị chuyển đổi từ người liên hệ offline\n- `cost_per_contact_total` — Chi phí trên mỗi lượt liên hệ\n\n*Số lượt xem trang đích*\n- `landing_page_view` — Số lượt xem trang đích\n- `inapp_landing_page_view` — Lượt xem trang đích trong ứng dụng\n- `website_landing_page_view` — Lượt xem trang đích trên trang web\n- `cost_per_landing_page_view` — Chi phí trên mỗi lượt xem trang đích\n\n*Đơn đặt hàng*\n- `order_created` — Đơn đặt hàng đã tạo\n- `order_shipped` — Đơn đặt hàng đã vận chuyển\n\n*ROAS của lượt mua*\n- `purchase_roas` — ROAS (Lợi nhuận trên chi tiêu quảng cáo) của lượt mua\n- `inapp_purchase_roas` — ROAS (Lợi nhuận trên chi tiêu quảng cáo) của lượt mua trong ứng dụng\n- `website_purchase_roas` — ROAS (Lợi nhuận trên chi tiêu quảng cáo) của lượt mua trên trang web\n"}},"AdsStartTime":{"name":"start_time","in":"query","required":false,"schema":{"type":"integer","format":"int64","example":1784221200},"description":"Start of the statistics period, as a Unix timestamp (seconds). The `insights` metrics are aggregated from this time.","x-description-i18n":{"vie":"Thời gian bắt đầu thống kê, dạng Unix timestamp (giây). Các chỉ số trong `insights` được tổng hợp từ thời điểm này."}},"AdsEndTime":{"name":"end_time","in":"query","required":false,"schema":{"type":"integer","format":"int64","example":1784912399},"description":"End of the statistics period, as a Unix timestamp (seconds). The `insights` metrics are aggregated up to this time.","x-description-i18n":{"vie":"Thời gian kết thúc thống kê, dạng Unix timestamp (giây). Các chỉ số trong `insights` được tổng hợp đến thời điểm này."}}},"schemas":{"ErrorResponse":{"type":"object","description":"Business or request error response","x-description-i18n":{"vie":"Phản hồi lỗi nghiệp vụ hoặc lỗi yêu cầu"},"required":["success"],"properties":{"success":{"type":"boolean","enum":[false],"description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}},"message":{"type":"string","description":"Human-readable error message","x-description-i18n":{"vie":"Thông báo lỗi dễ đọc"}},"error":{"type":"string","description":"Stable machine-readable error name, when provided","x-description-i18n":{"vie":"Tên lỗi ổn định dành cho máy xử lý, nếu có"}},"error_code":{"type":"integer","description":"Machine-readable error code, when provided","x-description-i18n":{"vie":"Mã lỗi dành cho máy xử lý, nếu có"}},"message_code":{"type":"integer","description":"POS business message code, when provided","x-description-i18n":{"vie":"Mã thông báo nghiệp vụ POS, nếu có"}},"permission":{"type":"string","description":"Required permission, when access is denied","x-description-i18n":{"vie":"Quyền bắt buộc khi truy cập bị từ chối"}}}},"OrderMessage":{"type":"object","description":"A rendered message from the conversation associated with an order. Properties can be omitted when `fields[]` is specified.","x-description-i18n":{"vie":"Tin nhắn đã render trong hội thoại liên kết với đơn hàng. Các thuộc tính có thể không xuất hiện khi chỉ định `fields[]`."},"properties":{"id":{"type":"string","description":"Message identifier","x-description-i18n":{"vie":"Mã tin nhắn"}},"type":{"type":["string","null"],"description":"Platform-specific message type, such as `INBOX` or `COMMENT`","x-description-i18n":{"vie":"Loại tin nhắn theo nền tảng, ví dụ `INBOX` hoặc `COMMENT`"}},"message":{"type":"string","description":"Rendered message content, which may contain HTML","x-description-i18n":{"vie":"Nội dung tin nhắn đã render, có thể chứa HTML"}},"original_message":{"type":["string","null"],"description":"Original message text before rendering","x-description-i18n":{"vie":"Nội dung tin nhắn gốc trước khi render"}},"message_tags":{"type":"array","description":"Extensible metadata for entities detected in the message","x-description-i18n":{"vie":"Metadata mở rộng của các thực thể được phát hiện trong tin nhắn"},"items":{"type":"object","additionalProperties":true}},"from":{"type":"object","additionalProperties":true,"description":"Extensible sender information supplied by the messaging platform","x-description-i18n":{"vie":"Thông tin người gửi có thể mở rộng do nền tảng nhắn tin cung cấp"}},"seen":{"type":"boolean","description":"Whether the message has been seen","x-description-i18n":{"vie":"Tin nhắn đã được xem hay chưa"}},"can_like":{"type":"boolean","description":"Whether the page can like the message","x-description-i18n":{"vie":"Trang có thể thích tin nhắn hay không"}},"user_likes":{"type":"boolean","description":"Whether the page has liked the message","x-description-i18n":{"vie":"Trang đã thích tin nhắn hay chưa"}},"like_count":{"type":["integer","null"],"description":"Number of likes","x-description-i18n":{"vie":"Số lượt thích"}},"can_comment":{"type":"boolean","description":"Whether the page can comment on the message","x-description-i18n":{"vie":"Trang có thể bình luận vào tin nhắn hay không"}},"comment_count":{"type":["integer","null"],"description":"Number of replies","x-description-i18n":{"vie":"Số lượng phản hồi"}},"can_remove":{"type":"boolean","description":"Whether the message can be removed","x-description-i18n":{"vie":"Tin nhắn có thể được gỡ hay không"}},"is_removed":{"type":"boolean","description":"Whether the message was removed","x-description-i18n":{"vie":"Tin nhắn đã bị gỡ hay chưa"}},"is_hidden":{"type":"boolean","description":"Whether the message is hidden","x-description-i18n":{"vie":"Tin nhắn có bị ẩn hay không"}},"can_hide":{"type":"boolean","description":"Whether the message can be hidden","x-description-i18n":{"vie":"Tin nhắn có thể được ẩn hay không"}},"can_reply_privately":{"type":"boolean","description":"Whether the message supports a private reply","x-description-i18n":{"vie":"Tin nhắn có thể được trả lời riêng tư hay không"}},"private_reply_conversation":{"type":["object","null"],"additionalProperties":true,"description":"Conversation metadata created by a private reply","x-description-i18n":{"vie":"Metadata hội thoại được tạo bởi một lần trả lời riêng tư"}},"attachments":{"type":"array","description":"Extensible platform-specific message attachments","x-description-i18n":{"vie":"Tệp đính kèm theo nền tảng với cấu trúc có thể mở rộng"},"items":{"type":"object","additionalProperties":true,"properties":{"type":{"type":"string","description":"Extensible platform-specific attachment type","x-description-i18n":{"vie":"Loại tệp đính kèm theo nền tảng, có thể mở rộng"}},"payload":{"type":["object","null"],"additionalProperties":true,"description":"Extensible structured attachment payload","x-description-i18n":{"vie":"Dữ liệu có cấu trúc của tệp đính kèm, có thể mở rộng"}}}}},"has_phone":{"type":"boolean","description":"Whether a phone number was detected in the message","x-description-i18n":{"vie":"Có phát hiện số điện thoại trong tin nhắn hay không"}},"phone_info":{"type":"array","description":"Extensible metadata for phone numbers detected in the message","x-description-i18n":{"vie":"Metadata mở rộng của các số điện thoại được phát hiện trong tin nhắn"},"items":{"type":"object","additionalProperties":true}},"is_parent":{"type":"boolean","description":"Whether the message is a top-level comment","x-description-i18n":{"vie":"Tin nhắn có phải là bình luận cấp cao nhất hay không"}},"inserted_at":{"type":"string","example":"2026-06-25T02:00:38.675576","description":"ISO 8601 timestamp emitted at runtime without a timezone suffix","x-description-i18n":{"vie":"Thời gian ISO 8601 được trả về lúc chạy, không có hậu tố múi giờ"}},"page_id":{"type":"string","description":"Page identifier","x-description-i18n":{"vie":"Mã trang"}},"show_info":{"type":"boolean","description":"Whether sender information should be displayed for this message","x-description-i18n":{"vie":"Có hiển thị thông tin người gửi cho tin nhắn này hay không"}},"parent_id":{"type":["string","null"],"description":"Parent message identifier for a reply","x-description-i18n":{"vie":"Mã tin nhắn cha nếu đây là phản hồi"}},"is_parent_hidden":{"type":"boolean","description":"Whether the parent message is hidden","x-description-i18n":{"vie":"Tin nhắn cha có bị ẩn hay không"}},"edit_history":{"type":["array","null"],"description":"Extensible message edit history","x-description-i18n":{"vie":"Lịch sử chỉnh sửa tin nhắn có thể mở rộng"},"items":{"type":"object","additionalProperties":true}},"removed_by":{"type":["object","null"],"additionalProperties":true,"description":"Information about the actor who removed the message","x-description-i18n":{"vie":"Thông tin người đã gỡ tin nhắn"}},"rich_message":{"type":["object","null"],"additionalProperties":true,"description":"Extensible rich-message metadata","x-description-i18n":{"vie":"Metadata tin nhắn đa nội dung có thể mở rộng"}},"conversation_id":{"type":"string","description":"Conversation identifier","x-description-i18n":{"vie":"Mã hội thoại"}},"is_livestream_order":{"type":["boolean","null"],"description":"Whether the message was recognized as a livestream order","x-description-i18n":{"vie":"Tin nhắn có được nhận diện là đơn hàng livestream hay không"}}}},"Order":{"type":"object","description":"Order information","x-description-i18n":{"vie":"Thông tin đơn hàng"},"properties":{"id":{"type":"integer","description":"Order ID","x-description-i18n":{"vie":"Mã đơn hàng"}},"system_id":{"type":"integer","description":"System ID","x-description-i18n":{"vie":"Mã hệ thống"}},"shop_id":{"type":"integer","description":"Shop ID","x-description-i18n":{"vie":"Mã cửa hàng"}},"inserted_at":{"type":"string","format":"date-time","description":"Order creation time","x-description-i18n":{"vie":"Thời điểm tạo đơn"}},"updated_at":{"type":"string","format":"date-time","description":"Order update time","x-description-i18n":{"vie":"Thời điểm cập nhật đơn"}},"status":{"type":"integer","description":"Order status","x-description-i18n":{"vie":"Trạng thái đơn hàng"},"enum":[0,17,11,12,13,20,1,8,9,2,3,16,4,15,5,6,7],"x-enum-descriptions":["New","Waiting for confirmation","Restocking","Wait for printing","Printed","Purchased","Confirmed","Packaging","Waiting for pick up","Shipped","Received","Collected money","Returning","Partial return","Returned","Canceled","Deleted recently"],"x-enum-descriptions-i18n":{"vie":["Mới","Chờ xác nhận","Chờ hàng","Chờ in","Đã in","Đã đặt hàng","Đã xác nhận","Đang đóng hàng","Chờ chuyển hàng","Đã gửi hàng","Đã nhận","Đã thu tiền","Đang hoàn","Hoàn một phần","Đã hoàn","Đã hủy","Đã xóa"]}},"status_name":{"type":"string","description":"Order status name","x-description-i18n":{"vie":"Tên trạng thái đơn hàng"}},"bill_full_name":{"type":"string","description":"Customer name","x-description-i18n":{"vie":"Tên khách hàng"}},"bill_phone_number":{"type":"string","description":"Phone number of customer","x-description-i18n":{"vie":"SĐT khách hàng"}},"bill_email":{"type":"string","description":"Customer email","x-description-i18n":{"vie":"Email khách hàng"}},"conversation_id":{"type":"string","description":"Conversation ID","x-description-i18n":{"vie":"Mã hội thoại"}},"page_id":{"type":"string","description":"Facebook page ID","x-description-i18n":{"vie":"Mã Facebook page"}},"post_id":{"type":"string","description":"Post ID","x-description-i18n":{"vie":"Mã bài viết"}},"ad_id":{"type":"string","description":"Ad ID","x-description-i18n":{"vie":"Mã quảng cáo"}},"shipping_fee":{"type":"integer","description":"Shipping fee","x-description-i18n":{"vie":"Phí vận chuyển"}},"partner_fee":{"type":"integer","description":"Fee from shipping partner","x-description-i18n":{"vie":"Phí vận chuyển từ ĐVVC"}},"fee_marketplace":{"type":"integer","description":"Fees from e-commerce platforms","x-description-i18n":{"vie":"Phí sàn"}},"customer_pay_fee":{"type":"boolean","description":"Customer pay shipping fee","x-description-i18n":{"vie":"Khách trả phí ship"}},"is_free_shipping":{"type":"boolean","description":"Free shipping","x-description-i18n":{"vie":"Miễn phí vận chuyển"}},"is_livestream":{"type":"boolean","description":"Is livestream order","x-description-i18n":{"vie":"Đơn hàng từ livestream"}},"is_live_shopping":{"type":"boolean","description":"Is live shopping order","x-description-i18n":{"vie":"Đơn hàng từ live shopping"}},"is_smc":{"type":"boolean","description":"Shopping on Messenger","x-description-i18n":{"vie":"Đơn hàng từ mua sắm trên Messenger"}},"received_at_shop":{"type":"boolean","description":"true: Sales at counter, false: Sell online","x-description-i18n":{"vie":"true: Bán tại quầy, false: Bán online"}},"total_discount":{"type":"integer","description":"Discount total","x-description-i18n":{"vie":"Tổng tiền giảm giá"}},"note":{"type":"string","description":"Internal note","x-description-i18n":{"vie":"Ghi chú nội bộ"}},"note_print":{"type":"string","description":"Note for printing","x-description-i18n":{"vie":"Ghi chú đơn hàng"}},"returned_reason":{"type":"integer","description":"Return reason code (1: Customer, 2: Staff, 3: Defective product, 4: Shipping carrier, 5: Exchange). Other values are shop-defined custom reasons, see returned_reason_name for the display name","x-description-i18n":{"vie":"Mã lý do hoàn hàng (1: Do khách hàng, 2: Do nhân viên, 3: Do sản phẩm lỗi, 4: Do đơn vị vận chuyển, 5: Do đổi hàng). Mã khác là lý do tùy chỉnh theo từng shop, xem tên hiển thị tại returned_reason_name"}},"returned_reason_name":{"type":"string","description":"Return reason name","x-description-i18n":{"vie":"Tên lý do hoàn hàng"}},"sub_status":{"type":"integer","description":"Reason for delivery delay","x-description-i18n":{"vie":"Lý do delay giao hàng"}},"warehouse_id":{"type":"string","description":"Warehouse ID","x-description-i18n":{"vie":"Mã kho hàng"}},"warehouse_info":{"type":"object","description":"Warehouse information","x-description-i18n":{"vie":"Thông tin kho hàng"},"properties":{"name":{"type":"string","description":"Warehouse name","x-description-i18n":{"vie":"Tên kho hàng"}},"phone_number":{"type":"string","description":"Warehouse phone number","x-description-i18n":{"vie":"Số điện thoại kho hàng"}},"full_address":{"type":"string","description":"Warehouse full address","x-description-i18n":{"vie":"Địa chỉ đầy đủ kho hàng"}},"address":{"type":"string","description":"Warehouse address","x-description-i18n":{"vie":"Địa chỉ chi tiết kho hàng"}},"province_id":{"type":"string","description":"Province ID","x-description-i18n":{"vie":"Mã tỉnh thành phố"}},"district_id":{"type":"string","description":"District ID","x-description-i18n":{"vie":"Mã quận huyện"}},"commune_id":{"type":"string","description":"Commune ID","x-description-i18n":{"vie":"Mã phường xã"}},"affiliate_id":{"type":"string","description":"Affiliate ID","x-description-i18n":{"vie":"Mã đại lý"}},"ffm_id":{"type":"string","description":"FFM ID","x-description-i18n":{"vie":"Mã FFM"}},"has_snappy_service":{"type":"boolean","description":"Has Snappy service","x-description-i18n":{"vie":"Có dịch vụ Snappy"}},"custom_id":{"type":"string","description":"Custom ID","x-description-i18n":{"vie":"Mã tùy chỉnh"}}}},"creator_id":{"type":"string","description":"Creator ID","x-description-i18n":{"vie":"Mã người tạo"}},"creator":{"type":"object","description":"Order creator","x-description-i18n":{"vie":"Thông tin người tạo đơn"},"properties":{"id":{"type":"string","description":"Creator ID","x-description-i18n":{"vie":"Mã người tạo"}},"fb_id":{"type":"string","description":"Facebook ID of creator","x-description-i18n":{"vie":"ID facebook người tạo đơn"}},"name":{"type":"string","description":"Creator name","x-description-i18n":{"vie":"Tên người tạo đơn"}},"avatar_url":{"type":"string","description":"Creator avatar URL","x-description-i18n":{"vie":"Link avatar người tạo"}}}},"items":{"type":"array","description":"Product list","x-description-i18n":{"vie":"Danh sách sản phẩm"},"items":{"type":"object","required":["variation_id","quantity"],"properties":{"product_id":{"type":"string","description":"Product ID","x-description-i18n":{"vie":"Mã sản phẩm"}},"quantity":{"type":"integer","description":"Quantity","x-description-i18n":{"vie":"Số lượng"}},"returned_count":{"type":"integer","description":"Returned count","x-description-i18n":{"vie":"Số lượng đã trả"}},"assigning_seller_id":{"type":"string","description":"Assigning seller ID","x-description-i18n":{"vie":"Mã nhân viên được phân công"}},"quantity_by_combo_products":{"type":"array","description":"Quantity by combo products","x-description-i18n":{"vie":"Số lượng theo combo sản phẩm"},"items":{"type":"object"}},"discount_each_product":{"type":"integer","description":"Discount for each product","x-description-i18n":{"vie":"Giảm giá cho từng sản phẩm"}},"is_bonus_product":{"type":"boolean","description":"Is bonus product","x-description-i18n":{"vie":"Sản phẩm tặng kèm"}},"is_discount_percent":{"type":"boolean","description":"Is discount by percent","x-description-i18n":{"vie":"Giảm giá theo phần trăm"}},"is_wholesale":{"type":"boolean","description":"Is wholesale","x-description-i18n":{"vie":"Bán sỉ"}},"is_composite":{"type":"boolean","description":"Is composite product","x-description-i18n":{"vie":"Sản phẩm composite"}},"one_time_product":{"type":"boolean","description":"One time product","x-description-i18n":{"vie":"Sản phẩm một lần"}},"note":{"type":"string","description":"Product note","x-description-i18n":{"vie":"Ghi chú sản phẩm"}},"note_product":{"type":"string","description":"Product note","x-description-i18n":{"vie":"Ghi chú sản phẩm"}},"inserted_at":{"type":"string","format":"date-time","description":"Inserted at","x-description-i18n":{"vie":"Thời điểm tạo"}},"measure_group_id":{"type":"integer","description":"Measure group ID","x-description-i18n":{"vie":"Mã nhóm đơn vị tính"}},"variation_info":{"type":"object","description":"Variation information. Optional when creating/updating an order (the backend defaults it to an empty object if omitted). Its inner fields are not individually required, but sending `retail_price` is recommended so the line price is correct.","x-description-i18n":{"vie":"Thông tin biến thể. Không bắt buộc khi tạo/cập nhật đơn (backend tự coi là object rỗng nếu thiếu). Các field bên trong không bắt buộc riêng lẻ, nhưng nên gửi `retail_price` để giá dòng hàng đúng."},"properties":{"id":{"type":"string","description":"Variation ID","x-description-i18n":{"vie":"Mã biến thể"}},"name":{"type":"string","description":"Product name","x-description-i18n":{"vie":"Tên sản phẩm"}},"product_id":{"type":"string","description":"Product ID","x-description-i18n":{"vie":"Mã sản phẩm"}},"retail_price":{"type":"integer","description":"Retail price. Not strictly required, but recommended when creating/updating an order so the line price is correct.","x-description-i18n":{"vie":"Giá bán lẻ. Không bắt buộc, nhưng nên gửi khi tạo/cập nhật đơn để giá dòng hàng chính xác."}},"detail":{"type":"string","description":"Variation detail","x-description-i18n":{"vie":"Chi tiết biến thể"}},"images":{"type":"array","description":"Variation images","x-description-i18n":{"vie":"Hình ảnh biến thể"},"items":{"type":"string","format":"uri"}},"fields":{"type":"array","description":"Variation fields","x-description-i18n":{"vie":"Thuộc tính biến thể"},"items":{"type":"object","properties":{"id":{"type":"string","description":"Field ID","x-description-i18n":{"vie":"Mã thuộc tính"}},"name":{"type":"string","description":"Field name","x-description-i18n":{"vie":"Tên thuộc tính"}},"value":{"type":"string","description":"Field value","x-description-i18n":{"vie":"Giá trị thuộc tính"}},"keyValue":{"type":"string","description":"Key value","x-description-i18n":{"vie":"Giá trị khóa"}}}}},"barcode":{"type":"string","description":"Barcode","x-description-i18n":{"vie":"Mã barcode"}},"brand_id":{"type":"string","description":"Brand ID","x-description-i18n":{"vie":"Mã thương hiệu"}},"category_ids":{"type":"array","description":"Category IDs","x-description-i18n":{"vie":"Danh sách mã danh mục"},"items":{"type":"integer"}},"display_id":{"type":"string","description":"Display ID","x-description-i18n":{"vie":"Mã hiển thị"}},"product_display_id":{"type":"string","description":"Product display ID","x-description-i18n":{"vie":"Mã hiển thị sản phẩm"}},"last_imported_price":{"type":"integer","description":"Last imported price","x-description-i18n":{"vie":"Giá nhập hàng cuối"}},"is_upsale_product":{"type":"boolean","description":"Upsale product","x-description-i18n":{"vie":"Sản phẩm upsale"}},"weight":{"type":"integer","description":"Weight","x-description-i18n":{"vie":"Khối lượng"}},"measure_info":{"type":"object","description":"Measure information","x-description-i18n":{"vie":"Thông tin đơn vị tính"},"properties":{"measure_id":{"type":"integer","description":"Measure ID","x-description-i18n":{"vie":"Mã đơn vị tính"}},"exchange_value":{"type":"integer","description":"Exchange value","x-description-i18n":{"vie":"Giá trị quy đổi"}}}},"avg_price":{"type":"integer","description":"Average import price","x-description-i18n":{"vie":"Giá nhập trung bình"}}}},"components":{"type":"array","description":"Product components","x-description-i18n":{"vie":"Thành phần sản phẩm"},"items":{"type":"object","properties":{"component_id":{"type":"string","description":"Component ID","x-description-i18n":{"vie":"Mã thành phần"}},"quantity":{"type":"integer","description":"Quantity","x-description-i18n":{"vie":"Số lượng"}},"variation_id":{"type":"string","description":"Variation ID","x-description-i18n":{"vie":"Mã biến thể"}},"variation_info":{"type":"object","description":"Variation information","x-description-i18n":{"vie":"Thông tin biến thể"}}}}}}}},"partner":{"type":"object","description":"Partner information","x-description-i18n":{"vie":"Thông tin đơn vị vận chuyển"},"properties":{"partner_id":{"type":"integer","description":"Partner ID","x-description-i18n":{"vie":"ID đơn vị vận chuyển trên hệ thống Pancake"}},"cod":{"type":"integer","description":"Reconciliation COD","x-description-i18n":{"vie":"Đối soát tiền thu hộ"}},"extend_code":{"type":"string","description":"Shipping order ID on partner system","x-description-i18n":{"vie":"Mã vận đơn"}},"total_fee":{"type":"integer","description":"Total fee","x-description-i18n":{"vie":"Tổng phí"}},"updated_at":{"type":"string","format":"date-time","description":"Updated at","x-description-i18n":{"vie":"Thời điểm cập nhật"}},"delivery_name":{"type":"string","description":"Shipper name","x-description-i18n":{"vie":"Tên người giao hàng"}},"delivery_tel":{"type":"string","description":"Delivery phone","x-description-i18n":{"vie":"Số điện thoại người giao hàng"}},"picked_up_at":{"type":"string","format":"date-time","description":"Picked up at","x-description-i18n":{"vie":"Thời điểm lấy hàng"}},"sort_code":{"type":"string","description":"Sort code","x-description-i18n":{"vie":"Mã phân loại"}},"paid_at":{"type":"string","format":"date-time","description":"Paid at","x-description-i18n":{"vie":"Thời điểm thanh toán"}},"system_created":{"type":"boolean","description":"System created","x-description-i18n":{"vie":"Được tạo bởi hệ thống"}},"extend_update":{"type":"array","description":"Update from courier","x-description-i18n":{"vie":"Cập nhật từ đơn vị vận chuyển"},"items":{"type":"object","properties":{"key":{"type":"string","description":"Update key","x-description-i18n":{"vie":"Mã cập nhật"}},"status":{"type":"string","description":"Status","x-description-i18n":{"vie":"Trạng thái"}},"tracking_id":{"type":"string","description":"Partner extend code","x-description-i18n":{"vie":"Mã đơn hàng đối tác"}},"note":{"type":"string","description":"Courier notes","x-description-i18n":{"vie":"Ghi chú từ đơn vị vận chuyển"}},"update_at":{"type":"string","format":"date-time","description":"Updated at","x-description-i18n":{"vie":"Thời điểm cập nhật"}}}}},"partner_status":{"type":"string","nullable":true,"description":"Partner shipping status","x-description-i18n":{"vie":"Trạng thái vận chuyển"},"enum":["waiting","request_received","processing_picked_up","picking_up","delay_pickup","picked_up","waiting_on_the_way","on_the_way","contact_delivery_company","out_for_delivery","delay_delivery","inform_recipient","undeliverable","waiting_for_return","delivered","delivered_cod","returning","returned","returned_cod","canceled"],"x-enum-descriptions":["Waiting for processing","Carrier received the request","Processing pickup","Picking up","Delayed pickup","Picked up","Waiting for transit","In transit","Contact the carrier","Out for delivery","Delayed delivery","Notify the recipient","Undeliverable","Waiting for return","Delivered","Delivered, COD reconciled","Returning","Returned","Returned, COD reconciled","Canceled"],"x-enum-descriptions-i18n":{"vie":["Chờ xử lý","ĐVVC đã tiếp nhận đơn","Đang xử lý lấy hàng","Đang lấy hàng","Trễ lấy hàng","Đã lấy hàng","Chờ trung chuyển","Đang trung chuyển","Liên hệ ĐVVC","Đang giao hàng","Trễ giao hàng","Thông báo cho người nhận","Giao không thành","Chờ chuyển hoàn","Đã giao hàng","Đã giao hàng, đã đối soát COD","Đang chuyển hoàn","Đã chuyển hoàn","Đã chuyển hoàn, đã đối soát COD","Đã hủy vận đơn"]}},"partner_name":{"type":"string","nullable":true,"description":"Partner name","x-description-i18n":{"vie":"Tên đơn vị vận chuyển"}},"first_delivery_at":{"type":"string","format":"date-time","nullable":true,"description":"First delivery time","x-description-i18n":{"vie":"Thời điểm giao hàng lần đầu"}},"first_undeliverable_at":{"type":"string","format":"date-time","nullable":true,"description":"First failed delivery time","x-description-i18n":{"vie":"Thời điểm giao hàng thất bại lần đầu"}},"order_number_vtp":{"type":"string","nullable":true,"description":"Viettel Post tracking number","x-description-i18n":{"vie":"Mã vận đơn Viettel Post"}},"printed_form":{"type":"object","nullable":true,"description":"Printed form","x-description-i18n":{"vie":"Mẫu in"}}}},"shipping_address":{"$ref":"#/components/schemas/ShippingAddress"},"payment_purchase_histories":{"type":"array","description":"Payment histories","x-description-i18n":{"vie":"Lịch sử thanh toán"},"items":{"type":"object","properties":{"amount":{"type":"integer","description":"Amount of money","x-description-i18n":{"vie":"Số tiền"}},"type":{"type":"string","description":"Payment type","x-description-i18n":{"vie":"Loại thanh toán"}},"inserted_at":{"type":"string","format":"date-time","description":"Transaction time","x-description-i18n":{"vie":"Thời điểm giao dịch"}},"result_code":{"type":"string","description":"Result code","x-description-i18n":{"vie":"Mã kết quả"}},"ipn_reply":{"type":"boolean","description":"IPN reply","x-description-i18n":{"vie":"Phản hồi IPN"}},"voucher_amount":{"type":"integer","description":"Voucher amount","x-description-i18n":{"vie":"Số tiền voucher"}},"tags":{"type":"array","description":"Tags","x-description-i18n":{"vie":"Thẻ"},"items":{"type":"string"}}}}},"tags":{"type":"array","description":"Tags list","x-description-i18n":{"vie":"Danh sách thẻ đơn hàng"},"items":{"type":"object","properties":{"id":{"type":"integer","description":"Tag ID","x-description-i18n":{"vie":"Mã thẻ đơn hàng"}},"name":{"type":"string","description":"Tag name","x-description-i18n":{"vie":"Tên thẻ đơn hàng"}}}}},"marketer":{"type":"object","description":"Marketer information","x-description-i18n":{"vie":"Thông tin marketer"},"properties":{"id":{"type":"string","description":"Marketer ID","x-description-i18n":{"vie":"Mã marketer"}},"name":{"type":"string","description":"Marketer name","x-description-i18n":{"vie":"Tên marketer"}},"email":{"type":"string","description":"Marketer email","x-description-i18n":{"vie":"Email marketer"}},"phone_number":{"type":"string","description":"Marketer phone number","x-description-i18n":{"vie":"Số điện thoại marketer"}},"fb_id":{"type":"string","description":"Marketer Facebook ID","x-description-i18n":{"vie":"Facebook ID marketer"}},"avatar_url":{"type":"string","description":"Marketer avatar URL","x-description-i18n":{"vie":"Link avatar marketer"}}}},"pke_mkter":{"type":"string","description":"Marketer ID","x-description-i18n":{"vie":"Mã nhân viên marketer"}},"activated_combo_products":{"type":"object","description":"Activated combo products information","x-description-i18n":{"vie":"Thông tin combo sản phẩm được kích hoạt"},"properties":{"combo_product_id":{"type":"integer","description":"Combo product ID","x-description-i18n":{"vie":"Mã combo sản phẩm"}},"quantity_combo_activated":{"type":"integer","description":"Quantity combo activated","x-description-i18n":{"vie":"Số lượng combo được kích hoạt"}},"combo_product_info":{"type":"object","description":"Combo product information","x-description-i18n":{"vie":"Thông tin combo sản phẩm"}}}},"activated_promotion_advances":{"type":"array","description":"Activated promotion advances information","x-description-i18n":{"vie":"Thông tin khuyến mãi được kích hoạt"},"items":{"type":"object","properties":{"id":{"type":"integer","description":"ID","x-description-i18n":{"vie":"Mã"}},"promotion_advance_id":{"type":"string","description":"Promotion advance ID","x-description-i18n":{"vie":"Mã khuyến mãi"}},"promotion_advance_info":{"type":"object","description":"Promotion advance information","x-description-i18n":{"vie":"Thông tin khuyến mãi"}}}}},"invoice_info_list":{"type":"array","description":"Invoice information list","x-description-i18n":{"vie":"Danh sách thông tin hóa đơn"},"items":{"type":"object","properties":{"error":{"type":"string","description":"Error message if any","x-description-i18n":{"vie":"Thông báo lỗi nếu có"}},"invoice_detail":{"type":"object","description":"Invoice detail information","x-description-i18n":{"vie":"Chi tiết thông tin hóa đơn"},"properties":{"company_address":{"type":"string","description":"Company address","x-description-i18n":{"vie":"Địa chỉ công ty"}},"company_address_breakdown":{"type":"object","description":"Company address breakdown","x-description-i18n":{"vie":"Chi tiết địa chỉ công ty"},"properties":{"company_additional_info":{"type":"string","description":"Company additional information","x-description-i18n":{"vie":"Thông tin bổ sung công ty"}},"company_barangay":{"type":"string","description":"Company barangay","x-description-i18n":{"vie":"Phường/xã công ty"}},"company_city":{"type":"string","description":"Company city","x-description-i18n":{"vie":"Thành phố công ty"}},"company_detailed_address":{"type":"string","description":"Company detailed address","x-description-i18n":{"vie":"Địa chỉ chi tiết công ty"}},"company_district":{"type":"string","description":"Company district","x-description-i18n":{"vie":"Quận/huyện công ty"}},"company_full_address":{"type":"string","description":"Company full address","x-description-i18n":{"vie":"Địa chỉ đầy đủ công ty"}},"company_postcode":{"type":"string","description":"Company postcode","x-description-i18n":{"vie":"Mã bưu điện công ty"}},"company_province":{"type":"string","description":"Company province","x-description-i18n":{"vie":"Tỉnh công ty"}},"company_region":{"type":"string","description":"Company region","x-description-i18n":{"vie":"Vùng/khu vực công ty"}},"company_state":{"type":"string","description":"Company state","x-description-i18n":{"vie":"Bang/tỉnh công ty"}},"company_town":{"type":"string","description":"Company town","x-description-i18n":{"vie":"Thị trấn/phường công ty"}}}},"company_email":{"type":"string","description":"Company email","x-description-i18n":{"vie":"Email công ty"}},"company_name":{"type":"string","description":"Company name","x-description-i18n":{"vie":"Tên công ty"}},"company_tax_id":{"type":"string","description":"Company tax ID","x-description-i18n":{"vie":"Mã số thuế công ty"}}}},"invoice_type":{"type":"string","description":"Invoice type","x-description-i18n":{"vie":"Loại hóa đơn"}},"is_requested":{"type":"boolean","description":"Request for invoice","x-description-i18n":{"vie":"Yêu cầu xuất hóa đơn"}},"order_sn":{"type":"string","description":"Order code on the marketplace","x-description-i18n":{"vie":"Mã đơn hàng trên sàn"}}}}},"reports_by_phone":{"type":"object","description":"Reports by phone number","x-description-i18n":{"vie":"Báo cáo theo số điện thoại"},"properties":{"order_fail":{"type":"integer","description":"Number of failed orders","x-description-i18n":{"vie":"Số đơn thất bại"}},"order_success":{"type":"integer","description":"Number of successful orders","x-description-i18n":{"vie":"Số đơn thành công"}},"warning":{"type":"integer","description":"Number of warnings orders","x-description-i18n":{"vie":"Số đơn cảnh báo"}}},"example":{"+639175706297":{"order_fail":29,"order_success":20,"warning":0}}},"tracking_link":{"type":"string","description":"Link confirm order","x-description-i18n":{"vie":"Link xác nhận đơn hàng"}},"ads_source":{"type":"string","description":"Advertising source","x-description-i18n":{"vie":"Nguồn quảng cáo"}},"bank_payments":{"type":"object","description":"Payment method","x-description-i18n":{"vie":"Phương thức thanh toán"}},"transfer_proofs":{"type":"array","description":"Bank transfer payment proofs, including verification time, amount and receipt images","x-description-i18n":{"vie":"Danh sách chứng từ xác thực chuyển khoản, gồm ngày giờ xác thực, số tiền và ảnh chứng từ"},"items":{"type":"object","properties":{"id":{"type":"integer","description":"Transfer proof ID","x-description-i18n":{"vie":"Mã chứng từ chuyển khoản"}},"order_id":{"type":"integer","description":"Order ID","x-description-i18n":{"vie":"Mã đơn hàng"}},"shop_id":{"type":"integer","description":"Shop ID","x-description-i18n":{"vie":"Mã cửa hàng"}},"payment_id":{"type":"string","description":"Bank payment method ID (matches a key in `bank_payments`)","x-description-i18n":{"vie":"Mã phương thức thanh toán ngân hàng (trùng với key trong `bank_payments`)"}},"amount":{"type":"integer","description":"Transferred amount","x-description-i18n":{"vie":"Số tiền chuyển khoản"}},"images":{"type":"array","description":"Transfer receipt images","x-description-i18n":{"vie":"Danh sách ảnh chứng từ chuyển khoản"},"items":{"type":"string"}},"note":{"type":"string","nullable":true,"description":"Note","x-description-i18n":{"vie":"Ghi chú"}},"is_income":{"type":"boolean","description":"Money received (true) or paid out (false)","x-description-i18n":{"vie":"Là khoản tiền nhận vào (true) hay chi ra (false)"}},"is_verify":{"type":"boolean","description":"Whether the transfer has been verified","x-description-i18n":{"vie":"Chứng từ đã được xác thực hay chưa"}},"verify_at":{"type":"string","format":"date-time","nullable":true,"description":"Verification time","x-description-i18n":{"vie":"Thời điểm xác thực chuyển khoản"}},"verifier":{"type":"object","nullable":true,"description":"Verifier information","x-description-i18n":{"vie":"Thông tin người xác thực"},"properties":{"id":{"type":"string","description":"Verifier ID","x-description-i18n":{"vie":"Mã người xác thực"}},"name":{"type":"string","description":"Verifier name","x-description-i18n":{"vie":"Tên người xác thực"}},"fb_id":{"type":"string","description":"Facebook ID of verifier","x-description-i18n":{"vie":"Facebook ID người xác thực"}},"avatar_url":{"type":"string","description":"Verifier avatar URL","x-description-i18n":{"vie":"Link avatar người xác thực"}}}},"creator":{"type":"object","nullable":true,"description":"Creator information","x-description-i18n":{"vie":"Thông tin người tạo chứng từ"},"properties":{"id":{"type":"string","description":"Creator ID","x-description-i18n":{"vie":"Mã người tạo"}},"name":{"type":"string","description":"Creator name","x-description-i18n":{"vie":"Tên người tạo"}},"fb_id":{"type":"string","description":"Facebook ID of creator","x-description-i18n":{"vie":"Facebook ID người tạo"}},"avatar_url":{"type":"string","description":"Creator avatar URL","x-description-i18n":{"vie":"Link avatar người tạo"}}}},"last_editor":{"type":"object","nullable":true,"description":"Last editor information","x-description-i18n":{"vie":"Thông tin người chỉnh sửa cuối"},"properties":{"id":{"type":"string","description":"Editor ID","x-description-i18n":{"vie":"Mã người chỉnh sửa"}},"name":{"type":"string","description":"Editor name","x-description-i18n":{"vie":"Tên người chỉnh sửa"}},"fb_id":{"type":"string","description":"Facebook ID of editor","x-description-i18n":{"vie":"Facebook ID người chỉnh sửa"}},"avatar_url":{"type":"string","description":"Editor avatar URL","x-description-i18n":{"vie":"Link avatar người chỉnh sửa"}}}},"order_info":{"type":"object","nullable":true,"description":"Additional order information","x-description-i18n":{"vie":"Thông tin đơn hàng bổ sung"}},"inserted_at":{"type":"string","format":"date-time","description":"Transfer proof creation time","x-description-i18n":{"vie":"Thời điểm tạo chứng từ"}},"updated_at":{"type":"string","format":"date-time","description":"Transfer proof update time","x-description-i18n":{"vie":"Thời điểm cập nhật chứng từ"}}}}},"shopify_order_id":{"type":"string","description":"Shopify order ID","x-description-i18n":{"vie":"Mã đơn hàng Shopify"}},"shopify_abandon_checkout_id":{"type":"integer","description":"Shopify abandon checkout ID","x-description-i18n":{"vie":"Mã Shopify abandon checkout"}},"is_abandoned_order":{"type":"boolean","description":"Abandoned-cart flag for creating or updating an order. Send it directly in the request body, not inside `third_party` or `third_party_infomation`.\nAn explicit value, including `false`, takes precedence over automatic detection. If omitted on creation, the flag is determined automatically; if omitted on update, the current value is preserved.\nOnly boolean `true` or string `\"true\"` is normalized to `true`; all other submitted values become `false`.\n","x-description-i18n":{"vie":"Cờ đơn chưa hoàn tất khi tạo hoặc cập nhật đơn. Truyền trực tiếp trong body, không bọc trong `third_party` hoặc `third_party_infomation`.\nGiá trị truyền lên, kể cả `false`, được ưu tiên hơn kết quả nhận diện tự động. Nếu bỏ qua khi tạo đơn, cờ được xác định tự động; nếu bỏ qua khi cập nhật, giữ nguyên giá trị hiện tại.\nChỉ boolean `true` hoặc chuỗi `\"true\"` được chuẩn hóa thành `true`; mọi giá trị khác được gửi lên đều thành `false`.\n"},"example":true},"cod":{"type":"integer","description":"Cash on delivery","x-description-i18n":{"vie":"Tiền thu hộ"}},"cash":{"type":"integer","description":"Cash payment","x-description-i18n":{"vie":"Tiền mặt"}},"account":{"type":"integer","description":"Order source ID","x-description-i18n":{"vie":"Mã nguồn đơn hàng"}},"account_name":{"type":"string","description":"Order source name","x-description-i18n":{"vie":"Tên mã nguồn đơn"}},"advanced_platform_fee":{"type":"object","description":"Fees from e-commerce platforms","x-description-i18n":{"vie":"Phí từ sàn thương mại điện tử"},"properties":{"ads_top_up":{"type":"integer","description":"Ads wallet top-up","x-description-i18n":{"vie":"Ví quảng cáo"}},"affiliate_commission":{"type":"integer","description":"Affiliate commission","x-description-i18n":{"vie":"Phí hoa hồng (Sàn TMĐT)"}},"diff_shipping_fee":{"type":"integer","description":"Difference shipping fee","x-description-i18n":{"vie":"Chênh lệch phí vận chuyển (Sàn TMĐT)"}},"marketplace_voucher":{"type":"integer","description":"Marketplace voucher","x-description-i18n":{"vie":"Sàn trợ giá"}},"payment_fee":{"type":"integer","description":"Payment fee","x-description-i18n":{"vie":"Phí cố định, giao dịch (Sàn TMĐT)"}},"platform_commission":{"type":"integer","description":"Platform commission","x-description-i18n":{"vie":"Phí hoa hồng nền tảng (Sàn TMĐT)"}},"seller_transaction_fee":{"type":"integer","description":"Seller transaction fee","x-description-i18n":{"vie":"Phí thanh toán (Sàn TMĐT)"}},"service_fee":{"type":"integer","description":"Service fee","x-description-i18n":{"vie":"Phí dịch vụ (Sàn TMĐT)"}},"sfp_service_fee":{"type":"integer","description":"SFP service fee","x-description-i18n":{"vie":"Phí dịch vụ SFP (Sàn TMĐT)"}}}},"printing_count":{"type":"integer","description":"Printing count","x-description-i18n":{"vie":"Số lần in"}},"money_to_collect":{"type":"integer","description":"Money to collect","x-description-i18n":{"vie":"Số tiền cần thu"}},"marketplace_id":{"type":"string","description":"Marketplace ID","enum":["-2","-3","-4","-9","-16","-17","-20","-25","-27","-28"],"x-enum-descriptions":{"-2":"Tiki","-3":"Shopee","-4":"Lazada","-9":"TikTok","-16":"WooCommerce","-17":"Shopify","-20":"Line Shopping","-25":"Tokopedia","-27":"Mercado Libre","-28":"Tiendanube"},"x-description-i18n":{"vie":"Mã sàn thương mại điện tử"}},"total_price":{"type":"integer","description":"Total price","x-description-i18n":{"vie":"Tổng giá trị sản phẩm"}},"shop_customer_address_id":{"type":"string","description":"Customer address ID","x-description-i18n":{"vie":"Mã địa chỉ khách hàng"}},"customer":{"type":"object","description":"Customer information","x-description-i18n":{"vie":"Thông tin khách hàng"},"properties":{"fb_id":{"type":"string","description":"Customer Facebook ID","x-description-i18n":{"vie":"Facebook ID khách hàng"}},"id":{"type":"string","description":"Customer ID","x-description-i18n":{"vie":"Mã khách hàng"}},"name":{"type":"string","description":"Customer name","x-description-i18n":{"vie":"Tên khách hàng"}},"page_id":{"type":"string","description":"Page ID","x-description-i18n":{"vie":"Mã trang"}}}},"total_quantity":{"type":"integer","description":"Total quantity","x-description-i18n":{"vie":"Tổng số lượng"}},"time_assign_marketer":{"type":"string","format":"date-time","description":"Time assign marketer","x-description-i18n":{"vie":"Thời điểm phân công marketer"}},"p_utm_source":{"type":"string","description":"UTM Source","x-description-i18n":{"vie":"UTM Source"}},"p_utm_medium":{"type":"string","description":"UTM Medium","x-description-i18n":{"vie":"UTM Medium"}},"p_utm_campaign":{"type":"string","description":"UTM Campaign","x-description-i18n":{"vie":"UTM Campaign"}},"p_utm_term":{"type":"string","description":"UTM Term","x-description-i18n":{"vie":"UTM Term"}},"p_utm_content":{"type":"string","description":"UTM Content","x-description-i18n":{"vie":"UTM Content"}},"p_utm_id":{"type":"string","description":"UTM ID","x-description-i18n":{"vie":"UTM ID"}},"utm_affiliate":{"type":"string","description":"Affiliate","x-description-i18n":{"vie":"Affiliate"}},"link":{"type":"string","description":"Link","x-description-i18n":{"vie":"Link"}},"status_history":{"type":"array","description":"Status update history","x-description-i18n":{"vie":"Lịch sử cập nhật trạng thái"},"items":{"type":"object","properties":{"avatar_url":{"type":"string","description":"Avatar URL","x-description-i18n":{"vie":"Link avatar"}},"editor":{"type":"object","description":"Editor information","x-description-i18n":{"vie":"Thông tin người chỉnh sửa"}},"editor_fb":{"type":"string","description":"Editor Facebook ID","x-description-i18n":{"vie":"Facebook ID người chỉnh sửa"}},"editor_id":{"type":"string","description":"Editor ID","x-description-i18n":{"vie":"Mã người chỉnh sửa"}},"name":{"type":"string","description":"Name","x-description-i18n":{"vie":"Tên"}},"old_status":{"type":"integer","description":"Old status","x-description-i18n":{"vie":"Trạng thái cũ"}},"status":{"type":"integer","description":"Status","x-description-i18n":{"vie":"Trạng thái"}},"updated_at":{"type":"string","format":"date-time","description":"Updated at","x-description-i18n":{"vie":"Thời điểm cập nhật"}}}}},"duplicated_phone":{"type":"boolean","description":"Duplicated phone","x-description-i18n":{"vie":"Số điện thoại trùng lặp"}},"order_currency":{"type":"string","description":"Order currency","x-description-i18n":{"vie":"Loại tiền tệ"}},"charged_by_vnpay":{"type":"integer","description":"Charged by VNPay","x-description-i18n":{"vie":"Số tiền thanh toán qua VNPay"}},"charged_by_qrpay":{"type":"integer","description":"Charged by QRPay","x-description-i18n":{"vie":"Số tiền khách thanh toán qua QRPAY"}},"custom_id":{"type":"string","description":"Custom ID","x-description-i18n":{"vie":"Mã tùy chỉnh"}},"last_editor":{"type":"object","description":"Last editor information","x-description-i18n":{"vie":"Thông tin người chỉnh sửa cuối cùng đơn hàng"},"properties":{"id":{"type":"string","description":"Editor ID","x-description-i18n":{"vie":"Mã người chỉnh sửa"}},"fb_id":{"type":"string","description":"Facebook ID of editor","x-description-i18n":{"vie":"Facebook ID người chỉnh sửa"}},"name":{"type":"string","description":"Editor name","x-description-i18n":{"vie":"Tên người chỉnh sửa"}},"email":{"type":"string","description":"Editor email","x-description-i18n":{"vie":"Email người chỉnh sửa"}},"avatar_url":{"type":"string","description":"Editor avatar URL","x-description-i18n":{"vie":"Link avatar người chỉnh sửa"}},"phone_number":{"type":"string","description":"Editor phone number","x-description-i18n":{"vie":"Số điện thoại người chỉnh sửa"}}}},"last_editor_id":{"type":"string","description":"Last editor ID","x-description-i18n":{"vie":"Mã người sửa cuối"}},"charged_by_momo":{"type":"integer","description":"Charged by MoMo","x-description-i18n":{"vie":"Số tiền khách thanh toán qua MOMO"}},"prepaid_by_point":{"type":"object","description":"Prepaid by point","x-description-i18n":{"vie":"Thanh toán bằng điểm thưởng"},"properties":{"money":{"type":"integer","description":"Money amount","x-description-i18n":{"vie":"Số tiền"},"example":15000},"point":{"type":"integer","description":"Point amount","x-description-i18n":{"vie":"Số điểm"},"example":15}},"example":{"money":15000,"point":15}},"bank_transfer_images":{"type":"array","description":"Bank transfer images","x-description-i18n":{"vie":"Hình ảnh chuyển khoản"},"items":{"type":"string","format":"uri"}},"transfer_money":{"type":"integer","description":"Transfer money","x-description-i18n":{"vie":"Số tiền khách chuyển khoản"}},"lock_order_by_user":{"type":"string","description":"Lock order by user ID","x-description-i18n":{"vie":"Mã người dùng khóa đơn hàng"}},"assigning_care":{"type":"object","description":"Assigning care information","x-description-i18n":{"vie":"Nhân viên chăm sóc"},"properties":{"id":{"type":"string","description":"Care ID","x-description-i18n":{"vie":"Mã người chăm sóc"}},"fb_id":{"type":"string","description":"Facebook ID of care","x-description-i18n":{"vie":"Facebook ID người chăm sóc"}},"name":{"type":"string","description":"Care name","x-description-i18n":{"vie":"Tên người chăm sóc"}},"email":{"type":"string","description":"Care email","x-description-i18n":{"vie":"Email người chăm sóc"}},"avatar_url":{"type":"string","description":"Care avatar URL","x-description-i18n":{"vie":"Link avatar người chăm sóc"}},"phone_number":{"type":"string","description":"Care phone number","x-description-i18n":{"vie":"Số điện thoại người chăm sóc"}}}},"assigning_care_id":{"type":"string","description":"Assigning care ID","x-description-i18n":{"vie":"Mã nhân viên chăm sóc"}},"time_assign_care":{"type":"string","format":"date-time","description":"Time assign care","x-description-i18n":{"vie":"Thời điểm phân công chăm sóc"}},"assigning_seller":{"type":"object","description":"Assigning seller information","x-description-i18n":{"vie":"Nhân viên được phân công"},"properties":{"id":{"type":"string","description":"Seller ID","x-description-i18n":{"vie":"Mã người bán"}},"fb_id":{"type":"string","description":"Facebook ID of seller","x-description-i18n":{"vie":"Facebook ID người bán"}},"name":{"type":"string","description":"Seller name","x-description-i18n":{"vie":"Tên người bán"}},"email":{"type":"string","description":"Seller email","x-description-i18n":{"vie":"Email người bán"}},"avatar_url":{"type":"string","description":"Seller avatar URL","x-description-i18n":{"vie":"Link avatar người bán"}},"phone_number":{"type":"string","description":"Seller phone number","x-description-i18n":{"vie":"Số điện thoại người bán"}}}},"einvoices":{"type":"array","items":{"$ref":"#/components/schemas/EInvoice"}},"charged_by_card":{"type":"integer","description":"Charged by card","x-description-i18n":{"vie":"Số tiền khách quẹt thẻ"}},"estimate_delivery_date":{"type":"string","format":"date-time","description":"Estimate delivery date","x-description-i18n":{"vie":"Ngày giao hàng dự kiến"}},"order_sources":{"type":"string","description":"Order sources ID","x-description-i18n":{"vie":"Mã nguồn đơn hàng"}},"charged_by_fundiin":{"type":"integer","description":"Charged by Fundiin","x-description-i18n":{"vie":"Số tiền thanh toán qua Fundiin"}},"surcharge":{"type":"integer","description":"Surcharge","x-description-i18n":{"vie":"Phụ thu"}},"is_linked_partner":{"type":"boolean","description":"Is linked partner","x-description-i18n":{"vie":"Đã liên kết đối tác"}},"call_laters":{"type":"array","description":"Call laters","x-description-i18n":{"vie":"Gọi lại sau"},"items":{"type":"object"}},"last_update_status_at":{"type":"string","format":"date-time","description":"Last update status at","x-description-i18n":{"vie":"Thời điểm cập nhật trạng thái cuối"}},"discount_by_customer_level":{"type":"integer","description":"Discount by customer level","x-description-i18n":{"vie":"Giảm giá theo cấp độ khách hàng"}},"viewing":{"type":"array","description":"Viewing","x-description-i18n":{"vie":"NV đang xem"},"items":{"type":"object"}},"additional_info":{"type":"object","description":"Additional info","x-description-i18n":{"vie":"Thông tin bổ sung"},"properties":{"service_partner":{"type":"string","description":"Service partner","x-description-i18n":{"vie":"Dịch vụ vận chuyển"},"enum":["instant"],"x-enum-descriptions":["Instant"],"x-enum-descriptions-i18n":{"vie":["Hỏa tốc"]}},"delivery_deadline":{"type":"string","format":"date-time","description":"Delivery deadline (ISO8601, no timezone). Send null to clear.","x-description-i18n":{"vie":"Hạn giao hàng (ISO8601, không kèm timezone). Gửi null để xóa."},"example":"2026-06-03T10:00:00"}}},"order_returned_ids":{"type":"string","description":"Order returned IDs","x-description-i18n":{"vie":"Mã đơn hàng đổi trả"}},"cost_surcharge":{"type":"integer","description":"Cost surcharge","x-description-i18n":{"vie":"Phụ phí"}},"time_send_partner":{"type":"string","format":"date-time","description":"Time send partner","x-description-i18n":{"vie":"Thời điểm gửi đơn vị vận chuyển"}},"charged_by_kredivo":{"type":"integer","description":"Charged by Kredivo","x-description-i18n":{"vie":"Số tiền thanh toán qua Kredivo"}},"discount":{"type":"integer","description":"Discount","x-description-i18n":{"vie":"Giảm giá"}},"histories":{"type":"array","description":"Histories","x-description-i18n":{"vie":"Lịch sử"},"items":{"type":"object"}},"duplicated_customer":{"type":"boolean","description":"Duplicated customer","x-description-i18n":{"vie":"Khách hàng trùng lặp"}},"customer_referral_code":{"type":"object","description":"Customer referral code","x-description-i18n":{"vie":"Mã giới thiệu khách hàng"},"properties":{"active":{"type":"string","description":"Active status","x-description-i18n":{"vie":"Trạng thái kích hoạt"},"example":"true"},"customer_id":{"type":"string","format":"uuid","description":"Customer ID","x-description-i18n":{"vie":"Mã khách hàng"},"example":"09bb9399-45f3-4897-a53a-85dde2f886fe"},"discount":{"type":"string","description":"Discount value","x-description-i18n":{"vie":"Giá trị giảm giá"},"example":"10"},"format":{"type":"string","description":"Referral code format","x-description-i18n":{"vie":"Định dạng mã giới thiệu"},"example":"{PHONE_NUMBER}"},"free_products_priced_between_approx":{"type":"object","description":"Free products priced between approximately","x-description-i18n":{"vie":"Miễn phí cho khách mới sản phẩm có giá"},"properties":{"active":{"type":"string","description":"Active status","x-description-i18n":{"vie":"Trạng thái kích hoạt"},"example":"true"},"operator":{"type":"string","description":"Comparison operator","x-description-i18n":{"vie":"Toán tử so sánh"},"example":"GreaterOrEqual"},"price":{"type":"string","description":"Price threshold","x-description-i18n":{"vie":"Ngưỡng giá"},"example":"150000"}}},"is_percent":{"type":"string","description":"Discount is percentage","x-description-i18n":{"vie":"Giảm giá theo phần trăm"},"example":"true"},"only_customers_with_level_will_have_referral_code":{"type":"string","description":"Only customers with level will have referral code","x-description-i18n":{"vie":"Chỉ khách hàng có cấp độ mới có mã giới thiệu"},"example":"true"},"referral_code":{"type":"string","description":"Referral code","x-description-i18n":{"vie":"Mã giới thiệu"},"example":"982843759"},"reward_points_for_old_customers":{"type":"object","description":"Reward points for customers","x-description-i18n":{"vie":"Điểm thưởng khách hàng"},"properties":{"active":{"type":"string","description":"Active status","x-description-i18n":{"vie":"Trạng thái kích hoạt"},"example":"true"},"money":{"type":"string","description":"Money reward","x-description-i18n":{"vie":"Tiền thưởng"},"example":"10000"},"point":{"type":"string","description":"Point reward","x-description-i18n":{"vie":"Điểm thưởng"},"example":"1"}}},"shop_customer_id":{"type":"string","format":"uuid","description":"Shop customer ID","x-description-i18n":{"vie":"Mã khách hàng shop"},"example":"f8160a4c-dfa7-4ee8-b540-d245755ea1f1"}},"example":{"active":"true","customer_id":"09bb9399-45f3-4897-a53a-85dde2f886fe","discount":"10","format":"{PHONE_NUMBER}","free_products_priced_between_approx":{"active":"true","operator":"GreaterOrEqual","price":"150000"},"is_percent":"true","only_customers_with_level_will_have_referral_code":"true","referral_code":"982843759","reward_points_for_old_customers":{"active":"true","money":"10000","point":"1"},"shop_customer_id":"f8160a4c-dfa7-4ee8-b540-d245755ea1f1"}},"tax":{"type":"integer","description":"Tax","x-description-i18n":{"vie":"Thuế"}},"is_from_ecommerce":{"type":"boolean","description":"Is from e-commerce","x-description-i18n":{"vie":"Đơn hàng từ sàn thương mại điện tử"}},"note_image":{"type":"array","description":"Note images","x-description-i18n":{"vie":"Link hình ảnh ghi chú"},"items":{"type":"string","format":"uri"}},"shopify_draft_order_id":{"type":"string","description":"Shopify draft order ID","x-description-i18n":{"vie":"Mã đơn hàng nháp Shopify"}},"display_id":{"type":"integer","description":"Display ID","x-description-i18n":{"vie":"Mã hiển thị"}},"shop_partner_id":{"type":"integer","description":"Shop partner ID","x-description-i18n":{"vie":"Mã đối tác shop"}},"is_locked":{"type":"boolean","description":"Order lock","x-description-i18n":{"vie":"Khóa đơn hàng"}},"merge_order":{"type":"boolean","description":"Allows merging orders","x-description-i18n":{"vie":"Cho phép gộp đơn"}}}},"OrderInfo":{"type":"object","properties":{"id":{"type":"integer","description":"Order ID","x-description-i18n":{"vie":"Mã đơn hàng"}},"system_id":{"type":"integer","description":"System ID","x-description-i18n":{"vie":"Mã hệ thống"}},"shop_id":{"type":"integer","description":"Shop ID","x-description-i18n":{"vie":"Mã cửa hàng"}},"inserted_at":{"type":"string","format":"date-time","description":"Order creation time","x-description-i18n":{"vie":"Thời điểm tạo đơn"}},"updated_at":{"type":"string","format":"date-time","description":"Order update time","x-description-i18n":{"vie":"Thời điểm cập nhật đơn"}},"status":{"type":"integer","description":"Order status","x-description-i18n":{"vie":"Trạng thái đơn hàng"},"enum":[0,17,11,12,13,20,1,8,9,2,3,16,4,15,5,6,7],"x-enum-descriptions":["New","Waiting for confirmation","Restocking","Wait for printing","Printed","Purchased","Confirmed","Packaging","Waiting for pick up","Shipped","Received","Collected money","Returning","Partial return","Returned","Canceled","Deleted recently"],"x-enum-descriptions-i18n":{"vie":["Mới","Chờ xác nhận","Chờ hàng","Chờ in","Đã in","Đã đặt hàng","Đã xác nhận","Đang đóng hàng","Chờ chuyển hàng","Đã gửi hàng","Đã nhận","Đã thu tiền","Đang hoàn","Hoàn một phần","Đã hoàn","Đã hủy","Đã xóa"]}},"status_name":{"type":"string","description":"Order status name","x-description-i18n":{"vie":"Tên trạng thái đơn hàng"}},"bill_full_name":{"type":"string","description":"Customer name","x-description-i18n":{"vie":"Tên khách hàng"}},"bill_phone_number":{"type":"string","description":"Phone number of customer","x-description-i18n":{"vie":"SĐT khách hàng"}},"bill_email":{"type":"string","description":"Customer email","x-description-i18n":{"vie":"Email khách hàng"}},"conversation_id":{"type":"string","description":"Conversation ID","x-description-i18n":{"vie":"Mã hội thoại"}},"page_id":{"type":"string","description":"Facebook page ID","x-description-i18n":{"vie":"Mã Facebook page"}},"post_id":{"type":"string","description":"Post ID","x-description-i18n":{"vie":"Mã bài viết"}},"ad_id":{"type":"string","description":"Ad ID","x-description-i18n":{"vie":"Mã quảng cáo"}},"shipping_fee":{"type":"integer","description":"Shipping fee","x-description-i18n":{"vie":"Phí vận chuyển"}},"partner_fee":{"type":"integer","description":"Fee from shipping partner","x-description-i18n":{"vie":"Phí vận chuyển từ ĐVVC"}},"fee_marketplace":{"type":"integer","description":"Fees from e-commerce platforms","x-description-i18n":{"vie":"Phí sàn"}},"customer_pay_fee":{"type":"boolean","description":"Customer pay shipping fee","x-description-i18n":{"vie":"Khách trả phí ship"}},"is_free_shipping":{"type":"boolean","description":"Free shipping","x-description-i18n":{"vie":"Miễn phí vận chuyển"}},"is_livestream":{"type":"boolean","description":"Is livestream order","x-description-i18n":{"vie":"Đơn hàng từ livestream"}},"is_live_shopping":{"type":"boolean","description":"Is live shopping order","x-description-i18n":{"vie":"Đơn hàng từ live shopping"}},"is_smc":{"type":"boolean","description":"Shopping on Messenger","x-description-i18n":{"vie":"Đơn hàng từ mua sắm trên Messenger"}},"received_at_shop":{"type":"boolean","description":"true: Sales at counter, false: Sell online","x-description-i18n":{"vie":"true: Bán tại quầy, false: Bán online"}},"total_discount":{"type":"integer","description":"Discount total","x-description-i18n":{"vie":"Tổng tiền giảm giá"}},"note":{"type":"string","description":"Internal note","x-description-i18n":{"vie":"Ghi chú nội bộ"}},"note_print":{"type":"string","description":"Note for printing","x-description-i18n":{"vie":"Ghi chú đơn hàng"}},"returned_reason":{"type":"integer","description":"Return reason code (1: Customer, 2: Staff, 3: Defective product, 4: Shipping carrier, 5: Exchange). Other values are shop-defined custom reasons, see returned_reason_name for the display name","x-description-i18n":{"vie":"Mã lý do hoàn hàng (1: Do khách hàng, 2: Do nhân viên, 3: Do sản phẩm lỗi, 4: Do đơn vị vận chuyển, 5: Do đổi hàng). Mã khác là lý do tùy chỉnh theo từng shop, xem tên hiển thị tại returned_reason_name"}},"returned_reason_name":{"type":"string","description":"Return reason name","x-description-i18n":{"vie":"Tên lý do hoàn hàng"}},"sub_status":{"type":"integer","description":"Reason for delivery delay","x-description-i18n":{"vie":"Lý do delay giao hàng"}},"warehouse_id":{"type":"string","description":"Warehouse ID","x-description-i18n":{"vie":"Mã kho hàng"}},"warehouse_info":{"type":"object","description":"Warehouse information","x-description-i18n":{"vie":"Thông tin kho hàng"},"properties":{"name":{"type":"string","description":"Warehouse name","x-description-i18n":{"vie":"Tên kho hàng"}},"phone_number":{"type":"string","description":"Warehouse phone number","x-description-i18n":{"vie":"Số điện thoại kho hàng"}},"full_address":{"type":"string","description":"Warehouse full address","x-description-i18n":{"vie":"Địa chỉ đầy đủ kho hàng"}},"address":{"type":"string","description":"Warehouse address","x-description-i18n":{"vie":"Địa chỉ chi tiết kho hàng"}},"province_id":{"type":"string","description":"Province ID","x-description-i18n":{"vie":"Mã tỉnh thành phố"}},"district_id":{"type":"string","description":"District ID","x-description-i18n":{"vie":"Mã quận huyện"}},"commune_id":{"type":"string","description":"Commune ID","x-description-i18n":{"vie":"Mã phường xã"}},"affiliate_id":{"type":"string","description":"Affiliate ID","x-description-i18n":{"vie":"Mã đại lý"}},"ffm_id":{"type":"string","description":"FFM ID","x-description-i18n":{"vie":"Mã FFM"}},"has_snappy_service":{"type":"boolean","description":"Has Snappy service","x-description-i18n":{"vie":"Có dịch vụ Snappy"}},"custom_id":{"type":"string","description":"Custom ID","x-description-i18n":{"vie":"Mã tùy chỉnh"}}}},"creator_id":{"type":"string","description":"Creator ID","x-description-i18n":{"vie":"Mã người tạo"}},"creator":{"type":"object","description":"Order creator","x-description-i18n":{"vie":"Thông tin người tạo đơn"},"properties":{"id":{"type":"string","description":"Creator ID","x-description-i18n":{"vie":"Mã người tạo"}},"fb_id":{"type":"string","description":"Facebook ID of creator","x-description-i18n":{"vie":"ID facebook người tạo đơn"}},"name":{"type":"string","description":"Creator name","x-description-i18n":{"vie":"Tên người tạo đơn"}},"avatar_url":{"type":"string","description":"Creator avatar URL","x-description-i18n":{"vie":"Link avatar người tạo"}}}},"items":{"type":"array","description":"Product list. When creating or updating an order, each entry must include `variation_id` and `quantity`. `variation_info` is optional — if omitted, the backend treats it as an empty object; send it (with `retail_price`) when you need the line price to be explicit.","x-description-i18n":{"vie":"Danh sách sản phẩm. Khi tạo hoặc cập nhật đơn, mỗi phần tử cần có `variation_id` và `quantity`. `variation_info` không bắt buộc — nếu thiếu, backend coi như object rỗng; nên gửi kèm (cùng `retail_price`) khi muốn giá dòng hàng tường minh."},"items":{"type":"object","required":["variation_id","quantity"],"properties":{"product_id":{"type":"string","description":"Product ID","x-description-i18n":{"vie":"Mã sản phẩm"}},"quantity":{"type":"integer","description":"Quantity","x-description-i18n":{"vie":"Số lượng"}},"returned_count":{"type":"integer","description":"Returned count","x-description-i18n":{"vie":"Số lượng đã trả"}},"assigning_seller_id":{"type":"string","description":"Assigning seller ID","x-description-i18n":{"vie":"Mã nhân viên được phân công"}},"quantity_by_combo_products":{"type":"array","description":"Quantity by combo products","x-description-i18n":{"vie":"Số lượng theo combo sản phẩm"},"items":{"type":"object"}},"discount_each_product":{"type":"integer","description":"Discount for each product","x-description-i18n":{"vie":"Giảm giá cho từng sản phẩm"}},"is_bonus_product":{"type":"boolean","description":"Is bonus product","x-description-i18n":{"vie":"Sản phẩm tặng kèm"}},"is_discount_percent":{"type":"boolean","description":"Is discount by percent","x-description-i18n":{"vie":"Giảm giá theo phần trăm"}},"is_wholesale":{"type":"boolean","description":"Is wholesale","x-description-i18n":{"vie":"Bán sỉ"}},"is_composite":{"type":"boolean","description":"Is composite product","x-description-i18n":{"vie":"Sản phẩm composite"}},"one_time_product":{"type":"boolean","description":"One time product","x-description-i18n":{"vie":"Sản phẩm một lần"}},"note":{"type":"string","description":"Product note","x-description-i18n":{"vie":"Ghi chú sản phẩm"}},"note_product":{"type":"string","description":"Product note","x-description-i18n":{"vie":"Ghi chú sản phẩm"}},"inserted_at":{"type":"string","format":"date-time","description":"Inserted at","x-description-i18n":{"vie":"Thời điểm tạo"}},"measure_group_id":{"type":"integer","description":"Measure group ID","x-description-i18n":{"vie":"Mã nhóm đơn vị tính"}},"variation_info":{"type":"object","description":"Variation information. Optional when creating/updating an order (the backend defaults it to an empty object if omitted). Its inner fields are not individually required, but sending `retail_price` is recommended so the line price is correct.","x-description-i18n":{"vie":"Thông tin biến thể. Không bắt buộc khi tạo/cập nhật đơn (backend tự coi là object rỗng nếu thiếu). Các field bên trong không bắt buộc riêng lẻ, nhưng nên gửi `retail_price` để giá dòng hàng đúng."},"properties":{"id":{"type":"string","description":"Variation ID","x-description-i18n":{"vie":"Mã biến thể"}},"name":{"type":"string","description":"Product name","x-description-i18n":{"vie":"Tên sản phẩm"}},"product_id":{"type":"string","description":"Product ID","x-description-i18n":{"vie":"Mã sản phẩm"}},"retail_price":{"type":"integer","description":"Retail price. Not strictly required, but recommended when creating/updating an order so the line price is correct.","x-description-i18n":{"vie":"Giá bán lẻ. Không bắt buộc, nhưng nên gửi khi tạo/cập nhật đơn để giá dòng hàng chính xác."}},"detail":{"type":"string","description":"Variation detail","x-description-i18n":{"vie":"Chi tiết biến thể"}},"images":{"type":"array","description":"Variation images","x-description-i18n":{"vie":"Hình ảnh biến thể"},"items":{"type":"string","format":"uri"}},"fields":{"type":"array","description":"Variation fields","x-description-i18n":{"vie":"Thuộc tính biến thể"},"items":{"type":"object","properties":{"id":{"type":"string","description":"Field ID","x-description-i18n":{"vie":"Mã thuộc tính"}},"name":{"type":"string","description":"Field name","x-description-i18n":{"vie":"Tên thuộc tính"}},"value":{"type":"string","description":"Field value","x-description-i18n":{"vie":"Giá trị thuộc tính"}},"keyValue":{"type":"string","description":"Key value","x-description-i18n":{"vie":"Giá trị khóa"}}}}},"barcode":{"type":"string","description":"Barcode","x-description-i18n":{"vie":"Mã barcode"}},"brand_id":{"type":"string","description":"Brand ID","x-description-i18n":{"vie":"Mã thương hiệu"}},"category_ids":{"type":"array","description":"Category IDs","x-description-i18n":{"vie":"Danh sách mã danh mục"},"items":{"type":"integer"}},"display_id":{"type":"string","description":"Display ID","x-description-i18n":{"vie":"Mã hiển thị"}},"product_display_id":{"type":"string","description":"Product display ID","x-description-i18n":{"vie":"Mã hiển thị sản phẩm"}},"last_imported_price":{"type":"integer","description":"Last imported price","x-description-i18n":{"vie":"Giá nhập hàng cuối"}},"is_upsale_product":{"type":"boolean","description":"Upsale product","x-description-i18n":{"vie":"Sản phẩm upsale"}},"weight":{"type":"integer","description":"Weight","x-description-i18n":{"vie":"Khối lượng"}},"measure_info":{"type":"object","description":"Measure information","x-description-i18n":{"vie":"Thông tin đơn vị tính"},"properties":{"measure_id":{"type":"integer","description":"Measure ID","x-description-i18n":{"vie":"Mã đơn vị tính"}},"exchange_value":{"type":"integer","description":"Exchange value","x-description-i18n":{"vie":"Giá trị quy đổi"}}}},"avg_price":{"type":"integer","description":"Average import price","x-description-i18n":{"vie":"Giá nhập trung bình"}}}},"components":{"type":"array","description":"Product components","x-description-i18n":{"vie":"Thành phần sản phẩm"},"items":{"type":"object","properties":{"component_id":{"type":"string","description":"Component ID","x-description-i18n":{"vie":"Mã thành phần"}},"quantity":{"type":"integer","description":"Quantity","x-description-i18n":{"vie":"Số lượng"}},"variation_id":{"type":"string","description":"Variation ID","x-description-i18n":{"vie":"Mã biến thể"}},"variation_info":{"type":"object","description":"Variation information","x-description-i18n":{"vie":"Thông tin biến thể"}}}}},"id":{"type":"integer","description":"Item ID","x-description-i18n":{"vie":"Mã sản phẩm trong đơn"}},"variation_id":{"type":"string","description":"Variation ID","x-description-i18n":{"vie":"Mã biến thể"}}}}},"partner":{"type":"object","description":"Partner information","x-description-i18n":{"vie":"Thông tin đơn vị vận chuyển"},"properties":{"partner_id":{"type":"integer","description":"Partner ID","x-description-i18n":{"vie":"ID đơn vị vận chuyển trên hệ thống Pancake"}},"cod":{"type":"integer","description":"Reconciliation COD","x-description-i18n":{"vie":"Đối soát tiền thu hộ"}},"extend_code":{"type":"string","description":"Shipping order ID on partner system","x-description-i18n":{"vie":"Mã vận đơn"}},"total_fee":{"type":"integer","description":"Total fee","x-description-i18n":{"vie":"Tổng phí"}},"updated_at":{"type":"string","format":"date-time","description":"Updated at","x-description-i18n":{"vie":"Thời điểm cập nhật"}},"delivery_name":{"type":"string","description":"Shipper name","x-description-i18n":{"vie":"Tên người giao hàng"}},"delivery_tel":{"type":"string","description":"Delivery phone","x-description-i18n":{"vie":"Số điện thoại người giao hàng"}},"picked_up_at":{"type":"string","format":"date-time","description":"Picked up at","x-description-i18n":{"vie":"Thời điểm lấy hàng"}},"sort_code":{"type":"string","description":"Sort code","x-description-i18n":{"vie":"Mã phân loại"}},"paid_at":{"type":"string","format":"date-time","description":"Paid at","x-description-i18n":{"vie":"Thời điểm thanh toán"}},"system_created":{"type":"boolean","description":"System created","x-description-i18n":{"vie":"Được tạo bởi hệ thống"}},"extend_update":{"type":"array","description":"Update from courier","x-description-i18n":{"vie":"Cập nhật từ đơn vị vận chuyển"},"items":{"type":"object","properties":{"key":{"type":"string","description":"Update key","x-description-i18n":{"vie":"Mã cập nhật"}},"status":{"type":"string","description":"Status","x-description-i18n":{"vie":"Trạng thái"}},"tracking_id":{"type":"string","description":"Partner extend code","x-description-i18n":{"vie":"Mã đơn hàng đối tác"}},"note":{"type":"string","description":"Courier notes","x-description-i18n":{"vie":"Ghi chú từ đơn vị vận chuyển"}},"update_at":{"type":"string","format":"date-time","description":"Updated at","x-description-i18n":{"vie":"Thời điểm cập nhật"}}}}},"partner_status":{"type":"string","nullable":true,"description":"Partner shipping status","x-description-i18n":{"vie":"Trạng thái vận chuyển"},"enum":["waiting","request_received","processing_picked_up","picking_up","delay_pickup","picked_up","waiting_on_the_way","on_the_way","contact_delivery_company","out_for_delivery","delay_delivery","inform_recipient","undeliverable","waiting_for_return","delivered","delivered_cod","returning","returned","returned_cod","canceled"],"x-enum-descriptions":["Waiting for processing","Carrier received the request","Processing pickup","Picking up","Delayed pickup","Picked up","Waiting for transit","In transit","Contact the carrier","Out for delivery","Delayed delivery","Notify the recipient","Undeliverable","Waiting for return","Delivered","Delivered, COD reconciled","Returning","Returned","Returned, COD reconciled","Canceled"],"x-enum-descriptions-i18n":{"vie":["Chờ xử lý","ĐVVC đã tiếp nhận đơn","Đang xử lý lấy hàng","Đang lấy hàng","Trễ lấy hàng","Đã lấy hàng","Chờ trung chuyển","Đang trung chuyển","Liên hệ ĐVVC","Đang giao hàng","Trễ giao hàng","Thông báo cho người nhận","Giao không thành","Chờ chuyển hoàn","Đã giao hàng","Đã giao hàng, đã đối soát COD","Đang chuyển hoàn","Đã chuyển hoàn","Đã chuyển hoàn, đã đối soát COD","Đã hủy vận đơn"]}},"partner_name":{"type":"string","nullable":true,"description":"Partner name","x-description-i18n":{"vie":"Tên đơn vị vận chuyển"}},"first_delivery_at":{"type":"string","format":"date-time","nullable":true,"description":"First delivery time","x-description-i18n":{"vie":"Thời điểm giao hàng lần đầu"}},"first_undeliverable_at":{"type":"string","format":"date-time","nullable":true,"description":"First failed delivery time","x-description-i18n":{"vie":"Thời điểm giao hàng thất bại lần đầu"}},"order_number_vtp":{"type":"string","nullable":true,"description":"Viettel Post tracking number","x-description-i18n":{"vie":"Mã vận đơn Viettel Post"}},"printed_form":{"type":"object","nullable":true,"description":"Printed form","x-description-i18n":{"vie":"Mẫu in"}}}},"shipping_address":{"$ref":"#/components/schemas/ShippingAddress"},"payment_purchase_histories":{"type":"array","description":"Payment histories","x-description-i18n":{"vie":"Lịch sử thanh toán"},"items":{"type":"object","properties":{"amount":{"type":"integer","description":"Amount of money","x-description-i18n":{"vie":"Số tiền"}},"type":{"type":"string","description":"Payment type","x-description-i18n":{"vie":"Loại thanh toán"}},"inserted_at":{"type":"string","format":"date-time","description":"Transaction time","x-description-i18n":{"vie":"Thời điểm giao dịch"}},"result_code":{"type":"string","description":"Result code","x-description-i18n":{"vie":"Mã kết quả"}},"ipn_reply":{"type":"boolean","description":"IPN reply","x-description-i18n":{"vie":"Phản hồi IPN"}},"voucher_amount":{"type":"integer","description":"Voucher amount","x-description-i18n":{"vie":"Số tiền voucher"}},"tags":{"type":"array","description":"Tags","x-description-i18n":{"vie":"Thẻ"},"items":{"type":"string"}}}}},"tags":{"type":"array","description":"Tags list","x-description-i18n":{"vie":"Danh sách thẻ đơn hàng"},"items":{"type":"object","properties":{"id":{"type":"integer","description":"Tag ID","x-description-i18n":{"vie":"Mã thẻ đơn hàng"}},"name":{"type":"string","description":"Tag name","x-description-i18n":{"vie":"Tên thẻ đơn hàng"}}}}},"marketer":{"type":"object","description":"Marketer information","x-description-i18n":{"vie":"Thông tin marketer"},"properties":{"id":{"type":"string","description":"Marketer ID","x-description-i18n":{"vie":"Mã marketer"}},"name":{"type":"string","description":"Marketer name","x-description-i18n":{"vie":"Tên marketer"}},"email":{"type":"string","description":"Marketer email","x-description-i18n":{"vie":"Email marketer"}},"phone_number":{"type":"string","description":"Marketer phone number","x-description-i18n":{"vie":"Số điện thoại marketer"}},"fb_id":{"type":"string","description":"Marketer Facebook ID","x-description-i18n":{"vie":"Facebook ID marketer"}},"avatar_url":{"type":"string","description":"Marketer avatar URL","x-description-i18n":{"vie":"Link avatar marketer"}}}},"pke_mkter":{"type":"string","description":"Marketer ID","x-description-i18n":{"vie":"Mã nhân viên marketer"}},"activated_combo_products":{"type":"object","description":"Activated combo products information","x-description-i18n":{"vie":"Thông tin combo sản phẩm được kích hoạt"},"properties":{"combo_product_id":{"type":"integer","description":"Combo product ID","x-description-i18n":{"vie":"Mã combo sản phẩm"}},"quantity_combo_activated":{"type":"integer","description":"Quantity combo activated","x-description-i18n":{"vie":"Số lượng combo được kích hoạt"}},"combo_product_info":{"type":"object","description":"Combo product information","x-description-i18n":{"vie":"Thông tin combo sản phẩm"}}}},"activated_promotion_advances":{"type":"array","description":"Activated promotion advances information","x-description-i18n":{"vie":"Thông tin khuyến mãi được kích hoạt"},"items":{"type":"object","properties":{"id":{"type":"integer","description":"ID","x-description-i18n":{"vie":"Mã"}},"promotion_advance_id":{"type":"string","description":"Promotion advance ID","x-description-i18n":{"vie":"Mã khuyến mãi"}},"promotion_advance_info":{"type":"object","description":"Promotion advance information","x-description-i18n":{"vie":"Thông tin khuyến mãi"}}}}},"invoice_info_list":{"type":"array","description":"Invoice information list","x-description-i18n":{"vie":"Danh sách thông tin hóa đơn"},"items":{"type":"object","properties":{"error":{"type":"string","description":"Error message if any","x-description-i18n":{"vie":"Thông báo lỗi nếu có"}},"invoice_detail":{"type":"object","description":"Invoice detail information","x-description-i18n":{"vie":"Chi tiết thông tin hóa đơn"},"properties":{"company_address":{"type":"string","description":"Company address","x-description-i18n":{"vie":"Địa chỉ công ty"}},"company_address_breakdown":{"type":"object","description":"Company address breakdown","x-description-i18n":{"vie":"Chi tiết địa chỉ công ty"},"properties":{"company_additional_info":{"type":"string","description":"Company additional information","x-description-i18n":{"vie":"Thông tin bổ sung công ty"}},"company_barangay":{"type":"string","description":"Company barangay","x-description-i18n":{"vie":"Phường/xã công ty"}},"company_city":{"type":"string","description":"Company city","x-description-i18n":{"vie":"Thành phố công ty"}},"company_detailed_address":{"type":"string","description":"Company detailed address","x-description-i18n":{"vie":"Địa chỉ chi tiết công ty"}},"company_district":{"type":"string","description":"Company district","x-description-i18n":{"vie":"Quận/huyện công ty"}},"company_full_address":{"type":"string","description":"Company full address","x-description-i18n":{"vie":"Địa chỉ đầy đủ công ty"}},"company_postcode":{"type":"string","description":"Company postcode","x-description-i18n":{"vie":"Mã bưu điện công ty"}},"company_province":{"type":"string","description":"Company province","x-description-i18n":{"vie":"Tỉnh công ty"}},"company_region":{"type":"string","description":"Company region","x-description-i18n":{"vie":"Vùng/khu vực công ty"}},"company_state":{"type":"string","description":"Company state","x-description-i18n":{"vie":"Bang/tỉnh công ty"}},"company_town":{"type":"string","description":"Company town","x-description-i18n":{"vie":"Thị trấn/phường công ty"}}}},"company_email":{"type":"string","description":"Company email","x-description-i18n":{"vie":"Email công ty"}},"company_name":{"type":"string","description":"Company name","x-description-i18n":{"vie":"Tên công ty"}},"company_tax_id":{"type":"string","description":"Company tax ID","x-description-i18n":{"vie":"Mã số thuế công ty"}}}},"invoice_type":{"type":"string","description":"Invoice type","x-description-i18n":{"vie":"Loại hóa đơn"}},"is_requested":{"type":"boolean","description":"Request for invoice","x-description-i18n":{"vie":"Yêu cầu xuất hóa đơn"}},"order_sn":{"type":"string","description":"Order code on the marketplace","x-description-i18n":{"vie":"Mã đơn hàng trên sàn"}}}}},"reports_by_phone":{"type":"object","description":"Reports by phone number","x-description-i18n":{"vie":"Báo cáo theo số điện thoại"},"properties":{"order_fail":{"type":"integer","description":"Number of failed orders","x-description-i18n":{"vie":"Số đơn thất bại"}},"order_success":{"type":"integer","description":"Number of successful orders","x-description-i18n":{"vie":"Số đơn thành công"}},"warning":{"type":"integer","description":"Number of warnings orders","x-description-i18n":{"vie":"Số đơn cảnh báo"}}},"example":{"+639175706297":{"order_fail":29,"order_success":20,"warning":0}}},"tracking_link":{"type":"string","description":"Link confirm order","x-description-i18n":{"vie":"Link xác nhận đơn hàng"}},"ads_source":{"type":"string","description":"Advertising source","x-description-i18n":{"vie":"Nguồn quảng cáo"}},"bank_payments":{"type":"object","description":"Payment method","x-description-i18n":{"vie":"Phương thức thanh toán"}},"transfer_proofs":{"type":"array","description":"Bank transfer payment proofs, including verification time, amount and receipt images","x-description-i18n":{"vie":"Danh sách chứng từ xác thực chuyển khoản, gồm ngày giờ xác thực, số tiền và ảnh chứng từ"},"items":{"type":"object","properties":{"id":{"type":"integer","description":"Transfer proof ID","x-description-i18n":{"vie":"Mã chứng từ chuyển khoản"}},"order_id":{"type":"integer","description":"Order ID","x-description-i18n":{"vie":"Mã đơn hàng"}},"shop_id":{"type":"integer","description":"Shop ID","x-description-i18n":{"vie":"Mã cửa hàng"}},"payment_id":{"type":"string","description":"Bank payment method ID (matches a key in `bank_payments`)","x-description-i18n":{"vie":"Mã phương thức thanh toán ngân hàng (trùng với key trong `bank_payments`)"}},"amount":{"type":"integer","description":"Transferred amount","x-description-i18n":{"vie":"Số tiền chuyển khoản"}},"images":{"type":"array","description":"Transfer receipt images","x-description-i18n":{"vie":"Danh sách ảnh chứng từ chuyển khoản"},"items":{"type":"string"}},"note":{"type":"string","nullable":true,"description":"Note","x-description-i18n":{"vie":"Ghi chú"}},"is_income":{"type":"boolean","description":"Money received (true) or paid out (false)","x-description-i18n":{"vie":"Là khoản tiền nhận vào (true) hay chi ra (false)"}},"is_verify":{"type":"boolean","description":"Whether the transfer has been verified","x-description-i18n":{"vie":"Chứng từ đã được xác thực hay chưa"}},"verify_at":{"type":"string","format":"date-time","nullable":true,"description":"Verification time","x-description-i18n":{"vie":"Thời điểm xác thực chuyển khoản"}},"verifier":{"type":"object","nullable":true,"description":"Verifier information","x-description-i18n":{"vie":"Thông tin người xác thực"},"properties":{"id":{"type":"string","description":"Verifier ID","x-description-i18n":{"vie":"Mã người xác thực"}},"name":{"type":"string","description":"Verifier name","x-description-i18n":{"vie":"Tên người xác thực"}},"fb_id":{"type":"string","description":"Facebook ID of verifier","x-description-i18n":{"vie":"Facebook ID người xác thực"}},"avatar_url":{"type":"string","description":"Verifier avatar URL","x-description-i18n":{"vie":"Link avatar người xác thực"}}}},"creator":{"type":"object","nullable":true,"description":"Creator information","x-description-i18n":{"vie":"Thông tin người tạo chứng từ"},"properties":{"id":{"type":"string","description":"Creator ID","x-description-i18n":{"vie":"Mã người tạo"}},"name":{"type":"string","description":"Creator name","x-description-i18n":{"vie":"Tên người tạo"}},"fb_id":{"type":"string","description":"Facebook ID of creator","x-description-i18n":{"vie":"Facebook ID người tạo"}},"avatar_url":{"type":"string","description":"Creator avatar URL","x-description-i18n":{"vie":"Link avatar người tạo"}}}},"last_editor":{"type":"object","nullable":true,"description":"Last editor information","x-description-i18n":{"vie":"Thông tin người chỉnh sửa cuối"},"properties":{"id":{"type":"string","description":"Editor ID","x-description-i18n":{"vie":"Mã người chỉnh sửa"}},"name":{"type":"string","description":"Editor name","x-description-i18n":{"vie":"Tên người chỉnh sửa"}},"fb_id":{"type":"string","description":"Facebook ID of editor","x-description-i18n":{"vie":"Facebook ID người chỉnh sửa"}},"avatar_url":{"type":"string","description":"Editor avatar URL","x-description-i18n":{"vie":"Link avatar người chỉnh sửa"}}}},"order_info":{"type":"object","nullable":true,"description":"Additional order information","x-description-i18n":{"vie":"Thông tin đơn hàng bổ sung"}},"inserted_at":{"type":"string","format":"date-time","description":"Transfer proof creation time","x-description-i18n":{"vie":"Thời điểm tạo chứng từ"}},"updated_at":{"type":"string","format":"date-time","description":"Transfer proof update time","x-description-i18n":{"vie":"Thời điểm cập nhật chứng từ"}}}}},"shopify_order_id":{"type":"string","description":"Shopify order ID","x-description-i18n":{"vie":"Mã đơn hàng Shopify"}},"shopify_abandon_checkout_id":{"type":"integer","description":"Shopify abandon checkout ID","x-description-i18n":{"vie":"Mã Shopify abandon checkout"}},"is_abandoned_order":{"type":"boolean","description":"Abandoned-cart flag for creating or updating an order. Send it directly in the request body, not inside `third_party` or `third_party_infomation`.\nAn explicit value, including `false`, takes precedence over automatic detection. If omitted on creation, the flag is determined automatically; if omitted on update, the current value is preserved.\nOnly boolean `true` or string `\"true\"` is normalized to `true`; all other submitted values become `false`.\n","x-description-i18n":{"vie":"Cờ đơn chưa hoàn tất khi tạo hoặc cập nhật đơn. Truyền trực tiếp trong body, không bọc trong `third_party` hoặc `third_party_infomation`.\nGiá trị truyền lên, kể cả `false`, được ưu tiên hơn kết quả nhận diện tự động. Nếu bỏ qua khi tạo đơn, cờ được xác định tự động; nếu bỏ qua khi cập nhật, giữ nguyên giá trị hiện tại.\nChỉ boolean `true` hoặc chuỗi `\"true\"` được chuẩn hóa thành `true`; mọi giá trị khác được gửi lên đều thành `false`.\n"},"example":true},"cod":{"type":"integer","description":"Cash on delivery","x-description-i18n":{"vie":"Tiền thu hộ"}},"cash":{"type":"integer","description":"Cash payment","x-description-i18n":{"vie":"Tiền mặt"}},"account":{"type":"integer","description":"Order source ID","x-description-i18n":{"vie":"Mã nguồn đơn hàng"}},"account_name":{"type":"string","description":"Order source name","x-description-i18n":{"vie":"Tên mã nguồn đơn"}},"advanced_platform_fee":{"type":"object","description":"Fees from e-commerce platforms","x-description-i18n":{"vie":"Phí từ sàn thương mại điện tử"},"properties":{"ads_top_up":{"type":"integer","description":"Ads wallet top-up","x-description-i18n":{"vie":"Ví quảng cáo"}},"affiliate_commission":{"type":"integer","description":"Affiliate commission","x-description-i18n":{"vie":"Phí hoa hồng (Sàn TMĐT)"}},"diff_shipping_fee":{"type":"integer","description":"Difference shipping fee","x-description-i18n":{"vie":"Chênh lệch phí vận chuyển (Sàn TMĐT)"}},"marketplace_voucher":{"type":"integer","description":"Marketplace voucher","x-description-i18n":{"vie":"Sàn trợ giá"}},"payment_fee":{"type":"integer","description":"Payment fee","x-description-i18n":{"vie":"Phí cố định, giao dịch (Sàn TMĐT)"}},"platform_commission":{"type":"integer","description":"Platform commission","x-description-i18n":{"vie":"Phí hoa hồng nền tảng (Sàn TMĐT)"}},"seller_transaction_fee":{"type":"integer","description":"Seller transaction fee","x-description-i18n":{"vie":"Phí thanh toán (Sàn TMĐT)"}},"service_fee":{"type":"integer","description":"Service fee","x-description-i18n":{"vie":"Phí dịch vụ (Sàn TMĐT)"}},"sfp_service_fee":{"type":"integer","description":"SFP service fee","x-description-i18n":{"vie":"Phí dịch vụ SFP (Sàn TMĐT)"}}}},"printing_count":{"type":"integer","description":"Printing count","x-description-i18n":{"vie":"Số lần in"}},"money_to_collect":{"type":"integer","description":"Money to collect","x-description-i18n":{"vie":"Số tiền cần thu"}},"marketplace_id":{"type":"string","description":"Marketplace ID","enum":["-2","-3","-4","-9","-16","-17","-20","-25","-27","-28"],"x-enum-descriptions":{"-2":"Tiki","-3":"Shopee","-4":"Lazada","-9":"TikTok","-16":"WooCommerce","-17":"Shopify","-20":"Line Shopping","-25":"Tokopedia","-27":"Mercado Libre","-28":"Tiendanube"},"x-description-i18n":{"vie":"Mã sàn thương mại điện tử"}},"total_price":{"type":"integer","description":"Total price","x-description-i18n":{"vie":"Tổng giá trị sản phẩm"}},"shop_customer_address_id":{"type":"string","description":"Customer address ID","x-description-i18n":{"vie":"Mã địa chỉ khách hàng"}},"customer":{"type":"object","description":"Customer information","x-description-i18n":{"vie":"Thông tin khách hàng"},"properties":{"fb_id":{"type":"string","description":"Customer Facebook ID","x-description-i18n":{"vie":"Facebook ID khách hàng"}},"id":{"type":"string","description":"Customer ID","x-description-i18n":{"vie":"Mã khách hàng"}},"name":{"type":"string","description":"Customer name","x-description-i18n":{"vie":"Tên khách hàng"}},"page_id":{"type":"string","description":"Page ID","x-description-i18n":{"vie":"Mã trang"}}}},"total_quantity":{"type":"integer","description":"Total quantity","x-description-i18n":{"vie":"Tổng số lượng"}},"time_assign_marketer":{"type":"string","format":"date-time","description":"Time assign marketer","x-description-i18n":{"vie":"Thời điểm phân công marketer"}},"p_utm_source":{"type":"string","description":"UTM Source","x-description-i18n":{"vie":"UTM Source"}},"p_utm_medium":{"type":"string","description":"UTM Medium","x-description-i18n":{"vie":"UTM Medium"}},"p_utm_campaign":{"type":"string","description":"UTM Campaign","x-description-i18n":{"vie":"UTM Campaign"}},"p_utm_term":{"type":"string","description":"UTM Term","x-description-i18n":{"vie":"UTM Term"}},"p_utm_content":{"type":"string","description":"UTM Content","x-description-i18n":{"vie":"UTM Content"}},"p_utm_id":{"type":"string","description":"UTM ID","x-description-i18n":{"vie":"UTM ID"}},"utm_affiliate":{"type":"string","description":"Affiliate","x-description-i18n":{"vie":"Affiliate"}},"link":{"type":"string","description":"Link","x-description-i18n":{"vie":"Link"}},"status_history":{"type":"array","description":"Status update history","x-description-i18n":{"vie":"Lịch sử cập nhật trạng thái"},"items":{"type":"object","properties":{"avatar_url":{"type":"string","description":"Avatar URL","x-description-i18n":{"vie":"Link avatar"}},"editor":{"type":"object","description":"Editor information","x-description-i18n":{"vie":"Thông tin người chỉnh sửa"}},"editor_fb":{"type":"string","description":"Editor Facebook ID","x-description-i18n":{"vie":"Facebook ID người chỉnh sửa"}},"editor_id":{"type":"string","description":"Editor ID","x-description-i18n":{"vie":"Mã người chỉnh sửa"}},"name":{"type":"string","description":"Name","x-description-i18n":{"vie":"Tên"}},"old_status":{"type":"integer","description":"Old status","x-description-i18n":{"vie":"Trạng thái cũ"}},"status":{"type":"integer","description":"Status","x-description-i18n":{"vie":"Trạng thái"}},"updated_at":{"type":"string","format":"date-time","description":"Updated at","x-description-i18n":{"vie":"Thời điểm cập nhật"}}}}},"duplicated_phone":{"type":"boolean","description":"Duplicated phone","x-description-i18n":{"vie":"Số điện thoại trùng lặp"}},"order_currency":{"type":"string","description":"Order currency","x-description-i18n":{"vie":"Loại tiền tệ"}},"charged_by_vnpay":{"type":"integer","description":"Charged by VNPay","x-description-i18n":{"vie":"Số tiền thanh toán qua VNPay"}},"charged_by_qrpay":{"type":"integer","description":"Charged by QRPay","x-description-i18n":{"vie":"Số tiền khách thanh toán qua QRPAY"}},"custom_id":{"type":"string","description":"Custom ID","x-description-i18n":{"vie":"Mã tùy chỉnh"}},"last_editor":{"type":"object","description":"Last editor information","x-description-i18n":{"vie":"Thông tin người chỉnh sửa cuối cùng đơn hàng"},"properties":{"id":{"type":"string","description":"Editor ID","x-description-i18n":{"vie":"Mã người chỉnh sửa"}},"fb_id":{"type":"string","description":"Facebook ID of editor","x-description-i18n":{"vie":"Facebook ID người chỉnh sửa"}},"name":{"type":"string","description":"Editor name","x-description-i18n":{"vie":"Tên người chỉnh sửa"}},"email":{"type":"string","description":"Editor email","x-description-i18n":{"vie":"Email người chỉnh sửa"}},"avatar_url":{"type":"string","description":"Editor avatar URL","x-description-i18n":{"vie":"Link avatar người chỉnh sửa"}},"phone_number":{"type":"string","description":"Editor phone number","x-description-i18n":{"vie":"Số điện thoại người chỉnh sửa"}}}},"last_editor_id":{"type":"string","description":"Last editor ID","x-description-i18n":{"vie":"Mã người sửa cuối"}},"charged_by_momo":{"type":"integer","description":"Charged by MoMo","x-description-i18n":{"vie":"Số tiền khách thanh toán qua MOMO"}},"prepaid_by_point":{"type":"object","description":"Prepaid by point","x-description-i18n":{"vie":"Thanh toán bằng điểm thưởng"},"properties":{"money":{"type":"integer","description":"Money amount","x-description-i18n":{"vie":"Số tiền"},"example":15000},"point":{"type":"integer","description":"Point amount","x-description-i18n":{"vie":"Số điểm"},"example":15}},"example":{"money":15000,"point":15}},"bank_transfer_images":{"type":"array","description":"Bank transfer images","x-description-i18n":{"vie":"Hình ảnh chuyển khoản"},"items":{"type":"string","format":"uri"}},"transfer_money":{"type":"integer","description":"Transfer money","x-description-i18n":{"vie":"Số tiền khách chuyển khoản"}},"lock_order_by_user":{"type":"string","description":"Lock order by user ID","x-description-i18n":{"vie":"Mã người dùng khóa đơn hàng"}},"assigning_care":{"type":"object","description":"Assigning care information","x-description-i18n":{"vie":"Nhân viên chăm sóc"},"properties":{"id":{"type":"string","description":"Care ID","x-description-i18n":{"vie":"Mã người chăm sóc"}},"fb_id":{"type":"string","description":"Facebook ID of care","x-description-i18n":{"vie":"Facebook ID người chăm sóc"}},"name":{"type":"string","description":"Care name","x-description-i18n":{"vie":"Tên người chăm sóc"}},"email":{"type":"string","description":"Care email","x-description-i18n":{"vie":"Email người chăm sóc"}},"avatar_url":{"type":"string","description":"Care avatar URL","x-description-i18n":{"vie":"Link avatar người chăm sóc"}},"phone_number":{"type":"string","description":"Care phone number","x-description-i18n":{"vie":"Số điện thoại người chăm sóc"}}}},"assigning_care_id":{"type":"string","description":"Assigning care ID","x-description-i18n":{"vie":"Mã nhân viên chăm sóc"}},"time_assign_care":{"type":"string","format":"date-time","description":"Time assign care","x-description-i18n":{"vie":"Thời điểm phân công chăm sóc"}},"assigning_seller":{"type":"object","description":"Assigning seller information","x-description-i18n":{"vie":"Nhân viên được phân công"},"properties":{"id":{"type":"string","description":"Seller ID","x-description-i18n":{"vie":"Mã người bán"}},"fb_id":{"type":"string","description":"Facebook ID of seller","x-description-i18n":{"vie":"Facebook ID người bán"}},"name":{"type":"string","description":"Seller name","x-description-i18n":{"vie":"Tên người bán"}},"email":{"type":"string","description":"Seller email","x-description-i18n":{"vie":"Email người bán"}},"avatar_url":{"type":"string","description":"Seller avatar URL","x-description-i18n":{"vie":"Link avatar người bán"}},"phone_number":{"type":"string","description":"Seller phone number","x-description-i18n":{"vie":"Số điện thoại người bán"}}}},"einvoices":{"type":"array","items":{"$ref":"#/components/schemas/EInvoice"}},"charged_by_card":{"type":"integer","description":"Charged by card","x-description-i18n":{"vie":"Số tiền khách quẹt thẻ"}},"estimate_delivery_date":{"type":"string","format":"date-time","description":"Estimate delivery date","x-description-i18n":{"vie":"Ngày giao hàng dự kiến"}},"order_sources":{"type":"string","description":"Order sources ID","x-description-i18n":{"vie":"Mã nguồn đơn hàng"}},"charged_by_fundiin":{"type":"integer","description":"Charged by Fundiin","x-description-i18n":{"vie":"Số tiền thanh toán qua Fundiin"}},"surcharge":{"type":"integer","description":"Surcharge","x-description-i18n":{"vie":"Phụ thu"}},"is_linked_partner":{"type":"boolean","description":"Is linked partner","x-description-i18n":{"vie":"Đã liên kết đối tác"}},"call_laters":{"type":"array","description":"Call laters","x-description-i18n":{"vie":"Gọi lại sau"},"items":{"type":"object"}},"last_update_status_at":{"type":"string","format":"date-time","description":"Last update status at","x-description-i18n":{"vie":"Thời điểm cập nhật trạng thái cuối"}},"discount_by_customer_level":{"type":"integer","description":"Discount by customer level","x-description-i18n":{"vie":"Giảm giá theo cấp độ khách hàng"}},"viewing":{"type":"array","description":"Viewing","x-description-i18n":{"vie":"NV đang xem"},"items":{"type":"object"}},"additional_info":{"type":"object","description":"Additional info","x-description-i18n":{"vie":"Thông tin bổ sung"},"properties":{"service_partner":{"type":"string","description":"Service partner","x-description-i18n":{"vie":"Dịch vụ vận chuyển"},"enum":["instant"],"x-enum-descriptions":["Instant"],"x-enum-descriptions-i18n":{"vie":["Hỏa tốc"]}},"delivery_deadline":{"type":"string","format":"date-time","description":"Delivery deadline (ISO8601, no timezone). Send null to clear.","x-description-i18n":{"vie":"Hạn giao hàng (ISO8601, không kèm timezone). Gửi null để xóa."},"example":"2026-06-03T10:00:00"}}},"order_returned_ids":{"type":"string","description":"Order returned IDs","x-description-i18n":{"vie":"Mã đơn hàng đổi trả"}},"cost_surcharge":{"type":"integer","description":"Cost surcharge","x-description-i18n":{"vie":"Phụ phí"}},"time_send_partner":{"type":"string","format":"date-time","description":"Time send partner","x-description-i18n":{"vie":"Thời điểm gửi đơn vị vận chuyển"}},"charged_by_kredivo":{"type":"integer","description":"Charged by Kredivo","x-description-i18n":{"vie":"Số tiền thanh toán qua Kredivo"}},"discount":{"type":"integer","description":"Discount","x-description-i18n":{"vie":"Giảm giá"}},"histories":{"type":"array","description":"Histories","x-description-i18n":{"vie":"Lịch sử"},"items":{"type":"object"}},"duplicated_customer":{"type":"boolean","description":"Duplicated customer","x-description-i18n":{"vie":"Khách hàng trùng lặp"}},"customer_referral_code":{"type":"object","description":"Customer referral code","x-description-i18n":{"vie":"Mã giới thiệu khách hàng"},"properties":{"active":{"type":"string","description":"Active status","x-description-i18n":{"vie":"Trạng thái kích hoạt"},"example":"true"},"customer_id":{"type":"string","format":"uuid","description":"Customer ID","x-description-i18n":{"vie":"Mã khách hàng"},"example":"09bb9399-45f3-4897-a53a-85dde2f886fe"},"discount":{"type":"string","description":"Discount value","x-description-i18n":{"vie":"Giá trị giảm giá"},"example":"10"},"format":{"type":"string","description":"Referral code format","x-description-i18n":{"vie":"Định dạng mã giới thiệu"},"example":"{PHONE_NUMBER}"},"free_products_priced_between_approx":{"type":"object","description":"Free products priced between approximately","x-description-i18n":{"vie":"Miễn phí cho khách mới sản phẩm có giá"},"properties":{"active":{"type":"string","description":"Active status","x-description-i18n":{"vie":"Trạng thái kích hoạt"},"example":"true"},"operator":{"type":"string","description":"Comparison operator","x-description-i18n":{"vie":"Toán tử so sánh"},"example":"GreaterOrEqual"},"price":{"type":"string","description":"Price threshold","x-description-i18n":{"vie":"Ngưỡng giá"},"example":"150000"}}},"is_percent":{"type":"string","description":"Discount is percentage","x-description-i18n":{"vie":"Giảm giá theo phần trăm"},"example":"true"},"only_customers_with_level_will_have_referral_code":{"type":"string","description":"Only customers with level will have referral code","x-description-i18n":{"vie":"Chỉ khách hàng có cấp độ mới có mã giới thiệu"},"example":"true"},"referral_code":{"type":"string","description":"Referral code","x-description-i18n":{"vie":"Mã giới thiệu"},"example":"982843759"},"reward_points_for_old_customers":{"type":"object","description":"Reward points for customers","x-description-i18n":{"vie":"Điểm thưởng khách hàng"},"properties":{"active":{"type":"string","description":"Active status","x-description-i18n":{"vie":"Trạng thái kích hoạt"},"example":"true"},"money":{"type":"string","description":"Money reward","x-description-i18n":{"vie":"Tiền thưởng"},"example":"10000"},"point":{"type":"string","description":"Point reward","x-description-i18n":{"vie":"Điểm thưởng"},"example":"1"}}},"shop_customer_id":{"type":"string","format":"uuid","description":"Shop customer ID","x-description-i18n":{"vie":"Mã khách hàng shop"},"example":"f8160a4c-dfa7-4ee8-b540-d245755ea1f1"}},"example":{"active":"true","customer_id":"09bb9399-45f3-4897-a53a-85dde2f886fe","discount":"10","format":"{PHONE_NUMBER}","free_products_priced_between_approx":{"active":"true","operator":"GreaterOrEqual","price":"150000"},"is_percent":"true","only_customers_with_level_will_have_referral_code":"true","referral_code":"982843759","reward_points_for_old_customers":{"active":"true","money":"10000","point":"1"},"shop_customer_id":"f8160a4c-dfa7-4ee8-b540-d245755ea1f1"}},"tax":{"type":"integer","description":"Tax","x-description-i18n":{"vie":"Thuế"}},"is_from_ecommerce":{"type":"boolean","description":"Is from e-commerce","x-description-i18n":{"vie":"Đơn hàng từ sàn thương mại điện tử"}},"note_image":{"type":"array","description":"Note images","x-description-i18n":{"vie":"Link hình ảnh ghi chú"},"items":{"type":"string","format":"uri"}},"shopify_draft_order_id":{"type":"string","description":"Shopify draft order ID","x-description-i18n":{"vie":"Mã đơn hàng nháp Shopify"}},"display_id":{"type":"integer","description":"Display ID","x-description-i18n":{"vie":"Mã hiển thị"}},"shop_partner_id":{"type":"integer","description":"Shop partner ID","x-description-i18n":{"vie":"Mã đối tác shop"}},"is_locked":{"type":"boolean","description":"Order lock","x-description-i18n":{"vie":"Khóa đơn hàng"}},"merge_order":{"type":"boolean","description":"Allows merging orders","x-description-i18n":{"vie":"Cho phép gộp đơn"}}}},"EInvoice":{"type":"object","description":"E-invoice information","x-description-i18n":{"vie":"Thông tin hóa đơn điện tử"},"properties":{"actual_shipping_fee":{"type":"integer","description":"Shipping fee","x-description-i18n":{"vie":"Phí vận chuyển"}},"adjust_amount":{"type":"integer","nullable":true,"description":"Percentage reduction on revenue","x-description-i18n":{"vie":"Phần trăm giảm trên doanh thu"}},"adjustment_criteria":{"type":"integer","nullable":true,"description":"Adjustment criteria","x-description-i18n":{"vie":"Tiêu chí điều chỉnh"},"enum":[1,2,3,4],"x-enum-descriptions":["Quantity adjustment","Price adjustment","Tax rate adjustment","Tax amount adjustment"],"x-enum-descriptions-i18n":{"vie":["Điều chỉnh số lượng","Điều chỉnh đơn giá","Điều chỉnh thuế suất","Điều chỉnh tiền thuế"]}},"adjustment_type":{"type":"integer","nullable":true,"description":"Adjustment type","x-description-i18n":{"vie":"Loại điều chỉnh"},"enum":[1,2,3],"x-enum-descriptions":["Increase adjustment","Decrease adjustment","Information"],"x-enum-descriptions-i18n":{"vie":["Điều chỉnh tăng","Điều chỉnh giảm","Thông tin"]}},"allocation_discounts":{"type":"array","description":"Allocation discounts","x-description-i18n":{"vie":"Phân bổ chiết khấu"},"items":{"type":"object"}},"allocation_type":{"type":"integer","description":"Allocation type","x-description-i18n":{"vie":"Loại phân bổ"},"enum":[1,2],"x-enum-descriptions":["By unit price","custom"],"x-enum-descriptions-i18n":{"vie":["Theo đơn giá","Tùy chỉnh"]}},"bank_account_number":{"type":"string","nullable":true,"description":"Bank account number","x-description-i18n":{"vie":"Số tài khoản ngân hàng"}},"bank_name":{"type":"string","nullable":true,"description":"Bank name","x-description-i18n":{"vie":"Tên ngân hàng"}},"budget_unit_code":{"type":"string","nullable":true,"description":"Budget unit code","x-description-i18n":{"vie":"Mã đơn vị ngân sách"}},"buyer_not_get_invoice":{"type":"boolean","description":"Buyer not get invoice","x-description-i18n":{"vie":"Người mua không nhận hóa đơn"}},"creator":{"type":"object","nullable":true,"description":"Creator information","x-description-i18n":{"vie":"Thông tin người tạo"},"properties":{"avatar_url":{"type":"string","nullable":true,"description":"Avatar URL","x-description-i18n":{"vie":"URL avatar"}},"fb_id":{"type":"string","nullable":true,"description":"Facebook ID","x-description-i18n":{"vie":"Mã Facebook"}},"id":{"type":"string","description":"Creator ID","x-description-i18n":{"vie":"Mã người tạo"}},"name":{"type":"string","description":"Creator name","x-description-i18n":{"vie":"Tên người tạo"}}}},"discount":{"type":"integer","description":"General discount amount","x-description-i18n":{"vie":"Giảm giá chung"}},"display_id":{"type":"integer","description":"Display ID","x-description-i18n":{"vie":"Mã hiển thị"}},"einvoice_account_id":{"type":"integer","nullable":true,"description":"E-invoice account ID","x-description-i18n":{"vie":"Mã tài khoản hóa đơn điện tử"}},"email":{"type":"string","description":"Email address","x-description-i18n":{"vie":"Địa chỉ email"}},"full_name":{"type":"string","description":"Buyer's name","x-description-i18n":{"vie":"Tên người mua hàng"}},"id":{"type":"integer","description":"Invoice ID","x-description-i18n":{"vie":"ID hóa đơn"}},"identity_code":{"type":"string","nullable":true,"description":"Buyer's identity code","x-description-i18n":{"vie":"Mã định danh người mua"}},"included_tax":{"type":"integer","description":"Included tax","x-description-i18n":{"vie":"Thuế đã bao gồm"}},"invoice_no":{"type":"string","description":"Invoice number","x-description-i18n":{"vie":"Số hóa đơn"}},"invoice_series":{"type":"string","description":"Invoice series","x-description-i18n":{"vie":"Ký hiệu hóa đơn"}},"invoice_type":{"type":"integer","nullable":true,"description":"Invoice type","x-description-i18n":{"vie":"Loại hóa đơn"}},"is_adjust_amount":{"type":"boolean","description":"Is adjust amount","x-description-i18n":{"vie":"Có điều chỉnh số tiền"}},"is_included_tax":{"type":"boolean","description":"Is included tax","x-description-i18n":{"vie":"Có bao gồm thuế"}},"items":{"type":"array","description":"Invoice items","x-description-i18n":{"vie":"Danh sách sản phẩm hóa đơn"},"items":{"type":"object","properties":{"adjust_amount":{"type":"integer","nullable":true,"description":"Adjust amount","x-description-i18n":{"vie":"Số tiền điều chỉnh"}},"discount":{"type":"integer","description":"Discount amount","x-description-i18n":{"vie":"Số tiền giảm giá"}},"id":{"type":"integer","description":"Item ID","x-description-i18n":{"vie":"Mã sản phẩm"}},"is_calculation_tax":{"type":"boolean","description":"Is calculation tax","x-description-i18n":{"vie":"Có tính thuế"}},"is_component":{"type":"boolean","description":"Is component","x-description-i18n":{"vie":"Là sản phẩm cấu thành"}},"is_surcharge":{"type":"boolean","nullable":true,"description":"Is surcharge","x-description-i18n":{"vie":"Là phụ phí"}},"measure":{"type":"string","nullable":true,"description":"Measure","x-description-i18n":{"vie":"Đơn vị tính"}},"note":{"type":"string","nullable":true,"description":"Note","x-description-i18n":{"vie":"Ghi chú"}},"order_id":{"type":"integer","description":"Order ID","x-description-i18n":{"vie":"Mã đơn hàng"}},"order_item_id":{"type":"integer","description":"Order item ID","x-description-i18n":{"vie":"Mã sản phẩm đơn hàng"}},"quantity":{"type":"integer","description":"Quantity","x-description-i18n":{"vie":"Số lượng"}},"retail_price":{"type":"integer","description":"Retail price","x-description-i18n":{"vie":"Giá bán"}},"tax":{"type":"integer","description":"Tax rate","x-description-i18n":{"vie":"Thuế suất"}},"type":{"type":"integer","description":"Item type","x-description-i18n":{"vie":"Loại sản phẩm"}},"variation":{"type":"object","nullable":true,"description":"Variation information","x-description-i18n":{"vie":"Thông tin biến thể"},"properties":{"custom_id":{"type":"string","nullable":true,"description":"Custom ID","x-description-i18n":{"vie":"Mã tùy chỉnh"}},"display_id":{"type":"integer","description":"Display ID","x-description-i18n":{"vie":"Mã hiển thị"}},"fields":{"type":"array","description":"Variation fields","x-description-i18n":{"vie":"Các trường biến thể"},"items":{"type":"object","properties":{"id":{"type":"string","description":"Field ID","x-description-i18n":{"vie":"Mã trường"}},"keyValue":{"type":"string","description":"Key value","x-description-i18n":{"vie":"Giá trị khóa"}},"name":{"type":"string","description":"Field name","x-description-i18n":{"vie":"Tên trường"}},"value":{"type":"string","description":"Field value","x-description-i18n":{"vie":"Giá trị trường"}}}}},"product":{"type":"object","nullable":true,"description":"Product information","x-description-i18n":{"vie":"Thông tin sản phẩm"},"properties":{"custom_id":{"type":"string","nullable":true,"description":"Product custom ID","x-description-i18n":{"vie":"Mã tùy chỉnh sản phẩm"}},"display_id":{"type":"integer","description":"Product display ID","x-description-i18n":{"vie":"Mã hiển thị sản phẩm"}},"name":{"type":"string","description":"Product name","x-description-i18n":{"vie":"Tên sản phẩm"}}}},"product_id":{"type":"string","nullable":true,"description":"Product ID","x-description-i18n":{"vie":"Mã sản phẩm"}}}},"variation_id":{"type":"string","nullable":true,"description":"Variation ID","x-description-i18n":{"vie":"Mã biến thể"}},"variation_info":{"type":"object","nullable":true,"description":"Variation information details","x-description-i18n":{"vie":"Chi tiết thông tin biến thể"},"properties":{"detail":{"type":"string","nullable":true,"description":"Variation detail","x-description-i18n":{"vie":"Chi tiết biến thể"}},"diff_discount":{"type":"integer","nullable":true,"description":"Different discount","x-description-i18n":{"vie":"Giảm giá khác biệt"}},"discount":{"type":"integer","nullable":true,"description":"Discount amount","x-description-i18n":{"vie":"Số tiền giảm giá"}},"item_total_amount_with_tax":{"type":"integer","nullable":true,"description":"Item total amount with tax","x-description-i18n":{"vie":"Tổng tiền sản phẩm có thuế"}},"item_total_amount_without_tax":{"type":"integer","nullable":true,"description":"Item total amount without tax","x-description-i18n":{"vie":"Tổng tiền sản phẩm không thuế"}},"measure_info":{"type":"string","nullable":true,"description":"Measure information","x-description-i18n":{"vie":"Thông tin đơn vị tính"}},"name":{"type":"string","nullable":true,"description":"Product name","x-description-i18n":{"vie":"Tên sản phẩm"}},"product_id":{"type":"string","nullable":true,"description":"Product ID","x-description-i18n":{"vie":"Mã sản phẩm"}},"product_tags":{"type":"array","description":"Product tags","x-description-i18n":{"vie":"Thẻ sản phẩm"},"items":{"type":"string"}},"tax_amount":{"type":"integer","nullable":true,"description":"Tax amount","x-description-i18n":{"vie":"Số tiền thuế"}},"tax_rate":{"type":"integer","nullable":true,"description":"Tax rate","x-description-i18n":{"vie":"Thuế suất"}},"unit_price":{"type":"integer","nullable":true,"description":"Unit price","x-description-i18n":{"vie":"Giá đơn vị"}}}}}}},"key_search":{"type":"string","nullable":true,"description":"Key search","x-description-i18n":{"vie":"Mã tìm kiếm"}},"last_editor_id":{"type":"string","nullable":true,"description":"Last editor ID","x-description-i18n":{"vie":"Mã người chỉnh sửa cuối"}},"note":{"type":"string","nullable":true,"description":"Note","x-description-i18n":{"vie":"Ghi chú"}},"order_id":{"type":"integer","description":"Order ID","x-description-i18n":{"vie":"Mã đơn hàng"}},"order_info":{"type":"object","nullable":true,"description":"Order information","x-description-i18n":{"vie":"Thông tin đơn hàng"},"properties":{"account":{"type":"string","nullable":true,"description":"Account","x-description-i18n":{"vie":"Tài khoản"}},"account_source":{"type":"string","nullable":true,"description":"Account source","x-description-i18n":{"vie":"Nguồn tài khoản"}},"cod":{"type":"integer","description":"COD amount","x-description-i18n":{"vie":"Số tiền COD"}},"custom_id":{"type":"string","nullable":true,"description":"Custom ID","x-description-i18n":{"vie":"Mã tùy chỉnh"}},"display_id":{"type":"integer","description":"Display ID","x-description-i18n":{"vie":"Mã hiển thị"}},"order_currency":{"type":"string","description":"Order currency","x-description-i18n":{"vie":"Loại tiền tệ đơn hàng"}},"order_sources":{"type":"string","nullable":true,"description":"Order sources","x-description-i18n":{"vie":"Nguồn đơn hàng"}},"page":{"type":"object","nullable":true,"description":"Page information","x-description-i18n":{"vie":"Thông tin trang"},"properties":{"id":{"type":"string","description":"Page ID","x-description-i18n":{"vie":"Mã trang"}},"name":{"type":"string","nullable":true,"description":"Page name","x-description-i18n":{"vie":"Tên trang"}},"username":{"type":"string","nullable":true,"description":"Username","x-description-i18n":{"vie":"Tên người dùng"}}}},"page_id":{"type":"string","nullable":true,"description":"Page ID","x-description-i18n":{"vie":"Mã trang"}},"partner":{"type":"object","nullable":true,"description":"Partner information","x-description-i18n":{"vie":"Thông tin đối tác"},"properties":{"extend_code":{"type":"string","nullable":true,"description":"Extend code","x-description-i18n":{"vie":"Mã mở rộng"}},"partner_id":{"type":"integer","description":"Partner ID","x-description-i18n":{"vie":"Mã đối tác"}}}},"shop_customer_id":{"type":"string","nullable":true,"description":"Shop customer ID","x-description-i18n":{"vie":"Mã khách hàng shop"}},"warehouse_id":{"type":"string","nullable":true,"description":"Warehouse ID","x-description-i18n":{"vie":"Mã kho"}}}},"original_einvoice":{"type":"object","nullable":true,"description":"Original e-invoice ID","x-description-i18n":{"vie":"Mã hóa đơn điện tử gốc"}},"payment_method":{"type":"string","description":"Payment method","x-description-i18n":{"vie":"Phương thức thanh toán"}},"phone_number":{"type":"string","description":"Phone number","x-description-i18n":{"vie":"Số điện thoại"}},"purchaser_tax_code":{"type":"string","nullable":true,"description":"Purchaser tax code","x-description-i18n":{"vie":"Mã số thuế người mua"}},"purchaser_unit":{"type":"string","nullable":true,"description":"Purchaser unit","x-description-i18n":{"vie":"Đơn vị tính"}},"release_date":{"type":"string","format":"date-time","nullable":true,"description":"Release date","x-description-i18n":{"vie":"Ngày phát hành"}},"release_type":{"type":"integer","nullable":true,"description":"Release type","x-description-i18n":{"vie":"Loại phát hành"}},"shipping_address":{"$ref":"#/components/schemas/ShippingAddress"},"shipping_fee":{"type":"integer","description":"Shipping fee","x-description-i18n":{"vie":"Phí vận chuyển"}},"shop_id":{"type":"integer","description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},"signature_type":{"type":"integer","description":"Signature type","x-description-i18n":{"vie":"Loại chữ ký"}},"status":{"type":"integer","description":"Status","x-description-i18n":{"vie":"Trạng thái"},"enum":[0,1,2,3,4,5,6,7],"x-enum-descriptions":["Not released","Pending release","Released","Canceled","Replacement invoice","Replaced invoice","Adjustment invoice","Adjusted"],"x-enum-descriptions-i18n":{"vie":["Chưa phát hành","Chờ phát hành","Đã phát hành","Đã hủy","Hoá đơn thay thế","Hoá đơn bị thay thế","Hoá đơn điều chỉnh","Bị điều chỉnh"]}},"tax":{"type":"integer","description":"Tax rate","x-description-i18n":{"vie":"Thuế suất"}},"template_code":{"type":"string","nullable":true,"description":"Template code","x-description-i18n":{"vie":"Mã mẫu"}},"total_amount":{"type":"integer","description":"Total amount","x-description-i18n":{"vie":"Tổng tiền"}},"verification_code":{"type":"string","nullable":true,"description":"Tax Authority Code","x-description-i18n":{"vie":"Mã cơ quan thuế"}},"voucher_book":{"type":"object","nullable":true,"description":"Voucher book","x-description-i18n":{"vie":"Mã phân loại"}}}},"ShippingAddress":{"type":"object","nullable":true,"description":"Shipping address","x-description-i18n":{"vie":"Địa chỉ giao hàng"},"properties":{"address":{"type":"string","nullable":true,"description":"Street address. When creating an order via API, if `address` is provided but `province_id` is left empty, the system automatically parses this free-text address to fill in `province_id`, `district_id` and `commune_id`. Auto-fill is skipped when the parsed location is in Thailand (country code 66) or when no commune can be resolved from the text.","x-description-i18n":{"vie":"Địa chỉ. Khi tạo đơn qua API, nếu có `address` nhưng `province_id` để trống, hệ thống sẽ tự động phân tích địa chỉ dạng văn bản này để điền `province_id`, `district_id` và `commune_id`. Bỏ qua tự động điền nếu địa chỉ thuộc Thái Lan (mã quốc gia 66) hoặc không xác định được phường/xã từ nội dung."}},"commnue_name":{"type":"string","nullable":true,"description":"Commune name","x-description-i18n":{"vie":"Tên phường/xã"}},"commune_id":{"type":"string","nullable":true,"description":"Commune ID","x-description-i18n":{"vie":"Mã phường/xã"}},"country_code":{"type":"string","nullable":true,"description":"Country code","x-description-i18n":{"vie":"Mã quốc gia"}},"district_id":{"type":"string","nullable":true,"description":"District ID","x-description-i18n":{"vie":"Mã quận/huyện"}},"district_name":{"type":"string","nullable":true,"description":"District name","x-description-i18n":{"vie":"Tên quận/huyện"}},"full_address":{"type":"string","nullable":true,"description":"Full address","x-description-i18n":{"vie":"Địa chỉ đầy đủ"}},"full_name":{"type":"string","nullable":true,"description":"Full name","x-description-i18n":{"vie":"Họ và tên"}},"new_full_address":{"type":"string","nullable":true,"description":"New full address","x-description-i18n":{"vie":"Địa chỉ đầy đủ mới"}},"new_province_id":{"type":"string","nullable":true,"description":"New province ID","x-description-i18n":{"vie":"Mã tỉnh/thành mới"}},"phone_number":{"type":"string","nullable":true,"description":"Phone number","x-description-i18n":{"vie":"Số điện thoại"}},"post_code":{"type":"string","nullable":true,"description":"Post code","x-description-i18n":{"vie":"Mã bưu điện"}},"province_id":{"type":"string","nullable":true,"description":"Province ID","x-description-i18n":{"vie":"Mã tỉnh/thành"}},"province_name":{"type":"string","nullable":true,"description":"Province name","x-description-i18n":{"vie":"Tên tỉnh/thành"}},"render_type":{"type":"string","nullable":true,"description":"Render type","x-description-i18n":{"vie":"Loại hiển thị"}}}},"ReturnOrder":{"type":"object","description":"Return order information","x-description-i18n":{"vie":"Thông tin đơn hàng đổi trả"},"properties":{"id":{"type":"integer","description":"Return order ID","x-description-i18n":{"vie":"Mã đơn hàng đổi trả"}},"display_id":{"type":"integer","description":"Display ID","x-description-i18n":{"vie":"Mã hiển thị"}},"bill_full_name":{"type":"string","description":"Customer name","x-description-i18n":{"vie":"Tên khách hàng"}},"bill_phone_number":{"type":"string","description":"Phone number of customer","x-description-i18n":{"vie":"SĐT khách hàng"}},"creator_id":{"type":"string","description":"Creator ID","x-description-i18n":{"vie":"Mã người tạo"}},"custom_id":{"type":"string","description":"Custom ID","x-description-i18n":{"vie":"Mã tùy chỉnh"}},"discount":{"type":"integer","description":"Discount total","x-description-i18n":{"vie":"Tổng giảm giá"}},"discount_from_order_to_returned":{"type":"integer","description":"Discount from order to returned","x-description-i18n":{"vie":"Giảm giá từ đơn hàng gốc"}},"inserted_at":{"type":"string","format":"date-time","description":"Created at","x-description-i18n":{"vie":"Thời điểm tạo"}},"updated_at":{"type":"string","format":"date-time","description":"Updated at","x-description-i18n":{"vie":"Thời điểm cập nhật"}},"order_id":{"type":"integer","description":"Order ID","x-description-i18n":{"vie":"Mã đơn hàng"}},"order_id_to_returned":{"type":"integer","description":"Order ID to returned","x-description-i18n":{"vie":"Mã đơn hàng cần trả"}},"order":{"type":"object","properties":{"id":{"type":"integer","description":"Order ID","x-description-i18n":{"vie":"Mã đơn hàng"}},"system_id":{"type":"integer","description":"System ID","x-description-i18n":{"vie":"Mã hệ thống"}},"shop_id":{"type":"integer","description":"Shop ID","x-description-i18n":{"vie":"Mã cửa hàng"}},"inserted_at":{"type":"string","format":"date-time","description":"Order creation time","x-description-i18n":{"vie":"Thời điểm tạo đơn"}},"updated_at":{"type":"string","format":"date-time","description":"Order update time","x-description-i18n":{"vie":"Thời điểm cập nhật đơn"}},"status":{"type":"integer","description":"Order status","x-description-i18n":{"vie":"Trạng thái đơn hàng"},"enum":[0,17,11,12,13,20,1,8,9,2,3,16,4,15,5,6,7],"x-enum-descriptions":["New","Waiting for confirmation","Restocking","Wait for printing","Printed","Purchased","Confirmed","Packaging","Waiting for pick up","Shipped","Received","Collected money","Returning","Partial return","Returned","Canceled","Deleted recently"],"x-enum-descriptions-i18n":{"vie":["Mới","Chờ xác nhận","Chờ hàng","Chờ in","Đã in","Đã đặt hàng","Đã xác nhận","Đang đóng hàng","Chờ chuyển hàng","Đã gửi hàng","Đã nhận","Đã thu tiền","Đang hoàn","Hoàn một phần","Đã hoàn","Đã hủy","Đã xóa"]}},"status_name":{"type":"string","description":"Order status name","x-description-i18n":{"vie":"Tên trạng thái đơn hàng"}},"bill_full_name":{"type":"string","description":"Customer name","x-description-i18n":{"vie":"Tên khách hàng"}},"bill_phone_number":{"type":"string","description":"Phone number of customer","x-description-i18n":{"vie":"SĐT khách hàng"}},"bill_email":{"type":"string","description":"Customer email","x-description-i18n":{"vie":"Email khách hàng"}},"conversation_id":{"type":"string","description":"Conversation ID","x-description-i18n":{"vie":"Mã hội thoại"}},"page_id":{"type":"string","description":"Facebook page ID","x-description-i18n":{"vie":"Mã Facebook page"}},"post_id":{"type":"string","description":"Post ID","x-description-i18n":{"vie":"Mã bài viết"}},"ad_id":{"type":"string","description":"Ad ID","x-description-i18n":{"vie":"Mã quảng cáo"}},"shipping_fee":{"type":"integer","description":"Shipping fee","x-description-i18n":{"vie":"Phí vận chuyển"}},"partner_fee":{"type":"integer","description":"Fee from shipping partner","x-description-i18n":{"vie":"Phí vận chuyển từ ĐVVC"}},"fee_marketplace":{"type":"integer","description":"Fees from e-commerce platforms","x-description-i18n":{"vie":"Phí sàn"}},"customer_pay_fee":{"type":"boolean","description":"Customer pay shipping fee","x-description-i18n":{"vie":"Khách trả phí ship"}},"is_free_shipping":{"type":"boolean","description":"Free shipping","x-description-i18n":{"vie":"Miễn phí vận chuyển"}},"is_livestream":{"type":"boolean","description":"Is livestream order","x-description-i18n":{"vie":"Đơn hàng từ livestream"}},"is_live_shopping":{"type":"boolean","description":"Is live shopping order","x-description-i18n":{"vie":"Đơn hàng từ live shopping"}},"is_smc":{"type":"boolean","description":"Shopping on Messenger","x-description-i18n":{"vie":"Đơn hàng từ mua sắm trên Messenger"}},"received_at_shop":{"type":"boolean","description":"true: Sales at counter, false: Sell online","x-description-i18n":{"vie":"true: Bán tại quầy, false: Bán online"}},"total_discount":{"type":"integer","description":"Discount total","x-description-i18n":{"vie":"Tổng tiền giảm giá"}},"note":{"type":"string","description":"Internal note","x-description-i18n":{"vie":"Ghi chú nội bộ"}},"note_print":{"type":"string","description":"Note for printing","x-description-i18n":{"vie":"Ghi chú đơn hàng"}},"returned_reason":{"type":"integer","description":"Return reason code (1: Customer, 2: Staff, 3: Defective product, 4: Shipping carrier, 5: Exchange). Other values are shop-defined custom reasons, see returned_reason_name for the display name","x-description-i18n":{"vie":"Mã lý do hoàn hàng (1: Do khách hàng, 2: Do nhân viên, 3: Do sản phẩm lỗi, 4: Do đơn vị vận chuyển, 5: Do đổi hàng). Mã khác là lý do tùy chỉnh theo từng shop, xem tên hiển thị tại returned_reason_name"}},"returned_reason_name":{"type":"string","description":"Return reason name","x-description-i18n":{"vie":"Tên lý do hoàn hàng"}},"sub_status":{"type":"integer","description":"Reason for delivery delay","x-description-i18n":{"vie":"Lý do delay giao hàng"}},"warehouse_id":{"type":"string","description":"Warehouse ID","x-description-i18n":{"vie":"Mã kho hàng"}},"warehouse_info":{"type":"object","description":"Warehouse information","x-description-i18n":{"vie":"Thông tin kho hàng"},"properties":{"name":{"type":"string","description":"Warehouse name","x-description-i18n":{"vie":"Tên kho hàng"}},"phone_number":{"type":"string","description":"Warehouse phone number","x-description-i18n":{"vie":"Số điện thoại kho hàng"}},"full_address":{"type":"string","description":"Warehouse full address","x-description-i18n":{"vie":"Địa chỉ đầy đủ kho hàng"}},"address":{"type":"string","description":"Warehouse address","x-description-i18n":{"vie":"Địa chỉ chi tiết kho hàng"}},"province_id":{"type":"string","description":"Province ID","x-description-i18n":{"vie":"Mã tỉnh thành phố"}},"district_id":{"type":"string","description":"District ID","x-description-i18n":{"vie":"Mã quận huyện"}},"commune_id":{"type":"string","description":"Commune ID","x-description-i18n":{"vie":"Mã phường xã"}},"affiliate_id":{"type":"string","description":"Affiliate ID","x-description-i18n":{"vie":"Mã đại lý"}},"ffm_id":{"type":"string","description":"FFM ID","x-description-i18n":{"vie":"Mã FFM"}},"has_snappy_service":{"type":"boolean","description":"Has Snappy service","x-description-i18n":{"vie":"Có dịch vụ Snappy"}},"custom_id":{"type":"string","description":"Custom ID","x-description-i18n":{"vie":"Mã tùy chỉnh"}}}},"creator_id":{"type":"string","description":"Creator ID","x-description-i18n":{"vie":"Mã người tạo"}},"creator":{"type":"object","description":"Order creator","x-description-i18n":{"vie":"Thông tin người tạo đơn"},"properties":{"id":{"type":"string","description":"Creator ID","x-description-i18n":{"vie":"Mã người tạo"}},"fb_id":{"type":"string","description":"Facebook ID of creator","x-description-i18n":{"vie":"ID facebook người tạo đơn"}},"name":{"type":"string","description":"Creator name","x-description-i18n":{"vie":"Tên người tạo đơn"}},"avatar_url":{"type":"string","description":"Creator avatar URL","x-description-i18n":{"vie":"Link avatar người tạo"}}}},"items":{"type":"array","description":"Product list. When creating or updating an order, each entry must include `variation_id` and `quantity`. `variation_info` is optional — if omitted, the backend treats it as an empty object; send it (with `retail_price`) when you need the line price to be explicit.","x-description-i18n":{"vie":"Danh sách sản phẩm. Khi tạo hoặc cập nhật đơn, mỗi phần tử cần có `variation_id` và `quantity`. `variation_info` không bắt buộc — nếu thiếu, backend coi như object rỗng; nên gửi kèm (cùng `retail_price`) khi muốn giá dòng hàng tường minh."},"items":{"type":"object","required":["variation_id","quantity"],"properties":{"product_id":{"type":"string","description":"Product ID","x-description-i18n":{"vie":"Mã sản phẩm"}},"quantity":{"type":"integer","description":"Quantity","x-description-i18n":{"vie":"Số lượng"}},"returned_count":{"type":"integer","description":"Returned count","x-description-i18n":{"vie":"Số lượng đã trả"}},"assigning_seller_id":{"type":"string","description":"Assigning seller ID","x-description-i18n":{"vie":"Mã nhân viên được phân công"}},"quantity_by_combo_products":{"type":"array","description":"Quantity by combo products","x-description-i18n":{"vie":"Số lượng theo combo sản phẩm"},"items":{"type":"object"}},"discount_each_product":{"type":"integer","description":"Discount for each product","x-description-i18n":{"vie":"Giảm giá cho từng sản phẩm"}},"is_bonus_product":{"type":"boolean","description":"Is bonus product","x-description-i18n":{"vie":"Sản phẩm tặng kèm"}},"is_discount_percent":{"type":"boolean","description":"Is discount by percent","x-description-i18n":{"vie":"Giảm giá theo phần trăm"}},"is_wholesale":{"type":"boolean","description":"Is wholesale","x-description-i18n":{"vie":"Bán sỉ"}},"is_composite":{"type":"boolean","description":"Is composite product","x-description-i18n":{"vie":"Sản phẩm composite"}},"one_time_product":{"type":"boolean","description":"One time product","x-description-i18n":{"vie":"Sản phẩm một lần"}},"note":{"type":"string","description":"Product note","x-description-i18n":{"vie":"Ghi chú sản phẩm"}},"note_product":{"type":"string","description":"Product note","x-description-i18n":{"vie":"Ghi chú sản phẩm"}},"inserted_at":{"type":"string","format":"date-time","description":"Inserted at","x-description-i18n":{"vie":"Thời điểm tạo"}},"measure_group_id":{"type":"integer","description":"Measure group ID","x-description-i18n":{"vie":"Mã nhóm đơn vị tính"}},"variation_info":{"type":"object","description":"Variation information. Optional when creating/updating an order (the backend defaults it to an empty object if omitted). Its inner fields are not individually required, but sending `retail_price` is recommended so the line price is correct.","x-description-i18n":{"vie":"Thông tin biến thể. Không bắt buộc khi tạo/cập nhật đơn (backend tự coi là object rỗng nếu thiếu). Các field bên trong không bắt buộc riêng lẻ, nhưng nên gửi `retail_price` để giá dòng hàng đúng."},"properties":{"id":{"type":"string","description":"Variation ID","x-description-i18n":{"vie":"Mã biến thể"}},"name":{"type":"string","description":"Product name","x-description-i18n":{"vie":"Tên sản phẩm"}},"product_id":{"type":"string","description":"Product ID","x-description-i18n":{"vie":"Mã sản phẩm"}},"retail_price":{"type":"integer","description":"Retail price. Not strictly required, but recommended when creating/updating an order so the line price is correct.","x-description-i18n":{"vie":"Giá bán lẻ. Không bắt buộc, nhưng nên gửi khi tạo/cập nhật đơn để giá dòng hàng chính xác."}},"detail":{"type":"string","description":"Variation detail","x-description-i18n":{"vie":"Chi tiết biến thể"}},"images":{"type":"array","description":"Variation images","x-description-i18n":{"vie":"Hình ảnh biến thể"},"items":{"type":"string","format":"uri"}},"fields":{"type":"array","description":"Variation fields","x-description-i18n":{"vie":"Thuộc tính biến thể"},"items":{"type":"object","properties":{"id":{"type":"string","description":"Field ID","x-description-i18n":{"vie":"Mã thuộc tính"}},"name":{"type":"string","description":"Field name","x-description-i18n":{"vie":"Tên thuộc tính"}},"value":{"type":"string","description":"Field value","x-description-i18n":{"vie":"Giá trị thuộc tính"}},"keyValue":{"type":"string","description":"Key value","x-description-i18n":{"vie":"Giá trị khóa"}}}}},"barcode":{"type":"string","description":"Barcode","x-description-i18n":{"vie":"Mã barcode"}},"brand_id":{"type":"string","description":"Brand ID","x-description-i18n":{"vie":"Mã thương hiệu"}},"category_ids":{"type":"array","description":"Category IDs","x-description-i18n":{"vie":"Danh sách mã danh mục"},"items":{"type":"integer"}},"display_id":{"type":"string","description":"Display ID","x-description-i18n":{"vie":"Mã hiển thị"}},"product_display_id":{"type":"string","description":"Product display ID","x-description-i18n":{"vie":"Mã hiển thị sản phẩm"}},"last_imported_price":{"type":"integer","description":"Last imported price","x-description-i18n":{"vie":"Giá nhập hàng cuối"}},"is_upsale_product":{"type":"boolean","description":"Upsale product","x-description-i18n":{"vie":"Sản phẩm upsale"}},"weight":{"type":"integer","description":"Weight","x-description-i18n":{"vie":"Khối lượng"}},"measure_info":{"type":"object","description":"Measure information","x-description-i18n":{"vie":"Thông tin đơn vị tính"},"properties":{"measure_id":{"type":"integer","description":"Measure ID","x-description-i18n":{"vie":"Mã đơn vị tính"}},"exchange_value":{"type":"integer","description":"Exchange value","x-description-i18n":{"vie":"Giá trị quy đổi"}}}},"avg_price":{"type":"integer","description":"Average import price","x-description-i18n":{"vie":"Giá nhập trung bình"}}}},"components":{"type":"array","description":"Product components","x-description-i18n":{"vie":"Thành phần sản phẩm"},"items":{"type":"object","properties":{"component_id":{"type":"string","description":"Component ID","x-description-i18n":{"vie":"Mã thành phần"}},"quantity":{"type":"integer","description":"Quantity","x-description-i18n":{"vie":"Số lượng"}},"variation_id":{"type":"string","description":"Variation ID","x-description-i18n":{"vie":"Mã biến thể"}},"variation_info":{"type":"object","description":"Variation information","x-description-i18n":{"vie":"Thông tin biến thể"}}}}},"id":{"type":"integer","description":"Item ID","x-description-i18n":{"vie":"Mã sản phẩm trong đơn"}},"variation_id":{"type":"string","description":"Variation ID","x-description-i18n":{"vie":"Mã biến thể"}}}}},"partner":{"type":"object","description":"Partner information","x-description-i18n":{"vie":"Thông tin đơn vị vận chuyển"},"properties":{"partner_id":{"type":"integer","description":"Partner ID","x-description-i18n":{"vie":"ID đơn vị vận chuyển trên hệ thống Pancake"}},"cod":{"type":"integer","description":"Reconciliation COD","x-description-i18n":{"vie":"Đối soát tiền thu hộ"}},"extend_code":{"type":"string","description":"Shipping order ID on partner system","x-description-i18n":{"vie":"Mã vận đơn"}},"total_fee":{"type":"integer","description":"Total fee","x-description-i18n":{"vie":"Tổng phí"}},"updated_at":{"type":"string","format":"date-time","description":"Updated at","x-description-i18n":{"vie":"Thời điểm cập nhật"}},"delivery_name":{"type":"string","description":"Shipper name","x-description-i18n":{"vie":"Tên người giao hàng"}},"delivery_tel":{"type":"string","description":"Delivery phone","x-description-i18n":{"vie":"Số điện thoại người giao hàng"}},"picked_up_at":{"type":"string","format":"date-time","description":"Picked up at","x-description-i18n":{"vie":"Thời điểm lấy hàng"}},"sort_code":{"type":"string","description":"Sort code","x-description-i18n":{"vie":"Mã phân loại"}},"paid_at":{"type":"string","format":"date-time","description":"Paid at","x-description-i18n":{"vie":"Thời điểm thanh toán"}},"system_created":{"type":"boolean","description":"System created","x-description-i18n":{"vie":"Được tạo bởi hệ thống"}},"extend_update":{"type":"array","description":"Update from courier","x-description-i18n":{"vie":"Cập nhật từ đơn vị vận chuyển"},"items":{"type":"object","properties":{"key":{"type":"string","description":"Update key","x-description-i18n":{"vie":"Mã cập nhật"}},"status":{"type":"string","description":"Status","x-description-i18n":{"vie":"Trạng thái"}},"tracking_id":{"type":"string","description":"Partner extend code","x-description-i18n":{"vie":"Mã đơn hàng đối tác"}},"note":{"type":"string","description":"Courier notes","x-description-i18n":{"vie":"Ghi chú từ đơn vị vận chuyển"}},"update_at":{"type":"string","format":"date-time","description":"Updated at","x-description-i18n":{"vie":"Thời điểm cập nhật"}}}}},"partner_status":{"type":"string","nullable":true,"description":"Partner shipping status","x-description-i18n":{"vie":"Trạng thái vận chuyển"},"enum":["waiting","request_received","processing_picked_up","picking_up","delay_pickup","picked_up","waiting_on_the_way","on_the_way","contact_delivery_company","out_for_delivery","delay_delivery","inform_recipient","undeliverable","waiting_for_return","delivered","delivered_cod","returning","returned","returned_cod","canceled"],"x-enum-descriptions":["Waiting for processing","Carrier received the request","Processing pickup","Picking up","Delayed pickup","Picked up","Waiting for transit","In transit","Contact the carrier","Out for delivery","Delayed delivery","Notify the recipient","Undeliverable","Waiting for return","Delivered","Delivered, COD reconciled","Returning","Returned","Returned, COD reconciled","Canceled"],"x-enum-descriptions-i18n":{"vie":["Chờ xử lý","ĐVVC đã tiếp nhận đơn","Đang xử lý lấy hàng","Đang lấy hàng","Trễ lấy hàng","Đã lấy hàng","Chờ trung chuyển","Đang trung chuyển","Liên hệ ĐVVC","Đang giao hàng","Trễ giao hàng","Thông báo cho người nhận","Giao không thành","Chờ chuyển hoàn","Đã giao hàng","Đã giao hàng, đã đối soát COD","Đang chuyển hoàn","Đã chuyển hoàn","Đã chuyển hoàn, đã đối soát COD","Đã hủy vận đơn"]}},"partner_name":{"type":"string","nullable":true,"description":"Partner name","x-description-i18n":{"vie":"Tên đơn vị vận chuyển"}},"first_delivery_at":{"type":"string","format":"date-time","nullable":true,"description":"First delivery time","x-description-i18n":{"vie":"Thời điểm giao hàng lần đầu"}},"first_undeliverable_at":{"type":"string","format":"date-time","nullable":true,"description":"First failed delivery time","x-description-i18n":{"vie":"Thời điểm giao hàng thất bại lần đầu"}},"order_number_vtp":{"type":"string","nullable":true,"description":"Viettel Post tracking number","x-description-i18n":{"vie":"Mã vận đơn Viettel Post"}},"printed_form":{"type":"object","nullable":true,"description":"Printed form","x-description-i18n":{"vie":"Mẫu in"}}}},"shipping_address":{"$ref":"#/components/schemas/ShippingAddress"},"payment_purchase_histories":{"type":"array","description":"Payment histories","x-description-i18n":{"vie":"Lịch sử thanh toán"},"items":{"type":"object","properties":{"amount":{"type":"integer","description":"Amount of money","x-description-i18n":{"vie":"Số tiền"}},"type":{"type":"string","description":"Payment type","x-description-i18n":{"vie":"Loại thanh toán"}},"inserted_at":{"type":"string","format":"date-time","description":"Transaction time","x-description-i18n":{"vie":"Thời điểm giao dịch"}},"result_code":{"type":"string","description":"Result code","x-description-i18n":{"vie":"Mã kết quả"}},"ipn_reply":{"type":"boolean","description":"IPN reply","x-description-i18n":{"vie":"Phản hồi IPN"}},"voucher_amount":{"type":"integer","description":"Voucher amount","x-description-i18n":{"vie":"Số tiền voucher"}},"tags":{"type":"array","description":"Tags","x-description-i18n":{"vie":"Thẻ"},"items":{"type":"string"}}}}},"tags":{"type":"array","description":"Tags list","x-description-i18n":{"vie":"Danh sách thẻ đơn hàng"},"items":{"type":"object","properties":{"id":{"type":"integer","description":"Tag ID","x-description-i18n":{"vie":"Mã thẻ đơn hàng"}},"name":{"type":"string","description":"Tag name","x-description-i18n":{"vie":"Tên thẻ đơn hàng"}}}}},"marketer":{"type":"object","description":"Marketer information","x-description-i18n":{"vie":"Thông tin marketer"},"properties":{"id":{"type":"string","description":"Marketer ID","x-description-i18n":{"vie":"Mã marketer"}},"name":{"type":"string","description":"Marketer name","x-description-i18n":{"vie":"Tên marketer"}},"email":{"type":"string","description":"Marketer email","x-description-i18n":{"vie":"Email marketer"}},"phone_number":{"type":"string","description":"Marketer phone number","x-description-i18n":{"vie":"Số điện thoại marketer"}},"fb_id":{"type":"string","description":"Marketer Facebook ID","x-description-i18n":{"vie":"Facebook ID marketer"}},"avatar_url":{"type":"string","description":"Marketer avatar URL","x-description-i18n":{"vie":"Link avatar marketer"}}}},"pke_mkter":{"type":"string","description":"Marketer ID","x-description-i18n":{"vie":"Mã nhân viên marketer"}},"activated_combo_products":{"type":"object","description":"Activated combo products information","x-description-i18n":{"vie":"Thông tin combo sản phẩm được kích hoạt"},"properties":{"combo_product_id":{"type":"integer","description":"Combo product ID","x-description-i18n":{"vie":"Mã combo sản phẩm"}},"quantity_combo_activated":{"type":"integer","description":"Quantity combo activated","x-description-i18n":{"vie":"Số lượng combo được kích hoạt"}},"combo_product_info":{"type":"object","description":"Combo product information","x-description-i18n":{"vie":"Thông tin combo sản phẩm"}}}},"activated_promotion_advances":{"type":"array","description":"Activated promotion advances information","x-description-i18n":{"vie":"Thông tin khuyến mãi được kích hoạt"},"items":{"type":"object","properties":{"id":{"type":"integer","description":"ID","x-description-i18n":{"vie":"Mã"}},"promotion_advance_id":{"type":"string","description":"Promotion advance ID","x-description-i18n":{"vie":"Mã khuyến mãi"}},"promotion_advance_info":{"type":"object","description":"Promotion advance information","x-description-i18n":{"vie":"Thông tin khuyến mãi"}}}}},"invoice_info_list":{"type":"array","description":"Invoice information list","x-description-i18n":{"vie":"Danh sách thông tin hóa đơn"},"items":{"type":"object","properties":{"error":{"type":"string","description":"Error message if any","x-description-i18n":{"vie":"Thông báo lỗi nếu có"}},"invoice_detail":{"type":"object","description":"Invoice detail information","x-description-i18n":{"vie":"Chi tiết thông tin hóa đơn"},"properties":{"company_address":{"type":"string","description":"Company address","x-description-i18n":{"vie":"Địa chỉ công ty"}},"company_address_breakdown":{"type":"object","description":"Company address breakdown","x-description-i18n":{"vie":"Chi tiết địa chỉ công ty"},"properties":{"company_additional_info":{"type":"string","description":"Company additional information","x-description-i18n":{"vie":"Thông tin bổ sung công ty"}},"company_barangay":{"type":"string","description":"Company barangay","x-description-i18n":{"vie":"Phường/xã công ty"}},"company_city":{"type":"string","description":"Company city","x-description-i18n":{"vie":"Thành phố công ty"}},"company_detailed_address":{"type":"string","description":"Company detailed address","x-description-i18n":{"vie":"Địa chỉ chi tiết công ty"}},"company_district":{"type":"string","description":"Company district","x-description-i18n":{"vie":"Quận/huyện công ty"}},"company_full_address":{"type":"string","description":"Company full address","x-description-i18n":{"vie":"Địa chỉ đầy đủ công ty"}},"company_postcode":{"type":"string","description":"Company postcode","x-description-i18n":{"vie":"Mã bưu điện công ty"}},"company_province":{"type":"string","description":"Company province","x-description-i18n":{"vie":"Tỉnh công ty"}},"company_region":{"type":"string","description":"Company region","x-description-i18n":{"vie":"Vùng/khu vực công ty"}},"company_state":{"type":"string","description":"Company state","x-description-i18n":{"vie":"Bang/tỉnh công ty"}},"company_town":{"type":"string","description":"Company town","x-description-i18n":{"vie":"Thị trấn/phường công ty"}}}},"company_email":{"type":"string","description":"Company email","x-description-i18n":{"vie":"Email công ty"}},"company_name":{"type":"string","description":"Company name","x-description-i18n":{"vie":"Tên công ty"}},"company_tax_id":{"type":"string","description":"Company tax ID","x-description-i18n":{"vie":"Mã số thuế công ty"}}}},"invoice_type":{"type":"string","description":"Invoice type","x-description-i18n":{"vie":"Loại hóa đơn"}},"is_requested":{"type":"boolean","description":"Request for invoice","x-description-i18n":{"vie":"Yêu cầu xuất hóa đơn"}},"order_sn":{"type":"string","description":"Order code on the marketplace","x-description-i18n":{"vie":"Mã đơn hàng trên sàn"}}}}},"reports_by_phone":{"type":"object","description":"Reports by phone number","x-description-i18n":{"vie":"Báo cáo theo số điện thoại"},"properties":{"order_fail":{"type":"integer","description":"Number of failed orders","x-description-i18n":{"vie":"Số đơn thất bại"}},"order_success":{"type":"integer","description":"Number of successful orders","x-description-i18n":{"vie":"Số đơn thành công"}},"warning":{"type":"integer","description":"Number of warnings orders","x-description-i18n":{"vie":"Số đơn cảnh báo"}}},"example":{"+639175706297":{"order_fail":29,"order_success":20,"warning":0}}},"tracking_link":{"type":"string","description":"Link confirm order","x-description-i18n":{"vie":"Link xác nhận đơn hàng"}},"ads_source":{"type":"string","description":"Advertising source","x-description-i18n":{"vie":"Nguồn quảng cáo"}},"bank_payments":{"type":"object","description":"Payment method","x-description-i18n":{"vie":"Phương thức thanh toán"}},"transfer_proofs":{"type":"array","description":"Bank transfer payment proofs, including verification time, amount and receipt images","x-description-i18n":{"vie":"Danh sách chứng từ xác thực chuyển khoản, gồm ngày giờ xác thực, số tiền và ảnh chứng từ"},"items":{"type":"object","properties":{"id":{"type":"integer","description":"Transfer proof ID","x-description-i18n":{"vie":"Mã chứng từ chuyển khoản"}},"order_id":{"type":"integer","description":"Order ID","x-description-i18n":{"vie":"Mã đơn hàng"}},"shop_id":{"type":"integer","description":"Shop ID","x-description-i18n":{"vie":"Mã cửa hàng"}},"payment_id":{"type":"string","description":"Bank payment method ID (matches a key in `bank_payments`)","x-description-i18n":{"vie":"Mã phương thức thanh toán ngân hàng (trùng với key trong `bank_payments`)"}},"amount":{"type":"integer","description":"Transferred amount","x-description-i18n":{"vie":"Số tiền chuyển khoản"}},"images":{"type":"array","description":"Transfer receipt images","x-description-i18n":{"vie":"Danh sách ảnh chứng từ chuyển khoản"},"items":{"type":"string"}},"note":{"type":"string","nullable":true,"description":"Note","x-description-i18n":{"vie":"Ghi chú"}},"is_income":{"type":"boolean","description":"Money received (true) or paid out (false)","x-description-i18n":{"vie":"Là khoản tiền nhận vào (true) hay chi ra (false)"}},"is_verify":{"type":"boolean","description":"Whether the transfer has been verified","x-description-i18n":{"vie":"Chứng từ đã được xác thực hay chưa"}},"verify_at":{"type":"string","format":"date-time","nullable":true,"description":"Verification time","x-description-i18n":{"vie":"Thời điểm xác thực chuyển khoản"}},"verifier":{"type":"object","nullable":true,"description":"Verifier information","x-description-i18n":{"vie":"Thông tin người xác thực"},"properties":{"id":{"type":"string","description":"Verifier ID","x-description-i18n":{"vie":"Mã người xác thực"}},"name":{"type":"string","description":"Verifier name","x-description-i18n":{"vie":"Tên người xác thực"}},"fb_id":{"type":"string","description":"Facebook ID of verifier","x-description-i18n":{"vie":"Facebook ID người xác thực"}},"avatar_url":{"type":"string","description":"Verifier avatar URL","x-description-i18n":{"vie":"Link avatar người xác thực"}}}},"creator":{"type":"object","nullable":true,"description":"Creator information","x-description-i18n":{"vie":"Thông tin người tạo chứng từ"},"properties":{"id":{"type":"string","description":"Creator ID","x-description-i18n":{"vie":"Mã người tạo"}},"name":{"type":"string","description":"Creator name","x-description-i18n":{"vie":"Tên người tạo"}},"fb_id":{"type":"string","description":"Facebook ID of creator","x-description-i18n":{"vie":"Facebook ID người tạo"}},"avatar_url":{"type":"string","description":"Creator avatar URL","x-description-i18n":{"vie":"Link avatar người tạo"}}}},"last_editor":{"type":"object","nullable":true,"description":"Last editor information","x-description-i18n":{"vie":"Thông tin người chỉnh sửa cuối"},"properties":{"id":{"type":"string","description":"Editor ID","x-description-i18n":{"vie":"Mã người chỉnh sửa"}},"name":{"type":"string","description":"Editor name","x-description-i18n":{"vie":"Tên người chỉnh sửa"}},"fb_id":{"type":"string","description":"Facebook ID of editor","x-description-i18n":{"vie":"Facebook ID người chỉnh sửa"}},"avatar_url":{"type":"string","description":"Editor avatar URL","x-description-i18n":{"vie":"Link avatar người chỉnh sửa"}}}},"order_info":{"type":"object","nullable":true,"description":"Additional order information","x-description-i18n":{"vie":"Thông tin đơn hàng bổ sung"}},"inserted_at":{"type":"string","format":"date-time","description":"Transfer proof creation time","x-description-i18n":{"vie":"Thời điểm tạo chứng từ"}},"updated_at":{"type":"string","format":"date-time","description":"Transfer proof update time","x-description-i18n":{"vie":"Thời điểm cập nhật chứng từ"}}}}},"shopify_order_id":{"type":"string","description":"Shopify order ID","x-description-i18n":{"vie":"Mã đơn hàng Shopify"}},"shopify_abandon_checkout_id":{"type":"integer","description":"Shopify abandon checkout ID","x-description-i18n":{"vie":"Mã Shopify abandon checkout"}},"is_abandoned_order":{"type":"boolean","description":"Abandoned-cart flag for creating or updating an order. Send it directly in the request body, not inside `third_party` or `third_party_infomation`.\nAn explicit value, including `false`, takes precedence over automatic detection. If omitted on creation, the flag is determined automatically; if omitted on update, the current value is preserved.\nOnly boolean `true` or string `\"true\"` is normalized to `true`; all other submitted values become `false`.\n","x-description-i18n":{"vie":"Cờ đơn chưa hoàn tất khi tạo hoặc cập nhật đơn. Truyền trực tiếp trong body, không bọc trong `third_party` hoặc `third_party_infomation`.\nGiá trị truyền lên, kể cả `false`, được ưu tiên hơn kết quả nhận diện tự động. Nếu bỏ qua khi tạo đơn, cờ được xác định tự động; nếu bỏ qua khi cập nhật, giữ nguyên giá trị hiện tại.\nChỉ boolean `true` hoặc chuỗi `\"true\"` được chuẩn hóa thành `true`; mọi giá trị khác được gửi lên đều thành `false`.\n"},"example":true},"cod":{"type":"integer","description":"Cash on delivery","x-description-i18n":{"vie":"Tiền thu hộ"}},"cash":{"type":"integer","description":"Cash payment","x-description-i18n":{"vie":"Tiền mặt"}},"account":{"type":"integer","description":"Order source ID","x-description-i18n":{"vie":"Mã nguồn đơn hàng"}},"account_name":{"type":"string","description":"Order source name","x-description-i18n":{"vie":"Tên mã nguồn đơn"}},"advanced_platform_fee":{"type":"object","description":"Fees from e-commerce platforms","x-description-i18n":{"vie":"Phí từ sàn thương mại điện tử"},"properties":{"ads_top_up":{"type":"integer","description":"Ads wallet top-up","x-description-i18n":{"vie":"Ví quảng cáo"}},"affiliate_commission":{"type":"integer","description":"Affiliate commission","x-description-i18n":{"vie":"Phí hoa hồng (Sàn TMĐT)"}},"diff_shipping_fee":{"type":"integer","description":"Difference shipping fee","x-description-i18n":{"vie":"Chênh lệch phí vận chuyển (Sàn TMĐT)"}},"marketplace_voucher":{"type":"integer","description":"Marketplace voucher","x-description-i18n":{"vie":"Sàn trợ giá"}},"payment_fee":{"type":"integer","description":"Payment fee","x-description-i18n":{"vie":"Phí cố định, giao dịch (Sàn TMĐT)"}},"platform_commission":{"type":"integer","description":"Platform commission","x-description-i18n":{"vie":"Phí hoa hồng nền tảng (Sàn TMĐT)"}},"seller_transaction_fee":{"type":"integer","description":"Seller transaction fee","x-description-i18n":{"vie":"Phí thanh toán (Sàn TMĐT)"}},"service_fee":{"type":"integer","description":"Service fee","x-description-i18n":{"vie":"Phí dịch vụ (Sàn TMĐT)"}},"sfp_service_fee":{"type":"integer","description":"SFP service fee","x-description-i18n":{"vie":"Phí dịch vụ SFP (Sàn TMĐT)"}}}},"printing_count":{"type":"integer","description":"Printing count","x-description-i18n":{"vie":"Số lần in"}},"money_to_collect":{"type":"integer","description":"Money to collect","x-description-i18n":{"vie":"Số tiền cần thu"}},"marketplace_id":{"type":"string","description":"Marketplace ID","enum":["-2","-3","-4","-9","-16","-17","-20","-25","-27","-28"],"x-enum-descriptions":{"-2":"Tiki","-3":"Shopee","-4":"Lazada","-9":"TikTok","-16":"WooCommerce","-17":"Shopify","-20":"Line Shopping","-25":"Tokopedia","-27":"Mercado Libre","-28":"Tiendanube"},"x-description-i18n":{"vie":"Mã sàn thương mại điện tử"}},"total_price":{"type":"integer","description":"Total price","x-description-i18n":{"vie":"Tổng giá trị sản phẩm"}},"shop_customer_address_id":{"type":"string","description":"Customer address ID","x-description-i18n":{"vie":"Mã địa chỉ khách hàng"}},"customer":{"type":"object","description":"Customer information","x-description-i18n":{"vie":"Thông tin khách hàng"},"properties":{"fb_id":{"type":"string","description":"Customer Facebook ID","x-description-i18n":{"vie":"Facebook ID khách hàng"}},"id":{"type":"string","description":"Customer ID","x-description-i18n":{"vie":"Mã khách hàng"}},"name":{"type":"string","description":"Customer name","x-description-i18n":{"vie":"Tên khách hàng"}},"page_id":{"type":"string","description":"Page ID","x-description-i18n":{"vie":"Mã trang"}}}},"total_quantity":{"type":"integer","description":"Total quantity","x-description-i18n":{"vie":"Tổng số lượng"}},"time_assign_marketer":{"type":"string","format":"date-time","description":"Time assign marketer","x-description-i18n":{"vie":"Thời điểm phân công marketer"}},"p_utm_source":{"type":"string","description":"UTM Source","x-description-i18n":{"vie":"UTM Source"}},"p_utm_medium":{"type":"string","description":"UTM Medium","x-description-i18n":{"vie":"UTM Medium"}},"p_utm_campaign":{"type":"string","description":"UTM Campaign","x-description-i18n":{"vie":"UTM Campaign"}},"p_utm_term":{"type":"string","description":"UTM Term","x-description-i18n":{"vie":"UTM Term"}},"p_utm_content":{"type":"string","description":"UTM Content","x-description-i18n":{"vie":"UTM Content"}},"p_utm_id":{"type":"string","description":"UTM ID","x-description-i18n":{"vie":"UTM ID"}},"utm_affiliate":{"type":"string","description":"Affiliate","x-description-i18n":{"vie":"Affiliate"}},"link":{"type":"string","description":"Link","x-description-i18n":{"vie":"Link"}},"status_history":{"type":"array","description":"Status update history","x-description-i18n":{"vie":"Lịch sử cập nhật trạng thái"},"items":{"type":"object","properties":{"avatar_url":{"type":"string","description":"Avatar URL","x-description-i18n":{"vie":"Link avatar"}},"editor":{"type":"object","description":"Editor information","x-description-i18n":{"vie":"Thông tin người chỉnh sửa"}},"editor_fb":{"type":"string","description":"Editor Facebook ID","x-description-i18n":{"vie":"Facebook ID người chỉnh sửa"}},"editor_id":{"type":"string","description":"Editor ID","x-description-i18n":{"vie":"Mã người chỉnh sửa"}},"name":{"type":"string","description":"Name","x-description-i18n":{"vie":"Tên"}},"old_status":{"type":"integer","description":"Old status","x-description-i18n":{"vie":"Trạng thái cũ"}},"status":{"type":"integer","description":"Status","x-description-i18n":{"vie":"Trạng thái"}},"updated_at":{"type":"string","format":"date-time","description":"Updated at","x-description-i18n":{"vie":"Thời điểm cập nhật"}}}}},"duplicated_phone":{"type":"boolean","description":"Duplicated phone","x-description-i18n":{"vie":"Số điện thoại trùng lặp"}},"order_currency":{"type":"string","description":"Order currency","x-description-i18n":{"vie":"Loại tiền tệ"}},"charged_by_vnpay":{"type":"integer","description":"Charged by VNPay","x-description-i18n":{"vie":"Số tiền thanh toán qua VNPay"}},"charged_by_qrpay":{"type":"integer","description":"Charged by QRPay","x-description-i18n":{"vie":"Số tiền khách thanh toán qua QRPAY"}},"custom_id":{"type":"string","description":"Custom ID","x-description-i18n":{"vie":"Mã tùy chỉnh"}},"last_editor":{"type":"object","description":"Last editor information","x-description-i18n":{"vie":"Thông tin người chỉnh sửa cuối cùng đơn hàng"},"properties":{"id":{"type":"string","description":"Editor ID","x-description-i18n":{"vie":"Mã người chỉnh sửa"}},"fb_id":{"type":"string","description":"Facebook ID of editor","x-description-i18n":{"vie":"Facebook ID người chỉnh sửa"}},"name":{"type":"string","description":"Editor name","x-description-i18n":{"vie":"Tên người chỉnh sửa"}},"email":{"type":"string","description":"Editor email","x-description-i18n":{"vie":"Email người chỉnh sửa"}},"avatar_url":{"type":"string","description":"Editor avatar URL","x-description-i18n":{"vie":"Link avatar người chỉnh sửa"}},"phone_number":{"type":"string","description":"Editor phone number","x-description-i18n":{"vie":"Số điện thoại người chỉnh sửa"}}}},"last_editor_id":{"type":"string","description":"Last editor ID","x-description-i18n":{"vie":"Mã người sửa cuối"}},"charged_by_momo":{"type":"integer","description":"Charged by MoMo","x-description-i18n":{"vie":"Số tiền khách thanh toán qua MOMO"}},"prepaid_by_point":{"type":"object","description":"Prepaid by point","x-description-i18n":{"vie":"Thanh toán bằng điểm thưởng"},"properties":{"money":{"type":"integer","description":"Money amount","x-description-i18n":{"vie":"Số tiền"},"example":15000},"point":{"type":"integer","description":"Point amount","x-description-i18n":{"vie":"Số điểm"},"example":15}},"example":{"money":15000,"point":15}},"bank_transfer_images":{"type":"array","description":"Bank transfer images","x-description-i18n":{"vie":"Hình ảnh chuyển khoản"},"items":{"type":"string","format":"uri"}},"transfer_money":{"type":"integer","description":"Transfer money","x-description-i18n":{"vie":"Số tiền khách chuyển khoản"}},"lock_order_by_user":{"type":"string","description":"Lock order by user ID","x-description-i18n":{"vie":"Mã người dùng khóa đơn hàng"}},"assigning_care":{"type":"object","description":"Assigning care information","x-description-i18n":{"vie":"Nhân viên chăm sóc"},"properties":{"id":{"type":"string","description":"Care ID","x-description-i18n":{"vie":"Mã người chăm sóc"}},"fb_id":{"type":"string","description":"Facebook ID of care","x-description-i18n":{"vie":"Facebook ID người chăm sóc"}},"name":{"type":"string","description":"Care name","x-description-i18n":{"vie":"Tên người chăm sóc"}},"email":{"type":"string","description":"Care email","x-description-i18n":{"vie":"Email người chăm sóc"}},"avatar_url":{"type":"string","description":"Care avatar URL","x-description-i18n":{"vie":"Link avatar người chăm sóc"}},"phone_number":{"type":"string","description":"Care phone number","x-description-i18n":{"vie":"Số điện thoại người chăm sóc"}}}},"assigning_care_id":{"type":"string","description":"Assigning care ID","x-description-i18n":{"vie":"Mã nhân viên chăm sóc"}},"time_assign_care":{"type":"string","format":"date-time","description":"Time assign care","x-description-i18n":{"vie":"Thời điểm phân công chăm sóc"}},"assigning_seller":{"type":"object","description":"Assigning seller information","x-description-i18n":{"vie":"Nhân viên được phân công"},"properties":{"id":{"type":"string","description":"Seller ID","x-description-i18n":{"vie":"Mã người bán"}},"fb_id":{"type":"string","description":"Facebook ID of seller","x-description-i18n":{"vie":"Facebook ID người bán"}},"name":{"type":"string","description":"Seller name","x-description-i18n":{"vie":"Tên người bán"}},"email":{"type":"string","description":"Seller email","x-description-i18n":{"vie":"Email người bán"}},"avatar_url":{"type":"string","description":"Seller avatar URL","x-description-i18n":{"vie":"Link avatar người bán"}},"phone_number":{"type":"string","description":"Seller phone number","x-description-i18n":{"vie":"Số điện thoại người bán"}}}},"einvoices":{"type":"array","items":{"$ref":"#/components/schemas/EInvoice"}},"charged_by_card":{"type":"integer","description":"Charged by card","x-description-i18n":{"vie":"Số tiền khách quẹt thẻ"}},"estimate_delivery_date":{"type":"string","format":"date-time","description":"Estimate delivery date","x-description-i18n":{"vie":"Ngày giao hàng dự kiến"}},"order_sources":{"type":"string","description":"Order sources ID","x-description-i18n":{"vie":"Mã nguồn đơn hàng"}},"charged_by_fundiin":{"type":"integer","description":"Charged by Fundiin","x-description-i18n":{"vie":"Số tiền thanh toán qua Fundiin"}},"surcharge":{"type":"integer","description":"Surcharge","x-description-i18n":{"vie":"Phụ thu"}},"is_linked_partner":{"type":"boolean","description":"Is linked partner","x-description-i18n":{"vie":"Đã liên kết đối tác"}},"call_laters":{"type":"array","description":"Call laters","x-description-i18n":{"vie":"Gọi lại sau"},"items":{"type":"object"}},"last_update_status_at":{"type":"string","format":"date-time","description":"Last update status at","x-description-i18n":{"vie":"Thời điểm cập nhật trạng thái cuối"}},"discount_by_customer_level":{"type":"integer","description":"Discount by customer level","x-description-i18n":{"vie":"Giảm giá theo cấp độ khách hàng"}},"viewing":{"type":"array","description":"Viewing","x-description-i18n":{"vie":"NV đang xem"},"items":{"type":"object"}},"additional_info":{"type":"object","description":"Additional info","x-description-i18n":{"vie":"Thông tin bổ sung"},"properties":{"service_partner":{"type":"string","description":"Service partner","x-description-i18n":{"vie":"Dịch vụ vận chuyển"},"enum":["instant"],"x-enum-descriptions":["Instant"],"x-enum-descriptions-i18n":{"vie":["Hỏa tốc"]}},"delivery_deadline":{"type":"string","format":"date-time","description":"Delivery deadline (ISO8601, no timezone). Send null to clear.","x-description-i18n":{"vie":"Hạn giao hàng (ISO8601, không kèm timezone). Gửi null để xóa."},"example":"2026-06-03T10:00:00"}}},"order_returned_ids":{"type":"string","description":"Order returned IDs","x-description-i18n":{"vie":"Mã đơn hàng đổi trả"}},"cost_surcharge":{"type":"integer","description":"Cost surcharge","x-description-i18n":{"vie":"Phụ phí"}},"time_send_partner":{"type":"string","format":"date-time","description":"Time send partner","x-description-i18n":{"vie":"Thời điểm gửi đơn vị vận chuyển"}},"charged_by_kredivo":{"type":"integer","description":"Charged by Kredivo","x-description-i18n":{"vie":"Số tiền thanh toán qua Kredivo"}},"discount":{"type":"integer","description":"Discount","x-description-i18n":{"vie":"Giảm giá"}},"histories":{"type":"array","description":"Histories","x-description-i18n":{"vie":"Lịch sử"},"items":{"type":"object"}},"duplicated_customer":{"type":"boolean","description":"Duplicated customer","x-description-i18n":{"vie":"Khách hàng trùng lặp"}},"customer_referral_code":{"type":"object","description":"Customer referral code","x-description-i18n":{"vie":"Mã giới thiệu khách hàng"},"properties":{"active":{"type":"string","description":"Active status","x-description-i18n":{"vie":"Trạng thái kích hoạt"},"example":"true"},"customer_id":{"type":"string","format":"uuid","description":"Customer ID","x-description-i18n":{"vie":"Mã khách hàng"},"example":"09bb9399-45f3-4897-a53a-85dde2f886fe"},"discount":{"type":"string","description":"Discount value","x-description-i18n":{"vie":"Giá trị giảm giá"},"example":"10"},"format":{"type":"string","description":"Referral code format","x-description-i18n":{"vie":"Định dạng mã giới thiệu"},"example":"{PHONE_NUMBER}"},"free_products_priced_between_approx":{"type":"object","description":"Free products priced between approximately","x-description-i18n":{"vie":"Miễn phí cho khách mới sản phẩm có giá"},"properties":{"active":{"type":"string","description":"Active status","x-description-i18n":{"vie":"Trạng thái kích hoạt"},"example":"true"},"operator":{"type":"string","description":"Comparison operator","x-description-i18n":{"vie":"Toán tử so sánh"},"example":"GreaterOrEqual"},"price":{"type":"string","description":"Price threshold","x-description-i18n":{"vie":"Ngưỡng giá"},"example":"150000"}}},"is_percent":{"type":"string","description":"Discount is percentage","x-description-i18n":{"vie":"Giảm giá theo phần trăm"},"example":"true"},"only_customers_with_level_will_have_referral_code":{"type":"string","description":"Only customers with level will have referral code","x-description-i18n":{"vie":"Chỉ khách hàng có cấp độ mới có mã giới thiệu"},"example":"true"},"referral_code":{"type":"string","description":"Referral code","x-description-i18n":{"vie":"Mã giới thiệu"},"example":"982843759"},"reward_points_for_old_customers":{"type":"object","description":"Reward points for customers","x-description-i18n":{"vie":"Điểm thưởng khách hàng"},"properties":{"active":{"type":"string","description":"Active status","x-description-i18n":{"vie":"Trạng thái kích hoạt"},"example":"true"},"money":{"type":"string","description":"Money reward","x-description-i18n":{"vie":"Tiền thưởng"},"example":"10000"},"point":{"type":"string","description":"Point reward","x-description-i18n":{"vie":"Điểm thưởng"},"example":"1"}}},"shop_customer_id":{"type":"string","format":"uuid","description":"Shop customer ID","x-description-i18n":{"vie":"Mã khách hàng shop"},"example":"f8160a4c-dfa7-4ee8-b540-d245755ea1f1"}},"example":{"active":"true","customer_id":"09bb9399-45f3-4897-a53a-85dde2f886fe","discount":"10","format":"{PHONE_NUMBER}","free_products_priced_between_approx":{"active":"true","operator":"GreaterOrEqual","price":"150000"},"is_percent":"true","only_customers_with_level_will_have_referral_code":"true","referral_code":"982843759","reward_points_for_old_customers":{"active":"true","money":"10000","point":"1"},"shop_customer_id":"f8160a4c-dfa7-4ee8-b540-d245755ea1f1"}},"tax":{"type":"integer","description":"Tax","x-description-i18n":{"vie":"Thuế"}},"is_from_ecommerce":{"type":"boolean","description":"Is from e-commerce","x-description-i18n":{"vie":"Đơn hàng từ sàn thương mại điện tử"}},"note_image":{"type":"array","description":"Note images","x-description-i18n":{"vie":"Link hình ảnh ghi chú"},"items":{"type":"string","format":"uri"}},"shopify_draft_order_id":{"type":"string","description":"Shopify draft order ID","x-description-i18n":{"vie":"Mã đơn hàng nháp Shopify"}},"display_id":{"type":"integer","description":"Display ID","x-description-i18n":{"vie":"Mã hiển thị"}},"shop_partner_id":{"type":"integer","description":"Shop partner ID","x-description-i18n":{"vie":"Mã đối tác shop"}},"is_locked":{"type":"boolean","description":"Order lock","x-description-i18n":{"vie":"Khóa đơn hàng"}},"merge_order":{"type":"boolean","description":"Allows merging orders","x-description-i18n":{"vie":"Cho phép gộp đơn"}}}},"order_to_returned":{"type":"object","properties":{"id":{"type":"integer","description":"Order ID","x-description-i18n":{"vie":"Mã đơn hàng"}},"system_id":{"type":"integer","description":"System ID","x-description-i18n":{"vie":"Mã hệ thống"}},"shop_id":{"type":"integer","description":"Shop ID","x-description-i18n":{"vie":"Mã cửa hàng"}},"inserted_at":{"type":"string","format":"date-time","description":"Order creation time","x-description-i18n":{"vie":"Thời điểm tạo đơn"}},"updated_at":{"type":"string","format":"date-time","description":"Order update time","x-description-i18n":{"vie":"Thời điểm cập nhật đơn"}},"status":{"type":"integer","description":"Order status","x-description-i18n":{"vie":"Trạng thái đơn hàng"},"enum":[0,17,11,12,13,20,1,8,9,2,3,16,4,15,5,6,7],"x-enum-descriptions":["New","Waiting for confirmation","Restocking","Wait for printing","Printed","Purchased","Confirmed","Packaging","Waiting for pick up","Shipped","Received","Collected money","Returning","Partial return","Returned","Canceled","Deleted recently"],"x-enum-descriptions-i18n":{"vie":["Mới","Chờ xác nhận","Chờ hàng","Chờ in","Đã in","Đã đặt hàng","Đã xác nhận","Đang đóng hàng","Chờ chuyển hàng","Đã gửi hàng","Đã nhận","Đã thu tiền","Đang hoàn","Hoàn một phần","Đã hoàn","Đã hủy","Đã xóa"]}},"status_name":{"type":"string","description":"Order status name","x-description-i18n":{"vie":"Tên trạng thái đơn hàng"}},"bill_full_name":{"type":"string","description":"Customer name","x-description-i18n":{"vie":"Tên khách hàng"}},"bill_phone_number":{"type":"string","description":"Phone number of customer","x-description-i18n":{"vie":"SĐT khách hàng"}},"bill_email":{"type":"string","description":"Customer email","x-description-i18n":{"vie":"Email khách hàng"}},"conversation_id":{"type":"string","description":"Conversation ID","x-description-i18n":{"vie":"Mã hội thoại"}},"page_id":{"type":"string","description":"Facebook page ID","x-description-i18n":{"vie":"Mã Facebook page"}},"post_id":{"type":"string","description":"Post ID","x-description-i18n":{"vie":"Mã bài viết"}},"ad_id":{"type":"string","description":"Ad ID","x-description-i18n":{"vie":"Mã quảng cáo"}},"shipping_fee":{"type":"integer","description":"Shipping fee","x-description-i18n":{"vie":"Phí vận chuyển"}},"partner_fee":{"type":"integer","description":"Fee from shipping partner","x-description-i18n":{"vie":"Phí vận chuyển từ ĐVVC"}},"fee_marketplace":{"type":"integer","description":"Fees from e-commerce platforms","x-description-i18n":{"vie":"Phí sàn"}},"customer_pay_fee":{"type":"boolean","description":"Customer pay shipping fee","x-description-i18n":{"vie":"Khách trả phí ship"}},"is_free_shipping":{"type":"boolean","description":"Free shipping","x-description-i18n":{"vie":"Miễn phí vận chuyển"}},"is_livestream":{"type":"boolean","description":"Is livestream order","x-description-i18n":{"vie":"Đơn hàng từ livestream"}},"is_live_shopping":{"type":"boolean","description":"Is live shopping order","x-description-i18n":{"vie":"Đơn hàng từ live shopping"}},"is_smc":{"type":"boolean","description":"Shopping on Messenger","x-description-i18n":{"vie":"Đơn hàng từ mua sắm trên Messenger"}},"received_at_shop":{"type":"boolean","description":"true: Sales at counter, false: Sell online","x-description-i18n":{"vie":"true: Bán tại quầy, false: Bán online"}},"total_discount":{"type":"integer","description":"Discount total","x-description-i18n":{"vie":"Tổng tiền giảm giá"}},"note":{"type":"string","description":"Internal note","x-description-i18n":{"vie":"Ghi chú nội bộ"}},"note_print":{"type":"string","description":"Note for printing","x-description-i18n":{"vie":"Ghi chú đơn hàng"}},"returned_reason":{"type":"integer","description":"Return reason code (1: Customer, 2: Staff, 3: Defective product, 4: Shipping carrier, 5: Exchange). Other values are shop-defined custom reasons, see returned_reason_name for the display name","x-description-i18n":{"vie":"Mã lý do hoàn hàng (1: Do khách hàng, 2: Do nhân viên, 3: Do sản phẩm lỗi, 4: Do đơn vị vận chuyển, 5: Do đổi hàng). Mã khác là lý do tùy chỉnh theo từng shop, xem tên hiển thị tại returned_reason_name"}},"returned_reason_name":{"type":"string","description":"Return reason name","x-description-i18n":{"vie":"Tên lý do hoàn hàng"}},"sub_status":{"type":"integer","description":"Reason for delivery delay","x-description-i18n":{"vie":"Lý do delay giao hàng"}},"warehouse_id":{"type":"string","description":"Warehouse ID","x-description-i18n":{"vie":"Mã kho hàng"}},"warehouse_info":{"type":"object","description":"Warehouse information","x-description-i18n":{"vie":"Thông tin kho hàng"},"properties":{"name":{"type":"string","description":"Warehouse name","x-description-i18n":{"vie":"Tên kho hàng"}},"phone_number":{"type":"string","description":"Warehouse phone number","x-description-i18n":{"vie":"Số điện thoại kho hàng"}},"full_address":{"type":"string","description":"Warehouse full address","x-description-i18n":{"vie":"Địa chỉ đầy đủ kho hàng"}},"address":{"type":"string","description":"Warehouse address","x-description-i18n":{"vie":"Địa chỉ chi tiết kho hàng"}},"province_id":{"type":"string","description":"Province ID","x-description-i18n":{"vie":"Mã tỉnh thành phố"}},"district_id":{"type":"string","description":"District ID","x-description-i18n":{"vie":"Mã quận huyện"}},"commune_id":{"type":"string","description":"Commune ID","x-description-i18n":{"vie":"Mã phường xã"}},"affiliate_id":{"type":"string","description":"Affiliate ID","x-description-i18n":{"vie":"Mã đại lý"}},"ffm_id":{"type":"string","description":"FFM ID","x-description-i18n":{"vie":"Mã FFM"}},"has_snappy_service":{"type":"boolean","description":"Has Snappy service","x-description-i18n":{"vie":"Có dịch vụ Snappy"}},"custom_id":{"type":"string","description":"Custom ID","x-description-i18n":{"vie":"Mã tùy chỉnh"}}}},"creator_id":{"type":"string","description":"Creator ID","x-description-i18n":{"vie":"Mã người tạo"}},"creator":{"type":"object","description":"Order creator","x-description-i18n":{"vie":"Thông tin người tạo đơn"},"properties":{"id":{"type":"string","description":"Creator ID","x-description-i18n":{"vie":"Mã người tạo"}},"fb_id":{"type":"string","description":"Facebook ID of creator","x-description-i18n":{"vie":"ID facebook người tạo đơn"}},"name":{"type":"string","description":"Creator name","x-description-i18n":{"vie":"Tên người tạo đơn"}},"avatar_url":{"type":"string","description":"Creator avatar URL","x-description-i18n":{"vie":"Link avatar người tạo"}}}},"items":{"type":"array","description":"Product list. When creating or updating an order, each entry must include `variation_id` and `quantity`. `variation_info` is optional — if omitted, the backend treats it as an empty object; send it (with `retail_price`) when you need the line price to be explicit.","x-description-i18n":{"vie":"Danh sách sản phẩm. Khi tạo hoặc cập nhật đơn, mỗi phần tử cần có `variation_id` và `quantity`. `variation_info` không bắt buộc — nếu thiếu, backend coi như object rỗng; nên gửi kèm (cùng `retail_price`) khi muốn giá dòng hàng tường minh."},"items":{"type":"object","required":["variation_id","quantity"],"properties":{"product_id":{"type":"string","description":"Product ID","x-description-i18n":{"vie":"Mã sản phẩm"}},"quantity":{"type":"integer","description":"Quantity","x-description-i18n":{"vie":"Số lượng"}},"returned_count":{"type":"integer","description":"Returned count","x-description-i18n":{"vie":"Số lượng đã trả"}},"assigning_seller_id":{"type":"string","description":"Assigning seller ID","x-description-i18n":{"vie":"Mã nhân viên được phân công"}},"quantity_by_combo_products":{"type":"array","description":"Quantity by combo products","x-description-i18n":{"vie":"Số lượng theo combo sản phẩm"},"items":{"type":"object"}},"discount_each_product":{"type":"integer","description":"Discount for each product","x-description-i18n":{"vie":"Giảm giá cho từng sản phẩm"}},"is_bonus_product":{"type":"boolean","description":"Is bonus product","x-description-i18n":{"vie":"Sản phẩm tặng kèm"}},"is_discount_percent":{"type":"boolean","description":"Is discount by percent","x-description-i18n":{"vie":"Giảm giá theo phần trăm"}},"is_wholesale":{"type":"boolean","description":"Is wholesale","x-description-i18n":{"vie":"Bán sỉ"}},"is_composite":{"type":"boolean","description":"Is composite product","x-description-i18n":{"vie":"Sản phẩm composite"}},"one_time_product":{"type":"boolean","description":"One time product","x-description-i18n":{"vie":"Sản phẩm một lần"}},"note":{"type":"string","description":"Product note","x-description-i18n":{"vie":"Ghi chú sản phẩm"}},"note_product":{"type":"string","description":"Product note","x-description-i18n":{"vie":"Ghi chú sản phẩm"}},"inserted_at":{"type":"string","format":"date-time","description":"Inserted at","x-description-i18n":{"vie":"Thời điểm tạo"}},"measure_group_id":{"type":"integer","description":"Measure group ID","x-description-i18n":{"vie":"Mã nhóm đơn vị tính"}},"variation_info":{"type":"object","description":"Variation information. Optional when creating/updating an order (the backend defaults it to an empty object if omitted). Its inner fields are not individually required, but sending `retail_price` is recommended so the line price is correct.","x-description-i18n":{"vie":"Thông tin biến thể. Không bắt buộc khi tạo/cập nhật đơn (backend tự coi là object rỗng nếu thiếu). Các field bên trong không bắt buộc riêng lẻ, nhưng nên gửi `retail_price` để giá dòng hàng đúng."},"properties":{"id":{"type":"string","description":"Variation ID","x-description-i18n":{"vie":"Mã biến thể"}},"name":{"type":"string","description":"Product name","x-description-i18n":{"vie":"Tên sản phẩm"}},"product_id":{"type":"string","description":"Product ID","x-description-i18n":{"vie":"Mã sản phẩm"}},"retail_price":{"type":"integer","description":"Retail price. Not strictly required, but recommended when creating/updating an order so the line price is correct.","x-description-i18n":{"vie":"Giá bán lẻ. Không bắt buộc, nhưng nên gửi khi tạo/cập nhật đơn để giá dòng hàng chính xác."}},"detail":{"type":"string","description":"Variation detail","x-description-i18n":{"vie":"Chi tiết biến thể"}},"images":{"type":"array","description":"Variation images","x-description-i18n":{"vie":"Hình ảnh biến thể"},"items":{"type":"string","format":"uri"}},"fields":{"type":"array","description":"Variation fields","x-description-i18n":{"vie":"Thuộc tính biến thể"},"items":{"type":"object","properties":{"id":{"type":"string","description":"Field ID","x-description-i18n":{"vie":"Mã thuộc tính"}},"name":{"type":"string","description":"Field name","x-description-i18n":{"vie":"Tên thuộc tính"}},"value":{"type":"string","description":"Field value","x-description-i18n":{"vie":"Giá trị thuộc tính"}},"keyValue":{"type":"string","description":"Key value","x-description-i18n":{"vie":"Giá trị khóa"}}}}},"barcode":{"type":"string","description":"Barcode","x-description-i18n":{"vie":"Mã barcode"}},"brand_id":{"type":"string","description":"Brand ID","x-description-i18n":{"vie":"Mã thương hiệu"}},"category_ids":{"type":"array","description":"Category IDs","x-description-i18n":{"vie":"Danh sách mã danh mục"},"items":{"type":"integer"}},"display_id":{"type":"string","description":"Display ID","x-description-i18n":{"vie":"Mã hiển thị"}},"product_display_id":{"type":"string","description":"Product display ID","x-description-i18n":{"vie":"Mã hiển thị sản phẩm"}},"last_imported_price":{"type":"integer","description":"Last imported price","x-description-i18n":{"vie":"Giá nhập hàng cuối"}},"is_upsale_product":{"type":"boolean","description":"Upsale product","x-description-i18n":{"vie":"Sản phẩm upsale"}},"weight":{"type":"integer","description":"Weight","x-description-i18n":{"vie":"Khối lượng"}},"measure_info":{"type":"object","description":"Measure information","x-description-i18n":{"vie":"Thông tin đơn vị tính"},"properties":{"measure_id":{"type":"integer","description":"Measure ID","x-description-i18n":{"vie":"Mã đơn vị tính"}},"exchange_value":{"type":"integer","description":"Exchange value","x-description-i18n":{"vie":"Giá trị quy đổi"}}}},"avg_price":{"type":"integer","description":"Average import price","x-description-i18n":{"vie":"Giá nhập trung bình"}}}},"components":{"type":"array","description":"Product components","x-description-i18n":{"vie":"Thành phần sản phẩm"},"items":{"type":"object","properties":{"component_id":{"type":"string","description":"Component ID","x-description-i18n":{"vie":"Mã thành phần"}},"quantity":{"type":"integer","description":"Quantity","x-description-i18n":{"vie":"Số lượng"}},"variation_id":{"type":"string","description":"Variation ID","x-description-i18n":{"vie":"Mã biến thể"}},"variation_info":{"type":"object","description":"Variation information","x-description-i18n":{"vie":"Thông tin biến thể"}}}}},"id":{"type":"integer","description":"Item ID","x-description-i18n":{"vie":"Mã sản phẩm trong đơn"}},"variation_id":{"type":"string","description":"Variation ID","x-description-i18n":{"vie":"Mã biến thể"}}}}},"partner":{"type":"object","description":"Partner information","x-description-i18n":{"vie":"Thông tin đơn vị vận chuyển"},"properties":{"partner_id":{"type":"integer","description":"Partner ID","x-description-i18n":{"vie":"ID đơn vị vận chuyển trên hệ thống Pancake"}},"cod":{"type":"integer","description":"Reconciliation COD","x-description-i18n":{"vie":"Đối soát tiền thu hộ"}},"extend_code":{"type":"string","description":"Shipping order ID on partner system","x-description-i18n":{"vie":"Mã vận đơn"}},"total_fee":{"type":"integer","description":"Total fee","x-description-i18n":{"vie":"Tổng phí"}},"updated_at":{"type":"string","format":"date-time","description":"Updated at","x-description-i18n":{"vie":"Thời điểm cập nhật"}},"delivery_name":{"type":"string","description":"Shipper name","x-description-i18n":{"vie":"Tên người giao hàng"}},"delivery_tel":{"type":"string","description":"Delivery phone","x-description-i18n":{"vie":"Số điện thoại người giao hàng"}},"picked_up_at":{"type":"string","format":"date-time","description":"Picked up at","x-description-i18n":{"vie":"Thời điểm lấy hàng"}},"sort_code":{"type":"string","description":"Sort code","x-description-i18n":{"vie":"Mã phân loại"}},"paid_at":{"type":"string","format":"date-time","description":"Paid at","x-description-i18n":{"vie":"Thời điểm thanh toán"}},"system_created":{"type":"boolean","description":"System created","x-description-i18n":{"vie":"Được tạo bởi hệ thống"}},"extend_update":{"type":"array","description":"Update from courier","x-description-i18n":{"vie":"Cập nhật từ đơn vị vận chuyển"},"items":{"type":"object","properties":{"key":{"type":"string","description":"Update key","x-description-i18n":{"vie":"Mã cập nhật"}},"status":{"type":"string","description":"Status","x-description-i18n":{"vie":"Trạng thái"}},"tracking_id":{"type":"string","description":"Partner extend code","x-description-i18n":{"vie":"Mã đơn hàng đối tác"}},"note":{"type":"string","description":"Courier notes","x-description-i18n":{"vie":"Ghi chú từ đơn vị vận chuyển"}},"update_at":{"type":"string","format":"date-time","description":"Updated at","x-description-i18n":{"vie":"Thời điểm cập nhật"}}}}},"partner_status":{"type":"string","nullable":true,"description":"Partner shipping status","x-description-i18n":{"vie":"Trạng thái vận chuyển"},"enum":["waiting","request_received","processing_picked_up","picking_up","delay_pickup","picked_up","waiting_on_the_way","on_the_way","contact_delivery_company","out_for_delivery","delay_delivery","inform_recipient","undeliverable","waiting_for_return","delivered","delivered_cod","returning","returned","returned_cod","canceled"],"x-enum-descriptions":["Waiting for processing","Carrier received the request","Processing pickup","Picking up","Delayed pickup","Picked up","Waiting for transit","In transit","Contact the carrier","Out for delivery","Delayed delivery","Notify the recipient","Undeliverable","Waiting for return","Delivered","Delivered, COD reconciled","Returning","Returned","Returned, COD reconciled","Canceled"],"x-enum-descriptions-i18n":{"vie":["Chờ xử lý","ĐVVC đã tiếp nhận đơn","Đang xử lý lấy hàng","Đang lấy hàng","Trễ lấy hàng","Đã lấy hàng","Chờ trung chuyển","Đang trung chuyển","Liên hệ ĐVVC","Đang giao hàng","Trễ giao hàng","Thông báo cho người nhận","Giao không thành","Chờ chuyển hoàn","Đã giao hàng","Đã giao hàng, đã đối soát COD","Đang chuyển hoàn","Đã chuyển hoàn","Đã chuyển hoàn, đã đối soát COD","Đã hủy vận đơn"]}},"partner_name":{"type":"string","nullable":true,"description":"Partner name","x-description-i18n":{"vie":"Tên đơn vị vận chuyển"}},"first_delivery_at":{"type":"string","format":"date-time","nullable":true,"description":"First delivery time","x-description-i18n":{"vie":"Thời điểm giao hàng lần đầu"}},"first_undeliverable_at":{"type":"string","format":"date-time","nullable":true,"description":"First failed delivery time","x-description-i18n":{"vie":"Thời điểm giao hàng thất bại lần đầu"}},"order_number_vtp":{"type":"string","nullable":true,"description":"Viettel Post tracking number","x-description-i18n":{"vie":"Mã vận đơn Viettel Post"}},"printed_form":{"type":"object","nullable":true,"description":"Printed form","x-description-i18n":{"vie":"Mẫu in"}}}},"shipping_address":{"$ref":"#/components/schemas/ShippingAddress"},"payment_purchase_histories":{"type":"array","description":"Payment histories","x-description-i18n":{"vie":"Lịch sử thanh toán"},"items":{"type":"object","properties":{"amount":{"type":"integer","description":"Amount of money","x-description-i18n":{"vie":"Số tiền"}},"type":{"type":"string","description":"Payment type","x-description-i18n":{"vie":"Loại thanh toán"}},"inserted_at":{"type":"string","format":"date-time","description":"Transaction time","x-description-i18n":{"vie":"Thời điểm giao dịch"}},"result_code":{"type":"string","description":"Result code","x-description-i18n":{"vie":"Mã kết quả"}},"ipn_reply":{"type":"boolean","description":"IPN reply","x-description-i18n":{"vie":"Phản hồi IPN"}},"voucher_amount":{"type":"integer","description":"Voucher amount","x-description-i18n":{"vie":"Số tiền voucher"}},"tags":{"type":"array","description":"Tags","x-description-i18n":{"vie":"Thẻ"},"items":{"type":"string"}}}}},"tags":{"type":"array","description":"Tags list","x-description-i18n":{"vie":"Danh sách thẻ đơn hàng"},"items":{"type":"object","properties":{"id":{"type":"integer","description":"Tag ID","x-description-i18n":{"vie":"Mã thẻ đơn hàng"}},"name":{"type":"string","description":"Tag name","x-description-i18n":{"vie":"Tên thẻ đơn hàng"}}}}},"marketer":{"type":"object","description":"Marketer information","x-description-i18n":{"vie":"Thông tin marketer"},"properties":{"id":{"type":"string","description":"Marketer ID","x-description-i18n":{"vie":"Mã marketer"}},"name":{"type":"string","description":"Marketer name","x-description-i18n":{"vie":"Tên marketer"}},"email":{"type":"string","description":"Marketer email","x-description-i18n":{"vie":"Email marketer"}},"phone_number":{"type":"string","description":"Marketer phone number","x-description-i18n":{"vie":"Số điện thoại marketer"}},"fb_id":{"type":"string","description":"Marketer Facebook ID","x-description-i18n":{"vie":"Facebook ID marketer"}},"avatar_url":{"type":"string","description":"Marketer avatar URL","x-description-i18n":{"vie":"Link avatar marketer"}}}},"pke_mkter":{"type":"string","description":"Marketer ID","x-description-i18n":{"vie":"Mã nhân viên marketer"}},"activated_combo_products":{"type":"object","description":"Activated combo products information","x-description-i18n":{"vie":"Thông tin combo sản phẩm được kích hoạt"},"properties":{"combo_product_id":{"type":"integer","description":"Combo product ID","x-description-i18n":{"vie":"Mã combo sản phẩm"}},"quantity_combo_activated":{"type":"integer","description":"Quantity combo activated","x-description-i18n":{"vie":"Số lượng combo được kích hoạt"}},"combo_product_info":{"type":"object","description":"Combo product information","x-description-i18n":{"vie":"Thông tin combo sản phẩm"}}}},"activated_promotion_advances":{"type":"array","description":"Activated promotion advances information","x-description-i18n":{"vie":"Thông tin khuyến mãi được kích hoạt"},"items":{"type":"object","properties":{"id":{"type":"integer","description":"ID","x-description-i18n":{"vie":"Mã"}},"promotion_advance_id":{"type":"string","description":"Promotion advance ID","x-description-i18n":{"vie":"Mã khuyến mãi"}},"promotion_advance_info":{"type":"object","description":"Promotion advance information","x-description-i18n":{"vie":"Thông tin khuyến mãi"}}}}},"invoice_info_list":{"type":"array","description":"Invoice information list","x-description-i18n":{"vie":"Danh sách thông tin hóa đơn"},"items":{"type":"object","properties":{"error":{"type":"string","description":"Error message if any","x-description-i18n":{"vie":"Thông báo lỗi nếu có"}},"invoice_detail":{"type":"object","description":"Invoice detail information","x-description-i18n":{"vie":"Chi tiết thông tin hóa đơn"},"properties":{"company_address":{"type":"string","description":"Company address","x-description-i18n":{"vie":"Địa chỉ công ty"}},"company_address_breakdown":{"type":"object","description":"Company address breakdown","x-description-i18n":{"vie":"Chi tiết địa chỉ công ty"},"properties":{"company_additional_info":{"type":"string","description":"Company additional information","x-description-i18n":{"vie":"Thông tin bổ sung công ty"}},"company_barangay":{"type":"string","description":"Company barangay","x-description-i18n":{"vie":"Phường/xã công ty"}},"company_city":{"type":"string","description":"Company city","x-description-i18n":{"vie":"Thành phố công ty"}},"company_detailed_address":{"type":"string","description":"Company detailed address","x-description-i18n":{"vie":"Địa chỉ chi tiết công ty"}},"company_district":{"type":"string","description":"Company district","x-description-i18n":{"vie":"Quận/huyện công ty"}},"company_full_address":{"type":"string","description":"Company full address","x-description-i18n":{"vie":"Địa chỉ đầy đủ công ty"}},"company_postcode":{"type":"string","description":"Company postcode","x-description-i18n":{"vie":"Mã bưu điện công ty"}},"company_province":{"type":"string","description":"Company province","x-description-i18n":{"vie":"Tỉnh công ty"}},"company_region":{"type":"string","description":"Company region","x-description-i18n":{"vie":"Vùng/khu vực công ty"}},"company_state":{"type":"string","description":"Company state","x-description-i18n":{"vie":"Bang/tỉnh công ty"}},"company_town":{"type":"string","description":"Company town","x-description-i18n":{"vie":"Thị trấn/phường công ty"}}}},"company_email":{"type":"string","description":"Company email","x-description-i18n":{"vie":"Email công ty"}},"company_name":{"type":"string","description":"Company name","x-description-i18n":{"vie":"Tên công ty"}},"company_tax_id":{"type":"string","description":"Company tax ID","x-description-i18n":{"vie":"Mã số thuế công ty"}}}},"invoice_type":{"type":"string","description":"Invoice type","x-description-i18n":{"vie":"Loại hóa đơn"}},"is_requested":{"type":"boolean","description":"Request for invoice","x-description-i18n":{"vie":"Yêu cầu xuất hóa đơn"}},"order_sn":{"type":"string","description":"Order code on the marketplace","x-description-i18n":{"vie":"Mã đơn hàng trên sàn"}}}}},"reports_by_phone":{"type":"object","description":"Reports by phone number","x-description-i18n":{"vie":"Báo cáo theo số điện thoại"},"properties":{"order_fail":{"type":"integer","description":"Number of failed orders","x-description-i18n":{"vie":"Số đơn thất bại"}},"order_success":{"type":"integer","description":"Number of successful orders","x-description-i18n":{"vie":"Số đơn thành công"}},"warning":{"type":"integer","description":"Number of warnings orders","x-description-i18n":{"vie":"Số đơn cảnh báo"}}},"example":{"+639175706297":{"order_fail":29,"order_success":20,"warning":0}}},"tracking_link":{"type":"string","description":"Link confirm order","x-description-i18n":{"vie":"Link xác nhận đơn hàng"}},"ads_source":{"type":"string","description":"Advertising source","x-description-i18n":{"vie":"Nguồn quảng cáo"}},"bank_payments":{"type":"object","description":"Payment method","x-description-i18n":{"vie":"Phương thức thanh toán"}},"transfer_proofs":{"type":"array","description":"Bank transfer payment proofs, including verification time, amount and receipt images","x-description-i18n":{"vie":"Danh sách chứng từ xác thực chuyển khoản, gồm ngày giờ xác thực, số tiền và ảnh chứng từ"},"items":{"type":"object","properties":{"id":{"type":"integer","description":"Transfer proof ID","x-description-i18n":{"vie":"Mã chứng từ chuyển khoản"}},"order_id":{"type":"integer","description":"Order ID","x-description-i18n":{"vie":"Mã đơn hàng"}},"shop_id":{"type":"integer","description":"Shop ID","x-description-i18n":{"vie":"Mã cửa hàng"}},"payment_id":{"type":"string","description":"Bank payment method ID (matches a key in `bank_payments`)","x-description-i18n":{"vie":"Mã phương thức thanh toán ngân hàng (trùng với key trong `bank_payments`)"}},"amount":{"type":"integer","description":"Transferred amount","x-description-i18n":{"vie":"Số tiền chuyển khoản"}},"images":{"type":"array","description":"Transfer receipt images","x-description-i18n":{"vie":"Danh sách ảnh chứng từ chuyển khoản"},"items":{"type":"string"}},"note":{"type":"string","nullable":true,"description":"Note","x-description-i18n":{"vie":"Ghi chú"}},"is_income":{"type":"boolean","description":"Money received (true) or paid out (false)","x-description-i18n":{"vie":"Là khoản tiền nhận vào (true) hay chi ra (false)"}},"is_verify":{"type":"boolean","description":"Whether the transfer has been verified","x-description-i18n":{"vie":"Chứng từ đã được xác thực hay chưa"}},"verify_at":{"type":"string","format":"date-time","nullable":true,"description":"Verification time","x-description-i18n":{"vie":"Thời điểm xác thực chuyển khoản"}},"verifier":{"type":"object","nullable":true,"description":"Verifier information","x-description-i18n":{"vie":"Thông tin người xác thực"},"properties":{"id":{"type":"string","description":"Verifier ID","x-description-i18n":{"vie":"Mã người xác thực"}},"name":{"type":"string","description":"Verifier name","x-description-i18n":{"vie":"Tên người xác thực"}},"fb_id":{"type":"string","description":"Facebook ID of verifier","x-description-i18n":{"vie":"Facebook ID người xác thực"}},"avatar_url":{"type":"string","description":"Verifier avatar URL","x-description-i18n":{"vie":"Link avatar người xác thực"}}}},"creator":{"type":"object","nullable":true,"description":"Creator information","x-description-i18n":{"vie":"Thông tin người tạo chứng từ"},"properties":{"id":{"type":"string","description":"Creator ID","x-description-i18n":{"vie":"Mã người tạo"}},"name":{"type":"string","description":"Creator name","x-description-i18n":{"vie":"Tên người tạo"}},"fb_id":{"type":"string","description":"Facebook ID of creator","x-description-i18n":{"vie":"Facebook ID người tạo"}},"avatar_url":{"type":"string","description":"Creator avatar URL","x-description-i18n":{"vie":"Link avatar người tạo"}}}},"last_editor":{"type":"object","nullable":true,"description":"Last editor information","x-description-i18n":{"vie":"Thông tin người chỉnh sửa cuối"},"properties":{"id":{"type":"string","description":"Editor ID","x-description-i18n":{"vie":"Mã người chỉnh sửa"}},"name":{"type":"string","description":"Editor name","x-description-i18n":{"vie":"Tên người chỉnh sửa"}},"fb_id":{"type":"string","description":"Facebook ID of editor","x-description-i18n":{"vie":"Facebook ID người chỉnh sửa"}},"avatar_url":{"type":"string","description":"Editor avatar URL","x-description-i18n":{"vie":"Link avatar người chỉnh sửa"}}}},"order_info":{"type":"object","nullable":true,"description":"Additional order information","x-description-i18n":{"vie":"Thông tin đơn hàng bổ sung"}},"inserted_at":{"type":"string","format":"date-time","description":"Transfer proof creation time","x-description-i18n":{"vie":"Thời điểm tạo chứng từ"}},"updated_at":{"type":"string","format":"date-time","description":"Transfer proof update time","x-description-i18n":{"vie":"Thời điểm cập nhật chứng từ"}}}}},"shopify_order_id":{"type":"string","description":"Shopify order ID","x-description-i18n":{"vie":"Mã đơn hàng Shopify"}},"shopify_abandon_checkout_id":{"type":"integer","description":"Shopify abandon checkout ID","x-description-i18n":{"vie":"Mã Shopify abandon checkout"}},"is_abandoned_order":{"type":"boolean","description":"Abandoned-cart flag for creating or updating an order. Send it directly in the request body, not inside `third_party` or `third_party_infomation`.\nAn explicit value, including `false`, takes precedence over automatic detection. If omitted on creation, the flag is determined automatically; if omitted on update, the current value is preserved.\nOnly boolean `true` or string `\"true\"` is normalized to `true`; all other submitted values become `false`.\n","x-description-i18n":{"vie":"Cờ đơn chưa hoàn tất khi tạo hoặc cập nhật đơn. Truyền trực tiếp trong body, không bọc trong `third_party` hoặc `third_party_infomation`.\nGiá trị truyền lên, kể cả `false`, được ưu tiên hơn kết quả nhận diện tự động. Nếu bỏ qua khi tạo đơn, cờ được xác định tự động; nếu bỏ qua khi cập nhật, giữ nguyên giá trị hiện tại.\nChỉ boolean `true` hoặc chuỗi `\"true\"` được chuẩn hóa thành `true`; mọi giá trị khác được gửi lên đều thành `false`.\n"},"example":true},"cod":{"type":"integer","description":"Cash on delivery","x-description-i18n":{"vie":"Tiền thu hộ"}},"cash":{"type":"integer","description":"Cash payment","x-description-i18n":{"vie":"Tiền mặt"}},"account":{"type":"integer","description":"Order source ID","x-description-i18n":{"vie":"Mã nguồn đơn hàng"}},"account_name":{"type":"string","description":"Order source name","x-description-i18n":{"vie":"Tên mã nguồn đơn"}},"advanced_platform_fee":{"type":"object","description":"Fees from e-commerce platforms","x-description-i18n":{"vie":"Phí từ sàn thương mại điện tử"},"properties":{"ads_top_up":{"type":"integer","description":"Ads wallet top-up","x-description-i18n":{"vie":"Ví quảng cáo"}},"affiliate_commission":{"type":"integer","description":"Affiliate commission","x-description-i18n":{"vie":"Phí hoa hồng (Sàn TMĐT)"}},"diff_shipping_fee":{"type":"integer","description":"Difference shipping fee","x-description-i18n":{"vie":"Chênh lệch phí vận chuyển (Sàn TMĐT)"}},"marketplace_voucher":{"type":"integer","description":"Marketplace voucher","x-description-i18n":{"vie":"Sàn trợ giá"}},"payment_fee":{"type":"integer","description":"Payment fee","x-description-i18n":{"vie":"Phí cố định, giao dịch (Sàn TMĐT)"}},"platform_commission":{"type":"integer","description":"Platform commission","x-description-i18n":{"vie":"Phí hoa hồng nền tảng (Sàn TMĐT)"}},"seller_transaction_fee":{"type":"integer","description":"Seller transaction fee","x-description-i18n":{"vie":"Phí thanh toán (Sàn TMĐT)"}},"service_fee":{"type":"integer","description":"Service fee","x-description-i18n":{"vie":"Phí dịch vụ (Sàn TMĐT)"}},"sfp_service_fee":{"type":"integer","description":"SFP service fee","x-description-i18n":{"vie":"Phí dịch vụ SFP (Sàn TMĐT)"}}}},"printing_count":{"type":"integer","description":"Printing count","x-description-i18n":{"vie":"Số lần in"}},"money_to_collect":{"type":"integer","description":"Money to collect","x-description-i18n":{"vie":"Số tiền cần thu"}},"marketplace_id":{"type":"string","description":"Marketplace ID","enum":["-2","-3","-4","-9","-16","-17","-20","-25","-27","-28"],"x-enum-descriptions":{"-2":"Tiki","-3":"Shopee","-4":"Lazada","-9":"TikTok","-16":"WooCommerce","-17":"Shopify","-20":"Line Shopping","-25":"Tokopedia","-27":"Mercado Libre","-28":"Tiendanube"},"x-description-i18n":{"vie":"Mã sàn thương mại điện tử"}},"total_price":{"type":"integer","description":"Total price","x-description-i18n":{"vie":"Tổng giá trị sản phẩm"}},"shop_customer_address_id":{"type":"string","description":"Customer address ID","x-description-i18n":{"vie":"Mã địa chỉ khách hàng"}},"customer":{"type":"object","description":"Customer information","x-description-i18n":{"vie":"Thông tin khách hàng"},"properties":{"fb_id":{"type":"string","description":"Customer Facebook ID","x-description-i18n":{"vie":"Facebook ID khách hàng"}},"id":{"type":"string","description":"Customer ID","x-description-i18n":{"vie":"Mã khách hàng"}},"name":{"type":"string","description":"Customer name","x-description-i18n":{"vie":"Tên khách hàng"}},"page_id":{"type":"string","description":"Page ID","x-description-i18n":{"vie":"Mã trang"}}}},"total_quantity":{"type":"integer","description":"Total quantity","x-description-i18n":{"vie":"Tổng số lượng"}},"time_assign_marketer":{"type":"string","format":"date-time","description":"Time assign marketer","x-description-i18n":{"vie":"Thời điểm phân công marketer"}},"p_utm_source":{"type":"string","description":"UTM Source","x-description-i18n":{"vie":"UTM Source"}},"p_utm_medium":{"type":"string","description":"UTM Medium","x-description-i18n":{"vie":"UTM Medium"}},"p_utm_campaign":{"type":"string","description":"UTM Campaign","x-description-i18n":{"vie":"UTM Campaign"}},"p_utm_term":{"type":"string","description":"UTM Term","x-description-i18n":{"vie":"UTM Term"}},"p_utm_content":{"type":"string","description":"UTM Content","x-description-i18n":{"vie":"UTM Content"}},"p_utm_id":{"type":"string","description":"UTM ID","x-description-i18n":{"vie":"UTM ID"}},"utm_affiliate":{"type":"string","description":"Affiliate","x-description-i18n":{"vie":"Affiliate"}},"link":{"type":"string","description":"Link","x-description-i18n":{"vie":"Link"}},"status_history":{"type":"array","description":"Status update history","x-description-i18n":{"vie":"Lịch sử cập nhật trạng thái"},"items":{"type":"object","properties":{"avatar_url":{"type":"string","description":"Avatar URL","x-description-i18n":{"vie":"Link avatar"}},"editor":{"type":"object","description":"Editor information","x-description-i18n":{"vie":"Thông tin người chỉnh sửa"}},"editor_fb":{"type":"string","description":"Editor Facebook ID","x-description-i18n":{"vie":"Facebook ID người chỉnh sửa"}},"editor_id":{"type":"string","description":"Editor ID","x-description-i18n":{"vie":"Mã người chỉnh sửa"}},"name":{"type":"string","description":"Name","x-description-i18n":{"vie":"Tên"}},"old_status":{"type":"integer","description":"Old status","x-description-i18n":{"vie":"Trạng thái cũ"}},"status":{"type":"integer","description":"Status","x-description-i18n":{"vie":"Trạng thái"}},"updated_at":{"type":"string","format":"date-time","description":"Updated at","x-description-i18n":{"vie":"Thời điểm cập nhật"}}}}},"duplicated_phone":{"type":"boolean","description":"Duplicated phone","x-description-i18n":{"vie":"Số điện thoại trùng lặp"}},"order_currency":{"type":"string","description":"Order currency","x-description-i18n":{"vie":"Loại tiền tệ"}},"charged_by_vnpay":{"type":"integer","description":"Charged by VNPay","x-description-i18n":{"vie":"Số tiền thanh toán qua VNPay"}},"charged_by_qrpay":{"type":"integer","description":"Charged by QRPay","x-description-i18n":{"vie":"Số tiền khách thanh toán qua QRPAY"}},"custom_id":{"type":"string","description":"Custom ID","x-description-i18n":{"vie":"Mã tùy chỉnh"}},"last_editor":{"type":"object","description":"Last editor information","x-description-i18n":{"vie":"Thông tin người chỉnh sửa cuối cùng đơn hàng"},"properties":{"id":{"type":"string","description":"Editor ID","x-description-i18n":{"vie":"Mã người chỉnh sửa"}},"fb_id":{"type":"string","description":"Facebook ID of editor","x-description-i18n":{"vie":"Facebook ID người chỉnh sửa"}},"name":{"type":"string","description":"Editor name","x-description-i18n":{"vie":"Tên người chỉnh sửa"}},"email":{"type":"string","description":"Editor email","x-description-i18n":{"vie":"Email người chỉnh sửa"}},"avatar_url":{"type":"string","description":"Editor avatar URL","x-description-i18n":{"vie":"Link avatar người chỉnh sửa"}},"phone_number":{"type":"string","description":"Editor phone number","x-description-i18n":{"vie":"Số điện thoại người chỉnh sửa"}}}},"last_editor_id":{"type":"string","description":"Last editor ID","x-description-i18n":{"vie":"Mã người sửa cuối"}},"charged_by_momo":{"type":"integer","description":"Charged by MoMo","x-description-i18n":{"vie":"Số tiền khách thanh toán qua MOMO"}},"prepaid_by_point":{"type":"object","description":"Prepaid by point","x-description-i18n":{"vie":"Thanh toán bằng điểm thưởng"},"properties":{"money":{"type":"integer","description":"Money amount","x-description-i18n":{"vie":"Số tiền"},"example":15000},"point":{"type":"integer","description":"Point amount","x-description-i18n":{"vie":"Số điểm"},"example":15}},"example":{"money":15000,"point":15}},"bank_transfer_images":{"type":"array","description":"Bank transfer images","x-description-i18n":{"vie":"Hình ảnh chuyển khoản"},"items":{"type":"string","format":"uri"}},"transfer_money":{"type":"integer","description":"Transfer money","x-description-i18n":{"vie":"Số tiền khách chuyển khoản"}},"lock_order_by_user":{"type":"string","description":"Lock order by user ID","x-description-i18n":{"vie":"Mã người dùng khóa đơn hàng"}},"assigning_care":{"type":"object","description":"Assigning care information","x-description-i18n":{"vie":"Nhân viên chăm sóc"},"properties":{"id":{"type":"string","description":"Care ID","x-description-i18n":{"vie":"Mã người chăm sóc"}},"fb_id":{"type":"string","description":"Facebook ID of care","x-description-i18n":{"vie":"Facebook ID người chăm sóc"}},"name":{"type":"string","description":"Care name","x-description-i18n":{"vie":"Tên người chăm sóc"}},"email":{"type":"string","description":"Care email","x-description-i18n":{"vie":"Email người chăm sóc"}},"avatar_url":{"type":"string","description":"Care avatar URL","x-description-i18n":{"vie":"Link avatar người chăm sóc"}},"phone_number":{"type":"string","description":"Care phone number","x-description-i18n":{"vie":"Số điện thoại người chăm sóc"}}}},"assigning_care_id":{"type":"string","description":"Assigning care ID","x-description-i18n":{"vie":"Mã nhân viên chăm sóc"}},"time_assign_care":{"type":"string","format":"date-time","description":"Time assign care","x-description-i18n":{"vie":"Thời điểm phân công chăm sóc"}},"assigning_seller":{"type":"object","description":"Assigning seller information","x-description-i18n":{"vie":"Nhân viên được phân công"},"properties":{"id":{"type":"string","description":"Seller ID","x-description-i18n":{"vie":"Mã người bán"}},"fb_id":{"type":"string","description":"Facebook ID of seller","x-description-i18n":{"vie":"Facebook ID người bán"}},"name":{"type":"string","description":"Seller name","x-description-i18n":{"vie":"Tên người bán"}},"email":{"type":"string","description":"Seller email","x-description-i18n":{"vie":"Email người bán"}},"avatar_url":{"type":"string","description":"Seller avatar URL","x-description-i18n":{"vie":"Link avatar người bán"}},"phone_number":{"type":"string","description":"Seller phone number","x-description-i18n":{"vie":"Số điện thoại người bán"}}}},"einvoices":{"type":"array","items":{"$ref":"#/components/schemas/EInvoice"}},"charged_by_card":{"type":"integer","description":"Charged by card","x-description-i18n":{"vie":"Số tiền khách quẹt thẻ"}},"estimate_delivery_date":{"type":"string","format":"date-time","description":"Estimate delivery date","x-description-i18n":{"vie":"Ngày giao hàng dự kiến"}},"order_sources":{"type":"string","description":"Order sources ID","x-description-i18n":{"vie":"Mã nguồn đơn hàng"}},"charged_by_fundiin":{"type":"integer","description":"Charged by Fundiin","x-description-i18n":{"vie":"Số tiền thanh toán qua Fundiin"}},"surcharge":{"type":"integer","description":"Surcharge","x-description-i18n":{"vie":"Phụ thu"}},"is_linked_partner":{"type":"boolean","description":"Is linked partner","x-description-i18n":{"vie":"Đã liên kết đối tác"}},"call_laters":{"type":"array","description":"Call laters","x-description-i18n":{"vie":"Gọi lại sau"},"items":{"type":"object"}},"last_update_status_at":{"type":"string","format":"date-time","description":"Last update status at","x-description-i18n":{"vie":"Thời điểm cập nhật trạng thái cuối"}},"discount_by_customer_level":{"type":"integer","description":"Discount by customer level","x-description-i18n":{"vie":"Giảm giá theo cấp độ khách hàng"}},"viewing":{"type":"array","description":"Viewing","x-description-i18n":{"vie":"NV đang xem"},"items":{"type":"object"}},"additional_info":{"type":"object","description":"Additional info","x-description-i18n":{"vie":"Thông tin bổ sung"},"properties":{"service_partner":{"type":"string","description":"Service partner","x-description-i18n":{"vie":"Dịch vụ vận chuyển"},"enum":["instant"],"x-enum-descriptions":["Instant"],"x-enum-descriptions-i18n":{"vie":["Hỏa tốc"]}},"delivery_deadline":{"type":"string","format":"date-time","description":"Delivery deadline (ISO8601, no timezone). Send null to clear.","x-description-i18n":{"vie":"Hạn giao hàng (ISO8601, không kèm timezone). Gửi null để xóa."},"example":"2026-06-03T10:00:00"}}},"order_returned_ids":{"type":"string","description":"Order returned IDs","x-description-i18n":{"vie":"Mã đơn hàng đổi trả"}},"cost_surcharge":{"type":"integer","description":"Cost surcharge","x-description-i18n":{"vie":"Phụ phí"}},"time_send_partner":{"type":"string","format":"date-time","description":"Time send partner","x-description-i18n":{"vie":"Thời điểm gửi đơn vị vận chuyển"}},"charged_by_kredivo":{"type":"integer","description":"Charged by Kredivo","x-description-i18n":{"vie":"Số tiền thanh toán qua Kredivo"}},"discount":{"type":"integer","description":"Discount","x-description-i18n":{"vie":"Giảm giá"}},"histories":{"type":"array","description":"Histories","x-description-i18n":{"vie":"Lịch sử"},"items":{"type":"object"}},"duplicated_customer":{"type":"boolean","description":"Duplicated customer","x-description-i18n":{"vie":"Khách hàng trùng lặp"}},"customer_referral_code":{"type":"object","description":"Customer referral code","x-description-i18n":{"vie":"Mã giới thiệu khách hàng"},"properties":{"active":{"type":"string","description":"Active status","x-description-i18n":{"vie":"Trạng thái kích hoạt"},"example":"true"},"customer_id":{"type":"string","format":"uuid","description":"Customer ID","x-description-i18n":{"vie":"Mã khách hàng"},"example":"09bb9399-45f3-4897-a53a-85dde2f886fe"},"discount":{"type":"string","description":"Discount value","x-description-i18n":{"vie":"Giá trị giảm giá"},"example":"10"},"format":{"type":"string","description":"Referral code format","x-description-i18n":{"vie":"Định dạng mã giới thiệu"},"example":"{PHONE_NUMBER}"},"free_products_priced_between_approx":{"type":"object","description":"Free products priced between approximately","x-description-i18n":{"vie":"Miễn phí cho khách mới sản phẩm có giá"},"properties":{"active":{"type":"string","description":"Active status","x-description-i18n":{"vie":"Trạng thái kích hoạt"},"example":"true"},"operator":{"type":"string","description":"Comparison operator","x-description-i18n":{"vie":"Toán tử so sánh"},"example":"GreaterOrEqual"},"price":{"type":"string","description":"Price threshold","x-description-i18n":{"vie":"Ngưỡng giá"},"example":"150000"}}},"is_percent":{"type":"string","description":"Discount is percentage","x-description-i18n":{"vie":"Giảm giá theo phần trăm"},"example":"true"},"only_customers_with_level_will_have_referral_code":{"type":"string","description":"Only customers with level will have referral code","x-description-i18n":{"vie":"Chỉ khách hàng có cấp độ mới có mã giới thiệu"},"example":"true"},"referral_code":{"type":"string","description":"Referral code","x-description-i18n":{"vie":"Mã giới thiệu"},"example":"982843759"},"reward_points_for_old_customers":{"type":"object","description":"Reward points for customers","x-description-i18n":{"vie":"Điểm thưởng khách hàng"},"properties":{"active":{"type":"string","description":"Active status","x-description-i18n":{"vie":"Trạng thái kích hoạt"},"example":"true"},"money":{"type":"string","description":"Money reward","x-description-i18n":{"vie":"Tiền thưởng"},"example":"10000"},"point":{"type":"string","description":"Point reward","x-description-i18n":{"vie":"Điểm thưởng"},"example":"1"}}},"shop_customer_id":{"type":"string","format":"uuid","description":"Shop customer ID","x-description-i18n":{"vie":"Mã khách hàng shop"},"example":"f8160a4c-dfa7-4ee8-b540-d245755ea1f1"}},"example":{"active":"true","customer_id":"09bb9399-45f3-4897-a53a-85dde2f886fe","discount":"10","format":"{PHONE_NUMBER}","free_products_priced_between_approx":{"active":"true","operator":"GreaterOrEqual","price":"150000"},"is_percent":"true","only_customers_with_level_will_have_referral_code":"true","referral_code":"982843759","reward_points_for_old_customers":{"active":"true","money":"10000","point":"1"},"shop_customer_id":"f8160a4c-dfa7-4ee8-b540-d245755ea1f1"}},"tax":{"type":"integer","description":"Tax","x-description-i18n":{"vie":"Thuế"}},"is_from_ecommerce":{"type":"boolean","description":"Is from e-commerce","x-description-i18n":{"vie":"Đơn hàng từ sàn thương mại điện tử"}},"note_image":{"type":"array","description":"Note images","x-description-i18n":{"vie":"Link hình ảnh ghi chú"},"items":{"type":"string","format":"uri"}},"shopify_draft_order_id":{"type":"string","description":"Shopify draft order ID","x-description-i18n":{"vie":"Mã đơn hàng nháp Shopify"}},"display_id":{"type":"integer","description":"Display ID","x-description-i18n":{"vie":"Mã hiển thị"}},"shop_partner_id":{"type":"integer","description":"Shop partner ID","x-description-i18n":{"vie":"Mã đối tác shop"}},"is_locked":{"type":"boolean","description":"Order lock","x-description-i18n":{"vie":"Khóa đơn hàng"}},"merge_order":{"type":"boolean","description":"Allows merging orders","x-description-i18n":{"vie":"Cho phép gộp đơn"}}}},"returned_items":{"type":"array","description":"List of returned items","x-description-i18n":{"vie":"Danh sách sản phẩm trả"},"items":{"type":"object","properties":{"id":{"type":"integer","description":"Returned item ID","x-description-i18n":{"vie":"Mã sản phẩm trả"}},"product_id":{"type":"string","description":"Product ID","x-description-i18n":{"vie":"Mã sản phẩm"}},"variation_id":{"type":"string","description":"Variation ID","x-description-i18n":{"vie":"Mã biến thể"}},"returned_quantity":{"type":"integer","description":"Returned quantity","x-description-i18n":{"vie":"Số lượng trả"}},"discount_each_product":{"type":"integer","description":"Discount for each product","x-description-i18n":{"vie":"Giảm giá cho từng sản phẩm"}},"is_discount_percent":{"type":"boolean","description":"Is discount by percent","x-description-i18n":{"vie":"Giảm giá theo phần trăm"}},"variation_info":{"type":"object","description":"Variation information","x-description-i18n":{"vie":"Thông tin biến thể"}}}}},"returned_fee":{"type":"integer","description":"Returned fee","x-description-i18n":{"vie":"Phí trả hàng"}},"shop_customer_id":{"type":"string","description":"Customer ID","x-description-i18n":{"vie":"Mã khách hàng"}},"shop_id":{"type":"integer","description":"Shop ID","x-description-i18n":{"vie":"Mã cửa hàng"}},"status":{"type":"integer","description":"Return order status","x-description-i18n":{"vie":"Trạng thái đơn hàng đổi trả"},"enum":[0,1,2,4],"x-enum-descriptions":["New","Completed","Shipped","Canceled"],"x-enum-descriptions-i18n":{"vie":["Mới","Đã xác nhận","Đã nhập hàng","Đã hủy"]}},"status_histories":{"type":"array","description":"Status history","x-description-i18n":{"vie":"Lịch sử trạng thái"},"items":{"type":"object","properties":{"id":{"type":"string","description":"History ID"},"editor_id":{"type":"string","description":"Editor ID"},"old_status":{"type":"integer","description":"Old status"},"status":{"type":"integer","description":"Status"},"inserted_at":{"type":"string","format":"date-time","description":"Created at"},"updated_at":{"type":"string","format":"date-time","description":"Updated at"}}}},"tags":{"type":"array","description":"Tags list","x-description-i18n":{"vie":"Danh sách thẻ"},"items":{"type":"integer"}},"warehouse_id":{"type":"string","description":"Warehouse ID","x-description-i18n":{"vie":"Mã kho hàng"}}}},"Warehouse":{"type":"object","description":"Warehouse information","x-description-i18n":{"vie":"Thông tin kho hàng"},"properties":{"id":{"type":"string","description":"Warehouse ID","x-description-i18n":{"vie":"Mã kho hàng"}},"name":{"type":"string","description":"Warehouse name","x-description-i18n":{"vie":"Tên kho hàng"}},"address":{"type":"string","description":"Warehouse address","x-description-i18n":{"vie":"Địa chỉ chi tiết kho hàng(số nhà, đường, ...)"}},"full_address":{"type":"string","description":"Warehouse full address","x-description-i18n":{"vie":"Địa chỉ đầy đủ kho hàng"}},"phone_number":{"type":"string","description":"Warehouse phone number","x-description-i18n":{"vie":"Số điện thoại kho hàng"}},"province_id":{"type":"string","description":"Province ID","x-description-i18n":{"vie":"Mã tỉnh thành phố"}},"district_id":{"type":"string","description":"District ID","x-description-i18n":{"vie":"Mã quận huyện"}},"commune_id":{"type":"string","description":"Commune ID","x-description-i18n":{"vie":"Mã phường xã"}},"country_code":{"type":"string","description":"Country code","x-description-i18n":{"vie":"Mã quốc gia"}},"shop_id":{"type":"integer","description":"Shop ID","x-description-i18n":{"vie":"Mã cửa hàng"}},"allow_create_order":{"type":"boolean","description":"Allow create order","x-description-i18n":{"vie":"Kho hàng có thể tạo đơn hàng"}},"custom_id":{"type":"string","description":"Custom ID","x-description-i18n":{"vie":"Mã tuỳ chỉnh kho hàng"}},"affiliate_shop_id":{"type":"integer","description":"Affiliate shop ID","x-description-i18n":{"vie":"Mã cửa hàng liên kết"}},"affiliate_warehouse":{"type":"string","description":"Affiliate warehouse name","x-description-i18n":{"vie":"Tên kho hàng liên kết"}}}},"VariationWarehouse":{"type":"object","description":"Per-warehouse stock detail for a variation.","x-description-i18n":{"vie":"Chi tiết tồn kho của một mẫu mã tại từng kho."},"properties":{"id":{"type":"string","description":"Variation-warehouse record ID","x-description-i18n":{"vie":"Mã bản ghi tồn kho (variation_warehouse)"}},"variation_id":{"type":"string","description":"Variation ID","x-description-i18n":{"vie":"Mã mẫu mã"}},"warehouse_id":{"type":"string","description":"Warehouse ID","x-description-i18n":{"vie":"Mã kho"}},"shop_id":{"type":"integer","description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},"remain_quantity":{"type":"integer","description":"Sellable quantity. May include incoming/waiting stock depending on shop settings.","x-description-i18n":{"vie":"Số lượng có thể bán. Có thể đã cộng hàng đang về/chờ tùy cấu hình shop."}},"available_quantity":{"type":"integer","description":"remain_quantity clamped to be non-negative (max(0, remain_quantity)).","x-description-i18n":{"vie":"remain_quantity đã chặn không âm (max(0, remain_quantity))."}},"actual_remain_quantity":{"type":"integer","description":"Quantity physically on hand in the warehouse.","x-description-i18n":{"vie":"Số lượng thực tế đang có trong kho."}},"total_quantity":{"type":"integer","description":"Total quantity recorded at this warehouse.","x-description-i18n":{"vie":"Tổng số lượng ghi nhận tại kho."}},"waitting_quantity":{"type":"integer","description":"Quantity tied up in orders that are awaiting stock (orders placed but waiting for goods to arrive). (Field name keeps the legacy `waitt-` spelling.)","x-description-i18n":{"vie":"Số lượng nằm trong các đơn đang chờ hàng. (Tên field giữ cách viết cũ `waitt-`.)"}},"pending_quantity":{"type":"integer","description":"Quantity reserved by pending purchase orders.","x-description-i18n":{"vie":"Số lượng bị giữ bởi phiếu nhập đang chờ."}},"transfer_quantity":{"type":"integer","description":"Quantity currently being transferred out.","x-description-i18n":{"vie":"Số lượng đang chuyển đi."}},"pending_transfer_quantity":{"type":"integer","description":"Quantity pending transfer (not yet shipped between warehouses).","x-description-i18n":{"vie":"Số lượng chờ chuyển kho (chưa xuất đi)."}},"pending_export_quantity":{"type":"integer","description":"Quantity pending export.","x-description-i18n":{"vie":"Số lượng chờ xuất kho."}},"shipping_quantity":{"type":"integer","description":"Quantity tied up in orders being shipped.","x-description-i18n":{"vie":"Số lượng đang trong đơn giao hàng."}},"returning_quantity":{"type":"integer","description":"Quantity in the process of being returned to this warehouse.","x-description-i18n":{"vie":"Số lượng đang được trả về kho."}},"defect_quantity":{"type":"integer","description":"Damaged/defective quantity.","x-description-i18n":{"vie":"Số lượng hàng lỗi/hỏng."}},"total_quantity_transfer":{"type":"integer","description":"Total quantity across transfer operations.","x-description-i18n":{"vie":"Tổng số lượng liên quan chuyển kho."}},"shelf_quantity":{"type":"integer","description":"Quantity placed on the shelf.","x-description-i18n":{"vie":"Số lượng đang để trên kệ."}},"quantity_in_batch":{"type":"integer","description":"Quantity in the batch/lot.","x-description-i18n":{"vie":"Số lượng trong lô."}},"batch_position":{"type":"string","nullable":true,"description":"Batch/lot location label.","x-description-i18n":{"vie":"Vị trí lô."}},"shelf_position":{"type":"string","nullable":true,"description":"Shelf location label.","x-description-i18n":{"vie":"Vị trí kệ."}},"selling_status":{"type":"string","enum":["none","bad","normal","star"],"x-enum-descriptions":["Testing","Sell slow","Normal","Sell fast"],"x-enum-descriptions-i18n":{"vie":["Thử nghiệm","Bán chậm","Bình thường","Bán nhanh"]},"description":"Selling-speed status of the variation at this warehouse.","x-description-i18n":{"vie":"Trạng thái tốc độ bán của mẫu mã tại kho."}},"selling_avg":{"type":"number","description":"Average quantity sold per period — combine with remain_quantity to estimate days of stock left (for \"running low\" detection).","x-description-i18n":{"vie":"Số lượng bán trung bình mỗi kỳ — kết hợp với remain_quantity để ước lượng số ngày tồn còn lại (phát hiện \"sắp hết\")."}},"avg_price":{"type":"number","description":"Average cost price of the stock at this warehouse.","x-description-i18n":{"vie":"Giá vốn trung bình của hàng tại kho."}},"nearly_out":{"type":"boolean","description":"True when stock has reached the configured warning threshold (nearly out of stock).","x-description-i18n":{"vie":"True khi tồn đã chạm ngưỡng cảnh báo (sắp hết hàng)."}},"not_permission_view_quantity":{"type":"boolean","nullable":true,"description":"True when the current user lacks permission to view quantities for this warehouse (quantity fields are then hidden/zeroed).","x-description-i18n":{"vie":"True khi người dùng không có quyền xem số lượng tại kho này (khi đó các field số lượng bị ẩn/đưa về 0)."}}}},"VariationSize":{"type":"object","description":"Variation size (dimensions)","x-description-i18n":{"vie":"Kích thước mẫu mã"},"properties":{"length":{"type":"integer","description":"Length","x-description-i18n":{"vie":"Chiều dài"}},"width":{"type":"integer","description":"Width","x-description-i18n":{"vie":"Chiều rộng"}},"height":{"type":"integer","description":"Height","x-description-i18n":{"vie":"Chiều cao"}}}},"Variation":{"type":"object","description":"Product variation information","x-description-i18n":{"vie":"Thông tin mẫu mã sản phẩm"},"properties":{"id":{"type":"string","description":"Variation ID","x-description-i18n":{"vie":"Mã mẫu mã"}},"fields":{"type":"array","description":"Variation fields","x-description-i18n":{"vie":"Thông tin thuộc tính mẫu mã"},"items":{"type":"object","properties":{"name":{"type":"string","description":"Field name","x-description-i18n":{"vie":"Tên trường"}},"value":{"type":"string","description":"Field value","x-description-i18n":{"vie":"Giá trị trường"}}}}},"images":{"type":"array","description":"Variation images","x-description-i18n":{"vie":"Link hình ảnh mẫu mã"},"items":{"type":"string","format":"uri"}},"last_imported_price":{"type":"integer","description":"Imported price","x-description-i18n":{"vie":"Giá nhập"}},"retail_price":{"type":"integer","description":"Variation retail price","x-description-i18n":{"vie":"Giá bán mẫu mã"}},"price_at_counter":{"type":"integer","description":"Counter price","x-description-i18n":{"vie":"Giá tại quầy"}},"weight":{"type":"integer","description":"Variation weight","x-description-i18n":{"vie":"Khối lượng mẫu mã"}},"size":{"$ref":"#/components/schemas/VariationSize"},"barcode":{"type":"string","description":"Variation barcode","x-description-i18n":{"vie":"Mã barcode mẫu mã"}},"custom_id":{"type":"string","description":"Variation custom ID","x-description-i18n":{"vie":"Mã tuỳ chỉnh mẫu mã"}},"is_hidden":{"type":"boolean","description":"Store cake status variation","x-description-i18n":{"vie":"Trạng thái StoreCake is_hidden = true -> Ẩn, is_hidden = false -> Hiện"}},"variations_warehouses":{"type":"array","description":"Warehouse info","x-description-i18n":{"vie":"Thông tin tồn kho chi tiết"},"items":{"$ref":"#/components/schemas/VariationWarehouse"}},"wholesale_price2":{"type":"array","description":"Wholesale prices by product quantity","x-description-i18n":{"vie":"Giá bán sỉ theo số lượng sản phẩm"},"items":{"type":"object","properties":{"levelProduct":{"type":"string","description":"Product quantity to apply the wholesale price","x-description-i18n":{"vie":"Số sản phẩm áp dụng giá sỉ"}},"wholesalePrices":{"type":"string","description":"Wholesale price","x-description-i18n":{"vie":"Giá bán sỉ"}}}}},"is_removed":{"type":"boolean","description":"Is removed","x-description-i18n":{"vie":"Đã xóa"}},"keyword":{"type":"string","description":"Keyword","x-description-i18n":{"vie":"Keyword"}}}},"Product":{"type":"object","description":"Product information","x-description-i18n":{"vie":"Thông tin sản phẩm"},"required":["name","weight"],"properties":{"measure_group_id":{"type":"integer","description":"Measure group ID","x-description-i18n":{"vie":"Mã nhóm đơn vị tính"},"example":58},"name":{"type":"string","description":"Product name","x-description-i18n":{"vie":"Tên sản phẩm"}},"category_ids":{"type":"array","description":"Category IDs","x-description-i18n":{"vie":"Danh sách mã danh mục"},"items":{"type":"integer"}},"note":{"type":"string","description":"Internal note","x-description-i18n":{"vie":"Ghi chú nội bộ"}},"note_product":{"type":"string","description":"Product note","x-description-i18n":{"vie":"Ghi chú sản phẩm"}},"product_attributes":{"type":"array","description":"Product attributes","x-description-i18n":{"vie":"Thuộc tính sản phẩm"},"items":{"type":"object","properties":{"name":{"type":"string","description":"Attribute name","x-description-i18n":{"vie":"Tên thuộc tính"}},"values":{"type":"array","description":"Attribute values","x-description-i18n":{"vie":"Giá trị thuộc tính"},"items":{"type":"string"}}}}},"tags":{"type":"array","description":"Product tags","x-description-i18n":{"vie":"Thẻ sản phẩm"},"items":{"type":"integer"}},"weight":{"type":"integer","description":"Product weight","x-description-i18n":{"vie":"Trọng lượng sản phẩm"}},"custom_id":{"type":"string","description":"Product custom ID","x-description-i18n":{"vie":"Mã tùy chỉnh sản phẩm"}},"is_published":{"type":"boolean","description":"Store cake status","x-description-i18n":{"vie":"Trạng thái Store cake"}},"variations":{"type":"array","description":"Product variations","x-description-i18n":{"vie":"Danh sách mẫu mã"},"items":{"$ref":"#/components/schemas/Variation"}},"bonus_products":{"type":"array","description":"Bonus products","x-description-i18n":{"vie":"Sản phẩm tặng kèm"},"items":{"type":"object","required":["quantity","variation_id","price_original","variation_info"],"properties":{"quantity":{"type":"integer","description":"Bonus product quantity","x-description-i18n":{"vie":"Số lượng sản phẩm tặng kèm"}},"variation_id":{"type":"string","description":"Variation ID of the bonus product","x-description-i18n":{"vie":"Mã mẫu mã của sản phẩm tặng kèm"}},"price_original":{"type":"integer","description":"Original price of the bonus product","x-description-i18n":{"vie":"Giá gốc của sản phẩm tặng kèm"}},"images":{"type":"array","description":"Bonus product images","x-description-i18n":{"vie":"Hình ảnh sản phẩm tặng kèm"},"items":{"type":"string","format":"uri"}},"variation_info":{"type":"object","description":"Variation information of the bonus product","x-description-i18n":{"vie":"Thông tin mẫu mã của sản phẩm tặng kèm"},"required":["id","name","product_id"],"properties":{"id":{"type":"string","description":"Variation info ID","x-description-i18n":{"vie":"Mã thông tin mẫu mã"}},"measure_group_id":{"type":"string","description":"Measure group ID","x-description-i18n":{"vie":"Mã nhóm đơn vị tính"}},"measure_info":{"type":"object","description":"Measure unit information (present when measure_group_id exists)","x-description-i18n":{"vie":"Thông tin đơn vị tính (có khi có measure_group_id)"},"properties":{"exchange_value":{"type":"integer","description":"Exchange value","x-description-i18n":{"vie":"Giá trị quy đổi"}},"measure_id":{"type":"integer","description":"Measure ID","x-description-i18n":{"vie":"Mã đơn vị tính"}}}},"name":{"type":"string","description":"Variation name","x-description-i18n":{"vie":"Tên mẫu mã"}},"product_id":{"type":"string","description":"Product ID","x-description-i18n":{"vie":"Mã sản phẩm"}},"weight":{"type":"integer","description":"Weight","x-description-i18n":{"vie":"Trọng lượng"}}}}}}},"materials":{"type":"array","description":"Material IDs","x-description-i18n":{"vie":"Danh sách mã nguyên liệu"},"items":{"type":"integer"}},"keyword":{"type":"string","description":"Keyword","x-description-i18n":{"vie":"Từ khóa"}},"brand_id":{"type":"string","format":"uuid","description":"Brand ID","x-description-i18n":{"vie":"Mã thương hiệu"}}}},"Customer":{"type":"object","description":"Customer information","x-description-i18n":{"vie":"Thông tin khách hàng"},"properties":{"id":{"type":"string","description":"Customer ID","x-description-i18n":{"vie":"Mã khách hàng"}},"name":{"type":"string","description":"Full name","x-description-i18n":{"vie":"Họ tên đầy đủ"}},"gender":{"type":"string","description":"Gender","x-description-i18n":{"vie":"Giới tính"}},"emails":{"type":"array","description":"Email addresses","x-description-i18n":{"vie":"Danh sách email"},"items":{"type":"string"}},"phone_numbers":{"type":"array","description":"Phone numbers","x-description-i18n":{"vie":"Danh sách số điện thoại"},"items":{"type":"string"}},"pages_customers":{"type":"array","description":"Customer's linked pages","x-description-i18n":{"vie":"Danh sách page khách hàng"},"items":{"type":"object","properties":{"id":{"type":"string","description":"Page ID","x-description-i18n":{"vie":"Mã page"}},"name":{"type":"string","description":"Page name","x-description-i18n":{"vie":"Tên page"}},"platform":{"type":"string","description":"Platform","x-description-i18n":{"vie":"Nền tảng"}}}}},"date_of_birth":{"type":"string","format":"date","description":"Date of birth","x-description-i18n":{"vie":"Ngày sinh"}},"reward_point":{"type":"number","description":"Reward point","x-description-i18n":{"vie":"Điểm thưởng"}},"is_discount_by_level":{"type":"boolean","description":"Discount based on level","x-description-i18n":{"vie":"Giảm giá theo cấp độ"}},"tags":{"type":"array","description":"Customer tags","x-description-i18n":{"vie":"Thẻ khách hàng"},"items":{"type":"string"}},"is_block":{"type":"boolean","description":"Block customer","x-description-i18n":{"vie":"Chặn khách hàng"}},"assigned_user_id":{"type":"string","description":"Assigned employee ID","x-description-i18n":{"vie":"Mã nhân viên được phân công"}},"level_id":{"type":"string","description":"Customer level ID","x-description-i18n":{"vie":"Mã cấp độ khách hàng"}},"notes":{"type":"array","description":"Customer notes","x-description-i18n":{"vie":"Ghi chú khách hàng"},"items":{"type":"object","properties":{"id":{"type":"string","description":"Note ID","x-description-i18n":{"vie":"Mã ghi chú"}},"message":{"type":"string","description":"Note content","x-description-i18n":{"vie":"Nội dung ghi chú"}},"images":{"type":"array","description":"Note images","x-description-i18n":{"vie":"Hình ảnh ghi chú"},"items":{"type":"object","properties":{"url":{"type":"string","format":"uri"}}}}}}},"shop_customer_address":{"type":"array","description":"Customer addresses","x-description-i18n":{"vie":"Địa chỉ khách hàng"},"items":{"type":"object","properties":{"id":{"type":"string","description":"Address ID (include to update, omit to create new)","x-description-i18n":{"vie":"Mã địa chỉ (thêm để cập nhật, bỏ để tạo mới)"}},"country_code":{"type":"integer","description":"Country code","x-description-i18n":{"vie":"Mã quốc gia"}},"province_id":{"type":"string","description":"Province ID","x-description-i18n":{"vie":"Mã tỉnh thành"}},"district_id":{"type":"string","description":"District ID","x-description-i18n":{"vie":"Mã quận huyện"}},"commune_id":{"type":"string","description":"Commune ID","x-description-i18n":{"vie":"Mã phường xã"}},"address":{"type":"string","description":"Address","x-description-i18n":{"vie":"Địa chỉ"}},"full_address":{"type":"string","description":"Full address","x-description-i18n":{"vie":"Địa chỉ đầy đủ"}},"full_name":{"type":"string","description":"Recipient name","x-description-i18n":{"vie":"Tên người nhận"}},"phone_number":{"type":"string","description":"Phone number","x-description-i18n":{"vie":"Số điện thoại"}}}}},"order_count":{"type":"integer","description":"Order count","x-description-i18n":{"vie":"Số lượng đơn hàng"}},"purchased_amount":{"type":"integer","description":"Purchased amount","x-description-i18n":{"vie":"Tổng giá trị mua"}},"succeed_order_count":{"type":"integer","description":"Succeed order count","x-description-i18n":{"vie":"Số lượng đơn hàng thành công"}},"last_order_at":{"type":"string","format":"date-time","description":"Last order at","x-description-i18n":{"vie":"Thời điểm đơn hàng cuối"}},"conversation_link":{"type":"string","format":"uri","description":"Conversation link","x-description-i18n":{"vie":"Liên kết cuộc trò chuyện"}},"referral_code":{"type":"string","description":"Referral code","x-description-i18n":{"vie":"Mã giới thiệu"}},"fb_id":{"type":"string","description":"Facebook ID","x-description-i18n":{"vie":"Facebook ID"}},"customer_id":{"type":"string","description":"Customer ID","x-description-i18n":{"vie":"Mã khách hàng"}}}},"eCommerceProduct":{"type":"object","description":"eCommerce platform product information","x-description-i18n":{"vie":"Thông tin sản phẩm trên sàn thương mại điện tử"},"properties":{"id":{"type":"string","description":"Product ID on eCommerce platform","x-description-i18n":{"vie":"Mã sản phẩm trên sàn"},"example":"46152996242"},"linked_product_custom_id":{"type":"string","description":"Linked product ID","x-description-i18n":{"vie":"Mã sản phẩm liên kết"},"example":"ANPR"},"linked_product_name":{"type":"string","description":"Linked product name","x-description-i18n":{"vie":"Tên sản phẩm liên kết"},"example":"Áo nam Pari đẹp thời trang"},"marketplace_id":{"type":"string","description":"Marketplace ID","x-description-i18n":{"vie":"Mã sàn thương mại điện tử"},"example":"-3"},"marketplace_shop_name":{"type":"string","description":"Marketplace shop name","x-description-i18n":{"vie":"Tên shop trên sàn thương mại điện tử"},"example":"Vũ Sơn shop"},"name":{"type":"string","description":"Product name on eCommerce platform","x-description-i18n":{"vie":"Tên sản phẩm trên sàn thương mại điện tử"},"example":"Áo nam Pari đẹp thời trang"},"price":{"type":"integer","description":"Product price","x-description-i18n":{"vie":"Giá sản phẩm"},"example":0},"sku":{"type":"string","description":"Product SKU","x-description-i18n":{"vie":"Mã SKU sản phẩm"},"example":"ANPR"},"variations":{"type":"array","description":"Product variations","x-description-i18n":{"vie":"Danh sách mẫu mã sản phẩm"},"items":{"type":"object","properties":{"id":{"type":"string","description":"Variation ID on eCommerce platform","x-description-i18n":{"vie":"Mã mẫu mã trên sàn thương mại điện tử"},"example":"375286372857"},"images":{"type":"array","description":"Variation images","x-description-i18n":{"vie":"Danh sách hình ảnh mẫu mã"},"items":{"type":"string","format":"uri","example":"https://content.pancake.vn/user-content-dev2.pancake.vn/2025/9/17/abad91b33fa9a051b86d415f6cf63aba00d360ac.jpg"}},"linked_product_custom_id":{"type":"string","description":"Linked product custom ID","x-description-i18n":{"vie":"Mã sản phẩm liên kết"},"example":"ANPR"},"linked_variation_custom_id":{"type":"string","description":"Linked variation ID","x-description-i18n":{"vie":"Mã mẫu mã liên kết"},"example":"TESTMATDOS"},"linked_variation_fields":{"type":"array","description":"Linked variation fields","x-description-i18n":{"vie":"Thông tin thuộc tính mẫu mã liên kết"},"items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Field ID","x-description-i18n":{"vie":"ID thuộc tính"},"example":"2b61c249-35dc-4b79-a3aa-a173c63a8061"},"keyValue":{"type":"string","description":"Field key value","x-description-i18n":{"vie":"Giá trị thuộc tính"},"example":"BLUE"},"name":{"type":"string","description":"Field name","x-description-i18n":{"vie":"Tên thuộc tính"},"example":"color"},"value":{"type":"string","description":"Field value","x-description-i18n":{"vie":"Giá trị thuộc tính"},"example":"blue"}}}},"linked_variation_price":{"type":"integer","description":"Linked variation price","x-description-i18n":{"vie":"Giá mẫu mã liên kết"},"example":150000},"name":{"type":"string","description":"Variation name","x-description-i18n":{"vie":"Tên mẫu mã"},"example":"blue L"},"price":{"type":"integer","description":"Variation price","x-description-i18n":{"vie":"Giá mẫu mã"},"example":165000},"quantity":{"type":"integer","description":"Variation quantity","x-description-i18n":{"vie":"Số lượng mẫu mã"},"example":1025},"sku":{"type":"string","description":"Variation SKU","x-description-i18n":{"vie":"Mã SKU mẫu mã"},"example":"TESTMATDOS"}}}},"warehouse":{"type":"string","description":"Warehouse name","x-description-i18n":{"vie":"Tên kho hàng"},"example":"Kho HN"}}},"Transaction":{"type":"object","description":"Transaction information","x-description-i18n":{"vie":"Thông tin thu chi"},"properties":{"id":{"type":"string","description":"Transaction ID","x-description-i18n":{"vie":"Mã thu chi"}},"display_id":{"type":"string","description":"Transaction ID","x-description-i18n":{"vie":"Mã thu chi"}},"name":{"type":"string","description":"Transaction name","x-description-i18n":{"vie":"Tên giao dịch"}},"note":{"type":"string","description":"Note","x-description-i18n":{"vie":"Ghi chú"}},"amount":{"type":"integer","description":"Amount of money","x-description-i18n":{"vie":"Số tiền"}},"status":{"type":"integer","description":"Status","x-description-i18n":{"vie":"Trạng thái"},"enum":[-1,0,1,2,3],"x-enum-descriptions":["All status","New","Effective","Canceled","Deleted"],"x-enum-descriptions-i18n":{"vie":["Tất cả trạng thái","Mới","Có hiệu lực","Đã hủy","Đã xóa"]}},"is_locked":{"type":"boolean","description":"Locked","x-description-i18n":{"vie":"Khóa"}},"is_canceled":{"type":"boolean","description":"Is canceled","x-description-i18n":{"vie":"Đã hủy"}},"is_accounting":{"type":"boolean","description":"Financial accounting","x-description-i18n":{"vie":"Kế toán tài chính"}},"payment_debts_to_suppliers":{"type":"boolean","description":"Paying off debts to suppliers","x-description-i18n":{"vie":"Trả nợ nhà cung cấp"}},"payments":{"type":"array","description":"Payment method","x-description-i18n":{"vie":"Phương thức thanh toán"},"items":{"type":"string"}},"tag_ids":{"type":"array","description":"Transaction tags","x-description-i18n":{"vie":"Thẻ giao dịch"},"items":{"type":"string"}},"supplier_products_id":{"type":"integer","description":"Supplier products ID","x-description-i18n":{"vie":"Mã nhà cung cấp"}},"advertising_cost_id":{"type":"string","description":"Advertising cost ID","x-description-i18n":{"vie":"Mã chi phí quảng cáo"}},"shop_id":{"type":"integer","description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},"creator_id":{"type":"string","description":"Creator ID","x-description-i18n":{"vie":"Mã người tạo"}},"creator":{"type":"object","description":"Creator information","x-description-i18n":{"vie":"Thông tin người tạo"},"properties":{"id":{"type":"string"},"name":{"type":"string"},"fb_id":{"type":"string"},"avatar_url":{"type":"string","format":"uri"}}},"images":{"type":"array","description":"Image links","x-description-i18n":{"vie":"Link hình ảnh"},"items":{"type":"string","format":"uri"}},"inserted_at":{"type":"string","format":"date-time","description":"Inserted at","x-description-i18n":{"vie":"Thời điểm tạo"}},"time_incurred":{"type":"string","format":"date-time","description":"Time incurred","x-description-i18n":{"vie":"Thời điểm phát sinh"}},"table_name":{"type":"string","description":"Table name","x-description-i18n":{"vie":"Tên bảng"}},"orderId":{"type":"string","description":"Order ID","x-description-i18n":{"vie":"Mã đơn hàng"}}}},"Debt":{"type":"object","description":"Debt information","x-description-i18n":{"vie":"Thông tin công nợ"},"properties":{"id":{"type":"string","description":"Debt ID","x-description-i18n":{"vie":"Mã công nợ"}},"display_id":{"type":"integer","description":"Debt ID","x-description-i18n":{"vie":"Mã công nợ"}},"name_debt":{"type":"string","description":"Debt name","x-description-i18n":{"vie":"Tên công nợ"}},"description":{"type":"string","description":"Description","x-description-i18n":{"vie":"Mô tả"}},"status":{"type":"integer","description":"Status","x-description-i18n":{"vie":"Trạng thái"},"enum":[-1,0,1,2],"x-enum-descriptions":["All status","Not transacted / Partial payment","Traded","Canceled"],"x-enum-descriptions-i18n":{"vie":["Tất cả trạng thái","Chưa giao dịch / Thanh toán một phần","Đã giao dịch","Đã hủy"]}},"type":{"type":"integer","description":"Debt type (0: Debt must pay / 1: Debt must collect)","x-description-i18n":{"vie":"Loại công nợ (0: Công nợ phải trả / 1: Công nợ phải thu)"}},"money_must_pay_or_collect":{"type":"integer","description":"Total amount to be paid / Total amount to be collected","x-description-i18n":{"vie":"Tổng số tiền phải trả / Tổng số tiền phải thu"}},"money_payed_or_collected":{"type":"integer","description":"Paid amount / Collected amount","x-description-i18n":{"vie":"Số tiền đã trả / Số tiền đã thu"}},"currency":{"type":"string","description":"Currency","x-description-i18n":{"vie":"Tiền tệ"}},"shop_id":{"type":"integer","description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},"shop_customer_id":{"type":"string","description":"Customer ID","x-description-i18n":{"vie":"Mã khách hàng"}},"shop_customer":{"type":"object","description":"Customer information","x-description-i18n":{"vie":"Thông tin khách hàng"},"properties":{"id":{"type":"string"},"name":{"type":"string"},"phone_numbers":{"type":"array","items":{"type":"string"}},"customer":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"fb_id":{"type":"string"},"global_id":{"type":"string"},"psid":{"type":"string"}}}}},"order_id":{"type":"integer","description":"Order ID","x-description-i18n":{"vie":"Mã đơn hàng"}},"order":{"type":"object","description":"Order information","x-description-i18n":{"vie":"Thông tin đơn hàng"},"properties":{"id":{"type":"integer"},"display_id":{"type":"integer"},"custom_id":{"type":"string"},"total_price":{"type":"integer"},"cod":{"type":"integer"},"assigning_seller_id":{"type":"string"},"assigning_seller":{"type":"object"},"items":{"type":"array"}}},"purchase_id":{"type":"string","description":"Purchase ID","x-description-i18n":{"vie":"Mã phiếu nhập kho"}},"export_id":{"type":"string","description":"Export ID","x-description-i18n":{"vie":"Mã phiếu xuất kho"}},"supplier_products_id":{"type":"integer","description":"Supplier products ID","x-description-i18n":{"vie":"Mã nhà cung cấp"}},"transaction_id":{"type":"string","description":"Transaction ID","x-description-i18n":{"vie":"Mã thu chi"}},"partner_id":{"type":"string","description":"Partner ID","x-description-i18n":{"vie":"Mã đối tác"}},"creator_id":{"type":"string","description":"Creator ID","x-description-i18n":{"vie":"Mã người tạo"}},"last_editor_id":{"type":"string","description":"Last editor ID","x-description-i18n":{"vie":"Mã người chỉnh sửa cuối"}},"user":{"type":"object","description":"Creator information","x-description-i18n":{"vie":"Thông tin người tạo"},"properties":{"id":{"type":"string"},"name":{"type":"string"},"fb_id":{"type":"string"},"phone_number":{"type":"string"}}},"inserted_at":{"type":"string","format":"date-time","description":"Inserted at","x-description-i18n":{"vie":"Thời điểm tạo"}},"updated_at":{"type":"string","format":"date-time","description":"Updated at","x-description-i18n":{"vie":"Thời điểm cập nhật"}},"expired_at":{"type":"string","format":"date-time","description":"Expired at","x-description-i18n":{"vie":"Thời điểm hết hạn"}},"is_locked":{"type":"boolean","description":"Debt locked","x-description-i18n":{"vie":"Công nợ đã khóa"}},"link":{"type":"string","format":"uri","description":"Link","x-description-i18n":{"vie":"Liên kết"}}}},"Project":{"type":"object","description":"Project information","x-description-i18n":{"vie":"Thông tin dự án"},"properties":{"id":{"type":"integer","description":"Project ID","x-description-i18n":{"vie":"Mã dự án"}},"image":{"type":"string","nullable":true,"format":"uri","description":"Project image URL","x-description-i18n":{"vie":"URL hình ảnh dự án"}},"inserted_at":{"type":"string","format":"date-time","description":"Created timestamp","x-description-i18n":{"vie":"Thời điểm tạo"}},"name":{"type":"string","description":"Project name","x-description-i18n":{"vie":"Tên dự án"}},"nodes":{"type":"array","description":"Child source orders of project","x-description-i18n":{"vie":"Danh sách nguồn đơn hàng thuộc dự án"},"items":{"$ref":"#/components/schemas/ProjectNode"}},"shop_id":{"type":"integer","description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},"updated_at":{"type":"string","format":"date-time","description":"Updated timestamp","x-description-i18n":{"vie":"Thời điểm cập nhật"}}}},"ProjectNode":{"type":"object","description":"Project node information","x-description-i18n":{"vie":"Thông tin nút dự án"},"properties":{"id":{"type":"integer","description":"Source order ID","x-description-i18n":{"vie":"Mã nguồn đơn hàng"}},"image":{"type":"string","nullable":true,"format":"uri","description":"Source order image URL","x-description-i18n":{"vie":"URL hình ảnh nguồn đơn hàng"}},"inserted_at":{"type":"string","format":"date-time","description":"Created timestamp","x-description-i18n":{"vie":"Thời điểm tạo"}},"name":{"type":"string","description":"Source order name","x-description-i18n":{"vie":"Tên nguồn đơn hàng"}},"nodes":{"type":"array","description":"Child source orders","x-description-i18n":{"vie":"Danh sách nguồn đơn hàng con"},"items":{"$ref":"#/components/schemas/ProjectNode"}},"parent_id":{"type":"integer","nullable":true,"description":"Parent source order ID","x-description-i18n":{"vie":"Mã nguồn đơn hàng cha"}},"project_id":{"type":"integer","nullable":true,"description":"Project ID","x-description-i18n":{"vie":"Mã dự án"}},"shop_id":{"type":"integer","description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},"updated_at":{"type":"string","format":"date-time","description":"Updated timestamp","x-description-i18n":{"vie":"Thời điểm cập nhật"}},"custom_id":{"type":"string","nullable":true,"description":"Custom source order ID","x-description-i18n":{"vie":"Mã tùy chỉnh nguồn đơn hàng"}},"link_source_id":{"type":"integer","nullable":true,"description":"Link source ID","x-description-i18n":{"vie":"Mã nguồn liên kết"}}}},"Category":{"type":"object","properties":{"data":{"type":"object","description":"Product category information","x-description-i18n":{"vie":"Thông tin danh mục sản phẩm"},"properties":{"id":{"type":"integer","description":"Category ID","x-description-i18n":{"vie":"Mã danh mục"}},"name":{"type":"string","description":"Category name","x-description-i18n":{"vie":"Tên danh mục"}}}},"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}}}},"Brand":{"type":"object","description":"Product brand information","x-description-i18n":{"vie":"Thông tin thương hiệu sản phẩm"},"properties":{"id":{"type":"string","format":"uuid","description":"Brand ID","x-description-i18n":{"vie":"Mã thương hiệu"}},"name":{"type":"string","description":"Brand name","x-description-i18n":{"vie":"Tên thương hiệu"}},"description":{"type":"string","nullable":true,"description":"Brand description","x-description-i18n":{"vie":"Mô tả thương hiệu"}},"display_id":{"type":"integer","description":"Display ID","x-description-i18n":{"vie":"Mã hiển thị"}},"shop_id":{"type":"integer","description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},"inserted_at":{"type":"string","format":"date-time","description":"Created time","x-description-i18n":{"vie":"Thời gian tạo"}},"updated_at":{"type":"string","format":"date-time","description":"Updated time","x-description-i18n":{"vie":"Thời gian cập nhật"}}}},"Purchase":{"type":"object","description":"Purchase information","x-description-i18n":{"vie":"Thông tin phiếu nhập kho"},"properties":{"id":{"type":"string","description":"Purchase ID","x-description-i18n":{"vie":"Mã phiếu nhập kho"}},"display_id":{"type":"integer","description":"Purchase ID","x-description-i18n":{"vie":"Mã phiếu nhập kho"}},"status":{"type":"integer","description":"Status","x-description-i18n":{"vie":"Trạng thái"},"enum":[-2,-1,0,1,2],"x-enum-descriptions":["All status","New","Confirmed","Imported goods","Canceled"],"x-enum-descriptions-i18n":{"vie":["Tất cả trạng thái","Mới","Đã xác nhận","Đã nhập hàng","Đã hủy"]}},"time_import":{"type":"string","format":"date-time","description":"Time import","x-description-i18n":{"vie":"Thời gian nhập hàng"}},"total_quantity":{"type":"integer","description":"Total quantity","x-description-i18n":{"vie":"Tổng số lượng"}},"total_remain_quantity":{"type":"integer","description":"Total remain quantity","x-description-i18n":{"vie":"Tổng số lượng tồn"}},"total_price":{"type":"integer","description":"Total purchase price","x-description-i18n":{"vie":"Tổng giá trị nhập kho"}},"total_remain_price":{"type":"integer","description":"Total remain price","x-description-i18n":{"vie":"Tổng giá trị tồn"}},"note":{"type":"string","description":"Note","x-description-i18n":{"vie":"Ghi chú"}},"warehouse_id":{"type":"string","description":"Warehouse ID","x-description-i18n":{"vie":"Mã kho"}},"supplier_products_id":{"type":"integer","description":"Supplier products ID","x-description-i18n":{"vie":"Mã nhà cung cấp"}},"supplier":{"type":"object","description":"Supplier information","x-description-i18n":{"vie":"Thông tin nhà cung cấp"},"properties":{"id":{"type":"integer"},"name":{"type":"string"},"custom_id":{"type":"string"}}},"discount":{"type":"integer","description":"Discount","x-description-i18n":{"vie":"Giảm giá"}},"transport_fee":{"type":"integer","description":"Shipping fee","x-description-i18n":{"vie":"Phí vận chuyển"}},"prepaid_debt":{"type":"integer","description":"Prepaid debt","x-description-i18n":{"vie":"Trả trước NCC"}},"auto_create_debts":{"type":"boolean","description":"Auto create debts","x-description-i18n":{"vie":"Tạo công nợ theo nhà cung cấp"}},"not_create_transaction":{"type":"boolean","description":"Not create transaction","x-description-i18n":{"vie":"Không tạo phiếu chi"}},"is_lock":{"type":"boolean","description":"Locked","x-description-i18n":{"vie":"Khóa"}},"created_type":{"type":"string","description":"Purchase type","x-description-i18n":{"vie":"Loại phiếu nhập kho"}},"tags":{"type":"array","description":"Tag IDs","x-description-i18n":{"vie":"Danh sách mã thẻ"},"items":{"type":"integer"}},"tag_info":{"type":"array","description":"Purchase tag information","x-description-i18n":{"vie":"Thông tin thẻ phiếu nhập kho"},"items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"}}}},"items":{"type":"array","description":"Variation information","x-description-i18n":{"vie":"Thông tin mẫu mã"},"items":{"type":"object","properties":{"id":{"type":"string"},"imported_price":{"type":"integer","description":"Imported price","x-description-i18n":{"vie":"Giá nhập"}},"gross_price":{"type":"integer","description":"Gross price","x-description-i18n":{"vie":"Giá gốc"}},"discount":{"type":"integer","description":"Discount on product","x-description-i18n":{"vie":"Chiết khấu trên sản phẩm"}},"quantity":{"type":"integer","description":"Import quantity","x-description-i18n":{"vie":"Số lượng nhập"}},"variation_id":{"type":"string","description":"Variation ID","x-description-i18n":{"vie":"Mã mẫu mã"}},"product_name":{"type":"string","description":"Product name","x-description-i18n":{"vie":"Tên sản phẩm"}},"note_purchase":{"type":"string","description":"Note","x-description-i18n":{"vie":"Ghi chú"}},"selling_status":{"type":"string","description":"Selling status","x-description-i18n":{"vie":"Trạng thái bán"}},"variation":{"type":"object","properties":{"id":{"type":"string"},"display_id":{"type":"string"},"barcode":{"type":"string"},"product_id":{"type":"string"},"retail_price":{"type":"integer"},"retail_price_after_discount":{"type":"integer"},"remain_quantity":{"type":"integer"},"weight":{"type":"integer"},"product":{"type":"object","properties":{"display_id":{"type":"string"},"name":{"type":"string"}}},"variations_warehouses":{"type":"array","items":{"$ref":"#/components/schemas/VariationWarehouse"}}}}}}},"images":{"type":"array","description":"Purchase images","x-description-i18n":{"vie":"Link hình ảnh nhập hàng"},"items":{"type":"string","format":"uri"}},"bill_images":{"type":"array","description":"Invoice images","x-description-i18n":{"vie":"Link hình ảnh hóa đơn"},"items":{"type":"string","format":"uri"}},"user_id":{"type":"string","description":"Creator ID","x-description-i18n":{"vie":"Mã người tạo"}},"user":{"type":"object","description":"Creator information","x-description-i18n":{"vie":"Thông tin người tạo"},"properties":{"id":{"type":"string"},"name":{"type":"string"},"fb_id":{"type":"string"},"avatar_url":{"type":"string","format":"uri"}}},"inserted_at":{"type":"string","format":"date-time","description":"Inserted at","x-description-i18n":{"vie":"Thời điểm tạo"}},"updated_at":{"type":"string","format":"date-time","description":"Updated at","x-description-i18n":{"vie":"Thời điểm cập nhật"}},"received_at":{"type":"string","format":"date-time","description":"Received at","x-description-i18n":{"vie":"Ngày về dự kiến"}},"separate_by_display_ids":{"type":"integer","description":"Purchase ID separated","x-description-i18n":{"vie":"Mã phiếu nhập kho đã tách"}}}},"Export":{"type":"object","description":"Export information","x-description-i18n":{"vie":"Thông tin phiếu xuất kho"},"properties":{"id":{"type":"string","description":"Export ID","x-description-i18n":{"vie":"Mã phiếu xuất kho"}},"display_id":{"type":"integer","description":"Export ID","x-description-i18n":{"vie":"Mã phiếu xuất kho"}},"status":{"type":"integer","description":"Export status","x-description-i18n":{"vie":"Trạng thái phiếu xuất"},"enum":[0,1,2],"x-enum-descriptions":["New (type 0) / Defect export (type 1)","Completed (type 0) / Elimination export (type 1)","Canceled"],"x-enum-descriptions-i18n":{"vie":["Mới (type 0) / Xuất hàng lỗi (type 1)","Hoàn tất (type 0) / Xuất bỏ (type 1)","Đã hủy"]}},"type":{"type":"integer","description":"Type of export","x-description-i18n":{"vie":"Loại phiếu xuất kho"},"enum":[0,1],"x-enum-descriptions":["Normal export","Product defect export"],"x-enum-descriptions-i18n":{"vie":["Phiếu xuất thường","Xuất hàng lỗi"]}},"total":{"type":"integer","description":"Total quantity","x-description-i18n":{"vie":"Tổng số lượng"}},"total_price":{"type":"integer","description":"Total export price","x-description-i18n":{"vie":"Tổng giá trị xuất kho"}},"note":{"type":"string","description":"Note","x-description-i18n":{"vie":"Ghi chú"}},"warehouse_id":{"type":"string","description":"Warehouse ID","x-description-i18n":{"vie":"Mã kho"}},"supplier_products_id":{"type":"integer","description":"Supplier products ID","x-description-i18n":{"vie":"Mã nhà cung cấp"}},"tags":{"type":"array","description":"Tag IDs","x-description-i18n":{"vie":"Danh sách mã thẻ"},"items":{"type":"integer"}},"export_items":{"type":"array","description":"List of products","x-description-i18n":{"vie":"Danh sách sản phẩm"},"items":{"type":"object","properties":{"id":{"type":"string","description":"Export item ID","x-description-i18n":{"vie":"Mã sản phẩm xuất kho"}},"imported_price":{"type":"integer","description":"Export price","x-description-i18n":{"vie":"Giá xuất kho"}},"quantity":{"type":"integer","description":"Export quantity","x-description-i18n":{"vie":"Số lượng xuất kho"}},"variation_id":{"type":"string","description":"Variation ID","x-description-i18n":{"vie":"Mã mẫu mã"}},"display_id":{"type":"integer","description":"Display ID","x-description-i18n":{"vie":"Mã hiển thị"}},"inserted_at":{"type":"string","format":"date-time","description":"Inserted at","x-description-i18n":{"vie":"Thời điểm tạo"}}}}},"images":{"type":"array","description":"Export images","x-description-i18n":{"vie":"Link hình ảnh phiếu xuất kho"},"items":{"type":"string","format":"uri"}},"user_id":{"type":"string","description":"Creator ID","x-description-i18n":{"vie":"Mã người tạo"}},"user":{"type":"object","description":"Creator information","x-description-i18n":{"vie":"Thông tin người tạo"},"properties":{"id":{"type":"string"},"name":{"type":"string"},"fb_id":{"type":"string"},"avatar_url":{"type":"string","format":"uri"}}},"inserted_at":{"type":"string","format":"date-time","description":"Inserted at","x-description-i18n":{"vie":"Thời điểm tạo"}},"updated_at":{"type":"string","format":"date-time","description":"Updated at","x-description-i18n":{"vie":"Thời điểm cập nhật"}}}},"WarehouseTransfer":{"type":"object","description":"Warehouse transfer information","x-description-i18n":{"vie":"Thông tin chuyển kho"},"properties":{"id":{"type":"string","description":"Transfer ID","x-description-i18n":{"vie":"Mã chuyển kho"}},"display_id":{"type":"integer","description":"Transfer ID","x-description-i18n":{"vie":"Mã chuyển kho"}},"status":{"type":"integer","description":"Status","x-description-i18n":{"vie":"Trạng thái"},"enum":[0,1,2],"x-enum-descriptions":["Waiting for pick up","Shipping","Completed"],"x-enum-descriptions-i18n":{"vie":["Chờ chuyển hàng","Đang chuyển hàng","Hoàn tất"]}},"from_warehouse_id":{"type":"string","description":"From warehouse ID","x-description-i18n":{"vie":"Mã kho đi"}},"from_warehouse_name":{"type":"string","description":"From warehouse name","x-description-i18n":{"vie":"Tên kho đi"}},"to_warehouse_id":{"type":"string","description":"To warehouse ID","x-description-i18n":{"vie":"Mã kho đến"}},"to_warehouse_name":{"type":"string","description":"To warehouse name","x-description-i18n":{"vie":"Tên kho đến"}},"total_quantity":{"type":"integer","description":"Total quantity","x-description-i18n":{"vie":"Tổng số lượng"}},"shipping_fee":{"type":"integer","description":"Shipping fee","x-description-i18n":{"vie":"Phí vận chuyển"}},"note":{"type":"string","description":"Note","x-description-i18n":{"vie":"Ghi chú"}},"items":{"type":"array","description":"List of products","x-description-i18n":{"vie":"Danh sách sản phẩm"},"items":{"type":"object","properties":{"id":{"type":"string","description":"Transfer item ID","x-description-i18n":{"vie":"Mã sản phẩm chuyển kho"}},"variation_id":{"type":"string","description":"Variation ID","x-description-i18n":{"vie":"Mã mẫu mã"}},"quantity":{"type":"integer","description":"Transfer quantity","x-description-i18n":{"vie":"Số lượng chuyển kho"}},"product_display_id":{"type":"string","description":"Product ID","x-description-i18n":{"vie":"Mã sản phẩm"}},"product_name":{"type":"string","description":"Product name","x-description-i18n":{"vie":"Tên sản phẩm"}},"variation_display_id":{"type":"string","description":"Variation ID","x-description-i18n":{"vie":"Mã mẫu mã"}},"variation_fields":{"type":"array","description":"Variation fields","x-description-i18n":{"vie":"Trường mẫu mã"},"items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"value":{"type":"string"},"keyValue":{"type":"string"}}}}}}},"images":{"type":"array","description":"Transfer images","x-description-i18n":{"vie":"Link hình ảnh chuyển kho"},"items":{"type":"string","format":"uri"}},"shop_id":{"type":"integer","description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},"creator_id":{"type":"string","description":"Creator ID","x-description-i18n":{"vie":"Mã người tạo"}},"inserted_at":{"type":"string","format":"date-time","description":"Inserted at","x-description-i18n":{"vie":"Thời điểm tạo"}},"updated_status_at":{"type":"string","format":"date-time","description":"Updated status at","x-description-i18n":{"vie":"Thời điểm cập nhật trạng thái"}}}},"Stocktaking":{"type":"object","description":"Stocktaking information","x-description-i18n":{"vie":"Thông tin kiểm hàng"},"properties":{"id":{"type":"string","description":"Stocktaking ID","x-description-i18n":{"vie":"Mã phiếu kiểm"}},"display_id":{"type":"integer","description":"Stocktaking ID","x-description-i18n":{"vie":"Mã phiếu kiểm"}},"status":{"type":"integer","description":"Status","x-description-i18n":{"vie":"Trạng thái"},"enum":[-2,-1,0,1,2],"x-enum-descriptions":["All status","Creating","Stocktaking","Stocktook","Canceled"],"x-enum-descriptions-i18n":{"vie":["Tất cả trạng thái","Đang tạo","Đang kiểm hàng","Đã kiểm hàng","Đã hủy"]}},"warehouse_id":{"type":"string","description":"Warehouse ID","x-description-i18n":{"vie":"Mã kho"}},"stocktaking_by":{"type":"string","description":"Stocktaking by","x-description-i18n":{"vie":"Kiểm hàng theo"}},"stocktaking_by_value":{"type":"array","description":"Category ID / Supplier products ID / Brand ID","x-description-i18n":{"vie":"Danh sách mã danh mục / nhà cung cấp / thương hiệu"},"items":{"type":"string"}},"stocktaking_at":{"type":"string","format":"date-time","description":"Stocktaking at","x-description-i18n":{"vie":"Kiểm hàng lúc"}},"progress":{"type":"integer","description":"Processing percentage","x-description-i18n":{"vie":"Phần trăm xử lý"}},"note":{"type":"string","description":"Note","x-description-i18n":{"vie":"Ghi chú"}},"items":{"type":"array","description":"List of products","x-description-i18n":{"vie":"Danh sách sản phẩm"},"items":{"type":"object","properties":{"id":{"type":"string","description":"Stocktaking item ID","x-description-i18n":{"vie":"Mã hạng mục kiểm hàng"}},"variation_id":{"type":"string","description":"Variation ID","x-description-i18n":{"vie":"Mã mẫu mã"}},"changed_quantity":{"type":"integer","description":"Changed quantity","x-description-i18n":{"vie":"Số lượng thay đổi"}},"current_quantity":{"type":"integer","description":"Current quantity","x-description-i18n":{"vie":"Số lượng hiện tại"}},"note":{"type":"string","description":"Note","x-description-i18n":{"vie":"Ghi chú"}},"variation":{"type":"object","description":"Variation information","x-description-i18n":{"vie":"Thông tin mẫu mã"},"properties":{"id":{"type":"string"},"display_id":{"type":"string"},"barcode":{"type":"string"},"product_id":{"type":"string"},"retail_price":{"type":"integer"},"last_imported_price":{"type":"integer"},"weight":{"type":"integer"},"fields":{"type":"array","items":{"type":"object"}},"images":{"type":"array","items":{"type":"string","format":"uri"}},"product":{"type":"object","properties":{"display_id":{"type":"string"},"name":{"type":"string"},"image":{"type":"string","format":"uri"},"note_product":{"type":"string"},"note":{"type":"string","description":"Internal note","x-description-i18n":{"vie":"Ghi chú nội bộ"}}}}}},"inserted_at":{"type":"string","format":"date-time","description":"Inserted at","x-description-i18n":{"vie":"Thời điểm tạo"}},"updated_at":{"type":"string","format":"date-time","description":"Updated at","x-description-i18n":{"vie":"Thời điểm cập nhật"}}}}},"shop_id":{"type":"integer","description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},"creator_id":{"type":"string","description":"Creator ID","x-description-i18n":{"vie":"Mã người tạo"}},"inserted_at":{"type":"string","format":"date-time","description":"Inserted at","x-description-i18n":{"vie":"Thời điểm tạo"}},"updated_at":{"type":"string","format":"date-time","description":"Updated at","x-description-i18n":{"vie":"Thời điểm cập nhật"}},"updated_status_at":{"type":"string","format":"date-time","description":"Updated status at","x-description-i18n":{"vie":"Thời điểm cập nhật trạng thái"}}}},"CallLater":{"type":"object","description":"Call later and remind information","x-description-i18n":{"vie":"Thông tin hẹn gọi & nhắc nhở"},"properties":{"id":{"type":"string","description":"ID","x-description-i18n":{"vie":"Mã"}},"display_id":{"type":"integer","description":"Call later and remind ID","x-description-i18n":{"vie":"Mã hẹn gọi & nhắc nhở"}},"called_at":{"type":"string","format":"date-time","description":"Called at / Process at","x-description-i18n":{"vie":"Thời điểm gọi / Thời điểm xử lý"}},"needs_call_at":{"type":"string","format":"date-time","description":"Need call at / Need process at","x-description-i18n":{"vie":"Thời điểm cần gọi / Thời điểm cần xử lý"}},"notice_created":{"type":"string","description":"Notice information","x-description-i18n":{"vie":"Thông tin thông báo"}},"order_display_id":{"type":"string","description":"Order ID","x-description-i18n":{"vie":"Mã đơn hàng"}},"order_id":{"type":"integer","description":"Order ID","x-description-i18n":{"vie":"Mã đơn hàng"}},"status":{"type":"integer","description":"Status","x-description-i18n":{"vie":"Trạng thái"},"enum":[-1,0,3,1,2,7],"x-enum-descriptions":["All status","No process","Calling / Processing","Processed","Not listening / Unsuccessful","Removed"],"x-enum-descriptions-i18n":{"vie":["Tất cả trạng thái","Chưa xử lý","Đang gọi / Đang xử lý","Đã xử lý","Không nghe máy / Không thành công","Đã xóa"]}},"type":{"type":"string","description":"Notification type","x-description-i18n":{"vie":"Loại thông báo"}},"need_notify_users":{"type":"array","description":"Process staff","x-description-i18n":{"vie":"Nhân viên xử lý"},"items":{"type":"string"}},"creator":{"type":"object","description":"Creator information","x-description-i18n":{"vie":"Thông tin người tạo"},"properties":{"id":{"type":"string"},"name":{"type":"string"},"email":{"type":"string"},"fb_id":{"type":"string"},"avatar_url":{"type":"string","format":"uri"},"phone_number":{"type":"string"}}},"phone_number":{"type":"string","description":"Phone number","x-description-i18n":{"vie":"Số điện thoại"}}}},"Voucher":{"type":"object","description":"Voucher information","x-description-i18n":{"vie":"Thông tin mã giảm giá"},"properties":{"id":{"type":"string","description":"Voucher ID","x-description-i18n":{"vie":"Mã giảm giá"}},"display_id":{"type":"integer","description":"Voucher ID","x-description-i18n":{"vie":"Mã giảm giá"}},"name":{"type":"string","description":"Voucher name","x-description-i18n":{"vie":"Tên mã giảm giá"}},"type":{"type":"string","description":"Voucher type","x-description-i18n":{"vie":"Loại mã giảm giá"}},"start_time":{"type":"string","format":"date-time","description":"Voucher start time","x-description-i18n":{"vie":"Thời điểm bắt đầu"}},"end_time":{"type":"string","format":"date-time","description":"Voucher end time","x-description-i18n":{"vie":"Thời điểm kết thúc"}},"promo_code_info":{"type":"object","description":"Voucher promo code information","x-description-i18n":{"vie":"Thông tin mã giảm giá"},"properties":{"discount":{"type":"integer","description":"Discount value","x-description-i18n":{"vie":"Giá trị giảm giá"}},"is_percent":{"type":"boolean","description":"Is percent","x-description-i18n":{"vie":"Là phần trăm"}},"max_discount_by_percent":{"type":"integer","description":"Maximum discount by percent","x-description-i18n":{"vie":"Số tiền giảm giá tối đa"}}}},"is_free_shipping":{"type":"boolean","description":"Is free shipping","x-description-i18n":{"vie":"Miễn phí vận chuyển"}},"is_activated":{"type":"boolean","description":"Is activated","x-description-i18n":{"vie":"Kích hoạt"}},"is_used":{"type":"boolean","description":"Is used","x-description-i18n":{"vie":"Đã sử dụng"}},"customer_tags":{"type":"array","description":"Customer tags","x-description-i18n":{"vie":"Thẻ khách hàng"},"items":{"type":"string"}},"shop_id":{"type":"integer","description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},"creator_id":{"type":"string","description":"Creator ID","x-description-i18n":{"vie":"Mã người tạo"}},"inserted_at":{"type":"string","format":"date-time","description":"Inserted at","x-description-i18n":{"vie":"Thời điểm tạo"}},"updated_at":{"type":"string","format":"date-time","description":"Updated at","x-description-i18n":{"vie":"Thời điểm cập nhật"}}}},"Promotion":{"type":"object","description":"Promotion information","x-description-i18n":{"vie":"Thông tin khuyến mãi"},"properties":{"id":{"type":"string","description":"Promotion ID","x-description-i18n":{"vie":"Mã khuyến mãi"}},"display_id":{"type":"string","description":"Promotion display ID","x-description-i18n":{"vie":"Mã hiển thị khuyến mãi"}},"name":{"type":"string","description":"Promotion name","x-description-i18n":{"vie":"Tên khuyến mãi"}},"type":{"type":"string","description":"Promotion type","x-description-i18n":{"vie":"Loại khuyến mãi"}},"start_time":{"type":"string","format":"date-time","description":"Start time","x-description-i18n":{"vie":"Thời điểm bắt đầu"}},"end_time":{"type":"string","format":"date-time","description":"End time","x-description-i18n":{"vie":"Thời điểm kết thúc"}},"warehouse_ids":{"type":"array","description":"Warehouse IDs","x-description-i18n":{"vie":"Danh sách mã kho"},"items":{"type":"string"}},"customer_tags":{"type":"array","description":"Customer tags","x-description-i18n":{"vie":"Thẻ khách hàng"},"items":{"type":"string"}},"order_sources":{"type":"array","description":"Order sources","x-description-i18n":{"vie":"Nguồn đơn hàng"},"items":{"type":"object"}},"group_name":{"type":"string","description":"Promotion group","x-description-i18n":{"vie":"Nhóm khuyến mãi"}},"is_activated":{"type":"boolean","description":"Is activated","x-description-i18n":{"vie":"Đã kích hoạt"}},"is_variation":{"type":"boolean","description":"Is variation","x-description-i18n":{"vie":"Khuyến mãi theo mẫu mã"}},"is_used":{"type":"boolean","description":"Is used","x-description-i18n":{"vie":"Đã sử dụng"}},"is_free_shipping":{"type":"boolean","description":"Is free shipping","x-description-i18n":{"vie":"Miễn phí vận chuyển"}},"is_discount_in_birthday_customer":{"type":"boolean","description":"Is discount in birthday customer","x-description-i18n":{"vie":"Khuyến mãi cho sinh nhật"}},"coupon_info":{"type":"object","description":"Coupon information","x-description-i18n":{"vie":"Thông tin phiếu giảm giá"},"properties":{"discount":{"type":"integer","description":"Discount","x-description-i18n":{"vie":"Giảm giá"}},"is_percent":{"type":"boolean","description":"Is percent","x-description-i18n":{"vie":"Là phần trăm"}}}},"promo_code_info":{"type":"object","description":"Promotion code information","x-description-i18n":{"vie":"Thông tin mã khuyến mãi"},"properties":{"discount":{"type":"integer","description":"Discount","x-description-i18n":{"vie":"Giảm giá"}},"is_percent":{"type":"boolean","description":"Is percent","x-description-i18n":{"vie":"Là phần trăm"}},"max_discount_by_percent":{"type":"integer","description":"Maximum discount by percent","x-description-i18n":{"vie":"Phần trăm giảm tối đa"}}}},"discount_by_quantity":{"type":"integer","description":"Discount by quantity","x-description-i18n":{"vie":"Số lượng giảm giá"}},"items":{"type":"array","description":"List of promotion items (products/variations the promotion applies to)","x-description-i18n":{"vie":"Danh sách sản phẩm/mẫu mã áp dụng khuyến mãi"},"items":{"type":"object","properties":{"id":{"type":"string","description":"Promotion item ID","x-description-i18n":{"vie":"Mã sản phẩm khuyến mãi"}},"promotion_advance_id":{"type":"string","description":"Promotion ID","x-description-i18n":{"vie":"Mã khuyến mãi"}},"shop_id":{"type":"integer","description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},"product_id":{"type":"string","nullable":true,"description":"Product ID (when promotion is applied by product)","x-description-i18n":{"vie":"Mã sản phẩm (khi khuyến mãi áp dụng theo sản phẩm)"}},"variation_id":{"type":"string","nullable":true,"description":"Variation ID (when promotion is applied by variation)","x-description-i18n":{"vie":"Mã mẫu mã (khi khuyến mãi áp dụng theo mẫu mã)"}},"category_id":{"type":"string","nullable":true,"description":"Category ID (when promotion is applied by category)","x-description-i18n":{"vie":"Mã danh mục (khi khuyến mãi áp dụng theo danh mục)"}},"product":{"type":"object","nullable":true,"description":"Product information (when promotion is applied by product)","x-description-i18n":{"vie":"Thông tin sản phẩm (khi khuyến mãi áp dụng theo sản phẩm)"}},"variation":{"type":"object","nullable":true,"description":"Variation information (when promotion is applied by variation)","x-description-i18n":{"vie":"Thông tin mẫu mã (khi khuyến mãi áp dụng theo mẫu mã)"}},"level_info":{"type":"array","description":"Discount levels by quantity","x-description-i18n":{"vie":"Mức giảm giá theo số lượng"},"items":{"type":"object","properties":{"discount":{"type":"number","description":"Discount value","x-description-i18n":{"vie":"Giá trị giảm giá"}},"is_percent":{"type":"boolean","description":"Is percent","x-description-i18n":{"vie":"Là phần trăm"}},"from_quantity":{"type":"integer","description":"From quantity","x-description-i18n":{"vie":"Số lượng từ"}},"to_quantity":{"type":"integer","description":"To quantity","x-description-i18n":{"vie":"Số lượng đến"}}}}},"fixed_prices":{"type":"number","description":"Fixed price","x-description-i18n":{"vie":"Giá cố định"}},"coupon_item_info":{"type":"object","description":"Coupon information of the item","x-description-i18n":{"vie":"Thông tin phiếu giảm giá của sản phẩm"},"properties":{"discount":{"type":"number","description":"Discount","x-description-i18n":{"vie":"Giảm giá"}},"is_percent":{"type":"boolean","description":"Is percent","x-description-i18n":{"vie":"Là phần trăm"}}}},"limited_quantity":{"type":"integer","description":"Limited quantity","x-description-i18n":{"vie":"Số lượng giới hạn"}},"limited_quantity_used":{"type":"integer","description":"Limited quantity used","x-description-i18n":{"vie":"Số lượng giới hạn đã sử dụng"}},"attachment_product_info":{"type":"array","description":"Attached product information","x-description-i18n":{"vie":"Thông tin sản phẩm đính kèm"},"items":{"type":"object","properties":{"product_id":{"type":"string","nullable":true,"description":"Attached product ID","x-description-i18n":{"vie":"Mã sản phẩm đính kèm"}},"variation_id":{"type":"string","nullable":true,"description":"Attached variation ID","x-description-i18n":{"vie":"Mã mẫu mã đính kèm"}},"quantity":{"type":"integer","description":"Attached product quantity","x-description-i18n":{"vie":"Số lượng sản phẩm đính kèm"}}}}},"discount_info_by_attachment_product":{"type":"object","nullable":true,"description":"Discount by attached product","x-description-i18n":{"vie":"Giảm giá theo sản phẩm đính kèm"},"properties":{"discount":{"type":"number","description":"Discount value","x-description-i18n":{"vie":"Giá trị giảm giá"}},"is_percent":{"type":"boolean","description":"Is percent","x-description-i18n":{"vie":"Là phần trăm"}},"quantity":{"type":"integer","description":"Quantity to apply discount","x-description-i18n":{"vie":"Số lượng áp dụng giảm giá"}}}},"inserted_at":{"type":"string","format":"date-time","description":"Inserted at","x-description-i18n":{"vie":"Thời điểm tạo"}},"updated_at":{"type":"string","format":"date-time","description":"Updated at","x-description-i18n":{"vie":"Thời điểm cập nhật"}}}}},"bonus_items":{"type":"array","description":"Bonus items","x-description-i18n":{"vie":"Sản phẩm tặng thêm"},"items":{"type":"object"}},"total_quantity_bonus":{"type":"integer","description":"Total quantity bonus","x-description-i18n":{"vie":"Tổng số lượng khuyến mãi"}},"arr_level_promotion":{"type":"array","description":"Level promotion array","x-description-i18n":{"vie":"Mức độ khuyến mãi"},"items":{"type":"object"}},"level_order_prices":{"type":"array","description":"Level order prices","x-description-i18n":{"vie":"Mức khuyến mãi đơn hàng"},"items":{"type":"object"}},"priority_level":{"type":"integer","description":"Priority level","x-description-i18n":{"vie":"Mức độ ưu tiên"}},"type_employee":{"type":"string","description":"Type employee","x-description-i18n":{"vie":"Phân loại nhân viên"}},"post_ids":{"type":"array","description":"Post IDs","x-description-i18n":{"vie":"Mã bài viết"},"items":{"type":"string"}},"shop_id":{"type":"integer","description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},"creator_id":{"type":"string","description":"Creator ID","x-description-i18n":{"vie":"Mã người tạo"}},"inserted_at":{"type":"string","format":"date-time","description":"Inserted at","x-description-i18n":{"vie":"Thời điểm tạo"}},"updated_at":{"type":"string","format":"date-time","description":"Updated at","x-description-i18n":{"vie":"Thời điểm cập nhật"}}}},"LivestreamManager":{"type":"object","description":"Livestream session information","x-description-i18n":{"vie":"Thông tin phiên livestream"},"properties":{"creator":{"type":"object","description":"Creator information","x-description-i18n":{"vie":"Thông tin người tạo"},"properties":{"avatar_url":{"type":"string","description":"Avatar URL","x-description-i18n":{"vie":"URL ảnh đại diện"}},"fb_id":{"type":"string","description":"Facebook ID","x-description-i18n":{"vie":"Mã Facebook"}},"id":{"type":"string","description":"Creator ID","x-description-i18n":{"vie":"Mã người tạo"}},"name":{"type":"string","description":"Creator name","x-description-i18n":{"vie":"Tên người tạo"}}}},"end_time":{"type":"string","description":"End time of the livestream session","x-description-i18n":{"vie":"Thời gian kết thúc phiên livestream"}},"finisher":{"type":"object","description":"Finisher information","x-description-i18n":{"vie":"Thông tin người kết thúc"},"properties":{"avatar_url":{"type":"string","description":"Avatar URL","x-description-i18n":{"vie":"URL ảnh đại diện"}},"fb_id":{"type":"string","description":"Facebook ID","x-description-i18n":{"vie":"Mã Facebook"}},"id":{"type":"string","description":"Finisher ID","x-description-i18n":{"vie":"Mã người kết thúc"}},"name":{"type":"string","description":"Finisher name","x-description-i18n":{"vie":"Tên người kết thúc"}}}},"id":{"type":"string","description":"Livestream session ID","x-description-i18n":{"vie":"Mã phiên livestream"}},"inserted_at":{"type":"string","description":"Created date","x-description-i18n":{"vie":"Ngày tạo"}},"name":{"type":"string","description":"Livestream session name (campaign)","x-description-i18n":{"vie":"Tên phiên livestream (chiến dịch)"}},"origin_post_id":{"type":"string","description":"Origin post ID","x-description-i18n":{"vie":"Mã bài viết gốc"}},"post_ids":{"type":"array","items":{"type":"string"},"description":"List of post IDs","x-description-i18n":{"vie":"Danh sách bài viết"}},"remain_warehouse_ids":{"type":"array","items":{"type":"string"},"description":"List of inventory sync warehouse IDs","x-description-i18n":{"vie":"Danh sách mã kho đồng bộ tồn"}},"shop_id":{"type":"integer","description":"Shop ID","x-description-i18n":{"vie":"Mã shop"}},"start_time":{"type":"string","description":"Start time of the livestream session","x-description-i18n":{"vie":"Thời gian bắt đầu phiên livestream"}},"total_comments":{"type":"integer","description":"Total number of comments","x-description-i18n":{"vie":"Tổng số bình luận"}},"total_customers":{"type":"integer","description":"Total number of customers","x-description-i18n":{"vie":"Tổng số khách hàng"}},"warehouse_id":{"type":"string","description":"Order creation warehouse ID","x-description-i18n":{"vie":"Mã kho tạo đơn"}}}},"PaginatedResponse":{"type":"object","description":"Paginated response","x-description-i18n":{"vie":"Phản hồi phân trang"},"properties":{"data":{"type":"array","description":"List of items","x-description-i18n":{"vie":"Danh sách mục"}},"page_number":{"type":"integer","description":"Page number","x-description-i18n":{"vie":"Số trang"}},"page_size":{"type":"integer","description":"Page size","x-description-i18n":{"vie":"Kích thước trang"}},"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}},"total_entries":{"type":"integer","description":"Total entries","x-description-i18n":{"vie":"Tổng số bản ghi"}},"total_pages":{"type":"integer","description":"Total pages","x-description-i18n":{"vie":"Tổng số trang"}}}},"SimpleResponse":{"type":"object","description":"Simple response with success status","x-description-i18n":{"vie":"Phản hồi đơn giản với trạng thái thành công"},"properties":{"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}}}},"DataResponse":{"type":"object","description":"Response with data and success status","x-description-i18n":{"vie":"Phản hồi với dữ liệu và trạng thái thành công"},"properties":{"data":{"description":"Response data","x-description-i18n":{"vie":"Dữ liệu phản hồi"}},"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}}}},"WebhookOrderResponse":{"type":"object","description":"Webhook response when webhook_types includes orders","x-description-i18n":{"vie":"Phản hồi webhook khi webhook_types bao gồm orders"},"allOf":[{"type":"object","properties":{"id":{"type":"integer","description":"Order ID","x-description-i18n":{"vie":"Mã đơn hàng"}},"system_id":{"type":"integer","description":"System ID","x-description-i18n":{"vie":"Mã hệ thống"}},"shop_id":{"type":"integer","description":"Shop ID","x-description-i18n":{"vie":"Mã cửa hàng"}},"inserted_at":{"type":"string","format":"date-time","description":"Order creation time","x-description-i18n":{"vie":"Thời điểm tạo đơn"}},"updated_at":{"type":"string","format":"date-time","description":"Order update time","x-description-i18n":{"vie":"Thời điểm cập nhật đơn"}},"status":{"type":"integer","description":"Order status","x-description-i18n":{"vie":"Trạng thái đơn hàng"},"enum":[0,17,11,12,13,20,1,8,9,2,3,16,4,15,5,6,7],"x-enum-descriptions":["New","Waiting for confirmation","Restocking","Wait for printing","Printed","Purchased","Confirmed","Packaging","Waiting for pick up","Shipped","Received","Collected money","Returning","Partial return","Returned","Canceled","Deleted recently"],"x-enum-descriptions-i18n":{"vie":["Mới","Chờ xác nhận","Chờ hàng","Chờ in","Đã in","Đã đặt hàng","Đã xác nhận","Đang đóng hàng","Chờ chuyển hàng","Đã gửi hàng","Đã nhận","Đã thu tiền","Đang hoàn","Hoàn một phần","Đã hoàn","Đã hủy","Đã xóa"]}},"status_name":{"type":"string","description":"Order status name","x-description-i18n":{"vie":"Tên trạng thái đơn hàng"}},"bill_full_name":{"type":"string","description":"Customer name","x-description-i18n":{"vie":"Tên khách hàng"}},"bill_phone_number":{"type":"string","description":"Phone number of customer","x-description-i18n":{"vie":"SĐT khách hàng"}},"bill_email":{"type":"string","description":"Customer email","x-description-i18n":{"vie":"Email khách hàng"}},"conversation_id":{"type":"string","description":"Conversation ID","x-description-i18n":{"vie":"Mã hội thoại"}},"page_id":{"type":"string","description":"Facebook page ID","x-description-i18n":{"vie":"Mã Facebook page"}},"post_id":{"type":"string","description":"Post ID","x-description-i18n":{"vie":"Mã bài viết"}},"ad_id":{"type":"string","description":"Ad ID","x-description-i18n":{"vie":"Mã quảng cáo"}},"shipping_fee":{"type":"integer","description":"Shipping fee","x-description-i18n":{"vie":"Phí vận chuyển"}},"partner_fee":{"type":"integer","description":"Fee from shipping partner","x-description-i18n":{"vie":"Phí vận chuyển từ ĐVVC"}},"fee_marketplace":{"type":"integer","description":"Fees from e-commerce platforms","x-description-i18n":{"vie":"Phí sàn"}},"customer_pay_fee":{"type":"boolean","description":"Customer pay shipping fee","x-description-i18n":{"vie":"Khách trả phí ship"}},"is_free_shipping":{"type":"boolean","description":"Free shipping","x-description-i18n":{"vie":"Miễn phí vận chuyển"}},"is_livestream":{"type":"boolean","description":"Is livestream order","x-description-i18n":{"vie":"Đơn hàng từ livestream"}},"is_live_shopping":{"type":"boolean","description":"Is live shopping order","x-description-i18n":{"vie":"Đơn hàng từ live shopping"}},"is_smc":{"type":"boolean","description":"Shopping on Messenger","x-description-i18n":{"vie":"Đơn hàng từ mua sắm trên Messenger"}},"received_at_shop":{"type":"boolean","description":"true: Sales at counter, false: Sell online","x-description-i18n":{"vie":"true: Bán tại quầy, false: Bán online"}},"total_discount":{"type":"integer","description":"Discount total","x-description-i18n":{"vie":"Tổng tiền giảm giá"}},"note":{"type":"string","description":"Internal note","x-description-i18n":{"vie":"Ghi chú nội bộ"}},"note_print":{"type":"string","description":"Note for printing","x-description-i18n":{"vie":"Ghi chú đơn hàng"}},"returned_reason":{"type":"integer","description":"Return reason code (1: Customer, 2: Staff, 3: Defective product, 4: Shipping carrier, 5: Exchange). Other values are shop-defined custom reasons, see returned_reason_name for the display name","x-description-i18n":{"vie":"Mã lý do hoàn hàng (1: Do khách hàng, 2: Do nhân viên, 3: Do sản phẩm lỗi, 4: Do đơn vị vận chuyển, 5: Do đổi hàng). Mã khác là lý do tùy chỉnh theo từng shop, xem tên hiển thị tại returned_reason_name"}},"returned_reason_name":{"type":"string","description":"Return reason name","x-description-i18n":{"vie":"Tên lý do hoàn hàng"}},"sub_status":{"type":"integer","description":"Reason for delivery delay","x-description-i18n":{"vie":"Lý do delay giao hàng"}},"warehouse_id":{"type":"string","description":"Warehouse ID","x-description-i18n":{"vie":"Mã kho hàng"}},"warehouse_info":{"type":"object","description":"Warehouse information","x-description-i18n":{"vie":"Thông tin kho hàng"},"properties":{"name":{"type":"string","description":"Warehouse name","x-description-i18n":{"vie":"Tên kho hàng"}},"phone_number":{"type":"string","description":"Warehouse phone number","x-description-i18n":{"vie":"Số điện thoại kho hàng"}},"full_address":{"type":"string","description":"Warehouse full address","x-description-i18n":{"vie":"Địa chỉ đầy đủ kho hàng"}},"address":{"type":"string","description":"Warehouse address","x-description-i18n":{"vie":"Địa chỉ chi tiết kho hàng"}},"province_id":{"type":"string","description":"Province ID","x-description-i18n":{"vie":"Mã tỉnh thành phố"}},"district_id":{"type":"string","description":"District ID","x-description-i18n":{"vie":"Mã quận huyện"}},"commune_id":{"type":"string","description":"Commune ID","x-description-i18n":{"vie":"Mã phường xã"}},"affiliate_id":{"type":"string","description":"Affiliate ID","x-description-i18n":{"vie":"Mã đại lý"}},"ffm_id":{"type":"string","description":"FFM ID","x-description-i18n":{"vie":"Mã FFM"}},"has_snappy_service":{"type":"boolean","description":"Has Snappy service","x-description-i18n":{"vie":"Có dịch vụ Snappy"}},"custom_id":{"type":"string","description":"Custom ID","x-description-i18n":{"vie":"Mã tùy chỉnh"}}}},"creator_id":{"type":"string","description":"Creator ID","x-description-i18n":{"vie":"Mã người tạo"}},"creator":{"type":"object","description":"Order creator","x-description-i18n":{"vie":"Thông tin người tạo đơn"},"properties":{"id":{"type":"string","description":"Creator ID","x-description-i18n":{"vie":"Mã người tạo"}},"fb_id":{"type":"string","description":"Facebook ID of creator","x-description-i18n":{"vie":"ID facebook người tạo đơn"}},"name":{"type":"string","description":"Creator name","x-description-i18n":{"vie":"Tên người tạo đơn"}},"avatar_url":{"type":"string","description":"Creator avatar URL","x-description-i18n":{"vie":"Link avatar người tạo"}}}},"items":{"type":"array","description":"Product list. When creating or updating an order, each entry must include `variation_id` and `quantity`. `variation_info` is optional — if omitted, the backend treats it as an empty object; send it (with `retail_price`) when you need the line price to be explicit.","x-description-i18n":{"vie":"Danh sách sản phẩm. Khi tạo hoặc cập nhật đơn, mỗi phần tử cần có `variation_id` và `quantity`. `variation_info` không bắt buộc — nếu thiếu, backend coi như object rỗng; nên gửi kèm (cùng `retail_price`) khi muốn giá dòng hàng tường minh."},"items":{"type":"object","required":["variation_id","quantity"],"properties":{"product_id":{"type":"string","description":"Product ID","x-description-i18n":{"vie":"Mã sản phẩm"}},"quantity":{"type":"integer","description":"Quantity","x-description-i18n":{"vie":"Số lượng"}},"returned_count":{"type":"integer","description":"Returned count","x-description-i18n":{"vie":"Số lượng đã trả"}},"assigning_seller_id":{"type":"string","description":"Assigning seller ID","x-description-i18n":{"vie":"Mã nhân viên được phân công"}},"quantity_by_combo_products":{"type":"array","description":"Quantity by combo products","x-description-i18n":{"vie":"Số lượng theo combo sản phẩm"},"items":{"type":"object"}},"discount_each_product":{"type":"integer","description":"Discount for each product","x-description-i18n":{"vie":"Giảm giá cho từng sản phẩm"}},"is_bonus_product":{"type":"boolean","description":"Is bonus product","x-description-i18n":{"vie":"Sản phẩm tặng kèm"}},"is_discount_percent":{"type":"boolean","description":"Is discount by percent","x-description-i18n":{"vie":"Giảm giá theo phần trăm"}},"is_wholesale":{"type":"boolean","description":"Is wholesale","x-description-i18n":{"vie":"Bán sỉ"}},"is_composite":{"type":"boolean","description":"Is composite product","x-description-i18n":{"vie":"Sản phẩm composite"}},"one_time_product":{"type":"boolean","description":"One time product","x-description-i18n":{"vie":"Sản phẩm một lần"}},"note":{"type":"string","description":"Product note","x-description-i18n":{"vie":"Ghi chú sản phẩm"}},"note_product":{"type":"string","description":"Product note","x-description-i18n":{"vie":"Ghi chú sản phẩm"}},"inserted_at":{"type":"string","format":"date-time","description":"Inserted at","x-description-i18n":{"vie":"Thời điểm tạo"}},"measure_group_id":{"type":"integer","description":"Measure group ID","x-description-i18n":{"vie":"Mã nhóm đơn vị tính"}},"variation_info":{"type":"object","description":"Variation information. Optional when creating/updating an order (the backend defaults it to an empty object if omitted). Its inner fields are not individually required, but sending `retail_price` is recommended so the line price is correct.","x-description-i18n":{"vie":"Thông tin biến thể. Không bắt buộc khi tạo/cập nhật đơn (backend tự coi là object rỗng nếu thiếu). Các field bên trong không bắt buộc riêng lẻ, nhưng nên gửi `retail_price` để giá dòng hàng đúng."},"properties":{"id":{"type":"string","description":"Variation ID","x-description-i18n":{"vie":"Mã biến thể"}},"name":{"type":"string","description":"Product name","x-description-i18n":{"vie":"Tên sản phẩm"}},"product_id":{"type":"string","description":"Product ID","x-description-i18n":{"vie":"Mã sản phẩm"}},"retail_price":{"type":"integer","description":"Retail price. Not strictly required, but recommended when creating/updating an order so the line price is correct.","x-description-i18n":{"vie":"Giá bán lẻ. Không bắt buộc, nhưng nên gửi khi tạo/cập nhật đơn để giá dòng hàng chính xác."}},"detail":{"type":"string","description":"Variation detail","x-description-i18n":{"vie":"Chi tiết biến thể"}},"images":{"type":"array","description":"Variation images","x-description-i18n":{"vie":"Hình ảnh biến thể"},"items":{"type":"string","format":"uri"}},"fields":{"type":"array","description":"Variation fields","x-description-i18n":{"vie":"Thuộc tính biến thể"},"items":{"type":"object","properties":{"id":{"type":"string","description":"Field ID","x-description-i18n":{"vie":"Mã thuộc tính"}},"name":{"type":"string","description":"Field name","x-description-i18n":{"vie":"Tên thuộc tính"}},"value":{"type":"string","description":"Field value","x-description-i18n":{"vie":"Giá trị thuộc tính"}},"keyValue":{"type":"string","description":"Key value","x-description-i18n":{"vie":"Giá trị khóa"}}}}},"barcode":{"type":"string","description":"Barcode","x-description-i18n":{"vie":"Mã barcode"}},"brand_id":{"type":"string","description":"Brand ID","x-description-i18n":{"vie":"Mã thương hiệu"}},"category_ids":{"type":"array","description":"Category IDs","x-description-i18n":{"vie":"Danh sách mã danh mục"},"items":{"type":"integer"}},"display_id":{"type":"string","description":"Display ID","x-description-i18n":{"vie":"Mã hiển thị"}},"product_display_id":{"type":"string","description":"Product display ID","x-description-i18n":{"vie":"Mã hiển thị sản phẩm"}},"last_imported_price":{"type":"integer","description":"Last imported price","x-description-i18n":{"vie":"Giá nhập hàng cuối"}},"is_upsale_product":{"type":"boolean","description":"Upsale product","x-description-i18n":{"vie":"Sản phẩm upsale"}},"weight":{"type":"integer","description":"Weight","x-description-i18n":{"vie":"Khối lượng"}},"measure_info":{"type":"object","description":"Measure information","x-description-i18n":{"vie":"Thông tin đơn vị tính"},"properties":{"measure_id":{"type":"integer","description":"Measure ID","x-description-i18n":{"vie":"Mã đơn vị tính"}},"exchange_value":{"type":"integer","description":"Exchange value","x-description-i18n":{"vie":"Giá trị quy đổi"}}}},"avg_price":{"type":"integer","description":"Average import price","x-description-i18n":{"vie":"Giá nhập trung bình"}}}},"components":{"type":"array","description":"Product components","x-description-i18n":{"vie":"Thành phần sản phẩm"},"items":{"type":"object","properties":{"component_id":{"type":"string","description":"Component ID","x-description-i18n":{"vie":"Mã thành phần"}},"quantity":{"type":"integer","description":"Quantity","x-description-i18n":{"vie":"Số lượng"}},"variation_id":{"type":"string","description":"Variation ID","x-description-i18n":{"vie":"Mã biến thể"}},"variation_info":{"type":"object","description":"Variation information","x-description-i18n":{"vie":"Thông tin biến thể"}}}}},"id":{"type":"integer","description":"Item ID","x-description-i18n":{"vie":"Mã sản phẩm trong đơn"}},"variation_id":{"type":"string","description":"Variation ID","x-description-i18n":{"vie":"Mã biến thể"}}}}},"partner":{"type":"object","description":"Partner information","x-description-i18n":{"vie":"Thông tin đơn vị vận chuyển"},"properties":{"partner_id":{"type":"integer","description":"Partner ID","x-description-i18n":{"vie":"ID đơn vị vận chuyển trên hệ thống Pancake"}},"cod":{"type":"integer","description":"Reconciliation COD","x-description-i18n":{"vie":"Đối soát tiền thu hộ"}},"extend_code":{"type":"string","description":"Shipping order ID on partner system","x-description-i18n":{"vie":"Mã vận đơn"}},"total_fee":{"type":"integer","description":"Total fee","x-description-i18n":{"vie":"Tổng phí"}},"updated_at":{"type":"string","format":"date-time","description":"Updated at","x-description-i18n":{"vie":"Thời điểm cập nhật"}},"delivery_name":{"type":"string","description":"Shipper name","x-description-i18n":{"vie":"Tên người giao hàng"}},"delivery_tel":{"type":"string","description":"Delivery phone","x-description-i18n":{"vie":"Số điện thoại người giao hàng"}},"picked_up_at":{"type":"string","format":"date-time","description":"Picked up at","x-description-i18n":{"vie":"Thời điểm lấy hàng"}},"sort_code":{"type":"string","description":"Sort code","x-description-i18n":{"vie":"Mã phân loại"}},"paid_at":{"type":"string","format":"date-time","description":"Paid at","x-description-i18n":{"vie":"Thời điểm thanh toán"}},"system_created":{"type":"boolean","description":"System created","x-description-i18n":{"vie":"Được tạo bởi hệ thống"}},"extend_update":{"type":"array","description":"Update from courier","x-description-i18n":{"vie":"Cập nhật từ đơn vị vận chuyển"},"items":{"type":"object","properties":{"key":{"type":"string","description":"Update key","x-description-i18n":{"vie":"Mã cập nhật"}},"status":{"type":"string","description":"Status","x-description-i18n":{"vie":"Trạng thái"}},"tracking_id":{"type":"string","description":"Partner extend code","x-description-i18n":{"vie":"Mã đơn hàng đối tác"}},"note":{"type":"string","description":"Courier notes","x-description-i18n":{"vie":"Ghi chú từ đơn vị vận chuyển"}},"update_at":{"type":"string","format":"date-time","description":"Updated at","x-description-i18n":{"vie":"Thời điểm cập nhật"}}}}},"partner_status":{"type":"string","nullable":true,"description":"Partner shipping status","x-description-i18n":{"vie":"Trạng thái vận chuyển"},"enum":["waiting","request_received","processing_picked_up","picking_up","delay_pickup","picked_up","waiting_on_the_way","on_the_way","contact_delivery_company","out_for_delivery","delay_delivery","inform_recipient","undeliverable","waiting_for_return","delivered","delivered_cod","returning","returned","returned_cod","canceled"],"x-enum-descriptions":["Waiting for processing","Carrier received the request","Processing pickup","Picking up","Delayed pickup","Picked up","Waiting for transit","In transit","Contact the carrier","Out for delivery","Delayed delivery","Notify the recipient","Undeliverable","Waiting for return","Delivered","Delivered, COD reconciled","Returning","Returned","Returned, COD reconciled","Canceled"],"x-enum-descriptions-i18n":{"vie":["Chờ xử lý","ĐVVC đã tiếp nhận đơn","Đang xử lý lấy hàng","Đang lấy hàng","Trễ lấy hàng","Đã lấy hàng","Chờ trung chuyển","Đang trung chuyển","Liên hệ ĐVVC","Đang giao hàng","Trễ giao hàng","Thông báo cho người nhận","Giao không thành","Chờ chuyển hoàn","Đã giao hàng","Đã giao hàng, đã đối soát COD","Đang chuyển hoàn","Đã chuyển hoàn","Đã chuyển hoàn, đã đối soát COD","Đã hủy vận đơn"]}},"partner_name":{"type":"string","nullable":true,"description":"Partner name","x-description-i18n":{"vie":"Tên đơn vị vận chuyển"}},"first_delivery_at":{"type":"string","format":"date-time","nullable":true,"description":"First delivery time","x-description-i18n":{"vie":"Thời điểm giao hàng lần đầu"}},"first_undeliverable_at":{"type":"string","format":"date-time","nullable":true,"description":"First failed delivery time","x-description-i18n":{"vie":"Thời điểm giao hàng thất bại lần đầu"}},"order_number_vtp":{"type":"string","nullable":true,"description":"Viettel Post tracking number","x-description-i18n":{"vie":"Mã vận đơn Viettel Post"}},"printed_form":{"type":"object","nullable":true,"description":"Printed form","x-description-i18n":{"vie":"Mẫu in"}}}},"shipping_address":{"$ref":"#/components/schemas/ShippingAddress"},"payment_purchase_histories":{"type":"array","description":"Payment histories","x-description-i18n":{"vie":"Lịch sử thanh toán"},"items":{"type":"object","properties":{"amount":{"type":"integer","description":"Amount of money","x-description-i18n":{"vie":"Số tiền"}},"type":{"type":"string","description":"Payment type","x-description-i18n":{"vie":"Loại thanh toán"}},"inserted_at":{"type":"string","format":"date-time","description":"Transaction time","x-description-i18n":{"vie":"Thời điểm giao dịch"}},"result_code":{"type":"string","description":"Result code","x-description-i18n":{"vie":"Mã kết quả"}},"ipn_reply":{"type":"boolean","description":"IPN reply","x-description-i18n":{"vie":"Phản hồi IPN"}},"voucher_amount":{"type":"integer","description":"Voucher amount","x-description-i18n":{"vie":"Số tiền voucher"}},"tags":{"type":"array","description":"Tags","x-description-i18n":{"vie":"Thẻ"},"items":{"type":"string"}}}}},"tags":{"type":"array","description":"Tags list","x-description-i18n":{"vie":"Danh sách thẻ đơn hàng"},"items":{"type":"object","properties":{"id":{"type":"integer","description":"Tag ID","x-description-i18n":{"vie":"Mã thẻ đơn hàng"}},"name":{"type":"string","description":"Tag name","x-description-i18n":{"vie":"Tên thẻ đơn hàng"}}}}},"marketer":{"type":"object","description":"Marketer information","x-description-i18n":{"vie":"Thông tin marketer"},"properties":{"id":{"type":"string","description":"Marketer ID","x-description-i18n":{"vie":"Mã marketer"}},"name":{"type":"string","description":"Marketer name","x-description-i18n":{"vie":"Tên marketer"}},"email":{"type":"string","description":"Marketer email","x-description-i18n":{"vie":"Email marketer"}},"phone_number":{"type":"string","description":"Marketer phone number","x-description-i18n":{"vie":"Số điện thoại marketer"}},"fb_id":{"type":"string","description":"Marketer Facebook ID","x-description-i18n":{"vie":"Facebook ID marketer"}},"avatar_url":{"type":"string","description":"Marketer avatar URL","x-description-i18n":{"vie":"Link avatar marketer"}}}},"pke_mkter":{"type":"string","description":"Marketer ID","x-description-i18n":{"vie":"Mã nhân viên marketer"}},"activated_combo_products":{"type":"object","description":"Activated combo products information","x-description-i18n":{"vie":"Thông tin combo sản phẩm được kích hoạt"},"properties":{"combo_product_id":{"type":"integer","description":"Combo product ID","x-description-i18n":{"vie":"Mã combo sản phẩm"}},"quantity_combo_activated":{"type":"integer","description":"Quantity combo activated","x-description-i18n":{"vie":"Số lượng combo được kích hoạt"}},"combo_product_info":{"type":"object","description":"Combo product information","x-description-i18n":{"vie":"Thông tin combo sản phẩm"}}}},"activated_promotion_advances":{"type":"array","description":"Activated promotion advances information","x-description-i18n":{"vie":"Thông tin khuyến mãi được kích hoạt"},"items":{"type":"object","properties":{"id":{"type":"integer","description":"ID","x-description-i18n":{"vie":"Mã"}},"promotion_advance_id":{"type":"string","description":"Promotion advance ID","x-description-i18n":{"vie":"Mã khuyến mãi"}},"promotion_advance_info":{"type":"object","description":"Promotion advance information","x-description-i18n":{"vie":"Thông tin khuyến mãi"}}}}},"invoice_info_list":{"type":"array","description":"Invoice information list","x-description-i18n":{"vie":"Danh sách thông tin hóa đơn"},"items":{"type":"object","properties":{"error":{"type":"string","description":"Error message if any","x-description-i18n":{"vie":"Thông báo lỗi nếu có"}},"invoice_detail":{"type":"object","description":"Invoice detail information","x-description-i18n":{"vie":"Chi tiết thông tin hóa đơn"},"properties":{"company_address":{"type":"string","description":"Company address","x-description-i18n":{"vie":"Địa chỉ công ty"}},"company_address_breakdown":{"type":"object","description":"Company address breakdown","x-description-i18n":{"vie":"Chi tiết địa chỉ công ty"},"properties":{"company_additional_info":{"type":"string","description":"Company additional information","x-description-i18n":{"vie":"Thông tin bổ sung công ty"}},"company_barangay":{"type":"string","description":"Company barangay","x-description-i18n":{"vie":"Phường/xã công ty"}},"company_city":{"type":"string","description":"Company city","x-description-i18n":{"vie":"Thành phố công ty"}},"company_detailed_address":{"type":"string","description":"Company detailed address","x-description-i18n":{"vie":"Địa chỉ chi tiết công ty"}},"company_district":{"type":"string","description":"Company district","x-description-i18n":{"vie":"Quận/huyện công ty"}},"company_full_address":{"type":"string","description":"Company full address","x-description-i18n":{"vie":"Địa chỉ đầy đủ công ty"}},"company_postcode":{"type":"string","description":"Company postcode","x-description-i18n":{"vie":"Mã bưu điện công ty"}},"company_province":{"type":"string","description":"Company province","x-description-i18n":{"vie":"Tỉnh công ty"}},"company_region":{"type":"string","description":"Company region","x-description-i18n":{"vie":"Vùng/khu vực công ty"}},"company_state":{"type":"string","description":"Company state","x-description-i18n":{"vie":"Bang/tỉnh công ty"}},"company_town":{"type":"string","description":"Company town","x-description-i18n":{"vie":"Thị trấn/phường công ty"}}}},"company_email":{"type":"string","description":"Company email","x-description-i18n":{"vie":"Email công ty"}},"company_name":{"type":"string","description":"Company name","x-description-i18n":{"vie":"Tên công ty"}},"company_tax_id":{"type":"string","description":"Company tax ID","x-description-i18n":{"vie":"Mã số thuế công ty"}}}},"invoice_type":{"type":"string","description":"Invoice type","x-description-i18n":{"vie":"Loại hóa đơn"}},"is_requested":{"type":"boolean","description":"Request for invoice","x-description-i18n":{"vie":"Yêu cầu xuất hóa đơn"}},"order_sn":{"type":"string","description":"Order code on the marketplace","x-description-i18n":{"vie":"Mã đơn hàng trên sàn"}}}}},"reports_by_phone":{"type":"object","description":"Reports by phone number","x-description-i18n":{"vie":"Báo cáo theo số điện thoại"},"properties":{"order_fail":{"type":"integer","description":"Number of failed orders","x-description-i18n":{"vie":"Số đơn thất bại"}},"order_success":{"type":"integer","description":"Number of successful orders","x-description-i18n":{"vie":"Số đơn thành công"}},"warning":{"type":"integer","description":"Number of warnings orders","x-description-i18n":{"vie":"Số đơn cảnh báo"}}},"example":{"+639175706297":{"order_fail":29,"order_success":20,"warning":0}}},"tracking_link":{"type":"string","description":"Link confirm order","x-description-i18n":{"vie":"Link xác nhận đơn hàng"}},"ads_source":{"type":"string","description":"Advertising source","x-description-i18n":{"vie":"Nguồn quảng cáo"}},"bank_payments":{"type":"object","description":"Payment method","x-description-i18n":{"vie":"Phương thức thanh toán"}},"transfer_proofs":{"type":"array","description":"Bank transfer payment proofs, including verification time, amount and receipt images","x-description-i18n":{"vie":"Danh sách chứng từ xác thực chuyển khoản, gồm ngày giờ xác thực, số tiền và ảnh chứng từ"},"items":{"type":"object","properties":{"id":{"type":"integer","description":"Transfer proof ID","x-description-i18n":{"vie":"Mã chứng từ chuyển khoản"}},"order_id":{"type":"integer","description":"Order ID","x-description-i18n":{"vie":"Mã đơn hàng"}},"shop_id":{"type":"integer","description":"Shop ID","x-description-i18n":{"vie":"Mã cửa hàng"}},"payment_id":{"type":"string","description":"Bank payment method ID (matches a key in `bank_payments`)","x-description-i18n":{"vie":"Mã phương thức thanh toán ngân hàng (trùng với key trong `bank_payments`)"}},"amount":{"type":"integer","description":"Transferred amount","x-description-i18n":{"vie":"Số tiền chuyển khoản"}},"images":{"type":"array","description":"Transfer receipt images","x-description-i18n":{"vie":"Danh sách ảnh chứng từ chuyển khoản"},"items":{"type":"string"}},"note":{"type":"string","nullable":true,"description":"Note","x-description-i18n":{"vie":"Ghi chú"}},"is_income":{"type":"boolean","description":"Money received (true) or paid out (false)","x-description-i18n":{"vie":"Là khoản tiền nhận vào (true) hay chi ra (false)"}},"is_verify":{"type":"boolean","description":"Whether the transfer has been verified","x-description-i18n":{"vie":"Chứng từ đã được xác thực hay chưa"}},"verify_at":{"type":"string","format":"date-time","nullable":true,"description":"Verification time","x-description-i18n":{"vie":"Thời điểm xác thực chuyển khoản"}},"verifier":{"type":"object","nullable":true,"description":"Verifier information","x-description-i18n":{"vie":"Thông tin người xác thực"},"properties":{"id":{"type":"string","description":"Verifier ID","x-description-i18n":{"vie":"Mã người xác thực"}},"name":{"type":"string","description":"Verifier name","x-description-i18n":{"vie":"Tên người xác thực"}},"fb_id":{"type":"string","description":"Facebook ID of verifier","x-description-i18n":{"vie":"Facebook ID người xác thực"}},"avatar_url":{"type":"string","description":"Verifier avatar URL","x-description-i18n":{"vie":"Link avatar người xác thực"}}}},"creator":{"type":"object","nullable":true,"description":"Creator information","x-description-i18n":{"vie":"Thông tin người tạo chứng từ"},"properties":{"id":{"type":"string","description":"Creator ID","x-description-i18n":{"vie":"Mã người tạo"}},"name":{"type":"string","description":"Creator name","x-description-i18n":{"vie":"Tên người tạo"}},"fb_id":{"type":"string","description":"Facebook ID of creator","x-description-i18n":{"vie":"Facebook ID người tạo"}},"avatar_url":{"type":"string","description":"Creator avatar URL","x-description-i18n":{"vie":"Link avatar người tạo"}}}},"last_editor":{"type":"object","nullable":true,"description":"Last editor information","x-description-i18n":{"vie":"Thông tin người chỉnh sửa cuối"},"properties":{"id":{"type":"string","description":"Editor ID","x-description-i18n":{"vie":"Mã người chỉnh sửa"}},"name":{"type":"string","description":"Editor name","x-description-i18n":{"vie":"Tên người chỉnh sửa"}},"fb_id":{"type":"string","description":"Facebook ID of editor","x-description-i18n":{"vie":"Facebook ID người chỉnh sửa"}},"avatar_url":{"type":"string","description":"Editor avatar URL","x-description-i18n":{"vie":"Link avatar người chỉnh sửa"}}}},"order_info":{"type":"object","nullable":true,"description":"Additional order information","x-description-i18n":{"vie":"Thông tin đơn hàng bổ sung"}},"inserted_at":{"type":"string","format":"date-time","description":"Transfer proof creation time","x-description-i18n":{"vie":"Thời điểm tạo chứng từ"}},"updated_at":{"type":"string","format":"date-time","description":"Transfer proof update time","x-description-i18n":{"vie":"Thời điểm cập nhật chứng từ"}}}}},"shopify_order_id":{"type":"string","description":"Shopify order ID","x-description-i18n":{"vie":"Mã đơn hàng Shopify"}},"shopify_abandon_checkout_id":{"type":"integer","description":"Shopify abandon checkout ID","x-description-i18n":{"vie":"Mã Shopify abandon checkout"}},"is_abandoned_order":{"type":"boolean","description":"Abandoned-cart flag for creating or updating an order. Send it directly in the request body, not inside `third_party` or `third_party_infomation`.\nAn explicit value, including `false`, takes precedence over automatic detection. If omitted on creation, the flag is determined automatically; if omitted on update, the current value is preserved.\nOnly boolean `true` or string `\"true\"` is normalized to `true`; all other submitted values become `false`.\n","x-description-i18n":{"vie":"Cờ đơn chưa hoàn tất khi tạo hoặc cập nhật đơn. Truyền trực tiếp trong body, không bọc trong `third_party` hoặc `third_party_infomation`.\nGiá trị truyền lên, kể cả `false`, được ưu tiên hơn kết quả nhận diện tự động. Nếu bỏ qua khi tạo đơn, cờ được xác định tự động; nếu bỏ qua khi cập nhật, giữ nguyên giá trị hiện tại.\nChỉ boolean `true` hoặc chuỗi `\"true\"` được chuẩn hóa thành `true`; mọi giá trị khác được gửi lên đều thành `false`.\n"},"example":true},"cod":{"type":"integer","description":"Cash on delivery","x-description-i18n":{"vie":"Tiền thu hộ"}},"cash":{"type":"integer","description":"Cash payment","x-description-i18n":{"vie":"Tiền mặt"}},"account":{"type":"integer","description":"Order source ID","x-description-i18n":{"vie":"Mã nguồn đơn hàng"}},"account_name":{"type":"string","description":"Order source name","x-description-i18n":{"vie":"Tên mã nguồn đơn"}},"advanced_platform_fee":{"type":"object","description":"Fees from e-commerce platforms","x-description-i18n":{"vie":"Phí từ sàn thương mại điện tử"},"properties":{"ads_top_up":{"type":"integer","description":"Ads wallet top-up","x-description-i18n":{"vie":"Ví quảng cáo"}},"affiliate_commission":{"type":"integer","description":"Affiliate commission","x-description-i18n":{"vie":"Phí hoa hồng (Sàn TMĐT)"}},"diff_shipping_fee":{"type":"integer","description":"Difference shipping fee","x-description-i18n":{"vie":"Chênh lệch phí vận chuyển (Sàn TMĐT)"}},"marketplace_voucher":{"type":"integer","description":"Marketplace voucher","x-description-i18n":{"vie":"Sàn trợ giá"}},"payment_fee":{"type":"integer","description":"Payment fee","x-description-i18n":{"vie":"Phí cố định, giao dịch (Sàn TMĐT)"}},"platform_commission":{"type":"integer","description":"Platform commission","x-description-i18n":{"vie":"Phí hoa hồng nền tảng (Sàn TMĐT)"}},"seller_transaction_fee":{"type":"integer","description":"Seller transaction fee","x-description-i18n":{"vie":"Phí thanh toán (Sàn TMĐT)"}},"service_fee":{"type":"integer","description":"Service fee","x-description-i18n":{"vie":"Phí dịch vụ (Sàn TMĐT)"}},"sfp_service_fee":{"type":"integer","description":"SFP service fee","x-description-i18n":{"vie":"Phí dịch vụ SFP (Sàn TMĐT)"}}}},"printing_count":{"type":"integer","description":"Printing count","x-description-i18n":{"vie":"Số lần in"}},"money_to_collect":{"type":"integer","description":"Money to collect","x-description-i18n":{"vie":"Số tiền cần thu"}},"marketplace_id":{"type":"string","description":"Marketplace ID","enum":["-2","-3","-4","-9","-16","-17","-20","-25","-27","-28"],"x-enum-descriptions":{"-2":"Tiki","-3":"Shopee","-4":"Lazada","-9":"TikTok","-16":"WooCommerce","-17":"Shopify","-20":"Line Shopping","-25":"Tokopedia","-27":"Mercado Libre","-28":"Tiendanube"},"x-description-i18n":{"vie":"Mã sàn thương mại điện tử"}},"total_price":{"type":"integer","description":"Total price","x-description-i18n":{"vie":"Tổng giá trị sản phẩm"}},"shop_customer_address_id":{"type":"string","description":"Customer address ID","x-description-i18n":{"vie":"Mã địa chỉ khách hàng"}},"customer":{"type":"object","description":"Customer information","x-description-i18n":{"vie":"Thông tin khách hàng"},"properties":{"fb_id":{"type":"string","description":"Customer Facebook ID","x-description-i18n":{"vie":"Facebook ID khách hàng"}},"id":{"type":"string","description":"Customer ID","x-description-i18n":{"vie":"Mã khách hàng"}},"name":{"type":"string","description":"Customer name","x-description-i18n":{"vie":"Tên khách hàng"}},"page_id":{"type":"string","description":"Page ID","x-description-i18n":{"vie":"Mã trang"}}}},"total_quantity":{"type":"integer","description":"Total quantity","x-description-i18n":{"vie":"Tổng số lượng"}},"time_assign_marketer":{"type":"string","format":"date-time","description":"Time assign marketer","x-description-i18n":{"vie":"Thời điểm phân công marketer"}},"p_utm_source":{"type":"string","description":"UTM Source","x-description-i18n":{"vie":"UTM Source"}},"p_utm_medium":{"type":"string","description":"UTM Medium","x-description-i18n":{"vie":"UTM Medium"}},"p_utm_campaign":{"type":"string","description":"UTM Campaign","x-description-i18n":{"vie":"UTM Campaign"}},"p_utm_term":{"type":"string","description":"UTM Term","x-description-i18n":{"vie":"UTM Term"}},"p_utm_content":{"type":"string","description":"UTM Content","x-description-i18n":{"vie":"UTM Content"}},"p_utm_id":{"type":"string","description":"UTM ID","x-description-i18n":{"vie":"UTM ID"}},"utm_affiliate":{"type":"string","description":"Affiliate","x-description-i18n":{"vie":"Affiliate"}},"link":{"type":"string","description":"Link","x-description-i18n":{"vie":"Link"}},"status_history":{"type":"array","description":"Status update history","x-description-i18n":{"vie":"Lịch sử cập nhật trạng thái"},"items":{"type":"object","properties":{"avatar_url":{"type":"string","description":"Avatar URL","x-description-i18n":{"vie":"Link avatar"}},"editor":{"type":"object","description":"Editor information","x-description-i18n":{"vie":"Thông tin người chỉnh sửa"}},"editor_fb":{"type":"string","description":"Editor Facebook ID","x-description-i18n":{"vie":"Facebook ID người chỉnh sửa"}},"editor_id":{"type":"string","description":"Editor ID","x-description-i18n":{"vie":"Mã người chỉnh sửa"}},"name":{"type":"string","description":"Name","x-description-i18n":{"vie":"Tên"}},"old_status":{"type":"integer","description":"Old status","x-description-i18n":{"vie":"Trạng thái cũ"}},"status":{"type":"integer","description":"Status","x-description-i18n":{"vie":"Trạng thái"}},"updated_at":{"type":"string","format":"date-time","description":"Updated at","x-description-i18n":{"vie":"Thời điểm cập nhật"}}}}},"duplicated_phone":{"type":"boolean","description":"Duplicated phone","x-description-i18n":{"vie":"Số điện thoại trùng lặp"}},"order_currency":{"type":"string","description":"Order currency","x-description-i18n":{"vie":"Loại tiền tệ"}},"charged_by_vnpay":{"type":"integer","description":"Charged by VNPay","x-description-i18n":{"vie":"Số tiền thanh toán qua VNPay"}},"charged_by_qrpay":{"type":"integer","description":"Charged by QRPay","x-description-i18n":{"vie":"Số tiền khách thanh toán qua QRPAY"}},"custom_id":{"type":"string","description":"Custom ID","x-description-i18n":{"vie":"Mã tùy chỉnh"}},"last_editor":{"type":"object","description":"Last editor information","x-description-i18n":{"vie":"Thông tin người chỉnh sửa cuối cùng đơn hàng"},"properties":{"id":{"type":"string","description":"Editor ID","x-description-i18n":{"vie":"Mã người chỉnh sửa"}},"fb_id":{"type":"string","description":"Facebook ID of editor","x-description-i18n":{"vie":"Facebook ID người chỉnh sửa"}},"name":{"type":"string","description":"Editor name","x-description-i18n":{"vie":"Tên người chỉnh sửa"}},"email":{"type":"string","description":"Editor email","x-description-i18n":{"vie":"Email người chỉnh sửa"}},"avatar_url":{"type":"string","description":"Editor avatar URL","x-description-i18n":{"vie":"Link avatar người chỉnh sửa"}},"phone_number":{"type":"string","description":"Editor phone number","x-description-i18n":{"vie":"Số điện thoại người chỉnh sửa"}}}},"last_editor_id":{"type":"string","description":"Last editor ID","x-description-i18n":{"vie":"Mã người sửa cuối"}},"charged_by_momo":{"type":"integer","description":"Charged by MoMo","x-description-i18n":{"vie":"Số tiền khách thanh toán qua MOMO"}},"prepaid_by_point":{"type":"object","description":"Prepaid by point","x-description-i18n":{"vie":"Thanh toán bằng điểm thưởng"},"properties":{"money":{"type":"integer","description":"Money amount","x-description-i18n":{"vie":"Số tiền"},"example":15000},"point":{"type":"integer","description":"Point amount","x-description-i18n":{"vie":"Số điểm"},"example":15}},"example":{"money":15000,"point":15}},"bank_transfer_images":{"type":"array","description":"Bank transfer images","x-description-i18n":{"vie":"Hình ảnh chuyển khoản"},"items":{"type":"string","format":"uri"}},"transfer_money":{"type":"integer","description":"Transfer money","x-description-i18n":{"vie":"Số tiền khách chuyển khoản"}},"lock_order_by_user":{"type":"string","description":"Lock order by user ID","x-description-i18n":{"vie":"Mã người dùng khóa đơn hàng"}},"assigning_care":{"type":"object","description":"Assigning care information","x-description-i18n":{"vie":"Nhân viên chăm sóc"},"properties":{"id":{"type":"string","description":"Care ID","x-description-i18n":{"vie":"Mã người chăm sóc"}},"fb_id":{"type":"string","description":"Facebook ID of care","x-description-i18n":{"vie":"Facebook ID người chăm sóc"}},"name":{"type":"string","description":"Care name","x-description-i18n":{"vie":"Tên người chăm sóc"}},"email":{"type":"string","description":"Care email","x-description-i18n":{"vie":"Email người chăm sóc"}},"avatar_url":{"type":"string","description":"Care avatar URL","x-description-i18n":{"vie":"Link avatar người chăm sóc"}},"phone_number":{"type":"string","description":"Care phone number","x-description-i18n":{"vie":"Số điện thoại người chăm sóc"}}}},"assigning_care_id":{"type":"string","description":"Assigning care ID","x-description-i18n":{"vie":"Mã nhân viên chăm sóc"}},"time_assign_care":{"type":"string","format":"date-time","description":"Time assign care","x-description-i18n":{"vie":"Thời điểm phân công chăm sóc"}},"assigning_seller":{"type":"object","description":"Assigning seller information","x-description-i18n":{"vie":"Nhân viên được phân công"},"properties":{"id":{"type":"string","description":"Seller ID","x-description-i18n":{"vie":"Mã người bán"}},"fb_id":{"type":"string","description":"Facebook ID of seller","x-description-i18n":{"vie":"Facebook ID người bán"}},"name":{"type":"string","description":"Seller name","x-description-i18n":{"vie":"Tên người bán"}},"email":{"type":"string","description":"Seller email","x-description-i18n":{"vie":"Email người bán"}},"avatar_url":{"type":"string","description":"Seller avatar URL","x-description-i18n":{"vie":"Link avatar người bán"}},"phone_number":{"type":"string","description":"Seller phone number","x-description-i18n":{"vie":"Số điện thoại người bán"}}}},"einvoices":{"type":"array","items":{"$ref":"#/components/schemas/EInvoice"}},"charged_by_card":{"type":"integer","description":"Charged by card","x-description-i18n":{"vie":"Số tiền khách quẹt thẻ"}},"estimate_delivery_date":{"type":"string","format":"date-time","description":"Estimate delivery date","x-description-i18n":{"vie":"Ngày giao hàng dự kiến"}},"order_sources":{"type":"string","description":"Order sources ID","x-description-i18n":{"vie":"Mã nguồn đơn hàng"}},"charged_by_fundiin":{"type":"integer","description":"Charged by Fundiin","x-description-i18n":{"vie":"Số tiền thanh toán qua Fundiin"}},"surcharge":{"type":"integer","description":"Surcharge","x-description-i18n":{"vie":"Phụ thu"}},"is_linked_partner":{"type":"boolean","description":"Is linked partner","x-description-i18n":{"vie":"Đã liên kết đối tác"}},"call_laters":{"type":"array","description":"Call laters","x-description-i18n":{"vie":"Gọi lại sau"},"items":{"type":"object"}},"last_update_status_at":{"type":"string","format":"date-time","description":"Last update status at","x-description-i18n":{"vie":"Thời điểm cập nhật trạng thái cuối"}},"discount_by_customer_level":{"type":"integer","description":"Discount by customer level","x-description-i18n":{"vie":"Giảm giá theo cấp độ khách hàng"}},"viewing":{"type":"array","description":"Viewing","x-description-i18n":{"vie":"NV đang xem"},"items":{"type":"object"}},"additional_info":{"type":"object","description":"Additional info","x-description-i18n":{"vie":"Thông tin bổ sung"},"properties":{"service_partner":{"type":"string","description":"Service partner","x-description-i18n":{"vie":"Dịch vụ vận chuyển"},"enum":["instant"],"x-enum-descriptions":["Instant"],"x-enum-descriptions-i18n":{"vie":["Hỏa tốc"]}},"delivery_deadline":{"type":"string","format":"date-time","description":"Delivery deadline (ISO8601, no timezone). Send null to clear.","x-description-i18n":{"vie":"Hạn giao hàng (ISO8601, không kèm timezone). Gửi null để xóa."},"example":"2026-06-03T10:00:00"}}},"order_returned_ids":{"type":"string","description":"Order returned IDs","x-description-i18n":{"vie":"Mã đơn hàng đổi trả"}},"cost_surcharge":{"type":"integer","description":"Cost surcharge","x-description-i18n":{"vie":"Phụ phí"}},"time_send_partner":{"type":"string","format":"date-time","description":"Time send partner","x-description-i18n":{"vie":"Thời điểm gửi đơn vị vận chuyển"}},"charged_by_kredivo":{"type":"integer","description":"Charged by Kredivo","x-description-i18n":{"vie":"Số tiền thanh toán qua Kredivo"}},"discount":{"type":"integer","description":"Discount","x-description-i18n":{"vie":"Giảm giá"}},"histories":{"type":"array","description":"Histories","x-description-i18n":{"vie":"Lịch sử"},"items":{"type":"object"}},"duplicated_customer":{"type":"boolean","description":"Duplicated customer","x-description-i18n":{"vie":"Khách hàng trùng lặp"}},"customer_referral_code":{"type":"object","description":"Customer referral code","x-description-i18n":{"vie":"Mã giới thiệu khách hàng"},"properties":{"active":{"type":"string","description":"Active status","x-description-i18n":{"vie":"Trạng thái kích hoạt"},"example":"true"},"customer_id":{"type":"string","format":"uuid","description":"Customer ID","x-description-i18n":{"vie":"Mã khách hàng"},"example":"09bb9399-45f3-4897-a53a-85dde2f886fe"},"discount":{"type":"string","description":"Discount value","x-description-i18n":{"vie":"Giá trị giảm giá"},"example":"10"},"format":{"type":"string","description":"Referral code format","x-description-i18n":{"vie":"Định dạng mã giới thiệu"},"example":"{PHONE_NUMBER}"},"free_products_priced_between_approx":{"type":"object","description":"Free products priced between approximately","x-description-i18n":{"vie":"Miễn phí cho khách mới sản phẩm có giá"},"properties":{"active":{"type":"string","description":"Active status","x-description-i18n":{"vie":"Trạng thái kích hoạt"},"example":"true"},"operator":{"type":"string","description":"Comparison operator","x-description-i18n":{"vie":"Toán tử so sánh"},"example":"GreaterOrEqual"},"price":{"type":"string","description":"Price threshold","x-description-i18n":{"vie":"Ngưỡng giá"},"example":"150000"}}},"is_percent":{"type":"string","description":"Discount is percentage","x-description-i18n":{"vie":"Giảm giá theo phần trăm"},"example":"true"},"only_customers_with_level_will_have_referral_code":{"type":"string","description":"Only customers with level will have referral code","x-description-i18n":{"vie":"Chỉ khách hàng có cấp độ mới có mã giới thiệu"},"example":"true"},"referral_code":{"type":"string","description":"Referral code","x-description-i18n":{"vie":"Mã giới thiệu"},"example":"982843759"},"reward_points_for_old_customers":{"type":"object","description":"Reward points for customers","x-description-i18n":{"vie":"Điểm thưởng khách hàng"},"properties":{"active":{"type":"string","description":"Active status","x-description-i18n":{"vie":"Trạng thái kích hoạt"},"example":"true"},"money":{"type":"string","description":"Money reward","x-description-i18n":{"vie":"Tiền thưởng"},"example":"10000"},"point":{"type":"string","description":"Point reward","x-description-i18n":{"vie":"Điểm thưởng"},"example":"1"}}},"shop_customer_id":{"type":"string","format":"uuid","description":"Shop customer ID","x-description-i18n":{"vie":"Mã khách hàng shop"},"example":"f8160a4c-dfa7-4ee8-b540-d245755ea1f1"}},"example":{"active":"true","customer_id":"09bb9399-45f3-4897-a53a-85dde2f886fe","discount":"10","format":"{PHONE_NUMBER}","free_products_priced_between_approx":{"active":"true","operator":"GreaterOrEqual","price":"150000"},"is_percent":"true","only_customers_with_level_will_have_referral_code":"true","referral_code":"982843759","reward_points_for_old_customers":{"active":"true","money":"10000","point":"1"},"shop_customer_id":"f8160a4c-dfa7-4ee8-b540-d245755ea1f1"}},"tax":{"type":"integer","description":"Tax","x-description-i18n":{"vie":"Thuế"}},"is_from_ecommerce":{"type":"boolean","description":"Is from e-commerce","x-description-i18n":{"vie":"Đơn hàng từ sàn thương mại điện tử"}},"note_image":{"type":"array","description":"Note images","x-description-i18n":{"vie":"Link hình ảnh ghi chú"},"items":{"type":"string","format":"uri"}},"shopify_draft_order_id":{"type":"string","description":"Shopify draft order ID","x-description-i18n":{"vie":"Mã đơn hàng nháp Shopify"}},"display_id":{"type":"integer","description":"Display ID","x-description-i18n":{"vie":"Mã hiển thị"}},"shop_partner_id":{"type":"integer","description":"Shop partner ID","x-description-i18n":{"vie":"Mã đối tác shop"}},"is_locked":{"type":"boolean","description":"Order lock","x-description-i18n":{"vie":"Khóa đơn hàng"}},"merge_order":{"type":"boolean","description":"Allows merging orders","x-description-i18n":{"vie":"Cho phép gộp đơn"}}}}]},"WebhookCustomerResponse":{"type":"object","description":"Webhook response when webhook_types includes customers","x-description-i18n":{"vie":"Phản hồi webhook khi webhook_types bao gồm customers"},"allOf":[{"$ref":"#/components/schemas/Customer"}]},"WebhookProductResponse":{"type":"object","description":"Webhook response when webhook_types includes products","x-description-i18n":{"vie":"Phản hồi webhook khi webhook_types bao gồm products"},"properties":{"data":{"type":"object","properties":{"record":{"$ref":"#/components/schemas/Product"},"success":{"type":"boolean"}}}}},"WebhookInventoryResponse":{"type":"object","description":"Webhook response when webhook_types includes variations_warehouses","x-description-i18n":{"vie":"Phản hồi webhook khi webhook_types bao gồm variations_warehouses"},"properties":{"data":{"type":"object","properties":{"record":{"type":"object","properties":{"variation_id":{"type":"string","description":"Variation ID","x-description-i18n":{"vie":"Mã mẫu mã"}},"warehouse_id":{"type":"string","description":"Warehouse ID","x-description-i18n":{"vie":"Mã kho"}},"remain_quantity":{"type":"integer","description":"Remain quantity","x-description-i18n":{"vie":"Số lượng tồn"}},"actual_remain_quantity":{"type":"integer","description":"Actual remain quantity","x-description-i18n":{"vie":"Số lượng tồn thực tế"}},"change_quantity":{"type":"integer","description":"Change quantity","x-description-i18n":{"vie":"Số lượng thay đổi"}},"is_actual_remain_quantity":{"type":"boolean","description":"Is actual remain quantity","x-description-i18n":{"vie":"Là số lượng tồn thực tế"}},"inserted_at":{"type":"string","format":"date-time","description":"Inserted at","x-description-i18n":{"vie":"Thời điểm tạo"}},"type":{"type":"string","description":"Type","x-description-i18n":{"vie":"Loại"}}}},"success":{"type":"boolean"}}}}},"WebhookAutoCallResponse":{"type":"object","description":"Auto Voice result sent once to the configured webhook URL. Return HTTP 200 to acknowledge receipt.","x-description-i18n":{"vie":"Kết quả Auto Voice được gửi một lần tới webhook URL đã cấu hình. Trả về HTTP 200 để xác nhận đã nhận."},"properties":{"type":{"type":"string","example":"auto_call"},"shop_id":{"type":"integer","example":4},"order_id":{"type":"string","description":"Order ID or code used to trigger the call","x-description-i18n":{"vie":"Mã đơn hàng đã kích hoạt cuộc gọi"},"example":"1418"},"phone_number":{"type":"string","example":"0973667874"},"answered":{"type":"boolean","description":"Whether the callee picked up","x-description-i18n":{"vie":"Khách có nghe máy hay không"},"example":true},"dtmf":{"type":"string","nullable":true,"description":"Digits the callee pressed (null if none)","x-description-i18n":{"vie":"Phím khách bấm (null nếu không)"},"example":"1"}},"example":{"type":"auto_call","shop_id":4,"order_id":"1418","phone_number":"0973667874","answered":true,"dtmf":"1"}},"AdAccount":{"type":"object","description":"Ad accounts list response","x-description-i18n":{"vie":"Danh sách tài khoản quảng cáo"},"properties":{"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}},"data":{"type":"array","description":"List of ad accounts","x-description-i18n":{"vie":"Danh sách tài khoản quảng cáo"},"items":{"type":"object","properties":{"id":{"type":"string","description":"Ad account ID","x-description-i18n":{"vie":"Mã tài khoản quảng cáo"}},"name":{"type":"string","description":"Ad account name","x-description-i18n":{"vie":"Tên tài khoản quảng cáo"}},"account_status":{"type":"integer","description":"Account status","x-description-i18n":{"vie":"Trạng thái tài khoản"},"enum":[1,2,3,7,8,9,100,101,201,202],"x-enum-descriptions":["Active","Disabled","Unsettled","Awaiting risk review","Awaiting settlement","Within grace period","Awaiting closure","Closed","Any active status","Any closed status"],"x-enum-descriptions-i18n":{"vie":["Đang hoạt động","Vô hiệu hoá","Chưa thanh toán","Đang chờ duyệt rủi ro","Đang chờ thanh toán","Trong thời gian ân hạn","Đang chờ đóng","Đã đóng","Bất kỳ trạng thái nào đang hoạt động","Bất kỳ trạng thái nào đã đóng"]}},"currency":{"type":"string","description":"Currency used by the account","x-description-i18n":{"vie":"Đơn vị tiền tệ"}},"is_business":{"type":"boolean","description":"Business account (true) / Personal account (false)","x-description-i18n":{"vie":"Tài khoản doanh nghiệp (true) / Tài khoản cá nhân (false)"}},"sync_succeed_at":{"type":"string","format":"date-time","description":"Last successful sync timestamp","x-description-i18n":{"vie":"Thời điểm đồng bộ thành công gần nhất"}},"tags":{"type":"array","description":"Tags","x-description-i18n":{"vie":"Thẻ"},"items":{"type":"string"}}}}},"page_number":{"type":"integer","description":"Current page number","x-description-i18n":{"vie":"Trang hiện tại"}},"page_size":{"type":"integer","description":"Number of records per page","x-description-i18n":{"vie":"Số bản ghi mỗi trang"}},"total_entries":{"type":"integer","description":"Total number of ad accounts","x-description-i18n":{"vie":"Tổng số tài khoản quảng cáo"}},"total_pages":{"type":"integer","description":"Total number of pages","x-description-i18n":{"vie":"Tổng số trang"}}}},"CampaignListResponse":{"type":"object","properties":{"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}},"data":{"type":"array","description":"List of campaigns","x-description-i18n":{"vie":"Danh sách chiến dịch"},"items":{"type":"object","properties":{"id":{"type":"string","description":"Campaign ID","x-description-i18n":{"vie":"Mã chiến dịch"}},"name":{"type":"string","description":"Campaign name","x-description-i18n":{"vie":"Tên chiến dịch"}},"status":{"type":"string","description":"Campaign status","x-description-i18n":{"vie":"Trạng thái chiến dịch"},"enum":["ACTIVE","PAUSED","DELETED","ARCHIVED"],"x-enum-descriptions":["Active","Paused","Deleted","Archived"],"x-enum-descriptions-i18n":{"vie":["Đang hoạt động","Tạm dừng","Đã xoá","Đã lưu trữ"]}},"effective_status":{"type":"string","description":"Effective status","x-description-i18n":{"vie":"Trạng thái hiệu quả"},"enum":["ACTIVE","PAUSED","DELETED","ARCHIVED","IN_PROCESS","WITH_ISSUES"],"x-enum-descriptions":["Active","Paused","Deleted","Archived","In process","With issues"],"x-enum-descriptions-i18n":{"vie":["Đang hoạt động","Tạm dừng","Đã xoá","Đã lưu trữ","Đang tiến hành","Có vấn đề"]}},"objective":{"type":"string","description":"Campaign objective","x-description-i18n":{"vie":"Mục tiêu chiến dịch"},"enum":["APP_INSTALLS","BRAND_AWARENESS","CONVERSIONS","EVENT_RESPONSES","LEAD_GENERATION","LINK_CLICKS","LOCAL_AWARENESS","MESSAGES","OFFER_CLAIMS","OUTCOME_APP_PROMOTION","OUTCOME_AWARENESS","OUTCOME_ENGAGEMENT","OUTCOME_LEADS","OUTCOME_SALES","OUTCOME_TRAFFIC","PAGE_LIKES","POST_ENGAGEMENT","PRODUCT_CATALOG_SALES","REACH","STORE_VISITS","VIDEO_VIEWS"],"x-enum-descriptions":["App installs","Brand awareness","Conversions","Event responses","Lead generation","Link clicks","Local awareness","Messages","Offer claims","App promotion","Awareness","Engagement","Leads","Sales","Traffic","Page likes","Post engagement","Product catalog sales","Reach","Store visits","Video views"],"x-enum-descriptions-i18n":{"vie":["Lượt cài đặt ứng dụng","Nhận biết thương hiệu","Chuyển đổi","Lượt phản hồi sự kiện","Tạo khách hàng tiềm năng","Lượt nhấp vào liên kết","Nhận biết tại địa phương","Tin nhắn","Lượt nhận ưu đãi","Kết quả quảng bá ứng dụng","Kết quả nhận biết","Kết quả tương tác","Kết quả khách hàng tiềm năng","Kết quả doanh số","Kết quả lưu lượng truy cập","Thích trang","Tương tác với bài viết","Doanh số từ danh mục sản phẩm","Phạm vi tiếp cận","Lượt truy cập cửa hàng","Xem quảng cáo video"]}},"created_time":{"type":"string","format":"date-time","description":"Campaign creation time","x-description-i18n":{"vie":"Thời điểm tạo chiến dịch"}},"start_time":{"type":"string","format":"date-time","description":"Campaign start time","x-description-i18n":{"vie":"Thời điểm bắt đầu chiến dịch"}},"end_time":{"type":"string","format":"date-time","nullable":true,"description":"Campaign end time","x-description-i18n":{"vie":"Thời điểm kết thúc chiến dịch"}},"marketer_id":{"type":"string","nullable":true,"description":"Marketer ID assigned","x-description-i18n":{"vie":"Mã marketer phụ trách"}},"product_id":{"type":"string","nullable":true,"description":"Product ID","x-description-i18n":{"vie":"Mã sản phẩm"}},"product_category_id":{"type":"string","nullable":true,"description":"Product category ID","x-description-i18n":{"vie":"Mã danh mục sản phẩm"}},"product":{"nullable":true,"description":"Product of campaign","x-description-i18n":{"vie":"Sản phẩm của chiến dịch"},"allOf":[{"$ref":"#/components/schemas/Product"}]},"ad_account":{"type":"object","description":"Ad account","x-description-i18n":{"vie":"Tài khoản quảng cáo"},"properties":{"id":{"type":"string","description":"Ad account ID","x-description-i18n":{"vie":"Mã tài khoản quảng cáo"}},"name":{"type":"string","description":"Ad account name","x-description-i18n":{"vie":"Tên tài khoản quảng cáo"}},"currency":{"type":"string","description":"Currency used by the account","x-description-i18n":{"vie":"Đơn vị tiền tệ"}}}},"insights":{"type":"object","description":"Campaign performance metrics","x-description-i18n":{"vie":"Chỉ số hiệu suất chiến dịch"},"properties":{"ad_ids":{"type":"array","description":"List of ad IDs in this campaign","x-description-i18n":{"vie":"Danh sách mã quảng cáo trong chiến dịch"},"items":{"type":"string"}},"impressions":{"type":"number","description":"Number of ad impressions","x-description-i18n":{"vie":"Lượt hiển thị"}},"clicks":{"type":"integer","description":"Number of clicks (all)","x-description-i18n":{"vie":"Số lần nhấp (tất cả)"}},"reach":{"type":"integer","description":"Number of people reached via Instant Experience","x-description-i18n":{"vie":"Số người tiếp cận Trải nghiệm tức thì"}},"spend":{"type":"number","description":"Total amount spent","x-description-i18n":{"vie":"Số tiền đã chi tiêu"}},"cpc":{"type":"number","description":"CPC","x-description-i18n":{"vie":"CPC"}},"cpm":{"type":"number","description":"CPM","x-description-i18n":{"vie":"CPM"}},"cpp":{"type":"number","description":"CPP","x-description-i18n":{"vie":"CPP"}},"ctr":{"type":"number","description":"CTR","x-description-i18n":{"vie":"CTR"}},"frequency":{"type":"number","description":"Average frequency of ad views per person","x-description-i18n":{"vie":"Tần suất"}},"ad_performance_session":{"type":"integer","description":"Overall performance metric","x-description-i18n":{"vie":"Hiệu quả"}},"cost_per_1000_accounts_center_reach":{"type":"number","description":"Cost per 1000 accounts center reach","x-description-i18n":{"vie":"Chi phí trên mỗi 1000 tài khoản tiếp cận"}},"cost_per_result":{"type":"number","description":"Cost per result","x-description-i18n":{"vie":"Chi phí trên mỗi kết quả"}},"avg_purchase_conversion_value":{"type":"number","description":"Average purchase conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi trung bình của lượt mua"}},"indicator_result":{"type":"number","description":"Result indicator value","x-description-i18n":{"vie":"Kết quả"}},"result_roas":{"type":"number","description":"Return on ad spend (ROAS)","x-description-i18n":{"vie":"Kết quả ROAS"}},"ad_engagement_session":{"type":"integer","description":"Overall engagement metric","x-description-i18n":{"vie":"Tương tác"}},"link_click":{"type":"integer","description":"Link clicks","x-description-i18n":{"vie":"Lượt click vào liên kết"}},"like":{"type":"integer","description":"Facebook likes","x-description-i18n":{"vie":"Lượt thích trên Facebook"}},"comment":{"type":"integer","description":"Post comments","x-description-i18n":{"vie":"Bình luận về bài viết"}},"post_engagement":{"type":"integer","description":"Post engagements","x-description-i18n":{"vie":"Lượt tương tác với bài viết"}},"post_reaction":{"type":"integer","description":"Post reactions","x-description-i18n":{"vie":"Cảm xúc về bài viết"}},"post":{"type":"integer","description":"Post shares","x-description-i18n":{"vie":"Lượt chia sẻ bài viết"}},"onsite_conversion_post_save":{"type":"integer","description":"Post saves","x-description-i18n":{"vie":"Lượt lưu bài viết"}},"photo_view":{"type":"integer","description":"Photo views","x-description-i18n":{"vie":"Lượt xem ảnh"}},"video_view":{"type":"integer","description":"Video plays (at least 3 seconds)","x-description-i18n":{"vie":"Lượt phát video trong tối thiểu 3 giây"}},"inline_link_click_ctr":{"type":"number","description":"CTR (link click-through rate, %)","x-description-i18n":{"vie":"CTR (Tỷ lệ nhấp vào liên kết)"}},"outbound_click":{"type":"integer","description":"Outbound clicks","x-description-i18n":{"vie":"Lượt click ra ngoài"}},"onsite_conversion_messaging_conversation_started_7d":{"type":"integer","description":"Messaging conversations started (7-day window)","x-description-i18n":{"vie":"Lượt bắt đầu cuộc trò chuyện qua tin nhắn"}},"onsite_conversion_messaging_first_reply":{"type":"integer","description":"New messaging contacts","x-description-i18n":{"vie":"Người liên hệ nhắn tin mới"}},"onsite_conversion_messaging_block":{"type":"integer","description":"Messaging blocks","x-description-i18n":{"vie":"Lượt chặn"}},"video_thruplay_watched_actions":{"type":"integer","description":"ThruPlays","x-description-i18n":{"vie":"ThruPlays"}},"video_play_actions":{"type":"integer","description":"Video plays","x-description-i18n":{"vie":"Lượt phát video"}},"video_p25_watched_actions":{"type":"integer","description":"Video plays at 25% completion","x-description-i18n":{"vie":"Lượt phát 25% thời lượng video"}},"video_p50_watched_actions":{"type":"integer","description":"Video plays at 50% completion","x-description-i18n":{"vie":"Lượt phát 50% thời lượng video"}},"video_p75_watched_actions":{"type":"integer","description":"Video plays at 75% completion","x-description-i18n":{"vie":"Lượt phát 75% thời lượng video"}},"video_p95_watched_actions":{"type":"integer","description":"Video plays at 95% completion","x-description-i18n":{"vie":"Lượt phát 95% thời lượng video"}},"video_p100_watched_actions":{"type":"integer","description":"Video plays at 100% completion","x-description-i18n":{"vie":"Lượt phát 100% thời lượng video"}},"estimated_ad_recallers":{"type":"number","description":"Estimated ad recall lift (people)","x-description-i18n":{"vie":"Độ cải thiện khả năng nhớ đến quảng cáo theo ước tính (Người)"}},"cost_per_outbound_click":{"type":"number","description":"Cost per outbound click","x-description-i18n":{"vie":"Chi phí trên mỗi lượt click ra ngoài"}},"cost_per_thruplay":{"type":"number","description":"Cost per ThruPlay","x-description-i18n":{"vie":"Chi phí trên mỗi lượt ThruPlay"}},"outbound_clicks_ctr":{"type":"number","description":"Outbound click-through rate (%)","x-description-i18n":{"vie":"CTR ra ngoài (Tỷ lệ nhấp)"}},"cost_per_post_engagement":{"type":"number","description":"Cost per post engagement","x-description-i18n":{"vie":"Chi phí trên mỗi lượt tương tác với bài viết"}},"estimated_ad_recall_rate":{"type":"number","description":"Estimated ad recall lift rate (%)","x-description-i18n":{"vie":"Tỷ lệ độ cải thiện khả năng nhớ đến quảng cáo theo ước tính"}},"cost_per_estimated_ad_recallers":{"type":"number","description":"Cost per estimated ad recall lift (people)","x-description-i18n":{"vie":"Chi phí trên độ cải thiện khả năng nhớ đến quảng cáo theo ước tính (Người)"}},"cost_per_messaging_conversation_started":{"type":"number","description":"Cost per messaging conversation started","x-description-i18n":{"vie":"Chi phí trên mỗi lượt bắt đầu cuộc trò chuyện qua tin nhắn"}},"lead":{"type":"number","description":"Leads","x-description-i18n":{"vie":"Khách hàng tiềm năng"}},"website_lead":{"type":"number","description":"Website leads","x-description-i18n":{"vie":"Số khách hàng tiềm năng trên trang web"}},"offline_lead":{"type":"number","description":"Offline leads","x-description-i18n":{"vie":"Số khách hàng tiềm năng offline"}},"meta_lead":{"type":"number","description":"Meta leads","x-description-i18n":{"vie":"Khách hàng tiềm năng trên Meta"}},"lead_conversion_value":{"type":"number","description":"Lead conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi khách hàng tiềm năng"}},"website_lead_conversion_value":{"type":"number","description":"Website lead conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi khách hàng tiềm năng trên trang web"}},"offline_lead_conversion_value":{"type":"number","description":"Offline lead conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi khách hàng tiềm năng offline"}},"meta_lead_conversion_value":{"type":"number","description":"Meta lead conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi khách hàng tiềm năng của Meta"}},"cost_per_lead":{"type":"number","description":"Cost per lead","x-description-i18n":{"vie":"Chi phí trên mỗi khách hàng tiềm năng"}},"omni_purchase":{"type":"number","description":"Purchases","x-description-i18n":{"vie":"Lượt mua"}},"inapp_omni_purchase":{"type":"number","description":"In-app purchases","x-description-i18n":{"vie":"Lượt khách hàng trong ứng dụng"}},"website_omni_purchase":{"type":"number","description":"Website purchases","x-description-i18n":{"vie":"Lượt mua trên web"}},"offline_omni_purchase":{"type":"number","description":"Offline purchases","x-description-i18n":{"vie":"Lượt mua hàng offline"}},"meta_omni_purchase":{"type":"number","description":"Meta purchases","x-description-i18n":{"vie":"Lượt mua trên Meta"}},"omni_purchase_conversion_value":{"type":"number","description":"Purchase conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt mua"}},"inapp_omni_purchase_conversion_value":{"type":"number","description":"In-app purchase conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi của lượt mua hàng trong ứng dụng"}},"website_omni_purchase_conversion_value":{"type":"number","description":"Website purchase conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi của lượt mua trên web"}},"offline_omni_purchase_conversion_value":{"type":"number","description":"Offline purchase conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt mua hàng offline"}},"meta_omni_purchase_conversion_value":{"type":"number","description":"Meta purchase conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi của lượt mua trên Meta"}},"cost_per_omni_purchase":{"type":"number","description":"Cost per purchase","x-description-i18n":{"vie":"Chi phí trên mỗi lượt mua"}},"omni_initiated_checkout":{"type":"number","description":"Checkout initiated","x-description-i18n":{"vie":"Lượt bắt đầu thanh toán"}},"inapp_omni_initiated_checkout":{"type":"number","description":"In-app checkout initiated","x-description-i18n":{"vie":"Lượt bắt đầu thanh toán trên ứng dụng di động"}},"website_omni_initiated_checkout":{"type":"number","description":"Website checkout initiated","x-description-i18n":{"vie":"Lượt bắt đầu thanh toán trên web"}},"offline_omni_initiated_checkout":{"type":"number","description":"Offline checkout initiated","x-description-i18n":{"vie":"Lượt bắt đầu thanh toán offline"}},"meta_omni_initiated_checkout":{"type":"number","description":"Meta checkout initiated","x-description-i18n":{"vie":"Lượt bắt đầu thanh toán trên Meta"}},"omni_initiated_checkout_conversion_value":{"type":"number","description":"Checkout initiated conversion value","x-description-i18n":{"vie":"Giá trị của chuyển đổi bắt đầu thanh toán"}},"inapp_omni_initiated_checkout_conversion_value":{"type":"number","description":"In-app checkout initiated conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt bắt đầu thanh toán trong ứng dụng"}},"website_omni_initiated_checkout_conversion_value":{"type":"number","description":"Website checkout initiated conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi của số lượt bắt đầu thanh toán trên trang web"}},"offline_omni_initiated_checkout_conversion_value":{"type":"number","description":"Offline checkout initiated conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi offline từ sự kiện bắt đầu thanh toán"}},"meta_omni_initiated_checkout_conversion_value":{"type":"number","description":"Meta checkout initiated conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt bắt đầu thanh toán trên Meta"}},"cost_per_omni_initiated_checkout":{"type":"number","description":"Cost per checkout initiated","x-description-i18n":{"vie":"Chi phí trên mỗi lượt bắt đầu thanh toán"}},"omni_complete_registration":{"type":"number","description":"Registrations completed","x-description-i18n":{"vie":"Lượt hoàn tất đăng ký"}},"inapp_omni_complete_registration":{"type":"number","description":"In-app registrations completed","x-description-i18n":{"vie":"Lượt hoàn tất đăng ký trên ứng dụng di động"}},"website_omni_complete_registration":{"type":"number","description":"Website registrations completed","x-description-i18n":{"vie":"Lượt hoàn tất đăng ký trên trang web"}},"offline_omni_complete_registration":{"type":"number","description":"Offline registrations completed","x-description-i18n":{"vie":"Lượt hoàn tất đăng ký offline"}},"omni_complete_registration_conversion_value":{"type":"number","description":"Registration completed conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt hoàn tất đăng ký"}},"inapp_omni_complete_registration_conversion_value":{"type":"number","description":"In-app registration completed conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt hoàn tất đăng ký trong ứng dụng"}},"website_omni_complete_registration_conversion_value":{"type":"number","description":"Website registration completed conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt hoàn tất đăng ký trên trang web"}},"offline_omni_complete_registration_conversion_value":{"type":"number","description":"Offline registration completed conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt hoàn tất đăng ký offline"}},"cost_per_omni_complete_registration":{"type":"number","description":"Cost per registration completed","x-description-i18n":{"vie":"Chi phí trên mỗi lượt hoàn tất đăng ký"}},"omni_view_content":{"type":"number","description":"Content views","x-description-i18n":{"vie":"Lượt xem nội dung"}},"inapp_omni_view_content":{"type":"number","description":"In-app content views","x-description-i18n":{"vie":"Lượt xem nội dung trong ứng dụng"}},"website_omni_view_content":{"type":"number","description":"Website content views","x-description-i18n":{"vie":"Lượt xem nội dung trên trang web"}},"offline_omni_view_content":{"type":"number","description":"Offline content views","x-description-i18n":{"vie":"Lượt xem nội dung offline"}},"meta_omni_view_content":{"type":"number","description":"Meta content views","x-description-i18n":{"vie":"Lượt xem nội dung trên Meta"}},"omni_view_content_conversion_value":{"type":"number","description":"Content view conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt xem nội dung"}},"inapp_omni_view_content_conversion_value":{"type":"number","description":"In-app content view conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt xem nội dung trong ứng dụng"}},"website_omni_view_content_conversion_value":{"type":"number","description":"Website content view conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt xem nội dung trên trang web"}},"offline_omni_view_content_conversion_value":{"type":"number","description":"Offline content view conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi offline từ sự kiện xem nội dung"}},"meta_omni_view_content_conversion_value":{"type":"number","description":"Meta content view conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt xem nội dung trên Meta"}},"cost_per_omni_view_content":{"type":"number","description":"Cost per content view","x-description-i18n":{"vie":"Chi phí trên mỗi lượt xem nội dung"}},"omni_search":{"type":"number","description":"Searches","x-description-i18n":{"vie":"Tìm kiếm"}},"inapp_omni_search":{"type":"number","description":"In-app searches","x-description-i18n":{"vie":"Lượt tìm kiếm trong ứng dụng"}},"website_omni_search":{"type":"number","description":"Website searches","x-description-i18n":{"vie":"Lượt tìm kiếm trên trang web"}},"offline_omni_search":{"type":"number","description":"Offline searches","x-description-i18n":{"vie":"Lượt tìm kiếm offline"}},"omni_search_conversion_value":{"type":"number","description":"Search conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi của tìm kiếm"}},"inapp_omni_search_conversion_value":{"type":"number","description":"In-app search conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi tìm kiếm ứng dụng di động"}},"website_omni_search_conversion_value":{"type":"number","description":"Website search conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi của tìm kiếm trên trang web"}},"offline_omni_search_conversion_value":{"type":"number","description":"Offline search conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt tìm kiếm offline"}},"cost_per_omni_search":{"type":"number","description":"Cost per search","x-description-i18n":{"vie":"Chi phí trên mỗi lượt tìm kiếm"}},"omni_add_to_cart":{"type":"number","description":"Add to cart","x-description-i18n":{"vie":"Lượt thêm vào giỏ hàng"}},"inapp_omni_add_to_cart":{"type":"number","description":"In-app add to cart","x-description-i18n":{"vie":"Lượt thêm vào giỏ hàng trong ứng dụng"}},"website_omni_add_to_cart":{"type":"number","description":"Website add to cart","x-description-i18n":{"vie":"Lượt thêm vào giỏ hàng trên trang web"}},"offline_omni_add_to_cart":{"type":"number","description":"Offline add to cart","x-description-i18n":{"vie":"Lượt thêm vào giỏ hàng offline"}},"meta_omni_add_to_cart":{"type":"number","description":"Meta add to cart","x-description-i18n":{"vie":"Lượt thêm vào giỏ hàng trên Meta"}},"omni_add_to_cart_conversion_value":{"type":"number","description":"Add to cart conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt thêm vào giỏ hàng"}},"inapp_omni_add_to_cart_conversion_value":{"type":"number","description":"In-app add to cart conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt thêm ứng dụng vào giỏ hàng"}},"website_omni_add_to_cart_conversion_value":{"type":"number","description":"Website add to cart conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt thêm vào giỏ hàng trên trang web"}},"offline_omni_add_to_cart_conversion_value":{"type":"number","description":"Offline add to cart conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi offline từ các lượt thêm vào giỏ hàng"}},"meta_omni_add_to_cart_conversion_value":{"type":"number","description":"Meta add to cart conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt thêm vào giỏ hàng trên Meta"}},"cost_per_omni_add_to_cart":{"type":"number","description":"Cost per add to cart","x-description-i18n":{"vie":"Chi phí trên mỗi lượt thêm vào giỏ hàng"}},"omni_add_to_wishlist":{"type":"number","description":"Add to wishlist","x-description-i18n":{"vie":"Thêm vào danh sách mong ước"}},"inapp_omni_add_to_wishlist":{"type":"number","description":"In-app add to wishlist","x-description-i18n":{"vie":"Thêm vào danh sách mong ước trong ứng dụng di động"}},"website_omni_add_to_wishlist":{"type":"number","description":"Website add to wishlist","x-description-i18n":{"vie":"Thêm vào danh sách mong ước trên trang web"}},"offline_omni_add_to_wishlist":{"type":"number","description":"Offline add to wishlist","x-description-i18n":{"vie":"Thêm vào danh sách mong ước offline"}},"meta_omni_add_to_wishlist":{"type":"number","description":"Meta add to wishlist","x-description-i18n":{"vie":"Thêm vào danh sách mong ước trên Meta"}},"omni_add_to_wishlist_conversion_value":{"type":"number","description":"Add to wishlist conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt thêm vào danh sách mong ước"}},"inapp_omni_add_to_wishlist_conversion_value":{"type":"number","description":"In-app add to wishlist conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt thêm vào danh sách mong ước trong ứng dụng"}},"website_omni_add_to_wishlist_conversion_value":{"type":"number","description":"Website add to wishlist conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt thêm vào danh sách mong ước trên trang web"}},"offline_omni_add_to_wishlist_conversion_value":{"type":"number","description":"Offline add to wishlist conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi offline từ lượt thêm vào danh sách mong ước"}},"meta_omni_add_to_wishlist_conversion_value":{"type":"number","description":"Meta add to wishlist conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt thêm vào danh sách mong ước trên Meta"}},"cost_per_omni_add_to_wishlist":{"type":"number","description":"Cost per add to wishlist","x-description-i18n":{"vie":"Chi phí trên mỗi lượt thêm vào danh sách mong ước"}},"customize_product_total":{"type":"number","description":"Product customizations","x-description-i18n":{"vie":"Lượt tuỳ chỉnh sản phẩm"}},"inapp_customize_product_total":{"type":"number","description":"In-app product customizations","x-description-i18n":{"vie":"Lượt tuỳ chỉnh sản phẩm trong ứng dụng di động"}},"website_customize_product_total":{"type":"number","description":"Website product customizations","x-description-i18n":{"vie":"Lượt tuỳ chỉnh sản phẩm trên trang web"}},"offline_customize_product_total":{"type":"number","description":"Offline product customizations","x-description-i18n":{"vie":"Lượt tuỳ chỉnh sản phẩm offline"}},"customize_product_total_conversion_value":{"type":"number","description":"Product customization conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt tuỳ chỉnh sản phẩm"}},"inapp_customize_product_total_conversion_value":{"type":"number","description":"In-app product customization conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt tuỳ chỉnh sản phẩm trong ứng dụng"}},"website_customize_product_total_conversion_value":{"type":"number","description":"Website product customization conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt tuỳ chỉnh sản phẩm trên trang web"}},"offline_customize_product_total_conversion_value":{"type":"number","description":"Offline product customization conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt tuỳ chỉnh sản phẩm offline"}},"cost_per_customize_product_total":{"type":"number","description":"Cost per product customization","x-description-i18n":{"vie":"Chi phí trên mỗi lượt tuỳ chỉnh sản phẩm"}},"start_trial_total":{"type":"number","description":"Trials started","x-description-i18n":{"vie":"Lượt bắt đầu dùng thử"}},"inapp_start_trial_total":{"type":"number","description":"In-app trials started","x-description-i18n":{"vie":"Lượt bắt đầu dùng thử trong ứng dụng di động"}},"website_start_trial_total":{"type":"number","description":"Website trials started","x-description-i18n":{"vie":"Lượt bắt đầu dùng thử trên trang web"}},"offline_start_trial_total":{"type":"number","description":"Offline trials started","x-description-i18n":{"vie":"Lượt bắt đầu dùng thử offline"}},"start_trial_total_conversion_value":{"type":"number","description":"Trial started conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt bắt đầu dùng thử"}},"inapp_start_trial_total_conversion_value":{"type":"number","description":"In-app trial started conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt bắt đầu dùng thử trong ứng dụng"}},"website_start_trial_total_conversion_value":{"type":"number","description":"Website trial started conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt bắt đầu dùng thử trên trang web"}},"offline_start_trial_total_conversion_value":{"type":"number","description":"Offline trial started conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt bắt đầu dùng thử offline"}},"cost_per_start_trial_total":{"type":"number","description":"Cost per trial started","x-description-i18n":{"vie":"Chi phí trên mỗi lượt bắt đầu dùng thử"}},"subscribe_total":{"type":"number","description":"Subscriptions","x-description-i18n":{"vie":"Lượt đăng ký"}},"inapp_subscribe_total":{"type":"number","description":"In-app subscriptions","x-description-i18n":{"vie":"Lượt đăng ký trong ứng dụng di động"}},"website_subscribe_total":{"type":"number","description":"Website subscriptions","x-description-i18n":{"vie":"Lượt đăng ký trên trang web"}},"offline_subscribe_total":{"type":"number","description":"Offline subscriptions","x-description-i18n":{"vie":"Lượt đăng ký offline"}},"subscribe_total_conversion_value":{"type":"number","description":"Subscription conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt đăng ký"}},"inapp_subscribe_total_conversion_value":{"type":"number","description":"In-app subscription conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt đăng ký trong ứng dụng"}},"website_subscribe_total_conversion_value":{"type":"number","description":"Website subscription conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt đăng ký trên trang web"}},"offline_subscribe_total_conversion_value":{"type":"number","description":"Offline subscription conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt đăng ký offline"}},"cost_per_subscribe_total":{"type":"number","description":"Cost per subscription","x-description-i18n":{"vie":"Chi phí trên mỗi lượt đăng ký"}},"submit_application_total":{"type":"number","description":"Applications submitted","x-description-i18n":{"vie":"Lượt gửi đơn"}},"inapp_submit_application_total":{"type":"number","description":"In-app applications submitted","x-description-i18n":{"vie":"Lượt gửi đơn trong ứng dụng di động"}},"website_submit_application_total":{"type":"number","description":"Website applications submitted","x-description-i18n":{"vie":"Lượt gửi đơn trên trang web"}},"offline_submit_application_total":{"type":"number","description":"Offline applications submitted","x-description-i18n":{"vie":"Lượt gửi đơn offline"}},"meta_submit_application_total":{"type":"number","description":"Meta applications submitted","x-description-i18n":{"vie":"Lượt gửi đơn đăng ký trên Meta"}},"submit_application_total_conversion_value":{"type":"number","description":"Application submitted conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt gửi đơn"}},"inapp_submit_application_total_conversion_value":{"type":"number","description":"In-app application submitted conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt gửi đơn đăng ký trong ứng dụng"}},"website_submit_application_total_conversion_value":{"type":"number","description":"Website application submitted conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt gửi đơn đăng ký trên trang web"}},"offline_submit_application_total_conversion_value":{"type":"number","description":"Offline application submitted conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt gửi đơn đăng ký offline"}},"meta_submit_application_total_conversion_value":{"type":"number","description":"Meta application submitted conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt gửi đơn đăng ký trên Meta"}},"cost_per_submit_application_total":{"type":"number","description":"Cost per application submitted","x-description-i18n":{"vie":"Chi phí trên mỗi lượt gửi đơn"}},"contact_total":{"type":"number","description":"Contacts","x-description-i18n":{"vie":"Người liên hệ"}},"inapp_contact_total":{"type":"number","description":"In-app contacts","x-description-i18n":{"vie":"Người liên hệ trong ứng dụng di động"}},"website_contact_total":{"type":"number","description":"Website contacts","x-description-i18n":{"vie":"Người liên hệ trên trang web"}},"offline_contact_total":{"type":"number","description":"Offline contacts","x-description-i18n":{"vie":"Người liên hệ offline"}},"contact_total_conversion_value":{"type":"number","description":"Contact conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ người liên hệ"}},"inapp_contact_total_conversion_value":{"type":"number","description":"In-app contact conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ người liên hệ trong ứng dụng"}},"website_contact_total_conversion_value":{"type":"number","description":"Website contact conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ người liên hệ trên trang web"}},"offline_contact_total_conversion_value":{"type":"number","description":"Offline contact conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ người liên hệ offline"}},"cost_per_contact_total":{"type":"number","description":"Cost per contact","x-description-i18n":{"vie":"Chi phí trên mỗi lượt liên hệ"}},"landing_page_view":{"type":"number","description":"Landing page views","x-description-i18n":{"vie":"Số lượt xem trang đích"}},"inapp_landing_page_view":{"type":"number","description":"In-app landing page views","x-description-i18n":{"vie":"Lượt xem trang đích trong ứng dụng"}},"website_landing_page_view":{"type":"number","description":"Website landing page views","x-description-i18n":{"vie":"Lượt xem trang đích trên trang web"}},"cost_per_landing_page_view":{"type":"number","description":"Cost per landing page view","x-description-i18n":{"vie":"Chi phí trên mỗi lượt xem trang đích"}},"order_created":{"type":"number","description":"Orders created","x-description-i18n":{"vie":"Đơn đặt hàng đã tạo"}},"order_shipped":{"type":"number","description":"Orders shipped","x-description-i18n":{"vie":"Đơn đặt hàng đã vận chuyển"}},"purchase_roas":{"type":"number","description":"Purchase ROAS","x-description-i18n":{"vie":"ROAS (Lợi nhuận trên chi tiêu quảng cáo) của lượt mua"}},"inapp_purchase_roas":{"type":"number","description":"In-app purchase ROAS","x-description-i18n":{"vie":"ROAS (Lợi nhuận trên chi tiêu quảng cáo) của lượt mua trong ứng dụng"}},"website_purchase_roas":{"type":"number","description":"Website purchase ROAS","x-description-i18n":{"vie":"ROAS (Lợi nhuận trên chi tiêu quảng cáo) của lượt mua trên trang web"}},"order_statistics":{"type":"array","description":"Order count grouped by day offset from campaign start","x-description-i18n":{"vie":"Thống kê đơn hàng theo ngày kể từ khi chiến dịch bắt đầu"},"items":{"type":"object","properties":{"id":{"type":"integer","description":"Day offset","x-description-i18n":{"vie":"Ngày thứ (tính từ ngày bắt đầu)"}},"order_count":{"type":"integer","description":"Number of orders on that day","x-description-i18n":{"vie":"Số đơn hàng trong ngày đó"}}}}}}}}}},"summary":{"type":"object","description":"Aggregated performance metrics across all campaigns","x-description-i18n":{"vie":"Tổng hợp chỉ số hiệu suất của tất cả chiến dịch"},"properties":{"impressions":{"type":"number","description":"Total impressions","x-description-i18n":{"vie":"Tổng lượt hiển thị"}},"clicks":{"type":"integer","description":"Total clicks","x-description-i18n":{"vie":"Tổng số lần nhấp (tất cả)"}},"reach":{"type":"integer","description":"Total unique people reached","x-description-i18n":{"vie":"Tổng số người tiếp cận Trải nghiệm tức thì"}},"spend":{"type":"number","description":"Total amount spent","x-description-i18n":{"vie":"Tổng số tiền đã chi tiêu"}},"cpc":{"type":"number","description":"CPC","x-description-i18n":{"vie":"CPC"}},"cpm":{"type":"number","description":"CPM","x-description-i18n":{"vie":"CPM"}},"cpp":{"type":"number","description":"CPP","x-description-i18n":{"vie":"CPP"}},"ctr":{"type":"number","description":"CTR","x-description-i18n":{"vie":"CTR"}},"frequency":{"type":"number","description":"Average frequency","x-description-i18n":{"vie":"Tần suất trung bình"}}}},"page_number":{"type":"integer","description":"Current page number","x-description-i18n":{"vie":"Trang hiện tại"}},"page_size":{"type":"integer","description":"Number of records per page","x-description-i18n":{"vie":"Số bản ghi mỗi trang"}},"total_entries":{"type":"integer","description":"Total number of campaigns","x-description-i18n":{"vie":"Tổng số chiến dịch"}},"total_pages":{"type":"integer","description":"Total number of pages","x-description-i18n":{"vie":"Tổng số trang"}}}},"AdSetListResponse":{"type":"object","properties":{"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}},"data":{"type":"array","description":"List of ad sets","x-description-i18n":{"vie":"Danh sách nhóm quảng cáo"},"items":{"type":"object","properties":{"id":{"type":"string","description":"Ad set ID","x-description-i18n":{"vie":"Mã nhóm quảng cáo"}},"name":{"type":"string","description":"Ad set name","x-description-i18n":{"vie":"Tên nhóm quảng cáo"}},"status":{"type":"string","description":"Ad set status","x-description-i18n":{"vie":"Trạng thái nhóm quảng cáo"},"enum":["ACTIVE","PAUSED","DELETED","ARCHIVED"],"x-enum-descriptions":["Active","Paused","Deleted","Archived"],"x-enum-descriptions-i18n":{"vie":["Đang hoạt động","Tạm dừng","Đã xoá","Đã lưu trữ"]}},"effective_status":{"type":"string","description":"Effective status","x-description-i18n":{"vie":"Trạng thái hiệu quả"},"enum":["ACTIVE","PAUSED","DELETED","PENDING_REVIEW","DISAPPROVED","PREAPPROVED","PENDING_BILLING_INFO","CAMPAIGN_PAUSED","ARCHIVED","ADSET_PAUSED","IN_PROCESS","WITH_ISSUES"],"x-enum-descriptions":["Active","Paused","Deleted","Pending review","Disapproved","Preapproved","Pending billing info","Campaign paused","Archived","Ad set paused","In process","With issues"],"x-enum-descriptions-i18n":{"vie":["Đang hoạt động","Tạm dừng","Đã xoá","Đang chờ duyệt","Đã từ chối","Đã chấp nhận","Đang chờ thông tin thanh toán","Quảng cáo đã tạm dừng","Đã lưu trữ","Bộ lọc đã tạm dừng","Đang tiến hành","Có vấn đề"]}},"created_time":{"type":"string","format":"date-time","description":"Ad set creation time","x-description-i18n":{"vie":"Thời điểm tạo"}},"start_time":{"type":"string","format":"date-time","description":"Ad set start time","x-description-i18n":{"vie":"Thời điểm bắt đầu"}},"end_time":{"type":"string","format":"date-time","nullable":true,"description":"Ad set end time","x-description-i18n":{"vie":"Thời điểm kết thúc"}},"bid_amount":{"type":"integer","description":"Bid amount","x-description-i18n":{"vie":"Giá thầu"}},"bid_strategy":{"type":"string","nullable":true,"description":"Bid strategy","x-description-i18n":{"vie":"Chiến lược giá thầu"},"enum":["LOWEST_COST_WITHOUT_CAP","LOWEST_COST_WITH_BID_CAP","COST_CAP","LOWEST_COST_WITH_MIN_ROAS"],"x-enum-descriptions":["Lowest cost without cap","Lowest cost with bid cap","Cost cap","Lowest cost with minimum ROAS"],"x-enum-descriptions-i18n":{"vie":["Chi phí thấp nhất không giới hạn","Chi phí thấp nhất có giới hạn giá thầu","Giới hạn chi phí","Chi phí thấp nhất với ROAS tối thiểu"]}},"billing_event":{"type":"string","description":"Billing event","x-description-i18n":{"vie":"Sự kiện thanh toán"},"enum":["APP_INSTALLS","IMPRESSIONS","LINK_CLICKS","OFFER_CLAIMS","PAGE_LIKES","POST_ENGAGEMENT","VIDEO_VIEWS","THRUPLAY","PURCHASE","LISTING_INTERACTION"],"x-enum-descriptions":["App installs","Impressions","Link clicks","Offer claims","Page likes","Post engagement","Video views","ThruPlay","Purchase","Listing interaction"],"x-enum-descriptions-i18n":{"vie":["Lượt cài đặt ứng dụng","Quảng cáo được hiển thị","Lượt nhấp vào liên kết","Lượt nhận ưu đãi","Thích trang","Tương tác với bài viết","Xem video","ThruPlay","Thanh toán","Tương tác với danh sách sản phẩm"]}},"daily_budget":{"type":"integer","description":"Daily budget","x-description-i18n":{"vie":"Ngân sách hàng ngày"}},"lifetime_budget":{"type":"integer","description":"Lifetime budget","x-description-i18n":{"vie":"Ngân sách trọn đời"}},"destination_type":{"type":"string","description":"Destination type","x-description-i18n":{"vie":"Điểm đến"},"enum":["WEBSITE","APP","MESSENGER","APPLINKS_AUTOMATIC","WHATSAPP","INSTAGRAM_DIRECT","FACEBOOK","MESSAGING_MESSENGER_WHATSAPP","MESSAGING_INSTAGRAM_DIRECT_MESSENGER","MESSAGING_INSTAGRAM_DIRECT_MESSENGER_WHATSAPP","MESSAGING_INSTAGRAM_DIRECT_WHATSAPP","SHOP_AUTOMATIC","ON_AD","ON_POST","ON_EVENT","ON_VIDEO","ON_PAGE","INSTAGRAM_PROFILE","FACEBOOK_PAGE","INSTAGRAM_PROFILE_AND_FACEBOOK_PAGE","INSTAGRAM_LIVE"],"x-enum-descriptions":["Website","App","Messenger","App links automatic","WhatsApp","Instagram Direct","Facebook","Messenger & WhatsApp","Instagram & Messenger","Instagram Direct & Messenger & WhatsApp","Instagram Direct & WhatsApp","Shop automatic","On ad","On post","On event","On video","On page","Instagram profile","Facebook page","Instagram profile and Facebook page","Instagram Live"],"x-enum-descriptions-i18n":{"vie":["Trang web","Ứng dụng","Messenger","Liên kết ứng dụng","WhatsApp","Instagram Direct","Facebook","Messenger & WhatsApp","Instagram & Messenger","Instagram Direct & Messenger & WhatsApp","Instagram Direct & WhatsApp","Cửa hàng tự động","Trên quảng cáo","Trên bài viết","Trên sự kiện","Trên video","Trên trang","Trên trang Instagram","Trên trang Facebook","Trên trang Instagram & Facebook","Trên Instagram Live"]}},"optimization_goal":{"type":"string","description":"Optimization goal","x-description-i18n":{"vie":"Mục tiêu tối ưu hoá"},"enum":["NONE","APP_INSTALLS","AD_RECALL_LIFT","ENGAGED_USERS","EVENT_RESPONSES","IMPRESSIONS","LEAD_GENERATION","QUALITY_LEAD","LINK_CLICKS","OFFSITE_CONVERSIONS","PAGE_LIKES","POST_ENGAGEMENT","QUALITY_CALL","REACH","LANDING_PAGE_VIEWS","VISIT_INSTAGRAM_PROFILE","VALUE","THRUPLAY","DERIVED_EVENTS","APP_INSTALLS_AND_OFFSITE_CONVERSIONS","CONVERSATIONS","IN_APP_VALUE","MESSAGING_PURCHASE_CONVERSION","SUBSCRIBERS","REMINDERS_SET","MEANINGFUL_CALL_ATTEMPT","PROFILE_VISIT","PROFILE_AND_PAGE_ENGAGEMENT","ADVERTISER_SILOED_VALUE","AUTOMATIC_OBJECTIVE","MESSAGING_APPOINTMENT_CONVERSION"],"x-enum-descriptions":["None","App installs","Ad recall lift","Engaged users","Event responses","Impressions","Lead generation","Quality lead","Link clicks","Offsite conversions","Page likes","Post engagement","Quality call","Reach","Landing page views","Visit Instagram profile","Value","ThruPlay","Derived events","App installs and offsite conversions","Conversations","In-app value","Messaging purchase conversion","Subscribers","Reminders set","Meaningful call attempt","Profile visit","Profile and page engagement","Advertiser siloed value","Automatic objective","Messaging appointment conversion"],"x-enum-descriptions-i18n":{"vie":["Không","Lượt cài đặt ứng dụng","Lift gọi lại","Người dùng tương tác","Lượt phản hồi sự kiện","Quảng cáo được hiển thị","Tạo khách hàng tiềm năng","Khách hàng tiềm năng chất lượng","Lượt nhấp vào liên kết","Chuyển đổi ngoài","Thích trang","Tương tác với bài viết","Cuộc gọi chất lượng","Phạm vi tiếp cận","Lượt xem trang đích","Truy cập trang Instagram","Giá trị","Quảng cáo được phát đến khi hoàn thành","Sự kiện phát sinh","Cài đặt ứng dụng và chuyển đổi ngoài trang","Cuộc trò chuyện","Giá trị trong ứng dụng","Chuyển đổi mua hàng qua tin nhắn","Người đăng ký","Đặt lời nhắc","Cố gắng gọi có ý nghĩa","Truy cập hồ sơ","Tương tác hồ sơ và trang","Giá trị riêng biệt nhà quảng cáo","Mục tiêu tự động","Chuyển đổi cuộc hẹn qua tin nhắn"]}},"marketer_id":{"type":"string","nullable":true,"description":"Marketer ID assigned","x-description-i18n":{"vie":"Mã marketer phụ trách"}},"product_id":{"type":"string","nullable":true,"description":"ID of product","x-description-i18n":{"vie":"Mã sản phẩm liên kết"}},"product_category_id":{"type":"string","nullable":true,"description":"ID of product category","x-description-i18n":{"vie":"Mã danh mục sản phẩm"}},"ad_account":{"type":"object","description":"Ad account","x-description-i18n":{"vie":"Tài khoản quảng cáo"},"properties":{"id":{"type":"string","description":"Ad account ID","x-description-i18n":{"vie":"Mã tài khoản quảng cáo"}},"name":{"type":"string","description":"Ad account name","x-description-i18n":{"vie":"Tên tài khoản quảng cáo"}},"currency":{"type":"string","description":"Currency used by the account","x-description-i18n":{"vie":"Đơn vị tiền tệ"}}}},"ad_campaign":{"type":"object","description":"Campaign of ad set","x-description-i18n":{"vie":"Chiến dịch quảng cáo"},"properties":{"id":{"type":"string","description":"Campaign ID","x-description-i18n":{"vie":"Mã chiến dịch"}},"name":{"type":"string","description":"Campaign name","x-description-i18n":{"vie":"Tên chiến dịch"}}}},"insights":{"type":"object","description":"Ad set performance metrics","x-description-i18n":{"vie":"Chỉ số hiệu suất nhóm quảng cáo"},"properties":{"ad_ids":{"type":"array","description":"List of ad IDs in this campaign","x-description-i18n":{"vie":"Danh sách mã quảng cáo trong chiến dịch"},"items":{"type":"string"}},"impressions":{"type":"number","description":"Number of ad impressions","x-description-i18n":{"vie":"Lượt hiển thị"}},"clicks":{"type":"integer","description":"Number of clicks (all)","x-description-i18n":{"vie":"Số lần nhấp (tất cả)"}},"reach":{"type":"integer","description":"Number of people reached via Instant Experience","x-description-i18n":{"vie":"Số người tiếp cận Trải nghiệm tức thì"}},"spend":{"type":"number","description":"Total amount spent","x-description-i18n":{"vie":"Số tiền đã chi tiêu"}},"cpc":{"type":"number","description":"CPC","x-description-i18n":{"vie":"CPC"}},"cpm":{"type":"number","description":"CPM","x-description-i18n":{"vie":"CPM"}},"cpp":{"type":"number","description":"CPP","x-description-i18n":{"vie":"CPP"}},"ctr":{"type":"number","description":"CTR","x-description-i18n":{"vie":"CTR"}},"frequency":{"type":"number","description":"Average frequency of ad views per person","x-description-i18n":{"vie":"Tần suất"}},"ad_performance_session":{"type":"integer","description":"Overall performance metric","x-description-i18n":{"vie":"Hiệu quả"}},"cost_per_1000_accounts_center_reach":{"type":"number","description":"Cost per 1000 accounts center reach","x-description-i18n":{"vie":"Chi phí trên mỗi 1000 tài khoản tiếp cận"}},"cost_per_result":{"type":"number","description":"Cost per result","x-description-i18n":{"vie":"Chi phí trên mỗi kết quả"}},"avg_purchase_conversion_value":{"type":"number","description":"Average purchase conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi trung bình của lượt mua"}},"indicator_result":{"type":"number","description":"Result indicator value","x-description-i18n":{"vie":"Kết quả"}},"result_roas":{"type":"number","description":"Return on ad spend (ROAS)","x-description-i18n":{"vie":"Kết quả ROAS"}},"ad_engagement_session":{"type":"integer","description":"Overall engagement metric","x-description-i18n":{"vie":"Tương tác"}},"link_click":{"type":"integer","description":"Link clicks","x-description-i18n":{"vie":"Lượt click vào liên kết"}},"like":{"type":"integer","description":"Facebook likes","x-description-i18n":{"vie":"Lượt thích trên Facebook"}},"comment":{"type":"integer","description":"Post comments","x-description-i18n":{"vie":"Bình luận về bài viết"}},"post_engagement":{"type":"integer","description":"Post engagements","x-description-i18n":{"vie":"Lượt tương tác với bài viết"}},"post_reaction":{"type":"integer","description":"Post reactions","x-description-i18n":{"vie":"Cảm xúc về bài viết"}},"post":{"type":"integer","description":"Post shares","x-description-i18n":{"vie":"Lượt chia sẻ bài viết"}},"onsite_conversion_post_save":{"type":"integer","description":"Post saves","x-description-i18n":{"vie":"Lượt lưu bài viết"}},"photo_view":{"type":"integer","description":"Photo views","x-description-i18n":{"vie":"Lượt xem ảnh"}},"video_view":{"type":"integer","description":"Video plays (at least 3 seconds)","x-description-i18n":{"vie":"Lượt phát video trong tối thiểu 3 giây"}},"inline_link_click_ctr":{"type":"number","description":"CTR (link click-through rate, %)","x-description-i18n":{"vie":"CTR (Tỷ lệ nhấp vào liên kết)"}},"outbound_click":{"type":"integer","description":"Outbound clicks","x-description-i18n":{"vie":"Lượt click ra ngoài"}},"onsite_conversion_messaging_conversation_started_7d":{"type":"integer","description":"Messaging conversations started (7-day window)","x-description-i18n":{"vie":"Lượt bắt đầu cuộc trò chuyện qua tin nhắn"}},"onsite_conversion_messaging_first_reply":{"type":"integer","description":"New messaging contacts","x-description-i18n":{"vie":"Người liên hệ nhắn tin mới"}},"onsite_conversion_messaging_block":{"type":"integer","description":"Messaging blocks","x-description-i18n":{"vie":"Lượt chặn"}},"video_thruplay_watched_actions":{"type":"integer","description":"ThruPlays","x-description-i18n":{"vie":"ThruPlays"}},"video_play_actions":{"type":"integer","description":"Video plays","x-description-i18n":{"vie":"Lượt phát video"}},"video_p25_watched_actions":{"type":"integer","description":"Video plays at 25% completion","x-description-i18n":{"vie":"Lượt phát 25% thời lượng video"}},"video_p50_watched_actions":{"type":"integer","description":"Video plays at 50% completion","x-description-i18n":{"vie":"Lượt phát 50% thời lượng video"}},"video_p75_watched_actions":{"type":"integer","description":"Video plays at 75% completion","x-description-i18n":{"vie":"Lượt phát 75% thời lượng video"}},"video_p95_watched_actions":{"type":"integer","description":"Video plays at 95% completion","x-description-i18n":{"vie":"Lượt phát 95% thời lượng video"}},"video_p100_watched_actions":{"type":"integer","description":"Video plays at 100% completion","x-description-i18n":{"vie":"Lượt phát 100% thời lượng video"}},"estimated_ad_recallers":{"type":"number","description":"Estimated ad recall lift (people)","x-description-i18n":{"vie":"Độ cải thiện khả năng nhớ đến quảng cáo theo ước tính (Người)"}},"cost_per_outbound_click":{"type":"number","description":"Cost per outbound click","x-description-i18n":{"vie":"Chi phí trên mỗi lượt click ra ngoài"}},"cost_per_thruplay":{"type":"number","description":"Cost per ThruPlay","x-description-i18n":{"vie":"Chi phí trên mỗi lượt ThruPlay"}},"outbound_clicks_ctr":{"type":"number","description":"Outbound click-through rate (%)","x-description-i18n":{"vie":"CTR ra ngoài (Tỷ lệ nhấp)"}},"cost_per_post_engagement":{"type":"number","description":"Cost per post engagement","x-description-i18n":{"vie":"Chi phí trên mỗi lượt tương tác với bài viết"}},"estimated_ad_recall_rate":{"type":"number","description":"Estimated ad recall lift rate (%)","x-description-i18n":{"vie":"Tỷ lệ độ cải thiện khả năng nhớ đến quảng cáo theo ước tính"}},"cost_per_estimated_ad_recallers":{"type":"number","description":"Cost per estimated ad recall lift (people)","x-description-i18n":{"vie":"Chi phí trên độ cải thiện khả năng nhớ đến quảng cáo theo ước tính (Người)"}},"cost_per_messaging_conversation_started":{"type":"number","description":"Cost per messaging conversation started","x-description-i18n":{"vie":"Chi phí trên mỗi lượt bắt đầu cuộc trò chuyện qua tin nhắn"}},"lead":{"type":"number","description":"Leads","x-description-i18n":{"vie":"Khách hàng tiềm năng"}},"website_lead":{"type":"number","description":"Website leads","x-description-i18n":{"vie":"Số khách hàng tiềm năng trên trang web"}},"offline_lead":{"type":"number","description":"Offline leads","x-description-i18n":{"vie":"Số khách hàng tiềm năng offline"}},"meta_lead":{"type":"number","description":"Meta leads","x-description-i18n":{"vie":"Khách hàng tiềm năng trên Meta"}},"lead_conversion_value":{"type":"number","description":"Lead conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi khách hàng tiềm năng"}},"website_lead_conversion_value":{"type":"number","description":"Website lead conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi khách hàng tiềm năng trên trang web"}},"offline_lead_conversion_value":{"type":"number","description":"Offline lead conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi khách hàng tiềm năng offline"}},"meta_lead_conversion_value":{"type":"number","description":"Meta lead conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi khách hàng tiềm năng của Meta"}},"cost_per_lead":{"type":"number","description":"Cost per lead","x-description-i18n":{"vie":"Chi phí trên mỗi khách hàng tiềm năng"}},"omni_purchase":{"type":"number","description":"Purchases","x-description-i18n":{"vie":"Lượt mua"}},"inapp_omni_purchase":{"type":"number","description":"In-app purchases","x-description-i18n":{"vie":"Lượt khách hàng trong ứng dụng"}},"website_omni_purchase":{"type":"number","description":"Website purchases","x-description-i18n":{"vie":"Lượt mua trên web"}},"offline_omni_purchase":{"type":"number","description":"Offline purchases","x-description-i18n":{"vie":"Lượt mua hàng offline"}},"meta_omni_purchase":{"type":"number","description":"Meta purchases","x-description-i18n":{"vie":"Lượt mua trên Meta"}},"omni_purchase_conversion_value":{"type":"number","description":"Purchase conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt mua"}},"inapp_omni_purchase_conversion_value":{"type":"number","description":"In-app purchase conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi của lượt mua hàng trong ứng dụng"}},"website_omni_purchase_conversion_value":{"type":"number","description":"Website purchase conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi của lượt mua trên web"}},"offline_omni_purchase_conversion_value":{"type":"number","description":"Offline purchase conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt mua hàng offline"}},"meta_omni_purchase_conversion_value":{"type":"number","description":"Meta purchase conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi của lượt mua trên Meta"}},"cost_per_omni_purchase":{"type":"number","description":"Cost per purchase","x-description-i18n":{"vie":"Chi phí trên mỗi lượt mua"}},"omni_initiated_checkout":{"type":"number","description":"Checkout initiated","x-description-i18n":{"vie":"Lượt bắt đầu thanh toán"}},"inapp_omni_initiated_checkout":{"type":"number","description":"In-app checkout initiated","x-description-i18n":{"vie":"Lượt bắt đầu thanh toán trên ứng dụng di động"}},"website_omni_initiated_checkout":{"type":"number","description":"Website checkout initiated","x-description-i18n":{"vie":"Lượt bắt đầu thanh toán trên web"}},"offline_omni_initiated_checkout":{"type":"number","description":"Offline checkout initiated","x-description-i18n":{"vie":"Lượt bắt đầu thanh toán offline"}},"meta_omni_initiated_checkout":{"type":"number","description":"Meta checkout initiated","x-description-i18n":{"vie":"Lượt bắt đầu thanh toán trên Meta"}},"omni_initiated_checkout_conversion_value":{"type":"number","description":"Checkout initiated conversion value","x-description-i18n":{"vie":"Giá trị của chuyển đổi bắt đầu thanh toán"}},"inapp_omni_initiated_checkout_conversion_value":{"type":"number","description":"In-app checkout initiated conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt bắt đầu thanh toán trong ứng dụng"}},"website_omni_initiated_checkout_conversion_value":{"type":"number","description":"Website checkout initiated conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi của số lượt bắt đầu thanh toán trên trang web"}},"offline_omni_initiated_checkout_conversion_value":{"type":"number","description":"Offline checkout initiated conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi offline từ sự kiện bắt đầu thanh toán"}},"meta_omni_initiated_checkout_conversion_value":{"type":"number","description":"Meta checkout initiated conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt bắt đầu thanh toán trên Meta"}},"cost_per_omni_initiated_checkout":{"type":"number","description":"Cost per checkout initiated","x-description-i18n":{"vie":"Chi phí trên mỗi lượt bắt đầu thanh toán"}},"omni_complete_registration":{"type":"number","description":"Registrations completed","x-description-i18n":{"vie":"Lượt hoàn tất đăng ký"}},"inapp_omni_complete_registration":{"type":"number","description":"In-app registrations completed","x-description-i18n":{"vie":"Lượt hoàn tất đăng ký trên ứng dụng di động"}},"website_omni_complete_registration":{"type":"number","description":"Website registrations completed","x-description-i18n":{"vie":"Lượt hoàn tất đăng ký trên trang web"}},"offline_omni_complete_registration":{"type":"number","description":"Offline registrations completed","x-description-i18n":{"vie":"Lượt hoàn tất đăng ký offline"}},"omni_complete_registration_conversion_value":{"type":"number","description":"Registration completed conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt hoàn tất đăng ký"}},"inapp_omni_complete_registration_conversion_value":{"type":"number","description":"In-app registration completed conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt hoàn tất đăng ký trong ứng dụng"}},"website_omni_complete_registration_conversion_value":{"type":"number","description":"Website registration completed conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt hoàn tất đăng ký trên trang web"}},"offline_omni_complete_registration_conversion_value":{"type":"number","description":"Offline registration completed conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt hoàn tất đăng ký offline"}},"cost_per_omni_complete_registration":{"type":"number","description":"Cost per registration completed","x-description-i18n":{"vie":"Chi phí trên mỗi lượt hoàn tất đăng ký"}},"omni_view_content":{"type":"number","description":"Content views","x-description-i18n":{"vie":"Lượt xem nội dung"}},"inapp_omni_view_content":{"type":"number","description":"In-app content views","x-description-i18n":{"vie":"Lượt xem nội dung trong ứng dụng"}},"website_omni_view_content":{"type":"number","description":"Website content views","x-description-i18n":{"vie":"Lượt xem nội dung trên trang web"}},"offline_omni_view_content":{"type":"number","description":"Offline content views","x-description-i18n":{"vie":"Lượt xem nội dung offline"}},"meta_omni_view_content":{"type":"number","description":"Meta content views","x-description-i18n":{"vie":"Lượt xem nội dung trên Meta"}},"omni_view_content_conversion_value":{"type":"number","description":"Content view conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt xem nội dung"}},"inapp_omni_view_content_conversion_value":{"type":"number","description":"In-app content view conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt xem nội dung trong ứng dụng"}},"website_omni_view_content_conversion_value":{"type":"number","description":"Website content view conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt xem nội dung trên trang web"}},"offline_omni_view_content_conversion_value":{"type":"number","description":"Offline content view conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi offline từ sự kiện xem nội dung"}},"meta_omni_view_content_conversion_value":{"type":"number","description":"Meta content view conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt xem nội dung trên Meta"}},"cost_per_omni_view_content":{"type":"number","description":"Cost per content view","x-description-i18n":{"vie":"Chi phí trên mỗi lượt xem nội dung"}},"omni_search":{"type":"number","description":"Searches","x-description-i18n":{"vie":"Tìm kiếm"}},"inapp_omni_search":{"type":"number","description":"In-app searches","x-description-i18n":{"vie":"Lượt tìm kiếm trong ứng dụng"}},"website_omni_search":{"type":"number","description":"Website searches","x-description-i18n":{"vie":"Lượt tìm kiếm trên trang web"}},"offline_omni_search":{"type":"number","description":"Offline searches","x-description-i18n":{"vie":"Lượt tìm kiếm offline"}},"omni_search_conversion_value":{"type":"number","description":"Search conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi của tìm kiếm"}},"inapp_omni_search_conversion_value":{"type":"number","description":"In-app search conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi tìm kiếm ứng dụng di động"}},"website_omni_search_conversion_value":{"type":"number","description":"Website search conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi của tìm kiếm trên trang web"}},"offline_omni_search_conversion_value":{"type":"number","description":"Offline search conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt tìm kiếm offline"}},"cost_per_omni_search":{"type":"number","description":"Cost per search","x-description-i18n":{"vie":"Chi phí trên mỗi lượt tìm kiếm"}},"omni_add_to_cart":{"type":"number","description":"Add to cart","x-description-i18n":{"vie":"Lượt thêm vào giỏ hàng"}},"inapp_omni_add_to_cart":{"type":"number","description":"In-app add to cart","x-description-i18n":{"vie":"Lượt thêm vào giỏ hàng trong ứng dụng"}},"website_omni_add_to_cart":{"type":"number","description":"Website add to cart","x-description-i18n":{"vie":"Lượt thêm vào giỏ hàng trên trang web"}},"offline_omni_add_to_cart":{"type":"number","description":"Offline add to cart","x-description-i18n":{"vie":"Lượt thêm vào giỏ hàng offline"}},"meta_omni_add_to_cart":{"type":"number","description":"Meta add to cart","x-description-i18n":{"vie":"Lượt thêm vào giỏ hàng trên Meta"}},"omni_add_to_cart_conversion_value":{"type":"number","description":"Add to cart conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt thêm vào giỏ hàng"}},"inapp_omni_add_to_cart_conversion_value":{"type":"number","description":"In-app add to cart conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt thêm ứng dụng vào giỏ hàng"}},"website_omni_add_to_cart_conversion_value":{"type":"number","description":"Website add to cart conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt thêm vào giỏ hàng trên trang web"}},"offline_omni_add_to_cart_conversion_value":{"type":"number","description":"Offline add to cart conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi offline từ các lượt thêm vào giỏ hàng"}},"meta_omni_add_to_cart_conversion_value":{"type":"number","description":"Meta add to cart conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt thêm vào giỏ hàng trên Meta"}},"cost_per_omni_add_to_cart":{"type":"number","description":"Cost per add to cart","x-description-i18n":{"vie":"Chi phí trên mỗi lượt thêm vào giỏ hàng"}},"omni_add_to_wishlist":{"type":"number","description":"Add to wishlist","x-description-i18n":{"vie":"Thêm vào danh sách mong ước"}},"inapp_omni_add_to_wishlist":{"type":"number","description":"In-app add to wishlist","x-description-i18n":{"vie":"Thêm vào danh sách mong ước trong ứng dụng di động"}},"website_omni_add_to_wishlist":{"type":"number","description":"Website add to wishlist","x-description-i18n":{"vie":"Thêm vào danh sách mong ước trên trang web"}},"offline_omni_add_to_wishlist":{"type":"number","description":"Offline add to wishlist","x-description-i18n":{"vie":"Thêm vào danh sách mong ước offline"}},"meta_omni_add_to_wishlist":{"type":"number","description":"Meta add to wishlist","x-description-i18n":{"vie":"Thêm vào danh sách mong ước trên Meta"}},"omni_add_to_wishlist_conversion_value":{"type":"number","description":"Add to wishlist conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt thêm vào danh sách mong ước"}},"inapp_omni_add_to_wishlist_conversion_value":{"type":"number","description":"In-app add to wishlist conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt thêm vào danh sách mong ước trong ứng dụng"}},"website_omni_add_to_wishlist_conversion_value":{"type":"number","description":"Website add to wishlist conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt thêm vào danh sách mong ước trên trang web"}},"offline_omni_add_to_wishlist_conversion_value":{"type":"number","description":"Offline add to wishlist conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi offline từ lượt thêm vào danh sách mong ước"}},"meta_omni_add_to_wishlist_conversion_value":{"type":"number","description":"Meta add to wishlist conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt thêm vào danh sách mong ước trên Meta"}},"cost_per_omni_add_to_wishlist":{"type":"number","description":"Cost per add to wishlist","x-description-i18n":{"vie":"Chi phí trên mỗi lượt thêm vào danh sách mong ước"}},"customize_product_total":{"type":"number","description":"Product customizations","x-description-i18n":{"vie":"Lượt tuỳ chỉnh sản phẩm"}},"inapp_customize_product_total":{"type":"number","description":"In-app product customizations","x-description-i18n":{"vie":"Lượt tuỳ chỉnh sản phẩm trong ứng dụng di động"}},"website_customize_product_total":{"type":"number","description":"Website product customizations","x-description-i18n":{"vie":"Lượt tuỳ chỉnh sản phẩm trên trang web"}},"offline_customize_product_total":{"type":"number","description":"Offline product customizations","x-description-i18n":{"vie":"Lượt tuỳ chỉnh sản phẩm offline"}},"customize_product_total_conversion_value":{"type":"number","description":"Product customization conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt tuỳ chỉnh sản phẩm"}},"inapp_customize_product_total_conversion_value":{"type":"number","description":"In-app product customization conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt tuỳ chỉnh sản phẩm trong ứng dụng"}},"website_customize_product_total_conversion_value":{"type":"number","description":"Website product customization conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt tuỳ chỉnh sản phẩm trên trang web"}},"offline_customize_product_total_conversion_value":{"type":"number","description":"Offline product customization conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt tuỳ chỉnh sản phẩm offline"}},"cost_per_customize_product_total":{"type":"number","description":"Cost per product customization","x-description-i18n":{"vie":"Chi phí trên mỗi lượt tuỳ chỉnh sản phẩm"}},"start_trial_total":{"type":"number","description":"Trials started","x-description-i18n":{"vie":"Lượt bắt đầu dùng thử"}},"inapp_start_trial_total":{"type":"number","description":"In-app trials started","x-description-i18n":{"vie":"Lượt bắt đầu dùng thử trong ứng dụng di động"}},"website_start_trial_total":{"type":"number","description":"Website trials started","x-description-i18n":{"vie":"Lượt bắt đầu dùng thử trên trang web"}},"offline_start_trial_total":{"type":"number","description":"Offline trials started","x-description-i18n":{"vie":"Lượt bắt đầu dùng thử offline"}},"start_trial_total_conversion_value":{"type":"number","description":"Trial started conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt bắt đầu dùng thử"}},"inapp_start_trial_total_conversion_value":{"type":"number","description":"In-app trial started conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt bắt đầu dùng thử trong ứng dụng"}},"website_start_trial_total_conversion_value":{"type":"number","description":"Website trial started conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt bắt đầu dùng thử trên trang web"}},"offline_start_trial_total_conversion_value":{"type":"number","description":"Offline trial started conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt bắt đầu dùng thử offline"}},"cost_per_start_trial_total":{"type":"number","description":"Cost per trial started","x-description-i18n":{"vie":"Chi phí trên mỗi lượt bắt đầu dùng thử"}},"subscribe_total":{"type":"number","description":"Subscriptions","x-description-i18n":{"vie":"Lượt đăng ký"}},"inapp_subscribe_total":{"type":"number","description":"In-app subscriptions","x-description-i18n":{"vie":"Lượt đăng ký trong ứng dụng di động"}},"website_subscribe_total":{"type":"number","description":"Website subscriptions","x-description-i18n":{"vie":"Lượt đăng ký trên trang web"}},"offline_subscribe_total":{"type":"number","description":"Offline subscriptions","x-description-i18n":{"vie":"Lượt đăng ký offline"}},"subscribe_total_conversion_value":{"type":"number","description":"Subscription conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt đăng ký"}},"inapp_subscribe_total_conversion_value":{"type":"number","description":"In-app subscription conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt đăng ký trong ứng dụng"}},"website_subscribe_total_conversion_value":{"type":"number","description":"Website subscription conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt đăng ký trên trang web"}},"offline_subscribe_total_conversion_value":{"type":"number","description":"Offline subscription conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt đăng ký offline"}},"cost_per_subscribe_total":{"type":"number","description":"Cost per subscription","x-description-i18n":{"vie":"Chi phí trên mỗi lượt đăng ký"}},"submit_application_total":{"type":"number","description":"Applications submitted","x-description-i18n":{"vie":"Lượt gửi đơn"}},"inapp_submit_application_total":{"type":"number","description":"In-app applications submitted","x-description-i18n":{"vie":"Lượt gửi đơn trong ứng dụng di động"}},"website_submit_application_total":{"type":"number","description":"Website applications submitted","x-description-i18n":{"vie":"Lượt gửi đơn trên trang web"}},"offline_submit_application_total":{"type":"number","description":"Offline applications submitted","x-description-i18n":{"vie":"Lượt gửi đơn offline"}},"meta_submit_application_total":{"type":"number","description":"Meta applications submitted","x-description-i18n":{"vie":"Lượt gửi đơn đăng ký trên Meta"}},"submit_application_total_conversion_value":{"type":"number","description":"Application submitted conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt gửi đơn"}},"inapp_submit_application_total_conversion_value":{"type":"number","description":"In-app application submitted conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt gửi đơn đăng ký trong ứng dụng"}},"website_submit_application_total_conversion_value":{"type":"number","description":"Website application submitted conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt gửi đơn đăng ký trên trang web"}},"offline_submit_application_total_conversion_value":{"type":"number","description":"Offline application submitted conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt gửi đơn đăng ký offline"}},"meta_submit_application_total_conversion_value":{"type":"number","description":"Meta application submitted conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt gửi đơn đăng ký trên Meta"}},"cost_per_submit_application_total":{"type":"number","description":"Cost per application submitted","x-description-i18n":{"vie":"Chi phí trên mỗi lượt gửi đơn"}},"contact_total":{"type":"number","description":"Contacts","x-description-i18n":{"vie":"Người liên hệ"}},"inapp_contact_total":{"type":"number","description":"In-app contacts","x-description-i18n":{"vie":"Người liên hệ trong ứng dụng di động"}},"website_contact_total":{"type":"number","description":"Website contacts","x-description-i18n":{"vie":"Người liên hệ trên trang web"}},"offline_contact_total":{"type":"number","description":"Offline contacts","x-description-i18n":{"vie":"Người liên hệ offline"}},"contact_total_conversion_value":{"type":"number","description":"Contact conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ người liên hệ"}},"inapp_contact_total_conversion_value":{"type":"number","description":"In-app contact conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ người liên hệ trong ứng dụng"}},"website_contact_total_conversion_value":{"type":"number","description":"Website contact conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ người liên hệ trên trang web"}},"offline_contact_total_conversion_value":{"type":"number","description":"Offline contact conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ người liên hệ offline"}},"cost_per_contact_total":{"type":"number","description":"Cost per contact","x-description-i18n":{"vie":"Chi phí trên mỗi lượt liên hệ"}},"landing_page_view":{"type":"number","description":"Landing page views","x-description-i18n":{"vie":"Số lượt xem trang đích"}},"inapp_landing_page_view":{"type":"number","description":"In-app landing page views","x-description-i18n":{"vie":"Lượt xem trang đích trong ứng dụng"}},"website_landing_page_view":{"type":"number","description":"Website landing page views","x-description-i18n":{"vie":"Lượt xem trang đích trên trang web"}},"cost_per_landing_page_view":{"type":"number","description":"Cost per landing page view","x-description-i18n":{"vie":"Chi phí trên mỗi lượt xem trang đích"}},"order_created":{"type":"number","description":"Orders created","x-description-i18n":{"vie":"Đơn đặt hàng đã tạo"}},"order_shipped":{"type":"number","description":"Orders shipped","x-description-i18n":{"vie":"Đơn đặt hàng đã vận chuyển"}},"purchase_roas":{"type":"number","description":"Purchase ROAS","x-description-i18n":{"vie":"ROAS (Lợi nhuận trên chi tiêu quảng cáo) của lượt mua"}},"inapp_purchase_roas":{"type":"number","description":"In-app purchase ROAS","x-description-i18n":{"vie":"ROAS (Lợi nhuận trên chi tiêu quảng cáo) của lượt mua trong ứng dụng"}},"website_purchase_roas":{"type":"number","description":"Website purchase ROAS","x-description-i18n":{"vie":"ROAS (Lợi nhuận trên chi tiêu quảng cáo) của lượt mua trên trang web"}},"order_statistics":{"type":"array","description":"Order count grouped by day offset from campaign start","x-description-i18n":{"vie":"Thống kê đơn hàng theo ngày kể từ khi chiến dịch bắt đầu"},"items":{"type":"object","properties":{"id":{"type":"integer","description":"Day offset","x-description-i18n":{"vie":"Ngày thứ (tính từ ngày bắt đầu)"}},"order_count":{"type":"integer","description":"Number of orders on that day","x-description-i18n":{"vie":"Số đơn hàng trong ngày đó"}}}}}}},"targeting":{"type":"object","description":"Audience targeting settings","x-description-i18n":{"vie":"Nhắm đối tượng"},"properties":{"age_min":{"type":"integer","description":"Minimum age","x-description-i18n":{"vie":"Độ tuổi tối thiểu"}},"age_max":{"type":"integer","description":"Maximum age","x-description-i18n":{"vie":"Độ tuổi tối đa"}},"age_range":{"type":"array","description":"Age range [min, max]","x-description-i18n":{"vie":"Khoảng độ tuổi [min, max]"},"items":{"type":"integer"}},"genders":{"type":"array","description":"Gender targeting: 1 = male, 2 = female","x-description-i18n":{"vie":"Giới tính: 1 = nam, 2 = nữ"},"items":{"type":"integer"}},"device_platforms":{"type":"array","description":"Device platforms targeted","x-description-i18n":{"vie":"Nền tảng thiết bị nhắm mục tiêu"},"items":{"type":"string"}},"publisher_platforms":{"type":"array","description":"Publisher platforms targeted","x-description-i18n":{"vie":"Nền tảng nhà xuất bản nhắm mục tiêu"},"items":{"type":"string"}},"facebook_positions":{"type":"array","description":"Facebook ad placements","x-description-i18n":{"vie":"Vị trí hiển thị quảng cáo trên Facebook"},"items":{"type":"string"}},"locales":{"type":"array","description":"Language locale IDs","x-description-i18n":{"vie":"Mã ngôn ngữ nhắm mục tiêu"},"items":{"type":"integer"}},"geo_locations":{"type":"object","description":"Geographic targeting","x-description-i18n":{"vie":"Nhắm mục tiêu theo vị trí địa lý"},"properties":{"countries":{"type":"array","description":"Country codes","x-description-i18n":{"vie":"Mã quốc gia"},"items":{"type":"string"}},"location_types":{"type":"array","description":"Location types (home, recent, travel_in)","x-description-i18n":{"vie":"Loại vị trí (nhà, gần đây, đang ghé thăm)"},"items":{"type":"string"}}}},"flexible_spec":{"type":"array","description":"Flexible audience targeting (interests, behaviors, life events)","x-description-i18n":{"vie":"Nhắm mục tiêu linh hoạt (sở thích, hành vi, sự kiện cuộc sống)"},"items":{"type":"object","properties":{"interests":{"type":"array","description":"Interest targeting","x-description-i18n":{"vie":"Nhắm mục tiêu theo sở thích"},"items":{"type":"object","properties":{"id":{"type":"string","description":"Interest ID","x-description-i18n":{"vie":"Mã sở thích"}},"name":{"type":"string","description":"Interest name","x-description-i18n":{"vie":"Tên sở thích"}}}}},"behaviors":{"type":"array","description":"Behavior targeting","x-description-i18n":{"vie":"Nhắm mục tiêu theo hành vi"},"items":{"type":"object","properties":{"id":{"type":"string","description":"Behavior ID","x-description-i18n":{"vie":"Mã hành vi"}},"name":{"type":"string","description":"Behavior name","x-description-i18n":{"vie":"Tên hành vi"}}}}},"life_events":{"type":"array","description":"Life event targeting","x-description-i18n":{"vie":"Nhắm mục tiêu theo sự kiện cuộc sống"},"items":{"type":"object","properties":{"id":{"type":"string","description":"Life event ID","x-description-i18n":{"vie":"Mã sự kiện cuộc sống"}},"name":{"type":"string","description":"Life event name","x-description-i18n":{"vie":"Tên sự kiện cuộc sống"}}}}},"relationship_statuses":{"type":"array","description":"Relationship status targeting","x-description-i18n":{"vie":"Nhắm mục tiêu theo tình trạng hôn nhân"},"items":{"type":"integer"}}}}},"targeting_automation":{"type":"object","description":"Advantage audience automation settings","x-description-i18n":{"vie":"Cài đặt tự động hoá đối tượng Advantage"},"properties":{"advantage_audience":{"type":"integer","description":"Advantage audience enabled: 1 = yes, 0 = no","x-description-i18n":{"vie":"Đối tượng Advantage: 1 = bật, 0 = tắt"}}}}}}}}},"summary":{"type":"object","description":"Aggregated performance metrics across all ad sets","x-description-i18n":{"vie":"Tổng hợp chỉ số hiệu suất của tất cả nhóm quảng cáo"},"properties":{"impressions":{"type":"number","description":"Total impressions","x-description-i18n":{"vie":"Tổng lượt hiển thị"}},"clicks":{"type":"integer","description":"Total clicks","x-description-i18n":{"vie":"Tổng số lần nhấp (tất cả)"}},"reach":{"type":"integer","description":"Total unique people reached","x-description-i18n":{"vie":"Tổng số người tiếp cận Trải nghiệm tức thì"}},"spend":{"type":"number","description":"Total amount spent","x-description-i18n":{"vie":"Tổng số tiền đã chi tiêu"}},"cpc":{"type":"number","description":"CPC","x-description-i18n":{"vie":"CPC"}},"cpm":{"type":"number","description":"CPM","x-description-i18n":{"vie":"CPM"}},"cpp":{"type":"number","description":"CPP","x-description-i18n":{"vie":"CPP"}},"ctr":{"type":"number","description":"CTR","x-description-i18n":{"vie":"CTR"}},"frequency":{"type":"number","description":"Average frequency","x-description-i18n":{"vie":"Tần suất trung bình"}}}},"page_number":{"type":"integer","description":"Current page number","x-description-i18n":{"vie":"Trang hiện tại"}},"page_size":{"type":"integer","description":"Number of records per page","x-description-i18n":{"vie":"Số bản ghi mỗi trang"}},"total_entries":{"type":"integer","description":"Total number of ad sets","x-description-i18n":{"vie":"Tổng số nhóm quảng cáo"}},"total_pages":{"type":"integer","description":"Total number of pages","x-description-i18n":{"vie":"Tổng số trang"}}}},"AdListResponse":{"type":"object","properties":{"success":{"type":"boolean","description":"Success status","x-description-i18n":{"vie":"Trạng thái thành công"}},"data":{"type":"array","description":"List of ads","x-description-i18n":{"vie":"Danh sách quảng cáo"},"items":{"type":"object","properties":{"id":{"type":"string","description":"Ad ID","x-description-i18n":{"vie":"Mã quảng cáo"}},"name":{"type":"string","description":"Ad name","x-description-i18n":{"vie":"Tên quảng cáo"}},"status":{"type":"string","description":"Ad status","x-description-i18n":{"vie":"Trạng thái quảng cáo"},"enum":["ACTIVE","PAUSED","DELETED","ARCHIVED"],"x-enum-descriptions":["Active","Paused","Deleted","Archived"],"x-enum-descriptions-i18n":{"vie":["Đang hoạt động","Tạm dừng","Đã xoá","Đã lưu trữ"]}},"effective_status":{"type":"string","description":"Effective status","x-description-i18n":{"vie":"Trạng thái hiệu quả"},"enum":["ACTIVE","PAUSED","DELETED","PENDING_REVIEW","DISAPPROVED","PREAPPROVED","PENDING_BILLING_INFO","CAMPAIGN_PAUSED","ARCHIVED","ADSET_PAUSED","IN_PROCESS","WITH_ISSUES"],"x-enum-descriptions":["Active","Paused","Deleted","Pending review","Disapproved","Preapproved","Pending billing info","Campaign paused","Archived","Ad set paused","In process","With issues"],"x-enum-descriptions-i18n":{"vie":["Đang hoạt động","Tạm dừng","Đã xoá","Đang chờ duyệt","Đã từ chối","Đã chấp nhận","Đang chờ thông tin thanh toán","Quảng cáo đã tạm dừng","Đã lưu trữ","Bộ lọc đã tạm dừng","Đang tiến hành","Có vấn đề"]}},"created_time":{"type":"string","format":"date-time","description":"Ad creation time","x-description-i18n":{"vie":"Thời điểm tạo quảng cáo"}},"marketer_id":{"type":"string","nullable":true,"description":"Marketer ID assigned","x-description-i18n":{"vie":"Mã marketer phụ trách"}},"product_id":{"type":"string","nullable":true,"description":"ID of product","x-description-i18n":{"vie":"Mã sản phẩm liên kết"}},"product_category_id":{"type":"string","nullable":true,"description":"ID of product category","x-description-i18n":{"vie":"Mã danh mục sản phẩm"}},"ad_account":{"type":"object","description":"Ad account","x-description-i18n":{"vie":"Tài khoản quảng cáo"},"properties":{"id":{"type":"string","description":"Ad account ID","x-description-i18n":{"vie":"Mã tài khoản"}},"name":{"type":"string","description":"Ad account name","x-description-i18n":{"vie":"Tên tài khoản"}},"currency":{"type":"string","description":"Currency used by the account","x-description-i18n":{"vie":"Đơn vị tiền tệ"}}}},"ad_campaign":{"type":"object","description":"Parent campaign of the ad","x-description-i18n":{"vie":"Chiến dịch quảng cáo"},"properties":{"id":{"type":"string","description":"Campaign ID","x-description-i18n":{"vie":"Mã chiến dịch"}},"name":{"type":"string","description":"Campaign name","x-description-i18n":{"vie":"Tên chiến dịch"}}}},"ad_set":{"type":"object","description":"Ad group","x-description-i18n":{"vie":"Nhóm quảng cáo"},"properties":{"id":{"type":"string","description":"Ad set ID","x-description-i18n":{"vie":"Mã nhóm quảng cáo"}},"name":{"type":"string","description":"Ad set name","x-description-i18n":{"vie":"Tên nhóm quảng cáo"}}}},"ad_creative":{"type":"object","description":"Facebook post (bài viết)","x-description-i18n":{"vie":"Bài viết Facebook"},"properties":{"id":{"type":"string","description":"Creative ID","x-description-i18n":{"vie":"Mã creative"}},"name":{"type":"string","description":"Post content","x-description-i18n":{"vie":"Nội dung bài viết"}},"object_story_id":{"type":"string","description":"Facebook post ID","x-description-i18n":{"vie":"Mã bài viết Facebook"}}}},"insights":{"type":"object","description":"Ad performance metrics","x-description-i18n":{"vie":"Chỉ số hiệu suất quảng cáo"},"properties":{"ad_ids":{"type":"array","description":"List of ad IDs in this campaign","x-description-i18n":{"vie":"Danh sách mã quảng cáo trong chiến dịch"},"items":{"type":"string"}},"impressions":{"type":"number","description":"Number of ad impressions","x-description-i18n":{"vie":"Lượt hiển thị"}},"clicks":{"type":"integer","description":"Number of clicks (all)","x-description-i18n":{"vie":"Số lần nhấp (tất cả)"}},"reach":{"type":"integer","description":"Number of people reached via Instant Experience","x-description-i18n":{"vie":"Số người tiếp cận Trải nghiệm tức thì"}},"spend":{"type":"number","description":"Total amount spent","x-description-i18n":{"vie":"Số tiền đã chi tiêu"}},"cpc":{"type":"number","description":"CPC","x-description-i18n":{"vie":"CPC"}},"cpm":{"type":"number","description":"CPM","x-description-i18n":{"vie":"CPM"}},"cpp":{"type":"number","description":"CPP","x-description-i18n":{"vie":"CPP"}},"ctr":{"type":"number","description":"CTR","x-description-i18n":{"vie":"CTR"}},"frequency":{"type":"number","description":"Average frequency of ad views per person","x-description-i18n":{"vie":"Tần suất"}},"ad_performance_session":{"type":"integer","description":"Overall performance metric","x-description-i18n":{"vie":"Hiệu quả"}},"cost_per_1000_accounts_center_reach":{"type":"number","description":"Cost per 1000 accounts center reach","x-description-i18n":{"vie":"Chi phí trên mỗi 1000 tài khoản tiếp cận"}},"cost_per_result":{"type":"number","description":"Cost per result","x-description-i18n":{"vie":"Chi phí trên mỗi kết quả"}},"avg_purchase_conversion_value":{"type":"number","description":"Average purchase conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi trung bình của lượt mua"}},"indicator_result":{"type":"number","description":"Result indicator value","x-description-i18n":{"vie":"Kết quả"}},"result_roas":{"type":"number","description":"Return on ad spend (ROAS)","x-description-i18n":{"vie":"Kết quả ROAS"}},"ad_engagement_session":{"type":"integer","description":"Overall engagement metric","x-description-i18n":{"vie":"Tương tác"}},"link_click":{"type":"integer","description":"Link clicks","x-description-i18n":{"vie":"Lượt click vào liên kết"}},"like":{"type":"integer","description":"Facebook likes","x-description-i18n":{"vie":"Lượt thích trên Facebook"}},"comment":{"type":"integer","description":"Post comments","x-description-i18n":{"vie":"Bình luận về bài viết"}},"post_engagement":{"type":"integer","description":"Post engagements","x-description-i18n":{"vie":"Lượt tương tác với bài viết"}},"post_reaction":{"type":"integer","description":"Post reactions","x-description-i18n":{"vie":"Cảm xúc về bài viết"}},"post":{"type":"integer","description":"Post shares","x-description-i18n":{"vie":"Lượt chia sẻ bài viết"}},"onsite_conversion_post_save":{"type":"integer","description":"Post saves","x-description-i18n":{"vie":"Lượt lưu bài viết"}},"photo_view":{"type":"integer","description":"Photo views","x-description-i18n":{"vie":"Lượt xem ảnh"}},"video_view":{"type":"integer","description":"Video plays (at least 3 seconds)","x-description-i18n":{"vie":"Lượt phát video trong tối thiểu 3 giây"}},"inline_link_click_ctr":{"type":"number","description":"CTR (link click-through rate, %)","x-description-i18n":{"vie":"CTR (Tỷ lệ nhấp vào liên kết)"}},"outbound_click":{"type":"integer","description":"Outbound clicks","x-description-i18n":{"vie":"Lượt click ra ngoài"}},"onsite_conversion_messaging_conversation_started_7d":{"type":"integer","description":"Messaging conversations started (7-day window)","x-description-i18n":{"vie":"Lượt bắt đầu cuộc trò chuyện qua tin nhắn"}},"onsite_conversion_messaging_first_reply":{"type":"integer","description":"New messaging contacts","x-description-i18n":{"vie":"Người liên hệ nhắn tin mới"}},"onsite_conversion_messaging_block":{"type":"integer","description":"Messaging blocks","x-description-i18n":{"vie":"Lượt chặn"}},"video_thruplay_watched_actions":{"type":"integer","description":"ThruPlays","x-description-i18n":{"vie":"ThruPlays"}},"video_play_actions":{"type":"integer","description":"Video plays","x-description-i18n":{"vie":"Lượt phát video"}},"video_p25_watched_actions":{"type":"integer","description":"Video plays at 25% completion","x-description-i18n":{"vie":"Lượt phát 25% thời lượng video"}},"video_p50_watched_actions":{"type":"integer","description":"Video plays at 50% completion","x-description-i18n":{"vie":"Lượt phát 50% thời lượng video"}},"video_p75_watched_actions":{"type":"integer","description":"Video plays at 75% completion","x-description-i18n":{"vie":"Lượt phát 75% thời lượng video"}},"video_p95_watched_actions":{"type":"integer","description":"Video plays at 95% completion","x-description-i18n":{"vie":"Lượt phát 95% thời lượng video"}},"video_p100_watched_actions":{"type":"integer","description":"Video plays at 100% completion","x-description-i18n":{"vie":"Lượt phát 100% thời lượng video"}},"estimated_ad_recallers":{"type":"number","description":"Estimated ad recall lift (people)","x-description-i18n":{"vie":"Độ cải thiện khả năng nhớ đến quảng cáo theo ước tính (Người)"}},"cost_per_outbound_click":{"type":"number","description":"Cost per outbound click","x-description-i18n":{"vie":"Chi phí trên mỗi lượt click ra ngoài"}},"cost_per_thruplay":{"type":"number","description":"Cost per ThruPlay","x-description-i18n":{"vie":"Chi phí trên mỗi lượt ThruPlay"}},"outbound_clicks_ctr":{"type":"number","description":"Outbound click-through rate (%)","x-description-i18n":{"vie":"CTR ra ngoài (Tỷ lệ nhấp)"}},"cost_per_post_engagement":{"type":"number","description":"Cost per post engagement","x-description-i18n":{"vie":"Chi phí trên mỗi lượt tương tác với bài viết"}},"estimated_ad_recall_rate":{"type":"number","description":"Estimated ad recall lift rate (%)","x-description-i18n":{"vie":"Tỷ lệ độ cải thiện khả năng nhớ đến quảng cáo theo ước tính"}},"cost_per_estimated_ad_recallers":{"type":"number","description":"Cost per estimated ad recall lift (people)","x-description-i18n":{"vie":"Chi phí trên độ cải thiện khả năng nhớ đến quảng cáo theo ước tính (Người)"}},"cost_per_messaging_conversation_started":{"type":"number","description":"Cost per messaging conversation started","x-description-i18n":{"vie":"Chi phí trên mỗi lượt bắt đầu cuộc trò chuyện qua tin nhắn"}},"lead":{"type":"number","description":"Leads","x-description-i18n":{"vie":"Khách hàng tiềm năng"}},"website_lead":{"type":"number","description":"Website leads","x-description-i18n":{"vie":"Số khách hàng tiềm năng trên trang web"}},"offline_lead":{"type":"number","description":"Offline leads","x-description-i18n":{"vie":"Số khách hàng tiềm năng offline"}},"meta_lead":{"type":"number","description":"Meta leads","x-description-i18n":{"vie":"Khách hàng tiềm năng trên Meta"}},"lead_conversion_value":{"type":"number","description":"Lead conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi khách hàng tiềm năng"}},"website_lead_conversion_value":{"type":"number","description":"Website lead conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi khách hàng tiềm năng trên trang web"}},"offline_lead_conversion_value":{"type":"number","description":"Offline lead conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi khách hàng tiềm năng offline"}},"meta_lead_conversion_value":{"type":"number","description":"Meta lead conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi khách hàng tiềm năng của Meta"}},"cost_per_lead":{"type":"number","description":"Cost per lead","x-description-i18n":{"vie":"Chi phí trên mỗi khách hàng tiềm năng"}},"omni_purchase":{"type":"number","description":"Purchases","x-description-i18n":{"vie":"Lượt mua"}},"inapp_omni_purchase":{"type":"number","description":"In-app purchases","x-description-i18n":{"vie":"Lượt khách hàng trong ứng dụng"}},"website_omni_purchase":{"type":"number","description":"Website purchases","x-description-i18n":{"vie":"Lượt mua trên web"}},"offline_omni_purchase":{"type":"number","description":"Offline purchases","x-description-i18n":{"vie":"Lượt mua hàng offline"}},"meta_omni_purchase":{"type":"number","description":"Meta purchases","x-description-i18n":{"vie":"Lượt mua trên Meta"}},"omni_purchase_conversion_value":{"type":"number","description":"Purchase conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt mua"}},"inapp_omni_purchase_conversion_value":{"type":"number","description":"In-app purchase conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi của lượt mua hàng trong ứng dụng"}},"website_omni_purchase_conversion_value":{"type":"number","description":"Website purchase conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi của lượt mua trên web"}},"offline_omni_purchase_conversion_value":{"type":"number","description":"Offline purchase conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt mua hàng offline"}},"meta_omni_purchase_conversion_value":{"type":"number","description":"Meta purchase conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi của lượt mua trên Meta"}},"cost_per_omni_purchase":{"type":"number","description":"Cost per purchase","x-description-i18n":{"vie":"Chi phí trên mỗi lượt mua"}},"omni_initiated_checkout":{"type":"number","description":"Checkout initiated","x-description-i18n":{"vie":"Lượt bắt đầu thanh toán"}},"inapp_omni_initiated_checkout":{"type":"number","description":"In-app checkout initiated","x-description-i18n":{"vie":"Lượt bắt đầu thanh toán trên ứng dụng di động"}},"website_omni_initiated_checkout":{"type":"number","description":"Website checkout initiated","x-description-i18n":{"vie":"Lượt bắt đầu thanh toán trên web"}},"offline_omni_initiated_checkout":{"type":"number","description":"Offline checkout initiated","x-description-i18n":{"vie":"Lượt bắt đầu thanh toán offline"}},"meta_omni_initiated_checkout":{"type":"number","description":"Meta checkout initiated","x-description-i18n":{"vie":"Lượt bắt đầu thanh toán trên Meta"}},"omni_initiated_checkout_conversion_value":{"type":"number","description":"Checkout initiated conversion value","x-description-i18n":{"vie":"Giá trị của chuyển đổi bắt đầu thanh toán"}},"inapp_omni_initiated_checkout_conversion_value":{"type":"number","description":"In-app checkout initiated conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt bắt đầu thanh toán trong ứng dụng"}},"website_omni_initiated_checkout_conversion_value":{"type":"number","description":"Website checkout initiated conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi của số lượt bắt đầu thanh toán trên trang web"}},"offline_omni_initiated_checkout_conversion_value":{"type":"number","description":"Offline checkout initiated conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi offline từ sự kiện bắt đầu thanh toán"}},"meta_omni_initiated_checkout_conversion_value":{"type":"number","description":"Meta checkout initiated conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt bắt đầu thanh toán trên Meta"}},"cost_per_omni_initiated_checkout":{"type":"number","description":"Cost per checkout initiated","x-description-i18n":{"vie":"Chi phí trên mỗi lượt bắt đầu thanh toán"}},"omni_complete_registration":{"type":"number","description":"Registrations completed","x-description-i18n":{"vie":"Lượt hoàn tất đăng ký"}},"inapp_omni_complete_registration":{"type":"number","description":"In-app registrations completed","x-description-i18n":{"vie":"Lượt hoàn tất đăng ký trên ứng dụng di động"}},"website_omni_complete_registration":{"type":"number","description":"Website registrations completed","x-description-i18n":{"vie":"Lượt hoàn tất đăng ký trên trang web"}},"offline_omni_complete_registration":{"type":"number","description":"Offline registrations completed","x-description-i18n":{"vie":"Lượt hoàn tất đăng ký offline"}},"omni_complete_registration_conversion_value":{"type":"number","description":"Registration completed conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt hoàn tất đăng ký"}},"inapp_omni_complete_registration_conversion_value":{"type":"number","description":"In-app registration completed conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt hoàn tất đăng ký trong ứng dụng"}},"website_omni_complete_registration_conversion_value":{"type":"number","description":"Website registration completed conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt hoàn tất đăng ký trên trang web"}},"offline_omni_complete_registration_conversion_value":{"type":"number","description":"Offline registration completed conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt hoàn tất đăng ký offline"}},"cost_per_omni_complete_registration":{"type":"number","description":"Cost per registration completed","x-description-i18n":{"vie":"Chi phí trên mỗi lượt hoàn tất đăng ký"}},"omni_view_content":{"type":"number","description":"Content views","x-description-i18n":{"vie":"Lượt xem nội dung"}},"inapp_omni_view_content":{"type":"number","description":"In-app content views","x-description-i18n":{"vie":"Lượt xem nội dung trong ứng dụng"}},"website_omni_view_content":{"type":"number","description":"Website content views","x-description-i18n":{"vie":"Lượt xem nội dung trên trang web"}},"offline_omni_view_content":{"type":"number","description":"Offline content views","x-description-i18n":{"vie":"Lượt xem nội dung offline"}},"meta_omni_view_content":{"type":"number","description":"Meta content views","x-description-i18n":{"vie":"Lượt xem nội dung trên Meta"}},"omni_view_content_conversion_value":{"type":"number","description":"Content view conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt xem nội dung"}},"inapp_omni_view_content_conversion_value":{"type":"number","description":"In-app content view conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt xem nội dung trong ứng dụng"}},"website_omni_view_content_conversion_value":{"type":"number","description":"Website content view conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt xem nội dung trên trang web"}},"offline_omni_view_content_conversion_value":{"type":"number","description":"Offline content view conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi offline từ sự kiện xem nội dung"}},"meta_omni_view_content_conversion_value":{"type":"number","description":"Meta content view conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt xem nội dung trên Meta"}},"cost_per_omni_view_content":{"type":"number","description":"Cost per content view","x-description-i18n":{"vie":"Chi phí trên mỗi lượt xem nội dung"}},"omni_search":{"type":"number","description":"Searches","x-description-i18n":{"vie":"Tìm kiếm"}},"inapp_omni_search":{"type":"number","description":"In-app searches","x-description-i18n":{"vie":"Lượt tìm kiếm trong ứng dụng"}},"website_omni_search":{"type":"number","description":"Website searches","x-description-i18n":{"vie":"Lượt tìm kiếm trên trang web"}},"offline_omni_search":{"type":"number","description":"Offline searches","x-description-i18n":{"vie":"Lượt tìm kiếm offline"}},"omni_search_conversion_value":{"type":"number","description":"Search conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi của tìm kiếm"}},"inapp_omni_search_conversion_value":{"type":"number","description":"In-app search conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi tìm kiếm ứng dụng di động"}},"website_omni_search_conversion_value":{"type":"number","description":"Website search conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi của tìm kiếm trên trang web"}},"offline_omni_search_conversion_value":{"type":"number","description":"Offline search conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt tìm kiếm offline"}},"cost_per_omni_search":{"type":"number","description":"Cost per search","x-description-i18n":{"vie":"Chi phí trên mỗi lượt tìm kiếm"}},"omni_add_to_cart":{"type":"number","description":"Add to cart","x-description-i18n":{"vie":"Lượt thêm vào giỏ hàng"}},"inapp_omni_add_to_cart":{"type":"number","description":"In-app add to cart","x-description-i18n":{"vie":"Lượt thêm vào giỏ hàng trong ứng dụng"}},"website_omni_add_to_cart":{"type":"number","description":"Website add to cart","x-description-i18n":{"vie":"Lượt thêm vào giỏ hàng trên trang web"}},"offline_omni_add_to_cart":{"type":"number","description":"Offline add to cart","x-description-i18n":{"vie":"Lượt thêm vào giỏ hàng offline"}},"meta_omni_add_to_cart":{"type":"number","description":"Meta add to cart","x-description-i18n":{"vie":"Lượt thêm vào giỏ hàng trên Meta"}},"omni_add_to_cart_conversion_value":{"type":"number","description":"Add to cart conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt thêm vào giỏ hàng"}},"inapp_omni_add_to_cart_conversion_value":{"type":"number","description":"In-app add to cart conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt thêm ứng dụng vào giỏ hàng"}},"website_omni_add_to_cart_conversion_value":{"type":"number","description":"Website add to cart conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt thêm vào giỏ hàng trên trang web"}},"offline_omni_add_to_cart_conversion_value":{"type":"number","description":"Offline add to cart conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi offline từ các lượt thêm vào giỏ hàng"}},"meta_omni_add_to_cart_conversion_value":{"type":"number","description":"Meta add to cart conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt thêm vào giỏ hàng trên Meta"}},"cost_per_omni_add_to_cart":{"type":"number","description":"Cost per add to cart","x-description-i18n":{"vie":"Chi phí trên mỗi lượt thêm vào giỏ hàng"}},"omni_add_to_wishlist":{"type":"number","description":"Add to wishlist","x-description-i18n":{"vie":"Thêm vào danh sách mong ước"}},"inapp_omni_add_to_wishlist":{"type":"number","description":"In-app add to wishlist","x-description-i18n":{"vie":"Thêm vào danh sách mong ước trong ứng dụng di động"}},"website_omni_add_to_wishlist":{"type":"number","description":"Website add to wishlist","x-description-i18n":{"vie":"Thêm vào danh sách mong ước trên trang web"}},"offline_omni_add_to_wishlist":{"type":"number","description":"Offline add to wishlist","x-description-i18n":{"vie":"Thêm vào danh sách mong ước offline"}},"meta_omni_add_to_wishlist":{"type":"number","description":"Meta add to wishlist","x-description-i18n":{"vie":"Thêm vào danh sách mong ước trên Meta"}},"omni_add_to_wishlist_conversion_value":{"type":"number","description":"Add to wishlist conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt thêm vào danh sách mong ước"}},"inapp_omni_add_to_wishlist_conversion_value":{"type":"number","description":"In-app add to wishlist conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt thêm vào danh sách mong ước trong ứng dụng"}},"website_omni_add_to_wishlist_conversion_value":{"type":"number","description":"Website add to wishlist conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt thêm vào danh sách mong ước trên trang web"}},"offline_omni_add_to_wishlist_conversion_value":{"type":"number","description":"Offline add to wishlist conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi offline từ lượt thêm vào danh sách mong ước"}},"meta_omni_add_to_wishlist_conversion_value":{"type":"number","description":"Meta add to wishlist conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt thêm vào danh sách mong ước trên Meta"}},"cost_per_omni_add_to_wishlist":{"type":"number","description":"Cost per add to wishlist","x-description-i18n":{"vie":"Chi phí trên mỗi lượt thêm vào danh sách mong ước"}},"customize_product_total":{"type":"number","description":"Product customizations","x-description-i18n":{"vie":"Lượt tuỳ chỉnh sản phẩm"}},"inapp_customize_product_total":{"type":"number","description":"In-app product customizations","x-description-i18n":{"vie":"Lượt tuỳ chỉnh sản phẩm trong ứng dụng di động"}},"website_customize_product_total":{"type":"number","description":"Website product customizations","x-description-i18n":{"vie":"Lượt tuỳ chỉnh sản phẩm trên trang web"}},"offline_customize_product_total":{"type":"number","description":"Offline product customizations","x-description-i18n":{"vie":"Lượt tuỳ chỉnh sản phẩm offline"}},"customize_product_total_conversion_value":{"type":"number","description":"Product customization conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt tuỳ chỉnh sản phẩm"}},"inapp_customize_product_total_conversion_value":{"type":"number","description":"In-app product customization conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt tuỳ chỉnh sản phẩm trong ứng dụng"}},"website_customize_product_total_conversion_value":{"type":"number","description":"Website product customization conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt tuỳ chỉnh sản phẩm trên trang web"}},"offline_customize_product_total_conversion_value":{"type":"number","description":"Offline product customization conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt tuỳ chỉnh sản phẩm offline"}},"cost_per_customize_product_total":{"type":"number","description":"Cost per product customization","x-description-i18n":{"vie":"Chi phí trên mỗi lượt tuỳ chỉnh sản phẩm"}},"start_trial_total":{"type":"number","description":"Trials started","x-description-i18n":{"vie":"Lượt bắt đầu dùng thử"}},"inapp_start_trial_total":{"type":"number","description":"In-app trials started","x-description-i18n":{"vie":"Lượt bắt đầu dùng thử trong ứng dụng di động"}},"website_start_trial_total":{"type":"number","description":"Website trials started","x-description-i18n":{"vie":"Lượt bắt đầu dùng thử trên trang web"}},"offline_start_trial_total":{"type":"number","description":"Offline trials started","x-description-i18n":{"vie":"Lượt bắt đầu dùng thử offline"}},"start_trial_total_conversion_value":{"type":"number","description":"Trial started conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt bắt đầu dùng thử"}},"inapp_start_trial_total_conversion_value":{"type":"number","description":"In-app trial started conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt bắt đầu dùng thử trong ứng dụng"}},"website_start_trial_total_conversion_value":{"type":"number","description":"Website trial started conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt bắt đầu dùng thử trên trang web"}},"offline_start_trial_total_conversion_value":{"type":"number","description":"Offline trial started conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt bắt đầu dùng thử offline"}},"cost_per_start_trial_total":{"type":"number","description":"Cost per trial started","x-description-i18n":{"vie":"Chi phí trên mỗi lượt bắt đầu dùng thử"}},"subscribe_total":{"type":"number","description":"Subscriptions","x-description-i18n":{"vie":"Lượt đăng ký"}},"inapp_subscribe_total":{"type":"number","description":"In-app subscriptions","x-description-i18n":{"vie":"Lượt đăng ký trong ứng dụng di động"}},"website_subscribe_total":{"type":"number","description":"Website subscriptions","x-description-i18n":{"vie":"Lượt đăng ký trên trang web"}},"offline_subscribe_total":{"type":"number","description":"Offline subscriptions","x-description-i18n":{"vie":"Lượt đăng ký offline"}},"subscribe_total_conversion_value":{"type":"number","description":"Subscription conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt đăng ký"}},"inapp_subscribe_total_conversion_value":{"type":"number","description":"In-app subscription conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt đăng ký trong ứng dụng"}},"website_subscribe_total_conversion_value":{"type":"number","description":"Website subscription conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt đăng ký trên trang web"}},"offline_subscribe_total_conversion_value":{"type":"number","description":"Offline subscription conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt đăng ký offline"}},"cost_per_subscribe_total":{"type":"number","description":"Cost per subscription","x-description-i18n":{"vie":"Chi phí trên mỗi lượt đăng ký"}},"submit_application_total":{"type":"number","description":"Applications submitted","x-description-i18n":{"vie":"Lượt gửi đơn"}},"inapp_submit_application_total":{"type":"number","description":"In-app applications submitted","x-description-i18n":{"vie":"Lượt gửi đơn trong ứng dụng di động"}},"website_submit_application_total":{"type":"number","description":"Website applications submitted","x-description-i18n":{"vie":"Lượt gửi đơn trên trang web"}},"offline_submit_application_total":{"type":"number","description":"Offline applications submitted","x-description-i18n":{"vie":"Lượt gửi đơn offline"}},"meta_submit_application_total":{"type":"number","description":"Meta applications submitted","x-description-i18n":{"vie":"Lượt gửi đơn đăng ký trên Meta"}},"submit_application_total_conversion_value":{"type":"number","description":"Application submitted conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt gửi đơn"}},"inapp_submit_application_total_conversion_value":{"type":"number","description":"In-app application submitted conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt gửi đơn đăng ký trong ứng dụng"}},"website_submit_application_total_conversion_value":{"type":"number","description":"Website application submitted conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt gửi đơn đăng ký trên trang web"}},"offline_submit_application_total_conversion_value":{"type":"number","description":"Offline application submitted conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt gửi đơn đăng ký offline"}},"meta_submit_application_total_conversion_value":{"type":"number","description":"Meta application submitted conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ lượt gửi đơn đăng ký trên Meta"}},"cost_per_submit_application_total":{"type":"number","description":"Cost per application submitted","x-description-i18n":{"vie":"Chi phí trên mỗi lượt gửi đơn"}},"contact_total":{"type":"number","description":"Contacts","x-description-i18n":{"vie":"Người liên hệ"}},"inapp_contact_total":{"type":"number","description":"In-app contacts","x-description-i18n":{"vie":"Người liên hệ trong ứng dụng di động"}},"website_contact_total":{"type":"number","description":"Website contacts","x-description-i18n":{"vie":"Người liên hệ trên trang web"}},"offline_contact_total":{"type":"number","description":"Offline contacts","x-description-i18n":{"vie":"Người liên hệ offline"}},"contact_total_conversion_value":{"type":"number","description":"Contact conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ người liên hệ"}},"inapp_contact_total_conversion_value":{"type":"number","description":"In-app contact conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ người liên hệ trong ứng dụng"}},"website_contact_total_conversion_value":{"type":"number","description":"Website contact conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ người liên hệ trên trang web"}},"offline_contact_total_conversion_value":{"type":"number","description":"Offline contact conversion value","x-description-i18n":{"vie":"Giá trị chuyển đổi từ người liên hệ offline"}},"cost_per_contact_total":{"type":"number","description":"Cost per contact","x-description-i18n":{"vie":"Chi phí trên mỗi lượt liên hệ"}},"landing_page_view":{"type":"number","description":"Landing page views","x-description-i18n":{"vie":"Số lượt xem trang đích"}},"inapp_landing_page_view":{"type":"number","description":"In-app landing page views","x-description-i18n":{"vie":"Lượt xem trang đích trong ứng dụng"}},"website_landing_page_view":{"type":"number","description":"Website landing page views","x-description-i18n":{"vie":"Lượt xem trang đích trên trang web"}},"cost_per_landing_page_view":{"type":"number","description":"Cost per landing page view","x-description-i18n":{"vie":"Chi phí trên mỗi lượt xem trang đích"}},"order_created":{"type":"number","description":"Orders created","x-description-i18n":{"vie":"Đơn đặt hàng đã tạo"}},"order_shipped":{"type":"number","description":"Orders shipped","x-description-i18n":{"vie":"Đơn đặt hàng đã vận chuyển"}},"purchase_roas":{"type":"number","description":"Purchase ROAS","x-description-i18n":{"vie":"ROAS (Lợi nhuận trên chi tiêu quảng cáo) của lượt mua"}},"inapp_purchase_roas":{"type":"number","description":"In-app purchase ROAS","x-description-i18n":{"vie":"ROAS (Lợi nhuận trên chi tiêu quảng cáo) của lượt mua trong ứng dụng"}},"website_purchase_roas":{"type":"number","description":"Website purchase ROAS","x-description-i18n":{"vie":"ROAS (Lợi nhuận trên chi tiêu quảng cáo) của lượt mua trên trang web"}},"order_statistics":{"type":"array","description":"Order count grouped by day offset from campaign start","x-description-i18n":{"vie":"Thống kê đơn hàng theo ngày kể từ khi chiến dịch bắt đầu"},"items":{"type":"object","properties":{"id":{"type":"integer","description":"Day offset","x-description-i18n":{"vie":"Ngày thứ (tính từ ngày bắt đầu)"}},"order_count":{"type":"integer","description":"Number of orders on that day","x-description-i18n":{"vie":"Số đơn hàng trong ngày đó"}}}}}}}}}},"summary":{"type":"object","description":"Aggregated performance metrics across all ads","x-description-i18n":{"vie":"Tổng hợp chỉ số hiệu suất của tất cả quảng cáo"},"properties":{"impressions":{"type":"number","description":"Total impressions","x-description-i18n":{"vie":"Tổng lượt hiển thị"}},"clicks":{"type":"integer","description":"Total clicks","x-description-i18n":{"vie":"Tổng số lần nhấp (tất cả)"}},"reach":{"type":"integer","description":"Total unique people reached","x-description-i18n":{"vie":"Tổng số người tiếp cận Trải nghiệm tức thì"}},"spend":{"type":"number","description":"Total amount spent","x-description-i18n":{"vie":"Tổng số tiền đã chi tiêu"}},"cpc":{"type":"number","description":"CPC","x-description-i18n":{"vie":"CPC"}},"cpm":{"type":"number","description":"CPM","x-description-i18n":{"vie":"CPM"}},"cpp":{"type":"number","description":"CPP","x-description-i18n":{"vie":"CPP"}},"ctr":{"type":"number","description":"CTR","x-description-i18n":{"vie":"CTR"}},"frequency":{"type":"number","description":"Average frequency","x-description-i18n":{"vie":"Tần suất trung bình"}}}},"page_number":{"type":"integer","description":"Current page number","x-description-i18n":{"vie":"Trang hiện tại"}},"page_size":{"type":"integer","description":"Number of records per page","x-description-i18n":{"vie":"Số bản ghi mỗi trang"}},"total_entries":{"type":"integer","description":"Total number of ads","x-description-i18n":{"vie":"Tổng số quảng cáo"}},"total_pages":{"type":"integer","description":"Total number of pages","x-description-i18n":{"vie":"Tổng số trang"}}}}},"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"API key for authentication.\n\nTo create an API key, go to **Setting -> Application** and click `Create` in the `API KEY` frame.\n","x-description-i18n":{"vie":"Khóa API để xác thực.\n\nĐể tạo API key, vào **Cấu hình -> Ứng dụng** và click `Thêm mới` trong khung `API KEY`.\n"}}}},"security":[{"ApiKeyAuth":[]}]}