Factures

Open Source — GitScrum MCP Server est open source sous la licence MIT. Disponible sur npm et sur GitHub. Serveur Model Context Protocol pour GitScrum — Claude, GitHub Copilot, Cursor et tout client compatible MCP disposent d'un accès opérationnel complet à votre stack de gestion de projets.

L'outil invoice fournit 8 actions couvrant l'ensemble du cycle de facturation — de la création de brouillons à l'envoi, au suivi des paiements et à la gestion des annulations. Chaque opération de facturation disponible dans l'application web GitScrum est accessible par conversation en langage naturel avec votre assistant IA.

Les factures dans GitScrum suivent un cycle de vie strict par statut. Chaque facture progresse à travers des états définis, et le serveur MCP applique ces transitions automatiquement. Votre assistant IA peut créer des factures détaillées, les envoyer aux clients, enregistrer les paiements et générer des analyses de facturation — le tout sans quitter votre IDE ou client IA.

Vue d'ensemble des actions

Cycle de vie des statuts

Chaque facture suit une progression de statut définie. Le serveur MCP applique les transitions valides — vous ne pouvez pas marquer un brouillon comme payé sans l'avoir envoyé d'abord, et les factures annulées ne peuvent pas être rouvertes.

  ┌───────┐      send      ┌──────┐     mark_paid    ┌──────┐
  │ Draft │ ──────────────► │ Sent │ ────────────────► │ Paid │
  └───────┘                 └──────┘                   └──────┘
      │                         │
      │       cancel            │        (auto)
      │◄────────────────────    │──────────────────►  ┌─────────┐
      │                         │    past due_date    │ Overdue │
      ▼                         ▼                     └─────────┘
  ┌───────────┐           ┌───────────┐                    │
  │ Cancelled │           │ Cancelled │                    │ cancel
  └───────────┘           └───────────┘                    ▼
                                                     ┌───────────┐
                                                     │ Cancelled │
                                                     └───────────┘

• Draft — État initial. Modifiable. Peut être envoyé ou annulé.
• Sent — Livré au client. Passe à payé, en retard ou annulé.
• Paid — Paiement enregistré. État terminal.
• Overdue — Défini automatiquement lorsqu'une facture envoyée dépasse sa date d'échéance.
• Cancelled — Annulé. État terminal.

Lister les factures

L'action list retourne les factures d'un workspace. Filtrez par statut ou par client pour affiner les résultats.

Paramètres requis

Paramètres optionnels

Exemples de prompts

You:  "Affiche toutes les factures"
AI:   Appelle invoice action=list → retourne la liste des factures avec statuts et montants

You:  "Liste les factures impayées"
AI:   Appelle invoice action=list avec status="sent"

You:  "Affiche les factures en retard"
AI:   Appelle invoice action=list avec status="overdue"

You:  "Liste toutes les factures d'Acme Corp"
AI:   Trouve l'UUID du client → appelle invoice action=list avec client_uuid

Obtenir les détails d'une facture

L'action get retourne la facture complète — titre, client, lignes de détail, montants, taxes, dates, statut et historique de paiement.

Paramètres requis

You:  "Montre-moi les détails de la facture du projet web Acme Corp"
AI:   Trouve la facture → appelle invoice action=get → retourne la facture complète avec les lignes de détail

You:  "Quel est le total de notre dernière facture ?"
AI:   Liste les factures récentes → appelle invoice action=get → extrait le montant total

Créer des factures

L'action create génère un nouveau brouillon de facture. Vous pouvez inclure les lignes de détail, les taux de taxe, l'association client et la devise en un seul appel. La facture commence en statut Draft, permettant la révision et les modifications avant l'envoi.

Paramètres requis

Paramètres optionnels

Structure des lignes de détail

Chaque élément du tableau items suit cette structure :

Exemples de prompts

You:  "Crée une facture pour Acme Corp : Refonte du site web, 5 000 $, échéance le 15 mars"
AI:   Trouve l'UUID du client → appelle invoice action=create avec title="Refonte du site web",
      client_uuid, items=[{description: "Refonte du site web", quantity: 1, unit_price: 5000}],
      due_date="2026-03-15"

You:  "Facture TechStart pour 40 heures de développement à 150 $/heure plus 10 % de taxe"
AI:   Appelle invoice action=create avec title, client_uuid,
      items=[{description: "Services de développement", quantity: 40, unit_price: 150}],
      tax_rate=10

You:  "Crée une facture avec trois lignes de détail :
       - Design UX : 20 heures à 120 $
       - Développement Frontend : 60 heures à 150 $
       - Tests QA : 15 heures à 100 $"
AI:   Appelle invoice action=create avec le tableau items contenant les trois entrées

Mettre à jour les factures

L'action update modifie un brouillon de facture. Seules les factures en statut Draft peuvent être modifiées — une fois envoyée, la facture est verrouillée.

Paramètres requis

Tous les paramètres optionnels de create sont disponibles dans update.

You:  "Ajoute une taxe de 10 % à la facture d'Acme Corp"
AI:   Appelle invoice action=update avec tax_rate=10

You:  "Change la date d'échéance au 1er avril"
AI:   Appelle invoice action=update avec due_date="2026-04-01"

You:  "Mets à jour les notes de la facture : 'Conditions de paiement à 30 jours'"
AI:   Appelle invoice action=update avec notes="Conditions de paiement à 30 jours"

Envoyer les factures

L'action send fait passer une facture de Draft à Sent. Cela livre la facture au client et la verrouille contre toute modification ultérieure. Le changement de statut est enregistré avec un horodatage.

Paramètres requis

You:  "Envoie la facture d'Acme Corp"
AI:   Appelle invoice action=send → la facture passe de Draft à Sent

You:  "Envoie tous les brouillons de facture"
AI:   Liste les brouillons → appelle invoice action=send pour chacun

Enregistrer un paiement

L'action mark_paid enregistre le paiement d'une facture envoyée ou en retard. Vous pouvez optionnellement spécifier la date de paiement et la méthode pour les registres comptables.

Paramètres requis

Paramètres optionnels

You:  "Marque la facture d'Acme Corp comme payée"
AI:   Appelle invoice action=mark_paid → la facture passe en Paid

You:  "Enregistre le paiement de la facture, reçu hier par virement bancaire"
AI:   Appelle invoice action=mark_paid avec payment_date="2026-02-05",
      payment_method="Virement bancaire"

You:  "Marque toutes les factures en retard de TechStart comme payées"
AI:   Liste les factures en retard du client → appelle mark_paid pour chacune

Annuler des factures

L'action cancel met fin à une facture. Cela fonctionne sur les factures en statut Draft, Sent ou Overdue. Vous pouvez optionnellement fournir une raison pour l'annulation.

Paramètres requis

Paramètres optionnels

You:  "Annule le brouillon de facture pour Global Media"
AI:   Appelle invoice action=cancel → la facture passe en Cancelled

You:  "Annule la facture avec la raison : 'Périmètre du projet modifié, nouvelle facture à suivre'"
AI:   Appelle invoice action=cancel avec reason

Statistiques de facturation

L'action stats retourne les métriques de facturation au niveau du workspace — montant total facturé, payé vs en attente, total en retard, délai moyen de paiement et tendances de revenu. Ces chiffres alimentent le tableau de bord de facturation dans l'application web GitScrum.

Paramètres requis

You:  "Affiche les statistiques de facturation"
AI:   Appelle invoice action=stats → retourne le total facturé, payé, en attente, en retard

You:  "Quel est le revenu en attente ?"
AI:   Appelle invoice action=stats → extrait le total des factures en attente

You:  "Quel est notre délai moyen de paiement ?"
AI:   Appelle invoice action=stats → retourne le nombre moyen de jours avant paiement

Workflow de facturation

Pour les agences gérant plusieurs engagements clients, ce workflow couvre l'ensemble du cycle de facturation :

1. Créer la facture

Générez une facture détaillée liée à un client.

You:  "Crée une facture pour Acme Corp : Livraison Phase 1 — 80 heures frontend à 150 $,
       20 heures design à 120 $, 10 % de taxe, échéance le 30 mars"
AI:   Un seul appel create avec toutes les lignes, la taxe et la date d'échéance

2. Vérifier et ajuster

Vérifiez le brouillon avant l'envoi.

You:  "Montre-moi la facture d'Acme Corp"
AI:   Appelle invoice action=get → affiche la facture complète pour vérification

You:  "Ajoute une note : 'Paiement par virement bancaire sur le compte se terminant par 4521'"
AI:   Appelle invoice action=update avec notes

3. Envoyer au client

Livrez la facture.

You:  "Envoie la facture d'Acme Corp"
AI:   Appelle invoice action=send → la facture est livrée et verrouillée

4. Suivre le paiement

Surveillez les paiements et enregistrez-les à réception.

You:  "Des factures en retard ?"
AI:   Appelle invoice action=list avec status="overdue" → affiche les éléments en retard

You:  "Acme Corp a payé sa facture par virement"
AI:   Appelle invoice action=mark_paid avec payment_method="Virement bancaire"

5. Analyser la santé de la facturation

Surveillez la performance globale de la facturation.

You:  "Montre-moi la vue d'ensemble de la facturation"
AI:   Appelle invoice action=stats → résume le revenu, les montants en attente et les tendances de paiement

Prochaines étapes

• Clients : Gérez les fiches clients liées à vos factures.
• Propositions : Créez des propositions qui se convertissent en projets facturés.
• Tableaux de bord ClientFlow : Accédez aux analyses de facturation et rapports inter-workspaces.
• Projets : Gérez la livraison des projets parallèlement à la facturation.