Skip to main content

Communication

The Communication tab contains settings for communication between your instance of OnlineConnect and your back-end system.

Clicking the Add button will open a new dialogue where you enter information about your account, file paths and printers.

Account

  • User ID and password

  • API key

    Provide the entire API key, that is, both the ID and Secret ID (also known as Combined ID or Bearer token) separated by a dash.

    Example: SE6BXKQVRGV6USOO-D3N1CVEWFOBHKAVVDWIKT7FY

The credentials will be validated if you switch tab or click OK.

Order files

Specify the path from where the order files should be fetched. You can add multiple paths with different settings.

Caution

If you add the same path twice, make sure there is a difference in file mask, otherwise the fetching could fail.

File format is set to XML by default.

Number of seconds after editing before the file is processed is an integer that specifies how many seconds the application should wait before processing the file after the latest modification.

Check Translate DOS (OEM) characters if the files originate from an MS-DOS based application. Character set referred to here is known as OEM or CP430.

Checking Use file lock (Advanced setting) will perform a file lock even if other applications are using the file. Use with caution.

Send this folder’s direct printing to a specific printer mapping. Leave blank from automatic selection (Advanced setting) should be set if specific printer mapping for this path should be used.

Printers

Direct print is enabled by default. If disabled, shipments will be created and stored in nShift Delivery > Shipments > Stored printings where the printing is executed manually.

Guide – Printer Settings (recommended) is a step by step wizard that helps you to configure your label and document printers.

Use the Add-button to configure additional printers.

Tip

The application reads the printer list sequentially. It's useful if you have multiple printers with different label sizes. Best practice is to set the printer with a smaller label first because services that don't support smaller labels will automatically be printed on next printer in the list, ideally one supporting normal label size.

Printer mappings

You can create an alias for a printer (or printer pair). This is useful if you have multiple printing/packing stations. The alias is then used in the order file to direct the printout to a certain printing station.

Feedback report

In the Feedback report tab, settings can be made for two kinds of reports, Standard and/or Event based. Report files can be used by your beckend system in order to track a certain order’s parcel and/or consignment number or order status.

To generate a Standard report the application returns shipment information as one or multiple files and the report interval can be set in the Filter dropdown.

  • “Send feedback report only periodically” reports once every 15 minutes.

  • “Send feedback report only on direct print” reports only the printouts made via OnlineConnect.

  • “Send feedback report on direct print and periodically” reports both of the previous selections together.

Note

Shipments created via Direct print will be reported both at the time of printing and in the next 15 minute interval.

File format can be either "Standard format" or "Standard format with reference" that contain order number, parcel number, consignment number, printed date and possibly reference, separated by semicolon (;).

Example: Orderno;373325381737155333;201366278689;2019-03-21 15:23:04;Reference

Event based reports are created once every 15 minutes. File contents depend on whether shipment status has been updated since last report.

You can select Naming method for both kinds of report.

  • “Date with arbitrary prefix and file extension” merges the values in the “Prefix” and “File extension” boxes with the current date and time in the middle. A new file will be created at each reporting event.

  • “Fixed name” uses the value in the “Name” box as the full name of the file. The same file will be updated at each reporting event.

  • “Internal name with arbitrary file extension” merges an internal file name with the value in the “File extension” box. A new file will be created at each reporting event.

The table below shows all available status events that can occur. Status availability may vary depending on carrier and service.

STATUS_ Presents current status of a shipment. These are not permanent.

STATUS_TRANSITION_ Presents when the status of a shipment was changed. These are permanent.

STATUS_PRINTED – "Printed"

STATUS_TRANSITION_PRINTED – The status was changed to “Printed”

STATUS_DISPATCHING – "On route"

STATUS_TRANSITION_DISPATCHING – The status was changed to “On route”

STATUS_DELIVERING – "Arrived at pickup location"

STATUS_TRANSITION_DELIVERING – The status was changed to “Arrived at pickup location”

STATUS_DELIVERED – "Delivered"

STATUS_TRANSITION_DELIVERED – The status was changed to “Delivered”

STATUS_PARTDELIVERED – "Partly delivered"

STATUS_TRANSITION_PARTDELIVERED – The status was changed to “Partly delivered”

STATUS_RETURNED – "Returned"

STATUS_TRANSITION_RETURNED – The status was changed to “Returned”

STATUS_CANCELLED – "Discarded"

STATUS_TRANSITION_CANCELLED – The status was changed to “Discarded”

In this section: