# Hogotopod Partner API

## Docs

- [Giới thiệu Hogotopod Partner API](/index): Hệ thống tích hợp đơn hàng tự động dành cho đối tác Hogotopod Fulfillment
- [Bắt đầu nhanh (Quickstart)](/quickstart): Tạo đơn hàng Fulfillment đầu tiên với Hogotopod Partner API trong 5 phút
- [Xác thực & API Key](/authentication): Hướng dẫn cấu hình bảo mật, tạo API Key và thiết lập Headers cho Partner API
- [Tạo đơn hàng Partner](/guides/order-creation): Hướng dẫn chi tiết quy trình tạo đơn đơn lẻ, tạo đơn hàng loạt và ước tính chi phí
- [Cẩm nang Thêu & Đắp vải](/guides/embroidery-catalogs): Hướng dẫn tra cứu danh mục mã màu chỉ, kim tuyến, mẫu vải và cấu hình thêu vi tính
- [Sản phẩm & Biểu phí](/guides/products-pricing): Hướng dẫn tra cứu danh mục sản phẩm, tính toán giá thành và biểu phí vận chuyển
- [Vận chuyển & Vòng đời Đơn hàng](/guides/shipping-update): Cập nhật thông tin shipping label, theo dõi tiến độ sản xuất và hủy đơn hàng
- [Danh sách API Key của tài khoản](/api-reference/api-key-management/danh-sách-api-key-của-tài-khoản)
- [Tạo API Key mới (rawKey chỉ trả về một lần)](/api-reference/api-key-management/tạo-api-key-mới-rawkey-chỉ-trả-về-một-lần)
- [Thu hồi API Key](/api-reference/api-key-management/thu-hồi-api-key)
- [Lấy danh mục theo group code](/api-reference/catalogs-&-options/lấy-danh-mục-theo-group-code): Group được hỗ trợ cho Partner API:<ul><li><code>EMBROIDERY_THREAD_COLOR</code> — màu chỉ thêu → <code>threadColors</code></li><li><code>GLITTER_COLOR</code> — màu kim tuyến → <code>glitterColors</code></li><li><code>YARN_COLOR</code> — màu len → <code>yarnColors</code></li><li><code>PRODUCT_POSITIONS</code> — vị trí → <code>positionCode</code></li><li><code>FABRIC_CATEGORIES</code> — nhóm mẫu vải (lọc)</li></ul>Dùng field <code>code</code> của từng phần tử khi tạo đơn.
- [Lấy toàn bộ danh mục tùy chọn thêu / đắp vải](/api-reference/catalogs-&-options/lấy-toàn-bộ-danh-mục-tùy-chọn-thêu-đắp-vải): Cùng nguồn dữ liệu với màn hình tạo đơn khách hàng (form-order):<ul><li><b>threadColors</b> — group <code>EMBROIDERY_THREAD_COLOR</code> → <code>designAttachments.threadColors</code></li><li><b>glitterColors</b> — GET catalog group <code>GLITTER_COLOR</code> → field <code>designAttachments.glitterColors</code></li><li><b>yarnColors</b> — group <code>YARN_COLOR</code> → <code>designAttachments.yarnColors</code></li><li><b>fabricPatterns</b> — danh sách fabric → <code>designAttachments.fabricPatterns</code> (gửi <code>code</code>)</li><li><b>fabricCategories</b> — group <code>FABRIC_CATEGORIES</code> (lọc UI)</li><li><b>positions</b> — group <code>PRODUCT_POSITIONS</code> → <code>positionCode</code></li></ul>Nhiều mã catalog/fabric: nối bằng dấu phẩy, ví dụ <code>GOLD,SILVER</code>. Màu chỉ thêu chỉ chọn màu có sẵn trong danh mục (không hỗ trợ enum). Field outline đã ngừng.
- [Lấy danh sách các loại phụ phí cấp sản phẩm có thể chọn](/api-reference/catalogs-&-options/lấy-danh-sách-các-loại-phụ-phí-cấp-sản-phẩm-có-thể-chọn): Cùng nguồn dữ liệu và quy tắc lọc với màn hình tạo đơn khách hàng (form-order):<ul><li>Chỉ trả về các phụ phí khách/đối tác có thể chủ động chọn (FEE_PRODUCT = 32); các phí hệ thống tự động tính (như phụ phí vượt mũi thêu EMBROIDERY_STITCH_OVERAGE) hoặc phí đã ngừng được ẩn đi hoàn toàn</li><li>Có thể truyền tham số <code>productType</code> (EMBROIDERY, PRINT_2D, PRINT_3D, PRINT_UV, PRINT_3D_EMBROIDERY) để lọc phụ phí theo loại sản phẩm</li><li>Nếu không truyền <code>productType</code>, trả về toàn bộ phụ phí cấp sản phẩm có thể chọn</li><li>Dùng mã <code>code</code> để truyền vào mảng <code>products[].feeCodes</code> khi tạo đơn qua POST /v1/partner/order/store</li></ul>
- [Lấy danh sách mẫu thêu đắp vải (fabric patterns)](/api-reference/catalogs-&-options/lấy-danh-sách-mẫu-thêu-đắp-vải-fabric-patterns): Tương đương GET /v1/fabric trên portal. Gửi <code>code</code> vào <code>designAttachments.fabricPatterns</code> (nhiều mã cách nhau bởi dấu phẩy). Dùng kèm fee <code>CHOOSE_PATTERN_FABRIC</code>.
- [Danh sách quốc gia](/api-reference/partner-orders/danh-sách-quốc-gia)
- [Chi tiết đơn hàng cho đối tác](/api-reference/partner-orders/chi-tiết-đơn-hàng-cho-đối-tác)
- [Ước tính đơn hàng cho đối tác](/api-reference/partner-orders/ước-tính-đơn-hàng-cho-đối-tác)
- [Tạo đơn hàng cho đối tác](/api-reference/partner-orders/tạo-đơn-hàng-cho-đối-tác)
- [Tạo nhiều đơn hàng cho đối tác](/api-reference/partner-orders/tạo-nhiều-đơn-hàng-cho-đối-tác)
- [Đặt cọc đơn hàng cho đối tác](/api-reference/partner-orders/đặt-cọc-đơn-hàng-cho-đối-tác): Đặt cọc một hoặc nhiều đơn theo danh sách `ordersCode`. `isFull=true` đặt cọc toàn bộ giá trị còn lại.
- [Xóa đơn hàng cho đối tác](/api-reference/partner-orders/xóa-đơn-hàng-cho-đối-tác)
- [Đồng ý tuỳ chỉnh giá phí sản phẩm](/api-reference/partner-orders/đồng-ý-tuỳ-chỉnh-giá-phí-sản-phẩm): Đồng ý báo giá / tuỳ chỉnh phí đang chờ xác nhận (`feePriceConfirm.status = SENT`).
- [Cập nhật thông tin vận chuyển cho đối tác](/api-reference/partner-orders/cập-nhật-thông-tin-vận-chuyển-cho-đối-tác)
- [Lấy ra mã giảm giá của khách hàng cho đối tác](/api-reference/partner-orders/lấy-ra-mã-giảm-giá-của-khách-hàng-cho-đối-tác)
- [findAll](/api-reference/product-api/findall)
- [count](/api-reference/product-api/count)
- [search](/api-reference/product-api/search)
- [findByCode](/api-reference/product-api/findbycode)
- [getAllShippingFees](/api-reference/product-api/getallshippingfees)
- [findFeeByCode](/api-reference/product-api/findfeebycode)
- [calculateShippingFee](/api-reference/product-api/calculateshippingfee)