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
  • Commission and decommission EPCIS messages
  • EPCIS messages for shipping, packing, and unpacking
  • 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
  • Commissioning requests


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


Logging


The messages are collected on the SAP ATTP channel page as follows:

  • All the incoming requests from SAP ATTP are listed with the corresponding response (if any).  
  • For outgoing requests, only the failed requests are listed with the corresponding response (if any).


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


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:


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 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.


Function/ParameterAction
IPEnter the endpoint of the SAP ATTP system.
Interface requestsEnter the interface for requesting serial numbers.
Interface epcisEnter the interface for sending EPCIS messages.
Verification interfaceEnter the SAP ATTP endpoint for verification of items (packs).
System nameEnter the name of the target SAP ATTP system.
UsernameEnter the username for basic authorization.
PasswordEnter the password for basic authorization.
bizLocationEnter the business (company) location in sGLN format. Example: urn:epc:id:sgln:183456.829829.0

Note: The business location can be different from the sender (readPoint).
readPointEnter the location of the device that performs the trigger, in sGLN format. Example: urn:epc:id:sgln:183456.829829.0
Time zone offsetEnter the difference in hours and minutes from the Coordinated Universal Time (UTC) for your particular place and date. The allowed format is +HH:MM or -HH:MM. For example, +06:30.

The allowed value range:
  • For hours, between 00 and 14 (inclusive)
  • For minutes, between 00 and 59 (inclusive).


Note:  If the value of the first two digits is 14, the value of the second two digits must be 00.

Support emailEnter the email address that Movilitas.Cloud can use to send notifications about errors.
Maximum serials per one requestEnter the allowed maximum number of serials per request.


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).


The following requests are supported:

  • Serial number requests
  • SSCC requests
  • Commissioning requests


For a serial number request or an SSCC request, Movilitas.Cloud sends back an 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 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 response to SAP ATTP (when applicable).


Function/ParameterAction
Request
Endpoint for SerialsThis is the endpoint used for serial requests (serial numbers and SSCCs).

Copy the Movilitas.Cloud endpoint to your clipboard by using the Copy endpoint button on the right. As an SAP ATTP user, you must use this endpoint to send your request to Movilitas.Cloud.
Endpoint for CommissioningThis is the endpoint used for commissioning requests. Commissioning requests contain packs (sGTINs), containers (SSCCs), and aggregation information.

Copy the Movilitas.Cloud endpoint to your clipboard by using the Copy endpoint button on the right. As an SAP ATTP user, you must use this endpoint to send your request to Movilitas.Cloud.
Only accept assigned itemsSpecify if the serials to be commissioned must be known in Movilitas.Cloud or they can be created on the fly. By default, the checkbox is selected, meaning that you can commission only the items for which the serials are in Assigned status in Movilitas.Cloud.
Release packs directly to marketActivate direct commissioning to the market from SAP ATTP by selecting this checkbox.

Note: Applicable when the commissioning request is sent to TraceLink from SAP ATTP through Movilitas.Cloud.

When this checkbox is not selected, the commissioning request from SAP ATTP is registered on the Serialized Manufacturing application --> Commissioning page, and you need to manually commission the items to the market from that page.
Process shipping eventsSelect this checkbox to process the shipping event in a commissioning request.

When the shipping event is processed, an outbound external transfer is created in the Serialized Logistics application. As a prerequisite, the Serialized Logistics application shall be properly configured, the warehouse data as the sender and the client data as the receiver, including SGLN.

When the items are commissioned to the market through Movilitas.Cloud, select the Release packs directly to market checkbox to ensure that the commissioning request is fully processed and the items are first commissioned to the market before processing the shipping event.
UsernameCopy the username to your clipboard by using the Copy username button on the right. As an SAP ATTP user, you must use this username to connect to the given endpoint. The username is the channel key of the SAP ATTP channel.
PasswordProvide a password that you want to use with the username to connect to the Movilitas.Cloud endpoint.
Auto-replenish SSCCIf you want automatic control over the SSCC pool in the Serialized Manufacturing application, select this checkbox. When there are not enough SSCCs in the pool to fulfill a request, the automatic replenishment function fills the pool with the required amount without human intervention and then the request from SAP ATTP is successful.

If the checkbox is not selected, you need to regularly check the SSCC pool status and make sure that there are enough SSCCs in the pool by manually generating or requesting SSCCs in the Serialized Manufacturing application.
SourceWhen Auto-replenish SSCC checkbox is selected, provide the source to fill the SSCC pool in the Serialized Manufacturing application:
  • Movilitas.Cloud - Use it to generate SSCCs in-house.
  • TraceLink channel - Use it to request SSCCs from TraceLink through a configured TraceLink Partner channel.
SiteSelect the manufacturing site that requests the SSCCs. The page offers the sites previously registered under the Serialized Manufacturing application --> Site management --> Sites tab.

Applicable when Auto-replenish SSCC checkbox is selected, and the source is a TraceLink channel.
Marketing Authorization HolderSelect the MAH that provides the SSCCs. The page offers the MAHs previously registered with a TraceLink company identifier under the Serialized Manufacturing application --> Site management --> MAHs tab.

Applicable when Auto-replenish SSCC checkbox is selected, and the source is a TraceLink channel.
Async Response towards SAP ATTP
EndpointProvide the SAP ATTP endpoint where Movilitas.Cloud must send the asynchronous response.
UsernameProvide the SAP ATTP username that Movilitas.Cloud must use to connect.
PasswordProvide the SAP ATTP password belonging to the username that Movilitas.Cloud must use to connect.
Support emailEnter the email address that Movilitas.Cloud can use to send notifications about errors.



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 WSDL request files follow the structure as described in the WSDL descriptors for Serial Request and Comissioning Request.


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:

  • Serial Number Request
  • SSCC Request
  • Commissioning Request

The list includes the successful, the failed, and the pending requests.


StatusDescription
Finished (Green checkmark icon)

A successful incoming request means the request was processed and, when Movilitas.Cloud can send back a response, the response from Movilitas.Cloud reached the SAP ATTP response server.


It does not automatically mean that the response from Movilitas.Cloud contains the expected content. For example, it can happen that the pool does not contain enough SSCCs to fulfill the request and the response contains an appropriate message.

Failed (Red exclamation mark)

An incoming request might fail due to one of the following reasons:


Reason 1: Movilitas.Cloud receives the serial number request or the SSCC request, Movilitas.Cloud could generate the response, but Movilitas.Cloud cannot send the response back to SAP ATTP:

  • The response server at SAP ATTP is down.
  • A wrong endpoint URL is provided for the response server.
  • There is a glitch in the Internet connection.
  • The configuration of the response server changed. 
After the root cause is identified and the issue is fixed, you can resend the failed response from Movilitas.Cloud to SAP ATTP.

Reason 2: When sending a commissioning request to Movilitas.Cloud, there is a mismatch between the configuration in Movilitas.Cloud and the content of the request. You need to make sure that the commissioning request is consistent with the configuration in Movilitas.Cloud. Movilitas.Cloud does not send asynchronous response for a commissioning request, therefore resending from Movilitas.Cloud is not applicable.
Pending (Circular arrows icon)Processing of the request is in progress.



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 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.


StatusDescriptionAction
Finished (Green checkmark icon)Movilitas.Cloud processed the request and when applicable, sent a response back to the response server at SAP ATTP.For the serial number request or the SSCC request, verify if the response contains the requested items or if the response is a message that the request cannot be fulfilled for a reason.

If the request cannot be fulfilled for a reason, adjust the configuration in Movilitas.Cloud or retry the request, depending on the message.

For a commissioning request, this status indicates successful processing. Depending on the Release packs directly to market checkbox status on the SAP ATTP channel page, one of the following applies:
  • Checkbox OFF - The items are listed under the Serialized Manufacturing application --> Commissioning tab. Commission them to the market manually.
  • Checkbox ON - The items are directly released to the market. No further action.
Failed (Red exclamation mark)One of the following is applicable:
  1. Movilitas.Cloud could not send a response back to the response server at SAP ATTP.
  2. There is a mismatch between the configuration in Movilitas.Cloud and the content of the request. Movilitas.Cloud could not process the request.

Follow the action next to the letter in Action column.

1. Find the root cause.
2. Fix the issue.
  1. Ensure that the right SAP ATTP endpoint is configured and that the SAP ATTP response server is up and running.
  2. Ensure that the data in the request is in sync with the configuration in Movilitas.Cloud.
3. Apply resending.
  1. When there was an issue with the response server at SAP ATTP, resend the response from Movilitas.Cloud to SAP ATTP.
  2. When there was an issue with the request, resend the request from SAP ATTP to Movilitas.Cloud.
Pending (Circular arrows icon)Movilitas.Cloud is processing the request.Wait for the processing to be finished.



EXAMPLE 1


We are expanding a successful message for a 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 message for a Serial Number Request. Movilitas.Cloud successfully processed the request, 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 message for a commissioning request. The provided serial numbers in the request are associated with another batch in Movilitas.Cloud. The application displays a paginated error list for further investigation. We need to resolve the mismatch between the request and the configuration in Movilitas.Cloud. Then, the SAP ATTP user can resend the request from SAP ATTP to Movilitas.Cloud.



Back to the list of procedures


Managing the Outgoing Requests to SAP ATTP


You can view and manage the outgoing requests that failed on the channel. You can either resend or delete a failed message.


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 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 that failed on the channel.


Example:


 


7. Check the messages and take the necessary action.

  • Expand a message by clicking on the > icon.
  • If the last status of the message is Failed, resolve the error and send the message again by clicking the Resend (circular arrows) icon under the Action column.
  • To delete a message, click the delete icon under the Action column.


In the following example, we are expanding a message. All the details are displayed including the XML content of the request:



Back to the list of procedures