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
  • 2025-05-27
  • 2025-05-14
  • 2025-05-08
  • 2025-04-29
  • 2025-04-14
  • 2025-03-26
  • 2025-03-04
  • 2025-02-20
  • 2024-12-30
  • 2024-12-25
  • 2024-12-15
  • 2024-12-01
  • 2024-11-30
  • 2024-10-23
  • 2024-10-20
  • 2024-10-15
  • 2024-10-03
  • 2024-08-11
  • 2024-08-03
  • 2024-06-17
  • 2024-05-28
  • 2024-04-23
  • 2024-04-22
  • 2024-03-29
  • 2024-03-12
  • 2024-02-06
  • 2023-12-10
  • 2023-10-03
  • 2023-08-14
  • 2023-06-14
  • 2023-05-10
  • 2023-04-06
  • 2023-03-01
  • 2023-01-16
  • 2022-12-07
  • 2022-10-05
  • 2022-09-21
  • 2022-08-01
  • 2022-07-07
  • 2022-06-30
  • 2022-03-28
  • 2022-03-17
  • 2022-03-08
  • 2022-02-28
  • 2022-01-11
  • 2021-12-28

Was this helpful?

Change log

PreviousGiới thiệuNextDanh sách sản phẩm

Last updated 10 days ago

Was this helpful?

2025-05-27

  • : Trả thêm thông tin code, barcode cho sản phẩm trong đơn hàng

2025-05-14

  • : Trả thêm thông tin carrierServiceType, carrierServiceTypeName

2025-05-08

  • : Trả thêm thông tin liên quan tới facebook: adId, postId, psId, conversationId

2025-04-29

  • : Trả thêm giá vốn sản phẩm

2025-04-14

  • : Trả thêm createdById, createdUserName, createdDateTime (thông tin người tạo, thời gian tạo bút toán)

  • : Thêm trạng thái "CustomerConfirming" (Chờ xác nhận)

2025-03-26

2025-03-04

2025-02-20

2024-12-30

2024-12-25

2024-12-15

2024-12-01

2024-11-30

2024-10-23

2024-10-20

2024-10-15

2024-10-03

2024-08-11

2024-08-03

2024-06-17

2024-05-28

2024-04-23

2024-04-22

2024-03-29

  • Link cũ deprecated.

2024-03-12

2024-02-06

  • Tách cài đặt kho lấy tồn cho API ra khỏi cài đặt dùng cho website.

2023-12-10

2023-10-03

2023-08-14

2023-06-14

2023-05-10

2023-04-06

  • Ngừng hỗ trợ request params dạng GET, chỉ hỗ trợ dạng POST từ version 2.0 (Chuẩn bị tắt bản 1.0)

2023-03-01

2023-01-16

2022-12-07

2022-10-05

2022-09-21

    • /api/promotion/coupon?act=addbatch: Tạo chương trình coupon.

    • /api/promotion/coupon?act=increasecode: Cập nhật thêm mã vào chương trình coupon.

2022-08-01

2022-07-07

2022-06-30

2022-03-28

2022-03-17

2022-03-08

  • Request params businessId required: Trước đây request params gửi sang open.nhanh.vn chỉ yêu cầu 4 params: version, appId, accessToken, data nhưng developer hay nhầm lẫn về việc 1 accessToken có thể dùng cho nhiều bussinessId, khiến cho việc POST dữ liệu từ 1 doanh nghiệp A sang 1 doanh nghiệp B, gây sai dữ liệu nghiêm trọng, để tránh tình huống có thể gây ra sai sót này:

    • Từ 2022-01-01: Tài liệu Open API đã sửa lại Request params yêu cầu thêm businessId.

    • Từ 2022-03-07: Thông báo trên hệ thống, và gửi email cho các tài khoản developer về việc Request params bắt buộc cần thêm businessId.

    • Từ 2022-05-10: Developer có 2 tháng (từ 2022-03-07 tới 2022-05-10) để sửa code truyền thêm bussinessId, tới ngày này tất cả các request thiếu businessId sẽ bị báo lỗi.

2022-02-28

2022-01-11

2021-12-28

: Trả thêm transfering (số đang chuyển kho) trong dữ liệu tồn kho (inventory)

: Trả thêm transfering (số đang chuyển kho) trong dữ liệu tồn kho (inventory)

: Trả thêm VATpercent (phần trăm VAT) cho sản phẩm trong phiếu

: Trả thêm depotId (ID kho doanh nghiệp).

: Trả thêm thông tin người đóng gói.

: Cho phép cập nhật Phí ship báo khách (customerShipFee).

: Trả ngày giờ tạo đơn hàng khi thêm mới

: Thêm trạng thái Confirming (Đang xác nhận).

: Thêm danh sách nguồn đơn hàng.

: Thêm externalImages param (Đường dẫn ảnh cho sản phẩm từ CDN khác không thuộc Nhanh.vn)

: Thêm ảnh cho sản phẩm từ CDN khác không thuộc Nhanh.vn

: Trả thêm productMoney trong thông tin sản phẩm của đơn hàng.

: Thêm dataOptions: comboItems trả về danh sách sản phẩm con trong combo.

: Trả thêm order cho thuộc tính

: Trả thêm order cho thuộc tính, typeId, typeName sản phẩm

: Thêm lọc tất cả sản phẩm con (param parentId = -10)

Thêm API:

: Trả thêm updateAt (ngày cập nhật sản phẩm)

: Trả thêm updateAt (ngày cập nhật đơn hàng)

: Thêm oldPrice, description, content

: Trả thêm lịch trình đơn hàng

: Trả thêm lịch trình đơn hàng khi thêm mới, cập nhật đơn hàng

: Respone bổ sung thêm số dư tài khoản sau khi gửi tin và số tin nhắn còn được gửi trong ngày.

: Thay đổi key trả về requiredDateTime, approvedDateTime, realDateTime => requiredAt, approvedAt, comfirmedAt

: Thêm tham số "isPartDelivery" cho phép đơn hàng đánh dấu có giao hàng một phần

: Trả về deliveryDate khi cập nhật đơn hàng

: Đổi request param updatedDateTimeFrom, updatedDateTimeTo => updatedAtFrom, updatedAtTo

: Đổi link lấy accessToken sang link mới https://open.nhanh.vn/api/oauth/access_token

: Thêm API gửi tin Zalo ZNS.

: Thêm API tính phí vận chuyển tự kết nối.

: Thêm request param carrierAccountId, carrierShopId, serviceCode hỗ trợ cho trường hợp đơn hàng có tính phí vận chuyển tự kết nối khi truyền sendCarrierType = 2.

: Thêm lọc ngày cập nhật khách hàng: updatedDateTimeFrom, updatedDateTimeTo. Đổi request param fromLastBoughtDate, toLastBoughtDate => lastBoughtDateFrom, lastBoughtDateTo

: Đổi request param updatedFromDateTime, updatedToDateTime => updatedDateTimeFrom, updatedDateTimeTo

: Đổi request param updatedFromDateTime, updatedToDateTime => updatedDateTimeFrom, updatedDateTimeTo

: trả về facebook fanpageId và adId.

: trả thêm lịch trình hãng vận chuyển.

: Thêm dataOptions: tags trả về danh sách tags của hóa đơn

: Thêm request param updatedFromDateTime và updatedToDateTime để lọc danh sách sản phẩm theo ngày cập nhật mới nhất

: trả về thêm trạng thái danh mục (status)

: trả về thêm options : notApplyWithDiscountPromotion chương trình có cho áp dụng cùng chương trình chiết khấu hay không

: Thêm request param dataOptions để lấy thêm dữ liệu cần thiết, VD: giftProducts để lấy sản phẩm quà tặng

: Thêm request param dataOptions để lấy thêm dữ liệu cần thiết, VD: giftProducts để lấy sản phẩm quà tặng; marketingUtm để lấy thông tin utmSource, utmMedium, utmCampaign

: Response trả về thêm isRequiredInsurance là biến đánh dấu bảng giá có bắt buộc mua bảo hiểm hàng hóa hay không

Thêm API

Thêm API

: Thêm lọc kho hàng

: Thêm tiêu điểm đơn hàng

: Thêm lọc loại khách hàng, trả về thêm mã số thuế, tên công ty, địa chỉ công ty

Thêm API

Thêm API

Thay đổi loại đơn hàng: Thêm 2 loại chuyển hàng mới, bỏ loại chuyển hàng shippingType (trước đó là 1 mục nhỏ bên trong loại đơn Chuyển hàng), chi tiết xin đọc thông báo .

: Thêm thông tin moneyTransferAccountId (Tài khoản nhận tiền chuyển khoản - Áp dụng với doanh nghiệp sử dụng kế toán)

:

: /api/product/imei: Tìm theo ID cửa hàng

: /api/order/index: Tìm theo ngày cập nhật đơn hàng

: /api/store/depot: thêm số điện thoại kho hàng

: /api/website/addsubscriber: Thêm mới subscriber

: /api/website/addcontact: Thêm mới liên hệ

: /api/product/search: Tìm theo sản phẩm được đánh dấu (showHot: Sản phẩm hot showNew: Sản phẩm mới showHome: Sản phẩm trên trang chủ,giá trị truyền lên 1 | 0)

, : Nếu bạn truyền param customerId hoặc customerMobile thì sẽ không bị giới hạn lấy dữ liệu trong khoảng 10 ngày.

: /api/promotion/coupon?act=products trả về danh sách sản phẩm được áp dụng coupon(ID sản phẩm).

: /api/product/imeisold thêm productPrice: Giá sản phẩm.

: /api/order/add thêm privateDescription: ghi chú chăm sóc khách hàng.

: /api/product/gift thêm promotionFromDate, promotionToDate, promotionStatus, promotionDepotIds.

: Giới hạn khoảng ngày chỉ hỗ trợ lấy dữ liệu trong 10 ngày. Nếu bạn không truyền param fromDate và toDate, mặc định sẽ lấy 10 ngày gần nhất. Nếu bạn muốn lấy dữ liệu các ngày cũ hơn, xin vui lòng truyền fromDate và toDate trong khoảng 10 ngày (VD: 2021-09-01 => 2021-09-10, 2021-09-11 => 2021-09-20)

: thêm webhooks cho đơn từ các sàn TMĐT (Lazada, Shopee, Tiki, Sendo...).

: /api/order/update thêm orderId giúp cập nhật đơn hàng theo ID trên Nhanh.vn.

Webhooks đơn hàng
Danh sách đơn hàng
Danh sách đơn hàng
Danh sách đơn hàng
Danh sách bút toán
Thêm đơn hàng
Danh sách sản phẩm
Chi tiết sản phẩm
Phiếu xuất nhập kho
Danh sách bút toán
Danh sách đơn hàng
Cập nhật đơn hàng
Webhooks đơn hàng
Thêm đơn hàng
Danh sách nguồn đơn hàng
Thêm sản phẩm
Thêm ảnh sản phẩm
Danh sách đơn hàng
Danh sách đơn hàng
Danh sách sản phẩm
Chi tiết sản phẩm
Danh sách sản phẩm
Danh sách gian hàng sàn TMĐT
Danh sách sản phẩm
Danh sách đơn hàng
Thêm sản phẩm
Thêm đơn hàng
Webhooks đơn hàng
Gửi tin Zalo ZNS
Sản phẩm xuất nhập kho nháp
Thêm đơn hàng
Danh sách khách hàng
Lấy accessToken
Gửi tin Zalo ZNS
Tính phí vận chuyển
Thêm đơn hàng
Danh sách khách hàng
Danh sách đơn hàng
Danh sách sản phẩm
Danh sách đơn hàng
Lịch sử đơn hàng
Bán lẻ
Danh sách sản phẩm
Danh mục
Coupon
Phiếu xuất nhập kho
Danh sách đơn hàng
Tính phí vận chuyển
Danh sách công nợ khách hàng
Danh sách hạn sử dụng sản phẩm
Phiếu xuất nhập kho
Thêm đơn hàng
Danh sách khách hàng
Danh sách bút toán
Danh mục nội bộ
tại đây
Cập nhật đơn hàng
Danh sách coupon
Danh sách IMEI
Danh sách đơn hàng
Danh sách kho hàng
Thêm mới subscriber
Thêm mới liên hệ
Danh sách sản phẩm
Danh sách đơn hàng
Phiếu xuất nhập kho
Danh sách coupon
Tra cứu IMEI bán ra theo ngày
Thêm đơn hàng
Quà tặng sản phẩm
Danh sách sản phẩm xuất nhập kho nháp
Webhooks đơn hàng
Đơn hàng
Webhooks đơn hàng