Callback
  • De la tarabă la magazin

  • -

  • De la magazin la lanț de retail

  • -

  • De la retail la producție

Integrări Torgsoft: marketplace-uri, CRM și magazine online

Torgsoft susține oficial integrările care sunt deja implementate de companie și descrise în documentația programului și Torgsoft Online Market. Conexiunile altor platforme pot fi dezvoltate de integratori și dezvoltatori terți. Aceștia creează serviciul de schimb, configurează lucrul cu platforma și asigură suportul acestuia.

Pentru conexiunile terțe se folosesc capacitățile existente ale Torgsoft: exportul de produse, prețuri, stocuri și date ale clienților, importul de noi comenzi, opțiuni specializate și exportul anumitor rapoarte. Nu există un API deschis universal pentru gestionarea arbitrară a documentelor contabile în această schemă.

Ghidul definește ce trebuie pregătit de fiecare parte și cum se distribuie munca între proprietarul magazinului, integrator și dezvoltator. În tabele sunt indicate separat conexiunile standard și scenariile de creare a unui adaptor terț.

30 de zile pentru testarea opțiunii și a schimbului

Opțiunile suplimentare Torgsoft pot fi activate gratuit timp de 30 de zile, în special «Sincronizarea cu magazinul online». Calea în program: Setări → Lista funcțiilor suplimentare → Activați pentru 30 de zile. După activare, reporniți Torgsoft.

Excepția — «Ștergerea statisticilor perioadelor închise». Pentru anumite opțiuni se aplică limite demo: de exemplu, integrarea cu Rozetka în modul de testare include până la 10 produse în lista de prețuri XML. Accesul la API, abonamentele la platforme, găzduirea și dezvoltarea adaptorului se procesează separat. Termenul de dezvoltare și aprobare a accesului este determinat independent de perioada de probă.

1. Cum se organizează schimbul și cine este responsabil pentru ce

Adaptorul — un program separat sau un modul al site-ului care convertește fișierele Torgsoft în solicitări către API-ul serviciului extern și pregătește fișierele noilor comenzi pentru Torgsoft. API-ul platformei oferă operațiuni permise cu produsele, comenzile sau contactele sale. **Feed-ul** — un fișier de catalog pe care serviciul îl descarcă printr-un link sau îl acceptă prin propriul său mecanism de import.

Conexiunea este formată din două părți. Integratorul configurează exportul și importul în Torgsoft. Dezvoltatorul creează sau instalează un modul compatibil pe partea site-ului, CRM-ului sau marketplace-ului. Activarea opțiunii oferă capabilitățile Torgsoft în limitele documentației sale; serviciul terț de schimb efectuează conversia datelor și lucrează cu API-ul platformei selectate.

ParticipantCe pregăteștePentru ce este responsabil
Proprietarul magazinului Conturile de vânzător, produsele, depozitul, valuta, regulile de preț, plățile, rezervările și expedierile. Accesul la platformă, fiabilitatea evidenței, produsele permise și fluxul de lucru convenit al angajaților.
Integratorul Torgsoft Opțiunile, obiectele de sincronizare, câmpurile fișierelor, centrele de evidență, conturile pentru plăți, programul și notificările. Configurarea programului și verificarea documentelor create, rezervelor, prețurilor și execuției sarcinilor.
Dezvoltatorul adaptorului Aplicația platformei, autorizarea, maparea produselor, conversia formatelor, jurnalul și recuperarea. Funcționarea API-ului, integralitatea transmiterii, protecția împotriva importului repetat și compatibilitatea interfețelor.
Administratorul de server Directoarele de schimb, permisiunile, transportul criptat, lansarea serviciilor, copiile de rezervă și monitorizarea. Funcționarea după repornire și separarea datelor de serviciu de feed-urile publice.
Managerul de comenzi Verificarea comenzilor, asamblarea, confirmarea plăților, expedierilor, anulărilor și retururilor. Acțiunile lăsate manuale și reconcilierea excepțiilor care nu sunt procesate automat.

O singură persoană poate îndeplini mai multe roluri. În specificația tehnică pentru fiecare secțiune, executorul și rezultatul prin care se verifică munca sunt totuși definite.

Direcțiile de transmitere a datelor

DirecțiaMecanismul TorgsoftAcțiunea adaptoruluiLimitele scenariului
Torgsoft → catalog CSV/YML și fotografii. Mapează produsele, pregătește câmpurile platformei, actualizează cardurile, prețurile și cantitățile. Cardurile noi necesită categorii, caracteristici și alte date obligatorii ale platformei.
Platforma → comandă nouă Import SAL/XML/JSON. Primește comenzile, verifică articolele și generează un fișier cu valoarea SaleType. Formatul determină crearea unei comenzi sau a unei facturi, plata și expedierea conform scenariului prevăzut.
Torgsoft → contacte TSClients.trs conform setărilor. Selectează câmpurile permise și le aliniază la structura CRM sau a sistemului de mailing. Prezența unui contact nu stabilește consimțământul pentru trimiterea de mesaje publicitare.
Torgsoft → analitică Fișierul de produse și exportul anumitor rapoarte. Încarcă fișierele într-un tabel sau model analitic. Istoricul vânzărilor nu este inclus în fișierul de produse. Exportul fiecărui raport este definit separat.
Fiecare integrare are un domeniu de aplicare definit

Transmiterea catalogului nu include primirea comenzilor. Importul unei comenzi noi nu oferă o comandă universală pentru a modifica o factură deja creată, un retur sau o operațiune financiară. Pentru astfel de acțiuni, se utilizează capacitățile unei integrări standard specifice sau un proces separat în interfața Torgsoft.

Trei metode de conectare

  1. Integrare standard. Proprietarul activează opțiunea sau modulul TOM, integratorul îl configurează conform instrucțiunilor. Lista de operațiuni este definită de documentația conexiunii.
  2. Adaptor terț. Integratorul pregătește schimbul de fișiere Torgsoft, dezvoltatorul lucrează cu API-ul sau feed-ul platformei și formează fișierele de comenzi.
  3. Conectare prin site sau CRM. Torgsoft schimbă date cu un singur sistem care are conectori către alte canale. Dezvoltatorul determină ruta comenzilor, sursa stocurilor și regulile de rezervare pentru toate verigile.

Pentru fiecare canal este definită o singură rută de primire a comenzii în Torgsoft. De exemplu, comenzile din marketplace sunt transmise printr-un adaptor direct sau prin CRM. Importul simultan prin ambele rute necesită un mecanism comun pentru eliminarea duplicatelor.

2. Ce trebuie pregătit în Torgsoft și cum se citesc fișierele sale

Baza adaptorului este formatul de sincronizare a magazinului online cu Torgsoft. Setările sunt descrise în instrucțiunile opțiunii. Înainte de dezvoltare, integratorul transmite dezvoltatorului fișierul real de produse, setările de export și numărul versiunii bazei de date.

2.1. Pregătirea obiectului de sincronizare

  1. Activați «Sincronizarea cu magazinul online» și deschideți Depozit → Sincronizare cu magazinul online.
  2. Creați un obiect cu numele canalului. Selectați centrele de evidență pentru export și centrul din care sunt plasate comenzile.
  3. Determinați sursa prețului pentru factură: Torgsoft sau magazinul online. Pentru a salva prețul de achiziție pe platformă, bifați «Pentru produsele de pe factură, se iau prețurile din».
  4. Conveniți asupra rezervării, procesării cantităților lipsă și contului sau casei de marcat pentru plăți.
  5. Setați câmpurile, numele fișierelor, codificarea, transferul clienților și metoda de livrare a fotografiilor.
  6. Configurați adresa de schimb, transferați manual produsele de testare și descărcați o singură comandă.
  7. După verificare, activați programul și notificările pentru angajatul responsabil.

În fila «Clienți», se verifică căutarea după numărul de telefon, crearea de clienți noi și actualizarea datelor acestora. Dezvoltatorul transmite numărul de telefon în formatul internațional convenit. Căutarea după numărul de telefon nu înlocuiește cheia comenzii și nu protejează împotriva creării repetate a documentului.

2.2. Livrarea fișierelor: FTP cu TLS sau directorul serverului web

MetodăSetările TorgsoftMunca administratorului și a dezvoltatorului
FTP cu SSL/TLS Adresa serverului, login, parola, directorul și «Utilizați criptarea SSL/TLS». Configurați un server FTP compatibil și TLS. Verificați modul pasiv, drepturile de scriere, încărcarea și ștergerea. Confirmați criptarea în timpul schimbului.
Server web: informații Directorul fișierelor de produse, clienți și alte date. Aici programul caută, de asemenea, fișierele de comenzi. Oferiți adaptorului acces la director. Pentru acces extern, creați un gateway securizat; HTTPS și autorizarea sunt asigurate de serverul web.
Server web: fotografii Directorul fotografiilor din parametrii Torgsoft. Organizați accesul la imagini. Pentru această metodă, fotografiile trebuie să fie stocate în director.

Tipul «Server web» funcționează cu fișiere într-un director specificat. Nu creează un API REST universal pentru Torgsoft. SFTP este un alt protocol; suportul său în Make, n8n sau un marketplace nu înseamnă suport în metoda de livrare selectată în Torgsoft.

Directoarele pentru feed-ul de produse, comenzi, contacte și certificate sunt separate prin drepturi de acces. În spatele adresei URL publice a sistemului de publicitate sunt plasate doar fișierul de produse permis și imaginile.

2.3. Produse, prețuri, stocuri și fotografii

TSGoods.trs — denumirea tipică pentru un CSV cu separatorul ;. Câmpurile, numele, ordinea lor, antetul și numele fișierului sunt personalizabile. Un format alternativ este YML, un catalog XML cu o structură corespunzătoare de etichete.

DateAcțiunile integratoruluiAcțiunile dezvoltatorului
GoodID Include cheia produsului pentru export. Mapează cheia cu produsul sau varianta platformei și o transmite înapoi în comandă. Diferențiază bazele de date ale diferitelor magazine.
Articul, Barcode Verifică codurile de bare, articolele și duplicatele. Se folosește pentru maparea primară cu SKU. Înlocuiește GoodID pentru importul unui articol de produs.
Nume, descriere, producător, categorii, caracteristici dinamice Completează cardurile și include câmpurile necesare în fișier. Mapează categoriile și caracteristicile cu clasificatorul platformei. Adaugă date obligatorii care lipsesc în export.
RetailPrice, WholesalePrice, prețuri promoționale și în valută Selectează tipul de preț și sursa prețului facturii. Aplică valuta canalului, marja și rotunjirea. Salvează prețul efectiv de achiziție și verifică totalul comenzii.
WarehouseQuantity Verifică includerea centrelor de evidență și a rezervelor în fișier. Calculează disponibilitatea canalului conform regulii convenite. Rezervele deja luate în considerare nu se mai scad din nou.
WarehouseQuantityForPartner Include cantitatea per centre de evidență. Analizează 2=1,000|3=2,000: codul centrului și cantitatea. Mapează codurile cu depozitele platformei.
ModelGoodID, culoare, mărime Pregătește modelele și variantele separate de depozit. Mapează fiecare variantă. Dimensiunile sau culorile cu stocuri separate se salvează ca poziții separate de depozit.
GoodPhotoList, GoodPhotoListWithLinks Configurează directorul foto, numele fișierelor și prefixul linkurilor. Verifică adresele URL și cerințele imaginilor. Pentru aceste câmpuri se utilizează modul prevăzut de stocare a fotografiilor în director.

Parserul CSV este configurat în funcție de exportul real: separator, antete, codificare, ghilimele și numere. Caracterele speciale sunt verificate pe un fișier de test. În modul UTF-8, Torgsoft generează un CSV de produs cu un BOM — un marcaj de codificare de serviciu la începutul fișierului; adaptorul trebuie să-l proceseze.

YML-ul Torgsoft nu este un feed gata făcut pentru fiecare serviciu. Dezvoltatorul verifică elementul rădăcină, etichetele obligatorii, caracteristicile, limbile și ID-ul destinatarului. De exemplu, Hotline folosește propria structură XML, iar marketplace-urile necesită coduri de categorie și valori ale caracteristicilor.

2.4. Formatul noii comenzi

Torgsoft acceptă fișiere text .sal. Începând cu versiunea de bază de date 493, sunt suportate și XML și JSON în UTF-8. Pentru SAL, se utilizează codificarea obiectului de sincronizare; în modul UTF-8 este necesar BOM. Numele fișierului este compus din caractere ASCII: litere latine, numere și separatori siguri.

Datele API sunt convertite în schema Torgsoft: cumpărătorul ajunge în Client, parametrii — în Options, pozițiile — în Goods. Câmpuri obligatorii: Client.Name, Options.OrderNumber, Options.SaleType și GoodID, Price, Count pentru fiecare produs.

Exemplu de JSON cu date condiționale pentru o precomandă:

{
  "Client": {
    "Name": "Cumpărător de test",
    "MPhone": "+380670000000",
    "EMail": "buyer@example.com"
  },
  "Options": {
    "OrderNumber": "SHOP-A-100042",
    "SaleType": "1",
    "OrderDate": "2026-10-05 12:00:00",
    "CurrencyInternationalCode": "UAH",
    "Comment": "Comandă de test de la canal extern"
  },
  "Goods": [
    { "GoodID": "201", "Price": "1290.00", "Count": "1" },
    { "GoodID": "202", "Price": "350.00", "Count": "2" }
  ]
}

Înainte de încărcare, integratorul înlocuiește GoodID-urile reale din baza de date de test și verifică documentele în program. Dezvoltatorul formează un OrderNumber stabil din codul canalului, magazin, și ID-ul extern. Numerele comenzilor diferite și ale magazinelor nu trebuie să coincidă.

Câmpurile suplimentare transmit adresa, livrarea, data rezervării, codul valutar, tipul comerțului și centrul de evidență. Disponibilitatea depinde de versiunea bazei de date. WarehouseID este preluat din Torgsoft; codul depozitului marketplace-ului necesită mapare. Scopul WarehouseID în parametrii generali și în rândul de produs este descris în formatul de schimb.

CâmpFormat și destinațieCe trebuie convenit
Options.OrderDate Data comenzii: yyyy-mm-dd hh:mm:ss. Fusul orar al magazinului și conversia timpului API la ora locală convenită.
Options.ReserveDate Data rezervării: ddmmyyyy, de exemplu 05102026. Perioada de rezervare și comportamentul la expirarea acesteia.
Options.CurrencyInternationalCode Codul internațional al valutei. În lipsa acestui câmp, procesarea se face în moneda națională. Valuta comenzii, setările contabile și cursurile de schimb, dacă este necesară recalcularea.
Options.SaleForm 1 — en-gros, 2 — amănuntul; o valoare absentă sau incorectă înseamnă cu amănuntul. Tipul de comerț și sursa prețului facturii.
Options.WarehouseID, Goods[].WarehouseID Centrul de evidență al facturii și centrul de descărcare a unei anumite poziții de produs. Codurile reale ale centrelor din Torgsoft și procesarea comenzilor din mai multe depozite.
Options.BonusPay, Options.GiftCertificate Suma plății cu bonusuri și lista numerelor certificatelor utilizate prin virgulă. Opțiunile activate, setările de sincronizare corespunzătoare, verificarea soldului disponibil și rezultatul deducerii.
Options.DeliveryCondition, Options.DeliveryAddress Condiția de livrare și adresa text. Completarea acestor câmpuri și a parametrilor structurați separați ai transportatorului.

2.5. SaleType: ce documente creează importul

SaleTypeRezultatCe se verifică
1 Precomandă, pe baza căreia se poate crea o factură. Cine verifică comanda și emite factura. Potrivit pentru primul test de import.
2 Factură cu 100% plată în avans. Plata integrală, suma, contul de încasare și setările contabile.
3 Factură cu 100% plată în avans și expediere, crearea avizului de însoțire a mărfii. Plata integrală și momentul expedierii contabile. Statutul «plătit» nu confirmă predarea coletului către transportator.
4 Factură fără plată, cu expediere și crearea avizului de însoțire a mărfii. Baza pentru expediere fără plata în avans și evidența ulterioară a decontărilor.
5 Imediat factură; nu se creează precomandă. Cine efectuează plata, rezervarea și expedierea conform facturii.

Pentru SaleType 2–5, documentația presupune prezența întregii cantități necesare în centrul de evidență. În absența produsului, vânzarea poate trece pe minus. Înainte de crearea automată a documentelor, se verifică cantitatea și regulile de acțiune în caz de deficit.

Comentariul «plătit» nu procesează plata. SaleType nu returnează fondurile în serviciul de plată. Dezvoltatorul și integratorul convin asupra evenimentului de pe platformă, tipului de document, contului de încasare și acțiunilor ulterioare ale angajatului.

2.6. Clienți, prețuri en-gros și certificate

Conform setărilor, Torgsoft exportă TSClients.trs: numele complet, contactele, adresa, cardul clientului, reducerea, suma pentru calculul acesteia și bonusurile acumulate. Dezvoltatorul determină cheia de mapare și transmite destinatarului doar câmpurile necesare. Istoricul cumpărăturilor nu este inclus în acest fișier.

Opțiunea «Politica de prețuri en-gros» adaugă un XML cu praguri de cantitate și prețuri. Pentru certificate este prevăzut CSV-ul TSGiftCertificate.trs. Destinatarul trebuie să implementeze regulile corespunzătoare de preț sau de fidelitate.

Bonusurile și certificatele utilizate sunt transmise în comandă prin BonusPay și GiftCertificate. Integratorul activează opțiunile și setările necesare; dezvoltatorul, înainte de plată, verifică datele actuale conform procesului convenit. Echipa verifică deducerea finală în Torgsoft și regulile de anulare a achiziției.

Exportul bonusurilor și certificatelor este o captură la momentul formării. Pentru a utiliza fidelitatea în mai multe canale, este necesar un proces convenit de verificare și deducere. Fișierul în sine nu blochează reutilizarea unui certificat în alt magazin.

2.7. Program, mesaje POST și confirmarea importului

Produsele și comenzile pot avea sarcini separate. Integratorul selectează tipul de sincronizare și executorul: Torgsoft sau serverul de sarcini automate. Pentru lansarea prin program, este necesar ca programul să fie deschis pe computerul specificat de utilizatorul specificat. Pentru lucrul în fundal, se verifică serviciul, versiunea acestuia, drepturile și accesul la fișiere.

Intervalul se stabilește conform recomandărilor din secțiunea de ajutor: nu mai des de o dată la 10 minute, luând în considerare celelalte obiecte. Dezvoltatorul configurează separat frecvența solicitărilor către API. Interogarea frecventă a platformei nu accelerează importul fișierului în Torgsoft în afara programului.

«Trimitere solicitare POST după sincronizare» notifică site-ul despre finalizarea schimbului. Dezvoltatorul furnizează URL-ul, numele și valoarea parametrului; integratorul le setează în program. Pentru solicitare, se specifică timeout-ul final, User-Agent permis și redirecționarea. Un timeout de 0 înseamnă așteptare nelimitată.

Acest mesaj nu este un flux al tuturor evenimentelor de vânzare sau retur. După acesta, adaptorul citește fișierele gata făcute. Webhook-urile platformei externe sunt primite de propriul handler HTTP al adaptorului.

În scenariul FTP, fișierul de comandă se descarcă local și se șterge de pe FTP, apoi se procesează de program și, după importul cu succes, se șterge local. Dispariția fișierului de pe FTP nu confirmă crearea documentului. Un fișier eronat în directorul local poate împiedica importul ulterior; integratorul verifică jurnalul și documentele.

3. Integrări standard și capacitățile TOM

Pentru aceste scenarii, se utilizează funcțiile Torgsoft sau opțiuni specializate. Proprietarul obține acces la serviciul extern, integratorul configurează modul. Suportul acoperă operațiunile documentate de conectare.

ServiciulScenariul standardPregătirea și configurareaCondiții
Prom.ua Schimb de produse și comenzi prin «Integrarea cu Prom.ua». Proprietarul: contul și accesele. Integratorul: opțiunea, obiectul, lista de prețuri, maparea produselor și procesarea comenzilor. Verificați variantele, prețurile, asocierea pozițiilor și tranzițiile de statusuri suportate conform instrucțiunilor opțiunii.
Rozetka Listă de prețuri XML și comenzi prin «Integrarea cu Rozetka.ua». Proprietarul: contul, cardurile și accesele. Integratorul: opțiunea, caracteristicile, fotografiile, regulile de acceptare și programul. Lista de prețuri trebuie să corespundă cu Rozetka. Demo — până la 10 produse. Înainte de publicare, verificați integralitatea fișierului și procesarea sa.
Satu.kz Schimb prin opțiunea specializată Satu.kz. Proprietarul: magazinul pe Satu. Integratorul: accesele, produsele, prețurile, obiectul și acceptarea comenzilor. Conexiunile Satu și Kaspi sunt scenarii diferite. Pentru Kaspi este nevoie de un adaptor separat.
Nova Poshta Avize de însoțire prin opțiunea «Nova Poshta». Proprietarul: contul și cheia API. Integratorul: expeditorul, adresele, livrarea și documentele asociate. Formatul comenzii suportă NewPostDeliveryOptions și numărul AWB (TTN). Detaliile sunt prezentate în secțiunea despre livrare.
Ukrposhta Expedieri poștale prevăzute de opțiune. Proprietarul: accesele. Integratorul: opțiunea, expeditorul, adresele și parametrii coletelor. Parametrii Nova Poshta nu se utilizează pentru Ukrposhta. Configurarea se face conform instrucțiunilor separate.
Binotel Telefonie și interacțiunea cu clienții prevăzută de opțiune. Proprietarul: contul și accesul. Integratorul: opțiunea, conexiunea și telefoanele clienților. Verificați căutarea clientului și permisiunile angajaților. Conectarea telefoniei nu oferă un API de vânzări.
PrivatBank, monobank, UKRSIBBANK Extrase prin «Extrase bancare». Proprietarul: accesul la conturi. Integratorul: conturile Torgsoft, metoda de obținere și recunoașterea plăților. Conturile, valutele și autorizarea se verifică pentru o conexiune specifică. Extrasul și acquiring-ul pe internet au mecanisme diferite.
TurboSMS, AlphaSMS SMS prin TurboSMS și AlphaSMS; Viber prin TurboSMS Viber. Proprietarul: contul, soldul și expeditorul aprobat. Integratorul: serviciul, accesele, șabloanele și destinatarii. Se aplică cerințele furnizorului privind mesajele și expeditorul. Pentru publicitate este necesar acordul corespunzător al destinatarilor.
SendGrid, SMTP Expedierea e-mailurilor prin instrumentele programului. Proprietarul: serviciul de mail și domeniul. Integratorul: metoda de expediere, accesele și expeditorul. Verificați domeniul, limitele, dezabonările și adresele nevalide. Configurarea expedierii nu include toate funcțiile unui serviciu de marketing.
Google Drive Arhivarea în spațiul de stocare în cloud. Proprietarul: contul și spațiul. Integratorul: opțiunea de arhivare, autorizarea, conținutul arhivei și programul. Verificați finalizarea copierii și restaurarea. Arhiva bazei de date nu este utilizată pentru stocurile operaționale de pe marketplace.
M.E.Doc, Art-Zvit Documente prin formatele de export prevăzute. Contabilul: tipul documentului și detaliile. Integratorul: exportul corespunzător și importul în receptor. Volumul este determinat de tipul documentului. Sincronizarea contabilă bidirecțională completă nu este inclusă în acest scenariu.
Webkassa, IS ESF Kazakhstan Opțiuni specializate pentru fiscalizare și facturi electronice. Proprietarul și contabilul: înregistrarea, detaliile și accesele. Integratorul: opțiunile și setările. Aceste funcții au propriile cerințe și nu înlocuiesc schimbul de produse și comenzi cu Kaspi.

Documentație: integrările Torgsoft, ajutorul programului, extrase bancare.

Module gata făcute Torgsoft Online Market

Torgsoft Online Market, TOM — o platformă de magazin online care lucrează împreună cu Torgsoft. Accesele, plățile, feed-urile și resursele externe sunt configurate în panoul TOM. Integrările sale se referă la datele magazinului și nu creează un API pentru toate documentele Torgsoft.

Modul TOMDateAcțiunile integratoruluiVerificări
KeyCRM Comenzile TOM, cumpărătorul, produsele, prețurile, plățile și livrarea; statusurile de retur configurate către TOM. Activează modulul; specifică cheia, ID-ul sursei, managerul, livrările, plățile și statusurile. Alte canale KeyCRM necesită o rută separată către Torgsoft. Statusul în TOM și starea documentelor contabile se verifică separat.
LiqPay, Portmone, monobank Plata în TOM și transmiterea comenzii după tipul selectat. Conectează comerciantul, cheile și «Tipul comenzii Torgsoft» pentru metoda de plată. Verifică plata cu succes, factura, suma și documentul. Datele bancare complete ale plății nu sunt transmise prin acest modul.
Google Merchant Center, Hotline Feed-uri de produse. Activează feed-ul, include categoriile, completează caracteristicile și verifică raportul de generare. Feed-ul trebuie să treacă verificarea destinatarului. Transmiterea catalogului nu înseamnă aprobarea campaniei publicitare.
Google Analytics 4, Google Tag Manager Analitica web și evenimentele magazinului. Specifică ID-urile resurselor, configurează etichetele și verifică evenimentele. Verifică transaction ID și duplicarea purchase. Vânzările offline necesită o sursă separată de date.

4. Platforme pentru magazine online

Pentru CMS este nevoie de un modul care mapează articolele site-ului cu produsele Torgsoft, actualizează câmpurile convenite și transmite comenzile noi. Proprietarul oferă acces la magazin și definește stocul. Integratorul pregătește schimbul de fișiere. Dezvoltatorul instalează un conector compatibil sau creează un adaptor pentru API-ul platformei.

Înainte de lansare, stabiliți cine creează cardurile de produse și gestionează descrierile. Pentru un site deja completat, se pot transmite doar prețurile și stocurile. Dacă adaptorul va crea cardurile, are nevoie suplimentar de categorii, caracteristici, variante, fotografii și reguli de publicare.

PlatformaScenariuCe trebuie pregătit și făcutCondiții și verificări
Horoshop Catalog, prețuri, stocuri și comenzi prin conexiunea platformei. Proprietarul coordonează conexiunea cu Horoshop. Integratorul configurează opțiunea de sincronizare, fișierul, fotografiile și directorul de comenzi conform cerințelor conectorului. Înainte de lansare, conveniți asupra structurii câmpurilor și identificatorului de mapare. Verificați mărimile, culorile, cardurile existente, prețurile reduse și tipul de document al comenzii.
OpenCart Catalog și comenzi prin modulul de schimb. Proprietarul oferă versiunea CMS și lista de extensii. Dezvoltatorul instalează un modul compatibil sau adaugă un handler de fișiere și sarcini de schimb. Integratorul configurează Torgsoft. API-ul standard OpenCart nu înlocuiește un conector complet pentru catalog. Verificați compatibilitatea cu modulul de variante, reducerile, taxele și plasarea comenzii personalizată (checkout).
WooCommerce Produse, variații, stocuri și comenzi noi. Dezvoltatorul obține cheile REST API cu drepturile necesare, utilizează produsele, variațiile și comenzile wc/v3. Salvează legătura GoodID cu product/variation ID. Verificați separat gestionarea stocului produsului părinte și a variației, statusurile comenzii și relivrarea webhook-urilor. Webhook-urile trebuie să treacă verificarea semnăturii.
PrestaShop Produse, combinații, stocuri și comenzi prin Webservice. Administratorul activează Webservice și emite o cheie limitată. Dezvoltatorul lucrează cu resursele de produse, combinații, stock_availables și comenzi. Verificați formatul solicitărilor și resursele disponibile cu versiunea magazinului. În modul multi-magazin, luați în considerare shop ID; actualizați stocul combinației după identificatorul său.
Shopify Catalog, prețuri, cantități de depozit și comenzi prin GraphQL Admin API. Proprietarul instalează aplicația. Dezvoltatorul configurează autorizarea, permisiunile pentru produse, stocuri și comenzi; mapează variantele, inventory item și location ID. Accesul la datele cumpărătorilor și comenzile vechi necesită permisiunile corespunzătoare. Verificați versiunea API, limitele GraphQL și diferența dintre cantitatea disponibilă și alte stări ale stocului.
Wix Stores Catalog, stocuri și comenzi Wix. Dezvoltatorul determină versiunea de catalog a magazinului, obține permisiunile Stores și eCommerce, mapează variantele și locațiile de stocare, utilizează respectivele Inventory API și Orders API. Câmpurile stocului agregat din obiectul produsului pot fi doar în modul citire (read-only). Actualizați cantitatea prin resursa desemnată; nu amestecați modelele de catalog V1 și V3.
Ecwid Produse, combinații, cantitate și comenzi. Proprietarul verifică disponibilitatea API-ului pentru magazin. Dezvoltatorul obține store ID și token-ul cu drepturi de citire a comenzilor și lucrul cu catalogul. Mapează combinațiile individuale, salvează ID-ul magazinului împreună cu ID-ul comenzii. Verificați statusurile de plată, ale comenzilor și limitele planului.
BigCommerce Catalog, stocuri și comenzi. Dezvoltatorul configurează API account/OAuth și scope-urile necesare. Pentru catalog utilizează Catalog API, pentru depozite — Inventory API, pentru comenzi — respectivul Orders API. Resursele aparțin unor versiuni API diferite. Luați în considerare location ID, variantele, canalele și listele de prețuri; nu aplicați un singur preț pentru toate grupurile de cumpărători fără acord prealabil.
Magento / Adobe Commerce Produse, cantități de depozit și comenzi prin REST API. Administratorul creează integrarea cu resursele necesare. Dezvoltatorul mapează SKU, website/store scope și inventory sources. În Multi-Source Inventory, cantitatea din source și salable quantity au scopuri diferite. Luați în considerare rezervările Magento și nu deduceți aceeași rezervă de două ori.
MODX și site individual Catalog și comenzi printr-un modul personalizat. Dezvoltatorul adaugă un handler de fișier de produse la modulul efectiv al magazinului, jurnalul de mapare și generatorul de fișiere de comenzi. Configurează sarcinile de fundal. MODX în sine nu definește un format unic de coș și comandă. Contractul de schimb este definit pentru componenta de magazin instalată sau baza de date proprie a site-ului.

5. Marketplace-uri și servicii de anunțuri

Prom.ua, Rozetka și Satu.kz sunt discutate printre opțiunile standard. Pentru platformele din acest tabel, este descrisă funcționarea unui adaptor terț. Mai întâi, proprietarul înregistrează contul de vânzător și accesul la operațiunile necesare. Dezvoltatorul verifică permisiunile aplicației, cerințele categoriilor, formatul de preț și cantitate, iar integratorul pregătește schimbul Torgsoft.

Transmiterea doar a articolului, numelui și prețului este suficientă pentru a actualiza o parte din ofertele deja create. Pentru a publica un card nou, sunt necesare toate atributele obligatorii ale platformei. Datele lipsă din fișierul de produse sunt stocate în tabelul de corespondențe sau directoarele adaptorului.

ServiciuScenariuCe face dezvoltatorulCe trebuie să verifice proprietarul și integratorul
Etsy Actualizarea listărilor, variantelor, prețurilor, cantității; primirea comenzilor. Înregistrează aplicația Open API v3, configurează OAuth cu PKCE și scope-urile necesare. Mapează GoodID cu listing/product/variation, pregătește fișierul de comandă. Tipul de acces al aplicației, regulile pentru produsele permise pe Etsy, caracteristicile variantelor, profilurile de livrare și valuta magazinului. Accesul comercial pentru a deservi alți vânzători se aprobă conform regulilor Etsy.
eBay Oferte prin Inventory API, comenzi prin Fulfillment API. Obține seller OAuth, configurează inventory location, politicile de afaceri și SKU-urile. Creează sau actualizează inventory items/offers, descarcă comenzile. Conveniți asupra metodei de transfer a listărilor existente. Ofertele create prin Inventory API trebuie gestionate de operațiunile sale. Verificați piața, valuta, livrarea și stocul fiecărei variații.
Allegro Oferte, prețuri, disponibilitate și comenzi. Înregistrează aplicația, efectuează OAuth, mapează produsele la offers, citește checkout forms și evenimentele de comenzi. Parametri obligatorii ai categoriilor, catalogul Allegro, piețele disponibile, valuta și metodele de livrare. Legarea unui produs la catalog și publicarea unei oferte sunt operațiuni separate.
Amazon Ofertele și stocurile vânzătorului, primirea comenzilor prin Selling Partner API. Înregistrează aplicația și rolurile, configurează autorizarea vânzătorului, legăturile SKU/ASIN/marketplace ID și respectivele Listings, Feeds și Orders API. Separați FBM și FBA: rezerva locală a magazinului nu înlocuiește stocurile depozitului Amazon. Accesul la datele personale se înregistrează conform regulilor actuale ale API-ului și rolului corespunzător.
Epicentr Marketplace Catalog, prețuri și stocuri prin XML; comenzi prin API. Pregătește XML conform cerințelor Epicentr, categorii și atribute. Folosind token-ul contului, primește comenzi și creează fișiere pentru Torgsoft. API-ul de comenzi nu înlocuiește feed-ul XML de produse. Testele API trebuie efectuate luând în considerare lucrul în mediul de producție; conveniți asupra unei comenzi de control și evitați modificările masive.
ALLO Marketplace Catalog, prețuri și stocuri prin feed-ul de produse. Convertește exportul Torgsoft în XML conform cerințelor contului, adaugă categorii, caracteristici și fotografii, publică fișierul pentru descărcare. Metoda de primire a comenzilor se convine separat prin interfața permisă sau conectorul CRM. Feed-ul de produse în sine nu transmite comenzi.
eMAG Catalog, oferte, stocuri și comenzi prin Marketplace API. Obține accesul API al vânzătorului, implementează resursele de produse/oferte și comenzi pentru regiunea necesară. Categoriile, datele localizate, taxele și valuta regiunii. Procesați rezultatele pentru fiecare poziție și mesajele de procesare asincronă.
Kaufland Global Marketplace Date despre produse, oferte și comenzi prin Seller API; importul unei părți a datelor prin CSV. Configurează solicitările API semnate, storefront-ul și depozitele. Mapează EAN/produs cu units ale vânzătorului, obține order units. Crearea datelor despre produse și ofertele vânzătorului au cerințe diferite. Verificați rezultatul importului CSV după finalizarea procesării, nu doar acceptarea adresei URL.
Magazin Kaspi Oferte prin XML; comenzi prin API. Generează lista de prețuri XML cu merchant ID, SKU, date despre stocuri și prețuri; primește comenzi cu token-ul permis și le convertește în formatul Torgsoft. Accesul vânzătorului la Kaspi, regulile regiunii, orașului și depozitele. Sincronizarea standard Satu.kz nu realizează conectarea cu Kaspi.
Kasta Catalog prin XML și schimbul de stocuri prin interfețele HUB. Primește de la vânzător contractul de conectare pentru modelul său de colaborare; configurează XML și operațiunile permise ale HUB API, mapează produsele și variantele. Clarificați schema depozitelor și metoda de transmitere a comenzilor în contul furnizorului. Lanțul prin alt CRM necesită verificarea separată a fiecărei direcții de schimb.
OLX Publicarea și gestionarea anunțurilor prin operațiunile disponibile OLX API. Înregistrează aplicația, obține autorizarea utilizatorului, pregătește anunțurile din datele despre produse și salvează ID-urile lor. Categoriile, pachetele, moderarea și permisiunile contului. Un anunț nu este o comandă: procesarea vânzării și importul în Torgsoft sunt definite separat.
Temu Primirea comenzilor prin metodele permise ale Partner API. Înregistrează aplicația și autorizarea vânzătorului în regiunea necesară. Folosind drepturile acordate citește lista și detaliile comenzilor, mapează pozițiile și formează importul. Înainte de a începe lucrul, verificați accesul la metodele de comenzi și datele de livrare pentru modelul vânzătorului. Includeți catalogul și stocurile în sarcină doar după aprobarea operațiunilor API corespunzătoare.
TikTok Shop Produse și comenzi prin TikTok Shop Open Platform. Înregistrează aplicația, autorizarea vânzătorului, semnarea solicitărilor și scope-urile. Lucrează cu Product și Order API disponibile, depozite și SKU. Magazinul trebuie să fie admis pe piața suportată. Verificați cerințele categoriei, conformitatea produselor, permisiunile și diferențele regionale ale API-ului.

Corespondențe obligatorii pentru marketplace

  • Produs: GoodID Torgsoft → SKU vânzător → ID-ul ofertei și variantei sale. Pentru un set se salvează compoziția și regula de recalculare a cantității.
  • Depozit: centrul de evidență → warehouse/location/storefront-ul platformei. Vânzările din depozitele marketplace-ului sunt separate de cele proprii.
  • Comandă: canal + contul vânzătorului + ID extern → OrderNumber. Numărul se folosește invariabil la toate primirile repetate.
  • Preț: valuta, taxele, prețul promoțional și prețul efectiv de cumpărare. Comisionul platformei nu reduce automat suma produselor din comandă.
  • Stare: ce statusuri permit importul, rezervarea, plata, expedierea și anularea manuală. Statusurile diferitelor sisteme au propriile semnificații.

6. Cataloage de produse și canale de publicitate

Aceste servicii primesc date despre produse pentru a afișa oferte. Comanda se plasează în canalul de vânzări desemnat, de unde se transmite către Torgsoft. Proprietarul pregătește contul de afaceri și site-ul; dezvoltatorul creează feed-ul sau folosește un modul de magazin gata făcut; marketerul verifică diagnosticul și publicitatea.

ServiciuConexiuneAcțiunile executoruluiCerințe
Google Merchant Center Feed TOM gata făcut sau adaptor de fișier de produse. Dezvoltatorul adaugă un ID stabil, un link către pagină și o imagine, prețul, valuta, disponibilitatea și identificatorii produsului. Proprietarul configurează sursa de date și confirmă site-ul. Prețul și disponibilitatea trebuie să corespundă cu pagina și finalizarea comenzii (checkout). GTIN, brandul și alte câmpuri se completează conform cerințelor specifice ale produsului. Verificați rezultatul în diagnosticarea Merchant Center.
Hotline Feed TOM sau XML conform specificației Hotline. Dezvoltatorul mapează categoriile, producătorii, caracteristicile, prețurile, linkurile și condițiile de livrare. Proprietarul conectează lista de prețuri în contul magazinului. YML-ul altei platforme nu este acceptat ca un fișier Hotline gata făcut fără conversie. Se verifică valuta, adresele URL ale produselor, câmpurile obligatorii și rezultatul încărcării.
Facebook și Instagram: catalogul Meta prin Shopify Torgsoft → Shopify → canalul oficial Facebook & Instagram. Dezvoltatorul menține catalogul Shopify, proprietarul conectează resursele de afaceri Meta, marketerul configurează catalogul și campaniile. Disponibilitatea funcțiilor depinde de țară, contul de afaceri și regulile Meta. Importul comenzilor se face din Shopify doar pentru comenzile create efectiv acolo.
Pinterest Catalogs Feed pentru catalogul de produse. Dezvoltatorul pregătește fișierul conform specificației Pinterest cu linkuri, prețuri și disponibilitate. Proprietarul configurează business account, domeniul și sursa. Verificați disponibilitatea cataloagelor pentru țară și conformitatea magazinului cu cerințele Pinterest. Publicarea unui pin de produs nu creează o comandă în Torgsoft.

Feed-ul se publică integral: dezvoltatorul verifică structura, numărul de poziții și disponibilitatea linkurilor, apoi înlocuiește versiunea de lucru. Un fișier gol sau incomplet este blocat până la clarificarea cauzei, pentru ca serviciul extern să nu retragă din publicare ofertele actuale.

7. CRM și vânzări multicanal

CRM-ul poate uni comenzile de pe site-uri și marketplace-uri. Pentru o astfel de schemă este nevoie de o punte separată între CRM și Torgsoft. Prezența conectorilor către canale în CRM nu configurează automat această punte.

Proprietarul determină sursa stocurilor și ordinea de rezervare. Dezvoltatorul colectează comenzile, salvează canalul sursă și ID-ul, mapează produsele și creează fișierul Torgsoft. Integratorul verifică documentele rezultate. Până când comanda nu este importată și nu a afectat stocul contabil, adaptorul sau CRM-ul o iau în considerare în rezerva convenită a canalului.

ServiciuScenariuPregătirea și implementareaLimitele schimbului
KeyCRM Modul TOM gata făcut sau adaptor terț al comenzilor din alte surse. Pentru TOM, integratorul folosește modulul din secțiunea 3. Pentru alte canale, dezvoltatorul obține un API key, determină sursele, selectează comenzile, mapează SKU-urile și pregătește fișierele. Modulul standard TOM deservește ruta TOM descrisă. Statusurile altor canale, plățile și modificările inverse în Torgsoft sunt incluse într-o specificație tehnică separată.
SalesDrive Comenzi noi în Torgsoft; stocuri de produse în CRM printr-un mecanism permis. Proprietarul emite cheia cu drepturile necesare. Dezvoltatorul citește lista de comenzi, aplică filtrele și paginarea, convertește pozițiile. Pentru stocuri alege interfața XML/API documentată. Verificați disponibilitatea metodelor pentru tarif și setările contului, limitele actuale și câmpurile formularului. În cazul modificării manuale a comenzii după import, este necesară o procedură de reconciliere.
KeepinCRM Catalog, prețuri și stocuri prin XML. Dezvoltatorul generează XML-ul și configurează corespondențele câmpurilor; proprietarul specifică URL-ul și regulile de import în KeepinCRM. Importul automat XML documentat se execută la fiecare 12 ore. Această rută nu înseamnă transmiterea automată a tuturor comenzilor sau declanșarea evenimentelor de mișcare a stocului la suprascrierea soldurilor.
Base / BaseLinker Stocuri în inventory și comenzi de pe canalele conectate. Dezvoltatorul obține token-ul, inventory ID, depozitele și mapările produselor. Actualizează cantitățile, citește comenzile confirmate și, dacă este activat, jurnalul de evenimente. Procesați toate paginile și comenzile cu același timestamp (marcaj de timp). Un singur import în Torgsoft pentru o comandă externă; modificările după confirmare se procesează conform unor reguli separate.
HubSpot Transmiterea datelor de contact selectate. Dezvoltatorul convertește TSClients.trs în solicitări Contacts API sau într-un fișier de import. Proprietarul aprobă câmpurile și cheia de mapare; administratorul acordă accesul. Contactele nu conțin automat întregul istoric al achizițiilor, tranzacțiilor (deals) și soldurilor. Regulile de actualizare și protecția împotriva duplicatelor sunt stabilite separat.
Pipedrive Sincronizarea câmpurilor de contact convenite. Dezvoltatorul folosește Persons API actual, mapează contactul cu cheia externă și salvează Pipedrive ID. Nu creați o persoană nouă la fiecare export. Crearea tranzacțiilor (deals), activităților și istoricului vânzărilor necesită alte surse și un scenariu separat.
Zoho CRM Actualizarea contactelor prin API. Dezvoltatorul configurează OAuth pentru centrul de date necesar, câmpurile obligatorii Contacts și upsert cu cheia convenită. Verificați Last Name, câmpurile personalizate, regulile pentru duplicate și permissions. Câmpurile cu alte formate trebuie normalizate în prealabil.

Cum se distribuie statusurile

Dezvoltatorul menține un tabel de corespondențe: status CRM, condiția de import, SaleType și acțiunea managerului. De exemplu, o comandă neplătită confirmată poate crea o factură fără expediere. După plata efectivă a unei facturi deja create, managerul sau un mecanism separat suportat înregistrează plata. Importul repetat al aceleiași comenzi ca o factură nouă este exclus.

Anulările și retururile după import ajung în coada de reconciliere. Angajatul responsabil modifică documentele Torgsoft și confirmă finalizarea operațiunii. Automatizarea acestei etape se include doar cu o metodă specifică suportată de lucru cu documentul.

8. Mailing, telefonie și mesagerii

Pentru SMS, Viber, e-mailuri și telefonie, se verifică mai întâi setările standard Torgsoft din secțiunea 3. Pentru platformele de marketing, dezvoltatorul folosește exportul permis de contacte. Proprietarul determină scopul transmiterii, baza legală pentru trimiterea mesajelor și procedura de dezabonare.

ServiciuScenariuMunca dezvoltatorului și a proprietaruluiVerificări
SendPulse Contacte pentru newslettere prin import sau API. Dezvoltatorul convertește TSClients.trs într-o listă cu câmpurile necesare, configurează autorizarea și agenda (address book). Proprietarul aprobă audiența și mesajele. Salvați statusul de consimțământ și dezabonare. Un telefon sau email exportat nu înseamnă permisiunea pentru toate canalele de comunicare.
Mailchimp Importul sau actualizarea audienței. Dezvoltatorul pregătește CSV sau folosește Marketing API, mapează e-mailul și câmpurile suplimentare. Marketerul selectează audience și regulile de segmentare. Nu reabonați contactele dezabonate prin export repetat. Datele de e-commerce și evenimentele de cumpărare necesită o sursă separată.
Brevo Contacte, atribute și liste prin API. Dezvoltatorul mapează câmpurile, identificatorii și list IDs, creează sau actualizează contactele. Proprietarul configurează listele și regulile de comunicare. Verificați formatele telefonului, tipurile de atribute și comportamentul la coincidența e-mailului și a numărului. Dezabonările și blocările au prioritate asupra importului repetat.
Telegram Bot API Notificările adaptorului și comenzi structurate din bot. Dezvoltatorul creează botul, colectează coșul din SKU-urile cunoscute, cantitatea și datele cumpărătorului, formează fișierul de comandă. Pentru mesaje folosește chat IDs convenite. Un mesaj liber în chat nu este o comandă gata făcută. Sunt necesare verificarea utilizatorului, a token-ului, webhook, prețului și a tuturor pozițiilor. Notificările afișează doar evenimentele confirmate de adaptor.
WhatsApp, Instagram, Facebook Messenger prin SendPulse Comenzi din scenariul chatbot-ului prin webhook. Proprietarul conectează canalul de afaceri necesar. Dezvoltatorul primește datele coșului finalizat, găsește GoodID și creează fișierul pentru Torgsoft. Verificați drepturile contului de afaceri, disponibilitatea canalului, regulile pentru mesaje, șabloanele și consimțământul. Corespondența arbitrară cu un manager necesită procesarea separată a comenzii.

Webhook-ul mesageriei este primit de adaptor. Acesta verifică evenimentul, îl salvează în jurnal și răspunde platformei. Fișierul pentru Torgsoft este creat după verificarea comenzii. Acest lucru permite reprocesarea evenimentului fără a recrea documentul.

Binotel este utilizat în cadrul scenariului standard de telefonie. Pentru legarea unui apel cu un CRM sau un bot separat, se definește o rută proprie și drepturi de acces la datele conversațiilor. Numărul de telefon al cumpărătorului nu este un identificator al comenzii sale.

9. Plăți și livrare

9.1. Plata online și extrasul bancar

Modulele TOM pentru LiqPay, Portmone și monobank, precum și extrasele bancare standard sunt prezentate în secțiunea 3. Pentru un alt site, furnizorul de plăți este conectat pe partea site-ului. Dezvoltatorul confirmă rezultatul plății, iar integratorul aprobă afișarea acesteia în Torgsoft.

FurnizorScenariuCe se va implementaCondiții
WayForPay Plata pe site; importul noii comenzi confirmate. Proprietarul obține merchant account. Dezvoltatorul conectează plata, verificarea semnăturii callback, numărul, suma, valuta și statusul final. Pagina de întoarcere reușită a cumpărătorului nu înlocuiește verificarea plății. Callback-ul repetat nu trebuie să recreeze comanda.
Stripe Plata pe site prin contul Stripe accesibil afacerii. Dezvoltatorul verifică semnătura webhook-ului pe corpul original al solicitării, corelează plata cu comanda și confirmă starea finală. Proprietarul verifică disponibilitatea Stripe pentru țară și afacere. Metodele de plată amânată se finalizează printr-un eveniment separat; crearea sesiunii de plată (checkout session) nu confirmă plata.
PayPal Plata pe site prin cont de afaceri. Dezvoltatorul conectează checkout-ul, verificarea webhook-ului și rezultatul retragerii efective — capture. Salvează payment/capture ID. Aprobarea comenzii de către cumpărător și retragerea (capture) finalizată sunt stări diferite. Verificați disponibilitatea acceptării plăților, valuta și suma.

Dacă o nouă comandă este primită deja cu plata integrală confirmată, pentru aceasta se poate conveni SaleType=2. Pentru expedierea contabilă automată, este necesar un scenariu separat aprobat SaleType=3. Dacă factura este deja creată în Torgsoft, o plată ulterioară nu este un motiv pentru a descărca această comandă din nou ca fiind una nouă.

Plățile parțiale, rambursul, comisioanele, returnările și discrepanțele de sumă sunt procesate după reguli separate. Integratorul specifică contul de încasare, managerul reconciliază suma vânzării cu plata, contabilul — cu plata furnizorului. Comisionul reținut și suma primită la bancă nu modifică automat prețul produselor achiziționate.

9.2. Transmiterea datelor de livrare

Documentul de vânzare și avizul de transport (AWB) au destinații diferite. Pentru livrare, proprietarul configurează un cont la transportator. Dezvoltatorul transmite datele adresei și identificatorii externi; integratorul determină unde se creează AWB-ul și cum îl vede angajatul în Torgsoft.

ServiciuRutăCe trebuie pregătitLimitele scenariului
Nova Poshta Opțiune standard și datele NewPostDeliveryOptions în fișierul de comandă. Integratorul configurează contul, expeditorul și opțiunea. Dezvoltatorul transmite destinatarul, tipul livrării, sucursala sau adresa; pentru AWB existent — DeclarationNumber. Verificați identificatorii actuali ai sucursalelor, telefonul și datele de adresă ucrainene. Importul unui AWB existent are propriile condiții, enumerate mai jos.
Ukrposhta Opțiune standard Torgsoft. Proprietarul obține accesul la transportator. Integratorul configurează expeditorul, adresa, tipul expedierii și datele destinatarului conform instrucțiunilor opțiunii. Blocul NewPostDeliveryOptions este destinat pentru Nova Poshta. Câmpurile sale nu sunt un format universal pentru toți transportatorii.
Meest Poshta prin KeyCRM Crearea și tipărirea AWB-urilor (TTN) în CRM. Proprietarul conectează transportatorul în KeyCRM. Managerul creează avizul acolo; adaptorul transmite comanda însăși către Torgsoft pe ruta convenită. Tipărirea documentelor în CRM este disponibilă pentru AWB-urile create de integrarea sa. Numărul AWB Meest nu este transmis ca DeclarationNumber al Nova Poshta.
Rozetka Delivery prin KeyCRM AWB și documente de livrare în CRM. Proprietarul configurează transportatorul, managerul procesează livrarea în CRM. Dezvoltatorul salvează tracking ID în jurnalul de legătură cu comanda. Livrarea în CRM și expedierea contabilă în Torgsoft se reconciliază separat. Această rută nu adaugă scrierea automată a unui AWB terț într-un document arbitrar Torgsoft.
InPost Procesarea expedierii de către un adaptor terț. Proprietarul obține acces la API-ul pieței necesare. Dezvoltatorul transmite datele adresei, punctul de ridicare și parametrii coletului, primește eticheta și tracking ID. Utilizați API-ul și contractul țării respective. Urmărirea este salvată în adaptor, site sau CRM; înregistrarea în Torgsoft se convine separat.
DHL Express Expedieri și etichete prin MyDHL API. Proprietarul pregătește contul și contractul. Dezvoltatorul transmite adresa, greutatea, dimensiunile, serviciul și datele vamale pentru expedierea internațională. Sunt necesari parametrii reali ai ambalajului. Fișierul de produse Torgsoft în sine nu conține toate datele pentru documentația de transport și vamală.

Câmpurile Nova Poshta care trebuie mapate

În NewPostDeliveryOptions, se transmit RecepientType, Numele complet și telefonul. Pentru livrarea la sucursală se utilizează WarehouseRef sau orașul și numărul sucursalei. Dacă se transmite WarehouseRef, orașul și numărul sucursalei nu sunt necesare pentru această căutare. Pentru livrarea la adresă se completează câmpurile corespunzătoare pentru stradă, clădire și apartament.

Dacă este completat DeclarationNumber, celelalte câmpuri din acest bloc sunt ignorate: se utilizează AWB-ul (TTN) existent. Încărcarea acestuia este prevăzută pentru importul cu un aviz de însoțire a mărfii la ieșire — SaleType 3 sau 4 — sau după generarea unei facturi dintr-o precomandă. Integratorul verifică acest proces în scenariul său.

10. Analitică și automatizare a fișierelor

Către serviciul analitic se transmite un set definit de date: catalog, stocuri, clienți sau un raport exportat. Dezvoltatorul și analistul convin asupra denumirilor câmpurilor, datei instantaneului (snapshot), valutei și perioadei. Fișierul de produse nu se folosește ca sursă pentru istoricul complet al vânzărilor.

ServiciuScenariuImplementareVerificări
Google Sheets Tabele cu produse, prețuri, stocuri sau rapoarte. Dezvoltatorul citește fișierul convenit și scrie datele prin Sheets API. Proprietarul acordă acces utilizatorului necesar sau service account. Adăugați timpul de actualizare, separați coloanele manuale. Nu transmiteți date personale într-un tabel public. Editarea tabelului nu modifică automat Torgsoft.
Microsoft Power BI Model din CSV și alte exporturi pregătite. Analistul creează modelul; dezvoltatorul organizează primirea regulată a fișierelor. Administratorul configurează sursa și, dacă este necesar, gateway-ul. Programul depinde de locația fișierelor și de licență. Stabiliți dacă raportul conține un snapshot sau operațiuni pe o perioadă; evitați adăugarea repetată a acelorași vânzări.
Looker Studio Rapoarte printr-o sursă pregătită sau conector. Dezvoltatorul încarcă datele în Google Sheets, un depozit de date sau creează un Community Connector. Analistul definește tipurile de câmpuri și valorile (metrics). Pregătiți date agregate la nivelul de detaliere necesar, reguli de stocare în cache și drepturi de acces. Conectorul nu adaugă surse absente în exportul inițial.
GA4, GTM și etichete publicitare Evenimentele magazinului online prin TOM sau CMS. Marketerul definește evenimentele, dezvoltatorul le adaugă în magazin, verifică item IDs și transaction ID. Prin GTM conectează etichetele aprobate. Evenimentul purchase trebuie să sosească o singură dată cu conținutul efectiv al achiziției. Nu înlocuiește documentul contabil și nu conține automat vânzările offline Torgsoft.
Make Orchestrarea citirii fișierelor, conversiei și solicitărilor HTTP. Dezvoltatorul configurează transportul securizat compatibil, procesarea CSV/XML/JSON, stocarea stărilor, gestionarea erorilor și accesul la API-ul platformei. Verificați suportul pentru protocolul necesar și operațiuni în conectori. Legarea modulelor în sine nu oferă maparea GoodID, protecția împotriva duplicatelor și confirmarea importului.
n8n Scenarii de fundal pentru schimb de fișiere și API. Dezvoltatorul implementează workflow-ul, configurează citirea fișierelor sau gateway-ul HTTPS, conversia datelor, jurnalul și reîncercările (retries). Nodul FTP/SFTP și metoda de livrare Torgsoft trebuie să fie compatibile. Dacă modul TLS necesar nu este suportat de nod, se utilizează un gateway securizat. Repornirea workflow-ului nu trebuie să repete importul.

Pentru exportul regulat al raportului, integratorul determină separat metoda sa de formare în Torgsoft. Dezvoltatorul nu planifică accesul automat la nicio dată din baza de date doar pe baza prezenței sincronizării de fișiere.

11. Cum să asigurați fiabilitatea, securitatea și mentenanța

11.1. Stocarea mapărilor separat de numele produsului

Dezvoltatorul creează o stocare permanentă a corespondențelor. Numele produsului se poate schimba, iar codul de bare nu este întotdeauna unic pentru toate înregistrările. Înainte de maparea primară, integratorul verifică directorul; coincidențele neaprobate nu sunt unite automat.

EntitateCe stochează adaptorulDestinație
Baza de date și canalul Codul intern al bazei, platforma, contul de vânzător, magazinul. Separarea ID-urilor numerice identice ale diferitelor baze de date și magazine.
Produs GoodID, SKU, product/listing/offer ID, variant ID. Actualizarea fără echivoc a ofertei și importul unei poziții specifice.
Depozit Centrul de evidență, warehouse/location ID, regula rezervei. Cantitatea corectă pentru canal și descărcarea din centrul corespunzător.
Comandă ID extern, OrderNumber, stare, suma de control (checksum), timp, numele fișierului. Redelivrarea evenimentelor, reconcilierea și controlul duplicatelor.
Plata și livrarea Payment/capture ID, transportator, shipment/tracking ID. Legătura evenimentului financiar sau de transport cu comanda corespunzătoare.

11.2. Definirea unei reguli unice pentru stocuri

Integratorul arată dezvoltatorului ce conține exact cantitatea exportată: stocul fizic sau disponibilitatea deja redusă de rezervele luate în calcul. Dezvoltatorul documentează calculul pentru fiecare canal.

Exemplu de regulă de disponibilitate

Cantitate canal = max(0, cantitate export − rezerve necontabilizate − stoc de siguranță).

În «rezervele necontabilizate» sunt incluse doar comenzile care nu au afectat încă cantitatea exportată. După import și confirmarea rezervei contabile, rezerva externă corespunzătoare este eliminată. Pentru o rezervă deja luată în considerare, deducerea repetată nu se mai aplică.

Pentru un set format din mai multe produse, dezvoltatorul calculează cantitatea de seturi în funcție de compoziția setului. Pentru un produs fracționar, verifică unitatea de măsură și precizia admisă de platformă. Cantitatea zero înseamnă o acțiune convenită cu disponibilitatea, iar ștergerea cardului se efectuează doar conform unei reguli separate.

11.3. Verificarea comenzii înainte de publicarea fișierului

  1. Verificați sursa, contul, ID-ul extern și statusul permis.
  2. Găsiți GoodID pentru fiecare poziție. Pentru un SKU necunoscut, trimiteți toată comanda în coada de corectare.
  3. Verificați cantitatea, unitățile, valuta, prețurile și reducerile. Calculați totalul și comparați-l cu datele platformei.
  4. Conveniți afișarea livrării, a suprataxelor și a cadourilor. Dacă se utilizează un serviciu separat, GoodID-ul acestuia și comportamentul contabil sunt verificate de integrator.
  5. Verificați cumpărătorul, adresa și parametrii transportatorului necesari pentru scenariul ales.
  6. Selectați SaleType conform tabelului aprobat și generați fișierul de schemă suportat de versiunea bazei de date.

Un fișier cu o poziție omisă sau un produs necunoscut nu se publică ca o comandă parțială fără un proces convenit separat. Datele erorii sunt salvate pentru corectare; după aceasta se utilizează același ID extern.

11.4. Protejarea importului de duplicate

Dezvoltatorul creează o cheie unică «canal + cont + ID extern» în jurnal. Un eveniment repetat actualizează starea acestei înregistrări. Înainte de o nouă publicare, adaptorul verifică dacă fișierul a fost deja trimis și dacă documentul este confirmat în Torgsoft.

Stările practice ale jurnalului: primit → verificat → fișier pregătit → publicat → import confirmat. Erorile și înregistrările ce necesită reconciliere se țin separat. Confirmarea ultimei stări se determină prin mecanismul real disponibil al integrării specifice sau prin verificarea angajatului responsabil.

Acceptarea de către serverul FTP, HTTP 200 și ștergerea fișierului nu sunt considerate o confirmare universală a documentului. După un eșec la limita de transmisie, adaptorul oprește republicarea acestei comenzi până la reconciliere. Valoarea însăși a OrderNumber nu este o garanție documentată de protecție împotriva tuturor importurilor repetate.

11.5. Publicarea doar a fișierelor finalizate

Fișierul de intrare pentru produse se citește după finalizarea generării și verificarea structurii. Mesajul POST, programul sau gateway-ul se utilizează conform rutei configurate. Adaptorul controlează integritatea fișierului și respinge înregistrările incomplete.

Rezultatul adaptorului este mai întâi scris într-un director de serviciu, verificat și apoi publicat ca fișier finalizat. Pentru comenzi, fișierul temporar are o extensie pe care importatorul nu o procesează. Redenumirea se efectuează în cadrul sistemului de fișiere sau printr-un mecanism verificat al serverului; atomicitatea acestui pas este verificată de administrator.

Feed-ul de lucru pentru produse este păstrat până la verificarea cu succes a versiunii următoare. Se compară numărul de produse, proporția de stocuri zero, câmpurile obligatorii și dimensiunea fișierului. Pragurile de anomalii se convin cu proprietarul, astfel încât o retragere planificată a sortimentului să nu fie blocată fără explicații.

11.6. Separarea erorilor și a reîncercărilor

  • Autorizare: opriți ruta corespunzătoare, notificați administratorul, reînnoiți accesul conform regulilor platformei.
  • Limita API sau indisponibilitate temporară: salvați sarcina și repetați cu o întârziere controlată și respectarea Retry-After, dacă acesta este transmis.
  • Date incorecte: trimiteți înregistrarea pentru corectare; nu republicați în mod repetat un fișier eronat nemodificat.
  • Rezultat parțial al lotului: citiți răspunsurile pentru fiecare produs și repetați doar operațiunile neexecutate permise.
  • Rezultat nedefinit al importului: reconciliați documentul înainte de repetare.

Monitorizarea arată ultima actualizare reușită, vârsta stocurilor, numărul și vârsta comenzilor netransmise, erorile SKU și confirmările întârziate. Proprietarul desemnează un angajat pentru fiecare tip de notificare. O solicitare API cu un cod HTTP de succes este verificată suplimentar pentru erori de afaceri în corpul răspunsului.

11.7. Protejarea acceselor și a datelor cu caracter personal

  • Pentru FTP-ul Torgsoft, activați SSL/TLS și verificați criptarea efectivă. Interfețele HTTP externe ale adaptorului funcționează prin HTTPS.
  • Păstrați cheile și parolele în setări protejate. Nu le adăugați la URL-urile feed-urilor publice, repository-uri, mesaje și jurnale.
  • Emiteți drepturi minime. Utilizați accese separate pentru mediul de producție și pentru teste.
  • Verificați semnătura webhook-ului și actualitatea autorizării conform instrucțiunilor furnizorului. Salvați evenimentul într-un depozit de încredere înainte de a confirma acceptarea acestuia.
  • Separați directorul public de fișierele clienților, comenzilor, bonusurilor și certificatelor. Limitați perioada de păstrare și accesul angajaților.
  • În jurnale mascați datele de contact și de plată inutile. Transmiterea contactelor pentru publicitate trebuie coordonată cu regulile de consimțământ și dezabonare.

11.8. Verificarea lansării manuale și de fundal separat

Administratorul și integratorul verifică versiunea actuală a Torgsoft, serverul de sarcini automate și bibliotecile furnizate pentru această conexiune. Bibliotecile SSL incompatibile nu sunt înlocuite cu DLL-uri întâmplătoare de pe site-uri terțe.

O comandă de control se lansează manual și prin serviciul efectiv. Se verifică utilizatorul serviciului, drepturile, directoarele, setările de limbă și regionale, accesul la rețea și rezultatul după repornire. Importul manual cu succes nu confirmă funcționarea sarcinii de fundal.

După modificarea versiunii programului, a schemei de fișiere, a prețurilor, a modulelor site-ului sau API-ului, testele cheie sunt repetate. Dezvoltatorul menține versiunile adaptorului și ale contractului de schimb; proprietarul determină persoana responsabilă pentru actualizări.

12. Plan de testare și acceptare a integrării

Cele 30 de zile gratuite ale opțiunii pot fi folosite pentru a verifica schimbul cu serviciul ales. Mai întâi, proprietarul configurează accesele și aprobă scenariul; după aceasta, integratorul activează opțiunea, iar dezvoltatorul lansează adaptorul pregătit. Aprobarea aplicației de către platforma externă, tarifele acesteia și dezvoltarea se iau în considerare separat.

Ce trebuie să fie gata înainte de prima lansare

Rezultatul pregătiriiResponsabilCe trebuie transmis echipei
Volum convenit Proprietarul și integratorul Canalele, direcțiile, câmpurile, depozitele, valutele, acțiunile manuale și criteriile de acceptare.
Acces platformă Proprietarul și dezvoltatorul Contul, permisiunile aplicației, metodele API de lucru, regiunea, limitele și mediul de testare, dacă este oferit.
Schimb Torgsoft Integratorul Versiunea BD, obiectul de sincronizare, exportul real și lista de setări.
Server Administratorul Transportul securizat, permisiunile directoarelor, lansarea serviciului, jurnalul, copia de rezervă și restaurarea.
Mapări Dezvoltatorul și integratorul Produsele/variantele, depozitele, categoriile, statusurile, metodele de plată și livrare.
Scenariu contabil Integratorul și managerul SaleType, sursa prețurilor, plata, rezerva, expedierea, anularea și returul.
Izolarea testării de magazinul de producție

Pentru o copie de testare a bazei de date, dezactivați sau reconfigurați toate sarcinile automate de producție, directoarele de schimb și conexiunile. Verificați trimiterea de SMS-uri, e-mailuri, arhive cloud și lucrul cu transportatorii. Copia nu trebuie să publice stocuri de test în magazinul de producție sau să descarce comenzile acestuia.

Dacă platforma nu oferă un mediu de testare separat, proprietarul aprobă produsele și comenzile de control în contul de producție. Drepturile și sarcinile adaptorului sunt limitate la această listă; modificările masive rămân dezactivate.

Secvența lucrărilor

  1. Verificarea acceselor. Dezvoltatorul execută citirea permisă a catalogului și comenzilor, verifică autorizarea și operațiunile necesare.
  2. Testul catalogului. Integratorul exportă produsele de control; dezvoltatorul verifică cardurile noi și cele existente, variantele, prețurile și cantitatea zero.
  3. Testul comenzii. Dezvoltatorul transmite fișierul; integratorul verifică cumpărătorul, fiecare GoodID, cantitatea, prețul, valuta și documentele create.
  4. Plăți și livrare. Managerul și integratorul verifică tipurile de plată convenite, rezerva, expedierea și AWB-ul (TTN).
  5. Eșecuri și repetări. Echipa testează evenimentele repetate, pierderea accesului, un fișier incomplet, un SKU necunoscut și repornirea serviciului.
  6. Lansare limitată. Proprietarul admite sortimentul și canalul convenit; echipa observă câteva cicluri complete și reconciliază rezultatul.
  7. Acceptare. Proprietarul primește instrucțiunile, jurnalul de teste, accesele la monitorizare și procedura de mentenanță.

Teste de control

TestCe se verificăCriteriul de acceptare
Produs nou și existent Crearea și actualizarea conform rutei convenite. Cardul existent și-a păstrat ID-ul; cel nou are toate câmpurile obligatorii; duplicatul lipsește.
Două mărimi sau culori GoodID, variant ID, prețurile și stocurile. Comanda fiecărei variante creează poziția corectă.
Stoc zero și rezervă Disponibilitatea și tranziția rezervei externe în contabilitate. Produsul indisponibil nu este oferit spre vânzare; rezerva nu se scade de două ori.
Mai multe depozite WarehouseID și mapările location ID. Stocul convenit este publicat; documentul aparține centrului de evidență corect.
Promoție și reducere manuală Prețul efectiv de cumpărare și sursa prețului facturii. Prețurile și totalul corespund politicii convenite, fără recalculări neprevăzute.
Valută și cantitate fracționară Codul valutar, precizia, unitățile și rotunjirea. Toate sumele și cantitățile coincid în ambele sisteme.
Text ucrainean și caractere speciale Codificarea, BOM, ghilimele, separatorii. Numele complet, adresa și pozițiile sunt citite fără distorsiuni sau decalaje ale coloanelor.
SKU necunoscut Integralitatea coșului. Comanda a ajuns în coada de corectare, documentul incomplet nu este creat.
Comandă repetată sau webhook Cheia unică și starea jurnalului. S-a creat un singur set de documente pentru comanda externă.
Paginare și același timp al evenimentelor Integralitatea primirii comenzilor. Toate comenzile de control de pe toate paginile sunt incluse fără omisiuni.
Comandă neplătită și plătită SaleType, contul și momentul plății. Documentele corespund schemei convenite; plata târzie nu a creat o a doua factură.
Anulare și retur Coada de reconciliere și acțiunile managerului. Starea documentelor și stocurilor este reconciliată; responsabilul a confirmat finalizarea.
Adresă și AWB (TTN) existent Transportatorul, destinatarul, sucursala și tracking ID. Avizul de însoțire aparține comenzii corecte; AWB-ul suplimentar nu este creat.
Feed incomplet sau gol Verificarea înainte de publicare. Fișierul eronat este blocat; catalogul de lucru este păstrat.
Eșec la momentul transmiterii Comportamentul jurnalului și recuperarea. Rezultatul nedefinit a fost trimis spre reconciliere; repetarea oarbă lipsește.
Eroare API sau expirarea accesului Repetările, coada și notificările. Înregistrările sunt salvate, responsabilul a primit notificarea, limitele sunt respectate.
Import manual și de fundal Serviciul, directoarele, localizarea (locale) și drepturile. Rezultat identic în ambele moduri și după repornire.
Copie de rezervă și restaurare Starea jurnalului, mapările și configurația. După recuperare, echipa vede înregistrările confirmate și netransmise; duplicarea este exclusă de procesul convenit.

Pentru fiecare test, echipa înregistrează în jurnal rezultatul efectiv, ID-ul extern, OrderNumber și documentul Torgsoft. Un exemplu de JSON și verificarea sintaxei acestuia nu înlocuiesc importul în versiunea instalată a programului.

Înainte de transmiterea în lucru, proprietarul primește lista operațiunilor automatizate, a excepțiilor manuale, intervalele de actualizare și responsabilii. Separat, se fixează tarifele platformelor, opțiunile necesare, termenul de suport al adaptorului, procedura de actualizări și recuperare după eșec.