Package Exports

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-prestashop8) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

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) - Examples | Installation
🇫🇷 Français - Exemples | Installation
🇩🇪 Deutsch - Beispiele | Installation
🇪🇸 Español - 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

🚀 Quick Start

Installation

npm install n8n-nodes-prestashop8

PrestaShop Configuration

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

n8n Configuration

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

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 (6 resources)

customers - Store customers
addresses - Shipping/billing addresses
groups - Customer groups and pricing
customer_threads - Customer service conversations
customer_messages - Individual messages
guests - Non-registered visitors

📦 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: [price_ASC], [date_add_DESC]
Fields: full, minimal, or custom
Debug: URL, headers, timeout

🎯 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
📋 Project Summaries - Executive summaries and presentations

🐛 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

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

Fork the project
Create a feature branch (git checkout -b feature/amazing-feature)
Commit changes (git commit -m 'Add amazing feature')
Push the branch (git push origin feature/amazing-feature)
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