Artikelbericht
Versie: Procesbeschrijving SALES005 v1.0.1
Met het artikelgegevensbericht geeft de leverancier o.a. aan welke artikelen hij in zijn catalogus heeft staan, in welke verpakkingsvorm, met welke GTIN (GS1artikelcode), voor welke prijs en ook kunnen variabelen en/of bewerkingen worden meegestuurd. Het artikelbericht bevat daarnaast informatie over de besteleenheid, de prijseenheid en de gebruikseenheid. De technische eigenschappen worden gecommuniceerd via het productbericht.
1 Algemene spelregels voor het artikelbericht
- De leverancier is de bron van de handelsinformatie. De uitwisseling van artikelgegevens kan op twee manieren plaatsvinden:
- De afnemer geeft aan welke gegevens hij van de leverancier wil ontvangen en doet hiervoor een aanvraag bij de leverancier;
- De leverancier bevestigt de gemaakte afspraken door het artikelbericht aan de afnemer te sturen.
- Het artikelbericht wordt niet alleen gebruikt om prijsmutaties door te geven, maar ook om te bevestigen of een artikel wel of niet (meer) leverbaar is. Daarnaast kunnen er ook wijzigingen plaatsvinden in de logistieke eigenschappen;
- Aan mutaties is altijd een ingangsdatum gekoppeld. Voor de juiste verwerking van de gegevens is het van belang dat de gegevens op tijd tussen de leverancier en afnemer worden uitgewisseld;
- De betalingsvoorwaarden en de meeste leveringsvoorwaarden zijn niet in het artikelbericht opgenomen. Deze worden geacht eenmalig tussen afnemer en leverancier te zijn overeengekomen;
- Bij een algehele wijziging van het btw-tarief (bijvoorbeeld van 19% naar 21%) verzendt de leverancier geen artikelmutaties. De afnemer wordt geacht deze mutaties op eigen initiatief te wijzigen. Indien het een beperkte wijziging in het btw-tarief betreft (bijvoorbeeld een wijziging van artikelen van laag btw-tarief naar hoog btw-tarief), verzendt de leverancier wel artikelmutaties aan de afnemer;
- Kortingen zijn altijd van toepassing op de brutoprijs, nooit op de nettoprijs;
- Indien de brutoprijs wordt doorgegeven, moet de ontvanger aan de hand van de brutoprijs en de kortingen en toeslagen de nettoprijs kunnen berekenen;
- Als de adviesprijs wordt meegegeven is deze informatief;
- Indien bilateraal wordt uitgewisseld kan er een nettoprijs worden meegegeven;
- De opgegeven levertijden zijn informatief waaraan geen rechten kunnen worden ontleent.
2 Algemene artikelbericht
Bij de algemene artikelgegevens betreft het handelsinformatie over de artikelen die de leverancier in zijn catalogus heeft opgenomen. Hierbij gaat het om technische condities en gegevens als de GTIN, de artikelcode, de verpakkingsvorm, de artikelomschrijving, de minimale afname en algemene prijsinformatie/ wijzigingen (wijzigingen in prijzen, kortingen en toeslagen op bestaande artikelen) etc. De algemene artikelgegevens betreft catalogusinformatie die voor alle afnemers identiek is.
2.1 Spelregels bij het scenario 'algemene artikelgegevens'
Deze paragraaf beschrijft de spelregels die van toepassing zijn op het scenario waarin algemene artikelgegevens worden uitgewisseld.
De volgende spelregel geldt voor het uitwisselen van algemene artikelgegevens:
- De leverancier kan voor algemene handelsinformatie, onder bepaalde voorwaarden, te allen tijde aangeven dat deze informatie niet meer geldig is (mutatie code).
2.2 Stappenplan
Hieronder staat in welke volgorde u de verschillende stappen binnen dit scenario moet doorlopen:
- De leverancier geeft met de mutatiecode 'wijziging' of 'origineel' aan of in het bestand alleen de wijzigingen worden uitgewisseld of dat het actuele bestand wordt uitgewisseld (eventueel vervallen artikelen komen hierin niet in voor);
- Bij het uitwisselen van wijzigingen kan de leverancier vervolgens aangeven of het artikel inlopend, nieuw/beschikbaar (actueel), vervallen of uitlopend is;
- De afnemer neemt de gemuteerde artikelgegevens over in zijn systeem.
Het is ook mogelijk om algemene artikelgegevens via een datapool uit te wisselen. De leverancier voert eenmalig in een datapool zijn artikelgegevens in en maakt deze kenbaar aan de afnemers. Mutaties levert de leverancier zelf aan bij een datapool en de afnemer kan zelf zijn artikelbestanden up-to-date houden via een datapool.
3 Afnemerspecifiek artikelbericht
Bij de afnemerspecifieke berichten wordt het artikelbericht bilateraal uitgewisseld tussen leverancier en afnemer. De voorwaarden zijn vastgelegd in een contract tussen de afnemer en leverancier. Dit artikelbericht is specifiek per afnemer. Ook hier worden technische condities en gegevens als de GTIN, de artikelcode, de verpakkingsvorm, de minimale afname en prijsinformatie/-wijzigingen (wijzigingen in prijzen, kortingen en toeslagen op bestaande artikelen) uitgewisseld, echter is deze informatie specifiek geldend voor één afnemer.
3.1 Spelregels bij het scenario 'afnemerspecifieke artikelgegevens'
Deze paragraaf beschrijft de spelregels die van toepassing zijn op het scenario waarin afnemerspecifieke artikelgegevens worden uitgewisseld. Hieronder volgen de spelregels voor het uitwisselen van afnemerspecifieke artikelgegevens:
- Bij afnemerspecifieke artikelgegevens ligt altijd een contract tussen afnemer en leverancier ten grondslag;
- Overeengekomen prijsgegevens worden inclusief artikelgegevens verstrekt;
- Artikelen kunnen toegevoegd, gewijzigd of verwijderd worden, binnen de overeengekomen afspraken;
- Bij wijzigingen van de levercondities (GTIN en/of artikelcode leverancier blijft gelijk) worden altijd alle gegevens voor een artikel doorgegeven en dus niet alleen de gewijzigde gegevens.
3.2 Stappenplan
Hieronder staat in welke volgorde u de verschillende stappen binnen dit scenario moet doorlopen:
- De leverancier en afnemer hebben in een contract prijzen en condities vastgesteld met betrekking tot de artikelen die de leverancier aanbiedt aan deze specifieke afnemer;
- De leverancier geeft met de mutatiecode 'wijziging' of 'origineel' aan of in het bestand alleen de wijzigingen worden uitgewisseld (nadat deze wijzigingen contractueel zijn overeengekomen) of dat het actuele bestand wordt uitgewisseld (vervallen artikelen komen hier niet in voor);
- Bij het uitwisselen van wijzigingen kan de leverancier vervolgens aangeven of het product inlopend, nieuw/beschikbaar (actueel), vervallen, geschorst, of uitlopend is. De status “vernietig publicatie” geeft aan dat foutieve data verwijderd kan worden;
- De afnemer neemt de gemuteerde artikelgegevens over in zijn bestand.
Deze gegevens kunnen afwijken van de algemene artikelgegevens die de leverancier heeft uitgestuurd (andere kortingen, toeslagen, verpakkingen, levercondities).
3.3 Status en mutatiecode
Om de artikelrecords met onderliggende handelsgegevens van afnemer en leverancier gesynchroniseerd te houden moet het voor de ontvanger van het artikelbericht duidelijk zijn hoe de ontvangen informatie te verwerken is. De mutatiecode kan op berichtniveau worden aangegeven; de mutatie geldt voor alle producten of artikelen die in het bericht zijn opgenomen. De statuscode wordt toegepast om aan te geven wat in de overgangsfase gebeurt bij het wijzigen van een product met onderliggende handelsgegevens.
Op berichtniveau in het artikelbericht kan via de mutatiecode de aard van de wijziging voor het assortiment worden aangegeven:
Tabel 1 - Mutatie op berichtniveau
| Mutatiecode | Betekenis |
|---|---|
| 4 | Wijziging (alleen de mutaties worden uitgewisseld) |
| 9 | Origineel (het totale actuele bestand wordt uitgewisseld) |
Op regelniveau wordt een statuscode toegepast om informatie te geven over de mutatie:
Tabel 2 - Statuscode op regelniveau
| Statuscode | Betekenis |
|---|---|
| 125 | Artikel is inlopend: het artikel zal t.z.t. worden genomen in de catalogus |
| 126 | Nieuw/beschikbaar |
| 94E | Het artikel is uitlopend: het artikel zal t.z.t. niet meer leverbaar zijn. In dit geval kan ook een ‘opvolger’ worden opgenomen. |
| 130 | Vervallen |
| 155 | Vernietig publicatie |
| 175 | Geschorst (bv. seizoensartikelen) |
4 Gebruik van eenhedendriehoek
Bij het uitwisselen van artikelgegevens wordt meegegeven hoe men het artikel kan bestellen (minimum afname, stapgrootte en eenheid afname), wat de prijs is van het artikel (prijs en/of omrekenprijs) en wat men ontvangt (het aantal gebruikseenheden).
Om spraakverwarring te voorkomen worden de volgende definities binnen de SALES Standaard gebruikt:
- Besteleenheid: De besteleenheid en de eenheid van de minimale afname zijn gelijk. De besteleenheid kan bijvoorbeeld ‘doos’ zijn, de eenheid van de minimale afname is dan ook ‘doos’ en niet ‘x’ keer de inhoud van die doos. De minimum afname is het aantal besteleenheden van het artikel dat minimaal moet worden afgenomen bij een bestelling. De besteleenheid is gekoppeld aan de GTIN en de stapgrootte. De besteleenheid is dus gerelateerd aan de artikeldata en niet aan de productdata; Voorbeeld: GTIN = omdoos met 12 lampen. De besteleenheid is dan ‘omdoos’, de minimunafname is dan ook een getal wat x keer de omdoos weergeeft. Bij een minimumafname van 1 krijgt men dus 12 lampen, bij 2 worden dat er 24 etc.
- Gebruikseenheid: De gebruikseenheid is de eenheid waarin de gebruiker het product toepast in de praktijk (zie codelijst). 'Ik heb voor deze klus x meter of y liter of z stuks nodig';
- Prijseenheid: De prijs van een artikel wordt uitgedrukt in een valuta-eenheid en de prijseenheid bepaalt vervolgens aan welke eenheid de vermelde prijs is gerelateerd. Een artikel kost bijvoorbeeld 12,50 euro per 4 meter. Om afrondingsverschillen te voorkomen wordt geadviseerd om een macht van 10 te gebruiken voor de prijsbasis; dus per 1, per 10 of per 100.
Voor het omrekenen van de prijseenheid naar een besteleenheid wordt gewerkt met een omrekenfactor. Dit is het verhoudingsgetal tussen bijvoorbeeld de prijseenheid en de besteleenheid. Het is een omrekenfactor tussen twee eenheden (het aantal eenheden blijft hier buiten beschouwing). Het doel van Factor A is om de prijs per besteleenheid te berekenen. Factor B is het aantal gebruikseenheden, en geeft de verhouding tussen de gebruikseenheid en besteleenheid weer. Factor C geeft dan de verhouding tussen prijseenheid en de gebruikseenheid weer.
Figuur 1 - Omrekenfactor prijseenheid, gebruikseenheid en besteleenheid
De bovenstaande eenheden zijn voor de installateur en aannemer of onderaannemer van groot belang. Alternatieve eenheden kunnen meegestuurd worden om te voorzien in extra informatie ten behoeve van calculatie. De genoemde alternatieve eenheid slaat altijd op het artikel en hebben een directe relatie met de bovenliggende eenheid: Voorbeeld voor isolatieplaten: gebruikerseenheid “ 6 stuks” en alternatieve gebruikerseenheid “3 m2”. Dit betekent dat er 3m2 in een pak zit (en dus niet dat één plaat 3m2 is).
Om de diverse onderdelen van de driehoek te kunnen berekenen worden de volgende formules gebruikt:
Verhouding Besteleenheid en Prijseenheid
Factor A = Besteleenheid / Prijseenheid
Prijseenheid = Besteleenheid /(Factor A)
Besteleenheid = Prijseenheid × Factor A
Verhouding Besteleenheid en Gebruikseenheid
Factor B=Besteleenheid/Gebruikseenheid
Factor B staat gelijk aan het aantal gebruikseenheden binnen een besteleenheid, weergegeven in het veld <QuantityOfUseUnits> in het artikelbericht.
Gebruikseenheid = Besteleenheid / (Factor B)
Besteleenheid = Gebruikseenheid × Factor B
Verhouding Prijseenheid en Gebruikseenheid
Factor C = Gebruikseenheid / Prijsseenheid
Prijseenheid = Gebruikseenheid / (Factor C)
Gebruikseenheid = Prijseenheid × Factor C
Overige formules
De prijs van 1 (minimale) besteleenheid berekenen we op de volgende manier:
Prijs van de minimale bestelhoeveelheid = (Minimum afname × Factor A × Prijs) / (Aantal in prijsbasis)
de prijs van 1 gebruikseenheid berekenen we op de volgende manier:
Prijs van de gebruikseenheid = (Factor C × Prijs) / (Aantal in prijsbasis)
Factor C kan ook berekend worden door de volgende formule:
Factor C = (Factor A) / (Aantal gebruikseenheden)
Oftewel:
Factor C = (Factor A) / (Factor B)
Met de onderstaande voorbeelden geven we inzicht in de combinaties die voor kunnen komen bij het uitwisselen van de artikelgegevens. Elk voorbeeld brengt zijn eigen moeilijkheden met zich mee bij het bepalen van de juiste waarden in de driehoek. Als echter de bovenstaande formules strikt worden gevolgd zal de data op een eenduidige manier verwerkt kunnen worden. De samenvatting na elk voorbeeld probeert inzage te geven zoals software aan de ontvangende kant de geleverde gegevens zal interpreteren.
Voorbeeld 1 betreft een pak isolatieplaten
De moeilijkheid bij dit voorbeeld zit hem in het feit dat de eenheden van calculatie (vierkante meters) afwijken van de levereenheden (pakken) en gebruikseenheden (platen). In het artikelbestand zijn alle gegevens aanwezig om de diverse omrekeningen te kunnen maken.
Voorbeeld 2 betreft een doos schroeven
Dit voorbeeld behandelt een doos schroeven welke een andere prijseenheid hebben dan er in de verpakking zit. Verwarring ontstaat vaak bij de berekening van factor C, het lijkt op basis van de getallen in de driehoek onlogisch om daar ‘1’ te noteren. Het gaat hier echter om de verhouding tussen de eenheden. Aangezien de eenheden van prijs en gebruik hetzelfde zijn komt hier de omrekenfactor ‘1’ uit.
Voorbeeld 3 betreft een doos met VD-draad
Dit voorbeeld is toegevoegd om inzicht te geven in de verkoopeenheden van meterwaren.
Voorbeeld 4 betreft een rol bladlood
Soms zijn prijseenheden, besteleenheden en gebruikseenheden verschillend van elkaar, ook hier kan in het artikelbericht in voorzien worden.
Voorbeeld 5 betreft een enkele klauwhamer
Het meest eenvoudige voorbeeld, als alle eenheden hetzelfde zijn, zijn alle factoren ‘1’. Echter de interpretatie in de generieke samenvatting leest wat vreemd maar is hoe software het zal interpreteren.
Voorbeeld 6 betreft een doosje schuurschijven
Factor C kan niet meegestuurd worden in het artikelbericht omdat er dan onherroepelijk afrondingsverschillen ontstaan, het voorbeeld schuurschijven geeft hier inzicht in.
4.1 Voorbeeld 1: Isolatieplaten
Het artikel betreft een pak isolatieplaten. Als het artikel besteld wordt dan moet er minimaal één pak worden afgenomen. In dit pak zitten zes isolatieplaten. De afnemer zal het aantal platen dat hij nodig heeft afleiden van het aantal m2 dat hij nodig heeft voor het werk. De prijs van het artikel wordt berekend op basis van het aantal m2 dat de afnemer bij de leverancier afneemt.
Tabel 3 - Omrekenfactor isolatieplaten
| Gegevens artikel | Eenhedendriehoek | Veld in XML-bericht | |
|---|---|---|---|
| Artikelnummer | 8712345678906 | <GTIN> | |
| Artikelcode leverancier | 1442112 | <SuppliersTradeItemId> | |
| Artikelomschrijving | Isolatieplaat, pak | <TradeItemDescription> | |
| Bestelcondities | |||
| Minimumafname | 1 | <MinimumOrderQuantity> | |
| Eenheid afname | PCE | Besteleenheid | <OrderUoM> |
| Omrekenfactor prijs-besteleenheid | 3,6 | Factor A | <PriceToOrderUnitFactor> |
| Gebruiksinformatie | |||
| Aantal gebruiks-eenheden | 6 | Factor B | <QuantityOfUseUnits> |
| Gebruikseenheid | PCE | Gebruikseenheid | <UseUnitUoM> |
| Omschrijving gebruikseenheid | Plaat | <UseUnitDescription> | |
| Verpakkingsinformatie | |||
| Code verpakking | PK | <PackageTypeCode> | |
| Prijsinformatie | |||
| Brutoprijs | € 20 | <GrossPrice> | |
| Aantal prijsbasis | 1 | <NumberOfUnitsInPriceBasis> | |
| Prijseenheid | MTK | Prijseenheid | <PriceBasisUoM> |
| Valuta-eenheid | EUR | <Currency> |
Dit voorbeeld wordt vertaald naar de volgende eenhedendriehoek:
Figuur 2 - Factoren van een pak isolatieplaten
Sommige factoren komen uit het SALES Artikelbericht, anderen worden berekend. Om de prijs van de minimumafname (het pak waarin zes platen zitten) te berekenen wordt de volgende formule toegepast:
Prijs van de minimale bestelhoeveelheid = (Minimum afname × Factor A × Prijs) / (Aantal in prijsbasis)
Prijs van de minimale bestelhoeveelheid = (1 ×3,6 × 20) / 1 = €72
De prijs van de enkele isolatieplaat bereken we dan als volgt, de Factor C (in dit voorbeeld is dat het aantal m2 per plaat) in de formule is vervangen door de formule waarmee deze factor berekend kan worden:
Prijs van de gebruikseenheid = (((Factor A) / (Aantal gebruikseenheden)) × Prijs) / (Aantal in prijsbasis)
Prijs van de gebruikseenheid = ((3,6 / 6) × 20) / 1 = €12
Samengevat:
Eén artikel is in dit geval één pak (PCE) met zes platen (PCE). Een pak met isolatieplaten heeft een brutoprijs van € 72,00. De minimale besteleenheid is één pak en kost dus €72,00. Eén plaat (gebruikseenheid) kost € 12,00.
4.2 Voorbeeld 2: Gipsplaatschroeven
Het artikel betreft zwarte gipsplaatschroeven die met 200 stuks in een kartonnen doos zitten. Als men de gipsplaatschroeven wil bestellen dan moeten er minimaal 2 dozen worden besteld. De prijs wordt berekend per 100 stuks schroeven. Extra aandacht voor het gebruik van de GTIN, deze hoort in dit geval bij het artikel “doos schroeven 200st” en niet bij het product “schroef”.
Tabel 4 - Omrekenfactor gipsplaatschroeven
| Gegevens artikel | Eenhedendriehoek | Veld in XML-bericht | |
|---|---|---|---|
| Artikelnummer | 8712345678913 | <GTIN> | |
| Artikelcode leverancier | 5678 | <SuppliersTradeItemId> | |
| Artikelomschrijving | Gipsplaatschroeven zwart a 200 st 3,5 X 35mm | <TradeItemDescription> | |
| Bestelcondities | |||
| Minimumafname | 2 | <MinimumOrderQuantity> | |
| Eenheid afname | PCE | Besteleenheid | <OrderUoM> |
| Omrekenfactor prijs-besteleenheid | 200 | Factor A | <PriceToOrderUnitFactor> |
| Gebruiksinformatie | |||
| Aantal gebruiks-eenheden | 200 | Factor B | <QuantityOfUseUnits> |
| Gebruikseenheid | PCE | Gebruikseenheid | <UseUnitUoM> |
| Omschrijving gebruikseenheid | schroef | <UseUnitDescription> | |
| Verpakkingsinformatie | |||
| Code verpakking | CT | <PackageTypeCode> | |
| Prijsinformatie | |||
| Brutoprijs | € 2 | <GrossPrice> | |
| Aantal prijsbasis | 100 | <NumberOfUnitsInPriceBasis> | |
| Prijseenheid | PCE | Prijseenheid | <PriceBasisUoM> |
| Valuta-eenheid | EUR | <Currency> |
Dit voorbeeld wordt vertaald naar de volgende eenhedendriehoek:
Figuur 3 - Omrekenfactor gipsplaatschroeven
Om de prijs van de minimumafname, twee dozen waarin 200 gipsplaatschroeven zitten te berekenen, kan de volgende formule worden toegepast:
Prijs van de minimale bestelhoeveelheid = (Minimum afname × Factor A × Prijs) / (Aantal in prijsbasis)
Prijs van de minimale bestelhoeveelheid = (2 × 200 × 2) / 100= €8
De prijs van één gebruikseenheid, welke één schroef is, kan als volgt berekend worden:
Prijs van de gebruikseenheid = (((Factor A) / (Aantal gebruikseenheden)) × Prijs) / (Aantal in prijsbasis)
Prijs van de gebruikseenheid = ((200 / 200) × 2) / 100 = €0,02
Samengevat:
Eén artikel is in dit geval 1 doos (PCE) met 200 schroeven (PCE). Een doos met schroeven heeft een brutoprijs van € 4,00. De minimale besteleenheid is 2 dozen en kost dus €8,-. Eén schroef (gebruikseenheid) kost € 0,02.
4.3 Voorbeeld 3: VD-draad
Het artikel betreft een VD-draad. Het artikel kan besteld worden per kartonnen doos waarin 100 meter VD-draad zit. De afnemer zal het draad dat hij nodig heeft afleiden van het aantal meter draad dat hij nodig heeft voor een werk. De verwerkingseenheid is gesteld op één meter.
Tabel 5 - Omrekenfactor VD-draad
| Gegevens artikel | Eenhedendriehoek | Veld in XML-bericht | |
|---|---|---|---|
| Artikelnummer | 8712345678920 | <GTIN> | |
| Artikelcode leverancier | 5814B | <SuppliersTradeItemId> | |
| Artikelomschrijving | VD-draad, 0.75mm2 | <TradeItemDescription> | |
| Bestelcondities | |||
| Minimumafname | 1 | <MinimumOrderQuantity> | |
| Eenheid afname | PCE | Besteleenheid | <OrderUoM> |
| Omrekenfactor prijs-besteleenheid | 100 | Factor A | <PriceToOrderUnitFactor> |
| Gebruiksinformatie | |||
| Aantal gebruiks-eenheden | 100 | Factor B | <QuantityOfUseUnits> |
| Gebruikseenheid | MTR | Gebruikseenheid | <UseUnitUoM> |
| Verpakkingsinformatie | |||
| Code verpakking | CT | <PackageTypeCode> | |
| Prijsinformatie | |||
| Brutoprijs | € 920 | <GrossPrice> | |
| Aantal prijsbasis | 1000 | <NumberOfUnitsInPriceBasis> | |
| Prijseenheid | MTR | Prijseenheid | <PriceBasisUoM> |
| Valuta-eenheid | EUR | <Currency> |
Dit voorbeeld wordt vertaald naar de volgende eenhedendriehoek:
Figuur 4 - Omrekenfactor VD draad
Om de prijs van de minimumafname (één doos met 100 meter VD-draad) te berekenen, wordt de volgende formule toegepast:
Prijs van de minimale bestelhoeveelheid = (Minimum afname × Factor A × Prijs) / (Aantal in prijsbasis)
Prijs van de minimale bestelhoeveelheid = (1 × 100 × 920) / 1000 = €92
De prijs van één gebruikseenheid (één meter VD-draad), wordt als volgt berekend:
Prijs van de gebruikseenheid = (((Factor A) / (Aantal gebruikseenheden)) × Prijs) / (Aantal in prijsbasis)
Prijs van de gebruikseenheid = ((920 / 1000) × 100) / 100 = €0,92
Samengevat:
Eén artikel is in dit geval 1 doos (PCE) met 100 meter draad (MTR). Een doos met draad heeft een brutoprijs van € 92,00. De minimale besteleenheid is één pak en kost dus €92,00. Éen meter (gebruikseenheid) kost € 0,92.
4.4 Voorbeeld 4: Bladlood
Het artikel betreft bladlood, 18 ponds met een gewicht van 18kg/m2. Het artikel kan besteld worden per stuk(rol) van 3,3 meter. De gebruikseenheid is ook in dit voorbeeld gesteld op één meter. De overige gegevens staan hieronder:
Tabel 6 - Omrekenfactor bladlood
| Gegevens artikel | Eenhedendriehoek | Veld in XML-bericht | |
|---|---|---|---|
| Artikelnummer | 8712345678937 | <GTIN> | |
| Artikelcode leverancier | 17 | <SuppliersTradeItemId> | |
| Artikelomschrijving | Bladlood, 18 pds, 250mm breed | <TradeItemDescription> | |
| Bestelcondities | |||
| Minimumafname | 1 | <MinimumOrderQuantity> | |
| Eenheid afname | PCE | Besteleenheid | <OrderUoM> |
| Omrekenfactor prijs-besteleenheid | 15 | Factor A | <PriceToOrderUnitFactor> |
|Gebruiksinformatie
|Aantal gebruiks-eenheden |3,3| Factor B| <QuantityOfUseUnits>|
|Gebruikseenheid |MTR |Gebruikseenheid |<UseUnitUoM>|
|Verpakkingsinformatie
|Code verpakking |NE ||<PackageTypeCode>|
|Prijsinformatie
|Brutoprijs |€ 616 || <GrossPrice>|
|Aantal prijsbasis |1000 || <NumberOfUnitsInPriceBasis>|
|Prijseenheid |KGM |Prijseenheid |<PriceBasisUoM>|
|Valuta-eenheid |EUR ||<Currency>|
Dit voorbeeld wordt vertaald naar de volgende eenhedendriehoek:
Figuur 5 - Omrekenfactor bladlood
Om de prijs van de minimumafname (één rol bladlood van 3,3 meter) te berekenen, wordt de volgende formule toegepast:
Prijs van de minimale bestelhoeveelheid=(Minimum afname ×Factor A ×Prijs)/(Aantal in prijsbasis)
Prijs van de minimale bestelhoeveelheid=(1 ×15 ×616)/1000=€9,24
De prijs van één gebruikseenheid (één strekkende meter bladlood), wordt als volgt berekend:
Prijs van de gebruikseenheid=(((Factor A)/(Aantal gebruikseenheden))×Prijs)/(Aantal in prijsbasis)
Prijs van de gebruikseenheid=((15/3,3)×616)/1000=€2,82
Samengevat: Eén artikel is in dit geval 1 rol (PCE) met 3,3 meter lood (MTR). Een rol met lood heeft een brutoprijs van € 9,24. De minimale besteleenheid is 1 rol en kost dus €9,24. Eén meter (gebruikseenheid) kost €2,82.
4.5 Voorbeeld 5: Klauwhamer
Het artikel betreft een klauwhamer, 35cm. Het artikel kan besteld worden per stuk.
Tabel 7 - Omrekenfactor klauwhamer
| Gegevens artikel | Eenhedendriehoek | Veld in XML-bericht | |
|---|---|---|---|
| Artikelnummer | 8712345678944 | <GTIN> | |
| Artikelcode leverancier | 48LP | <SuppliersTradeItemId> | |
| Artikelomschrijving | Klauwhamer, 35cm, grijs | <TradeItemDescription> | |
| Bestelcondities | |||
| Minimumafname | 1 | <MinimumOrderQuantity> | |
| Eenheid afname | PCE | Besteleenheid | <OrderUoM> |
| Omrekenfactor prijs-besteleenheid | 1 | Factor A | <PriceToOrderUnitFactor> |
| Gebruiksinformatie | |||
| Aantal gebruiks-eenheden | 1 | Factor B | <QuantityOfUseUnits> |
| Gebruikseenheid | PCE | Gebruikseenheid | <UseUnitUoM> |
| Verpakkingsinformatie | |||
| Code verpakking | NE | <PackageTypeCode> | |
| Prijsinformatie | |||
| Brutoprijs | € 8 | <GrossPrice> | |
| Aantal prijsbasis | 1 | <NumberOfUnitsInPriceBasis> | |
| Prijseenheid | PCE | Prijseenheid | <PriceBasisUoM> |
| Valuta-eenheid | EUR | <Currency> |
Dit voorbeeld wordt vertaald naar de volgende eenhedendriehoek:
Figuur 6 - Omrekenfactor klauwhamer
Om de prijs van de minimumafname (één stuks klauwhamer) te berekenen, wordt de volgende formule toegepast:
Prijs van de minimale bestelhoeveelheid = (Minimum afname ×Factor A × Prijs) / (Aantal in prijsbasis)
Prijs van de minimale bestelhoeveelheid = (1 × 1 × 8) / 1 = €8,00
De prijs van één gebruikseenheid (één stuks klauwhamer), wordt als volgt berekend:
Prijs van de gebruikseenheid = (((Factor A) / (Aantal gebruikseenheden)) × Prijs) / (Aantal in prijsbasis)
Prijs van de gebruikseenheid = ((1 / 1) × 8) / 1 = €8,00
Samengevat:
Eén artikel is in dit geval één hamer (PCE) met één hamer (PCE). Een hamer met hamer heeft een brutoprijs van € 8,00. De minimale besteleenheid is één hamer en kost dus €8,00. Eén hamer (gebruikseenheid) kost € 8,00.
4.6 Voorbeeld 6: Schuurschijven
Het artikel betreft een schuurschijven die met drie stuks in een kartonnen doos zitten. Als men de schijven wil bestellen dan moet er per vijf dozen worden besteld. De prijs wordt berekend per setje schijven.
Tabel 8 - Omrekenfactor schuurschijven
| Gegevens artikel | Eenhedendriehoek | Veld in XML-bericht | |
|---|---|---|---|
| Artikelnummer | 8712345678789 | <GTIN> | |
| Artikelcode leverancier | 8976 | <SuppliersTradeItemId> | |
| Artikelomschrijving | Schuurschijven, set van 3 stuks | <TradeItemDescription> | |
| Bestelcondities | |||
| Minimumafname | 5 | <MinimumOrderQuantity> | |
| Eenheid afname | PCE | Besteleenheid | <OrderUoM> |
| Omrekenfactor prijs-besteleenheid | 1 | Factor A | <PriceToOrderUnitFactor> |
| Gebruiksinformatie | |||
| Aantal gebruiks-eenheden | 3 | Factor B | <QuantityOfUseUnits> |
| Gebruikseenheid | PCE | Gebruikseenheid | <UseUnitUoM> |
| Omschrijving gebruikseenheid | schijf | <UseUnitDescription> | |
| Verpakkingsinformatie | |||
| Code verpakking | CT | <PackageTypeCode> | |
| Prijsinformatie | |||
| Brutoprijs | € 4,10 | <GrossPrice> | |
| Aantal prijsbasis | 1 | <NumberOfUnitsInPriceBasis> | |
| Prijseenheid | PCE | Prijseenheid | <PriceBasisUoM> |
| Valuta-eenheid | EUR | <Currency> |
Dit voorbeeld wordt vertaald naar de volgende eenhedendriehoek:
Figuur 7 - Omrekenfactor schuurschijven
Om de prijs van de minimumafname, vijf dozen waarin drie schuurschijven zitten te berekenen, kan de volgende formule worden toegepast:
Prijs van de minimale bestelhoeveelheid = (Minimum afname × Factor A × Prijs) / (Aantal in prijsbasis)
Prijs van de minimale bestelhoeveelheid = (5 × 1 × 4,10) / 1 = €20,50
De prijs van één gebruikseenheid, welke één schijf is, kan als volgt berekend worden:
Prijs van de gebruikseenheid = (((Factor A) / (Aantal gebruikseenheden)) × Prijs) / (Aantal in prijsbasis)
Prijs van de gebruikseenheid = ((1 / 3) × 4,10) / 1 = €1,37
Samengevat: Eén artikel is in dit geval één doos (PCE) met drie schijven (PCE). Een doos met schijven heeft een brutoprijs van € 4,10. De minimale besteleenheid is vijf dozen en kost dus €20,50. Eén schijf (gebruikseenheid) kost € 1,37.
5 Artikelhiërarchie
De artikelhiërarchie is de relatie tussen het product en de hogere artikelniveaus. Voor elke verpakking kan worden vermeld wat er in verpakt is.
Om de artikelhiërarchie te gebruiken is het nodig dat elke verpakking een eigen artikelcode heeft. Bij elke verpakking is aangegeven hoeveel stuks van het lagere niveau in de artikelhiërarchie ingesloten zijn. Het laagste niveau in de artikelhiërarchie is herkenbaar aan het ontbreken van een verwijzing naar een lagere/ingesloten verpakkingsvorm.
Aandachtspunten voor de artikelhiërarchie:
- Voor elk product wordt de gehele artikelhiërarchie gecommuniceerd, dus ook de niet-bestelbare tussenliggende niveaus;
- De artikelhiërarchie is ook bruikbaar voor combiverpakkingen, waarbij meerdere soorten artikelen in één verpakking aanwezig zijn;
- Vertaling van de berichten naar een intern bestand houdt in dat er binnen dat bestand een relatie is gedefinieerd tussen verschillende artikelen en verpakkingsvormen;
- Voor elke verpakking wordt altijd het aantal gebruikseenheden aangegeven.
5.1 Wijziging in de artikelhiërarchie
Als een artikel wijzigt, kan dat consequenties hebben voor andere artikelen in de artikelhiërarchie. Deze informatie dient te worden uitgewisseld met het artikelbericht:
- Een nieuw artikel leidt altijd tot een nieuwe artikelhiërarchie, waarbij alle hoger liggende artikelen eveneens een nieuwe GTIN hebben;
- Een bestaand artikel leidt eveneens tot het uitwisselen van de complete artikelhiërarchie, waarbij alle hoger liggende artikelen eveneens een nieuwe GTIN hebben.
Bij hoger liggende verpakkingen is via de artikelhiërarchie aangegeven hoeveel artikelen van het lagere niveau erin zijn verpakt. Op het laagste niveau (niveau 0) zijn enkel de producteigenschappen aangegeven dus, geen aantallen. Vanaf niveau 1 is van elke verpakking eenduidig het aantal gebruikseenheden te berekenen, zie figuur 8. Dit staat bekend als 'relatieve verwijzing'; vanuit de verpakking wordt verwezen naar de onderliggende verpakking. Daarnaast is het mogelijk om voor elke verpakking 'direct' het aantal gebruikseenheden aan te gegeven; dit staat bekend als absolute verwijzing'.
Voorbeeld van een artikelhiërarchie
Op elk verpakkingsniveau is de inhoud bekend door een verwijzing naar het ingesloten artikel en door het vermelden van de gebruikseenheid en het aantal gebruikerseenheden in de verpakking.
De veronderstelling bij dit voorbeeld is dat blisterverpakkingen niet los verkocht worden bij bestellingen tussen de fabrikant en de groothandel. Niveau 2 is dus niet bestelbaar voor de groothandel in dit voorbeeld. Niveau 2 is dus wel bestelbaar is in de relatie tussen de groothandel en de installateur.
| Niveau 3: Handelsartikel Doos Ledlamp 3 blisters van GTIN 08738023400014 ingesloten Bestelbaar GTIN 08721023454111 |  |
| Niveau 2: Handelsartikel Blister Ledlampen 6 stuks van GTIN 08762023400021 ingesloten Bestelbaar voor installateur Niet-bestelbaar voor de groothandel GTIN 08738023400014 |  |
| Niveau 1: Handelsartikel Verpakte Ledlamp 1 stuks van GTIN 08712023400008 ingesloten Bestelbaar GTIN 08762023400021 |  |
| Niveau 0: Product Onverpakte ledlamp (60W/230V, E27) Niet-bestelbaar GTIN 08712023400008 |  |
Figuur 8 - Voorbeeld van artikelhiërarchie
Dit betekent het volgende voor het opvoeren van artikelgegevens:
Tabel 9 - Opvoeren van artikelgegevens
| Niveau 1 Handelsartikel | Niveau 2 Handelsartikel | Niveau 3 Handelsartikel | |
|---|---|---|---|
| GTIN | 08762023400021 | 08738023400014 | 08721023454111 |
| Leveranciersomschrijving | Ledlamp, E27 | Ledlamp, E27 | Ledlamp, E27 |
| Bestelbaar | Ja | Ja | Ja |
| Besteleenheid | PCE (stuks) | PCE (stuks) | |
| Omrekenfactor prijs-naar besteleenheid | 1 | 1 | 1 |
| Minimumafname | 3 | 1 | 1 |
| Stapgrootte | 3 | 1 | 1 |
| Eenheid afname | PCE (stuks) | PCE (stuks) | PCE (stuks) |
| Levertijd | 1 | 1 | 1 |
| Eenheid levertijd | 804 (dagen) | 804 (dagen) | 804 (dagen) |
| Aantal gebruikseenheden | 1 | 6 | 18 |
| Gebruikseenheid | PCE (stuks) | PCE (stuks) | PCE (stuks) |
| Aantal prijseenheden per prijs | 1 | 1 | 1 |
| Prijseenheid | PCE (stuks) | PCE (stuks) | PCE (stuks) |
| Code verpakkingsvorm | CT | BME | |
| Brutogewicht | 120 | 750 | 2,4 |
| Eenheid gewicht | GRM | GRM | |
| Kortingsgroep | 75-456 | 75-498 | 75-487 |
| Aantal ingesloten artikelen | 1 | 6 | 3 |
| GTIN ingesloten artikel | 08712023400008 (productbericht) | 08762023400021 | 08738023400014 |
Op elk verpakkingsniveau is de inhoud bekend door een verwijzing naar het ingesloten artikel en door het vermelden van de gebruikseenheid en het aantal gebruikerseenheden in de verpakking.
6 Kortingen en toeslagen
Kortingen en toeslagen kunnen betrekking hebben op een individueel artikel in een orderregel of op de gehele order. De kortingen die gelden op de individuele artikelen (eventueel afhankelijk van de leverwijze) worden ondersteund in het artikelbericht. De volgende kortingssoorten en toeslagen kunnen worden vermeld in het artikelbericht:
- Kortingen ten opzichte van de brutoprijs zoals handelskorting/standaard korting en staffelkorting;
- Korting ten opzichte van brutoprijs bewerkingstoeslag;
- Additionele leverwijze afhankelijke kortingspercentages zoals afhaalkorting, korting magazijnlevering/rechtstreekse levering.
De volgende afspraken zijn opgesteld met betrekking tot het berekenen van een prijs vanuit brutoprijs en kortingen/toeslagen:
- Bij elk artikel kan aangegeven worden dat het tot een bepaalde kortingsgroep behoort. Alle artikelen in een kortingsgroep hebben één en hetzelfde kortingspercentage. De verschillende kortingen/toeslagen kunnen ook gespecificeerd worden. Dit is niet nodig indien het artikel tot een bepaalde kortingsgroep behoort. Worden de verschillende kortingen/toeslagen gespecificeerd terwijl er een kortingsgroep is aangegeven, dan geldt dat de korting als gevolg van de kortingsgroep genegeerd kan worden (de kortingsgroep wordt dus 'overruled');
- Handelskorting/standaardkorting wordt aangegeven als een bedrag ten opzichte van de brutoprijs of als een percentage van de brutoprijs;
- Een handelstoeslag/standaardtoeslag mag niet worden gehanteerd;
- De nettoprijs is een afgeleide van brutoprijs, brutoprijs bewerkingstoeslag, handelskorting/standaard korting en korting bewerkingstoeslag. Let op, er kunnen situaties voorkomen waarin alleen een nettoprijs gecommuniceerd wordt;
- Bij het gebruik van meerdere kortingen of meerdere toeslagen is gebruik van het volgnummer verplicht;
- Zowel het bruto als het netto prijsveld vullen is niet de bedoeling, is het wel het geval dan is het nettoprijsveld leidend en zijn de meegegeven kortingen/toeslagen uitsluitend ter informatie en controle;
- De brutoprijs in de prijslijst is gebaseerd op de prijseenheid (bijvoorbeeld één stuks), exclusief orderafhankelijke toeslagen en/of kortingen;
- Bij staffelkortingen geeft de leverancier per ondergrensstaffel het totale kortingspercentage van handelskorting en staffelkorting(en) ten opzichte van de brutoprijs en/óf het totaal kortingsbedrag van handelskorting en staffelkorting ten opzichte van de brutoprijs aan;
- Staffelkorting wordt altijd met code QD aangegeven;
- Indien zowel het kortingspercentage als het kortingsbedrag aanwezig is, dan is het percentage leidend en dient het kortingsbedrag als informatieveld. Dit geldt voor zowel staffelkorting als voor leverwijze afhankelijke kortingen;
- Staffeltoeslagen worden niet ondersteund;
- Of een korting rechtstreeks, een afhaalkorting of een korting magazijnlevering betreft, is afhankelijk van de manier waarop levering aan de afnemer vorm krijgt. Deze kortingen kunnen uitsluitend als bedrag en/of percentage worden aangegeven. Voor de berekening van de uiteindelijke prijs wordt eerst de prijs bepaald na toepassing van eerder genoemde kortingen (+ de bewerkingstoeslag met bijbehorende korting indien van toepassing). Bij de berekening van de uiteindelijke prijs zijn twee varianten te onderscheiden:
- Soort korting staffelkorting is meegegeven. In deze situatie moet de leverwijze afhankelijke korting over staffelkortingen worden berekend, dus: eerst de staffelkorting berekenen en daarover eventueel de leverwijze afhankelijke kortingen;
- Soort korting staffelkorting wordt niet meegegeven. In het artikelbericht mag dan geen korting (leverwijze afhankelijke) over korting (staffel) worden berekend;
- De prijs wordt bepaald op basis van het percentage/bedrag dat bij de betreffende ondergrens staffel is meegegeven;
- De uiteindelijke prijs van een product kan worden verhoogd met een bewerkingstoeslag, de brutoprijs bewerkingstoeslag in combinatie met een eventueel daarbij horende korting;
- De korting bewerkingstoeslag kan worden weergegeven als percentage van de brutoprijs bewerkingstoeslag óf als kortingsbedrag ten opzichte van de brutoprijs bewerkingstoeslag. Bij deze korting op de bewerkingstoeslag kan een ondergrens zijn ingesteld in het element ondergrensstaffel. De korting is dan alleen van toepassing indien meer prijseenheden worden afgenomen dan aangeven in de ondergrens.
6.1 Prijsbepaling
Om van een brutoprijs tot de nettoprijs te kunnen komen worden de kortingen en toeslagen losstaand van elkaar berekend.
Figuur 9 - Gesplitste berekening korting en toeslag
Hierbij worden een aantal rekenregels vastgesteld.
- Bij het opgeven van zowel een netto- als brutoprijs is de nettoprijs leidend;
- Meegegeven brutoprijs, kortingen en toeslagen zijn dan informatief en worden ter controle van de prijsvorming gebruikt. Ook bij het informatief meegeven dienen deze volledig te zijn;
- Als een korting of toeslag wordt meegegeven, is het vermelden een brutoprijs verplicht;
- Het grondslagbedrag om de nettoprijs te berekenen is de brutoprijs;
- Bij vermelding van meerdere kortingen of toeslagen op de artikelregel is het gebruik van een volgnummer verplicht. Voor correct gebruik zie Tabel 10;
- Bij gebruik van een volgnummer word opeenvolgend doorgerekend;
- De blokken kortingen en toeslagen worden apart van elkaar berekend en altijd ten opzichte van de brutoprijs;
- De kortingen en toeslagen worden verrekend met de brutoprijs om tot de nettoprijs te kunnen komen;
- Het vullen van zowel nettoprijs als brutoprijs wordt afgeraden.
Tabel 10 - Voorbeeld gebruik volgnummers
| Korting | Volgnummer | Toeslag | Volgnummer |
|---|---|---|---|
| QD | 1 | FC | 1 |
| ADO | 2 | AEM | 2 |
| TD | 3 | ADR | 3 |
| ADR | 4 |
Voorbeeld korting over korting:
Tabel 11 - Voorbeeld gebruik “korting over korting”
| Brutoprijs 100 euro | Geen korting | Handels korting | Staffel ondergrens 101 | Staffel ondergrens 1001 | Staffel ondergrens 10.000 | |
|---|---|---|---|---|---|---|
| 1 | Staffeling | |||||
| Kortingspercentage | 20% | 30% | 40% | 60% | ||
| Kortingsbedrag | 20 euro | 30 euro | 40 euro | 60 euro | ||
| Nettobedrag | 80 euro | 70 euro | 60 euro | 40 euro | ||
| 2a | Rechtstreeks leveren | |||||
| Kortingspercentage | +5% | +5% | +5% | +5% | +5% | |
| Kortingsbedrag | 5 euro | 4 euro | 3,50 euro | 3 euro | 2 euro | |
| Nettobedrag | 95 euro | 76 euro | 66,50 euro | 57 euro | 38 euro | |
| 2b | Afhalen | |||||
| Kortingspercentage | +10% | +10% | +10% | +10% | +10% | |
| Kortingsbedrag | 10 euro | 8 euro | 7 euro | 6 euro | 4 euro | |
| Nettobedrag | 90 euro | 72 euro | 63 euro | 54 euro | 36 euro |
Er is een order geplaatst voor de levering van 50 pakken verpakte platen isolatiemateriaal. De brutoprijs voor één pak bedraagt 20 euro. De kortingssoort voor staffelkorting is meegegeven. Er wordt dus gebruik gemaakt van korting (leverwijze afhankelijk) over korting (staffel). Op basis van de bovenstaande tabel levert dat per leveringsscenario de volgende nettoprijs op:
Tabel 12 - Nettoprijzen per leveringsscenario
| Brutoprijs 20 euro per pak | Rechtstreeks | Afhalen |
|---|---|---|
| Totale brutoprijs | 1.000 euro | 1.000 euro |
| Staffel 30% 300 euro | 300 euro | |
| Bedrag inclusief staffel | 700 euro | 700 euro |
| Korting levering | 5% | 10% |
| Kortingsbedrag levering | 35 euro | 70 euro |
| Totale nettoprijs | 665 euro | 630 euro |