App Overview
Purchase Container Handling is a procurement logistics app for Microsoft Dynamics 365 Business Central. It gives purchasing teams a single point of control over incoming shipments that arrive in shared containers, grouping multiple purchase order lines and transfer order lines under one container record so they can be tracked, managed, and received together.
At the heart of the app is the Inbound Container Card: a workspace where a purchasing agent creates a container record before a shipment arrives, populates it with the purchase order lines and transfer order lines physically inside that container, and then posts all receipts in a single action when the container is delivered. Rather than opening and posting each purchase order individually, the entire container is handled from one place.
Beyond the core receiving workflow, the app tracks physical and financial data per container — weight, volume, number of packages, container size, and total order value — and integrates with Business Central's warehouse management layer so the container code travels from source lines through warehouse receipt documents all the way to Item Ledger Entries.
Feature Map
Use this table to find the right article for your task.
| Feature | What it solves | Who uses it |
|---|---|---|
| Inbound Container | Which lines are in this container? Central card for creating containers, assigning lines, managing dates, and posting receipts in one step. | Purchasing Agent, Business Manager |
| Container Measurements and Value | How heavy is this container and what is it worth? Records actual receipt weights and volumes per line, and calculates totals on the container header. | Purchasing Agent |
| Warehouse Integration | Container lines go to a warehouse-managed location — how do we post? Explains how the container code flows to warehouse receipt documents and how to handle locations requiring warehouse documents. | Purchasing Agent, IT Manager |
Common Infrastructure
Several concepts are shared across all three features.
Inbound Container Record
Every workflow in the app starts with an Inbound Container record. A container has a unique Container ID (assigned from a number series), a Planned Receipt Date, and a Status (Open, Received on ramp, Posted). It acts as the parent for all the order lines it contains. The container card shows two live sub-lists — Open Container Lines (purchase and transfer lines with outstanding quantity) and Posted Container Lines (purchase receipts and transfer receipts already posted) — refreshed automatically whenever the card is opened or changed.
Container Code on Source Lines
The container code is the linking mechanism between the container record and the underlying documents. It is stored as a field on purchase order lines (Container Code) and on transfer order lines (Inbound Container Code). Once a line carries a container code it appears in the container's Open Container Lines sub-list, and the container's Receive Lines action will include it in the bulk posting. The code is preserved through posting to purchase receipt lines, transfer receipt lines, and Item Ledger Entries.
Container Statuses
Containers move through three statuses that can be set manually or are set automatically by the app:
- Open — the container has been created and is being populated.
- Received on ramp — the container has arrived; this status is set manually to reflect physical progress.
- Posted — all lines have been received. The container card becomes read-only. The container can be reopened if corrections are needed.
Number Series
Container IDs are assigned from a number series configured in Inbound Container Setup. If no series has been configured when the first container is created, the app offers to create a default series (PCONTAINER) automatically. Manual numbers are also supported if the series has Manual Nos. enabled.
Typical Workflows
Receiving a standard container
- Create a new Inbound Container record and set the Planned Receipt Date.
- Use Get Purchase Order Lines (Ctrl+H) to add the relevant purchase lines to the container.
- For any transfer order lines in the same container, open the Transfer Order and fill in the Inbound Container Code on the relevant lines.
- When the container arrives, open the container card and click Receive Lines (F9).
- Confirm the prompt. All linked purchase orders and transfer orders are received in one step. The container status changes to Posted.
Updating the expected arrival date
- A delay is confirmed by the vendor. Open the Inbound Container Card.
- Edit the Planned Receipt Date field and confirm the prompt to propagate the change to all linked order lines.
- The date is updated on every purchase and transfer line belonging to the container — no need to open each order individually.
Receiving a container going to a warehouse-managed location
- Assign the container code to purchase order lines as normal.
- In the warehouse, create a Warehouse Receipt from the source documents. The container code flows automatically to the warehouse receipt lines.
- If needed, use Add Container Code To All Lines on the warehouse receipt to stamp all lines at once.
- Post the warehouse receipt. The container code is preserved on the posted receipt lines and on Item Ledger Entries.
- Return to the container card — the posted lines appear in the Posted Container Lines sub-list. Set the status to Posted manually.
Calculating container weight and value before customs
- During unloading, enter the actual measured weights and volumes on each Open Container Line (Receipt Net Weight, Receipt Gross Weight, Receipt Volume, Total Package).
- Fill in the physical container dimensions on the header: No. of Colli, Container Size (Feet), Container Cubic Meters.
- Click Calculate Content and Value to sum all line-level data into the header totals.
- Use the resulting Order Total and Handling weight/volume/value fields for freight invoices or customs declarations.
Integration with Other Abakion Apps
| App | Integration |
|---|---|
| Master Data Information (BC682) | When installed, up to ten configurable information fields appear on the container header and on each open and posted container line. Custom data defined in Master Data Information travels with the container shipment and is accessible via the Master Data Information action on the container card and on the line sub-lists. |
| Purchase Order Management (BC629) | When installed, two additional fields appear on the container card and on open container lines: Expected Shipment Date (the date the vendor is expected to ship) and Vendor Transport Method. These fields are managed in Purchase Order Management and surfaced in Purchase Container Handling for visibility during the receiving process. |
Setup
The setup user stories below cover the full configuration of Purchase Container Handling. Work through them in order the first time you set up the app. Each story is independent once the earlier ones are complete, so you can return to any individual step later without repeating the others.
Core Setup
SETUP-01: Activate the app and open the setup page
As a IT Manager
I want to verify the app is active and open the Inbound Container Setup page
So that I can configure the app before users start creating containers
Setup:
- Search for Inbound Container Setup and open the page.
- If the app is installed but not yet activated, an activation prompt appears. Follow the activation wizard and enter the required email address.
- Once activated, the setup page is accessible and the Inbound Container List is visible in the search.
SETUP-02: Configure the container number series
As a IT Manager
I want to assign a number series for automatic container ID assignment
So that container IDs are assigned consistently and sequentially without manual input
Setup:
- Open Inbound Container Setup.
- In the Number Series group, set Container No. Series to the number series code you want to use.
- If no suitable series exists, create one in No. Series first, then return here and select it.
Note: If this field is left blank and a user creates the first container, the app will prompt them to create a default series (PCONTAINER, starting at PLCON00001). Manual numbers are also supported if the series has Manual Nos. enabled.
SETUP-03: Configure how date updates behave on purchase documents
As a Business Manager
I want to control whether propagating a Planned Receipt Date from the container triggers currency exchange rate prompts, and whether the purchase order header date is also updated
So that the date update experience matches our company's purchasing process
Setup:
- Open Inbound Container Setup.
- In the Update group, review the following settings:
- Update Purchase Documents Silently — when enabled, date propagation from the container to purchase order lines happens without triggering currency exchange rate dialogs. Enable this if your purchasers find the prompts disruptive during a simple date change.
- Update Dates On Purchase Order Header — when enabled, propagating the Planned Receipt Date from the container also updates the date on the purchase order header (not just the lines). Enable this if header dates must stay in sync with line dates.
- Save the page.
SETUP-04: Open the Content and Value Setup
As a IT Manager
I want to access the Content and Value Setup to configure how weight and volume fields are populated from item data
So that the Calculate Content and Value action produces correct totals when run on a container
Setup:
- Open Inbound Container Setup.
- Click Open Content and Value Setup in the action bar.
- This opens the Shipping Manager Setup page where weight and volume field mapping rules are configured.
- Verify that the relevant item weight and volume fields are mapped correctly so that line total calculations on container lines pick up the right values from item master data.
SETUP-05: Enable the Document Export Inbound Container feature (optional)
As a IT Manager
I want to enable the optional Document Export Inbound Container feature
So that the Export Inbound Container action and page are visible to users who need to export container data to external systems
Setup:
- Open Inbound Container Setup.
- Click Detailed App Setup in the action bar.
- In the feature list, find Show Export Inbound Container and enable it.
- Close the page. The Open Document Export Inbound Container action is now visible on the Inbound Container Card and List.
Note: This feature is disabled by default. Only enable it if your organisation uses the Document Export integration. Most implementations do not require it.