Chào mừng bạn đến với tài liệu lập trình viên chính thức của Hogotopod Fulfillment Partner API. Hệ thống API này cho phép các đối tác, nhà bán hàng (sellers) và các nền tảng thương mại điện tử kết nối trực tiếp với hệ sinh thái sản xuất và đóng gói vận chuyển của Hogotopod để tự động hóa toàn bộ quy trình: từ đồng bộ sản phẩm, ước tính chi phí, tạo đơn hàng thêu/in ấn đến cập nhật mã vận đơn (tracking).

Khởi đầu nhanh

Tạo đơn hàng đầu tiên của bạn chỉ trong 5 phút với cURL mẫu.

Xác thực & API Key

Tìm hiểu cách tạo API Key từ Seller Portal và quy tắc Header bắt buộc.

Tùy chọn thêu & đắp vải

Tra cứu mã kim tuyến, màu chỉ, mẫu vải đắp và vị trí thêu hợp lệ.

Hướng dẫn tạo đơn

Khám phá định dạng payload tạo đơn thêu, in 2D/3D và ước tính giá thành.

​
Các tính năng cốt lõi

1

Hỗ trợ đa dạng kỹ thuật sản xuất

Hệ thống hỗ trợ chuyên sâu các kỹ thuật:
  • Thêu vi tính (Embroidery): Thêu phẳng, thêu đắp vải (Appliqué), thêu chỉ kim tuyến (Glitter yarn), nhiều vị trí (Center, Left chest, Sleeve).
  • In ấn theo yêu cầu (Print On Demand - 2D/3D): All-over-print, DTG, in nhiệt chất lượng cao.
2

Tự động hóa xử lý đơn hàng

  • Tạo đơn hàng đơn lẻ (/v1/partner/order/store) hoặc theo lô nhiều đơn (/v1/partner/order/store-batch).
  • Ước tính chi phí và tự động trừ ví cọc (autoDeposit).
  • Đính kèm file thiết kế (designUrl), file chạy thêu (dstFileUrl) và ảnh preview mockup.
3

Đa dạng phương thức vận chuyển quốc tế

  • Tích hợp các line vận chuyển: Hogotofast, Hogoto ePacket, TikTok Shop (US/UK), Ship to EU, v.v.
  • Hỗ trợ dán nhãn vận chuyển tự in (Partner Label) hoặc do hệ thống tự sinh mã tracking.
4

Tra cứu danh mục & biểu phí trực tiếp

  • Lấy bảng giá sản xuất theo size và màu sắc.
  • Tính toán trước phí ship theo từng quốc gia và vùng địa lý.

​
Thông tin máy chủ (Base URL)

Tất cả các lệnh gọi API đều được thực thi thông qua cổng API HTTPS bảo mật:
Tất cả các endpoint dành cho đối tác đều bắt đầu bằng tiền tố /v1/partner/* (ví dụ: https://seller.hogotopod.com/api/v1/partner/order/store).

​
Quy ước dữ liệu & Mã phản hồi

Hệ thống giao tiếp thông qua giao thức HTTP RESTful chuẩn hóa:
  • Định dạng dữ liệu: JSON (Content-Type: application/json; charset=utf-8).
  • Cấu trúc phản hồi chuẩn: