Partner-, cím- és bankszámla-adatok az API-n
Mit tud egy külső program a partnerekkel, a címtörzzsel és a bankszámlákkal: keresés, lista, lekérdezés, felvétel duplikáció-szűréssel és törlés.
Az API-n keresztül egy külső program kereshet és listázhat partnereket, lekérdezheti egy partner minden adatát, felvehet új partnert, és kezelheti a címtörzset, a bankszámla-törzset, valamint a partnerekhez kötött bankszámlákat. Mindig csak azokat a cégeket látja, amelyekhez a kulcs tulajdonosának tartalmi joga van.
Tipikus folyamat: új vevő felvétele
- Keresse meg adószám alapján, hogy a partner létezik-e már (partner-keresés). Legalább egy keresési feltételt meg kell adni.
- Ha nincs találat, vegye fel a partnert a nevével, adószámával és szükség esetén cégcsoportjával és bankszámlaszámával.
- Ha a válasz azt jelzi, hogy az adószám első 8 jegye már létezik, ne vegye fel újra: a válasz megadja a meglévő partner azonosítóját.
- Ha a bankszámlaszám nem volt érvényes, a partner ettől még létrejön, a válasz pedig figyelmeztetést tartalmaz; javítsa a számot, és adja hozzá külön a partner bankszámláihoz.
- Kérdezze le a partner teljes adatlapját: alapadatok, adózói státusz, címek a KSH-település hivatkozással és bankszámlák.
Szabályok
| Terület | Mire figyeljen |
|---|---|
| Partnerlista | egyszerre legfeljebb 100 sor; adószám-előtag, névrész és státusz szerint szűrhető, rendezhető |
| Partner törlése | csak hivatkozás nélküli partner törölhető; ilyenkor a cím- és bankszámla-kapcsolatai is törlődnek, a közös törzsadatok megmaradnak |
| Címtörzs | irányítószám és település kötelező; azonos címnél a meglévőt kapja vissza; cégekhez kötött cím nem törölhető |
| Bankszámla-törzs | a számot a rendszer egységes 24 jegyű formára hozza; érvénytelen szám nem menthető; azonos számnál a meglévőt kapja vissza; cégekhez kötött szám nem törölhető |
| Partner bankszámlái | a partner adószámmal is megadható; a törlés csak a kapcsolatot szünteti meg, a bankszámla a törzsben marad |
Új partner csak olyan cégcsoportba vehető fel, amelyhez a kulcs tulajdonosának joga van.
Példa
A Minta Kft. webshopja a Példa Zrt. adószámával keres, nincs találat, ezért felveszi a partnert a bankszámlaszámával. A rendszer a számot egységes formára hozza, a bankszámlát a törzsbe teszi és a partnerhez köti; a válasz megadja az új partner és bankszámla azonosítóját.