Tasklet Connector – Setup and Field Mapping

Prev Next

Overview

The Shipping Connector for Tasklet lets warehouse workers create Shipping Manager waybills from a Tasklet Mobile WMS scanner. When they post a warehouse shipment on the scanner, they enter package type, number of packages and total gross weight, and the app creates the waybill and its packages in Business Central. From the scanner they can also add packages to a shipment, see the packages on its waybill, and change the shipping agent or service.

Unlike the carrier connectors, this app does not send anything to a carrier and has no Power Automate solution. The waybill it creates is sent to the carrier by the shipping connector you use in Shipping Manager (for example nShift or Webshipper).

The connector has two parts:

  • Business Central app: Shipping Connector for Tasklet (version 28.0). It depends on Mobile WMS from Tasklet Factory, Shipping Manager, Abakion Manager Foundation and Abakion App Manager Core.
  • Mobile WMS configuration: the scanner menus and actions that call the app. They are set up in Tasklet's mobile configuration, not in this app.

Prerequisites

  • Tasklet Mobile WMS is installed and the scanners can handle warehouse shipments.
  • Shipping Manager is set up, including shipping agents, shipping agent services and package types per shipping agent.
  • A shipping connector in Shipping Manager that sends the waybills to your carrier platform.

Setup

Set up the connector in this order.

  1. Activate the app. Run the assisted setup Activate Shipping Connector for Tasklet and choose Activate Trial. Activation also changes your Mobile WMS setup, see the table below.
  2. Set up package types per shipping agent. Open Package Type per Shipping Agent and add the package types each shipping agent uses. The scanner only offers package types listed here for the shipment's shipping agent.
  3. Check shipping agent services. On the scanner, services are shown and selected by their Description. Give each service of a shipping agent a unique description.
  4. Map shipping agents on the connector. On the connector card of your shipping connector, map shipping agents and services as usual. The scanner does not create customs lines (see How it works on the scanner).
  5. Set up the scanner menus. In the Tasklet mobile configuration (Application.cfg), add Change Agent and Change Service to the Post Shipment page, as shown in Installationsguide. Add Colli and Show Colli need their own pages with the names under Scanner actions below; the Installationsguide does not cover them yet.
  6. Test. On a scanner, post a released warehouse shipment. Check that a waybill with the right number of packages is created and linked to the shipment.

What activation changes

Change Details
Post Shipment menu Added to the WMS mobile group.
Ship menu Removed from the WMS mobile group. Posting is done through Post Shipment instead.
Scanner texts Created for English and Danish (the Danish texts are in English).
Gross weight Calculated on all released warehouse shipments that have no gross weight yet.

Scanner actions

These are the names the Tasklet mobile configuration must use to call the app.

Action on the scanner Type Name Header
Add Colli Registration AddWaybillLine AddWaybillLineHeader
Show Colli Lookup WayBillLines WayBillLinesHeader
Change Agent Registration ABA_ChangeShippingAgent ChangeShippingAgent
Change Service Registration ABA_ChangeShippingAgentService ChangeShippingAgentService
Post Shipment Standard Mobile WMS action PostShipment Standard

Validation

When packages are added, the app checks the input and stops with one of these errors:

  • Number of packages should be greater than zero.
  • Package Type must have a value.
  • Shipping Agent Service Description is not unique for the Shipping. (Change Service only.)

How it works on the scanner

All actions work on a warehouse shipment. The waybill is created the first time packages are added, and linked to the warehouse shipment.

Post Shipment

  1. The worker opens Post Shipment and selects the warehouse shipment. The scanner shows the shipping agent and service, for example "Delivery with: GLS, Service: Business".
  2. The first step says which shipping agent and service the order will be shipped with.
  3. The worker selects Package Type, enters No. of Packages and confirms Gross Weight. Gross Weight is proposed from the warehouse shipment's Total Gross Weight.
  4. When the shipment is posted, the app finds or creates the waybill for the warehouse shipment and adds one package line per package.
  5. The total gross weight is split evenly over the packages.
  6. The waybill is linked to the warehouse shipment, and the shipment is posted by Mobile WMS.

After this, Shipping Manager handles the waybill as usual and sends it through the shipping connector.

Add Colli

The worker scans or enters the warehouse shipment number and enters Package Type, No. of Packages and Gross Weight. The app finds or creates the waybill and adds the packages, in the same way as Post Shipment. The shipment is not posted.

Show Colli

Shows the waybill number, the number of packages and the total gross weight of the waybill for the warehouse shipment.

Change Agent

The worker selects a new shipping agent from all shipping agents in Business Central. The app updates the shipping agent on the warehouse shipment and, if it exists, on the waybill.

Change Service

The worker selects a service from the descriptions of the shipping agent's services. The app updates the service on the warehouse shipment and the waybill. If two services have the same description, the change is stopped with an error.

Customs

In version 28.0, the scanner does not calculate customs lines. Calculate them in Business Central before the waybill is sent.

Field mapping

The tables show which scanner input or Business Central field fills each field in Business Central. The app does not send data to a carrier.

Packages (Post Shipment and Add Colli)

Scanner step Business Central field Notes
Package Type Package Type (waybill line) List of Packaging Type values from Package Type per Shipping Agent for the shipment's shipping agent.
No. of Packages Number of waybill lines One line per package. Must be greater than 0.
Gross Weight Gross Weight (waybill line) Gross Weight ÷ No. of Packages on each line. Proposed from Total Gross Weight on the warehouse shipment (Post Shipment only).
Warehouse shipment no. Waybill (warehouse shipment) The waybill is found or created for the warehouse shipment and linked to it.

Shipping agent and service

Scanner step Business Central field Notes
Shipping Agent (Change Agent) Shipping Agent Code (warehouse shipment and waybill) List of all shipping agents. Proposed from the warehouse shipment.
Shipping Agent Service (Change Service) Shipping Agent Service Code (warehouse shipment and waybill) Selected by Description. The description must be unique for the shipping agent.

Information shown on the scanner

Where Text BC source
Shipment list Ship with agent, service: service Shipping Agent Code and Shipping Agent Service Code (warehouse shipment)
Post Shipment, selection Delivery with: agent, Service: service Shipping Agent Code and the service's Description
Post Shipment, first step The order will be shipped with agent, service: service Shipping Agent Code and External Shipping Agent Service Code from the 3PL connector's shipping agent mapping. Shows "Unknown" if no mapping is found.
Show Colli Waybill No., No of Collies, Total Gross Weight No., No. Of Colli and Total Gross Weight (waybill)

The texts on the scanner are in English, also for Danish users.

Data returned and troubleshooting

The app returns nothing from a carrier. Tracking numbers and labels come from the shipping connector that sends the waybill. See the article for that connector.

Symptom Check
The Ship menu is gone from the scanner Expected. Activation replaces it with Post Shipment.
No package types to choose from Add package types for the shipment's shipping agent in Package Type per Shipping Agent.
"Number of packages should be greater than zero." Enter 1 or more in No. of Packages.
"Package Type must have a value." Select a package type. If the list is empty, see the row above.
"Shipping Agent Service Description is not unique for the Shipping." Two services of the shipping agent have the same description. Make the descriptions unique.
Change Service does nothing The selected description did not match a service of the current shipping agent. Change the agent first, then the service.
"service: Unknown" on the first Post Shipment step No shipping agent mapping was found for the shipment's 3PL connector, shipping agent and service. The shipment can still be posted.
Add Colli, Show Colli, Change Agent or Change Service missing Add them to the Tasklet mobile configuration with the names in Scanner actions. See Installationsguide.
Add Colli fails for a valid shipment number Check whether the warehouse shipment number is longer than 10 characters.
Wrong weight per package The total gross weight is split evenly. Correct single lines on the waybill in Business Central.
No customs lines on the waybill Expected in version 28.0. Calculate customs in Business Central.