Nyugtakiállítás megbízottként
A megbízotti kiállítás a nyugtákra is kiterjed, ugyanazzal a kapcsolatmodellel, mint a számláknál. Itt is igaz, hogy a megbízotti nyugtázás alig tér el a megszokottól:
- A felületen nyugtázol? A dedikált felhasználóval való belépés után ugyanúgy állíthatod ki a nyugtát, mint a saját fiókodban; részletek a Nyugtakiállítás a felületen szakaszban.
- Agenttel nyugtázol? A standard nyugta XML-t küldd be a csatlakozáskor megadott dedikált (
usrMb) felhasználó bejelentkezési adataival (felhasználónév + jelszó); egyedül a kötelező nyugtaszám előtagra kell figyelned; részletek a Nyugtakiállítás Számla Agenttel szakaszban.
Előfeltételek
- A megbízotti kapcsolat jóváhagyott; lásd: Kapcsolat kialakítása a felületen vagy Kapcsolat kialakítása API-val.
- Agentes kiállításnál a megbízott fiókja olyan szolgáltatáscsomagban van, amely tartalmazza az Agentes nyugtakibocsátást - ez az ingyenes csomag kivételével minden csomagban benne van -, és a dedikált felhasználó szerepköre is engedi a nyugtakibocsátást; enélkül a hívás 8-as hibával áll le.
- A megbízóval egyeztetett nyugtaszám előtag rendelkezésre áll; lásd: Nyugtaszám előtag.
Ha ezek teljesülnek, kezdhetsz.
Élesítés előtt a nyugtakiállítás is kockázat nélkül kipróbálható tesztfiókokkal; lásd: A folyamat tesztelése.
Mi változik a hagyományos nyugtákhoz képest?
A rövid válasz: szinte semmi. A megbízotti kontextus itt is a bejelentkezésből jön: a dedikált felhasználó megbízottként tartozik a megbízó fiókjához - minden más a megszokott módon működik.
- A nyugta a megbízó nevében készül, és a megbízó fiókjában tárolódik; a megbízó ugyanúgy látja, mint bármely saját nyugtáját.
- A kiállítás költségeit a megbízott viseli, és az elérhető funkciók (például az Agentes nyugtakibocsátás) is a megbízott díjcsomagját követik.
Nyugtakiállítás a felületen
A felületi nyugtázás nem tér el a hagyományos nyugtakiállítástól: a dedikált felhasználóval belépve ugyanúgy állítod ki a nyugtát a megbízó fiókjában, mint a sajátodban. Nyugtatömbről sem kell külön gondoskodnod: amikor a 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 egyet MB kezdetű előtaggal. Ez a csatlakozáskor megadott előtagtól független - az csak számlatömböt hoz létre, nyugtatömböt nem.
Egy dologra figyelj: ha a dedikált felhasználó több fiókhoz is hozzáfér (például a megbízott saját fiókjához is), belépés után a cégválasztóban ellenőrizd, hogy a megbízó fiókja van-e kiválasztva - a nyugta mindig az éppen kiválasztott fiókban készül el.
Nyugtakiállítás Számla Agenttel
Az XML-ben semmi nem változik. A megbízotti nyugta a standard nyugta XML-lel (xmlnyugtacreate, action-szamla_agent_nyugta_create) készül, a csatlakozáskor megadott dedikált (usrMb) felhasználó bejelentkezési adataival (felhasználónév + jelszó); nincs külön "megbízotti" mező. A lekérdezés (nyugta_get), a küldés (nyugta_send) és a sztornó (nyugta_storno) is a standard hívásokkal megy. Lásd: Nyugta XML. A Számla Agent kulcs megbízotti hívásokhoz itt sem használható: a kulcs a fiókhoz tartozik, nem hordozza a megbízotti kapcsolatot; lásd: Számlakiállítás megbízottként.
Egyetlen dolog igényel figyelmet: a megfelelő, a megbízotti kapcsolat kialakítása során létrejött nyugtaszám előtag használata.
Nyugtaszám előtag
A számlákkal ellentétben az <elotag> mező minden nyugtánál kötelező; előtag nélkül nem készül nyugta (7-es hiba, hiányzó adat).
- Egyeztesd a megbízóval, melyik nyugta-előtagot használja a megbízotti kiállítás, és azt küldd az
<elotag>mezőben. - Ha a kérésben olyan előtagot adsz meg, amely még nem létezik a megbízó fiókjában, a rendszer automatikusan létrehoz egy új nyugtatömböt ezzel az előtaggal („Agent-en keresztül regisztrált Nyugta előtag" megnevezéssel), és a nyugta ebbe készül el. Új előtag bevezetése előtt egyeztess a megbízóval.
- Ha a küldött előtagot már számlák használják, a hívás 336-os hibával áll le; nyugta- és számla-előtag nem ütközhet.
- Ha a nyugta-előtag létezik, de tiltott, a hívás 524-es hibával áll le; meglévő nyugta sztornója ettől még engedélyezett. Az előtagot a megbízó a Beállítások > Előtagok oldalon tudja engedélyezni vagy tiltani: az előtagot kiválasztva az „Engedélyezem az előtag használatát" jelölővel.
Az előtagokról bővebben: Előtagkezelés - Nyugta-előtagok.
Válasz
A válasz ugyanaz, mint a standard Agent nyugtahívásoknál: a nyugtaszám a válasz XML-ben érkezik, kérésre PDF-fel. Lásd: Nyugta válasz.
Gyakori hibák
| Kód | Üzenet | Jelentés és teendő |
|---|---|---|
| 3 | Sikertelen bejelentkezés. | Hibás bejelentkezési adatok. Ellenőrizd, hogy a dedikált felhasználó adataival hívsz-e. |
| 7 | Hiányzó adat: (mező). | Kötelező adat hiányzik a kérésből, nyugtánál tipikusan az <elotag>. |
| 8 | Nincs jogosultságod vagy megfelelő díjcsomagod a művelet elvégzéséhez (…)! | A megbízott fiók csomagja nem tartalmazza az Agentes nyugtakibocsátást, vagy a dedikált felhasználó szerepköréhez nincs hozzárendelve a nyugtakibocsátási jog. |
| 164 | Ez a felhasználó (név) több számlázási fiókhoz is hozzáfér, így a funkció nem üzemképes. | Az Agent híváshoz pontosan egy fiókhoz hozzáférő felhasználó kell; használd a dedikált (usrMb) felhasználót. |
| 336 | Ezt az előtagot a számlázás már használja, így nem lehet nyugta előtag (előtag). | A küldött előtagot már számlák használják; válassz másik nyugta-előtagot. |
| 524 | Ez a nyugtaszám előtag nincs engedélyezve: (előtag). | A nyugta-előtagot a megbízó fiókjában letiltották. Engedélyezni a Beállítások > Előtagok oldalon lehet: az előtagot kiválasztva az „Engedélyezem az előtag használatát" jelölőt kell bepipálni. Kérd meg erre a megbízót, vagy használj másik előtagot; meglévő nyugta sztornóját a tiltás nem akadályozza. |
Teljes lista teendőkkel: Hibakezelés.
Korlátozások és láthatóság
- A nyugták láthatósága a számlákkal azonos szabályt követi: a megbízó minden nyugtát lát, a megbízott csak a dedikált felhasználóval kiállítottakat.
- A megbízotti nyugta-előtagot tartsd külön a megbízó saját nyugta-előtagjaitól, hogy minden nyugta eredete egyértelmű maradjon.