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


The SAP ICH channel can be used to send messages to SAP ICH and also to receive messages from SAP ICH.


Outgoing messages


The users can do the following:

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


Incoming messages


The users can do the following:

  • Uploading an IDOC Delvry in XML format as a closed envelope.


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 can use 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



Uploading an IDOC


You can upload an IDOC Delvry in XML format as a closed envelope. The IDOC specifies a delivery. Uploading an IDOC triggers the following in the Serialized Logistics application:

  • If the client is not existing, the application creates the client.
  • If the delivery address of the client is not existing, the application creates the delivery address of the client.


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.


Example:



6. Select Incoming messages tab (selected by default). The application displays the Upload IDOC button.



7. Click Upload IDOC.


8. Select the file from your computer. Only XML files are allowed.


Next Steps


Go to the Serialized Logistics application and review the client.


Back to the list of procedures



Monitoring Outgoing Messages


You can view the details of the requests (events) sent to the SAP ICH system from Movilitas.Cloud over the SAP ICH channel. The messaging is 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.


Example:



6. Select the Outgoing messages tab. The application displays the log of outgoing messages.


Example:



7. Find the message by using the search field. Enter specific data from the XML file, for example, product code, serial number, or message ID, and the list of messages is 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 message was sent to the SAP ICH system.
Sender GLNThe GLN of the sending entity.
Receiver GLNThe GLN of the receiving entity.
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 Verifications


You can view the details of the verification messages sent to the SAP ICH system. The verification messaging is 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.


Example:



6. Select the Verifications tab. The application displays the log of verifications.


Example:



7. Find the verification message by using the search field. Enter specific data from 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 codeHTTP response status code for the verification request.
Sent DatetimeThe timestamp when the verification message 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