Ga naar hoofdinhoud

UDE v2 Materieelverhuur 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 de RentalUDE:

  • XML structuur RentalUDE in het Artikelbericht
  • XML structuur RentalUDE in het Orderbericht
  • XML structuur RentalUDE in het Orderbevestigingbericht
  • XML structuur RentalUDE in het Verzendbericht
  • XML structuur RentalUDE in het Factuurbericht

De RentalUDE is hieronder in zijn geheel te zien.

<UserDefinedExtension xmlns:rental="https://ontology.ketenstandaard.nl/DICO/UDE/Rental/v2" xsi:schemaLocation="https://ontology.ketenstandaard.nl/DICO/UDE/Rental/v2 RentalUDEv2.xsd">
  <rental:RentalUDE>
      <rental:Prices>
          <rental:PricePerRentalTime>
              <rental:PeriodQuantity> </rental:PeriodQuantity>
              <rental:PeriodUoM> </rental:PeriodUoM>
              <rental:MinimumOrderPeriod> </rental:MinimumOrderPeriod>
              <rental:PeriodMultiple> </rental:PeriodMultiple>
              <rental:Price> </rental:Price>
          </rental:PricePerRentalTime>
      </rental:Prices>
      <rental:WeekendInvoicing> </rental:WeekendInvoicing>
      <rental:ContinuesUse> </rental:ContinuesUse>
      <rental:RentalPeriod>
          <rental:FixedStartDateTime> </rental:FixedStartDateTime>
          <rental:FixedFinishDateTime> </rental:FixedFinishDateTime>
      </rental:RentalPeriod>
      <rental:StartRentalPeriod> </rental:StartRentalPeriod>
  </rental:RentalUDE>
</UserDefinedExtension>

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:rental="https://ontology.ketenstandaard.nl/DICO/UDE/Rental/v2" xsi:schemaLocation="https://ontology.ketenstandaard.nl/DICO/UDE/Rental/v2 RentalUDEv2.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 van de berichten is de locatie van de extensie in het betreffende bericht aangegeven.

2 UDE Stuctuur​

2.1 RentalUDE in het Artikelbericht​

De volgende onderdelen van de extensie mogen binnen het artikelbericht gebruikt worden:

  <rental:RentalUDE>
    <rental:Prices>
      <rental:PricePerRentalTime>
        <rental:PeriodQuantity> </rental:PeriodQuantity>
        <rental:PeriodUoM> </rental:PeriodUoM>
        <rental:MinimumOrderPeriod> </rental:MinimumOrderPeriod>
        <rental:PeriodMultiple> </rental:PeriodMultiple>
        <rental:Price> </rental:Price>
      </rental:PricePerRentalTime>
    </rental:Prices>
    <rental:WeekendInvoicing> </rental:WeekendInvoicing>
    <rental:ContinuesUse> </rental:ContinuesUse>
  </rental:RentalUDE>

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

2.2 RentalUDE in het Orderbericht​

De volgende onderdelen van de extensie mogen binnen het orderbericht gebruikt worden:

<rental:RentalUDE>
  <rental:RentalPeriod>
    <rental:FixedStartDateTime> </rental:FixedStartDateTime>
    <rental:FixedFinishDateTime> </rental:FixedFinishDateTime>
  </rental:RentalPeriod>
</rental:RentalUDE>

De plaats van de extensie binnen het orderbericht is op de regel, xpath is: Order/OrderLine/UserDefinedExtension

2.3 RentalUDE in het Orderbevestiging​

De volgende onderdelen van de extensie mogen binnen de orderbevestiging gebruikt worden:

<rental:RentalUDE>
  <rental:Prices>
    <rental:PricePerRentalTime>
      <rental:PeriodQuantity> </rental:PeriodQuantity>
      <rental:PeriodUoM> </rental:PeriodUoM>
      <rental:MinimumOrderPeriod> </rental:MinimumOrderPeriod>
      <rental:PeriodMultiple> </rental:PeriodMultiple>
      <rental:Price> </rental:Price>
    </rental:PricePerRentalTime>
  </rental:Prices>
  <rental:WeekendInvoicing> </rental:WeekendInvoicing>
  <rental:RentalPeriod>
    <rental:FixedStartDateTime> </rental:FixedStartDateTime>
    <rental:FixedFinishDateTime> </rental:FixedFinishDateTime>
  </rental:RentalPeriod>
</rental:RentalUDE>

De plaats van de extensie binnen het orderbevestiging is op de regel, xpath is: OrderResponse/OrderResponseLine/UserDefinedExtension

2.4 RentalUDE in het Verzendbericht​

De volgende onderdelen van de extensie mogen binnen het verzendbericht gebruikt worden:

<rental:RentalUDE>
  <rental:RentalPeriod>
    <rental:FixedStartDateTime> </rental:FixedStartDateTime>
    <rental:FixedFinishDateTime> </rental:FixedFinishDateTime>
  </rental:RentalPeriod>
</rental:RentalUDE>

De plaats van de extensie binnen het verzendbericht is op de regel, xpath is: DespatchAdvice/DespatchLine/ItemLevelDespatchAdvice/UserDefinedExtension

2.5 RentalUDE in het Factuurbericht​

De volgende onderdelen van de extensie mogen binnen het factuurbericht gebruikt worden:

<rental:RentalUDE>
  <rental:Prices>
    <rental:PricePerRentalTime>
      <rental:PeriodQuantity> </rental:PeriodQuantity>
      <rental:PeriodUoM> </rental:PeriodUoM>
      <rental:MinimumOrderPeriod> </rental:MinimumOrderPeriod>
      <rental:PeriodMultiple> </rental:PeriodMultiple>
      <rental:Price> </rental:Price>
    </rental:PricePerRentalTime>
  </rental:Prices>
  <rental:WeekendInvoicing> </rental:WeekendInvoicing>
  <rental:RentalPeriod>
    <rental:FixedStartDateTime> </rental:FixedStartDateTime>
    <rental:FixedFinishDateTime> </rental:FixedFinishDateTime>
  </rental:RentalPeriod>
  <rental:StartRentalPeriod> </rental:StartRentalPeriod>
</rental:RentalUDE>

Op de factuur wordt in RentalPeriod de periode meegegeven waarover gefactureerd wordt, dus niet de gehele huurperiode (tenzij deze gelijk is aan de gehele huurperiode).

De plaats van de extensie binnen het factuurbericht is op de regel, xpath is: Invoice/InvoiceLine/UserDefinedExtension