As soon as the carrier has successfully issued a label (status Success), the API returns tracking information per transport unit. This information is stored on the label lines and can be opened directly from Business Central.
Prerequisites
-
The shipment label has status Success.
-
In its API response, the carrier returned a transport unit number and a tracking link (for Planzer, from the
transportUnitfield).
Tracking data per package
On the Shipment Label Card, you find the Transport Units / Parcels sub form. Each line is filled with the following tracking fields:
|
Field |
Description |
|---|---|
|
Transport Unit No. |
Shipment number assigned by the carrier. Shown in green once it is populated. |
|
Tracking Link |
URL to the carrier's shipment tracking. |
|
Barcode |
Shipment barcode value, if provided by the carrier. |
The three fields are read-only; they are copied from the API response by the connector.
Open the tracking link
-
Open the Shipment Label Card of the desired label.
-
Switch to the Packages sub form.
-
In the relevant line, click on the Tracking Link column and choose the drill-down (magnifier icon). Ventoo Shipping opens the URL in the browser via
Hyperlink.
Find a shipment number
If you only know the shipment number, search the Shipment Labels list by filtering on the value in Transport Unit No.. Because the field lives at line level (table Shipment Label Line VTO), it can alternatively be queried via the Shipment Label Line VTO list, the advanced search, or a custom list column.
Read tracking fields programmatically
For extensions, the fields can be read from the Shipment Label Line VTO table, filtered on the Label Entry No. of the label header.