ETIMxChange

ETIMxChange 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. ETIMxChange 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.

Actuele versie: 1.0
  • 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 ETIMxChange 1.0 (release 2024-02-19) treft u aan in de downloadsectie van ETIM International.

Planning implementatie 2BA

Gezien de impact op het 2BA datamodel en planning is de implementatie gefragmenteerd in:

  • Import fase 1 | gereed
    1. Import beperkt tot huidige 2BA datamodel + subtree LcaEnvironmental
    2. Schema validatie nog niet beschikbaar
  • Import fase 2 | gereed
    1. Import minor verbeteringen
    2. Schema validatie
  • Import fase 3 | medio september 2024
    1. Selectief aantal nieuwe velden, te herkenning in de mapping
  • Export | medio juli 2024

Known Issues

Product
  • Land van productie ontbreekt
  • 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 ProductPageURL

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:

Validatie

Er is nog geen validatiemogelijkheid beschikbaar.

Land specifieke elementen

Het kan voorkomen dat een land meer velden nodig heeft dan oorspronkelijk beschikbaar in de ETIMxChange structuur. De ETIMxChange 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.

NL CHARACTERISTICNaamOmschrijving
NL_002-1DIN-nummer
NL_002-2ISO-nummer
NL_007Minimale levertijd
NL_011Afnamegroep
NL_012Indicator bestelbaar
NL_014Indicator breekbaar op verpakking
NL_015Indicator THT op verpakking
NL_016-1Indicator versnijdbaar artikel
NL_016-2Maximaal versnijdbare lengte
NL_018Code BTW-tarief

Root tree

De header van ETIMxChange 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
  1. NameDataCreator wordt overgenomen in de verwerkingsrapportages.
  2. SupplierIdGln voor de aangeleverde partij.
  3. Bijlagen worden op header niveau niet geïmporteerd.
  4. CatalogueValidityStart wordt niet geïmporteerd.
  5. De in Languagecode eerst genoemde waarde wordt gebruikt voor taalafhankelijke velden waarbij geen taalcode is opgegeven. Dit is conform BMEcat werking. Conform ETIMxChange 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 ETIMxChange. 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.

  1. CatalogueType FULL: volledig bestand.
  2. 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. ETIMxChange 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 ETIMxChange 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 ETIMxChange standaard kan deze waarde niet aangeleverd worden. Er is wel een mutatiecode op bestandsniveau (voor zowel het artikel- als productbericht). 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 ETIMxChange alleen opgenomen in de artikel sectie.

Aandachtspunten:

  1. StandardOrderLeadTime is gemapped naar minimale levertijd. ETIMxChange 1.0 ondersteunt maximale levertijd niet. Naar verwachting zal dit in een volgende versie mogelijk zijn. Als levertijd worden kalenderdagen verwacht, geen werkdagen.
  2. Verpakkingscode C62 wordt naast verpakkingscode NE geïmporteerd als ‘onverpakt’.

Prijs- en bestelgegevens

Per artikel kan worden gedefinieerd hoe het artikel besteld kan worden, op welke eenheid de prijs gebaseerd is, in welke kortingsgroep het artikel valt en hoe het artikel gebruikt kan worden.

Aandachtspunten:
  1. De artikel afnamegroep is verplaatst naar productniveau.
  2. In tegenstelling tot ETIMxChange zijn de volgende velden verplicht:
    1. Ordering/useunit > mapping model
    2. Ordering/UseUnitConversionFactor > mapping model
    3. Pricing/PriceUnitFactor > mapping model
    4. Pricing/PriceOnRequest > mapping model
    5. 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:
  1. ETIMxChange 1.0 ondersteunt geen marketingtekst op artikelniveau. De ProductMarketingText wordt hier bij het importeren overgenomen naar het artikel.
  2. ETIMxChange 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 ETIMxChange 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 (MD-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. ETIMxChange 1.0 bevat geen mogelijkheid om de MD5 Hash en OriginalFileSource te specificeren.

Aandachtspunten:
  1. 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.
  2. ETIMxChange 1.0 bevat geen mogelijkheid om de afbeelding gerelateerde bijlagen te typeren als lage (PPI) of hoge (PHI) resolutie.
  3. Indien er gebruik wordt gemaakt van de AttachmentUri dan wordt, conform de ETIM Guideline, het volledige pad verwacht.
  4. 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:

ETIMxChange 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.’

Wat biedt 2BA voor u als Installateur Wat biedt 2BA voor u als Groothandel Wat biedt 2BA voor u als Fabrikant Wat biedt 2BA voor u als Software Partner
This site is registered on wpml.org as a development site.