SPL Shipping Engine

## Sections
• [Get Started](https://developers.gnteq.app/get-started.md): This Application Programming Interface (API) document is aimed at helping you connect your software & online services to SPL’s shipping & tracking platform. By using these APIs, you will be able to get the information that you need to get started with the integration.
• [Security](https://developers.gnteq.app/security.md): We take data privacy and security seriously and ensure that any information collected through the integration are compliant with regional and global security regulations. During the integration, we implement the right set of security tools to safeguard information being transmitted between system for which 2 levels of security means are used for each method : 1- Authorizing Requests : during this cycle, each submitted request will be validated based on the most recent generated API bearer token using valid and approved credentials. Those credentials are provided by SPL’s team at the commence of the integration. 2- Authorizing Customer Identity : during this cycle, each submitted request should contain a valid and approved customer and branch code.
• [Data Type Element Description](https://developers.gnteq.app/data-type-element-description.md): Further details on elements of the Shipping Services API and their attributes are shown below : - Type: The type of data that can be inserted into this field. - Required: Specifies three categories. - Length: The maximum number of characters allowed in this field.
• [Base URLs](https://developers.gnteq.app/base-urls.md): This section provides the foundational URLs required to access SPL Shipping Engine API across different environments. Users can reference these base URLs to direct their requests appropriately for development, testing, or production workflows. UAT URL : uat.gnteq.app Production URL : dev.gnteq.app
• [Authentication](https://developers.gnteq.app/authentication.md): To ensure we maintain high standards of security and provide additional protection for users and accounts, our API services use a combination of technology and software protocols that impose API authentication. Users will require to get a bearer key token that requires frequent renewal.
  • [Get Token](https://developers.gnteq.app/authentication/get-token.md)
• [Shipments](https://developers.gnteq.app/shipments.md): These APIs allow authorized users to : - Create a shipment on SPL’s platform. - C reate multiple shipments on SPL’s platform. - Track their shipments by AWB Number or by Reference Number. - G et the sortation center name / Office by address.
  • [Shipment Creation](https://developers.gnteq.app/shipments/bulk-shipment-creation-copy-4.md): Create and manage new shipments by providing detailed shipment, shipper, and consignee information. This section enables users to specify shipment characteristics, including package details, delivery options, and customs declarations, facilitating seamless shipping operations within the SPL Shipping Engine.
  • [Bulk Shipment Creation](https://developers.gnteq.app/shipments/bulk-shipment-creation.md)
  • [Shipment Tracking](https://developers.gnteq.app/shipments/shipment-tracking.md): Use this section to retrieve real-time status updates and detailed tracking information for shipments by providing key identifiers such as airwaybill number, reference, or customer details. It enables seamless monitoring of parcel progress within SPL Shipping Engine, helping users stay informed throughout the delivery lifecycle.
  • [Bulk Shipments Tracking](https://developers.gnteq.app/shipments/bulk-shipments-tracking.md): Retrieve status updates for multiple shipments simultaneously by submitting a list of airway bills along with relevant customer and branch information. This section enables efficient tracking of bulk shipments, providing consolidated delivery details to streamline logistics management.
  • [Edit Shipment Address](https://developers.gnteq.app/shipments/edit-shipment-address.md)
• [Labels](https://developers.gnteq.app/labels.md): This API will allow authorized users to generate and print labels for multiple shipments (per one AWB) or by selecting a batch of AWB’s into a single file print (Bulk Print multiple AWB’s).
  • [Label Print](https://developers.gnteq.app/labels/label-print.md)
  • [Bulk Labels Print](https://developers.gnteq.app/labels/bulk-labels-print.md)
• [Master Airwaybill](https://developers.gnteq.app/master-airwaybill.md): These APIs allow authorized users to create and finalize a Master Air Waybill (MAWB) on SPL’s platform for a list of pre-existing shipments, Add Containers to a MAWB and Deleting containers from a MAWB.
  • [MAWB Creation](https://developers.gnteq.app/master-airwaybill/mawb-creation.md)
  • [Create MAWB By Shipments](https://developers.gnteq.app/master-airwaybill/create-mawb-by-shipments.md)
  • [Adding Containers To a MAWB](https://developers.gnteq.app/master-airwaybill/adding-containers-to-a-mawb.md)
• [National Address API](https://developers.gnteq.app/national-address-api.md): This API will allow authorized users to retrieve the Saudi Full National Address using either the Short Address or the X, Y coordinates Important Notes: • You must provide at least one of these parameters: shortAddress or the coordinate values (longitude, latitude). • If both are provided: o The API will first check the Short Address. o If the Short Address is invalid, it will then use the Coordinates. • The provided values must be valid; otherwise, an error message will be returned. • The user can choose the language of the response, noting that the English is the default language
  • [National Address By Short Address](https://developers.gnteq.app/national-address-api/get-token-copy.md): Retrieve detailed national address information by providing a short address or geographic coordinates. This section enables users to obtain precise location data, including region, city, district, and building details.
  • [National Address By Coordinates](https://developers.gnteq.app/national-address-api/get-token-copy-1.md)