JSPM

n8n-nodes-vmass

0.1.3
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 11
  • Score
    100M100P100Q41090F
  • 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

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

  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