1. Integration Guide
  2. Integration Overview

Integration Overview

This manual is for members of the Transportation and Global Trade Management Cloud implementation teams, who are responsible for connecting the system to other external systems through integration interfaces. This manual explains how to send and receive integration messages and the format of each message.

Oracle Transportation and Global Trade Management Cloud exposes a large number of interfaces to support integration with external applications. There are two distinct use cases for application integration covered in this guide: Business Process Integration and User Interface Integration. Data Tier Integration is covered in the Data Management Guide.

Business Process Integration is defined in this guide as the sending and receiving of functional messages between applications. These messages are implemented as Transmission or Mobile Device Communication XML documents.

The Transmission XML document is the primary application integration message and is covered in detail in this guide. Mobile Device Communication integration is built on the infrastructure described in the main chapters of this guide but uses a different XML message format and is optimized for high volume, small messages e.g. for Fleet power or trailer devices. The details for this integration are covered in the Mobile Device Communications chapter.

As an example functional message, the Transportation Orders (TransOrder) Transmission interface receives transportation order messages from an external application into Transportation and Global Trade Management Cloud. This is referred to as an inbound interface. The outbound interfaces send messages from the Transportation and Global Trade Management Cloud application to other external applications. For example, shipments planned from Orders in Transportation Management Cloud can be sent in a PlannedShipment message to another system for additional processing.

The valid formats of all messages are described by Integration XML Schema Definition (XSD) documents.

This guide describes the following:

  • The purpose of each XSD and the available messages defined by it.
  • The application level message protocol describing the process of message exchange.
  • The transport level protocols supported for inbound and outbound message communication.

User Interface Integration is defined in this guide as the retrieval and modification of application data to support customer-defined user interfaces. This is achieved by the use of the Transportation and Global Trade Management Cloud Representational State Transfer (ReST) API, which is covered in the REST API Guide.