n8n VitePOS Bridge Node

Private n8n community node package for the VitePOS automation bridge WordPress plugin and the VitePOS Profit & Loss analytics plugin.

What It Adds

• A VitePOS Bridge API credential in n8n.
• A VitePOS Bridge action node.
• Operations for health, manifest, WhatsApp admin checks, product/customer/vendor list/get/update/upserts, order list/get/create, purchase list/get/receiving, batch status, batch updates, and analytics.
• No-code field mode for products, customers, vendors, orders, purchases, purchase batches, batch allocation, and analytics filters.
• A raw request operation for bridge endpoints added later.

Credential Fields

• WordPress Site URL: for example https://example.com
• WordPress Username: a WordPress user with WooCommerce management access
• WordPress Application Password: the WP Application Password for that user

Recommended WhatsApp Flow

1. Start with your WhatsApp trigger or Meta webhook.
2. Add VitePOS Bridge.
3. Choose WhatsApp -> Check Admin Sender.
4. Set wa_id to the incoming sender ID, usually contacts[0].wa_id from Meta webhooks.
5. Add an IF node checking data.allowed if the bridge response is wrapped, or allowed if you enable simplified response handling later.
6. Only route allowed admin senders to batch, expiry, cost, and analytics actions.

No-Code VitePOS Actions

Most write operations default to Use Fields, so you can build workflows without writing JSON:

• Order -> Create Order: add customer details and repeatable order items. WhatsApp orders default to FEFO batch allocation so the customer never chooses expiry dates.
• Product, Customer, Vendor, Order, and Purchase -> List or Get: fetch records directly from the bridge without using Raw Request. Customer -> List Customers can search by customer name, first name, last name, email, or phone across all WordPress roles by default, which covers VitePOS customers saved as subscribers. Order -> List Orders can filter by customer name/phone/email plus Product ID/SKU/Variation ID/Product Search and returns matching_line_items plus matched_quantity. Purchase -> List Purchases can filter by Product ID/SKU/Variation ID or Product Search and returns matching_items plus matched_quantity.
• Purchase -> Create Purchase: add vendor/outlet fields and repeatable purchase items with Batch No, Expiry Date, Purchase Cost, Sale Price, and quantity.
• Batch -> Get Batch Status: find expired, near-expiry, valid, and no-expiry batches using product/outlet filters.
• Analytics -> Get Summary, Get Product Leaderboard, Get Product Analytics, or Sync Woo Dashboard: use date range, month, product, category, customer, order status, sort, and limit fields.

Use Advanced JSON only when you need custom payloads beyond the normal fields.

Install From n8n UI

After this package is published to npm, install it from self-hosted n8n without SSH:

1. Open n8n as an owner/admin user.
2. Go to Settings -> Community Nodes.
3. Select Install.
4. Enter the package name:

n8n-nodes-vitepos-bridge

To pin a specific version:

[email protected]

5. Confirm the community node warning and install.
6. Restart n8n if your instance asks for it.
7. Search for VitePOS Bridge in the node picker.

Publish To npm Through GitHub

This repo includes .github/workflows/publish.yml.

One-time setup:

1. Create a GitHub repo for this package.
2. Replace YOUR_GITHUB_USERNAME in package.json with the repo owner.
3. Push this package folder to the repo.
4. Create an npm access token with publish permission.
5. Add it to the GitHub repo secrets as NPM_TOKEN.
6. Create a GitHub release for the current package version, or run the Publish to npm workflow manually.

The package name n8n-nodes-vitepos-bridge must be available on npm at publish time.

Manual Self-Hosted Install

For a private Docker install, copy this package into the n8n container/image and install it where n8n loads community nodes. If your n8n setup uses the custom nodes folder, copy the compiled dist/credentials and dist/nodes folders into ~/.n8n/custom/.

For a global npm install of n8n, install this package in the same Node environment as n8n:

npm install /path/to/n8n-nodes-vitepos-bridge

Restart n8n after installing. Then search for VitePOS Bridge in the n8n node picker.