Invoices

Créer une facture finalisée (payée)

Crée une facture finalisée déjà payée, émise depuis l'organisation de la clé. Par défaut, renvoie la facture créée en JSON (lignes, client et pdfUrl) ; envoyez l'en-tête Accept: application/pdf pour récupérer directement le PDF Factur-X binaire. Scope invoices:write (intégration serveur-à-serveur : générez vos factures automatiquement). Ne déclenche pas d'émission e-invoice.

post/invoices

Request

  • Base URL: https://api.swipify.fr/api/v1
  • URL: https://api.swipify.fr/api/v1/invoices
  • Auth: API key in header X-API-Key

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.

Request body

paymentModestring
paidDatestring date required
objectstring nullable
brandProfileKeystring

Profil de marque (logo/nom commercial/couleur). Absent → profil par défaut. Voir GET /brand-profiles. La clé est normalisée en minuscules (lowercase).

Example request

{
  "customer": {
    "type": "company",
    "name": "Menuiserie Durand",
    "firstName": "Marc",
    "lastName": "Durand",
    "siret": "80295478500018",
    "email": "contact@menuiserie-durand.fr"
  },
  "lines": [
    {
      "description": "Pose de parquet chêne",
      "quantity": 25,
      "unit": "m²",
      "unitPrice": 48,
      "vatRate": 10
    }
  ],
  "paidDate": "2026-07-15",
  "paymentMode": "Virement"
}

Response

Facture créée. JSON par défaut ; PDF Factur-X binaire si Accept: application/pdf.

idinteger
numberstring nullable
draftNumberstring nullable
statusstring
objectstring nullable
datestring date-time nullable
dueDatestring date-time nullable
paidDatestring 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.

brandProfileKeystring nullable

Profil de marque du document. null = profil par défaut.

reminderCountinteger

Nombre de relances d'impayé envoyées (manuelles et automatiques). L'envoi d'une relance reste un geste dans l'application, jamais un appel API.

reminderLastSentAtstring date-time nullable

Date de la dernière relance d'impayé, null si jamais relancée.

remindersPausedboolean

true si les relances automatiques sont suspendues pour cette facture.

recurringboolean

true si la facture a été générée par une facture récurrente.

createdAtstring date-time
pdfUrlstring

Chemin pour re-télécharger le PDF Factur-X (GET /invoices/{id}/pdf).

Example response

{
  "id": 1234,
  "number": "FAC-2026-0042",
  "status": "paid",
  "totalHT": "850.00",
  "totalVAT": "170.00",
  "totalTTC": "1020.00",
  "brandProfileKey": "boutique-lyon",
  "reminderCount": 1,
  "pdfUrl": "/api/v1/invoices/1234/pdf"
}

Changes

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