Nhanh.vn Open API
Trang chủHướng dẫn sử dụngApps
v1
v1
  • Giới thiệu
  • Get data from Nhanh.vn
    • Lấy hãng vận chuyển
    • Lấy danh sách thành phố, quận huyện
    • Tính phí vận chuyển
    • Lấy danh sách đơn hàng
    • Lấy danh sách lịch sử đơn hàng
    • Lấy danh mục sản phẩm
    • Lấy danh sách sản phẩm
    • Lấy thông tin chi tiết sản phẩm
    • Lấy danh sách quà tặng sản phẩm
    • Lấy danh sách IMEI
    • Tra cứu IMEI bán ra theo ngày
    • Lấy danh sách khách hàng
    • Lấy danh mục tin tức
    • Lấy danh sách tin tức
    • Lấy danh sách nhà cung cấp
    • Lấy danh sách phiếu xuất nhập kho
    • Lấy danh sách sản phẩm xuất nhập kho
    • Lấy danh sách sản phẩm xuất nhập kho nháp
    • Lấy danh sách kho doanh nghiệp
    • Lấy danh sách coupon
    • Lấy danh sách nhân viên
    • Lấy danh sách bảo hành
    • Nhúng khung đặt hàng Nhanh
    • Tích hợp-elastix
  • Send data to Nhanh.vn
    • Tạo gian hàng
    • Thêm sản phẩm
    • Thêm đơn hàng
    • Cập nhật đơn hàng
    • Gửi khiếu nại đơn hàng
    • Thêm khách hàng
    • Cấu hình webhooks
  • Listen webhooks from Nhanh.vn
    • Nhận cập nhật trạng thái đơn hàng
    • Nhận cập nhật sản phẩm
    • Nhận cập nhật tồn kho
    • Nhận cập nhật thay đổi cấp độ, thêm điểm, trừ điểm
    • Nhận cập nhật hóa đơn mới
    • Nhận cập nhật khiếu nại
Powered by GitBook
On this page
  • Request
  • Response

Was this helpful?

  1. Send data to Nhanh.vn

Cập nhật đơn hàng

PreviousThêm đơn hàngNextGửi khiếu nại đơn hàng

Last updated 1 year ago

Was this helpful?

  • /api/order/update: Tính năng này dùng để cập nhật thông tin đơn hàng khi khách hàng thực hiện việc chuyển khoản online (Khi website của bạn nhận được cập nhật từ cổng thanh toán, website của bạn sẽ gửi thông tin này sang Nhanh.vn) hoặc khi khách hàng hủy đơn hàng. Hoặc dùng trong tình huống website của bạn muốn gửi đơn hàng qua các hãng vận chuyển.

Request

  • See

  • The data structure of an order:

Key
Type
Required
Description

id

string(20)

Yes

id đơn hàng trên website của bạn

autoSend

int

No

Biến đánh dấu gửi luôn đơn hàng sang hãng vận chuyển (Dùng trong tình huống bạn có hệ thống xác nhận đơn hàng từ trước, chỉ dùng Nhanh để hỗ trợ vận chuyển). Set value = 1 để gửi đơn hàng sang hãng vận chuyển. Nếu gửi thành công hệ thống sẽ trả về carrierCode (mã vận đơn)

moneyTransfer

int

No

Số tiền khách đã chuyển khoản

paymentCode

string(255)

No

Mã giao dịch thanh toán

paymentGateway

string(255)

No

Tên của cổng thanh toán

status

string

No

Trạng thái đơn hàng, có thể là: - Success // Thành công - Confirmed // Đã xác nhận - Canceled // Khách huỷ(chỉ đổi được sang trạng thái Khách hủy khi đơn hàng đang ở trạng thái Mới, Đang xác nhận, Đã xác nhận) - Aborted // Hệ thống hủy (chỉ đổi được sang trạng thái Hệ thống hủy khi đơn hàng đang ở trạng thái Mới, Đang xác nhận, Đã xác nhận)

description

string

No

Mô tả lý do hủy đơn hàng

Response

{
    "code": 1, // 1 is success, 0 is error
    "messages": [ ], // error messages if code is 0
    "data": [
        "orderId": 125123098, // int ID đơn hàng trên Nhanh.vn
        "status": "Shipping", // trạng thái hiện tại của đơn hàng
        "shipFee": 30000, // int: Phí vận chuyển
        "codFee": 13000, // int: Phí thu tiền hộ
        "shipFeeDiscount": 0, // int: Phí vận chuyển được giảm giá
        "codFeeDiscount": 0 // int: Phí thu tiền hộ được giảm giá
        "carrierCode": string // Mã vận đơn, Nếu gửi đơn hàng thành công sang hãng vận chuyển hệ thống sẽ trả về carrierCode (mã vận đơn)
    ]
}

Chú ý:

  • shipFee và codFee dùng trong tình huống đơn hàng có sử dụng dịch vụ vận chuyển, thông tin đơn hàng gửi sang có kèm theo carrierId, carrierServiceId và weight.

  • 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

common request params