n8n-nodes-kiotviet-fnb

Đây là bộ node cộng đồng cho n8n giúp tích hợp với KiotViet FnB API. Bao gồm các node để quản lý sản phẩm, danh mục, đơn hàng, khách hàng, tồn kho, và webhooks thời gian thực.

Ủng hộ 1 cốc cà phê

Nếu bạn thấy gói tích hợp này hữu ích, hãy ủng hộ tác giả 1 cốc cà phê nhé!
Cám ơn các bạn đã ủng hộ!

BIEN NGO HUY PHONG
TECHCOMBANK

Yêu cầu trước khi sử dụng

• Tài khoản KiotViet FnB
• Thông tin API (Client ID và Client Secret)
• Tên cửa hàng (Retailer name)

Cài đặt

Thực hiện theo các bước sau để cài đặt node:

# Dùng npm
npm install n8n-nodes-kiotviet-fnb

# Dùng pnpm
pnpm install n8n-nodes-kiotviet-fnb

Thông tin xác thực (Credentials)

Để sử dụng các node KiotViet FnB, bạn cần thêm thông tin xác thực vào n8n:

1. Vào Credentials trong n8n
2. Tìm "KiotViet FnB API"
3. Thêm thông tin:

• Client ID
• Client Secret
• Retailer Name

Các node có sẵn

Node Sản phẩm (Products)

Quản lý sản phẩm trong hệ thống KiotViet FnB.

Các thao tác hỗ trợ:

• Get: Lấy thông tin một sản phẩm theo ID
• Get Many: Lấy danh sách sản phẩm (hỗ trợ phân trang)
• Get By Code: Tìm sản phẩm theo mã
• Create: Tạo sản phẩm mới
• Update: Cập nhật thông tin sản phẩm
• Delete: Xóa sản phẩm

Node Danh mục (Categories)

Quản lý danh mục sản phẩm.

Các thao tác hỗ trợ:

• Get: Lấy thông tin danh mục theo ID
• Get Many: Lấy danh sách danh mục (hỗ trợ phân trang)
• Get By Code: Tìm danh mục theo mã

Node Đơn hàng (Orders)

Quản lý đơn hàng và giao dịch.

Các thao tác hỗ trợ:

• Create: Tạo đơn hàng mới
• Get: Lấy thông tin đơn hàng theo ID
• Get By UUID: Tìm đơn hàng dựa trên UUID
• Get Many: Lấy danh sách đơn hàng
• Get By Branches: Lấy đơn hàng theo chi nhánh
• Get By Customers: Lấy đơn hàng theo khách hàng
• Get By Status: Lọc đơn hàng theo trạng thái

Node Khách hàng (Customers)

Quản lý thông tin khách hàng.

Các thao tác hỗ trợ:

• Create: Tạo khách hàng mới
• Get: Lấy thông tin khách hàng theo ID
• Get By Code: Tìm khách hàng bằng mã
• Get Many: Lấy danh sách khách hàng
• Search: Tìm khách hàng theo tên hoặc số liên hệ
• Update: Cập nhật thông tin khách hàng
• Delete: Xóa khách hàng

Node Tồn kho (Stock)

Theo dõi và quản lý tồn kho.

Các thao tác hỗ trợ:

• Get Product Stock: Lấy tồn kho của một sản phẩm cụ thể
• Get Many Stocks: Lấy tồn kho cho nhiều sản phẩm
• Get Stock By Branch: Lấy tồn kho theo chi nhánh

Tùy chọn thêm:

• Include Zero Stock: Hiển thị sản phẩm có tồn kho 0
• Include Cost: Hiển thị thông tin giá vốn
• Include Reserved: Hiển thị số lượng đã được đặt/giữ

Node Webhooks

Thiết lập thông báo thời gian thực khi dữ liệu thay đổi.

Các thao tác hỗ trợ:

• Register: Đăng ký subscription webhook mới
• Unregister: Hủy đăng ký webhook hiện có

Sự kiện được hỗ trợ:

• Cập nhật khách hàng (Customer Update)
• Xóa khách hàng (Customer Delete)
• Cập nhật sản phẩm (Product Update)
• Xóa sản phẩm (Product Delete)
• Cập nhật tồn kho (Stock Update)

Ví dụ workflow

Quản lý đơn hàng (Order Management)

{
  "name": "Process New Order",
  "nodes": [
    {
      "parameters": {
        "operation": "create",
        "orderData": {
          "customerId": 123,
          "branchId": 456,
          "products": [
            {
              "productId": 789,
              "quantity": 2,
              "price": 50000
            }
          ]
        }
      },
      "name": "KiotViet Orders",
      "type": "n8n-nodes-kiotviet-fnb",
      "typeVersion": 1
    }
  ]
}

Giám sát tồn kho (Stock Monitoring)

{
  "name": "Monitor Low Stock",
  "nodes": [
    {
      "parameters": {
        "operation": "getManyStocks",
        "returnAll": true,
        "additionalFields": {
          "includeZeroStock": true
        }
      },
      "name": "KiotViet Stock",
      "type": "n8n-nodes-kiotviet-fnb",
      "typeVersion": 1
    }
  ]
}

Cập nhật thời gian thực (Real-time Updates)

{
  "name": "Stock Update Notification",
  "nodes": [
    {
      "parameters": {
        "operation": "register",
        "eventType": "stock.update",
        "url": "https://your-webhook-url.com/stock-updates",
        "additionalFields": {
          "description": "Theo dõi thay đổi tồn kho"
        }
      },
      "name": "KiotViet Webhooks",
      "type": "n8n-nodes-kiotviet-fnb",
      "typeVersion": 1
    }
  ]
}

Xử lý lỗi

Các node có xử lý lỗi đầy đủ, bao gồm:

• Hạn chế tốc độ (rate limiting)
• Lỗi xác thực (Authentication)
• Lỗi dữ liệu không hợp lệ
• Lỗi kết nối mạng

Thông báo lỗi có nội dung rõ ràng, bao gồm:

• Loại lỗi
• Chi tiết mô tả
• Gợi ý cách khắc phục