Digitec Galaxus

Versie v1.13.0
Platform Magento 2
Laatste wijziging 1 August 2025

GTIN & ManufacturerKey Validatie handleiding voor product feed

Deze pagina legt de "Not valid GTIN (8-14 numbers) or ManufacturerKey" validatiefout uit in de Digitec Galaxus Integratie. Als producten worden uitgesloten van uw feed en u deze fout ziet in het Items overzicht, vindt u hier wat de validatie controleert, waarom deze faalt en hoe u het kunt oplossen. Het begrijpen van deze vereisten helpt om uw productfeed schoon te houden en geaccepteerd te worden door Digitec Galaxus.

Wat deze fout betekent

Digitec Galaxus vereist dat elk product uniek identificeerbaar is. Als onderdeel van hun marketplace-vereisten moet elk product minimaal één van de volgende hebben:

  • Een geldig GTIN (Global Trade Item Number) — tussen de 8 en 14 numerieke cijfers
  • Een geldige ManufacturerKey — het eigen productnummer van de fabrikant, uniek binnen elk merk

Dit is een vereiste van de Digitec Galaxus marketplace, niet alleen een module-validatie. Producten zonder een geldig identificatienummer kunnen niet worden geplaatst op de marketplace. De module controleert dit vooraf zodat ongeldige producten worden onderschept voordat de feed wordt verstuurd, in plaats van afgewezen te worden door Digitec Galaxus na het uploaden.

Als beide ontbreken of ongeldig zijn, faalt de validatie en wordt het product uitgesloten van de feed met de fout:

Not valid GTIN (8-14 numbers) or ManufacturerKey

Waarom Digitec Galaxus dit vereist

Digitec Galaxus gebruikt GTIN en ManufacturerKey om uw producten te matchen aan hun catalogus. Zonder een geldig identificatienummer:

  • Het product kan niet gematcht worden aan een bestaande vermelding op de marketplace
  • Digitec Galaxus zal het product afwijzen tijdens de import
  • Bestellingen en voorraadwijzigingen werken niet omdat er geen koppeling is tussen uw catalogus en die van hen

De ManufacturerKey dient als alternatief wanneer een product geen standaard GTIN heeft — bijvoorbeeld custom producten, private-label artikelen of accessoires zonder EAN. De ManufacturerKey moet uniek zijn binnen elk merk.

Hoe de validatie werkt

De module controleert in deze volgorde:

  1. Is een ManufacturerKey aanwezig? Zo ja — product slaagt, GTIN wordt niet gecontroleerd.
  2. Als ManufacturerKey leeg is — controleer de GTIN waarde:
    • Moet alleen numeriek zijn (geen letters, spaties of streepjes)
    • Moet 8 tot 14 cijfers lang zijn

De fout treedt dus alleen op wanneer ManufacturerKey leeg is en de GTIN ontbreekt of ongeldig is.

Veelvoorkomende oorzaken

Oorzaak Voorbeeld Oplossing
GTIN attribuut is leeg Geen EAN ingevuld op product Voeg de EAN/GTIN toe aan het product
GTIN bevat niet-numerieke tekens EAN-5901234123457 of 590 123 412 Verwijder letters, spaties, streepjes
GTIN te kort 123456 (6 cijfers) Controleer juiste EAN — minimaal 8 cijfers
GTIN te lang 123456789012345 (15 cijfers) Controleer op extra cijfers of samengevoegde waarden
Verkeerd attribuut gekoppeld SKU gebruikt in plaats van EAN attribuut Pas de GTIN attribuutkoppeling aan in de configuratie
ManufacturerKey attribuut leeg Geen fabrikantennummer ingesteld Voeg ManufacturerKey toe of zorg dat GTIN geldig is

Geldige GTIN formaten

Deze worden allemaal geaccepteerd:

  • GTIN-8 (EAN-8): 8 cijfers, bijv. 96385074
  • GTIN-12 (UPC-A): 12 cijfers, bijv. 012345678905
  • GTIN-13 (EAN-13): 13 cijfers, bijv. 5901234123457
  • GTIN-14: 14 cijfers, bijv. 15901234123457

Hoe op te lossen

Stap 1: Controleer uw feed output

Begin met het uitschakelen van de datavalidatie zodat u kunt inspecteren wat de module daadwerkelijk verstuurt:

  1. Ga naar Digitec Galaxus → Product Data → Advanced
  2. Zet Enable Data Validation op No
  3. Genereer de feed opnieuw
  4. Open de CSV en controleer de GTIN en ManufacturerKey kolommen

Dit laat zien of de juiste attribuutwaarden worden gebruikt. Veelvoorkomende bevindingen:

  • Kolommen zijn leeg — de gekoppelde attributen hebben geen waarden op uw producten
  • GTIN bevat SKU's in plaats van EAN's — de standaardkoppeling gebruikt sku, wat waarschijnlijk niet uw EAN attribuut is
  • Waarden kloppen niet — het verkeerde attribuut is gekoppeld

Zodra u weet wat er in de feed staat, kies de juiste oplossing hieronder.

Optie 1: Pas de attribuutkoppeling aan

De GTIN attribuutkoppeling staat standaard op sku. Als uw EAN's in een ander attribuut staan:

  1. Ga naar Digitec Galaxus → Product Data → Stock & Pricing
  2. Wijzig het GTIN veld naar het juiste attribuut (bijv. ean, barcode of een custom attribuut)
  3. Doe hetzelfde voor ManufacturerKey indien nodig
  4. Genereer de feed opnieuw

Optie 2: Pas de productgegevens aan

Als de koppeling correct is maar producten missen waarden:

  1. Ga naar Digitec Galaxus → Items in het admin panel
  2. Filter op producten met validatiefouten
  3. Bewerk die producten in de catalogus en voeg een geldige EAN/GTIN of ManufacturerKey waarde toe
  4. Genereer de feed opnieuw

Optie 3: Voeg ManufacturerKey toe

Als uw producten geen GTIN's hebben (bijv. custom of private-label producten):

  1. Navigeer naar Digitec Galaxus → Product Data → Stock & Pricing
  2. Zorg dat ManufacturerKey is gekoppeld aan een attribuut dat het productnummer van de fabrikant bevat
  3. Vul dat attribuut in op de betreffende producten
  4. Genereer de feed opnieuw

Probleemoplossing

Koppeling lijkt correct maar producten falen nog steeds

De attribuutkoppeling in de moduleconfiguratie (bijv. EAN / GTIN codeEAN) kan zijn ingesteld op een specifieke storeview. Als de feed voor een andere storeview wordt gegenereerd, is de koppeling mogelijk niet van toepassing.

Controleer: Zorg dat de EAN/GTIN attribuutkoppeling is geconfigureerd voor de storeview waarvoor de feed wordt gegenereerd, niet alleen op het standaard bereik.

Product heeft een geldige EAN maar krijgt toch de fout

Het EAN attribuut op het product heeft mogelijk een waarde, maar de feed pikt deze niet op. Dit kan gebeuren wanneer:

  • De attribuutkoppeling is ingesteld op storeview-niveau en de feed draait op een andere storeview
  • De EAN waarde van het product is alleen ingesteld op één storeview maar het attribuutbereik is storeview (niet globaal)

Controleer: Open de CSV (met validatie uitgeschakeld) en verifieer dat de GTIN kolom daadwerkelijk de verwachte EAN waarde bevat voor het betreffende product. Als de kolom leeg is ondanks dat het product een EAN heeft, is de koppeling of het bereik het probleem.

De oplossing verifiëren

Na het aanbrengen van wijzigingen:

bin/magento digitecgalaxus:run-generate-feed --type=data -vvv

Controleer de output op het aantal geldige/ongeldige producten. U kunt ook het Items overzicht in het admin panel bekijken om te bevestigen dat fouten zijn opgelost.

Meer Hulp Nodig?

Documentatie:

Support:

Artikel bijgewerkt:
star star star star star
star star star star star
Alexandru-Manuel Carabus
Magmodules sets the bar for Magento module quality and support—we check their catalog first for client feature requests, and they’re our first choice for licenses.
Google 11 Nov 2025
star star star star star
star star star star star
Matt Austin
Possibly the fastest support response times of any Magento Extension vendor. Great extensions too!
Google 09 Sep 2025
star star star star star
star star star star star
Jan Privé
Dankzij de heldere uitleg en snelle reactie van Magmodules kon mijn vraag, en dus mijn Magento-probleem, binnen enkele uren worden beantwoord. Doeltreffend, zonder moeilijke termen, gewoon zo als het zou moeten zijn.... Bedankt!
Google 05 Sep 2025
star star star star star
star star star star star
Denis Metzler
To evaluate a provider, it is not enough to consider only the product offered, but also its after-sales service, such as support and troubleshooting. Magmodules has been extremely satisfactory at all levels on multiple occasions and sets the bar at the top when comparing the competition.
Google 02 Sep 2025
star star star star star
star star star star star
Bleijenberg winkelinrichting en materialen
Goed bereikbaar, reageren snel en denken oplossingsgericht. Een aanrader.
Google 30 Jul 2025
star star star star star
star star star star star
Patrick Verduijn
Magmodules biedt plugins aan die van hoge kwaliteit zijn tegen een goede prijs, waar dit bedrijf in uitblinkt is de bereidheid om de zeldzame feedback & problemen met de plugins te willen onderzoeken, mee te willen denken in het debuggen van problemen en goede oplossingen toe te passen. In mijn decennium ervaring met Magento & 3th parties is Magmodules absoluut een uniqum binnen de markt.
Google 25 Jul 2025
star star star star star
star star star star star
Erik de Groot
Magemodules heeft hele sterke Magento extensies en een proactieve support. Al jaren heel erg tevreden over jullie service en producten!
Google 18 Jul 2025
star star star star star
star star star star star
René Zeuner
We are using the Mollie Magento extension from Magmodules. It works excellently without flaws. Very fast, competent and friendly support. Thanks!
Google 30 Jun 2025
star star star star star
star star star star star
R. U.
Erg goed team, reageren snel en duidelijk en hebben met toegang tot onze database erg goed geholpen (eigenlijk een gratis customization).
Google 18 Jun 2025
star star star star star
star star star star star
Hugo de Groot
Uitstekende support! Wij gebruiken o.a. de Rich Snippets Suite extensie voor onze Magento 2 webshop (Hyvä) en hadden een specifieke vraag over structured data op PLP-pagina’s. Binnen no-time kregen we een inhoudelijk en duidelijk antwoord. Zeer prettig contact en goed onderbouwde uitleg. Absoluut een betrouwbare partner voor Magento-extensies!
Google 13 Jun 2025