Skip to main content

Additional elements

There are several non-mandatory elements that can be supplied if extended functions are desired.

Meta

This element is usually inserted first in a file, directly after the declaration of the root element. The meta element can contain printer mapping, mapping to a certain print favorite etc. Values are supplied as <val n="value name">...</val>. An index of valid values can be found in the Value reference guide.

Pre-notification by email

This service is declared as part of a standalone element <ufonline> nested under the shipment element. Values are supplied as <val n="value name">...>/val>. An index of valid values can be found in Value reference guide.

Example

<ufonline>
    <option optid="enot">
        <val n="sendemail">yes</val>
        <val n="from">customerservice@mycompany.xyz</val>
        <val n="to">someone@otherside.xyz</val>
        <val n="message">Your package is on the way!</val>
    </option>
</ufonline>

The element must end with </ufonline>.

Link to Print

This service is declared as part of a standalone element <ufonline> nested under the shipment element. The declaration of the shipment element can also contain the attribute linkprintkey which is a unique value of any data type and length. This is used if it's desirable to know how the final link would look like. In this example, we will use aFg3rA as a key which would give us a link like this: https://www.unifaunonline.com/ext.uo.se.se.linkprint?key=<user-ID>&>job=aFg3rA&mode=normal

Due to the key being visible in the link, it's important that you don't use simple keys such as number sequence or similar. The recipient could change the link and print other recipient's shipping documents. Do not use empty spaces or underline characters in the link.

If linkprintkey is not supplied the system will automatically generate one.

Example

<ufonline>
    <option optid="lnkprtn">
        <val n="sendemail">yes</val>
        <val n="from">customerservice@mycompany.xyz</val>
        <val n="to">someone@otherside.xyz</val>
        <val n="message">Here is the link to your shipping documents!</val>
    </option>
</ufonline>

Consolidated shipment

This service permits continuous printing of shipping labels while the EDI message is held until the shipment is closed. A typical use case is if you have multiple orders to a certain receiver during the day and you wish to consolidate these into one single shipment. This service is declared as part of a standalone element <ufonline> nested under the shipment element.

Example

<ufonline>
    <option optid="CONSOLIDATE">
    </option>
</ufonline>

The consolidated shipment service requires the mergeid attribute in shipment element tag.

Example

<shipment orderno="Ordernummer_1" mergeid="MRG001">

Mergeid can be an alphanumeric value of your choice and should be unique for each shipment. Do not use empty spaces or underline characters. Consolidated shipments need to be closed, either manually in nShift Delivery or by supplying a closing XML file containing a control element directly under the root element.

Example

<control>
    <close>
        <val n="mergeid">MRG001</val>
    </close>
</control>

Closing a consolidated shipment triggers waybill and eventual customs declaration documents printout to preset laser printer if no printer is specified in the <val n="printer"> tag.

In this section: