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

  • Users can send verification requests and receive the verification result.
  • Users can send EPCIS messages about the following actions and receive the response: pack, unpack, commission, decommission, ship, receive, and serial number request.


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

  • Serialized Logistics for Pharma
  • Wholesaler FMD application
  • Serialized Manufacturing
  • Serialized Logistics


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 field and the filters:
  • Enter the channel name in the search 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.4Click 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 creating 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.
Support e-mailEnter the email address that Movilitas.Cloud uses to send notifications about errors.


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 view the details of the messages sent to the SAP ICH system from Movilitas.Cloud over the SAP ICH channel. The messages are asynchronous and the status is updated after receiving the response from the SAP ICH system.


Note: You can track the verification messages on the Verifications tab.


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 field and the filters:

  • Enter the channel name in the search 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.


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)00133344445555(21)uOEn7XoP55jP", 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 the messages, the following parameters and functions are displayed:


Parameter/FunctionDescription
> (Expand) iconYou can view the details of the message after expanding the message:
  • Status
  • Request type
  • Sent Datetime
  • Sender GLN
  • Receiver GLN
  • Comments
  • Last return code
  • XML SOAP message
StatusStatus of the message:
  • Finished
  • Pending
  • Error
Request typeThe following request types are displayed on the Messages tab:
  • Pack
  • Unpack
  • Commission sscc - For container
  • Commission event - For trade item
  • Decommission
  • Ship
  • Receive
  • Serial number request
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.
CommentsAn optional message providing further details.

For example:
  • Error message about a rejected or failed request.
  • Information about a partially completed serial number request, because the requested amount is bigger than what is allowed.
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 view the details of the verification messages sent to the SAP ICH system. The messages are synchronous and the status is updated after receiving the response 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 field and the filters:

  • Enter the channel name in the search 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.


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 the messages, 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 (message details)
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 result of the verification from the SAP ICH system. The available values are:

  • True - Item is valid.
  • False - Item is not valid.


If it is empty, verification was not completed due to an error.

MessageDisplays further information in the following cases:
  • The verification result is false (not a valid item).
  • The verification was not completed due to an error.
Resend buttonIn case of an error, you can resend the verification request by clicking on the button.


Back to the list of procedures