Change log

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://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)
• Danh sách coupon:

  • /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 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.