Description

n8n PrestaShop 8 Node


A comprehensive n8n community node for PrestaShop 8 integration with automatic XML/JSON conversion and full CRUD support.

🌍 Documentation Languages:

• 🇬🇧 English (this file) – EN.md”>Installation
• 🇫🇷 FR.md”>Exemples | Installation
• 🇩🇪 DE.md”>Beispiele | Installation
• 🇪🇸 ES.md”>Ejemplos | Instalación

📚 Complete Documentation Hub

🚀 Quick Start | ✨ Features | 📚 Documentation | 🎯 Examples | 🤝 Contributing

—

🎯 Overview

The first n8n node that truly simplifies PrestaShop 8 integration:

• ✅ Full CRUD operations without writing a single line of XML
• ✅ Intuitive graphical interface with dynamic dropdown menus
• ✅ Automatic XML/JSON conversion – PrestaShop XML ↔ Simple JSON
• ✅ 25+ resources supported: products, customers, orders, stocks…
• ✅ Advanced filtering with 10 search operators
• ✅ Raw mode for debugging and advanced use cases
• ✅ Retry on error to automatically recover from transient failures (timeouts, connection drops)

🚀 Quick Start

Installation

npm install n8n-nodes-prestashop8

PrestaShop Configuration

1. Enable Webservice: Settings > Web Service > Enable
2. Create API Key with CRUD permissions
3. Note the URL: https://your-store.com/api

n8n Configuration

// PrestaShop 8 API Credentials
{
  "baseUrl": "https://your-store.com/api",
  "apiKey": "YOURAPIKEY"
}

First Workflow

// List active products
{
  "resource": "products",
  "operation": "search",
  "filters": {
    "filter": [
      { "field": "active", "operator": "=", "value": "1" }
    ]
  }
}

✨ Features

🔄 Complete CRUD Operations

| Operation | Description | Example |
|———–|————-|———|
| List | Retrieve collections | All products |
| Get by ID | Individual retrieval | Product ID 123 |
| Search | Search with filters | Products > €20 |
| Create | Create new entities | New customer |
| Update | Modify existing | Update stock |
| Delete | Remove entities | Delete order |

📊 Supported Resources

👥 CRM & Customers (5 resources)
customers – Store customers
addresses – Shipping/billing addresses
groups – Customer groups and pricing
customer_threads – Customer service conversations
customer_messages – Individual messages
📦 Product Catalog (9 resources)
products – Product catalog
combinations – Product variations (size, color…)
stock_availables – Stock management
categories – Category tree
manufacturers – Brands and manufacturers
suppliers – Suppliers
tags – Product tags
product_features – Product characteristics
product_options – Customization options
🛒 Orders & Sales (8 resources)
orders – Store orders
order_details – Order line items
order_histories – Status change history
order_states – Possible order states
order_carriers – Carriers by order
order_invoices – Invoices
carts – Shopping carts
cart_rules – Discount codes and promotions

🔍 Advanced Filtering

| Operator | Description | Example |
|———-|————-|———|
| = | Equal | price = 19.99 |
| != | Not equal | active != 0 |
| > / >= | Greater than | stock > 10 |
| < / <= | Less than | price <= 50 |
| LIKE | Contains | name LIKE %iPhone% |
| NOT LIKE | Does not contain | ref NOT LIKE %OLD% |
| BEGINS | Starts with | name BEGINS Apple |
| ENDS | Ends with | ref ENDS -2024 |

🎛️ Advanced Options

• Pagination: limit=20 or limit=10,30
• Sorting: [priceASC], [dateadd_DESC]
• Fields: full, minimal, or custom
• Debug: URL, headers, timeout
• Retry on error: automatically retry a call that fails on a transient error — network timeout, connection drop, 5xx server error or 429 rate-limit (never on 4xx). Configurable max attempts and fixed delay between attempts; the retry budget is reset for each failing call. Each attempt is logged to the n8n server logs.

🎯 Usage Examples

E-commerce Automation

// Daily ERP → PrestaShop stock sync
Cron → ERP API → Transform → PrestaShop 8 Node → Slack Alert

Marketing Automation

// New customers → CRM + welcome email
PrestaShop Webhook → PrestaShop 8 Node → CRM → Mailchimp

Business Intelligence

// Daily sales report
Cron → PrestaShop 8 Node → Calculate KPIs → Email Report

📚 Documentation

• 🎯 Practical Examples - Detailed use cases
• 🛠️ Installation Guide - Step-by-step setup
• 📝 Changelog - Updates and fixes

🐛 Issues & Support

Common Problems

• 401 Unauthorized → Check API key and permissions
• 404 Not Found → Verify base URL and Webservices enabled
• Timeout → Increase timeout in debug options, or enable Retry on error to auto-recover from transient timeouts

Get Help

• 🐞 GitHub Issues - Bugs and questions
• 🌐 n8n Community - Forum discussions
• 📖 Documentation - Detailed guides

🤝 Contributing

Contributions are welcome! Here's how to participate:

Quick Start Development

git clone https://github.com/PPCM/n8n-nodes-prestashop8.git
cd n8n-nodes-prestashop8
npm install
npm run dev  # Watch mode

Contribution Process

1. Fork the project
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit changes (git commit -m 'Add amazing feature')
4. Push the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

Types of Contributions

• 🐞 Bug fixes
• ✨ New features
• 📚 Documentation improvements
• 🧪 Additional tests
• 🎨 UI/UX improvements

Guidelines

• TypeScript code with strict typing
• Unit tests for new features
• Updated documentation
• Respect ESLint + Prettier

📊 Roadmap

v1.1 (Q1 2024)

• [ ] Intelligent caching to optimize API calls
• [ ] Pre-configured workflow templates
• [ ] Bulk operations for batch processing
• [ ] Integrated PrestaShop webhooks

v1.2 (Q2 2024)

• [ ] PrestaShop Cloud support
• [ ] Advanced multi-store
• [ ] Visual field mapping
• [ ] Performance metrics

v2.0 (Q3 2024)

• [ ] GraphQL support (if available in PrestaShop)
• [ ] AI-powered data transformation
• [ ] Real-time synchronization
• [ ] Advanced analytics dashboard

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.

🙏 Acknowledgments

• n8n Team for the fantastic automation tool
• PrestaShop Community for API documentation
• Contributors who improve this project

🌟 Star History


---

Revolutionize your e-commerce with n8n and PrestaShop 8 🚀

⬆ Back to top