Utilisation

Utilisation au quotidien

Principe

Le module Clients Indirects vous permet de tracer les ventes réalisées de manière indirecte : via une marketplace (Amazon, Cdiscount, etc.), un revendeur ou tout autre canal de commercialisation. Chaque vente indirecte est enregistrée comme une fiche avec ses informations clés, consultable depuis une liste centralisée ou directement depuis la fiche du client concerné.

Créer une vente indirecte

  1. Allez dans le menu Clients Indirects (entrée du menu principal).
  2. Cliquez sur Nouvelle vente indirecte.
  3. Remplissez les champs de la fiche :
    • Référence : attribuée automatiquement (provisoire tant que la fiche est en brouillon, définitive à la validation).
    • Libellé : description courte de la vente.
    • Montant : montant de la vente.
    • Client final : le tiers qui a acheté le produit ou service.
    • Place de marché : le tiers intermédiaire (marketplace, revendeur) par lequel la vente a été réalisée.
    • Canal de commercialisation : la source ou le canal d'origine de la vente (dictionnaire configurable dans Dolibarr).
    • Date de vente : la date à laquelle la vente a eu lieu.
    • Produit : le produit ou service vendu (si le module Produits est activé).
    • Projet : le projet associé (si le module Projets est activé).
    • Notes : notes publiques et privées pour des informations complémentaires.
  4. Cliquez sur Créer pour enregistrer la fiche.

Formulaire de création d'une nouvelle vente indirecte avec les champs Libellé, Montant, Client final, Place de marché et Date de vente remplis

Statuts d'une vente indirecte

Chaque vente indirecte passe par les statuts suivants :

  • Brouillon : la fiche vient d'être créée et peut être librement modifiée.
  • Validé : la fiche est confirmée. La référence définitive est attribuée.
  • Annulé : la fiche est annulée (par exemple en cas d'erreur ou de retour).

Pour changer le statut, utilisez les boutons d'action disponibles sur la fiche de la vente indirecte.

Fiche d'une vente indirecte à l'état Validé, avec sa référence définitive et les boutons d'action en haut de page

Liste des ventes indirectes

La page de liste vous permet de consulter l'ensemble des ventes indirectes enregistrées. Vous pouvez :

  • Filtrer par référence, libellé, client final, place de marché, canal de commercialisation, date de vente, statut, etc.
  • Trier les colonnes en cliquant sur les en-têtes.
  • Exporter les données via les fonctions d'export standard de Dolibarr.

Suivi depuis la fiche client

Un onglet Ventes indirectes est ajouté automatiquement sur la fiche de chaque tiers (partie "Commercial" de la fiche). Cet onglet affiche :

  • Les dernières ventes indirectes associées au client.
  • Un lien pour consulter la liste complète des ventes indirectes de ce client.

Cette intégration vous permet d'avoir une vision globale de la relation commerciale, en combinant ventes directes et indirectes.

Import via l'API REST

L'intérêt principal du module est de pouvoir alimenter Dolibarr avec des données provenant d'autres plateformes. L'API REST vous permet d'automatiser l'import des ventes indirectes.

Points d'accès disponibles

Méthode URL Description
GET /api/index.php/indirectcustomers/saleshistory/{id} Récupérer une vente indirecte par son identifiant
GET /api/index.php/indirectcustomers/saleshistory/ Lister les ventes indirectes (avec tri, pagination et filtres)
POST /api/index.php/indirectcustomers/saleshistory/ Créer une vente indirecte
PUT /api/index.php/indirectcustomers/saleshistory/{id} Modifier une vente indirecte
DELETE /api/index.php/indirectcustomers/saleshistory/{id} Supprimer une vente indirecte

Exemple de création via l'API

POST /api/index.php/indirectcustomers/saleshistory/
{
    "ref": "(PROV)",
    "label": "Vente Amazon - Commande #12345",
    "amount": 150.00,
    "fk_soc": 42,
    "fk_source": 18,
    "source_id": 3,
    "date_sell": "2026-04-10",
    "status": 0
}

Les champs obligatoires sont : ref, date_sell et status. Les autres champs sont facultatifs mais recommandés pour un suivi complet.

Authentification

L'API utilise le système d'authentification standard de Dolibarr. Vous devez passer votre clé API (token) dans le header DOLAPIKEY de chaque requête. La clé API se configure dans la fiche de l'utilisateur Dolibarr, onglet "API".

Configuration FAQ