Integration of SAP TM with SAP Global Trade Services · PDF fileSAP Transportation Management...

13
SAP Transportation Management Integration of SAP TM with SAP Global Trade Services PUBLIC Document Version: 2.0 September 2012

Transcript of Integration of SAP TM with SAP Global Trade Services · PDF fileSAP Transportation Management...

Page 1: Integration of SAP TM with SAP Global Trade Services · PDF fileSAP Transportation Management Integration of SAP TM with SAP ... Integration of SAP TM with SAP Global Trade Services

SAP Transportation Management

Integration of SAP TM with SAP Global Trade Services

PUBLIC

Document Version: 2.0 – September 2012

Page 2: Integration of SAP TM with SAP Global Trade Services · PDF fileSAP Transportation Management Integration of SAP TM with SAP ... Integration of SAP TM with SAP Global Trade Services

(C) SAP AG 2

Copyright

© Copyright 2012 SAP AG. All rights reserved.

SAP Library document classification: PUBLIC

No part of this publication may be reproduced or transmitted in any form or for any purpose without the express permission of SAP AG. The information contained herein may be changed without prior notice.

No part of this publication may be reproduced or transmitted in any form or for any purpose without the express permission of SAP AG. The information contained herein may be changed without prior notice.

Some software products marketed by SAP AG and its distributors contain proprietary software components of other software vendors.

Microsoft, Windows, Excel, Outlook, PowerPoint, Silverlight, and Visual Studio are registered trademarks of Microsoft Corporation.

IBM, DB2, DB2 Universal Database, System i, System i5, System p, System p5, System x, System z, System z10, z10, z/VM, z/OS, OS/390, zEnterprise, PowerVM, Power Architecture, Power Systems, POWER7, POWER6+, POWER6, POWER, PowerHA, pureScale, PowerPC, BladeCenter, System Storage, Storwize, XIV, GPFS, HACMP, RETAIN, DB2 Connect, RACF, Redbooks, OS/2, AIX, Intelligent Miner, WebSphere, Tivoli, Informix, and Smarter Planet are trademarks or registered trademarks of IBM Corporation.

Linux is the registered trademark of Linus Torvalds in the United States and other countries.

Adobe, the Adobe logo, Acrobat, PostScript, and Reader are trademarks or registered trademarks of Adobe Systems Incorporated in the United States and other countries.

Oracle and Java are registered trademarks of Oracle and its affiliates.

UNIX, X/Open, OSF/1, and Motif are registered trademarks of the Open Group.

Citrix, ICA, Program Neighborhood, MetaFrame, WinFrame, VideoFrame, and MultiWin are trademarks or registered trademarks of Citrix Systems Inc.

HTML, XML, XHTML, and W3C are trademarks or registered trademarks of W3C®, World Wide Web Consortium, Massachusetts Institute of Technology.

Apple, App Store, iBooks, iPad, iPhone, iPhoto, iPod, iTunes, Multi-Touch, Objective-C, Retina, Safari, Siri, and Xcode are trademarks or registered trademarks of Apple Inc.

Page 3: Integration of SAP TM with SAP Global Trade Services · PDF fileSAP Transportation Management Integration of SAP TM with SAP ... Integration of SAP TM with SAP Global Trade Services

(C) SAP AG 3

IOS is a registered trademark of Cisco Systems Inc.

RIM, BlackBerry, BBM, BlackBerry Curve, BlackBerry Bold, BlackBerry Pearl, BlackBerry Torch, BlackBerry Storm, BlackBerry Storm2, BlackBerry PlayBook, and BlackBerry App World are trademarks or registered trademarks of Research in Motion Limited.

Google App Engine, Google Apps, Google Checkout, Google Data API, Google Maps, Google Mobile Ads, Google Mobile Updater, Google Mobile, Google Store, Google Sync, Google Updater, Google Voice, Google Mail, Gmail, YouTube, Dalvik and Android are trademarks or registered trademarks of Google Inc.

INTERMEC is a registered trademark of Intermec Technologies Corporation.

Wi-Fi is a registered trademark of Wi-Fi Alliance.

Bluetooth is a registered trademark of Bluetooth SIG Inc.

Motorola is a registered trademark of Motorola Trademark Holdings LLC.

Computop is a registered trademark of Computop Wirtschaftsinformatik GmbH.

SAP, R/3, SAP NetWeaver, Duet, PartnerEdge, ByDesign, SAP BusinessObjects Explorer, StreamWork, SAP HANA, and other SAP products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of SAP AG in Germany and other countries.

Business Objects and the Business Objects logo, BusinessObjects, Crystal Reports, Crystal Decisions, Web Intelligence, Xcelsius, and other Business Objects products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of Business Objects Software Ltd. Business Objects is an SAP company.

Sybase and Adaptive Server, iAnywhere, Sybase 365, SQL Anywhere, and other Sybase products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of Sybase Inc. Sybase is an SAP company.

Crossgate, m@gic EDDY, B2B 360°, and B2B 360° Services are registered trademarks of Crossgate AG in Germany and other countries. Crossgate is an SAP company.

All other product and service names mentioned are the trademarks of their respective companies. Data contained in this document serves informational purposes only. National product specifications may vary.

Page 4: Integration of SAP TM with SAP Global Trade Services · PDF fileSAP Transportation Management Integration of SAP TM with SAP ... Integration of SAP TM with SAP Global Trade Services

(C) SAP AG 4

These materials are subject to change without notice. These materials are provided by SAP AG and its affiliated companies ("SAP Group") for informational purposes only, without representation or warranty of any kind, and SAP Group shall not be liable for errors or omissions with respect to the materials. The only warranties for SAP Group products and services are those that are set forth in the express warranty statements accompanying such products and services, if any. Nothing herein should be construed as constituting an additional warranty.

Page 5: Integration of SAP TM with SAP Global Trade Services · PDF fileSAP Transportation Management Integration of SAP TM with SAP ... Integration of SAP TM with SAP Global Trade Services

(C) SAP AG 5

Icons in Body Text

Icon Meaning

Caution

Example

Note

Recommendation

Syntax

Additional icons are used in SAP Library documentation to help you identify different types of

information at a glance. For more information, see Help on Help General Information Classes and Information Classes for Business Information Warehouse on the first page of any version of SAP Library.

Typographic Conventions

Type Style Description

Example text Words or characters quoted from the screen. These include field names, screen titles, pushbuttons labels, menu names, menu paths, and menu options.

Cross-references to other documentation.

Example text Emphasized words or phrases in body text, graphic titles, and table titles.

EXAMPLE TEXT Technical names of system objects. These include report names, program names, transaction codes, table names, and key concepts of a programming language when they are surrounded by body text, for example, SELECT and INCLUDE.

Example text Output on the screen. This includes file and directory names and their paths, messages, names of variables and parameters, source text, and names of installation, upgrade and database tools.

Example text Exact user entry. These are words or characters that you enter in the system exactly as they appear in the documentation.

<Example text> Variable user entry. Angle brackets indicate that you replace these words and characters with appropriate entries to make entries in the system.

EXAMPLE TEXT Keys on the keyboard, for example, F2 or ENTER.

Page 6: Integration of SAP TM with SAP Global Trade Services · PDF fileSAP Transportation Management Integration of SAP TM with SAP ... Integration of SAP TM with SAP Global Trade Services

(C) SAP AG 6

Table of Contents

Integration of SAP TM with SAP Global Trade Services ................................................................. 7

Settings Configuration in SAP TM ............................................................................................... 8

SOA Services Configuration for Connection Between SAP TM and SAP Global Trade Services ..................................................................................................................................................... 9

Configuring Connections using SAP NetWeaver Process Integration ................................... 11

Configuring a Point-to-Point Connection ................................................................................ 13

Page 7: Integration of SAP TM with SAP Global Trade Services · PDF fileSAP Transportation Management Integration of SAP TM with SAP ... Integration of SAP TM with SAP Global Trade Services

(C) SAP AG 7

Integration of SAP TM with SAP Global Trade Services

This configuration guide provides you with the necessary information for configuring the integration of SAP Transportation Management (SAP TM) and SAP Global Trade Services.

Ensure that you carry out the configuration steps in the order given.

1. Settings Configuration in SAP TM [Page 8]

2. SOA Services Configuration for Connection Between SAP TM and SAP Global Trade Services [Page 9]

Page 8: Integration of SAP TM with SAP Global Trade Services · PDF fileSAP Transportation Management Integration of SAP TM with SAP ... Integration of SAP TM with SAP Global Trade Services

(C) SAP AG 8

Settings Configuration in SAP TM

You can use this process to establish the connection between SAP Transportation Management (SAP TM) and SAP Global Trade Services.

Prerequisites

You have made the required Customizing settings in the SAP Global Trade Services system and connected it to your SAP ERP system. For more information, see the configuration guide for Customs Management on SAP Service Marketplace at:

http://service.sap.com/swdc Installations and Upgrades Installation and Upgrade Guides

SAP Business Suite Applications SAP Governance, Risk, Compliance (GRC) Global Trade

Services

Process

1. You define the customs profile in Customizing for SAP Transportation Management

under Transportation Management Global Trade Define Customs Profile .

2. You define a new customs relevance check if a check for transportation within the European Union is not relevant for you. You define a new customs relevance check in

Customizing for SAP Transportation Management under Transportation Management

Basic Settings Global Trade Define Customs Relevance Check .

3. You assign the customs profile to the freight order type and to the freight booking type in

Customizing for SAP Transportation Management under Transportation Management

Freight Order Management Freight Order Define Freight Order Types and under

Transportation Management Freight Order Management Freight Booking Define

Freight Booking Types .

4. You have defined the system landscape directory data of your business systems in

Customizing for SAP Transportation Management under Transportation Management

Basic Functions Define SLD Data of Business Systems .

Result

You have made the settings in SAP TM to establish the connection between SAP TM and SAP Global Trade Services.

You can now configure the SOA services for the connection between SAP TM and SAP Global Trade Services.

More Information

SOA Services Configuration for Connection Between SAP TM and SAP Global Trade Services [Page 9]

Page 9: Integration of SAP TM with SAP Global Trade Services · PDF fileSAP Transportation Management Integration of SAP TM with SAP ... Integration of SAP TM with SAP Global Trade Services

(C) SAP AG 9

SOA Services Configuration for Connection Between SAP TM and SAP Global Trade Services

You can use this process to configure service-oriented architecture (SOA) services. SOA middleware facilitates communication between disparate applications and systems based on the exchange of XML messages. With SOA middleware, you can accelerate business integration and use standards-based Web services to form new and innovative business solutions that meet your changing business needs quickly. SAP NetWeaver Process Integration (SAP NetWeaver PI) is SAP's implementation of SOA middleware.

The connection between SAP Transportation Management (SAP TM) and SAP Global Trade Services can be established using either PI (mediated) or a point-to-point-connection.

The communication between SAP TM (software component SCMTM) and SAP Global Trade Services (software component SAP SLL-LEG) has to be set up for the following SOA services:

From Sender SOA Service To Receiver SOA Service

Name: ExportDeclarationSUITERequest_Out

Namespace: http://sap.com/xi/TMS/Global

Software Component: SCMTM <Version>

Name: ExportDeclarationSUITERequest_In

Namespace: http://sap.com/xi/GTS/Global2

Software Component: SAP SLL-LEG <Version>

Name: ExportDeclarationSUITECancellation

Request_Out

Namespace: http://sap.com/xi/TMS/Global

Software Component: SCMTM <Version>

Name: ExportDeclarationSUITECancellation

Request_In

Namespace: http://sap.com/xi/GTS/Global2

Software Component: SAP SLL-LEG <Version>

Name: ExportDeclarationSUITEConfirmation

_Out

Namespace: http://sap.com/xi/GTS/Global2

Software Component: SAP SLL-LEG <Version>

Name: ExportDeclarationSUITEConfirmation

_In

Namespace: http://sap.com/xi/TMS/Global

Software Component: SCMTM <Version>

Prerequisites

You have set up SAP Global Trade Services 10.0 (relevant software component version: SAP SLL-LEG10.0).

You have set up SAP TM 8.0 (relevant software component version SCMTM 8.0) is set up.

If the connection is established by PI, you have set up SAP NetWeaver PI 7.0 and higher.

Page 10: Integration of SAP TM with SAP Global Trade Services · PDF fileSAP Transportation Management Integration of SAP TM with SAP ... Integration of SAP TM with SAP Global Trade Services

(C) SAP AG 10

Process

To configure the SOA services, decide between one of following options:

You configure the connection using SAP NetWeaver PI.

For more information see, Configuring the Connections using SAP NetWeaver Process Integration [Page 11].

You configure the connection using a point-to-point-Connection.

For more information see, Configuring a Point-to-Point Connection [Page 13].

More Information

For more information about SAP NetWeaver PI, see SAP Library for SAP NetWeaver at http://help.sap.com/netweaver SAP NetWeaver Process Integration .

Page 11: Integration of SAP TM with SAP Global Trade Services · PDF fileSAP Transportation Management Integration of SAP TM with SAP ... Integration of SAP TM with SAP Global Trade Services

(C) SAP AG 11

Configuring Connections using SAP NetWeaver Process Integration

You can use a process integration scenario from the Enterprise Services Repository (ES Repository) as a configuration template. The system uses the information saved in the process integration scenario, together with additional assignments, to calculate the relevant configuration objects. To configure the connection, you have access to the predefined content of the integration scenario TM_GTSExportDeclarationIntegration (SAPTM IC) under http://sap.com/xi/TMS/Global/IC.

To configure the connection, run the configuration wizard once for each SOA service pair.

Prerequisites

The sender business system SAP Transportation Management (SAP TM) and receiver business system (SAP Global Trade Services) exist as business systems in SAP NetWeaver Process Integration (SAP NetWeaver PI) with completely configured XI receiver communication channels.

Procedure

1. In the main menu bar of the Integration Builder, choose Tools Apply Model from ES

Repository .

A wizard starts.

2. Perform the following steps:

o Select ES Repository Model

o Create Configuration Scenario

3. In the Type of ES Repository Model screen area, select the Process Integration Scenario radio button.

4. In the ES Repository Model Reference(s) screen area, select the process integration scenario from the ES Repository:

o TM_GTSExportDeclarationIntegration

o SAPTM IC 1.0

o http://sap.com/xi/TMS/Global/IC

Choose the Continue pushbutton.

5. In the Create Configuration Scenario screen area, enter a name for the configuration scenario and choose the Finish pushbutton.

The system transfers the integration scenario from the integration repository and the Integration Scenario Configuration wizard starts.

6. Perform the following configuration steps:

o Select Model

Page 12: Integration of SAP TM with SAP Global Trade Services · PDF fileSAP Transportation Management Integration of SAP TM with SAP ... Integration of SAP TM with SAP Global Trade Services

(C) SAP AG 12

o Assign Components

o Configure Connections

o Generate Configuration Objects

7. You can configure multiple component views within the same configuration scenario. For this connection, there is only one component view defined and therefore you skip this step.

8. To map the participants in a process displayed in the model to actual senders and receivers of messages in your system landscape, assign the components by choosing Assign Components. On the Business System Components for A2A tab page, choose the communication component of the sender and the receiver system. To select the next system, use the navigation arrows to navigate.

9. To configure the three connections, choose Configure Connections. For each connection, select a communication channel for the receiver business system communication component, and choose the Apply pushbutton. The navigation arrows enable you to navigate to the other connections in the process integration scenario.

10. To generate all connections, choose Generate All Connections for the Integration Server Communication and Create Configuration Objects.

A dialog box appears.

11. Make the following settings:

Settings for Generation

General Generation

Scope of Generation

You can limit the scope of generation to particular object types. Select the checkboxes of the following object types:

o Receiver Determination

o Interface Determination

o Sender/Receiver Agreement

Change List for Generated Objects

Select the Create New radio button if you want to create a new change list for the generated objects. You can also use an existing change list. The process integration scenario is predefined.

12. Choose Start.

13. The system displays the generation log, which you can save.

Result

The relevant receiver determinations, interface determinations, and collaboration agreements are generated for your connection.

Page 13: Integration of SAP TM with SAP Global Trade Services · PDF fileSAP Transportation Management Integration of SAP TM with SAP ... Integration of SAP TM with SAP Global Trade Services

(C) SAP AG 13

Configuring a Point-to-Point Connection

Procedure

1. Configure the service provider. The service provider receives the message and calls the service backend implementation. For more information, see SAP Library for SAP NetWeaver at http://help.sap.com/netweaver. In SAP NetWeaver Process Integration Library, choose SAP NetWeaver Process Integration Library SOA Middleware

SOA Management section Configuring the Web Service Runtime Working with the SOA Manager Configuring Service Providers and Consumers Configuring a Service

Provider .

2. Configure a consumer proxy. To call a service provider of SAP Global Trade Services, SAP Transportation Management (TM) calls a consumer proxy. The result of the call is that SAP TM sends a message to the SAP Global Trade Services service provider. For more information, see SAP Library for SAP NetWeaver at http://help.sap.com/netweaver.

In SAP NetWeaver Process Integration Library, choose SAP NetWeaver Process Integration Library SOA Middleware SOA Management section Configuring the Web Service Runtime Working with the SOA Manager Configuring Service Providers

and Consumers Configuring a Consumer Proxy .

3. Perform the configuration for each SOA service pair once.