Return Module - Undelivered Shipments

Document History

Version	Author	Reviewer/Approver	Date of Issue	Page / Section	Brief Description
1.0	Deema Z.	Asma L.	3rd Jan 2024	Return	Approved

Glossary

Term	Description
SLA	Service Level Agreement
Return Shipment	A return shipment is a shipment that couldn’t be delivered because it was either tried for delivery multiple times, has problems, or was rejected by the receiver. In such cases, receiver would be eligible for a refund.

1. Scan to Return

The user can scan the returned shipments and view their status in the system by navigating to the ‘Scan to Return’ screen under the Return module as follows:

1- Scan the shipment via the scanning machine.

2- The system will validate the return shipment SLA setting per branch:

A warning message appears if the user scans an invalid shipment.
A warning message appears if one of the return SLA’s is left empty.

3- The original shipment should meet the following SLA criteria, otherwise the system will show a validation message:

‘Number of Delivery Attempts’ SLA, otherwise, the shipment is to be sent for delivery again.
Shipment Value is greater than the ‘Return Customs Declared Value’ SLA, otherwise, the shipment is to be sent to scrap.

The holding Duration is Longer than the ‘Return Warehouse Holding Duration’ SLA, if not met, the shipment is to be stored until it meets the duration.

2. Returned Containers Management

The purpose of this feature is to manage the container and its related settings through the following functionalities:

2.1 View Returned Container

The user can view the defined returned containers in the system by navigating to the ‘Returned Container’ screen by choosing the Return module from the left navigation panel as follows:

Add new Container: the user can add a new container by referring to the “Add New Container” section.
Show per page: the user can select the number of items to show on each page.
·Actions: by clicking on this button the user can view specific container details by referring to View Container Details, edit returned container by referring to Edit Returned Container, or finalize by referring to Finalize Returned Container as follows:

Figure 3- Actions Related Returned Container

2.2 View Returned Container Details

The user can view the returned container details by navigating to the ‘Returned Container’ screen via the Return module and clicking on Details from Actions as follows:

Figure 4- View Returned Container Details

Edit: the user can edit the container information by clicking on the Edit button, if the container is finalized the user can’t edit container information.
Show per page: the user can select the number of items to show on each page.

2.3 Add New Container

The user can return shipments in another way in the system by navigating to the ‘Returned Container’ screen by choosing the Return module from the left navigation panel as follows:

General Information

Figure 5- Add Container- General Information

Origin: this field represents the container’s origin.
Origin Airport: this field represents the container's origin airport.
Destination: this field represents the containers’ final destination.
Destination Airport: this field represents the container's destination airport.
Client Reference: this field represents the reference number, if available, provided by the client to identify a container.
Container Type: this field represent the container’s type, by default, the type of container will be ‘return’.
Container Code: This field represents the container’s external code used for integration purposes.
Container Total Weight: this field represents the total weight of all shipments within a container.
Container Chargeable Weight: this field represents the weight measurement that is used by the customer to determine the value of the goods.
Truck Number: this field represents the number of the truck transporting the container.

Shipment

Is Customer Limited: when this is enabled, it provides the option to restrict the container to either a single customer or multiple customers. This requires shipments to undergo a validation process to ensure they are associated with one of the linked customers. If not enabled, no validation will be conducted when adding shipments to the containers.
Shipment AWB Numbers: this input field permits the user to input all the AWB numbers to be included in the container, with built-in validation to check that the shipment has not already been added to another container.

Show per page: the user can select the number of items to show on each page.

By clicking on “Save as a draft”, the system will save the container as a draft.

2.4 Edit Returned Container

The user can edit an existing returned container by clicking on Edit from Actions by navigating to the ‘Returned Container’ screen via the Return module as follows:

(if the container is finalized the user can’t edit container information)

General Information

Figure 7- Edit Container- General Information

Shipments

Show per page: the user can select the number of items to show on each page.

By clicking on Save as draft, the system saves any edit successfully as a draft.

2.5 Finalize Returned Container

The user can confirm the final information of the container by navigating to the ‘Returned Container’ screen via the Return module and selecting the Finalize action.

3. Returned Shipment Management

The purpose of this feature is to manage the returned shipments and their related settings through the following functionalities.

3.1 View Returned Shipments

The user can return Shipments in the system by navigating to the ‘Returned Shipment’ screen and choosing the Return module from the left navigation panel as follows:

Search: the user can search for the returned shipment by typing the AWB number in the search filter field.
Create Return Shipment: the user can add new return shipment by clicking on Create Return Shipment button.
Assign event: the user can assign events to returned shipments by referring to the Assign event section.
Show per page: the user can select the number of items to show on each page.
Actions: by clicking on this button the user can view specific returned shipment details by referring to View Returned Shipments Details, edit returned shipments by referring to Edit Returned Shipments, manage attachments by referring to Manage Attachments, or manage items by referring to Manage Items as follows:

Figure 10- Actions Related Shipments Management

Upload Fiels

The user can view the bulk shipment list in the system by navigating to the ‘Returned Shipment’ screen by choosing the Return module from the left navigation panel as follows:

Rows Per Page: the user can select the number of items to show on each page.
Assign event: by clicking on this button the user can assign events to the returned shipment.
Search: the user can search for the shipment by typing the file name in the search filter field.

Assign Event
General information

Figure 12- General Information- Assign event

On the general information page, the user assigns the event to the return shipment by filling in the related date for the event and the shipment.

Shipment

3.2 View Returned Shipments Details

The user can view the returned shipment details, shipment events, and attachments by navigating to the ‘Shipment’ screen via the Return module and clicking on Details from Actions as follows:

Figure 14- View Returned Shipments Details

Edit: the user can edit the shipment information if needed.
Print Label: the user can print the label for the shipment by clicking on print label button.
Add Item: the user can add items and move to the items list section.
Add Attachment: the user can add an attachment to the shipment information.
Edit History: the user can access the edit history, displaying details of the user who made the edit, the timestamp of the edit, and the type of edit performed.

Shipper & Consignee

Items

3.3 Create Return Shipment

The user can add a new returned shipment by navigating to the ‘Returned Shipment’ screen via the Return Module and clicking on Create Return Shipment as follows:

Shipper Name: this field represents the shipper’s name.
Shipping Date: this field represents the date and time the order was shipped from the origin to the destination.
Estimated delivery date: this field represents the date a shipment is expected to be delivered to the end user.
Product Type: this field represents the delivery service type e.g., Home Delivery, Office Delivery, Drop Off, etc.
Customs Declared Value: this field represents the shipment value to be declared to custom authorities.
Customer Name: this field represents the customer’s name related to the shipment.
Branch Name: this field represents the branch name related to the shipment.
Goods Description: this field represents a detailed description of the shipped goods.
COD Amount: this field represents the amount to be collected on delivery from the consignee.
COD Currency: this field represents the currency of the COD amount value.
Duty Handling: this field represents the customs handling charge (Delivery Duty Paid / Unpaid).
Supplier Code: this field represents the special code for the supplier.
Airwaybill Number: this field represents the unique number of shipments.
Number of Pieces: this field represents the number of items within the shipment.
Length: this field represents the shipment’s length.
Width: this field represents the shipment’s width.
Height: this field represents the shipment’s height.
Dimension Unit: this field represents the unit for shipment (CM: centimeter, M: Meter)
Value: this field represents the goods value.
Unit of Measure: this field represents the unit used to quantify the size of the goods being shipped in kilograms (KG) or pounds (LB).

Shipper Details

Address line (1): this field represents the shipper’s address.
Country: this field represents the shipper’s country.
City: this field represents the shipper’s city.
Postal Code: this field represents a series of letters and numbers appended to the postal address to sort and classify mail.
Longitude: this field represents the address longitude to locate a location.
Latitude: this field represents the address latitude to locate a location.
Contact Person Name: this field represents the consignee’s name.
Email Address: this field represents the shipper’s email address.
Phone Number (1): this field represents the shipper’s main phone number.
Phone Number (2): this field represents the shipper’s secondary phone number.
Shipper Reference: this field represents any reference number or text added by the shipper.

Consignee Details

Address Line (1): this field represents the consignee’s main address.
Address Line (2): this field represents the consignee’s secondary address.
Country: this field represents the consignee’s country.
City: this field represents the consignee’s city.
Postal Post: this field represents a series of letters and numbers appended to the postal address to sort and classify mail.
District: this field represents a location, area, or region linked to the address provided.
Longitude: this field represents the address longitude to locate a location.
Latitude: this field represents the address latitude to locate a location.
Contact person Name: this field represents the consignee’s name bound to receive the shipment.
Email Address: this field represents the consignee’s email address.
Phone Number (1): this field represents the consignee’s main phone number.
Phone Number (2): this field represents the consignee’s secondary phone number.
Company Name: this field represents the company name of the consignee.
Type: this field represents the address type e.g., Residential, Industrial, or office location.
Civil Id: this field represents the consignee’s national id number.

By clicking on Save, the system adds new return shipment information successfully.

3.4 Edit Returned Shipments

The user can edit the returned shipment information by clicking on Edit from Actions by navigating to the ‘Return Shipment’ screen via the Return module as follows:

By clicking on Save, the system updates the information under the respective shipment successfully.

Edit Shipper

Edit Consignee

By clicking on Save, the system updates the consignee’s information successfully.

3.5 Manage Attachment

The user can add an attachment to the shipment by clicking on ‘Manage Attachments’ from “Actions” by navigating to the ‘Shipment’ screen the via Return module as follows:

Upload Document: this field represents the document name.

By clicking on Save, the system will add the selected attachments to be linked to the respective shipment.

By clicking on Download, the system downloads the attachment file successfully.

3.6 Manage Items

The user can add the item to the shipment by navigating to the ‘Manage Item’ screen from Actions via the Return module as follows:

Goods Description: this field represents the item’s general description.
HS Code: this field represents the stands for Harmonized System Code, and it is an internationally standardized system of names and numbers used to classify traded products.
Country of Origin: this field represents the item’s country of origin.
Quantity: this field represents the item’s quantity.
Currency: this field represents the currency of the item amount.
Amount: this field represents the item’s amount.
Unit of Measure: this field represents the unit used to quantify the size of the goods being shipped in kilograms (KG) or pounds (LB).
Actual Weight: this field represents the item’s actual weight value.
Rows Per Page: the user can select the number of items to show on each page.

By clicking on Add item, the added item moves to the items list section.

By clicking on Save, the system adds an added item to the shipment successfully.