Feature Overview
A waybill is the central shipping document in Shipping Manager. It represents a single shipment — capturing the recipient address, sender address, shipping connector, shipping agent and service, package lines, weight, volume, and integration status. Every physical shipment you want to send through a shipping broker is represented by one waybill.
Waybills are linked to source documents in Business Central: sales orders, warehouse shipments, posted warehouse shipments, transfer orders, purchase orders, inventory picks, and posted sales shipments all support an associated waybill. When you create a waybill from a source document, the recipient and sender addresses are copied automatically. From a sales order, the ship-to address and customer information are used. From a purchase order, the vendor's buy-from address becomes the sender and your company's location becomes the receiver. From a transfer order, the transfer-from location is the sender and the transfer-to location is the receiver.
Once a waybill is complete — meaning all packages are closed, the shipping connector and agent are specified, and both sender and recipient names are filled — you send it to the shipping broker. The broker returns a tracking number and, in most cases, a package label. Shipping Manager tracks the integration status through the cycle: Ready to Send → Successfully Sent → Updated with Label. The waybill header status follows a parallel lifecycle from Waybill Created through Packing Started and Packing Finished to Shipping Agent Ordered, Picked up by Shipping Agent, Delivered to Recipient, and Closed.
Key Facts
| Item | Detail |
|---|---|
| Main pages | Waybill Header List, Waybill Header (card), Closed Waybill Header List |
| Linked source documents | Sales Orders, Warehouse Shipments, Posted Warehouse Shipments, Transfer Orders, Purchase Orders, Inventory Picks, Posted Sales Shipments |
| Waybill header statuses | Waybill Created → Packing Started → Packing Finished → Shipping Agent Ordered → Picked up by Shipping Agent → Delivered to Recipient → Closed |
| Integration statuses | (blank) → Ready to Send → Successfully Sent → Updated with Label → Error |
| Key configuration | Shipping Manager Setup (no. series, default connector, default agent, default units of measure) |
| Number series | Way-Bill Nos. and Packaging Unit Nos. are required in Shipping Manager Setup |
| Address sources | Ship-to address (sales), vendor buy-from (purchase), transfer locations, warehouse shipment ship-to fields |
| Free text fields | Up to 5 free text fields per waybill, populated from shipping agent / service defaults |
Getting Started
- Open Assisted Setup and run Activate Shipping Manager. Enter your email address and activate the trial. This registers the app and creates the default number series.
- Go to Shipping Manager Setup. Verify that Way-Bill Nos. and Packaging Unit Nos. are filled in (the wizard creates defaults if you selected Default No. Series).
- On Shipping Manager Setup, set the Default Weight Unit of Measure (e.g., KG) and Default Volume Unit of Measure (e.g., M3).
- Set up at least one Connector (see the Connectors article). Assign it as the Default Shipping Connector on Shipping Manager Setup.
- Set up Packaging Types for the package sizes you use (see the Packaging Types & Waybill Lines article).
- Open a Sales Order and use the Waybill action to create a new waybill. The ship-to address is copied automatically.
- On the waybill, verify the Shipping Connector, Shipping Agent Code, and Shipping Agent Service Code.
- Add one or more Waybill Lines (packages). Assign a Package Type to each line and enter the gross weight.
- Use Close All Packages to close all lines and move the waybill to Packing Finished status. The integration status changes to Ready to Send.
- The connector will pick up the waybill and send it to the broker. Once processed, the tracking number and label are returned and the integration status updates to Updated with Label.
Related Features
Connectors are the integration backbone that waybills depend on: each waybill must reference a connector, which determines which shipping broker the waybill is transmitted to and how the API communication is configured. Packaging Types & Waybill Lines determine the package structure of each waybill; without packaging types you cannot close packages and therefore cannot send. Customs Tariffs appear as a sub-page on waybill lines and are required when shipping internationally; the tariff lines carry item-level customs information sent to the broker. Shipping Fees can be automatically calculated and written back to the linked sales order when the waybill is set to Ready to Send, if the Calculate and Assign Shipping Fee option is enabled on Shipping Manager Setup.
User Stories
US-01: Create a waybill from a sales order
As a Sales Order Processor
I want to create a waybill directly from a sales order
So that the shipping information from the order is automatically copied to the waybill without manual re-entry
Setup:
- Open the relevant Sales Order.
- On the action bar, choose the Waybill action (enabled by the Show Waybill Lines feature in Abakion Manager Foundation).
- A new waybill is created. The ship-to name, address, city, post code, country, contact, phone, e-mail, shipping connector, shipping agent, and shipping agent service are copied from the order.
- Verify the Shipping Connector and Shipping Agent Code on the waybill header.
- Add waybill lines for each package.
Note: If the sales order already has a waybill number in the Waybill Header field, you will be asked whether you want to create a new waybill or open the existing one.
US-02: Create a waybill from a warehouse shipment
As a Sales Order Processor
I want to create a waybill from a warehouse shipment
So that I can manage the physical shipment at the warehouse level rather than the order level
Setup:
- Open the Warehouse Shipment document.
- Choose the Waybill action on the action bar.
- A new waybill is created with the ship-to address from the warehouse shipment's SCB ship-to fields, and the sender address from the shipment's location.
- The packing station is also copied if it is set on the warehouse shipment.
- Complete the waybill by adding lines, closing packages, and sending.
US-03: Create a waybill for a transfer order
As a Sales Order Processor
I want to create a waybill for a transfer order
So that internal stock movements between locations are handled through the same shipping process as customer shipments
Setup:
- Open the Transfer Order.
- Choose the Waybill action.
- The waybill is created with the transfer-to location as the recipient and the transfer-from location as the sender — both address blocks are populated from the respective location cards.
- Complete the waybill normally.
US-04: Create a waybill for an incoming purchase (return shipment)
As a Purchasing Agent
I want to create a waybill on a purchase order
So that I can arrange collection of goods from a vendor or manage return shipments
Setup:
- Open the Purchase Order.
- Choose the Waybill action.
- The vendor's buy-from address is set as the Sender on the waybill, and your company's receiving location (or company information if no location is set) becomes the Receiver.
- The shipping connector and agent are copied from the purchase order's SCB fields if populated.
US-05: Automatically create a waybill when a sales order is created
As a IT Manager
I want to configure the system to automatically create a waybill when a new sales order is released for a specific customer
So that the sales team never has to manually trigger waybill creation for routine customers
Setup:
- Go to Connectors and open the relevant connector card.
- Enable Automatically Create Waybill on the connector.
- Ensure the customer's orders use this connector as their shipping connector (set on the customer or sales order header as the default).
- When a new sales order is released, the system automatically creates an associated waybill for that connector.
Note: This setting is per connector. Only orders using that connector will have waybills created automatically.
US-06: Add packages to a waybill and assign package types
As a Sales Order Processor
I want to add waybill lines with specific package types
So that each physical box or pallet in the shipment is represented on the waybill with correct dimensions and weight
Setup:
- Open the waybill and go to the Waybill Lines subpage.
- Insert a new line.
- In the Package Type field, select the relevant packaging type (e.g., BOX, PALLET). Dimensions (Length, Width, Height) and volume are copied from the packaging type definition.
- Enter the Gross Weight for the package.
- Repeat for each physical package in the shipment.
Note: If automatic waybill line creation is configured via Waybill Line Setup, lines may already be present when the waybill is created. See the Packaging Types & Waybill Lines article.
US-07: Close all packages and send the waybill to the broker
As a Sales Order Processor
I want to close all packages on a waybill and trigger the send to the shipping broker
So that the broker receives the shipment order and returns tracking numbers and labels
Setup:
- Open the waybill. Verify that all required header fields are filled in: Shipping Connector, Shipping Agent Code, Shipping Agent Service Code, Name (recipient), and Sender Name.
- Verify that at least one waybill line exists and that all lines have a Weight Unit of Measure on the waybill header.
- Choose Close All Packages. All open lines are set to Package Closed and the waybill status moves to Packing Finished.
- The integration status automatically changes to Ready to Send.
- The connector sends the waybill to the broker. Once processed, the status updates to Successfully Sent and then Updated with Label.
Note: You can also use the Send Waybill action directly — this sets status to Packing Finished and triggers the send in one step, provided the waybill has not already been sent.
US-08: Re-open a sent waybill to correct an error
As a Sales Order Processor
I want to re-open a package that has already been sent so I can correct a weight or address error
So that the broker receives corrected data without creating a new waybill
Setup:
- Open the waybill and navigate to the relevant line.
- Choose Re-Open Package on the line.
- If the waybill has already been transmitted (status: Shipping Agent Ordered or later), you will be asked to confirm before re-opening.
- The line status reverts to Package Open and the waybill header status reverts to Packing Started, allowing modifications.
- Use Reset and Send Again (available as an action on the error notification) if the waybill was stuck in an error state.
US-09: Track a shipment using the shipping agent tracking site
As a Sales Order Processor
I want to navigate directly to the shipping agent's tracking page for a waybill
So that I can check delivery status without leaving Business Central
Setup:
- Open the posted sales shipment that have waybill Related. The Waybill Tracking No. field contains the tracking number returned by the broker after the waybill was sent.
- Choose Track Shipment. This opens the shipping agent's tracking URL in your browser, pre-filled with the tracking number.
Note: The tracking URL is configured on the Shipping Agent card in standard Business Central.
US-10: View the related source document directly from a waybill
As a Sales Order Processor
I want to open the source document (sales order, warehouse shipment, etc.) directly from the waybill
So that I can quickly navigate back to the originating document without searching manually
Setup:
- Open the waybill.
- The Related Document field shows the source document number (e.g., the sales order number or warehouse shipment number).
- Choose Drill Down on the related document field. The corresponding document page opens directly (Sales Order, Warehouse Shipment, Transfer Order, etc.).
US-11: Configure waybill to auto-send when a document is posted
As a IT Manager
I want to configure Shipping Manager to automatically send the waybill when the linked document is posted
So that the shipping order is dispatched to the broker at the same time the shipment is posted in Business Central
Setup:
- Go to Shipping Manager Setup.
- Enable Send Waybill on Post Document.
- When a sales shipment or warehouse shipment is posted and a waybill exists, the waybill is automatically set to Packing Finished and the integration status to Ready to Send.
US-12: Automatically print the label when the waybill is sent
As a IT Manager
I want to configure Shipping Manager to automatically print the package label when the waybill is sent
So that warehouse staff receive labels for affixing immediately after the waybill is transmitted
Setup:
- Go to Shipping Manager Setup.
- Enable Print Label on Send Waybill.
- When the waybill is sent and the broker returns a label, it is automatically sent to the configured printer.
US-13: Configure when packages are automatically closed during posting
As a IT Manager
I want to control whether packages are closed automatically when a warehouse shipment is posted
So that the packing workflow matches how the warehouse team works
Setup:
- Go to Shipping Manager Setup.
- Set the Close all package event field:
- Close all packages when posting shipment — all open packages are closed automatically when the shipment is posted.
- Keep package status — packages remain in their current status; staff must close them manually.
US-14: Use free text fields to pass connector-specific data to the broker
As a IT Manager
I want to configure up to 5 free text values that are automatically populated on waybills for specific shipping agents or services
So that connector-specific fields (e.g., account codes, reference numbers) are always present without manual entry
Setup:
- Open the Shipping Agent card for the relevant agent, or the Shipping Agent Services card for a specific service.
- Fill in Free Text 1 through Free Text 5 with the values required by the connector (e.g., account numbers, product codes, special instructions).
- When a waybill is created or when the shipping agent or service is changed on a waybill, these values are automatically copied to the corresponding free text fields on the waybill header and lines.
Note: Service-level free text values override agent-level values if both are set.
US-15: Set a default packing station for label printing
As a IT Manager
I want to assign a default packing station to Shipping Manager Setup and to warehouse shipments
So that the correct label printer is used automatically without warehouse staff having to select it each time
Setup:
- Go to Packing Stations and create codes for each label printer or packing area (e.g., DOCK1, OFFICE).
- On Shipping Manager Setup, set Default Packing Station to the primary printer.
- On individual Warehouse Shipments, the packing station from the shipment is copied to the waybill when created. If not set, the default from Shipping Manager Setup is used.
US-16: Assign a pickup point to a waybill for parcel locker delivery
As a Sales Order Processor
I want to assign a specific pickup point (parcel locker) to a waybill
So that the broker delivers to the customer's preferred collection point rather than a home address
Setup:
- Ensure pickup points are synchronised from the connector's API (managed by the connector app — see the Connectors article).
- On the waybill or on the sales order, set the Pickup Point field. The lookup filters pickup points by the selected shipping connector.
- When the waybill is created from the sales order, the pickup point is copied automatically.
US-17: Synchronise item measurements from the waybill back to item cards
As a IT Manager
I want to enable automatic synchronisation of measurements from waybill lines back to item cards
So that weight and dimension data entered or received during shipping is kept consistent with item master data
Setup:
- Go to Shipping Manager Setup.
- Enable Sync. Measurements on Item.
- When weight or dimension values on waybill lines are updated (e.g., from broker feedback), the values are written back to the item card.
US-18: View open and closed waybills separately
As a Sales Order Processor
I want to have separate list views for active waybills and closed waybills
So that the active waybill list is not cluttered with historical shipments
Setup:
- Use Waybill Header List for active waybills (statuses up to Shipping Agent Ordered).
- Use Closed Waybill Header List for completed shipments (status Closed).
- Both lists are accessible from the Shipping Manager role centre and from source document pages.
Field Reference
| Field | Where to find it | What it does | Default |
|---|---|---|---|
| Way-Bill Nos. | Shipping Manager Setup | Number series used when creating new waybills | (set during wizard) |
| Packaging Unit Nos. | Shipping Manager Setup | Number series used when creating packaging units | (set during wizard) |
| Send Waybill on Post Document | Shipping Manager Setup | Automatically sends the waybill when the linked document is posted | Enabled |
| Close all package event | Shipping Manager Setup | Controls whether packages are auto-closed when a shipment is posted | Close all packages when posting shipment |
| Print Label on Send Waybill | Shipping Manager Setup | Automatically prints the label when the waybill is transmitted | Disabled |
| Default Shipping Connector | Shipping Manager Setup | Pre-populates the connector on new waybills | (blank) |
| Default Shipping Agent | Shipping Manager Setup | Pre-populates the shipping agent on new waybills | (blank) |
| Default Shipping Agent Service | Shipping Manager Setup | Pre-populates the service on new waybills | (blank) |
| Default Packing Station | Shipping Manager Setup | Default label printer / packing area for new waybills | (blank) |
| Default Type of Goods | Shipping Manager Setup | Pre-populates the type of goods on new waybills | (blank) |
| Default Declaration Code | Shipping Manager Setup | Pre-populates the customs declaration type on new waybills | (blank) |
| Default Reason for Export | Shipping Manager Setup | Pre-populates the reason for export on new waybills | (blank) |
| Sync. Measurements on Item | Shipping Manager Setup | Writes updated measurements back to item cards | Enabled |
| Status | Waybill Header | Current lifecycle status of the waybill | Waybill Created |
| Integration Status | Waybill Header | Current transmission status with the broker | (blank) |
| Shipping Connector | Waybill Header | Which connector/broker this waybill is sent through | From setup default |
| Shipping Agent Code | Waybill Header | The shipping agent (carrier) | From sales order or setup |
| Shipping Agent Service Code | Waybill Header | The service level / product from the carrier | From sales order or setup |
| Pickup Point | Waybill Header | Parcel locker or pickup location code for the recipient | From sales order if set |
| Packing Station | Waybill Header | Label printer / packing area to use for this shipment | From warehouse shipment or setup default |
| Weight Unit of Measure | Waybill Header | Unit of measure applied to all weight values on this waybill | From setup default |
| Volume Unit of Measure | Waybill Header | Unit of measure applied to all volume values on this waybill | From setup default |
| Waybill Tracking No. | Waybill Header | Tracking number returned by the broker after sending | Set by broker |
| Free Text 1–5 | Waybill Header / Waybill Lines | Connector-specific data fields passed to the broker | From shipping agent / service |
| Package Type | Waybill Lines | The packaging type for this package (box, pallet, etc.) | (blank) |
| Gross Weight | Waybill Lines | Total weight of the package including contents and packaging | (blank) |
| Net Weight | Waybill Lines | Weight of the contents only | (blank) |
| Length / Width / Height | Waybill Lines | Physical dimensions of the package | From packaging type |
| Status | Waybill Lines | Package Open or Package Closed | Package Open |