README FR

CyberOffice readme informations complètes

Module disponible sur Prestashop addons et sur Dolistore

Récompensé par Prestashop Addons Team comme Contributor of the Year 2016.

Statut niveau d'expertise SuperHero & Développé par un Top Developer, + de 3700 téléchargements et modules installés, avis clients 5/5. (Sources addons Prestashop). Meilleures ventes de sa catégorie sur Prestashop Addons Connexion à un logiciel tiers (CRM, ERP).

Module CyberOffice synchronisation Prestashop vers Dolibarr ERP/CRM

Description du module CyberOffice

Ce module de synchronisation CyberOffice (Prestashop vers Dolibarr) permet d'accroitre les performances de gestion commerciale d'une boutique Prestashop en la connectant à l'ERP/CRM Dolibarr. Il synchronise en temps réel via des webservices tous les évènements réalisés sur Prestashop vers Dolibarr. (Catégories, produits, déclinaisons, prix, stocks, images, caractéristiques, clients, commandes, factures, règlements, comptes bancaires... )

CyberOffice peut s'installer à tous moments de la vie de votre boutique Prestashop. Il est malgré tout recommandé de le mettre en place lorsque vous avez obtenu vos premières ventes et que vous maîtrisez les processus d'utilisation de votre shop. Si vous faites des tests, pensez au moment de la mise en production à synchroniser à nouveau les catégories et les produits.

Fonctionnalités

Désignations	Prestashop	Dolibarr
Compatibilité Prestashop	1.6 à 1.7.xx (module 1.6.2)
	>8.xx (module version 8.0.0 et Php 8 )
Compatibilité Dolibarr et DoliCloud		10.0 à 16.xx (module 1.6.2)
		17.x (module version 8.0.0 et Php 8)
Compatible serveurs mutualités ou dédiés intégrant SOAP
Web Services (automatique)
Synchronisation de Prestashop vers Dolibarr
Installation facile par module
Multi-stores (plusieurs boutiques dans un même Prestashop connectées à un seul Dolibarr ERP/CRM)
Multi-shops (plusieurs Prestashop indépendants connectés* à un seul Dolibarr ERP/CRM)
Catégories
Produits et déclinaisons, (variant activation sur demande, nécessite notre module MyCyberOffice), caractéristiques
Prix spécifiques Prestashop synchronisés (nécessite le module tarifs dégressifs de Dolibarr)
Références
Codes barre UPC et EAN13 et ISBN pour la version 1.7
Clients (récupération de l'historique au choix selon la date)
Commandes (récupération de l'historique au choix selon la date), synchronisation incrémentielle.
Factures (récupération de l'historique au choix selon la date)
Stocks (synchronisation au choix), choix de l'entrepôt à utiliser selon le transporteur
Paiements (association aux différents comptes bancaires)
Statuts commandes et factures, paiement (v8) au choix pour synchronisation
Création Shipping (libellé modifiable, ajout du transporteur) et Discount (libellé modifiable), Wrapping pour les emballages cadeaux (libellé modifiable)
N°Shop / N° de commande / N°panier Prestashop visible dans Ref client commandes & factures
Description longue produit Prestashop ajoutée dans extrafield fiche produit
Commandes et factures en multi-devises synchronisées en devise sur Dolibarr

Le second module MyCyberOffice synchronisation automatique de Dolibarr vers Prestashop est disponible sur les plateformes d'extensions Prestashop Addons et DoliStore.

*Nécessite une licence par Prestashop. Les versions CyberOffice 8 et MyCyberOffice 8 doivent fonctionner uniquement entre elles en php8.

Installation facile par module sur Prestashop et Dolibarr ERP/CRM

1.Vidéo d’installation du module

2.Vidéo d’utilisation du module

3.Vidéo Multi-boutiques et catégories (Les catégories sont essentielles pour la synchronisation des produits)

Prestashop

Module dans Prestashop

1-Ajouter un nouveau module, charger Cyberoffice.zip

Backoffice : Modules / Gestionnaire de modules / installer un module

2-Configurer CyberOffice

Numéros	Descriptions	Précisions
1	Clé webservices Dolibarr	Copier la clé générée dans Dolibarr (Dolibarr/webservices)
2	Chemin d'accès à Dolibarr	Copier l'url complète de Dolibarr sans oublier le / à la fin
3	Authentification Dolibarr	C'est le login (identifiant) de connexion Dolibarr (Super Admin) et le mot de passe correspondant. (Ne pas indiquer l'adresse email)
4	Entité	Mettre 1 par défaut, si vous êtes en multi sociétés choisir l'id correspondant
5	Entrepôt	Index (id) de l'entrepôt utilisé (affiché dans l'url Dolibarr)
6	Langue par défaut	Choisir la langue utilisée
7	Statuts à synchroniser	Ce sont les statuts choisis qui déclenchent la synchronisation des commandes et factures dans Dolibarr. Ceux par défaut "Paiement accepté" "Expédié" "Livré" correspondent à 99% des utilisations, si vous ne savez pas laissez les configurés ainsi. Si vous les cochez tous, il y aura des synchronisations permanentes dans Dolibarr à chaque étape des commandes et factures.
7 bis	Uniquement dans la Version 8	Synchronisation du paiement de la facture. Doit se faire sur un état présent sur les autres statuts de synchronisation "commandes" et "factures". Exemple : Paiement accepté
8	Shop Protocole	Choisir http ou https
9	Prefixe	Si vos produits Prestashop n'ont pas de référence mettre le préfixe que vous voulez pour identifier vos produits dans Dolibarr. Si tous vos produits ont une référence dans Prestashop mettre {ref} elles seront reprises et utilisées dans Dolibarr.

Votre boutique ne doit pas être en MODE MAINTENANCE

3-Suivre les instructions CyberOffice infos

Numéros	Description	Précisions
1	Installer le module sous Prestashop	Dans le back office cliquer sur ajouter un nouveau module
2	Télécharger le fichier module_cyberoffice.zip et l'installer sur Dolibarr avec l'installateur. (Uniquement CyberOffice version 8)	(Uniquement Version CyberOffice <8 ) Cliquer sur module cyberoffice.zip décompressez le et placer le dossier "cyberoffice" et son contenu à la racine de Dolibarr au même niveau que les répertoires principaux de Dolibarr. (Ne pas utiliser custom )
3	Sous Dolibarr : Activer le webservice (API/WEB SERVICES serveur SOAP) et générer la clé (accueil-configuration-modules-modules interfaces-webservices) Activer le module CyberOffice	Visionnez la vidéo d'installation https://www.youtube.com/watch?v=uKlSU0CdKVE
4	Sous Prestashop: Paramétrer le module. Tous les champs doivent être renseignés	Voir le point 2 au dessus "Configurer le module"
5	Tout est coché vert ? Votre synchronisation est opérationnelle	Vous devez avoir impérativement toutes les coches vertes pour que le module soit fonctionnel.
6	Initialiser la base "Catégorie" et la base "Produit"	A effectuer dans l'ordre comme l'indique la procédure "Initialisation" dans le module. Les catégories sont essentielles pour la synchronisation des produits.
7	Optionnel : Vous pouvez synchroniser vos commandes et clients existants	Dans l'outil CyberOffice choisir une date de début et de fin pour synchroniser l'historique des clients et commandes. Attention les clients sont souvent inscrits avant la commande.

Instructions CyberOffice 8

Point 6 Initialisation: En fonction du nombre de catégories ou de produits, le délai de synchronisation sera plus ou moins long, vous devez attendre la réponse du serveur qui sera de type: Response batch1: sent. (en cas de timeout, effectuez des synchronisations par tranche). Images : Lors de l'initialisation des produits, seules les images de couverture (cover) sont synchronisées dans Dolibarr afin d'éviter la surcharge du serveur (timeout). Pour les obtenir toutes dans la fiche produit Dolibarr: 1- Ouvrir la fiche produit dans Prestashop 2- Sauvegarder la 3- Toutes les images seront alors synchronisées dans Dolibarr.

Initialisation des catégories et des produits

Point 7 Synchroniser les clients en fonction de leur date de création dans Prestashop. Très souvent l'inscription est réalisée bien avant la commande.

Synchronisation des commandes, si une commande n'a pas son client synchronisé elle ne se synchronisera pas dans Dolibarr. Dans ce cas vérifier la date de création du client dans Prestashop et faire une synchronisation client à cette date.

Synchronisation de l'historique clients ayant passés commandes et des commandes réalisées sur Prestashop

Informations du serveur Prestashop

Numéros	Descriptions	Précisions
8	cUrl extension must be available on your server	cURL doit être actif sur le serveur pour que le module fonctionne
9	default_socket_timeout : 60	Valeur courante pour le bon fonctionnement du module*
10	max_execution_time : 165	Valeur courante pour le bon fonctionnement du module et son installation par l'assistant*
11	memory_limit : 512M	Valeur courante pour le bon fonctionnement du module et son installation par l'assistant*
12	display_error : off	A passer sur OFF impérativement pour le bon fonctionnement des webservices.

*La valeur peut être supérieure mais surtout pas inférieure

Fonctionnement des status de synchronisation

Choisissez quels statuts déclencheront la synchronisation des commandes, factures et paiements* vers Dolibarr. Si vous ne savez pas laissez les valeurs par défaut qui fonctionneront dans tous les cas.

*(Statut de synchronisation des paiements paramétrables uniquement dans le version 8 pour les autres versions le paiement est synchronisé en meme temps que la facture.)

Nouveautés de la nouvelle version 8.0.0

1. Supporte exclusivement Prestashop 8, php8, et Dolibarr 17

2. Synchronise le statut de paiement : Synchronisation du paiement de la facture. Doit se faire sur un état présent sur les autres statuts de synchronisation "commandes" et "factures". Exemple : Paiement accepté

3. Permet de synchroniser manuellement une commande vers Dolibarr depuis le bouton intégré dans Prestashop: Synchronisation dans Dolibarr

Nouveautés de la version 1.6.2

-Nouveau tableau de bord de configuration présent sur le module dans Dolibarr

1. Clients : Synchronisation de la langue du client (traduction pdf) / Force le nom en majuscule

2. Produits : Synchronisation du stock / Ne pas synchroniser les descriptions / Synchronisation variant <-> déclinaison (Activation sur demande)

3. Commandes : 1 ligne remise par Prestashop discount / Synchronisation de la ref Prestashop avec la référence commande / Synchronisation de la ref Prestashop avec la référence client

4. Factures : Mise à disposition du lien de téléchargement sur Prestashop (La facture de Dolibarr est présente dans le backoffice du client)

Nouveautés à partir de la version 1.5.x

-Pour les pays a double taxation

Dans quelques pays comme le Canada , Brésil, l'Espagne, le Portugal, la Tunisie, les USA, etc….les produits sont soumis à une double taxation. Le module gère maintenant ces doubles taxes en mode combiné et en mode l'une après l'autre.

-Synchronisation incrémentielle des commandes échouées

Après un arrêt en cours de synchronisation des commandes cliquer sur le bouton "synchronisation incrémentielle" pour relancer la synchronisation juste après l'arrêt. Evite de relancer l'ensemble des commandes.

Dolibarr ERP/CRM

Module Dolibarr ERP/CRM

1-Télécharger et installer le fichier module_cyberoffice.zip avec l'installateur Dolibarr.

Pour les versions CyberOffice précédentes < 8, ne pas installer dans le répertoire Custom. Ne pas utiliser l'installateur, mais installer au même niveau que les répertoires principaux de Dolibarr

2-Activer le module Webservice, protection par clé à copier dans Prestashop

Si vous avez uniquement CyberOffice 8 le champ Webservice Key de la boutique doit être vide. Si vous avez MyCyberOffice 8 le champs récupérera automatiquement la valeur de la clé web de Prestashop indiqué dans MyCyberOffice sur Dolibarr (Clé d'authentification).

3-Activer le module CyberOffice et les catégories (dans outils multi-modules)

Activer les codes-barres uniquement si ils sont tous présents dans les produits Prestashop

-Activer le module services

4-Création automatique des remises et frais de port et emballage*

Si les services ne sont pas créés, il faut passer sur Off puis On le module CyberOffice. Cela relance la création des services.

Seuls les libellés sont modifiables selon vos besoins.(* voir plus loin nouveautés)

5-Vérifier si un entrepôt est ouvert

et si les tva sont renseignées à l'identique de Prestashop

6-Synchroniser les stocks et

paramètrer la méthode de décrémentation des stocks

7-Associer les modes de règlements avec les comptes bancaires une fois la base de données Prestashop liée

Le choix des banques n'apparait qu'une fois la liaison effectuée avec la base Prestashop

Nouveautés de la version 1.6.2

Très nombreuses nouvelles fonctionnalités configurables a partir du nouveau tableau de bord

Nouveau tableau de bord de configuration de CyberOffice sur Dolibarr

Clients :

Synchronisation de la langue choisie par le client (traduction du PDF) : OUI/NON

La langue choisie par client est transférée dans le compte du client Tiers sur Dolibarr et est conservée dans tous les documents si les traductions existent.

Force le nom du client en Majuscule : OUI/NON

Force le nom du Tiers de Dolibarr en majuscule afin d'avoir une cohérence des noms dans la liste de Tiers.

Produits :

Synchronisation du stock : OUI/NON

Cette fonction permet de synchroniser ou pas le stock

Ne pas synchroniser les descriptions : OUI/NON

Cette fonction permet de synchroniser ou pas les descriptions

Synchronisation variant<-> déclinaison : OUI/NON

Cette fonctionnalité permet de synchroniser les déclinaisons de Prestashop dans le module "Variantes" de Dolibarr

Commandes :

1 ligne de remise par Prestashop discount : OUI/NON

Prestashop : Règle de prix par produit

Dolibarr: Crée une réduction PrestaDiscount par ligne

Synchronisation de la référence Prestashop avec la référence commande : OUI/NON

La numérotation des commandes Prestashop est synchronisée dans Dolibarr au niveau du numéro de commande.

Synchronisation de la référence Prestashop avec la référence Client : OUI/NON

La numérotation des commandes Prestashop est synchronisée dans Dolibarr au niveau de la Ref.Client

Factures :

Mise à disposition du lien de téléchargement sur Prestashop : OUI/NON

En cliquant sur l'icone Facture PDF la facture Dolibarr est disponible pour le client.

Dans Prestashop les factures doivent être activées sur les Etats de commandes utilisées. Les 2 plateformes doivent avoir le meme niveau d'http ou https afin d'assurer une bonne connexion entre elles.

Facture Dolibarr récupérée dans l'espace client Prestashop

Nouveautés à partir de la version 1.5.5

-Ajout du transporteur après le service PrestaShipping dans la commande et facture

Le libellé de PrestaShipping est modifiable simplement directement dans le service

-Décrémentation des stocks par transporteur

Il est possible d'associer un transporteur à un stock afin de décrémenter le stock de son choix en fonction du transporteur.

Aller dans Configuration / Dictionnaire et ouvrir cyberoffice_carrier_warehouse

Associer les ID des entrepôts Dolibarr avec les ID des transporteurs Prestashop

Ajouter les ID sur la première ligne et cliquer sur "Ajouter". La modification et la désactivation des anciennes associations peuvent être réalisées à tous moments.

Les id correspondants des transporteurs existants dans Prestashop

Décréments sur chacun des stocks

-Commandes et Factures en multi-devises sur Prestashop sont synchronisées en devise sur Dolibarr

Commande en $ sur Prestashop synchronisée en $ dans Dolibarr

Commande en $ sur Dolibarr

Il est nécessaire d'activer et de configurer le module Multi-devise sur Dolibarr

-Prix spécifiques Prestashop synchronisés sur Dolibarr (nécessite le module tarifs dégressifs de Dolibarr)

Installer et activer le module Tarifs dégressifs dans Dolibarr (Disponible sur Dolistore)

Activer le module tarifs dégressifs

Un onglet supplémentaire "Tarifs dégressifs" sera présent dans la fiche produit. Chaque tarif apparait sur une ligne

Les prix spécifiques du produit dans Prestashop sont synchronisés dans Dolibarr

-Nouveau service Wrapping emballage

Les prix d'emballage sont maintenant sur une ligne distincte dans la commande Dolibarr avec la création d'un nouveau service "PrestaWrapping"

Création automatique à l'installation du module CyberOffice si le module Services est activé.

Dans Prestashop : Paramètres de la boutique / commandes

Configuration des tarifs emballages cadeaux

Commande Prestashop avec emballage + tva

Commande synchronisée avec emballage dans Dolibarr avec la ligne PrestaWrapping

Penser à ajouter le taux de TVA sur le service PrestaWrapping

Fonctionnalités et astuces

Conseils	Précisions
Déclinaison sans variant	Dans le cas de déclinaison sans variant, un produit=déclinaison est créé et le détail de la déclinaison est ajoutée dans le label du produit
Références produits	La référence produit est automatiquement créée avec gestion des doublons (incrément). Utilisation du code {ref} si elles sont toutes renseignées
Import	Si vous importez et mettez à jour vos produits en csv pensez toujours a initialiser à nouveau vos produits afin que vos modifications se synchronisent dans Dolibarr
Catégories	Pour synchroniser uniquement les catégories et produits dans Dolibarr, il suffit de dégreffer le module dans actionOrderStatutPostUpdate. (Modules / positions)
PHP	La Directive PHP allow_url_fopen doit être sur ON sur le serveur Dolibarr pour que les images puissent s'importer.
Dolibarr 5	Avec Dolibarr 5.xx passer à 1 la variable $dolibarr_nocsrfcheck=1 dans le fichier conf.php si vous avez un message dans le module sur Prestashop.
https	Lors de la sécurisation de l'url du shop de http en https, il est possible d'intervenir dans la table "const" de Dolibarr (mysql) et de récupérer la valeur de l'ancien shop (http) et la copier à la place de la valeur du shop (https). Cela permet d'éviter de tout synchroniser une nouvelle fois et avoir des doublons dans Dolibarr. Il est également possible dans le module au niveau de l'adresse de la boutique d'ajouter un "s" (https). Ne pas oublier de faire de même au niveau de l'arborescence de la catégorie existante (tags/catégories).
Prénom Nom	* Pour inverser dans Dolibarr l'ordre de la civilité des contacts et de les passer de Nom Prénom à Prénom Nom. Aller dans configuration / affichage / Ordre d'affichage nom/prénom
Commandes factures	* Si vous souhaitez que cette inversion Prénom / nom se répercute dans les commandes et factures. Dans le fichier server_customer.php du module CyberOffice sur Dolibarr vers la ligne 245 inversez les champs. Actuellement: $ newobject-> name_alias = ($ customer ['company']? $ customer ['lastname']. ''. $ customer ['firstname']: ''); Changez comme cela: $ newobject-> name_alias = ($ customer ['company']? $ customer ['firstname']. ''. $ customer ['lastname']: ''); Vous devrez faire cette modification lors de chaque mise à jour.
Pack produits	Pour synchroniser et décrémenter correctement les packs produits il faut créer un produit standard sur Prestashop. Celui-ci contiendra des informations et des images qui indiqueront qu'il contient plusieurs produits. (Surtout ne pas utiliser Pack lors de la création) Sur Dolibarr il faut ajouter les produits fils à ce produit père dans l'onglet Kits, ainsi que la composition à décrémenter des stocks. Lors des ventes sur Prestashop le père et les fils seront bien décrémentés sur Dolibarr
Fusion Cyberoffice	Cette nouvelle fonctionnalité permet de fusionner dans Dolibarr des clients synchronisés depuis Prestashop et déjà présents sur Dolibarr. 1-Recherchez votre client dans la zone de gauche avec l'outil de recherche. 2-Cliquez sur la loupe pour lancer la recherche 3-Sélectionnez le client (en bleu une fois sélectionné) 4-Cliquez dans la zone de droite sur la loupe avec +. Le système affichera les clients se rapprochant avec le même nom, le même email, etc... 5-Sélectionnez le client dans la zone de droite (en bleu une fois sélectionné) 6-Cliquez sur le bouton fusionner import_key indique le shop correspondant : P01= shop 01
Utilisation du module Multi-Societe sur Dolibarr	Renseigner la même clé webservices

Tiers / Liste / Fusion CyberOffice

Fonctions avancées

• Comment configurer les caractéristiques produits de Prestashop pour les synchroniser avec les attributs supplémentaires (extrafields) produits de Dolibarr

Label de compatibilité avec CyberOffice

Nous avons mis en place un label de qualité, qui permet de garantir une parfaite compatibilité des modules avec CyberOffice.

Label	Module	Description
	MyCyberOffice	Synchronisation des informations de Dolibarr vers Prestashop (Pilotage de la boutique depuis Dolibarr)
	CashdeskPro2.0	Logiciel de caisse pour Dolibarr (vente au comptoir pour les commercants ayant une boutique physique)
	EmailViewedProduct	Envoi automatique d’e-mails marketing responsive avec coupon de réduction des produits vus par vos clients sur votre site. Ajout automatiquement dans le mail de blocs supplémentaires (Produits ajoutés et abandonnés au panier, les nouveaux produits).

Copyright tous droits réservés - CyberOffice - 2016-2023