Concepten
Geld en valuta's
Bedragen zijn getallen met de eigen decimalen van hun valuta, naast de ISO 4217-code van de valuta. Prijzen zijn inclusief btw.
Hoe een bedrag eruitziet
Elk bedrag is een JSON-getal, geschreven met precies het aantal decimalen dat de valuta heeft, naast de drieletterige ISO 4217-code van de valuta:
{ "total": 147.00, "vat": 25.51, "currency": "EUR" }
{ "total": 147, "vat": 13, "currency": "JPY" }
{ "total": 147.000, "vat": 7.000, "currency": "KWD" }Een evenement heeft één valuta, gekozen bij het maken, en elke prijs, bestelling, factuur en korting ervan is in die valuta. Het evenement noemt hem in currency.
Om in de kleinste eenheid op te slaan, vermenigvuldig je met tien tot de macht van het aantal decimalen van de valuta: 147,00 EUR is 14700 cent, 147 JPY is 147 yen, 147,000 KWD is 147000 fils.
Btw
Prijzen zijn inclusief btw, zoals de deelnemer ze betaalt. Een bestelling noemt het total en de vat die erin zit; elke factuurregel heeft een eigen btw-tarief, één keer afgerond op de regel, zodat de regels optellen tot de factuur. Btw wordt gerekend waar het evenement plaatsvindt, dus een zakelijke koper uit een ander land betaalt ook de btw van het evenement.
Het budget is de uitzondering: dat wordt exclusief btw begroot, en het overzicht zegt dat in basis.
Waar bedragen staan
| Resource | Bedragen |
|---|---|
| Tickettypes | price |
| Extra's | price |
| Kortingscodes | value voor een bedrag eraf (een percentage is een gewoon getal), discounted |
| Bestellingen | total, vat |
| Facturen en creditnota's | total, vat, en per regel unitPrice, total, vat |
| Statistieken en verkooptempo van een evenement | revenue, vat |
| Overzicht van het budget | elk bedrag, exclusief btw |
| Ranglijst van de deelkit | revenue |
| Onkostendeclaraties (webhooks) | claimed, approved |
De bedragen van een creditnota zijn de bedragen die hij teruggeeft. Terugbetalingen zijn altijd creditnota's: een factuur wordt nooit gewijzigd als hij eenmaal is uitgegeven.
Meerdere valuta's
Een werkruimte kan evenementen in verschillende valuta's houden; tel bedragen per valuta op, nooit over valuta's heen. Als een factuur de btw ook in een andere valuta moet vermelden (in sommige landen vraagt de wet dat), zeggen vatConverted en vatCurrency hoeveel, tegen de koers die op de factuur is vastgelegd.