Regisztráció

A pénzügyi adatkapcsolat kialakításához a fogadó rendszert regisztrálni kell a Számlázz.hu rendszerében.

1. lépés: Alapvető információk megadása

Kérjük, add meg a regisztrációs e-mailben:

• Mely számlázási fiókhoz szeretnéd a kapcsolatot kialakítani? (adószám + cégnév)
• Milyen célból szeretnéd az adatkapcsolatot kialakítani? (pl. könyvelés automatizálása, CRM integráció, stb.)

2. lépés: Technikai paraméterek megadása

A fogadó rendszer működéséhez szükséges technikai adatok:

Adat	Leírás	Tipp
name*	A fogadó rendszer neve	Ez jelenik meg a legördülőben és az Online pénzügyi adatkapcsolat oldalon.
email*	Kapcsolattartó e-mail címe	Ide küldjük a kapcsolathoz tartozó rendszerüzeneteket.
contactname*	Kapcsolattartó neve	A kapcsolatért felelős személy neve, aki probléma esetén értesíthető.
keypostfix*	Kulcs végződés	5 karakter, minden azonosító kulcs végére ennek kell kerülnie.
addkeytourl*	A kulcs az URL végére kerüljön-e?	Igen / Nem
urlszamlaki	A kimenő számlák fogadására alkalmas URL
pdfszamlaki	Csatoljuk-e a számla PDF-et is a kimenő számla átadáskor?	Igen / Nem
urlszamlabe	A bejövő számlák fogadására alkalmas URL
pdfszamlabe	Csatoljuk-e a számla PDF-et is a bejövő számla átadáskor?	Igen / Nem
urlbanktranz	A banki tranzakciók fogadására alkalmas URL
urlnyugta	A nyugták fogadására alkalmas URL

Azonosító kulcs és kulcs konkatenálás különbsége

• Az azonosító kulcsot mindig küldjük minden adatcsomaggal a X-Szamlazzhu-Key HTTP fejlécben (alapértelmezett)
• A kulcs konkatenálás (addkeytourl) egy külön funkció, ami a kulcsot az URL végére fűzi (opcionális)
• Két különböző dolog: az egyik a HTTP fejlécben van, a másik az URL-ben

3. lépés: Adatok elküldése

Ha szeretnéd az alkalmazásodat összekötni a Számlázz.hu-val, a fenti paramétereket várjuk tőled. Csak azt az URL-t add meg, amilyen típusú adatot szeretnél fogadni. Töltsd ki a fenti űrlapot vagy töltsd le ezt a CSV-t, írd bele a fogadó rendszered adatait és küldd el e-mail címünkre.

Csak éles fiókban

A bejövő számlák, banki tranzakciók és nyugták adatküldése csak éles fiókban lehetséges.

Fogadó végpont követelményei

Pénzügyi adatkapcsolatot csak olyan fogadó végponttal tudunk kialakítani, amely minden átadott adatcsomagra egyetlen HTTP válaszban HTTP 200 (OK) státuszt ad, és a válasz törzsében a műveletnek megfelelő, helyes (a dokumentáció szerinti) XML-t küld vissza. Enélkül a Számlázz.hu nem tudja megbízhatóan rögzíteni, hogy az adat megérkezett és feldolgozásra került.

A következőket nem tudjuk támogatni:

Olyan végpontokat, amelyek fogadáskor csak HTTP 302 (átirányítás) választ adnak - nem követjük az átirányítást; a válasz XML-nek a válasz törzsében kell megjelennie 200-as státusz mellett. Például a Google Apps Script (vagy hasonló "web app") alapú fogadó végpontok gyakran nem úgy viselkednek, hogy közvetlenül 200-as válasszal és a várt XML-törzzsel térjenek vissza, ahogy az adatkapcsolat elvárja.

Ha a környezeted nem tud ennek megfelelni, olyan szervert vagy API-t érdemes beállítanod, ami közvetlenül, a dokumentáció szerint adja vissza a válasz XML-t.

🔗 Kapcsolat típusok

A Számlázz.hu rendszerében kétféle online adatkapcsolati regisztráció lehetséges:

• A publikus kapcsolat minden ügyfelünk számára elérhető; jellemzően könyvelőprogramok kerülnek fel a jelenleg publikusan elérhető partnereink közé. Ha publikus kapcsolaton keresztül szeretnéd integrálni a rendszeredet a Számlázz.hu-val, akkor a kapcsolat létrehozásához előzetes jóváhagyásra, alapos tesztelésre és marketing együttműködésre van szükség.

• A rejtett kapcsolat létrehozása általában egyszerűbb; ha csak a saját ERP/CRM rendszeredet szeretnéd összekötni a saját számlázási fiókoddal, kérjük, jelezd ezt a regisztráció során. A rejtett kapcsolat nem jelenik meg a listában, és kizárólag az általad megadott fiók(ok)ban használható.

URL beállítási útmutató

Hogyan működik az adatküldés?

A Számlázz.hu egyetlen URL-en keresztül küldi el az összes partner adatait a fogadó rendszernek. Ez azt jelenti, hogy:

• Egy URL-en fogadhatod az összes ügyfél adatait - nincs szükség külön URL-ekre minden céghez
• A kulcs segít megkülönböztetni - minden adatcsomag tartalmazza az ügyfél azonosító kulcsát
• A szétosztás a te rendszeredben történik - te döntöd el, hogyan kezeled a különböző ügyfelek adatait

Mit kell beállítanod?

• Add meg azt az URL-t, ahol fogadni tudod az összes partner adatait
• Ha szeretnéd, a kulcsot hozzáfűzhetjük az URL végéhez (addkeytourl beállítás)
• A domain nem változhat, csak az URL végére kerülhet a kulcs

Példa:

• Alap URL: https://sajatrendszer.hu/fogadas/
• Kulcs hozzáfűzésével: https://sajatrendszer.hu/fogadas/ugyfelkulcs123