The Movilitas.Cloud application provides SAP ATTP business channel enabling users to connect to the SAP ATTP system.

The SAP ATTP channel can be used to send requests to SAP ATTP and also to receive requests from SAP ATTP.

Outgoing requests

The following outgoing requests are supported:

• Serial number requests.
• SSCC requests.
• EPCIS messages for (bulk) commissioning and decommissioning, with or without aggregation.
• EPCIS messages for receiving, unpacking, packing, and shipping.
• sGTIN verification requests.

For outgoing requests, Movilitas.Cloud receives the response from SAP ATTP.

Incoming requests

The following incoming requests are supported:

• Serial number requests
• SSCC requests
• Commission requests (including shipping event)
• Generic report requests

For incoming serial number requests and SSCC requests, Movilitas.Cloud sends asynchronous responses back to SAP ATTP.

Logging

The incoming and outgoing messages are logged on the SAP ATTP channel page.

Supported applications

The SAP ATTP channel can be used in the following applications:

• Manufacturer for Pharma
• Serialized Logistics for Pharma
• Serialized Manufacturing
• Serialized Logistics

List of Procedures

• Creating an SAP ATTP Channel
• Managing Connection Settings To Send Requests to SAP ATTP
• Managing Connection Settings To Receive Requests from SAP ATTP
• Viewing the Incoming Requests from SAP ATTP and Resending Failed Responses
• Managing the Outgoing Requests to SAP ATTP

For more information on the general channel actions, see Managing Channels for a Tenant (Overview).

Creating an SAP ATTP Channel

Procedure

1. Go to Movilitas.Cloud Console --> My tenants.

2. Select the tenant or click Open tenant next to it.

3. On the Tenant Dashboard, select the Channels tab. The application displays the list of channels assigned to the tenant.

4. Click the + icon (Create channel). The application displays the Create channel dialog.

5. Select Business channel as the type and click Create. The application displays the Create Channel page with an empty form to give the basic parameters of the channel.

6. Enter a name for the channel and select SAP ATTP Interface as the source.

7. Click Create Channel.

The application informs you about the additional costs. After confirming the creation, the application displays the Edit Channel page with the following sections:

• Basic channel settings
• ATTP connection settings to send requests to SAP ATTP
• Settings for requests from SAP ATTP
• SAP ATTP EPCIS messages

Example:

Next Steps

Provide the connection settings for your SAP ATTP channel. You can apply the following use cases:

• Sending requests to SAP ATTP. For more information, see Managing Connection Settings to Send Requests to SAP ATTP.
• Receiving requests from SAP ATTP. For more information, see Managing Connection Settings to Receive Requests from SAP ATTP.

Back to the list of procedures

Managing Connection Settings To Send Requests to SAP ATTP

On the ATTP connection settings panel, you can provide the connection details to send requests to SAP ATTP:

• Serial number requests
• Commission and decommission EPCIS messages
• EPCIS messages for shipping, packing, and unpacking
• sGTIN verification requests

Procedure

1. Go to Movilitas.Cloud Console --> My tenants.

2. Select the tenant or click Open tenant next to it.

3. On the Tenant Dashboard, select the Channels tab. The application displays the list of channels assigned to the tenant.

4. To search for an SAP ATTP channel, use the search field and the filters:

• Enter the channel name in the search field.
• Select the status.
• Select SAP ATTP Interface as the source.
• Select Business channel as the type.

5. To view the channel information, click on the channel name or the edit icon (Edit channel) next to the channel.

The application displays the Edit Channel page with the following sections:

• Basic channel settings
• ATTP connection settings to send requests to SAP ATTP
• Settings for requests from SAP ATTP
• SAP ATTP EPCIS messages

6. On the ATTP connection settings panel, provide the connection details to send requests to SAP ATTP as described in the table below.

Example:

7. Click Save Settings.

Back to the list of procedures

Managing Connection Settings To Receive Requests from SAP ATTP

On the Settings for requests from ATTP panel, you can provide the connection details to receive requests from SAP ATTP and to send back asynchronous responses to SAP ATTP (when applicable).

To send requests to Movilitas.Cloud, the following authentication mechanisms are supported:

• WS Security (WSS)
• Basic authentication

The following requests are supported:

• Serial number requests
• SSCC requests
• Commission requests (including shipping event)
• Generic report requests

For a serial number request or an SSCC request, Movilitas.Cloud sends back an asynchronous response. Movilitas.Cloud applies basic authentication when sending the asynchronous response.

Procedure

1. Go to Movilitas.Cloud Console --> My tenants.

2. Select the tenant or click Open tenant next to it.

3. On the Tenant Dashboard, select the Channels tab. The application displays the list of channels assigned to the tenant.

4. To search for an SAP ATTP channel, use the search field and the filters:

• Enter the channel name in the search field.
• Select the status.
• Select SAP ATTP Interface as the source.
• Select Business channel as the type.

5. To view the channel information, click on the channel name or the edit icon (Edit channel) next to the channel.

The application displays the Edit Channel page with the following sections:

• Basic channel settings
• ATTP connection settings to send requests to SAP ATTP
• Settings for requests from SAP ATTP
• SAP ATTP EPCIS messages

6. On the Settings for requests from ATTP panel, provide the connection details to receive requests from SAP ATTP and to send back asynchronous responses to SAP ATTP (when applicable).

EXAMPLE 1 - Commissioning to the market and reporting the shipment

The following example illustrates a case when configuring the incoming request settings for the first time:

• The SAP ATTP user sends serial number requests, SSCC requests, and commission requests (including the shipping event).
• Auto-replenishment for SSCCs is activated, and the SSCCs are requested through a TraceLink Partner channel. The manufacturing site (the requester) and the MAH (the SSCC provider) are also configured.
• To receive the serial numbers and the SSCCs, the asynchronous response settings are also provided.

EXAMPLE 2 - Processing the shipping event only

The following example illustrates incoming request settings that were saved earlier.

• The SAP ATTP user sends commission requests (including the shipping event) and only wants to process the shipping event.
• The Only accept assigned items checkbox is cleared. Serialization is not performed in Movilitas.Cloud, only the transfer is recorded in the Serialized Logistics application.
• Although asynchronous responses are not sent in this case, dummy asynchronous response settings were provided so that the settings could be saved.

7. Click Save Settings.

Next Steps

You are ready to send requests to the Movilitas.Cloud endpoint. Before sending any request, make sure that the files follow the structure as described in the WSDL descriptors:

• Serial Request
• Commissioning Request
• Generic Report

Back to the list of procedures

Viewing the Incoming Requests from SAP ATTP and Resending Failed Responses

You can view the incoming requests from SAP ATTP and take actions when necessary:

• Serial Number Request
• SSCC Request
• Commission Request (including shipping event)
• Generic Report Request

Procedure

1. Go to Movilitas.Cloud Console --> My tenants.

2. Select the tenant or click Open tenant next to it.

3. On the Tenant Dashboard, select the Channels tab. The application displays the list of channels assigned to the tenant.

4. To search for an SAP ATTP channel, use the search field and the filters:

• Enter the channel name in the search field.
• Select the status.
• Select SAP ATTP Interface as the source.
• Select Business channel as the type.

5. To view the channel information, click on the channel name or the edit icon (Edit channel) next to the channel.

The application displays the Edit Channel page with the following sections:

• Basic channel settings
• ATTP connection settings to send requests to SAP ATTP
• Settings for requests from SAP ATTP
• Incoming requests and outgoing requests

6. Select the Incoming Requests tab. The application displays all the incoming requests on the channel (both successful and failed).

The following example illustrates the requests on the last page:

7. Check the messages, expand a message by clicking on the > icon, and take the necessary action.

Pending Status (Circular arrows icon)

Movilitas.Cloud is processing the request. Wait for the processing to be finished.

Finished Status (Green checkmark icon)

Movilitas.Cloud processed the request and when applicable, sent a response back to the response server at SAP ATTP.

Failed Status (Red exclamation mark)

An incoming request can fail due to multiple reasons, and the request type determines what kind of failures can occur.

Follow the description in the next table.

EXAMPLE 1

We are expanding a successful serial number request. All the details are displayed including the request and the response. In this example, the response contains the list of serials:

EXAMPLE 2

We are expanding a failed serial number request. Movilitas.Cloud successfully processed the request and generated the response including the serial numbers, but SAP ATTP is not available.

Once the SAP ATTP response server is up and running and the right SAP ATTP endpoint is configured, we can resend the response to SAP ATTP. This will not generate a new log in the list, but it will update the status of the log to Finished (green):

EXAMPLE 3

We are expanding a failed commission request. The tenant in Movilitas.Cloud performs serialization and has a connection to TraceLink to report the requests.

• The application displays a paginated error list for further investigation.
• The provided serial numbers in the request are not assigned to the SAP ATTP channel. In this example, none of the items could be processed. Note: For the commissioning and aggregation parts, partial processing is possible. For example, 6 items out of 10 could be processed, and only 4 items failed. This case also leads to a failed commission request. The user needs to investigate the error list and identify how many items failed versus how many items succeeded.
• The request contains a shipping event that was not processed either. Note: Partial processing is not possible for the shipping event.
• The user needs to resolve the mismatch between the request and the configuration in Movilitas.Cloud. Then, the SAP ATTP user can send the modified request from SAP ATTP to Movilitas.Cloud.

EXAMPLE 4

We are expanding a failed generic report request. The generic report is an aggregation report to Uzbekistan (the variant name is "ZRR_UZ_AGG_RPT"). The request contained a batch that is unknown in Movilitas.Cloud.

Back to the list of procedures

Managing the Outgoing Requests to SAP ATTP

You can view and manage the outgoing requests on the channel. 

If a message fails, the application automatically retries sending the message a maximum of four times. However, the user can also resend or delete a failed message. Automatic re-try and manual resending do not apply for the following types of outgoing requests:

• Request serials
• Request SSCCs

Procedure

1. Go to Movilitas.Cloud Console --> My tenants.

2. Select the tenant or click Open tenant next to it.

3. On the Tenant Dashboard, select the Channels tab. The application displays the list of channels assigned to the tenant.

4. To search for an SAP ATTP channel, use the search field and the filters:

• Enter the channel name in the search field.
• Select the status.
• Select SAP ATTP Interface as the source.
• Select Business channel as the type.

5. To view the channel information, click on the channel name or the edit icon (Edit channel) next to the channel.

The application displays the Edit Channel page with the following sections:

• Basic channel settings
• ATTP connection settings to send requests to SAP ATTP
• Settings for requests from SAP ATTP
• Incoming requests and outgoing requests

6. Select the Outgoing Requests tab. The application displays all the outgoing requests on the channel (both successful and failed).

Example:

7. Check the messages, expand a message by clicking on the > icon, and take the necessary action.

In the following example, we are expanding a failed serial request. All the details are displayed including the XML content of the request and the last raw response:

Back to the list of procedures