n8n-nodes-vmass

Community node for n8n to integrate with VMASS POS System — a multi-tenant point-of-sale platform for restaurants, cafes, and retail shops in Vietnam.

Installation

Community Nodes (Recommended)

1. Open n8n → Settings → Community Nodes
2. Click Install
3. Enter n8n-nodes-vmass
4. Click Install

Manual (Self-hosted)

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

Docker

# docker-compose.yml
services:
  n8n:
    image: n8nio/n8n
    environment:
      - N8N_CUSTOM_EXTENSIONS=/home/node/.n8n/custom
    volumes:
      - n8n_data:/home/node/.n8n

Then inside the container:

cd /home/node/.n8n/nodes
npm install n8n-nodes-vmass

Credentials

1. Go to Credentials → Create New → VMASS API
2. Enter:
   • API Key: Get from VMASS Dashboard > Settings > API Keys
   • Base URL: https://your-domain.vmass.vn/api/public
3. Click Save

Test Key vs Live Key

| Type | Format | Purpose | |------|--------|---------| | Test Key | vmss_test_... | Sandbox — no real data affected | | Live Key | vmss_live_... | Production — real data |

Nodes

VMASS (Action Node)

Perform CRUD operations on VMASS resources.

| Resource | Operation | Description | |----------|-----------|-------------| | Order | Create | Create a new order with items | | | Get | Get order details by ID | | | Get Many | List orders with filters (status, date range, pagination) | | | Update Status | Update order status (pending/processing/completed/paid/cancelled) | | Product | Create | Create a new product | | | Get | Get product details | | | Get Many | List products (filter by category, name) | | | Update | Update product information | | | Delete | Soft delete a product | | Inventory | Create | Add a new inventory item | | | Get | Get inventory item details | | | Get Many | List all inventory items | | | Get Low Stock | Get items below threshold | | | Update Quantity | Add, subtract, or set quantity | | Customer | Create | Create a new customer | | | Get | Get customer details | | | Get Many | List customers (filter by phone) | | | Update | Update customer information | | | Delete | Soft delete a customer | | Webhook | Get Many | List registered webhooks | | | Register | Register a new webhook endpoint | | | Unregister | Remove a webhook | | | Test | Send a test event to a webhook |

VMASS Trigger (Trigger Node)

Receive real-time webhook events from VMASS. Supports webhook signature verification via HMAC-SHA256.

| Event | Description | |-------|-------------| | order.created | New order created | | order.paid | Order payment received | | order.shipped | Order shipped | | order.completed | Order completed | | order.cancelled | Order cancelled | | product.updated | Product information updated | | inventory.low_stock | Inventory item below threshold | | inventory.expiring | Inventory item expiring soon | | customer.created | New customer created | | payment.received | Payment received |

Features

• Retry logic: Auto-retry on rate limits (429) and server errors (5xx) with exponential backoff
• Timeout: 30s request timeout
• Error handling: Supports n8n's "Continue on Fail" mode
• Webhook security: HMAC-SHA256 signature verification with replay attack protection
• Response normalization: Automatically unwraps VMASS API response format

Example Workflows

Send Telegram notification on new order

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

Auto-update Google Sheets on completed orders

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

Slack alert on low stock

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

Sync customers to CRM

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

Support

• Website: vmass.vn
• Email: [email protected]
• Hotline: 0708 245 246
• API Docs: api.vmass.vn

License

MIT