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:

  • Sending an EPCIS shipment message from SAP ICH.
  • Sending an IDOC Delvry as a closed envelope from SAP ICH.
  • Uploading an IDOC Delvry file in XML format on the SAP ICH channel page.


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 on the channel name or 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.N/A
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.
N/A


Example when creating an SAP ICH channel:



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


IMPORTANT: The field names relate to the outgoing traffic (to SAP ICH) but the settings are also used to handle incoming traffic (from SAP ICH). For incoming traffic, the sender and receiver are the other way around. You define the participants in the communication.


ParameterAction
Sender GLNEnter the Global Location Number (GLN) of the sending entity.
Receiver GLNEnter the GLN of the receiving entity.
Verification GLNEnter the GLN of the company that requests the verification.
Substitute sGLN for DSCSA sendingEnter the SGLN of the entity that you would like to include as the sender in the outgoing DSCSA shipping (EPCIS) messages. Before the SGLN value, also enter "urn:epc:id:sgln:". For example: urn:epc:id:sgln:1234567.98765.0

This field is only applicable when the following conditions are met:
  • The tenant in Movilitas.Cloud sends EPCIS messages to SAP ICH from two sources: SAP ATTP and Movilitas.Cloud. Using the same sender in both cases leads to a conflict in the SAP ICH system so you want to overwrite the sender when sending from Movilitas.Cloud.
  • The tenant in Movilitas.Cloud acts as a 3PL of the supplier so shipping to the client from Movilitas.Cloud is performed on behalf of the supplier.
  • The shipping is performed in the USA market (DSCSA). 


Otherwise, leave the field blank.


Based on the given SGLN value, the system finds the matching supplier in the Serialized Logistics application and uses that supplier data in the DSCSA shipping message as the sender. IMPORTANT: As a prerequisite, you must register the supplier with the given SGLN value in the Serialized Logistics application (master data). No match or multiple matches leads to an error.

Support e-mailEnter the email address where Movilitas.Cloud can send notifications about errors on the channel.
Use receiver GLN to determine supplierSelect the checkbox to let the system identify the supplier of the incoming EPCIS file based on the receiver GLN of the channel. If the checkbox is cleared, the system identifies the supplier based on the source owning party SGLN in the received EPCIS file.


6. Click Save Settings.


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


Next Steps


If you want to send messages from SAP ICH to Movilitas.Cloud, set up the connection to Movilitas.Cloud. 


Configure the relevant application with the SAP ICH channel.


Back to the list of procedures



Setting Up the Connection to Receive Messages from SAP ICH


You can send EPCIS shipment and IDOC Delvry messages to Movilitas.Cloud. Incoming traffic can be utilized in the Serialized Logistics application only.


Make sure that you provide the GLN values on the SAP ICH Settings panel and that the GLN values are in line with the GLN values in the EPCIS / IDOC Delvry file that you will send:

  • Sender GLN on the channel settings = Receiver in the EPCIS or IDOC Delvry file.
  • Receiver GLN on the channel settings = Sender in the EPCIS or IDOC Delvry file.
    • When multiple suppliers send EPCIS files from SAP ICH, leave the Receiver GLN field blank; however, in this case, the Use receiver GLN to determine supplier checkbox is not applicable and the logic checks the EPCIS file to identify the supplier.


IMPORTANT: The connection details and the authentication data (certificate information) are shared with the SAP ICH team only (not public). Before sending a message, contact the SAP ICH team to complete the connection setup for you.


Back to the list of procedures



Uploading an IDOC


You can upload an IDOC Delvry file in XML format. This function can be useful when you cannot send the IDOC Delvry from SAP ICH for any reason.


The IDOC specifies a delivery. Uploading an IDOC triggers the following automated actions in the Serialized Logistics application:

  • If the client is not existing, the application creates the client. Note: The user needs to manually give the client location (SGLN) after the auto-creation.
  • If the delivery address of the client is not existing, the application creates the delivery address of the client. Note: The user needs to manually give the delivery address SGLN after the auto-creation.
  • The application creates the delivery.
    • If the outbound external order that contains the delivery does not exist, the order is also created.
    • If the IDOC contains National Drug Codes (NDCs) for the USA market, the application converts the NDCs into Global Trade Item Numbers (GTINs), stores the company prefixes, fetches product master data from openFDA, links the products to the supplier, and displays the GTINs and product data in the order.
  • The application links the outbound order (and all grouped deliveries) to the delivery address of the client and this information is used when reporting the DSCSA shipment to SAP ICH.


For more information, see the Site management > Clients tab and the Orders > Outbound orders tab in the Serialized Logistics application.


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 on the channel name or the edit icon (Edit channel) next to the channel. The application displays the current channel settings and the log of incoming messages, by default.


The following example illustrates the case when incoming messages have not been logged on the channel yet. This means an IDOC Delvry file has not been uploaded or sent to Movilitas.Cloud yet (empty logs):



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



7. Click Upload IDOC.


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


The application processes the file. The processing might take some time and when it ends, a log is created in the list.


The following example illustrates the case when uploading an IDOC Delvry file creates the first log. The upload is successful (green checkmark icon):



9. Find the log in the list and select the > (Expand) icon to check the IDOC Delvry content and other details.


Example:



Note: For large files, the application offers the Download button but does not display the IDOC content.


Next Steps


Go to the Serialized Logistics application:

  • Under the Orders --> Outbound orders tab: Review the outbound order (settings, line items, deliveries).
  • Under the Site management --> Clients tab: Review the client. Provide the SGLN values manually, both for the client master data and for the delivery address.


Back to the list of procedures



Monitoring Incoming Messages


You can view the details of the messages sent to Movilitas.Cloud from SAP ICH. You can also view the details of IDOC Delvry files that were manually uploaded on the channel.


Movilitas.Cloud supports the following incoming messages:

  • EPCIS
  • IDOC Delvry (from SAP ICH or by upload)


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 on the channel name or the edit icon (Edit channel) next to the channel. The application displays the current channel settings and the log of incoming messages, by default.


Example:



6. Select the Incoming messages tab (default). The application displays the log of incoming messages.


Example:



7. Find the message by using the search field. Enter an expression from the XML, as described in the table below. The list of messages is filtered based on the search criteria.


Request typeSearch Expressions
Supplier EPCIS from SAP ICHContent from the XML, for example, a serial number.
IDOC from SAP ICHContent from the XML, for example, a delivery ID (VBELN).
Manually uploaded IDOCContent from the XML, for example, a delivery ID (VBELN).


IMPORTANT: Large messages are not included in the search results. The application displays a separate note to inform the user about it.


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
  • XML
    • Download button to download the file to your local computer.
    • XML content except for large messages.
StatusStatus of the message:
  • Finished (Green checkmark icon)
  • Pending (Circular arrows icon)
  • Error (Red exclamation mark)
Request typeThe following request types are displayed on the Incoming messages tab:
  • Supplier EPCIS from SAP ICH
  • IDOC from SAP ICH
  • Manually uploaded IDOC
Sent DatetimeThe timestamp when the message was sent or uploaded to Movilitas.Cloud.
Sender GLNThe GLN of the sending entity.
Receiver GLNThe GLN of the receiving entity.
CommentsAn optional message providing further details about an error.


8. Take the necessary action on the message.


Pending Status (Circular arrows icon)


Movilitas.Cloud is processing the request. Wait for the processing to be finished.


Finished Status (Green checkmark icon)


Movilitas.Cloud processed the request that triggers automated actions in the Serialized Logistics application, as described in the table below.


Request TypeResultAction
Supplier EPCIS from SAP ICH
  • The application creates trade items and containers and stores the aggregation information (hierarchy).
  • The application creates a snapshot of the items and the hierarchy. The items are linked to the supplier. Note: The tenant acts as the 3PL for the supplier.
  • If the product is not existing in the system, the application creates the product first:
    • The company prefix of the product is stored and the supplier is flagged as the MAH of the product.
    • If the receiver of the shipping event is a warehouse in the Serialized Logistics application that is located in the USA:
      • The product master data is taken from the EPCIS file. If the master data is not present in the EPCIS file, the master data is fetched from openFDA.
      • The NDC is determined and stored next to the GTIN in the database.
  • If the first EPCIS file from the supplier includes the supplier details, the application completes the supplier configuration (master data and shipping address). As a prerequisite, the supplier must be registered with the following master data:
    • Supplier name
    • Supplier SGLN
Verify the auto-created items in the Serialized Logistics application:

1. Supplier details: Site management --> Suppliers --> Master data tab and Shipping address tab.

2. Product data: Site management --> Suppliers --> Products tab.

3. Shipment data: Site management --> Suppliers --> Uploads tab. The file name indicates that it comes from EPCIS.


If there are issues with the shipment data, resolve the issue under the Site management --> Suppliers --> Uploads tab:

  1. Investigate the log.
  2. Create a new EPCIS file by reusing the original one.
  3. Include the items in the file that needs correction.
  4. Upload the EPCIS file.


For more information, see Managing Suppliers.

Manually uploaded IDOC (IDOC Delvry)
  • If the client is not existing, the application creates the client. Note: The user needs to manually give the client location (SGLN) after the auto-creation.
  • If the delivery address of the client is not existing, the application creates the delivery address of the client. Note: The user needs to manually give the delivery address SGLN after the auto-creation.
  • The application creates the delivery.
    • If the outbound external order that contains the delivery does not exist, the order is also created. The order with all its deliveries is assigned to a specific warehouse.
    • The delivery is linked to the route that is specified in the IDOC Delvry. As a prerequisite, the user registered all possible routes in the Serialized Logistics application.
    • If the IDOC contains NDCs for the USA market, the application converts the NDCs into GTINs, stores the company prefixes, fetches product master data from openFDA, links the products to the supplier, and displays the GTINs and product data in the order.
  • The application links the outbound order (and all grouped deliveries) to the delivery address of the client and this information is used when reporting the DSCSA shipment to SAP ICH.
1. Go to the Serialized Logistics application.
2. Verify the client master data and delivery address under the Site management --> Clients tab.
3. Add the client SGLN and the delivery address SGLN manually and save the settings under the Site management --> Clients tab.
4. Verify the delivery and the outbound external order under the Orders --> Outbound orders tab. Optionally, fill in the empty fields in the order settings, as needed.
IDOC from SAP ICH (IDOC Delvry)


Error Status (Red exclamation mark)


An incoming request can fail due to multiple reasons, and the request type determines what kind of errors can occur.


Follow the description in the next table.


Request TypeReasons for ErrorAction
Supplier EPCIS from SAP ICH

1. The supplier cannot be identified. 


For example, the supplier SGLN is not registered in the Serialized Logistics application and the EPCIS shipment cannot be processed.


2. An error blocks processing the events of the EPCIS.

1. Investigate the issue based on the information in the comment column.

2. Fix the issue. 
  • For issues with the sender/receiver, check the configuration in the Serialized Logistics application. Make sure that both the supplier and the warehouse configuration are complete, including the SGLN value.
  • For issues that block processing the events in the EPCIS, investigate the EPCIS content and make sure that all events are correct and consistent.

3. Send the EPCIS shipment message to Movilitas.Cloud again.
Manually uploaded IDOC (IDOC Delvry)1. The IDOC message misses a required data or field.


2. The IDOC contains invalid or unknown data. For example:

  • An invalid or unknown NDC.
  • An unknown warehouse site. The logic cannot match the partner ID of the shipping point (OSP) in the IDOC Delvry with any of the sublocations of the warehouse.
  • An unknown route.


3. The IDOC contains an already existing outbound order-delivery combination.

1. Investigate the issue based on the information in the comment column.

2. Fix the issue.
  • For issues with the warehouse site, make sure that the sublocation of the warehouse is registered in the Serialized Logistics application. The sublocation tag must match the partner ID of the shipping point (OSP).
  • For issues with the route, make sure that the route is registered in the Serialized Logistics application. The route tag must match the "ROUTE" value in the IDOC Delvry.
  • Modify the content of the message to contain all required data in the correct format and with the correct value.

3. Send the IDOC message to Movilitas.Cloud again.
IDOC from SAP ICH (IDOC Delvry)


In the following example, we are searching for the IDOC Delvry that contains the delivery ID (VBELN) "MULTIDEL060603".

  • There are two search results. 
  • The one that raised an error is expanded. The IDOC describes an already existing delivery for the order.
  • The system offers to download the file and displays the XML content.



In the following example, we are searching for a supplier EPCIS that contains the SGTIN "030597.0002402.10533497".

  • There is one search result that is expanded.
  • The message is successful.
  • The system offers to download the file and displays the XML content.



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 on the channel name or the edit icon (Edit channel) next to the channel. The application displays the current channel settings and the log of incoming messages, by default.


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, for example, product code, serial number, or message ID, and the list of messages is filtered based on the search criteria.


IMPORTANT: Large messages are not included in the search results. The application displays a separate note to inform the user about it.


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 content
    • Download button to download the file to your local computer.
    • XML content except for large messages.
StatusStatus of the message:
  • Finished (Green checkmark icon)
  • Pending (Circular arrows)
  • Error (Red exclamation mark)
Request typeThe following request types are displayed on the Outgoing messages tab:
  • Pack
  • Unpack
  • Commission sscc - For container
  • Commission event - For trade item
  • Decommission
  • Ship
  • Receive
  • Serial number request
  • DSCSA shipping
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.


In the following example, we are searching for all the messages that include the following product code and serial number: "(01)00133344445555(21)uOEn7XoP55jP".

  • There are three search results, and all of them are successful. 
  • One of the messages (Pack action) is expanded.
  • The system offers to download the file but it also displays the XML content.



In the following example, we are searching for all the messages that include the following SSCC code: "(00)001234560000000018". There are four search results with different statuses:



In the following example, we are searching for the DSCSA shipping message that contains the delivery ID "0080743615 " by using the search expression "urn:epcglobal:cbv:bt:4048846110008:0080743615".

  • There is one search result that is expanded.
  • The message is successful.
  • The system offers to download the file but it also displays the XML content.



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 on the channel name or the edit icon (Edit channel) next to the channel. The application displays the current channel settings and the log of incoming messages, by default.


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, for example, product code or serial number, and the list of messages is filtered based on the search criteria.


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)


Note: For verifications in the USA, the messages follow VRS 1.3. The supported context is DSCSA saleable return. The message contains the pack data, the contact email that is the support email on the channel, and the possession flag that is always “true”.

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 or the verification was not completed due to an error. 
MessageDisplays further information when the verification result is false. The message status is Success or Error.
Resend buttonIn case of an error, you can resend the verification request by clicking on the button.


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



Back to the list of procedures