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:
- Is een ManufacturerKey aanwezig? Zo ja — product slaagt, GTIN wordt niet gecontroleerd.
- 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:
- Ga naar Digitec Galaxus → Product Data → Advanced
- Zet Enable Data Validation op No
- Genereer de feed opnieuw
- 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:
- Ga naar Digitec Galaxus → Product Data → Stock & Pricing
- Wijzig het GTIN veld naar het juiste attribuut (bijv.
ean,barcodeof een custom attribuut) - Doe hetzelfde voor ManufacturerKey indien nodig
- Genereer de feed opnieuw
Optie 2: Pas de productgegevens aan
Als de koppeling correct is maar producten missen waarden:
- Ga naar Digitec Galaxus → Items in het admin panel
- Filter op producten met validatiefouten
- Bewerk die producten in de catalogus en voeg een geldige EAN/GTIN of ManufacturerKey waarde toe
- Genereer de feed opnieuw
Optie 3: Voeg ManufacturerKey toe
Als uw producten geen GTIN's hebben (bijv. custom of private-label producten):
- Navigeer naar Digitec Galaxus → Product Data → Stock & Pricing
- Zorg dat ManufacturerKey is gekoppeld aan een attribuut dat het productnummer van de fabrikant bevat
- Vul dat attribuut in op de betreffende producten
- Genereer de feed opnieuw
Probleemoplossing
Koppeling lijkt correct maar producten falen nog steeds
De attribuutkoppeling in de moduleconfiguratie (bijv. EAN / GTIN code → EAN) 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:
- Alle Help Artikelen - Compleet documentatie overzicht
Support:
- Contact Opnemen - Hulp van ons team