Ga naar hoofdinhoud

UDE v2 Databerichten SALES005

Versie: Procesbeschrijving SALES005 v2.0

1 Het proces​

Het handelsproces begint met het uitwisselen van stamgegevens. In de DICO standaard kennen we het product- en artikelbericht van de SALES005. Binnen DICO wordt een product gedefinieerd als iets wat gebruikseigenschappen bezit en een artikel als iets wat handelseigenschappen bezit. Het artikel kent in deze context dus de eigenschappen die aangeven of iets gereviseerd of hergebruikt is en het product beschrijft de eigenschappen die generiek zijn en dus ook van toepassing zijn op een ‘nieuw’ artikel zoals afmetingen. Daarnaast behoren het conditiebericht en het itemrelatiebericht ook tot DICO Databerichten.

Gepubliceerde extensies binnen DataUDE:

  • XML structuur DataUDE in het Artikelbericht
  • XML structuur DataUDE in het Productbericht

Hierbij is het belangrijk op te merken dat de extensie altijd opgeroepen dient te worden door gebruik te maken van de volgende tag:

<UserDefinedExtension xmlns:data="http://www.ketenstandaard.nl/UDE/SALES/Data/v2" xsi:schemaLocation="http://www.ketenstandaard.nl/UDE/SALES/Data/v2 DataUDEv2.xsd">

Op deze manier wordt de XSD van de extensie ingeladen waardoor de extensie te valideren is en is tevens de enige juiste wijze om de extensie officieel te gebruiken.

In de desbetreffende deelhoofdstukken is de locatie van de extensie(s) in de betreffende berichten aangegeven.

1.1 Overzicht structuren in de DataUDE

In de data extensie zijn op dit moment de volgende sturcturen aanwezig:

  • TradeItemIndicators
  • Indicators
  • ValueDetail
  • ModelClassificationCharacteristics
  • VariableOrderConditions

2 UDE Structuren​

2.1 TradeItemIndicators​

De extensie bevat indicatoren die van toepassing zijn op het artikelbericht.

Techniek

De onderstaande extensie wordt in het artikelbericht meegeven op regelniveau. Alleen op deze locatie in het bericht wordt de TradeItemIndicatoren-extensie geplaatst.

  • De plaats van de extensie binnen het Artikelbericht is op de regel, xpath is: PriceCatalogue/Grouping/TradeItemLine/UserDefinedExtension

De volgende onderdelen van de extensie mogen binnen het Artikelbericht op deze plek gebruikt worden:

<TradeItemLine>
  <UserDefinedExtension xmlns:data="http://www.ketenstandaard.nl/UDE/SALES/Data/v2" xsi:schemaLocation="http://www.ketenstandaard.nl/UDE/SALES/Data/v2 DataUDEv2.xsd">
    <data:DataUDE>
      <data:TradeItemIndicators>
       <data:Refurbished>true</data:Refurbished>
       <data:Reused>true</data:Reused>
      </data:TradeItemIndicators>
    </data:DataUDE>
  </UserDefinedExtension>
</TradeItemLine>

Let op: voor het uitwisselen van stamgegevens van artikelen, volg de standaardregels van huidige XML berichten.

2.2 Indicators​

Met deze structuur is het mogelijk om flexibele indicatoren aan te maken. Een indicator die nog niet vastligt in het artikel en/of productbericht. Deze structuur speelt in op de vele verscheidingsvormen omtrent indicatoren.

<data:Indicator>
  <data:Type>OTH</data:Type>
  <data:TypeOther>CO2 Toeslag </data:TypeOther>
  <data:Value>false</data:Value>
</data:Indicator>

Let op: TypeOther is in dit geval een fictief voorbeeld

Op het veld Type zit een codelijst IndicatorsType, bij de code OTH wordt het mogelijk om een TypeOther aan te geven. De inhoud van het veld Value is vrij als TypeOther wordt gebruikt. Wordt TypeOther niet gebruikt en wordt een specifieke code aangeroepen in het veld Type dan kan de inhoud van het veld Value voorgeschreven in de definitie van de desbetreffende code.

Techniek

Deze extensie kan voorkomen in 2 berichten, namelijk het artikelbericht of het productbericht.

  • De plaats van deze extensie binnen het artikelbericht is op de regel, xpath is: PriceCatalogue/Grouping/TradeItemLine/UserDefinedExtension

  • De plaats van deze extensie binnen het productbericht is op de regel, xpath is: ProductData/ProductLine/UserDefinedExtension

De volgende onderdelen van de extensie mogen binnen het bericht op deze plek gebruikt worden (voorbeeld artikelbericht):

<TradeItemLine>
  <UserDefinedExtension xmlns:data="http://www.ketenstandaard.nl/UDE/SALES/Data/v2" xsi:schemaLocation="http://www.ketenstandaard.nl/UDE/SALES/Data/v2 DataUDEv2.xsd">
    <data:DataUDE>
      <data:Indicator>
        <data:Type> </data:Type>
        <data:TypeOther> </data:TypeOther>
        <data:Value> </data:Value>
        <data:CertificateReference> </data:CertificateReference>
        <data:AttachmentReference> </data:AttachmentReference>
      </data:Indicator>
    </data:DataUDE>
  </UserDefinedExtension>
</TradeItemLine>

2.3 ValueDetail​

De ValueDetail structuur maakt het mogelijk om voor een product extra waardes mee te geven. Per eigenschap kan één extra waarde (value) worden gegeven. Dus als er via het productbericht en de ETM structuur in dat bericht een "kleur" (ETIM code: EF000007) wordt meegegeven kan met de waarde "wit" (ETIM code EV000202), kan met extensie een extra waarde eraan worden gevoegd, bijvoorbeeld "wolkenwit". Per taal kan er slechts één valuedetail worden opgegeven.

Voorbeeld van het toepassen van ValueDetail:

<ProductClassificationCharacteristic>
  <InternationalCharacteristicCode>EF000007</InternationalCharacteristicCode>
  <InternationalCharacteristicCodeValue>EV000022</InternationalCharacteristicCodeValue>
  <UserDefinedExtension xmlns:data="http://www.ketenstandaard.nl/UDE/SALES/Data/v2" xsi:schemaLocation="http://www.ketenstandaard.nl/UDE/SALES/Data/v2 DataUDEv2.xsd">
    <data:DataUDE>
      <data:ValueDetail>
       <data:DetailValue>Wolkenwit</data:DetailValue>
       <data:LanguageCode>NL</data:LanguageCode>
      </data:ValueDetail>
      <data:ValueDetail>
       <data:DetailValue>Cloud white</data:DetailValue>
       <data:LanguageCode>EN</data:LanguageCode>
      </data:ValueDetail>
    </data:DataUDE>
  </UserDefinedExtension>
</ProductClassificationCharacteristic>

Techniek Deze extensie wordt geplaatst in het productbericht.

  • De plaats van de extensie binnen het productbericht is op ProductClassificationCharacteristic-niveau, xpath is: ProductData/ProductLine/ProductclassificationETIM/ProductClassificationCharacteristic/UserDefinedExtension

De volgende onderdelen van de extensie mogen binnen het bericht op deze plek gebruikt worden:

<ProductClassificationCharacteristic>
  <UserDefinedExtension xmlns:data="http://www.ketenstandaard.nl/UDE/SALES/Data/v2" xsi:schemaLocation="http://www.ketenstandaard.nl/UDE/SALES/Data/v2 DataUDEv2.xsd">
    <data:DataUDE>
      <data:ValueDetail>
        <data:DetailValue> </data:DetailValue>
        <data:LanguageCode> </data:LanguageCode>
      </data:ValueDetail>
    </data:DataUDE>
  </UserDefinedExtension>
</ProductClassificationCharacteristic>

2.4 ModelClassificationCharacteristics​

Door het ontstaan van Connection Types (CT) is het noodzakelijk om de huidige ETIM MC structuur los te trekken van de ETIM EC structuur in het productbericht. Om ETIM gegevens met CT juist uit te wisselen is een extensie beschikbaar. Deze extensie is gebaseerd op de structuur die ETIM International heeft opgesteld.

De werking van de extensie is gelijk aan die van de structuur in het productbericht.

Techniek

Deze extensie wordt geplaatst in het productbericht.

  • De plaats van de extensie binnen het productbericht is op ProductLine-niveau, xpath is: ProductData/ProductLine/UserDefinedExtension
<ProductLine>
  <UserDefinedExtension xmlns:data="http://www.ketenstandaard.nl/UDE/SALES/Data/v2" xsi:schemaLocation="http://www.ketenstandaard.nl/UDE/SALES/Data/v2 DataUDEv2.xsd">
    <data:DataUDE>
      <data:ModelClassificationCharacteristics>
        <data:ProductClass>
          <data:ClassCode> </data:ClassCode>
          <data:ClassVersion> </data:ClassVersion>
        </data:ProductClass>
        <data:ModellingClass>
          <data:ClassCode> </data:ClassCode>
          <data:ClassVersion> </data:ClassVersion>
        </data:ModellingClass>
        <data:BIMStatus> </data:BIMStatus>
        <data:Port>
          <data:PortCode> </data:PortCode>
          <data:ConnectionTypeCode> </data:ConnectionTypeCode>
          <data:ConnectionTypeVersion> </data:ConnectionTypeVersion>
          <data:ModellingClassFeature>
            <data:FeatureCode> </data:FeatureCode>
            <data:FeatureValue> </data:FeatureValue>
            <data:XCoordinate> </data:XCoordinate>
            <data:YCoordinate> </data:YCoordinate>
            <data:ZCoordinate> </data:ZCoordinate>
            <data:MatrixValues>
              <data:MatrixValue>
                <data:MatrixSourceValue> </data:MatrixSourceValue>
                <data:MatrixResultValue> </data:MatrixResultValue>
              </data:MatrixValue>
            </data:MatrixValues>
          </data:ModellingClassFeature>
        </data:Port>
      </data:ModelClassificationCharacteristics>
    </data:DataUDE>
  </UserDefinedExtension> 
</ProductLine>

2.5 VariableOrderConditions​

De structuur maakt het mogelijk om maatwerkproducten en artikelen op te geven. Denk daarbij aan de breedte en lengte van een tafelblad.

Voorbeelden:

  • Een tafelblad kan besteld worden met een lengte van 1000 mm – 2000 mm, in stapjes van 100 mm;
<data:VariableOrderConditions>
    <data:VariableCode>EF001438</data:VariableCode>
    <data:VariableDescription>Lengte</data:VariableDescription>
    <data:ValueType>N</data:ValueType>
    <data:NumericValueUoM>MMT</data:NumericValueUoM>
    <data:ValueRange>        
        <data:LowerNumericValue>1000</data:LowerNumericValue>
        <data:UpperNumericValue>2000</data:UpperNumericValue>
        <data:NumericValueStepSize>100</data:NumericValueStepSize>       
    </data:ValueRange>
</data:VariableOrderConditions>
  • Een vierkant luchtkanaal kan besteld worden met een breedte van 400 mm tot 1000 mm, en dat kan in stappen van 50 mm.
<data:VariableOrderConditions>
    <data:VariableCode>EF000008</data:VariableCode>
    <data:VariableDescription>Breedte</data:VariableDescription>
    <data:ValueType>N</data:ValueType>
    <data:NumericValueUoM>MMT</data:NumericValueUoM>
    <data:ValueRange>
        <data:LowerNumericValue>400</data:LowerNumericValue>
        <data:UpperNumericValue>1000</data:UpperNumericValue>
        <data:NumericValueStepSize>50</data:NumericValueStepSize>        
    </data:ValueRange>
</data:VariableOrderConditions>
  • Een verwarming kan besteld worden in 4 verschillende kleuren (wit, rood, blauw en zwart).
<data:VariableOrderConditions>
    <data:VariableCode>EF000007</data:VariableCode>
    <data:VariableDescription>Kleur</data:VariableDescription>
    <data:ValueType>A</data:ValueType>
    <data:ValueRange>
        <data:AlphanumericValue>RAL9010</data:AlphanumericValue>
        <data:AlphanumericValue>RAL9005</data:AlphanumericValue>
        <data:AlphanumericValue>RAL5015</data:AlphanumericValue>
        <data:AlphanumericValue>RAL3020</data:AlphanumericValue>
    </data:ValueRange>
</data:VariableOrderConditions>

Techniek Deze extensie kan voorkomen in 2 berichten, namelijk het artikelbericht of het productbericht.

  • De plaats van deze extensie binnen het artikelbericht is op de regel, xpath is: PriceCatalogue/Grouping/TradeItemLine/UserDefinedExtension

  • De plaats van deze extensie binnen het productbericht is op de regel, xpath is: ProductData/ProductLine/UserDefinedExtension

De extensie wordt binnen het bericht op deze plek gebruikt (voorbeeld artikelbericht):

  
<TradeItemLine>
  <UserDefinedExtension xmlns:data="http://www.ketenstandaard.nl/UDE/SALES/Data/v2" xsi:schemaLocation="http://www.ketenstandaard.nl/UDE/SALES/Data/v2 DataUDEv2.xsd">
    <data:VariableOrderConditions>
        <data:VariableCode> </data:VariableCode>
        <data:VariableDescription> </data:VariableDescription>
        <data:ValueType> </data:ValueType>
        <data:NumericValueUoM> </data:NumericValueUoM>
        <data:ValueRange>
            <data:AlphanumericValue> </data:AlphanumericValue>
            <data:LowerNumericValue> </data:LowerNumericValue>
            <data:UpperNumericValue> </data:UpperNumericValue>
            <data:NumericValueStepSize> </data:NumericValueStepSize>
        </data:ValueRange>
    </data:VariableOrderConditions>
  </UserDefinedExtension>
</TradeItemLine>