Daudziem veikaliem preču dati jau kaut kur ir — grāmatvedības vai resursu vadības sistēmā (1C, Horizon, Jumis, Moneo, Erply, Standard Books, Directo un citās) vai vienkārši pašu veidotā izklājlapā. Jautājums parasti skan vienādi: kā panākt, lai veikalā būtu tie paši atlikumi un cenas, kas sistēmā, un lai ar roku ievadītais veikalā netiktu nodzēsts.
Atbilde abos gadījumos ir viena: gan ERP, gan savas noliktavas izklājlapa Integrāciju centrāles (kodā un adresēs — EcomLink) acīs ir parasts piegādātājs.
Šis raksts ir ERP pieslēgšanas pirmā daļa: kurā virzienā dati iet, ko sagatavot pirms piegādātāja formas, ko no ERP jāizvelk, kā fails nonāk pie Integrāciju centrāles un ko tā nedara. Pārējais ir atsevišķos rakstos: kurš lauks kam pieder un kas pasargā veikalā ar roku ievadīto — ERP dati un jūsu dati — kurš lauks kam pieder; ritms, noliktavas, pārbaude un pieteikums atbalstam — ERP ikdienā — ritms, noliktavas un pārbaude. Ja ERP nav, bet ir izklājlapa — Sava noliktava kā piegādātājs — izklājlapa vai Google Sheets.
Īsā atbilde: dati iet tikai vienā virzienā
Integrāciju centrāle no ERP lasa. Tā neraksta ERP sistēmā neko — ne pasūtījumus, ne rezervācijas, ne pārdotos daudzumus.
Ceļš ir trīs soļi, vienmēr tādā secībā:
ERP eksports (fails vai API atbilde) → imports (Integrāciju centrāle ieliek datus savās sagatavošanas tabulās) → veikala atjaunošana (sagatavotais tiek publicēts veikala katalogā).
Valodas fails to pasaka pats, vadības paneļa augšā:
«Krājumu imports ielasa cenu, krājumus un statusu no piegādātāja datu plūsmas sagatavošanas tabulās; lai tos publicētu, palaidiet veikala atjaunošanu.»
Divi apgalvojumi, kas ir spēkā vienmēr: imports veikalā neko nemaina, un veikala atjaunošana datu plūsmu nelasa. Ja ERP mainīja cenu, bet veikalā tā ir vecā, tad vai nu nav bijis imports, vai nav bijusi atjaunošana — nekad kaut kas trešais. Sīkāk: Preču imports un Veikala atjaunošana — fāzes un kas tajās notiek.
Seši vārdi, kas atkārtojas visos četros ERP rakstos
- Sagatavošanas tabulas ir Integrāciju centrāles sava preču kopija — tieši tā, ko redzat ekrānā Produkti. Veikala katalogs tur netiek aiztikts, kamēr nav palaista veikala atjaunošana.
- Sagatavotā rinda ir viena prece no viena piegādātāja šajā kopijā. Divi piegādātāji ar to pašu preci dod divas sagatavotās rindas.
- Fāzes ir soļi, no kuriem sastāv veikala atjaunošana (cenas un atlikumi, apraksti, attēli, jaunās preces un tā tālāk).
- Uzvarētāja izvēle ir tā fāze, kurā starp vairāku piegādātāju rindām izvēlas to vienu, kuras cena un atlikums nonāk veikalā.
- Salīmēšana (sasaiste) ir brīdis, kad divas sagatavotās rindas tiek atzītas par vienu un to pašu preci un piesaistītas vienai veikala precei.
- Parsētāja piespraušana nozīmē piegādātājam fiksēti pieslēgt konkrētu lasītāju, lai imports nemēģina formātu uzminēt pats. To dara sistēmas administrators ekrānā Integrācija.
⚠️ Ja veikalā jau ir preces, pirms jebkāda grafika uzstādīšanas izlasiet sadaļu «Kad ERP sāk barot jau esošu katalogu» rakstā ERP dati un jūsu dati — kurš lauks kam pieder. Nepareizā secībā ERP pieliek savas preces blakus jūsējām, un pēc tam neviens tās neapvieno.
📷 Ekrānattēls: ecomlink/ecomlink — vadības panelis ar vienu ERP piegādātāja rindu; «Krājumu imports» ir ikonpoga ar atvērtu paskaidri, «Palaist veikala atjaunošanu» ir poga ar uzrakstu augšā pa labi
Pirms sākat
ERP pieslēgšana nesākas piegādātāja formā. Pirms tās aizpildīšanas jābūt nokārtotam šim:
- Integrāciju centrāle ir pieslēgta. Kreisajā izvēlnē sadaļā Lietotnes aplikācijai jābūt ar pogu Atvērt, nevis Savienot (aplikācijai ir mēneša maksa). Sk. EcomLink — kas tas ir un kā tas ir iekārtots.
- Izveidots piegādātāja ieraksts. Sadaļā Piegādātāji pievienojiet jaunu ierakstu ar savu Piegādātāja kodu un nosaukumu. Sk. Piegādātāja pievienošana.
- Zināma ERP eksporta adrese un pieejas dati — HTTP(S) vai FTP adrese, faila ceļš, lietotājvārds un parole.
- No ERP puses saņemts paraugfails — viens reāls eksporta fails, ko var apskatīt, pirms tiek uzstādīts grafiks.
- Sagatavotas veikala kategorijas un ražotāji, ar kuriem ERP kategorijas un zīmolus varēs sasaistīt. Sk. Kategoriju sasaiste un Zīmolu sasaiste.
Viss ceļš 7 soļos
- Izveidojiet piegādātāja ierakstu un aizpildiet pirmo cilni (kods, nosaukums, uzcenojums, salīdzināšanas koda avots).
- Cilnē Datu plūsma ierakstiet adresi, faila nosaukumu un pieejas datus.
- Cilnē Importa uzvedība izlemiet, ko ERP drīkst pārrakstīt un vai tas drīkst radīt jaunas preces.
- Palūdziet atbalstam pilno importu (lietotājam tas nav pieejams — sk. «Ko darāt jūs un ko lūdzat atbalstam» rakstā ERP ikdienā — ritms, noliktavas un pārbaude).
- Sasaistiet ERP kategorijas ar veikala gala kategorijām un ERP zīmolus ar veikala ražotājiem.
- Palaidiet veikala atjaunošanu un pārbaudiet rezultātu ekrānā Produkti.
- Tikai tad uzstādiet automātisko grafiku.
Kas Integrāciju centrāles acīs ir ERP
Integrāciju centrāle neatšķir ERP no vairumtirgotāja: abos gadījumos tas ir viens ieraksts sadaļā «Piegādātāji» ar savu kodu, savu datu plūsmas adresi un savām iestatnēm. ERP nav ne atsevišķas sadaļas, ne atsevišķa ekrāna. Ceļi ir divi:
- ERP eksportē standarta formātā. Ja ERP var nolikt XML, CSV, JSON vai XLSX failu ar saprotamām kolonnām, to lasa kāds no četriem standarta parsētājiem (Standard XML, Standard CSV, Standard JSON, Standard XLSX). Šis ir parastais ceļš, un tam nekas nav jāprogrammē.
- ERP runā tikai savā valodā. Tad sistēmas administrators piegādātājam ekrānā Integrācija pieslēdz atsevišķi uzrakstītu parsētāju. Modulī tāds šobrīd ir vienai ERP sistēmai — DIRECTO (Directo ERP XML core); pārējie piespraužamie ir vairumtirgotāju formāti.
Citas ERP sistēmas vārdā nosaukta parsētāja modulī nav. Tas nenozīmē, ka to nevar pieslēgt — tas nozīmē, ka pieslēgšana notiek pa pirmo ceļu vai ar atsevišķu vienošanos par jauna parsētāja izveidi. Ko tas maina pieslēgšanas gaitā un termiņos, sk. EcomLink — kas tas ir un kā tas ir iekārtots, sadaļā «Ko pieslēdzat paši un ko pieslēdz EcomCart».
Sava roku veidota izklājlapa ir pirmais ceļš: to lasa Standard CSV vai Standard XLSX, un neko programmēt nevajag. Sk. Sava noliktava kā piegādātājs — izklājlapa vai Google Sheets.
⚠️ Piegādātāja formas pirmajā cilnē Vispārējie (zobrata ikona) ir lauks Importa formāts ar vērtībām XML / XLSX / CSV / PIM / PIM2 / CUST. Tas ir tikai apzīmējums sarakstam — imports to nelasa. Izvēlieties to, kas atbilst jūsu ERP eksporta failam (XML / XLSX / CSV); PIM, PIM2 un CUST ir vecāki, iekšēji apzīmējumi, un ERP eksportam tos neizvēlas. Ko tiešām lasīs, izšķir ekrāns Integrācija (tikai sistēmas administratoram, zem cilnes «Uzstādījumi») vai automātiskā noteikšana pēc faila satura.
Tajā pašā cilnē Vispārējie atrodas arī Salīdzināšanas koda avots, Atjaunošanas biežums un Pilnā importa biežums, kā arī Cenas piemaksa un Uzcenojuma plāns.
📷 Ekrānattēls: ecomlink/vendor — piegādātāja formas ciļņu rinda ar atzīmētu cilni «Vispārējie» (zobrata ikona) un atvērtu «Importa formāts» izvēlni
Ko no ERP vajag izvilkt
Minimālais komplekts, bez kura prece veikalā neienāk vai nav atrodama:
| Lauks | Nosaukums plūsmā | Kāpēc obligāts |
|---|---|---|
| Preces kods | model |
preces identitāte; pēc tā atpazīst, ka rinda ir tā pati |
| Nosaukums | name (pa valodām: name_lv, name_en, …) |
obligāts vismaz vienā valodā — rindu bez nosaukuma pilnais imports noraida, un tā nenonāk pat sagatavošanas tabulās |
| Cena | price |
paraugfailā pie tā ir piebilde «Cena bez PVN» |
| Atlikums | quantity |
izšķir, vai preci vispār drīkst publicēt |
| Kategorija | categories (līmeņi atdalīti ar >>) |
jāsasaista ar veikala gala kategoriju; bez sasaistes prece netiek pievienota |
| Ražotājs / zīmols | manufacturer |
jāsasaista ar veikala ražotāju; bez tā prece netiek pievienota |
Ļoti ieteicami vēl trīs: mpn, sku, ean. Publicēšanu tie neietekmē, bet tieši no tiem veidojas kods, pēc kura viena un tā pati prece no ERP un no vairumtirgotāja tiek salīmēta vienā veikala precē. Kuru no trim ņemt, izvēlas lauks Salīdzināšanas koda avots (noklusējums MPN). Sasaiste prasa arī sasaistītu zīmolu — precei ar nesasaistītu ražotāju koda nav, un tā nesalīmējas ne ar ko.
Standarta parsētāji saprot vēl virkni lauku — status, unit, min_quantity, izmērus un svaru, title_image, images, attributes, options, specials, discounts. Modulī ir pa vienam paraugfailam katram standarta formātam; komentāri ar paskaidrojumiem (piemēram, «Cena bez PVN» un «Pilnais kategorijas ceļš, atdalīts ar >>») ir XML paraugā, pārējo formātu konvencijas — pavadošajā aprakstā. Palūdziet paraugfailu atbalstam un iedodiet ERP pusei.
🔑 Vissvarīgākā vienošanās ar ERP pusi: lauks, kuru ERP nesūta, ir jāatstāj ārpus eksporta, nevis jāsūta tukšs. Tukša kolonna (vai tukšs elements) nozīmē «notīri šo vērtību»; kolonna, kuras eksportā nav vispār, nozīmē «neaiztiec to, kas jau ir». Tieši šī viena atšķirība visbiežāk nodzēš veikalā ar roku ievadītos datus.
Ko pēdējais imports tiešām atnesa, var pārbaudīt preces kartiņā ekrānā Produkti — blokā Datu plūsma nodrošina: «ko atnesa pēdējais imports; lauks, kura šajā sarakstā nav, ir tāds, ko datu plūsma nesniedz».
📷 Ekrānattēls: ecomlink/product — atvērts «Produkta detaļas» logs ar bloku «Datu plūsma nodrošina»
Kā ERP fails nonāk pie Integrāciju centrāles
Adreses un pieejas dati piegādātāja formas cilnē Datu plūsma ir šie seši lauki: Datu plūsmas URL (HTTP resursdators) vai FTP resursdators (resursdators bez ceļa, piem. example.com), Faila nosaukums (ceļš zem tā, piem. exports/preces.xml) un trīs pieejas datu sloti — Lietotājvārds, Parole, Klienta / organizācijas ID. Turpat, zemāk, ir vēl divi lauki, kas ar adresi nav saistīti: Avota valoda (uz to atsaucas sadaļa «Ja kaut kas nestrādā» rakstā ERP dati un jūsu dati — kurš lauks kam pieder) un zem virsraksta Attēli rūtiņa Kešot attēlus lokāli.
📷 Ekrānattēls: ecomlink/vendor — piegādātāja forma, cilne «Datu plūsma», aizpildīts «Datu plūsmas URL (HTTP resursdators)» un «Faila nosaukums»
Trīs praktiskas sekas:
- Augšupielādes lauka nav. Failu nevar iedot no datora — eksportam jābūt sasniedzamam pa HTTP(S) vai FTP. Ja ERP prot tikai nolikt failu mapē, tā mape jāpublicē (kaut ar lietotājvārdu un paroli).
- Abus adreses laukus vienlaikus aizpildīt nedrīkst — saglabāšana tiek atteikta ar kļūdu: FTP resursdators klusi uzvarētu, un otrs lauks izskatītos dzīvs, nedarot neko.
- Parole formā ir redzama, tāpēc ERP pieslēgšanai veidojiet atsevišķu, tikai lasīšanai domātu lietotāju, nevis lietojiet grāmatveža kontu.
Ja eksports ir vairākos failos, pārējo failu atrašanās vietas norāda cilnē Datu plūsmas konfigurācija. Sk. Datu plūsmas konfigurācija — kā plūsmu lasa.
Ko Integrāciju centrāle nedara
- Nesūta pasūtījumus uz ERP un nesamazina atlikumu ERP pusē pēc pārdošanas. Starp diviem importiem veikals rāda to skaitli, kāds bija pēdējā importā — tāpēc ritms ir svarīgs.
- Neuztur veikala paša atlikuma skaitīšanu. Katra atjaunošana ieraksta daudzumu no sagatavotās rindas, tāpēc ar roku izlabots atlikums Integrāciju centrāles precei pazūd ar nākamo palaišanu; tas jālabo ERP pusē.
- Nepārnes preces no veikala uz ERP. Prece, kas ir tikai veikalā, tur arī paliek.
Ja kaut kas nestrādā
Piegādātāju neizdodas saglabāt: pie FTP resursdatora lauka parādās kļūda, turklāt angliski. Aizpildīti ir abi adreses lauki. Atstājiet vienu — vai nu Datu plūsmas URL (HTTP resursdators), vai FTP resursdators —, otru iztukšojiet un saglabājiet vēlreiz.
Pārējais šajā rakstā kļūdas pats par sevi nerada. Pirmā vieta, kur skatīties, kad imports vai veikala atjaunošana nedod gaidīto, ir sadaļa «Ja kaut kas nestrādā» rakstā ERP ikdienā — ritms, noliktavas un pārbaude — tur ir gan «imports nostrādāja, bet veikalā nav nevienas ERP preces», gan «imports pabeidzas "veiksmīgi", bet nekas netiek sagatavots». Ja dati veikalā tiek pārrakstīti vai parādās dublikāti, sk. ERP dati un jūsu dati — kurš lauks kam pieder; ja pieslēgta ir izklājlapa, nevis ERP, sk. Sava noliktava kā piegādātājs — izklājlapa vai Google Sheets.
Vispārīgā diagnostika, kas neattiecas tikai uz ERP: Ja Integrāciju centrāle nestrādā.