Előtagkezelés

Megbízotti számlakibocsátásnál minden számlatömb (előtag) vagy a megbízóhoz, vagy egy konkrét megbízotthoz tartozik. Ez az oldal összefoglalja:

• miért fontos az előtag a megbízotti számlázásban,
• honnan származnak a megbízotti előtagok,
• mi történik a Számla Agenten küldött előtaggal - döntési fa és szöveges magyarázat,
• miben mások a nyugta-előtagok,
• és melyek a tipikus előtag-hibák.

Miért fontos az előtag a megbízotti számlázásban?

• Az előtagok választják el a megbízó saját számláit a megbízott számláitól; a sztornó, helyesbítés és ismétlés jogai ezt a szétválasztást követik (lásd: Számlaműveletek korlátozásai).
• A megbízott csak a saját cégéhez kötött számlatömböket látja és használhatja; a megbízó többi számlatömbje nem érhető el számára.
• Az előtag legfeljebb 5 karakter. Saját előtagot csak a Számla Agenten keresztül tudsz megadni: az API-s csatlakozási kérelemben vagy a számla XML-ben - a felületen nem. Ha megadod, az lesz érvényes; MB kezdetű előtagot a rendszer csak akkor generál, ha nem adtál meg sajátot.
• A már használatba vett előtag (amellyel készült bizonylat) utólag nem módosítható: ha a megbízó fiókjában az előtagok szerkesztésére jogosult felhasználó (jellemzően a fiókgazda) a Beállítások > Előtagok oldalon átnevezné, mentéskor a 360-as hibaüzenetet kapja.

Honnan származnak a megbízotti előtagok?

Forrás	Mikor
<cegszamlaszamelotag> az action-agent_ceg_mb hívásban	Megbízói fiók létrehozása vagy csatlakozási kérelem API-n: az előtag a kérelemmel együtt tárolódik, a számlatömb pedig akkor jön létre, amikor a megbízó fiókgazdája a vezérlőpultján elfogadja a csatlakozási kérelmet. A felületről küldött kérelemben előtag nem adható meg.
Automatikus generálás a kérelem elfogadásakor	Ha a csatlakozási kérelemben nem szerepelt előtag, és a megbízottnak ennél a megbízónál még nincs számlatömbje, a rendszer a kérelem elfogadásakor generál egyet (MB + betűk). Ez a gyakorlatban a felületről indított kérelmet jelenti, ott ugyanis előtag nem adható meg; az API-s kérelemben a <cegszamlaszamelotag> kötelező (nélküle a hívás 7-es hibával áll le).
Számla XML-ben küldött új előtag	Automatikusan regisztrálódik és a megbízotthoz kötődik (lásd a döntési fát).
Nyugta XML-ben küldött új előtag	Automatikusan regisztrálódik új nyugtatömbként a megbízó fiókjában (lásd: Nyugta-előtagok).
Felületi belépéskor generált nyugta-előtag	Amikor a dedikált (megbízotti) felhasználó először belép a megbízó fiókjába, és még nincs nyugtatömbje, a rendszer automatikusan generál egy MB kezdetű nyugta-előtagot.

Döntési fa: mi történik a küldött előtaggal

Az alábbi logika minden megbízotti Agent számlahívásnál (xmlszamla) lefut:

A tiltott tömbre vonatkozó szabály alól kivétel a sztornó, a helyesbítés, valamint a díjbekérőből vagy előlegszámlából készülő számla: ezek a tiltott számlatömbbe is elkészülhetnek.

A döntési fa lépései szövegesen:

• Az egyeztetett megbízotti előtagot küldöd: a számla abba a tömbbe készül.
• Nem küldesz előtagot: ha pontosan egy megbízotti számlatömböd van ennél a megbízónál, a rendszer automatikusan ezt az egyetlen saját előtagodat használja; ha nincs, vagy egynél több van, a hívás 357-es hibával áll le, és meg kell adnod az előtagot.
• Vadonatúj előtagot küldesz: automatikusan új számlatömb regisztrálódik, a cégedhez kötve. Új előtag bevezetése előtt érdemes egyeztetned a megbízóval.
• Másik megbízotthoz tartozó vagy nyugta típusú előtagot küldesz: a hívás 354-es hibával áll le.
• Tiltott (nem engedélyezett) előtagot küldesz: a hívás a számlatömb-ellenőrzésen 202-es hibával áll le, akkor is, ha a tömb egyébként a tiédhez van kötve.
• Létező, egyik megbízotthoz sem kötött megbízói előtagot küldesz: ha már van saját megbízotti tömböd, a válasz megmondja, hogy azt használd (356-os hiba, a helyes előtaggal az üzenetben). Ha nincs, és az előtag még használatlan, a cégedhez rendelődik, és a számla elkészül; ha már készült vele számla, a hívás 354-es hibával áll le.

Nyugta-előtagok

Nyugtánál az <elotag> mező kötelező; nincs automatikus kiválasztás. A nyugta-előtagok elkülönülnek a számla-előtagoktól: számlák által már használt előtag nem lehet nyugta-előtag (336-os hiba). Részletek: Nyugtakiállítás megbízottként.

Előtag-hibák áttekintése

Az alábbi táblázat az előtagokhoz kapcsolódó összes hibakódot összefoglalja, kód szerint növekvő sorrendben:

Kód	Üzenet	Tipikus ok és teendő
68	Már létezik cég ezzel az adószámmal és számlaszám előtaggal.	Az action-agent_ceg_mb kérésben megadott előtagot ez az adószám már használja; egyeztess másik előtagot a megbízóval.
200	Ezt az előtagot ugyanezzel az adószámmal jelenleg is használja egy számlázási fiók számla/nyugta előtagként. Kérjük, válassz másik előtagot!	Az előtagot ugyanez az adószám egy másik aktív fiókban jelenleg is használja (előfordulhat új számlatömb létrehozásakor, a csatlakozási kérelem elfogadásakor és új előtag regisztrálásakor); válassz másik előtagot.
202	Ez a számlaszám előtag nem létezik vagy nincs engedélyezve: (előtag).	A küldött előtag számlatömbje tiltott (nem engedélyezett) vagy NAV számlaszám-ütközés miatt blokkolt; a tiltott tömböt a megbízó fiókjában a Beállítások > Előtagok oldalon lehet engedélyezni, a blokkolt tömb helyett másik előtag kell.
336	Ezt az előtagot a számlázás már használja, így nem lehet nyugta előtag ((előtag)).	Nyugtához olyan előtagot küldtél, amellyel már készült számla; válassz külön nyugta-előtagot.
337	Az előtag csak nagybetűket és számokat tartalmazhat, és hossza legfeljebb 5 karakter lehet.	Az action-agent_ceg_mb kérésben küldött <cegszamlaszamelotag> formátuma nem megfelelő; javítsd a kérésben.
353	Nincs egyetlen érvényes számlaszám előtag sem.	A fiókban egyetlen engedélyezett számlatömb sincs; hozz létre vagy engedélyezz egyet.
354	Ez a számlaszám előtag nem használható.	A küldött előtag másik megbízotté, nyugta típusú, vagy már készültek vele számlák, így nem vehető át; az egyeztetett megbízotti előtagot küldd.
356	A megadott számlaszám előtag helyett használd ezt: (előtag).	Már van saját megbízotti számlatömböd ennél a megbízónál; az üzenetben visszaadott előtagot kell használni.
357	Kérjük, add meg a számlaszám-előtagot.	Nem küldtél előtagot, és az automatikusan sem választható ki, mert nincs, vagy egynél több megbízotti számlatömböd van; küldd az egyeztetett előtagot a <szamlaszamElotag> mezőben.
360	Ez az előtag nem módosítható, mert már használták számlakiállításhoz.	Olyan előtagot próbáltál szerkeszteni a felületen, amellyel már készült bizonylat; a már használt előtag nem módosítható, helyette új számlatömb hozható létre.
362	Ezt az előtagot ez az adószám korábban már használta. Kérjük, válassz másik előtagot.	Az előtagot ez az adószám korábban már használta egy azóta letiltott (már nem aktív) fiókban; válassz másik előtagot.
524	Ez a nyugtaszám előtag nincs engedélyezve: (előtag).	A nyugtatömböt a megbízó letiltotta; a Beállítások > Előtagok oldalon engedélyezhető újra.

Pontos üzenetek és teendők: Hibakezelés.

Gyakorlati tanácsok

1. Az előtagot előre egyeztesd a megbízóval, és kezeld a szerződés részeként.
2. Olyan előtagot használj, ami azonosítja a megbízotti kapcsolatot (pl. a megbízó rövid neve), legfeljebb 5 karakteren.
3. Az előtagot minden számla XML-ben küldd el explicit módon, akkor is, ha az automatikus kiválasztás működne. Az automatikus kiválasztás ugyanis csak addig működik, amíg pontosan egy megbízotti számlatömböd van: ha később egy második tömb is létrejön, az előtag nélküli hívások 357-es hibával leállnak.
4. A megbízó saját előtagjait nem tudod használni: a már használt megbízói előtagot a rendszer hibával elutasítja, a még használatlant pedig a cégedhez rendelné át (lásd a döntési fát) - ezért mindig az egyeztetett megbízotti előtagot küldd.