Tính phí vận chuyển

Tính phí cho 1 đơn

  • /api/shipping/fee: Tính năng này dùng để tính phí vận chuyển cho một đơn hàng. Mỗi khi khách hàng vào trang Giỏ hàng, hoặc ở bước thanh toán, website của bạn có thể call API này để tính phí vận chuyển cho đơn hàng và hiển thị chi tiết tổng tiền của đơn hàng bao gồm cả phí vận chuyển và phí thu tiền hộ (nếu khách hàng chọn hình thức thanh toán khi nhận hàng).

Request

Chú ý: API này có 2 tình huống:

  • Nếu các sản phẩm được đồng bộ từ Nhanh.vn sang website của bạn (Nhanh.vn đã có thông tin shippingWeight của các sản phẩm này): website của bạn có thể gửi sang 1 mảng productIds, Nhanh.vn sẽ tự tính toán tổng trọng lượng của đơn hàng này.

  • Website của bạn tự tính tổng trọng lượng shippingWeight của đơn hàng này.

    Nếu bạn có truyền sang các tham số length, width, height: Nhanh.vn sẽ tính toán trọng lượng của đơn hàng theo công thức quy ra kg: A = dài * rộng * cao / 6000 (so sánh số A và shippingWeight tham số nào lớn hơn sẽ lấy theo tham số đó để tính toán cước phí) và trả về kết quả đánh dấu nếu gói hàng thuộc loại hàng cồng kềnh.

Response

  • JSON decode the response to get the structure:

  • data is an array of all supported shipping services

    [
      // service 1
      [
          'carrierId': int // id hãng vận chuyển
          'carrierName': string // tên hãng vận chuyển
          'serviceId': int // id dịch vụ vận chuyển
          'serviceName': string // tên dịch vụ vận chuyển
          'serviceDescription': string // mô tả dịch vụ vận chuyển
          'estimatedDeliveryTime': int // Thời gian dự kiến giao hàng
          'shipFee': int // phí vận chuyển
          'codFee': int // phí thu tiền hộ
          'declaredFee': int // phí bảo hiểm (khi mua dịch vụ khai giá để đền bù trong tình huống hãng vận chuyển làm mất hàng)
          'isBulkyGoods': 1 | 0 // Biến đánh dấu hàng cồng kềnh
      ]
      // service 2
      // ...
    ]

    Chú ý:

    • shipFeeDiscount là phí vận chuyển được chiết khấu, VD shipFee = 25.000, shipFeeDiscount = 7.000 thì shipFee thực tế của đơn hàng này sẽ chỉ = 18.000

    • codFeeDiscount là phí thu tiền hộ được chiết khấu, VD codFee = 15.000, codFeeDiscount = 3.000 thì codFee thực tế của đơn hàng này sẽ chỉ = 12.000

Tính phí cho nhiều đơn

  • /api/shipping/multifee: Tính năng này dùng để tính phí vận chuyển cho nhiều đơn hàng (thường dùng nếu website của bạn là mô hình sàn, cho phép khách mua từ nhiều shop khác nhau). Mỗi khi khách hàng vào trang Giỏ hàng, hoặc ở bước thanh toán, website của bạn có thể call API này để tính phí vận chuyển cho đơn hàng và hiển thị chi tiết tổng tiền của đơn hàng bao gồm cả phí vận chuyển.

    Chú ý: API này dùng cho các sàn thương mại điện tử, giỏ hàng hỗ trợ mua hàng từ nhiều gian hàng, mỗi gian hàng có 1 địa chỉ lấy hàng khác nhau. Nếu website của bạn chỉ hỗ trợ lấy hàng từ 1 địa chỉ, xin vui lòng sử dụng /api/shipping/fee.

Request

  • The structure of data array:

    [
      // Đơn hàng 1
      [
          "fromCityName" => "TP. HCM",
          "fromDistrictName" => "Quận 1",
          "toCityName" => "Hà nội",
          "shippingWeight" => 800,
          "toDistrictName" => "Hoàn Kiếm",
          "codMoney" => 1250000
      ],
      // Đơn hàng 2
      [
          "fromCityName" => "TP. HCM",
          "fromDistrictName" => "Quận 3",
          "toCityName" => "Hà nội",
          "shippingWeight" => 2000, // 2000 gr = 2 kg
          "toDistrictName" => "Hoàn Kiếm",
          "codMoney" => 4950000
      ]
    ]

Chú ý: Hỗ trợ tối đa tính phí cho 10 đơn hàng cùng lúc.

API này có 2 tình huống:

  • Website của bạn tự tính tổng trọng lượng shippingWeight của đơn hàng này.

  • Nếu các sản phẩm được đồng bộ từ Nhanh.vn sang website của bạn (Nhanh.vn đã có thông tin shippingWeight của các sản phẩm này): website của bạn có thể gửi sang 1 mảng productIds, Nhanh.vn sẽ tự tính toán tổng trọng lượng của đơn hàng này.

    Chú ý: nếu bạn có truyền sang các tham số length, width, height: Nhanh.vn sẽ tính toán trọng lượng của đơn hàng theo công thức quy ra kg: A = dài rộng cao / 6000 (so sánh số A và shippingWeight tham số nào lớn hơn sẽ lấy theo tham số đó để tính toán cước phí) và trả về kết quả đánh dấu nếu gói hàng thuộc loại hàng cồng kềnh.

Response

  • The response: JSON decode the response to get the structure:

    [
      // kết quả tính phí cho đơn hàng 1
      [
            "carrierId": int // id hãng vận chuyển
            "carrierName": string // tên hãng vận chuyển
            "serviceId": int // id dịch vụ vận chuyển
            "serviceName": string // tên dịch vụ vận chuyển
            "serviceDescription": string // mô tả dịch vụ vận chuyển
            "estimatedDeliveryTime": int // Thời gian dự kiến giao hàng
            "shipFee": int // phí vận chuyển
            "codFee": int // phí thu tiền hộ
            "declaredFee": int // phí bảo hiểm (khi mua dịch vụ khai giá để đền bù trong tình huống hãng vận chuyển làm mất hàng)
            "isBulkyGoods": 1 | 0 // Biến đánh dấu hàng cồng kềnh
      ],
      // kết quả tính phí cho đơn hàng 2
      [
            "carrierId": int // id hãng vận chuyển
            "carrierName": string // tên hãng vận chuyển
            "serviceId": int // id dịch vụ vận chuyển
            "serviceName": string // tên dịch vụ vận chuyển
            "serviceDescription": string // mô tả dịch vụ vận chuyển
            "estimatedDeliveryTime": int // Thời gian dự kiến giao hàng
            "shipFee": int // phí vận chuyển
            "codFee": int // phí thu tiền hộ
            "declaredFee": int // phí bảo hiểm (khi mua dịch vụ khai giá để đền bù trong tình huống hãng vận chuyển làm mất hàng)
            "isBulkyGoods": 1 | 0 // Biến đánh dấu hàng cồng kềnh
        // ...
      ]
      // kết quả tính phí cho các đơn hàng tiếp theo
    ]

Last updated