vmass

n8n community node for VMASS POS integration

Package Information

Downloads: 5 weekly / 31 monthly
Latest Version: 0.1.3
Author: VMASS

Available Nodes

VMASS icon
VMASS
VMASS POS System Integration - Quản lý đơn hàng, sản phẩm, kho, khách hàng
VMASS Trigger icon
VMASS Trigger
Nhận webhook events từ VMASS POS System

Documentation

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

License

MIT

Discussion