Overview

In Supplier Data Manager, Outputs define what files are generated at the end of a completed job. By default, two files are available to download when a job completes:

• A CSV file containing all the processed rows and columns for the completed job
• A CSV file containing all the rows deleted during the job

The screenshot above shows the default output files available for download at the end of a completed Supplier Data Manager job: one CSV for processed rows and one CSV for deleted rows.

When assets (media files) are imported, two additional outputs are automatically generated in ZIP format at the end of the job:

• Linked media: media files linked to at least one product. These can be automatically synced with Akeneo PIM during a Push operation.
• Orphan media: media files not linked to any product. These are not sent to Akeneo PIM.

For more information on managing media assets, see Manage your assets.

Interface

In Supplier Data Manager, Output Formats (OF) are listed and managed in each project's settings page.

The screenshot above shows the Output Formats list in a Supplier Data Manager project's settings page, displaying each configured Output Format with its name and step.

To access additional configuration controls for a specific Output Format, click the ➡️️ button next to it.

The screenshot above shows the expanded configuration panel for a Supplier Data Manager Output Format, with fields for Name, Step, Format, and Source.

Configuration

Each Output Format in Supplier Data Manager requires the following parameters:

• Name: An internal reference label for this Output Format. Can be anything meaningful to your team.
• Step: The step in the project after which the output will be generated.
• Format: Either Excel or CSV.

• Source: A dropdown that controls what data is included in the export. Available options:

• inter — The working sheet used internally during the step. Mostly useful for debugging.

• results — Stores the tags generated by the Extraction step.
• deleted — Fields and rows deleted during the step. All deleted rows across steps are combined into a single file at the end of the job.
• matched — Rows removed or filtered in the Match History step.
• input — The data the step received as input.
• output — The data the step sent to the next step. This source is used to generate the default output on the last step.
• export — Available in the Variant step only. Used to export either parent products or child variants.

Advanced configuration

When editing a specific Output Format in Supplier Data Manager, additional options are available for controlling the file encoding, the column separator (for CSV files), and the structure of individual sheets (for Excel files).

The sheets parameter is an array of Sheet objects. Each sheet has two properties:

• name: The name of the sheet (max 31 characters for Excel compatibility).

• fields: An array of field objects that control which columns appear in the sheet. Each field object supports the following properties:

• name: The identifier of the field. Set to null to include all available fields (catchall).

• required: Boolean. When true, the field is included in the output file as null even if the column is empty or does not exist in the data.
• template (optional): Formats the field value using a basic template syntax. The available variables are name and value. Example: "template": "{name} - {value}"
• type (optional): Either column (default) or constant. Use constant to add a static value to every row in the output.
• value: Required when type is constant. The static value to insert. Example: {"type": "constant", "value": "2024", "name": "year"}
• created_at_step (optional): Filters the field to only include values created at a specific step. Provide the step ID as an integer. Only valid when name is null.
• exclude (optional): A list of field names to exclude when using catchall (name: null). Only valid when name is null.

Webhooks

Supplier Data Manager supports project-level webhooks that send a POST request to a URL of your choice when specific events occur. Two triggers are available:

• Job Done — fires when a job completes all steps.
• Step Completed — fires when an individual step within a job completes.

To configure webhooks for a project, go to the Admin Panel and navigate to Connectors > Project webhooks.

The screenshot above shows the webhook configuration form in the Supplier Data Manager Admin Panel, with fields for URL, Headers, Project, and Trigger.

For full configuration details, payload structure, and delivery information, see Webhooks.

Retrieving outputs via FTP

If FTP access is enabled for your organization and user account in Supplier Data Manager, you can download output files over SFTP without going through the web application. When connected to the FTP server, navigate to the outputs directory. It lists all projects in your organization — navigate into a project directory to download all output files generated for its jobs.

For connection details, FTP setup instructions, and enabling FTP access, see Using FTP with Akeneo Supplier Data Manager.