API et assistants IA

Reliez vos outils.
Gardez la main sur vos documents.

Utilisez l’API pour vos clients, devis et factures. Connectez un assistant compatible avec MCP ou recevez les événements de signature et de paiement dans vos automatisations.

Connecter mon assistant IAConsulter l’API

Accès Pro et Business · Clé privée liée à votre organisation

Les fondations

Ce sur quoi vous bâtissez

Authentification, événements et schéma : trois briques pour intégrer Plune à vos outils. Les briques marquées « Disponible » sont ouvertes dès maintenant.

  • Clés API Bearer

    Disponible

    Générez des clés depuis vos paramètres, scopées à votre organisation. Révocables à tout moment, jamais stockées en clair côté serveur.

  • Webhooks signés HMAC (bêta)

    Disponible dès Pro · HMAC-SHA256

    Recevez quote.signed, invoice.paid et signature.completed sur une URL HTTPS, avec une signature HMAC-SHA256 à vérifier.

  • Factur-X et schéma OpenAPI

    Disponible · OpenAPI 3.1

    Après activation et saisie des données requises, les factures finalisées peuvent être exportées au format Factur-X (PDF avec XML embarqué). Le schéma OpenAPI 3.1 est publié sur /api/v1/openapi.json pour générer vos clients et SDK.

Endpoints

L'API REST, endpoint par endpoint

Base : https://plune.app/api/v1. Authentifiez chaque requête avec Authorization: Bearer <clé>.

  • GET/api/v1/catalog

    DisponibleRetrouver vos services et produits, leurs prix HT, TVA et unités.

  • GET/api/v1/bundles

    DisponibleRetrouver vos formules et les lignes qui les composent.

  • GET/api/v1/quotes

    DisponibleLister vos devis et suivre leur statut (envoyé, signé, expiré).

  • GET/api/v1/clients

    DisponibleLister vos clients pour les synchroniser avec votre CRM.

  • POST/api/v1/clients

    DisponibleCréer une fiche client et ses coordonnées.

  • GET/api/v1/invoices

    DisponibleSuivre vos factures, leur statut et leurs échéances.

  • POST/api/v1/quotes

    DisponibleCréer un devis depuis votre outil métier (totaux et numérotation gérés par Plune).

  • POST/api/v1/invoices

    DisponibleCréer une facture (totaux recalculés, Factur-X à la finalisation).

  • POST/api/v1/webhooks

    DisponibleDéclarer une URL HTTPS pour recevoir les événements signés HMAC. Le secret est renvoyé une seule fois.

  • GET/api/v1/webhooks

    DisponibleLister vos endpoints webhook, leur état et leur dernier envoi. Le secret est masqué.

  • PATCH/api/v1/webhooks/{id}

    DisponibleActiver, désactiver ou changer les événements écoutés par un endpoint.

  • DELETE/api/v1/webhooks/{id}

    DisponibleSupprimer un endpoint webhook et ses livraisons.

Assistants IA

Pilotez Plune depuis votre assistant IA

Connectez Claude Code, Codex ou Antigravity au serveur MCP de Plune. Retrouvez vos clients et votre catalogue, préparez un devis ou une facture, puis récupérez son PDF. Réservé aux offres Pro et Business.

Connexion en trois étapes

  1. Étape 1

    Préparez votre clé Plune

    Dans Plune, ouvrez Paramètres, puis Clés API. Avec Pro ou Business, générez une clé et copiez-la dans un emplacement privé.

  2. Étape 2

    Ajoutez le connecteur Plune

    Dans un client MCP compatible avec les en-têtes Bearer, ajoutez l’URL ci-contre et l’en-tête Authorization: Bearer suivi de votre clé.

  3. Étape 3

    Préparez puis relisez votre document

    Demandez un devis ou une facture avec votre client, vos services, votre profil d’entreprise et le modèle choisi. Les prix et couleurs peuvent être adaptés au document. Ouvrez le lien Plune renvoyé pour relire le brouillon avant de le finaliser ou de l’envoyer.

URL du serveur MCPhttps://plune.app/api/mcp

La clé reste dans votre configuration privée. Les documents sont créés en brouillon ; le Factur-X nécessite une facture finalisée et les réglages requis.

Exemple : « Prépare un devis pour mon client, avec ma formule et mon service à 80 € HT, une remise de 10 % et un acompte de 20 %. »

Configurer Codex
codex mcp add plune --url https://plune.app/api/mcp --bearer-token-env-var PLUNE_API_KEY

Renseignez PLUNE_API_KEY dans votre environnement privé avant de lancer Codex.

Instructions officielles : Claude Code · Antigravity.

Ce que votre IA peut faire

  • Retrouver vos clients, services, produits et formules
  • Reprendre votre profil d’entreprise, ses coordonnées et ses réglages
  • Choisir le modèle, les couleurs et la variante du logo du document
  • Créer vos devis et factures en brouillon avec les données de Plune
  • Personnaliser les prix, la TVA et la remise ; ajouter un acompte au devis
  • Consulter vos factures, leur statut et leurs échéances
  • Récupérer les PDF et le Factur-X des factures finalisées si activé
  • Relire les détails et les montants de vos documents

Chaque assistant n'accède qu'aux données de votre organisation, selon les mêmes règles que l'application.

Automatisation

Reliez Plune à vos outils, sans tout coder

Configurez une destination HTTPS par API, puis utilisez les événements signés pour déclencher vos propres automatisations. Voici des exemples à construire avec vos outils.

  • Être notifié dès qu’un devis est signé
  • Transmettre la facture Factur-X à votre comptabilité
  • Synchroniser vos clients avec vos outils métier
Être accompagné sur l’intégration

Exemple de flux prévu

  1. WebhookUn devis est signé sur Plune
  2. Votre intégrationVous préparez la facture selon vos règles
  3. VérificationVous finalisez et partagez le document
Aperçu

À quoi ressemblent les échanges

Une requête de lecture des devis et un exemple d’événement envoyé à votre destination webhook.

Requête (devis)

curl https://plune.app/api/v1/quotes \
  -H "Authorization: Bearer plune_live_votreCle"

# Reponse
{
  "data": [
    { "id": "...", "number": "DEV-00042", "status": "SIGNED", "totalTTC": 132.0 }
  ],
  "page": 1, "limit": 50, "total": 1
}

Événement (webhook)

{
  "id": "evt_01HX",
  "type": "quote.signed",
  "created_at": "2026-05-25T09:30:00Z",
  "data": {
    "quote_id": "quo_123",
    "client_id": "cl_123",
    "total_ttc": 132.00
  }
}
Questions fréquentes

Avant de connecter vos outils.

Accès

Intégrez Plune à vos outils

Générez une clé API depuis vos paramètres et commencez à lire et créer vos devis, factures et clients. Les webhooks signés relient les signatures et les paiements à vos automatisations.

Générer une clé APIVoir les offres Pro et Business

Gestion des cookies

Plune utilise des cookies nécessaires au service. Avec votre accord, nous pouvons aussi mesurer l'audience et les campagnes publicitaires. Le suivi partenaire fait l’objet d’un choix séparé sur le lien partenaire.

Responsable de traitement : Edouard Hue, éditeur de Plune. Détail des cookies, durées et destinataires.