Storno és hibakezelés

A számla generálása után előfordulhat módosítás-igény, vagy a kapcsolat hibára fut.

Storno (számla-érvénytelenítés)

Mikor kell

• Vendég-vita (összeg-eltérés)
• Hibás vendég-adat (rossz cégnév)
• Eladás-lemondás post-számla

Hogyan

1. Bookinda → Eladások → eladás-sor → Számla tab
2. Storno gomb
3. Megerősítés
4. Billingo-ban a számla érvénytelenné válik (de nem törlődik)
5. Bookinda-eladás-rekordról a Billingo-document-id törlődik

Mit jelent a "cancel"

A számla státusza "Érvénytelen". Billingo-ban láthatod (audit-trail), de számolhatatlan a könyvelésben.

Új számla generálása storno után

Ha a stornozott eladás új számlát igényel:

1. Az eladás-rekord visszaáll "no invoice"-be
2. Auto-invoice ON: új számla auto-generálódik
3. Auto-invoice OFF: manuálisan generálsz

Gyakori hibák

"Auth failed" / "401 Unauthorized"

• API-key érvénytelen vagy revoked
• Megoldás: új API-key + Disconnect / Reconnect

"Document block not found"

• A választott blokk törölve a Billingo-ban
• Megoldás: Connect → Edit → új blokk-választás

"Invalid customer data"

• Vendég-cégadat hiányos (cégnév van, adószám nincs)
• Megoldás: vendég-profilon kiegészítés

"Currency / VAT mismatch"

• Konfig-eltérés (pl. EUR-ban próbálsz, de HUF-os tenant)
• Megoldás: Connect → Edit → currency

"Network error" / "Timeout"

• Billingo API ideiglenesen nem elérhető
• Megoldás: várj 5 percet, automatikus retry

"NAV Online error"

• NAV-szerver elérhetetlen vagy számla XML hibás
• Megoldás: Billingo-felületen "Resend to NAV"

Audit-trail

Minden számla-művelet log-olódik:

• Bookinda-oldalon: Eladás → Számla tab → "History"
• Billingo-oldalon: Számla → "Activity log"

Re-connect

Ha az API-key érvényét vesztette:

1. Billingo: új API-key generálás
2. Bookinda: Connect → Disconnect
3. Bookinda: Connect → új API-key beillesztés
4. Test → Save

Best-practice ellenőrzés

Hetente

• Connect → Billingo státusz ACTIVE-e?
• Új PAID eladásokra mind van számla?

Havonta

• Billingo-ban audit: Bookinda-számlák match-elnek-e?
• Storno-számok normálisak (1-2% normál, 5%+ probléma)?

Negyedévente

• API-key rotation (security best-practice)

Mikor használd

Szcenárió 1, vendég-vita Vendég panaszkodik: "Más összeg". Storno → új számla javított adattal.

Szcenárió 2, vendég-cégadat utólag Vendég utólag mondja: "Cégadattal". Storno → vendég-profilon cégadat → új számla.

Szcenárió 3, refund post-számla Vendég megbánja, refund. Storno + refund-tranzakció.

Szcenárió 4, API-key elveszett Te véletlenül publikussá tetted. Új generálás + reconnect.

Tippek

• A storno végleges, ne csináld feleslegesen.
• Vendég-cégadat utólagos hozzáadása új számlát igényel.
• API-key rotation 6-12 havonta security szempontjából.
• Connect-státusz hetente check-elendő, ne hagyj ERROR-t.

Kapcsolódó cikkek

• Billingo áttekintés
• Setup
• Auto-invoice