AttendBeacon
Otwórz przestrzeń roboczą

Pojęcia

Kwoty i waluty

Kwoty to liczby z liczbą miejsc po przecinku właściwą dla waluty, podawane obok kodu waluty według ISO 4217. Ceny zawierają VAT.

Jak wygląda kwota

Każda kwota to liczba JSON zapisana z dokładnie taką liczbą miejsc po przecinku, jaką ma jej waluta, obok trzyliterowego kodu waluty według ISO 4217:

JSON
{ "total": 147.00, "vat": 25.51, "currency": "EUR" }
{ "total": 147,    "vat": 13,    "currency": "JPY" }
{ "total": 147.000, "vat": 7.000, "currency": "KWD" }

Wydarzenie ma jedną walutę, wybraną przy jego tworzeniu, i wszystkie jego ceny, zamówienia, faktury i rabaty są w tej walucie. Wydarzenie podaje ją w polu currency.

Aby zapisać kwotę w jednostkach podrzędnych, pomnóż ją przez dziesięć do potęgi równej liczbie miejsc po przecinku waluty: 147,00 EUR to 14700 centów, 147 JPY to 147 jenów, 147,000 KWD to 147000 filsów.

VAT

Ceny zawierają VAT, tak jak płaci je uczestnik. Zamówienie podaje swoją kwotę total i zawarty w niej vat. Każda pozycja faktury ma własną stawkę VAT, zaokrąglaną raz na pozycji, więc pozycje sumują się do kwoty faktury. VAT nalicza się tam, gdzie odbywa się wydarzenie, więc kupujący będący firmą z innego kraju również płaci VAT kraju wydarzenia.

Wyjątkiem jest budżet: planuje się go w kwotach netto, a jego podsumowanie podaje to w polu basis.

Gdzie występują kwoty

ZasóbKwoty
Rodzaje biletówprice
Dodatkiprice
Kody rabatowevalue dla rabatu kwotowego (procent to zwykła liczba), discounted
Zamówieniatotal, vat
Faktury i faktury korygującetotal, vat oraz unitPrice, total, vat każdej pozycji
Statystyki wydarzenia i tempo sprzedażyrevenue, vat
Podsumowanie budżetuwszystkie kwoty, netto
Ranking zestawu do udostępnianiarevenue
Rozliczenia wydatków (webhooki)claimed, approved

Kwoty faktury korygującej to kwoty, które zwraca. Zwroty są zawsze fakturami korygującymi: raz wystawionej faktury nigdy się nie zmienia.

Wiele walut

Przestrzeń robocza może prowadzić wydarzenia w różnych walutach. Sumuj kwoty w obrębie jednej waluty, nigdy między walutami. Gdy faktura musi podawać VAT także w innej walucie (w niektórych krajach wymaga tego prawo), vatCurrency i vatConverted podają tę kwotę według kursu zapisanego na fakturze.

Przewodniki i ta witryna są w twoim języku. Opisy w samej dokumentacji API są po angielsku, tak jak mówi samo API.