Troubleshoot errors related to file parsing

This section covers errors related to feed format and structure.

They occur after the feed file has been downloaded, when Criteo attempts to read, split, and interpret the feed content.

These errors usually indicate invalid syntax, missing required fields, or unexpected feed structure.

Error code

Error message

Potential reason

How to fix it

CsvParsingError

CSV parsing failed

Malformed CSV

Re‑export the CSV using a standard format:

  • Fields must be surrounded by double quotes (")

  • Any double quote inside a field must be escaped by doubling it ("")

  • Ensure the delimiter is consistent across the file

DownloadSplitterZeroOutput

No products extracted

Feed structure mismatch

Verify feed structure and mapping rules.

JsonParsingError

JSON parsing failed

Invalid JSON structure

Validate JSON syntax and ensure a valid product array.

CsvMissingIdField

Missing product ID field

id column missing

Add a unique id field for each product.

XmlNoProductNode

No product node found

Incorrect XML structure

Ensure the correct product node exists (e.g. <product> or <item>).

XmlParsingError

XML parsing failed

Invalid or oversized product node

Validate XML and reduce product size if needed.

SplitterError

Error while splitting feed

Corrupted or truncated file

Ensure the feed file is fully generated and transferred.

TransformationError

Transformation failed

Invalid field values

Fix invalid or missing field values.

TransformationZeroOutput

No valid products

All products filtered out

Ensure mandatory attributes are populated.

FusionError

Product merge failed

Conflicting product IDs

Ensure product IDs are stable and unique.

CsvMalformed

Malformed CSV

Broken rows

Fix malformed lines and re‑export the feed.

CsvHeaderMissing

CSV header missing

Header row not present

Add a header row matching the expected schema.

CsvHeaderNotInLowerCase

Headers not lowercase

Uppercase column names

Convert all headers to lowercase.