Integrare TecCom: ghid pas cu pas

TecCom este platforma B2B de comerț a TecAlliance. Printr-o singură integrare, accesezi 280+ furnizori din aftermarket-ul european: interogări de disponibilitate, verificare de preț, comenzi electronice, confirmări, tracking de livrare.

Alternativa clasică este integrarea directă cu fiecare depozit prin API, CSV sau email. Funcționează pentru 2-3 furnizori. De la 5 furnizori în sus, devine nesustenabil: fiecare depozit are propriul format, propriul calendar de actualizări, propriul SLA. TecCom normalizează toate astea într-un singur flux.

Nu poți folosi TecCom fără licență de la TecAlliance. Licența se semnează anual și costul depinde de volumul de cereri, numărul de furnizori activați și modelul de distribuție.

În România, există parteneri TecAlliance care pot intermedia licențierea și pot configura accesul la sandbox-ul TecCom pentru dezvoltare. Acest pas durează 2-4 săptămâni. Planifică din timp.

Ai nevoie și de acordul fiecărui furnizor de a comunica prin TecCom. Unele relații sunt active din oficiu (TecCom listează furnizorul), altele necesită activare separată cu furnizorul.

TecCom folosește autentificare pe bază de API key și session token per furnizor. Platforma ta păstrează credențialele într-un seif securizat (nu în .env plain), și reîmprospătează session-urile la expirare.

Pentru fiecare furnizor activat, configurezi ID-ul TecCom al partenerului, adresa endpoint-ului și regulile de routing (ce SKU-uri merg la care furnizor). În catalogul TecDoc, fiecare piesă are un "mapping" către unul sau mai mulți furnizori disponibili.

Când un client intră pe pagina unei piese, platforma face un call TecCom pentru disponibilitate și preț. Răspunsul e aproape instant (sub 500ms în condiții normale) și vine cu: stoc per depozit, preț net per furnizor, termen de livrare estimat.

Un detaliu important: nu interoga TecCom pe fiecare pagină de produs în timp real. Folosește caching agresiv (30-60 secunde per SKU) și reactualizări pe background. Altfel ajungi să plătești mii de call-uri pe zi și să degradezi latency-ul magazinului.

Recomand pattern-ul „interogare cache-first cu background refresh”: afișează imediat din cache, trimite call în background pentru refresh, invalidează cache-ul când comanda se plasează.

Plasarea comenzii se face prin TecCom în format TXML5 (XML standardizat). Platforma ta compune mesajul (item-uri, cantități, preferințe de livrare), îl semnează și îl trimite. TecCom returnează un ID de comandă, confirmarea primită de la furnizor și estimarea de livrare.

Tratarea erorilor e critică. Furnizorul poate respinge comanda (stoc insuficient, cont blocat, SKU invalid). Platforma trebuie să gestioneze aceste cazuri vizibil pentru echipa de operațiuni, nu silențios.

După plasare, TecCom oferă webhook-uri pentru actualizări de stare (confirmat, în pregătire, expediat, livrat, cu întârziere). Procesezi webhook-urile pe un queue worker, nu sincron.

TecCom are uptime bun, dar incidente se întâmplă (probleme de autentificare, timeout-uri, furnizori indisponibili temporar). Platforma ta trebuie să știe repede când ceva nu funcționează.

Setează alertări pe: rata de eroare a call-urilor TecCom peste 5% într-o fereastră de 10 minute, timp mediu de răspuns peste 2 secunde, webhook-uri neprocesate în coadă peste 100.

Logging structurat pentru fiecare call (request/response, latency, result) îți salvează ore de debugging când un furnizor se plânge de o comandă lipsă.

Testează pe sandbox TecCom cu date reale (furnizorii pot configura un endpoint de test). Plasează 5-10 comenzi de test, monitorizează webhook-urile, rulează un scenariu de eroare (respingere de furnizor, timeout).

Rollout-ul în producție se face gradual: activezi un furnizor la început, monitorizezi 48 de ore, apoi mai adaugi 2-3, și așa mai departe. Nu lansa cu 60 de furnizori simultan.

Documentează procedura de onboarding pentru fiecare furnizor nou. În câteva luni, vei avea o listă structurată: credențiale TecCom, contacte la furnizor, SLA agreat, mapping de SKU-uri. Fără documentație, adăugarea fiecărui nou furnizor ia o zi în loc de o oră.

Hardcodarea listei de furnizori în cod. Adăugarea unui furnizor nou necesită un deploy. Corect: tabelă de configurare în DB, UI de admin pentru activare/dezactivare.

Necalcularea marjei pe preț în timpul interogării. Afișezi prețul net de la furnizor în loc de prețul final cu markup. Clienții comandă, descoperi diferența când faci factura, ești pe minus.

Ignorarea caching-ului. Magazinul face 5000 de call-uri pe zi când ar trebui să facă 500. Costurile cresc, iar timpul de răspuns crește și el.

Lipsa unui plan de fallback când TecCom e indisponibil. Magazinul afișează „eroare” în loc de „ultimul stoc și preț cunoscute, actualizare în curs”. Experiența utilizatorului suferă inutil.