# Nâng cấp lên v3.0

* Các chú ý khi chuyển từ **v2.0** lên **v3.0**.

## Các thay đổi

### App

* Cài đặt app sẽ có thêm 1 mục webhooks version: Bạn có thể chọn nhận webhooks v2 hoặc v3.

### Access Token

* Các accessToken và quyền đã được cấp ở v2 sẽ vẫn được dùng cho v3 Alpha. Bản chính thức có thể sẽ tách hoàn toàn accessToken 2 bản v2.0, v3.0.

### Request

* Khác với v2.0 dùng Body form-data, v3.0 dùng Body raw. Xem cách tạo [request params v3.0](https://apidocs.nhanh.vn/v3#request-params).
* v3.0 đã hỗ trợ mở CORS, không còn chặn gọi bằng Javascript như v2.0

### Response

* API v3.0 đã thay đổi hoàn toàn cấu trúc dữ liệu response data.
  * Xem Response chung [tại đây](https://apidocs.nhanh.vn/v3#response).
  * Bạn chú ý đọc kỹ tài liệu ở từng API sẽ có thể có thêm các data response riêng.

## Các API có thay đổi

### Thay đổi chung

* Thay đổi về [Paginator](https://apidocs.nhanh.vn/v3#paginator) giúp hỗ trợ nhiều điều kiện sort hơn.
* 1 số API trước đó có giới hạn 10 ngày, nay sẽ tăng lên 31 ngày để bạn dễ dàng lấy được dữ liệu theo từng tháng.
* Khi Nhanh bắn webhooks cho app, cấu trúc dữ liệu sẽ tương tự như khi gọi API, giúp giảm việc gọi API để lấy thêm thông tin. VD:
  * Webhooks đơn hàng mới, sẽ có cấu trúc giống với 1 đơn hàng trong mảng khi gọi API lấy danh sách đơn hàng.
  * Webhooks sản phẩm mới, sẽ có cấu trúc giống với 1 sản phẩm trong mảng khi gọi API lấy danh sách sản phẩm.

### Order Add

* v2: hỗ trợ truyền id (là productId của web / app) và idNhanh (id sản phẩm trên Nhanh).
* v3: bỏ id (productId của web / app), chỉ sử dụng id sản phẩm trên Nhanh.

## Các API mới

* Dự kiến API v3 sẽ hỗ trợ thêm các mục sau:

### POS

* Sản phẩm:
  * Danh sách sản phẩm đã xóa.
* Bán hàng:
  * Thêm hóa đơn bán lẻ, bán sỉ
  * Lấy danh sách hóa đơn đã bị xóa
* Đơn hàng:
  * Lấy danh sách đơn hàng đã bị xóa
* Kho hàng: Thêm 1 số loại phiếu xuất nhập kho
* Khuyến mại:
  * Tặng điểm, trừ điểm khách hàng
  * Tặng coupon
* Webhooks:

### Vpage

* v3.0 đã mở API cho [Vpage.nhanh.vn](https://vpage.nhanh.vn).
* Xem API của Vpage [tại đây](https://apidocs.nhanh.vn/v3/vpage/conversation/conversation_list).

## Các Webhooks mới

* Đang cập nhật.