N4 3.6.34 Cargo Manual
N4 3.6.34 Cargo Manual
Cargo Manual
Administrator and User Guide
3.6.34
CONFIDENTIAL INFORMATION OF Navis LLC
This help has been made available as part of the license that has been granted to an authorized user of Navis
LLC software. Use of this documentation is subject to the terms and limitations of that license agreement. This
documentation describes all functionality that can be licensed for this product. Not all functionality described in
this documentation may be available to you depending on your license agreement. If you are not aware of the
relevant terms of your license agreement, contact sales at Navis LLC. This document is protected by copyright
and by the licensee’s agreement to maintain the confidentiality of the content of this document as provided in
the license agreement for the software.
Liability Disclaimer
Navis LLC takes steps to ensure that its published documentation is correct; however, errors do occur. Navis
LLC reserves the right to correct any such errors and disclaims liability resulting therefrom.
Navis LLC
www.navis.com
Contents
Part 1 Cargo Overview and Getting Started. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Cargo Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Getting Started. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 3
Confidential -- Proprietary
Contents
ROADGATE034 (CARGO_BL_LOV_FILTER). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
xpscacheCARGO001 (CARGO_XPS). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
2.2.3 Cargo Privileges. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
2.2.3.1 N4 Cargo Privileges. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
2.2.3.2 N4 Mobile Privileges. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 4
Confidential -- Proprietary
Contents
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 5
Confidential -- Proprietary
Contents
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 6
Confidential -- Proprietary
Contents
5.1.15 Merge or move the Bill of Lading (BL) items when you re-consign one BL to another BL with identical
commodities. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188
5.1.16 Create invoice for multiple cargo lots using the 'generate-invoice-request' API. . . . . . . . . . . . . . . . 192
Index. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 7
Confidential -- Proprietary
Part 1
Cargo Overview and Getting
Started
In this Section:
Cargo Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Getting Started. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 8
Confidential -- Proprietary
Cargo Overview
Prerequisites
• General Cargo, RDT Cargo Tracking (for accessing the Cargo Inventory program in N4 Mobile), and Bills of Lading
(for creating bill of lading and bill of lading items) licenses.
The General Cargo Option is useful for terminals that handle bulk cargo. This option provides a simple, fast, and
efficient way to manage non-containerized cargo, such as break-bulk, rolling cargo, and bulk cargo.
You can use N4 for cargo setup and configuration and either N4 or N4 Mobile for performing cargo operations.
Cargo Lot Management enables you to track cargo in three basic ways:
• Bulk Cargo
▪ Cargo is tracked by weight or volume, such as coal, wheat, and crude oil.
• Quantified Cargo
▪ Cargo is tracked by quantity. This is sometimes referred to as Pseudo Bulk Cargo. In this case, each piece of
cargo does not have a unique identifier either because the identifier is unknown or because the pieces are too
numerous and interchangeable; therefore, this type of cargo is tracked only by quantity.
• Identified Cargo
▪ Each piece of cargo is tracked by a known and unique identifier, such as the VIN number of a car.
N4 supports the following gate transaction types for break-bulk cargo:
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 9
Confidential -- Proprietary
Part 1: Cargo Overview and Getting Started Cargo Overview
Key Terms
Ad hoc pick-up
Break-bulk cargo
General cargo that is conventionally stevedored and stowed (palletized or sling), as opposed to bulk or containerized
cargo.
Bulk cargo
Cargo that is stowed without packaging such as a container, grains and liquids are common examples of bulk cargo.
Non-containerized
Cargo that is not loaded into a container, such as break bulk, dry bulk, liquid bulk, large machinery, or rolling stock. N4
does not currently handle non-containerized cargo.
Identified Lots
Identified cargo lots for a bill of lading item. For example, a car.
A building where containers are packed and unpacked to consolidate loads from multiple shippers that are shipping
less than a full container load.
Manifest
A summary of all cargo that was loaded onboard a specific vessel (or train) during a specific voyage (or train service).
Manifests are usually broken down by load port, discharge port, transshipment port, and bill of lading number. Often
received via EDI.
Cargo bay
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 10
Confidential -- Proprietary
Part 1: Cargo Overview and Getting Started Cargo Overview
A document or a contract between a line operator and a shipper. The bill of lading lists all cargo items received from a
shipper that will be delivered to the consignee named in the contract. It also lists the origin and the destination of the
cargo. One bill of lading can list cargo items that are distributed among several containers. Conversely, one container
can include cargo items from several bills of lading. Each bill of lading relates to a single vessel visit.
Next Step:
Read the Getting Started section. This section provides an overview of the setup and configuration tasks that
you must complete before you perform any cargo operation.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 11
Confidential -- Proprietary
Getting Started
The following tables provide a comprehensive overview of the different setup and configuration tasks you must
complete before you begin performing cargo operations.
Setup
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 12
Confidential -- Proprietary
Part 1: Cargo Overview and Getting Started Getting Started
Configuration
Tasks Setup
Business Tasks You can include or exclude business tasks in
N4 to configure the gate for the Deliver Break-
Bulk (DB) and Receive Break-Bulk (RB)
transaction types.
For more information on configuring business
tasks, see Business Tasks form.
For more information on the cargo business
tasks, see Cargo Business Tasks.
Cargo Privileges Use the Cargo privileges to secure the various
cargo related components in N4 and N4
Mobile.
For more information, see Cargo Privileges (on
page 51).
Cargo Settings Use the Cargo settings to specify the level of
validation that N4 must implement for the cargo
and bills of lading associated with a container.
For more information, see Cargo Settings (on
page 39).
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 13
Confidential -- Proprietary
Part 1: Cargo Overview and Getting Started Getting Started
Bill of Lading (BL) Settings Configure the level of BL functionality used fro
your site using the available BL settings.
For more information, see Bill of Lading
settings (on page 39).
For detailed information on setup and configuration, see the Cargo Setup and Configuration chapter.
For process flows that describe how to configure a gate and EDI, see Configuring a Gate and EDI Process flow.
Next step:
If you have completed the setup and configuration tasks, you are ready to perform cargo operations. The
Cargo How Do I section illustrates performing Deliver Break-Bulk and Receive Break-Bulk transactions.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 14
Confidential -- Proprietary
Part 2
Cargo Setup and
Configuration
In this Section:
Cargo Setup. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Cargo Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 15
Confidential -- Proprietary
2.1 Cargo Setup
This section describes all the reference data that you need to add and configure as part of cargo management.
Commodities view. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Special Stows view. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Hazard Placards view. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Hazard Fire Code view. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Package Types view. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Product Types view. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Hazardous Goods view. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
Cargo Damage Types view. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 16
Confidential -- Proprietary
Part 2: Cargo Setup and Configuration Cargo Setup
Commodities view
The Commodities view displays the commodity codes that exist at the current scope level. A commodity code is a
site-specific code indicating the contents of a container, such as cotton, shrimp, electronics, and clothes. Typically,
commodity codes are assigned to exports received at the gate. Some facilities also assign commodity codes to imports
and transships.
A facility uses commodity codes for decking because some commodities tend to get rolled often as exports and some
commodities tend to have long dwell times as imports.
You can add new commodity codes, and edit or delete existing commodity codes from this view.
You cannot purge an archetype commodity, if the commodity is referenced by one or more non-archetype
commodity.
Click .
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 17
Confidential -- Proprietary
Part 2: Cargo Setup and Configuration Cargo Setup
Commodities view
Commodities Columns
Short Label Long Label In Filter? Sorting?
Arch Archetype Commodity X X
Archetype? Is Archetype? X X
Changed Record Changed Date X X
Changer Record Changed User X X
Cmdy Code Commodity Code X X
Cmdy Id Commodity ID X X
Cmdy Short Name Commodity Short Name X X
Created Record Create Date X X
Creator Record Create User X X
Description Description X X
Exclusive Tower Is Exclusive Reefer Tower X X
Film Is Film X X
Food Is Food X X
HazValidation Validate Hazard X X
Heat Sensitive Is Heat Sensitive X X
Humd Req.% Humidity required, % X X
icon1 Icon #1 X X
icon2 Icon #2 X X
Life Cycle Life Cycle State X X
Oils Is Oils X X
RngeValidation Validate Temperature X X
Range
Taintable Is Taintable X X
Tainting Is Tainting X X
Temp Ideal Ideal Temperature (C) X X
Temp Max Maximum Temperature X X
Temp Min Minimum Temperature X X
TempValidation Validate Ideal X X
Temperature
UN/NA UN/NA Identification X X
Number .
Valuable Is Valuables X X
VCG Ratio Vertical Center Of Gravity X X
Ratio
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 18
Confidential -- Proprietary
Part 2: Cargo Setup and Configuration Cargo Setup
Commodities view
The Commodity form enables you to add and edit a commodity code. A commodity code is a site-specific code
indicating the contents of a container. N4 applies rudimentary hazardous information to a container based on its
commodity. You can also define the temperature requirements for refrigerated commodities. When you receive a
container load of one of these commodities, N4 automatically applies the temperature requirements to the container at
the gate.
You can use this form to manually add commodity codes or use the Actions Copy Reference Set option to copy
commodity codes defined in an existing entity set.
6. Optionally, use the various check boxes, such as Is Food, Is Film, and Is Oils, to define additional characteristics of
the commodity.
Currently, N4 does not use these check boxes to validate information about the commodity in any other data
entry forms.
7. In the Vertical Center of Gravity Ratio field, enter the vertical center of gravity ratio for the commodity.
To calculate the vertical center of gravity ratio divide the center of gravity of the container by the container height.
The vertical center of gravity ratio must be greater than 0.0 and less than 1.0. The aggregate vertical center of
gravity ratio affects the stability of the vessel.
8. Enter other optional information for the commodity.
9. Click Save.
The following table lists the optional fields in the Commodity form.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 19
Confidential -- Proprietary
Part 2: Cargo Setup and Configuration Cargo Setup
Commodities view
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 20
Confidential -- Proprietary
Part 2: Cargo Setup and Configuration Cargo Setup
Commodities view
UN/NA Identification Number Enter the UN/NA Identification Number for the commodity.
Validate Hazard Select the check box if you want to validate the hazard
information for the commodity at the gate.
N4 performs the following validations in any form that contains both the Commodity field and the Temp. Required
field:
• If you select the Non-reefer only check box, entering a value in the Temp. Required field generates an error.
• If you select the Validate Temperature Range check box, the value specified in the Temp. Required field must be
between the values specified in the Minimum Temperature and Maximum Temperature fields for the commodity.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 21
Confidential -- Proprietary
Part 2: Cargo Setup and Configuration Cargo Setup
Commodities view
• If you select the Validate Ideal Temperature check box, the value specified in the Temp. Required field must be
equal to the Ideal Temperature specified for the commodity.
If you do not select any of the check boxes in the Commodity form, N4 does not perform any validations.
The various forms in N4 using the above validations are:
Each icon has a background and foreground code associated with it.The background code represents Icon #1 and the
foreground code represents icon #2. XPS uses the alternate icon (Icon #2) if the first icon (Icon #1) is not available.
For instructions for how to configure commodities, see Commodity form (on page 18).
5 6 Timber
7 8 Fragile goods
9 10 Beer
11 12 Malt
13 14 Ice Cream
15 16 Onion
17 18 French Fries
The Assign Commodity Archetype form enables you to assign an archetype commodity to one or more non-
archetype commodity(s) selected from the Commodities view (on page 17). If a non-archetype commodity already
has an archetype assigned, you can use this form to update it.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 22
Confidential -- Proprietary
Part 2: Cargo Setup and Configuration Cargo Setup
Special Stows view
When you add or update one or more archetype or non-archetype commodity(s), N4 displays the corresponding
Commodity ID in the Arch field in the Commodities view (on page 17).
The Special Stows view displays the special stow codes that exist at the current scope level. Special stow codes are
assigned to containers with special requirements for loading to a vessel. For example, use special stow codes to
identify a container that is out-of-gauge, has a specific temperature or humidity requirement, or is carrying hazardous
cargo.
There are a few basic stow codes that vessel planners know and follow. For example, ADEK means 'Above Deck', and
the planner knows to plan the container to an above deck stow position. With special stow codes, it is best to have only
a few that everyone understands. Typically, twenty or so stow codes will cover 99% of special stow conditions.
You can add new special stow codes, and edit or delete existing special stow codes from this view.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 23
Confidential -- Proprietary
Part 2: Cargo Setup and Configuration Cargo Setup
Hazard Placards view
Click .
The Special Stow form enables you to add and edit special stow codes. Special stow codes are usually maintained by
the facility. Use this form to manually add special stow codes or use the Actions Copy Reference Set option to
copy special stow codes defined in an existing entity set.
The Hazard Placards view displays the hazard placards that exist at the current scope level. The hazard placards are
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 24
Confidential -- Proprietary
Part 2: Cargo Setup and Configuration Cargo Setup
Hazard Placards view
used as a visual identification of the hazards associated with a unit. The hazard placards are based on the hazard
class and the packaging group of the hazard.
Most facilities record the hazard placards observed on a container. For more information on adding or updating
hazards for a unit, see Update Hazards form.
You can add new hazard placards, and edit or delete existing hazard placards from this view.
Click .
The Hazard Placard form enables you to add and edit hazard placards. The hazard placards are used when defining
the hazards associated with a unit. For more information, see Update Hazards form.
To enter weight using a specific unit, type the standard unit symbol, such as lb (pounds), mt (metric ton), lt
(long ton), or st (short ton), immediately after the numeric value. For example, to specify weight in Pounds,
enter 50000 lb in the text field. The symbol for the default unit for a field is displayed as part of the field
label.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 25
Confidential -- Proprietary
Part 2: Cargo Setup and Configuration Cargo Setup
Hazard Fire Code view
4. Click Save.
The Hazard Fire Code view displays the hazard fire codes that exist at the current scope level. You can use the
hazard fire codes to map your local hazard identification convention to the standard UN hazard identifiers (Hazard
Class and UN Number).
When you add or edit a hazard item, N4 maps the hazard to the corresponding hazard fire code that you define in this
view and displays the hazard fire code in the Hazards form.
N4 also displays the fire hazard code in the Units view and the Contents tab in the Unit Inspector.
You can add, edit, and delete hazard fire codes from this view.
You can also use the Administration DBA Import SNX File SNX Importer form to import an XML file with the
hazard fire code data.
Click .
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 26
Confidential -- Proprietary
Part 2: Cargo Setup and Configuration Cargo Setup
Hazard Fire Code view
The Fire Code form enables you to add and edit a hazard fire code. You can use a hazard fire code to map your local
hazard identification convention to the UN hazard identifiers, the Hazard Class and the UN Number.
Premium Code
A premium code identifies the severity of the hazard with which it is associated. N4 uses the premium code to
determine the main IMDG hazard class and UN number associated with a unit.
If there is only one hazard associated with a unit, N4 displays the corresponding IMDG class and UN number as the
main hazard and also uses it in the Chargeable Unit events table for billing purposes.
• N4 selects the hazard with the most severe premium code as the main hazard
• If multiple hazards have the same premium code, N4 selects the heaviest hazardous cargo as the main hazard
For example, if the following hazards are associated with a unit:
2.2 2345 B
If A represents the premium code for the most severe hazard, N4 assigns the hazard with the IMDG Class 1.2 and UN
number 1234 as the main hazard for the unit.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 27
Confidential -- Proprietary
Part 2: Cargo Setup and Configuration Cargo Setup
Package Types view
Since all the hazards have the same premium code, N4 selects the hazard with the heaviest cargo weight and assigns
the hazard with the IMDG class 4 and UN number 9898 as the main hazard for the unit.
The Package Types view displays the package types that exist at the current scope level. Use package types to define
the packaged items manifested on a bill of lading, such as a pallet or a barrel. For more information on bill of lading
items, see Bill of Lading Item form (on page 66). N4 uses the information specified for the package type to
automatically fill in the fields in the Bill of Lading Item form.
N4 allows you to associate an icon with the commodity (on page 18), package type (on page 29), and the product
type (on page 31) entities. The precedence of the icon displayed in the Cargo Lot Inspector (on page 101), Bill of
Lading Inspector (on page 74), and the Unit Inspector is as follows:
• Package Type
• Product Type
• Commodity
• Standard Navis Cubes icon
You can add new package type, or edit and delete existing package types from this view.
You cannot delete a package type if it is associated with a bill of lading item.
Click .
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 28
Confidential -- Proprietary
Part 2: Cargo Setup and Configuration Cargo Setup
Package Types view
The Package Type form enables you to add a package type or edit an existing package type. Use package types to
define the packaged items manifested on a bill of lading, such as a pallet or a barrel. For more information on bill of
lading items, see Bill of Lading Item form (on page 66).
N4 allows you to associate an icon with the commodity (on page 18), package type (on page 29), and the product type
(on page 31) entities. The precedence of the icon displayed in the Cargo Lot Inspector (on page 101), Bill of
Lading Inspector (on page 74), and the Unit Inspector is as follows:
• Package Type
• Product Type
• Commodity
• Standard Navis Cubes icon
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 29
Confidential -- Proprietary
Part 2: Cargo Setup and Configuration Cargo Setup
Product Types view
The Product Types view displays the product types that exist at the current scope level. Use product types to define
the type of product for an item on a bill of lading. A product type is the Universal Product Code (UPC) for an item, such
as USGE357 for General Electric product number 357 sold in the US. For more information on bill of lading items, see
Bill of Lading Item form (on page 66). N4 uses the information specified for the product type to automatically fill in
the fields in the Bill of Lading Item form.
N4 allows you to associate an icon with the commodity (on page 18), package type (on page 29), and the product type
(on page 31) entities. The precedence of the icon displayed in the Cargo Lot Inspector (on page 101), Bill of
Lading Inspector (on page 74), and the Unit Inspector is as follows:
• Package Type
• Product Type
• Commodity
• Standard Navis Cubes icon
You can add new product types, and edit or delete existing product types from this view.
You cannot delete a product type if it is associated with a bill of lading item.
Click .
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 30
Confidential -- Proprietary
Part 2: Cargo Setup and Configuration Cargo Setup
Product Types view
The Product Type form enables you to add a new product type and edit an existing product type. Use product types to
define the type of product for an item on a bill of lading. A product type is the Universal Product Code (UPC) for an
item, such as USGE357 for General Electric product number 357 sold in the US.
N4 allows you to associate an icon with the commodity (on page 18), package type (on page 29), and the product type
(on page 31) entities. The precedence of the icon displayed in the Cargo Lot Inspector (on page 101), Bill of Lading
Inspector (on page 74), and the Unit Inspector is as follows:
• Package Type
• Product Type
• Commodity
• Standard Navis Cubes icon
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 31
Confidential -- Proprietary
Part 2: Cargo Setup and Configuration Cargo Setup
Hazardous Goods view
The Hazardous Goods view displays the hazardous goods that exist at the current scope level. The hazardous goods
listed in this view form the reference data that is displayed in various forms that allow you to associate hazards with
other entities such as bookings and units.
If you have the hazardous goods data as an XML file based on the snx.xsd, you can use Administration DBA
Import SNX File option to import the initial data for the Hazardous Goods view.
You can also add, edit, and delete hazardous goods records from this view.
For more information about the privileges for the Hazardous Goods view, see Cargo Privileges (on page 51).
In addition, you can use the Actions Export SNX File option to export the selected hazardous goods records as an
XML file using the snx.xsd format. For example, if you make a lot of edits to the data at one facility and you want to
replicate the same edits across all facilities, you can use the Export SNX File option to export the data from the first
facility and use SNX to import it at the other facilities.
Click .
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 32
Confidential -- Proprietary
Part 2: Cargo Setup and Configuration Cargo Setup
Hazardous Goods view
The Hazardous Goods form enables you to add hazardous goods records for your site. You can also use this form to
edit an existing hazardous goods record.
2. Enter other optional information for the hazardous goods record, such as the IMDG Class, the Proper Name, and
the Placards.
3. Click Save.
N4 uses the data specified in this form to automatically fill-in the appropriate fields in when you are adding
hazards for a container or a booking.
However, if you use this form to edit the hazardous goods information after you have associated the
hazardous goods with a unit or a booking, N4 does not automatically update the unit record. If you want to
update the unit record, you must do so manually using the Hazards form.
The following table lists the optional fields in the Hazardous Goods form:
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 33
Confidential -- Proprietary
Part 2: Cargo Setup and Configuration Cargo Setup
Hazardous Goods view
The Hazardous Goods Inspector displays the details of the selected hazardous goods record. You can keep the
Hazardous Goods Inspector open at all times as you work in other views and forms, and you can move and resize it
as needed.
When you update the selected hazardous goods record, N4 automatically refreshes the information displayed in the
Hazardous Goods Inspector.
The basic information for a hazardous goods record is displayed in the following areas:
• Inspect Hazardous Goods: The left area displays the UN/NA Number for the hazardous goods record.
• Details: The middle area displays the hazardous goods details, such as the IMDG class, the proper name for the
hazardous goods, the organization that issued the identification number, and whether the placards associated with
the record are optional.
• Placard Details: The right area displays the details of the hazard placards associated with the record.
N4 automatically fills-in these details from the Hazard Placards view (on page 24).
The Details pane (on page 35) displays additional information for the selected hazardous goods record below the
button.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 34
Confidential -- Proprietary
Part 2: Cargo Setup and Configuration Cargo Setup
Hazardous Goods view
1. Click .
2. From the list on the left, select the type of information to display.
To perform actions:
1. Click Actions to display the menu.
2. Select the required menu option.
The Details pane in the Hazardous Goods Inspector displays the additional risks associated with the hazardous
goods in the Subsidiary Risks (on page 35) tab.
The Subsidiary Risks tab displays the additional risks associated with the selected hazardous goods record. You can
add, edit, and delete subsidiary risks from this tab.
For more information about the privileges for the Subsidiary Risks tab, see Cargo Privileges (on page 51).
The Subsidiary Risk form enables you to add or edit a subsidiary risk associated with the selected hazardous goods
record.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 35
Confidential -- Proprietary
Part 2: Cargo Setup and Configuration Cargo Setup
Cargo Damage Types view
You can associate only one placard with each subsidiary risk record. To specify additional placards, add
multiple subsidiary risks with the same IMDG Class.
3. Select the Is Placard Optional check box, if the placard associated with the subsidiary risk is optional.
4. Click Save.
When you associate the hazardous goods record with an entity, such as a unit or a booking, N4 associates all the
unique placards specified for the hazardous goods and any subsidiary risks with the entity. For example, if you have
the same placard associated with the hazardous goods record and a subsidiary risk record, N4 displays the placard
only once for the entity with which you associate the hazardous goods.
The Cargo Damage Types view displays the damage types that you can record against cargo lots. The damage types
displayed in the Damage Types view are used to record damages against equipment, such as containers and chassis.
Since cargo lots are not associated with any equipment, you must use the damage types displayed in the Cargo
Damage Types view to record damages against cargo lots.
You can add new cargo damage types or edit and delete existing cargo damage types from this view.
You must have the Cargo Damage Type privileges to view and update records in this list view. For more
information on available privileges, see General Cargo Privileges (on page 47).
In addition, you can use the Actions menu to:
When you use the Delete ( ) button to delete a damage type, N4 does not delete the damage type permanently. It
only marks the damage type as obsolete. You can use the Display Show All option to view all the obsolete
records in the list view. The Lifecycle column indicates whether a damage type is active or obsolete.
When you record a damage against a cargo lot, N4 displays only the active damage types in the lookup field.
Click .
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 36
Confidential -- Proprietary
Part 2: Cargo Setup and Configuration Cargo Setup
Cargo Damage Types view
The Cargo Damage Type form enables you to add or edit a cargo damage type (on page 36). You can use a cargo
damage type to record a damage against a cargo lot. To add a damage type for an equipment, such as a container or a
chassis, use the Equipment Damage Type form.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 37
Confidential -- Proprietary
2.2 Cargo Configuration
This section lists the N4 settings that you can use to configure various cargo operations.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 38
Confidential -- Proprietary
Part 2: Cargo Setup and Configuration Cargo Configuration
Bill of Lading settings
INVBL001 (TRUE_BILLS_OF_LADING)
Set it to false if you do not use the full Bill of Lading functionality and you want N4 to treat the BL number as only a text
field.
You can use the Shipment Details form to record the BL number for a unit. In addition, N4 displays the BL number in
the Units view and in the Status area in the Unit Inspector.
For validating the POD of the unit against the POD of the BL, see the CGOCargoValidation002
(MATCH_BL_UNIT_POD) (on page 40) setting.
INVBL002 (BILLS_OF_LADING_FOR_ALL_IMPORT_EMPTIES)
Set it to true if you use bills of lading for all empty import containers and if you do not want N4 to send the BL Number
to XPS as the release number.
CGOCargoRelease001 (RELEASE_BY_QTY_FLAGTYPE)
Specify the default terminal hold that you wish to apply to a Bill of Lading. Whenever a BL is created, N4 places this
hold that either releases or applies a hold by quantity. If the Released Quantity and the Manifested Quantity are
equal, the hold defined is released for a BL.
Ensure you use the same ID when defining the default hold using the Hold/Permission Type form.
CGOCargoValidation001 (MATCH_BL_UNIT_LINE)
This setting determines whether N4 must validate the line operator for the unit against the line operator for the bill of
lading during data entry in a form, SNX import, or processing an EDI message. The default value for
CGOCargoValidation001 is true and N4 validates the unit line operator against the BL line operator for all these
processes.
Set it to false, if you do not want N4 to validate the line operator for the unit against the line operator for the bill of
lading.If you override this setting for your site, you must do so at the Complex scope level for the EDI messages to
use the correct value of the setting.
If you see a line operator mismatch error message, it could be a result of this being set to true.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 39
Confidential -- Proprietary
Part 2: Cargo Setup and Configuration Cargo Configuration
Cargo Settings
CGOCargoValidation002 (MATCH_BL_UNIT_POD)
This setting determines whether N4 must validate the Port of Discharge (POD) for the unit against the POD for the bill
of lading during data entry in a form, SNX import, or processing an EDI message. The default value for
CGOCargoValidation002 is true and N4 validates the unit POD against the BL POD for all these processes.
Set it to false, if you do not want N4 to validate the POD for the unit against the POD for the bill of lading.If you
override this setting for your site, you must do so at the Complex scope level for the EDI messages to use the correct
value of the setting.
To enable/disable the Bill of Lading functionality, see INVBL001 (TRUE_BILLS_OF_LADING) (on page 39)
setting.
CGOCargoValidation003 (MATCH_BL_UNIT_POL)
This setting determines whether N4 must validate the Port of Load (POL) for the unit against the POL for the bill of
lading during data entry in a form, SNX import, or processing an EDI message. The default value for
CGOCargoValidation002 is true and N4 validates the unit POL against the POL for the BL for all these processes.
Set it to false, if you do not want N4 to validate the POL for the unit against the POL for the bill of lading.If you override
this setting for your site, you must do so at the Complex scope level for the EDI messages to use the correct value of
the setting.
CGOCargoValidation004 (MATCH_BL_UNIT_CARRIER_VISIT)
This setting determines whether N4 must validate the carrier visit for the unit against the carrier visit for the bill of lading
during data entry in a form, SNX import, or processing an EDI message. The default value for
CGOCargoValidation004 is true and N4 validates the unit carrier visit against the BL carrier visit for all these
processes.
Set it to false, if you do not want N4 to validate the carrier visit for the unit against the carrier visit for the bill of lading.If
you override this setting for your site, you must do so at the Complex scope level for the EDI messages to use the
correct value of the setting.
CGORECONSIGN001 (ON_RECONSIGN)
You can use this setting to determine whether to merge or move the Bill of Lading (BL) items when you re-consign one
BL to another BL with identical commodities. For information on how to re-consign one BL to another, see Merge or
move the Bill of Lading (BL) items when you re-consign one BL to another BL with identical commodities (on page
188).
By default, N4 merges the BL items if you re-consign one BL to another BL with matching commodity.
If you override this setting by selecting MOVE_ITEMS_IDENTIFIED_CARGO, N4 moves the BL items from one BL to
the other BL with matching commodity.
This setting is applicable only for identified cargo lots. You can use the Identified Lots tab (on page 71) in the
Bill of Lading Item form to add or edit identified cargo lots.
INVMOBILE_RDT005 (MOBILE_CARGO_INVENTORY_POPULATE_QTY)
N4 Mobile populates the Quantity field withthe cargo lot quantity in all N4 Mobile Cargo Inventory programs. You can
use this setting to either display or hide the cargo lot quantity in the Quantity field.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 40
Confidential -- Proprietary
Part 2: Cargo Setup and Configuration Cargo Configuration
Cargo Settings
True: N4 Mobile Cargo Inventory programs populate the Quantity field with the cargo lot quantity.
False: N4 Mobile Cargo Inventory programs do not populate the cargo lot quantity in the Quantity field and allows the
user to enter the quantity.
ROADGATE034 (CARGO_BL_LOV_FILTER)
This setting gives you the option to filter and view Cargo Bill Of Lading and Cargo BL Item data based on your gate
transaction type (either Receive Break-Bulk or Deliver Break-Bulk). For example, if you are performing a Receive
Break-Bulk transaction, the Cargo Bill Of Lading and Cargo BL Item LOV fields filter and display data only
associated with the Receive Break-Bulk transaction type.
True: The Cargo Bill Of Lading and Cargo BL Item LOV fields in the Gate form filter and display data based on the
transaction type (Receive Break-Bulk or Deliver Break-Bulk).
Depending on the size of your database, setting ROADGATE034 to True could cause performance issues that
may slow down your gate process.
False: The Cargo Bill Of Lading and Cargo BL Item LOV fields in the Gate form display all values irrespective of the
transaction type.
xpscacheCARGO001 (CARGO_XPS)
This setting determines if N4 should send break bulk cargo units to XPS. Set it to:
• true to share with XPS the break bulk cargo units listed on the N4 Unit Inspector Cargo Lots tab.
• false (default) if you don't want N4 to share with XPS the break bulk cargo units listed on the N4 Unit Inspector
Cargo Lots tab.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 41
Confidential -- Proprietary
Part 2: Cargo Setup and Configuration Cargo Configuration
Cargo Privileges
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 42
Confidential -- Proprietary
Part 2: Cargo Setup and Configuration Cargo Configuration
Cargo Privileges
INSPECT_BOL_DENY_COM Bill Of Lading Inspector - Deny access to Commodity CORE_FEAT System Foundation II
MODITY_NOTE Deny Access to Commodity Note column in Bill of Lading
Note Inspector
BILL_OF_LADING_ADD Bills of Lading - Add Add bills of lading BILL_OF_LADING Bills Of Lading
BILL_OF_LADING_EQUIPME Bills of Lading - Add Units/ Add units/items to bills of BILL_OF_LADING Bills Of Lading
NT_ADD Items lading
BILL_OF_LADING_COPY Bills of Lading - Copy Copies bills of lading BILL_OF_LADING Bills Of Lading
BILL_OF_LADING_DELETE Bills of Lading - Delete Delete bills of lading BILL_OF_LADING Bills Of Lading
BILL_OF_LADING_ITEM_DE Bills of Lading - Delete Items Delete bills of lading items BILL_OF_LADING Bills Of Lading
LETE
BILL_OF_LADING_EQUIPME Bills of Lading - Delete Units/ Delete units/items from bills of BILL_OF_LADING Bills Of Lading
NT_DELETE Items lading
BILL_OF_LADING_EDIT Bills of Lading - Edit Edit bills of lading BILL_OF_LADING Bills Of Lading
BILL_OF_LADING_VIEW Bills of Lading - View View bills of lading BILL_OF_LADING Bills Of Lading
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 43
Confidential -- Proprietary
Part 2: Cargo Setup and Configuration Cargo Configuration
Cargo Privileges
CFS Privileges
ID Name Description License Required Option Name
CARGO_STRIP Cargo Lot - Strip Strip Cargo Lot using CFS Container Freight
the Cargo Lot -> Station (CFS)
Actions menu
CARGO_STUFF Cargo Lot - Stuff Stuff Cargo Lot using CFS Container Freight
the Cargo Lot -> Station (CFS)
Actions menu
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 44
Confidential -- Proprietary
Part 2: Cargo Setup and Configuration Cargo Configuration
Cargo Privileges
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 45
Confidential -- Proprietary
Part 2: Cargo Setup and Configuration Cargo Configuration
Cargo Privileges
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 46
Confidential -- Proprietary
Part 2: Cargo Setup and Configuration Cargo Configuration
Cargo Privileges
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 47
Confidential -- Proprietary
Part 2: Cargo Setup and Configuration Cargo Configuration
Cargo Privileges
This privilege is
applicable only if
the user has at
least the Cargo
Lot - View
privilege to
access the
Cargo Lots view
and the Pre-
Advised Cargo
view.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 48
Confidential -- Proprietary
Part 2: Cargo Setup and Configuration Cargo Configuration
Cargo Privileges
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 49
Confidential -- Proprietary
Part 2: Cargo Setup and Configuration Cargo Configuration
Cargo Privileges
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 50
Confidential -- Proprietary
Part 2: Cargo Setup and Configuration Cargo Configuration
Cargo Privileges
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 51
Confidential -- Proprietary
Part 2: Cargo Setup and Configuration Cargo Configuration
Cargo Privileges
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 52
Confidential -- Proprietary
Part 2: Cargo Setup and Configuration Cargo Configuration
Cargo Privileges
In addition to the
Subsidiary Risks -
Add privilege, you
must have the
Hazardous Goods -
Inspector privilege to
be able to add
Subsidiary Risks for a
hazardous goods
record.
The above
statements are also
true for the other
subsidiary risks
privileges
(Subsidiary Risks -
Delete, Subsidiary
Risks - Edit, and
Subsidiary Risks -
View).
SUBSIDIARY_RISK_DELETE Subsidiary Risks - Delete Delete Subsidiary Risks. CORE_FEAT System Foundation II
SUBSIDIARY_RISK_EDIT Subsidiary Risks - Edit Edit Subsidiary Risks. CORE_FEAT System Foundation II
SUBSIDIARY_RISK_VIEW Subsidiary Risks - View View Subsidiary Risks. CORE_FEAT System Foundation II
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 53
Confidential -- Proprietary
Part 2: Cargo Setup and Configuration Cargo Configuration
Cargo Privileges
CARGO_INVENTORY_ Mobile Cargo Inventory Mobile Cargo - Cargo CARGO_MOBILE RDT Cargo
MOBILE Inventory Management
CARGO_IDENTIFY_MO Mobile Cargo Inventory - Identify Cargo Lot using CARGO_MOBILE RDT Cargo
BILE Identify Cargo Inventory Management
CARGO_INSPECT_MO Mobile Cargo Inventory - Inspect Cargo Lot details CARGO_MOBILE RDT Cargo
BILE Inspect using Cargo Inventory Management
CARGO_LOAD_RAIL_ Mobile Cargo Inventory - Load Cargo Lot to Rail CARGO_MOBILE RDT Cargo
MOBILE Load Rail using Cargo Inventory Management
CARGO_LOAD_TRUCK Mobile Cargo Inventory - Load Cargo Lot to Truck CARGO_MOBILE RDT Cargo
_MOBILE Load Truck using Cargo Inventory Management
CARGO_LOAD_VESSE Mobile Cargo Inventory - Load Cargo Lot to CARGO_MOBILE RDT Cargo
L_MOBILE Load Vessel Vessel using Cargo Management
Inventory
CARGO_MOVE_MOBIL Mobile Cargo Inventory - Move Cargo Lot using CARGO_MOBILE RDT Cargo
E Move Cargo Cargo Inventory Management
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 54
Confidential -- Proprietary
Part 2: Cargo Setup and Configuration Cargo Configuration
Cargo Privileges
CARGO_UPDATE_DAM Mobile Cargo Inventory - Record Damages for CARGO_MOBILE RDT Cargo
AGE_INSPECT_MOBIL Record Damage on Cargo Lot when Management
E Inspect inspecting using Cargo
Inventory
CARGO_UPDATE_DAM Mobile Cargo Inventory - Record Damages for CARGO_MOBILE RDT Cargo
AGE_LOAD_RAIL_MOB Record Damage on Cargo Lot when loading Management
ILE Load Rail to Rail using Cargo
Inventory
CARGO_UPDATE_DAM Mobile Cargo Inventory - Record Damages for CARGO_MOBILE RDT Cargo
AGE_LOAD_TRUCK_M Record Damage on Cargo Lot when loading Management
OBILE Load Truck to Truck using Cargo
Inventory
CARGO_UPDATE_DAM Mobile Cargo Inventory - Record Damages for CARGO_MOBILE RDT Cargo
AGE_LOAD_VESSEL_ Record Damage on Cargo Lot when loading Management
MOBILE Load Vessel on Vessel using Cargo
Inventory
CARGO_UPDATE_DAM Mobile Cargo Inventory - Record Damages for CARGO_MOBILE RDT Cargo
AGE_STRIP_MOBILE Record Damage on Strip Cargo Lot when Management
stripping using Cargo
Inventory
CARGO_UPDATE_DAM Mobile Cargo Inventory - Record Damages for CARGO_MOBILE RDT Cargo
AGE_STUFF_MOBILE Record Damage on Stuff Cargo Lot when stuffing Management
using Cargo Inventory
CARGO_UPDATE_DAM Mobile Cargo Inventory - Record Damages for CARGO_MOBILE RDT Cargo
AGE_UNLOAD_RAIL_M Record Damage on Cargo Lot when Management
OBILE Unload Rail unloading to Rail using
Cargo Inventory
CARGO_UPDATE_DAM Mobile Cargo Inventory - Record Damages for CARGO_MOBILE RDT Cargo
AGE_UNLOAD_TRUCK Record Damage on Cargo Lot when Management
_MOBILE Unload Truck unloading from Truck
using Cargo Inventory
CARGO_UPDATE_DAM Mobile Cargo Inventory - Record Damages for CARGO_MOBILE RDT Cargo
Cargo Lot when Management
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 55
Confidential -- Proprietary
Part 2: Cargo Setup and Configuration Cargo Configuration
Cargo Privileges
The Cargo Inventory tasks and the associated privileges are listed in the below table:
Task Privilege(s)
Record Cargo Inventory Mobile Cargo Inventory
Allows to identify the cargo lots based on Mobile Cargo Inventory - Identify
position, bill of lading, marks, or cargo lot ID .
Allows to search for cargo lots based on position, Mobile Cargo Inventory - Inspect
bill of lading, cargo lot ID, or marks and inspect
them.
Allows to search for cargo lots based on position, Mobile Cargo Inventory - Move Cargo
bill of lading, cargo lot ID, or marks and move
them.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 56
Confidential -- Proprietary
Part 2: Cargo Setup and Configuration Cargo Configuration
Cargo Privileges
Task Privilege(s)
Allows to search for cargo lots associated with a Strip: Mobile Cargo Inventory - Strip
bill of lading, unit ID or cargo lot and strip from a Stuff: Mobile Cargo Inventory - Stuff
container/stuff into a container.
Allows to search for cargo lots and load/unload to Rail: Mobile Cargo Inventory - Load Rail/Mobile
or from rail, truck or vessel using Cargo Cargo Inventory - Unload Rail
Inventory. Truck: Mobile Cargo Inventory - Load Truck/
Mobile Cargo Inventory - Unload Truck
Vessel: Mobile Cargo Inventory - Load Vessel/
Mobile Cargo Inventory - Unload Vessel
Allows to record damages for cargo lots when Rail: Mobile Cargo Inventory - Record Damage
loading/unloading to or from rail, truck or vessel on Load Rail/Mobile Cargo Inventory - Record
using Cargo Inventory. Damage on Unload Rail
Truck: Mobile Cargo Inventory - Record Damage
on Load Truck/Mobile Cargo Inventory - Record
Damage on Unload Truck
Vessel: Mobile Cargo Inventory - Record
Damage on Load Vessel/Mobile Cargo Inventory
- Record Damage on Unload Vessel
Allows to record damages for cargo lots when Damages: Mobile Cargo Inventory - Record
using/inspecting Cargo Inventory. Damages
Inspecting Damages: Mobile Cargo Inventory -
Record Damage on Inspect
Record damages due to cargo lot stripping/ Stripping: Mobile Cargo Inventory - Record
stuffing using Cargo Inventory. Damage on Strip
Stuffing: Mobile Cargo Inventory - Record
Damage on Stuff
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 57
Confidential -- Proprietary
Part 3
Cargo Management
In this Section:
Bills of Lading view. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Delivery Orders view. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
Cargo Lots view. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Pre-Advised Cargo view. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 58
Confidential -- Proprietary
3.1 Bills of Lading view
Operations Cargo Bills of Lading Bills of Lading view
Operations Unit Bills of Lading Bills of Lading view
Prerequisites
• To access the Bills of Lading view, you need to assign the Bills of Lading - View privilege to your user role.
A bill of lading is a document or a contract between a line operator and a shipper. See where bills of lading fit in the
Gate Operations process
The bill of lading lists all cargo items received from a shipper that will be delivered to the consignee named in the
contract. It also lists the origin and the destination of the cargo. One bill of lading can list cargo items that are
distributed among several containers. It can also list non-containerized cargo (cargo located on the vessel), such as
automobiles. Conversely, one container can include cargo items from several bills of lading. Each bill of lading relates
to a single vessel visit.
You can use bills of lading to manage the release of import and transship containers arriving on a deep sea vessel.
The Bills of Lading view displays the bills of lading that exist at the current scope level. You can create a filter to limit
the data displayed, such as displaying only the bills of lading for a specific vessel visit.
If you do not use the bill of lading functionality, set the INVBL001 (TRUE_BILLS_OF_LADING) (on page 39)
configuration setting as false.
When you set INVBL001 as false, N4:
• Does not display the bills of lading for a unit in the Bills of Lading view.
• Displays the bill of lading number in the Units view or in the Status area in the Unit Inspector.
• Allows you to record the bill of lading number for the selected unit using the Shipment Details form.
From this view, you can add new bills of lading, and edit or delete existing bills of lading.
You cannot delete a bill of lading if it is associated with an active gate transaction. In addition, you cannot delete
a Master BL before you delete all the associated Bills of Lading created using the Split BL action.
In addition, you can use the Actions menu to:
• Export SNX File: Export the selected bills of lading as an XML file using the snx.xsd format.
This action is not available from the Actions menu in the Bill of Lading Inspector (on page 74).
• Inspect Bill of Lading: Displays the Bill of Lading Inspector (on page 74) for the bill of lading selected in the list
view.
You can also double-click a bill of lading record in the list view to access the inspector.
• Copy Bill of Lading (on page 82): Copies the header information, such as Category, Line Operator, Vessel Visit,
POD, and POL, BL Items, and default cargo lots from the selected bill of lading to create a new bill of lading.
The Inspect Bill of Lading and the Copy Bill of Lading actions are not available from the Actions menu in
the Bill of Lading Inspector.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 59
Confidential -- Proprietary
Part 3: Cargo Management Bills of Lading view
Cargo Privileges
In addition, if you select multiple records in the list view, N4 disables the Inspect Bill of Lading and the
Copy Bill of Lading actions.
• Record Service Event: Record service events for the selected bill of lading.
• Update Holds/Permissions: Update holds/permissions for the selected bill of lading.
If you do not want to allow a user to edit a bill of lading but still be able to release a hold/permission
associated with a bill of lading, you can include the Bills of Lading Actions - Apply/Release the Holds/
Permissions privilege for the user and exclude the Bills of Lading - Edit privilege.
• Create Service Order (on page 83): Add a service order for the selected bill of lading.
• Delete Bill Of Lading: Deletes the selected bill of lading
Click .
N4allows you to delete a BL even if it is assigned to a unit/cargo lot provided the unit’s transit state is either
Advised, Inbound, or Retired. However, N4 does not allow you to delete a BL if some or all of the related
cargo/units/containers have one of the following transit states EC/IN, EC/OUT, Yard, or Loaded. Instead, N4
displays an error message, Cannot delete bill of lading {0}, as it is associated with Units
In This Section
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 60
Confidential -- Proprietary
Part 3: Cargo Management Bills of Lading view
Bills of Lading Columns
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 61
Confidential -- Proprietary
Part 3: Cargo Management Bills of Lading view
Bill of Lading form
You can use the Bill of Lading form to add or edit a bill of lading (on page 59). You can also use this form to associate
items (on page 66) and units (on page 73) to the bill of lading. See where this task fits in the Gate Operations
process
You must save a new bill of lading before you can add items or units to the bill of lading.
The bill of lading line operator must also be the line operator for the carrier visit specified in step 4, unless the
carrier visit is for a common carrier vessel.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 62
Confidential -- Proprietary
Part 3: Cargo Management Bills of Lading view
Bill of Lading form
4. From the BL Category drop-down list, select the category, such as Import, Export or Transship, for the bill of
lading.
You cannot add an Export unit to an Import bill of lading or an Import unit to an Export bill of lading.
5. From the Vessel Visit lookup field, select the vessel visit for the bill of lading.
6. N4 does not display carrier visits that are in the Archived, Closed, or Canceled phase in this list.
If you change the vessel visit associated with a bill of lading, N4 also verifies the Port of Load and Port of
Discharge fields. If the new vessel visit does not have these ports in the itinerary, N4 clears the fields in the
Bill of Lading form. If the new vessel visit has these ports in the itinerary, N4 does not change the values in
the Port of Load and Port of Discharge fields. If these values are no longer appropriate, you must manually
change these values. To view or edit the itinerary of a vessel visit, use the Edit Port Rotation form.
7. Specify any optional information such as the port of load, port of discharge, origin, and destination, for the bill of
lading.
8. Click Save.
The following table lists the optional fields in the Bill of Lading form:
Port of Load Select the port where the units will be loaded on
the vessel.
Port of Discharge Select the port where the units will be discharged
from the vessel.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 63
Confidential -- Proprietary
Part 3: Cargo Management Bills of Lading view
Bill of Lading form
PIN Enter the PIN (on page 65), PIN (on page 88)
associated with the bill of lading.
Notify Party1 Name Enter the name of the first party to which the arrival
notice must be sent.
Notify Party2 Name Enter the name of the second party to which the
arrival notice must be sent.
Notify Party1 Add1 Enter the mailing address of the first party to which
the arrival notice must be sent.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 64
Confidential -- Proprietary
Part 3: Cargo Management Bills of Lading view
Bill of Lading form
Notify Party2 Add1 Enter the mailing address of the second party to
which the arrival notice must be sent.
Notify Party1 Contact No1 Enter the contact number of the first party to which
the arrival notice must be sent.
Notify Party2 Contact No1 Enter the contact number of the second party to
which the arrival notice must be sent.
Notes
In addition to the fields listed here, you can configure additional fields for the Bill of Lading form using the
Database Backed Variforms view.
When you upload a Manifest EDI message with BL items, N4 processes all items individually, displays the BL
item number for each BL item, and updates the quantity, package weight, and total weight for each of the items.
N4 performs the weight calculations only if the Manifest EDI message has values for any two of the following
fields: Item Quantity, Package Weight (kg), or Item Total Weight (kg). If you specify the item quantity and
package weight, N4 calculates the item's total weight.
PIN
The PIN is a unique identification for a unit, bill of lading, or delivery order that a line operator can use to validate that a
truck driver is picking up the correct container or break-bulk cargo.
For unit
In N4, you can use the Delivery Requirements form to assign or edit the PIN for a unit. These privileges control the
ability to view and edit PIN associated with a unit:
• Pin - Check: You can check whether a PIN is assigned to a unit but you cannot see the actual number.
• Pin - View: You can view the PIN assigned to a unit, but you cannot edit the PIN.
• Pin - Edit: You can view and edit the PIN assigned to a unit.
• Deny access to Unit field PIN Number: You cannot view the PIN Number field or column on forms and list views.
If the user’s role excludes the privileges PIN - Check, PIN - Edit, and PIN – View, then on the Units view, the
PIN Number column displays the data as "****".
A line operator can control:
• Whether to use PINs for all units operated by the line operator
• Whether to assign a PIN for each unit or allow N4 to generate a PIN automatically when the unit is first created, for
example using a stow plan
Use the Line Operator form Booking Rules tab to specify these restrictions.
A line operator may receive the PIN from an EDI trading partner or it may be generated in N4. If the line operators
assign a PIN to a unit they can specify an alphanumeric value. If N4 generates the PIN, it consists of only digits but the
value is stored as a string value.
PIN is available as part of the Unit reporting entity and can be included in various reports.
You can configure the Pin Number field on a gate form at the outgate stage for a deliver gate transaction to force the
truck driver to enter a PIN. You can include the RejectPinNbrMismatch, RejectPinNbrNotAssigned, and
RejectPinNbrNotEntered business tasks in your gate configuration to control the delivery of a unit using the PIN.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 65
Confidential -- Proprietary
Part 3: Cargo Management Bills of Lading view
Bill of Lading form
If you have the privilege that allows you to edit a BL or a delivery order, you can edit the PIN assigned to the BL
or the delivery order.
You can include the Pin Number field as part of your Deliver Break-Bulk gate transaction to force the truck driver to
enter a PIN. You can include the RejectPinNbrMismatch, RejectPinNbrNotAssigned, and
RejectPinNbrNotEntered business tasks in your gate configuration to control the delivery of break-bulk cargo
using the PIN.
The Items tab displays the BL items associated with the selected bill of lading. You can use a BL item to define the
commodity and the package type of the cargo. In addition, you can specify any reefer requirements for the commodity.
You can add new BL items, and edit or delete existing BL items on this tab.
When you delete a BL item, N4 also deletes any associated records in the Cargo Lots view (on page 96) and the
Units view.
• Split BL (on page 72): Split the selected BL Items to a new or existing BL.
• Re-consign BL (on page 72): Re-consign the selected BL Items to a new or existing BL.
• Delete BL Item: Deletes the BL item.
A bill of lading item defines the commodity and the package type of the cargo. It also specifies additional details related
to the cargo, package contents, and any reefer requirements for the commodity.
Use the Bill of Lading Item form to add or edit an item for the selected bill of lading. When you save a BL item, N4
creates the default cargo lot for the BL item and lists it in the Cargo Lots tab (on page 70). N4 sets a period in the
Default column to indicate a default cargo lot. You cannot edit the Default field manually. After N4 creates the default
cargo lot, you can either manifest or identify this cargo lot. For more information on these actions, see the Cargo Lots
view (on page 96).
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 66
Confidential -- Proprietary
Part 3: Cargo Management Bills of Lading view
Bill of Lading form
In addition, you can use the Identified Lots tab (on page 71) to identify cargo lots for a BL item for quantified (non-
bulk) cargo.
You cannot add an identified cargo lot for a BL item for measured (bulk) cargo.
When you select a commodity, if applicable, N4 automatically fills in the Temp Min. (C) and Temp Max. (C)
fields in the Reefer Requirements tab using the data saved in the commodity record.
The lookup field displays only the commodities configured at the current scope level. You can add a new commodity
using the Commodity form (on page 18).
2. In the Item Quantity field, enter the quantity, such as the number of packages, bulk units, or measurements, for the
selected commodity.
3. Specify any optional information for the BL item.
4. Click Save.
The Sequence Number is a read-only field. When you save a BL item, N4 automatically generates the
Sequence Number to provide a unique identifier for the BL item.
When you save a BL item, N4 creates the default cargo lot for the BL item and displays it in the Cargo Lots tab (on
page 70). If you edit an existing bill of lading, N4 automatically updates the associated default cargo lot.
The following table lists the optional fields in the Item area in the Bill of Lading Item form.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 67
Confidential -- Proprietary
Part 3: Cargo Management Bills of Lading view
Bill of Lading form
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 68
Confidential -- Proprietary
Part 3: Cargo Management Bills of Lading view
Bill of Lading form
For non-bulk cargo, N4 performs the following calculations after you save a BL item. If you enter:
N4 recalculates these values if you update any of the above values in a BL item.
The following table lists the optional fields in the Details tab in the Bill of Lading Item form.
The following table lists the optional fields in the Package Contents tab in the Bill of Lading Item form.
Piece Quantity If you selected the Bulk Package check box, enter
the quantity of Piece Bulk Units for the bulk
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 69
Confidential -- Proprietary
Part 3: Cargo Management Bills of Lading view
Bill of Lading form
The following table lists the optional fields in the Reefer Requirements tab in the Bill of Lading Item form.
In the Reefer Requirements tab, the Temp Min. (C) and Temp Max. (C) fields are view-only fields and N4
automatically fills in these fields using the existing data for the selected commodity.
The Cargo Lots tab displays the cargo lots associated with the selected bill of lading item. When you save a BL item,
N4 creates the default cargo lot for the BL item and lists it in the Cargo Lots tab. You can double-click a cargo lot to
access the Cargo Lot Inspector (on page 101) and view more details about the selected cargo lot.
In addition, you can perform the following Actions on selected cargo lots on this tab:
• Edit Cargo Lot (on page 115): Edit some of the fields associated with the selected cargo lot record.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 70
Confidential -- Proprietary
Part 3: Cargo Management Bills of Lading view
Bill of Lading form
• Stuff (on page 115): Stuff the selected cargo lot(s) into a container.
• Strip (on page 118): Strip the contents of a container to a yard position.
• Create Delivery Order (on page 121): Create a delivery order for the selected cargo lot(s).
• Record Service Event: Record a service event for the selected cargo lot(s).
• Unload Unload Vessel (on page 123): Unload cargo from a vessel to a yard position.
• Unload Unload Truck (on page 124): Unload cargo from a truck to a yard position.
• Unload Unload Rail (on page 125): Unload cargo from a train or a railcar to a yard position.
• Load Load Vessel (on page 126): Load cargo from the yard to the specified vessel visit.
• Load Load Truck (on page 127): Load cargo from the yard to the specified truck visit.
• Load Load Rail (on page 129): Load cargo from the yard to the specified train visit.
• Manifest Manifest Container (on page 131): Manifest the selected cargo lot(s) to a container.
• Manifest Manifest Vessel (on page 132): Manifest the selected cargo lot(s) to a vessel.
• Manifest Manifest Rail (on page 134): Manifest the selected cargo lot(s) to a rail.
• Other Manufacture Cargo (on page 135): Create cargo lots for cargo manufactured at the facility.
• Other Adjust Cargo Lot Quantity (on page 136): Adjust the quantity of the selected cargo lot.
N4 records the adjustment as a discrepancy against the selected cargo lot record.
• Other Transload (on page 137): Transload the selected cargo lot(s) to another container.
• Other Identify Lot (on page 138): Identify the contents of the selected cargo lot(s).
• Other Cancel Manifest (on page 139): Cancel the manifest for the selected cargo lot.
• Other Split BL (on page 140): Split the bill of lading associated with the selected cargo lot into smaller BLs for
ease of processing.
• Other Re-consign BL (on page 141): Re-consign the selected cargo lots to a new or existing BL.
• Record Damages (on page 142): Record damages for the selected cargo lot.
The Identified Lots tab displays the identified cargo lots associated with the selected bill of lading item. For a
quantified (non-bulk) cargo BL item, you can add or edit identified cargo lots from this tab.
You cannot add an identified cargo lot for a BL item for measured (bulk) cargo.
When you save an identified cargo lot, N4 decreases the Quantity of the default cargo lot for the BL item by one. Use
the Cargo Lots tab (on page 70) to view the default cargo lot for the BL item.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 71
Confidential -- Proprietary
Part 3: Cargo Management Bills of Lading view
Bill of Lading form
The Cargo Lot Identified form enables you to add or edit identified cargo for the selected bill of lading item.
In N4, you can move Bill of Lading (BL) items from one BL to another BL, this is referred to as splitting the BL. N4
allows you to split BL items from one BL to another existing BL or to a new BL. For more information on the restrictions,
see Cargo Split BL form (on page 140).
In addition to the BL items, you can directly split cargo lots (on page 140) from one BL to another existing BL or new
BL. The selected cargo lots must be associated with the same BL. In this case, N4 automatically creates the BL Items
for the selected cargo lots.
You must have the Cargo Lot - Split BL privilege to access the Actions Split BL option.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 72
Confidential -- Proprietary
Part 3: Cargo Management Bills of Lading view
Bill of Lading form
Operations Unit Bills of Lading Bills of Lading view Bill of Lading Inspector Items tab Actions Re-consign BL BL Item
Re-consign BL form
In N4, you can re-consign BL items from one BL to a new BL or an existing BL.
Prerequisites
• You must have the Cargo Lot - Re-consign BL privilege to access the Actions Re-consign BL option.
In addition to the BL items, you can directly re-consign cargo lots (on page 141) from one BL to another existing BL or
new BL. The selected cargo lots may or may not be associated with the same BL. In this case, N4 automatically
creates the BL Items for the selected cargo lots.
Notes
• When you split a BL item (on page 72), the Master BL and the Target BL must match at all times. For example, split
a BL item to a new BL. Now, you can only spit the BL items from the same BL to this new BL and not from any other
BL. For more information on the restrictions, see Cargo Split BL form (on page 140). However, when you re-
consign a BL item, N4 allows you to move BL items among BLs without any restrictions.
• You can use the CGORECONSIGN001 (ON_RECONSIGN) (on page 40) setting to determine whether the items of
one BL item should be merged or moved to the other BL item having identical commodity.
The Units tab displays the units associated with the selected bill of lading. You can add new units, or edit and delete
existing units from this view.
You must use this tab to associate units with a bill of lading. N4 does not allow you to associate a bill of lading to
a unit from the Shipment Details form if the INVBL001 (TRUE_BILLS_OF_LADING) (on page 39) setting is
set to true.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 73
Confidential -- Proprietary
Part 3: Cargo Management Bills of Lading view
Bill of Lading Inspector
The Bill of Lading Units form enables you to add unit(s) to the selected bill of lading.
• Adds the unit record to the Units tab (on page 73) in the Bill of Lading Inspector (on page 74).
• Adds the BL record to the Bills of Lading tab in the Unit Inspector.
• Adds the BL Nbr field to the Status area of the Unit Inspector.
• Copies the following fields from the BL to the unit, if the unit does not have any value specified in these fields:
▪ Shipper
▪ Consignee
▪ Bonded Trucking Company
▪ Inbond
▪ Exam
The Bill of Lading Inspector displays the details of the selected bill of lading and enables you to perform various
actions on it. The Bill of Lading Inspector provides a view of all aspects of the selected bill of lading from the
perspective of the facility in the current scope. You can keep the Bill of Lading Inspector open at all times as you
work in other views and forms, and you can move and resize it as needed.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 74
Confidential -- Proprietary
Part 3: Cargo Management Bills of Lading view
Bill of Lading Inspector
To reflect the updates from the system, N4 refreshes the information displayed in the Bill of Lading Inspector every
30 seconds.
The basic information for a bill of lading displays in the following areas:
• Details: The left area displays the bill of lading details, such as the bill of lading number, line operator, category, and
carrier visit for the selected bill of lading.
• Routing: The right area displays the routing information, such as POL and POD for the selected bill of lading.
The Details pane (on page 78) displays additional bill of lading information below the button.
1. Click .
2. From the list on the left, select the type of information to display.
To perform actions:
1. Click Actions to display the menu.
2. Select the required menu option.
In addition to the actions that are also available from the Bills of Lading view (on page 59), the Actions menu in the
Bill of Lading Inspector displays the Edit Bill of Lading action that you can use to edit the details (on page 62) of the
selected bill of lading.
BL Releases Tab
Short Label Long Label Sorting? Group?
Changed Changed X
Changer Changer X
Created Created X
Creator Creator X
Disposition Code Disposition Code X
Disposition Seq Number Disposition Seq Number X
Hold/Perm Holds/Permissions X
Notes Notes X
Post Date Post Date X
Qty Quantity X
Qty Type Quantity Type X
Reference Reference X
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 75
Confidential -- Proprietary
Part 3: Cargo Management Bills of Lading view
Bill of Lading Inspector
Holds/Perms Tab
Short Label Long Label Sorting?
Appl By Applied By X
Appl To Applied To X
Appl To Enty Applied To Entity X
Applied On Applied On X
Description Description X
Guarded By Guarded By X
Guarded By Enty Guarded By Entity X
Hold/Perm Hold/Permission X
Hold/Perm View Hold/Perm View X
Note Note X
Ref ID Reference ID X
Ref Required Reference Id Required X
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 76
Confidential -- Proprietary
Part 3: Cargo Management Bills of Lading view
Bill of Lading Inspector
Items Tab
Short Label Long Label Sorting?
Bulk Bulk X
Commodity Commodity X
Commodity Note Commodity Note X
Contents Contents
Damaged? Damaged?
Item Nbr Item Number X
Piece Qty Piece Quantity X
Product Product X
Qty Quantity X
Sequence Sequence Number X
Total Weight Item Total Weight X
Units Bulk Units
Units Tab
Short Label Long Label Sorting? Group?
Changed X
Changer X
Created X
Creator X
Unit BL Nbr X
Unit Category Unit Category X 1-Unit
Unit Frght Kind X 4-Contents
Unit X 4-Contents
Hazardous?
Unit Hzd 4-Contents
UNNbrs
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 77
Confidential -- Proprietary
Part 3: Cargo Management Bills of Lading view
Bill of Lading Inspector
The Details pane in the Bill of Lading Inspector, displays additional bill of lading information in the following tabs:
• BL Releases (on page 78): Displays the releases granted for the bill of lading.
You can add new BL releases, and edit or delete existing releases on this tab.
• History, Events (on page 79): Displays the events recorded for the bill of lading.
You can record new events or view details of existing events on this tab.
• Holds/Perms (on page 80): Displays holds/permissions, if any, for the selected bill of lading.
You can add new holds/permissions, show details, grant permissions, and release holds on this tab.
• Items (on page 66): Displays the items associated with the selected bill of lading.
You can add new items, and edit or delete existing items on this tab.
• Units (on page 73): Displays the units associated with the selected bill of lading.
You can add new units, or edit and delete existing units on this tab.
BL Releases tab
Operations Cargo Bills of Lading Bills of Lading view Bill of Lading Inspector BL Releases tab
Operations Unit Bills of Lading Bills of Lading view Bill of Lading Inspector BL Releases tab
The BL Releases tab displays the releases granted for the selected bill of lading. You can add, edit, or delete BL
releases from this tab.
US Customs holds is an example of holds/permissions that may be required for a Bill of Lading. For information about
US Customs holds setup and configuration, see Configure EDI for US Customs Holds in the Navis N4: EDI, Billing, and
Services Management.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 78
Confidential -- Proprietary
Part 3: Cargo Management Bills of Lading view
Bill of Lading Inspector
Operations Unit Bills of Lading Bills of Lading view Bill of Lading Inspector BL Releases tab Bill of Lading Release form
The Bill of Lading Release form enables you to add or edit a BL release.
The History, Events tab in the Bill of Lading Inspector (on page 74) displays the events recorded for the selected bill
of lading. The Changes field displays the values that changed per the event for the selected bill of lading.
To record an event for a bill of lading manually, use the Record Service Event form (on page 79).
To view the details of an event, double-click the event or use the Action Show Details option.
When a billable event is extracted to the Chargeable Unit Events view, N4 associates the Batch ID with the event.
You can display the Extract Batch column to view the Batch ID associated with the event. For more information on
displaying a column, see Hiding and displaying columns.
The Record Service Event form enables you to record a service event for the selected bill of lading.
The Description and Billable Event fields in this form are read-only. N4 uses these fields to provide a short
description of the event and indicate whether the event is billable to the customer.
The Field Updates area in this form displays any fields that require user input. The fields displayed in this area depend
on the effects defined for the selected event. For more information, see Effects tab.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 79
Confidential -- Proprietary
Part 3: Cargo Management Bills of Lading view
Bill of Lading Inspector
When you record an event with a service order number, N4 updates the service order item status to Completed. For
more information, see Service Order Inspector Units tab.
N4 extracts the selected service order number to the Service Order field in the Chargeable Unit Events view for
the event.
3. From the Responsible Party lookup field, select the party responsible. If N4 automatically fills in the Responsible
Party field using the value specified in the Billing Party field in the Service Order form, the value cannot be edited.
N4 extracts this value to the Payee Id field in the Chargeable Unit Events view for the event.
4. Optionally, record the Quantity and Quantity Unit associated with the selected event type.
For example, if you have an event that records power supplied for reefers, you can enter a value in the Quantity
field and select the unit of time (days or hours) in the Quantity Unit field.
5. Optionally, in the Note field, enter any notes for the service event.
6. Optionally, in the Apply Date field, enter the date when the event is performed.
By default, N4 displays the current system date in this field.
7. Click OK.
N4 displays the recorded service event for the selected entity on the History, Event tab.
If the selected service event type is bulk-applicable, but a validation prevents you from recording it for one or more of
the selected items, N4 does not record the service event for any of the selected items.
In addition, if N4 is configured to automatically update a field, add/release a hold, or grant/cancel a permission, per a
service event type effect or auto update rule, N4 attempts to perform these tasks. If the change is unsuccessful, N4
displays an error message. But for an auto update rule, if any of the following are true then N4 does nothing:
• To release a hold when the hold is not active for the target entity.
• To cancel a permission when the permission is not granted for the target entity (permission will still be required).
Holds/Perms tab
Operations Cargo Bills of Lading Bills of Lading view Bill of Lading Inspector Holds/Perms tab
Operations Unit Bills of Lading Bills of Lading view Bill of Lading Inspector Holds/Perms tab
The Holds/Perms tab displays the holds/permissions for the selected bill of lading. You can add or edit a hold/
permission for the selected unit on this tab. When you edit a hold/permission, if you have not selected a hold or
permission or if the status of the selected permission is Required, N4 disables the (Edit) button. For more
information, see Update Hold/Permission form (Edit mode).
In addition, you can use the following Actions menu options to:
• Show Details: View the details of the selected hold/permission and the list of events affected by it.
You can also double-click a hold/permission to view the details and the list of events affected by it.
• Grant Permission (on page 82): Grant the selected permission.
You can only grant REQUIRED permissions.
• Release Hold: Release the selected hold.
You can only release ACTIVE holds.
• Cancel Permission: Cancel the selected permission.
You can only cancel GRANTED permissions.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 80
Confidential -- Proprietary
Part 3: Cargo Management Bills of Lading view
Bill of Lading Inspector
The Holds/Perms tab also displays the prerequisite events associated with the selected bill of lading. A prerequisite
event has the PRE_REQUISITE status. Use the Actions Show Details option to view the details of the prerequisite
event and the list of events affected by it.
You must record the prerequisite service event for the selected bill of lading before you can record the service events
listed on the Affected Event Types tab.
To record a prerequisite service event, on the History, Events tab (on page 79) for the selected bill of lading, click
or use the Actions Record Service Event (on page 79) option.
The Update Hold/Permission form enables you to add/release holds, or grant/cancel permissions for the selected bill
of lading.
Prerequisites
• In this form, you can select a hold/permission in step 2 only if it exists at the current scope level and has a service
business rule defined. For more information, see Holds/Permissions view.
To update a Hold/Permission:
1. From the Action drop-down list, select one of the following options:
▪ Add Hold: Add a hold for the selected bill of lading.
▪ Release Hold: Release an ACTIVE hold for the bill of lading.
▪ Grant Permission: Grant a REQUIRED permission for the bill of lading.
▪ Cancel Permission: Cancel a GRANTED permission for the bill of lading.
2. From the Hold/Permission drop-down list, select the hold that you want to add/release or the permission that you
want to grant/cancel.
The Description and Target Entity Type fields are view-only and display information about the selected hold/
permission.
3. From the Relation to Referenced Guardian drop-down list, select the guardian entity type for the selected hold/
permission.
For a list of target entities and the related guardian entity types, see Target and guardian entity types.
4. From the Referenced Guardian Entity drop-down list, select the specific guardian entity for the hold/permission.
The values in the drop-down list depend on the option selected in step 3.
The Relation to Referenced Guardian and Referenced Guardian Entity drop-down list are enabled only
for guarded holds/permissions. For more information, see Rule types.
The Has Unique Reference Id and Reference Id Required check boxes are read-only and display the options set
at the time the hold/permission was defined. For more information, see Hold/Permission Type form.
5. If the Reference Id Required check box is selected, you must enter a reference ID in the Reference ID field, and if
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 81
Confidential -- Proprietary
Part 3: Cargo Management Bills of Lading view
Copy Bill of Lading form
the Has Unique Reference Id check box is selected, the reference ID entered in the Reference ID field must be
unique for the entity and hold/permission combination.
6. Optionally, in the Note field, enter a note for any special considerations for the hold/permission.
7. Click OK.
When updating a hold/permission:
• If you select multiple bills of lading in a list view and a validation prevents you from applying the hold/permission to
one or more selected bills of lading, N4 still applies the hold/permission to the other selected bills of lading.
• If the selected hold/permission already exists as an ACTIVE hold or a REQUIRED permission for a selected bill of
lading, N4 does not apply the same hold/permission twice.
• If a hold/permission that requires a unique reference ID already exists as an ACTIVE hold or a REQUIRED
permission for a selected bill of lading, N4 does not apply the same hold/permission twice if the reference ID that
you specify is the same as the reference ID that already exists.
Notes
• You can edit the Reference ID and the Note fields for an active/released hold or a granted/canceled permission.
However, you cannot edit a required permission. For more information, see Update Hold/Permission form (Edit
mode)
The Grant Permission form enables you to grant the selected permission for the target entity such as unit, vessel visit,
train visit, bill of lading, or an order (booking, EDO, or ELO).
The form displays the following details for the selected permission:
• Type
• Name
• Description
• Guardian entity
• Guarded entity
• Reference ID must be unique or not
• Reference ID is required
If a reference ID:
• Is not required for the selected permission, click OK to grant the permission.
• Is required for the selected permission, you must enter a reference ID in the Reference ID field and click OK.
For more information, see Hold/Permission Type form.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 82
Confidential -- Proprietary
Part 3: Cargo Management Bills of Lading view
Service Order form
Prerequisites
• You must have the Bills of Lading - Copy privilege to access the Copy Bill of Lading action.
In N4, you can copy the details of an existing bill of lading (BL) to create a new BL. When you copy a bill of lading, N4
copies the header information, such as the Category, Line Operator, Vessel Visit, POD, and POL of the selected BL.
It also copies the BL Items from the selected BL to the new BL; however, it only creates the default cargo lots for the
copied BL Items. N4 does not copy any other cargo lots associated with the selected BL.
As opposed to the Split BL (on page 72) action, the Copy Bill of Lading action creates a new BL with no
association with the original BL.
The Service Order form enables you to add a service order for the selected bill(s) of lading.
In addition, N4 adds units that are associated with the selected bills of lading to the new service order. The units must
be in an Advised, Inbound, EC/In, or Yard transit state.
The table lists the optional fields in the Service Order form:
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 83
Confidential -- Proprietary
Part 3: Cargo Management Bills of Lading view
Service Order form
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 84
Confidential -- Proprietary
3.2 Delivery Orders view
Operations Cargo Delivery Orders Delivery Orders view
Prerequisites
• To access the Delivery Orders view, you need to assign the Delivery Order - View privilege to your user role.
A delivery order is a group of one or multiple bill of lading (BL) items that represent cargo to be picked up by trucks or
be placed on railcars for departure from the terminal for the same consignee. The BL items included in a delivery order
may be associated with the same or different bills of lading. Usually, the consignee for a shipment creates or provides
the delivery order. You can use a delivery order to manage cargo lot pickup by a truck or several trucks arriving at the
terminal.
If you use delivery orders for Deliver Break-Bulk (DB) gate transactions, N4 updates the Order Status when the truck
visit and the associated gate transaction are completed. However, if the delivery order is created without cargo lot
details, the Order Status remains New. N4 updates the Order Status based on the Cargo Delivery Order Item field.
Therefore, in your gate configuration, you must include the Cargo Delivery Order Item field for the Deliver Break-Bulk
(DB) gate transaction at the ingate stage.
You can use the Deliver Orders view to add, edit, and delete delivery orders. In addition, you can use the Actions
Cancel Delivery Order (on page 90) option to cancel the selected delivery order. If you select multiple records in the
list view, N4 disables this action.
Click .
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 85
Confidential -- Proprietary
Part 3: Cargo Management Delivery Orders view
Delivery Orders Columns
You can use the Delivery Order form to add a new delivery order (on page 85) or edit an existing delivery order. A
delivery order represents the cargo to be picked up by truck or placed on railcars for departure from the terminal for a
single consignee.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 86
Confidential -- Proprietary
Part 3: Cargo Management Delivery Orders view
Delivery Order form
4. Click Save.
After you save a delivery order, you can add delivery order items.
The table lists the optional fields in the Delivery Order form:
Start By Date Enter the date by when the work for the
delivery order must begin.
For more information on adding data and
time data, see Entering dates and Entering
time.
End By Date Enter the date by when the work for the
delivery order must finish.
Customer Reference Enter the customer reference ID for the
delivery order.
Contact Details Click the Add/Edit Contact Details button
to add contact information for the billing
party or other organizations associated with
the delivery order, such as a forwarding
agent or a notify party.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 87
Confidential -- Proprietary
Part 3: Cargo Management Delivery Orders view
Delivery Order form
PIN
The PIN is a unique identification for a unit, bill of lading, or delivery order that a line operator can use to validate that a
truck driver is picking up the correct container or break-bulk cargo.
For unit
In N4, you can use the Delivery Requirements form to assign or edit the PIN for a unit. These privileges control the
ability to view and edit PIN associated with a unit:
• Pin - Check: You can check whether a PIN is assigned to a unit but you cannot see the actual number.
• Pin - View: You can view the PIN assigned to a unit, but you cannot edit the PIN.
• Pin - Edit: You can view and edit the PIN assigned to a unit.
• Deny access to Unit field PIN Number: You cannot view the PIN Number field or column on forms and list views.
If the user’s role excludes the privileges PIN - Check, PIN - Edit, and PIN – View, then on the Units view, the
PIN Number column displays the data as "****".
A line operator can control:
• Whether to use PINs for all units operated by the line operator
• Whether to assign a PIN for each unit or allow N4 to generate a PIN automatically when the unit is first created, for
example using a stow plan
Use the Line Operator form Booking Rules tab to specify these restrictions.
A line operator may receive the PIN from an EDI trading partner or it may be generated in N4. If the line operators
assign a PIN to a unit they can specify an alphanumeric value. If N4 generates the PIN, it consists of only digits but the
value is stored as a string value.
PIN is available as part of the Unit reporting entity and can be included in various reports.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 88
Confidential -- Proprietary
Part 3: Cargo Management Delivery Orders view
Delivery Order form
You can configure the Pin Number field on a gate form at the outgate stage for a deliver gate transaction to force the
truck driver to enter a PIN. You can include the RejectPinNbrMismatch, RejectPinNbrNotAssigned, and
RejectPinNbrNotEntered business tasks in your gate configuration to control the delivery of a unit using the PIN.
If you have the privilege that allows you to edit a BL or a delivery order, you can edit the PIN assigned to the BL
or the delivery order.
You can include the Pin Number field as part of your Deliver Break-Bulk gate transaction to force the truck driver to
enter a PIN. You can include the RejectPinNbrMismatch, RejectPinNbrNotAssigned, and
RejectPinNbrNotEntered business tasks in your gate configuration to control the delivery of break-bulk cargo
using the PIN.
You can use the Contact Details form to specify the contact details for various organizations, such as the billing party,
forwarding agent, or notify party, associated with the delivery order. You can also use the Contacts tab (on page 94)
in the Delivery Order Inspector (on page 91) to add or edit contact details after you have saved the delivery order
record.
If available, N4 automatically fills in the available information for the selected Contact ID. You can then edit
these fields according to your requirements.
4. Click Add.
N4 displays the record in the CONTACT DETAILS area at the bottom.
5. Click OK.
You can click Cancel to exit the form without saving any changes.
After you add the contact details, if you select the record in the CONTACT DETAILS area, N4 fills in the available
information in the various fields that you can edit, if required.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 89
Confidential -- Proprietary
Part 3: Cargo Management Delivery Orders view
Cancel Delivery Order form
In the CONTACT DETAILS area, you can use the button to add another record and the button to delete the
selected record.
The Order Item tab displays the order items associated with the selected delivery order.
You can add, edit, and delete order items from this tab.
You can use the Delivery Order Item form to add or edit a delivery order item. In N4, a delivery order item represents
a group of cargo lots that may be associated with the same or different bills of lading (BLs).
You can use the Cancel Delivery Order form to cancel the selected delivery order. You can select only one delivery
order at a time. If you select multiple deliver orders in the list view, N4 disables the option.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 90
Confidential -- Proprietary
Part 3: Cargo Management Delivery Orders view
Delivery Order Inspector
2. Click Save.
N4 updates the:
The Delivery Order Inspector displays the details of the selected delivery order and enables you to perform various
actions on it. The Delivery Order Inspector provides a view of all the aspects of a delivery order from the perspective
of the facility in the current scope. You can keep the Delivery Order Inspector open at all times as you work in other
views and forms, and you can move and resize it as needed.
The basic information for the delivery order displays in the following areas:
• Delivery Order: The left area displays the deliver order number.
• Details: The right area displays the delivery order details, such as the order status, billing party, carrier visit, carrier
mode, and the dates associated with the delivery order.
The Details pane displays additional delivery order information below the button.
1. Click .
2. From the list on the left, select the type of information to display.
To perform actions:
1. Click Actions to display the menu.
2. Select the required menu option.
In addition to the actions that are also available from the Delivery Orders view (on page 85), the Actions menu in the
Delivery Order Inspector displays the Edit Delivery Order action that you can use to edit the details (on page 86),
edit the details (on page 86) of the selected delivery order.
Contacts Tab
Short Label Long Label Sorting?
Addr Type Address Type X
Address1 Contact Address Line1 X
Address2 Contact Address Line2 X
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 91
Confidential -- Proprietary
Part 3: Cargo Management Delivery Orders view
Delivery Order Inspector
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 92
Confidential -- Proprietary
Part 3: Cargo Management Delivery Orders view
Delivery Order Inspector
The History, Events tab displays the events recorded for the selected entity such as unit, container, chassis,
accessory, vessel visit, train visit, bill of lading, or an order (booking, EDO, or ELO). You can record service events for
the selected entity on this tab. For more information, see Event Types view.
In addition, when you perform certain tasks in N4 or in XPS, such as discharge a container or edit the routing
information for a booking, N4 records the associated built-in events on the tab for the affected entity.
To view the details of an event, double-click the event or use the Action Show Details option. The Changes field
displays the values that changed per the event for a unit, booking, EDO, or ELO, such as the old and new unit position
for a unit discharge event.
When a billable event is extracted to the Chargeable Unit Events view, N4 associates the Batch ID with the event.
You can display the Extract Batch column to view the Batch ID associated with the event. For more information on
displaying a column, see Hiding and displaying columns.
For break-bulk units that are associated with cargo lots, N4 also displays any cargo lot events in the History, Events
tab for the unit.
You can see the Hatch Clerk's ID in the XPS log, but it does not appear in N4 by default unless you use the Radio
Server. To make the Hatch Clerk ID visible in N4 without the Radio Server, you can implement a customized code
extension of the type ENTITY_LIFECYCLE_INTERCEPTION with the name UpdateMoveEventAppliedByInfo.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 93
Confidential -- Proprietary
Part 3: Cargo Management Delivery Orders view
Delivery Order Inspector
The Details pane in the Delivery Order Inspector, displays additional delivery order information in the following tabs:
• Contacts (on page 94): Displays the contact information of the various organizations associated with the delivery
order, such as the billing party, forwarding agent, or the deliver to party.
You can add new contacts or edit and delete existing contacts on this tab.
• History, Events: Displays the events recorded for the delivery order.
You can record new events or view details of existing events on this tab.
• Order Items (on page 90): Displays the order items associated with the delivery order.
You can record new order items or edit and delete existing order items on this tab.
Contacts tab
Operations Cargo Delivery Orders Delivery Orders view Delivery Order Inspector Contacts tab
The Contacts tab displays the contacts associated with the selected delivery order. From this tab, you can view, add,
edit, or delete contact information for the delivery order.
The Delivery Order Address form enables you to associate an address with the delivery order.
To add an address:
1. Select one of the following as the Address Type that you want to add for the delivery order:
▪ Bill To - If selected, the Contract ID must match the Billing Party specified for the delivery order.
▪ Deliver To
▪ Forwarding Agent
▪ Notify Party
2. From the Contact ID lookup field, select the organization you want to associate with the delivery order.
The lookup field displays the organizations that exist in N4. To add a new organization, use the Configuration
Organizations menu.
N4 does not allow you to add duplicate records where the Contact ID and the Address Type are same.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 94
Confidential -- Proprietary
Part 3: Cargo Management Delivery Orders view
Delivery Order Inspector
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 95
Confidential -- Proprietary
3.3 Cargo Lots view
Operations Cargo Cargo Lots Cargo Lots view
A cargo lot represents non-containerized cargo, such as break-bulk cargo, rolling cargo, and bulk cargo. N4 enables
you to view and track non-containerized cargo and perform actions, such as stuff and strip cargo, manifest cargo, and
load and discharge cargo from a carrier.
Prerequisites
• Viewing cargo lot information in N4 requires the Bills of Lading Option.
• Cargo Lot - View privilege.
• Bulk Cargo: Cargo is tracked by weight or volume, such as coal, wheat, and crude oil.
• Quantified Cargo: Cargo is tracked by quantity. This is sometimes referred to as Pseudo Bulk Cargo. In this case,
each piece of cargo does not have a unique identifier either because the identifier is unknown or because the pieces
are too numerous and interchangeable; therefore, this type of cargo is tracked only by quantity.
• Identified Cargo: Each piece of cargo is tracked by a known and unique identifier, such as the VIN number of a car.
For Bulk Cargo and Quantified Cargo, N4 creates:
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 96
Confidential -- Proprietary
Part 3: Cargo Management Cargo Lots view
Delivery Order Inspector
For identified cargo, N4 maintains a cargo lot and a corresponding unit for each piece. For example, if you have a BL
item for identified cargo and Quantity = 15, N4 creates 15 cargo lots and 15 units for the BL item.
The Cargo Lots view displays the cargo lot records that fall within the Horizon (days) specified for the user. N4
compares the Created Date for a cargo lot with the Horizon (days) (User Preferences form) value to determine the
oldest record displayed in this view.
You can prevent the users logged in at one facility from viewing the cargo lots for the other facilities within the complex,
by including the CARGO_LOT_DENY_UNFILTERED_VIEW privilege in a role assigned to them and creating a saved
filter that is based on the Inbound BL Item Vessel Visit Facility (Ves. Facility) field in the Cargo Lots view. For more
information, see How do I prevent users logged in at one facility from viewing cargo lots for another facility in the
complex? (on page 183)
The Cargo Lots view displays only the cargo lots with non-zero quantities. To view the cargo lots where
Quantity = 0, use the Bill of Lading form (on page 62) Items tab (on page 66) of the associated BL.
From this view, you cannot add or delete a cargo lot. However, you can double-click a record to access the Cargo Lot
Inspector (on page 101) and view details of an existing cargo lot, edit some of the fields associated with the cargo lot,
and perform various actions related to cargo lots.
• Edit Cargo Lot (on page 115): Edit some of the fields associated with the selected cargo lot record.
• Stuff (on page 115): Stuff the selected cargo lot(s) into a container.
• Strip (on page 118): Strip the contents of a container to a yard position.
• Move (on page 120): Move the selected cargo lot(s) to a new position.
• Create Delivery Order (on page 121): Create a delivery order for the selected cargo lot(s).
• Create Service Order (on page 121): Create a service order to plan the events for the selected cargo lot(s).
• Record Service Event (on page 105): Record a service event for the selected cargo lot(s).
• Unload Unload Vessel (on page 123): Unload cargo from a vessel to a yard position.
• Unload Unload Truck (on page 124): Unload cargo from a truck to a yard position.
• Unload Unload Rail (on page 125): Unload cargo from a train or a railcar to a yard position.
• Load Load Vessel (on page 126): Load cargo from the yard to the specified vessel visit.
• Load Load Truck (on page 127): Load cargo from the yard to the specified truck visit.
• Load Load Rail (on page 129): Load cargo from the yard to the specified train visit.
• Manifest Manifest Container (on page 131): Manifest the selected cargo lot(s) to a container.
• Manifest Manifest Vessel (on page 132): Manifest the selected cargo lot(s) to a vessel.
• Manifest Manifest Rail (on page 134): Manifest the selected cargo lot(s) to a rail.
• Other Manufacture Cargo (on page 135): Create cargo lots for cargo manufactured at the facility.
• Other Adjust Cargo Lot Quantity (on page 136): Adjust the quantity of the selected cargo lot.
N4 records the adjustment as a discrepancy against the selected cargo lot record.
• Other Transload (on page 137): Transload the selected cargo lot(s) to another container.
• Other Identify Lot (on page 138): Identify the contents of the selected cargo lot(s).
• Other Cancel Manifest (on page 139): Cancel the manifest for the selected cargo lot(s).
• Other Split BL (on page 140): Split the bill of lading associated with the selected cargo lot into smaller BLs for
ease of processing.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 97
Confidential -- Proprietary
Part 3: Cargo Management Cargo Lots view
Delivery Order Inspector
• Other Re-consign BL (on page 141): Re-consign the selected cargo lots to a new or existing BL.
• Record Damages (on page 142): Record damages for the selected cargo lot.
In the Cargo Lots view, if you press CTRL+s keys, N4 displays the Select Action message box where you can type
the first few characters of the action that you want to perform to access the option.
For example, if you want to record damages for the selected cargo lot, you can either click Actions Record
Damages option to access the Damages form (on page 142) or you can press CTRL+s keys and in the Select Action
message box, type Rec and select the Record Damage option from the list to access the Damages form.
The Cargo Lots view displays the information about the related break-bulk unit, such as the Unit Nbr, Position, and
T-state. The Position and T-state information is derived from the current Active unit facility visit (UFV). If the current
UFV is in the Advised state, it does not have an Active UFV, therefore, the related information is not displayed in the
Cargo Lots view.
In This Section
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 98
Confidential -- Proprietary
Part 3: Cargo Management Cargo Lots view
Cargo Lot ID
Cargo Lot ID
A Cargo Lot ID not only identifies the cargo lot but is also used as the Unit Nbr for the break-bulk unit associated with
the cargo lot. Since the unit numbers must be unique, N4 uses the following logic to generate a cargo lot ID and to
ensure that the cargo lot IDs are unique throughout N4:
N4 displays the BL GID field in the Bills of Lading view (on page 59), Bill of Lading form (on page 62) (edit mode),
Cargo Lots view (on page 96), and the Details area in the Bill of Lading Inspector (on page 74).
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 99
Confidential -- Proprietary
Part 3: Cargo Management Cargo Lots view
Cargo Lots Columns
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 100
Confidential -- Proprietary
Part 3: Cargo Management Cargo Lots view
Cargo Lot Inspector
The Delivery Order field is a part of the variform definition of the Cargo Lots view (on page 96) but is not visible
by default. You have to create a database-backed variform to display this field to your users. For more
information on creating a database-backed variform override: see Database Backed Variforms view in the
Navis N4 Administration Mode manual.
The Cargo Lot Inspector displays the details of the selected cargo lot and enables you to perform various actions on
it. The Cargo Lot Inspector provides a view of all the aspects of the selected cargo lot from the perspective of the
facility in the current scope. You can keep the Cargo Lot Inspector open at all times as you work in other views and
forms, and you can move and resize it as needed.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 101
Confidential -- Proprietary
Part 3: Cargo Management Cargo Lots view
Cargo Lot Inspector
To access the Cargo Lot Inspector double-click a record in the list view or select a record in the list view, right-click,
and select the Inspect Cargo Lot option.
N4 displays the basic information for a cargo lot in the following areas:
• Cargo Lot: Displays the icon associated with the cargo lot, the cargo lot ID, Unit Nbr (for a manifested cargo lot) BL
Nbr, Commodity, Product, Packaging, Quantity, and the Lot Total Weight.
The cargo lot displays the Unit information, such as the Unit Nbr, Position, and T-state for the current Active Unit
Facility Visit (UFV) associated with the cargo lot. If the current unit associated with the cargo lot is in the Advised
state, N4 displays these fields as null.
• Details: Displays the BL details, such as the BL Category, Shipper, Origin, POL, Consignee, Destination, and Item
Nbr, related to the cargo lot.
• Status: Displays cargo lot information, such as the Transit State, whether the cargo lot is the Default cargo lot,
whether any damages are associated with the cargo lot, any Discrepancy, Position, and date and time you created
or last updated the cargo lot record.
N4 allows you to associate an icon with the commodity (on page 18), package type (on page 29), and the product type
(on page 31) entities. The precedence of the icon displayed in the Cargo Lot Inspector (on page 101), Bill of Lading
Inspector (on page 74), and the Unit Inspector is as follows:
• Package Type
• Product Type
• Commodity
• Standard Navis Cubes icon
The Details pane (on page 104) displays additional cargo lot information below the button.
1. Click .
2. From the list on the left, select the type of information to display.
To perform actions:
1. Click Actions to display the menu.
2. Select the required menu option.
To view the list of actions that you can perform on a cargo lot, see the Cargo Lots view (on page 96).
Damages Tab
Short Label Long Label Sorting?
Changed X
Changer X
Created X
Creator X
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 102
Confidential -- Proprietary
Part 3: Cargo Management Cargo Lots view
Cargo Lot Inspector
Holds/Perms Tab
Short Label Long Label Sorting?
Appl By Applied By X
Appl To Applied To X
Appl To Enty Applied To Entity X
Applied On Applied On X
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 103
Confidential -- Proprietary
Part 3: Cargo Management Cargo Lots view
Cargo Lot Inspector
The Details pane in the Cargo Lot Inspector (on page 101) displays additional cargo lot information in the following
tabs:
• Damages (on page 105): Displays the damages recorded for the selected cargo lot.
• History, Events (on page 105): Displays the events recorded for the selected cargo lot.
You can add new events or view details of existing events on this tab.
• Holds/Perms (on page 106): Displays holds/permissions, if any, for the selected cargo lot.
You can add new holds/permissions, show details, grant permissions, and release holds on this tab.
The Holds/Perms tab displays the holds/permission associated with the cargo unit or the container unit and not the
cargo lot, itself. For example, if the cargo lot is in a container unit, the Holds/Perms tab in the Cargo Lot Inspector
displays all the holds/permissions associated with the container unit. For more information, see Cargo Holds/
Permissions (on page 108).
If you move a cargo lot that has a hold/permission associated with it to a location that does not have any holds/
permissions, N4 moves the holds/permissions to the new location and applies the holds/permissions to any cargo
lots already existing at the new location. If the new location already has holds/permissions, N4 merges the holds/
permissions of the existing and the new location.
• Units: Displays the units associated with the selected cargo lot.
When you double-click a unit in the tab, N4 displays the Unit Inspector for the selected unit. N4 does not display
this tab for the cargo lots that do not have a unit associated with them.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 104
Confidential -- Proprietary
Part 3: Cargo Management Cargo Lots view
Cargo Lot Inspector
Damages tab
Operations Cargo Cargo Lots Cargo Lots view Cargo Lot Inspector Damages tab
The Damages tab displays the damages recorded for the selected cargo lot. From this tab, you can only view the
damages for the selected cargo lot.
To add, edit, or delete damages, use the Record Damages (on page 142) action from the Cargo Lots view (on page
96) or Cargo Lot Inspector (on page 101).
The History, Events tab in the Cargo Lot Inspector (on page 101) displays the events recorded for the selected
cargo lot. The Changes field displays the values that changed per the event for the selected cargo lot.
Although N4 allows you to add event types for the cargo lot entity, they are available only for audit purposes and
are not supported with any other feature except to view them in the History, Events tab in the Cargo Lot
Inspector.
N4 displays the following events in the History, Events tab of the selected cargo lot:
• Event types where the Applies To field is set as Cargo Lot and the Functional Area may or may not be set as
Applicable to Cargo module.
These events are also listed in the History, Events tab of the Unit Inspector of the break-bulk unit associated with
the cargo lot.
• Event types where the Applies To field is set as Unit and the Functional Area is set as Applicable to Cargo
module.
To record an event for a cargo lot manually, use the Record Service Event form (on page 105).
To view the details of an event, double-click the event or use the Action Show Details option.
The Description and Billable Event fields in this form are read-only. N4 uses these fields to provide a short
description of the event and indicate whether the event is billable to the customer.
The Field Updates area in this form displays any fields that require user input. The fields displayed in this area depend
on the effects defined for the selected event. For more information, see Effects tab.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 105
Confidential -- Proprietary
Part 3: Cargo Management Cargo Lots view
Cargo Lot Inspector
target entity and for which you have the required privilege. For more information on adding a service event type, see
Event Type form.
2. Optionally, select the Service Order Number associated with the event.
The Service Order Number drop-down list displays only the service orders that have either the In Progress or the
New status. It does not display a service order if the status is either Completed or Cancelled.
When you record an event with a service order number, N4 updates the service order item status to Completed. For
more information, see Service Order Inspector Units tab.
N4 extracts the selected service order number to the Service Order field in the Chargeable Unit Events view for
the event.
3. From the Responsible Party lookup field, select the party responsible. If N4 automatically fills in the Responsible
Party field using the value specified in the Billing Party field in the Service Order form, the value cannot be edited.
N4 extracts this value to the Payee Id field in the Chargeable Unit Events view for the event.
4. Optionally, record the Quantity and Quantity Unit associated with the selected event type.
For example, if you have an event that records power supplied for reefers, you can enter a value in the Quantity
field and select the unit of time (days or hours) in the Quantity Unit field.
5. Optionally, in the Note field, enter any notes for the service event.
6. Optionally, in the Apply Date field, enter the date when the event is performed.
By default, N4 displays the current system date in this field.
7. Click OK.
N4 displays the recorded service event for the selected entity on the History, Event tab.
If the selected service event type is bulk-applicable, but a validation prevents you from recording it for one or more of
the selected items, N4 does not record the service event for any of the selected items.
In addition, if N4 is configured to automatically update a field, add/release a hold, or grant/cancel a permission, per a
service event type effect or auto update rule, N4 attempts to perform these tasks. If the change is unsuccessful, N4
displays an error message. But for an auto update rule, if any of the following are true then N4 does nothing:
• To release a hold when the hold is not active for the target entity.
To cancel a permission when the permission is not granted for the target entity (permission will still be required).
Holds/Perms tab
Operations Cargo Cargo Lots Cargo Lots view Cargo Lot Inspector Holds/Perms tab
The Holds/Perms tab displays the holds/permissions for the selected cargo lot. You can add a hold for the selected
cargo lot on this tab.
In addition, you can use the following Actions menu options to:
• Show Details: View the details of the selected hold/permission and the list of events affected by it.
You can also double-click a hold/permission to view the details and the list of events affected by it.
• Grant Permission (on page 82): Grant the selected permission.
You can only grant REQUIRED permissions.
• Release Hold: Release the selected hold.
You can only release ACTIVE holds.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 106
Confidential -- Proprietary
Part 3: Cargo Management Cargo Lots view
Cargo Lot Inspector
You must record the prerequisite service event for the selected entity before you can record the service events listed
on the Affected Event Types tab.
To record a prerequisite service event, on the History, Events tab (on page 105) for the selected cargo lot, click or
use the Actions Record Service Event (on page 105) option.
The Update Hold/Permission form enables you to add/release holds, or grant/cancel permissions for the selected
cargo lots.
Prerequisites
• In this form, you can select a hold/permission in step 2 only if it exists at the current scope level and has a service
business rule defined. For more information, see Holds/Permissions view.
To update a Hold/Permission:
1. From the Action drop-down list, select one of the following options:
▪ Add Hold: Add a hold for the selected cargo lot(s).
▪ Release Hold: Release an ACTIVE hold for the cargo lot(s).
▪ Grant Permission: Grant a REQUIRED permission for the cargo lot(s).
▪ Cancel Permission: Cancel a GRANTED permission for the cargo lot(s).
2. From the Hold/Permission drop-down list, select the hold that you want to add/release or the permission that you
want to grant/cancel.
The Description and Target Entity Type fields are view-only and display information about the selected hold/
permission.
3. From the Relation to Referenced Guardian drop-down list, select the guardian entity type for the selected hold/
permission.
For a list of target entities and the related guardian entity types, see Target and guardian entity types.
4. From the Referenced Guardian Entity drop-down list, select the specific guardian entity for the hold/permission.
The values in the drop-down list depend on the option selected in step 3.
The Relation to Referenced Guardian and Referenced Guardian Entity drop-down list are enabled only
for guarded holds/permissions. For more information, see Rule types.
The Has Unique Reference Id and Reference Id Required check boxes are read-only and display the options set
at the time the hold/permission was defined. For more information, see Hold/Permission Type form.
5. If the Reference Id Required check box is selected, you must enter a reference ID in the Reference ID field, and if
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 107
Confidential -- Proprietary
Part 3: Cargo Management Cargo Lots view
Cargo Lot Inspector
the Has Unique Reference Id check box is selected, the reference ID entered in the Reference ID field must be
unique for the entity and hold/permission combination.
To change the reference ID for an existing hold/permission, you must release/cancel the hold/permission and
read the hold/permission with the new reference ID.
6. Optionally, in the Note field, enter a note for any special considerations for the hold/permission.
7. Click OK.
When updating a hold/permission:
• If you select multiple cargo lots in a list view and a validation prevents you from applying the hold/permission to one
or more selected cargo lot(s), N4 still applies the hold/permission to the other selected cargo lot(s).
• If the selected hold/permission already exists as an ACTIVE hold or a REQUIRED permission for a selected cargo
lot(s), N4 does not apply the same hold/permission twice.
• If a hold/permission that requires a unique reference ID already exists as an ACTIVE hold or a REQUIRED
permission for a selected cargo lot(s), N4 does not apply the same hold/permission twice if the reference ID that you
specify is the same as the reference ID that already exists.
Cargo Holds/Permissions
N4 persists holds/permissions for a cargo lot when you perform move actions, such as load and unload, or when you
stuff and strip cargo lots to and from containers. When you stuff cargo with holds/permissions into a container with no
holds/permissions, N4 retains the cargo holds/permissions. When you strip cargo with holds/permissions, N4 saves the
holds/permissions with the new cargo lot.
As most of the cargo Actions record events against the associated cargo unit, you must create the Holds/
Permissions for the Unit entity and not the Cargo Lot entity.
The following table list the various cargo-related events and the entity for which the event is recorded.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 108
Confidential -- Proprietary
Part 3: Cargo Management Cargo Lots view
Cargo Lot Inspector
You can use the History, Events tab in the Unit Inspector of the unit associated with a cargo lot to view the events
recorded for the Unit entity. You can use the History, Events tab in the Cargo Lot Inspector (on page 101) to view the
events recorded for the Cargo Lot entity.
Source Location Target Location Move Quantity Target Cargo How N4 handles
Type Type Lot the Holds/
Permissions
Non-containerized Non-containerized Partial N/A • Creates a new
cargo lot and
unit at the new
location.
• Applies the
holds/
permissions
from the source
to the target
unit.
Non-containerized Non-containerized Partial Exists • Increases the
Quantity at the
target location.
• Merges the
Holds/
Permissions
from the source
location with the
Holds/
Permissions of
the target
location.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 109
Confidential -- Proprietary
Part 3: Cargo Management Cargo Lots view
Cargo Lot Inspector
Source Location Target Location Move Quantity Target Cargo How N4 handles
Type Type Lot the Holds/
Permissions
Non-containerized Non-containerized Full N/A • Moves the Unit
at the source
location to the
target location.
• No changes to
the Holds/
Permissions.
Non-containerized Non-containerized Full Exists • Increases the
Quantity at the
target location.
• Merges the
Holds/
Permissions
from the source
location with the
Holds/
Permissions of
the target
location.
Non-containerized Containerized Partial N/A • Creates a new
cargo lot and
unit at the new
location.
• Applies the
holds/
permissions
from the source
to the target
unit.
Non-containerized Containerized Partial Exists • Increases the
Quantity at the
target location.
• Merges the
Holds/
Permissions
from the source
location with the
Holds/
Permissions of
the target
location.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 110
Confidential -- Proprietary
Part 3: Cargo Management Cargo Lots view
Cargo Lot Inspector
Source Location Target Location Move Quantity Target Cargo How N4 handles
Type Type Lot the Holds/
Permissions
Non-containerized Containerized Full N/A • Moves the
cargo lot to the
container at the
target location.
• Retires the unit
at the source
location.
• Merges the
Holds/
Permissions
from the source
location with the
Holds/
Permissions of
the target
location.
Non-containerized Containerized Full Exists • Increases the
Quantity at the
target location.
• Retires the unit
at the source
location.
• Merges the
Holds/
Permissions
from the source
location with the
Holds/
Permissions of
the target
location.
Containerized Containerized Partial N/A • Creates a new
cargo lot in the
container at the
new location.
• Applies the
holds/
permissions
from the source
to the target
unit.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 111
Confidential -- Proprietary
Part 3: Cargo Management Cargo Lots view
Cargo Lot Inspector
Source Location Target Location Move Quantity Target Cargo How N4 handles
Type Type Lot the Holds/
Permissions
Containerized Containerized Partial Exists • Increases the
Quantity at the
target location.
• Merges the
Holds/
Permissions
from the source
location with the
Holds/
Permissions of
the target
location.
Containerized Containerized Full N/A • Creates a new
cargo lot in the
container at the
new location.
• Merges the
Holds/
Permissions
from the source
location with the
Holds/
Permissions of
the target
location.
• Does not delete
the Holds/
Permissions
from the source
unit even if the
container is
empty.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 112
Confidential -- Proprietary
Part 3: Cargo Management Cargo Lots view
Cargo Lot Inspector
Source Location Target Location Move Quantity Target Cargo How N4 handles
Type Type Lot the Holds/
Permissions
Containerized Containerized Full Exists • Increases the
Quantity at the
target location.
• Merges the
Holds/
Permissions
from the source
location with the
Holds/
Permissions of
the target
location.
• Does not delete
the Holds/
Permissions
from the source
unit even if the
container is
empty.
Containerized Non-containerized Partial N/A • Creates a new
cargo lot and B-
Bulk unit at the
new location.
• Applies the
Holds/
Permissions
from the source
location to the
B-Bulk unit at
the new
location.
Containerized Non-containerized Partial Exists • Increases the
Quantity at the
target location.
• Merges the
Holds/
Permissions
from the
container unit to
the B-Bulk unit
at the new
location.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 113
Confidential -- Proprietary
Part 3: Cargo Management Cargo Lots view
Cargo Lot Inspector
Source Location Target Location Move Quantity Target Cargo How N4 handles
Type Type Lot the Holds/
Permissions
Containerized Non-containerized Full N/A • Creates a new
cargo lot and B-
Bulk unit at the
new location.
• Applies the
Holds/
Permissions
from the source
location to the
B-Bulk unit at
the new
location.
• Does not delete
the Holds/
Permissions
from the source
unit even if the
container is
empty.
Containerized Non-containerized Full Exists • Increases the
Quantity at the
target location.
• Merges the
Holds/
Permissions
from the
container unit to
the B-Bulk unit
at the new
location.
• Does not delete
the Holds/
Permissions
from the source
unit even if the
container is
empty.
Units tab
Operations Cargo Cargo Lots Cargo Lots view Cargo Lot Inspector Units tab
The Units tab displays the units associated with the selected cargo lot. You cannot add, edit, or delete units from this
tab.
If you double-click a unit record, N4 displays the Unit Inspector for the selected unit. However, N4 does not display
this tab for cargo lots that do not have a unit associated with them.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 114
Confidential -- Proprietary
Part 3: Cargo Management Cargo Lots view
Edit Cargo Lot form
The Edit Cargo Lot form enables you to edit some of the fields associated with a cargo lot. If you select multiple
records in the list view, the Actions Edit Cargo Lot option is not available.
You can edit the following fields for the selected cargo lot:
• Quantity Manifested
• Lot Total Weight
• Brand
• Model
• Color
• Export Release Nbr
• Lot Planned Position
N4 displays the above fields in the Status area in the Cargo Lot Inspector (on page 101). When you update the cargo
lot details to the Edit Cargo Lot form, N4 records the CARGO_PROPERTY_UPDATE event in the History, Events
tab of the Unit Inspector and the Cargo Lot Inspector (on page 101).
In N4, you can stuff cargo units in the yard into a unit in the yard. You can use the Cargo Stuff form to stuff the
selected cargo units into the specified container. You can stuff multiple cargo items from different yard locations or from
a truck into a container. The cargo lots may be associated with the same or different bills of lading.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 115
Confidential -- Proprietary
Part 3: Cargo Management Cargo Lots view
Cargo Stuff form
• A bill of lading item (on page 66) for bulk or non-bulk cargo.
• A cargo unit in the yard (a B-Bulk unit must exist in the Units view for the cargo lot).
If the commodity associated with the cargo lot has temperature requirements, you can stuff the selected
cargo lot only into a reefer container.
a. In the Quantity field, edit the prompted value if you do not want to stuff the entire cargo lot quantity in the unit.
If you select multiple cargo lots in the list view, N4 does not display the Quantity field. The entire quantity of
all the selected cargo lots is stuffed into the selected container.
a. Select the Direct Stuff check box to perform a stuff operation directly from a truck into a container.
b. Select the Truck Complete check box to move the truck to the next stage after the stuff operation.
c. Click Save.
When you successfully stuff the entire quantity of a cargo lot into the specified container, N4:
If you select multiple cargo lots in the Cargo Lots view and the cargo lots are associated with multiple
bills of lading, the Freight Kind of the new unit is LCL. If the selected cargo lots are associated with the
same bill of lading, the Freight Kind of the new unit is FCL.
▪ If the Freight Kind of the selected unit is FCL or LCL, N4 does not retire the unit.
▪ Adds the cargo lot Quantity to the Cargo Quantity of the container unit.
▪ Records the UNIT_STUFF event for the container unit.
For the Cargo Stuff action, N4 records a CARGO_STUFF event each time you stuff a partial or full quantity
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 116
Confidential -- Proprietary
Part 3: Cargo Management Cargo Lots view
Cargo Stuff form
to a unit. However, it records the UNIT_STUFF action only once when you stuff the first cargo lot into the
unit.
The following code sample represents the Groovy plug-in that you can edit to specify which holds/permission are
transferred as part of the Strip and Stuff actions. This example transfers the CARGO_UNLOAD hold as part of the
Strip or Stuff action:
import java.util.ArrayList;
import java.util.Collection;
import java.util.List;
import com.navis.apex.business.model.GroovyInjectionBase;
import com.navis.cargo.business.model.CargoLot;
import com.navis.inventory.business.units.Unit;
import com.navis.services.business.rules.Flag;
import com.navis.services.business.rules.FlagType;
class CustomHoldTypeListForTransferGroovyImpl extends GroovyInjectionBase {
public List<String> getHoldTypeList(Unit inFromUnit, Unit inToUnit) {
List<String> returnHoldTypeIds = new ArrayList();
log("From Unit:"+inFromUnit.getUnitId()) ;
log("To Unit:"+inToUnit.getUnitId()) ;
Collection flags = FlagType.findActiveFlagsOnEntity(inFromUnit);
for (Object flagObj : flags) {
Flag flag = (Flag) flagObj;
//You can add the list of all holds/permissions that you want to
//move as part of the Strip and Stuff actions.
if (flag.getFlagFlagType().getId().equals("CARGO_UNLOAD")){
returnHoldTypeIds.add(flag.getFlagFlagType().getId()) ;
}
}
return returnHoldTypeIds;
}
}
If the selected cargo lot has other holds/permissions associated with it, N4 does not transfer those as part of the Strip
and Stuff actions. It transfers only the holds/permissions specified in the Groovy plug-in.
The Groovy class name and method signature must match exactly with that specified in the example above.
You can use this Groovy plug-in to transfer different holds for the Strip and the Stuff actions, if required. N4 uses the
inFromUnit and inToUnit variables to determine the Freight Kind of the units. If the inFromUnit represents a
containerized unit and inToUnit represents a break-bulk unit, then it is the Strip action. If the condition is reversed, it
is the Stuff action.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 117
Confidential -- Proprietary
Part 3: Cargo Management Cargo Lots view
Cargo Strip form
You can use the Cargo Strip form to strip cargo from a unit, either entirely or partially, and create break-bulk unit(s) in
the yard. You can also use service orders (on page 121) to create a plan for a container to be stripped. You can strip
multiple cargo lots from a single container or multiple containers.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 118
Confidential -- Proprietary
Part 3: Cargo Management Cargo Lots view
Cargo Strip form
Partially strip Partially strip Strip all the Strip all the
cargo to a new cargo to an cargo to a new cargo to an
yard location existing yard yard location existing yard
location location
Creates a new B- Yes No Yes No
Bulk unit
Creates a new Yes No No No
cargo lot record
in the Cargo
Lots view
Associates the Yes N/A Yes N/A
B-Bulk unit with
the cargo lot
Retires the No No Yes Yes
existing unit and
creates a new
STORAGE
Empty unit
Records the No No Yes Yes
UNIT_STRIP
event against
the Retired B-
Bulk unit
In addition, when you successfully strip a cargo lot from the specified container to a location in the yard, N4:
If you specified a service order in the Cargo Strip form, N4 also updates the status of the service order after
successfully completing the strip action.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 119
Confidential -- Proprietary
Part 3: Cargo Management Cargo Lots view
Cargo Move form
The following code sample represents the Groovy plug-in that you can edit to specify which holds/permission are
transferred as part of the Strip and Stuff actions. This example transfers the CARGO_UNLOAD hold as part of the
Strip or Stuff action:
import java.util.ArrayList;
import java.util.Collection;
import java.util.List;
import com.navis.apex.business.model.GroovyInjectionBase;
import com.navis.cargo.business.model.CargoLot;
import com.navis.inventory.business.units.Unit;
import com.navis.services.business.rules.Flag;
import com.navis.services.business.rules.FlagType;
class CustomHoldTypeListForTransferGroovyImpl extends GroovyInjectionBase {
public List<String> getHoldTypeList(Unit inFromUnit, Unit inToUnit) {
List<String> returnHoldTypeIds = new ArrayList();
log("From Unit:"+inFromUnit.getUnitId()) ;
log("To Unit:"+inToUnit.getUnitId()) ;
Collection flags = FlagType.findActiveFlagsOnEntity(inFromUnit);
for (Object flagObj : flags) {
Flag flag = (Flag) flagObj;
//You can add the list of all holds/permissions that you want to
//move as part of the Strip and Stuff actions.
if (flag.getFlagFlagType().getId().equals("CARGO_UNLOAD")){
returnHoldTypeIds.add(flag.getFlagFlagType().getId()) ;
}
}
return returnHoldTypeIds;
}
}
If the selected cargo lot has other holds/permissions associated with it, N4 does not transfer those as part of the Strip
and Stuff actions. It transfers only the holds/permissions specified in the Groovy plug-in.
The Groovy class name and method signature must match exactly with that specified in the example above.
You can use this Groovy plug-in to transfer different holds for the Strip and the Stuff actions, if required. N4 uses the
inFromUnit and inToUnit variables to determine the Freight Kind of the units. If the inFromUnit represents a
containerized unit and inToUnit represents a break-bulk unit, then it is the Strip action. If the condition is reversed, it
is the Stuff action.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 120
Confidential -- Proprietary
Part 3: Cargo Management Cargo Lots view
Create Delivery Order form
Railcar Visits Railcar Visits view Railcar Visit Inspector Cargo on Board tab
You can use the Cargo Move form to move cargo lots from one position to another.
When you move a cargo lot, if the original cargo lot is associated with a delivery order, N4 copies the Delivery Order
Number to the new cargo lot.
You can use a deliver order to group together the cargo lots for the same consignee. The cargo lots included in a
delivery order may be associated with the same or different bills of lading. In the Cargo Lots view, you must select all
the cargo lots that you want to include in the new delivery order.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 121
Confidential -- Proprietary
Part 3: Cargo Management Cargo Lots view
Create Service Order form
In N4, you can use a service order to plan the events to be performed on a cargo lot.
For example, you can create a service order to identify all the cargo lots that must be stuffed into a container. You can
use a service order to create a plan to stuff:
• Creates or updates the service order and associates it with the cargo lot(s).
You can view the Order Nbr in the Details area in the Cargo Lot Inspector (on page 101).
• Lists the service order in the Operations Yard Service Orders Service Orders view.
• Associates the selected Event Type with the service order.
You can use the Service Order Inspector Services tab to view the details.
• Associates the specified unit with the service order.
You can use the Service Order Inspector Units tab to view the unit.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 122
Confidential -- Proprietary
Part 3: Cargo Management Cargo Lots view
Cargo Discharge form
In N4, you can discharge cargo lots from a vessel to a valid yard position. You can select multiple cargo lots on the
vessel and discharge them to a single yard position.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 123
Confidential -- Proprietary
Part 3: Cargo Management Cargo Lots view
Cargo De-Van form
If you discharge a cargo lot partially, N4 records the CARGO_DISCH event but the Quantity and Quantity
Unit fields for the STORAGE event created in the Chargeable Unit Events view are null.
In N4, you can use the Cargo De-Van form to unload cargo lots from a truck to a valid yard position. You can only
select one cargo lot at a time to unload it from a truck.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 124
Confidential -- Proprietary
Part 3: Cargo Management Cargo Lots view
Cargo De-Ramp form
In N4, you can unload cargo lots from a train or a railcar to a valid yard position. You can select multiple cargo lots on
the train and unload them to a single yard position.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 125
Confidential -- Proprietary
Part 3: Cargo Management Cargo Lots view
Cargo Load form
In N4, you can load a cargo lot from a valid yard position to a vessel visit. N4 assigns a valid yard position and creates
a unit for a cargo lot when you perform any of the following actions:
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 126
Confidential -- Proprietary
Part 3: Cargo Management Cargo Lots view
Cargo Van form
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 127
Confidential -- Proprietary
Part 3: Cargo Management Cargo Lots view
Cargo Van form
In N4, you can use the Cargo Van form to load a cargo lot from a valid yard position onto a truck. You can load cargo
lots from multiple yard locations or from a single yard location. N4 assigns a valid yard position and creates a unit for a
cargo lot when you perform any of the following actions:
If you use the Cargo Van form to load a cargo lot, N4 does not create a gate transaction for the load. To
create a gate transaction and save all the details, you must configure and use the Deliver Break-Bulk Cargo
process for your site.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 128
Confidential -- Proprietary
Part 3: Cargo Management Cargo Lots view
Cargo Ramp form
d. Click Save.
N4 displays an error message if the cargo lot is already on the truck.
When you successfully load a cargo lot onto a truck, N4:
In N4, you can load a cargo lot from a valid yard position to a train visit. N4 assigns a valid yard position and creates a
unit for a cargo lot when you perform any of the following actions:
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 129
Confidential -- Proprietary
Part 3: Cargo Management Cargo Lots view
Manifest Cargo
You can manifest cargo to a carrier, such as a vessel or a rail, or you can manifest cargo to a container. You can
manifest a cargo lot using the Actions menu from the:
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 130
Confidential -- Proprietary
Part 3: Cargo Management Cargo Lots view
Manifest Cargo
element, represents the position of the cargo lot. N4 manifests the cargo lot based on the <cargo-lot> element and the
<position> element.
When you:
• Manifest Cargo to Container (on page 131): You indicate that the cargo lot is inside a container. In this case, N4
does not create a new unit, instead it associates the cargo lot with the existing unit ID. You can then strip the cargo
lot from the unit.
• Manifest Cargo to Vessel (on page 132): You associate the cargo lot with a vessel visit and indicate that the cargo
lot is on board a vessel at the specified position. In this case, N4 creates a new unit on board the vessel at the
specified position. You can then unload the unit from the vessel.
• Manifest Cargo to Rail (on page 134): You associate the cargo lot with a train visit (or a railcar visit) and indicate
that the cargo lot is on board a train at the specified position or railcar ID. In this case, N4 creates a new unit on
board the train. You can then unload the unit from the train.
You can use the Cargo Manifest To Container form to manifest selected cargo lot(s) to an Active or Advised
container unit. Manifesting a cargo lot to a container indicates that the cargo lot is inside the container. In this case, N4
does not create a new unit; instead, it associates the cargo lot with the existing unit ID. You can then perform other
cargo related actions, such as Strip (on page 118), on this unit.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 131
Confidential -- Proprietary
Part 3: Cargo Management Cargo Lots view
Manifest Cargo
If the remaining Quantity for the default cargo lot is zero, the cargo lot is fully manifested and it no longer
displays in the Cargo Lots view.
• Does not create a new Break-Bulk unit. However, it updates the specified unit as follows:
▪ Updates the Cargo Quantity = Existing Cargo Quantity + Quantity.
▪ Displays the cargo lot in the Cargo Lots tab in the Unit Inspector.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 132
Confidential -- Proprietary
Part 3: Cargo Management Cargo Lots view
Manifest Cargo
You can use the Cargo Manifest to Vessel form to manifest selected cargo lot(s) to a vessel visit. Manifesting a cargo
lot to a vessel visit indicates that the cargo lot is on board the vessel. In this case, N4 creates a new Break-bulk unit
with the position on board the vessel. However, if there is already an existing cargo lot at the target position, N4 does
not create a new unit, it only adds the Quantity to the existing cargo lot and unit. You can then perform other cargo
related actions on the unit, such as unload it from the vessel (on page 123).
If the remaining Quantity for the default cargo lot is zero, the cargo lot is fully manifested and it no longer
displays in the Cargo Lots view.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 133
Confidential -- Proprietary
Part 3: Cargo Management Cargo Lots view
Manifest Cargo
You can use the Cargo Manifest to Rail form to manifest selected cargo lot(s) to a train visit or a railcar visit.
Manifesting a cargo lot to a train visit indicates that the cargo lot is on board the train. In this case, N4 creates a new
Break-bulk unit with the position on board the train. However, if there is already an existing cargo lot at the target
position, N4 does not create a new unit, it only adds the Quantity to the existing cargo lot and unit. You can then
perform other cargo related actions on the unit, such as unload it from the train (on page 125).
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 134
Confidential -- Proprietary
Part 3: Cargo Management Cargo Lots view
Manufacture Cargo form
If successful, N4:
If the remaining Quantity for the default cargo lot is zero, the cargo lot is fully manifested and it no longer
displays in the Cargo Lots view.
However, if you specify the Railcar Id, the cargo lots are displayed in the Cargo on Board tab in the
Railcar Visit Inspector.
Some terminals have manufacturing or assembly operations as part of the complex. In such cases cargo does not
come from the outside; instead, it is manufactured in the yard. N4 enables you to create cargo lots for cargo that is
manufactured at the facility. When you manufacture cargo in N4, you can assign a valid yard position to the cargo lot.
This unit can then be loaded onto an outbound carrier to leave the facility.
For example, a bill of lading lists an order for a customer for five rolls of steel. When you produce the rolls, you can use
N4 to create a cargo lot for the rolls and assign a yard position so that you can load the cargo on to a vessel. The yard
position can represent the end of a manufacturing or assembly line where you collect the finished goods before they
are shipped.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 135
Confidential -- Proprietary
Part 3: Cargo Management Cargo Lots view
Adjust Cargo Lot Quantity form
To manufacture cargo:
1. In the Cargo Lots view (on page 96), select the default cargo lot(s) or the identified cargo lot(s) that you want to
manufacture.
If you select multiple cargo lots and any of the selected cargo lots is already associated with a unit, N4 displays an
error message.
2. Select Actions Other Manufacture Cargo.
3. In the Manufacture Cargo form:
a. Enter a valid Yard Position.
If you enter a yard position where you previously manufactured cargo (a unit already exists at that yard position),
N4 does not create a new unit record, instead it updates the existing unit to reflect the change in the quantity and
also records another CARGO_MANUFACTURED event against the Unit.
b. If you do not want to manufacture the entire cargo lot, edit the value in the Quantity field to specify the quantity
that you want to manufacture at the specified yard position.
However, the Quantity field does not display if you select multiple cargo lots in the list view or if you select an
identified cargo lot.
When the value specified in the Quantity field is less than the cargo lot quantity, N4 creates a new cargo lot
record with the specified quantity and reduces the same amount from the quantity for the selected cargo lot.
For example, if the quantity for the default cargo lot is 100, but you enter 60 in the Quantity field in the
Manufacture Cargo form, N4 creates the cargo lot and the unit record with Quantity = 60 and sets the Quantity
of the default cargo lot as 40.
c. Click Save.
When you successfully manufacture cargo at the specified yard position, N4:
• Updates the default cargo lot record in the Cargo Lots view with:
▪ Unit Nbr = Unit Nbr of the new unit created in the Units view.
▪ Quantity = Total quantity of the selected cargo lot(s).
▪ Position = Yard Position specified in the Manufacture Cargo form.
▪ Lot Type = Yard
▪ Lot Position = Yard Position specified in the Manufacture Cargo form.
• Creates a new unit in the Units view with:
▪ T-state = Yard
▪ Position = Yard Position specified in the Manufacture Cargo form.
▪ Cargo Quantity = Total quantity of the selected cargo lot(s).
If you select identified cargo lots in the Cargo Lots view, N4 creates a unit for each of the identified cargo
lots.
• Records the CARGO_MANUFACTURED event against the Unit and the Cargo Lot records.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 136
Confidential -- Proprietary
Part 3: Cargo Management Cargo Lots view
Cargo Transload form
You can use the Adjust Cargo Lot Quantity form to record a discrepancy if you notice that the actual Quantity for the
cargo lot does not match the Quantity in N4.
You cannot adjust the quantity of a default cargo lot or a retired cargo lot.
Discrepancy = 20 - 30 = -10
A positive Discrepancy value indicates surplus while a negative Discrepancy value indicates shortage.
If you adjust the cargo lot Quantity to zero, N4 hides the cargo lot record from the Cargo Lots view and
Retires the unit record in the Units view.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 137
Confidential -- Proprietary
Part 3: Cargo Management Cargo Lots view
Cargo Identify form
You can use the Cargo Transload form to transload cargo lots.
You cannot use the Transload action from the Units view to transload the contents of a unit that contains cargo
lots. To transload cargo lots, you must use the Transload action from the Cargo Lots view (on page 96).
When the transload is successful, it results in four units (also referred to as unit facility visits (UFVs)) in N4. The two old
units (source and destination) are Retired and two new units (or UFVs) are created. In addition, N4:
Notes
• You should not add Event Effects to the new events added for the Transload action.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 138
Confidential -- Proprietary
Part 3: Cargo Management Cargo Lots view
Cancel Cargo Lot Manifest form
You can use the Cargo Identify form to identify cargo lots and assign them unique IDs. Cargo lot IDs must be unique
within a bill of lading (BL). In addition, you cannot identify a Default cargo lot.
You can use the Cancel Cargo Lot Manifest form to cancel or undo the manifest for the selected cargo lot(s).
For an identified cargo lot, N4 does not delete the cargo lot.
To cancel a manifest:
1. In the Cargo Lots view, select the cargo lot(s) for which you want to cancel the manifest.
2. Select the Actions Other Cancel Manifest option.
3. In the Cancel Cargo Lot Manifest form:
a. Select the Confirm Cancel Manifest? check box.
b. Click Save.
When canceling a manifest, you cannot select:
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 139
Confidential -- Proprietary
Part 3: Cargo Management Cargo Lots view
Cargo Split BL form
Occasionally, you may have a bill of lading that you want to split into several small bills of lading to ease the processing
of items on the original BL. For example, you may have an Import shipment that actually belongs to multiple
consignees and you need to split the cargo so that you can control the delivery to each consignee separately.
You can split a bill of lading at the BL Item level or at the cargo lots level. To split the BL at the BL item level, see Item
Split BL form (on page 72).
Prerequisites
• To access the Actions Other Split BL option you must have the Cargo Lot - Split BL privilege.
• Adds or updates the bill of lading in the Bills of Lading view (on page 59) and sets the BL Number of the selected
cargo lot as the Original BL number of the BL record.
• Adds a new cargo lot in the Cargo Lots view.
• Adds a new unit in the Units view.
• Records the CARGO_SPLIT_OFF event in the History, Events tab of the new unit.
• Records the CARGO_SPLIT event in the History, Events tab of the unit associated with the original cargo lot.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 140
Confidential -- Proprietary
Part 3: Cargo Management Cargo Lots view
Cargo Re-consign BL from
• The split BL must have all its cargo originate from the same original BL. Therefore, if the target BL already exists, its
Original BL number must match the BL Number of the selected cargo lots.
• If you select only one cargo lot, you can enter a partial quantity in the Cargo Split BL form. However, if you have
multiple cargo lots selected, you can specify only the target BL number and N4 assumes that the entire quantity of
each of the selected cargo lots is moved to the target BL.
• The cargo lots may not belong to the same Bill of Lading item. Based on the commodity, packaging, and product
type, N4 either uses an existing item or creates a new item.
• If present, N4 adds the transferred quantity to existing cargo lots for the same BL item and location otherwise it
creates a new cargo lot for each BL item and location.
When you use the Split BL action (on page 140) from the Cargo Lots view (on page 96), N4 checks to ensure that all
the selected cargo lots are associated with the same BL. However, you can use the Re-consign BL action to select
cargo lots associated with different bills of lading and combine them into an existing or new BL. You can re-consign a
bill of lading at the BL Item level or at the cargo lots level. To re-consign the BL at the BL item level, see BL Item Re-
consign BL form (on page 72).
Prerequisites
• To access the Actions Other Re-consign BL option you must have the Cargo Lot - Re-consign BL privilege.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 141
Confidential -- Proprietary
Part 3: Cargo Management Cargo Lots view
Damages form (Cargo)
c. Click Save.
If successful, N4:
• Adds or updates the bill of lading in the Bills of Lading view (on page 59).
• Adds a new cargo lot in the Cargo Lots view.
• Adds a new unit in the Units view.
When you re-consign a BL, N4 enforces the following conditions:
• The selected cargo lots may or may not be associated with the same BL.
• The cargo lots may not belong to the same Bill of Lading item. Based on the commodity, packaging, and product
type, N4 either uses an existing item or creates a new item.
• If you select only one cargo lot, you can enter a partial quantity in the Cargo Re-consign BL form. However, if you
have multiple cargo lots selected, you can specify only the target BL number and N4 assumes that the entire
quantity of each of the selected cargo lots is moved to the target BL.
• If present, N4 adds the transferred quantity to existing cargo lots for the same BL item and location otherwise it
creates a new cargo lot for each BL item and location.
In N4, when you record damages against a cargo lot, N4 splits the cargo lot and creates a new cargo lot for the
damaged items. This segregates the damaged cargo from the undamaged items.
For example, a cargo lot has 11 barrels and you record damages with quantity, three. N4 splits the cargo lot into two,
the original cargo lot is updated with quantity = 8, and a new cargo lot is created at the same position with quantity = 3.
Now you can track and move the damaged and undamaged items separately.
If the cargo lot position already has other damaged items, N4 combines any new damages recorded for the same
cargo lot if the bill of lading item (commodity, product type, and packaging) and the damage type of the damage record
is the same.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 142
Confidential -- Proprietary
Part 3: Cargo Management Cargo Lots view
Damages form (Cargo)
• Creates separate cargo lots at the same location for the same BL Item if the set of damages associated with the
cargo lot are different.
• Retains the cargo lot damages when you move a cargo lot.
• Validates the Damage Quantity entered when recording damages and then splits the cargo lot.
• Combines damaged cargo lots at the same location if the BL Item and the Damage Type is the same.
If you merge two cargo lots with the same damage type but different severity, the damage severity of the target
cargo lot overrides the damage severity of the merged cargo lot.
• For Identified cargo lots, you can record damages even before you manifest the cargo lot. When you later manifest
the cargo lot, N4 simply updates the position of the Identified cargo lot without changing the Damage information.
The Damages tab (on page 105) in the Cargo Lot Inspector (on page 101) displays the damages recorded against
the selected cargo lot. In addition, if you record a major damage for a cargo lot, N4 displays the damaged icon in the
Cargo Lot Inspector.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 143
Confidential -- Proprietary
Part 3: Cargo Management Cargo Lots view
Damages form (Cargo)
• N4 combines the lots since the Damage Type and original BL # are the same.
The following table lists the optional fields in the Damages form:
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 144
Confidential -- Proprietary
Part 3: Cargo Management Cargo Lots view
Damages form (Cargo)
2. Click .
3. Click Save.
If you click Close, N4 closes the form without saving the changes.
If you delete all the damage items for a cargo lot, the cargo lot is no longer damaged.
When you delete a damage for a cargo lot, N4 records the CARGO_DAMAGE event (on page 145) against the cargo
lot.
CARGO_DAMAGE event
When you record damages for a cargo lot, N4 records the CARGO_DAMAGE event in the Event History of the target
cargo lot.
When recording the CARGO_DAMAGE event, N4 also records the changes to the following fields:
• Damage Quantity
• Damage Quantity Unit
• Cargo Damage Type
• Cargo Damage Severity
If you completely delete a damage record, the Cargo Damage Type field and the Cargo Damage Severity field are
set to null (as opposed to empty). Also, since the Quantity becomes zero, N4 retires the cargo lot.
N4 always records the CARGO_DAMAGE event to the unit associated with the cargo lot. If the cargo lot is inside a
container then it is the container unit; otherwise, it is the B-Bulk unit associated with the cargo lot.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 145
Confidential -- Proprietary
3.4 Pre-Advised Cargo view
Operations Cargo Pre-Advised Cargo Pre-Advised Cargo view
Prerequisites
• To access the Pre-Advised Cargo view, you need to assign the Cargo Lot - View privilege to your user role.
The Pre-Advised Cargo view displays the cargo lots that are not associated with a unit. This view also includes the
identified cargo lots that have not been manifested, yet.
You cannot add, edit, or delete cargo lots from this view. However, you can view the Cargo Lot Inspector (on page
101) for the selected cargo lot and perform following Actions on the selected cargo lot(s):
• Edit Cargo Lot (on page 115): Edit some of the fields associated with the selected cargo lot record.
• Manifest Rail (on page 134): Manifest the selected cargo lot(s) to a rail.
• Manifest Vessel (on page 132): Manifest the selected cargo lot(s) to a vessel.
• Manifest Container (on page 131): Manifest the selected cargo lot(s) to a container.
• Manufacture Cargo (on page 135): Create cargo lots for cargo manufactured at the facility.
• Identify Lot (on page 138): Identify the contents of the selected cargo lot.
• Split BL (on page 140): Split the selected cargo lot(s) to a new or existing BL for ease of processing.
• Re-consign BL (on page 141): Re-consign the selected cargo lots to a new or existing BL.
• Record Damages (on page 142): Record damages for the selected cargo lot.
In addition, if you press CTRL+s keys, N4 displays the Select Action message box where you can type the first few
characters of the action that you want to perform to access the option.
In This Section
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 146
Confidential -- Proprietary
Part 3: Cargo Management Pre-Advised Cargo view
Pre-Advised Cargo Columns
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 147
Confidential -- Proprietary
Part 4
N4 Mobile Cargo
In this Section:
Cargo Inventory. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 148
Confidential -- Proprietary
4.1 Cargo Inventory
The Cargo Inventory application enables you to inspect cargo lots and perform various actions, such as load and
unload cargo lots from a carrier (vessel, truck, or rail), stuff cargo lots, strip cargo lots, and identify cargo lots. The
INVMOBILE_RDT005 (MOBILE_CARGO_INVENTORY_POPULATE_QTY) (on page 40) setting determines whether
to display or hide the cargo lot quantity in the Quantity field in all N4 Mobile Cargo Inventory programs.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 149
Confidential -- Proprietary
Part 4: N4 Mobile Cargo Cargo Inventory
Pre-Advised Cargo Columns
Depending on your privileges (on page 54) your form may look different.
In This Section
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 150
Confidential -- Proprietary
Part 4: N4 Mobile Cargo Cargo Inventory
Stuff Cargo
5. Click .
If only one cargo lot is found matching the specified criteria, Cargo Inventory displays the Validate form (on page 153);
otherwise, it displays the Matching Cargo form (on page 155).
• Unit ID
• Bill of Lading
• BL Item
• Cargo Lot
• Commodity
• Product
• Package
• Position
• Quantity
If you want to use flex fields, they must first be configured in N4. N4 Mobile supports the unitFlexString01 -
unitFlexString15 flex fields. For more information, see Use flex fields in Navis N4: Customization Administrator Guide.
Once configured, you can then configure the N4 Mobile forms to display only the flex fields you want.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 151
Confidential -- Proprietary
Part 4: N4 Mobile Cargo Cargo Inventory
Stuff Cargo
5. Click .
After the stuff action is completed successfully, you can see the changes reflected in the Units view, Cargo Lots view
(on page 96), and the Bills of Lading view (on page 59) in N4.
For the Cargo Stuff action, N4 records a CARGO_STUFF event each time you stuff a partial or full quantity
to a unit. However, it records the UNIT_STUFF action only once when you stuff the first cargo lot into the
unit.
• Unit ID
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 152
Confidential -- Proprietary
Part 4: N4 Mobile Cargo Cargo Inventory
Strip Cargo
• Service Order
• For each cargo lot:
▪ Cargo Lot ID
▪ BL Item
▪ Commodity
▪ Product
From the list of Cargo Lot IDs displayed in the Matching Cargo form, select the cargo lot you want to stuff into the
container. Cargo Inventory displays the Validate form (on page 151) for the selected cargo lot.
After you stuff the selected cargo lot, Cargo Inventory returns you to the Matching Cargo form. You can either
continue to stuff the other cargo lots or you can click the button to go back to the Search form.
You can also click the button to go back to the list of N4 Mobile applications.
4. Click .
If only one cargo lot is found matching the specified criteria, Cargo Inventory displays the Validate form (on page
153); otherwise, it displays the Matching Cargo form (on page 155).
• Unit ID
• Bill of Lading
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 153
Confidential -- Proprietary
Part 4: N4 Mobile Cargo Cargo Inventory
Strip Cargo
• BL Item
• Cargo Lot
• Commodity
• Product
• Package
• Position
• Quantity
• Container Empty?
You can edit, the Position, Quantity, and Container Empty? fields.
If you want to use flex fields, they must first be configured in N4. N4 Mobile supports the unitFlexString01 -
unitFlexString15 flex fields. For more information, see Use flex fields in Navis N4: Customization Administrator Guide.
Once configured, you can then configure the N4 Mobile forms to display only the flex fields you want.
4. Click .
After the strip is completed successfully, you can see the changes reflected in the Units view, Cargo Lots view (on
page 96), and the Bills of Lading view (on page 59) in N4.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 154
Confidential -- Proprietary
Part 4: N4 Mobile Cargo Cargo Inventory
Vessel Load
• To a position in the yard where other cargo lots already exist, N4 updates the cargo unit as follows:
▪ Increases the existing Quantity of the cargo lot at the yarf Position by the Quantity specified in step 2 above.
▪ Updates the existing cargo unit at the yard location as follows:
▪ Quantity = Original Quantity - Quantity moved
• Unit ID
• Bill of Lading
• Service Order
• For each cargo lot:
▪ Cargo Lot ID
▪ BL
▪ BL Item
▪ Commodity
▪ Product
From the list of Cargo Lot IDs displayed in the Matching Cargo form, select the cargo lot you want to strip from the
container. Cargo Inventory displays the Validate form (on page 153) for the selected cargo lot.
After you strip the selected cargo lot, Cargo Inventory returns you to the Matching Cargo form. You can either
continue to strip the other cargo lots or you can click the button to go back to the Search form.
You can also click the button to go back to the list of N4 Mobile applications.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 155
Confidential -- Proprietary
Part 4: N4 Mobile Cargo Cargo Inventory
Vessel Load
4. Click .
If only one cargo lot is found matching the specified criteria, Cargo Inventory displays the Load form (on page 156);
otherwise, it displays the Matching Cargo form (on page 157).
• Vessel Visit ID
• Bill of Lading
• BL Item
• Cargo Lot
• Commodity
• Product
• Package
• Position
• Quantity
All the fields, except Position and Quantity are displayed in the view-only mode.
3. Click .
After the load is completed successfully, you can see the changes reflected in the Units view, Cargo Lots view (on
page 96), and the Bills of Lading view (on page 59) in N4.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 156
Confidential -- Proprietary
Part 4: N4 Mobile Cargo Cargo Inventory
Vessel UnLoad
• Vessel Visit ID
• Bill of Lading
• For each cargo lot:
▪ Cargo Lot ID
▪ BL Item
▪ Commodity
▪ Product
From the list of Cargo Lot IDs displayed in the Matching Cargo form, select the cargo lot you want to load on the
vessel. Cargo Inventory displays the Load form (on page 156) for the selected cargo lot.
After you load the selected cargo lot, Cargo Inventory returns you to the Matching Cargo form. You can either
continue to load the other cargo lots or you can click the button to go back to the Search form (on page 155).
You can also click the button to go back to the list of N4 Mobile applications.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 157
Confidential -- Proprietary
Part 4: N4 Mobile Cargo Cargo Inventory
Vessel UnLoad
4. Click .
If only one cargo lot is found matching the specified criteria, Cargo Inventory displays the Vessel UnLoad - Validate
form (on page 158); otherwise, it displays the Matching Cargo form (on page 159).
• Vessel Visit ID
• Bill of Lading
• BL Item
• Cargo Lot
• Commodity
• Product
• Package
• Position
• Quantity
All the fields, except Position and Quantity are displayed in the view-only mode.
If you want to use flex fields, they must first be configured in N4. N4 Mobile supports the unitFlexString01 -
unitFlexString15 flex fields. For more information, see Use flex fields in Navis N4: Customization Administrator Guide.
Once configured, you can then configure the N4 Mobile forms to display only the flex fields you want.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 158
Confidential -- Proprietary
Part 4: N4 Mobile Cargo Cargo Inventory
Vessel UnLoad
3. Click .
After the discharge is completed successfully, you can see the changes reflected in the Units view, Cargo Lots view
(on page 96), and the Bills of Lading view (on page 59) in N4.
• Vessel Visit ID
• Bill of Lading
• For each cargo lot:
▪ Cargo Lot ID
▪ BL Item
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 159
Confidential -- Proprietary
Part 4: N4 Mobile Cargo Cargo Inventory
Truck Load
▪ Commodity
▪ Product
From the list of Cargo Lot IDs displayed in the Matching Cargo form, select the cargo lot you want to discharge from
the vessel. Cargo Inventory displays the Vessel UnLoad - Validate form (on page 158) for the selected cargo lot.
After you discharge the selected cargo lot, Cargo Inventory returns you to the Matching Cargo form. You can either
continue to discharge the other cargo lots or you can click the button to go back to the Search form (on page
158).
You can also click the button to go back to the list of N4 Mobile applications.
You must specify at least one of the optional values, Truck License or Bill of Lading.
4. Click .
If you specify only one of the above values and multiple truck visits are returned, Cargo Inventory displays the
Matching Visits form (on page 161); otherwise, it displays the Select Cargo To Load form (on page 160).
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 160
Confidential -- Proprietary
Part 4: N4 Mobile Cargo Cargo Inventory
Truck Load
However, if you do not want to manually enter the Cargo Lot information, you can click to proceed to the
Validate Load form (on page 161).
If only one cargo lot is found matching the specified criteria, Cargo Inventory displays the Validate Load form;
otherwise, it displays the Matching Cargo form (on page 161).
If you want to use flex fields, they must first be configured in N4. N4 Mobile supports the unitFlexString01 -
unitFlexString15 flex fields. For more information, see Use flex fields in Navis N4: Customization Administrator Guide.
Once configured, you can then configure the N4 Mobile forms to display only the flex fields you want.
After you have specified the quantity to be loaded onto the truck, click . Cargo Inventory returns to the Select
Cargo To Load form (on page 160) and displays a message indicating that the cargo lot was successfully loaded onto
the truck. This also completes the associated gate transaction.
If you have loaded all the cargo lots to the truck, click Done to complete the gate transaction at the yard stage and
enable the truck to move to the next gate stage. If the yard stage is the last stage for the truck visit, N4 also marks the
truck visit as completed. If you click Done before loading all the cargo lots onto the truck, Cargo Inventory displays an
error message.
• BL Nbr
• Delivery Order
• Truck License
From the list displayed in the Matching Visits form, select the BL or the truck license that you want to process. Cargo
Inventory displays the Select Cargo To Load form (on page 160).
• Delivery Order
• Bill of Lading
• For each cargo lot:
▪ Cargo Lot ID
▪ BL Item
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 161
Confidential -- Proprietary
Part 4: N4 Mobile Cargo Cargo Inventory
Truck UnLoad
▪ Position
▪ Product
From the list of Cargo Lot IDs displayed in the Matching Cargo form, select the cargo lot, based on the position in the
yard, that you want to load onto the truck. Cargo Inventory displays the Validate Load form (on page 161) for the
selected cargo lot.
After you specify the Quantity and click to load the selected cargo lot, Cargo Inventory returns you to the Select
Cargo To Load form (on page 160). You can repeat the steps to load remaining cargo lots associated with the truck
license.
You can also click the button to go back to the list of N4 Mobile applications.
To manifest a cargo lot on the truck as part of the ingate stage, include the CreateBreakbulkUnit
business task at the ingate stage for the Receive Break-Bulk (RB) gate transaction type.
3. Click .
If you specify only the truck license or only the BL Nbr and the specified truck license is associated with multiple BLs or
the specified BL is associated with multiple truck licenses, Cargo Inventory displays the Matching BL form (on page
163); otherwise, it displays the Select Cargo To UnLoad form (on page 163).
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 162
Confidential -- Proprietary
Part 4: N4 Mobile Cargo Cargo Inventory
Truck UnLoad
However, if you do not want to manually enter the Cargo Lot information, you can click to proceed to the
Validate Unload form (on page 163).
If only one cargo lot is found matching the specified criteria, Cargo Inventory displays the Validate Unload form (on
page 163); otherwise, it displays the Matching Cargo form (on page 163).
If you want to use flex fields, they must first be configured in N4. N4 Mobile supports the unitFlexString01 -
unitFlexString15 flex fields. For more information, see Use flex fields in Navis N4: Customization Administrator Guide.
Once configured, you can then configure the N4 Mobile forms to display only the flex fields you want.
After you specify the yard Position, click . Cargo Inventory returns to the Select Cargo To UnLoad form (on
page 163) and displays a message indicating that the cargo lot was successfully unloaded from the truck.
If you have unloaded all the cargo lots from the truck, click Done to complete the gate transaction at the yard stage and
enable the truck to move to the next gate stage. If the yard stage is the last stage for the truck visit, N4 also marks the
truck visit as completed. If you click Done before unloading all the cargo from a truck, Cargo Inventory displays an
error message.
• BL Nbr
• Truck License
From the list displayed in the Matching BL form, select the BL or the truck license that you want to process. Cargo
Inventory displays the Select Cargo To UnLoad form (on page 163).
• Truck License
• Bill of Lading
• For each cargo lot:
▪ Cargo Lot ID
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 163
Confidential -- Proprietary
Part 4: N4 Mobile Cargo Cargo Inventory
Rail Load
▪ BL Item
▪ Commodity
▪ Product
From the list of Cargo Lot IDs displayed in the Matching Cargo form, select the cargo lot you want to unload from the
truck. Cargo Inventory displays the Validate Unload form (on page 163) for the selected cargo lot.
After you specify the Position and click to unload the selected cargo lot, Cargo Inventory returns you to the
Search form. You can repeat the steps to unload all the cargo lots associated with the truck license.
You can also click the button to go back to the list of N4 Mobile applications.
3. Optionally, enter the BL number for the cargo lot that you want to load on the train.
4. Optionally, enter the Cargo Lot ID.
If the cargo lot is not associated with the specified bill of lading or is not in the yard, Cargo Inventory displays an
error.
You must specify at least one of the optional values, BL or Cargo Lot.
5. Click .
If only one cargo lot is found matching the specified criteria, Cargo Inventory displays the Validate form (on page
164); otherwise, it displays the Matching Cargo form (on page 166).
• Rail Visit
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 164
Confidential -- Proprietary
Part 4: N4 Mobile Cargo Cargo Inventory
Rail Load
• Bill of Lading
• BL Item
• Cargo Lot
• Commodity
• Product
• Package
• Position
• Quantity
If you want to use flex fields, they must first be configured in N4. N4 Mobile supports the unitFlexString01 -
unitFlexString15 flex fields. For more information, see Use flex fields in Navis N4: Customization Administrator Guide.
Once configured, you can then configure the N4 Mobile forms to display only the flex fields you want.
3. Click .
After the load is completed successfully, you can see the changes reflected in the Units view, Cargo Lots view (on
page 96), and the Bills of Lading view (on page 59) in N4.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 165
Confidential -- Proprietary
Part 4: N4 Mobile Cargo Cargo Inventory
Rail UnLoad
• Rail Visit
• Bill of Lading
• For each cargo lot:
▪ Cargo Lot ID
▪ BL Item
▪ Position
▪ Product
From the list of Cargo Lot IDs displayed in the Matching Cargo form, select the cargo lot you want to load on the
railcar. Cargo Inventory displays the Validate form (on page 164) for the selected cargo lot.
After you load the selected cargo lot, Cargo Inventory returns you to the Matching Cargo form. You can either
continue to load the other cargo lots or you can click the button to go back to the Search form (on page 164).
You can also click the button to go back to the list of N4 Mobile applications.
3. Optionally, enter the Bill of Lading number for the cargo lot that you want to unload from the railcar.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 166
Confidential -- Proprietary
Part 4: N4 Mobile Cargo Cargo Inventory
Rail UnLoad
5. Click .
If only one cargo lot is found matching the specified criteria, Cargo Inventory displays the Validate form (on page
167); otherwise, it displays the Matching Cargo form (on page 168).
• Rail Visit
• Bill of Lading
• BL Item
• Cargo Lot
• Commodity
• Product
• Package
• Position
• Quantity
All the fields, except Position and Quantity are displayed in the view-only mode.
If you want to use flex fields, they must first be configured in N4. N4 Mobile supports the unitFlexString01 -
unitFlexString15 flex fields. For more information, see Use flex fields in Navis N4: Customization Administrator Guide.
Once configured, you can then configure the N4 Mobile forms to display only the flex fields you want.
3. Click .
After the unload is completed successfully, you can see the changes reflected in the Units view, Cargo Lots view (on
page 96), and the Bills of Lading view (on page 59) in N4.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 167
Confidential -- Proprietary
Part 4: N4 Mobile Cargo Cargo Inventory
Inspect Cargo
• To a position in the yard where other cargo lots already exist, N4 updates the cargo unit as follows:
▪ Increases the existing Quantity of the cargo lot in the yard by the Quantity specified in step 2 above.
▪ Retires the unit on the railcar.
If you unload only a part of the cargo lot:
• Rail Visit
• Bill of Lading
• For each cargo lot:
▪ Cargo Lot ID
▪ BL Item
▪ Commodity
▪ Product
From the list of Cargo Lot IDs displayed in the Matching Cargo form, select the cargo lot you want to unload from the
railcar. Cargo Inventory displays the Validate form (on page 167) for the selected cargo lot.
After you unload the selected cargo lot, Cargo Inventory returns you to the Matching Cargo form. You can either
continue to unload the other cargo lots or you can click the button to go back to the Search form (on page 166).
You can also click the button to go back to the list of N4 Mobile applications.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 168
Confidential -- Proprietary
Part 4: N4 Mobile Cargo Cargo Inventory
Inspect Cargo
2. Click .
If only one cargo lot is found matching the specified criteria, Cargo Inventory displays the Validate form (on page 169);
otherwise, it displays the Matching Cargo form (on page 170).
• Bill of Lading
• BL Item
• Cargo Lot
• Commodity
• Product
• Package
• Marks
• Position
• Quantity
If you want to use flex fields, they must first be configured in N4. N4 Mobile supports the unitFlexString01 -
unitFlexString15 flex fields. For more information, see Use flex fields in Navis N4: Customization Administrator Guide.
Once configured, you can then configure the N4 Mobile forms to display only the flex fields you want.
2. Click .
If you update the Quantity for the cargo lot, N4:
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 169
Confidential -- Proprietary
Part 4: N4 Mobile Cargo Cargo Inventory
Identify Cargo
• Bill of Lading
• For each cargo lot:
▪ Cargo Lot ID
▪ BL Item
▪ Commodity
▪ Product
From the list of Cargo Lot IDs displayed in the Matching Cargo form, select the cargo lot you want to inspect. Cargo
Inventory displays the Validate form (on page 169) for the selected cargo lot.
After you inspect the selected cargo lot, Cargo Inventory returns you to the Matching Cargo form. You can either
continue to inspect the other cargo lots or you can click the button to go back to the Search form.
You can also click the button to go back to the list of N4 Mobile applications.
2. Click .
If only one cargo lot is found matching the specified criteria, Cargo Inventory displays the Validate form (on page 171);
otherwise, it displays the Matching Cargo form (on page 171).
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 170
Confidential -- Proprietary
Part 4: N4 Mobile Cargo Cargo Inventory
Identify Cargo
• Bill of Lading
• BL Item
• Cargo Lot
• Commodity
• Product
• Package
• Marks
• Position
• Quantity
• Cargo ID
You can edit only the Cargo ID field.
If you want to use flex fields, they must first be configured in N4. N4 Mobile supports the unitFlexString01 -
unitFlexString15 flex fields. For more information, see Use flex fields in Navis N4: Customization Administrator Guide.
Once configured, you can then configure the N4 Mobile forms to display only the flex fields you want.
2. Click .
Cargo Inventory returns you to the Matching Cargo form (on page 171), where the new identified cargo lot is also
displayed.
If successful, N4:
• Bill of Lading
• For each cargo lot:
▪ Cargo Lot ID
▪ BL Item
▪ Commodity
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 171
Confidential -- Proprietary
Part 4: N4 Mobile Cargo Cargo Inventory
Record Damages
▪ Product
From the list of Cargo Lot IDs displayed in the Matching Cargo form, select the cargo lot you want to identify. Cargo
Inventory displays the Validate form (on page 171) for the selected cargo lot.
After you identify the selected cargo lot, Cargo Inventory returns you to the Matching Cargo form. You can either
continue to identify the other cargo lots or you can click the button to go back to the Search form.
You can also click the button to go back to the list of N4 Mobile applications.
4. Click .
If you enter a valid Cargo Lot ID, Cargo Inventory displays the Record Damages - Validate Record Damage form (on
page 172). However, if you enter a valid bill of lading that has multiple cargo lots associated with it, Cargo Inventory
displays the Record Damages - Matching Cargo form (on page 173).
• Bill of Lading
• BL Item
• Cargo Lot
• Position
• Quantity
For each cargo lot, you can record up to two damages using the Validate Record Damage form. To record more than
two damages, you must use the Record Damages action in from the Cargo Lots view (on page 96) in N4.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 172
Confidential -- Proprietary
Part 4: N4 Mobile Cargo Cargo Inventory
Move Cargo
6. Click .
The Matching Cargo form displays the following information for each cargo lot:
• Cargo Lot ID
• BL Item
• Commodity
• Product
From the list of Cargo Lot IDs displayed in the Matching Cargo form, select the cargo lot against which you want to
record the damages. Cargo Inventory displays the Validate Record Damage form (on page 172) for the selected
cargo lot.
After you record the damages for the selected cargo lots, Cargo Inventory returns you to the Search form (on page
172). You can either continue to record damages for other cargo lots associated with the bill of lading or specify
another BL in the Search form.
You can also click the button to go back to the list of N4 Mobile applications.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 173
Confidential -- Proprietary
Part 4: N4 Mobile Cargo Cargo Inventory
Move Cargo
2. Click .
If only one cargo lot is found matching the specified criteria, Cargo Inventory displays the Quantity and Position form
(on page 174); otherwise, it displays the Matching Cargo form (on page 174).
The Matching Cargo form displays the following information for each cargo lot:
• Cargo Lot ID
• BL Item
• Position
• Marks
From the list of Cargo Lot IDs displayed in the Matching Cargo form, select the cargo lot you want to move. Cargo
Inventory displays the Quantity and Position form (on page 174) for the selected cargo lot.
After you move the selected cargo lots, Cargo Inventory returns you to the Search form. You can either continue to
move other cargo lots associated with your search criteria or specify new search criteria in the Search form (on page
173).
You can also click the button to go back to the list of N4 Mobile applications.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 174
Confidential -- Proprietary
Part 5
Cargo How Do I...
This section includes the frequently asked questions for cargo.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 175
Confidential -- Proprietary
5.1 Cargo How Do I...
How do I ...
In This Section
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 176
Confidential -- Proprietary
Part 5: Cargo How Do I... Cargo How Do I...
Associate/Disassociate a non-archetype commodity with/from the archetype commodity
In N4 you can associate non-archetype commodities using Add Commodity form (on page 18) or Assign Archetype
Commodity form (on page 22) only if there exists an archetype commodity in the current scope level. You can create
an commodity using the Add Commodity form and select the Is Archetype check box to make it an archetype
commodity. You can also edit a non-archetype commodity and make it an archetype by selecting the Is Archetype
check box. N4 lists all the archetype commodities created for the current scope in the Archetype drop-down list in the
Add Commodity form. However, for an archetype commodity, the Archetype drop-down list appears grayed out.
Non-admin users should have the CARGO_EDIT (on page 51) privilege to work with the archetype functionality.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 177
Confidential -- Proprietary
Part 5: Cargo How Do I... Cargo How Do I...
Cancel a break-bulk gate transaction
N4 resets the Quantity of the selected cargo lot to what it was before creating the gate transaction. In addition, it
purges the cargo units created as part of the gate transaction.
• The T-State column is updated as yard in the Cargo Lots and Units views.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 178
Confidential -- Proprietary
Part 5: Cargo How Do I... Cargo How Do I...
Configure Holds/Permissions to prevent break-bulk cargo events from being recorded
Since most of the cargo Actions record events against the associated cargo unit, you must create the Holds/
Permissions for the Unit entity and not the Cargo Lot entity.
You can use the History, Events tab in the Unit Inspector of the unit associated with a cargo lot to view the events
recorded for the Unit entity. For a complete list of cargo-related events, see Cargo Holds/Permissions (on page 108).
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 179
Confidential -- Proprietary
Part 5: Cargo How Do I... Cargo How Do I...
Configure PIN related business tasks for break-bulk cargo
2. Use the Service Business Rule form to add a service business rule for the hold/permission added in step 1 above.
3. In the Cargo Lots view (on page 96), select a cargo lot that you want to load on a vessel and that has a unit
associated with it.
4. Double-click the cargo record to open the Cargo Lot Inspector (on page 101).
Event type 'CARGO_LOAD' can not be applied to 'Unit:<Unit Number>'. Hold <Hold/Permission ID> exists on '<Unit
Number>.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 180
Confidential -- Proprietary
Part 5: Cargo How Do I... Cargo How Do I...
Configure PIN related business tasks for break-bulk cargo
• RejectPinNbrNotEntered
• RejectPinNbrMismatch
• RejectPinNbrNotAssigned
The following table displays the expected result when you include the three business tasks in your gate configuration
and whether you specify a Delivery Order (DO) or Bill of Lading (BL) at the gate.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 181
Confidential -- Proprietary
Part 5: Cargo How Do I... Cargo How Do I...
Enter cargo lot Quantity for truck loads
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 182
Confidential -- Proprietary
Part 5: Cargo How Do I... Cargo How Do I...
Extend Cargo features in N4 Mobile
To prevent a N4 Mobile Cargo user from completing a gate transaction if they enter a quantity that is more than what is
specified in the cargo delivery order, include the RejectCargoRequestedNotFound business task in your Deliver
Break-Bulk (DB) gate transaction configuration.
To prevent users logged in at one facility from viewing cargo lots that exist at other facilities within the
complex:
1. In the Roles view, create a new role or edit an existing role to include the Cargo Lot - Deny Unfiltered view
(CARGO_LOT_DENY_UNFILTERED_VIEW) privilege.
This privilege is applicable only if the user has at least the Cargo Lot - View privilege to access the Cargo
Lots view.
2. In the Users view, assign the role that you created/edited in step 1 to the users who should not have the permission
to view the cargo lots for other facilities.
3. In the Cargo Lots view (on page 96):
a. Define a filter that restricts the records displayed in the list view based on the Inbound BL Item Vessel Visit
Facility field.
b. Save the filter and associate the user role (created/edited in step 1), for which you want to restrict the access,
with the saved filter. For more information, see Saving the list view as a filter in Navis N4: Basics.
Now, when users with the new role log into N4, they can view only the cargo lots filtered by the facility at which they are
logged in. In addition, they cannot see the following options in the Saved Filter menu in the Cargo Lots view:
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 183
Confidential -- Proprietary
Part 5: Cargo How Do I... Cargo How Do I...
Prevent getting same bill of lading (BL) in the same Complex
Customer has multiple facilities in the same complex. Data for a transshipment container arrives at Facility A through a
BAPLIE and COPRAR-d with BL 12345. However, customer receives error saying that BL does not match the vessel
visit because the BL is already in N4.
Solution:
Set CGOCargoValidation004 (MATCH_BL_UNIT_CARRIER_VISIT) (on page 40) to false at the Complex scope
level. This will prevent N4 from validating the carrier visit for the unit against the carrier visit for the BL.
The XSL can only be used with postscript printers. For non-postscript printers, you must consult the printer
manual and edit the XSL accordingly.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 184
Confidential -- Proprietary
Part 5: Cargo How Do I... Cargo How Do I...
Process identified cargo lots using Gate API
API Request:
<gate>
<submit-transaction>
<gate-id>GEN_CARGO</gate-id>
<stage-id>Ingate</stage-id>
<truck license-nbr="ATOL"/>
<truck-visit tvdtls-flex-string01="SEM01"/>
<truck-transaction tran-type="RB">
</cargo>
</truck-transaction>
</submit-transaction>
</gate>
When you post the above API, N4 processes the identified cargo lot ‘LOT-01’ for the Receive Breakbulk transaction.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 185
Confidential -- Proprietary
Part 5: Cargo How Do I... Cargo How Do I...
Record a Billable Event Type for a Cargo Lot
6. Click Save.
If you select CargoLot from the Applies To drop-down list, the Billable check box is not applicable.
Although N4 does not display any error message, you cannot directly extract this event or include it in an
invoice.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 186
Confidential -- Proprietary
Part 5: Cargo How Do I... Cargo How Do I...
Set up Inbound Cargo EDI Messages
You can set up the Inbound EDI message CUSCAR D 95B (Customs Cargo Report) to create and update cargo data,
such as BL, BL Item, and default cargo lots. As updates to the BL occur, N4 adjusts the BL Item quantity and the
associated default cargo lot.
In the EDI Session form, when you select Manifest as the EDI Message class, N4 enables the Extract button and the
Filter Criteria area on the form.
The Inbound EDI messages follow the current N4 method of Receive Load Classify Map Post.
N4 supports the cargo lot details only for outbound Manifest EDI messages.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 187
Confidential -- Proprietary
Part 5: Cargo How Do Cargo How Do I...
I... Merge or move the Bill of Lading (BL) items when you re-consign one BL to another BL with identical
commodities
In N4, you can:
• Create an EDI session where the Message Type = Manifest, Direction = Send, and the File Extension = XML. You
must also define filter criteria to specify the bills of lading to be included in the EDI message.
You can use the following fields to define the filter criteria:
▪ Agent
▪ BL Number
▪ Bond Trucking Company
▪ Bonded Destination
▪ Consignee
▪ Exam Status
▪ Inbond status
▪ Line operator
▪ Manifest Seq Number
▪ Port of Discharge
▪ Port of Load
▪ Second Port of Discharge
▪ Shipper
▪ Vessel Visit
▪ Vessel Visit Phase
• Schedule the EDI session as an EDI Job.
The Outbound EDI messages follow the current N4 method of Select Extract Map Unload Send.
By default, N4 merges the BL items if you re-consign one BL to another BL with matching commodity.
If you override this setting, N4 moves the BL items from one BL to the other BL with matching commodity.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 188
Confidential -- Proprietary
Part 5: Cargo How Do Cargo How Do I...
I... Merge or move the Bill of Lading (BL) items when you re-consign one BL to another BL with identical
commodities
This setting is applicable only for identified cargo lots. You can use the Identified Lots tab (on page 71) in the
Bill of Lading Item form to add or edit identified cargo lots.
Merge BL Items
Consider there are two BL items, BL123 and BL124 with quantity 1 each and identical commodity 'CAR'.
1. Double-click the CGORECONSIGN001 (ON_RECONSIGN) (on page 40) setting in the Settings view and in the
Edit Configuration form ensure that the MOVE_ITEMS_IDENTIFIED_CARGO option is excluded by default.
2. Select the BL item, BL123 from the Bills of Lading view.
3. Select the Bill of Lading Inspector Items tab. The BL items are displayed.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 189
Confidential -- Proprietary
Part 5: Cargo How Do Cargo How Do I...
I... Merge or move the Bill of Lading (BL) items when you re-consign one BL to another BL with identical
commodities
4. Select the item and click Actions Re-consign BL. The BL Item Re-consign BL form (on page 72) is displayed.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 190
Confidential -- Proprietary
Part 5: Cargo How Do Cargo How Do I...
I... Merge or move the Bill of Lading (BL) items when you re-consign one BL to another BL with identical
commodities
8. Select the Bill of Lading Inspector Items tab. There will be one BL item with quantity 2.
Move BL Items
Follow these steps to move the BL item from one BL to another BL:
1. Double-click the CGORECONSIGN001 (ON_RECONSIGN) (on page 40) setting in the Settings view and in the
Edit Configuration form, click Override and include the MOVE_ITEMS_IDENTIFIED_CARGO option.
2. Follow steps 2 to 7 mentioned in the earlier procedure.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 191
Confidential -- Proprietary
Part 5: Cargo How Do I... Cargo How Do I...
Create invoice for multiple cargo lots using the 'generate-invoice-request' API
3. Select the Bill of Lading Inspector Items tab. Two BL items with quantity 1 each are displayed.
For information about the operators listed in the drop-down list, see Using operators in the online help or on the NCC.
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 192
Confidential -- Proprietary
Index
Index
A Cargo Lot ID. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Adjust Cargo Lot Quantity form. . . . . . . . . . . . . . 136 Cargo Lot Inspector. . . . . . . . . . . . . . . . . . . . . . . 101
Cancel Cargo Lot Manifest form. . . . . . . . . . . . . . 139 Cargo Transload form. . . . . . . . . . . . . . . . . . . . . 137
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 193
Confidential -- Proprietary
Index
Enter cargo lot Quantity for truck loads. . . . . . . . 182 Inspect - Validate form. . . . . . . . . . . . . . . . . . . . . 169
Inspect Cargo. . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
INVBL001 (TRUE_BILLS_OF_LADING). . . . . . . . 39
INVBL002
(BILLS_OF_LADING_FOR_ALL_IMPORT_EMPTIES)
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 194
Confidential -- Proprietary
Index
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 195
Confidential -- Proprietary
Index
T
Transferring Cargo Holds/Permissions. . . . . . . . 109
Truck Load. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
Truck UnLoad. . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
U
Units tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114, 73
Units Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
UnLoad Cargo - Matching BL form. . . . . . . . . . . . 163
UnLoad Cargo - Matching Cargo form. . . . . . . . . 163
UnLoad Cargo - Search form. . . . . . . . . . . . . . . . 162
UnLoad Cargo - Select Cargo To UnLoad form. . 163
UnLoad Cargo - Validate Unload form. . . . . . . . . 163
Unload Rail - Matching Cargo form. . . . . . . . . . . 168
Unload Rail - Search form. . . . . . . . . . . . . . . . . . 166
Unload Rail - Validate form. . . . . . . . . . . . . . . . . . 167
Update damages recorded for a cargo lot. . . . . . 145
Update Hold/Permission form. . . . . . . . . . . . 81, 107
V
Vessel Load. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
Vessel UnLoad. . . . . . . . . . . . . . . . . . . . . . . . . . . 157
Vessel UnLoad - Validate form. . . . . . . . . . . . . . . 158
X
xpscacheCARGO001 (CARGO_XPS). . . . . . . . . . 41
Published: Monday, April 12, 2021 Navis N4 3.6.34: Cargo Manual Administrator and User Guide 196
Confidential -- Proprietary