Skip to main content

UDE v1 Transaction messages SALES005

Version: Process description SALES005 v1.0

1 The process​

The trading process starts with the exchange of master data. In the DICO Standard, we are familiar with the SALES005 product and item message. Within DICO, a product is defined as something that possesses use properties and an article as something that possesses trade properties. So in this context, the item knows the properties that indicate whether something is refurbished or reused and the product describes the properties that are generic and thus also apply to a "new" item such as dimensions. In addition, the condition message and the item relationship message also belong to DICO Data Messages.

Published extensions within DataUDE:

  • XML structure TransactionUDE in the Shipping message (packing slip)

Here it is important to note that the extension should always be called by using the following tag:

<UserDefinedExtension xmlns:trans="http://www.ketenstandaard.nl/UDE/SALES/Transaction/v1" xsi:schemaLocation="http://www.ketenstandaard.nl/UDE/SALES/Transaction/v1 TransactionUDE.xsd">

This way, the XSD of the extension is loaded making the extension validatable and is also the only correct way to officially use the extension.

The location of the extension in the relevant subsection is indicated in the relevant message.

2 UDE Structures​

2.1 TransportInformation​

The extension contains structures and elements that apply to the Transmission Message. The information focuses on transport information. With the extension extra information can be added to the Despatch Advice Message. Think for example of a licence plate or tracking data.

Technology

The extension below is included in the article message at line level. Only at this location in the message is the TransportInformation extension placed.

The location of the extension within the Despatch Advice Message can be included at 2 locations, header level and the regeel:

xpath is: DespatchAdvice/UserDefinedExtension

or

xpath is: DespatchAdvice/DespatchLine/UserDefinedExtension

The following parts of the extension may be used within the Send message at this location:

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

and

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