Manage Shipments

Locate Shipment list

  • Barge Shipments are listed on Tasks > Shipment tab
1916

Shipment Information Fields

General Shipment information fields

  • The general information of a Shipment is present on the tab Shipments (Web form) and the sheet Shipments (Excel template)
Information fieldDescription
Shipment Code
(Web form + Excel template)
(Required)
Management code assigned to the Shipment being created
Format: Must not contain spaces
For example: "Shipment 01" is not acceptable; "Shipment_01" is acceptable
Itinerary Code
(Web form + Excel template)
(Required)
Itinerary Code of the Shipment being created
Format: Must not contain spaces
For example: "Itinerary 01" is invalid; "Itinerary_01" is valid
Leg Position
(Web form + Excel template)
(Required)
Numerical order of the itinerary leg of the Shipment being created
Format: Number only. The minimum value is 0. The maximum value is 9
Note: For a shipments will all new containers (Containers that have never been in any previous shipment), the leg position of all containers must be 0 in order for them to display on the Mobile app, so that the driver can see and request
Shipment Mode
(Web form + Excel template)
(Required)
Mode of transport used for the shipment being created
For shipments of Sea barge model, the shipment mode is Barge
Shipment Order Type
(Web form + Excel template)
(Required)
Order type of the shipment being created
There are two types:
INTERNAL: Shipments between your organization's Inland Container Depots (ICD)
EXTERNAL: Shipments from your organization's Inland Container Depots to external locations
Shipment Type
(Web form + Excel template)
(Required)
Type of the shipment being created
If the Order Type of the Shipment being created is INTERNAL, there are three shipment type options:
DUMMY: The shipment type in which the barge will pick up containers at one or more locations
ACTUAL: The shipment type in which the barge will drop off containers at one or more locations
NFR (Non-freight related): The shipment type in which the barge will travel from one location to another location without loading any container
If the Order Type of the Shipment being created is EXTERNAL, there are two shipment type options:
ACTUAL: The shipment type in which the barge will both pick up containers at one or more locations and then drop off containers at one or more other locations
NFR (Non-freight related): Same as above
Transaction Type
(Web form + Excel template)
(Required)
Transaction Type of the shipment being created
There are seven transaction types:
IMPORT
EXPORT
DOMESTIC
EXPORT - IMPORT
DOMESTIC - EXPORT
DOMESTIC - IMPORT
DOMESTIC - EXPORT - IMPORT
Vehicle
(Web form + Excel template)
(Required)
Vehicle Code of the barge that will perform the shipment being created
Stuffing Date
(Web form + Excel template)
(Required)
The official due date to stuff goods to the containers of the shipment being created
Cut-off Date
(Web form + Excel template)
(Required)
The latest possible date the containers of the shipment may be delivered to a terminal for loading to a ship
Late Delivery Time
(Web form + Excel template)
(Required)
The date and time at which the shipment being created will be considered late to start
Shipment Note
(Web form + Excel template)
(Optional)
A specific note about the shipment being created
Origin Customer Code
(Web form + Excel template)
(Required)
Code of the location where the shipment being created originally departs
Destination Customer Code
(Web form + Excel template)
(Required)
Code of the location where the shipment being created ultimately arrives

Shipment Stops information fields

  • These information fields are present on the tab Stops (Web form) and the sheet Stops (Excel template)
Information fieldDescription
Shipment Code
(Web form + Excel template)
(Required)
Management code assigned to the Shipment being created
Shipment Stop Index
(Web form + Excel template)
(Required)
Numerical code of the shipment stop being created
Location (Web form); Shipment Stop Location Code (Excel template)
(Required)
Location code of the shipment stop being created
Task Group (Web form); Task Group Code (Excel template)
(Required)
This information fields is used only for Freight transport - Road model
The task group to be performed at the shipment stop being created
Shipment Stop Type
(Web form + Excel template)
(Required)
Type of the shipment stop being created
There are two types: Pick stop and Drop stop
Estimated Time Arrival
(Web form + Excel template)
(Required)
Estimated Time of Arrival at the shipment stop being created
Planned Time Arrival
(Web form + Excel template)
(Required)
Planned Time of Arrival at the shipment stop being created
Estimated Time Departure
(Web form + Excel template)
(Required)
Estimated Time of Departure from the shipment stop being created
Planned Time Departure
(Web form + Excel template)
(Required)
Planned Time of Departure from the shipment stop being created

Shipment Containers information fields

  • These information fields are present on the tab Containers (Web form) and the sheet Containers (Excel template)
Information fieldDescription
Shipment Code
(Excel template)
(Required)
Management code assigned to the Shipment being created
Stop Index (Web form); Shipment Stop Index (Excel template)
(Required)
Numerical code of the shipment stop
Container Number
(Web form + Excel template)
(Required)
Numbers printed on the door of the container
Seal Number
(Web form + Excel template)
(Optional)
The numbers printed on the seal lock of the container
Leg Position
Booking Number
(Web form + Excel template)
(Required)
Booking Number of the container included in the shipment being created
Shipping Line
(Web form + Excel template)
(Optional)
Code of the shipping line company that will transport the container
Customer
(Web form + Excel template)
(Required)
Ultimate customer of the container
Container Status
(Web form + Excel template)
(Required)
Most recent status of the container at the time the shipment is created
Container Type
(Web form + Excel template)
(Required)
Type of the container
Vessel
(Web form + Excel template)
(Optional)
Code of the vessel that will transport the container
Voyage ID
(Web form + Excel template)
(Optional)
Code of the voyage that will transport the container
Pick Location
(Web form + Excel template)
(Required)
Code of the location from where the container is picked up
Drop Location
(Web form + Excel template)
(Required)
Code of the location to where the container will be dropped off
IMO Class
(Web form + Excel template)
(Optional)
IMO Class of the container
There are two classes:
Dangerous goods: FXIX
Oversize goods: FXXO
Temperature
(Web form + Excel template)
(Optional)
Temperature of the container
Tare Weight
(Web form + Excel template)
(Required)
Weight of the container without loading any goods
Gross Weight
(Web form + Excel template)
(Required)
Maximum goods weight that the container can carry
VGM
(Web form + Excel template)
(Required)
Short for Verified Gross Mass - The verified weight of the cargo plus the tare weight of the container
Note
(Web form + Excel template)
(Optional)
A short note about the container

Create shipments

  • There are two methods to create shipment: Using Web form and using Excel template

Create shipments using Web form

  • Please refer to the CRUD functions article to know the general steps about creating single object using Web form
  • Below is the input instruction for each information field on Web form

1. Tab Shipments

  • First, you have to click on Shipment Mode field, select the value BARGE from the drop down menu
1494
  • Then, input in other information fields
  • Below are some notes when creating/assign Shipments
Barge assignment rules
  • When the dispatchers try to assign a Shipment to a particular barge, the system will validate some rules
  • The general rules are:
  • 1 - With nonempty Shipments (Dummy, Internal and External Actual Shipments), at any particular time point, the barge can only be assigned a maximum of one ongoing Shipment (Shipment currently being performed) and one pending Shipment (Shipment waiting to be performed)
  • 2 - With empty Shipments (Non-freight Related, or NFR Shipments), you can assign a NFR Shipment to a barge right after its corresponding Actual Shipment has been assigned to that barge
Dummy Shipments
  • If the barge is currently not performing any Shipment, then you can assign a new Dummy Shipment to that barge
  • You can not assign a new Dummy Shipment to a barge if that barge is still performing another Dummy Shipment. Only after the preceding Dummy Shipment has been completed the new one can be assigned
  • You can not assign a new Dummy Shipment to a barge if that barge has already been assigned an External Actual Shipment, and the barge captain has yet to submit tasks of that External Actual Shipment on Mobile app
Internal Actual Shipments
  • You can assign a new Internal Actual Shipment to a barge even if the barge is still performing, hasn't yet completed an External Actual Shipment
External Actual Shipments
  • You can not assign a new External Actual Shipment to a barge if that barge has a completed Dummy Shipment that has not been linked with an Internal Actual Shipment
  • You can not assign a new External Actual Shipment to a barge if that barge has already been assigned an External Actual Shipment, and the barge captain has yet to submit tasks of the preceding External Actual Shipment on Mobile app
Non-freight Related (NFR) Shipments
  • At any particular time point, a barge can be concurrently assigned one Internal NFR Shipment and one Eternal NFR Shipment

2. Tab Stops

  • After you have input all necessary information on tab Shipments, navigate to tab Stops
  • On this tab, you have to add the Shipment Stops to the Shipment being created. Start by clicking on Location field, input either the name or code of the appropriate location into the search bar, then select from the drop down menu
  • The names and codes of the locations can be found under Customer Code and Customer Name columns in Partners > Customer List tab
  • Next, click on Stop Type field, select the appropriate stop type from the drop down menu
  • Then, click on Add Stop button to add the stop to the shipment
  • The stop will appear in the stop list below
  • Repeat these steps for other stops
1912
  • In the stop list, you have to specify the Estimated Time Arrival; Planned Time Arrival; Estimated Time Departure; Planned Time Departure for each stop. To do that, click on the calendar icon of each corresponding information field, then select the appropriate date/hour/minute/second from the drop down calendars
1518
  • If you accidentally add the wrong stop, you can remove it by clicking on trash bin icon under Action column
1480

3. Tab Containers

  • After you have added all stops of the shipment in tab Stops, let's navigate to tab Containers to add containers to the shipment
  • First, click on Stop Index field. The drop down menu will list all available Pick Stops that you have added earlier, along with their numerical order. Select the appropriate Pick Stop from the list
  • Next, input container number into Container Number field. Then, click on Add Container button. Repeat these steps for other containers
  • The containers will appear in the container list below. You then need to input information for each container

🚧

Container number format

  • You can input freely into Container Number field. However, only containers that have their numbers written correctly in ISO standard (for example CSQU3054383) will show up on Mobile app
1912

Adding container to Shipment

  • If you accidentally add the wrong container, you can remove it by clicking on trash bin icon under Action column
1494
  • Finally, click on the button Create to finish creating the shipment
1495

Create shipments using Excel template

  • Please refer to the CRUD functions article to know the general steps about creating single object using web form
  • Below is the input instruction for each information field in the Excel template

Sheet Shipments

2.1. Shipment Mode
  • First, you have to input the following value into Shipment Mode cell (Note: All letters must be uppercase): BARGE
2.2. Shipment Type
  • Input only one appropriate value from the following three values into this cell (Note: All letters must be uppercase): ACTUAL; DUMMY; NFR
2.3. Transaction Type
  • Input only one appropriate value from the following seven values in the table below into this cell
Value on Web formCorresponding value in Excel template
IMPORTI
EXPORTE
DOMESTICD
EXPORT - IMPORTE,I
DOMESTIC - IMPORTD,I
DOMESTIC - EXPORTD,E
DOMESTIC - EXPORT - IMPORTD,E,I
2.4. Shipment Order Type
  • If the shipment order type of the shipment is internal, input the following value into this cell (Note: All letters must be uppercase): INTERNAL
  • If the shipment order type of the shipment is external, input the following value into this cell (Note: All letters must be uppercase): EXTERNAL
2.5. Vehicle
  • Copy the Vehicle Code of the appropriate barge on Web app, then paste into this cell
  • The Vehicle Code can be found under Vehicle Code column in Transportation > Vehicle List tab
2.6. Origin Customer Code; Destination Customer Code
  • Copy the Customer Codes of the appropriate customers on Web app, then paste into these cells
  • The Customer Codes can be found under Customer Code column in Partners > Customer List tab
1902
2.7. Itinerary Code
  • Input the corresponding itinerary code of the shipment into this cell
112
2.8. Leg Index
  • Input the corresponding Leg index of the shipment into this cell
110
2.9. Shipment Mode
  • Always input the following value into this cell: BARGE
2.10. Shipment Type
  • Input the following value into this cell if the shipment being created is a Dummy shipment: DUMMY
  • Input the following value into this cell if the shipment being created is an Actual shipment: ACTUAL
141
2.11. Transaction Type
  • Input only one of the following six values from the below table into this cell
Value on Web formCorresponding value in Excel template
IMPORTI
EXPORTE
DOMESTICD
EXPORT - IMPORTE,I
DOMESTIC - IMPORTD,I
DOMESTIC - EXPORTD,E
DOMESTIC - EXPORT - IMPORTD,E,I
2.12. Vehicle
  • Copy the Vehicle Code of the barge on Web app, then paste into this cell
  • The Vehicle Code can be found under Vehicle Code column in Transportation > Vehicle List tab
1905
2.13. Trailer
  • This information field is only used for Freight transport - Road model. Just leave this cell blank
2.14. Stuffing Date; Cut-off Date; Late Delivery Time
  • These dates must be input in the following format: dd/mm/yyyy hh:mm
  • For example: 20/11/2019 12:30
2.15. Shipment Note
  • Format: Free-form

Sheet Stop

2.16. Shipment Code
  • Same as instructed above
2.17. Shipment Stop Index
  • Input the corresponding numerical order of the shipment stop into this cell
  • For example: 1; 2; 3 and so on
2.18. Shipment Stop Location Code
  • Copy the Customer Codes of the corresponding locations on Web app, then paste into these cells
  • The Customer Codes can be found under Customer Code column in Partners > Customer List tab
1897
2.19. Task Group Code
  • This information field is only used for Freight transport - Road model. Just leave this cell blank
2.20. Shipment Stop Type
  • If the stop is a Pick stop, input the following value into this cell: P
  • If the stop is a Drop stop, input the following value into this cell: D
168
2.21. Estimated Time Arrival; Planned Time Arrival; Estimated Time Departure; Planned Time Departure
  • These dates must be input in the following format: dd/mm/yyyy hh:mm
  • For example: 18/11/2019 08:30
859

Sheet Container

2.22. Shipment Code
  • Same as instructed above
2.23. Shipment Stop Index
  • Same as instructed above
2.24. Container Number
  • Input the numbers of the container into this cell
  • For example: TKRU426221
2.25. Booking Number
  • Input the Booking Number that comes with the container into this cell
  • For example: 403772CHLTB
2.26. Seal Number
  • Input the numbers of the seal lock of the container into this cell
  • For example: ES2633201
2.27. Shipping Line
  • Input the code of the shipping line into this cell
  • For example: OCL_LN
2.28. Customer; Pick Location; Drop Location
  • Copy the Customer Codes of the corresponding locations on Web app, then paste into these cells
  • The Customer Codes can be found under Customer Code column in Partners > Customer List tab
1901
2.29. Container Status
  • If the container has goods inside, input the following value into this cell: F
  • If the container is an empty container, doesn't have goods inside, input the following value into this cell: E
140
2.30. Container Type
  • Copy the suitable container type code on Web app, then paste into this cell
  • The container type code can be found under Container Type Code column in Freights > Container Types tab
1902
2.31. Vessel
  • Input the code of the shipping vessel into this cell
  • For example: EMPT; ATE; LGB etc.
2.32. Voyage ID
  • Input the code of the voyage into this cell
2.33. IMO Class
  • Input the following value into this cell if the container contains dangerous goods: FXIX
  • Input the following value into this cell if the container contains oversize goods: FXXO
  • If the container neither contains neither dangerous nor oversize goods, leave this cell blank
99
2.34. Temperature
  • Input the corresponding temperature of the container (In degree Celsius)
  • For example: 2; 4; -20 etc.
2.35. Tare Weight; Gross Weight; VGM
  • Input the corresponding weights (In kilogram) into these cells
  • For example: 2500; 3000; 33000 etc.
2.36. Note
  • Format: Free-form

🚧

Rule about creating Dummy shipment

For a barge, the previous assigned Dummy shipment has to be completed before the next assigned Dummy shipment can be created

Edit shipments

  • To edit a Shipment, click on Edit icon of that Shipment. You might need to use the horizontal scrollbar to scroll to the end of the Shipment list to see this icon
1694

Delete shipments

  • To delete a Shipment, click on Delete icon of that Shipment. You might need to use the horizontal scrollbar to scroll to the end of the Shipment list to see this icon
1694