UG:Air Status USER GUIDE

From UG

(Difference between revisions)

Current revision as of 19:49, 28 December 2011

[edit] Intro

Descartes (Jaguar partner) is offering Automated Air Status Update Service

This service allows airfreight shipments booked directly by Jaguar with the airlines, to be fed automatic status updates (departure and arrival dates), removing our need to manually check and then update the status of Airfreight shipments.

It is our understanding that in order to send updates Descartes needs to receive only MAWB number.

[edit] Logic & Conditions for Status Updates to be sent & received

Airline must participate in air status messaging. The list of current, participating airlines can be found under the Admin Menu > Air Status/EUAN Admin See #FSR Airlines Tab.

All status messages being sent to the airlines and received from airlines are to be recorded on the Systems Log.

NOTE: If any of the following airports - departure, transshipment or destination - that's set in the CT record and/or it's master record does not exist to airline, the message we send will be ignored by airline and no updates will be received. As well, if the departure, transshipment or destination airports that's set in the CT record and/or it's master record does not match the airlines message we receive, the message will be ignored and the record will not be automatically updated.

[edit] Mandatory Fields

The following needs to be filled in order to send & receive automatic updates:

Airline Name
MAWB Number(all 11 digits)
Airport of Departure Name
Estimated Departure Date

NOTE: Once the above mandatory fields are set in the CT record and/or the Master record, a message will automatically be created (in the background) and sent to the airline requesting the status information according to the MAWB #. It does not require any manual transmission on operators part. Once the airline confirms the departure, a message will be received (in the background) and then the CT record and/or the Master record will update accordingly.

[edit] Optional Fields

The following fields are optional but if/when they are filled messages will be sent out and automatic updates will be received:

Airport of Transshipment name
Airport of Transshipment Estimated Departure Date

[edit] Air Status Admin

[edit] Air Status and EU Advance Notice are currently shared in the Admin section of CT

Both the EU Advance notice and the Air Status Updates are shared inside the admin menu because it is Descartes who provides these 2 services to JFS and both are related to airfreight. Note the second & third tabs are related directly to Air Status.

[edit] Parameter Tab

This is where we manage the messages that's being sent and received. It includes the time parameters that we use, for how often the system is to send the messages to the airline and how often the system is to check for new messages being received. As well it includes the server information that is used for passing these electronic messages.

[edit] FSR Airlines Tab

Here is where the current list of participating airlines can be found. The left panel contains the current list of airlines that participate and/or are in testing phase for automatic updates and the right panel contains the current list of airlines that are setup in CyberTrax for Air Status messaging.

[edit] FWB FHL Airlines Tab

This tab is not applicable and is not currently being used. Originally it was created for the airlines that do not participate in the air status and/or EUAN messaging, but would participate in other types of messaging. It was found that such a case does not exist and this tab will most likely be removed from this menu at a later date.

[edit] Logging of sent & received Air Status Messages

Currently all requests sent to the airline are being recorded under our CT Systems Log.

[edit] Systems Log

Once there, expand menu item 'Anywhere and select Air Status/EUAN. You also have search options which can be set by date and/or by the CT # inside of the text box "Component description contains:" Then select Show Log

[edit] Logging of FSR Message

FSR stands for Flight Status Request. Our system send a request for this information to the airline starting 24 hours prior to the set estimated departure and will continue to send a request every hour until the actual departure is received.

[edit] Logging of FSA Message

FSA stands for Flight Status Answer. Once the FSR is sent for an MAWB #, our system awaits the airline's replies/confirmation of the departure date and/or arrival date and upon receipt, these date fields will be recorded here and automatically update the CT & its Master record accordingly.

[edit] History

[edit] Ver 1

See above

[edit] See Also

Link to CT2 User Guide: Category:Support
Link to spec: Air Status EDI

@@ Line 9: / Line 9: @@
 It is our understanding that in order to send updates Descartes needs to receive only MAWB number.
-== Hard coded or Hidden conditions ==
+== Logic & Conditions for Status Updates to be sent & received ==
+* Airline must participate in air status messaging.  The list of current, participating airlines can be found under the Admin Menu > Air Status/EUAN Admin  See [[#FSR Airlines Tab]].
+* All status messages being sent to the airlines and received from airlines are to be recorded on the Systems Log.
-== Business Processes ==
+'''NOTE:''' If any of the following airports - departure, transshipment or destination - that's set in the CT record and/or it's master record does not exist to airline, the message we send will be ignored by airline and no updates will be received. As well, if the departure, transshipment or destination airports that's set in the CT record and/or it's master record does not match the airlines message we receive, the message will be ignored and the record will not be automatically updated.
-=== For 1 CT record booked on a direct flight ===
+=== Mandatory Fields ===
-For shipments that are booked on a direct flight the incoming messages should update the following fields in CT.
+The following needs to be filled in order to send & receive automatic updates:
-* Airport Of Departure Actual Date -
+* Airline Name
-          o shipment should confirm the airport of departure is correct, by comparing the destination
+* MAWB Number(all 11 digits)
-            airport listed on the incoming message to the CT#Airport Of Departure
+* Airport of Departure Name
+* Estimated Departure Date
-* Airport Of Destination Actual Date-
+'''NOTE:''' Once the above mandatory fields are set in the CT record and/or the Master record, a message will automatically be created (in the background) and sent to the airline requesting the status information according to the MAWB #.  It does not require any manual transmission on operators part.  Once the airline confirms the departure, a message will be received (in the background) and then the CT record and/or the Master record will update accordingly.
-          o shipment should confirm the airport of departure is correct, by comparing the destination
-            airport listed on the incoming message to the CT#Airport Of Destination
-=== Transshipment airports ===
+=== Optional Fields ===
-It is possible to have more than one transhipment airport.
+The following fields are optional but if/when they are filled messages will be sent out and automatic updates will be received:
-We assume that Descartes can send meaningful updates to accommodate that case.
+* Airport of Transshipment name
+* Airport of Transshipment Estimated Departure Date
-In the event of more than one trans shipment airport, the system should only update the CT#Trans Shipment port listed in the CT record. Once the incoming message received showing the indicated or matching trans ship port arrival, the the CT#Trans Shipment Actual Date should be updated.
+== Air Status Admin ==
-Any departure or destination airports indicated in incoming messages that do not exist or match the CT record should be ignored. This will be addressed in Phase 2.
+=== Air Status and EU Advance Notice are currently shared in the Admin section of CT ===
-=== Split case ===
+[[File:Admin Air Status EUAN Admin.JPG]]
-In this case airline might call and say that X plts/pcs/etc will be placed on Flight F1.
+Both the EU Advance notice and the Air Status Updates are shared inside the admin menu because it is Descartes who provides these 2 services to JFS and both are related to airfreight.  '''Note''' the second & third tabs are related directly to Air Status.
-Later airline might call and say that Y plts/pcs/etc will be placed on Flight F2.
+=== Parameter Tab ===
-Later airline might call and say that remaining plts/pcs/etc will be placed on Flight F3.
+This is where we manage the messages that's being sent and received.  It includes the time parameters that we use, for how often the system is to send the messages to the airline and how often the system is to check for new messages being received.  As well it includes the server information that is used for passing these electronic messages.
-It could be split 2,3,4, ... times. - Keeping a record of this updates will be TBD for Phase 2
+[[File:Parameters Tab.JPG]]
+=== FSR Airlines Tab ===
-We assume that Descartes can send meaningful updates to accommodate that case. CT2 should be re-designed to support that.
+Here is where the current list of participating airlines can be found.  The left panel contains the current list of airlines that participate and/or are in testing phase for automatic updates and the right panel contains the current list of airlines that are setup in CyberTrax for Air Status messaging.
-The CT should update the CT#Airport Of Departure Actual Date when the first piece has departed and update when the last piece departs and the CT#Airport Of Destination Actual Date when the first piece arrives and updated when the last piece updates.
+[[File:FSR Airlines Tab.JPG]]
-A comment should be posted showing the following updates as a notification on the above.
+=== FWB FHL Airlines Tab ===
-*
+<font color="red" size="3"> This tab is not applicable and is not currently being used. Originally it was created for the airlines that do not participate in the air status and/or EUAN messaging, but would participate in other types of messaging.  It was found that such a case does not exist and this tab will most likely be removed from this menu at a later date. </font>
-          o SPLIT SHIPMENT - First part has departed
-          o SPLIT SHIPMENT - Last part has departed
-          o SPLIT SHIPMENT - First part has arrived
-          o SPLIT SHIPMENT - Last part has arrived
-The system will need to keep a count after the first departure, until the CT#Grand Total: Loose Pkgs or CT#Grand Total: Pkgs On Plts total matches, to accurately update the first and last parts. All other departures or arrivals should be ignored. This will be addressed in Phase 2
+[[File:Air Status FWB FHL Airlines.JPG]]
-=== Delays ===
+== Logging of sent & received Air Status Messages ==
-In the event that a shipment is removed from the original flight or the original flight is delayed.
+Currently all requests sent to the airline are being recorded under our CT Systems Log.
-Airport Of Departure Estimated Date field should be updated to reflect the corrected information.
+=== Systems Log ===
-Airport Of Destination Estimated Date field should be updated to reflect the corrected information.
+Once there, expand menu item '''Anywhere'' and select Air Status/EUAN.  You also have search options which can be set by date and/or by the CT # inside of the text box "Component description contains:"  Then select Show Log
-=== Phase Two Business Requirements For UC2 & 3 ===
+[[File:Log with comments how to.JPG]]
-Additional requirements TBD
+=== Logging of FSR Message ===
-=== Transshipment airports ===
+FSR stands for '''F'''light '''S'''tatus '''R'''equest.  Our system send a request for this information to the airline starting 24 hours prior to the set estimated departure and will continue to send a request every hour until the actual departure is received.
-It is possible to have more than one transhipment airport.
+[[File:FSR.JPG]]
-We assume that Descartes can send meaningful updates to accommodate that case.
+=== Logging of FSA Message ===
-CT2 should be re-designed to support that.
+FSA stands for '''F'''light '''S'''tatus '''A'''nswer.  Once the FSR is sent for an MAWB #, our system awaits the airline's replies/confirmation of the departure date and/or arrival date and upon receipt, these date fields will be recorded here and automatically update the CT & its Master record accordingly.
-=== Split case ===
+[[File:FSA.JPG]]
-In this case airline might call and say that X plts/pcs/etc will be placed on Flight F1.
+== History ==
-Later airline might call and say that Y plts/pcs/etc will be placed on Flight F2.
+=== Ver 1 ===
+See above
-Later airline might call and say that remaining plts/pcs/etc will be placed on Flight F3.
+== See Also ==
-It could be split 2,3,4, ... times.
+* '''Link to CT2 User Guide:''' [[:Category:Support]]
+* Link to spec: [[Air Status EDI]]
-We assume that Descartes can send meaningful updates to accommodate that case. CT2 should be re-designed to support that.
-== Filters ==