TecCom integráció: lépésről lépésre

A TecCom a TecAlliance B2B kereskedelmi platformja. Egyetlen integráción keresztül elérsz 280+ beszállítót az európai utángyártott piacon: készlet-lekérdezés, árlekérdezés, elektronikus rendelés, visszaigazolások, szállításkövetés.

A klasszikus alternatíva a közvetlen integráció minden raktárral API-n, CSV-n vagy e-mailen. 2-3 beszállítónál még működik. 5 felett fenntarthatatlanná válik: minden raktárnak saját formátuma, saját frissítési ütemterve, saját SLA-ja. A TecCom ezt mind egy folyamra normalizálja.

A TecCom-ot licenc nélkül nem használhatod. A licencet évente írják alá, és az ára a lekérdezési volumen, az aktivált beszállítók száma és a terjesztési modell függvénye.

Az EU-ban a TecAlliance-partnerek segítenek a licenc beszerzésében, és beállítják a TecCom-sandbox elérését a fejlesztéshez. Ez a lépés 2-4 hetet vesz igénybe. Tervezz előre.

Szükséges még minden beszállító engedélye is a TecCom-os kommunikációra. Egyes kapcsolatok alapból aktívak (a TecCom listázza a beszállítót), mások külön aktiválást igényelnek a beszállítóval.

A TecCom API-kulcsot és beszállítónkénti session-tokent használ. A platformod biztonságos tárolóban tartja a credential-öket (nem sima .env-ben), és frissíti a session-öket lejáratkor.

Minden aktivált beszállítóhoz konfigurálod a TecCom partner-ID-t, az endpoint-címet és a routing-szabályokat (melyik SKU melyik beszállítóhoz megy). A TecDoc-katalógusban minden alkatrésznek van egy "mapping"-je egy vagy több elérhető beszállítóhoz.

Amikor egy vevő egy termékoldalra érkezik, a platform TecCom-call-t indít készletre és árra. A válasz szinte azonnali (normál körülmények között 500 ms alatt) és tartalmazza: raktáranként a készletet, beszállítónként a nettó árat, a becsült szállítási időt.

Fontos részlet: ne kérdezd le a TecCom-ot minden termékoldalon valós időben. Használj agresszív cache-elést (30-60 másodperc SKU-nként) és háttér-frissítést. Különben napi több ezer call-t fizetsz, és rontod a webáruház válaszidejét.

Ajánlott minta: „cache-first háttér-frissítéssel”, ami annyit tesz: azonnal mutasd a cache-ből, lőjj ki egy háttér-call-t frissítésre, és invalidáld a cache-t rendeléskor.

A rendelés TecCom-on keresztül TXML5 formátumban megy (szabványosított XML). A platformod összeállítja az üzenetet (tételek, mennyiségek, szállítási preferenciák), aláírja és elküldi. A TecCom visszaad egy rendelés-ID-t, a beszállítói visszaigazolást és egy szállítási becslést.

A hibakezelés kritikus. A beszállító elutasíthatja a rendelést (elégtelen készlet, blokkolt fiók, érvénytelen SKU). A platformnak ezeket láthatóan, nem csendben kell felszínre hoznia az operatív csapatnak.

Rendelésátadás után a TecCom webhook-okat biztosít állapotfrissítésekhez (visszaigazolt, előkészítés alatt, kiszállítva, leszállítva, késik). A webhook-okat queue worker-en dolgozod fel, nem szinkron.

A TecCom rendelkezésre állása jó, de incidensek előfordulnak (auth-problémák, timeout-ok, beszállítók időszakos kiesése). A platformnak gyorsan tudnia kell, ha valami nem működik.

Állíts be riasztást: TecCom call hibaarány 5% felett 10 perces ablakban, átlagos válaszidő 2 másodperc felett, feldolgozatlan webhook-ok a sorban 100 felett.

Strukturált logolás minden call-hoz (request/response, latency, eredmény) órákat spórol a debuggoláson, amikor egy beszállító hiányzó rendelésre panaszkodik.

Tesztelj TecCom-sandboxon, valós adatokkal (a beszállítók beállíthatnak tesztendpointot). Adj le 5-10 tesztrendelést, figyeld a webhookokat, futtass hibaforgatókönyvet (beszállítói elutasítás, timeout).

Az éles bevezetés fokozatos: elsőként aktiválj egy beszállítót, monitorozz 48 órán át, majd tegyél mellé 2-3-at, és így tovább. Ne indulj 60 beszállítóval egyszerre.

Dokumentáld az onboarding-folyamatot minden új beszállítóra. Pár hónap múlva strukturált listád lesz: TecCom credential-ök, beszállítói kontaktok, megállapított SLA, SKU-mapping-ek. Dokumentáció nélkül egy új beszállító hozzáadása egy napba telik, nem egy órába.

A beszállítói lista kódban hardcode-olva. Új beszállító hozzáadásához deploy kell. Helyesen: konfigurációs tábla az adatbázisban, admin-felület aktiválásra/deaktiválásra.

Az árrés számolásának hiánya lekérdezés közben. A beszállító nettó árát mutatod a felárral növelt végár helyett. A vevők rendelnek, számlázáskor jön ki a különbség, veszteséges vagy.

A cache-elés figyelmen kívül hagyása. A webáruház napi 5000 call-t futtat 500 helyett. A költség nő, a válaszidő romlik.

Nincs tartalékterv arra, ha a TecCom elérhetetlen. A webáruház „hibát” mutat az „utoljára ismert készlet és ár, frissítés folyamatban” helyett. A felhasználói élmény feleslegesen sérül.