Conceitos
Dinheiro e moedas
Os montantes são números com as casas decimais da sua moeda, ao lado do código ISO 4217 da moeda. Os preços incluem IVA.
Como é um montante
Cada montante é um número JSON escrito exatamente com as casas decimais que a sua moeda tem, ao lado do código ISO 4217 de três letras da moeda:
{ "total": 147.00, "vat": 25.51, "currency": "EUR" }
{ "total": 147, "vat": 13, "currency": "JPY" }
{ "total": 147.000, "vat": 7.000, "currency": "KWD" }Um evento tem uma moeda, escolhida quando é criado, e todos os preços, encomendas, faturas e descontos do evento estão nessa moeda. O evento indica qual em currency.
Para guardar em unidades menores, multiplique por dez elevado ao número de casas decimais da moeda: 147.00 EUR são 14700 cêntimos, 147 JPY são 147 ienes, 147.000 KWD são 147000 fils.
IVA
Os preços incluem IVA, tal como o participante os paga. Uma encomenda indica o seu total e o vat nele incluído; cada linha de fatura tem a sua própria taxa de IVA, arredondada uma vez na linha, para que as linhas somem o total da fatura. O IVA é cobrado onde o evento se realiza, por isso um comprador empresarial de outro país também paga o IVA do evento.
O orçamento é a exceção: é planeado sem IVA, e o seu resumo indica-o em basis.
Onde aparece dinheiro
| Recurso | Montantes |
|---|---|
| Tipos de bilhete | price |
| Complementos | price |
| Códigos de desconto | value para um desconto em valor (uma percentagem é um número simples), discounted |
| Encomendas | total, vat |
| Faturas e notas de crédito | total, vat, e em cada linha unitPrice, total, vat |
| Estatísticas do evento e ritmo de vendas | revenue, vat |
| Resumo do orçamento | todos os montantes, sem IVA |
| Classificação do kit de partilha | revenue |
| Pedidos de reembolso de despesas (webhooks) | claimed, approved |
Os montantes de uma nota de crédito são os montantes que devolve. Os reembolsos são sempre notas de crédito: uma fatura nunca é alterada depois de emitida.
Várias moedas
Uma área de trabalho pode ter eventos em moedas diferentes; some os montantes por moeda, nunca entre moedas. Quando uma fatura também tem de indicar o IVA noutra moeda (a lei exige-o em alguns países), vatCurrency e vatConverted indicam quanto, à taxa registada na fatura.