Message Mapping
User Data Dictionary
PRODIS - Message Rules
- The valid Message Function Codes for a PRODIS are:
- Original (9)
- Change (4)
- Withdraw (50)
- PRODIS messages must quote a unique Sender Reference. The ICS will use this number and the associated Sender Reference Version Number to ensure duplicate messages are not processed.
- The version number for an Original (9) message must be set at 1 or greater.
- Before the PRODIS message is processed at the application level:
- All non significant leading and trailing blanks will be stripped;
- Multiple spaces will be compressed;
- Illegal characters will be removed; and
- All nulls will be converted to blanks.
- Any errors in a PRODIS message will be reported in a PRODIS Response message (PRODISR).
- Any advice messages resulting from the PRODIS message will be reported in a PRODIS Response message (PRODISR).
- The maximum number of errors and advices than can be reported will be 50. No further errors or advices will be processed once the maximum number allowed for PRODISR has been reached.
- A Change to a PRODIS will be rejected if there is no difference between the Original and the Change PRODIS.
- Each Change PRODIS message will be considered to be a new version of the message. For each version of a message the senders reference version number must be unique and incremented from the previous version.
- Change or Withdraw PRODIS messages for which no original exist will be rejected by the ICS.
- The Withdrawal of a PRODIS is for the entire record.
- Once a Progressive Discharge Report has been created, amended or withdrawn on line through the ICS Interactive Facility, future processing via EDI will not be permitted.
- Where the Message Function Code is 9 (Original) , the valid Line Action Code is I (Insert).
- Where the Message Function Code is 4 (Change) and the Line Action Code is populated, the valid codes are I (Insert), A (Amend) or D (Delete).
- To insert a new line to an existing record, the Message Function Code is 4 (Change) and the Line Action Code is I (Insert).
- To amend unprotected header details, the Message Function Code is 4 (Change) and the Line Action Code is not populated.
- To amend a line record, the Message Function Code is 4 (Change) and the Line Action Code is A (Amend).
- To delete a line record, the Message Function Code is 4 (Change) and the Line Action Code is D (Delete).
PRODIS Processing Rules
- The PRODIS is sent by Stevedores to report containers discharged from a vessel.
- The containers discharged are reported in incremental blocks every 3 hours until all containers have been discharged from the vessel (unless no discharge for a three hour period).
- A PRODIS will be linked to a Sea Actual Arrival Report (SEAAAR) by the:
- Vessel Identifier
- Voyage Number
- CTO Establishment ID
- The PRODIS will be linked to the Sea Cargo Report (PRODIS) and Cargo Line List (CARLST) by the:
- Vessel Identifier
- Vessel Number
- Discharge Port Code
- Container Number
- The Report Identifier for a PRODIS is a concatenation of the:
- Vessel Identifier;
- Vessel Number;
- Stevedore Establishment ID.
The PRODIS is also used to acquit an approved Underbond request where cargo has been discharged off a vessel that has been used as the Movement Vessel for the purposes of an Underbond by Sea move.
PRODIS Line | Cargo Movement Type. |
---|
Vessel Identifier | Under bond by Sea Movement Vessel Identifier |
Voyage Number | Under bond by Sea Movement Vessel Voyage Number |
CTO Establishment ID | Destination Premise |
Container Number | Container Number |
- The Line Identifier for a PRODIS is the Container Number.
- When container discharges from a single vessel / voyage occur at multiple berths within the same stevedore establishment, they can be reported on a single PRODIS.
- A PRODIS is required from each stevedore establishment when container discharges occur at multiple stevedore establishments within the same port, from a single vessel.
- Response Types
- The PRODIS Line cannot be linked to a Sea Cargo Report Line AND PRODIS Line cannot be linked to a Cargo List Line AND NOT Underbond by Sea then log exception as Surplus.
- Where a PRODIS Line has been previously linked to either a Sea Cargo Report or Cargo List Line AND PRODIS Line is deleted then log exception as Shortage.
- The PRODIS Line can be linked to a Sea Cargo Report Line OR Cargo List AND PRODIS Line Restow Indicator is set to Y then log exception as Shortage.
- The PRODIS Line can be linked to a Sea Cargo Report Line AND Cargo Report Line then Transit Cargo indicator is set to Y.
- The ICS will provide the user with advice when:
- Containers are not reported every 3 hours from the time the first container is discharged from the ship
- The receipt Date and Time of the message is more than 3 hours after the Date and Time of the first container discharge
- Date and Time of last container discharged must be reported when the vessel has completed discharging.
Data Dependency Tables
A Progressive Discharge Report Message can be Created, Changed or Withdrawn. The mechanism for carrying out these transactions utilises Message Function Code. The Message Function Code is a document level transaction indicator that is applied to the document.
Message Function Code | Action |
---|
ORIGINAL (9) | A new Progressive Discharge Report with a unique sender's reference. |
CHANGE (4) | A full Progressive Discharge Report containing changes to attributes excluding attributes contained within the unique business identifier. |
WITHDRAW (50) | A withdrawal of an existing Progressive Discharge Report. |
Data Dependency Table for Original and Change
The following table models the data elements of the Progressive Discharge Report Document where the document is considered an "Original" or a "Change".
Data Element | ICS Business Requirement | ICS Business Rule |
---|
Document Name | Mandatory | Code is PRODIS |
Sender Reference | Mandatory | |
Sender Reference Version | Mandatory | |
Message Function Code | Mandatory | See Message Function Code table above. |
Voyage Number | Mandatory | The Voyage Number must be the Principal Agent's Voyage Number. |
Vessel Id | Mandatory | |
CTO Establishment Id | Mandatory | |
Date of First Container Discharge | Conditional | Universal Co-ordinated Time (UTC) in the format CCYYMMDD. |
Time of First Container Discharge | Conditional | Universal Co-ordinated Time (UTC) in the format HHMM. |
Date of Last Container Discharge | Optional | Universal Co-ordinated Time (UTC) in the format CCYYMMDD. Only required when the vessel has completely discharged. |
Time of Last Container Discharge | Optional | Universal Co-ordinated Time (UTC) in the format HHMM. Only required when the vessel has completely discharged. |
Line Action Code | Mandatory | Valid Line Action codes are: - I (Insert)
- A (Amend)
- D (Delete)
|
Container Number | Mandatory | |
Restow Indicator | Optional | Valid Restow Indicator codes are: - Y (Goods Restowed)
- N (Goods not Restowed)
|
Container Responsible Party Id | Conditional | Not required if the Line Action Code is D (Delete). |
Data Dependency Table for Withdrawal
The following table models the data elements of the Progressive Discharge Report Document where the document is considered a "Withdraw".
Data Element | ICS Business Requirement | ICS Business Rule |
---|
Document Name | Mandatory | Code is PRODIS |
Sender Reference | Mandatory | |
Sender Reference Version | Mandatory | |
Message Function Code | Mandatory | See Message Function Code table above. |
Voyage Number | Mandatory | The Voyage Number must be the Principal Agent's Voyage Number. |
Vessel Identifier | Mandatory | |
CTO Establishment ID | Mandatory | |
NOTE: for further details in relation to a Business Term, refer to the User Data Dictionary.
V 2.3 5 DEC 2004