Mi a teendő, ha a Mergado nem tudja letölteni a bemeneti feedet#

Ha a Mergado nem tudja letölteni a bemeneti feededet, a projekt nem generálódik újra, és a kimeneten a régebbi adatok maradnak. A legtöbb esetben nem a Mergado a hibás: a feededet tároló szerver elutasítja a letöltési kérést, vagy nem válaszol rá. Ez a cikk segít kideríteni, mi történik, és megmutatja a megoldás felé vezető utat – ideális esetben úgy, hogy az okot magad találod meg, és nem kell az ügyfélszolgálat válaszára várnod.

Az útmutató a projekt bemeneti feedjére és az Adatfájl import szabály által letöltött fájlokra egyaránt érvényes.

Hogyan derítsd ki, mi történt pontosan#

Ne csak abból indulj ki, hogy „nem működik a projekt”. A Mergado minden letöltési kísérletet rögzít:

  1. Nyisd meg a Mergadóban azt a projektet, amelyiknél a probléma jelentkezett.
  2. Lépj az Előzmények oldalra.
  3. Az Eseménytípusok oszlopban szűrj a Termékek importálása eseményre, vagy a Tervezett termékimport eseményre, ha a projekt automatikusan generálódik újra.

Látni fogod a sikertelen kísérletek számát és a hozzájuk tartozó hibaüzenetet. A leggyakoribb hibáknál (401, 403, 404, 500, 502, 503 és 504) az üzenet konkrét, és rögtön elárulja, mi történt – ilyenkor haladj tovább az alábbi táblázat szerint. Ha csak az általános „Ismeretlen hiba” üzenetet látod, ugorj egyenesen a Mit jelent az „Ismeretlen hiba” részhez.

Mit jelentenek az egyes hibák#

Üzenet az Előzményekben Mi történik Hol keresd a megoldást
A távoli fájlhoz való hozzáférés megtagadva (401 Unauthorized). A feedet felhasználónév és jelszó védi, a Mergado pedig nem ismeri őket, vagy hibásak. Ellenőrizd a bejelentkezési adatokat a feed URL-címében, illetve a Mergado Drive bővítményben. Ha a szerveren megváltoztattad őket, a Mergadóban is módosítsd.
A távoli szerver elutasította a választ (403 Forbidden). A szerver tud a Mergadóról, de megtagadja tőle a hozzáférést. Ez a leggyakoribb eset. Az oka általában IP-cím whitelist, WAF (webes tűzfal, amely szűri a webhelyedre érkező forgalmat), a Cloudflare vagy az automatizált letöltés blokkolása. Engedélyezd a Mergado IP-címeit. Ha Cloudflare-t használsz, kövesd ezt az útmutatót.
A távoli fájl nem létezik (404 Not Found). A megadott címen nem található adat. A megadott címen nincs fájl. A feedet áthelyezték, átnevezték, vagy elírás van a címben. Nyisd meg a feed címét a böngészőben. Ha te sem találod, kérd le az aktuális címet a webáruház-rendszeredből, és javítsd ki a projekt beállításaiban.
A távoli szerveren közelebbről meg nem határozott hiba történt (500 Internal Server Error). A feedet kiszolgáló szerveren belső hiba történt, leggyakrabban maga a feedgenerálás hiúsult meg. Próbáld megnyitni a címet a böngészőben. Ha a hiba nem múlik el, fordulj a tárhelyszolgáltatódhoz vagy a webáruházad fejlesztőjéhez.
A távoli szerver nem tudott válaszolni (502 Bad Gateway). A webáruházad előtt álló szerver (proxy, CDN) nem kapott érvényes választ a feedet generáló szervertől. Ez általában átmeneti kiesés. Ha a hiba nem múlik el, fordulj a tárhelyszolgáltatódhoz.
A távoli szerver nem válaszolt (503 Service Unavailable). A szerver túlterhelt, karbantartás alatt áll, vagy átmenetileg nem érhető el. Várd meg a következő letöltési kísérletet. Ha a hiba ismétlődik, egyeztess a tárhelyszolgáltatóddal a szerver teljesítményéről vagy a tervezett karbantartásokról.
A távoli szerver nem tudott válaszolni (504 Gateway Timeout). A feed generálása túl sokáig tartott, és a szerver nem tudta időben elküldeni a választ. Kérd meg a tárhelyszolgáltatódat vagy a webáruházad fejlesztőjét, hogy gyorsítsák fel a feed generálását, vagy generálják előre fájlba.

A WAF (Web Application Firewall) olyan biztonsági szűrő, amely ellenőrzi a webhelyedre érkező kéréseket, és blokkolja a gyanúsakat. Gyakran a tárhelyszolgáltatás vagy olyan szolgáltatások része, mint a Cloudflare, és néha tévedésből az automatizált feedletöltést is blokkolja.

Mit jelent az „Ismeretlen hiba”#

A többi hibánál az Előzmények nem mutat konkrét leírást, csak az általános „Ismeretlen hiba” üzenetet. Ez főként a következőkre vonatkozik:

  • 429 Too Many Requests – a szerver korlátozza a kérések számát, és a feed letöltése nem fért bele a limitbe.
  • Időtúllépés (timeout) – a szerver egyáltalán nem válaszolt, vagy túl sokáig tartott a kapcsolat felépítése.
  • Tanúsítvány- / SSL-hiba – a szerver tanúsítványa érvénytelen, lejárt vagy nem megbízható.

A pontos kódot és okot ilyenkor az Előzményekből nem tudod meg – azt csak a technikai ügyfélszolgálatunk látja. Mielőtt írnál nekünk, próbáld meg magad ellenőrizni az okot – a legtöbb esetben válaszra várás nélkül megtalálod:

  1. Ellenőrizd a feed letöltését úgy, ahogy a Mergado látja. A Mergado nem böngészőn keresztül tölti le a feedet, hanem automatizáltan, a curl eszközzel, MergadoBot azonosítóval (User-Agenttel). Ugyanezt a kérést te is elküldheted. A terminálban (macOS, Linux, Windows 10 és újabb) futtasd a következő parancsot:

    curl -I -A "MergadoBot" "https://a-feeded-cime"
    • A válasz első sorában látod a HTTP-kódot (például HTTP/2 200, 403, 429 vagy 503). Ebből akkor is felismered az okot, ha az Előzmények csak „Ismeretlen hibát” mutat.
    • A válasz tartalmazza a cf-mitigated: challenge fejlécet → a feedet a Cloudflare blokkolja, kövesd a Cloudflare-hez készült útmutatót.
    • A parancs nem ad vissza semmit, vagy csak hosszú idő után fejeződik be → ez időtúllépésnek felel meg.
    • A parancs tanúsítványhibával áll le → SSL-hibáról van szó, kérd a tanúsítvány megújítását a tárhelyszolgáltatódtól.

    A teszt a te IP-címedről fut, nem a Mergado IP-címéről. Ha 200-as kódot kapsz, a Mergado mégsem tudja letölteni a feedet, akkor a szerver valószínűleg közvetlenül a Mergado IP-címét blokkolja – ezt ellenőrizd a naplóban (következő lépés) vagy a tárhelyszolgáltatódnál.

  2. Nézd meg a tárhelyed saját hozzáférési és hibanaplóját (access/error log) a tárhelyszolgáltatód adminisztrációs felületén – az Előzményeinkkel ellentétben ott a valódi HTTP-státuszkódot látod. Keresd meg benne a sikertelen kísérlet időpontját az Előzmények alapján, és keresd a 81.31.39.112 IP-címről érkező kéréseket.

    • A kérés egyáltalán nincs ott → még azelőtt megállították, hogy elérte volna a webáruházadat (tűzfal, WAF, hálózati szint) → ez időtúllépésnek felel meg.
    • A kérés ott van, és konkrét kódot látsz (például 429) → megvan a pontos ok, anélkül hogy ránk kellene várnod. 429-es hibánál kérd meg a szerver üzemeltetőjét vagy a tárhelyszolgáltatót, hogy emelje meg a limitet a Mergado IP-címére.
  3. Hasonlítsd össze az utolsó sikeres és az első sikertelen bejegyzés időpontját az Előzményekben. Így a problémát egy konkrét változáshoz kötheted – új biztonsági szabályhoz, a Cloudflare bekapcsolásához, tárhelyköltöztetéshez vagy tanúsítványmegújításhoz.

Ha ezzel a módszerrel sem találod meg az okot, írj nekünk a mergado@mergado.hu címre – csatold a projekt linkjét, a feed címét és a probléma jelentkezésének időpontját. Ezt az ellenőrzést követően kikeressük neked a kódot és a pontos okot az adminisztrációs felületen.

Különleges eset: korábban működött, aztán leállt, pedig nem változtattam semmin#

Ez gyakoribb, mint gondolnád, és szinte soha nem a Mergado oldalán van a hiba. Tipikus okok:

  • A tárhelyszolgáltatód új biztonsági szabályokat vezetett be. Valós eset: egy nagy cseh tárhelyszolgáltató új szabályt vezetett be a gyanús kommunikáció észlelésére, és tévedésből a Mergado kommunikációját is kockázatosnak minősítette. Ezzel a szerverein futó összes webáruháznál blokkolta a feedek letöltését, amíg fel nem hívtuk rá a figyelmét.
  • Bekapcsoltad a Cloudflare-t, vagy megváltozott a beállítása.
  • Lejárt a tanúsítvány.
  • Tárhelyet váltottál, vagy megváltozott a szerver IP-címe, és a whitelist már nincs ott.
  • Megváltozott a jelszó vagy a hash a feed címében, például a webáruház frissítése után.

Hogyan ismerheted fel: a projekt Előzményeiben keresd meg az utolsó sikeres letöltést, és hasonlítsd össze az első sikertelennel. Az időpont, amikor a dolog elromlott, a legértékesebb adat neked és a tárhelyszolgáltatódnak is.

Hogyan járj el#

  1. Teszteld a feedet úgy, ahogy a Mergado tölti le – a curl -I -A "MergadoBot" "https://a-feeded-cime" paranccsal (részletesen a Mit jelent az „Ismeretlen hiba” részben). Önmagában nem elég megnyitni a feedet a böngészőben: a böngésző akkor is betöltheti a feedet, ha a szerver az automatizált letöltést blokkolja.
  2. Nézd meg a projekt Előzményeiben, melyik hiba ismétlődik. Ha konkrét üzenetről van szó (401, 403, 404, 500, 502, 503 vagy 504), keresd meg a fenti táblázatban. Ha „Ismeretlen hiba” jelenik meg, kövesd a Mit jelent az „Ismeretlen hiba” részt.
  3. Ellenőrizd az IP-címek whitelistjét. A Mergado a bemeneti feedet a 81.31.39.112 címről tölti le. Ha bővítményeket is használsz, add hozzá azok IP-címeit is.
  4. Ellenőrizd, hogy a feedet nem védi-e egyszerre több módszer. A whitelist és a címben lévő hash kombinációja gyakori hibaforrás, jellemzően a Shoptet feedeknél.
  5. Ha Cloudflare-t használsz, állíts be kivételt a külön útmutató szerint. Ott önmagában nem elég felvenni az IP-címet a whitelistre.
  6. Írj a tárhelyszolgáltatódnak, ha a fentiek közül semmi sem segített. Jelezd, hogy a termékfeed jogszerű, automatizált letöltéséről van szó, és kérd a 81.31.39.112 IP-cím blokkolásának feloldását. Add meg azt is, mikor állt le a letöltés.
  7. Fordulj az ügyfélszolgálatunkhoz, ha bizonytalan vagy. Írj a mergado@mergado.hu címre, és csatold a projekt linkjét, a feed címét és a probléma jelentkezésének időpontját.

GYIK#

Azt jelenti a letöltési hiba, hogy elveszítem a kimeneti adatokat?#

Nem. Ha a letöltés nem sikerül, a Mergado megtartja az utolsó sikeres import adatait – ha volt már ilyen. A kimeneti feed továbbra is elérhető marad, de régebbi információkat tartalmaz, amíg a letöltés újra nem sikerül. Ha a feedet még egyszer sem sikerült letölteni (például egy újonnan létrehozott projektnél), a kimeneten még nincsenek adatok.

Miért nem töltődik le a feed, ha a böngészőben működik?#

A böngésző és a Mergado másképp fér hozzá a feedhez. A Mergado automatizáltan, a curl eszközzel, MergadoBot azonosítóval tölti le a feedet. A böngésző képes JavaScriptet és biztonsági ellenőrzéseket feldolgozni, az automatizált letöltés nem. A szerver ráadásul IP-cím alapján is megkülönböztetheti a hozzáférést, a te IP-címed pedig más, mint a Mergadóé. Leggyakrabban IP-cím whitelist, WAF vagy a Cloudflare áll a háttérben. Ezért a böngészőnél megbízhatóbb a curl-teszt, amelyet a Mit jelent az „Ismeretlen hiba” rész ismertet.

Ugyanez érvényes az Adatfájl import szabályra is?#

Igen. Az Adatfájl import szabály ugyanúgy tölti le a fájlt, mint a bemeneti feedet, így az okok és a megoldások is azonosak.

Honnan tudhatom meg, hogy a tárhelyszolgáltató blokkol-e?#

Megbízható jel az időtúllépés típusú hiba, amikor a szerver egyáltalán nem válaszol, miközben a MergadoBot azonosítóval futtatott curl-teszt a saját gépedről rendben lefut. Ha ráadásul a probléma egyik napról a másikra, a te beavatkozásod nélkül kezdődött, nagyon valószínű, hogy a tárhelyszolgáltató blokkol. Fordulj az ügyfélszolgálatához.

Miért csak „Ismeretlen hiba” látszik az Előzményekben, és nem konkrét kód?#

Az Előzmények csak a leggyakoribb hibáknál (401, 403, 404, 500, 502, 503 és 504) mutatnak konkrét leírást. A többi hiba, például a 429, az időtúllépés vagy a tanúsítványprobléma, általánosan „Ismeretlen hiba”-ként jelenik meg – a pontos kódot ilyenkor csak az ügyfélszolgálatunk látja. Azt, hogyan ellenőrizheted magad az okot, a Mit jelent az „Ismeretlen hiba” részben találod.

Kell valamit tennem a javítás után, hogy a projekt újragenerálódjon?#

A Mergado minden következő újrageneráláskor automatikusan megpróbálja letölteni a feedet. Ha azonnal ellenőrizni szeretnéd az eredményt, indítsd el kézzel az újragenerálást a projektben.

Hasznos volt ez a cikk?