Using FTP with Akeneo Supplier Data Manager

Summary

Akeneo Supplier Data Manager (SDM) provides SFTP access so you can upload input files and retrieve output files programmatically, without using the web application. This is typically used for automated integrations such as ETL (Extract, Transform, Load) pipelines.

Despite the "FTP" label in the interface, SDM uses SFTP (SSH File Transfer Protocol) on port 22. Any SFTP client (such as FileZilla, Cyberduck, or WinSCP) is compatible.

Before you start

To use SFTP with Supplier Data Manager, FTP access must be enabled at two levels:

  • Organization level — an admin must enable the FTP Allowed setting for the organization in the SDM admin panel.
  • User level — FTP access must also be enabled for each individual user account.

Enabling FTP access at the user level without enabling it at the organization level will cause an error. Always enable the organization-level setting first.

Enabling SFTP access in Supplier Data Manager

Step 1: Enable FTP at the organization level

  1. In the SDM admin panel, open the Organization settings page.
  2. Check the Ftp allowed checkbox.
  3. Save your changes.

The SDM admin Organization settings page with the Ftp allowed checkbox that enables SFTP access at the organization level.

Step 2: Enable FTP at the user level

  1. In the SDM admin panel, open the User settings page for the relevant user.
  2. Check the ftp allowed checkbox.
  3. Save your changes.

The SDM admin User settings page with the ftp allowed checkbox that grants SFTP access to an individual user.

Switching organizations affects SFTP access

SFTP access is only available for your currently active organization.

Re-authorization required: If you switch organizations, your SFTP access will be removed. You will need to re-enable access for the new organization.

Active sessions: If an SFTP session stays open while you switch organizations, you might still be able to add files, but they will not be processed. Always reconnect your SFTP client after switching organizations to ensure your files are handled correctly.

Connecting to Supplier Data Manager via SFTP

Use the following connection details in your SFTP client:

Parameter Value
Host ftp.sdm.akeneo.cloud
User Your Supplier Data Manager login email
Password Your Supplier Data Manager login password
Port 22

An SFTP client connection dialog configured with the SDM host (ftp.sdm.akeneo.cloud), the user's login email, and port 22.

Uploading input files via SFTP

Once connected to Supplier Data Manager via SFTP, you will see two top-level directories: inputs and outputs.

To trigger a new job by uploading a file:

  1. Navigate to the inputs directory. It contains one subdirectory per project in your organization.
  2. Drop an input file (CSV or XLS format) into the subdirectory for the target project.

Uploading a valid file to a project directory automatically creates a new job for that project.

SFTP jobs do not support media files. Only CSV or XLS files are accepted.

If you use an ETL tool that writes files with a temporary name before renaming them (for example, files starting with .tmp- or ending with .loading), SDM will skip those intermediate files and only process the final renamed file. This ensures partial uploads are never processed as complete jobs.

The SDM SFTP inputs directory showing one subdirectory per project. Uploading an input file to a project directory triggers a new job.

Retrieving output files via SFTP

The outputs directory in Supplier Data Manager's SFTP server lists all projects in your organization. Navigate to a project subdirectory to download the output files generated by completed jobs for that project.

For information about output file formats and what each file contains, see Outputs.