ETIM xChange
ETIM xChange is de allereerste standaard voor de uitwisseling van product – en handelsgegevens die volledig wordt beheerd door ETIM International en haar gemeenschap, met de focus op mondiaal gebruik. ETIM xChange is gebaseerd op de European Master Data Guidelines (EMDG) rekening houdend met nationale uitwisselstandaarden zoals DICO, BMEcat en FAB-DIS). Het uitwisselingsformaat is gebaseerd op JSON, inclusief JSON-schema voor validatie.
Versie 1.0 / 1.1
De datapool accepteert zowel de 1.0 als 1.1 versie van ETIM xChange. Vanwege de backwards compatibility worden beide versies weergeven als ETIM xChange versie 1.1.
Actuele versie: 1.1 (23-08-2024)
- Vereenvoudigde structuur in JSON die logisch is gegroepeerd, gebaseerd op meerdere nationale uitwisselingsstandaarden.
- Generieke opbouw van productgegevens met onderliggende verschijningsvormen; ofwel artikelen.
- Inclusief datastructuur voor het transporteren van milieudata zoals LCA-gegevens in alle fasen van de levenscyclus.
- De structuur biedt de mogelijkheid omschrijvingsvelden meertalig te communiceren.
- Compatibel met de nieuwste ETIM-MC-structuur, inclusief verbindingstypen ten behoeve van de Uniforme Objecten Bibliotheek.
- Het heeft een zeer flexibele structuur voor allerlei methoden voor het uitwisselen van verpakkingshiërarchiegegevens.
De volledige documentatie van ETIM xChange 1.1 treft u aan in de downloadsectie van ETIM International.
Valide bestanden
ETIM xChange berichten dienen volgens het bijhorend schema zonder fouten te zijn gevalideerd. ETIM International biedt hiervoor een validatie tool (login vereist) aan binnen de website.
Known Issues
Product
- Goederencode op productniveau
- Alternatieve productcode ontbreekt
Bijlagen
- Beperkt aantal bijlagentypen
- Specificatie hoge/lage resolutie, default mapping naar lage resolutie
Artikel
- Marketingtekst ontbreekt, mapping vanuit ProductMarketingText
- Deeplink ontbreekt, mapping vanuit ProductPageURI
- Land van herkomst ontbreekt
Mapping vs. datamodel
2BA conformeert de datapool volgens de Nederlandse standaarden van Ketenstandaard Bouw en Techniek. De ondersteunde uitwisselingsformaten worden toegewezen aan de interne velden van het datamodel. Sommige interne velden kunnen afwijken van de lengte of het type zoals beschreven in de richtlijn van de uitwisselformaten. We creëren zoveel mogelijk duidelijkheid, maar er kunnen verschillen zijn, uitzonderingen worden vermeld in de mapping.
De binnen het uitwisselformaat gehanteerde codelijsten komen niet altijd één op één over met de codelijsten uit het datamodel. Gebruik altijd de codelijsten bijbehorend bij het gebruikte uitwisselformaat. Raadpleeg onderstaand de mappings per codelijst:
Mapping ETIM Versie
Mapping product statuscode
Mapping artikel statuscode
Mapping taalcode
Mapping verpakkingscode
Mapping bijlage ATX code
Mapping itemrelatietype
Mapping toeslagen en kortingen
Land specifieke elementen
Het kan voorkomen dat een land meer velden nodig heeft dan oorspronkelijk beschikbaar in de ETIM xChange structuur. De ETIM xChange Country Specific Guideline bevat duidelijke voorbeelden hoe u deze in uw databestand kunt definiëren. Gebruik de CSItemCharacteristics velden zoals gedefinieerd in de ETIM richtlijn paragraaf 3.13 vanaf pagina 50.
Root tree
De header van ETIM xChange bevat geen mogelijkheid om het uitwisselformaat te specificeren. Ter herkenning van het formaat dient of de term ETIM_XCHANGE of ETIMxChange in de bestandsnaam opgenomen zijn. Wanneer deze term ontbreekt dan zal de dataset niet door de importroutine herkend worden.
Aandachtspunten
- NameDataCreator wordt overgenomen in de verwerkingsrapportages.
- SupplierIdGln voor de aangeleverde partij.
- Bijlagen worden op header niveau niet geïmporteerd.
- CatalogueValidityStart wordt niet geïmporteerd.
- De in Languagecode eerst genoemde waarde wordt gebruikt voor taalafhankelijke velden waarbij geen taalcode is opgegeven. Dit is conform BMEcat werking. Conform ETIM xChange documentatie mag dit alleen als er maar één taal is opgegeven. Wij overrulen die business rule. Wij raden sterk aan om taalcodes te gebruiken.
Type dataset
2BA ondersteunt complete of update (mutatie) bestanden van ETIM xChange. Een complete dataset dient alle actieve producten en artikelen te bevatten. Een nieuw volledig bestand overschrijft namelijk alle records in de database! Gebruik CatalogueType om de dataset als een volledig of mutatie bestand te definiëren. Bestaande productrecords die niet in het volledige bestand aanwezig zijn, worden voorzien van statuscode 130 als “vervallen product”. Bestaande handelsrecords die niet in het volledige bestand aanwezig zijn worden verwijderd.
- CatalogueType FULL: volledig bestand.
- CatalogueType CHANGE: mutatie bestand.
Het advies is om te werken met volledige datasets. Door te werken met volledige datasets blijft de gepubliceerde data het meest gelijk aan uw brondata. Heeft u een dusdanig groot assortiment met een groot aantal bijlagen en geregeld wijzigingen dan adviseren wij te werken mutatiebestanden en periodiek een compleet bestand te publiceren.
ETIM Classificatie
Land specifieke kenmerken
Vanaf ETIM versie 8 is het mogelijk land specifieke kenmerken te communiceren. ETIM xChange 1.0 ondersteunt deze functionaliteit niet. Wij hebben op voorhand een aanpassing in het importschema gemaakt om landspecifieke kenmerken wél te kunnen verwerken binnen de datapool.
ETIM versie notering
Raadpleeg hier de mapping van de ETIM versie versus datamodel. Binnen de ETIM xChange documentatie wordt aangegeven dat de EtimDynamicReleaseDate verplicht is wanneer de ETIM versie ‘DYNAMIC’ wordt opgegeven. Binnen de datapool overrulen wij die businessrule.
Reason no value
Als een waarde niet kan worden toegekend, heeft de dataleverancier volgens de ETIM-richtlijn de mogelijkheid om een minteken te gebruiken. Waarden met een minteken worden niet geïmporteerd. Gebruik in plaats daarvan een van de volgende redenen:
- NA; Niet van toepassing (deze functie is niet van toepassing in de context van een product in deze klasse).
- MV; Ontbrekende waarde (een alfanumerieke functie is relevant, maar er bestaat geen juiste waarde in deze ETIM-versie).
- UN; Onbekend (momenteel kan de dataleverancier geen waarde specificeren; maar in principe is het mogelijk).
Statuscode
Binnen het model bestaat ook een mutatiecode op regelniveau. Met de ETIM xChange standaard kan deze waarde niet aangeleverd worden. Er is wel een mutatiecode op bestandsniveau. Daarnaast is op regelniveau een statuscode gedefinieerd. De combinatie van beide codes wordt op de volgende manier geïnterpreteerd:
- Type dataset: mutatie (CHANGE):
- Alle productrecords inlezen met mutatiecode: 3 (wijzigen).
- Artikelrecords met statuscode 125, 126, 94E naar mutatiecode: 3 (wijzigen).
- Artikelrecords met statuscode 130 naar mutatiecode: 2 (verwijderen).
- Type dataset: compleet (FULL):
- Alle artikelen inlezen met (model) mutatiecode: 1 (toevoegen/nieuw).
- Alle producten inlezen met (model) mutatiecode:1 (toevoegen/nieuw).
Logistieke gegevens
De logistieke gegevens zijn binnen ETIM xChange alleen opgenomen in de artikel sectie.
Aandachtspunten:
- StandardOrderLeadTime is gemapped naar minimale levertijd. ETIM xChange 1.0 ondersteunt maximale levertijd niet. Naar verwachting zal dit in een volgende versie mogelijk zijn. Als levertijd worden kalenderdagen verwacht, geen werkdagen.
- Verpakkingscode C62 wordt geïmporteerd als ‘onverpakt’ (code NE).
Prijs- en bestelgegevens
Bij het uitwisselen van artikelgegevens is het van uitermate groot belang dat het duidelijk is hoe men het artikel kan bestellen (minimum afname, stapgrootte en eenheid afname), wat de prijs is van het artikel (prijs en/of omrekenprijs) en de hoeveelheid wat het artikel representeert (het aantal gebruikseenheden).
Aandachtspunten:
- De artikel afnamegroep is verplaatst naar productniveau.
- In tegenstelling tot ETIM xChange zijn de volgende velden verplicht:
- Ordering/useunit > mapping model
- Ordering/UseUnitConversionFactor > mapping model
- Pricing/PriceUnitFactor > mapping model
- Pricing/PriceOnRequest > mapping model
- Price/PriceValidityDate > mapping model
Omschrijving, merk, serie en type
Met een goede omschrijving wordt het duidelijk om welk product het gaat. Afnemers gebruiken deze binnen de (web)catalogus, op transactieberichten en binnen de calculaties. Daarnaast kan op basis van de omschrijving het artikel of product ook gevonden worden. De branchestandaard kent twee omschrijvingsvormen: kort en lang, daarnaast is er ruimte voor een uitgebreide marketing tekst.
Aandachtspunten:
- ETIM xChange 1.0 ondersteunt geen marketingtekst op artikelniveau. De ProductMarketingText wordt hier bij het importeren overgenomen naar het artikel.
- ETIM xChange 1.0 ondersteunt geen deeplinks op artikelniveau. De ProductPage wordt hier bij het importeren overgenomen naar het artikel.
Merk,serie en type
Groothandelaren gebruiken de structuur van merk, serie, type als filtermethode en zoekmachineoptimalisatie (SEO), bijvoorbeeld op hun webshop. Om deze reden zijn deze velden verplicht voor elk productrecord. Sommige fabrikanten gebruiken geen serie- en typegroepering. Gebruik in dit geval de waarde RNV_NA. Meer informatie klik hier.
Gevaarlijke stoffen en certificaten
Er is binnen ETIM xChange 1.0 geen specifieke certificaatstructuur opgenomen. Wanneer het type van een bijlage certificaat gerelateerd is, dan wordt waar mogelijk een certificaat record gegenereerd.
Bijlagen
Standaard zal de importroutine een bijlage downloaden en toevoegen aan de productdata. Vanwege de verschillende exportformaten worden de vooraf gedefinieerde waarden (ATX-codes) toegewezen aan de bijlagetype codelijst.
Bestandshash en OriginalFileSource
De importroutine creëert van elk gedownload bestand automatisch een MD5 Hash. Een MD5 Hash maakt het mogelijk om te determineren of het om een nieuw bestand of een duplicaat gaat. ETIM xChange 1.0 bevat geen mogelijkheid om de MD5 Hash en OriginalFileSource te specificeren.
Aandachtspunten:
- Standaard wordt er een bijlage gedownload en toegevoegd aan de productgegevens. Mocht er een bijlage als verwijzing naar de bron (URL) moeten blijven, dan kan dit buiten het uitwisselingsformaat geregeld worden via de parameter.xml KeepMimeURL. Per ATX-code kan worden aangegeven of de originele bron behouden moet blijven.
- ETIM xChange 1.0 bevat geen mogelijkheid om de afbeelding gerelateerde bijlagen te typeren als lage (PPI) of hoge (PHI) resolutie.
- Indien er gebruik wordt gemaakt van de AttachmentUri dan wordt, conform de ETIM Guideline, het volledige pad verwacht.
- Per bijlage kan middels de AttachmentLanguage een taalcode opgegeven worden in welke taal de content geschreven is. Als de taalcode niet is opgegeven, wordt de opgegeven headertaalcode gebruikt. met uitzondering van de bijlagetypen (afbeeldingen): ATX002, ATX011, ATX014, ATX015, ATX018.
Productreferenties en -relaties
In het datamodel worden de referenties en relaties alleen op productniveau gemapped, niet op artikelniveau.
Aandachtspunten:
ETIM xChange gaat bij een opgegeven hoeveelheid uit van een impliciete eenheid; aangezien het een artikel (of product) naar artikel (of product) relatie wordt uitgegaan van stuks (PCE). Een onderdeel of toebehoor van een product kan worden gespecifieerd met relatietype ‘SELECT.’
