{
  "standard": "lending-deal-package-readiness",
  "code_lists_version": "0.8.0",
  "note": "First-class, versioned enumerations (Std-8) — versioned enumerations, following the pattern of mature industry data standards. A field bound to a list (catalogue `code_list`) must carry one of its codes as the value.",
  "lists": {
    "legal_form": {
      "definition": "Legal form of the applicant entity.",
      "codes": [
        {
          "code": "ltd",
          "label": "Private limited company"
        },
        {
          "code": "llp",
          "label": "Limited liability partnership"
        },
        {
          "code": "plc",
          "label": "Public limited company"
        },
        {
          "code": "partnership",
          "label": "General/small partnership (may be regulated credit — see entity gate)"
        },
        {
          "code": "sole_trader",
          "label": "Sole trader (may be regulated credit — see entity gate)"
        },
        {
          "code": "other",
          "label": "Other/unknown legal form"
        }
      ]
    },
    "provenance_kind": {
      "definition": "How a fact entered the pack.",
      "codes": [
        {
          "code": "verified",
          "label": "Checked against a named reference-data source"
        },
        {
          "code": "self-declared",
          "label": "Stated by the applicant"
        },
        {
          "code": "document",
          "label": "Backed by an uploaded document"
        },
        {
          "code": "not_collected",
          "label": "Not yet provided — honest absence, never fabricated"
        }
      ]
    },
    "field_tag": {
      "definition": "How a catalogue field is expected to be established.",
      "codes": [
        {
          "code": "verify",
          "label": "Checked against a source"
        },
        {
          "code": "declare",
          "label": "Applicant-stated"
        },
        {
          "code": "doc",
          "label": "Document upload"
        }
      ]
    },
    "readiness_status": {
      "definition": "The pack-level readiness verdict.",
      "codes": [
        {
          "code": "oven-ready",
          "label": "No required gaps"
        },
        {
          "code": "gaps-remaining",
          "label": "Required fields outstanding (listed in readiness.missing)"
        }
      ]
    },
    "conformance_level": {
      "definition": "Evidence level the pack conforms to.",
      "codes": [
        {
          "code": "L1-declared",
          "label": "Applicant-stated"
        },
        {
          "code": "L2-verified-core",
          "label": "No self-declared verify-fields; ≥1 verified fact"
        },
        {
          "code": "L3-attested",
          "label": "L2 + attested + oven-ready"
        }
      ]
    },
    "data_class": {
      "definition": "Data-protection classification of a field.",
      "codes": [
        {
          "code": "personal",
          "label": "Personal data under UK GDPR — controller obligations attach"
        }
      ]
    },
    "guarantee_type": {
      "definition": "Type of personal guarantee offered.",
      "codes": [
        {
          "code": "personal",
          "label": "Personal guarantee"
        },
        {
          "code": "limited",
          "label": "Limited guarantee (capped)"
        },
        {
          "code": "joint_several",
          "label": "Joint & several guarantee"
        }
      ]
    },
    "security_type": {
      "definition": "Security offered against the facility.",
      "codes": [
        {
          "code": "unsecured",
          "label": "Unsecured"
        },
        {
          "code": "secured_property",
          "label": "Secured on property"
        },
        {
          "code": "secured_asset",
          "label": "Secured on specific assets (asset finance)"
        },
        {
          "code": "debenture",
          "label": "Debenture / floating charge"
        },
        {
          "code": "guarantee_only",
          "label": "Personal guarantee only"
        }
      ]
    },
    "use_of_funds": {
      "definition": "Purpose category for the requested facility (the facility-purpose classification — authored v0, refine with funder input).",
      "codes": [
        {
          "code": "working_capital",
          "label": "Working capital / cashflow"
        },
        {
          "code": "equipment_assets",
          "label": "Equipment / asset purchase"
        },
        {
          "code": "vehicles",
          "label": "Vehicles / fleet"
        },
        {
          "code": "property_purchase",
          "label": "Commercial property purchase"
        },
        {
          "code": "property_development",
          "label": "Property development / conversion"
        },
        {
          "code": "fit_out",
          "label": "Fit-out / refurbishment"
        },
        {
          "code": "stock",
          "label": "Stock / inventory"
        },
        {
          "code": "refinance",
          "label": "Refinance / restructure existing debt"
        },
        {
          "code": "acquisition",
          "label": "Business acquisition / MBO / franchise"
        },
        {
          "code": "growth",
          "label": "Growth / expansion / hiring"
        },
        {
          "code": "tax",
          "label": "Tax / VAT / one-off liabilities"
        },
        {
          "code": "invoice_finance",
          "label": "Invoice / receivables finance",
          "note": "Legacy: invoice finance is a PRODUCT, not a purpose — prefer facility_type=invoice_discounting/factoring plus the underlying purpose here."
        },
        {
          "code": "other",
          "label": "Other (describe in the_ask.purpose)"
        }
      ]
    },
    "verification_source": {
      "definition": "Named sources a verified fact may cite — see reference-data.v0.json for registry detail.",
      "codes": [
        {
          "code": "companies_house",
          "label": "UK Companies House"
        },
        {
          "code": "fca_register",
          "label": "FCA Financial Services Register"
        },
        {
          "code": "gleif",
          "label": "GLEIF LEI registry"
        },
        {
          "code": "open_banking",
          "label": "UK Open Banking (consented account data)"
        },
        {
          "code": "sanctions_screen",
          "label": "Sanctions / PEP screening provider"
        },
        {
          "code": "disqualified_directors_register",
          "label": "CH disqualified-directors register"
        },
        {
          "code": "structuring_need_map",
          "label": "Deterministic product-structure map (producer-internal)"
        },
        {
          "code": "hmrc_vat",
          "label": "HMRC VAT registration checker"
        },
        {
          "code": "registry_trust",
          "label": "Register of Judgments, Orders and Fines (Registry Trust)"
        },
        {
          "code": "land_registry",
          "label": "HM Land Registry (title register)"
        },
        {
          "code": "accounting_api",
          "label": "Accounting system (Open Accounting — Codat or a direct Xero/QuickBooks/Sage connection)"
        }
      ]
    },
    "disposition_status": {
      "definition": "Funder response states for a submitted pack (disposition.schema.json). The disposition message is how 'the funder disposes' becomes machine-readable.",
      "codes": [
        {
          "code": "received",
          "label": "Pack received — acknowledgment only"
        },
        {
          "code": "in_review",
          "label": "Under review"
        },
        {
          "code": "info_requested",
          "label": "More information requested (field_ids listed)"
        },
        {
          "code": "declined",
          "label": "Declined (reason_code required)"
        },
        {
          "code": "offer_issued",
          "label": "Offer / indicative terms issued (terms travel outside this standard)"
        }
      ]
    },
    "decline_reason": {
      "definition": "Structured decline reasons — so a decline is actionable by the producer (and its chase engine) rather than free text.",
      "codes": [
        {
          "code": "outside_credit_appetite",
          "label": "Outside current credit appetite"
        },
        {
          "code": "insufficient_trading_history",
          "label": "Insufficient trading history"
        },
        {
          "code": "adverse_credit_history",
          "label": "Adverse credit history"
        },
        {
          "code": "insufficient_security",
          "label": "Insufficient or unsuitable security"
        },
        {
          "code": "affordability_not_evidenced",
          "label": "Affordability / serviceability not evidenced"
        },
        {
          "code": "sector_exclusion",
          "label": "Sector or activity exclusion"
        },
        {
          "code": "incomplete_pack",
          "label": "Pack incomplete (prefer info_requested where possible)"
        },
        {
          "code": "kyc_aml_not_satisfied",
          "label": "KYC / AML not satisfied"
        },
        {
          "code": "withdrawn_by_applicant",
          "label": "Withdrawn by the applicant"
        },
        {
          "code": "other",
          "label": "Other (detail in free text)"
        }
      ]
    },
    "facility_type": {
      "definition": "The debt product/instrument requested — the product taxonomy (distinct from use_of_funds, which classifies purpose).",
      "codes": [
        {
          "code": "term_loan",
          "label": "Term loan (secured or unsecured)"
        },
        {
          "code": "revolving_credit_facility",
          "label": "Revolving credit facility (RCF)"
        },
        {
          "code": "overdraft",
          "label": "Business overdraft"
        },
        {
          "code": "asset_finance_hp",
          "label": "Asset finance — hire purchase"
        },
        {
          "code": "asset_finance_lease",
          "label": "Asset finance — finance/operating lease"
        },
        {
          "code": "invoice_discounting",
          "label": "Invoice discounting (confidential or disclosed)"
        },
        {
          "code": "factoring",
          "label": "Factoring (credit control outsourced)"
        },
        {
          "code": "asset_based_lending",
          "label": "Asset-based lending (revolving, multi-asset borrowing base)"
        },
        {
          "code": "trade_finance",
          "label": "Trade finance (import/export, letters of credit)"
        },
        {
          "code": "bridging",
          "label": "Bridging finance (short-term, exit-led)"
        },
        {
          "code": "development_finance",
          "label": "Property development finance (staged drawdown)"
        },
        {
          "code": "mezzanine_subordinated",
          "label": "Mezzanine / subordinated debt"
        },
        {
          "code": "merchant_cash_advance",
          "label": "Merchant cash advance (receipts-linked)"
        },
        {
          "code": "sale_and_leaseback",
          "label": "Sale and leaseback"
        },
        {
          "code": "other",
          "label": "Other (describe in the_ask.purpose)"
        },
        {
          "code": "inventory_finance",
          "label": "Inventory / stock finance",
          "definition": "Facility advanced against stock on hand, ordinarily struck against net orderly liquidation value."
        }
      ]
    },
    "repayment_profile": {
      "definition": "The repayment shape sought for the facility.",
      "codes": [
        {
          "code": "amortising",
          "label": "Amortising (capital + interest)"
        },
        {
          "code": "interest_only",
          "label": "Interest only, capital at term"
        },
        {
          "code": "bullet",
          "label": "Bullet / single repayment at term"
        },
        {
          "code": "revolving",
          "label": "Revolving (draw, repay, redraw)"
        },
        {
          "code": "receipts_linked",
          "label": "Receipts-linked (repays as a share of takings)"
        }
      ]
    },
    "exit_strategy": {
      "definition": "How an exit-led facility (bridging, development) will be repaid at term.",
      "codes": [
        {
          "code": "sale_of_asset",
          "label": "Sale of the asset / completed units"
        },
        {
          "code": "refinance",
          "label": "Refinance onto a term facility"
        },
        {
          "code": "trading_receipts",
          "label": "Repayment from trading receipts"
        },
        {
          "code": "contracted_income",
          "label": "Contracted income (pre-sales, pre-lets, awarded contracts)"
        },
        {
          "code": "other",
          "label": "Other (describe in the_ask.purpose)"
        }
      ]
    },
    "property_tenure": {
      "definition": "Tenure of charged property.",
      "codes": [
        {
          "code": "freehold",
          "label": "Freehold"
        },
        {
          "code": "leasehold",
          "label": "Leasehold"
        },
        {
          "code": "long_leasehold",
          "label": "Long leasehold (typically 125+ years)"
        },
        {
          "code": "other",
          "label": "Other / mixed"
        }
      ]
    },
    "trade_direction": {
      "definition": "Direction of the funded trade flows.",
      "codes": [
        {
          "code": "import",
          "label": "Import"
        },
        {
          "code": "export",
          "label": "Export"
        },
        {
          "code": "both",
          "label": "Import and export"
        }
      ]
    },
    "finance_basis": {
      "definition": "Per-deal financing basis. Absent = conventional; sharia_compliant activates the sharia overlay (sector gate, structure evidence, S-ladder).",
      "codes": [
        {
          "code": "conventional",
          "label": "Conventional financing (the default)"
        },
        {
          "code": "sharia_compliant",
          "label": "Sharia-compliant financing (overlay active)"
        }
      ]
    },
    "sharia_structure": {
      "definition": "Islamic financing structures. The standard evidences the chosen structure's checkable requirements; it does not rule on the structures themselves — certification does.",
      "codes": [
        {
          "code": "murabaha",
          "label": "Murabaha (cost-plus sale — funder buys, owns, sells at disclosed cost + markup)"
        },
        {
          "code": "tawarruq",
          "label": "Tawarruq / commodity murabaha (monetisation via commodity purchase and sale)"
        },
        {
          "code": "ijara",
          "label": "Ijara (lease — funder owns and insures the asset)"
        },
        {
          "code": "ijara_muntahia_bittamleek",
          "label": "Ijara muntahia bittamleek (lease ending in ownership)"
        },
        {
          "code": "diminishing_musharaka",
          "label": "Diminishing musharaka (co-ownership + progressive buyout + rent on the funder's share)"
        },
        {
          "code": "musharaka",
          "label": "Musharaka (profit-and-loss-sharing partnership)"
        },
        {
          "code": "mudaraba",
          "label": "Mudaraba (investor capital + manager expertise, shared profit)"
        },
        {
          "code": "wakala",
          "label": "Wakala (agency — agent invests/collects for a fee)"
        },
        {
          "code": "istisna",
          "label": "Istisna (commissioned manufacture / construction)"
        },
        {
          "code": "salam",
          "label": "Salam (forward purchase, price paid up front)"
        },
        {
          "code": "other",
          "label": "Other (describe; certification names the structure)"
        }
      ]
    },
    "sharia_level": {
      "definition": "Sharia conformance ladder — mirrors L1/L2/L3. Coherence enforced by the reference validator.",
      "codes": [
        {
          "code": "S1-declared",
          "label": "Structure stated by the applicant"
        },
        {
          "code": "S2-structure-evidenced",
          "label": "Sector gate passed + all structure evidence present + sequence checks pass"
        },
        {
          "code": "S3-certified",
          "label": "S2 + board certificate for the template used (with named board + review date)"
        }
      ]
    },
    "sharia_excluded_sic": {
      "definition": "Deterministic sector gate: UK SIC 2007 prefixes excluded for sharia-compliant deals — a pack whose VERIFIED sic_codes match any prefix cannot carry finance_basis sharia_compliant. A floor, not a ceiling: codes catch what codes can catch; certification review covers the rest.",
      "codes": [
        {
          "code": "1101",
          "label": "Distilling and spirits"
        },
        {
          "code": "1102",
          "label": "Wine production"
        },
        {
          "code": "1103",
          "label": "Cider and fruit wines"
        },
        {
          "code": "1104",
          "label": "Other fermented beverages"
        },
        {
          "code": "1105",
          "label": "Beer production"
        },
        {
          "code": "1200",
          "label": "Tobacco products"
        },
        {
          "code": "2540",
          "label": "Weapons and ammunition"
        },
        {
          "code": "3040",
          "label": "Military fighting vehicles"
        },
        {
          "code": "4634",
          "label": "Wholesale of alcoholic beverages"
        },
        {
          "code": "4635",
          "label": "Wholesale of tobacco products"
        },
        {
          "code": "4726",
          "label": "Retail of tobacco products"
        },
        {
          "code": "6419",
          "label": "Conventional banking (interest-based deposit taking)"
        },
        {
          "code": "6492",
          "label": "Conventional credit granting (interest-based)"
        },
        {
          "code": "9200",
          "label": "Gambling and betting"
        }
      ]
    },
    "stock_valuation_basis": {
      "description": "How a stock figure is struck. Materially changes what it means to a funder.",
      "codes": [
        {
          "code": "cost",
          "label": "At cost"
        },
        {
          "code": "lower_of_cost_or_nrv",
          "label": "Lower of cost or net realisable value"
        },
        {
          "code": "net_realisable_value",
          "label": "Net realisable value"
        },
        {
          "code": "orderly_liquidation_value",
          "label": "Net orderly liquidation value (NOLV)"
        }
      ]
    },
    "performance_evidence_basis": {
      "label": "Performance evidence basis",
      "note": "Which operational system of record proves that work was done, for this borrower. A financeable asset is created at an operational moment the ledger records much later or never; this names the witness. Selects the matching vertical overlay.",
      "codes": [
        {
          "code": "proof_of_delivery",
          "label": "Proof of delivery (transport / logistics)",
          "definition": "A TMS holds a signed POD per job. Haulage, courier, distribution."
        },
        {
          "code": "approved_timesheet",
          "label": "Approved timesheet (recruitment / staffing)",
          "definition": "A pay-and-bill or ATS system holds client-approved timesheets. The agency pays workers weekly while the client pays on terms."
        },
        {
          "code": "certified_application",
          "label": "Certified payment application (construction)",
          "definition": "Contract administration software holds certified payment applications and retentions. ROADMAP - no adapter yet."
        },
        {
          "code": "none",
          "label": "No operational system of record",
          "definition": "Performance is not independently evidenced; the receivables position rests on the applicant's own statement."
        }
      ]
    }
  }
}