Validation Results
Klervex validates your shipment data against deterministic business rules before generating documents.
How Validation Works
Validation is instant (under 1 second) and deterministic — the same data always produces the same result. There's no AI involved in validation, which means results are explainable and consistent.
Pass vs Fail
Pass
All rules satisfied. You can proceed to document generation.
Fail
One or more rules failed. Each failure includes:
- Rule name — Which rule failed
- Category — Validation category (HS Codes, Sanctions, Fields, etc.)
- Message — A specific, actionable error message
- Fix button — Navigates to the relevant field in the form
Validation Categories
| Category | What It Checks |
|---|---|
| Required Fields | All mandatory fields are present for the selected document types |
| HS Code | HS codes exist in the destination country's tariff schedule |
| Sanctions | Parties are not on OFAC SDN or other sanctions lists |
| Port Codes | Ports of loading/discharge are valid UN/LOCODE entries |
| Incoterms | Incoterms match the transport mode (e.g., FOB only for sea) |
| Values | Total value matches sum of line items, weights are consistent |
| Country Rules | Country-specific requirements (e.g., 10-digit HTS for US imports) |
| Document Rules | Document-specific field requirements |
Fixing Validation Errors
- Read the error message — it tells you exactly what's wrong
- Click Fix to jump to the relevant field
- Correct the value
- Click Validate again
You can fix and re-validate as many times as needed.
Example Errors
HS code 9999.99.9999 not found in US HTS schedule
→ Fix: Look up the correct HS code in HS Code Search
Port XXABC is not a valid UN/LOCODE
→ Fix: Select a valid port from the dropdown
Incoterms FOB is only valid for sea/inland waterway transport
→ Fix: Change Incoterms or transport mode
Exporter country is a sanctioned jurisdiction
→ Fix: Verify the exporter details are correct