📘 Introduction

Mapping is a core step in ensuring that external data can be correctly interpreted and processed by DJUST. It defines how external fields (from a CSV file or REST API response) are linked to DJUST’s internal data model.

Without mapping, DJUST cannot understand where to place imported data or how to structure exported data.

This configuration is required for every import and export job to function properly.

• Import jobs: map source fields to DJUST’s fields.
• Export jobs: map DJUST’s internal fields to the expected output for external systems (eg. the API field of a payload)

⚙️ Functional behavior

You can manage mapping settings directly from DJUST Back Office in the Data Hub for each Job Configuration

When configuring a job, you must provide the name of each input field (API field or CSV column header) and link it to the corresponding DJUST column name in the target entity model.

Example: If your system has a field called "Supplier Reviews", and DJUST expects supplierRating, enter Supplier Reviews next to supplierRating.

💡

Mapping and Job Configuration

Mappings are entity-specific and must be aligned with the data required by each DJUST object (e.g., Product, Offer, Order).

For detailed information on the required fields for each data type, refer to the dedicated documentations for each entity in this section.

Transcoding

The transcoding system lets users define mappings that convert an input value to an output value for a given import job

Key use cases

• When configuring an import job, users may want to standardize incoming values so that data imported from external systems matches the naming or categorization conventions of the platform (e.g., normalizing Product or Variant names).
• When importing external identifiers, users may need to translate external system values into platform-compatible values (e.g., converting an external classification identifier to the expected internal one).

Business rules

• When a conversion is active for a mapping, the output value automatically replaces the input value.
• An output value can be associated with multiple input values.
• An input value can be associated with only one output value.
• The input value can be an empty string but cannot be null.
• Output values must be non-empty and non null.
• Custom Fields cannot use the transcoding conversion.

🛠️ API quicklinks

• Create one or several transcodings for a specific job: POST /v2/mapper/job/{jobId}/transcodings
• Fetch one transcoding from a specific jobGET /v2/mapper/job/{jobId}/transcodings/{id}
• Fetch a list of transcodings from a specific job GET /v2/mapper/job/{jobId}/transcodings
• Update a list of transcodings from a specific jobPUT /v2/mapper/job/{jobId}/transcodings
• Detele a transcoding for a specific jobDELETE /v2/mapper/job/{jobId}/transcoding/{id}