ICS2 v3 ENS Validator

{
  "code": "File complete and in codebase: rosetta_core/ics2_ens.py (437 lines)\n\n## Key Components:\n- **Data structures**: ENSParty, ENSGoodsItem, ENSConsignment, ICS2Result (all dataclasses with provenance)\n- **validate_eori()**: EORI format validation (2-letter ISO + 1-15 alphanumeric)\n- **determine_filing_category()**: Transport mode → F10/F20/F30/F40/F44\n- **get_filing_deadline()**: Transport mode → deadline string per ICS2 Release 3\n- **validate_ens()**: Full ENS consignment validation returning (errors, warnings)\n  - Errors (blocking): transport_mode required, goods_items required, carrier EORI format, goods description\n  - Warnings (advisory): CN code 8 digits, gross mass positive, party EORI format, ports\n- **build_ens()**: Main entry — validates, determines filing category/deadline, computes totals, provenance\n- **build_ens_from_rosetta()**: Bridge from classify_hts() output → ENS. Extracts description, CN code, origin.\n\n## Constants:\n- FILING_CATEGORIES: F10 (air), F20 (maritime), F30 (road/rail), F40 (postal), F44 (express)\n- FILING_DEADLINES: per-mode (24h maritime containerized, 1h road, etc.)\n- EORI_PATTERN: regex for validation\n- ICS2_SOURCE: EU Regulation 2019/1583; ICS2 Release 3\n\n## Validation approach:\n- Errors = blocking (field required, format invalid)\n- Warnings = advisory (should have 8-digit CN, positive mass)\n- is_valid = (len(errors) == 0)\n- Full provenance chain with engine, source, transport_mode, items_validated",
  "content": "File complete and in codebase: rosetta_core/ics2_ens.py (437 lines)\n\n## Key Components:\n- **Data structures**: ENSParty, ENSGoodsItem, ENSConsignment, ICS2Result (all dataclasses with provenance)\n- **validate_eori()**: EORI format validation (2-letter ISO + 1-15 alphanumeric)\n- **determine_filing_category()**: Transport mode → F10/F20/F30/F40/F44\n- **get_filing_deadline()**: Transport mode → deadline string per ICS2 Release 3\n- **validate_ens()**: Full ENS consignment validation returning (errors, warnings)\n  - Errors (blocking): transport_mode required, goods_items required, carrier EORI format, goods description\n  - Warnings (advisory): CN code 8 digits, gross mass positive, party EORI format, ports\n- **build_ens()**: Main entry — validates, determines filing category/deadline, computes totals, provenance\n- **build_ens_from_rosetta()**: Bridge from classify_hts() output → ENS. Extracts description, CN code, origin.\n\n## Constants:\n- FILING_CATEGORIES: F10 (air), F20 (maritime), F30 (road/rail), F40 (postal), F44 (express)\n- FILING_DEADLINES: per-mode (24h maritime containerized, 1h road, etc.)\n- EORI_PATTERN: regex for validation\n- ICS2_SOURCE: EU Regulation 2019/1583; ICS2 Release 3\n\n## Validation approach:\n- Errors = blocking (field required, format invalid)\n- Warnings = advisory (should have 8-digit CN, positive mass)\n- is_valid = (len(errors) == 0)\n- Full provenance chain with engine, source, transport_mode, items_validated"
}