v2.logistics.get_channel_list
GET /api/v2/logistics/get_channel_list
Dùng API này để lấy tất cả kênh vận chuyển được hỗ trợ.
Đường dẫn Endpoint
URL: https://partner.shopeemobile.com/api/v2/logistics/get_channel_list
Tham số chung
| Tên | Kiểu | Mẫu | Mô tả |
|---|---|---|---|
| partner_id | int | 1 | Partner ID được cấp khi đăng ký thành công. Bắt buộc cho mọi yêu cầu. |
| timestamp | timestamp | 1610000000 | Dùng để xác định thời điểm của yêu cầu. Bắt buộc cho mọi yêu cầu. Hết hạn sau 5 phút. |
| access_token | string | c09222e3fc40ffb25fc947f738b1abf1 | Token truy cập API, dùng để xác định quyền của bạn. Có thể dùng nhiều lần và hết hạn sau 4 giờ. |
| shop_id | int | 600000 | Mã định danh duy nhất của Shopee cho một cửa hàng. Bắt buộc cho hầu hết các API. |
| sign | string | e318d3e932719916a9f9ebb57e2011961bd47abfa54a36e040d050d8931596e2 | Chữ ký được tạo từ partner_id, đường dẫn API, timestamp, access_token, shop_id và partner_key thông qua thuật toán băm HMAC-SHA256. Chi tiết: https://open.shopee.com/documents?module=87&type=2&id=58&version=2 |
Không có tham số yêu cầu.
Tham số Response
| Tên | Kiểu | Mẫu | Mô tả |
|---|---|---|---|
| error | string | error_auth | Cho biết loại lỗi nếu có lỗi xảy ra. Để trống nếu không có lỗi. |
| message | string | Invalid access_token. | Cho biết chi tiết lỗi nếu có lỗi xảy ra. Để trống nếu không có lỗi. |
| response | object | Thông tin chi tiết bạn đang truy vấn. | |
| logistics_channel_list | object[] | Danh sách kênh vận chuyển. | |
| logistics_channel_id | int64 | 28016 | Mã định danh của kênh vận chuyển. |
| logistics_channel_name | string | VNPost Nhanh_product | Tên kênh vận chuyển. |
| cod_enabled | boolean | true | Cho biết kênh vận chuyển này có hỗ trợ COD hay không. |
| enabled | boolean | true | Kênh vận chuyển này có được bật ở cấp cửa hàng hay không. |
| fee_type | string | SIZE_INPUT | SIZE_SELECTION SIZE_INPUT FIXED_DEFAULT_PRICE CUSTOM_PRICE |
| size_list | object[] | Chỉ dành cho fee_type là SIZE_SELECTION. | |
| size_id | string | 0 | Mã định danh của kích thước. |
| name | string | Tên kích thước. | |
| default_price | float | Phí vận chuyển được định sẵn cho kích thước cụ thể. | |
| weight_limit | object | Giới hạn cân nặng của kênh vận chuyển này. | |
| item_max_weight | float | 10.0 | Cân nặng tối đa cho một sản phẩm trên kênh vận chuyển này. Nếu giá trị là 0 hoặc null, không có giới hạn. |
| item_min_weight | float | 0.01 | Cân nặng tối thiểu cho một sản phẩm trên kênh vận chuyển này. Nếu giá trị là 0 hoặc null, không có giới hạn. |
| item_max_dimension | object | Giới hạn kích thước của kênh vận chuyển này. | |
| height | float | 100.0 | Giới hạn chiều cao tối đa. |
| width | float | 100.0 | Giới hạn chiều rộng tối đa. |
| length | float | 100.0 | Giới hạn chiều dài tối đa. |
| unit | string | cm | Đơn vị cho giới hạn. |
| dimension_sum | float | 280.0 | Tổng kích thước của sản phẩm. |
| volume_limit | object | Giới hạn thể tích sản phẩm. | |
| item_max_volume | float | 10.0 | Thể tích tối đa cho một sản phẩm trên kênh vận chuyển này. Nếu giá trị là 0 hoặc null, không có giới hạn. |
| item_min_volume | float | 1.0 | Thể tích tối thiểu cho một sản phẩm trên kênh vận chuyển này. Nếu giá trị là 0 hoặc null, không có giới hạn. |
| logistics_description | string | Đối với kênh thanh toán, trường này chỉ kênh thực hiện tương ứng. | |
| force_enable | boolean | false | Cho biết kênh vận chuyển có bị buộc bật ở cấp cửa hàng hay không. Nếu true, người bán không thể tắt kênh này. |
| mask_channel_id | int64 | 0 | Cho biết ID kênh vận chuyển cha. Nếu là 0, kênh là kênh thanh toán (masked); nếu khác 0, kênh là kênh thực hiện và có kênh thanh toán bên trên (channel_id của kênh thanh toán bằng mask_channel_id này). Nhiều kênh có thể dùng chung mask_channel_id. |
| block_seller_cover_shipping_fee | boolean | false | Cho biết kênh có bị chặn sử dụng chức năng người bán trả phí vận chuyển hay không. Nếu true, người bán không thể trả phí vận chuyển trên kênh này. |
| support_cross_border | boolean | false | Cho biết kênh này có hỗ trợ vận chuyển xuyên biên giới hay không. |
| seller_logistic_has_configuration | boolean | false | Cho biết người bán đã thiết lập cấu hình logistics của người bán chưa. Nếu đã thiết lập trả về true, ngược lại trả về false hoặc null. |
| logistics_capability | object | Khả năng của một kênh vận chuyển. | |
| seller_logistics | boolean | false | Cho biết đây có phải kênh logistics của người bán hay không. Nếu là kênh logistics của người bán trả về true, ngược lại trả về false. |
| preprint | boolean | false | Cho biết kênh này có hỗ trợ in vận đơn trước hay không. |
| service_type_identifier | string | instant | Tham số này chỉ định loại dịch vụ giao hàng của kênh vận chuyển. Các giá trị có thể: instant, same_day, null. |