[{"data":1,"prerenderedAt":716},["ShallowReactive",2],{"\u002Fv5\u002Fdokos\u002Fbookings\u002Fcredit-reservation":3,"section:\u002Fv5\u002Fdokos\u002Fbookings\u002Fcredit-reservation":715},{"id":4,"title":5,"body":6,"description":693,"extension":694,"meta":695,"navigation":697,"path":711,"seo":712,"stem":713,"__hash__":714},"docs\u002F1.v5\u002F1.dokos\u002F13.bookings\u002F3.credit-reservation.md","Crédits de réservation",{"type":7,"value":8,"toc":673},"minimark",[9,13,17,20,25,29,32,87,98,103,140,151,155,193,196,205,209,212,235,241,245,252,259,265,269,324,328,336,343,346,399,405,409,419,433,437,443,492,502,547,551,557,564,568,590,613,617],[10,11,5],"h1",{"id":12},"crédits-de-réservation",[14,15,16],"p",{},"Un crédit de réservation est une unité prépayée. Le client l'obtient en achetant un carnet de tickets, avec son abonnement, ou par un geste du gestionnaire. Il l'utilise ensuite pour réserver une ressource sans payer la réservation.",[14,18,19],{},"Exemple : un carnet de 10 heures de coworking, ou 4 heures de salle de réunion offertes chaque semaine aux abonnés.",[21,22,24],"h2",{"id":23},"le-cycle-de-vie-dun-crédit","Le cycle de vie d'un crédit",[26,27,28],"mermaid",{},"\nflowchart LR\n    A[Facture de vente validée] --> D[Crédit de réservation : Actif]\n    B[Règle d'allocation] --> D\n    C[Saisie manuelle] --> D\n    D -->|Réservation avec crédits| E[Utilisation de crédits de réservation]\n    E -->|Panier abandonné, annulation remboursée| D\n    D -->|Solde à 0| F[Consommé]\n    D -->|Date d'expiration passée| G[Expiré]\n",[14,30,31],{},"Trois documents portent ce cycle :",[33,34,35,48],"table",{},[36,37,38],"thead",{},[39,40,41,45],"tr",{},[42,43,44],"th",{},"Document",[42,46,47],{},"Rôle",[49,50,51,63,77],"tbody",{},[39,52,53,60],{},[54,55,56],"td",{},[57,58,59],"strong",{},"Type de crédits de réservation",[54,61,62],{},"Ce qui est vendu (article et unité de mesure) et ce que le crédit paie (règles de conversion)",[39,64,65,70],{},[54,66,67],{},[57,68,69],{},"Crédit de réservation",[54,71,72,73,76],{},"Un lot de crédits d'un client, avec sa ",[57,74,75],{},"Quantité achetée",", son solde et ses dates de validité",[39,78,79,84],{},[54,80,81],{},[57,82,83],{},"Utilisation de crédits de réservation",[54,85,86],{},"Une consommation de crédits, liée en général à une réservation de ressource",[14,88,89,90,93,94,97],{},"Les crédits appartiennent à un ",[57,91,92],{},"Client",". Si le champ ",[57,95,96],{},"Utilisateur"," est rempli, seul cet utilisateur peut les utiliser.",[99,100,102],"h3",{"id":101},"comment-un-client-obtient-des-crédits","Comment un client obtient des crédits",[104,105,106,113,131],"ul",{},[107,108,109,112],"li",{},[57,110,111],{},"À la validation d'une facture de vente."," Pour chaque ligne, Dokos cherche un type de crédits actif dont l'article et l'unité de mesure correspondent. Il crée un crédit de la quantité de la ligne multipliée par le nombre de crédits du type. Le crédit commence à la date de la facture. Une commande seule ne crée pas de crédits.",[107,114,115,118,119,122,123,126,127,130],{},[57,116,117],{},"Par une règle d'allocation."," Une ",[57,120,121],{},"Règle d'allocation de crédits de réservation"," crée des crédits à chaque ",[57,124,125],{},"Récurrence"," : Une fois, Chaque jour, Chaque semaine, Chaque mois, tous les 3 mois ou Chaque période de facturation. Une règle liée à un ",[57,128,129],{},"Abonnement"," est traitée à chaque traitement de l'abonnement.",[107,132,133,136,137,139],{},[57,134,135],{},"À la main."," Créez un ",[57,138,69],{}," et validez-le.",[14,141,142,143,146,147,150],{},"Si la ",[57,144,145],{},"Date d'expiration"," est vide, Dokos la calcule avec la durée du type : ",[57,148,149],{},"Date de début de validité"," + durée. Si le type n'a pas de durée, les crédits n'expirent pas.",[99,152,154],{"id":153},"comment-les-crédits-sont-consommés","Comment les crédits sont consommés",[104,156,157,171,185],{},[107,158,159,162,163,166,167,170],{},[57,160,161],{},"Sur le portail."," Si le client a des crédits utilisables pour la ressource et le tarif choisis, la fenêtre ",[57,164,165],{},"Gérer ma réservation"," affiche ",[57,168,169],{},"Réserver en utilisant des crédits",". Dokos crée l'utilisation dès l'ajout au panier. Dans le devis, la ligne passe à 0 €. La réservation est confirmée à la commande.",[107,172,173,176,177,180,181,184],{},[57,174,175],{},"Sur le bureau."," Dans la ",[57,178,179],{},"Réservation de ressource",", choisissez un client comme tiers et cochez ",[57,182,183],{},"Déduire les crédits de réservation",". Dokos crée l'utilisation à l'enregistrement.",[107,186,187,189,190,192],{},[57,188,135],{}," Créez une ",[57,191,83],{}," avec le client, le type et la quantité.",[14,194,195],{},"Le nombre de crédits utilisés vient de la règle de conversion du type pour la ressource et l'unité de mesure réservées. Si plusieurs types conviennent, Dokos prend le premier dont le solde suffit. Dans un type, les lots les plus anciens sont consommés en premier.",[14,197,198,199,204],{},"Un client qui réserve sans passer par le panier (rôle dédié ou contrat actif) n'utilise pas ses crédits. Voir ",[200,201,203],"a",{"href":202},"\u002Fv5\u002Fdokos\u002Fbookings\u002Freservation-en-ligne","Réserver en ligne",".",[99,206,208],{"id":207},"quand-les-crédits-sont-rendus","Quand les crédits sont rendus",[14,210,211],{},"Dokos annule l'utilisation et rend les crédits dans ces cas :",[104,213,214,217,220,232],{},[107,215,216],{},"le panier est abandonné et la réservation est supprimée après le délai de nettoyage ;",[107,218,219],{},"le client retire le créneau de son panier ;",[107,221,222,223,226,227,231],{},"le client annule la réservation sur le portail et la case ",[57,224,225],{},"Rembourser les crédits en cas d'annulation"," est cochée dans les ",[200,228,230],{"href":229},"\u002Fv5\u002Fdokos\u002Fbookings\u002Fparametres","paramètres"," ;",[107,233,234],{},"la réservation est supprimée.",[14,236,237,238,240],{},"Sans la case ",[57,239,225],{},", une annulation sur le portail ne rend pas les crédits.",[99,242,244],{"id":243},"quand-les-crédits-expirent","Quand les crédits expirent",[14,246,247,248,251],{},"Chaque jour, une tâche planifiée passe à ",[57,249,250],{},"Expiré"," les crédits dont la date d'expiration est passée. Un crédit reste donc utilisable jusqu'à sa date d'expiration incluse. Le solde restant est perdu.",[14,253,254,255,258],{},"Par défaut, Dokos vérifie la validité au moment où le client réserve. Un crédit qui expire le 31 décembre peut donc payer, le 30 décembre, une salle réservée pour le 10 janvier. Pour l'interdire, cochez ",[57,256,257],{},"Les crédits doivent être valides à la date de début de réservation"," dans les paramètres. Dokos date alors l'utilisation au début de la réservation.",[14,260,261,262,264],{},"Un crédit dont la ",[57,263,149],{}," est dans le futur n'est pas encore utilisable.",[99,266,268],{"id":267},"statuts-dun-crédit","Statuts d'un crédit",[33,270,271,281],{},[36,272,273],{},[39,274,275,278],{},[42,276,277],{},"Statut",[42,279,280],{},"Signification",[49,282,283,295,305,314],{},[39,284,285,290],{},[54,286,287],{},[57,288,289],{},"Actif",[54,291,292,293,204],{},"Le crédit a un solde et n'est pas expiré. Un solde négatif reste aussi ",[57,294,289],{},[39,296,297,302],{},[54,298,299],{},[57,300,301],{},"Consommé",[54,303,304],{},"Le solde est à 0.",[39,306,307,311],{},[54,308,309],{},[57,310,250],{},[54,312,313],{},"La date d'expiration est passée.",[39,315,316,321],{},[54,317,318],{},[57,319,320],{},"Annulé",[54,322,323],{},"Le crédit a été annulé.",[21,325,327],{"id":326},"configurer-un-type-de-crédits","Configurer un type de crédits",[329,330,333],"tour",{"demo":331,"doctype":332},"Mappemonde","Booking Credit Type",[14,334,335],{},"Créer un type de crédit de réservation dans la démo",[14,337,338],{},[339,340],"img",{"alt":341,"src":342},"Le formulaire Type de crédits de réservation, avec ses questions numérotées de 1 à 5 et le bouton Enregistrer (6).","\u002Fimages\u002Fdokos\u002Flieu\u002Ftype-de-credits-de-reservation.png",[14,344,345],{},"Le formulaire est progressif : chaque question apparaît quand la précédente est renseignée.",[347,348,349,354,360,365,370,376],"ol",{},[107,350,351],{},[57,352,353],{},"Quel est le nom de votre type de crédit de réservation ?",[107,355,356,359],{},[57,357,358],{},"Quel article sera utilisé pour la facturation ?"," Un article de type ticket pour un carnet, ou l'article d'abonnement.",[107,361,362],{},[57,363,364],{},"Quelle unité de mesure de facturation doit générer des crédits ?",[107,366,367],{},[57,368,369],{},"Combien de crédits doivent être attribués pour chaque vente ?",[107,371,372,375],{},[57,373,374],{},"Combien de temps ces crédits doivent-ils rester actifs ?"," Laissez vide pour des crédits sans expiration.",[107,377,378,379,382,383,386,387,390,391,394,395,398],{},"Dans ",[57,380,381],{},"Règles de conversion",", cliquez sur ",[57,384,385],{},"Nouvelle règle",". Renseignez ",[57,388,389],{},"Combien de crédits doivent être utilisés ?",", ",[57,392,393],{},"Contre un"," (l'unité de mesure de la réservation) et ",[57,396,397],{},"Pour cette ressource",". Ajoutez une règle par ressource et par unité de mesure.",[14,400,401],{},[339,402],{"alt":403,"src":404},"La fenêtre d'ajout d'une règle de conversion pour un type de crédit.","\u002Fimages\u002Fdokos\u002Flieu\u002Ftype-de-credits-de-reservation-conversions.png",[99,406,408],{"id":407},"autoriser-un-solde-négatif","Autoriser un solde négatif",[14,410,411,412,414,415,418],{},"Cochez ",[57,413,408],{}," pour accepter un dépassement, par exemple en fin de mois pour un abonné. La ",[57,416,417],{},"Limite de crédit"," fixe le dépassement maximum (0 = pas de limite).",[104,420,421,424,427,430],{},[107,422,423],{},"Dokos consomme d'abord les crédits disponibles, puis passe le lot actif le plus récent sous zéro.",[107,425,426],{},"Le client doit déjà avoir un crédit de ce type. Sinon, la réservation se fait sans déduction.",[107,428,429],{},"Au-delà de la limite, la déduction est refusée.",[107,431,432],{},"Un solde négatif n'expire pas. La dette reste jusqu'aux prochains crédits.",[21,434,436],{"id":435},"allouer-des-crédits-avec-un-abonnement","Allouer des crédits avec un abonnement",[14,438,439],{},[339,440],{"alt":441,"src":442},"Le formulaire Règle d'allocation de crédits de réservation.","\u002Fimages\u002Fdokos\u002Flieu\u002Fabonnement-credit.png",[347,444,445,450,458,471,480,489],{},[107,446,447,448,204],{},"Créez une ",[57,449,121],{},[107,451,452,453,455,456,204],{},"Renseignez le ",[57,454,92],{}," et, si besoin, l'",[57,457,96],{},[107,459,460,461,464,465,467,468,204],{},"Renseignez la ",[57,462,463],{},"Date de début",", la ",[57,466,125],{}," et l'",[57,469,470],{},"Expiration (Jours)",[107,472,473,474,476,477,204],{},"Choisissez le ",[57,475,59],{}," et la ",[57,478,479],{},"Quantité",[107,481,482,483,485,486,204],{},"Liez la règle à l'",[57,484,129],{}," ou au ",[57,487,488],{},"Contrat de réservation de ressources",[107,490,491],{},"Validez la règle.",[14,493,494,495,497,498,204],{},"Dans un abonnement enregistré, l'onglet ",[57,496,5],{}," affiche les règles liées. Un type de contrat peut aussi créer ces règles : voir ",[200,499,501],{"href":500},"\u002Fv5\u002Fdokos\u002Fbookings\u002Fcontrats-bookings","Contrats",[33,503,504,517],{},[36,505,506],{},[39,507,508,511,513,515],{},[42,509,510],{},"Besoin",[42,512,479],{},[42,514,125],{},[42,516,470],{},[49,518,519,533],{},[39,520,521,524,527,530],{},[54,522,523],{},"4 heures de salle par semaine, à utiliser dans la semaine",[54,525,526],{},"4",[54,528,529],{},"Chaque semaine",[54,531,532],{},"7",[39,534,535,538,541,544],{},[54,536,537],{},"10 heures par mois d'abonnement",[54,539,540],{},"10",[54,542,543],{},"Chaque période de facturation",[54,545,546],{},"30",[21,548,550],{"id":549},"suivre-les-soldes","Suivre les soldes",[329,552,554],{"demo":331,"doctype":553},"Booking%20Credits%20Balance",[14,555,556],{},"Rapport du solde des crédits de réservation",[14,558,559,560,563],{},"Le rapport ",[57,561,562],{},"Solde de crédits de réservation"," montre, par client et par type, les crédits obtenus, utilisés et restants. Sur le portail, le client voit ses crédits dans la rubrique dédiée.",[21,565,567],{"id":566},"exemple","Exemple",[14,569,570,571,574,575,578,579,582,583,586,587,204],{},"Mappemonde (démo) vend un « Carnet 10 heures coworking » : article ",[57,572,573],{},"Carnet 10 heures",", unité de mesure ",[57,576,577],{},"Unité",", 10 crédits, durée 90 jours. La règle de conversion donne 1 crédit contre une ",[57,580,581],{},"Heure"," et 4 crédits contre une ",[57,584,585],{},"Demi-journée"," pour la ressource ",[57,588,589],{},"Espace de coworking",[347,591,592,595,601,604,607],{},[107,593,594],{},"Le 1er octobre, Maison Verte SARL (exemple fictif) achète un carnet. La facture est validée : Dokos crée un crédit de 10, actif jusqu'au 30 décembre.",[107,596,597,598,600],{},"Le 7 octobre, Sophie réserve une demi-journée avec ",[57,599,169],{},". Dokos utilise 4 crédits. Le solde passe à 6.",[107,602,603],{},"Le 9 octobre, elle ajoute 2 heures avec ses crédits, puis ferme son navigateur. 15 minutes plus tard, le panier est nettoyé : les 2 crédits sont rendus. Le solde reste à 6.",[107,605,606],{},"Le 20 octobre, elle réserve 4 heures. Le solde passe à 2.",[107,608,609,610,612],{},"Le 31 décembre, la tâche planifiée passe le crédit à ",[57,611,250],{},". Les 2 crédits restants sont perdus.",[21,614,616],{"id":615},"problèmes-fréquents","Problèmes fréquents",[33,618,619,629],{},[36,620,621],{},[39,622,623,626],{},[42,624,625],{},"Problème",[42,627,628],{},"Cause et solution",[49,630,631,642,650,658],{},[39,632,633,639],{},[54,634,635,636,638],{},"Le bouton ",[57,637,169],{}," n'apparaît pas",[54,640,641],{},"Le type n'a pas de règle de conversion pour cette ressource et ce tarif, le client n'a pas de crédit actif, ou le crédit commence plus tard.",[39,643,644,647],{},[54,645,646],{},"La facture n'a pas créé de crédits",[54,648,649],{},"L'article ou l'unité de mesure de la ligne ne correspond pas au type, ou le type est désactivé.",[39,651,652,655],{},[54,653,654],{},"Les crédits d'un abonnement ne sont plus alloués",[54,656,657],{},"Vérifiez que la règle d'allocation est validée et liée à l'abonnement.",[39,659,660,663],{},[54,661,662],{},"L'annulation d'une utilisation depuis le bureau affiche une erreur",[54,664,665,666,672],{},"Anomalie connue (",[200,667,671],{"href":668,"rel":669},"https:\u002F\u002Fgitlab.com\u002Fdokos\u002Fbookings\u002F-\u002Fissues\u002F112",[670],"nofollow","bookings#112","). Contactez le support.",{"title":674,"searchDepth":675,"depth":676,"links":677},"",1,2,[678,686,689,690,691,692],{"id":23,"depth":676,"text":24,"children":679},[680,682,683,684,685],{"id":101,"depth":681,"text":102},3,{"id":153,"depth":681,"text":154},{"id":207,"depth":681,"text":208},{"id":243,"depth":681,"text":244},{"id":267,"depth":681,"text":268},{"id":326,"depth":676,"text":327,"children":687},[688],{"id":407,"depth":681,"text":408},{"id":435,"depth":676,"text":436},{"id":549,"depth":676,"text":550},{"id":566,"depth":676,"text":567},{"id":615,"depth":676,"text":616},"Vendre ou offrir des crédits, les faire consommer par les réservations, et comprendre quand ils sont rendus ou expirent.","md",{"icon":696,"reviewed":697,"last_verified":698,"sources":699},"i-lucide-ticket",true,"2026-10-31",[700,701,702,703,704,705,706,707,708,709,668,710],"bookings@v5:bookings\u002Fbookings\u002Fdoctype\u002Fbooking_credit\u002Fbooking_credit.py","bookings@v5:bookings\u002Fbookings\u002Fdoctype\u002Fbooking_credit\u002Fbooking_credit.json","bookings@v5:bookings\u002Fbookings\u002Fdoctype\u002Fbooking_credit_type\u002Fbooking_credit_type.json","bookings@v5:bookings\u002Fbookings\u002Fdoctype\u002Fbooking_credit_usage\u002Fbooking_credit_usage.py","bookings@v5:bookings\u002Fbookings\u002Fdoctype\u002Fbooking_credit_allocation_rule\u002Fbooking_credit_allocation_rule.json","bookings@v5:bookings\u002Fbookings\u002Fdoctype\u002Fresource_booking\u002Fresource_booking.py (refund_credit)","bookings@v5:bookings\u002Fcontrollers\u002Fquotation.py","bookings@v5:bookings\u002Fhooks.py (scheduler_events, doc_events)","bookings@v5:bookings\u002Flocale\u002Ffr.po","https:\u002F\u002Fgitlab.com\u002Fdokos\u002Fbookings\u002F-\u002Fissues\u002F86","https:\u002F\u002Fgitlab.com\u002Fdokos\u002Fbookings\u002F-\u002Fissues\u002F186","\u002Fv5\u002Fdokos\u002Fbookings\u002Fcredit-reservation",{"title":5,"description":693},"1.v5\u002F1.dokos\u002F13.bookings\u002F3.credit-reservation","8-cHUmZTBnI--3tBqQu4dkoIn4Lx8RbpfRMpmqo6H-8",{},1794324438171]