Ha nem a platformunkon keresztül adtál el jegyeket, azokat egyszerűen importálhatod a rendszerbe, hogy minden rendezvényre szóló belépőjegyed egy helyen legyen.
A jegyek importálása alapértelmezetten nem érhető el az admin felületen, ha szükséged van rá akkor vedd fel velünk a kapcsolatot és elérhetővé neked.
Mikor érdemes importálnod a jegyeket?
Ha párhuzamosan értékesítettél több rendszerben, és szeretnéd a beléptetést teljesen a mi rendszerünkből kezelni
Ha folyamatban van a rendezvényed értékesítése, és menet közben szeretnél Cooltix-ra váltani
Miért érdemes importálni a külső eladásaidat?
Egy helyen követheted a beléptetési statisztikákat
Elegendő egy beléptető alkalmazást használnod a bejáratnál
Az eseményed minden résztvevőjének adatát egy helyen kezelheted
Elengedő egy helyen keresned egy-egy vásárlást
Az importált jegyek nem jelennek meg az eladási kimutatásokban, de a beléptetések kimutatásainál igen. A jegyek listájában, vásárlások listájában és az exportban benne vannak.
Az importálás menete
1. Esemény feltöltése
Ha az eseményed még nem létezik, akkor töltsd fel az admin felületen. Az importáláshoz nem kell hogy publikáld az eseményedet, és rejtett is lehet (amit az esemény beállítások > láthatóság menüpontban tudsz beállítani)
Az importáláshoz az esemény publikálása nem szükséges, de a beléptetni csak publikált eseményhez tudsz.
2. Jegytípus beállítása
Add hozzá az eseményedhez a jegytípusokat amikre importálni szeretnél. Már egyébként is létező jegytípust is használhatsz, nem kötelező külön jegytípust létrehoznod az importáláshoz.
Amit a jegytípusok létrehozásánál érdemes megfontolnod:
A jegytípus elnevezése bármi lehet, megegyezhet de el is térhet a külső rendszerben használt elnevezéstől. Importálás után a mi rendszerünkben megadott jegytípus elnevezés fog megjelenni a kimutatásokban és a beléptetésnél
A jegyek beléptethetőségének időtartamát a jegytípus beállításai határozzák meg. Ha az egyes jegytípusok beléptethetőségi időtartama eltér, akkor érdemes ezekre külön jegytípusokat létrehozni (pl pénteki és szombati napijegy). Az importálás során az egyes jegyekhez nem kerül rögzítésre a beléptethetőség időtartama, így ha importálás után a jegytípus beállításainál módosítod akkor az az importált jegyekre is vonatkozik.
A beléptető felhasználóid jogosultságait jegytípusonként tudod megadni, ha szeretnéd hogy valamelyik belépési ponton csak bizonyos jegytípusok tudjanak belépni, akkor érdemes külön jegytípust létrehoznod rájuk (pl VIP és sajtó jegyek)
A jegytípusok rejtve is lehetnek, és nem kell hogy bárhol is elérhetőek vagy megvásárolhatóak legyenek, így is beléptethetőek ha az esemény publikálva van
2. Készítsd el az import fájl
A jegyek adatait tartalmazó táblázatot CSV formátumban tudod felölteni az admin felületre. Ha ugyanabból a rendszerből rendszeresen szeretnél importálni jegyeket, akkor az import fájlt API-n keresztül is feltöltheted.
Az importálásra vonatkozó fontos információk
A táblázat egy sora egy jegynek felel meg
A fájl formátuma pontosvesszővel ( ; ) tagolt CSV kell legyen UTF-8 karakterkódolással. A fájl nem tartalmazhat üres sorokat, vagy az importálható adatokon túl további oszlopokat.
Importálni csak eseményenként tudsz. Ha több eseményre szeretnél egyszerre importálni, akkor azt eseményenként külön lépésben tudod megtenni
A jegyek kódja egyedi kell legyen, nem csak eseményen belül hanem minden eseményen keresztül
Az importálás csak akkor lesz sikeres, ha a feltöltés után az ellenőrzésünk semmilyen hibát nem talált. Ha bármilyen hibát tartalmaz a fájl akkor a fájlból egy jegy sem kerül importálásra
Importálás után már nem tudod módosítani vagy törölni a feltöltött jegyeket, így körültekintően járj el, és feltöltés előtt ellenőrizd az adatok megfelelőségét
Az import fájlban csak formai ellenőrzést tudunk végezni, az elírásokat vagy az adatok helyességét nem
Töltsd le az eseményed típusának és igényeidnek megfelelő import sablonunkat:
Esemény típusa | Minimum adat | Minden adat |
Egyszeri esemény | ||
Ültetett esemény | ||
Időpont foglalásos esemény |
Kötelező minden eseménynél
Oszlop fejléc | Leírás |
productId | A Cooltix rendszerében a jegytípus azonosítója. A jegytípus szerkesztése közben a böngésző URLjének végén található. Például ha az URL: |
voucherCode | Az importált jegy QR kódjának értéke. Fontos hogy egyezzen meg azzal a kóddal amit a QR kód tartalmaz. |
Kötelező oszlopok időpont foglalásos eseménynél
A minden eseménytípusnál kötelező oszlopokon felül.
Oszlop fejléc | Leírás |
OccasionId | A Cooltix rendszerében az időpont azonosítója. Az időpont szerkesztése közben a böngésző URLjének végén található. Például ha az URL: |
Kötelező oszlopok ültetett eseménynél
A minden eseménytípusnál kötelező oszlopokon felül.
Oszlop fejléc | Leírás |
Helyfoglalásos szektor esetén: |
|
sectionLabel | A szektor megnevezése/sorszáma a térképen |
rowLabel | A sor megnevezése/sorszáma a térképen |
seatLabel | A szék megnevezése/sorszáma a térképen |
Érkezési sorrendes szektor esetén: |
|
generalAdmissionLabel | Az érkezési sorrendes szektor megnevezése/sorszáma a térképen |
Ha egy jegy helyfoglalásos szektorhoz tartozik akkor generalAdmissionLabel nem tartozhat hozzá, de sectionLabel, rowLabel és SeatLabel értékek kötelezőek.
Ha egy jegy helyfoglalásos szektorhoz tartozik akkor sectionLabel, rowLabel és SeatLabel nem tartozhat hozzá, de generalAdmissionLabel értékek kötelező.
További opcionálisan importálható oszlopok minden esemény típushoz
name | A jegyen szereplő név |
externalOrderId | Vásárlási azonosító a külső rendszerben. Ha meg van adva akkor ez alapján lesznek vásárláshoz csoportosítva a jegyek. Ha nincs megadva akkor egy vásárláshoz fog tartozni az összes importált jegy. |
orderDate | A vásárlás dátuma ISO formátumban: 2025-01-01T01:01:00Z |
customerEmail | Ha meg van adva akkor ez alapján lesznek vásárláshoz csoportosítva a jegyek. Ha meg van adva akkor importálás után a vásárlók Cooltix-es fiókjában is megjelenik a jegy. Ha meg van adva akkor a |
customerName | A vásárló neve. Ha meg van adva akkor a |
paymentMethodType | A vásárlás fizetési módja. A lehetséges értékek: online_card card cash otp_szep_card_online mbh_szep_card_online kh_szep_card_online apple_pay google_pay sofort eps szep_card_present |
invoiceNumber | A vásárláshoz tartozó számla sorszáma |
billingAddressCountryCode | A vásárlás számlázási adatának országa, ISO kód formátumban, (pl: HU) Ha megvan adva akkor mind a négy billingAddress oszlop kötelező. |
billingAddressPostalCode | A vásárlás számlázási adatának irányító száma. Ha megvan adva akkor mind a négy billingAddress oszlop kötelező. |
billingAddressCity | A vásárlás számlázási adatának városa. Ha megvan adva akkor mind a négy billingAddress oszlop kötelező. |
billingAddressLine | A vásárlás számlázási adatának címe. Ha megvan adva akkor mind a négy billingAddress oszlop kötelező. Legalább 2 karakter hosszú kell legyen. |
productPrice | A jegyen szereplő ár. Nem kell megegyezzen a jegytípus beállított árával, importált jegyeknél ha meg van adva akkor a productPrice kerül alkalmazásra. |
handlingFee | A jegy után fizetett kezelési költség. Nem kell megegyezzen a jegytípus beállított kezelési költségével, importált jegyeknél ha meg van adva akkor a handlingFee kerül alkalmazásra. |
currency | A vásárlás pénzneme ISO formátumban (például HUF) |
NTAK adatszolgáltatás esetén szükséges további adatok
Ezek hiányában NTAK felé a jegyek beléptetése nem kerül küldésre. Az alábbi mezőknél a jegyek értékesítését végző rendszerben használt azonosítókat kell megadni.
A működéshez a Szolgáltatási helyhez tartozó beállított NTAK-Cooltix összeköttetés szükséges.
fejléc | Leírás |
ntakSystemId | Az értékesítő rendszer NTAK azonosítója |
ntakSystemVersionNumber | Az értékesítő rendszer NTAK verziószáma |
ntakServiceLocationRegistrationNumber | Az értékesítéskor használt Szolgáltatási hely azonosító |
ntakTicketId | A jegy NTAK felé küldött azonosítója |
ntakProgramId | Az esemény NTAK felé küldött azonosítója |
ntakProgramLastModificationDate | Az esemény NTAK felé küldött utolsó módosítási dátuma. Opcionális, ha nincs megadva akkor a Cooltix esemény utolsó módosítási dátuma kerül küldésre |
Letölthető import minták: