ETIM xChange Validator

Free, no login, no file size limit. Upload an ETIM xChange JSON file and check schema validity, guideline rules, and ETIM 10.0 semantic issues.

Detects version from SchemaVersion field.

Learn more

Automatically detects xChange 2.0 (has SchemaVersion field) or 1.1 (no SchemaVersion field).

Schema

Auto

Validates against the detected version's JSON Schema.

Guideline

Version-matched

Runs guideline checks matching the detected version.

Semantic

ETIM 10.0 when classified

Validates ETIM class, feature, and value codes when EtimClassification is present.

  • This is the right choice for most files.
  • xChange 2.0 files must include a SchemaVersion field.

Drop your xChange JSON here or browse

Accepts ETIM xChange 1.1 and 2.0 JSON files. For BMEcat XML, use the ETIM BMEcat Validator.

Try it with a demo file

Download an official ETIM sample and drop it into the validator above.

Need help with a real file?

Example output

Passing input

pass
{
  "SchemaVersion": "2.0",
  "CatalogueType": "FULL",
  "CatalogueValidityStart": "2026-01-01",
  "Language": ["en-GB"],
  "Supplier": [{
    "SupplierName": "Acme Corp",
    "Product": [{
      "ProductIdentification": {
        "ManufacturerName": "Acme",
        "ManufacturerProductNumber": "A-100"
      }
    }]
  }]
}
  • Status: pass
  • Schema valid (xChange 2.0)
  • Guideline checks passed
  • 1 product

Failing input

fail
{
  "SchemaVersion": "2.0",
  "CatalogueType": "CHANGE",
  "Supplier": [{
    "SupplierName": "Acme Corp",
    "Product": []
  }]
}
  • Status: fail
  • /: missing required field "CatalogueValidityStart"
  • /: missing required field "Language"
  • ChangeReferenceCatalogueVersion is required
What this tool checks

JSON Schema validation checks structure against the official ETIM xChange schema (v1.1 or v2.0). This catches missing required fields, wrong data types, invalid enum values, and pattern mismatches.

Guideline checks enforce business rules beyond the schema: ChangeReferenceCatalogueVersion required for CHANGE catalogues, CurrencyCode required when trade items are present, feature value completeness, range pair consistency, and empty array warnings.

ETIM 10.0 semantic validation runs when the file includes EtimClassification. Validates class codes, feature assignments, and value codes against the full ETIM 10.0 model.

This tool validates ETIM xChange JSON files. For BMEcat ETIM XML, use the ETIM BMEcat Validator.

Learn more about ETIM xChange

Working with BMEcat XML instead? Use the ETIM BMEcat Validator for XSD, guideline, and ETIM 10.0 semantic checks on BMEcat ETIM 5.0.1 and 4.0.3 files.