Sản phẩm & Biểu phí

Hogotopod cung cấp danh mục phôi sản phẩm phong phú (Áo thun, Hoodie, Sweatshirt, Quần, Mũ, Tote bag, v.v.) kèm theo bảng tính phí ship chi tiết theo từng size và tuyến vận chuyển.

Tra cứu danh mục sản phẩm

1. Lấy tất cả sản phẩm

Lấy danh sách toàn bộ các sản phẩm đang khả dụng trong hệ thống:

curl --location 'https://seller.hogotopod.com/api/v1/product' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --header 'X-Tenant: fulfillment'

2. Tìm kiếm sản phẩm phân trang (`POST /v1/product/pageable`)

Dành cho các hệ thống cần tìm kiếm lọc theo danh mục hoặc phân trang hiển thị:

curl --location 'https://seller.hogotopod.com/api/v1/product/pageable' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --header 'X-Tenant: fulfillment' \
  --header 'Content-Type: application/json' \
  --data '{
    "page": 0,
    "size": 20,
    "sort": "createdDate,desc",
    "textSearch": "Sweater"
  }'

3. Tra cứu chi tiết một sản phẩm theo mã (`GET /v1/product/{code}`)

Lấy đầy đủ thông tin về màu sắc, danh sách size, trọng lượng và giá thành của từng biến thể:

curl --location 'https://seller.hogotopod.com/api/v1/product/SW01' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --header 'X-Tenant: fulfillment'

Tính toán Biểu phí & Vận chuyển

1. Tra cứu phí gốc và phụ phí sản phẩm (`GET /v1/product/{code}/fee`)

Endpoint này trả về ma trận giá phôi gốc và danh sách các khoản phụ phí có thể phát sinh (phí in thêm mặt, phí thêu tay áo, phí thêu 3D, v.v.):

curl --location 'https://seller.hogotopod.com/api/v1/product/SW01/fee' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --header 'X-Tenant: fulfillment'

2. Tính phí ship cho một kích cỡ cụ thể (`GET /v1/product/{code}/shipping-fee`)

Truyền thêm tham số size trên URL để nhận về cước phí vận chuyển tương ứng:

curl --location 'https://seller.hogotopod.com/api/v1/product/SW01/shipping-fee?size=L' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --header 'X-Tenant: fulfillment'

Phản hồi mẫu:

{
  "error": false,
  "code": "200",
  "result": {
    "HOGOTOFAST": 5.85,
    "HOGOTO_EPACKET": 4.50,
    "TIKTOK": 0.00,
    "SHIP_TO_EU": 7.20
  }
}

3. Lấy toàn bộ ma trận phí ship của tất cả các size (`GET /v1/product/{code}/all-shipping-fees`)

Để tránh việc phải gửi nhiều request cho từng kích cỡ, bạn có thể gọi endpoint này một lần để nhận ma trận giá ship của tất cả các size (S, M, L, XL, 2XL, 3XL…):

curl --location 'https://seller.hogotopod.com/api/v1/product/SW01/all-shipping-fees' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --header 'X-Tenant: fulfillment'

Phản hồi mẫu:

{
  "error": false,
  "code": "200",
  "result": {
    "S": {
      "HOGOTOFAST": 5.20,
      "HOGOTO_EPACKET": 4.10
    },
    "M": {
      "HOGOTOFAST": 5.20,
      "HOGOTO_EPACKET": 4.10
    },
    "L": {
      "HOGOTOFAST": 5.85,
      "HOGOTO_EPACKET": 4.50
    },
    "2XL": {
      "HOGOTOFAST": 6.50,
      "HOGOTO_EPACKET": 5.10
    }
  }
}

Bắt đầu

Hướng dẫn tích hợp

Tra cứu danh mục sản phẩm

1. Lấy tất cả sản phẩm

2. Tìm kiếm sản phẩm phân trang (`POST /v1/product/pageable`)

3. Tra cứu chi tiết một sản phẩm theo mã (`GET /v1/product/{code}`)

Tính toán Biểu phí & Vận chuyển

1. Tra cứu phí gốc và phụ phí sản phẩm (`GET /v1/product/{code}/fee`)

2. Tính phí ship cho một kích cỡ cụ thể (`GET /v1/product/{code}/shipping-fee`)

3. Lấy toàn bộ ma trận phí ship của tất cả các size (`GET /v1/product/{code}/all-shipping-fees`)

​Tra cứu danh mục sản phẩm

​1. Lấy tất cả sản phẩm

​2. Tìm kiếm sản phẩm phân trang (POST /v1/product/pageable)

​3. Tra cứu chi tiết một sản phẩm theo mã (GET /v1/product/{code})

​Tính toán Biểu phí & Vận chuyển

​1. Tra cứu phí gốc và phụ phí sản phẩm (GET /v1/product/{code}/fee)

​2. Tính phí ship cho một kích cỡ cụ thể (GET /v1/product/{code}/shipping-fee)

​3. Lấy toàn bộ ma trận phí ship của tất cả các size (GET /v1/product/{code}/all-shipping-fees)

Tra cứu danh mục sản phẩm

1. Lấy tất cả sản phẩm

2. Tìm kiếm sản phẩm phân trang (`POST /v1/product/pageable`)

3. Tra cứu chi tiết một sản phẩm theo mã (`GET /v1/product/{code}`)

Tính toán Biểu phí & Vận chuyển

1. Tra cứu phí gốc và phụ phí sản phẩm (`GET /v1/product/{code}/fee`)

2. Tính phí ship cho một kích cỡ cụ thể (`GET /v1/product/{code}/shipping-fee`)

3. Lấy toàn bộ ma trận phí ship của tất cả các size (`GET /v1/product/{code}/all-shipping-fees`)