Quotes

Créer un brouillon de devis (non émis)

Devis BROUILLON depuis l'organisation de la clé. Client optionnel : customer OU clientId. Scope requis : quotes:draft.

post/quotes/draft

Request

  • Base URL: https://api.swipify.fr/api/v1
  • URL: https://api.swipify.fr/api/v1/quotes/draft
  • 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

clientIdinteger

Référence un client existant (exclusif avec customer).

objectstring nullable
validUntilstring date-time
includeBankDetailsboolean

Imprime le RIB de la fiche entreprise (IBAN, BIC et numéro du devis en référence) dans le bloc « Conditions / RIB » du devis, pour régler l'acompte par virement. Sans effet sans échéancier ou sans IBAN.

brandProfileKeystring

Profil de marque mémorisé sur le brouillon et relu à la validation dans l'app. Absent → profil par défaut. Voir GET /brand-profiles pour la clé (elle diffère du nom affiché). Clé inconnue → 400.

Example request

{
  "paymentSchedule": [
    {
      "when": "À la signature du devis",
      "percent": 30
    },
    {
      "when": "À la fin de la prestation"
    }
  ],
  "brandProfileKey": "boutique-lyon"
}

Response

Devis brouillon créé

idinteger
numberstring nullable
draftNumberstring nullable
statusstring
versioninteger
objectstring nullable
datestring date-time nullable
validUntilstring date-time nullable
acceptanceModestring
includeBankDetailsboolean

Imprime le RIB de la fiche entreprise (IBAN, BIC et numéro du devis en référence) dans le bloc « Conditions / RIB » du devis, pour régler l'acompte par virement. Sans effet sans échéancier ou sans IBAN.

acceptedAtstring date-time nullable
rejectedAtstring date-time nullable
totalHTstring
totalVATstring
totalTTCstring
brandProfileKeystring nullable

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

createdAtstring date-time

Example response

{
  "number": "DEV-2026-0007",
  "status": "accepted",
  "version": 1,
  "acceptanceMode": "PAYMENT",
  "paymentSchedule": [
    {
      "when": "À la signature du devis",
      "percent": 30
    },
    {
      "when": "À la fin de la prestation"
    }
  ],
  "brandProfileKey": "boutique-lyon"
}

Changes

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