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, adult products, 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). Include Financials attaches the money result to every order on the page in the same request. |
| Get by ID | Retrieve a single order by its numeric ID. Optional Include: Conversation (buyer messages, disputes, claims), Diagnostics (wholesaler per item, status timings, issue reason codes, warning flags) and Financials (revenue, costs, commission, refunds, operator payout). All ride along on the same request — no extra HTTP calls. |
| Get Conversation Analysis | AI conclusion for the order: outcome, root cause, what went well, what went wrong, with evidence message IDs. Paid plans only (Commerce Plan and above) — returns HTTP 402 otherwise. Cached per conversation state. |

#### 💰 Financials

Requires the financials scope on your API key (Dashboard → Integrations → API Keys → wallet
icon). Read-only, and only your own orders.

Two numbers, on purpose. result.totalprofit is the order’s result; operatorresult.total
is what you end up with — operator pay has two parts, the marketplace commission Allegro
withholds from the payout (stays with you) and the profit share from the e-Wallet. A “total profit”
column belongs on operator_result.total.

Always check warnings before averaging anything. commissionzerocrossborder means CZ/SK/HU
orders carry no commission in our database, so their margin is overstated and **not comparable
with PL**. commissionnotrecovered is a written-off order whose commission Allegro never
reversed — the Pool nets to zero and the loss appears nowhere else.

💬 Message

Read-only access to buyer conversations. Requires the messages scope on your API key
(Dashboard → Integrations → API Keys → message icon). No API key can send a message to a buyer.

| Operation | Description |
|—|—|
| Get Many Threads | Conversation threads, disputes and claims. Filter by Order ID, Source Order ID, thread type, platform, account and date range. |
| Get Thread | A single thread with its messages. |

> ⚠️ Disputes and claims have no internal Order ID. They link to an order ONLY through
> Source Order ID (the marketplace order number). Filtering by Order ID alone runs without
> error and returns just the ordinary correspondence — silently missing exactly the threads
> that describe what went wrong.

> 💡 Automated messages are hidden by default. GAPLI’s own sends (invoice notifications,
> review requests, shipping updates) are roughly half of all thread traffic. Leaving them out
> keeps an AI analysis about the buyer conversation rather than about our notifications.
> They are still counted in automatedmessageshidden.

🏭 Wholesaler

| Operation | Description |
|—|—|
| Get Many | Retrieve the list of available wholesalers/suppliers, each with its industries. 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. |
| Get Wholesaler Coverage | Ready-made per-wholesaler counts for your Allegro accounts — how many products from each wholesaler sit on each account, and how many accounts each wholesaler is spread across. Leave the account empty to cover every account in one request. Allegro only. |

🏬 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.

⚠️ An agent sourcing by product name should set the Adult Products filter to exclude. A search
for “toys” walks the whole catalogue and the erotic wholesalers hold 124 products with “toy” in the
name — an agent that does not set the filter will happily list vibrators alongside children’s toys,
and nobody finds out until the offers are live. Every product carries is_adult, so an agent can
also branch on the field instead of trusting the name.

—

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