Ga naar hoofdinhoud

UDE v1 Transactieberichten SALES005

Versie: Procesbeschrijving SALES005 v1.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 TransactionUDE in het Verzendbericht (pakbon)

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:trans="http://www.ketenstandaard.nl/UDE/SALES/Transaction/v1" xsi:schemaLocation="http://www.ketenstandaard.nl/UDE/SALES/Transaction/v1 TransactionUDE.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 het desbetreffende deelhoofdstuk is de locatie van de extensie in het betreffende bericht aangegeven.

2 UDE Structuren​

2.1 TransportInformation​

De extensie bevat structuren en elementen die van toepassing zijn op het Verzendbericht. De informatie richt zich op transport informatie. Middels de extensie kan extra informatie aan het Verzendbericht worden toegevoegd. Denk dan bijvoorbeeld aan een nummerplaat of tracking gegevens.

Techniek

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

De plaats van de extensie binnen het Verzendbericht kan op 2 plekken worden meegestuurd, namelijk op kopniveau en de regeel:

xpath is: DespatchAdvice/UserDefinedExtension

of

xpath is: DespatchAdvice/DespatchLine/UserDefinedExtension

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

<DespatchAdvice>
  <UserDefinedExtension xmlns:trans="http://www.ketenstandaard.nl/UDE/SALES/Transaction/v1"
    xsi:schemaLocation="http://www.ketenstandaard.nl/UDE/SALES/Transaction/v1 TransactionUDE.xsd">
    <trans:TransactionUDE>
      <trans:TransportInformation>
        <trans:TrackingInformation>
          <trans:TrackingID> </trans:TrackingID>
          <trans:TrackingURL> </trans:TrackingURL>
        </trans:TrackingInformation>
        <trans:TransportDetails>
          <trans:TransportID> </trans:TransportID>
          <trans:LicencePlate> </trans:LicencePlate>
          <trans:TransportationType>
            <trans:TransportationTypeMode> </trans:TransportationTypeMode>
            <trans:TransportationTypeCode> </trans:TransportationTypeCode>
          </trans:TransportationType>
        </trans:TransportDetails>
        <trans:Carrier>
          <trans:GLN> </trans:GLN>
          <trans:Name> </trans:Name>
          <trans:Name2> </trans:Name2>
          <trans:Street> </trans:Street>
          <trans:HouseNumber> </trans:HouseNumber>
          <trans:HouseLetter> </trans:HouseLetter>
          <trans:HouseNumberSuffix> </trans:HouseNumberSuffix>
          <trans:City> </trans:City>
          <trans:PostalCode> </trans:PostalCode>
          <trans:Country> </trans:Country>
          <trans:ContactInformation>
            <trans:ContactPersonName> </trans:ContactPersonName>
            <trans:PhoneNumber> </trans:PhoneNumber>
            <trans:EmailAddress> </trans:EmailAddress>
          </trans:ContactInformation>
        </trans:Carrier>
      </trans:TransportInformation>
    </trans:TransactionUDE>
  </UserDefinedExtension>
</DespaDespatchAdvicetchLine>

en

<DespatchLine>
  <UserDefinedExtension xmlns:trans="http://www.ketenstandaard.nl/UDE/SALES/Transaction/v1"
    xsi:schemaLocation="http://www.ketenstandaard.nl/UDE/SALES/Transaction/v1 TransactionUDEv1.xsd">
    <trans:TransactionUDE>
      <trans:TransportInformation>
        <trans:TrackingInformation>
          <trans:TrackingID> </trans:TrackingID>
          <trans:TrackingURL> </trans:TrackingURL>
        </trans:TrackingInformation>
        <trans:TransportDetails>
          <trans:TransportID> </trans:TransportID>
          <trans:LicencePlate> </trans:LicencePlate>
          <trans:TransportationType>
            <trans:TransportationTypeMode> </trans:TransportationTypeMode>
            <trans:TransportationTypeCode> </trans:TransportationTypeCode>
          </trans:TransportationType>
        </trans:TransportDetails>
        <trans:Carrier>
          <trans:GLN> </trans:GLN>
          <trans:Name> </trans:Name>
          <trans:Name2> </trans:Name2>
          <trans:Street> </trans:Street>
          <trans:HouseNumber> </trans:HouseNumber>
          <trans:HouseLetter> </trans:HouseLetter>
          <trans:HouseNumberSuffix> </trans:HouseNumberSuffix>
          <trans:City> </trans:City>
          <trans:PostalCode> </trans:PostalCode>
          <trans:Country> </trans:Country>
          <trans:ContactInformation>
            <trans:ContactPersonName> </trans:ContactPersonName>
            <trans:PhoneNumber> </trans:PhoneNumber>
            <trans:EmailAddress> </trans:EmailAddress>
          </trans:ContactInformation>
        </trans:Carrier>
      </trans:TransportInformation>
    </trans:TransactionUDE>
  </UserDefinedExtension>
</DespatchLine>