Setup and configuration of Ventoo Shipping

After installation, configure Ventoo Shipping in two steps:

Carrier Setup – one record per carrier (for example Planzer) with connection and authentication data.
Shipping Setup – global default values (default carrier, auto-print, default pickup from company).

Configure a carrier

The carrier setup holds all connection, authentication and master data for a carrier. Each carrier is identified by a code that references the Business Central Shipping Agent code.

Open the carrier list

Use the search (Tell Me) to find Carrier Setup.
Choose New to create a new carrier record.
Choose Edit to open the Carrier Setup Card.

General

Field	Description
Code	Unique carrier code. References the Business Central shipping agent (`Shipping Agent`). On validate, the description is copied automatically.
Description	Display name of the carrier.
Carrier Type	Selects the technical connector. Possible values: (no carrier) and Planzer. The value determines which code executes the API calls.
Enabled	Controls whether the carrier may be used to create labels. Disabled carriers are rejected during processing.

Connection

Field	Description
Base URL Test	API endpoint for the test environment.
Base URL Production	API endpoint for the production environment.
Use Production	When enabled, the production URL is used; otherwise the test URL is used.

OAuth 2.0 authentication

Ventoo Shipping uses the OAuth 2.0 client-credentials flow. Client ID and Client Secret are stored in Business Central IsolatedStorage and are not held in plain text in the table.

Field	Description
OAuth Token URL	URL of the carrier token endpoint.
OAuth Client ID	Client ID for the carrier. Stored encrypted on validate and shown masked as `***` on the card.
OAuth Client Secret	Client Secret for the carrier. Stored encrypted on validate and shown masked as `***` on the card.
OAuth Scope	Optional scope parameter if required by the carrier.

Label defaults

Field	Description
Default Label Format	Default output format. Possible values: PDF or ZPL.
Default Label Resolution (dpi)	Default resolution in DPI. Mainly required for ZPL (for example `200` or `300`).

Carrier account (Planzer)

This group is only visible when Carrier Type is set to Planzer.

Field	Description
Account ID	Planzer account ID (6 digits). Padded with leading zeros when the request is built.
Customer ID	Planzer customer ID (6 digits).
Department ID	Planzer department ID (2 digits).
Query Param NachrichtArt	Optional `NachrichtArt` query parameter passed to the Planzer API.
Query Param System	Optional `System` query parameter passed to the Planzer API.

Options

Field	Description
Log API Calls	When enabled, the request and response JSON for each label is stored in the label record (fields Request JSON and Response JSON). Useful for troubleshooting.

Initialize master data

The Initialize Master Data action populates the carrier-specific tables Carrier Service Options and Carrier Notifications with the codes available for the carrier. For Planzer, this includes service codes such as mandatory signature or Saturday delivery, plus notification codes remark, reference1, billing, routing1–routing4, and deposit.

Open the Carrier Setup Card.
Choose Initialize Master Data.
Confirm the message. The tables are rebuilt for this carrier.

Note: The action deletes existing entries for this carrier and recreates them. Any custom changes to descriptions or the Enabled flag are lost.

The Service Options and Notifications actions on the Carrier Setup Card open the respective master data pages filtered to the current carrier. Individual codes can be enabled or disabled in bulk by using the Enable All and Disable All actions.

Shipping Setup

On the Shipping Setup page you define global defaults. Only one record exists per company; it is created automatically when the page is opened for the first time.

Field	Description
Default Carrier Code	Carrier proposed when a new label is created.
Auto-Print After Creation	When enabled, the label is automatically printed via the Business Central printer selection after a successful carrier response.
Default Pickup From Company	When enabled, name, address, postal code, city, country, contact person, phone and email from the company information (`Company Information`) are copied to the pickup address of the label.

The Carrier Setup action on the Shipping Setup page navigates directly to the carrier list.

Configure printer selection (optional)

To automatically route labels to a specific printer (action Auto-Print After Creation), use the standard Business Central Printer Selection page. Ventoo Shipping registers a lightweight report per carrier (for example Planzer Label Print VTO). When the report is printed, the carrier PDF is injected into the report output by the Ship Label Print Events VTO event subscriber.

Search for Printer Selections.
Choose New and add an entry for the relevant report and user.
Assign the desired printer.