Kho lấy hàng (Warehouses)

Kho lấy hàng là địa chỉ nơi carrier đến lấy hàng giao cho khách. Mỗi vận đơn Goship cần 1 kho làm điểm đi. Không có kho = không tạo được vận đơn.

Phải thêm ít nhất 1 kho

Mới setup hay quên mục này → không tính phí ship được, không tạo vận đơn được. Thêm kho ngay sau khi setup TrolyShip.

Vào quản lý kho

Kênh (/app/channels) → tab Vận chuyển → section TrolyShip → nút + Thêm kho.

Thêm kho

Form nhập:

Field	Label	Ghi chú
Tên kho	(vd “Kho HN”, “Kho HCM”)	Để phân biệt
Liên hệ	Tên người liên hệ	Ai giao hàng cho carrier
SĐT	Điện thoại liên hệ	Carrier gọi khi đến
Địa chỉ	Số nhà + đường	Bắt buộc
Tỉnh/Thành	Dropdown (data Goship)	Bắt buộc
Quận/Huyện	Dropdown (theo tỉnh)	Bắt buộc
Phường/Xã	Dropdown (theo huyện)	Bắt buộc
Mặc định	Checkbox	Đánh dấu kho dùng trước

Dropdown tỉnh/huyện/phường lấy từ Goship

Dropdown dùng data tĩnh từ Goship (goshipLocations.ts) — không tự gõ. Nếu khu vực bạn không có trong dropdown → khu vực đó Goship không phục vụ → không ship được tới đó.

Bấm Lưu → kho xuất hiện trong list.

Nhiều kho — khi nào cần

1 kho/khu vực

Nếu shop bạn giao cho khách cả miền Bắc + miền Nam → nên có 2 kho: 1 HN + 1 HCM. Khi tạo đơn, chọn kho gần khách nhất → phí rẻ + giao nhanh.

Số kho	Khi nào
1	Shop nhỏ, khách 1 khu vực
2-3	Shop có khách nhiều miền (HN, HCM, ĐN)
>3	Shop lớn, nhiều chi nhánh

Kho mặc định

Đánh dấu Mặc định (Mặc định badge) → kho này được chọn trước trong:

• Modal tạo vận đơn.
• autoShipIfEnabled — auto-ship dùng kho mặc định.

Chỉ 1 kho được mặc định tại 1 thời điểm. Nếu đánh mặc định kho khác → cũ tự bỏ.

Sửa / Xoá kho

• Sửa — đổi tên/địa chỉ/SĐT.
• Xoá — gỡ kho. Đơn đã có vận đơn dùng kho này → không ảnh hưởng (vận đơn giữ địa chỉ cũ).

Không xoá hết kho

Xoá hết kho = không tạo vận đơn mới được. Luôn giữ ít nhất 1.

Địa chỉ khách từ đâu

Khi tạo vận đơn, địa chỉ nhận (destination) lấy từ:

1. shipping_address JSON của đơn hàng ({city, district, ward, street} — code Goship).
2. Fallback: customer_* fields (địa chỉ khách của đơn).

Nếu khách nhập địa chỉ text tự do (không phải code Goship) → có thể không match → xem troubleshooting.

Workflow setup kho ban đầu

5 phút setup

1. Vào Kênh → tab Vận chuyển.
2. + Thêm kho → nhập địa chỉ shop bạn.
3. Đánh dấu Mặc định.
4. Xong — ship được ngay.

Kho chính = địa chỉ trong giấy phép KD

Carrier có thể check khớp địa chỉ kho với địa chỉ trong giấy phép kinh doanh của shop. Khớp → uy tín hơn, dễ được duyệt. Đừng nhập địa chỉ “ảo”.

Bước tiếp theo

• Tổng quan vận chuyển — kiến trúc TrolyShip/Goship.
• Vận đơn — tạo + theo dõi.
• Đơn hàng — duyệt đơn → tạo vận đơn.
• Troubleshooting vận chuyển — lỗi địa chỉ, webhook.