User talk:Tiaris

Interface de Dolibarr avec OsCommerce

Présentation

Le but de cet interface est de pouvoir utiliser Dolibarr pour la gestion des ventes sur un site e-commerce fonctionnant avec OsCommerce.

A l'usage, il m'est apparu que l'admin d'OsCommerce ne me suffit pas. Voici quelques questions que j'ai rencontrées :

Un revendeur est intéressé par une commande en quantité de mes articles vus sur le site. Ce qui suppose commande supplémentaire chez le fournisseur, conditions préférentielles, procédure d'export (Tahiti Rimai vend depuis la Polynésie), devis, acceptation du devis, paiement, facturation, envoi...

Je rencontre quelqu'un qui veut acheter des produits sans passer par le site (marché local).

En plus, a côté de l'activité liée au site, j'ai aussi une activité de prestations informatiques et là il ne me restait que la bureautique. Or la bureautique ça va un moment, mais j'aimerais pouvoir suivre mon CA, l'état de mon compte bancaire un peu plus sérieusement... Choses que Dolibarr propose.

Donc l'idée de base consiste à faire collaborer OSC et Dolibarr :

récupérer les informations utiles dans la base de données du site et les intégrer dans Dolibarr pour ensuite bénéficier des fonctions de Dolibarr (suivi de l'expédition d'une commande, intégration des paiements dans le suivi de compte, gestion des clients...)

gèrer le catalogue ( suivi des commandes fournisseurs) depuis Dolibarr et le mettre à jour sur le site.

Je propose de décrire ici les fonctions utiles pour réaliser cette interface. Sentez-vous libre d'y apporter vos contributions.

Les fonctions prévues

1. l'import des articles OSC -> Dolibarr

Cette fonction sert à importer un catalogue d'un site web dans dolibarr (mon cas par ex où le site tourne, mais pas encore Dolibarr)

2. l'export d'articles Dolibarr -> OSC

pour la gestion du catalogue OSC depuis Dolibarr

3. Import des clients et prospects OSC -> Dolibarr

pour le suivi des clients et la gestion des commandes

4. Import des commandes OSC-> Dolibarr

en vue de leur suivi dans Dolibarr

5. Traitement des commandes dans Dolibarr et leur mise à jour sur OSC

Il faut mettre à jour le suivi de la commande sur le site, car le client peut suivre l'état de sa commande.

L'utilisation de ces fonctions

Décrire comment elles seront implémentées et comment les intégrer dans Dolibarr)

Dans l'état actuel de ma réflexion (n'hésitez pas à me donner vos avis sur la question), je considère que le site e-commerce reste autonome par rapport à Dolibarr. Dolibarr est utilisé pour récupérer des infos du site et pour alimenter le site (intervention directe de l'utilisateur). On pourrait penser aussi un système où c'est le site e-commerce qui transmet les infos (commandes, clients...) à Dolibarr qui peut les iontégrer automatiquement dans ses traitements. Peut être à étudier par la suite.

Dans la release du cvs (et dans la 2.0.1), vous avez noté la présence d'un module expérimental d'un interface avec OSC. Elle permet de récupérer des données dans une base OSC, base qui doit tourner sur le même serveur que Dolibarr, ce qui est le cas pour une installation locale mais pas forcément pour un site en production hébergé. J'ai donc pensé implémenter cette interface sous forme de web-services développés à partir de nusoap (projet libre et GPL). Les web-services seont les fournisseurs de données (format OSC), et dans Dolibarr les clients se chargeront de la transformation des données OSC en objets Dolibarr (commandes, clients..), qui seront donc gérables par Dolibarr.

Description des webservices

gestion des articles

gestion des clients

gestion des commandes

1. get_CAmensuel : renvoie le tableau du CA réalisé par mois pour l'année en cours.

2. get_orders(nbmax, statut) : renvoie le tableau composé de nbmax commande du statut donné (livré, en attente, en traitement...)

Les tests à effectuer

Au fur et à mesure détailler un plan de test qui permet de valider les améliorations successives.

On se retrouve donc avec deux couches à réaliser : les webservices coté OSC (le côté serveur donc) et les clients de ces côté Dolibarr. Je proposerai les webservices dans les contributions OSC dès qu'ils seront un peu utilisables, car à partir de là ça peut intéresser d'autres gens. Je vais installer un site OSC de test sous peu avec ces webservices qui pourra nous servir aux tests.

Le site où sont installés les webservices : http://osc.tiaris.info

Il s'agit d'un site de test, que vous pouvez utiliser sans problème pas de paiement en ligne par carte bleue, et pas d'envoi de commandes à attendre ! Vous pouvez créer des commandes, vous enregistrer comme client, ça fera plus réaliste pour les tests Les services web : ils vont être installés prochainement et les tests pourront commencer aussitôt après que le cvs de dolibarr contiendra les scripts client de ces services.

Il y aura beaucoup de tests à prévoir pour valider le bon fonctionnement (en voici une première liste à affiner et à préciser au fur et à mesure).

Ce qu'il faudra tester dans Dolibarr (côté client) :

1. la gestion des articles

        leur récupération depuis OSC (et leur gestion ensuite come tout article Dolibarr)
        la création d'un article sur OSC depuis Dolibarr (suite à commande et livraison fournisseur)
        la gestion du stock

2. la gestion des clients - prospects

        OSC ne distingue pas les clients (qui ont commandé) des prospects (inscrits mais sans commande)
        récupération des clients
        récupération des prospects
        la gestion de ces clients / prospects dans Dolibarr
        la gestion des mises à jour client.

3. la récupération des commandes

        leur intégration dans les commandes Dolibarr
        le suivi du paiement (maj de la commande sur OSC à prévoir)
        le suivi de l'expédition (maj de la commande sur OSC à prévoir)
        l'intégration dans la gestion comptable de Dolibarr (compte bancaire, CA, frais, TVA...)

De l'autre côté, les tests permettront aussi de valider les fonctions des webservices sur le site OSC (côté serveur).