FTP(S)
Stockeo can connect to an FTP server to automatically retrieve feeds from your supplier. Three protocols are supported: FTP, FTPS, and SFTP.
Connection Setup
Protocol
Choose ftp://, ftps://, or sftp://. Changing the protocol automatically updates the default port.
ftp://
Standard, unencrypted FTP. Credentials and file data are transmitted in plain text.
21
ftps://
FTP over TLS (encrypted). Stockeo handles both explicit and implicit TLS automatically. If your server uses a self-signed certificate, enable the Accept self-signed certificate option.
990
sftp://
SFTP over SSH — a completely separate protocol from FTP/FTPS. Supports password and private key authentication.
22
Host
Hostname or IP address of the server (e.g. files.example.com).
Port
Port number. Defaults: 21 for FTP, 990 for FTPS, 22 for SFTP.
Accept self-signed certificate
FTPS only. Enable this option if the server uses a self-signed TLS certificate.
Username
Your FTP/SFTP login name.
Password
Password for FTP, FTPS, and SFTP with password authentication.
Private Key
SFTP with private key authentication only. Paste the full contents of your OpenSSH private key (beginning with -----BEGIN OPENSSH PRIVATE KEY-----). The server must have the corresponding public key in its authorized_keys file.
File path
The File path field tells Stockeo where to look for product feed. It supports three formats, each producing different processing behaviour.
Static path
A fixed path to a single file.
Stockeo checks whether the file has been modified since the last run. If the file has not changed, it is skipped and the run is recorded as File has not changed since last run. If it has changed, the file is downloaded and processed.
Wildcard path
A path with * or ? wildcards in the filename.
Liquid path
A path containing Liquid expressions that are evaluated before the file lookup.
The Liquid expression is resolved to a concrete filename using the current date and time. This makes it possible to dynamically target files whose names contain timestamps, dates, or other calculated values.
For example, the path above would be resolved to:
In this case, you can make use of the Stockeo custom Liquid filter moment.
Firewall Whitelist
Stockeo connects to your FTP server from a fixed IP address. If your supplier's server is protected by a firewall, you or your supplier will need to whitelist the following IP:
Pass this address to whoever manages the FTP server so they can allow incoming connections from it.
Connecting and Testing
After filling in all fields, click Connect. Stockeo will establish a connection to the server and save the credentials.
If the file is not found at the given path, the connection still succeeds but a warning is shown next to the File path field. You can proceed with saving and Stockeo will look for the file again at the next scheduled run.
Once connected, the Edit button appears and all fields become read-only. Clicking Edit unlocks the fields so you can update the connection details.
Last updated