# KiotViet

KiotViet Public API được phát triển nhằm hỗ trợ tích hợp, trao đổi dữ liệu giữa KiotViet với các website, sàn thương mại điện tử, nền tảng CRM... KiotViet Public API cung cấp cơ chế đọc ghi các đối tượng: Sản phẩm, khách hàng, hóa đơn, phụ phí,. .. Trên trang này, bạn sẽ tìm thấy danh sách các hoạt động mà node KiotViet hỗ trợ và liên kết đến nhiều tài nguyên hơn.

## Basic Operations

1. Product
   * Lấy Chi Tiết Hàng Hóa
   * Thêm Mới Hàng Hóa
   * Cập Nhật Hàng Hóa
   * Xóa Hàng Hóa
   * Danh Sách Hàng Hóa
   * Thêm Mới Danh Sách Hàng Hóa
   * Cập Nhật Danh Sách Hàng Hóa
   * Lấy Danh Sách Hàng Hóa Tồn Kho
2. Customer
   * Lấy Chi Tiết Khách Hàng
   * Thêm Mới Khách Hàng
   * Cập Nhật Khách Hàng
   * Xóa Khách Hàng
   * Lấy Danh Sách Khách Hàng
3. Order Product
   * Lấy Chi Tiết Đặt Hàng
   * Thêm Mới Đặt Hàng
   * Cập Nhật Đặt Hàng
   * Xóa Đặt Hàng
   * Lấy Danh Sách Đặt Hàng
4. Cash Flow
   * Danh Sách Sổ Quỷ
5. Commodity Group
   * Lấy Chi Tiết Nhóm Hàng
   * Thêm Mới Nhóm Hàng
   * Cập Nhật Nhóm Hàng
   * Xóa Nhóm Hàng
   * Lấy Danh Sách Nhóm Hàng
6. Surcharge
   * Thêm Mới Thu Khác
   * Cập Nhật Thu Khác
   * Ngừng Hoạt Động Thu Khác
   * Lấy Danh Sách Thu Khác
7. Invoice
   * Lấy Chi Tiết Hóa Đơn
   * Thêm Hóa Đơn Mới
   * Cập Nhật Hóa Đơn
   * Xóa Hóa Đơn
   * Lấy Danh Sách Hóa Đơn
8. Sale Channel
   * Lấy Danh Sách Kênh Bán Hàng
9. Price Books
   * Lấy Chi Tiết Bảng Giá
   * Cập Nhật Chi Tiết Bảng Giá
   * Lấy Danh Sách Bảng Giá
10. Group
    * Lấy Danh Sách Nhóm Khách Hàng
11. Purchase Order
    * Lấy Chi Tiết Nhập Hàng
    * Thêm Mới Nhập hàng
    * Cập Nhật Nhập Hàng
    * Xóa Nhập Hàng
    * Lấy Danh Sách Nhập Hàng
12. Return Product
    * Lấy Danh Sách Trả Hàng
    * Lấy Chi Tiết Phiếu Trả Hàng
13. Setting
    * Lấy Danh Sách Thiết Lập Cửa Hàng
14. Transfers
    * Thêm Mới Chuyển Hàng
    * Cập Nhật Chuyển Hàng
    * Xóa Chuyển Hàng
    * Lấy Chi Tiết Chuyển Hàng
    * Lấy Danh Sách Chuyển Hàng
15. Order Supplier&#x20;
    * Lấy Danh Sách Đặt Hàng Nhập
    * Lấy Chi Tiết Đặt Hàng Nhâh
16. Webhook
    * Đăng Ký Webhook
    * Hủy Đăng Ký Webhook
    * Danh Sách Webhook
    * Chi Tiết Webhook
17. Coupon
    * Cập Nhật Trạng Thái Coupon
18. Branches
    * Lấy Danh Sách Chi Nhánh

## Cách sử dụng

Quy trình sử dụng ví dụ này sẽ sử dụng các nút sau. - Start - KiotViet

<figure><img src="/files/bMTbR7qzCeNaI5Kg9Wlc" alt=""><figcaption><p>Workflow</p></figcaption></figure>

### 1. Start node

* Start node tồn tại theo mặc định khi bạn tạo một workflow mới.

### 2. KiotViet node (Append)

* Nhấn vào nút Click on the Add node or drag to connect và nhập KiotViet trong search nodes box
* Để sử dụng node này bạn phải tạo credential. (Hướng dẫn có tại [KiotViet credentail](/kiotviet-credential.md))

### Lấy Chi Tiết Hàng Hóa

* Chọn Resource là **Product** và Operation là **Lấy Chi Tiết Hàng Hóa**
* Chọn loại tìm kiếm phù hợp (code hoặc ID sản phẩm) và sao đó nhập code hoặc ID sản phẩm. Sau đó nhấn **Execute node**

<figure><img src="/files/dGqaNAy5MBlftsINTuAJ" alt=""><figcaption><p>Nhập dữ liệu</p></figcaption></figure>

* Sau khi hoàn thành kết quả sẽ được hiển thị bên phải

<figure><img src="/files/0mVxBAP3rpdTDnb4tnCl" alt=""><figcaption><p>Lấy chi tiết sản phẩm thành công</p></figcaption></figure>

### Thêm Mới Hàng Hóa

* Chọn Resource là **Product** và Operation là **Thêm Mới Hàng Hóa**
* Nhập các thông tin cần thiết được yêu cầu của sản phẩm&#x20;

<figure><img src="/files/ldHkg6PnXY6t5cWPdaXO" alt=""><figcaption><p>Nhập thông tin</p></figcaption></figure>

* **Lưu ý:** Hiện tại KiotViet không hỗ trợ cập nhật thông tin cho sản phẩm serial nên vui lòng bỏ chọn **Is Product Serial**
* Sau khi hoàn thành nhập dữ liệu thì nhấn nút **Execute node** để hoàn thành thêm sản phẩm mới

<figure><img src="/files/zVCMWHJguaBvAb0sTRpr" alt=""><figcaption><p>Hoàn thành thêm mới sản phẩm</p></figcaption></figure>

### Cập Nhật Hàng Hóa

* Chọn Resource là **Product** và Operation là **Cập Nhật Hàng Hóa**
* Nhập dữ liệu cần được cập nhật&#x20;

<figure><img src="/files/BidkMQkXPU5vGgQTOFUR" alt=""><figcaption><p>Nhập dữ liệu mới</p></figcaption></figure>

* Sau khi hoàn tất nhập dữ liệu mới thì nhấn nút **Execute node** để chạy workflow

<figure><img src="/files/G3t8zhLQPEGLmeap97Tm" alt=""><figcaption><p>Cập nhật dữ liệu hàng hóa thành công</p></figcaption></figure>

### Danh Sách Hàng Hóa

* Chọn Resource là **Product** và Operation là **Danh Sách Hàng Hóa**
* Điền trường bạn cần sắp xếp (Ví dụ: Sắp xếp theo id hoặc name), chọn tăng dần hoặc giảm dần và chọn thêm các trường để lọc dữ liệu

<figure><img src="/files/OFgKtYnxB0bQYIoMQbHV" alt=""><figcaption><p>Lấy danh sách sản phẩm</p></figcaption></figure>

* **Lưu ý:** Đối với Current Item hoạt động theo cách sau. Nếu bạn lấy 20 sản phẩm và Current Item bằng 1 thì danh sách sẽ lấy sản phẩm từ số 1 đến số 20 nên nếu muốn lấy 20 sản phẩm đầu bạn cần nhập 0. Tương tự nếu sau khi đã lấy 20 sản phẩm và bạn muốn lấy 20 sản phẩm tiếp theo bạn phải nhập 20 thì sẽ lấy từ sản phẩm 20 đến 29.
* Sau khi hoàn tất nhập dữ liệu mới thì nhấn nút **Execute node** để chạy workflow

<figure><img src="/files/XmKMow1FHV8LCqsoSv42" alt=""><figcaption><p>Lấy danh sách sản phẩm thành công</p></figcaption></figure>

### Xóa Hàng Hóa

* Chọn Resource là **Product** và Operation là **Xóa Hàng Hóa**
* Nhập ID sản phẩm cần xóa

<figure><img src="/files/zJ7gSRaWRBgoRhUOMzU1" alt=""><figcaption><p>Nhập ID sản phẩm</p></figcaption></figure>

* Sau đó nhấn **Execute node** để chạy workflow

<figure><img src="/files/3a57jbxGsZaIYOgRqKig" alt=""><figcaption><p>Xóa dữ liệu thành công</p></figcaption></figure>

### Thêm Mới Danh Sách Hàng Hóa

* Chọn Resource là **Product** và Operation là **Thêm Mới Danh Sách Hàng Hóa**
* Chọn **Add Product** để thêm một sản phẩm cần thêm

<figure><img src="/files/wZus4LWE79iulKqG7vYM" alt=""><figcaption><p>Thêm trường để tạo hàng hóa mới</p></figcaption></figure>

* Sau khi đã nhấn vào nút Add Product thì sẽ hiện ra các trường tương tự như [Thêm Mới Hàng Hóa](#them-hang-hoa-moi)
* Nhập các trường cần thiết và sau đó nhấn nút **Execute node** để chạy workflow

<figure><img src="/files/H1L0OAvvF0SJXp5LUnJm" alt=""><figcaption><p>Thêm mới danh sách thành công</p></figcaption></figure>

### Cập Nhật Danh Sách hàng Hóa

* Chọn Resource là **Product** và Operation là **Cập Nhật Danh Sách Hàng Hóa**
* Chọn **Add Product** để thêm một sản phẩm cần thêm

<figure><img src="/files/DxGiWY3xRqt2PnMcbpYF" alt=""><figcaption><p>Thêm trường để cập nhật hàng hóa</p></figcaption></figure>

* Sau khi nhấn nút **Add Product** thì sẽ hiện ra các trường tương tự như [Cập Nhật Hàng Hóa](#cap-nhat-hang-hoa)
* Nhập các trường cần cập nhật sau đó nhấn nút **Execute node** để chạy workflow

<figure><img src="/files/fDWD4kFRjx78mA1OnN8u" alt=""><figcaption><p>Cập nhật danh sách hàng hóa thành công</p></figcaption></figure>

### Lấy Hàng Tôn Kho

* Chọn Resource là **Product** và Operation là **Lấy Hàng Tồn Kho**
* Nhập thuộc tính cần được sắp xếp vào trường **Order By** và thứ tự sắp xếp ở trường **Order Direction.** Ngoài ra còn có thể chọn các thuộc tính khác để lọc như: Chi nhánh, thời gian cập nhật

<figure><img src="/files/D4oRb9HaRhNf9F9TZ1GB" alt=""><figcaption><p>Nhập thông tin tìm kiếm</p></figcaption></figure>

* **Lưu ý:** Mục Current Item có lưu ý giống lưu ý của [Danh Sách Hàng Hóa](#danh-sach-hang-hoa)
* Sau khi hoàn tất nhập, nhấn nút **Execute node** để chạy work flow

<figure><img src="/files/iktyxZ5RCnfK9oBMOb5x" alt=""><figcaption><p>Lấy thông tin tồn kho thành công</p></figcaption></figure>

### Thêm Mới Khách Hàng

* Chọn Resource là **Customer** và Operation là **Thêm Mới Khách Hàng**
* Điền các thông tin cần thiết để tạo khách hàng mới

<figure><img src="/files/MB2ODPf6QTNlNGD8loq5" alt=""><figcaption><p>Điền thông tin khách hàng</p></figcaption></figure>

* Sau khi nhập dữ liệu thành công, nhấn **Execute node** để chạy workflow&#x20;

<figure><img src="/files/HFe7JNysjZTW03XJ4pno" alt=""><figcaption><p>Thêm khách hàng mới thành công</p></figcaption></figure>

### Lấy Chi Tiết Khách Hàng

* Chọn Resource là **Customer** và Operation là **Lấy Chi Tiết Khách Hàng**
* Chọn loại tìm kiếm khách hàng (theo ID hoặc Code khách hàng) sau đó nhập ID hoặc Code khách hàng

<figure><img src="/files/2s9QuLqZ6UAX129WT2xr" alt=""><figcaption><p>Điền ID hoặc Code khách hàng</p></figcaption></figure>

* Sau khi nhập ID hoặc Code thì nhấn Execute node để chạy workflow&#x20;

<figure><img src="/files/manT8rSeqmsotwiVgO5K" alt=""><figcaption><p>Lấy chi tiết khách hàng thành công</p></figcaption></figure>

### Cập Nhật Khách Hàng

* Chọn Resource là **Customer** và Operation là **Cập Nhật Khách Hàng**
* Điền các trường cần thiết để cập nhật thông tin khách hàng

<figure><img src="/files/ItTiN0BfMmvRLAJSX8ZE" alt=""><figcaption><p>Nhập thông tin khách hàng cần cập nhật</p></figcaption></figure>

* Sau khi nhập thông tin cập nhật thì nhấn **Execute node** để chạy workflow

<figure><img src="/files/VlswKtR0O4cNJXszusee" alt=""><figcaption><p>Cập nhật thông tin khách hàng thành công</p></figcaption></figure>

### Lấy Danh Sách Khách Hàng

* Chọn Resource là **Customer** và Operation là **Lấy Danh Sách Khách Hàng**
* Nhập trường cần được sắp xếp (id,name,...), chọn thứ tự trả về của kết quả sau khi đã sắp xếp theo thứ tự tăng hoặc giảm dần, nhập số lượng bản ghi trả về, vị trí lấy thông tin và các thuộc tính cần lọc

<figure><img src="/files/KaYoIvbvasqg2x3B7VWs" alt=""><figcaption><p>Nhập thông tin để lấy danh sách</p></figcaption></figure>

* **Lưu ý:** Mục Current Item có lưu ý giống lưu ý của [Danh Sách Hàng Hóa](#danh-sach-hang-hoa)
* Sau khi hoàn thành các bước trên hãy nhấn **Execute node** để chạy workflow

<figure><img src="/files/rEqmpDVyXmwd89l8gF1Z" alt=""><figcaption><p>Lấy danh sách khách hàng thành công</p></figcaption></figure>

### Lấy Danh Sách Nhóm Khách Hàng

* Chọn Resource là **Customer** và Operation là **Lấy Danh Sách Nhóm Khách Hàng**
* Sau đó nhấn **Execute node** để chạy workflow

<figure><img src="/files/QYqpIO8cxysDr69p7NN2" alt=""><figcaption><p>Chạy workflow</p></figcaption></figure>

<figure><img src="/files/dtUHNu495NyhI0sEHwnq" alt=""><figcaption><p>Lấy danh sách nhóm khách hàng thành công</p></figcaption></figure>

### Xóa Khách Hàng

* Chọn Resource là **Customer** và Operation là **Xóa Khách Hàng**
* Nhập ID khách hàng cần xóa

<figure><img src="/files/722dm2Tyfyt1BWtGiSVX" alt=""><figcaption><p>Nhập ID khách hàng cần xóa</p></figcaption></figure>

* Sau đó nhấn **Execute node** để chạy workflow

<figure><img src="/files/lX3BxaWdbm3WezdneNhJ" alt=""><figcaption><p>Xóa khách hàng thành công</p></figcaption></figure>

### Thêm Mới Đặt Hàng

* Chọn Resource là **Order Product** và Operation là **Thêm Mới Đặt Hàng**
* Nhập các trường cần thiết để tạo đơn đặt hàng

<figure><img src="/files/7fWV0mknvmzRyn14HZZA" alt=""><figcaption><p>Nhập thông tin để tạo đơn đặt hàng</p></figcaption></figure>

* Sau đó, nhấn **Execute node** để chạy workflow

<figure><img src="/files/c0ZmJDCtxo9KNQ01Ri7e" alt=""><figcaption><p>Thêm đơn đặt hàng thành công</p></figcaption></figure>

### Cập Nhật Đặt Hàng

* Chọn Resource là **Order Product** và Operation là **Cập Nhật Đặt Hàng**
* Nhập thông tin cần cập nhật của đơn hàng

<figure><img src="/files/u7IEmsFDBX7qzXdPrB8D" alt=""><figcaption><p>Nhập thông tin cần cập nhật</p></figcaption></figure>

* Sau đó, nhấn **Execute node** để chạy workflow

<figure><img src="/files/55kkZeYWL2HUKWUHZkR8" alt=""><figcaption><p>Cập nhật đơn hàng thành công</p></figcaption></figure>

### Lấy Danh Sách Đặt Hàng

* Chọn Resource là **Order Product** và Operation là **Lấy Danh Sách Đặt Hàng**
* Điền các thuộc tính cần lọc để lấy thông tin

<figure><img src="/files/l0J2HRY5ILOttaJzj8ho" alt=""><figcaption><p>Điền thuộc tính cần lọc</p></figcaption></figure>

<figure><img src="/files/zUybcCiKJiJWsFvs7Ipa" alt=""><figcaption><p>Điền thuộc tính cần lọc</p></figcaption></figure>

* **Lưu ý:** Mục Current Item có lưu ý giống lưu ý của [Danh Sách Hàng Hóa](#danh-sach-hang-hoa)
* Sau đó, nhấn **Execute node** để chạy workflow

<figure><img src="/files/iiYaxOqZ7mC4J4LIGiH1" alt=""><figcaption><p>Lấy danh sách đơn đặt hàng thành công</p></figcaption></figure>

### Lấy Chi Tiết Đặt Hàng

* Chọn Resource là **Order Product** và Operation là **Lấy Chi Tiết Đặt Hàng**
* Chọn loại tìm kiếm (ID hoặc Code) và nhập ID hoặc Code đơn đặt hàng

<figure><img src="/files/NKNtwKNBs4XSHGxdiy3N" alt=""><figcaption><p>Nhập thông tin</p></figcaption></figure>

* Sau đó, nhấn **Execute node** để chạy workflow

<figure><img src="/files/BVo4qXBPb51VR8zyETvb" alt=""><figcaption><p>Lấy chi tiết đơn đặt hàng thành công</p></figcaption></figure>

### Xóa Đơn Đặt Hàng

* Chọn Resource là **Order Product** và Operation là **Xóa Đặt Hàng**
* Nhập ID đơn đặt hàng cần xóa

<figure><img src="/files/iT9DHR7OEnHgo6IXyEBV" alt=""><figcaption><p>Nhập ID cần xóa</p></figcaption></figure>

* Sau đó, nhấn **Execute node** để chạy workflow

<figure><img src="/files/knXICibAyR8CzzTTnj2Y" alt=""><figcaption><p>Xóa đơn đặt hàng thành công</p></figcaption></figure>

### Danh Sách Sổ Quỹ

* Chọn Resource là **Cash Flow** và Operation là **Danh Sách Sổ Quỹ**
* Nhập các thuộc tính cần thiết để lọc dữ liệu&#x20;

<figure><img src="/files/mPYKx2rfrLt0iTxv302u" alt=""><figcaption><p>Nhập các thuộc tính cần lọc </p></figcaption></figure>

* **Lưu ý:** Mục Current Item có lưu ý giống lưu ý của [Danh Sách Hàng Hóa](#danh-sach-hang-hoa)
* Sau đó, nhấn **Execute node** để chạy workflow

<figure><img src="/files/Ptvqqd02YwIVlNoVGiTU" alt=""><figcaption><p>Lấy danh sách sổ quỹ thành công</p></figcaption></figure>

### Thêm Mới Thu Khác

* Chọn Resource là **Surcharge** và Operation là **Thêm Mới Thu Khác**
* Nhập các trường cần thiết để tạo thu khác

<figure><img src="/files/CGI4YHKKmneSxC8ICzfY" alt=""><figcaption><p>Nhập các thông tin cần thiết</p></figcaption></figure>

* Sau đó, nhấn **Execute node** để chạy workflow

<figure><img src="/files/I4fzM7pyKCFLfsIHazeR" alt=""><figcaption><p>Thêm mới thu khác thành công</p></figcaption></figure>

### Cập Nhật Thu Khác

* Chọn Resource là **Surcharge** và Operation là **Cập Nhật Thu Khác**
* Nhập thông tin cần được cập nhật

<figure><img src="/files/2YgEEVu8eCOEC12Af0bf" alt=""><figcaption><p>Nhập thông tin cập nhật</p></figcaption></figure>

* Sau đó, nhấn **Execute node** để chạy workflow

<figure><img src="/files/hR2vUuqitIUEmZFiWgqK" alt=""><figcaption><p>Cập nhật thu khác thành công</p></figcaption></figure>

### Lấy Danh Sách Thu Khác

* Chọn Resource là **Surcharge** và Operation là **Lấy Danh Sách Thu Khác**
* Điền các thuộc tính cần lọc để lấy danh sách thu khác

<figure><img src="/files/Jsfnq0WhQdPIeCvMwg2u" alt=""><figcaption><p>Nhập thông tin để lọc</p></figcaption></figure>

* **Lưu ý:** Mục Current Item có lưu ý giống lưu ý của [Danh Sách Hàng Hóa](#danh-sach-hang-hoa)
* Sau đó, nhấn **Execute node** để chạy workflow

<figure><img src="/files/9uuHAJLHuaQcwv5nm5xB" alt=""><figcaption><p>Lấy danh sách thu khác thành công</p></figcaption></figure>

### **Ngừng** Hoạt Động Thu Khác

* Chọn Resource là **Surcharge** và Operation là **Ngừng Hoạt Động Thu Khác**
* Nhập ID thu khác cần ngừng hoạt động

<figure><img src="/files/mAGq6YPZ18dVwriuryrI" alt=""><figcaption><p>Nhập ID thu khác cần ngừng hoạt động</p></figcaption></figure>

* Sau đó, nhấn **Execute node** để chạy workflow

<figure><img src="/files/IEccGdBEtncr4dwNUivT" alt=""><figcaption><p>Ngừng hoạt động thu khác thành công</p></figcaption></figure>

### Thêm Hóa Đơn Mới

* Chọn Resource là **Invoice** và Operation là **Thêm Hóa Đơn Mới**
* Nhập các thông tin cần thiết để tạo một hóa đơn mới

<figure><img src="/files/cBnDgsV87IYwI3LB7lCJ" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/6dL8reOqEUFaflEzEYCG" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/2JeN07P2ASMHzxuxqU1h" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/F17ErN3oOlVO7iYF3lso" alt=""><figcaption></figcaption></figure>

* Sau đó, nhấn **Execute node** để chạy workflow

<figure><img src="/files/mfZ6WjNDyQbo2IDim8rZ" alt=""><figcaption><p>Tạo hóa đơn mới thành công</p></figcaption></figure>

### Cập Nhật Hóa Đơn

* Chọn Resource là **Invoice** và Operation là **Cập Nhật Hóa Đơn**&#x20;
* Nhập các thông tin cần cập nhật

<figure><img src="/files/IFizf6247tNhQ2o5GBpk" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/50SIXyLpxLC8cwe33T8e" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/rrn8la3qywQH0Fuz2nic" alt=""><figcaption></figcaption></figure>

* Sau đó, nhấn **Execute node** để chạy workflow

<figure><img src="/files/gNN2N0HiZPI9TYBetf2j" alt=""><figcaption><p>Cập nhật hóa đơn thành công</p></figcaption></figure>

### Lấy Danh Sách Hóa Đơn

* Chọn Resource là **Invoice** và Operation là **Lấy Danh Sách Hóa Đơn**&#x20;
* Nhập các thuộc tính cần lọc để lấy dữ liệu

<figure><img src="/files/xynw9zbNdYlHk3G5nEjL" alt=""><figcaption><p>Nhập các thuộc tính cần lọc</p></figcaption></figure>

* Sau đó, nhấn **Execute node** để chạy workflow

<figure><img src="/files/BeXgdKveHa1Fdu7nY3Gj" alt=""><figcaption><p>Lấy danh sách hóa đơn thành công</p></figcaption></figure>

### Lấy Chi Tiết Hóa Đơn

* Chọn Resource là **Invoice** và Operation là **Lấy Chi Tiết Hóa Đơn**&#x20;
* Chọn loại tìm kiếm hóa đơn (ID hoặc Code), nhập ID hoặc Code hóa đơn để lấy thông tin

<figure><img src="/files/mLm4iSF505SFSX3tauqX" alt=""><figcaption><p>Chọn loại tìm kiếm và nhập ID hoặc Code</p></figcaption></figure>

* Sau đó, nhấn **Execute node** để chạy workflow

<figure><img src="/files/0xtADzwROI1bS3hW3M8s" alt=""><figcaption><p>Lấy chi tiết hóa đơn thành công</p></figcaption></figure>

### Xóa Hóa Đơn

* Chọn Resource là **Invoice** và Operation là **Xóa Hóa Đơn**
* Nhập ID hóa đơn cần xóa

<figure><img src="/files/MUt6erJgvk6QDPvNnESO" alt=""><figcaption><p>Nhập ID hóa đơn cần xóa</p></figcaption></figure>

* Sau đó, nhấn **Execute node** để chạy workflow

<figure><img src="/files/tskBZQ4e15MK8Vn3B9cM" alt=""><figcaption><p>Xóa hóa đơn thành công</p></figcaption></figure>

### Lấy Danh Sách Kênh Bán Hàng

* Chọn Resource là **Sale Channel** và Operation là **Lấy Danh Sách Kênh Bán Hàng**
* Nhập các thuộc tính cần lọc để lấy dữ liệu

<figure><img src="/files/UU6VGkpzvlVctV6ZKAUh" alt=""><figcaption><p>Nhập các thuộc tính cần lọc</p></figcaption></figure>

* **Lưu ý:** Mục Current Item có lưu ý giống lưu ý của [Danh Sách Hàng Hóa](#danh-sach-hang-hoa)
* Sau đó, nhấn **Execute node** để chạy workflow

<figure><img src="/files/fwZuOTKnouPNLz0CHULT" alt=""><figcaption><p>Lấy danh sách kênh bán hàng thành công</p></figcaption></figure>

### Lấy Danh Sách Bảng Giá

* Chọn Resource là **Price Books** và Operation là **Lấy Danh Sách Bảng Giá**
* Điền các thuộc tính cần lọc để lấy thông tin

<figure><img src="/files/URRbDNgILFzapXCCrIDS" alt=""><figcaption><p>Nhập thuộc tính cần lọc</p></figcaption></figure>

* **Lưu ý:** Mục Current Item có lưu ý giống lưu ý của [Danh Sách Hàng Hóa](#danh-sach-hang-hoa)
* Sau đó, nhấn **Execute node** để chạy workflow

<figure><img src="/files/oDW4REK5vgJvx69Z0IBr" alt=""><figcaption><p>Lấy danh sách bảng giá thành công</p></figcaption></figure>

### Lấy Chi Tiết Bảng Giá (Lấy sản phẩm trong bảng giá)

* Chọn Resource là **Price Books** và Operation là **Lấy Chi Tiết Bảng Giá**
* Nhập ID Bảng giá và các thuộc tính cần lọc để lấy sản phẩm thuộc bảng giá

<figure><img src="/files/MXdJEcepQRjJgXaEj8Pz" alt=""><figcaption><p>Nhập ID bảng giá và thuộc tính lọc</p></figcaption></figure>

* **Lưu ý:** Mục **Bảng giá hiện tại** có lưu ý giống lưu ý của **Current Item** trong [Danh Sách Hàng Hóa](#danh-sach-hang-hoa)
* Sau đó, nhấn **Execute node** để chạy workflow

<figure><img src="/files/u6BZmAaQfFTCkXZAYMKw" alt=""><figcaption><p>Lấy chi tiết bảng giá thành công</p></figcaption></figure>

### Cập Nhật Chi Tiết Bảng Giá

* Chọn Resource là **Price Books** và Operation là **Cập Nhật Chi Tiết Bảng Giá**
* Nhập ID **Bảng giá**, **ID Sản phẩm** và **Giá sản phẩm**

<figure><img src="/files/nEAGosCXM1WdI68ilzDo" alt=""><figcaption><p>Nhập ID Bảng giá, ID Sản phẩm và Giá sản phẩm</p></figcaption></figure>

* Sau đó, nhấn **Execute node** để chạy workflow

<figure><img src="/files/1pim7PZNFn3qPlFtJPUt" alt=""><figcaption><p>Cập nhật chi tiết bảng giá thành công</p></figcaption></figure>

### Lấy danh sách nhóm khách hàng

* Chọn Resource là **Group** và Operation là **Lấy Danh Sách Nhóm Khách Hàng**

<figure><img src="/files/GtMQSaxUkBes5MPgZFTM" alt=""><figcaption><p>Lấy danh sách nhóm khách hàng</p></figcaption></figure>

* Sau đó, nhấn **Execute node** để chạy workflow

<figure><img src="/files/ecTCDoo1oWdECN5B1LhV" alt=""><figcaption><p>Lấy danh sách nhóm khách hàng thành công</p></figcaption></figure>

### Thêm Mới Hàng Nhập

* Chọn Resource là **Purchase Order** và Operation là **Thêm Mới Nhập Hàng**
* Nhập các thông tin cần thiết để thêm mới nhập hàng&#x20;

<figure><img src="/files/VRsiEs9NBS0z7RiCvFuH" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/7hm7sWMyTFPOYtKtGoZN" alt=""><figcaption><p>Điền thông tin cần thiết để nhập hàng</p></figcaption></figure>

* Sau đó, nhấn **Execute node** để chạy workflow

<figure><img src="/files/bBkFtZtKT2YVoZMF42Bp" alt=""><figcaption><p>Hoàn thành nhập hàng</p></figcaption></figure>

### Cập Nhật Nhập Hàng

* Chọn Resource là **Purchase Order** và Operation là **Cập Nhật Nhập Hàng**
* Điền các thông tin cần cập nhật của đơn nhập hàng

<figure><img src="/files/WrE15qIGOvfG6NuGAIQ7" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/IuO4ROpEYlKilTqsSwMP" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/S6xoa0GZp7MPytHDGF6M" alt=""><figcaption><p>Nhập thông tin cần cập nhật</p></figcaption></figure>

* Sau đó, nhấn **Execute node** để chạy workflow

<figure><img src="/files/i3uP6rGvMBwlpojpCAiC" alt=""><figcaption><p>Cập nhật đơn nhập hàng thành công</p></figcaption></figure>

### Lấy Chi Tiết Nhập Hàng

* Chọn Resource là **Purchase Order** và Operation là **Lấy Chi Tiết Nhập Hàng**
* Nhập ID của đơn nhập hàng cần tiền kiếm

<figure><img src="/files/qHo8doIFsWrjFiwWvZgP" alt=""><figcaption><p>Nhập ID phiếu nhập hàng</p></figcaption></figure>

* Sau đó, nhấn **Execute node** để chạy workflow

<figure><img src="/files/fYZL7xQ0MbOHWGIcBvx4" alt=""><figcaption><p>Lấy chi tiết đơn nhập hàng thành công</p></figcaption></figure>

### Lấy Danh Sách Nhập Hàng

* Chọn Resource là **Purchase Order** và Operation là **Lấy Danh Sách Nhập Hàng**
* Nhập **Page Size**, **Current Item** và có thể chọn thêm các **filter** để lọc danh sách dữ liệu

<figure><img src="/files/FUe6EVK4UcPpfhV8ETU7" alt=""><figcaption><p>Nhập các thuộc tính để lọc dữ liệu</p></figcaption></figure>

* **Lưu ý:** Mục Current Item có lưu ý giống lưu ý của [Danh Sách Hàng Hóa](#danh-sach-hang-hoa)
* Sau đó, nhấn **Execute node** để chạy workflow

<figure><img src="/files/m2m8CpFgJ8Q0baioBMAi" alt=""><figcaption><p>Lấy danh sách đơn nhập hàng thành công</p></figcaption></figure>

### Xóa Nhập Hàng

* Chọn Resource là **Purchase Order** và Operation là **Xóa Nhập Hàng**
* Nhập ID phiếu nhập hàng cần xóa và chọn có muốn hủy phiếu thanh toán không

<figure><img src="/files/tTBms2e5DnS3XmY93CCG" alt=""><figcaption><p>Nhập ID phiếu nhập hàng cần xóa và có hủy phiếu thanh toán</p></figcaption></figure>

* Sau đó, nhấn **Execute node** để chạy workflow

<figure><img src="/files/Z6QWXmzvgjLWSFTilu0l" alt=""><figcaption><p>Hủy phiếu nhập hàng thành công</p></figcaption></figure>

### Lấy Danh Sách Trả Hàng

* Chọn Resource là **Return Product** và Operation là **Lấy Danh Sách Trả Hàng**
* Nhập các thông tin cần thiết như: Sắp xếp theo trường, **Page Size**, **Current Item** và các thuộc tính cần filter để lọc dữ liệu&#x20;

<figure><img src="/files/eqEe89wgjeTdLX4k4cNO" alt=""><figcaption><p>Nhập các thông tin cần thiết để lọc</p></figcaption></figure>

* **Lưu ý:** Mục Current Item có lưu ý giống lưu ý của [Danh Sách Hàng Hóa](#danh-sach-hang-hoa)
* Sau đó, nhấn **Execute node** để chạy workflow

<figure><img src="/files/GvUlXKM7st64uhDKYfIp" alt=""><figcaption><p>Lấy danh sách trả hàng thành công</p></figcaption></figure>

### Lấy Chi Tiết Phiếu Trả Hàng

* Chọn Resource là **Return Product** và Operation là **Lấy Chi Tiết Phiếu Trả Hàng**
* Chọn loại tìm kiếm (Code hoặc ID) và nhập Code hoặc ID của phiếu trả hàng

<figure><img src="/files/BZPzMOfrrkpVaFQy85q0" alt=""><figcaption><p>Chọn loại tìm kiếm và nhập ID hoặc Code</p></figcaption></figure>

* Sau đó, nhấn **Execute node** để chạy workflow

<figure><img src="/files/qVFkF3fi6MZauUjIVcza" alt=""><figcaption><p>Lấy chi tiết phiếu trả hàng thành công</p></figcaption></figure>

### Lấy Danh Sách Thiết Lập Cửa Hàng

* Chọn Resource là **Setting** và Operation là **Lấy Danh Sách Thiết Lập Cửa Hàng**
* Sau đó, nhấn **Execute node** để chạy workflow

<figure><img src="/files/VujITjyWhn7Fjm6OOVEX" alt=""><figcaption><p>Lấy danh sách thiết lập cửa hàng thành công</p></figcaption></figure>

### Thêm Mới Chuyển Hàng

* Chọn Resource là **Tranfers** và Operation là **Thêm Mới Chuyển Hàng**
* Nhập các thông tin cần thiết để chuyển hàng

<figure><img src="/files/QtR2Hrfn4XtgZ7ZMz119" alt=""><figcaption><p>Nhập thông tin để chuyển hàng</p></figcaption></figure>

* Sau đó, nhấn **Execute node** để chạy workflow

<figure><img src="/files/b2PwwPFBWJg7oqcreoDE" alt=""><figcaption><p>Thêm mới chuyển hàng thành công</p></figcaption></figure>

### Cập Nhật Chuyển Hàng

* Chọn Resource là **Tranfers** và Operation là **Cập Nhật Chuyển Hàng**
* Nhập thông tin cần cập nhật&#x20;

<figure><img src="/files/MKvQSaOTyyqDEtfL0YoH" alt=""><figcaption><p>Nhập thông tin cập nhật</p></figcaption></figure>

* Sau đó, nhấn **Execute node** để chạy workflow

<figure><img src="/files/vmdLU0tw7KM58vmxgZkU" alt=""><figcaption><p>Cập nhật phiếu chuyển hàng thành công</p></figcaption></figure>

### Lấy Chi Tiết Phiếu Chuyển Hàng

* Chọn Resource là **Tranfers** và Operation là **Lấy Chi Tiết Phiếu Chuyển Hàng**
* Nhập ID phiếu chuyển hàng cần lấy thông tin

<figure><img src="/files/vOKnoIu1kALymvGbpfWS" alt=""><figcaption><p>Nhập ID phiếu chuyển hàng cần lấy thông tin</p></figcaption></figure>

* Sau đó, nhấn **Execute node** để chạy workflow

<figure><img src="/files/s6uuzm5DO2Vlt9kBmbX9" alt=""><figcaption><p>Lấy chi tiết phiếu chuyển hàng thành công</p></figcaption></figure>

### Lấy Danh Sách Phiếu Chuyển Hàng

* Chọn Resource là **Tranfers** và Operation là **Lấy Danh Sách Phiếu Chuyển Hàng**
* Nhập **Page Size, Current Item** và các filter để lọc dữ liệu

<figure><img src="/files/O3vjAPhHxilpXQGSCXgl" alt=""><figcaption><p>Nhập các thuộc tính cần lọc</p></figcaption></figure>

* **Lưu ý:** Mục Current Item có lưu ý giống lưu ý của [Danh Sách Hàng Hóa](#danh-sach-hang-hoa)
* Sau đó, nhấn **Execute node** để chạy workflow

<figure><img src="/files/c7QRGWlrUT7aop9eXbhu" alt=""><figcaption><p>Lấy danh sách chuyển hàng thành công</p></figcaption></figure>

### Xóa Chuyển Hàng

* Chọn Resource là **Tranfers** và Operation là **Xóa Chuyển Hàng**
* Nhập ID phiếu chuyển hàng cần xóa

<figure><img src="/files/SfPax5kwNXNCeIK5hkpq" alt=""><figcaption><p>Nhập ID phiếu chuyển hàng cần xóa</p></figcaption></figure>

* Sau đó, nhấn **Execute node** để chạy workflow

<figure><img src="/files/xpsbcX71VdRyIJ7I6iCe" alt=""><figcaption><p>Xóa chuyển hàng thành công</p></figcaption></figure>

### Lấy Danh Sách Đặt Hàng Nhập

* Chọn Resource là **Order Supplier** và Operation là **Lấy Danh Sách Đặt Hàng Nhập**
* Nhập **Page Size, Current Item** và các filter để lọc dữ liệu

<figure><img src="/files/hVSy3eAf8b69S0UK7xLy" alt=""><figcaption><p>Nhập các thuộc tính cần lọc</p></figcaption></figure>

* **Lưu ý:** Mục Current Item có lưu ý giống lưu ý của [Danh Sách Hàng Hóa](#danh-sach-hang-hoa)
* Sau đó, nhấn **Execute node** để chạy workflow

<figure><img src="/files/Hht8itq27zDd3tCSA3DX" alt=""><figcaption><p>Lấy danh sách đặt hàng nhập thành công</p></figcaption></figure>

### Lấy Chi Tiết Đặt Hàng Nhập

* Chọn Resource là **Order Supplier** và Operation là **Lấy Chi Tiết Đặt Hàng Nhập**
* Nhập ID đặt hàng nhập cần lấy thông tin

<figure><img src="/files/e2g4t9Vif2glK8ess0d8" alt=""><figcaption><p>Nhập ID cần lấy thông tin</p></figcaption></figure>

* Sau đó, nhấn **Execute node** để chạy workflow

<figure><img src="/files/scVEsXmOwyewtRFjMRZ8" alt=""><figcaption><p>Lấy chi tiết đặt hàng nhập thành công</p></figcaption></figure>

### Đăng Ký Webhook

* Chọn Resource là **Webhook** và Operation là **Đăng Ký Webhook**
* Chọn event ở mục "Type" mà bạn muốn đăng ký, dán đường dẫn webhook vào mục "URL", chọn "Is Active" và điền ghi chú vào mục "Description". Cuối cùng nhấn "Execute node"

<figure><img src="/files/ORikzl11S9esmmaFTlWE" alt=""><figcaption><p>Đăng ký webhook</p></figcaption></figure>

<figure><img src="/files/1eqwUIRiP6uhT5x62jK0" alt=""><figcaption><p>Đăng ký thành công</p></figcaption></figure>

### Danh Sách Webhook

* Chọn Resource là **Webhook** và Operation là **Danh Sách Webhook**
* Sau đó, nhấn **Execute node** để chạy workflow

<figure><img src="/files/lRVkDuBOhU8Vf1FNZe4h" alt=""><figcaption><p>Lấy danh sách webhook thành công</p></figcaption></figure>

### Chi Tiết Webhook

* Chọn Resource là **Webhook** và Operation là **Chi Tiết Webhook**
* Nhập ID webhook cần lấy thông tin

<figure><img src="/files/6U7KAgzW4OFkdHITbkbt" alt=""><figcaption><p>Nhập ID cần lấy thông tin chi tiết</p></figcaption></figure>

* Sau đó, nhấn **Execute node** để chạy workflow

<figure><img src="/files/udr6JcFfIQokNqcEPTLO" alt=""><figcaption><p>Lấy chi tiết webhook thành công</p></figcaption></figure>

### Hủy Đăng Ký Webhook

* Chọn Resource là **Webhook** và Operation là **Hủy Đăng Ký Webhook**
* Nhập ID cần hủy đăng ký

<figure><img src="/files/qBPmpVP4vYSRVhty5gfF" alt=""><figcaption><p>Nhập ID cần hủy đăng ký</p></figcaption></figure>

* Sau đó, nhấn **Execute node** để chạy workflow

<figure><img src="/files/yIMSREriuKAVLpsFwQZO" alt=""><figcaption><p>Hủy đăng ký thành công</p></figcaption></figure>

### Cập nhật trạng thái coupon

* Chọn Resource là **Coupon** và Operation là **Cập Nhật Trạng Thái Coupon**
* Nhập Coupon code cần cập nhật trạng thái

<figure><img src="/files/a67RnLNWbVQThP8r9C4H" alt=""><figcaption><p>Nhập coupon code</p></figcaption></figure>

* Sau đó, nhấn **Execute node** để chạy workflow

<figure><img src="/files/cvQWvgThyHDxrakIicxL" alt=""><figcaption><p>Cập nhật trạng thái coupon thành công</p></figcaption></figure>

### Lấy Danh Sách Chi Nhánh

* Chọn Resource là **Branch** và Operation là **Lấy Danh Sách Chi Nhánh**
* Nhập các thuộc tính cần lọc để lấy dữ liệu

<figure><img src="/files/VWLPx4OEmymp97jolRKW" alt=""><figcaption></figcaption></figure>

* **Lưu ý:** Mục Current Item có lưu ý giống lưu ý của [Danh Sách Hàng Hóa](#danh-sach-hang-hoa)
* Sau đó, nhấn **Execute node** để chạy workflow

<figure><img src="/files/OPWbUm6LOqnHUhnhgh37" alt=""><figcaption><p>Lấy danh sách chi nhánh thành công</p></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.n8n.vn/kiotviet.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
