ForHosting KIT · Documents et PDF

Générez un avoir à partir d’une facture

Créez un avoir cohérent à partir de la référence de la facture initiale, d’un motif précis et des lignes exactes à annuler.

● BetaGratuit · dans votre navigateur
Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Le générateur calcule le sous-total et la taxe de chaque ligne, additionne le crédit final et vérifie que le résultat ne dépasse pas le total de la facture initiale. La réponse JSON structurée convient à la révision, à l’archivage, aux processus comptables ou à la conversion en document imprimable aux couleurs de votre entreprise.

Commencez par la facture source et un motif précis

Un avoir utile doit être rattaché sans ambiguïté à l’opération qu’il corrige. Saisissez la référence de la facture initiale exactement comme elle figure dans votre système de facturation ou de comptabilité, puis indiquez son total taxes comprises et son code monétaire à trois lettres. Le motif doit expliquer l’événement commercial au lieu de simplement répéter qu’un crédit est accordé. Il peut s’agir de marchandises retournées, d’une réduction de service convenue, d’un stock endommagé, d’une correction tarifaire ou d’une surfacturation. Un motif précis donne aux responsables, clients, comptables et auditeurs le contexte nécessaire pour comprendre l’annulation du chiffre d’affaires et des taxes. Le générateur conserve ce texte dans le document structuré, mais n’invente ni numéro d’avoir, ni date d’émission, ni identité du client, ni formulation juridique, ni statut d’autorisation. Ces champs dépendent de votre organisation et de votre juridiction et doivent être ajoutés par le système qui contrôle la numérotation et l’émission. La séparation entre les faits sources et les identifiants générés rend le calcul déterministe et évite de présenter le document comme officiellement émis avant votre procédure habituelle d’approbation.

Décrivez chaque ligne créditée et laissez le calculateur totaliser

Ajoutez une ligne pour chaque produit, service, frais ou ajustement à créditer. Chaque ligne requiert une description, une quantité positive et un prix unitaire hors taxes non négatif. Le taux de taxe facultatif est exprimé en pourcentage et vaut zéro s’il est omis. Pour chaque ligne, le générateur multiplie la quantité par le prix unitaire, arrondit le sous-total obtenu à deux décimales, calcule la taxe sur ce sous-total arrondi, puis détermine le total de la ligne. Il additionne ensuite tous les sous-totaux et toutes les taxes afin d’obtenir le crédit total. L’arrondi par ligne est volontaire : il correspond à la présentation et à la comptabilisation des documents détaillés dans de nombreux systèmes de facturation, tout en garantissant le rapprochement de chaque ligne affichée avec le récapitulatif. Utilisez des valeurs positives, car le type de document indique déjà que ces montants annulent une partie de la facture ; des quantités ou prix négatifs créeraient une double négation confuse. Si la facture initiale comporte des remises ou des arrondis particuliers, représentez le montant réellement annulé par une ligne d’ajustement explicite afin de rapprocher le total généré de la facture source.

Validez le résultat avant d’émettre le document final

La réponse finale contient le type de document, la référence de la facture initiale, le motif, la devise, les lignes numérotées et une section de totaux. Celle-ci indique le sous-total crédité, la taxe créditée, le crédit global, le total de la facture initiale et le montant restant après cet avoir. Le générateur rejette la requête lorsque le crédit calculé dépasse le total fourni pour la facture initiale. Cette protection évite une erreur de saisie courante, mais ne remplace pas la vérification des avoirs antérieurs rattachés à la même facture. Puisque l’outil ne reçoit que la requête en cours et n’utilise ni réseau ni historique enregistré, votre système de facturation doit contrôler le cumul si plusieurs avoirs sont émis. Avant approbation, comparez les descriptions, quantités, prix, traitements fiscaux, devise et coordonnées du client avec la facture initiale. Attribuez ensuite le numéro officiel et la date d’émission conformément à vos contrôles comptables et aux exigences locales. La réponse structurée peut alimenter un modèle, un processus comptable, une file d’approbation ou un générateur PDF sans imposer les choix de présentation et de conformité à l’étape arithmétique.

Créditer des marchandises retournées

Transformez les quantités retournées, les prix initiaux et les taux de taxe en un avoir détaillé prêt à être approuvé.

Corriger une surfacturation

Documentez un ajustement de prix ou de frais et calculez le montant exact à annuler.

Préparer les données comptables

Créez des totaux structurés et cohérents à archiver, réviser ou transmettre à un générateur de documents de marque.

Quel est le coût d’une requête ?

Chaque requête API coûte $0.002. La version dans le navigateur s’exécute localement sans requête API payante.

L’outil attribue-t-il un numéro d’avoir officiel ?

Non. Il assemble les données calculées, mais confie la numérotation officielle et les dates d’émission à votre processus de facturation contrôlé.

Comment la taxe est-elle calculée ?

La taxe est calculée pour chaque ligne selon son sous-total arrondi et son taux, puis les montants de taxe sont additionnés.

Que se passe-t-il si le crédit dépasse la facture ?

La requête échoue avec une erreur de saisie non valide lorsque le crédit calculé dépasse le total fourni de la facture initiale.

L’outil détecte-t-il les avoirs antérieurs de la même facture ?

Non. Il ne dispose ni du réseau ni d’un historique enregistré ; votre système de facturation doit donc vérifier le cumul avant émission.

Puis-je utiliser un taux de taxe nul ?

Oui. Omettez tax_rate ou attribuez-lui zéro pour une ligne qui ne doit pas ajouter de taxe.

Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.

POSThttps://api.kit.forhosting.com/doc/credit-note-generate

Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.

curl -X POST https://api.kit.forhosting.com/doc/credit-note-generate \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"original_invoice_reference":"INV-2026-0042","original_invoice_total":250,"currency":"USD","reason":"Two items were returned unopened.","items":[{"description":"Wireless keyboard","quantity":2,"unit_price":45,"tax_rate":10},{"description":"Shipping adjustment","quantity":1,"unit_price":5}]}'
{
  "original_invoice_reference": "INV-2026-0042",
  "original_invoice_total": 250,
  "currency": "USD",
  "reason": "Two items were returned unopened.",
  "items": [
    {
      "description": "Wireless keyboard",
      "quantity": 2,
      "unit_price": 45,
      "tax_rate": 10
    },
    {
      "description": "Shipping adjustment",
      "quantity": 1,
      "unit_price": 5
    }
  ]
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "doc.credit_note_generate",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

max_items200
HTTPCodeSignification
401unauthorizedClé API absente ou invalide : vérifiez l’en-tête Authorization.
402insufficient_balanceSolde insuffisant : rechargez votre compte pour lancer cette tâche.
404unknown_typeType de tâche inconnu : vérifiez le champ type de votre requête.
429rate_limitedTrop de requêtes : ralentissez la cadence, puis réessayez.

Consulter la documentation complète du KIT →