Error Reference

This section documents all validation errors and warnings that dppvalidator can produce across its seven-layer validation architecture.

Error Code Categories

Prefix	Layer	Description
SCH	Schema	JSON Schema structural validation
PRS	Parsing	Input parsing and file handling
MOD	Model	Pydantic model type validation
JLD	JSON-LD	Context and term resolution errors
SEM	Semantic	Business logic and cross-field rules
VOC	Vocabulary	Controlled vocabulary and code lists
SIG	Signature	VC signature verification errors
VER	Version	UNTP version mismatch (engine pin vs declared payload version)
UPG	Upgrade shim	v0.6.x → v0.7.0 compat-shim warnings (lossy / synthesised / required)

Schema Rules (SCH)

Code	Severity	Description
SCH001	Warning	Schema not loaded or unavailable

Parsing Rules (PRS)

Code	Severity	Description
PRS001	Error	File not found
PRS002	Error	Invalid JSON syntax
PRS003	Error	Unsupported input type
PRS004	Error	Input exceeds size limit

JSON-LD Rules (JLD)

Code	Severity	Description
JLD001	Error	@context must be present and valid
JLD002	Warning	All terms must resolve during expansion
JLD003	Warning	Custom terms should use proper namespacing
JLD004	Warning	Context resolution failure (network)

Semantic Rules (SEM)

Code	Severity	Description
SEM001	Warning	Material mass fractions should sum to 1.0
SEM002	Error	validFrom must be before validUntil
SEM003	Error	Hazardous materials require safety information
SEM004	Warning	recycledContent should not exceed recyclableContent
SEM005	Info	At least one conformityClaim is recommended
SEM006	Warning	Item-level passports require serial numbers
SEM007	Warning	Emissions data should specify operational scope

Vocabulary Rules (VOC)

Code	Severity	Description
VOC001	Warning	Invalid ISO 3166-1 country code
VOC002	Warning	Invalid UNECE Rec20 unit code
VOC003	Warning	Material code must be valid per UNECE Rec 46
VOC004	Warning	HS code must be valid for product category
VOC005	Error	GTIN must have valid check digit

Version Rules (VER)

Code	Severity	Description
VER001	Error	UNTP version mismatch — engine schema_version vs payload version

Upgrade-shim Rules (UPG)

Emitted by dppvalidator.compat.upgrade_0_6_to_0_7.upgrade and the dppvalidator migrate / dppvalidator validate --upgrade-from CLI surfaces. See the migration guide for the full field rename / shape-change context.

Code	Severity	Description
UPG001	Warning / Info	Lossy — a v0.6 field has no v0.7 equivalent and was dropped (e.g. Product.registeredId).
UPG002	Warning / Info	Synthesised — a v0.7-required field was filled from a related v0.6 source and should be reviewed.
UPG003	Warning	Unmapped country code — wrapped structurally but the value will fail v0.7 validation.
UPG004	Error	Required v0.7 field is missing from the v0.6 source AND cannot be synthesised; provide manually.