Movilitas.Cloud application provides SAP Information Collaboration Hub (ICH) business channel enabling the users to connect to the SAP ICH system:

  • Users can send and receive verification messages
  • Users can send EPCIS messages about the following actions: pack, unpack, decommission, ship, receive and sample.


Currently, the SAP ICH channel can be used in the following applications:

  • Serialized Logistics for Pharma
  • Wholesaler FMD application


List of Procedures


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


Configuring an SAP ICH 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. Depending on your setup, create a new SAP ICH channel or modify an existing one. Follow one of the procedures described in the table below.


#Create a ChannelModify an Existing Channel
4.1Click the + icon (Create channel). The application displays the Create channel dialog.

To search for an SAP ICH channel, use the search criteria field and the filters:

  • Enter the channel name in the search criteria field.
  • Select the status.
  • Select SAP-ICH as the source.
  • Select Business channel as the type.
4.2Select 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.
To view the channel information, click the edit icon (Edit channel) next to the channel.

The application displays the Edit Channel page with the current channel settings.
4.3Enter a name for the channel and select SAP-ICH as the source.
4.4

Click Create Channel.


The application informs you about the additional costs. After confirming the creation, the application displays the Edit Channel page with a form where you can provide the connection details for the channel.



Example when creat an SAP ICH channel:




Example when opening an existing SAP ICH channel:




5. Provide the settings for the SAP ICH channel as explained in the table below:


ParameterAction
Sender GLNEnter the GLN number of the sending entity.
Receiver GLNEnter the GLN number of the receiving entity.
Verification GLNEnter the GLN number of the company that requests the verification.


6. Click Save Settings.


7. (Optional) If needed, change the name of the channel and click Save Channel.



Next Steps


Configure the relevant application with the SAP ICH channel.



Back to the list of procedures


Monitoring SAP ICH Messages

You can monitor all the SAP ICH messages sent due to scanning activities on the sites.


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 ICH channel, use the search criteria field and the filters:

  • Enter the channel name in the search criteria field.
  • Select the status
  • Select SAP-ICH 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 current channel settings as well as the messages and verifications sent over the channel.




6. To view the messages, click the Messages tab.


You can view the details of any message that was sent to the SAP ICH system from Movilitas.Cloud over the SAP ICH channel. The messages are asynchronous.


By using the search field you can easily find the message you need. You can enter specific data included in the XML file, for example, product code, serial number, or message ID, and the list of messages are filtered based on the search criteria.


In the following example, we are searching for all the messages that include the following product code and serial number: "(01)18895540081467(21)2542034337", and then we are expanding one of the messages:



In the following example, we are searching for all the messages that include the following SSCC code: "(00)001234560000000018":




For each message, the following parameters and functions are displayed:


Parameter/FunctionDescription
> (Expand) iconYou can view the details of the message after expanding the message:
  • Status
  • Sent Datetime
  • Sender GLN
  • Receiver GLN
  • Error
  • XML SOAP message
StatusStatus of the message:
  • Finished
  • Pending
  • Error
Sent DatetimeThe timestamp when the action was sent to the SAP ICH system.
Sender GLNThe GLN of the sending entity to the SAP ICH system.
Receiver GLNThe GLN of the receiving entity in the SAP ICH system.
ErrorThe error message if the action reaches the SAP ICH system.
Resend buttonIn case of an error, you can resend the message by clicking on the button.



Back to the list of procedures


Monitoring SAP ICH Verifications

You can monitor all the SAP ICH verifications from the SAP ICH system.


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 ICH channel, use the search criteria field and the filters:

  • Enter the channel name in the search criteria field.
  • Select the status
  • Select SAP-ICH 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 current channel settings as well as the messages and verifications sent over the channel.




6. To view the verifications, click the Verifications tab.


The application displays the verification messages received from the SAP ICH system. The messages are synchronous.


Example:



7. In the search field, enter an expression to find the verification message you need.


You can enter specific data included in the XML file, for example, product code or serial number, and the list of messages is filtered based on the search criteria.


In the following example, we are searching for all the verification messages containing the serial number "20201845094438":




For each message, the following parameters and functions are displayed:


Parameter/FunctionDescription
> (Expand) iconYou can view the details of the verification message after expanding the message:
  • Status
  • Status code
  • Sent Datetime
  • Verified
  • Message
  • last-response (full message)
StatusStatus of the message, The available statuses are:
  • Success
  • Error
Status codeStatus code of the message
  • 200 OK
  • 500 Error
Sent DatetimeThe timestamp when the action was sent.
Verified

The status of the verification from the SAP ICH system. The available values are:

  • True
  • False
MessageDisplays the reason if the verification fails.
Resend buttonIn case of an error, you can resend the verification request by clicking on the button.


Back to the list of procedures