Développeurs

L'API Plune est disponible

Une API REST pour lire et créer vos devis, factures et clients par programmation. Authentification par clé Bearer, scope par organisation. Un serveur MCP relie vos assistants IA. Les webhooks signés relient les signatures et les paiements à vos automatisations.

REST · clé Bearer · Factur-X (norme 2026) · serveur MCP · scope par 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

    Les factures émises sont au format hybride 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/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.

Assistants IA

Pilotez Plune depuis Claude, ChatGPT ou Gemini

Plune expose un serveur MCP, le standard commun aux assistants IA. Branchez-le une fois, puis demandez à votre IA de lister vos clients, créer un devis, ou récupérer un PDF Factur-X. Réservé aux offres Pro et Business.

Connexion en trois étapes

  1. Étape 1

    Ouvrez les connecteurs de votre assistant

    Dans Claude (web ou application) : Réglages, puis Connecteurs. ChatGPT et Gemini exposent le même réglage MCP.

  2. Étape 2

    Ajoutez le connecteur Plune

    Créez un connecteur personnalisé avec l’URL du serveur MCP de Plune indiquée ci-contre.

  3. Étape 3

    Connectez-vous avec votre e-mail Plune

    Utilisez le même e-mail que votre compte Plune. Les outils apparaissent aussitôt, limités aux données de votre organisation.

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

ChatGPT et Gemini : même URL via leur support MCP, ou clé API Bearer pour une intégration sur mesure.

Ce que votre IA peut faire

  • Lister et créer vos clients et vos devis
  • Consulter vos factures, leur statut et leurs échéances
  • Récupérer le PDF d’un devis ou le PDF Factur-X d’une facture
  • Transmettre la facture à votre comptabilité (connecteur en préparation)

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

Exemple de flux prévu

  1. WebhookUn devis est signé sur Plune
  2. API PluneLa facture Factur-X est générée
  3. Votre outilEnvoi au client et à la comptabilité
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
  }
}
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.

Gestion des cookies

Plune utilise des cookies nécessaires au service. Avec votre accord, nous pouvons aussi mesurer l'audience et les campagnes publicitaires.

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