Description

n8n-nodes-gapli


This is an n8n community node for GAPLI — an automated dropshipping platform. It lets you manage products, orders, wholesalers, marketplace accounts, and multi-market regions directly from your n8n workflows.

GAPLI is a B2B SaaS platform that enables operators to run automated dropshipping businesses across marketplaces (Allegro, Erli) and e-commerce stores (WooCommerce, PrestaShop). It handles product catalogs, order fulfillment, price management, inventory synchronization, and multi-marketplace integrations — all from a single dashboard.

🌍 Market-Aware: All product, wholesaler, and analytics queries can be scoped to a specific market/region (e.g. Poland, Czech Republic) using a dynamic dropdown with country flags.

n8n is a fair-code licensed workflow automation platform.

—

Installation · Nodes · Credentials · Operations · AI Agent Tool · Usage Examples · Compatibility · Resources

—

Installation

Follow the installation guide in the n8n community nodes documentation.

npm package name: n8n-nodes-gapli

Quick Install via n8n UI

1. Go to Settings → Community Nodes
2. Click Install a community node
3. Enter n8n-nodes-gapli and click Install

Manual Install (self-hosted n8n)

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

Then restart n8n.

—

Nodes

This package includes two nodes and one credential type:

🟣 GAPLI Node (Regular + AI Tool)

The main node for interacting with the GAPLI API. Supports all CRUD operations across multiple resources. Also available as an AI Agent Tool — connect it to an AI Agent node and let AI manage your dropshipping operations.

⚡ GAPLI Trigger Node (Polling)

A trigger node that polls the GAPLI API at regular intervals and fires your workflow when events occur:

• New Order — triggers when a new order is placed
• Order Status Changed — triggers when an order transitions between statuses
• New Product — triggers when new products appear in the catalog

—

Credentials

GAPLI API Key

To use this node, you need a GAPLI API key:

1. Log in to your GAPLI Dashboard
2. Navigate to Integrations (sidebar menu)
3. Go to the API Keys tab
4. Click Generate New Key
5. Copy the key (starts with gapli_)
6. In n8n, create new GAPLI API credentials and paste the key

| Field | Description |
|—|—|
| API Key | Your GAPLI API key (starts with gapli_) |
| Base URL | Default: https://gapli.com. Change only for staging/development. |

The credential includes an automatic connection test that calls the /health endpoint to verify your API key.

—

Operations

📦 Product

| Operation | Description |
|—|—|
| Get Many | Retrieve a list of products from your catalog. Supports market scoping and filters: parser ID, SKU, search text, EAN/GTIN, availability, price range, stock, oversized, exclude already listed. Full Database Scan mode available. |
| Get by SKU | Retrieve a single product by its SKU (Stock Keeping Unit). |
| Batch EAN Lookup | Look up multiple products by EAN/GTIN barcodes in a single request (up to 100). |
| Batch SKU Lookup | Look up multiple products by SKU identifiers in a single request (up to 100). |

🛒 Order

| Operation | Description |
|—|—|
| Get Many | Retrieve a list of orders. Filter by status, date range (from/to). |
| Get by ID | Retrieve a single order by its numeric ID. |

🏭 Wholesaler

| Operation | Description |
|—|—|
| Get Many | Retrieve the list of available wholesalers/suppliers. Supports market scoping and active status filter. |

🏪 Marketplace

| Operation | Description |
|—|—|
| Get Accounts | Retrieve connected marketplace accounts (Allegro, Erli). |
| Get Products | Retrieve products listed on marketplace accounts. Filter by account ID and platform. |

🏬 Store

| Operation | Description |
|—|—|
| Get Many | Retrieve all stores (WooCommerce, PrestaShop, etc.) for the authenticated operator. |

🌍 Market

| Operation | Description |
|—|—|
| Get Many | Retrieve the list of available markets/regions with country codes, currencies, and flag emojis. |

🏷️ Industry

| Operation | Description |
|—|—|
| Get Many | List available product industries with wholesaler counts per industry. |

📊 Analytics

| Operation | Description |
|—|—|
| Top Products | Get a ranking of best-selling products by period (7 days, 30 days, 90 days). |
| Sales Summary | Revenue in source transaction currency (totalrevenuesourcecurrency) and PLN (totalrevenue_pln). Supports Account ID and Store ID filters for per-account scoping. Old gross/net aliases preserved but deprecated. |
| Stock Alerts | Intelligent low-stock detection with estimated days until stockout. |
| Marketplace Health | Allegro account performance: sync rate, listing quality, error rates. |
| Global Top Products | 🌐 Platform-wide best-selling products across ALL operators (anonymized, quantity-based). |
| Global Category Trends | 🌐 Wholesaler/category popularity with trend direction (up/down/stable) and % change. |
| Platform Stats | 🌐 Platform-wide counters: orders, active operators, catalog size, marketplace accounts. |
| Global Price Benchmarks | 🌐 Average/min/max gross prices per wholesaler for competitive price analysis. |

💚 Health

| Operation | Description |
|—|—|
| Check | Verify the GAPLI API status and your authentication. Returns service info, rate limits, and available endpoints. |

—

AI Agent Tool

The GAPLI node is configured with usableAsTool: true, which means it can be used as a tool for AI Agent nodes in n8n.

How to use:

1. Add an AI Agent node to your workflow
2. Connect the GAPLI node as a tool
3. The AI agent can now autonomously:
– Search and retrieve products
– Check order statuses
– List marketplace accounts
– Monitor inventory
– Access global market intelligence

This is particularly useful for building conversational e-commerce assistants or autonomous dropshipping agents.

—

Usage Examples

Example 1: New Order Notification to Slack

GAPLI Trigger (New Order) → Slack (Send Message)

Set up the GAPLI Trigger with “New Order” event, then format and send order details to your Slack channel.

Example 2: Daily Inventory Check

Schedule Trigger (Daily) → GAPLI (Get Many Products, available=true) → Google Sheets (Append)

Automatically export your available inventory to a Google Sheet every day.

Example 3: Order Status Tracking

GAPLI Trigger (Order Status Changed) → IF (status=shipped) → Email (Send)

Send an email notification when orders are shipped.

Example 4: AI-Powered Product Assistant

Chat Trigger → AI Agent → GAPLI Tool (Products/Orders)

Build a conversational assistant that can answer questions about your products, orders, and inventory using natural language.

Example 5: Global Market Intelligence Report

Schedule Trigger (Weekly) → GAPLI (Global Top Products + Platform Stats) → Email (Send Report)

Generate a weekly market intelligence report with platform-wide bestsellers and performance trends.

—

Compatibility

| Requirement | Version |
|—|—|
| n8n | v1.0.0 or higher |
| Node.js | v22 or higher |
| GAPLI API | v1.0 |

Tested on n8n self-hosted and n8n Cloud.

—

Resources

• GAPLI Dashboard — Platform dashboard & API key management
• GAPLI API Documentation — Full API reference
• n8n Community Nodes Documentation — How to install community nodes
• n8n Community Forum — Get help and share workflows

—

Version History

0.8.0 (2026-05-02)

• 🌍 New: Market Selector — dynamic dropdown with country flag emojis on Product, Wholesaler, Analytics, and Marketplace resources. Scope queries to specific regions (e.g. 🇵🇱 Poland).
• 🌐 New: Market Resource — Get Many operation to list all available markets with country codes, currencies, and flags.
• 🔎 New: Batch EAN Lookup — look up multiple products by EAN/GTIN barcodes in a single POST request (up to 100).
• 🔎 New: Batch SKU Lookup — look up multiple products by SKU identifiers in a single POST request (up to 100).
• ⚡ New: Trigger Market Filter — scope “New Product” trigger to a specific market/region.
• 🔄 Backward Compatible — Market selector defaults to “All Markets” (no filter). Existing workflows work unchanged.

0.7.0 (2026-04-27)

• ✨ New: Max Items Safety Parameter — control how many products Full Database Scan returns (100–50,000)
• ✨ New: Pagination Metadata (_meta) — every product includes scan context data
• 🐛 Fix: manufacturer column crash — dynamic column existence checking
• 🐛 Fix: Silent error swallowing — parser errors now logged

0.6.0 (2026-04-26)

• 🐛 Critical Fix: Full Database Scan + Search HTTP 500 — name column dynamically checked; search falls back to SKU-only for partitions without name
• 🐛 Critical Fix: Search + Exclude Already Listed HTTP 500 — same root cause + 50K SKU safety cap
• ✨ New: EAN/GTIN Exact Match Filter — search by exact barcode
• ✨ New: Exclude Metadata — excludemeta in response for filter verification
• 💡 Improved: UI Hints — Full Database Scan and Exclude Already Listed descriptions enhanced

0.5.0 (2026-04-26)

• ✨ New: Parser-First Pagination — Full Database Scan no longer truncates at 50K; iterates per-parser
• ✨ New: Has EAN/GTIN Filter — return only products with valid EAN
• ✨ New: Exclude Parser IDs — skip specific wholesaler parsers
• ✨ New: Category IDs in Response — category_ids field added to product output

0.4.0 (2026-04-25)

• ✨ New: Full Database Scan Mode — bypass pagination limits, scan all parser partitions
• ✨ New: Wholesaler Dropdown — searchable dropdown replacing numeric Parser ID input

0.3.0 (2026-04-24)

• ✨ New: Server-Side Product Filters — 5 filters applied before pagination: stockmin, pricegrossmin, pricegrossmax, excludeoversized, excludealreadylistedonaccounts
• ✨ New: Global Analytics — 4 platform-wide operations for market intelligence:

– Get Global Top Products, Get Global Category Trends, Get Platform Stats, Get Global Price Benchmarks

0.2.0 (2026-04-22)

• ✨ New: Store Resource — retrieve operator stores
• ✨ New: Industry Resource — browse product industries with wholesaler counts
• ✨ New: Analytics Resource — 4 operations: Top Products, Sales Summary, Stock Alerts, Marketplace Health
• 🔧 Enhanced: Orders — added marketplaceaccountname field showing Allegro/Erli account name

0.1.0 (2026-04-22)

• 🎉 Initial release
• GAPLI Node with Product, Order, Wholesaler, Marketplace, and Health resources
• GAPLI Trigger Node with polling support for New Order, Order Status Changed, and New Product events
• AI Agent Tool support (usableAsTool)
• GapliApi credentials with connection testing
• Professional SVG icons (light & dark mode)

—

License

MIT — © 2026 GAPLI Global LTD