---
title: "Synchronisation"
weight: 60
description: "Fonctionnement de la synchronisation, mode offline, gestion des erreurs et des orphelins."
---

# Synchronisation et mode offline

## Principe de fonctionnement

OfflinePropale est conçu pour fonctionner en mode déconnecté. Toutes les données sont stockées localement sur l'appareil. La synchronisation transfère les données entre l'appareil et le serveur Dolibarr :

- **Téléchargement (pull)** : récupère les données de référence depuis Dolibarr (clients, produits, catégories, etc.)
- **Envoi (push)** : transmet vos offres et les clients créés localement vers le serveur

## Lancer une synchronisation

### Synchronisation manuelle

Appuyez sur le bouton **Synchroniser** dans la barre latérale. La progression s'affiche en temps réel.

![Bouton de synchronisation dans la barre latérale avec indicateur de progression](screenshots/synchronisation.webp)

### Synchronisation automatique

La synchronisation se lance automatiquement à l'ouverture de l'application si une connexion internet est disponible.

## Données synchronisées

### Données téléchargées (pull)

| Donnée | Description |
|--------|-------------|
| Tiers | Clients et prospects |
| Produits | Catalogue produits et services avec prix |
| Catégories | Arborescence des catégories produits |
| Contacts | Contacts associés aux tiers |
| Conditions de paiement | Liste des conditions (30 jours, comptant, etc.) |
| Modes de paiement | Liste des modes (chèque, virement, CB, etc.) |
| Logo société | Logo affiché sur les PDF générés |
| Configuration stocks | Niveaux de stock si activé |

### Données envoyées (push)

| Donnée | Description |
|--------|-------------|
| Clients locaux | Clients créés sur l'appareil (envoyés en premier) |
| Offres | Offres en attente de synchronisation |
| Photos | Documents et photos attachés aux offres |

> **Important :** Les clients créés localement sont envoyés **avant** les offres, pour que les identifiants temporaires soient remplacés par les identifiants Dolibarr définitifs.

## Ordre de synchronisation

La synchronisation s'exécute dans cet ordre :

1. **Téléchargement des données de référence** (clients, produits, catégories, etc.)
2. **Envoi des clients locaux** (ceux créés sur l'appareil)
3. **Envoi des offres en attente** (avec leurs photos)
4. **Détection des orphelins** (offres supprimées sur le serveur)

## Cycle de vie d'une offre

```
Brouillon -> En attente de sync -> Synchronisé -> Converti
                    |
                    +-> Erreur
```

### Détail des statuts

**Brouillon**
- Offre en cours de création
- Non envoyée au serveur
- Modifiable et supprimable

**En attente de synchronisation**
- Offre finalisée, prête à être envoyée
- Modifiable

**Synchronisé**
- Offre reçue et enregistrée sur le serveur Dolibarr
- Visible dans le backoffice
- Non modifiable depuis l'application mobile

**Erreur**
- Échec lors de la synchronisation
- Un message d'erreur est disponible
- Nouvelle tentative possible lors de la prochaine synchronisation

**Converti**
- Offre transformée en devis Dolibarr officiel depuis le backoffice
- Lien vers le devis disponible

## Mode offline

### Ce que vous pouvez faire hors ligne

- Créer de nouvelles offres
- Modifier les offres en brouillon ou en attente
- Consulter vos offres existantes
- Rechercher dans les clients et produits synchronisés
- Générer et partager des PDF
- Prendre des photos
- Créer de nouveaux clients
- Faire signer le client

### Ce que vous ne pouvez pas faire hors ligne

- Synchroniser avec le serveur
- Accéder aux nouvelles données (nouveaux clients, produits modifiés)
- Voir les offres créées sur d'autres appareils

## Gestion des erreurs

### Erreur de synchronisation

Si une offre passe en statut **Erreur**, ouvrez sa fiche pour consulter le message d'erreur.

### Erreurs courantes

**"Client introuvable"**
Le client a été supprimé ou désactivé dans Dolibarr. Modifiez l'offre et sélectionnez un autre client.

**"Produit introuvable"**
Un produit de l'offre n'existe plus dans le catalogue. Modifiez l'offre et remplacez le produit.

**"Erreur 403 Forbidden"**
Problème d'authentification ou de droits. Déconnectez-vous et reconnectez-vous à l'application.

> **Note :** En cas d'erreur 403, la synchronisation s'arrête immédiatement pour éviter un blocage par le pare-feu du serveur. Un message d'avertissement s'affiche pendant 8 secondes.

**"Erreur réseau"**
Connexion instable ou serveur indisponible. Vérifiez votre connexion et réessayez plus tard.

### Nouvelle tentative

Les offres en erreur sont automatiquement réessayées lors de la prochaine synchronisation. Corrigez la cause de l'erreur si possible avant de relancer la synchronisation.

## Offres orphelines

Une offre est considérée comme "orpheline" lorsqu'elle a été synchronisée avec succès mais a ensuite été supprimée du serveur (par un administrateur par exemple).

Lors de la synchronisation, l'application détecte ces orphelins et vous propose deux options :

- **Renvoyer** : marque l'offre pour un nouvel envoi lors de la prochaine synchronisation
- **Supprimer localement** : supprime l'offre de votre appareil

## Timeout et performance

Toutes les requêtes de synchronisation ont un timeout de 30 secondes. Si le serveur ne répond pas dans ce délai, la requête échoue et sera réessayée à la prochaine synchronisation.

Pour les bases de données volumineuses (nombreux produits ou clients), la première synchronisation peut être longue. Privilégiez une connexion Wi-Fi stable.

## Bonnes pratiques

1. **Synchronisez en Wi-Fi** : plus rapide et plus fiable qu'en 4G
2. **Synchronisez avant les rendez-vous** : assurez-vous d'avoir les dernières données
3. **Synchronisez après les rendez-vous** : sauvegardez vos offres dès que possible
4. **Vérifiez les erreurs** : consultez régulièrement la liste pour détecter les échecs
5. **Gardez l'application à jour** : les mises à jour améliorent la fiabilité de la synchronisation