Technické bariéry trhovísk: chyby API, limity FTP a stav „Odstránené“

Sprievodca diagnostikou a riešením problémov (Troubleshooting Guide)

Tento materiál je určený na rýchle riešenie najčastejších technických problémov, ktoré vznikajú pri synchronizácii evidenčného systému s marketplace platformami (Prom.ua, Rozetka) a pri práci s FTP servermi.

Blok 1. Problémy s API Prom.ua: chyby 401, Import forbidden a paralelné nahrávania

Pri práci s marketplace platformou Prom.ua sa používatelia často stretávajú s blokovaním prístupu k API. To vedie k tomu, že objednávky sa nesťahujú a tovary sa na stránke neaktualizujú.

Symptóm 1. Chyba «401 Not Authenticated» alebo «Import forbidden»

Príznaky. Pri sťahovaní objednávok alebo nahrávaní tovarov program zobrazí hlásenie 401 Not Authenticated. Skontrolujte platnosť API kľúča alebo Import forbidden. 

Príčiny:

1. Chýbajúci alebo expirovaný API kľúč. Platnosť prístupového tokenu v účte Prom.ua sa skončila alebo kľúč vôbec nie je uvedený v nastaveniach objektu synchronizácie.

2. Nedostatočné práva (Import forbidden). V osobnom účte predajcu Prom.ua sú pre aktívny token nastavené iba práva na «Čítanie», čo programu zakazuje vykonávať zmeny a zapisovať údaje na marketplace.

Riešenie:

1. Prejdite do osobného účtu Prom.ua do sekcie «Nastavenia» → «Správa API tokenov».

2. Skontrolujte dobu platnosti kľúča. Ak sa skončila, vygenerujte nový API kľúč.

3. Skontrolujte prístupové práva: v sekcii «Produkty a skupiny» povinne zmeňte hodnotu z «Čítanie» na «Čítanie a zápis».

4. Skopírujte nový token, vložte ho do nastavení objektu synchronizácie v Torgsoft a zopakujte nahrávanie.

Symptóm 2. Chyby «Too Many Requests» alebo «Bot protection»

Príznaky. Synchronizácia sa preruší chybami Too Many Requests alebo Bot protection. 

Príčina. Marketplace Prom.ua zaviedol nové obmedzenia týkajúce sa zákazu paralelných nahrávaní. Ak súčasne spustíte manuálnu synchronizáciu počas automatickej synchronizácie alebo máte nastavených niekoľko automatických úloh na rovnaký čas (duplicitné časy synchronizácie), aktivuje sa ochrana marketplace platformy a spojenie sa zablokuje. 

Riešenie:

1. Analyzujte denník synchronizácie a skontrolujte plán úloh.

2. Vyhnite sa manuálnemu spúšťaniu nahrávania v čase, keď pracuje časovač automatickej synchronizácie.

3. Vypnite synchronizáciu tovarov v sérii paralelných automatických nahrávaní alebo ich rozdeľte do rôznych časov.

Blok 2. Nahrávanie fotografií na FTP: formáty, prefixy a nedostatok miesta

Prenos mediálneho obsahu na marketplace platformy sa najčastejšie vykonáva cez FTP servery. Problémy v tejto fáze spôsobujú, že tovary sa nahrávajú bez obrázkov.

Symptóm 1. Fotografie boli úspešne nahrané na FTP, ale nezobrazujú sa na stránke

Príčina. FTP server je nesprávne nastavený alebo chýba HTTP prefix. Samotný FTP server iba ukladá súbory. Aby si ich marketplace mohol stiahnuť, FTP server musí fungovať ako webový server, byť dostupný cez internet a odkazy na fotografie musia byť priame. 

Riešenie:

1. Uistite sa, že váš FTP server je nastavený ako webový server.

2. V nastaveniach objektu synchronizácie povinne uveďte Prefix odkazu na fotografie, napríklad http://vas-domen.com/images/. Program pridá názov súboru k tomuto prefixu a vytvorí priamy odkaz pre marketplace.

Symptóm 2. Chyba «Transfer aborted. Input/output error» alebo prerušenie spojenia

Príznaky. V denníku synchronizácie sa zobrazujú chyby ako Chyba odoslania fotografie tovaru... Transfer aborted. Input/output error alebo Read timed out. 

Príčina. Najčastejšou príčinou je nedostatok voľného miesta na hostingu alebo FTP serveri na nahrávanie fotografií. Nahrávanie sa môže prerušiť aj zo strany samotného FTP servera pre limity počtu súborov (inode) alebo časové limity spojenia. 

Riešenie:

1. Kontaktujte administrátora vášho FTP hostingu alebo skontrolujte dostupné voľné miesto na disku v ovládacom paneli.

2. Odstráňte zastarané fotografie alebo prejdite na väčší hostingový plán.

Symptóm 3. Chyba nahrávania obrázkov pre nepodporovaný formát WebP

Príznaky. Pri pokuse pridať alebo nahrať fotografiu cez odkaz sa zobrazí chyba Nepodarilo sa nahrať obrázok alebo Cannot create file. 

Príčina. Obrázok má moderný formát .webp, aj keď je na konci odkazu uvedené .jpeg alebo .jpg; v skutočnosti môže byť súbor komprimovaný vo formáte WebP. Program momentálne nepodporuje prácu s formátom .webp z dôvodu obmedzení systémových komponentov. 

Riešenie. Používajte štandardné formáty obrázkov, ako napríklad .jpg, .jpeg, .png alebo .bmp. Ak sťahujete fotografiu z internetu, najskôr skonvertujte súbor WebP na JPEG alebo PNG.

Blok 3. Problémy na Rozetka: status «Odstránený» pre skrátený cenník

Marketplace Rozetka aktualizuje informácie o cenách a dostupnosti tovarov na základe XML cenníka, ktorý generuje evidenčný systém.

Symptóm. Tisíce tovarov na Rozetka náhle získali status «Odstránený»

Príznaky. Takmer pri celom sortimente na marketplace Rozetka.ua je nastavený status «Odstránený». 

Príčina. Zlyhania počas automatického nahrávania. Na FTP server sa pravidelne nahráva skrátený alebo neúplný cenník malej veľkosti, v ktorom chýba väčšina tovarov. Ak Rozetka načíta takýto súbor, predpokladá, že tovary už nie sú dostupné, a hromadne ich označí ako odstránené. Najčastejšie sa skrátený súbor vytvorí pre konflikt paralelných procesov, napríklad keď sa manuálne nahrávanie prekrýva s automatickým alebo keď dôjde k chybe na FTP počas prepisovania súboru. 

Riešenie:

1. Rýchla obnova. Vykonajte manuálnu synchronizáciu s Rozetka v programe. Tým sa vygeneruje plnohodnotný cenník normálnej veľkosti so všetkými tovarmi a nahrá sa na FTP.

2. Počas nasledujúcej aktualizácie Rozetka načítava cenník v hodinovom intervale, marketplace spracuje úplný súbor a všetky tovary sa vrátia do normálneho stavu.

3. Prevencia. Skontrolujte nastavenia plánovaných úloh. Vyhnite sa spúšťaniu viacerých synchronizácií s Rozetka naraz, aby systém stihol správne dokončiť generovanie XML súboru.