Blog

Bevezetés

Egy Unas API integráció során könnyű hibázni, sőt bármilyen integráció során, ha figyelmen kívül hagyunk apró részleteket. Én is megtapasztaltam ezt, amikor a termékek plusz státuszainak beállításánál belefutottam egy problémába. A dokumentáció elsőre egyértelműnek tűnt, sőt, már egy futó integrációról volt szó. De kiderült, hogy egy termékhez maximum három plusz státusz adható meg. Az Unas ügyfélszolgálat segítsége nélkül talán még mindig keresném a megoldást...

A probléma felmerülése

Az ügyfelem webshopjában és szinkronjába már be volt állítva három plusz termék státusz. Ezekkel nem is volt probléma, egészen addig, amíg nem érkezett egy kérés: szeretne hozzáadni egy negyediket. Természetesen szóltam, hogy megnézem hogyan oldható meg, hiszen nem tűnt olyan nagy dolognak, és azt feltételeztem, hogy bármennyi státusz beállítható.

Bár rémlett valami korlátozás, hogy a maximális szám három lehet és ellenőriztem is az admin felületen. Egy termékhez beállítottam az összes státuszt, aztán mentettem – és minden státusz megmaradt. Úgy gondoltam, minden rendben lesz. Csak közben kiment a fejemből, hogy ezek plusz státuszok, és nem alap státuszok, ami zavart okozott az API kezelésében.

Gyorsan hozzáadtam egy negyedik státuszt, amit az API-n keresztül küldtem el. Azonban hamar észrevettem, hogy valami nem stimmel: az árak és a raktárinformációk sem módosultak, hiába küldtem el többször is a helyes adatokat. Az API semmilyen hibajelzést nem adott vissza, ami még inkább megnehezítette a probléma felderítését. Ekkor kezdtem gyanítani, hogy valami lényeges részletet átsiklottam.

Az ügyfélszolgálat szerepe

Az ügyfélszolgálat minden elvárást felülmúlt. Amint rájöttem, hogy valami nem stimmel a státuszokkal, írtam nekik, Az Unas ügyfélszolgálat gyors és segítőkész volt. Pár órán belül válaszoltak, és türelmesen elmagyarázták, hogy maximum három plusz státusz adható meg egy termékhez. Jelezték is, hogy szépen le van írva a dokumentációban.

Őszintén szólva, mire visszaírtak, már én is megtaláltam a dokumentációban a korlátozást, de az ügyfélszolgálat gyorsasága és segítőkészsége így is nagyon pozitív tapasztalat volt.

A megoldás

Az ügyfélszolgálat válasza világossá tette a problémát: az API túl sok státusz miatt nem tudta feldolgozni a kérést, ezért sem az árak, sem a raktárinformációk nem frissültek. Miután kijavítottam a hibát, és eltávolítottam a negyedik státuszt, minden újra működött.

Az ügyfélszolgálat bevezette a hibajelzést is a rendszerbe, hogy a jövőben más felhasználók is értesüljenek, ha túllépik a státuszok számát. Ráadásul az ügyfél által kért negyedik státuszt is sikerült megoldani egy kis módosítással a forráskódban.

Tanulság

Ez az eset jól rávilágít arra, hogy mennyire fontos figyelmesen átolvasni a dokumentációt, különösen, ha API integrációról van szó. Az apró részletek figyelmen kívül hagyása komoly problémákhoz vezethet, ahogyan most is a státuszok esetében történt. Ugyanakkor a gyors és hatékony ügyfélszolgálat kulcsfontosságú szerepet játszik egy ilyen helyzet megoldásában.

Legközelebb biztosan jobban figyelek a dokumentáció minden apró részletére!