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.

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ées envoyées (push)

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