The Secure File Transfer Protocol (SFTP) business channel helps in creating a connection between the SFTP server and the Movilitas.Cloud application.


Use the SFTP channel to upload reports that are created in the FMD Reports application or EPCIS files that are created in the Serialized Logistics application.


In this section, you will learn how to configure and view an SFTP channel.


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

  • FMD Reports
  • Serialized Logistics


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


List of Procedures



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

  • Enter the channel name in the search criteria field.
  • Select the status.
  • Select SFTP 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 SFTP as the source.N/A
4.4

Click 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 SFTP channel:



5. Provide the SFTP connection settings as explained in the table below:


ParameterDescription
SFTP HostEnter the SFTP host IP or URI address.
SFTP PortEnter the SFTP port.
SFTP UsernameEnter the SFTP username.
SFTP PasswordEnter the SFTP password.


6. Click Save Settings.


Example:



7. Validate the connection to the SFTP server by clicking SFTP Health Check button. The application displays the result and if something goes wrong, displays the reason.


If there is a connection error, make sure that you are connected to the Internet and you provide the correct data for your SFTP server.


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


Next Steps


Perform one of the following:

  • Select the SFTP channel in the FMD Reports application to upload scheduled reports to the SFTP server.
  • Select the SFTP channel for a client in the United Arab Emirates (UAE) in the Serialized Logistics application to upload EPCIS Tatmeen files to the SFTP server after shipping to the client.
  • Select the SFTP channel for a client in the United States of America (USA) in the Serialized Logistics application to upload DSCSA EPCIS files to the SFTP server after shipping to the client. The messages are logged on the channel.


Back to the list of procedures



Viewing the Messages to SFTP (DSCSA USA Only)


When shipping to a client in the USA, the generated DSCSA EPCIS files are uploaded to the SFTP server through the SFTP channel associated with the client. The uploads are logged on the 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. To search for an SFTP channel, use the search field and the filters:

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


Example:



6. Find the message 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 messages.


You can enter the purchase order ID or specific data from the file, for example, the instance identifier or an SGTIN. The list of messages is filtered based on the search criteria.


For the messages, the following parameters are displayed:


ParameterDescription
> (Expand) icon

You can view the details of the file upload.


After expanding the log:

  • You can view the status, the message type (DSCSA EPCIS), the date and time of sending, the purchase order ID, the file path, the correlation ID of the message (an auto-generated UUID), the file content, and the error message (if any).
  • You can download the file.
StatusStatus of the message:
  • Checkmark icon (Success) - The file is successfully uploaded to the SFTP server.
  • Exclamation mark icon (Error) - The file is not uploaded, an error occurred.
TypeThe type of the message. DSCSA EPCIS only.
Sent DatetimeThe date and time of sending.
Purchase order IDThe purchase order ID of the shipment. 
ErrorThe error message in case of a failed upload.


The following example illustrates a successfully uploaded DSCSA EPCIS file. The user can view and download the EPCIS.



Back to the list of procedures