Conceptos
Importes y monedas
Los importes son números con los decimales propios de su moneda, junto al código ISO 4217 de la moneda. Los precios incluyen el IVA.
Cómo es un importe
Cada importe es un número JSON escrito exactamente con los decimales que tiene su moneda, junto al código ISO 4217 de tres letras de la moneda:
{ "total": 147.00, "vat": 25.51, "currency": "EUR" }
{ "total": 147, "vat": 13, "currency": "JPY" }
{ "total": 147.000, "vat": 7.000, "currency": "KWD" }Un evento tiene una sola moneda, elegida al crearlo, y todos sus precios, pedidos, facturas y descuentos están en esa moneda. El evento la indica en currency.
Para guardar unidades menores, multiplica por diez elevado a los decimales de la moneda: 147,00 EUR son 14700 céntimos, 147 JPY son 147 yenes y 147,000 KWD son 147000 fils.
IVA
Los precios incluyen el IVA, tal como los paga el asistente. Un pedido indica su total y el vat que contiene; cada línea de factura lleva su propio tipo de IVA, redondeado una vez en la línea, de modo que las líneas suman el total de la factura. El IVA se cobra donde tiene lugar el evento, así que un comprador empresarial de otro país también paga el IVA del evento.
El presupuesto es la excepción: se planifica sin IVA, y su resumen lo indica en basis.
Dónde aparecen importes
| Recurso | Importes |
|---|---|
| Tipos de entrada | price |
| Complementos | price |
| Códigos de descuento | value para un descuento en importe (un porcentaje es un número sin más), discounted |
| Pedidos | total, vat |
| Facturas y facturas rectificativas | total, vat, y en cada línea unitPrice, total, vat |
| Estadísticas del evento y ritmo de ventas | revenue, vat |
| Resumen del presupuesto | todos los importes, sin IVA |
| Clasificación del kit para compartir | revenue |
| Notas de gastos (webhooks) | claimed, approved |
Los importes de una factura rectificativa son los importes que devuelve. Los reembolsos son siempre facturas rectificativas: una factura nunca se modifica una vez emitida.
Varias monedas
Un espacio de trabajo puede organizar eventos en monedas distintas; suma los importes por moneda, nunca entre monedas. Cuando una factura también debe indicar su IVA en otra moneda (la ley lo exige en algunos países), vatCurrency y vatConverted indican cuánto, al tipo de cambio registrado en la factura.