Cargo-Planner Docs

Cargo properties

Each cargo has a list of properties that can be assigned to it which may or may not affect the load plan. You assign properties in the 1. Data view

Cargo properties table

SKU

Unique identifier of the cargo. Will automatically be set to an auto increasing number of not specified

Name

Name or description of cargo. Will be set to SKU of not specifieed

Length

Length of cargo

Width

Width of cargo

Height

Height of cargo

Weight

Weight of cargo per piece

Quantity

Depending on values in this field - one of three different calculation modes will happen:

  • If all rows has a quantity set, then the tool load the cargoes in as many containers as is necessary
  • If no rows has a quantity set - then the tool will try to fit as much as possible into one of the selected containers.
  • If some rows has a quantity set and some has not - then the tool will load the cargoes that has a quantity set in as many containers as needed - and then use the items that has no quantity set as “fillers”

Not stackable

If checked, then no cargo (including itself) is allowed to be put on top. The cargo itself is however allowed to be put on other cargoes which are stackable.

Bottom only

If checked then this cargo must be loaded at the bottom on the floor. If nothing else is specified then other cargoes can still be loaded on top of this cargo

Orientations

Used to specify in which orientations the cargo can be loaded. Avaialable options are based on the geometry of the cargo.

Rotatable

The cargo can be rotated. Default option for box geometry

Rotatable cargo

Tiltable

The cargo can be rotated in any direction

Tiltable cargo

Longship

The cargo can only be loaded in its lengthwise direction

Longship cargo

Standing

The cargo can only be loaded standing. Default option for cylinders

Standing cargo

Laying (crosswise)

The cargo can only be loaded laying in its crosswise direction

Laying crosswise cargo

Laying (lengthwise)

The cargo can only be loaded laying in its lengthwise direction

Laying lengthwise cargo

Custom

You can set a custom orientation as well

For API users or when using the Excel template:

If you need to enter an orientation for your cargo through the Excel sheet or by using the API - you have to enter a number from 1-63 - (which is what the app is using internally). This number is actually a bit mask of values between 1-63. The first orientation, which in the app is called “Longship” means a value of 1. The second orientation which essentially means the cargo rotated around its Z axis has a value of 2. This means that if you allow both those values it results in an orientation number of 3

Max Layers

If a layer option is provided for a cargo (a number) it means that this cargo can only be stacked up to a certain amount of times (layers). Longship layers

Max load

Max weight (in dimension specified by loadlist) that is allowed to be loaded on top of a cargo

Geometry

The geometry of the cargo. By default it will be set to “Box”.

It can also be “Pipe” which is a cylinder laying down. The Height and Width will be the diameter.

If set to “Drum” it will be a standing cylinder, and the Length and Width will be the diameter.

Color

The color of a cargo. If no color is provided it will be set to a random color.

Group / Consignment

Different cargoes can belong to the same group / shipment / consignment. If you enter a ID (number or text) then cargoes with the same ID will be loaded together.

Note that by default cargoes with different group ID’s will be loaded into different containers. If you want to allow cargoes with different ID’s to be loaded into the same containers you can change this behaviour in the Load settings

Class

Used for adding custom classes to your cargo. Classes can be used together with a segregation table to separate loading of certain cargoes.

Preload

If this cargo should be pre loaded on a pallet or box (secondary equipment) before being loaded into the container - check this to true

Load in

If a cargo needs to be loaded in a specific container type then double-click in this column and a new dialog will be shown where you can select the allowed equipments. Equipments can be selected from the loadlist or the equipment library.

Container IDs

Priority

If cargoes should be loaded in a particular order you can use the Priority column. Here we have three different cargoes with three different priorities.

Cargoes with different priorities

A cargo with a higher priority will be loaded before a cargo with a lower priority

Container with cargoes loaded by priorities

Margin

A distance around the cargo that will act as “free space”. Enter a number here if your cargo needs extra room for lashings or other purposes Cargo zone

Unit Quantity

Unit quantity. If set, then the Quantity field will internally be divided by this field. Example: Unit quantity set to 5 and Quantity field set to 12 - then 3 pieces of the item will be loaded”

Destination

The assigned geographic destination for the cargo. Free text field that supports input such as country, city, zip code and street. See routing for more information about this feature.

Examples:

  • France

  • Main St, San Francisco

  • 211 30, Sweden