{"schema":"https://ver.cy/schemas/card/1.0.0","id":"vr.wm-pol-026","code":"wm-pol-026-customs-declaration-clearance","url":"https://ver.cy/models/wm-pol-026-customs-declaration-clearance/","name":"Customs Declaration / Clearance","alternateNames":[],"kind":"world-model","status":"published","version":"0.3.0-research.1","language":"en","classifiers":{"family":"World Models","category":"Society, people and institutions","entryKind":"entity","plane":"","domain":["SOC.POL.CUS2"],"industry":["Cross-industry"],"navPath":"NAV.SOC.POL.CUS2","tags":["customs","declaration","clearance","soc.pol.cus2"],"facets":{}},"whatItIs":"A customs declaration is the formal statement by which a declarant places goods under a customs procedure, and clearance is the authority's handling of it through acceptance, assessment, control and release. The class covers the declaration record and its lifecycle; the goods, the consignment and the transport are separate records it refers to.","purpose":"Represent one customs declaration and its attributed processing, assessment and release evidence across revisions.","scope":{"in":["Declaration-specific identity, parties, procedure profile and line assertions","Supporting evidence, assessed amounts and financial conditions as references","Lodgement, authority responses, release scopes, amendment continuity and post-clearance links"],"out":["Goods, consignments, transport movements, parties, customs offices and tariff or legal-rule masters","Security summary filings, migration cases and border management policy as independent domains","Risk scoring, operational control tactics, enforcement, detention operations or controlled-item handling","Binding classification, origin or valuation decisions; tax calculation, payment, filing, legal advice and authorisation to release goods"],"boundaries":[{"neighbor":"WM-POL-006 Border / Customs / Migration","distinction":"Registry parent is a candidate domain alignment. This model specialises a declaration instance; border policy, migration and institutional operations remain external."},{"neighbor":"Goods, consignment and transport records","distinction":"Declaration lines reference these masters. A tariff code is a class, not line identity; release does not establish physical departure."},{"neighbor":"WM-REC-010 Decision / Approval Record","distinction":"Authority acts retain external identity and scope. A declaration can exist before any decision, and local receipt does not issue an approval."},{"neighbor":"WM-POL-017 Administrative Procedure / Case","distinction":"An audit, appeal or other administrative case is linked when present; the declaration is neither the complete case nor the procedure definition."},{"neighbor":"WCO Data Model and EUCDM","distinction":"Alignment targets only. No mapping, runtime dependency or exact schema conformance is implemented; conflicting EUCDM overview version labels remain unresolved."}]},"distinguishingFeatures":["The declaration is a legal statement with liability attached to the declarant, not just a transport document.","Its lifecycle runs through acceptance, assessment, control, release and discharge, each with its own record.","Amendments after acceptance are recorded as corrections rather than edits, because liability already attached.","Distinct from the commercial invoice and the transport documents it draws on."],"structure":{"bundles":[{"id":"POL026-B1","name":"Declaration content","description":"What was declared and by whom.","layers":[{"id":"POL026-B1-L1","name":"Declarant and procedure","description":"Who declares, in whose name, and under which procedure.","findings":[{"id":"POL026-F01","name":"Declaring parties","description":"Declarant, representative and the parties to the movement.","questions":[{"text":"Who is the declarant, and is a representative acting in their name?","id":"POL026-Q01"},{"text":"Which customs procedure and office does the declaration request?","id":"POL026-Q02"}]},{"id":"POL026-F02","name":"Goods declaration","description":"Classification, origin, value and quantity of the declared goods.","questions":[{"text":"Which commodity codes, descriptions and quantities are declared per item?","id":"POL026-Q03"},{"text":"Which declared origin and customs value, with which valuation method, apply?","id":"POL026-Q04"},{"text":"Which licences, permits or certificates are cited for restricted goods?","id":"POL026-Q05"}]}]}]},{"id":"POL026-B2","name":"Assessment and control","description":"What the authority did with it.","layers":[{"id":"POL026-B2-L1","name":"Assessment","description":"Duties, taxes and risk handling.","findings":[{"id":"POL026-F03","name":"Duty assessment","description":"The amounts assessed and the basis used.","questions":[{"text":"Which duties and taxes were assessed, and on which basis?","id":"POL026-Q06"},{"text":"Which preference or relief was claimed, and was it granted?","id":"POL026-Q07"}]},{"id":"POL026-F04","name":"Control outcome","description":"Documentary or physical control and its findings.","questions":[{"text":"Was the declaration selected for documentary or physical control, and with what finding?","id":"POL026-Q08"},{"text":"Were amendments or corrections made after acceptance, and by whom?","id":"POL026-Q09"}]}]}]},{"id":"POL026-B3","name":"Status and release","description":"How the declaration ended.","layers":[{"id":"POL026-B3-L1","name":"Clearance status","description":"Acceptance, release, rejection and discharge.","findings":[{"id":"POL026-F05","name":"Lifecycle status","description":"The current status of the declaration and the acts that set it.","questions":[{"text":"What is the declaration's current status, and which act set it?","id":"POL026-Q10"},{"text":"Were the goods released, detained or refused, and when?","id":"POL026-Q11"},{"text":"Has the procedure been discharged, and which obligations remain open?","id":"POL026-Q12"}]}]}]}]},"agentConduct":{"may":["Prepare and submit declarations with data traceable to the underlying commercial and transport records.","Report declaration status, assessed amounts and control outcomes to the declarant.","Propose a commodity classification with the reasoning and sources used.","Flag missing licences or inconsistencies before submission."],"mustNot":["Submit a declaration with a classification, origin or value that the evidence does not support.","Split or restructure consignments to obtain a lower duty or avoid a control.","Omit required licences, permits or restrictions from a declaration.","Alter an accepted declaration instead of filing a correction.","Facilitate movement of goods subject to prohibitions or sanctions."],"requiresHuman":["Signing or authorising submission of a declaration and accepting its liability.","Deciding how to respond to a control finding or a detention.","Settling a disputed classification, origin or valuation."]},"ethics":{"considerations":["Declarations carry legal liability, and errors expose the declarant to penalties.","Customs revenue funds public budgets, so misdeclaration shifts cost onto everyone.","Risk profiling can single out traders and travellers by origin rather than by behaviour.","Prohibitions at the border protect people, animals and heritage from real harm."],"affectedParties":["Declarants, importers and exporters","Customs administrations and inspectors","Consumers receiving the goods","Honest competitors in the same market"]},"owners":{"steward":"The customs compliance lead of the declarant, with the customs administration as authority of record.","roles":[{"name":"Declarant","responsibilities":["Provide supported assertions and evidence of capacity; review local proposals."]},{"name":"Authorised representative","responsibilities":["Act only within a current evidenced mandate and keep principal attribution."]},{"name":"Competent customs authority","responsibilities":["Own official acceptance, assessment, control and release assertions under the applicable profile."]},{"name":"Declaration data custodian","responsibilities":["Maintain local identity, evidence provenance and revision reconciliation without exercising public powers."]},{"name":"Records and access steward","responsibilities":["Apply recipient access, minimisation, retention and lawful hold policy."]},{"name":"Independent reviewer","responsibilities":["Review legal/profile applicability and conformance before operational adoption."]}],"masterSystems":["National customs declaration processing system","Customs broker or trade compliance system","Economic operator registration register"]},"relations":[{"target":"WM-POL-006","type":"aligned","note":"Candidate registry parent retained as domain context; no inherited executable border or migration semantics."},{"target":"WM-REC-010","type":"references","note":"Optional external authority acts, assessments and amendment/release decisions with identity and scope."},{"target":"WM-POL-017","type":"references","note":"Optional administrative review or audit case master; this model stores declaration-specific links only."},{"target":"Goods and consignment master","type":"references","note":"External master binding to be pinned by adopter; local lines carry allocations and assertions only."},{"target":"Party and customs-office masters","type":"references","note":"External actor and location identities with declaration-specific roles and mandate evidence."},{"target":"WCO Data Model","type":"aligned","note":"Version and information-package mapping must be pinned and tested before exchange."},{"target":"EU Customs Data Model","type":"aligned","note":"Regional mapping only; overview version conflict and national implementation remain open."},{"target":"WM-POL-006 Border / Customs / Migration","type":"neighbor","note":"Registry parent is a candidate domain alignment. This model specialises a declaration instance; border policy, migration and institutional operations remain external."},{"target":"Goods, consignment and transport records","type":"neighbor","note":"Declaration lines reference these masters. A tariff code is a class, not line identity; release does not establish physical departure."},{"target":"WM-REC-010 Decision / Approval Record","type":"neighbor","note":"Authority acts retain external identity and scope. A declaration can exist before any decision, and local receipt does not issue an approval."},{"target":"WM-POL-017 Administrative Procedure / Case","type":"neighbor","note":"An audit, appeal or other administrative case is linked when present; the declaration is neither the complete case nor the procedure definition."},{"target":"WCO Data Model and EUCDM","type":"neighbor","note":"Alignment targets only. No mapping, runtime dependency or exact schema conformance is implemented; conflicting EUCDM overview version labels remain unresolved."},{"target":"WM-POL-006","type":"parent"}],"interaction":{"identity":{"applicability":"required","items":["A declaration is identified by the movement reference number the customs system assigns on acceptance.","Parties are identified by economic operator registration numbers, such as EORI in the EU.","Declared items cite Harmonized System and national tariff codes rather than their own identifiers."]},"properties":{"applicability":"required","items":["Net and gross mass per item in kilogrammes, as declared and as verified.","Quantity in the supplementary unit the tariff requires, such as litres, pieces or square metres.","Customs value as a monetary amount with its currency and valuation method.","Number and identifiers of packages and containers covered.","Verified figures from a physical control are recorded separately from declared ones."]},"recognition":{"applicability":"optional","items":["A declaration record is marked by a movement reference number, a customs office and a procedure code.","Often confused with the transport document, the commercial invoice or the entry summary declaration."]},"capabilities":{"applicability":"required","items":["A declaration can be accepted, assessed, controlled, released and discharged.","Amounts and data can be corrected after acceptance through recorded amendments.","Status and release can be queried by the declarant and by entitled parties."]},"hazards":{"applicability":"required","items":["Misclassification or undervaluation leading to penalties and recovery of duty.","Goods detained at the border because a required licence was not declared.","Prohibited or sanctioned goods moving on an incomplete declaration.","Risk profiling that discriminates rather than targets behaviour."]},"interfaces":{"applicability":"required","items":["WCO Data Model for declaration data exchange with customs systems.","Harmonized System nomenclature of the World Customs Organization for classification.","UN/CEFACT and the WCO SAFE Framework for single window and supply chain data."]},"context":{"applicability":"required","items":["Used in import, export and transit, by traders, brokers, carriers and customs administrations.","The WTO Trade Facilitation Agreement and the Revised Kyoto Convention frame national customs law."]}},"sources":[{"title":"Revised Kyoto Convention - General Annex, Chapter 3","url":"https://www.wcoomd.org/en/topics/facilitation/instrument-and-tools/conventions/pf_revised_kyoto_conv/kyoto_new/gach3.aspx","note":"World Customs Organization"},{"title":"Agreement on Trade Facilitation","url":"https://www.wto.org/english/docs_e/legal_e/tfa-nov14_e.htm","note":"World Trade Organization"},{"title":"Customs declaration","url":"https://taxation-customs.ec.europa.eu/customs/customs-procedures-import-and-export/customs-operations/customs-declaration_en","note":"European Commission"},{"title":"WCO Data Model","url":"https://www.wcoomd.org/en/topics/facilitation/instrument-and-tools/tools/data-model.aspx","note":"World Customs Organization"},{"title":"What is the Harmonized System (HS)?","url":"https://www.wcoomd.org/en/topics/nomenclature/overview/what-is-the-harmonized-system.aspx","note":"World Customs Organization"},{"title":"Calculation of customs duties","url":"https://taxation-customs.ec.europa.eu/customs/common-customs-tariff-cct/calculation-customs-duties_en","note":"European Commission"},{"title":"Rules of origin for goods","url":"https://taxation-customs.ec.europa.eu/customs/rules-origin-goods_en","note":"European Commission"},{"title":"EU Customs Data Model (EUCDM)","url":"https://taxation-customs.ec.europa.eu/online-services/online-services-and-databases-customs/eu-customs-data-model-eucdm_en","note":"European Commission"},{"title":"WCO Data Model, World Customs Organization"},{"title":"International Convention on the Harmonized Commodity Description and Coding System, World Customs Organization"},{"title":"International Convention on the Simplification and Harmonization of Customs Procedures (Revised Kyoto Convention), WCO"}],"openQuestions":["Verify current legal instruments, amendments and transitional application for each adopting customs territory; resolve the EUCDM version conflict against released schemas and legal data requirements.","Create profile-specific nested schemas and conformance fixtures covering provisional IDs, multiple lines with one tariff code, partial or conditional release, late responses, denied amendments and lawful disposal.","Restore independent external review before any canonical or publishable-draft promotion; investigate procedure-specific export, transit, low-value and other exceptions separately.","Independent external review is absent; the separate local Codex self-audit cannot replace it.","Direct HTTP verification is blocked by the sandbox and has not been attempted; coordinator-run check_sources.py is required. Browser text access does not establish HTTP status, licensing or current legal applicability.","EUCDM overview cites both 7.0.11 and 7.0.1. Exact released schemas, national profiles and applicable code lists must be reconciled.","Full consolidated legal texts, treaty membership/implementation, national exceptions, retention rules and jurisdiction-specific deadlines require qualified review.","Nested schemas, data-element mappings, classifier edition pins and adversarial instance conformance fixtures remain incomplete.","Transit discharge, export exit, warehousing, reliefs, refunds, low-value, postal and traveller procedures require separate profiles; no operational controls are provided."],"resources":{"spec":"/models/wm-pol-026-customs-declaration-clearance/spec.yaml","agents":"/models/wm-pol-026-customs-declaration-clearance/AGENTS.md","source":"https://github.com/ver-cy/world-models/tree/feat/mega-model-registry/research/runs/wm-pol-026"},"provenance":{"origin":"world-models research","builtFrom":["models/wm-pol-026-customs-declaration-clearance/spec.yaml","ver-cy/world-models/card-supplements/wm-pol-026-customs-declaration-clearance.json"],"providers":["Codex"],"researchStatus":"reviewable-draft","generatedAt":"2026-10-06T12:11:26Z","builder":"tools/build_cards.py@1.0.0"},"completeness":{"sections":{"classifiers":"filled","whatItIs":"filled","purpose":"filled","distinguishingFeatures":"filled","structure":"filled","agentConduct":"filled","ethics":"filled","owners":"filled","relations":"filled","interaction.identity":"filled","interaction.properties":"filled","interaction.recognition":"filled","interaction.capabilities":"filled","interaction.hazards":"filled","interaction.interfaces":"filled","interaction.context":"filled","sources":"filled"},"notes":{"_supplement":"Sections authored in card supplement 1.0.0 by Claude (Opus 5.5) (2026-10-06, unreviewed). Written from the card's existing content and established practice in the field; no new sources were read. Unreviewed."},"score":1.0}}