Movilitas.Cloud application provides the LSPediA channel to establish a connection to LSPediA SFTP.


Movilitas.Cloud has an account in LSPediA service. The user only needs to give the company identifier (GLN) to receive files and a support email address to receive notifications about errors on the channel. The SFTP connection is automated, meaning that communication does not need human intervention. However, the users can monitor the incoming transactions (=from LSPediA) and the outgoing transactions (=to LSPediA).


Currently, the LSPediA channel can be used in the following application:

  • Serialized Logistics


List of Procedures


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



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

  • Enter the channel name in the search field.
  • Select the status.
  • Select LSPedia 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 LSPedia 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 LSPediA channel:



5. Provide the settings for the LSPediA 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 a link to the channel page where the error occurred.
Company identifierEnter the LSPediA company identifier of your company. The field identifies the receiver company in the inbound files and it is the GLN of the receiver company. Make sure that the same value is given in the SGLN format in the tenant settings.


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


Back to the list of procedures



Monitoring Incoming SFTP Transactions (Inbox)


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


Each transaction is logged on the channel:

  • Pending - In progress
  • 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 LSPediA channel, use the search field and the filters:

  • Enter the channel name in the search field.
  • Select the status.
  • Select LSPediA 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 LSPediA SFTP 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 click the refresh button in the top-right corner of the logs to see the latest transactions.


You can enter the file name, correlation ID, seller (sender) SGLN, or 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 seller SGLN, 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 transaction is logged for the supplier in the Serialized Logistics application, under the Site management --> Suppliers --> Uploads tab.
    • In the positive case, the items inside the file are created in the Serialized Logistics application. 
    • However, a successful transaction on the channel can still lead to an error in the Serialized Logistics application. Hence, we recommend you to verify whether the items are created in the Serialized Logistics application.
  • Red exclamation mark icon - The file is not processed, an error occurred.
Create DatetimeThe timestamp when the message was received from LSPediA SFTP. It is in the local time zone of the user.
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 LSPediA 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



Monitoring Outgoing SFTP Transactions (Outbox)


Movilitas.Cloud uploads the EPCIS files to LSPediA SFTP.


The transaction can take one of the following statuses:

  • Pending - In progress
  • 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 LSPediA channel, use the search field and the filters:

  • Enter the channel name in the search field.
  • Select the status.
  • Select LSPediA 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 LSPediA SFTP Transactions panel with the Inbox tab.


6. Select the Outbox tab. The application displays the list of outgoing transactions.


Example:



7. Find the transaction and expand the message for the details. You can click the refresh button in the top-right corner of the logs to see the latest transactions.


For the messages, the following parameters are displayed:


ParameterDescription
> (Expand) icon

You can view the details of the transaction.


After expanding the log, you can view the status, the date and time of sending, the sender GLN, the receiver GLN, the comments (if any), and the file size.

Status

Status of the message:

  • Pending - Sending the file is in progress.
  • Green checkmark icon - The file is successfully uploaded to LSPediA.
  • Red exclamation mark icon - An error occurred while uploading the file. 
Sent DatetimeThe timestamp when the message was sent to LSPediA. It is in the local time zone of the user.
SenderThe GLN of the sender.
ReceiverThe GLN of the receiver.
CommentsAn optional message providing further details about the error (if any).


In the following example, the transaction is successful.



Back to the list of procedures