# n8n PrestaShop 8 Node
[](https://www.npmjs.com/package/n8n-nodes-prestashop8)
[](https://www.npmjs.com/package/n8n-nodes-prestashop8)
[](https://github.com/PPCM/n8n-nodes-prestashop8/blob/main/LICENSE)
[](https://github.com/PPCM/n8n-nodes-prestashop8/issues)
[](https://github.com/PPCM/n8n-nodes-prestashop8/stargazers)
A comprehensive n8n community node for PrestaShop 8 integration with automatic XML/JSON conversion and full CRUD support.
**π Documentation Languages:**
- π¬π§ **English** (this file) - [Examples](./doc/EXAMPLES_EN.md) | [Installation](./doc/INSTALLATION_EN.md)
- π«π· [**FranΓ§ais**](./doc/README_FR.md) - [Exemples](./doc/EXAMPLES_FR.md) | [Installation](./doc/INSTALLATION_FR.md)
- π©πͺ [**Deutsch**](./doc/README_DE.md) - [Beispiele](./doc/EXAMPLES_DE.md) | [Installation](./doc/INSTALLATION_DE.md)
- πͺπΈ [**EspaΓ±ol**](./doc/README_ES.md) - [Ejemplos](./doc/EXAMPLES_ES.md) | [InstalaciΓ³n](./doc/INSTALLATION_ES.md)
**π [Complete Documentation Hub](./doc/README.md)**
[π Quick Start](#quick-start) | [β¨ Features](#features) | [π Documentation](#documentation) | [π― Examples](#examples) | [π€ Contributing](#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
```bash
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
```javascript
// PrestaShop 8 API Credentials
{
"baseUrl": "https://your-store.com/api",
"apiKey": "YOUR_API_KEY"
}
```
### First Workflow
```javascript
// 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**: `[price_ASC]`, `[date_add_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
```javascript
// Daily ERP β PrestaShop stock sync
Cron β ERP API β Transform β PrestaShop 8 Node β Slack Alert
```
### Marketing Automation
```javascript
// New customers β CRM + welcome email
PrestaShop Webhook β PrestaShop 8 Node β CRM β Mailchimp
```
### Business Intelligence
```javascript
// Daily sales report
Cron β PrestaShop 8 Node β Calculate KPIs β Email Report
```
## π Documentation
- **[π― Practical Examples](./doc/EXAMPLES_EN.md)** - Detailed use cases
- **[π οΈ Installation Guide](./doc/INSTALLATION_EN.md)** - Step-by-step setup
- **[π Changelog](./doc/CHANGELOG.md)** - 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](https://github.com/PPCM/n8n-nodes-prestashop8/issues)** - Bugs and questions
- π **[n8n Community](https://community.n8n.io)** - Forum discussions
- π **[Documentation](./doc/INSTALLATION_EN.md)** - Detailed guides
## π€ Contributing
Contributions are welcome! Here's how to participate:
### Quick Start Development
```bash
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](./LICENSE) file for details.
## π Acknowledgments
- **n8n Team** for the fantastic automation tool
- **PrestaShop Community** for API documentation
- **Contributors** who improve this project
## π Star History
[](https://star-history.com/#PPCM/n8n-nodes-prestashop8&Date)
---
**Revolutionize your e-commerce with n8n and PrestaShop 8** π
[β¬ Back to top](#n8n-prestashop-8-node)