Version de développement
Cette documentation décrit la version « next » (develop), non encore publiée. Pour la version stable, basculez sur « v5 » dans l'en-tête.
Ventes

Abonnements

Facturez vos clients à intervalle régulier (mensuel, trimestriel, annuel) depuis une commande ou directement.

Abonnements

Un abonnement facture un client de façon récurrente : adhésion, abonnement mensuel, location longue durée. À chaque période, Dokos crée la commande ou la facture, et peut demander le paiement.

Avant de commencer

  • Une fiche client.
  • Une Période de récurrence (mensuelle, trimestrielle, annuelle…).
  • Un ou plusieurs Plan d'abonnement : chaque plan indique l'article facturé et son prix.

Créer un abonnement

Depuis Ventes > Abonnement, cliquez sur Ajouter.

  1. Dans l'onglet Détails, sélectionnez le Client.
  2. Cliquez sur Sélectionner un forfait pour ajouter les plans.
  3. Dans l'onglet Paramètres, choisissez la Période de récurrence.
  4. Cochez Générer la facture au début de la période si la facture doit être émise en début de période.
  5. Enregistrez.

La Date de début de l'abonnement n'est pas affichée dans le formulaire. Un abonnement créé avec Ajouter commence à la date du jour.

Générer la facture au début de la période et Date de début de l'abonnement ne peuvent plus être modifiés après le premier enregistrement. En cas d'erreur, créez un nouvel abonnement.

Depuis une commande client

Une commande qui contient des lignes avec Est un article récurrent crée un abonnement à la validation, si une période de récurrence est définie. Un bandeau sur la commande l'indique, puis donne le lien vers l'abonnement.

Paramètres utiles

ChampEffet
Jour de facturationJour du mois de la facturation.
Valider la facture automatiquementCoché par défaut. Les factures créées sont validées.
Générer la facture avant le paiementLa facture est créée avant que le client paie.
Jours avant la génération de la commandeNombre de jours avant la période où Dokos crée la commande.
Proratiser la dernière factureFacture la dernière période au prorata en cas d'arrêt. Voir Arrêter un abonnement.
Ne pas facturer les périodes déjà commencéesSection Configuration de la facturation. Pour un abonnement saisi après coup. Voir Abonnement saisi après coup.
Mode de paiement, Désactiver le paiement automatiqueOnglet Paiement. Règlent le prélèvement automatique.
Format d'impression de facture, Modèle d'e-mailMise en page et e-mail d'envoi des factures.
Date de fin de la période d'essaiPendant l'essai, l'abonnement ne facture pas.

Abonnement saisi après coup

Par défaut, un abonnement dont la date de début est dans le passé facture toutes les périodes déjà commencées. Dokos les traite à la prochaine exécution horaire : il crée une commande, une facture et éventuellement une demande de paiement (Stripe, GoCardless…), sans autre avertissement. C'est le bon comportement pour un abonnement qui n'a encore rien facturé. Ce n'est pas celui que vous voulez quand vous reprenez des abonnements existants (migration vers Dokos, rattrapage d'un client) et que ces périodes ont déjà été facturées ailleurs.

Pour les laisser de côté, cochez Ne pas facturer les périodes déjà commencées dans l'onglet Paramètres, section Configuration de la facturation. La case est affichée quand la date de début est dans le passé, ou quand elle est déjà cochée.

Dans le formulaire, un nouvel abonnement commence à la date du jour : la case n'apparaît donc pas. Pour saisir une date de début passée, utilisez l'import de données sur la liste Abonnement, ou l'API. Dans le fichier, renseignez la colonne Date de début de l'abonnement et mettez la colonne Ne pas facturer les périodes déjà commencées à 1. Un abonnement créé par une commande client prend la date de début de la commande. La case n'est pas cochée à sa création.

À l'enregistrement, Dokos fixe le champ Début de la première période facturée (en lecture seule) : c'est la première période qui commence à la date d'enregistrement ou après. Ensuite :

  • l'abonnement reste au statut Actif, mais ne crée ni commande, ni facture, ni demande de paiement tant que la période à facturer commence avant cette date ;
  • l'en-tête affiche comme prochaine facture la vraie date de première facture ;
  • un nouvel enregistrement conserve cette date, pour que la période suivante ne soit pas sautée à son tour. Elle est recalculée seulement si la date de début, la date de fin de période d'essai ou la Période de récurrence change ;
  • si vous décochez la case, la date est effacée et l'abonnement facture normalement ;
  • avec Générer la facture au début de la période, la première période facturée est facturée à son premier jour. Sans cette case, elle est facturée à sa fin, et la période commencée avant l'enregistrement n'est pas facturée à sa fin ;
  • avec Jours avant la génération de la commande, la première période facturée est commandée à son premier jour, et non quelques jours avant.

Pour facturer vous-même les périodes passées, créez les factures de vente, puis rattachez-les à l'abonnement avec Actions > Lier une facture de vente.

Sans la case cochée, l'enregistrement d'un nouvel abonnement dont la date de début est dans le passé affiche l'avertissement Périodes déjà commencées : « La date de début est dans le passé. À la prochaine mise à jour, une commande, une facture et éventuellement une demande de paiement seront créées pour les périodes déjà commencées. Pour les facturer vous-même, cochez Ne pas facturer les périodes déjà commencées dans les paramètres. » Cet avertissement ne bloque pas l'enregistrement. Il apparaît aussi quand la date de début change, tant que rien n'est facturé.

Exemple fictif : Maison Verte SARL est migrée vers Dokos le 15 mai. Son abonnement mensuel à 150 € HT, facturé au début de la période, a pour date de début le 1er mars et ses factures de mars, avril et mai ont déjà été émises dans l'ancien outil. Vous cochez Ne pas facturer les périodes déjà commencées et vous enregistrez. Le champ Début de la première période facturée indique le 1er juin. Aucune commande ni facture n'est créée avant cette date. Le 1er juin, Dokos crée la commande de la période du 1er au 30 juin. Si vous aviez gardé la facturation à la fin de la période, cette période serait facturée le 1er juillet, et celle de mai ne le serait pas.

Dimensions analytiques

L'abonnement, ses lignes de plan et le Plan d'abonnement ont une section Dimensions analytiques. Elle contient le Centre de coûts, le Projet et vos autres dimensions analytiques.

Chaque ligne des commandes et des factures générées reçoit ses dimensions dans cet ordre :

  1. la valeur de la ligne de plan de l'abonnement ;
  2. sinon, la valeur de l'abonnement ;
  3. sinon, la valeur par défaut de l'article.

Quand vous ajoutez un plan à l'abonnement, une ligne du plan sans dimension reçoit la dimension du Plan d'abonnement.

À l'enregistrement, Dokos vérifie que chaque dimension appartient à la société de l'abonnement. Sinon, l'enregistrement est refusé avec le message « {0} : {1} n'appartient pas à la Société {2} ».

Exemple fictif : l'abonnement de Maison Verte SARL a le centre de coûts Lyon. Sa ligne Maintenance a le centre de coûts Grenoble. Sa ligne Hébergement n'en a pas. Chaque facture porte Grenoble sur la ligne Maintenance et Lyon sur la ligne Hébergement.

Vue d'ensemble de l'abonnement

L'en-tête de l'abonnement affiche des cartes : le statut, le Cycle de facturation actuel (pourcentage écoulé, jours restants), le Total HT (après remises, avant taxes) et le Total TTC par période. Le bouton Ajuster la fin de cycle change la date de fin de la période en cours.

Exemple fictif : la Menuiserie Élégante a un abonnement mensuel avec deux plans : maintenance à 150 € HT avec 10 % de remise, et poste de coworking à 200 € HT. Le Total HT affiché est de 335 € (150 € × 0,9 + 200 €).

Statut Remboursé

Le statut de l'abonnement décrit la période en cours. Quand la facture de cette période est annulée en totalité par des notes de crédit, l'abonnement passe au statut Remboursé. Dans la liste des abonnements, le statut s'affiche avec un indicateur gris.

Conditions :

  • la facture de la période en cours est validée ;
  • la somme des notes de crédit validées créées contre cette facture est supérieure ou égale au total de la facture (Total TTC). Une note de crédit partielle ne suffit pas : l'abonnement garde son statut Impayé ou A régler.

Un abonnement Remboursé n'est plus A régler : Dokos ne propose plus de demande de paiement pour la période créditée. La période suivante est facturée normalement, le statut Facturable reste prioritaire sur Remboursé.

Le statut se met à jour à la validation d'une note de crédit liée à l'abonnement, sans action de votre part.

Seule la facture de la période en cours compte. Si une facture d'une autre période est créditée, l'abonnement garde son statut (Impayé ou A régler s'il reste un solde dû) ; une ancienne facture créditée ne bloque pas le statut des périodes suivantes.

Dokos refuse de retourner plus que la quantité facturée. Avec une ligne de quantité 1 à 300 €, une seconde note de crédit contre la même facture est donc refusée.

Exemple fictif : l'abonnement mensuel de Maison Verte SARL a une facture de 2 × 150 € pour le mois en cours. Vous créez une note de crédit d'une unité : l'abonnement reste Impayé. Vous créez ensuite une seconde note de crédit d'une unité contre la même facture : la somme atteint 300 € et l'abonnement passe à Remboursé.

Demander un paiement en ligne

Quand l'abonnement a une facture ou une commande avec un solde dû, cliquez sur Créer > Demander un paiement. L'onglet Collecte de paiement suit les demandes. Voir Demande de paiement.

Modes de paiement

  • Paiement automatique : si le client a un moyen de paiement enregistré auprès d'une passerelle (Stripe, GoCardless…), Dokos déclenche le paiement à chaque échéance.
  • Paiement manuel : cochez Désactiver le paiement automatique. Vous envoyez une demande de paiement ou vous enregistrez le règlement vous-même.
Pour un prélèvement SEPA avec GoCardless : si le client a un mandat valide, ouvrez la demande de paiement et cliquez sur Actions > Obtenir le paiement immédiatement. Aucun lien n'est envoyé.

Crédits de réservation

Avec l'application Bookings, la validation d'une facture de vente peut attribuer des crédits de réservation au client. Les membres d'un tiers-lieu les utilisent pour réserver des ressources (salles, postes de coworking).

Arrêter un abonnement

Dans l'abonnement, cliquez sur Actions > Arrêter l'abonnement. Saisissez la Date d'annulation et cochez Facturer la dernière période au prorata si nécessaire. Cliquez sur Confirmer l'annulation.

Le menu Actions propose aussi Reprendre l'abonnement, Redémarrer l'abonnement et Lier une facture de vente.

Période déjà commandée ou facturée

Avec Générer la facture au début de la période, la commande de la période en cours existe dès son premier jour, et sa facture souvent aussi. Si vous arrêtez l'abonnement en cours de période, cette commande et cette facture restent au montant de la période entière, sauf si vous cochez Facturer la dernière période au prorata.

Dans la fenêtre d'arrêt, un bandeau jaune apparaît dès qu'une commande validée et non clôturée couvre la date d'annulation (elle commence au plus tard à cette date et se termine après). Il indique ce qui va se passer, avec ou sans la case cochée. Il change quand vous modifiez la date ou la case.

La part non consommée est calculée comme pour la dernière facture au prorata : nombre de jours après la Date d'annulation divisé par le nombre de jours de la période complète.

Situation de la périodeSans la case cochéeAvec Facturer la dernière période au prorata
Commandée et facturéeRien ne change : la période reste facturée en entier.Dokos crée un avoir brouillon contre la facture, pour les jours du lendemain de la date d'annulation à la fin de la période. Vérifiez-le puis validez-le. Aucun remboursement n'est effectué.
Commandée, pas encore facturéeRien ne change : la période reste commandée en entier.Dokos réduit les prix de la commande aux jours consommés, et la commande se termine à la date d'annulation. Une facture brouillon de cette commande est réduite aussi. La demande de paiement ouverte est annulée puis émise à nouveau pour le nouveau montant.

Plusieurs factures validées pour la même commande reçoivent chacune un avoir brouillon. Les acomptes rattachés à la facture restent sur la facture d'origine : ils ne sont pas repris dans l'avoir.

La régularisation a lieu au moment où vous confirmez l'arrêt, même si la date d'annulation est plus tard dans la période. Elle ne s'applique pas si la date d'annulation est le dernier jour de la période.

Si un paiement est déjà effectué ou en cours sur la commande (acompte versé, ou demande de paiement avec de l'argent en transit), la commande n'est pas réduite. Dokos affiche le message « La commande client … n'est pas réduite : un paiement est déjà effectué ou en cours. Créez un avoir pour les jours non consommés une fois la commande facturée. » Dans ce cas, créez vous-même l'avoir quand la commande est facturée.

Exemple fictif : Maison Verte SARL a un abonnement mensuel à 150 € HT, facturé au début de la période du 1er au 30 juin. Vous arrêtez l'abonnement avec une Date d'annulation au 10 juin et la case cochée. La période compte 30 jours, dont 20 après le 10 juin : la part non consommée est de 20/30.

  • Si la période est déjà facturée, Dokos crée un avoir brouillon de 100 € HT, du 11 au 30 juin. Vous le vérifiez, puis vous le validez.
  • Si la période est seulement commandée, la commande passe à 50 € HT (10 jours sur 30) et se termine le 10 juin. Une nouvelle demande de paiement de ce montant remplace l'ancienne.

Reprendre l'abonnement après un arrêt au prorata

  • Un avoir brouillon créé à l'arrêt reste en brouillon si vous reprenez l'abonnement : supprimez-le vous-même.
  • Une commande réduite se termine à la date d'annulation. Si vous cliquez sur Actions > Reprendre l'abonnement, Dokos refuse la reprise et affiche : « La commande client … ne facture cette période que jusqu'au …, date de résiliation. Annulez ou modifiez cette commande avant de reprendre l'abonnement. » Annulez ou modifiez la commande, puis reprenez l'abonnement. Pour garder la période entière en cours, arrêtez l'abonnement sans cocher Facturer la dernière période au prorata.

Abonnement lié à un contrat de réservation

Avec l'application Bookings, un abonnement lié à un contrat de réservation validé s'arrête avec son contrat. Dans l'abonnement, Actions > Arrêter l'abonnement résilie le contrat, sans option de prorata. Pour régulariser la période en cours, résiliez depuis le contrat : Actions > Résilier le contrat, puis cochez Prorater la dernière facture. La régularisation est la même que ci-dessus. Le même refus s'applique quand vous annulez la résiliation (Actions > Annuler la résiliation sur le contrat, ou Actions > Reprendre l'abonnement sur l'abonnement).

Ce qui peut bloquer

  • L'abonnement ne crée pas de facture : vérifiez la période de récurrence, les plans et le statut. Si Ne pas facturer les périodes déjà commencées est coché, vérifiez aussi Début de la première période facturée : rien n'est facturé avant cette date. Dokos traite les abonnements toutes les heures. Cliquez sur Récupérer les mises à jour pour lancer le traitement tout de suite.
  • Une commande et une facture ont été créées pour des périodes déjà facturées ailleurs : la case Ne pas facturer les périodes déjà commencées n'était pas cochée. Voir Abonnement saisi après coup.
  • Montant à 0 au premier paiement Stripe : la carte est enregistrée. Le prélèvement réel a lieu au cycle suivant.
  • Le lien GoCardless n'est pas proposé : le client a déjà un mandat valide. Utilisez Obtenir le paiement immédiatement sur la demande de paiement.
  • La commande n'a pas été réduite à l'arrêt : un paiement est déjà effectué ou en cours. Voir Période déjà commandée ou facturée.

Et ensuite