Movilitas.Cloud application provides the AS2 channel to establish a connection to the Movilitas.Cloud AS2 service. The Movilitas.Cloud AS2 service interfaces with other AS2 platforms.


Only incoming traffic is supported.


Prerequisites:

  • The supplier that sends EPCIS files to Movilitas.Cloud must be onboarded on the Movilitas.Cloud AS2 service.
  • Movilitas.Cloud must also be onboarded on the supplier's AS2 platform.


Once the onboarding is performed and the channel is configured together with the application where the channel is used, the connection is automated, meaning that the communication does not need human intervention. However, the users can monitor and manage the incoming messages (=from the supplier).


Currently, the AS2 channel can be used in the following applications:

  • Serialized Logistics


List of Procedures


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



Configuring an AS2 Channel


Before You Begin


The supplier that sends EPCIS files to Movilitas.Cloud must be onboarded on Movilitas.Cloud AS2 service. The onboarding process of the supplier is performed by Movilitas.Cloud.


Movilitas.Cloud must also be onboarded on the supplier's AS2 platform. The onboarding process of Movilitas.Cloud is performed by the supplier.


To perform the complete onboarding process, contact Movilitas.Cloud Support.

 

If any side is not onboarded properly, the procedure below will not be effective and you cannot receive EPCIS files from your supplier.


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 AS2 channel or modify an existing one. Follow one of the procedures described in the table below.


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

To search for an AS2 channel, use the search field and the filters:

  • Enter the channel name in the search field.
  • Select the status.
  • Select AS2 as the source.
  • Select Business channel as the type.
4.2
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.		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.3
Enter a name for the channel and select AS2 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 AS2 channel:



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


ParameterAction
Support e-mailEnter the email address where Movilitas.Cloud can send notifications about errors on the channel. The email will contain the name of the AS2 channel with a link to the channel page where the error occurred.
GLNEnter the Global Location Number of your company (tenant). Make sure that the value points to the warehouse that you register in the Serialized Logistics application with its location number in the SGLN format.


Example:


 

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 AS2 channel.


Back to the list of procedures



Monitoring Incoming Transactions (Inbox)


Movilitas.Cloud checks for new EPCIS files every minute and processes the files. 


Each transaction is logged on the channel:

  • Green - Finished (Successful)
  • Red - Failed


If a transaction fails, the application sends a notification to the given support email address by email.


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

  • Enter the channel name in the search field.
  • Select the status.
  • Select AS2 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 Edit Channel page with the current channel settings and the AS2 Transactions panel with the Inbox tab.


Example:



6. Find the transaction by using the search field and expand the message for the details.


You can enter specific data from the file, for example, an SGTIN, 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) icon

You can view the details of the transaction.


After expanding the log:

  • You can view the status, the EPCIS file size, the file name, the file content, and the error message (if any).
  • For a successful transaction, you can go to the supplier's page in the Serialized Logistics application by clicking on the link in the Processed Items section.
Status

Status of the message:

  • Pending - Processing of the file is in progress.
  • Green checkmark icon - The file is successfully processed. The items inside the file are created in Movilitas.Cloud. The transaction with the items is logged for the supplier in the Serialized Logistics application, under the Site management --> Suppliers --> Uploads tab.
  • Red exclamation mark icon - The file is not processed, an error occurred.
Create DatetimeThe timestamp when the message was sent to Tatmeen.
SenderThe name of the supplier.
Correlation IDAn auto-generated UUID for the transaction.
Actions

For transactions that lead to an error on the channel, you can reprocess the EPCIS file after the error is resolved by clicking on the circular arrows (Re-process file) button in the Actions column.


The following table collects typical errors and their resolution.


ErrorResolution
Supplier with SGLN not found.1. Register the supplier master data with its location number in the SGLN format under the Serialized Logistics application --> Site management --> Suppliers tab.

2. Go to the AS2 channel, find the log that caused the error, and click on the circular arrows (Re-process file) button in the Actions column.
Non-whitespace before first tag.The received file is not an EPCIS file.

Send an EPCIS file to Movilitas.Cloud.


In the following example, the transaction is successful. The user can verify the processed items on the supplier's page by clicking on the Suppliers Page link:



In the following example, the transaction failed because the supplier is not registered with its SGLN in the Serialized Logistics application:



Back to the list of procedures