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
  • Demo hiển thị lịch trình

Was this helpful?

  1. Order

Lịch sử đơn hàng

PreviousGửi khiếu nại đơn hàngNextNguồn đơn hàng

Last updated 1 year ago

Was this helpful?

  • /api/order/history: Tính năng này dùng để lấy lịch sử thao tác với đơn hàng.

Request

  • Xem các

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

Key
Type
Description

orderId

ID đơn hàng trên Nhanh.vn

type

string

"lognhanh": lấy lịch sự thao tác với đơn hàng từ nhanh. "logcarrier" lấy lịch trình đơn hàng từ hãng vận chuyển. Không truyền thì giá trị mặc định là "lognhanh".

  • Chú ý: Chỉ các đơn đã bắn sang hãng vận chuyển mới có dữ liệu logcarrier. Chỉ các hãng vận chuyển sau có logcarrier (Các hãng chưa có API hỗ trợ sẽ trả về mảng rỗng): + Giao hàng nhanh + Best Express + Shopee Xpress + NinjaVan + Giao hàng tiêu chuẩn + Ahamove + Việt Nam POST + SuperShip

Response

  • JSON decode the response to get the structure:

Key
Type
Description

code

int

1 = success or 0 = failed

messages

array

is an array of error messages if code = 0

data

array

Mảng danh sách lịch sử thao tác của đơn hàng

Không truyền type hoặc type = "lognhanh": 

[
    // history 1
    [
        "step" => string // Hành động,
        "createdBy" => string // Được thao tác bởi ai,
        "createdDateTime" => string // Thời gian thao tác, định dạng yyyy-mm-dd hh:mm:ii
        "oldStatus" => string // Trạng thái trước khi thao tác,
        "newStatus" => string // Trạng thái sau khi thao tác
    ],
    // history 2
    ...
]

Type = "logcarrier":
[
    "carrierLink" => "", // Link của hãng với case Grab / Ahamove
    "lastDelivererMobile" => "*********", // Số điện thoại bưu tá (số gần nhất, vì đơn có thể giao nhiều lần mới thành công)
    "lastDelivererName" => "Vương Quốc Đạt", // Tên bưu tá
    "logs" => [
        //[    
        // timestamp: convert từ datetime sang timestamp
        // step: các bước lịch trình đơn hàng
        // content: nội dung hãng vận chuyển trả về
        // icon: Tạo đơn: fa-plus 
        // 		 Lấy hàng: fa-person-carry-box / hoặc inbox nếu bản cũ chưa có icon
        // 		 Hàng đang chuyển: fa-truck
        // 		 Giao thành công: fa-handshake
        // "delivererPhone" => "*******", số điện thoại bưu tá
        // "driverName" => "*******", tên bưu tá
        //],
        [
            "timestamp" => 1695627527,
            "step" => "Shipping",
            "icon" => "fal fa-truck",
            "content" => "Hàng đang vận chuyển",
            "delivererPhone" => "********",
            "driverName" => "Vương Quốc Đạt"
        ],
        [
            "timestamp" => 1695637887,
            "step" => "Shipping",
            "icon" => "fal fa-truck",
            "content" => "Hàng đang vận chuyển",
            "delivererPhone" => null,
            "driverName" => "Vương Quốc Đạt"
        ]
        // ......
    ]
]

Demo hiển thị lịch trình

  • Ở trang chi tiết đơn hàng, trang danh sách đơn hàng, đã có sẵn chức năng Copy link lịch trình gửi cho khách hàng.

Int

∗^{{\color{red}*}}∗
common request params
Lịch trình vận chuyển