Change log
2025-07-31
Danh sách đơn hàng: Trả thêm thông tin VAT đơn hàng.
2025-07-15
Webhooks đơn hàng: Trả thêm thông tin moneyTransfer, paymentCode ở webhook cập nhật đơn hàng.
Thông báo thay đổi domain Open API (Để chuẩn bị ra mắt v3.0):
Trước đây tên miền cũ để gọi Open API là: open.nhanh.vn
Từ ngày 17/04/2025, hệ thống có tên miền mới là pos.open.nhanh.vn. Bạn chỉ cần đổi tên miền, mọi Request params vẫn như cũ, không có thay đổi gì.
Xem chi tiết thông báo: https://nhanh.vn/thong-bao-thay-doi-domain-open-api-an895.html.
2025-05-27
Webhooks đơn hàng: Trả thêm thông tin code, barcode cho sản phẩm trong đơn hàng
2025-05-14
Danh sách đơn hàng: Trả thêm thông tin carrierServiceType, carrierServiceTypeName
2025-05-08
Danh sách đơn hàng: Trả thêm thông tin liên quan tới facebook: adId, postId, psId, conversationId
2025-04-29
Danh sách đơn hàng: Trả thêm giá vốn sản phẩm
2025-04-14
Danh sách bút toán: Trả thêm createdById, createdUserName, createdDateTime (thông tin người tạo, thời gian tạo bút toán)
Thêm đơn hàng: Thêm trạng thái "CustomerConfirming" (Chờ xác nhận)
2025-03-26
Danh sách sản phẩm: Trả thêm transfering (số đang chuyển kho) trong dữ liệu tồn kho (inventory)
Chi tiết sản phẩm: Trả thêm transfering (số đang chuyển kho) trong dữ liệu tồn kho (inventory)
Phiếu xuất nhập kho: Trả thêm VATpercent (phần trăm VAT) cho sản phẩm trong phiếu
2025-03-04
Danh sách bút toán: Trả thêm depotId (ID kho doanh nghiệp).
2025-02-20
Danh sách đơn hàng: Trả thêm thông tin người đóng gói.
2024-12-30
Cập nhật đơn hàng: Cho phép cập nhật Phí ship báo khách (customerShipFee).
2024-12-25
Webhooks đơn hàng: Trả ngày giờ tạo đơn hàng khi thêm mới
2024-12-15
Thêm đơn hàng: Thêm trạng thái Confirming (Đang xác nhận).
2024-12-01
Danh sách nguồn đơn hàng: Thêm danh sách nguồn đơn hàng.
Thêm sản phẩm: 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 sản phẩm: Thêm ảnh cho sản phẩm từ CDN khác không thuộc Nhanh.vn
2024-11-30
Danh sách đơn hàng: Trả thêm productMoney trong thông tin sản phẩm của đơn hàng.
2024-10-23
Danh sách đơn hàng: Thêm dataOptions: comboItems trả về danh sách sản phẩm con trong combo.
Danh sách sản phẩm: Trả thêm order cho thuộc tính
Chi tiết sản phẩm: Trả thêm order cho thuộc tính, typeId, typeName sản phẩm
2024-10-20
Danh sách sản phẩm: Thêm lọc tất cả sản phẩm con (param parentId = -10)
2024-10-15
Thêm API: Danh sách gian hàng sàn TMĐT
Danh sách sản phẩm: Trả thêm updateAt (ngày cập nhật sản phẩm)
Danh sách đơn hàng: Trả thêm updateAt (ngày cập nhật đơn hàng)
2024-10-03
Thêm sản phẩm: Thêm oldPrice, description, content
2024-08-11
Thêm đơn hàng: Trả thêm lịch trình đơn hàng
Webhooks đơ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
2024-08-03
Gửi tin Zalo ZNS: 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.
2024-06-17
Sản phẩm xuất nhập kho nháp: Thay đổi key trả về requiredDateTime, approvedDateTime, realDateTime => requiredAt, approvedAt, comfirmedAt
2024-05-28
Thêm đơn hàng: Thêm tham số "isPartDelivery" cho phép đơn hàng đánh dấu có giao hàng một phần
2024-04-23
Webhooks đơn hàng: Trả về deliveryDate khi cập nhật đơn hàng
2024-04-22
Danh sách khách hàng: Đổi request param updatedDateTimeFrom, updatedDateTimeTo => updatedAtFrom, updatedAtTo
2024-03-29
Lấy accessToken: Đổi link lấy accessToken sang link mới https://pos.open.nhanh.vn/api/oauth/access_token
Link cũ deprecated.
2024-03-12
Gửi tin Zalo ZNS: Thêm API gửi tin Zalo ZNS.
2024-02-06
Tính phí vận chuyển: Thêm API tính phí vận chuyển tự kết nối.
Thêm đơn hàng: 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.
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
Danh sách khách hàng: Thêm lọc ngày cập nhật khách hàng: updatedDateTimeFrom, updatedDateTimeTo. Đổi request param fromLastBoughtDate, toLastBoughtDate => lastBoughtDateFrom, lastBoughtDateTo
Danh sách đơn hàng: Đổi request param updatedFromDateTime, updatedToDateTime => updatedDateTimeFrom, updatedDateTimeTo
Danh sách sản phẩm: Đổi request param updatedFromDateTime, updatedToDateTime => updatedDateTimeFrom, updatedDateTimeTo
2023-10-03
Danh sách đơn hàng: trả về facebook fanpageId và adId.
Lịch sử đơn hàng: trả thêm lịch trình hãng vận chuyển.
2023-08-14
Bán lẻ: Thêm dataOptions: tags trả về danh sách tags của hóa đơn
2023-06-14
Danh sách sản phẩm: 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
2023-05-10
Danh mục: trả về thêm trạng thái danh mục (status)
Coupon: 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
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)
Phiếu xuất nhập kho: 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
2023-03-01
Danh sách đơn hà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
2023-01-16
Tính phí vận chuyển: 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
2022-12-07
Thêm API Danh sách công nợ khách hàng
Thêm API Danh sách hạn sử dụng sản phẩm
Phiếu xuất nhập kho: Thêm lọc kho hàng
Thêm đơn hàng: Thêm tiêu điểm đơn hàng
Danh sách khách 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
2022-10-05
Thêm API Danh sách bút toán
Thêm API Danh mục nội bộ
2022-09-21
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 tại đây.
Cập nhật đơn hàng: 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/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
Danh sách IMEI: /api/product/imei: Tìm theo ID cửa hàng
2022-07-07
Danh sách đơn hàng: /api/order/index: Tìm theo ngày cập nhật đơn hàng
2022-06-30
Danh sách kho hàng: /api/store/depot: thêm số điện thoại kho hàng
Thêm mới subscriber: /api/website/addsubscriber: Thêm mới subscriber
Thêm mới liên hệ: /api/website/addcontact: Thêm mới liên hệ
2022-03-28
Danh sách sản phẩm: /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)
2022-03-17
Danh sách đơn hàng, Phiếu xuất nhập kho: 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.
Danh sách coupon: /api/promotion/coupon?act=products trả về danh sách sản phẩm được áp dụng coupon(ID sản phẩm).
2022-03-08
Request params businessId required: Trước đây request params gửi sang pos.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
Tra cứu IMEI bán ra theo ngày: /api/product/imeisold thêm productPrice: Giá sản phẩm.
Thêm đơn hàng: /api/order/add thêm privateDescription: ghi chú chăm sóc khách hàng.
2022-01-11
Quà tặng sản phẩm: /api/product/gift thêm promotionFromDate, promotionToDate, promotionStatus, promotionDepotIds.
2021-12-28
Danh sách sản phẩm xuất nhập kho nháp: 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)
Webhooks đơn hàng: thêm webhooks cho đơn từ các sàn TMĐT (Lazada, Shopee, Tiki, Sendo...).
Đơn hàng: /api/order/update thêm orderId giúp cập nhật đơn hàng theo ID trên Nhanh.vn.
Last updated
Was this helpful?