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

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