Bariere tehnice ale piețelor online: erori API, limite FTP și starea „Eliminat”

Ghid de diagnosticare și remediere a problemelor (Troubleshooting Guide)

Acest material este destinat rezolvării rapide a celor mai frecvente probleme tehnice care apar în timpul sincronizării sistemului de evidență cu marketplace-urile (Prom.ua, Rozetka) și în lucrul cu serverele FTP.

Blocul 1. Probleme cu API Prom.ua: erori 401, Import forbidden și încărcări paralele

În lucrul cu marketplace-ul Prom.ua, utilizatorii se confruntă frecvent cu blocarea accesului la API. Acest lucru duce la faptul că comenzile nu se descarcă, iar produsele nu se actualizează pe site.

Simptomul 1. Eroarea «401 Not Authenticated» sau «Import forbidden»

Semne. În timpul descărcării comenzilor sau încărcării produselor, programul afișează mesajul 401 Not Authenticated. Verificați validitatea cheii API sau Import forbidden. 

Cauze:

1. Cheie API lipsă sau expirată. Termenul de valabilitate al tokenului de acces din contul Prom.ua a expirat sau cheia nu este indicată deloc în setările obiectului de sincronizare.

2. Drepturi insuficiente (Import forbidden). În contul vânzătorului Prom.ua, pentru tokenul activ sunt setate doar drepturi de «Citire», ceea ce interzice programului să efectueze modificări și să scrie date pe marketplace.

Soluție:

1. Accesați contul personal Prom.ua în secțiunea «Setări» → «Gestionarea tokenurilor API».

2. Verificați termenul de valabilitate al cheii. Dacă acesta a expirat, generați o cheie API nouă.

3. Verificați drepturile de acces: în secțiunea «Produse și grupuri», schimbați obligatoriu valoarea din «Citire» în «Citire și scriere».

4. Copiați noul token, inserați-l în setările obiectului de sincronizare din Torgsoft și repetați încărcarea.

Simptomul 2. Erorile «Too Many Requests» sau «Bot protection»

Semne. Sincronizarea este întreruptă de erorile Too Many Requests sau Bot protection. 

Cauză. Marketplace-ul Prom.ua a introdus noi restricții privind interzicerea încărcărilor paralele. Dacă porniți simultan sincronizarea manuală în timp ce funcționează sincronizarea automată sau dacă aveți configurate mai multe sarcini automate la aceeași oră (dubluri ale timpului de sincronizare), se activează protecția marketplace-ului, iar conexiunea este blocată. 

Soluție:

1. Analizați jurnalul de sincronizare și verificați programul sarcinilor.

2. Evitați pornirea manuală a încărcării atunci când funcționează temporizatorul sincronizării automate.

3. Dezactivați sincronizarea produselor într-o serie de încărcări automate paralele sau programați-le la ore diferite.

Blocul 2. Încărcarea fotografiilor pe FTP: formate, prefixe și lipsă de spațiu

Transferul conținutului media către marketplace-uri se face cel mai des prin servere FTP. Problemele apărute în această etapă duc la încărcarea produselor fără imagini.

Simptomul 1. Fotografiile sunt încărcate cu succes pe FTP, dar nu se afișează pe site

Cauză. Serverul FTP este configurat incorect sau lipsește prefixul HTTP. Serverul FTP în sine doar stochează fișierele. Pentru ca marketplace-ul să le poată descărca, serverul FTP trebuie să funcționeze ca server Web, să fie deschis pentru acces prin internet, iar linkurile către fotografii trebuie să fie directe. 

Soluție:

1. Asigurați-vă că serverul dumneavoastră FTP este configurat ca server Web.

2. În setările obiectului de sincronizare, indicați obligatoriu Prefixul linkului către fotografii, de exemplu http://domeniul-dvs.com/images/. Programul va adăuga numele fișierului la acest prefix, formând un link direct pentru marketplace.

Simptomul 2. Eroarea «Transfer aborted. Input/output error» sau întreruperea conexiunii

Semne. În jurnalul de sincronizare apar erori precum Eroare la trimiterea fotografiei produsului... Transfer aborted. Input/output error sau Read timed out. 

Cauză. Cea mai frecventă cauză este lipsa spațiului liber pe hosting sau pe serverul FTP pentru încărcarea fotografiilor. De asemenea, încărcarea poate fi întreruptă de serverul FTP din cauza limitelor privind numărul de fișiere (inode) sau a timeouturilor de conexiune. 

Soluție:

1. Contactați administratorul hostingului FTP sau verificați în panoul de control disponibilitatea spațiului liber pe disc.

2. Ștergeți fotografiile învechite sau treceți la un plan de hosting mai mare.

Simptomul 3. Eroare la încărcarea imaginilor din cauza formatului WebP neacceptat

Semne. La încercarea de a adăuga sau încărca o fotografie după link apare eroarea Nu s-a reușit încărcarea imaginii sau Cannot create file. 

Cauză. Imaginea are formatul modern .webp, chiar dacă la finalul linkului este indicat .jpeg sau .jpg; de fapt, fișierul poate fi comprimat în format WebP. În prezent, programul nu acceptă lucrul cu formatul .webp din cauza limitărilor componentelor de sistem. 

Soluție. Folosiți formate standard de imagini, precum .jpg, .jpeg, .png sau .bmp. Dacă descărcați o fotografie de pe internet, convertiți în prealabil fișierul WebP în JPEG sau PNG.

Blocul 3. Probleme pe Rozetka: statusul «Șters» din cauza unui fișier de prețuri trunchiat

Marketplace-ul Rozetka actualizează informațiile despre prețuri și disponibilitatea produselor pe baza fișierului de prețuri XML generat de sistemul de evidență.

Simptom. Mii de produse pe Rozetka au primit brusc statusul «Șters»

Semne. Pentru aproape întregul sortiment de pe marketplace-ul Rozetka.ua este setat statusul «Șters». 

Cauză. Defecțiuni în timpul încărcării automate. Pe serverul FTP se încarcă periodic un fișier de prețuri trunchiat sau incomplet, de dimensiune mică, din care lipsesc majoritatea produselor. Dacă Rozetka citește un astfel de fișier, consideră că produsele nu mai sunt disponibile și le marchează în masă ca șterse. Cel mai des, fișierul trunchiat se formează din cauza unui conflict între procese paralele, de exemplu atunci când încărcarea manuală se suprapune peste cea automată sau când apare o eroare pe FTP în timpul suprascrierii fișierului. 

Soluție:

1. Recuperare rapidă. Efectuați manual sincronizarea cu Rozetka în program. Aceasta va genera un fișier complet de prețuri, de dimensiune normală, cu toate produsele, și îl va încărca pe FTP.

2. În timpul următoarei sesiuni de actualizare, Rozetka citește fișierul de prețuri la interval de o oră, marketplace-ul va procesa fișierul complet, iar toate produsele vor reveni la starea normală.

3. Prevenire. Verificați setările sarcinilor programate. Evitați pornirea simultană a mai multor sincronizări cu Rozetka, pentru ca sistemul să reușească să finalizeze corect generarea fișierului XML.