Printing favorites can be used to complete shipments created through API or XML file integration.

When creating a printing favorite you give it a unique name.

You then use the printing favorite name in the JSON or XML file.

JSON example:

{
  "pdfConfig": {},
  "shipment": {
    "ediForward": true,
    "favorite": "My favorite",
    "options": [{
      "id": "free",
      "languageCode": "SE"
    }],
    "parcels": [{
      "copies": 1,
      "valuePerParcel": true
    }],
    "receiver": {
      "address1": "Runevej 2A",
      "city": "AARHUS V",
      "country": "DK",
      "name": "Bookstore",
      "zipcode": "8210"
    },
    "sender": {
      "address1": "Yliopistonkatu 5",
      "city": "HELSINKI",
      "country": "FI",
      "name": "Warehouse",
      "zipcode": "00100"
    },
    "service": {
      "addons": [],
      "id": "FREE",
      "normalShipment": true,
      "pickupBooking": false,
      "pickupDate": "2022-10-19",
      "subId": "13579"
    },
    "test": false
  }
}

XML example

<?xml version='1.0' encoding='UTF-8'?>
<data>
   <meta>
      <val n="favorite">My favorite</val>
   </meta>
   <shipment>
      <val n="from">party1</val>
      <val n="to">party2</val>
      <service srvid="FREE_13579">
      </service>
      <ufonline>
         <option optid="free">
            <val n="language">SE</val>
         </option>
      </ufonline>
      <container type="parcel">
         <val n="copies">1</val>
      </container>
   </shipment>
   <sender sndid="party1">
      <val n="name">Warehouse</val>
      <val n="address1">Yliopistonkatu 5</val>
      <val n="zipcode">00100</val>
      <val n="city">HELSINKI</val>
      <val n="country">FI</val>
   </sender>
   <receiver rcvid="party2">
      <val n="name">Bookstore</val>
      <val n="address1">Runevej 2A</val>
      <val n="zipcode">8210</val>
      <val n="city">AARHUS V</val>
      <val n="country">DK</val>
   </receiver>
</data>

Some examples of using printing favorites to complete shipments created through integration

If a value is provided in both the integration file and the printing favorite, the integration file overwrites the printing favorite in case you do not lock the value in the printing favorite.

For example:

Example 1. Change source if the receiver is not from the address book, e.g. a terminal

1. Go to Maintenance > Printing favorites.
   
   
2. Click New printing favorite.
   
   
3. Give the printing favorite a unique name.
   
   
4. Click Change in the Senders and receivers section.
   
   
5. Click Change under Source in the Receiver section.
   
   
6. Select a source from the drop-down list in the Source field.
   
   
7. Click OK.
   
   
8. Select a receiver from the drop-down list in the Default receiver field.
   
   
9. Click OK and Finish to save your printing favorite.

Example 2. Use a specific additional service for all shipments, but there may be routes where the additional service is not available

1. Go to Maintenance > Printing favorites.
   
   
2. Click New printing favorite.
   
   
3. Give the printing favorite a unique name.
   
   
4. Click Change in the Service and addons section.
   
   
5. Go to the Addons section and check the Select if valid box next to the additional service you want to use.
   
   
6. Click OK and Finish to save your printing favorite. 

Note: If you lock an addon with Select if valid, shipments, where the addon is not available, will result in an error.

Example 3. Create both normal and return label

1. Go to Maintenance > Printing favorites.
   
   
2. Click New printing favorite.
   
   
3. Give the printing favorite a unique name.
   
   
4. Click Change in the Service and addons section.
   
   
5. Select a service if it should only apply for that specific service.
   
   
6. Check the Normal label box and the Return label box.
   
   
7. Click OK and Finish to save your printing favorite.

Example 4. Add a standard message to your pre-notification email

1. Go to Maintenance > Printing favorites.
   
   
2. Click New printing favorite.
   
   
3. Give the printing favorite a unique name.
   
   
4. Click Change in the Service and addons section.
   
   
5. Check the Pre-notification (email) box in the Options section.
   
   
6. Enter your message in the Message field.
   
   
7. Click OK and Finish to save your printing favorite.

Example 5. Print shipments that would normally get status "Warning"

1. Go to Maintenance > Printing favorites.
   
   
2. Click New printing favorite.
   
   
3. Give the printing favorite a unique name.
   
   
4. Click Change in the Shipment and parcels section.
   
   
5. Select the warnings to ignore in the Ignore warnings section.
   
   
6. Click OK and Finish to save your printing favorite.

Example 6. Do not print shipments in order files that contain warnings

1. Go to Maintenance > Printing favorites.
   
   
2. Click New printing favorite.
   
   
3. Give the printing favorite a unique name.
   
   
4. Click Change in the Shipment and parcels section.
   
   
5. Check the No direct print of orders with warnings box in the Order import section.
   
   
6. Click OK and Finish to save your printing favorite.