Integrările cu marketplace-uri, ERP-uri, curieri și procesatori de plăți cer răspunsuri clare înainte de instalarea unui modul: unde se actualizează stocul, ce sistem emite factura și ce eveniment confirmă plata? Dacă aceste reguli lipsesc, un conector care exportă produse poate crea totuși diferențe între prețuri, comenzi, documente și livrări.
Un flux bine proiectat nu înseamnă că toate aplicațiile fac aceleași lucruri. Înseamnă că fiecare sistem primește doar datele necesare, iar pentru fiecare tip de informație există o sursă principală și o modalitate de verificare a erorilor.
Integrarea de marketplace conectează catalogul, ofertele și comenzile cu un canal extern. ERP-ul sau aplicația de facturare lucrează cu nomenclatoare, documente și evidențe interne, curierul gestionează expedierea, iar procesatorul confirmă tranzacția financiară. Tratarea lor ca un singur „modul de automatizare” ascunde diferențele dintre date și responsabilități.
În CS-Cart, comanda proprie poate porni din checkout, în timp ce o comandă externă intră din marketplace. Într-un proiect cu mai multe canale, merită să pornești de la serviciile de Marketplace & Integrări Marketplace pentru a delimita conectarea canalelor de vânzare de celelalte fluxuri operaționale.
| Tip de integrare | Date urmărite frecvent | Întrebarea de control |
|---|---|---|
| Marketplace | produse, oferte, stocuri, comenzi, statusuri | Ce informații se trimit și ce informații se preiau? |
| ERP sau facturare | nomenclatoare, facturi, proforme, avize, anulări | Ce identificator previne documentele duplicate? |
| Curier | AWB, etichetă, tracking, ramburs, retur | Când se creează și când se anulează AWB-ul? |
| Procesator de plăți | identificator tranzacție, confirmare, refund | Care notificare schimbă statusul comenzii? |
Nu există o singură sursă principală pentru tot fluxul. Catalogul și stocul pot avea ca sursă ERP-ul, CS-Cart poate rămâne punctul principal pentru comenzile din magazin, iar marketplace-ul transmite comenzile din propriul canal. Procesatorul de plăți rămâne sursa pentru starea tranzacției, iar curierul pentru statusul fizic al expediției.
Notează explicit direcția pentru produs, SKU, EAN, categorie, preț, TVA, stoc, comandă, client, adresă, factură, AWB și retur. O sincronizare bidirecțională fără reguli de prioritate poate suprascrie modificări valide cu valori mai vechi venite din alt sistem.
Numele produsului este util pentru client, dar nu este un identificator sigur pentru automatizări. Păstrează maparea dintre SKU-ul intern și identificatorul acceptat de canalul extern, apoi păstrează legătura dintre comanda CS-Cart, comanda marketplace, factura, AWB-ul și tranzacția de plată.
Un conector nu trebuie evaluat doar după numele marketplace-ului afișat. Pentru eMAG sau Altex, acoperirea poate include obiecte diferite: catalog, categorii, oferte, prețuri, stocuri, comenzi, facturi, AWB-uri, retururi și notificări. Verifică exact ce operațiuni sunt disponibile și care rămân manuale.
De exemplu, exportul produsului nu confirmă automat că oferta este validată sau că toate atributele necesare sunt mapate. La fel, importul comenzii nu rezolvă singur emiterea facturii ori încărcarea documentului în marketplace. Pentru fiecare canal, stabilește regulile proprii de preț, TVA, stoc și status.
Planifică și situațiile neobișnuite: răspuns temporar indisponibil, limitare de cereri, produs respins, comandă anulată sau retur. Cozile de procesare, reluarea controlată a operațiunilor și logurile lizibile sunt mai utile decât reîncercările necontrolate care pot dubla acțiuni.
Integrarea ERP sau de facturare trebuie să știe ce moment din viața comenzii justifică emiterea unui document. Acest moment poate diferi după fluxul comercial, metodă de plată, livrare sau canal. Nu presupune că simpla creare a comenzii trebuie să producă imediat aceeași acțiune în toate sistemele.
Un conector robust salvează identificatorul comenzii externe, identificatorul documentului emis și rezultatul ultimei sincronizări. Astfel, dacă un apel trebuie reluat, sistemul poate verifica dacă factura există deja în loc să emită una nouă. Anulările, stornările și retururile au nevoie de aceeași trasabilitate.
Într-un marketplace cu mai mulți furnizori, decide dinainte cine emite documentul și cine vede comenzile, livrările și retururile. Plata clientului încasată de marketplace nu este, prin ea însăși, o regulă de distribuire automată a fondurilor către furnizori. Fluxul de facturare, comisionare și rambursare trebuie analizat separat pentru fiecare model comercial.
Alegerea unei metode de livrare în checkout este doar începutul. Integrarea cu curierul poate include generarea AWB-ului, eticheta, numărul de tracking, rambursul, punctul de ridicare, lockerul, actualizarea statusurilor și returul. Fiecare etapă trebuie corelată cu o comandă concretă și cu date de livrare validate.
Folosește Curieri & AWB atunci când vrei să clarifici fluxul de expediere, nu doar să afișezi o opțiune de livrare. În special pentru puncte de ridicare sau lockere, verifică transmiterea corectă a identificatorului punctului și tratarea modificărilor care pot apărea după plasarea comenzii.
Statusurile interne merită separate: AWB creat, colet preluat, în tranzit, livrat, refuzat sau retur inițiat nu reprezintă același eveniment. Nu actualiza manual toate comenzile cu un singur status generic fără să poți reconcilia ulterior răspunsul primit de la curier.
Redirecționarea clientului înapoi în magazin după plată este utilă pentru experiență, dar nu este singura dovadă a rezultatului tranzacției. Procesatorul trebuie să transmită confirmarea către server, iar integrarea trebuie să valideze notificarea și să asocieze corect tranzacția cu comanda.
Testează separat plata aprobată, respinsă, abandonată și notificările repetate. O notificare repetată nu trebuie să creeze operațiuni duplicate, iar o comandă modificată trebuie corelată atent cu identificatorul tranzacției inițiale. Cheile și datele de acces pentru test nu se amestecă cu cele pentru producție.
Pentru configurarea fluxurilor de încasare și checkout, pagina Plăți & Checkout este relevantă ca etapă separată de integrarea marketplace-ului. În MultiVendor, verifică explicit dacă modelul de plată susține distribuirea fondurilor de care ai nevoie; un procesator obișnuit pentru magazin nu echivalează automat cu split payment.
Verifică compatibilitatea conectorului cu versiunea CS-Cart, cu configurația MultiVendor dacă este cazul și cu celelalte add-on-uri care pot modifica produsele, comenzile sau statusurile. Repetă verificarea înainte de upgrade-uri, deoarece o modificare de platformă sau API poate afecta mapările existente.
Credentialele API, tokenurile OAuth, cheile private și certificatele nu trebuie introduse în fișiere publice sau în loguri. Păstrează separat mediile de test și producție, folosește HTTPS pentru callback-uri și limitează accesul la datele de configurare.
Pentru depanare, logul ar trebui să indice sistemul extern, operațiunea, momentul, identificatorul comenzii, codul răspunsului și mesajul de eroare, fără a expune secrete sau date sensibile. Un test complet include și erori de conectare, răspunsuri întârziate, anulări, retururi și notificări repetate, nu doar scenariul de succes.
Dacă ai mai multe canale sau un flux MultiVendor, pornește de la Marketplace & Integrări Marketplace și proiectează întâi datele și responsabilitățile. Un flux delimitat corect este mai ușor de administrat decât mai multe module care actualizează aceleași informații după reguli diferite.
Integrarea marketplace urmărește în principal conectarea catalogului, ofertelor și comenzilor cu un canal extern. Integrarea ERP sau de facturare se ocupă de nomenclatoare, documente și evidențe interne, de aceea regulile de sincronizare nu sunt aceleași.
Nu întotdeauna. Dacă preiei comenzi din marketplace, trebuie să clarifici și statusurile, facturile, AWB-urile, retururile și anulările, astfel încât informațiile să rămână corelate între sisteme.
Păstrează identificatori externi stabili pentru comandă, document și expediere, precum și starea ultimei sincronizări. La reluarea unei cereri, integrarea trebuie să verifice mai întâi dacă acțiunea a fost deja finalizată.
Clientul poate reveni în magazin fără ca plata să fie confirmată definitiv sau poate închide pagina înainte de redirect. Statusul comenzii trebuie actualizat pe baza confirmării server-to-server validate de la procesator.
Verifică compatibilitatea add-on-urilor și modul în care acestea intervin asupra produselor, comenzilor și statusurilor. Testează fluxurile esențiale într-un mediu separat înainte de a actualiza mediul de producție.
Vrei să discuți următorul pas pentru situația ta?