Tra cứu hành trình vận đơn

Endpoint

GET /v1/shippingbillgateways/:id/tracking

Lấy hành trình vận đơn từ hãng và trả về theo một định dạng chung cho mọi hãng. Không thay đổi dữ liệu vận đơn.

Tên	Kiểu	Bắt buộc	Mô tả
`id`	int	Có	ID vận đơn

Trường	Kiểu	Mô tả
`company_id`	int	ID công ty
`id`	int	ID vận đơn
`tracking_code`	string	Mã vận đơn
`carrier_id`	int	ID carrier
`carrier_name`	string	Tên carrier
`carrier_type`	string	Loại hãng: `ghn`, `viettelpost`, `ghtk`, `jtexpress`, `ahamove`, `be`, `superai`
`carrier_logo`	string	Logo hãng (có thể rỗng)
`current_status`	object	Trạng thái hiện tại theo hãng: `code` (mã gốc của hãng, int hoặc string), `name`, `description`
`timeline`	array	Các mốc hành trình: `timestamp` (int), `datetime`, `status_code`, `status_name`, `description`, `location`, `images`
`driver_name`, `driver_phone`, `driver_avatar`, `driver_vehicle_type`, `driver_license_plate`	string	Thông tin tài xế (nếu hãng có, ví dụ Ahamove/BE)
`recipient_name`, `recipient_phone`, `recipient_address`	string	Người nhận (từ vận đơn)
`cod_amount`	int	Tiền thu hộ (VND)
`is_cod_collected`	bool	Hãng đã thu COD chưa
`carrier_fee`	int	Cước hãng (VND)
`carrier_fee_detail`	object	Chi tiết cước
`pod_signature_url`	string	Ảnh chữ ký nhận hàng
`pod_photo_urls`	array	Ảnh giao hàng
`pod_delivered_at`	int	Thời điểm giao (Unix timestamp)
`pod_received_by`	string	Người nhận hàng
`tracking_link`	string	Link tra cứu trên trang của hãng
`estimated_delivery_from`, `estimated_delivery_to`	int	Thời gian giao dự kiến (Unix timestamp, `0` = không rõ)
`date_last_synced`	int	Thời điểm lấy dữ liệu (Unix timestamp)

{ "error": ["error_tracking_code_required"] }

Mã lỗi	Mô tả
`error_notfound`	Vận đơn không tồn tại hoặc không thuộc công ty của bạn
`error_shipping_carrier_notfound`	Carrier của vận đơn không tồn tại / khác công ty
`error_tracking_code_required`	Vận đơn chưa có mã vận đơn
`error_carrier_not_support_tracking`	Hãng chưa hỗ trợ tra hành trình
`error_gateway_exception (...)`	Lỗi khi gọi hãng