Produits et lignes

Structurez les lignes de devis et factures, avec ou sans produit YAOKA.

Le catalogue produits est disponible dans YAOKA Business, mais sa gestion n’est pas encore exposée par l’API publique. Les devis et factures peuvent néanmoins référencer un produit existant avec productId.

Contrat d’une ligne

Champ	Type	Obligatoire	Description
`label`	string	oui	Nom affiché sur le document.
`description`	string	non	Détail affiché sous le libellé.
`quantity`	number	oui	Quantité strictement positive.
`unitPrice`	string décimale	oui	Prix unitaire HT.
`vatRate`	string décimale	oui	Taux de TVA entre 0 et 100.
`unit`	string	non	`piece`, `hour`, `day`, `month`, etc.
`productId`	string	non	Référence vers un produit YAOKA existant.

{
  "label": "Abonnement mensuel",
  "description": "Accès pour 10 utilisateurs",
  "quantity": 1,
  "unitPrice": "99.00",
  "vatRate": "20.00",
  "unit": "month",
  "productId": "prd_..."
}

N’envoyez jamais totalHt, totalTax ou totalTtc. YAOKA recalcule tous les totaux côté serveur afin de conserver une source de vérité unique.

TVA à zéro

Envoyez explicitement "vatRate": "0.00". La justification fiscale éventuelle reste portée par les mentions du document ; YAOKA ne déduit pas automatiquement le motif d’exonération depuis le taux.

Tests et production Devis