Section navigation

Note de crédit

Pour corriger une facture électronique précédemment transmise, émettez une note de crédit en utilisant le type d’opération CORRECTION avec data.type = INVOICE. Une note de crédit annule les montants de la facture originale — totalement ou partiellement. Si les données originales doivent également être remplacées, une nouvelle facture est émise après la note de crédit.

La note de crédit référence toujours la facture originale et doit être envoyée au même destinataire.

Quand émettre une note de crédit

Scénario	Action	Documents émis
Annulation totale — doublon, mauvais acheteur ou transaction annulée	Créditer le montant total	Note de crédit uniquement
Crédit partiel — retour, remise ou surfacturation	Créditer uniquement les lignes ou montants concernés	Note de crédit uniquement
Correction — données ou montants incorrects sur la facture originale	Créditer le montant total, puis réémettre corrigée	Note de crédit + nouvelle facture
Montant insuffisant — le montant original était trop bas	Créditer le montant total, puis réémettre avec le montant correct	Note de crédit + nouvelle facture

Flux de correction

Annulation totale

À utiliser lorsque la facture originale n’aurait jamais dû être émise (doublon, mauvais acheteur, commande annulée).

Facture originale   INV-001   €6 300
     ↓
Note de crédit      CN-001    €6 300  (référence INV-001)
     ↓
Résultat net : €0

La facture originale reste dans le système. La note de crédit crée une annulation totale.

Crédit partiel

À utiliser lorsque seulement une partie de la facture originale doit être annulée (article retourné, remise convenue, surfacturation sur des lignes spécifiques).

Facture originale   INV-001   €6 300
     ↓
Note de crédit      CN-002    €600    (référence INV-001, lignes concernées uniquement)
     ↓
Résultat net : €5 700

Seules les lignes créditées sont incluses dans la note de crédit. La facture originale reste valide pour toutes les lignes non créditées.

Correction (crédit + réémission)

À utiliser lorsque la facture originale contenait des données ou des montants incorrects.

Facture originale   INV-001   €6 300
     ↓
Note de crédit      CN-003    €6 300  (annulation totale, référence INV-001)
     ↓
Nouvelle facture    INV-002   €5 950  (données corrigées)
     ↓
Résultat net : €5 950

Annulez entièrement l’originale via une note de crédit, puis émettez une nouvelle facture avec les données correctes.

Montant insuffisant (crédit + réémission plus élevée)

À utiliser lorsque le montant de la facture originale était trop bas.

Facture originale   INV-001   €5 000
     ↓
Note de crédit      CN-004    €5 000  (annulation totale, référence INV-001)
     ↓
Nouvelle facture    INV-003   €6 300  (montant correct)
     ↓
Résultat net : €6 300

Règles

Les montants doivent être positifs

Tous les montants sur une note de crédit doivent être positifs. Le type de document indique que les montants positifs des lignes représentent des crédits. Les valeurs négatives entraîneront des erreurs de validation.

La référence au document précédent est obligatoire

Chaque note de crédit référence la facture originale. Dans la requête CORRECTION::INVOICE, fournissez l’ID de l’enregistrement de transaction original dans le champ content.operation.record.id. fiskaly résout automatiquement les détails du document précédent.

{
  "content": {
    "type": "TRANSACTION",
    "record": { "id": "<intention-record-id>" },
    "operation": {
      "type": "CORRECTION",
      "record": { "id": "<original-transaction-record-id>" },
      "data": { "type": "INVOICE", ... }
    }
  }
}

Le destinataire doit correspondre

Le destinataire de la note de crédit doit correspondre au destinataire de la facture originale.

Série de numérotation séparée

Les notes de crédit doivent utiliser une série de numérotation séquentielle séparée (ex. CN-2026-000001). Fournissez-la via le champ series, de la même manière que pour les factures standard.

Type de ligne

Chaque ligne créditée utilise entries[].type = SALE, le même type de ligne que sur une facture standard. C’est le type de document — et non le type de ligne — qui indique qu’il s’agit d’avoirs.

Le type de ligne ne porte aucune sémantique d’avoir ou de retour en facturation électronique. En Italie, il n’est pas lu du tout lors de la génération de la FatturaPA : mettre RETURN — la valeur qu’utilisent les produits SIGN sur une correction — ne transforme donc pas le document en avoir. Seule l’opération appelée le fait.

Champs de ligne qui n’ont pas à correspondre

Deux champs génèrent souvent un travail inutile sur un avoir :

entries[].details.number n’est pas utilisé en facturation électronique. Il existe pour les produits de fiscalisation, où il identifie la ligne d’origine corrigée. Ne reportez pas les numéros de ligne d’origine sur un avoir : le lien avec la facture initiale est établi une seule fois, au niveau du document, via operation.record.id.
entries[].data.text n’est pas validé et n’a pas à reprendre le libellé de la facture d’origine. Contrairement à SIGN IT, où la description est censée correspondre, vous décrivez la ligne créditée comme elle doit apparaître.

Une facture, plusieurs notes de crédit

Plusieurs notes de crédit peuvent référencer la même facture d’origine — par exemple lorsque les marchandises d’une même facture sont retournées en plusieurs fois, ou lorsque des lignes différentes sont créditées à des moments différents. Chacune est un record CORRECTION indépendant portant le même operation.record.id et ne contenant que les lignes qu’elle crédite. La facture d’origine reste valable pour les lignes non créditées.

Une note de crédit n’est jamais créditée

Une note de crédit référence toujours une facture, jamais une autre note de crédit. Si la note de crédit elle-même doit être corrigée, utilisez le flux note de crédit + réémission décrit ci-dessous : une note de crédit ultérieure référence la facture de remplacement, et non la note de crédit précédente.

Créditer une facture non transmise par fiskaly

⚠️Une facture émise en externe ne peut pas être créditée

Le type de document découle de l’opération et n’est pas défini par vous : une CORRECTION produit un avoir, une INVOICE produit une facture. Référencer une facture émise en externe comme document précédent sur une opération INVOICE sera transmis avec succès, mais le document porte le type facture — ce qui augmente le montant dû au lieu de l’annuler.

Si vous migrez vers fiskaly, conservez votre précédent système de facturation électronique jusqu’à ce que chaque facture qu’il a émise soit réglée ou créditée. Lorsqu’une correction ponctuelle est inévitable, certaines administrations fiscales permettent au commerçant d’émettre un avoir manuellement, en dehors de son prestataire — la disponibilité et la procédure varient selon le pays, consultez donc la page pays correspondante.

Cela découle de la conception actuelle de l’Unified API et pourra changer dans une version future.

Utilisation de l’API

INTENTION

L’étape INTENTION suit le même schéma que pour une facture standard. Appelez l’endpoint createRecord avec un Enregistrement de type INTENTION associé au Système E_INVOICE_SERVICE.

TRANSACTION

Appelez l’endpoint createRecord avec un Enregistrement de type TRANSACTION :

Définissez le type d’opération sur CORRECTION avec data.type = INVOICE
Incluez la référence au document précédent de la facture originale
Incluez les lignes créditées (avec des montants positifs)
Utilisez le même destinataire que la facture originale

Exemple de requête — avoir partiel

{
  "content": {
    "type": "TRANSACTION",
    "record": { "id": "<intention-record-id>" },
    "operation": {
      "type": "CORRECTION",
      "record": { "id": "<original-invoice-transaction-record-id>" },
      "data": {
        "type": "INVOICE",
        "document": {
          "number": "CN-2026-000001",
          "series": "CN"
        },
        "entries": [
          {
            "type": "SALE",
            "details": { "concept": "GOOD" },
            "data": {
              "type": "ITEM",
              "text": "White sugar",
              "unit": {
                "quantity": "1.00",
                "price": {
                  "inclusive": "1220.00",
                  "exclusive": "1000.00"
                }
              },
              "value": { "base": "1000.00" },
              "vat": {
                "type": "VAT_RATE",
                "code": "STANDARD",
                "percentage": "22.00",
                "exclusive": "1000.00",
                "inclusive": "1220.00",
                "amount": "220.00"
              }
            }
          }
        ],
        "breakdown": [
          {
            "type": "VAT_RATE",
            "code": "STANDARD",
            "percentage": "22.00",
            "exclusive": "1000.00",
            "inclusive": "1220.00",
            "amount": "220.00"
          }
        ],
        "totals": {
          "vat": {
            "amount": "220.00",
            "exclusive": "1000.00",
            "inclusive": "1220.00"
          }
        },
        "recipients": [
          {
            "type": "BUSINESS",
            "name": "Dolci Italiani S.r.l.",
            "identification": {
              "type": "VAT",
              "value": "IT12345678901"
            },
            "address": {
              "street": "Via Roma 1",
              "city": "Milano",
              "code": "20121",
              "region": "MI",
              "country": "IT"
            },
            "invoicing": {
              "type": "SDI",
              "destination_code": "ABC1234"
            }
          }
        ]
      }
    }
  }
}

💡Note

Les notes de crédit sont créées sur le système E_INVOICE_SERVICE, en suivant le même flux INTENTION → TRANSACTION que pour les factures électroniques.

Note de crédit + réémission

Pour les scénarios de correction et de montant insuffisant, deux transactions séparées sont nécessaires :

Créez un enregistrement CORRECTION (note de crédit) référençant la facture originale
Créez un nouvel enregistrement INVOICE avec les données corrigées

Les deux enregistrements suivent le flux standard INTENTION → TRANSACTION.