Avoirs

POST /businesses/{business}/credit-notes

Champ	Sens	S’il est omis
reference_type	COR (correction), RAN (annulation), RAM (avoir suite à une reprise) ou RRR (remise, ristourne, rabais). Obligatoire.
reference_desc	La raison, 90 caractères au plus. Obligatoire.
original_invoice_id, original_code_def, original_external_reference	La facture d’origine, par notre identifiant, par son code DGI (avec ou sans tirets), ou par votre external_reference. Exactement un. Obligatoire pour COR, RAN et RAM. Un RRR peut n’en avoir aucun.
items[]	Les lignes créditées : position (la place de la ligne dans l’origine, à partir de 1, qui est l’index de ses lines) et quantity (trois décimales au plus, au plus ce qui reste). Le reste vient de l’origine, au prix où elle a été vendue.	toutes les lignes encore créditables, à ce qui reste (items dans defaults_applied)
type	FA, ou EA pour une exportation.	EA si l’origine est une facture d’exportation, sinon FA (type dans defaults_applied)
target	Le point de vente qui normalise l’avoir.	celui de la facture d’origine
operator_name, notes, comment_lines	Comme sur une facture.	les mêmes défauts
currency, exchange_rate, price_mode, client	Seulement sur un RRR sans facture d’origine, où ils fonctionnent comme sur une facture, et où items (avec description, unit_price, tax_group) et currency sont obligatoires. Partout ailleurs ils viennent de l’origine et sont refusés s’ils sont envoyés (400 CREDIT_NOTE_FIELD_NOT_ALLOWED).
format	Accepté et ignoré.

À savoir : on ne peut pas créditer un avoir ; les quantités créditées ne peuvent pas dépasser ce qui reste sur la ligne (400 CREDIT_QUANTITY_EXCEEDED), avoirs encore en file compris ; un avoir sur une facture encore en file attend derrière elle ; si l’origine finit en échec, l’avoir échoue aussi, et en créer un sur une origine déjà en échec répond 409 ORIGINAL_NOT_NORMALISED. L’origine est cherchée dans l’entreprise : la facture d’une autre entreprise répond 404 INVOICE_NOT_FOUND. La DGI n’exige pas qu’un avoir reprenne toute l’origine : les avoirs partiels sont acceptés, au prix vendu.

{
  "external_reference": "AVOIR-2026-000007",
  "original_external_reference": "VENTE-2026-000123",
  "reference_type": "COR",
  "reference_desc": "Erreur de quantité sur le ticket",
  "items": [ { "position": 1, "quantity": 1 } ]
}

La réponse a la même forme que celle d’une facture, avec type (FA/EA), original_invoice_id, reference_type et reference_desc.