Change log

Add new field preferred_carrier

Release Date: 1/7/2026

What's New

● special_print (Optional, Boolean — true/false or 1/0)

Special print flag cho đơn FASTUS. Đánh dấu item sử dụng kỹ thuật in đặc biệt.

Vị trí: body.items[].special_print

Surcharge: Flat +$2.00/item (× quantity). Tính 1 lần per item dù có nhiều vùng in.

Chỉ áp dụng cho production line FASTUS. Bị reject nếu production line khác.

● size (Optional, 'default' | 'large') — Large Print

Print size cho từng vùng in. 'large' sử dụng khổ in lớn, tính thêm phụ phí per area.

Vị trí: body.items[].print_files[].size

Default: 'default'

Chỉ áp dụng cho FASTUS + sản phẩm trong allow-list:

Unisex T-shirt | Gildan 5000

Unisex T-shirt | Comfort Colors 1717

Unisex T-shirt | Bella + Canvas 3001

Unisex Washed Tee | Colortone CD1300

Vùng in hỗ trợ large: front, back, left_sleeve, right_sleeve

Surcharge per area (× quantity):

front: +$2.00

back: +$2.00

left_sleeve: +$0.50

right_sleeve: +$0.50

Bị reject nếu production line không phải FASTUS hoặc product không trong allow-list.

CSV: cột large_prints, giá trị comma-separated: front,back,left_sleeve

● shipping_method 'express' — Express Shipping cho FASTUS

Thêm phương thức vận chuyển express cho production line FASTUS.

FASTUS giờ hỗ trợ: standard, priority, express

Express pricing dùng variation.express_shipping_fee

Khi chọn express, không thể chọn speed_type (rush/expedite). Speed type chỉ áp dụng cho standard shipping.
Release Date: 13/6/2026

What's New

● preferred_carrier (Optional, 'auto' | 'usps')

Carrier selection cho đơn TIKTOK / US1 ship US, shipping_method=standard, không có label_url.

• 'usps' → route sang USPS-only. Pricing dùng variation.usps_shipping_fee + usps_additional_fee.
• 'auto' (hoặc bỏ trống) → route sang default

Required khi đơn match đủ điều kiện trên. Ignored với shipping method khác (express/priority/...) hoặc khi có label_url. Khi
update đổi shipping_method sang non-standard, phải set preferred_carrier=null cùng request.

Add DHL shipping method

Release Date: 1/1/2026

What's New

Bổ sung thêm phương thức vận chuyển mới(shipping_method) DHL cho production line TIKTOK: dhl_parcel_ground, dhl_parcel_expedited

Add is_trademark Support for VNEMB Orders (Public API Only)

Release Date: 30/10/2025

What's New

Thêm field is_trademark cho VNEMB orders trong Public API để đánh dấu item có sử dụng trademark. Lưu ý is_trademark là bắt buộc với VNEMB

API Changes (Public API v1)

Order Item Schema:

{
  "sku": "VN-SHIRT-001",
  "quantity": 10,
  "is_trademark": 1  // 0 hoặc 1
}

CSV Upload:
sku,quantity,is_trademark
VN-SHIRT-001,10,1

Rules

- ✅ Chỉ áp dụng cho Public API (/api/public/v1/orders)
- ✅ Chỉ cho VNEMB production line
- ✅ Giá trị: 0 (không có) hoặc 1 (có trademark)
- ❌ Non-VNEMB orders không được dùng field này

Add new field preferred_carrier#

What's New#

What's New#

Add DHL shipping method#

What's New#

Add is_trademark Support for VNEMB Orders (Public API Only)#

What's New#

API Changes (Public API v1)#

Add new field preferred_carrier

What's New

What's New

Add DHL shipping method

What's New

Add is_trademark Support for VNEMB Orders (Public API Only)

What's New

API Changes (Public API v1)