Skip to content

Validation rules

The checks implemented in the current local engine, what triggers them, and the exact scope of each deterministic repair.

Structural rules

STRUCT-02

Unresolved replacement characters

Flags a mapped cell containing the � replacement character. The current engine does not guess or recover an unknown source encoding.

Blocking

Column rules

COL-01

Required columns present

Maps exact header names and known aliases, then reports destination-required fields that remain unmapped.

Blocking
COL-UNMAPPED

Unmapped source columns

Reports source columns with no destination mapping. They are omitted from the destination-shaped corrected CSV.

Info

Row rules

ROW-01

Duplicate identifiers

For destinations whose identifier is unique, matches it case-insensitively, keeps its first occurrence, and excludes later duplicates from corrected output. Shopify product Handles are not deduplicated.

Blocking
ROW-02

Empty mandatory cells

Flags blanks in mapped required fields. Vendor or Brand can be filled only when a dominant non-empty value exists in the current run; other blanks remain manual.

Blocking

Value rules

VAL-01

Price format

Converts a simple comma decimal such as 19,99 to 19.99. It does not strip currency symbols, append currency, or judge the business value.

Warning
VAL-EMAIL

Email casing

Lowercases mapped email values after trimming outer whitespace.

Warning
VAL-EMAIL-INVALID

Basic email syntax

Flags mapped email values that do not match a conservative local syntax check. It does not contact the mailbox or predict deliverability.

Blocking
VAL-COUNTRY

Supported country-name mapping

Converts a limited built-in set of country names to two-letter codes. Other values are preserved for manual review.

Warning

Size limits

SIZE-01

Local input limit

Rejects empty files and applies format-specific limits: CSV 25 MiB, XLSX 10 MiB, and XLS 5 MiB. Every current run validates and exports at most the first 100 non-empty data rows; files are not split automatically.

Info

Destination schemas

Shopify Products, Shopify Customers, WooCommerce, Google Merchant and Mailchimp each apply the shared rules above against their current core field definitions. These are focused schemas, not complete certifications of every rule maintained by each external platform.