Callback
  • Od trhového stánku k obchodu

  • -

  • Od obchodu k obchodnej sieti

  • -

  • Od maloobchodu k výrobe

Integrácie Torgsoft s e-shopmi, CRM a marketplace platformami

Torgsoft oficiálne podporuje integrácie, ktoré už spoločnosť implementovala a sú popísané v dokumentácii programu a Torgsoft Online Market. Pripojenie iných platforiem môžu vyvíjať integrátori a vývojári tretích strán. Títo vytvárajú službu výmeny, konfigurujú prácu s platformou a zabezpečujú jej podporu.

Pre pripojenia tretích strán sa využívajú existujúce možnosti Torgsoft: export tovarov, cien, skladových zásob a klientskych dát, import nových objednávok, špecializované možnosti a export jednotlivých reportov. Univerzálne otvorené API pre ľubovoľnú správu účtovných dokladov v tejto schéme neexistuje.

Príručka definuje, čo je potrebné pripraviť na každej strane a ako rozdeliť prácu medzi majiteľa obchodu, integrátora a vývojára. V tabuľkách sú samostatne uvedené štandardné pripojenia a scenáre vytvorenia adaptéra tretej strany.

30 dní na otestovanie možnosti a výmeny

Ďalšie možnosti Torgsoft je možné bezplatne aktivovať na 30 dní, najmä «Synchronizáciu s internetovým obchodom». Cesta v programe: Nastavenia → Zoznam ďalších funkcií → Aktivovať na 30 dní. Po aktivácii reštartujte Torgsoft.

Výnimkou je — «Odstránenie štatistík uzavretých období». Pre niektoré možnosti platia demo obmedzenia: napríklad integrácia s Rozetka v skúšobnom režime zahŕňa do XML cenníka až 10 produktov. Prístup k API, predplatné platforiem, hosting a vývoj adaptéra sa vybavujú samostatne. Termín vývoja a schválenia prístupu sa určuje nezávisle od skúšobnej doby.

1. Ako organizovať výmenu a kto za čo zodpovedá

Adaptér — samostatný program alebo modul webu, ktorý konvertuje súbory Torgsoft na požiadavky na API externej služby a pripravuje súbory nových objednávok pre Torgsoft. API platformy poskytuje povolené operácie s jej produktmi, objednávkami alebo kontaktmi. Feed — súbor katalógu, ktorý služba sťahuje prostredníctvom odkazu alebo prijíma cez svoj mechanizmus importu.

Pripojenie pozostáva z dvoch častí. Integrátor konfiguruje export a import v Torgsoft. Vývojár vytvorí alebo nainštaluje kompatibilný modul na strane webu, CRM alebo trhoviska. Aktivácia možnosti poskytuje funkcie Torgsoft v rámci jej dokumentácie; externá služba výmeny vykonáva konverziu dát a pracuje s API vybranej platformy.

ÚčastníkČo pripravujeZa čo zodpovedá
Majiteľ obchodu Účty predajcu, tovar, sklad, menu, pravidlá cien, platieb, rezervácií a expedícií. Prístup k platforme, spoľahlivosť účtovníctva, povolený tovar a dohodnutý postup práce zamestnancov.
Integrátor Torgsoft Možnosti, objekty synchronizácie, polia súborov, centrá evidencie, účty pre platby, plánovač a upozornenia. Nastavenie programu a kontrolu vytvorených dokladov, rezerv, cien a práce úloh.
Vývojár adaptéra Aplikáciu platformy, autorizáciu, mapovanie tovaru, konverziu formátov, log a obnovu. Fungovanie API, úplnosť prenosu, ochranu pred viacnásobným importom a kompatibilitu rozhraní.
Správca servera Adresáre výmeny, práva, šifrovaný prenos, spúšťanie služieb, zálohy a monitorovanie. Prevádzku po reštarte a oddelenie servisných dát od verejných feedov.
Manažér objednávok Kontrolu objednávok, kompletizáciu, potvrdenie platieb, odoslaní, zrušení a vrátení tovaru. Úkony, ktoré zostali manuálne, a zosúlaďovanie výnimiek, ktoré sa nespracovávajú automaticky.

Jedna osoba môže plniť viacero úloh. V technickom zadaní pre každú oblasť je aj tak určený vykonávateľ a výsledok, podľa ktorého sa práca kontroluje.

Smery prenosu dát

SmerMechanizmus TorgsoftAkcia adaptéraHranice scenára
Torgsoft → katalóg CSV/YML a fotografie. Priraďuje tovar, pripravuje polia platformy, aktualizuje karty, ceny a množstvá. Nové karty vyžadujú kategórie, vlastnosti a ďalšie povinné dáta platformy.
Platforma → nová objednávka Import SAL/XML/JSON. Prijíma objednávky, kontroluje položky a vytvára súbor s hodnotou SaleType. Formát určuje vytvorenie objednávky alebo faktúry, platbu a expedíciu podľa stanoveného scenára.
Торгсофт → kontakty TSClients.trs podľa nastavenia. Vyberá povolené polia a prispôsobuje ich štruktúre CRM alebo mailingu. Prítomnosť kontaktu neznamená súhlas s reklamným mailingom.
Торгсофт → analytika Súbor tovarov a export konkrétnych reportov. Nahráva súbory do tabuľky alebo analytického modelu. História predajov nie je súčasťou súboru tovarov. Export každého reportu sa definuje samostatne.
Každá integrácia má definovaný rozsah

Prenos katalógu nezahŕňa prijímanie objednávok. Import novej objednávky neposkytuje univerzálny príkaz na zmenu už vytvorenej faktúry, vrátenie tovaru alebo finančnú operáciu. Pre takéto akcie sa využívajú možnosti konkrétnej štandardnej integrácie alebo samostatný proces v rozhraní Torgsoft.

Tri spôsoby pripojenia

  1. Štandardná integrácia. Majiteľ aktivuje možnosť alebo modul TOM, integrátor ho nakonfiguruje podľa pokynov. Zoznam operácií je určený dokumentáciou pripojenia.
  2. Adaptér tretej strany. Integrátor pripraví súborovú výmenu Torgsoft, vývojár pracuje s API alebo feedom platformy a generuje súbory objednávok.
  3. Pripojenie cez web alebo CRM. Torgsoft si vymieňa dáta s jedným systémom, ktorý má konektory do ďalších kanálov. Vývojár určuje trasu objednávok, zdroj skladových zásob a pravidlá rezervácie pre všetky články.

Pre každý kanál je určená jedna trasa príchodu objednávky do Torgsoft. Napríklad objednávky z trhoviska sa prenášajú priamym adaptérom alebo cez CRM. Súčasný import oboma trasami vyžaduje spoločný mechanizmus na vylúčenie duplikátov.

2. Čo pripraviť v Torgsoft a ako čítať jeho súbory

Základom adaptéra je formát synchronizácie internetového obchodu s Torgsoft. Nastavenia sú popísané v inštrukciách k možnosti. Pred vývojom integrátor odovzdá vývojárovi aktuálny súbor tovarov, nastavenia exportu a číslo verzie databázy.

2.1. Príprava objektu synchronizácie

  1. Aktivovať «Synchronizáciu s internetovým obchodom» a otvoriť Sklad → Synchronizácia s internetovým obchodom.
  2. Vytvoriť objekt s názvom kanála. Vybrať centrá evidencie pre export a centrum, z ktorého sa vystavujú objednávky.
  3. Určiť zdroj ceny pre faktúru: Torgsoft alebo internetový obchod. Pre uloženie nákupnej ceny na platforme začiarknite «Pre tovary na faktúre brať ceny z».
  4. Dohodnúť rezerváciu, spracovanie chýbajúceho množstva a účet alebo pokladňu pre platby.
  5. Nastaviť polia, názvy súborov, kódovanie, prenos klientov a spôsob doručenia fotografií.
  6. Nakonfigurovať adresu výmeny, manuálne preniesť testovacie tovary a stiahnuť jednu objednávku.
  7. Po kontrole zapnúť plánovač a upozornenia pre zodpovedného zamestnanca.

Na karte «Klienti» sa kontroluje vyhľadávanie podľa telefónneho čísla, vytváranie nových klientov a aktualizácia ich údajov. Vývojár prenáša telefón v dohodnutom medzinárodnom formáte. Vyhľadávanie podľa telefónu nenahrádza kľúč objednávky a nechráni pred opakovaným vytvorením dokladu.

2.2. Doručenie súborov: FTP so SSL/TLS alebo adresár webového servera

SpôsobNastavenia TorgsoftPráca správcu a vývojára
FTP so SSL/TLS Adresa servera, prihlasovacie meno, heslo, adresár a «Použiť šifrovanie SSL/TLS». Nakonfigurovať kompatibilný FTP server a TLS. Skontrolovať pasívny režim, práva na zápis, nahrávanie a mazanie. Potvrdiť šifrovanie počas výmeny.
Web-server: informácie Adresár súborov tovarov, klientov a ďalších dát. Tu program tiež hľadá súbory objednávok. Poskytnúť adaptéru prístup k adresáru. Pre externý prístup vytvoriť zabezpečenú bránu; HTTPS a autorizáciu zabezpečuje webový server.
Web-server: fotografie Adresár fotografií z parametrov Torgsoft. Organizovať prístup k obrázkom. Pri tomto spôsobe musia byť fotografie uložené v adresári.

Typ «Web-server» pracuje so súbormi v určenom adresári. Nevytvára univerzálne REST API Torgsoft. SFTP je iný protokol; jeho podpora v Make, n8n alebo na trhovisku neznamená podporu vo vybranom spôsobe doručenia Torgsoft.

Adresáre produktového feedu, objednávok, kontaktov a certifikátov sú oddelené podľa prístupových práv. Za verejnou URL adresou reklamného systému sa umiestňuje iba povolený súbor tovarov a obrázky.

2.3. Tovary, ceny, skladové zásoby a fotografie

TSGoods.trs — je typický názov pre CSV s oddeľovačom ;. Polia, ich názvy, poradie, hlavička a názov súboru sú konfigurovateľné. Alternatívnym formátom je YML, XML-katalóg so zodpovedajúcou štruktúrou tagov.

DátaAkcie integrátoraAkcie vývojára
GoodID Zahŕňa kľúč produktu do exportu. Priraďuje kľúč k produktu alebo variante platformy a posiela ho späť v objednávke. Rozlišuje databázy rôznych obchodov.
Articul, Barcode Kontroluje artikle, čiarové kódy a duplikáty. Používa na primárne priradenie k SKU. Pre import položky tovaru dosadzuje GoodID.
Názov, popis, výrobca, kategórie, dynamické vlastnosti Vyplňuje karty a zahŕňa potrebné polia do súboru. Priraďuje kategórie a vlastnosti ku klasifikátoru platformy. Pridáva povinné dáta, ktoré v exporte chýbajú.
RetailPrice, WholesalePrice, akciové a menové ceny Vyberá typ ceny a zdroj ceny faktúry. Aplikuje menu, prirážku a zaokrúhľovanie kanála. Ukladá skutočnú nákupnú cenu a kontroluje celkovú sumu objednávky.
WarehouseQuantity Kontroluje zahrnutie centier evidencie a rezervácií do súboru. Počíta dostupnosť kanála podľa dohodnutého pravidla. Zohľadnené rezervácie sa neodpočítavajú dvakrát.
WarehouseQuantityForPartner Zahŕňa množstvá podľa centier evidencie. Analyzuje 2=1,000|3=2,000: kód centra a množstvo. Priraďuje kódy k skladom platformy.
ModelGoodID, farba, veľkosť Pripravuje modely a samostatné skladové varianty. Priraďuje každý variant. Veľkosti alebo farby so samostatnými zostatkami ukladá ako samostatné skladové položky.
GoodPhotoList, GoodPhotoListWithLinks Konfiguruje adresár fotografií, názvy súborov a predponu odkazov. Kontroluje URL a požiadavky na obrázky. Pre tieto polia používa stanovený režim ukladania fotografií v adresári.

CSV parser sa nastavuje podľa skutočného exportu: oddeľovač, hlavičky, kódovanie, úvodzovky a čísla. Špeciálne znaky sa testujú na testovom súbore. V režime UTF-8 Torgsoft generuje produktový CSV s BOM — servisnou značkou kódovania na začiatku súboru; adaptér ju musí spracovať.

YML Torgsoftu nie je hotovým feedom pre každú službu. Vývojár kontroluje koreňový element, povinné tagy, vlastnosti, jazyky a ID príjemcu. Napríklad Hotline používa vlastnú štruktúru XML, a trhoviská vyžadujú kódy kategórií a hodnoty vlastností.

2.4. Formát novej objednávky

Torgsoft prijíma textové súbory .sal. Od verzie DB 493 sú podporované aj XML a JSON v UTF-8. Pre SAL sa používa kódovanie objektu synchronizácie; v režime UTF-8 je potrebný BOM. Názov súboru sa skladá z ASCII znakov: latinských písmen, číslic a bezpečných oddeľovačov.

Dáta z API sa konvertujú do schémy Torgsoft: kupujúci prechádza do Client, parametre — do Options, položky — do Goods. Povinné polia: Client.Name, Options.OrderNumber, Options.SaleType a GoodID, Price, Count pre každý tovar.

Príklad JSON s podmienenými dátami pre predobjednávku:

{
  "Client": {
    "Name": "Testovací kupujúci",
    "MPhone": "+380670000000",
    "EMail": "buyer@example.com"
  },
  "Options": {
    "OrderNumber": "SHOP-A-100042",
    "SaleType": "1",
    "OrderDate": "2026-10-05 12:00:00",
    "CurrencyInternationalCode": "UAH",
    "Comment": "Testovacia objednávka externého kanála"
  },
  "Goods": [
    { "GoodID": "201", "Price": "1290.00", "Count": "1" },
    { "GoodID": "202", "Price": "350.00", "Count": "2" }
  ]
}

Pred načítaním integrátor dosadí reálne GoodID z testovacej databázy a skontroluje doklady v programe. Vývojár generuje stabilné OrderNumber z kódu kanála, obchodu a externého ID. Čísla rôznych objednávok a obchodov sa nesmú zhodovať.

Ďalšie polia prenášajú adresu, doručenie, dátum rezervácie, kód meny, druh obchodu a centrum evidencie. Dostupnosť závisí od verzie databázy. WarehouseID sa preberá z Torgsoft; kód skladu trhoviska vyžaduje mapovanie. Účel WarehouseID vo všeobecných parametroch a riadku produktu je popísaný vo formáte výmeny.

PoleFormát a účelČo dohodnúť
Options.OrderDate Dátum objednávky: yyyy-mm-dd hh:mm:ss. Časové pásmo obchodu a konverziu času API na dohodnutý lokálny čas.
Options.ReserveDate Dátum rezervácie: ddmmyyyy, napríklad 05102026. Lehotu rezervácie a správanie po jej uplynutí.
Options.CurrencyInternationalCode Medzinárodný kód meny. Pri absencii poľa prebieha spracovanie v národnej mene. Menu objednávky, nastavenia účtovníctva a kurzy, ak je potrebný prepočet.
Options.SaleForm 1 — veľkoobchod, 2 — maloobchod; chýbajúca alebo nesprávna hodnota znamená maloobchod. Druh obchodu a zdroj cien faktúry.
Options.WarehouseID, Goods[].WarehouseID Centrum evidencie faktúry a centrum odpisu konkrétnej položky tovaru. Reálne kódy centier z Torgsoft a spracovanie objednávky z viacerých skladov.
Options.BonusPay, Options.GiftCertificate Suma platby bonusmi a zoznam čísel použitých certifikátov oddelených čiarkou. Zapnuté možnosti, príslušné nastavenia synchronizácie, kontrolu dostupného zostatku a výsledok odpísania.
Options.DeliveryCondition, Options.DeliveryAddress Podmienka doručenia a textová adresa. Vyplnenie týchto polí a jednotlivých štruktúrovaných parametrov prepravcu.

2.5. SaleType: aké doklady import vytvára

SaleTypeRezultatČo sa kontroluje
1 Predobjednávka, na základe ktorej je možné vytvoriť faktúru. Kto kontroluje objednávku a vystavuje faktúru. Vhodné na prvé testovanie importu.
2 Faktúra so 100% platbou vopred. Plnú platbu, sumu, účet príjmu a nastavenia účtovníctva.
3 Faktúra so 100% platbou vopred a expedíciou, vytvorenie výdajky. Plnú platbu a moment účtovnej expedície. Štatút «zaplatené» nepotvrdzuje odovzdanie zásielky prepravcovi.
4 Faktúra bez platby, s expedíciou a vytvorením výdajky. Dôvod na expedíciu bez platby vopred a následné zúčtovanie platieb.
5 Ihneď faktúra; predobjednávka sa nevytvára. Kto vykonáva platbu, rezerváciu a expedíciu podľa faktúry.

Pre SaleType 2–5 dokumentácia predpokladá prítomnosť celého potrebného množstva v centre evidencie. Pri absencii tovaru môže predaj ísť do mínusu. Pred automatickým vytvorením dokladov sa kontroluje množstvo a pravidlá postupu pri jeho nedostatku.

Komentár «zaplatené» neuskutočňuje platbu. SaleType nevykonáva vrátenie prostriedkov v platobnej službe. Vývojár a integrátor dohodnú udalosť platformy, typ dokladu, účet príjmu a ďalšie kroky zamestnanca.

2.6. Klienti, veľkoobchodné ceny a certifikáty

Podľa nastavení Torgsoft exportuje TSClients.trs: meno, priezvisko a otčestvo (FIO), kontakty, adresu, kartu klienta, zľavu, sumu na jej výpočet a nazbierané bonusy. Vývojár určuje kľúč priradenia a prenáša príjemcovi len potrebné polia. História nákupov nie je súčasťou tohto súboru.

Možnosť «Politika veľkoobchodných cien» pridáva XML s prahovými hodnotami množstva a cenami. Pre certifikáty je určený CSV TSGiftCertificate.trs. Príjemca musí implementovať príslušné pravidlá tvorby cien alebo vernosti.

Použité bonusy a certifikáty sa prenášajú v objednávke cez BonusPay a GiftCertificate. Integrátor aktivuje potrebné možnosti a nastavenia; vývojár pred platbou skontroluje aktuálne dáta podľa dohodnutého procesu. Tím overuje konečné odpísanie v Torgsoft a pravidlá na zrušenie nákupu.

Export bonusov a certifikátov je snímka v čase vytvorenia. Na využitie vernostného programu vo viacerých kanáloch je potrebný dohodnutý proces kontroly a odpísania. Samotný súbor neblokuje opätovné použitie certifikátu v inom obchode.

2.7. Plánovač, POST-správy a potvrdenie importu

Tovary a objednávky môžu mať samostatné úlohy. Integrátor vyberá typ synchronizácie a vykonávateľa: Torgsoft alebo server automatických úloh. Na spustenie programom je potrebný otvorený program na uvedenom počítači pod uvedeným používateľom. Pre prácu na pozadí sa kontroluje služba, jej verzia, práva a prístup k súborom.

Interval sa nastavuje podľa odporúčaní nápovedy: nie častejšie ako raz za 10 minút s ohľadom na ostatné objekty. Vývojár samostatne nastavuje frekvenciu požiadaviek na API. Časté dopytovanie platformy neurýchli import súboru do Torgsoft mimo plánovača.

«Odosielať POST-požiadavku po synchronizácii» informuje web o dokončení výmeny. Vývojár poskytne URL, názov a hodnotu parametra; integrátor ich nastaví v programe. Pre požiadavku sa nastaví konečný časový limit (timeout), povolený User-Agent a presmerovanie. Časový limit 0 znamená neobmedzené čakanie.

Táto správa nie je tokom všetkých udalostí predaja alebo vrátenia. Po nej adaptér číta pripravené súbory. Webhooky externej platformy prijíma vlastný HTTP obslužný program adaptéra.

V FTP scenári sa súbor objednávky stiahne lokálne a odstráni z FTP, potom sa spracuje programom a po úspešnom importe sa odstráni lokálne. Zmiznutie súboru z FTP nepotvrdzuje vytvorenie dokladu. Chybný súbor v lokálnom adresári môže brániť ďalšiemu importu; integrátor kontroluje log a doklady.

3. Štandardné integrácie a možnosti TOM

Pre tieto scenáre sa využívajú funkcie Torgsoft alebo špecializované možnosti. Majiteľ získa prístup v externej službe, integrátor nastaví režim. Podpora pokrýva zdokumentované operácie pripojenia.

SlužbaŠtandardný scenárPríprava a nastaveniePodmienky
Prom.ua Produktová výmena a objednávky cez «Integráciu s Prom.ua». Majiteľ: účet a prístupy. Integrátor: možnosť, objekt, cenník, mapovanie tovarov a vybavovanie objednávok. Skontrolovať varianty, ceny, prepojenie položiek a podporované prechody stavov podľa inštrukcií možnosti.
Rozetka XML cenník a objednávky cez «Integráciu s Rozetka.ua». Majiteľ: účet, karty a prístupy. Integrátor: možnosť, vlastnosti, fotografie, pravidlá prijímania a plánovač. Cenník musí zodpovedať Rozetka. Demo — do 10 produktov. Pred publikovaním skontrolovať úplnosť súboru a jeho spracovanie.
Satu.kz Výmena cez špecializovanú možnosť Satu.kz. Majiteľ: obchod na Satu. Integrátor: prístupy, tovary, ceny, objekt a prijímanie objednávok. Pripojenie Satu a Kaspi sú rôzne scenáre. Pre Kaspi je potrebný samostatný adaptér.
Nova Poshta Prepravné listy (TTN) cez možnosť «Nova Poshta». Majiteľ: účet a API kľúč. Integrátor: odosielateľa, adresy, doručenie a súvisiace doklady. Formát objednávky podporuje NewPostDeliveryOptions a číslo TTN. Podrobnosti sú uvedené v časti o doručení.
Ukrposhta Poštové zásielky predvídané možnosťou. Majiteľ: prístupy. Integrátor: možnosť, odosielateľa, adresy a parametre zásielok. Parametre Nova Poshta sa nepoužívajú pre Ukrposhta. Nastavenie sa vykonáva podľa samostatných pokynov.
Binotel Telefónia a interakcia s klientmi predvídaná možnosťou. Majiteľ: účet a prístup. Integrátor: možnosť, pripojenie a telefóny klientov. Skontrolovať vyhľadávanie klienta a povolenia zamestnancov. Pripojenie telefónie neposkytuje API predajov.
ПриватБанк, monobank, UKRSIBBANK Výpisy cez «Bankové výpisy». Majiteľ: prístup k účtom. Integrátor: účty Torgsoft, spôsob získavania a rozpoznávanie platieb. Účty, meny a autorizácia sa kontrolujú pre konkrétne pripojenie. Výpis a internetový acquiring majú rôzne mechanizmy.
TurboSMS, AlphaSMS SMS cez TurboSMS a AlphaSMS; Viber cez TurboSMS Viber. Majiteľ: účet, zostatok a schváleného odosielateľa. Integrátor: službu, prístupy, šablóny a adresátov. Platia požiadavky poskytovateľa na správy a odosielateľa. Pre reklamu je potrebný náležitý súhlas adresátov.
SendGrid, SMTP Odosielanie e-mailov prostriedkami programu. Majiteľ: poštovú službu a doménu. Integrátor: spôsob odosielania, prístupy a odosielateľa. Skontrolovať doménu, limity, odhlásenia a neplatné adresy. Nastavenie odosielania nezahŕňa všetky funkcie marketingovej služby.
Google Drive Archivácia do cloudového úložiska. Majiteľ: účet a priestor. Integrátor: možnosť archivácie, autorizáciu, obsah archívu a plánovač. Skontrolovať dokončenie kopírovania a obnovu. Archív databázy sa nepoužíva pre operatívne skladové zásoby trhoviska.
M.E.Doc, Art-Zvit Doklady cez predvídané formáty exportu. Účtovník: typ dokladu a rekvizity. Integrátor: príslušný export a import v prijímateľovi. Rozsah je určený typom dokladu. Plná obojsmerná synchronizácia účtovníctva nie je súčasťou tohto scenára.
Webkassa, IS ESF Kazachstanu Špecializované možnosti pre fiškalizáciu a elektronické faktúry. Majiteľ a účtovník: registráciu, rekvizity a prístupy. Integrátor: možnosti a nastavenia. Tieto funkcie majú vlastné požiadavky a nenahrádzajú výmenu tovarov a objednávok s Kaspi.

Dokumentácia: integrácie Torgsoft, nápoveda k programu, bankové výpisy.

Hotové moduly Torgsoft Online Market

Torgsoft Online Market, TOM — platforma internetového obchodu, ktorá funguje spolu s Torgsoft. Prístupy, platby, feedy a externé zdroje sa nastavujú v paneli TOM. Jej integrácie sa týkajú dát obchodu a nevytvárajú API ku všetkým dokladom Torgsoft.

Modul TOMDátaAkcie integrátoraVerificări
KeyCRM Objednávky TOM, kupujúci, tovary, ceny, platby a doručenie; nastavené spätné statusy do TOM. Aktivovať modul; zadať kľúč, ID zdroja, manažéra, doručení, platieb a statusov. Ďalšie kanály KeyCRM vyžadujú samostatnú trasu do Torgsoft. Status v TOM a stav účtovných dokladov sa kontrolujú oddelene.
LiqPay, Portmone, monobank Platba v TOM a odoslanie objednávky podľa vybraného typu. Pripojiť obchodníka, kľúče a «Typ objednávky Torgsoft» pre spôsob platby. Skontrolovať úspešnú platbu, faktúru, sumu a doklad. Úplné bankové údaje platby sa týmto modulom neprenášajú.
Google Merchant Center, Hotline Produktové feedy. Aktivovať feed, zahrnúť kategórie, vyplniť vlastnosti a skontrolovať report o generovaní. Feed musí prejsť kontrolou prijímateľa. Prenos katalógu neznamená schválenie reklamnej kampane.
Google Analytics 4, Google Tag Manager Webová analytika a udalosti obchodu. Uviesť ID zdrojov, nastaviť tagy a skontrolovať udalosti. Skontrolovať transaction ID a duplikovanie purchase. Offline predaje vyžadujú samostatný zdroj dát.

4. Platformy internetových obchodov

Pre CMS je potrebný modul, ktorý mapuje položky webu na tovary Torgsoft, aktualizuje dohodnuté polia a prenáša nové objednávky. Majiteľ poskytne prístup k obchodu a definuje sklad. Integrátor pripraví výmenu súborov. Vývojár nainštaluje kompatibilný konektor alebo vytvorí adaptér k API platformy.

Pred spustením stanovte, kto vytvára karty tovarov a spravuje popisy. Pre už naplnený web je možné prenášať iba ceny a zostatky. Ak karty bude vytvárať adaptér, dodatočne potrebuje kategórie, vlastnosti, varianty, fotografie a pravidlá publikovania.

PlatformaScenárČo pripraviť a urobiťPodmienky a kontroly
Horoshop Katalóg, ceny, skladové zásoby a objednávky cez pripojenie platformy. Majiteľ dohodne pripojenie s Horoshop. Integrátor nastaví možnosť synchronizácie, súbor, fotografie a adresár objednávok podľa požiadaviek konektora. Pred spustením dohodnúť zloženie polí a identifikátor priradenia. Skontrolovať veľkosti, farby, existujúce karty, zľavnené ceny a typ dokladu objednávky.
OpenCart Katalóg a objednávky cez modul výmeny. Majiteľ poskytne verziu CMS a zoznam rozšírení. Vývojár nainštaluje kompatibilný modul alebo pridá obslužný program súborov a úlohy výmeny. Integrátor nakonfiguruje Torgsoft. Štandardné API OpenCart nenahrádza plnohodnotný konektor katalógu. Skontrolovať kompatibilitu s modulom variantov, zľavami, daňami a neštandardným procesom objednávky (checkout).
WooCommerce Tovary, variácie, skladové zásoby a nové objednávky. Vývojár získa REST API kľúče s potrebnými právami, použije tovary, variácie a objednávky wc/v3. Uloží prepojenie GoodID s product/variation ID. Samostatne skontrolovať riadenie zásob rodičovského produktu a variácie, statusy objednávok a opakované doručenie webhooku. Webhooky musia prejsť overením podpisu.
PrestaShop Tovary, kombinácie, zásoby a objednávky cez Webservice. Správca aktivuje Webservice a vydá obmedzený kľúč. Vývojár pracuje so zdrojmi produktov, kombinácií, stock_availables a objednávok. Formát požiadaviek a dostupné zdroje overiť s verziou obchodu. Pri režime viacerých obchodov (multistore) zohľadniť shop ID; zásobu kombinácie aktualizovať podľa jej identifikátora.
Shopify Katalóg, ceny, skladové množstvá a objednávky cez GraphQL Admin API. Majiteľ inštaluje aplikáciu. Vývojár nastaví autorizáciu, povolenia pre produkty, zásoby a objednávky; mapuje varianty, inventory item a location ID. Prístup k údajom kupujúcich a starým objednávkam vyžaduje príslušné povolenia. Skontrolovať verziu API, limity GraphQL a rozdiel medzi dostupným množstvom a inými stavmi zásob.
Wix Stores Katalóg, zásoby a objednávky Wix. Vývojár určí verziu katalógu obchodu, získa povolenia Stores a eCommerce, mapuje varianty a miesta uloženia, použije príslušné Inventory API a Orders API. Polia agregovanej zásoby v objekte produktu môžu byť iba na čítanie (read-only). Aktualizovať množstvo cez určený zdroj; nemiešať modely katalógov V1 a V3.
Ecwid Produkty, kombinácie, množstvo a objednávky. Majiteľ skontroluje dostupnosť API pre obchod. Vývojár získa store ID a token s právami na čítanie objednávok a prácu s katalógom. Priraďovať jednotlivé kombinácie, ukladať ID obchodu spolu s ID objednávky. Skontrolovať statusy platieb, objednávok a obmedzenia plánu.
BigCommerce Katalóg, skladové zásoby a objednávky. Vývojár nastaví API account/OAuth a potrebné scopes. Pre katalóg použije Catalog API, pre sklady — Inventory API, pre objednávky — príslušné Orders API. Zdroje patria do rôznych verzií API. Zohľadniť location ID, varianty, kanály a cenníky; neprenášať jednu cenu na všetky skupiny kupujúcich bez dohody.
Magento / Adobe Commerce Produkty, skladové množstvá a objednávky cez REST API. Správca vytvorí integráciu s potrebnými zdrojmi. Vývojár priradí SKU, website/store scope a inventory sources. V Multi-Source Inventory majú množstvo v source a salable quantity odlišný účel. Zohľadniť rezervácie Magento a neodpočítavať rovnakú rezervu dvakrát.
MODX a individuálny web Katalóg a objednávky cez vlastný modul. Vývojár pridá obslužný program súboru tovarov k skutočnému modulu obchodu, log priradenia a generátor súborov objednávok. Nastaví úlohy na pozadí. MODX sám o sebe nedefinuje jednotný formát košíka a objednávky. Zmluva o výmene je určená pre nainštalovaný komponent obchodu alebo vlastnú databázu webu.

5. Trhoviská a služby inzerátov

Prom.ua, Rozetka a Satu.kz sú rozobraté medzi štandardnými možnosťami. Pre platformy v tejto tabuľke je popísaná práca adaptéra tretej strany. Majiteľ si najprv zaregistruje účet predajcu a prístup k potrebným operáciám. Vývojár skontroluje povolenia aplikácie, požiadavky kategórií, formát ceny a množstva, a integrátor pripraví výmenu Torgsoft.

Prenos iba artiklu, názvu a ceny postačuje na aktualizáciu časti už vytvorených ponúk. Pre publikovanie novej karty sú potrebné všetky povinné atribúty platformy. Chýbajúce dáta v súbore tovarov sa ukladajú v tabuľke zhody alebo v adresároch adaptéra.

SlužbaScenárČo robí vývojárČo kontroluje majiteľ a integrátor
Etsy Aktualizácia listingov, variantov, cien, množstva; prijímanie objednávok. Registruje aplikáciu Open API v3, nastaví OAuth s PKCE a potrebné scopes. Mapuje GoodID s listing/product/variation, pripraví súbor objednávky. Typ prístupu aplikácie, pravidlá povoleného tovaru Etsy, vlastnosti variantov, profily doručenia a mena obchodu. Komerčný prístup na obsluhu iných predajcov sa dohoduje podľa pravidiel Etsy.
eBay Ponuky cez Inventory API, objednávky cez Fulfillment API. Získa seller OAuth, nastaví inventory location, obchodné politiky a SKU. Vytvára alebo aktualizuje inventory items/offers, sťahuje objednávky. Dohodnúť spôsob prenosu existujúcich listingov. Ponuky vytvorené cez Inventory API sa musia obsluhovať jeho operáciami. Skontrolovať trh, menu, doručenie a zostatok každej variácie.
Allegro Ponuky, ceny, dostupnosť a objednávky. Registruje aplikáciu, vykoná OAuth, mapuje produkty k offers, číta checkout forms a udalosti objednávok. Povinné parametre kategórií, katalóg Allegro, dostupné trhy, mena a spôsoby doručenia. Prepojenie produktu s katalógom a publikovanie ponuky sú samostatné operácie.
Amazon Ponuky a zásoby predajcu, prijímanie objednávok cez Selling Partner API. Zaregistruje aplikáciu a roly, nastaví autorizáciu predajcu, väzby SKU/ASIN/marketplace ID a príslušné Listings, Feeds a Orders API. Oddeliť FBM a FBA: lokálna zásoba obchodu nenahrádza zostatky v sklade Amazon. Prístup k osobným údajom vybaviť podľa platných pravidiel príslušného API a roly.
Epicentr Marketplace Katalóg, ceny a skladové zásoby cez XML; objednávky cez API. Pripraví XML podľa požiadaviek Epicentr, kategórie a atribúty. Pomocou tokenu účtu získa objednávky a vytvorí súbory pre Torgsoft. API objednávok nenahrádza produktový XML feed. Testy API vykonávať s ohľadom na prácu v produkčnom prostredí; dohodnúť kontrolnú objednávku a vyhnúť sa hromadným zmenám.
ALLO Marketplace Katalóg, ceny a skladové zásoby cez produktový feed. Skonvertuje export Torgsoft na XML podľa požiadaviek účtu, pridá kategórie, vlastnosti a fotografie, publikuje súbor na stiahnutie. Spôsob prijímania objednávok dohodnúť samostatne cez povolené rozhranie alebo konektor CRM. Produktový feed sám o sebe neprenáša objednávky.
eMAG Katalóg, ponuky, zásoby a objednávky cez Marketplace API. Získa API prístup predajcu, implementuje zdroje produktov/ponúk a objednávok pre požadovaný región. Kategórie, lokalizované dáta, dane a mena regiónu. Spracovať výsledky pre každú položku a správy asynchrónneho spracovania.
Kaufland Global Marketplace Produktové dáta, ponuky a objednávky cez Seller API; import časti dát cez CSV. Nastaví podpísané API požiadavky, storefront a sklady. Mapuje EAN/produkt s units predajcu, získa order units. Vytvorenie produktových dát a ponuky predajcu majú rôzne požiadavky. Skontrolovať výsledok importu CSV po dokončení spracovania, nie len prijatie URL.
Obchod Kaspi Ponuky cez XML; objednávky cez API. Vygeneruje XML cenník s merchant ID, SKU, skladovými dátami a cenami; prijíma objednávky s povoleným tokenom a konvertuje ich do formátu Torgsoft. Prístup predajcu na Kaspi, pravidlá regiónu, mesta a sklady. Štandardná synchronizácia Satu.kz nevykonáva pripojenie na Kaspi.
Kasta Katalóg cez XML a výmena skladových zásob cez rozhrania HUB. Získa od predajcu zmluvu o pripojení pre jeho model spolupráce; nastaví XML a povolené operácie HUB API, mapuje produkty a varianty. Spresniť schému skladov a spôsob prenosu objednávok v účte dodávateľa. Reťazec cez iné CRM vyžaduje samostatnú kontrolu každého smeru výmeny.
OLX Publikovanie a správa inzerátov cez dostupné operácie OLX API. Registruje aplikáciu, získa autorizáciu používateľa, pripraví inzeráty z produktových dát a uloží ich ID. Kategórie, balíky, moderovanie a povolenia účtu. Inzerát nie je objednávka: vybavenie predaja a import do Torgsoft sa určujú samostatne.
Temu Prijímanie objednávok cez povolené metódy Partner API. Zaregistruje aplikáciu a autorizáciu predajcu v požadovanom regióne. Pomocou udelených práv číta zoznam a detaily objednávok, mapuje položky a tvorí import. Pred začatím prác skontrolovať prístup k metódam objednávok a dátam doručenia pre model predajcu. Katalóg a zásoby zahrnúť do úlohy až po schválení príslušných API operácií.
TikTok Shop Produkty a objednávky cez TikTok Shop Open Platform. Zaregistruje aplikáciu, autorizáciu predajcu, podpisovanie požiadaviek a scopes. Pracuje s dostupnými Product a Order API, skladmi a SKU. Obchod musí byť pripustený na podporovaný trh. Skontrolovať požiadavky kategórie, zhodu tovarov, povolenia a regionálne rozdiely API.

Povinné zhody trhoviska

  • Tovar: GoodID Torgsoft → SKU predajcu → ID ponuky a jej variantu. Pre súpravu sa ukladá zloženie a pravidlo prepočtu množstva.
  • Sklad: centrum evidencie → warehouse/location/storefront platformy. Predaje zo skladov trhoviska sa oddeľujú od vlastných.
  • Objednávka: kanál + účet predajcu + externé ID → OrderNumber. Číslo sa používa nemenne pri všetkých opakovaných prijatiach.
  • Cena: mena, dane, akciová a skutočná nákupná cena. Provízia platformy automaticky neznižuje sumu produktov v objednávke.
  • Stav: aké statusy umožňujú import, rezerváciu, platbu, expedíciu a manuálne zrušenie. Statusy rôznych systémov majú vlastný význam.

6. Produktové katalógy a reklamné kanály

Tieto služby prijímajú produktové dáta pre zobrazenie ponúk. Objednávka sa vybavuje vo vyhradenom predajnom kanáli, odkiaľ sa prenáša do Torgsoft. Majiteľ pripraví firemný účet a web; vývojár vytvorí feed alebo použije hotový modul obchodu; marketér skontroluje diagnostiku a reklamu.

SlužbaPripojenieAkcie vykonávateľaPožiadavky
Google Merchant Center Hotový feed TOM alebo adaptér produktového súboru. Vývojár pridá stabilné ID, odkaz na stránku a obrázok, cenu, menu, dostupnosť a identifikátory produktu. Majiteľ nastaví zdroj dát a potvrdí web. Cena a dostupnosť musia zodpovedať stránke a vybaveniu nákupu (checkout). GTIN, značka a ďalšie polia sa vyplňujú podľa požiadaviek konkrétneho produktu. Výsledok sa kontroluje v diagnostike Merchant Center.
Hotline Feed TOM alebo XML podľa špecifikácie Hotline. Vývojár priraďuje kategórie, výrobcov, vlastnosti, ceny, odkazy a podmienky doručenia. Majiteľ pripojí cenník v účte obchodu. YML z inej platformy sa neprijíma ako hotový súbor Hotline bez konverzie. Kontroluje sa mena, produktové URL, povinné polia a výsledok nahratia.
Facebook a Instagram: katalóg Meta cez Shopify Torgsoft → Shopify → oficiálny kanál Facebook & Instagram. Vývojár spravuje katalóg Shopify, majiteľ pripojí firemné zdroje Meta, marketér nastaví katalóg a kampane. Dostupnosť funkcií závisí od krajiny, firemného účtu a pravidiel Meta. Import objednávok sa vykonáva zo Shopify iba pre objednávky, ktoré tam boli reálne vytvorené.
Pinterest Catalogs Feed pre produktový katalóg. Vývojár pripraví súbor podľa špecifikácie Pinterest s odkazmi, cenami a dostupnosťou. Majiteľ nastaví business account, doménu a zdroj. Skontrolovať dostupnosť katalógov pre krajinu a súlad obchodu s požiadavkami Pinterest. Publikovanie produktového pinu nevytvára objednávku v Torgsoft.

Feed sa publikuje kompletne: vývojár skontroluje štruktúru, počet položiek a dostupnosť odkazov, a následne nahradí pracovnú verziu. Prázdny alebo neúplný súbor je zablokovaný až do zistenia príčiny, aby externá služba nestiahla z publikovania aktuálne ponuky.

7. CRM a viackanálové predaje

CRM môže spájať objednávky webov a trhovísk. Pre takúto schému je potrebný samostatný most medzi CRM a Torgsoft. Prítomnosť konektorov ku kanálom v CRM automaticky nenakonfiguruje tento most.

Majiteľ určuje zdroj skladových zásob a postup rezervácie. Vývojár zhromažďuje objednávky, ukladá zdrojový kanál a ID, mapuje produkty a vytvára súbor Torgsoft. Integrátor skontroluje výsledné doklady. Kým objednávka nie je importovaná a neovplyvnila účtovnú zásobu, adaptér alebo CRM ju zohľadňuje v dohodnutej rezervácii kanála.

SlužbaScenárPríprava a implementáciaHranice výmeny
KeyCRM Hotový modul TOM alebo adaptér tretej strany na objednávky z iných zdrojov. Pre TOM integrátor použije modul z časti 3. Pre ostatné kanály vývojár získa API kľúč, určí zdroje, vyberie objednávky, namapuje SKU a pripraví súbory. Štandardný modul TOM obsluhuje popísanú trasu TOM. Statusy iných kanálov, platby a spätné zmeny v Torgsoft sa zahŕňajú do samostatného technického zadania.
SalesDrive Nové objednávky v Torgsoft; skladové zásoby v CRM cez povolený mechanizmus. Majiteľ vydá kľúč s potrebnými právami. Vývojár prečíta zoznam objednávok, aplikuje filtre a stránkovanie, skonvertuje položky. Pre skladové zásoby vyberie zdokumentované XML/API rozhranie. Skontrolovať dostupnosť metód pre tarifu a nastavenia účtu, aktuálne limity a polia formulára. Pri manuálnej zmene objednávky po importe je potrebná procedúra odsúhlasenia.
KeepinCRM Katalóg, ceny a skladové zásoby cez XML. Vývojár vygeneruje XML a nastaví zhodu polí; majiteľ uvedie URL a pravidlá importu v KeepinCRM. Zdokumentovaný automatický XML import sa vykonáva každých 12 hodín. Táto trasa neznamená automatický prenos všetkých objednávok alebo spúšťanie udalostí pohybu skladu počas prepisu zostatkov.
Base / BaseLinker Zásoby v inventory a objednávky z pripojených kanálov. Vývojár získa token, inventory ID, sklady a mapovania produktov. Aktualizuje množstvá, načíta potvrdené objednávky a, ak je zapnutý, denník udalostí. Spracovávať všetky stránky a objednávky s rovnakou časovou pečiatkou (timestamp). Jeden import do Torgsoft na jednu externú objednávku; zmeny po potvrdení spracovávať podľa samostatných pravidiel.
HubSpot Prenos vybraných kontaktných údajov. Vývojár skonvertuje TSClients.trs na požiadavky Contacts API alebo súbor importu. Majiteľ schváli polia a kľúč priradenia; správca vydá prístup. Kontakty automaticky neobsahujú celú históriu nákupov, obchodov (deals) a zostatkov. Pravidlá aktualizácie a ochrana pred duplikátmi sa určujú samostatne.
Pipedrive Synchronizácia dohodnutých polí kontaktov. Vývojár použije aktuálne Persons API, priradí kontakt k externému kľúču a uloží Pipedrive ID. Nevytvárať novú osobu pri každom exporte. Vytváranie obchodov (deals), aktivít a histórie predajov vyžaduje iné zdroje a samostatný scenár.
Zoho CRM Aktualizácia kontaktov cez API. Vývojár nastaví OAuth pre potrebné dátové centrum, povinné polia Contacts a upsert s dohodnutým kľúčom. Skontrolovať Last Name, používateľské polia, pravidlá duplikátov a permissions. Polia s inými formátmi vopred normalizovať.

Ako rozdeliť statusy

Vývojár vedie tabuľku zhody: status CRM, podmienka importu, SaleType a akcia manažéra. Napríklad, potvrdená nezaplatená objednávka môže vytvoriť faktúru bez expedície. Po skutočnej platbe už vytvorenej faktúry manažér alebo samostatný podporovaný mechanizmus zaregistruje platbu. Opakovaný import tej istej objednávky ako novej faktúry je vylúčený.

Zrušenia a vrátenia tovaru po importe sa dostávajú do frontu na odsúhlasenie. Zodpovedný zamestnanec zmení doklady Torgsoft a potvrdí dokončenie operácie. Automatizácia tejto fázy sa zahŕňa len s konkrétnym podporovaným spôsobom práce s dokladom.

8. Mailingy, telefónia a messengery

Pre SMS, Viber, e-maily a telefóniu sa najprv skontrolujú štandardné nastavenia Torgsoft z časti 3. Pre marketingové platformy vývojár použije povolený export kontaktov. Majiteľ určí účel prenosu, právny základ pre zasielanie správ a postup odhlásenia.

SlužbaScenárPráca vývojára a majiteľaKontroly
SendPulse Kontakty pre mailingy cez import alebo API. Vývojár prekonvertuje TSClients.trs na zoznam s potrebnými poliami, nastaví autorizáciu a adresár (address book). Majiteľ dohodne publikum a správy. Uchovávať status súhlasu a odhlásenia. Exportovaný telefón alebo e-mail neznamená súhlas so všetkými komunikačnými kanálmi.
Mailchimp Import alebo aktualizácia publika. Vývojár pripraví CSV alebo využije Marketing API, priradí e-mail a ďalšie polia. Marketér vyberie audience a pravidlá segmentácie. Neobnovovať odber odhlásených kontaktov opakovaným exportom. Dáta e-commerce a udalosti nákupov vyžadujú samostatný zdroj.
Brevo Kontakty, atribúty a zoznamy cez API. Vývojár priraďuje polia, identifikátory a list IDs, vytvára alebo aktualizuje kontakty. Majiteľ nastavuje zoznamy a pravidlá komunikácie. Skontrolovať formáty telefónu, typy atribútov a správanie pri zhode e-mailu a čísla. Odhlásenia a blokovania majú prioritu pred opakovaným importom.
Telegram Bot API Notifikácie adaptéra a štruktúrované objednávky z bota. Vývojár vytvorí bota, zozbiera košík zo známych SKU, množstvo a dáta kupujúceho, vytvorí súbor objednávky. Pre správy použije dohodnuté chat IDs. Voľná správa v chate nie je hotová objednávka. Vyžaduje sa kontrola používateľa, tokenu, webhook, ceny a všetkých položiek. Notifikácie zobrazujú iba udalosti potvrdené adaptérom.
WhatsApp, Instagram, Facebook Messenger cez SendPulse Objednávky zo scenára chatbota cez webhook. Majiteľ pripojí potrebný firemný kanál. Vývojár prijme dáta dokončeného košíka, nájde GoodID a vytvorí súbor pre Torgsoft. Skontrolovať práva firemného účtu, dostupnosť kanála, pravidlá pre správy, šablóny a súhlas. Ľubovoľná korešpondencia s manažérom vyžaduje samostatné spracovanie objednávky.

Webhook messengera prijíma adaptér. Ten skontroluje udalosť, uloží ju do logu a odpovie platforme. Súbor pre Torgsoft sa vytvorí po kontrole objednávky. To umožňuje opätovne spracovať udalosť bez opakovaného vytvorenia dokladu.

Binotel sa používa v rámci štandardného scenára telefónie. Pre prepojenie hovoru s CRM alebo samostatným botom sa určí vlastná trasa a prístupové práva k dátam rozhovorov. Telefónne číslo kupujúceho nie je identifikátorom jeho objednávky.

9. Platby a doručenie

9.1. Online platba a bankový výpis

Moduly TOM pre LiqPay, Portmone a monobank, ako aj štandardné bankové výpisy sú uvedené v časti 3. Pre iný web sa poskytovateľ platieb pripája na strane webu. Vývojár potvrdzuje výsledok platby, a integrátor schvaľuje jej zobrazenie v Torgsoft.

PoskytovateľScenárČo implementovaťPodmienky
WayForPay Platba na webe; import potvrdenej novej objednávky. Majiteľ získa merchant account. Vývojár pripojí platbu, kontrolu podpisu callback, číslo, sumu, menu a konečný status. Stránka úspešného návratu kupujúceho nenahrádza kontrolu platby. Opakovaný callback nesmie opätovne vytvoriť objednávku.
Stripe Platba na webe cez účet Stripe prístupný podniku. Vývojár kontroluje podpis webhooku na pôvodnom tele požiadavky, priraďuje platbu k objednávke a potvrdzuje konečný stav. Majiteľ skontroluje dostupnosť Stripe pre krajinu a firmu. Metódy odloženej platby končia samostatnou udalosťou; vytvorenie platobnej relácie (checkout session) nepotvrdzuje platbu.
PayPal Platba na webe cez firemný účet. Vývojár pripojí checkout, kontrolu webhooku a výsledok skutočného stiahnutia platby — capture. Ukladá payment/capture ID. Schválenie objednávky kupujúcim a dokončené stiahnutie (capture) sú odlišné stavy. Skontrolovať dostupnosť prijímania platieb, menu a sumu.

Ak je nová objednávka prijatá už s potvrdenou plnou úhradou, je možné pre ňu dohodnúť SaleType=2. Pre automatickú účtovnú expedíciu je potrebný samostatne dohodnutý scenár SaleType=3. Ak je už faktúra vytvorená v Torgsoft, neskoršia platba nie je dôvodom na to, aby sa táto objednávka opäť stiahla ako nová.

Čiastočné platby, dobierka, provízie, vrátenia a nezrovnalosti v sumách sa spracovávajú podľa samostatných pravidiel. Integrátor určí účet príjmu, manažér zosúlaďuje sumu predaja s platbou, účtovník — s výplatou od poskytovateľa. Zadržaná provízia a suma prijatá na bankový účet automaticky nemenia cenu zakúpených produktov.

9.2. Prenos dát o doručení

Predajný doklad a prepravný list (TTN) majú rôzny účel. Pre doručenie si majiteľ zriaďuje účet u prepravcu. Vývojár prenáša adresné dáta a externé identifikátory; integrátor určuje, kde sa vytvára TTN a ako ho zamestnanec vidí v Torgsoft.

SlužbaTrasaČo pripraviťHranice scenára
Nova Poshta Štandardná možnosť a dáta NewPostDeliveryOptions v súbore objednávky. Integrátor nastaví účet, odosielateľa a možnosť. Vývojár prenáša príjemcu, typ doručenia, pobočku alebo adresu; pre existujúci TTN — DeclarationNumber. Skontrolovať aktuálne identifikátory pobočiek, telefón a ukrajinské adresné dáta. Import existujúceho TTN má vlastné podmienky, uvedené nižšie.
Ukrposhta Štandardná možnosť Torgsoft. Majiteľ získa prístup k prepravcovi. Integrátor nastaví odosielateľa, adresu, typ zásielky a údaje príjemcu podľa inštrukcií k možnosti. Blok NewPostDeliveryOptions je určený pre Nova Poshta. Jeho polia nie sú univerzálnym formátom pre všetkých prepravcov.
Meest Poshta cez KeyCRM Vytváranie a tlač TTN v CRM. Majiteľ pripojí prepravcu v KeyCRM. Manažér vytvorí prepravný list tam; adaptér prenáša samotnú objednávku do Torgsoft dohodnutou trasou. Tlač dokladov v CRM je dostupná pre TTN vytvorené jej integráciou. Číslo TTN Meest sa neprenáša ako DeclarationNumber pre Nova Poshta.
Rozetka Delivery cez KeyCRM TTN a doklady o doručení v CRM. Majiteľ nastaví prepravcu, manažér vybavuje doručenie v CRM. Vývojár ukladá tracking ID v logu prepojenia s objednávkou. Doručenie v CRM a účtovná expedícia v Torgsoft sa zosúlaďujú oddelene. Táto trasa nepridáva automatický zápis cudzieho TTN do ľubovoľného dokladu Torgsoft.
InPost Spracovanie zásielky externým adaptérom. Majiteľ získa prístup k API požadovaného trhu. Vývojár prenáša adresné dáta, výdajné miesto a parametre zásielky, získa štítok a tracking ID. Používať API a zmluvu konkrétnej krajiny. Sledovanie je uložené v adaptéri, webe alebo CRM; zápis do Torgsoft sa dohaduje samostatne.
DHL Express Zásielky a štítky cez MyDHL API. Majiteľ pripraví účet a zmluvu. Vývojár prenáša adresu, hmotnosť, rozmery, službu a colné dáta pre medzinárodnú zásielku. Sú potrebné reálne parametre balenia. Samotný produktový súbor Torgsoft neobsahuje všetky dáta pre prepravnú a colnú dokumentáciu.

Polia Nova Poshta, ktoré je potrebné namapovať

V NewPostDeliveryOptions sa prenáša RecepientType, FIO a telefón. Pre doručenie na pobočku sa používa WarehouseRef alebo mesto a číslo pobočky. Ak je odovzdaný WarehouseRef, mesto a číslo pobočky pre toto vyhľadávanie nie sú potrebné. Pre doručenie na adresu sa vypĺňajú príslušné polia pre ulicu, budovu a byt.

Ak je vyplnený DeclarationNumber, ostatné polia tohto bloku sa ignorujú: použije sa existujúci TTN. Jeho stiahnutie je určené pre import s odchádzajúcou výdajkou — SaleType 3 alebo 4 — alebo po vytvorení faktúry z predobjednávky. Integrátor kontroluje tento proces vo svojom scenári.

10. Analytika a automatizácia súborov

Do analytickej služby sa prenáša určený súbor dát: katalóg, zostatky, klienti alebo exportovaný report. Vývojár a analytik odsúhlasia názvy polí, dátum snímky (záznamu), menu a obdobie. Súbor tovarov sa nepoužíva ako zdroj kompletnej histórie predaja.

SlužbaScenárImplementáciaKontroly
Google Sheets Tabuľky tovarov, cien, zostatkov alebo reportov. Vývojár načíta dohodnutý súbor a zapisuje dáta cez Sheets API. Majiteľ udelí prístup potrebnému používateľovi alebo service account. Pridať čas aktualizácie, oddeliť manuálne stĺpce. Neprenášať osobné údaje do verejnej tabuľky. Úprava tabuľky automaticky nemení Torgsoft.
Microsoft Power BI Model z CSV a iných pripravených exportov. Analytik vytvorí model; vývojár organizuje pravidelné získavanie súborov. Správca nastaví zdroj a, v prípade potreby, gateway. Rozvrh závisí od umiestnenia súborov a licencie. Určiť, či report obsahuje snímku alebo operácie za obdobie; predísť opakovanému pridaniu tých istých predajov.
Looker Studio Reporty cez pripravený zdroj alebo konektor. Vývojár nahrá dáta do Google Sheets, skladu dát alebo vytvorí Community Connector. Analytik definuje typy polí a metriky. Pripraviť agregované dáta v potrebnej úrovni detailu, pravidlá pre ukladanie do vyrovnávacej pamäte (cache) a prístupové práva. Konektor nepridáva zdroje, ktoré nie sú v pôvodnom exporte.
GA4, GTM a reklamné tagy Udalosti internetového obchodu cez TOM alebo CMS. Marketér definuje udalosti, vývojár ich pridá do obchodu, kontroluje item IDs a transaction ID. Cez GTM pripojí dohodnuté tagy. Udalosť purchase musí prísť len raz so skutočným obsahom nákupu. Nenahrádza účtovný doklad a automaticky neobsahuje offline predaje Torgsoft.
Make Orchestrácia čítania súborov, konverzie a HTTP požiadaviek. Vývojár nastaví kompatibilný zabezpečený transport, parsovanie CSV/XML/JSON, ukladanie stavov, spracovanie chýb a prístup k API platformy. Skontrolovať podporu potrebného protokolu a operácií v konektoroch. Samotné prepojenie modulov nezabezpečuje mapovanie GoodID, ochranu pred duplikátmi a potvrdenie importu.
n8n Scenáre na pozadí pre výmenu súborov a API. Vývojár nasadí workflow, nastaví čítanie súborov alebo HTTPS bránu, konverziu dát, log a opakované pokusy (retries). FTP/SFTP-uzol a spôsob doručenia Torgsoft musia byť kompatibilné. Ak požadovaný režim TLS nie je uzlom podporovaný, použije sa zabezpečená brána. Reštartovanie workflow nesmie opakovať import.

Pre pravidelný export reportu integrátor samostatne určuje spôsob jeho vytvorenia v Torgsoft. Vývojár neplánuje automatický prístup k žiadnym dátam v databáze len na základe existencie súborovej synchronizácie.

11. Ako zabezpečiť spoľahlivosť, bezpečnosť a údržbu

11.1. Ukladať priradenia oddelene od názvu produktu

Vývojár vytvorí trvalé úložisko pre priradenia. Názov produktu sa môže zmeniť a čiarový kód nie je vždy jedinečný pre všetky záznamy. Pred primárnym mapovaním integrátor skontroluje adresár; neschválené zhody sa nezlučujú automaticky.

EntitaČo ukladá adaptérÚčel
Databáza a kanál Interný kód databázy, platforma, účet predajcu, obchod. Oddelenie rovnakých číselných ID rôznych databáz a obchodov.
Tovar GoodID, SKU, product/listing/offer ID, variant ID. Jednoznačná aktualizácia ponuky a import konkrétnej položky.
Sklad Centrum evidencie, warehouse/location ID, pravidlo rezervy. Správne množstvo pre kanál a odpis z príslušného centra.
Objednávka Externé ID, OrderNumber, stav, kontrolný súčet (checksum), čas, názov súboru. Opakované doručenie udalostí, odsúhlasenie a kontrola duplikátov.
Platba a doručenie Payment/capture ID, prepravca, shipment/tracking ID. Prepojenie finančnej alebo prepravnej udalosti s príslušnou objednávkou.

11.2. Definovať jednotné pravidlo pre zostatky

Integrátor ukáže vývojárovi, čo presne obsahuje exportované množstvo: fyzickú zásobu alebo dostupnosť už zníženú o zohľadnené rezervy. Vývojár zdokumentuje výpočet pre každý kanál.

Príklad pravidla dostupnosti

Množstvo kanála = max(0, množstvo exportu − nezohľadnené rezervy − poistná zásoba).

Do «nezohľadnených rezerv» patria iba objednávky, ktoré ešte neovplyvnili exportované množstvo. Po importe a potvrdení účtovnej rezervy sa príslušná externá rezerva odstráni. Pre už zohľadnenú rezervu sa opakované odpočítanie neuplatňuje.

Pre súpravu z niekoľkých tovarov vývojár vypočíta počet súprav podľa zloženia súpravy. Pre zlomkový tovar kontroluje mernú jednotku a povolenú presnosť platformy. Nulové množstvo znamená dohodnutú akciu s dostupnosťou a vymazanie karty sa vykonáva iba podľa samostatného pravidla.

11.3. Skontrolovať objednávku pred publikovaním súboru

  1. Skontrolovať zdroj, účet, externé ID a povolený status.
  2. Nájsť GoodID pre každú položky. V prípade neznámeho SKU poslať celú objednávku do frontu na opravu.
  3. Skontrolovať množstvo, jednotky, menu, ceny a zľavy. Vypočítať súčet a porovnať ho s dátami platformy.
  4. Dohodnúť zobrazenie doručenia, doplatkov a darčekov. Ak sa používa samostatná služba, jej GoodID a účtovné správanie skontroluje integrátor.
  5. Skontrolovať kupujúceho, adresu a parametre prepravcu potrebné pre vybraný scenár.
  6. Vybrať SaleType podľa dohodnutej tabuľky a vygenerovať súbor schémy, ktorú podporuje verzia databázy.

Súbor s vynechanou položkou alebo neznámym tovarom sa nepublikuje ako čiastočná objednávka bez samostatne dohodnutého procesu. Údaje o chybe sa uložia na opravu; po nej sa použije to isté externé ID.

11.4. Chrániť import pred duplikátmi

Vývojár vytvorí v logu jedinečný kľúč «kanál + účet + externé ID». Opakovaná udalosť aktualizuje stav tohto záznamu. Pred novým publikovaním adaptér skontroluje, či už bol súbor prenesený a či je doklad v Torgsoft potvrdený.

Praktické stavy logu: prijaté → skontrolované → súbor pripravený → publikované → import potvrdený. Chyby a záznamy vyžadujúce zosúladenie sa vedú samostatne. Potvrdenie posledného stavu sa určuje na základe skutočného dostupného mechanizmu konkrétnej integrácie alebo overením zodpovedného zamestnanca.

Prijatie FTP-serverom, HTTP 200 a odstránenie súboru sa nepovažujú za univerzálne potvrdenie dokladu. Po zlyhaní na hranici prenosu adaptér zastaví opakované publikovanie tejto objednávky až do zosúladenia. Samotná hodnota OrderNumber nie je zdokumentovanou zárukou ochrany pred všetkými opakovanými importmi.

11.5. Publikovať iba dokončené súbory

Vstupný súbor tovarov sa číta až po dokončení generovania a overení štruktúry. POST správa, plánovač alebo brána sa využívajú v súlade s nastavenou trasou. Adaptér kontroluje integritu súboru a odmieta neúplné záznamy.

Výsledok adaptéra sa najskôr zapíše do servisného adresára, skontroluje sa a následne sa publikuje ako dokončený súbor. Pre objednávky má dočasný súbor príponu, ktorú importér nespracováva. Premenovanie sa vykonáva v rámci súborového systému alebo overeného mechanizmu servera; atomicitu tohto kroku kontroluje správca.

Pracovný produktový feed sa uchováva až do úspešnej kontroly ďalšej verzie. Porovnáva sa počet produktov, podiel nulových zostatkov, povinné polia a veľkosť súboru. Prahy anomálií sa dohodnú s majiteľom, aby nebolo plánované stiahnutie sortimentu zablokované bez vysvetlenia.

11.6. Oddeliť chyby a opakované pokusy

  • Autorizácia: zastaviť príslušnú trasu, informovať správcu, obnoviť prístup podľa pravidiel platformy.
  • Limit API alebo dočasná nedostupnosť: uložiť úlohu a zopakovať ju s riadeným oneskorením a dodržaním Retry-After, ak bol odovzdaný.
  • Nesprávne dáta: poslať záznam na opravu; nezmenený chybný súbor opakovane nepublikovať.
  • Čiastočný výsledok dávky: prečítať odpovede pre každý produkt a zopakovať iba povolené nevykonané operácie.
  • Nedefinovaný výsledok importu: zosúladiť doklad pred zopakovaním.

Monitorovanie ukazuje poslednú úspešnú aktualizáciu, vek zostatkov, počet a vek neprenesených objednávok, chyby SKU a oneskorené potvrdenia. Majiteľ určí zamestnanca pre každý typ upozornení. API požiadavka s úspešným HTTP kódom sa dodatočne kontroluje na obchodné chyby v tele odpovede.

11.7. Chrániť prístupy a osobné údaje

  • Pre FTP Torgsoft zapnúť SSL/TLS a skontrolovať skutočné šifrovanie. Externé HTTP rozhrania adaptéra fungujú cez HTTPS.
  • Kľúče a heslá uchovávať v chránených nastaveneniach. Nepridávať ich do URL verejných feedov, repozitárov, správ a logov.
  • Vydávať minimálne práva. Používať samostatné prístupy pre produkčné prostredie a pre testovanie.
  • Kontrolovať podpis webhooku a aktuálnosť autorizácie podľa pokynov poskytovateľa. Zapísať udalosť do spoľahlivého úložiska pred potvrdením jej prijatia.
  • Oddeliť verejný adresár od súborov klientov, objednávok, bonusov a certifikátov. Obmedziť dobu uchovávania a prístup zamestnancov.
  • V logoch maskovať zbytočné kontaktné a platobné údaje. Prenos kontaktov na reklamu koordinovať s pravidlami súhlasu a odhlásenia.

11.8. Kontrolovať manuálne a spustenie na pozadí samostatne

Správca a integrátor kontrolujú aktuльную verziu Torgsoft, server automatických úloh a knižnice dodávané pre toto pripojenie. Nekompatibilné knižnice SSL sa nenahrádzajú náhodnými DLL z cudzích webov.

Kontrolná objednávka sa spustí manuálne a cez skutočnú službu. Skontroluje sa používateľ služby, práva, adresáre, jazykové a regionálne nastavenia, prístup do siete a výsledok po reštarte. Úspešný manuálny import nepotvrdzuje prácu úlohy na pozadí.

Po zmene verzie programu, schémy súborov, tvorby cien, modulov webu alebo API sa kľúčové testy opakujú. Vývojár spravuje verzie adaptéra a zmluvy o výmene; majiteľ určuje zodpovednú osobu za aktualizácie.

12. Plán testovania a prevzatia integrácie

Bezplatných 30 dní možnosti je možné využiť na kontrolu výmeny s vybranou službou. Najprv majiteľ zriadi prístupy a schváli scenár; potom integrátor aktivuje možnosť a vývojár spustí pripravený adaptér. Schválenie aplikácie externou platformou, jej tarify a vývoj sa posudzujú samostatne.

Čo musí byť pripravené pred prvým spustením

Výsledok prípravyZodpovednýČo odovzdať tímu
Dohodnutý rozsah Majiteľ a integrátor Kanály, smery, polia, sklady, meny, manuálne akcie a kritériá prevzatia.
Prístup platformy Majiteľ a vývojár Účet, povolenia aplikácie, funkčné API metódy, región, limity a testovacie prostredie, ak je k dispozícii.
Výmena Torgsoft Integrátor Verziu DB, objekt synchronizácie, skutočný export a zoznam nastavení.
Server Správca Zabezpečený transport, práva k adresárom, spustenie služby, log, zálohu a obnovu.
Zhody (Mapovania) Vývojár a integrátor Produkty/varianty, sklady, kategórie, statusy, spôsoby platby a doručenia.
Účtovný scenár Integrátor a manažér SaleType, zdroj cien, platbu, rezervu, expedíciu, zrušenie a vrátenie tovaru.
Izolovať testovanie od produkčného obchodu

Pre testovaciu kópiu databázy vypnite alebo prenastavte všetky produkčné automatické úlohy, adresáre výmeny a pripojenia. Skontrolujte odosielanie SMS, e-mailov, cloudové archívy a prácu s prepravcami. Kópia nesmie publikovať testovacie zostatky do produkčného obchodu alebo sťahovať jeho objednávky.

Ak platforma neposkytuje samostatné testovacie prostredie, majiteľ schváli kontrolné produkty a objednávky v produkčnom účte. Práva a úlohy adaptéra sú obmedzené na tento zoznam; hromadné zmeny zostávajú vypnuté.

Postupnosť prác

  1. Kontrola prístupov. Vývojár vykoná povolené čítanie katalógu a objednávok, skontroluje autorizáciu a potrebné operácie.
  2. Test katalógu. Integrátor exportuje kontrolné produkty; vývojár skontroluje nové a existujúce karty, varianty, ceny a nulové množstvo.
  3. Test objednávки. Vývojár odošle súbor; integrátor skontroluje kupujúceho, každé GoodID, množstvo, cenu, menu a vytvorené doklady.
  4. Platby a doručenie. Manažér a integrátor skontrolujú dohodnuté typy platieb, rezervu, expedíciu a TTN.
  5. Zlyhania a opakovania. Tím otestuje opakované udalosti, stratu prístupu, neúplný súbor, neznáme SKU a reštart služby.
  6. Obmedzené spustenie. Majiteľ pripustí dohodnutý sortiment a kanál; tím sleduje niekoľko úplných cyklov a zosúlaďuje výsledok.
  7. Prevzatie. Majiteľ dostane inštrukcie, denník testov, prístupy k monitoringu a postup údržby.

Kontrolné testy

TestČo sa kontrolujeKritérium prevzatia
Nový a existujúci tovar Vytvorenie a aktualizácia podľa dohodnutej trasy. Existujúca karta si zachovala ID; nová má všetky povinné polia; duplikát chýba.
Dve veľkosti alebo farby GoodID, variant ID, ceny a zásoby. Objednávka každého variantu vytvorí správnu položku.
Nulový zostatok a rezerva Dostupnosť a prechod externej rezervy do účtovnej. Nedostupný tovar sa neponúka na predaj; rezerva sa neodpočítava dvakrát.
Viacero skladov WarehouseID a zhody s location ID. Publikuje sa dohodnutá zásoba; doklad patrí správnemu centru evidencie.
Akcia a manuálna zľava Skutočná nákupná cena a zdroj ceny faktúry. Ceny a súčet zodpovedajú dohodnutej politike, bez nepredvídaného prepočtu.
Mena a zlomkové množstvo Kód meny, presnosť, jednotky a zaokrúhľovanie. Všetky sumy a množstvá sa zhodujú v oboch systémoch.
Ukrajinský text a špeciálne znaky Kódovanie, BOM, úvodzovky, oddeľovače. FIO, adresa a položky sú načítané bez skreslenia alebo posunu stĺpcov.
Neznáme SKU Úplnosť košíka. Objednávka sa dostala do frontu na opravu, neúplný doklad nie je vytvorený.
Opakovaná objednávка alebo webhook Unikátny kľúč a stav logu. Bola vytvorená jedna súprava dokladov pre externú objednávku.
Stránkovanie a rovnaký čas udalostí Úplnosť prijatia objednávok. Všetky kontrolné objednávky zo všetkých stránok sú zahrnuté bez vynechania.
Nezaplatená a zaplatená objednávka SaleType, účet a moment platby. Doklady zodpovedajú dohodnutej schéme; neskorá platba nevytvorila druhú faktúru.
Zrušenie a vrátenie Front na zosúladenie a akcie manažéra. Stav dokladov a zostatkov je zosúladený; zodpovedná osoba potvrdila dokončenie.
Adresa a existujúci TTN Prepravcu, príjemcu, pobočku a tracking ID. Prepravný list patrí k správnej objednávke; nadbytočný TTN nie je vytvorený.
Neúplný alebo prázdny feed Kontrolu pred publikovaním. Chybný súbor je zablokovaný; pracovný katalóg je zachovaný.
Zlyhanie v momente prenosu Správanie logu a obnova. Nedefinovaný výsledok bol presmerovaný na zosúladenie; slepé opakovanie chýba.
Chyba API alebo vypršanie prístupu Opakovania, front a notifikácie. Záznamy sú uložené, zodpovedná osoba dostala správu, limity sú dodržané.
Manuálny a import na pozadí Službu, adresáre, locale a práva. Rovnaký výsledok v oboch režimoch a po reštarte.
Záloha a obnova Stav logu, priradenia a konfiguráciu. Po obnove tím vidí potvrdené a neprenesené záznamy; duplikácia je vylúčená dohodnutým procesom.

Pre každý test tím zapisuje do logu skutočný výsledok, externé ID, OrderNumber a doklad Torgsoft. Príklad JSON a kontrola jeho syntaxe nenahrádzajú import v nainštalovanej verzii programu.

Pred odovzdaním do prevádzky majiteľ dostane zoznam automatizovaných operácií, manuálnych výnimiek, intervalov aktualizácie a zodpovedných osôb. Samostatne sa fixujú tarify platforiem, potrebné možnosti, lehota podpory adaptéra, postup aktualizácií a obnovy po zlyhaní.