Verificări pentru integrări marketplace, ERP, curier și plăți

14/11/2026

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.

1. Separă rolul fiecărei integrări înainte de configurare

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 integrareDate urmărite frecventÎntrebarea de control
Marketplaceproduse, oferte, stocuri, comenzi, statusuriCe informații se trimit și ce informații se preiau?
ERP sau facturarenomenclatoare, facturi, proforme, avize, anulăriCe identificator previne documentele duplicate?
CurierAWB, etichetă, tracking, ramburs, returCând se creează și când se anulează AWB-ul?
Procesator de plățiidentificator tranzacție, confirmare, refundCare notificare schimbă statusul comenzii?

2. Stabilește sistemul master pentru fiecare tip de dată

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.

Identificatorii trebuie să rămână stabili

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ă.

  • Definește un proprietar pentru fiecare câmp sincronizat.
  • Decide ce se întâmplă când aceeași valoare este modificată în două sisteme.
  • Folosește identificatori externi stabili pentru comenzi și documente.
  • Documentează regulile de actualizare înainte de activarea sincronizării automate.

3. Verifică acoperirea reală a integrării de marketplace

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.

4. Leagă ERP-ul și facturarea de comenzi fără documente duble

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.

Particularități pentru MultiVendor

Î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.

5. Tratează AWB-ul și trackingul ca fluxuri operaționale distincte

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.

6. Confirmă plata prin notificare server-to-server, nu prin redirect

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.

7. Cere compatibilitate, securitate și loguri înainte de instalare

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.

8. Pe scurt: ce să verifici înainte de a alege

  1. Stabilește sistemul master pentru catalog, preț, stoc, comandă, document, livrare și plată.
  2. Compară funcțiile concrete ale conectorului: produse, comenzi, facturi, AWB-uri, retururi, statusuri, loguri și reluarea controlată a operațiunilor.
  3. Testează într-un mediu separat traseul complet, de la comandă până la livrare, anulare sau refund.
  4. Verifică compatibilitatea înainte de instalare și înainte de fiecare upgrade relevant.

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.

Întrebări frecvente

Care este diferența dintre integrarea marketplace și integrarea ERP în CS-Cart?

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.

Este suficient să sincronizez produsele și stocurile?

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.

Cum previn facturile sau AWB-urile duplicate?

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ă.

De ce nu este suficient redirectul după plata online?

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.

Ce verific înainte de upgrade-ul CS-Cart?

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?

Vezi Marketplace & Integrari Marketplace