Synchronisation commandes site prestashop vers rep dolibarr

# Cahier des charges — Automatisation de l'insertion des commandes PrestaShop → Dolibarr

**Entreprise** : Duplica Print
**Site** : PrestaShop (impression numérique petit/grand format, signalétique)
**ERP** : Dolibarr
**Gestionnaire de production** : Fresh Process (alimenté depuis Dolibarr)

## Contexte

Les commandes passées sur le site PrestaShop sont aujourd'hui partiellement synchronisées vers Dolibarr : les lignes de commande et les clients sont créés automatiquement, mais deux éléments doivent être complétés manuellement à chaque commande (copier-coller) :

1. **Le descriptif des options choisies par le client** (dimensions, matière, finition, etc.), saisi via le configurateur à champs libres de PrestaShop (fonctionnalité "Personnalisation" — texte libre, pas des déclinaisons classiques).
2. **Les fichiers d'impression** uploadés par le client lors de la commande (PDF prêts à imprimer), qui doivent être récupérés et rangés sur le serveur interne, dans un dossier nommé par numéro de commande.

Sans cela, les commandes ne sont pas exploitables telles quelles dans Fresh Process, qui se base sur les informations présentes dans Dolibarr.

## Pré-requis identifiés

- Chaque produit du site PrestaShop doit avoir une référence correspondante dans le catalogue produits Dolibarr (mapping par SKU/référence). **Ce travail de mapping initial est à la charge de Duplica Print**, mais le prestataire doit vérifier qu'il est bien en place avant de développer la suite, et signaler les références manquantes.
- Accès Webservice API PrestaShop (clé à générer côté back-office).
- Accès API REST Dolibarr (module à activer + clé à générer).
- Accès au stockage de fichiers interne (dossier réseau ou FTP/SFTP) où ranger les fichiers d'impression.

## Périmètre de la mission

### 1. Script de synchronisation complémentaire
Développer un script (langage au choix du prestataire — PHP, Python ou Node.js) qui, pour chaque nouvelle commande PrestaShop :

- Récupère le détail de la commande via l'API Webservice PrestaShop, y compris les données de **customization** (champs personnalisés : texte saisi et fichiers joints).
- Complète la **description de la ligne de commande correspondante dans Dolibarr** (via l'API REST Dolibarr) avec le texte des options renseignées par le client.
- Télécharge les **fichiers d'impression joints** à la commande et les enregistre dans le dossier serveur dédié, nommé par numéro de commande (ex. `/commandes/CMD-••••••••••/`).

### 2. Fréquence d'exécution
Le volume de commandes étant de 5 à 20 par jour, un déclenchement périodique (cron toutes les 15-30 minutes) est suffisant — pas besoin de temps réel à la seconde.

### 3. Gestion des erreurs
- Si un produit n'a pas de correspondance dans le catalogue Dolibarr, la commande doit être signalée (log ou notification par e-mail) plutôt que silencieusement ignorée.
- Prévoir un journal des commandes traitées (succès/échec) consultable facilement.

### 4. Hébergement du script
Le script doit pouvoir tourner en autonomie sur un petit serveur (VPS ou hébergement existant), sans dépendre d'un poste de travail allumé.

## Livrables attendus

- Script fonctionnel et documenté (installation, configuration des clés API, lancement du cron).
- Courte procédure de déploiement écrite pour une personne non-développeuse.
- Test réalisé sur un échantillon de commandes réelles, validé avec Duplica Print avant mise en production.

## Non inclus dans cette mission (pour info)
- Le mapping initial du catalogue produits PrestaShop ↔ Dolibarr (à faire en amont par Duplica Print).
- La vérification automatique de la résolution/format des fichiers clients (sujet à traiter séparément si besoin).