# Démarrer avec la synchronisation

La synchronisation entre Prestashop et Business Central passe deux files de messages : les messages entrants (modifications venant de Prestashop) et les messages sortants (modifications venant de Business Central).

## Démarrage rapide

Pour démarrer rapidement avec la synchronisation,

1. Ouvrez la page **Paramètres CAP Online - Webshop**.
2. Lancez le traitement **Exécuter les traitements automatiques Prestashop** en choisissant les éléments suivants :
   Sous l'onglet _Options_ :
   * Récupérer les données
   * Traiter les messages entrants
   * Traiter les messages sortants
   Sous l'onglet _Filtre: Entité_ :
   * Appliquer un filtre sur l'entité _Commande|Règlement commande_.
3. Cliquez sur **OK**.

Répétez, ou [automatisez](#automatiser-la-synchronisation), l'étape 2 et 3 pour récupérer les nouvelles commandes.

## Gérer les messages entrants

La page des messages entrants liste les modifications ayant eu lieu dans Prestashop et doivent être importées dans Business Central.

Les messages entrants sont approvisionnés :

* manuellement lorsque vous cliquez sur **Récupérer les données** ou **Forcer la récupération des données** dans la liste des entités.
* automatiquement lorsque vous lancez le traiement **Exécuter les traitements automatiques Prestashop** avec l'option **Récupérer les données** cochées.

Les messages entrants arrivent au _Statut_ = _Créé_.
Pour démarrer leur interprétation, sélectionnez les messages à traiter et cliquez sur l'action **Traiter les messages**.

Si l'interprétation du message est un succès, le statut passe à _Traité_.
Sinon, il est placé dans le statut _Erreur_ et vous pouvez cliquer sur le champ _Statut du message_ pour voir l'erreur complète rencontrée.

## Gérer les messages sortants

La page des messages sortants liste les modifications qui se sont produites dans Business Central et qui doivent être exportées vers Prestashop.

Les messages sortants sont approvisionnés automatiquement lorsque vous effectuez des modifications dans Business Central sur des enregistrements synchronisés avec Prestashop.

Les messages sortants sont créés au _Statut_ = _Créé_.
Pour démarrer leur conversion en message pour Prestashop et envoyer ce message à Prestashop, cliquez sur l'action **Traiter les messages**. Les enregistrements sélectionnés sont alors convertis en un message Prestashop et envoyés à Prestashop.

Si la conversion et l'envoi du message sont un succès, le statut passe à _Traité_.
Sinon, il est placé dans le statut _Erreur_ et vous pouvez cliquer sur le champ _Statut du message_ pour voir l'erreur complète rencontrée.

## Automatiser la synchronisation

Vous effectuez normalement un traitement manuel des messages entrants et sortants lorsque vous démarrez avec CAP Online - Webshop.
Une fois la synchronisation entièrement paramétrée et testée, vous souhaitez généralement automatiser son exécution.

Pour planifier la synchronisation automatique, réalisez les opérations suivantes :

1. Choisissez ![](/public/svg/search-right.svg) et tapez **Ecritures file d'attente des travaux**.
2. Dans la liste, cliquez sur **Nouveau**.
3. Dans le champ _Type objet à exécuter_, indiquez _Report_.
4. Dans le champ _ID objet à exécuter_, indiquez _70345101_.
5. Cliquez sur l'action **Page requête état** et cochez les tâches à automatiser.
6. Dans l'onglet, _Répétition_ renseignez les jours et la fréquence à laquelle la synchronisation doit se produire.
7. Cliquez sur l'action **Définir le statut sur Prêt**.

> [!IMPORTANT]
> Continuez de surveiller régulièrement les messages entrants/sortants en erreur.

## Synchroniser les stocks

### Importer les stocks depuis Prestashop

Si vous démarrez Business Central alors que vous disposez déjà d'un site Prestashop, vous pourriez vouloir récupérer les stocks de Prestashop pour initialiser les stocks de Business Central.
Pour ce faire, suivez les étapes ci-dessous :

1. Recherchez la traitement **Exécuter les traitements automatiques Prestashop**.
2. Cochez les cases **Récupérer les données** et **Traiter les messages entrants**.
3. Dans l'onglet **Filtre: Entité**, sélectionnez les entités _Boutique en ligne_, _Produit_ et _Déclinaison_.
4. Cliquez sur **OK**.

L'opération peut prendre quelques minutes et vise à s'assurer que tous les articles sont bien synchronisés.

5. Recherchez la page **Boutiques en lignes**.
6. Spécifiez le **Code magasin** associé à chacune des boutiques.
7. Recherchez la page **Paramètres CAP Caisse**.
8. Sous l'onglet **Stocks**, cochez la case **Importer les stocks vers une feuille** et renseignez la feuille article à renseigner pour l'import des stocks.

9. Recherchez la traitement **Exécuter les traitements automatiques Prestashop**.
10. Cochez les cases **Récupérer les données** et **Traiter les messages entrants**.
11. Dans l'onglet **Filtre: Entité**, sélectionnez l'entité _Disponibilité stock_.
12. Cliquez sur **OK**.

13. Ouvrez la feuille article renseignée plus tôt, contrôlez les données et validez la feuille.

> [!TIP]
> Maintenant que les stocks figurent dans Business Central, vous pourriez vouloir désactiver complètement la remontée des stocks depuis Prestashop.
> Pensez pour cela à décocher la case **Importer les stocks vers une feuille** dans les **Paramètres CAP Caisse**.

### Exporter les stocks vers Prestashop

Les stocks sont envoyés à Prestashop à partir des données calculées dans la table des disponibilités articles.
Pour visualiser le contenu de cette table, recherchez la page **Disponibilité articles**.

Pour actualiser la disponibilité en stock, CAP Online - Webshop fournit un traitement de mise à jour que vous pouvez lancer en recherchant la tâche **Calculer disponibilité articles**.

La disponibilité en stock est calculée de la même manière que la page **Disponibilité article par période**. La disponibilité est filtrée pour le magasin associé à la boutique en ligne pour laquelle le calcul est réalisé et à la date du jour de calcul.

> [!TIP]
> Pensez à planifier cette tâche dans la file d'attente des travaux si vous souhaitez que les stocks soient automatiquement mis à jour dans Prestashop.

La mise à jour des stocks dans Prestashop nécessite que l'entité _Disponibilité stock_ soit synchronisée en import et en export.

## Politique de rétention des données

Les données stockées dans les messages entrants et sortants peuvent rapidement consommées beaucoup d'espace et vous voudrez sûrement les éliminer au bout d'un certain temps.

Pour ce faire, configurez une [Stratégie de rétention des données](https://learn.microsoft.com/fr-fr/dynamics365/business-central/admin-data-retention-policies).

Pour les messages entrants, utilisez la table _Message entrant_ (70345102) et _Message sortant_ (70345103) pour les messages sortants.
La stratégie initiale interdie la suppression automatique des messages non traités.
En revanche, vous pouvez personnaliser la période de rétention des messages traités qui est par défaut d'un mois.
