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.


The following outgoing requests are supported:

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


The following incoming requests are supported:

  • Serial number requests


Movilitas.Cloud also receives the response from SAP ATTP (outgoing requests) or sends an asynchronous response back to SAP ATTP when applicable (incoming requests). Failed messages are listed at the bottom of the SAP ATTP channel page.


Currently, 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 uses 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 an asynchronous response to SAP ATTP (when applicable).

  • Serial number 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 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
EndpointCopy 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.
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.
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.



7. Click Save Settings.


You are ready to send requests to the Movilitas.Cloud endpoint. Make sure the WSDL request file follows the structure as described in the WSDL descriptor here.



Back to the list of procedures



Managing the EPCIS Messages


You can view and manage the EPCIS messages that are 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
  • SAP ATTP EPCIS messages.


6. Check the SAP ATTP EPCIS messages and take the necessary action.

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


In the following example, the application displays the list of messages:



In the following example, we are expanding a message:



Back to the list of procedures