Concepts
Montants et devises
Les montants sont des nombres avec les décimales propres à leur devise, accompagnés du code ISO 4217 de la devise. Les prix incluent la TVA.
À quoi ressemble un montant
Chaque montant est un nombre JSON écrit avec exactement le nombre de décimales de sa devise, accompagné du code ISO 4217 à trois lettres de la devise :
{ "total": 147.00, "vat": 25.51, "currency": "EUR" }
{ "total": 147, "vat": 13, "currency": "JPY" }
{ "total": 147.000, "vat": 7.000, "currency": "KWD" }Un événement a une seule devise, choisie à sa création, et chacun de ses prix, commandes, factures et réductions est exprimé dans cette devise. L’événement l’indique dans currency.
Pour stocker des unités mineures, multipliez par dix puissance le nombre de décimales de la devise : 147,00 EUR font 14700 centimes, 147 JPY font 147 yens, 147,000 KWD font 147000 fils.
TVA
Les prix incluent la TVA, tels que le participant les paie. Une commande indique son total et la vat qu’il contient ; chaque ligne de facture porte son propre taux de TVA, arrondi une seule fois sur la ligne, pour que les lignes s’additionnent jusqu’au total de la facture. La TVA est due là où l’événement a lieu : un acheteur professionnel d’un autre pays paie donc lui aussi la TVA de l’événement.
Le budget fait exception : il est prévu hors TVA, et sa synthèse le précise dans basis.
Où apparaissent les montants
| Ressource | Montants |
|---|---|
| Types de billets | price |
| Options | price |
| Codes de réduction | value pour une réduction en montant (un pourcentage est un simple nombre), discounted |
| Commandes | total, vat |
| Factures et avoirs | total, vat, et pour chaque ligne unitPrice, total, vat |
| Statistiques de l’événement et rythme des ventes | revenue, vat |
| Synthèse du budget | tous les montants, hors TVA |
| Classement du kit de partage | revenue |
| Notes de frais (webhooks) | claimed, approved |
Les montants d’un avoir sont les montants qu’il restitue. Un remboursement passe toujours par un avoir : une facture n’est jamais modifiée une fois émise.
Plusieurs devises
Un espace de travail peut organiser des événements dans différentes devises ; additionnez les montants par devise, jamais entre devises. Quand une facture doit aussi indiquer sa TVA dans une autre devise (la loi l’exige dans certains pays), vatCurrency et vatConverted en donnent le montant, au taux enregistré sur la facture.