JSPM

n8n-nodes-vmass

0.1.1
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 11
  • Score
    100M100P100Q41093F
  • License MIT

n8n community node for VMASS POS integration

Package Exports

  • n8n-nodes-vmass
  • n8n-nodes-vmass/dist/nodes/Vmass/Vmass.node.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (n8n-nodes-vmass) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

n8n-nodes-vmass

Custom n8n community node để tích hợp VMASS POS System vào n8n workflow automation.

📦 Cài đặt

Cách 1: Community Nodes (Khuyến nghị)

  1. Mở n8n → Settings → Community Nodes
  2. Click Install
  3. Nhập n8n-nodes-vmass
  4. Click Install

Cách 2: Docker (Manual)

# Mount volume trong docker-compose.yml
volumes:
  - ./n8n-nodes-vmass/dist:/home/node/.n8n/nodes/n8n-nodes-vmass

------tự thêm------- # Copy folder dist/ vào container n8n ------tự thêm------- docker cp ./dist n8n-container:/home/node/.n8n/nodes/n8n-nodes-vmass/

Cách 3: npm (Self-hosted)

cd ~/.n8n/nodes
npm install n8n-nodes-vmass

🔐 Cấu hình Credentials

  1. Credentials → Create New → VMASS API
  2. Nhập:
    • API Key: Lấy từ VMASS Dashboard > Cài đặt > API Keys
    • Base URL: https://your-domain.vmass.vn/api/public
  3. Click Save

📋 Nodes

1. VMASS Node (Action Node)

Node chính để thực hiện các thao tác với VMASS API.

Resources & Operations

Resource Operation Mô tả
Order Get Lấy chi tiết 1 đơn hàng theo ID
Get Many Danh sách đơn hàng (có filter)
Create Tạo đơn hàng mới
Update Status Cập nhật trạng thái (pending/completed/cancelled)
Product Get Chi tiết sản phẩm
Get Many Danh sách sản phẩm
Create Tạo sản phẩm mới
Update Cập nhật thông tin sản phẩm
Inventory Get Chi tiết nguyên liệu
Get Many Danh sách nguyên liệu
Create Thêm nguyên liệu mới
Update Quantity Cộng/trừ/đặt số lượng kho
Get Low Stock Nguyên liệu sắp hết
Customer Get Chi tiết khách hàng
Get Many Danh sách khách hàng
Create Thêm khách hàng
Update Cập nhật thông tin
Webhook Get Many Danh sách webhook đã đăng ký
Register Đăng ký webhook mới
Unregister Hủy đăng ký
Test Gửi test event

2. VMASS Trigger (Trigger Node)

Nhận webhook events tự động từ VMASS khi có sự kiện xảy ra.

Events hỗ trợ

Event Mô tả
order.created Đơn hàng mới được tạo
order.updated Đơn hàng được cập nhật
order.completed Đơn hàng hoàn thành
order.cancelled Đơn hàng bị hủy
inventory.low Nguyên liệu sắp hết (cảnh báo)
inventory.updated Kho được cập nhật
customer.created Khách hàng mới

🚀 Ví dụ sử dụng

Ví dụ 1: Gửi Telegram khi có đơn mới

VMASS Trigger (order.created) → Telegram (Send Message)

Ví dụ 2: Tự động cập nhật Google Sheets

VMASS Trigger (order.completed) → Google Sheets (Append Row)

Ví dụ 3: Cảnh báo Slack khi hết hàng

VMASS Trigger (inventory.low) → Slack (Post Message)

Ví dụ 4: Đồng bộ khách hàng sang CRM

VMASS Trigger (customer.created) → HTTP Request (POST to CRM)

🔧 API Key

Test Key vs Live Key

Loại Format Mục đích
Test Key vmss_test_... Sandbox/Test - dữ liệu không ảnh hưởng thật
Live Key vmss_live_... Production - dữ liệu thật

📞 Hỗ trợ

📄 License

MIT