Catalog

Créer un article de catalogue

Ajoute une prestation/produit réutilisable au catalogue (pré-remplit ensuite les lignes de devis/factures). Aucun document légal. Scope requis : catalog:write.

post/catalog

Request

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

descriptionstring required
unitPricenumber required
unitstring nullable

Unité de l'article, enregistrée comme celle d'une ligne (voir LineInput).

vatRatenumber
discountPercentnumber
isFavoriteboolean

Example request

{
  "unitPrice": 120,
  "unit": "heure"
}

Response

Article créé

idinteger
descriptionstring
unitstring nullable
unitPricestring
vatRatestring
discountPercentstring nullable
isFavoriteboolean

Example response

{
  "unitPrice": "120.00",
  "vatRate": "20.00",
  "discountPercent": "0.00"
}

Changes

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