Šajā rakstā ir piegādātāja formas cilne **Datu plūsma**: kā uzrakstīt plūsmas adresi un faila
nosaukumu, kādus pieejas datus kur ievada, kā pārbaudīt, vai plūsma tiešām strādā, un kas notiek ar
lejupielādēto failu. Par to, *kā* šo plūsmu pēc tam lasa — pavadošie faili, parsētāja opcijas,
lapošana, formāta noteikšana — ir otrā daļa:
[Datu plūsmas konfigurācija — kā plūsmu lasa](/hc/help2/articles/ecomlink-datu-plusmas-konfiguracija).

Piegādātāja formā (**Integrāciju centrāle → Piegādātāji →** zīmuļa poga) ir divas cilnes, kas atbild uz diviem
dažādiem jautājumiem:

- **Datu plūsma** — *no kurienes* fails tiek ņemts un *ar kādiem pieejas datiem*;
- **Datu plūsmas konfigurācija** — *kā* šo plūsmu lasa: kur atrodas pavadošie faili, kādas opcijas
  parsētājam ir uzstādītas.

Divi vārdi, kas rakstā atkārtojas:

- **Parsētājs** ir lasītājs, kas tieši šī vairumtirgotāja failu pārvērš precēs. Piegādātājam to
  piesprauž sistēmas administrators ekrānā **Integrācija** — sk.
  [Atbalstītie formāti un parsētāja izvēle](/hc/help2/articles/ecomlink-atbalstitie-formati-un-parseri).
- **Pavadošie faili** ir papildu faili blakus galvenajam: **Cenu lapa**, **Krājumu fails**,
  **Kategoriju koks**, **Vērtību apzīmējumi**, **Attēlu saraksts**. Tos norāda cilnē **Datu plūsmas
  konfigurācija**. Piegādātājam, kura plūsma ir viens fails, tādu nav.

Abas cilnes saglabā **viena un tā pati disketes poga** panelī augšā — tā iesniedz visu formu
neatkarīgi no tā, kura cilne ir atvērta.

## Pirms sākat

1. **Piegādātājs ir izveidots un vismaz vienreiz saglabāts.** Kamēr tā nav, cilnē **Datu plūsmas
   konfigurācija** ir tikai paziņojums «Vispirms saglabājiet piegādātāju…» — sk.
   [Piegādātāja pievienošana — sagatavošanās un pamatdati](/hc/help2/articles/ecomlink-piegadataja-pievienosana).
2. **Jums ir zināma plūsmas adrese un pieejas dati.** Tos dod vairumtirgotājs, nevis Integrāciju centrāle.
3. **Ja vairumtirgotājam ir savs parsētājs, tas ir piesaistīts.** Operators to izdarīt nevar: ekrāns
   **Integrācija** ir pieejams tikai sistēmas administratoram. Ja neesat pārliecināts, uzrakstiet
   atbalstam pieteikumu un norādiet piegādātāja kodu, vairumtirgotāja nosaukumu un plūsmas adresi.

## Cilne «Datu plūsma» — kur atrodas fails

Šeit dzīvo piegādātāja **kopējie** pieejas dati — tie, ko izmanto visi šī piegādātāja faili.
(Atsevišķam failam vai galvenei parsētājs var piedāvāt savus pieejas datus cilnē **Datu plūsmas
konfigurācija**; to pašu saka arī paskaidrojums, kas otrajā cilnē ir virs iestatījumu tabulas.)

1. Atveriet piegādātāju: **Integrāciju centrāle → Piegādātāji →** zīmuļa poga vajadzīgajā rindā.
2. Cilnē **Datu plūsma** aizpildiet **vai nu Datu plūsmas URL (HTTP resursdators)**, **vai FTP
   resursdators** — nekad abus.
3. Laukā **Faila nosaukums** ierakstiet galvenā faila ceļu zem resursdatora, piem.
   `exports/feed.xml`.
4. Ja piegādātājs prasa pieejas datus, aizpildiet **Lietotājvārds** un **Parole** (un **Klienta /
   organizācijas ID**, ja piegādātājs to prasa).
5. Ja piegādātājs raksta aprakstus citā valodā, ierakstiet to laukā **Avota valoda**.
6. Nospiediet **disketes pogu** panelī augšā pa labi.
7. Pārbaudiet rezultātu — sk. sadaļu «Kā pārbaudīt, vai plūsma strādā».

| Lauks | Ko tajā raksta |
|---|---|
| **Datu plūsmas URL (HTTP resursdators)** | Resursdators bez ceļa, piem. `example.com`; ja shēma nav norādīta, tiek pieņemts `https://`. (Vai vesels URL — sk. sadaļu «Divi veidi, kā uzrakstīt adresi».) |
| **FTP resursdators** | Resursdators bez ceļa, piem. `ftp.example.com`; tiek pieņemts `ftp://`. Ja tas ir aizpildīts, to izmanto **Datu plūsmas URL** vietā |
| **Faila nosaukums** | Galvenā faila ceļš zem resursdatora, piem. `exports/feed.xml` |
| **Lietotājvārds** | Piegādātāja lietotājvārds |
| **Parole** | Piegādātāja parole vai atslēga |
| **Klienta / organizācijas ID** | Trešais pieejas datu slots (Action.pl `ActionCustomerId`, ALSO klienta ID). Aizpildiet **tikai tad, ja piegādātājs to tiešām prasa**; pārējiem atstājiet tukšu |
| **Avota valoda** | Divu burtu kods — valoda, **kādā raksta piegādātājs**, piem. `pl`, `de`, `lt` |
| **Attēli → Kešot attēlus lokāli** | Rūtiņa. Ieslēgta — imports lejupielādē piegādātāja attēlus veikala krātuvē (aizņem vietu uz diska un pagarina importu). Izslēgta — attēli netiek lejupielādēti. Jaunam piegādātājam tā ir **izslēgta**. Tas attiecas tikai uz attēliem, nevis uz to, kuras preces tiek importētas |

**Vienu resursdatoru, nevis abus.** Ja ir aizpildīts gan **Datu plūsmas URL**, gan **FTP
resursdators**, saglabāšana tiek **atteikta** ar kļūdu (tā ir angliski):
*«Set either the Feed URL or the FTP host, not both…»*. Iemesls: importā FTP uzvar bez jebkāda
brīdinājuma, tāpēc piegādātājs, kas pārcelts no FTP uz HTTP, klusi vilktu veco failu.

**Parole ir redzama ekrānā.** Lauks **Parole** ir parasts teksta lauks, nevis maskēts. Atverot
piegādātāja formu, tā ir salasāma ikvienam, kas tajā brīdī skatās monitorā. (Cilnē **Datu plūsmas
konfigurācija** paroles rindas turpretī ir maskētas.)

⚠️ **Avota valodas laukā vietturis ir `lv`, bet tas NAV noklusējums.** Pelēkais `lv` ir tikai
piemērs tukšā laukā. Ierakstiet valodu, kādā raksta **piegādātājs** (`pl`, `de`, `lt`). Ja
piegādātājs raksta latviski, atstājiet tukšu vai ierakstiet `lv`. Sk. arī
[Mašīntulkošana — divi veidi un lauks «Avota valoda»](/hc/help2/articles/ecomlink-masintulkosana).

**Avota valodas maiņai ir blakusefekts.** Nomainot **Avota valodu** un saglabājot, visām šī
piegādātāja ar veikalu sasaistītajām precēm tiek ierindota apraksta pārbūve. Tas ir apzināti, bet
nozīmē, ka lauku nevajag «pamēģināt».

> 📷 **Ekrānattēls:** ecomlink/vendor — piegādātāja forma ar visām sešām cilnēm, aktīva cilne «Datu plūsma» ar aizpildītu resursdatoru, faila nosaukumu un pieejas datiem

## Kā pārbaudīt, vai plūsma strādā

**Formā nav pogas «Testēt».** Saglabāšana pārbauda tikai adreses **pierakstu**, nevis savienojumu:
tā nezina ne to, vai resursdators atbild, ne to, vai parole ir pareiza. Vienīgais veids, kā to
uzzināt, ir palaist importu.

1. Atveriet **Integrāciju centrāle → Vadības panelis**.
2. Šī piegādātāja rindā nospiediet **Krājumu imports** (lejupvērstās bultiņas poga) un
   apstipriniet. Darbs aiziet fonā; rindā parādās progresa josla.
3. Kad tas beidzies, paskatieties **statusa punktu** kolonnā **Pēdējais imports**. **Pabeigts**
   (zaļš) nozīmē, ka fails tika paņemts un nolasīts; **Kļūda** (sarkans) nozīmē, ka palaišana
   nokrita. Uzbraucot ar peli, atveras kartīte ar detaļām.
4. Sistēmas administrators to pašu redz precīzāk ekrānā **Žurnāli** ([Žurnāli — ekrāns un izpilžu
   rindas](/hc/help2/articles/ecomlink-zurnali-un-diagnostika)): blokā **Importa un veikala atjaunošanas izpildes** atrodiet šīs
   palaišanas **FINISH** rindu un skatieties `status=` un skaitītājus, bet blokā **Žurnāla
   ziņojumi** — brīdinājumus un kļūdas. Ekrāns ir pieejams **tikai sistēmas administratoram**;
   pārējiem šeit jāraksta atbalstam.

Ko rāda skaitītāji FINISH rindā:

- `inserted=0 updated=0 skipped=<liels skaitlis>` — **plūsma ir nolasīta līdz galam** (tātad adrese
  un pieejas dati strādā), bet neviena prece vēl nav sagatavota. Tā ir normāla pirmā palaišana:
  tālāk vajadzīgs **Pilnais imports**, ko var palaist sistēmas administrators.
- `status=error` — palaišana nokrita; cēlonis ir turpat rindā laukā `error="…"`. Lejupielādes
  kļūdās tur ir **piegādātāja paša atbildes teksts**.

## Divi veidi, kā uzrakstīt adresi

| Veids | Kā izskatās | Kad der |
|---|---|---|
| **Resursdators + ceļš** (noklusējums) | **Datu plūsmas URL** = `example.com`, **Faila nosaukums** = `exports/feed.xml` | vienmēr; vienīgais, kas der piegādātājam ar pavadošajiem failiem |
| **Vesels URL** | **Datu plūsmas URL** = `https://api.example.com/feed?doc=1`, **Faila nosaukums** tukšs | tikai vienfaila piegādātājam |

Vesela URL režīms ieslēdzas **tikai tad**, ja izpildās visi **četri** nosacījumi:

1. **Faila nosaukums** ir tukšs;
2. adresē ir ceļš vai vaicājums;
3. adrese **pati nosauc savu shēmu** — `https://` vai `ftp://`;
4. šim piegādātājam neviens pavadošais fails nav norādīts kā ceļš zem resursdatora (t. i., tie ir
   vai nu pilni URL, vai to nav vispār).

⚠️ **Shēma veselam URL ir jāraksta pašam.** Pieņemtā shēma (`https://` HTTP laukam, `ftp://` FTP
laukam) attiecas **tikai uz kailu resursdatoru**. Ierakstot `api.example.com/feed?doc=1` bez
`https://`, saglabāšana tiek atteikta ar paskaidrojumu, ka veselam URL jānosauc sava shēma.

Ekrāna palīgteksts pie lauka **Datu plūsmas URL** min tikai resursdatoru — vesela URL režīms tajā
nav aprakstīts, bet strādā, ja izpildās visi četri nosacījumi augstāk.

**Kad saglabāšana tiek atteikta un kad ne.** Atteikums — apzināti skaļš — notiek tikai tad, ja
adrese **satur ceļu vai vaicājumu**, bet tomēr nav lietojama kā vesels URL (trūkst shēmas vai
piegādātājam ir pavadošie faili zem resursdatora).

🔴 Bet **kails resursdators ar tukšu Faila nosaukumu netiek atteikts.** Ierakstot `example.com` un
atstājot **Faila nosaukumu** tukšu, forma saglabājas mierīgi — un imports pēc tam klusi izmanto
**iepriekš lejupielādēto** failu (sk. «Kas notiek ar lejupielādēto failu»). Tāpēc pēc saglabāšanas
vienmēr pārliecinieties, ka **Faila nosaukums** nav palicis tukšs.

Divi sīkumi, kas maina nozīmi:

- adrese, kas beidzas ar slīpsvītru (`example.com/feeds/`), **skaitās par resursdatoru**, nevis par
  veselu URL;
- ja **Faila nosaukums** nav tukšs, tas vienmēr uzvar — vesels URL blakus vecam ceļam nekad
  nesalīmējas par `https://host/new.xml/old.xml`.

## Autentifikācija — kas ir ievadāms un kas nav

**Pieejas datus vienmēr ievada cilnē «Datu plūsma»** — **Lietotājvārds**, **Parole**, **Klienta /
organizācijas ID**. Parsētājs izlemj tikai **transportu**: kādā veidā tie aiziet pie piegādātāja.
Operatoram transports nav jāzina un nav jāizvēlas.

| Transports | Ko tas nozīmē | Kur ievada |
|---|---|---|
| **HTTP Basic** | lietotājvārds + parole pieprasījuma galvenē; parastākais veids | cilne **Datu plūsma** |
| **FTP pieteikšanās** | tas pats **Lietotājvārds** / **Parole** pāris | cilne **Datu plūsma** |
| **Vaicājuma virkne** | pieejas dati aiziet adreses parametros (Action.pl) | cilne **Datu plūsma** |
| **Pieprasījuma dokuments** | klienta ID tiek ielikts pieprasījuma XML dokumentā (ALSO Lietuva) | cilne **Datu plūsma** |
| **Kalts marķieris** | lietotājvārdu un paroli sistēma apmaina pret īslaicīgu marķieri (LATAKKO) | cilne **Datu plūsma** |
| **Statiska autorizācijas galvene** (Bearer u. tml.) | galvene tiek sūtīta tāda, kāda ierakstīta | cilne **Datu plūsmas konfigurācija**, atslēga `main.auth_header` — **pilna** galvenes vērtība, ieskaitot vārdu `Bearer `; kā rindu pievienot, aprakstīts [otrajā daļā](/hc/help2/articles/ecomlink-datu-plusmas-konfiguracija) |

Atslēga `main.auth_header` sarakstā parādās **tikai tiem piegādātājiem, kuru parsētājs to pieprasa**
(šobrīd tie ir divi). Konfigurēt nevar tikai tādu piegādātāju, kuram vajadzīgais transports
nevienā parsētājā vispār nav aprakstīts — tas ir izstrādes darbs, nevis iestatījums.

## Kas notiek ar lejupielādēto failu

- Lejupielādētais fails tiek noglabāts veikala krātuvē (`storage/ecomlink/downloads/`), un tā ceļš
  tiek pierakstīts pie piegādātāja.
- **Pirms** katras jaunas lejupielādes iepriekšējā tiek arhivēta un saspiesta; arhīvs glabājas
  **20 dienas**. Tas ir vienīgais veids, kā vēlāk noskaidrot, kas tiešām ienāca vakar.
- Ja avots nav nokonfigurēts nemaz (nav resursdatora, nav faila nosaukuma, nav vesela URL), imports
  klusi izmanto **iepriekš lejupielādēto** failu. Ja arī tā nav — skaidra kļūda.
- Savienojumam ir **30 sekunžu**, visam failam — **30 minūšu** limits.
- Kļūdas atbildes saturs (līdz 2 KB) tiek iekļauts kļūdas ziņojumā — tieši tas atšķir «IP nav
  atļauto sarakstā» no «nederīgs marķieris» aiz viena un tā paša 403.

**Ja piegādātājs pieeju atver pēc IP adreses**, viņam jāpaziņo **jūsu veikala servera IPv4 adrese**.
Pieprasījums vienmēr iet pa IPv4 tieši tāpēc, lai piegādātājs redzētu to pašu adresi, ko esam viņam
nosaukuši. Adresi pasaka atbalsts vai sistēmas administrators — nemēģiniet to nolasīt no sava datora
vai pārlūkā, jo pieprasījumu veic serveris, nevis jūsu dators.

## Ja kaut kas nestrādā

**Saglabāšana atsakās: «Set either the Feed URL or the FTP host, not both».**
Aizpildīti abi resursdatora lauki. Atstājiet vienu — to, no kura tiešām ņem datus, — un otru
iztukšojiet.

**Saglabāšana atsakās, ka adresei jānosauc sava shēma.** (Arī šis ziņojums ir angliski.)
Adresē ir ceļš vai vaicājums, bet nav `https://` vai `ftp://`. Vai nu uzrakstiet shēmu klāt, vai
sadaliet adresi: resursdators laukā **Datu plūsmas URL**, ceļš laukā **Faila nosaukums**.

**Žurnālā ir 401, 403 vai «access denied».**
Vai nu pieejas dati ir mainīti, vai veikala serveris nav piegādātāja atļauto IP adrešu sarakstā.
Kurš no diviem — pasaka pats kļūdas ziņojums: tajā ir iekļauts piegādātāja atbildes teksts.
Pārbaudiet **Lietotājvārdu** / **Paroli** cilnē **Datu plūsma**; ja tie ir pareizi, prasiet
atbalstam servera IPv4 adresi un nosūtiet to piegādātājam.

**Lejupielāde neizdodas vai apstājas pusceļā.**
Savienojumam ir 30 sekunžu, visam failam — 30 minūšu limits. Ļoti liela vai ļoti lēna plūsma tajos
neiekļaujas; to risina ar piegādātāju (mazāks fails, arhīvs, lapošana), nevis formā.

**Kļūda vai brīdinājums ir par kādu iestatījumu tabulā «Datu plūsmas konfigurācija».**
Tie ir aprakstīti otrajā daļā:
[Datu plūsmas konfigurācija — kā plūsmu lasa](/hc/help2/articles/ecomlink-datu-plusmas-konfiguracija).

Saistītie raksti: [Piegādātāja pievienošana — sagatavošanās un pamatdati](/hc/help2/articles/ecomlink-piegadataja-pievienosana) — kā piegādātājs
tiek izveidots · [Atbalstītie formāti un parsētāja izvēle](/hc/help2/articles/ecomlink-atbalstitie-formati-un-parseri) — kā plūsmai
piesprauž vairumtirgotāja parsētāju · [Lauku pārsaiste — pārsaistīšana un sausā palaišana](/hc/help2/articles/ecomlink-lauku-parsaiste-parsaistisana) —
ja plūsmas lauks nonāk nepareizā preces īpašībā ·
[Žurnāli — ekrāns un izpilžu rindas](/hc/help2/articles/ecomlink-zurnali-un-diagnostika) — kur redzams, kas importā tiešām notika