DSV CargoWrite 3PL Connector

As a Business Central administrator
I want to install and activate the DSV CargoWrite 3PL Connector
So that I can start a free trial and begin configuring the integration

Setup:

1. Install the DSV CargoWrite 3PL Connector app in your environment.
2. When the role center shows the reminder "DSV CargoWrite 3PL Connector has been installed but not yet activated", choose Activate DSV CargoWrite 3PL Connector now — or search for and run the Activate DSV CargoWrite 3PL Connector assisted setup.
3. Enter your Email Address. If you are a partner enabling this for a client, switch on I am a partner activating this on behalf of a client and enter the partner email.
4. Choose Activate Trial to start the 30-day free trial, then Finish.

Note: Activating the trial here also activates Warehouse Manager, since the connector depends on it. Activation does not commit you to a subscription.

As a Business Central administrator
I want to install the free DSV CargoWrite Power Automate app
So that Business Central has the flow that actually communicates with DSV CargoWrite

Setup:

1. On the Connector Card, choose Power Automate app (also available from the final step of the setup wizard).
2. This opens the DSV CargoWrite 3PL Connector Power Automate app listing on Microsoft AppSource.
3. Install the app and complete its configuration as described in its documentation.

Note: The integration is not complete without this companion app — Business Central sends every operation to the Power Automate flow, which performs the real exchange with DSV CargoWrite.

As a Warehouse Manager
I want to enable the DSV CargoWrite connector on Warehouse Manager Setup
So that the DSV CargoWrite connector type and actions become available

Setup:

1. Search for and open Warehouse Manager Setup.
2. In the activated-connectors area, enable DSV CargoWrite.
3. Make sure the Length Unit of Measure field on Warehouse Manager Setup has a value — it is required before the connector can send documents.

Note: If the connector is not enabled here, attempting to send to DSV CargoWrite results in the error "DSV CargoWrite Connector is not activated on Warehouse Manager Setup."

As a IT Manager
I want to create a connector and set its type to DSV CargoWrite
So that the connector is pre-wired with DSV CargoWrite behaviour and units

Setup:

1. From Warehouse Manager Setup, open the Connectors list.
2. Create a new connector with a descriptive ID and Description.
3. In the Type field, choose DSV CargoWrite Connector.

Note: Choosing this type automatically sets the manager type to Warehouse Manager and fixes the units to MM (length), G (weight), and CM3 (volume), because DSV CargoWrite requires metric values. These unit fields cannot be changed for a DSV connector.

As a IT Manager
I want to enter the URL, Subscription Key, and Actor from the DSV CargoWrite portal
So that the Power Automate flow can authenticate against DSV CargoWrite

Setup:

1. Open the DSV CargoWrite connector and find the DSV CargoWrite Setup group.
2. Enter the Url — it must begin with https://api.dsv.com/sol/, otherwise Business Central rejects it.
3. Enter the Subscription Key and the Actor, both found in your DSV CargoWrite Warehouse Portal.

Note: The Subscription Key is stored securely in isolated storage, not as readable text on the record.

As a IT Manager
I want to register the BC Client Id and Client Secret on the connector
So that the Power Automate flow can write confirmations and statuses back into Business Central

Setup:

1. Have your Azure partner or IT department create an Azure app registration for Business Central API access.
2. On the connector, open the BC Login Information group.
3. Enter the BC Client Id and BC Client Secret from that app registration.

Note: Both values are stored securely in isolated storage. They identify Business Central to the Power Automate job, not to DSV CargoWrite.

As a IT Manager
I want to point the connector at the Power Automate flow endpoint
So that outbound operations are delivered to the flow that talks to DSV CargoWrite

Setup:

1. Obtain the flow endpoint URL from the companion Power Automate app.
2. On the connector, enter it in the URL Dispatcher field.
3. Set Error message recipients to the email addresses that should be notified when an operation fails.

Note: Every operation — send shipment, send receipt, sync items, status update, cancel — is posted to this dispatcher URL.

As a Warehouse Manager
I want to link the Business Central locations DSV operates to this connector
So that warehouse documents for those locations are routed to DSV CargoWrite

Setup:

1. From Warehouse Manager Setup, open Warehouse Connector Links (Third Party Logistics → Warehouses).
2. Add a line for each DSV-managed location and set its Connector ID to the DSV CargoWrite connector.
3. Verify or adjust the External ID to match DSV's identifier for that location if it differs from the BC location code.

Note: Location linking is provided by Warehouse Manager — see the Connector Setup & Location Linking article for full details.

As a Logistics Coordinator
I want to enable only the sync flows I have agreed with DSV
So that Business Central only sends the document types DSV expects

Setup:

1. Open the DSV CargoWrite connector.
2. Enable Sync Items if DSV should receive your item master data.
3. Enable Sync Warehouse Shipments for outbound shipment integration.
4. Enable Sync Warehouse Receipts for inbound receipt integration.

Note: Each flow only runs when its flag is enabled. For example, a warehouse shipment that becomes ready is only sent if Sync Warehouse Shipments is on.

As a Warehouse Manager
I want to push all items to DSV CargoWrite at once
So that the warehouse has my complete, current item master data

Setup:

1. Open the DSV CargoWrite connector.
2. Make sure Sync Items is enabled.
3. Choose the Sync Items action and confirm.

Note: The synchronisation is handed to the Power Automate flow and runs in the background; a confirmation message indicates it has been initiated.

As a Warehouse Manager
I want to push one specific item to DSV CargoWrite
So that a new or changed item is updated without re-sending the whole catalogue

Setup:

1. Open the Item Card for the item.
2. Choose Sync Item to DSV CargoWrite (also available as a promoted action) and confirm.

Note: This action is only visible when a DSV CargoWrite connector exists, and it requires Sync Items to be enabled on that connector.

As a Warehouse operator
I want to have warehouse shipments sent to DSV CargoWrite as soon as they are ready
So that the external warehouse can pick and ship without manual hand-off

Setup:

1. Create and release the warehouse shipment for a DSV-linked location as usual in Warehouse Manager.
2. When the shipment reaches the Ready to Send connector status, Business Central automatically posts it to the Power Automate dispatcher.

Note: This happens automatically only when the location's connector is a DSV CargoWrite connector and Sync Warehouse Shipments is enabled.

As a Warehouse operator
I want to have warehouse receipts sent to DSV CargoWrite when they are ready
So that the external warehouse knows what inbound goods to expect

Setup:

1. Create and release the warehouse receipt for a DSV-linked location.
2. When it reaches the Ready to Send connector status, Business Central automatically sends it to the Power Automate dispatcher.

Note: Requires Sync Warehouse Receipts to be enabled on the connector.

As a Warehouse Manager
I want to have DSV confirmations posted in Business Central automatically
So that receipts and shipments are posted as goods are physically handled, without manual posting

Setup:

1. On the connector, enable Post Warehouse Shipments and/or Post Warehouse Receipts.
2. Ensure the recurring update job queue entries are running (see next story).

Note: When auto-posting is enabled, the confirmed quantity updates pulled back from DSV CargoWrite are posted automatically in Business Central. Leave these off if you prefer to review before posting.

As a Business Central administrator
I want to schedule the recurring polls that pull updates from DSV CargoWrite
So that receipt confirmations, shipment updates, and statuses come back automatically

Setup:

1. Open the DSV CargoWrite connector.
2. Choose Create Job Queue Entries.
3. This creates three recurring entries — Update WH Receipts, Update WH Shipments, and Update Status on Shipments — that run on a recurring schedule.

Note: The entries are created ready to run. Review them in the Job Queue Entries list if you need to adjust the schedule or starting time.

As a Warehouse Manager
I want to pull only the changes since the last successful sync
So that updates are efficient and nothing is processed twice

Setup:

1. Ensure the recurring update job queue entries are active.
2. No manual configuration is required — the connector tracks the date of the most recent inbound activity for shipments and for receipts and uses it as the starting point for the next poll.

Note: The status-update job also tells DSV whether documents should be auto-posted, based on the connector's Post flags.

As a Logistics Coordinator
I want to define who receives error notifications from the integration
So that the right people are alerted when a send or update fails

Setup:

1. Open the DSV CargoWrite connector.
2. Enter one or more addresses in Error message recipients.

Note: These recipients are passed to the Power Automate flow with each outbound operation, so error handling in the flow can notify them.

As a IT Manager
I want to know that the connector standardises units automatically
So that dimensions and weights are always sent to DSV CargoWrite in the units they expect

Setup:

1. Create or open a DSV CargoWrite connector.
2. Note that the length, weight, and volume units are fixed to MM, G, and CM3.

Note: The connector enforces these units when the type is selected and re-applies them on upgrade, so they cannot drift to non-metric values. The matching units of measure (Millimeter, Gram, Cubic Centimeter) are created automatically when the app is installed.

As a Business Central administrator
I want to postpone or dismiss the activation reminder
So that I am reminded at a convenient time or not at all

Setup:

1. When the "installed but not yet activated" notification appears on the role center, choose one of:
   • Activate DSV CargoWrite 3PL Connector now to open the setup wizard;
   • Remind me in 1 day to postpone;
   • Don't show this again to stop the reminders.

Note: Choosing Don't show this again stops reminders but you can still activate later from the assisted setup list.

As a Warehouse Manager
I want to see what has been exchanged with DSV CargoWrite
So that I can confirm syncs are working and investigate issues

Setup:

1. Use Warehouse Manager's activity logging to review the inbound and outbound entries recorded for the DSV CargoWrite connector.
2. Check the date of the most recent inbound shipment and receipt activity to confirm the recurring updates are running.

Note: Activity logging is provided by Warehouse Manager — see the Warehouse Shipments & Receipts with 3PL article for how the document workflow and logging fit together.