Vận chuyển
Cập nhật hãng vận chuyển
Sửa thông tin và thông tin kết nối của một carrier
Endpoint
PUT /v1/shippingcarriers/:id
Quyền:
setting.sale
Path Parameters
| Tên | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
id | int | Có | ID carrier |
Request Body
Gửi đầy đủ các trường (các trường name, description, status, display_order, api_type, api_setting đều được ghi lại theo giá trị gửi lên).
| Trường | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
company_id | int | Có | ID công ty |
creator_id | int | Có | ID người sửa |
name | string | Có | Tên hiển thị |
api_type | int | Có | Loại hãng. Không đổi được sang loại hãng đang ẩn |
api_setting | object | Không | Thông tin kết nối (xem Shipping Carrier Object) |
description | string | Không | Mô tả |
status | int | Không | 1 (Bật), 3 (Tắt) |
display_order | int | Không | Thứ tự hiển thị |
Workflow & Logic
- Trường bí mật (chỉ ghi): gửi
""hoặc"********"(giá trị che đã nhận từ API) thì Hubport giữ nguyên giá trị đang lưu; gửi giá trị mới để thay. - GHN:
connect_modevàshop_idkhông gửi lên thì giữ giá trị cũ. Carrier đã kết nối bằng OTP luôn dùngshop_idcủa shop đã xác minh. - Đổi
api_type: thông tin kết nối cũ bị bỏ. Đổi carrier GHN sang hãng khác thì kết nối GHN bằng OTP cũng bị gỡ.
Response Schema
HTTP 200 - JSON Object
Shipping Carrier Object sau khi cập nhật.
Error Codes
| Mã lỗi | Mô tả |
|---|---|
error_name_required | Thiếu tên (HTTP 422) |
error_api_type_not_invalid | api_type không hợp lệ (HTTP 422) |
error_api_type_not_available | Không cho đổi sang loại hãng đang ẩn (HTTP 422) |
error_not_found | Carrier không tồn tại hoặc không thuộc công ty của bạn (HTTP 404) |
error_role_not_available | Không có quyền setting.sale (HTTP 403) |