Nhanh.vn Open API
Trang chủHướng dẫn sử dụngApps
v2
v2
  • Giới thiệu
  • Change log
  • Product
    • Danh sách sản phẩm
    • Thêm sản phẩm
    • Chi tiết sản phẩm
    • Danh mục sản phẩm
    • Danh mục nội bộ
    • Quà tặng sản phẩm
    • Danh sách IMEI
    • Tra cứu IMEI bán ra theo ngày
    • Lịch sử IMEI
    • Hạn sử dụng sản phẩm
    • Thêm ảnh sản phẩm
  • Order
    • Danh sách đơn hàng
    • Thêm đơn hàng
    • Cập nhật đơn hàng
    • Gửi khiếu nại đơn hàng
    • Lịch sử đơn hàng
    • Nguồn đơn hàng
  • Shipping
    • Hãng vận chuyển
    • Thành phố, quận huyện
    • Tính phí vận chuyển
  • Bill
    • Phiếu xuất nhập kho
    • Sản phẩm xuất nhập kho
    • Sản phẩm xuất nhập kho nháp
  • Customer
    • Danh sách khách hàng
    • Thêm khách hàng
  • Website
    • Tin tức
    • Danh mục tin tức
    • Thêm subscriber
    • Thêm liên hệ
  • Supplier
    • Nhà cung cấp
  • Promotion
    • Danh sách coupon
  • Store
    • Kho hàng
    • Nhân viên
  • Accounting
    • Bút toán
    • Công nợ khách hàng
  • Zalo
    • Gửi tin Zalo ZNS
  • Ecommerce
    • Danh sách gian hàng
  • Webhooks
    • Giới thiệu
    • Đơn hàng
    • Sản phẩm
    • Tồn kho
Powered by GitBook
On this page
  • Request
  • Response

Was this helpful?

  1. Shipping

Thành phố, quận huyện

PreviousHãng vận chuyểnNextTính phí vận chuyển

Last updated 1 year ago

Was this helpful?

  • /api/shipping/location: Lấy danh sách thành phố, quận huyện từ Nhanh.vn.

  • Các API , sẽ cần sử dụng đến các dữ liệu này.

  • Chú ý: Dữ liệu thành phố, quận huyện rất ít khi bị thay đổi (chỉ xảy ra khi có thay đổi tên, chia tách hoặc gộp 1 vài thành phố, quận huyện), bạn có thể cache dữ liệu trên hệ thống của bạn để giảm tải việc phải gọi API liên tục, thời gian cache khuyến cáo là 24h.

Request

  • Xem các

  • Các key của mảng data array dùng để tạo data json string:

Key
Type
Description

type

string

CITY/DISTRICT/WARD (mặc định là CITY)

parentId

int

Nếu type = DISTRICT thì parentId = id của thành phố cần lấy ra danh sách quận huyện. Nếu type = WARD thì parentId = id của quận huyện cần lấy ra.

Response

  • JSON decode the response to get the structure:

Key
Type
Description

code

int

1 = success or 0 = failed

messages

[ ]

is an array of error messages if code = 0

data

[ ]

Mảng danh sách thành phố hoặc quận huyện

  • Nếu type = CITY

data = [
    [
      "id": 2, // int
      "name":  "Hà Nội" // string
    ],
    [
      "id": 3,
      "name":  "Hồ Chí Minh"
    ],
    ...
]
  • Nếu type = DISTRICT

data = [
    [
      "id" => 2, // int
      "parentId" => 2, // int
      "name" => "Quận Hoàn Kiếm" // string
    ],
    [
      "id" => 6,
      "cityLocationId" => 2,
      "name" => "Quận Hai Bà Trưng"
    ],
    ...
]
  • Nếu type = WARD

data = [
    [
      "id" => 2, // int
      "parentId" => 3, // int
      "name" => "Phường Bạch Đằng" // string
    ],
    [
      "id" => 6,
      "parentId" => 3,
      "name" => "Phường Bách Khoa"
    ],
    ...
]
thêm đơn hàng
tính phí vận chuyển
common request params