Invoices

Créer un brouillon d'avoir depuis une facture

Crée un BROUILLON d'avoir (note de crédit) à partir d'une facture émise : lignes et totaux repris de la facture (avoir total par défaut). Sans émission : ni numéro officiel, ni PDF, ni transmission ; le brouillon se finalise dans l'app. La facture reste inchangée. id = identifiant de la FACTURE. Scopes requis : invoices:read ET creditnotes:draft.

post/invoices/{id}/credit-note-draft

Request

  • Base URL: https://api.swipify.fr/api/v1
  • URL: https://api.swipify.fr/api/v1/invoices/{id}/credit-note-draft
  • Auth: API key in header X-API-Key

Path parameters

idinteger required

Headers

Idempotency-Keystring

Clé d'idempotence (un UUID est recommandé). Optionnelle mais conseillée sur les retries réseau : la première réponse 2xx est mémorisée par (organisation, clé) ~24 h et rejouée au lieu de recréer la ressource (évite les doublons de facture/devis/client). Réutiliser la même clé pour une autre requête (méthode/chemin différents) renvoie 422. L'en-tête X-Idempotency-Key est accepté comme alias équivalent.

Response

Brouillon d'avoir créé

idinteger
numberstring nullable
draftNumberstring nullable
statusstring
creditTypestring nullable
creditReasonstring nullable
originalInvoiceIdinteger nullable
originalInvoiceNumberstring nullable
datestring date-time nullable
totalHTstring
totalVATstring
totalTTCstring
einvoiceStatus'pending' | 'delivered' | 'accepted' | 'rejected' | 'paid' | 'reported' | 'error' | 'null' nullable

Statut de cycle de vie e-invoice (PA). null si pas de cycle (brouillon/non conforme). rejected = refusée par la plateforme. reported = vente à un particulier, transmise en e-reporting : pas d'e-facture, donc ni remise ni acceptation client.

createdAtstring date-time

Example response

{
  "number": "AV-2026-0003",
  "status": "validated"
}

Changes

No recorded changes to this operation across all 1 revision of this API.