Aller au contenu

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.

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.

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

  • Définissez le type d’opération sur CORRECTION avec data.type = INVOICE
  • Référencez la facture originale via operation.record.id
  • 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"
},
"entries": [
{
"type": "RETURN",
"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"
}
}
]
}
}
}
}
ScénarioActionDocuments émis
Annulation totale — doublon, mauvais acheteur ou transaction annuléeCréditer le montant totalNote de crédit uniquement
Crédit partiel — retour, remise ou surfacturationCréditer uniquement les lignes ou montants concernésNote de crédit uniquement
Correction — données ou montants incorrects sur la facture originaleCréditer le montant total, puis réémettre corrigéeNote de crédit + nouvelle facture
Montant insuffisant — le montant original était trop basCréditer le montant total, puis réémettre avec le montant correctNote de crédit + nouvelle facture

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

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

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

À 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 €6300.00
↓
Note de crédit CN-002 €600.00 (référence INV-001, lignes concernées uniquement)
↓
Résultat net : €5700.00

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.

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

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

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)

Section intitulée « Montant insuffisant (crédit + réémission plus élevée) »

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

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

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

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

Les deux enregistrements suivent le flux standard INTENTION → TRANSACTION.

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. Émettez toujours une note de crédit en tant que CORRECTION. Une INVOICE avec des montants négatifs n’est pas une note de crédit.

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

Section intitulée « 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", ... }
}
}
}

Utilisez le même destinataire que sur la facture d’origine, avec le même canal de distribution et le même format.

Les notes de crédit doivent utiliser une série de numérotation séquentielle séparée (ex. CN-2026-000001). Incluez le préfixe de la série dans document.number et laissez document.series vide.

Le type de document n’est pas défini par vous : il découle de l’opération de l’Unified API que vous appelez. Une CORRECTION produit un avoir et une INVOICE produit une facture, quel que soit le type de ligne.

Définissez entries[].type = RETURN sur chaque ligne créditée, avec des montants positifs. Les lignes de la facture d’origine utilisent SALE.

Deux champs de entries[] 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.

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. Veillez à ce que les notes de crédit d’une même facture ne totalisent pas plus que la facture. Une note de crédit annulée par une nouvelle facture n’entre plus dans ce total.

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, émettez à la place un nouveau document. Lequel dépend de ce qui était erroné :

Ce qui était erronéActionDocuments émis
Crédit insuffisantCréditer le montant manquantUne autre note de crédit, référençant la facture d’origine
Crédit excessif ou émise par erreurFacturer la différenceNouvelle facture, référençant la note de crédit
Données erronées sur la note de créditFacturer le montant de la note de crédit, puis créditer à nouveau correctementNouvelle facture référençant la note de crédit + nouvelle note de crédit référençant la facture d’origine
Facture originale INV-001 €6300.00
↓
Note de crédit CN-001 €300.00 (référence INV-001, aurait dû être de €600.00)
↓
Note de crédit CN-002 €300.00 (référence INV-001, le montant manquant)
↓
Résultat net : €5700.00
Facture originale INV-001 €6300.00
↓
Note de crédit CN-001 €6300.00 (référence INV-001, aurait dû être de €600.00)
↓
Nouvelle facture INV-002 €5700.00 (référence CN-001, la différence)
↓
Résultat net : €5700.00

Pour une note de crédit émise par erreur, la nouvelle facture porte sur le montant total de la note de crédit.

Facture originale INV-001 €6300.00
↓
Note de crédit CN-001 €600.00 (référence INV-001, données erronées)
↓
Nouvelle facture INV-002 €600.00 (référence CN-001, l'annule)
↓
Note de crédit CN-002 €600.00 (référence INV-001, données correctes)
↓
Résultat net : €5700.00

La nouvelle facture reprend dans document.references.preceding_document le numéro et la date d’émission de la note de crédit qu’elle annule.