Container Measurements and Value

As a Purchasing Agent
I want to record the actual receipt weight and volume for each line in the open container sub-list
So that the physical measurements from unloading are captured in Business Central alongside the order data

Setup:

1. Open the Inbound Container Card for the container being unloaded.
2. In the Open Container Lines sub-list, locate each line.
3. Edit the Receipt Net Weight field to enter the actual net weight measured for that line's goods.
4. Edit the Receipt Gross Weight field with the gross weight including packaging.
5. Edit the Receipt Volume field with the actual volume measured.
6. Edit Total Package with the number of physical packages for that line.
7. Repeat for each line in the container.

Note: These fields write back directly to the corresponding purchase order or transfer order line. They are stored separately from the item master weight fields (Gross Weight, Net Weight, Unit Volume) which are read-only on the container line.

As a Purchasing Agent
I want to trigger a calculation that sums up weight, volume, packages, and order value across all container lines
So that I have accurate totals on the container header for use in freight invoices, customs declarations, or receiving documentation

Setup:

1. Open the Inbound Container Card.
2. Ensure that lines are assigned and measurements have been entered on the open container lines.
3. Click Calculate Content and Value in the action bar.
4. If all lines are open (no partial posting yet), the calculation runs and updates the header fields.
5. Review the updated values in the Measurements and Value group: Total Quantity, Order Total Net Weight, Order Total Gross Weight, Total Package, Order Total Volume, Total Order Amount (LCY), Handling Net Weight, Handling Gross Weight, and Handling Volume.

Note: The calculation also reads any posted receipt lines and transfer receipt lines linked to the container, ensuring that partially received containers still show correct totals.

As a Purchasing Agent
I want to understand what the Order Total and Handling weight and volume fields represent
So that I use the correct figures when filling in freight or customs documents

Setup:

1. Open the Inbound Container Card after running Calculate Content and Value.
2. Order Total Net Weight, Order Total Gross Weight, and Order Total Volume represent the sum of the calculated line totals (item master weight × quantity) from purchase order lines and transfer order lines.
3. Handling Net Weight, Handling Gross Weight, and Handling Volume represent the sum of the receipt-level weight and volume fields (the physically measured values entered on each container line).
4. Use Order Total values for procurement-side documentation (values derived from item records).
5. Use Handling values for logistics and freight documentation (values based on what was physically measured at receipt).

As a Purchasing Agent
I want to record the physical dimensions of the container and the number of colli
So that this information is available for logistics planning and documentation

Setup:

1. Open the Inbound Container Card.
2. In the Measurements and Value group, enter No. of Colli (number of individual packages or bundles in the container).
3. Enter the Container Size (Feet) (e.g. 20 or 40).
4. Enter Container Cubic Meters for the total cubic capacity of the container.
5. These fields are purely informational — they are not part of the automatic calculation but are available for printing or reporting.

As a Purchasing Agent
I want to enter a measured weight figure from an external weighing device
So that the actual physical weight of the full container is stored alongside the calculated weight totals

Setup:

1. Open the Inbound Container Card.
2. In the Measurements and Value group, find the Measured Weight field.
3. Enter the weight as read from the weighbridge or other measuring device.
4. This value is stored as-is and is not affected by the Calculate Content and Value action.

Note: Measured Weight is a free-entry field for informational purposes. It can be used to compare against the calculated Handling Gross Weight to detect discrepancies.

As a Purchasing Agent
I want to see the total monetary value of all lines assigned to a container
So that I can cross-check against supplier invoices or freight value declarations

Setup:

1. Open the Inbound Container Card.
2. Run Calculate Content and Value.
3. Review the Total Amount from Container Lines (LCY) field in the Measurements and Value group.
4. This value is the sum of the line amounts in LCY across all linked purchase order lines and transfer order lines. For purchase lines in a foreign currency, the app converts to LCY using the currency factor on the purchase header.

As a Purchasing Agent
I want to understand when the Calculate Content and Value action is unavailable
So that I know why the calculation is blocked and how to proceed

Setup:

1. Open the Inbound Container Card for a container where some lines have already been received (partially posted).
2. Click Calculate Content and Value.
3. If posted receipt lines exist for this container, the app checks whether they have quantity. If they do, a message is shown indicating which purchase receipt or transfer order line has already been posted, and the calculation is blocked.
4. The calculation is also blocked if the container status is Posted.

Note: This protection exists because once posting has started, the line data is split between open order lines and posted receipt lines. The calculation still correctly reads both sources during normal operation; the block only applies when an inconsistent state is detected.

As a IT Manager
I want to navigate from the Inbound Container Setup to the Content and Value Setup
So that I can configure how weight and volume fields are populated from item and purchase data

Setup:

1. Search for Inbound Container Setup and open it.
2. Click Open Content and Value Setup in the action bar.
3. This opens the Shipping Manager Setup page where the rules for weight and volume field mapping are configured.

Note: The Content and Value Setup is managed by the Shipping Manager component. Configuring it correctly ensures that item gross weight, net weight, and volume values flow correctly into the container line calculations.