{ "standard": "lending-deal-package-readiness", "catalogue_version": "0.15.0", "note": "Canonical field catalogue — the source of truth for WHICH fields a deal package may carry. 14 sections, 181 fields. v0.10.0 adds OPEN ACCOUNTING: ledger-derived financials (turnover, net profit, gross margin, creditors, debtors, sync date) verified against an accounting API, alongside the declared and document-backed counterparts that were previously the only way to carry those facts. v0.9.0 completes the sharia evidence models — every named structure now carries its checklist (partnership, agency and forward structures included); only 'other' has no fixed checklist (the certificate defines its requirements). v0.8.0 (Std-11) adds OPT-IN sharia-compliant structuring: the_ask.finance_basis switch + the sharia_compliance evidence section + the sector gate + per-structure requirements (requirement-profiles overlay) + the S1/S2/S3 ladder — additive; conventional packs are untouched. v0.7.0 (adversarial-audit fix pass): datatypes are now ENFORCED by the reference validator and the generated strict schema; ratio normatively defined as a 0–1 proportion; dscr re-typed decimal (coverage multiple), active_officers re-typed text (verified summary). v0.6.0 takes every product line to implementation-grade depth (financials/banking/security/people deepened; trade_finance + card_receipts sections added; exit_strategy + borrowing_base_certificate land). v0.5.0 marks the party/asset sections (people, guarantor, security_assets) repeatable — see instance_note. v0.4.0 (Std-10) extends coverage across the debt spectrum (facility_type + the receivables / capital_structure / development sections; per-product requirement profiles live in requirement-profiles.v0.json). v0.3.0 (Std-7) upgraded the catalogue to a DATA DICTIONARY: every field carries a datatype and a definition; enum-valued fields bind to code-lists.v0.json via code_list; verify sources are defined in reference-data.v0.json. Datatype vocabulary (ENFORCED by the reference validator): string | text | monetary_amount (GBP unless stated; per-value multi-currency is a jurisdiction-profile roadmap item) | integer | decimal (unbounded number — coverage multiples like DSCR) | ratio (a PROPORTION as a decimal fraction in [0,1] — 0.7, never 70) | date (ISO 8601) | boolean | enum | document_ref | list_string | url. Base: AskVouch vouch-rag-api/dealpack/schema.py (7 sections, 38 fields), extended with: the 10-field guarantor section (concepts from SBA Form 413, US-government public domain — except ila_confirmation, a UK-specific independent-legal-advice field), plus three catalogue-level additions: lei (FIBO), dscr (UK Open Banking), use_of_funds_code. tag: verify=checked against a source | declare=applicant-stated | doc=upload. data_class: personal = personal data under UK GDPR — absent means the field is about the legal entity, not a person.", "namespace_note": "NAMESPACES (a three-namespace pattern proven in mature canonical data models): (1) CORE — every field in this catalogue. (2) JURISDICTION — jurisdiction profiles will localise labels/sources/requirements without forking the schema (UK-first today; a US profile swaps companies_house→state registries etc.). (3) EXTENSION — producers MAY carry additional fields prefixed x_ (e.g. x_lender_score); extension fields must still be {value, provenance} shaped, are ignored by conformance scoring, and are permitted by the reference validator.", "instance_note": "REPEATING GROUPS: sections marked repeatable:true may appear multiple times in one pack — the first instance uses the bare section id ('guarantor'), further instances are suffixed ':2', ':3', … ('guarantor:2'). Each instance carries its own fields with their own per-fact provenance (one guarantor verified while another is not_collected is representable). Non-repeatable sections appear at most once; readiness.missing entries may be instance-qualified ('guarantor:2.guarantor_id'). Enforced by the reference validator.", "entity_gate_note": "v0 readiness claims are CORPORATE-ONLY: a pack whose entity is not ltd/llp/plc cannot claim oven-ready, attested, or conformance L2+ (enforced by the reference validator). sole_trader and small-partnership lending can be a regulated credit agreement (RAO art 60B, subject to the art 60C exemptions; partnerships via art 60L) — such packs may relate to a regulated credit agreement, implementers effecting introductions need credit-broking permission, and a dedicated regulated-agreement profile is future work not covered by v0.", "data_protection_note": "This standard defines a data STRUCTURE, not a lawful basis. Packs carry personal data (director and guarantor identity, personal financials, screening results). The party assembling or receiving a pack is a controller in its own right under UK GDPR and must establish lawful basis, retention, and security independently. Screening results (sanctions/PEP) are informational to the receiver: they do NOT discharge the receiving firm's own MLR 2017 customer-due-diligence obligations (reliance requires an explicit MLR reg 39 arrangement).", "requirement_profile": "baseline-v0", "requirement_profile_note": "The MINIMUM fields a pack must PROVIDE (present, not not_collected) to be oven-ready under the baseline profile. Per-product-type profiles (secured vs unsecured, asset finance) are follow-up work. A required field left not_collected must appear in readiness.missing — enforced by the reference validator. Guarantor/lei/dscr etc. are deliberately NOT required in v0.", "required_fields": [ "business_identity.company_name", "business_identity.company_number", "business_identity.legal_form", "financials.statutory_accounts", "banking.bank_statements", "the_ask.amount", "the_ask.purpose", "declarations.truth_statement" ], "sections": [ { "id": "business_identity", "title": "Business identity", "fields": [ { "id": "company_name", "label": "Registered company name", "tag": "verify", "source": "companies_house", "datatype": "string", "definition": "The entity's registered legal name as recorded at Companies House (not a trading name)." }, { "id": "company_number", "label": "Company number", "tag": "verify", "source": "companies_house", "datatype": "string", "definition": "The Companies House registration number (8 characters, incl. SC/NI/OC prefixes)." }, { "id": "legal_form", "label": "Legal form (ltd / llp / plc / partnership / sole trader / other — readiness claims are corporate-only in v0, see entity_gate_note; Companies House verifies registered entities only)", "tag": "verify", "source": "companies_house", "datatype": "enum", "code_list": "legal_form", "definition": "The applicant's legal form, normalised to the legal_form code list." }, { "id": "company_status", "label": "Company status", "tag": "verify", "source": "companies_house", "datatype": "string", "definition": "The registrar's current status for the entity (e.g. active, dissolved, liquidation)." }, { "id": "incorporation_date", "label": "Incorporation date", "tag": "verify", "source": "companies_house", "datatype": "date", "definition": "The date the entity was incorporated/registered." }, { "id": "sic_codes", "label": "Nature of business (SIC codes)", "tag": "verify", "source": "companies_house", "datatype": "list_string", "definition": "UK SIC 2007 classification codes recorded for the entity (see reference-data: sic_codes)." }, { "id": "lei", "label": "Legal Entity Identifier (LEI)", "tag": "verify", "source": "gleif", "datatype": "string", "definition": "ISO 17442 20-character Legal Entity Identifier, where the entity holds one (optional for SME packs)." }, { "id": "trading_name", "label": "Trading name (if different)", "tag": "declare", "datatype": "string", "definition": "The name the business trades under when it differs from the registered name." }, { "id": "website", "label": "Website", "tag": "declare", "datatype": "url", "definition": "The business's primary public website." }, { "id": "registered_address", "label": "Registered office address", "tag": "verify", "source": "companies_house", "datatype": "text", "definition": "The registered office address as recorded at the company registry." }, { "id": "trading_address", "label": "Principal trading address", "tag": "declare", "datatype": "text", "definition": "The address the business actually trades from, where different from the registered office." }, { "id": "vat_number", "label": "VAT registration number", "tag": "verify", "source": "hmrc_vat", "datatype": "string", "definition": "UK VAT registration number, checkable against the HMRC VAT registration checker." }, { "id": "employee_count", "label": "Number of employees", "tag": "declare", "datatype": "integer", "definition": "Current headcount including working directors." }, { "id": "business_description", "label": "Business description", "tag": "declare", "datatype": "text", "definition": "What the business does, in the applicant's own words — products, customers, channels." } ] }, { "id": "financials", "title": "Financials", "fields": [ { "id": "turnover", "label": "Annual turnover (latest year)", "tag": "declare", "datatype": "monetary_amount", "definition": "Revenue for the most recent 12-month period, GBP." }, { "id": "months_trading", "label": "Months trading", "tag": "declare", "datatype": "integer", "definition": "Number of months the business has been trading (may differ from incorporation age)." }, { "id": "accounts_overdue", "label": "Accounts filed on time at Companies House", "tag": "verify", "source": "companies_house", "datatype": "string", "definition": "Whether statutory filings are up to date at the registrar ('up to date' / 'overdue')." }, { "id": "net_profit", "label": "Net profit (latest year)", "tag": "declare", "datatype": "monetary_amount", "definition": "Net profit for the most recent financial year, GBP (negative = loss)." }, { "id": "statutory_accounts", "label": "Last filed statutory accounts (PDF)", "tag": "doc", "datatype": "document_ref", "definition": "The most recent filed statutory accounts." }, { "id": "management_accounts", "label": "Management accounts (less than 3 months old)", "tag": "doc", "datatype": "document_ref", "definition": "Recent management accounts (P&L + balance sheet), no older than 3 months." }, { "id": "cashflow_forecast", "label": "12-month cashflow forecast", "tag": "doc", "datatype": "document_ref", "definition": "Forward cashflow projection covering at least 12 months." }, { "id": "business_plan", "label": "Business plan", "tag": "doc", "datatype": "document_ref", "definition": "The business plan supporting the ask, where the product/amount warrants one." }, { "id": "accounts_reference_date", "label": "Latest accounts made-up-to date", "tag": "verify", "source": "companies_house", "datatype": "date", "definition": "The made-up-to date of the most recent filed accounts, per the company registry." }, { "id": "aged_creditor_ledger", "label": "Aged creditor ledger", "tag": "doc", "datatype": "document_ref", "definition": "Aged creditors report at the most recent month end — the mirror of the debtor book: who the business owes and how old the balances are." }, { "id": "creditor_days", "label": "Average creditor days", "tag": "declare", "datatype": "integer", "definition": "Average days the business takes to pay its suppliers." }, { "id": "vat_returns", "label": "Recent VAT returns", "tag": "doc", "datatype": "document_ref", "definition": "The last four quarterly VAT returns — a low-friction cross-check on declared turnover." }, { "id": "hmrc_arrears", "label": "HMRC arrears / Time-to-Pay", "tag": "declare", "datatype": "text", "definition": "Any PAYE/VAT/CT arrears and any Time-to-Pay arrangement in place ('none' is a valid answer). HMRC arrears rank ahead of most creditors and lenders price them." }, { "id": "ccj_history", "label": "County court judgments", "tag": "verify", "source": "registry_trust", "datatype": "text", "definition": "CCJs registered against the entity, per the public Register of Judgments, Orders and Fines — satisfied and unsatisfied." }, { "id": "accountant_details", "label": "Acting accountant", "tag": "declare", "datatype": "string", "definition": "Name and firm of the accountant who prepares the accounts — funders routinely verify accounts provenance with them." }, { "id": "accounting_consent", "label": "Accounting-data consent given", "tag": "declare", "datatype": "boolean", "definition": "Whether the applicant has connected their accounting system so figures can be read directly. Unlike open banking, accounting-data sharing is commercial API access, not a statutory right." }, { "id": "accounting_turnover_12m", "label": "Turnover, last 12 months (from accounting system)", "tag": "verify", "source": "accounting_api", "datatype": "monetary_amount", "definition": "Turnover for the trailing 12 months read from the applicant's accounting ledger. The verified counterpart to the declared turnover field." }, { "id": "accounting_net_profit_12m", "label": "Net profit, last 12 months (from accounting system)", "tag": "verify", "source": "accounting_api", "datatype": "monetary_amount", "definition": "Net profit for the trailing 12 months read from the accounting ledger." }, { "id": "accounting_gross_margin", "label": "Gross margin (from accounting system)", "tag": "verify", "source": "accounting_api", "datatype": "ratio", "definition": "Gross margin as a decimal fraction in [0,1], derived from ledger revenue and cost of sales." }, { "id": "accounting_creditors_total", "label": "Total trade creditors (from accounting system)", "tag": "verify", "source": "accounting_api", "datatype": "monetary_amount", "definition": "Total outstanding trade creditors at the sync date — the verified counterpart to the aged creditor ledger upload." }, { "id": "accounting_last_sync", "label": "Accounting data last synced", "tag": "verify", "source": "accounting_api", "datatype": "date", "definition": "The date the accounting figures in this pack were read. Consumers SHOULD apply their own freshness policy to it, as with any verified fact." } ] }, { "id": "banking", "title": "Banking", "note": "The open_banking-sourced fields define the TARGET shape; a producing system may not yet have a live open-banking integration (AskVouch's is not yet wired) — in that case these fields are emitted as not_collected, never fabricated.", "fields": [ { "id": "bank_provider", "label": "Business current-account provider", "tag": "declare", "datatype": "string", "definition": "The bank holding the business's primary current account." }, { "id": "bank_statements", "label": "Last 6 months' business bank statements", "tag": "doc", "datatype": "document_ref", "definition": "Business bank statements covering the most recent 6 months." }, { "id": "monthly_credit_turnover", "label": "Average monthly credit turnover", "tag": "verify", "source": "open_banking", "datatype": "monetary_amount", "definition": "Average monthly credits into the business account (consented open-banking read), GBP." }, { "id": "existing_repayments", "label": "Existing loan repayments and standing orders", "tag": "verify", "source": "open_banking", "datatype": "monetary_amount", "definition": "Aggregate monthly outflow to existing credit commitments, GBP." }, { "id": "dscr", "label": "Debt service coverage ratio (affordability)", "tag": "verify", "source": "open_banking", "datatype": "decimal", "definition": "Debt-service coverage ratio: net operating income ÷ total debt service, derived from consented account data. A coverage MULTIPLE (e.g. 1.25) — datatype decimal, not ratio, because it routinely exceeds 1." }, { "id": "statements_months_provided", "label": "Months of statements provided", "tag": "declare", "datatype": "integer", "definition": "How many months of business bank statements the pack's bank_statements document covers." }, { "id": "average_monthly_balance", "label": "Average monthly balance", "tag": "verify", "source": "open_banking", "datatype": "monetary_amount", "definition": "Average cleared balance over the statement period, from consented bank data." }, { "id": "returned_items_count", "label": "Returned / unpaid items", "tag": "verify", "source": "open_banking", "datatype": "integer", "definition": "Count of returned direct debits, bounced payments and unpaid items over the last 6 months — a primary affordability distress signal." }, { "id": "other_banking_relationships", "label": "Other banking relationships", "tag": "declare", "datatype": "text", "definition": "Other business accounts or lenders the business banks with ('none' is a valid answer)." }, { "id": "open_banking_consent", "label": "Open banking consent given", "tag": "declare", "datatype": "boolean", "definition": "Whether the applicant has consented to connect account data via open banking for verification." } ] }, { "id": "security_assets", "title": "Security & assets", "repeatable": true, "fields": [ { "id": "security_offered", "label": "Security offered (unsecured / secured / asset)", "tag": "declare", "datatype": "enum", "code_list": "security_type", "definition": "The security basis proposed for the facility, per the security_type code list." }, { "id": "charges_register", "label": "Existing charges & debentures on the company", "tag": "verify", "source": "companies_house", "datatype": "text", "definition": "Summary of charges registered against the entity (classification, status, persons entitled)." }, { "id": "property_address", "label": "Property address (if secured on property)", "tag": "declare", "datatype": "text", "definition": "Address of the property offered as security, where applicable." }, { "id": "valuation_report", "label": "Property valuation (RICS report)", "tag": "doc", "datatype": "document_ref", "definition": "A RICS (or equivalent) valuation of the security property." }, { "id": "asset_schedule", "label": "Asset schedule (asset finance)", "tag": "declare", "datatype": "text", "definition": "Schedule of the assets being financed or offered as security." }, { "id": "buildings_insurance", "label": "Buildings insurance", "tag": "doc", "datatype": "document_ref", "definition": "Evidence of buildings insurance over the security property." }, { "id": "title_number", "label": "Land registry title number", "tag": "verify", "source": "land_registry", "datatype": "string", "definition": "The registered title number of charged property, checkable against the land register." }, { "id": "tenure", "label": "Property tenure", "tag": "declare", "datatype": "enum", "definition": "Tenure of the charged property.", "code_list": "property_tenure" }, { "id": "lease_years_remaining", "label": "Lease years remaining", "tag": "declare", "datatype": "integer", "definition": "Unexpired lease term where tenure is leasehold — short unexpired terms constrain lending." }, { "id": "estimated_value", "label": "Estimated value", "tag": "declare", "datatype": "monetary_amount", "definition": "The applicant's estimate of the asset's value, pending the valuation_report." }, { "id": "existing_charge_ranking", "label": "Existing charges and ranking sought", "tag": "declare", "datatype": "text", "definition": "Charges already registered against this asset and the ranking the new lender is being offered (first, second, …)." }, { "id": "ltv_requested", "label": "Loan-to-value requested", "tag": "declare", "datatype": "ratio", "definition": "Requested facility as a proportion of the asset's estimated value." }, { "id": "asset_make_model", "label": "Asset make and model", "tag": "declare", "datatype": "string", "definition": "For financed plant/vehicles/equipment: manufacturer and model." }, { "id": "asset_identifier", "label": "Asset identifier", "tag": "declare", "datatype": "string", "definition": "Serial number, VIN, or registration identifying the specific financed asset." }, { "id": "asset_age_years", "label": "Asset age (years)", "tag": "declare", "datatype": "integer", "definition": "Age of the financed asset — drives residual value and maximum term." }, { "id": "supplier_invoice", "label": "Supplier invoice / quote", "tag": "doc", "datatype": "document_ref", "definition": "The supplier's invoice or quotation for the asset being financed." }, { "id": "outstanding_charges_count", "label": "Outstanding charges (count)", "tag": "verify", "source": "companies_house", "datatype": "integer", "definition": "Number of UNDISCHARGED charges registered against the company at Companies House. Satisfied charges are excluded: they are discharged history and do not encumber the security. Zero is a positive, recorded fact - unencumbered security is the good case and should not have to be inferred from an absence." } ] }, { "id": "people", "title": "People", "repeatable": true, "fields": [ { "id": "active_officers", "label": "Active directors and officers", "tag": "verify", "source": "companies_house", "datatype": "text", "data_class": "personal", "definition": "The entity's active directors/officers as recorded at Companies House — a verified summary (count and/or names)." }, { "id": "director_disqualified", "label": "Directors not on the disqualified register", "tag": "verify", "source": "disqualified_directors_register", "datatype": "string", "data_class": "personal", "definition": "Result of checking each director against the disqualified-directors register." }, { "id": "sanctions_pep", "label": "Sanctions / PEP screen on directors", "tag": "verify", "source": "sanctions_screen", "datatype": "string", "data_class": "personal", "note": "Informational only — see data_protection_note. A structured result object (provider, list version, screened_at, result, match refs) replaces this bare string in a future minor version.", "definition": "Outcome of sanctions/PEP screening across the entity's directors." }, { "id": "director_id", "label": "Director photo ID (passport / driving licence)", "tag": "doc", "datatype": "document_ref", "data_class": "personal", "definition": "Photographic identity document for the relevant director(s)." }, { "id": "director_address_proof", "label": "Director proof of address (under 3 months)", "tag": "doc", "datatype": "document_ref", "data_class": "personal", "definition": "Proof of residential address for the relevant director(s), no older than 3 months." }, { "id": "psc_register", "label": "Persons with significant control", "tag": "verify", "source": "companies_house", "datatype": "text", "definition": "The PSC register entries for the company — who ultimately owns or controls it.", "data_class": "personal" }, { "id": "shareholding_percent", "label": "Shareholding", "tag": "declare", "datatype": "ratio", "definition": "This person's shareholding in the applicant.", "data_class": "personal" }, { "id": "role_title", "label": "Role", "tag": "declare", "datatype": "string", "definition": "This person's role in the business (e.g. managing director, finance director).", "data_class": "personal" }, { "id": "industry_experience_years", "label": "Industry experience (years)", "tag": "declare", "datatype": "integer", "definition": "Years of relevant sector experience — a standard underwriting factor for newer businesses.", "data_class": "personal" }, { "id": "credit_search_consent", "label": "Personal credit search consent", "tag": "declare", "datatype": "boolean", "definition": "Whether this person has consented to a personal credit search where the funder requires one.", "data_class": "personal" } ] }, { "id": "guarantor", "title": "Guarantor & personal financials", "repeatable": true, "note": "Concepts derived from SBA Form 413 (Personal Financial Statement) + SBA 1919 principals — US-government public-domain works. Closes the biggest gap in dealpack v0: commercial lending almost always needs a personal guarantee + the guarantor's net worth. REGULATORY NOTE: a guarantor is a natural person — where the underlying agreement is (or may be) regulated, FCA Consumer Duty, CONC guarantor provisions, and vulnerable-customer obligations attach to implementers. Where a guarantee may be SECURED ON A DWELLING, the regulated-mortgage analysis applies — the ila_confirmation field exists to evidence independent legal advice.", "fields": [ { "id": "guarantee_required", "label": "Personal guarantee required (yes / no)", "tag": "declare", "datatype": "boolean", "definition": "Whether the facility under discussion requires a personal guarantee." }, { "id": "guarantee_type", "label": "Guarantee type (personal / limited / joint & several)", "tag": "declare", "datatype": "enum", "code_list": "guarantee_type", "definition": "The form of guarantee offered, per the guarantee_type code list." }, { "id": "guarantee_amount", "label": "Amount guaranteed", "tag": "declare", "datatype": "monetary_amount", "definition": "The amount of the guarantee, GBP (the cap, for a limited guarantee)." }, { "id": "guarantor_name", "label": "Guarantor name", "tag": "declare", "datatype": "string", "data_class": "personal", "definition": "Full name of the guarantor (a natural person)." }, { "id": "guarantor_id", "label": "Guarantor photo ID + proof of address", "tag": "doc", "datatype": "document_ref", "data_class": "personal", "definition": "Identity and address evidence for the guarantor." }, { "id": "guarantor_net_worth", "label": "Guarantor net worth (assets minus liabilities)", "tag": "declare", "datatype": "monetary_amount", "data_class": "personal", "definition": "The guarantor's stated net worth: total assets minus total liabilities, GBP (SBA-413 'Net Worth' concept)." }, { "id": "personal_financial_statement", "label": "Personal financial statement (assets, liabilities, income — SBA-413 style)", "tag": "doc", "datatype": "document_ref", "data_class": "personal", "definition": "A personal financial statement itemising the guarantor's assets, liabilities and income." }, { "id": "guarantor_homeowner", "label": "Homeowner status / property equity (NOTE: sizing a guarantee against a dwelling can trip the regulated-mortgage perimeter — see section note)", "tag": "declare", "datatype": "text", "data_class": "personal", "definition": "Whether the guarantor owns their home and the indicative equity available (regulated-mortgage trip-wire — see section note)." }, { "id": "ila_confirmation", "label": "Independent legal advice confirmation (where guarantee secured on a dwelling)", "tag": "doc", "datatype": "document_ref", "data_class": "personal", "definition": "Evidence the guarantor took independent legal advice, where the guarantee is secured on a dwelling." }, { "id": "guarantor_sanctions_pep", "label": "Sanctions / PEP screen on the guarantor", "tag": "verify", "source": "sanctions_screen", "datatype": "string", "data_class": "personal", "note": "Informational only — see data_protection_note. Structured result object lands in a future minor version.", "definition": "Outcome of sanctions/PEP screening on the guarantor." } ] }, { "id": "the_ask", "title": "The ask", "fields": [ { "id": "amount", "label": "Amount requested", "tag": "declare", "datatype": "monetary_amount", "definition": "The facility amount requested, GBP." }, { "id": "purpose", "label": "What the money is for", "tag": "declare", "datatype": "text", "definition": "Free-text description of what the funds will be used for (categorised by use_of_funds_code)." }, { "id": "facility_type", "label": "Facility type requested", "tag": "declare", "datatype": "enum", "code_list": "facility_type", "definition": "The debt product requested, per the facility_type code list. Selects the requirement profile (see requirement-profiles.v0.json)." }, { "id": "use_of_funds_code", "label": "Use-of-funds category", "tag": "declare", "datatype": "enum", "code_list": "use_of_funds", "note": "Catalogue-level addition (not yet in AskVouch dealpack v0); the code list is defined in code-lists.v0.json.", "definition": "The purpose category for the facility, per the use_of_funds code list." }, { "id": "candidate_products", "label": "Candidate product structures for that purpose", "tag": "verify", "source": "structuring_need_map", "datatype": "text", "definition": "Product structures deterministically mapped as candidates for the stated purpose (never a recommendation or ranking)." }, { "id": "term_months", "label": "Repayment period wanted (months)", "tag": "declare", "datatype": "integer", "definition": "The requested repayment term, in months." }, { "id": "deposit_contribution", "label": "Deposit / own money going in", "tag": "declare", "datatype": "monetary_amount", "definition": "The applicant's own contribution to the transaction, GBP." }, { "id": "repayment_profile", "label": "Repayment profile", "tag": "declare", "datatype": "enum", "definition": "The repayment shape sought.", "code_list": "repayment_profile" }, { "id": "exit_strategy", "label": "Exit strategy", "tag": "declare", "datatype": "enum", "definition": "How the facility will be repaid at term — REQUIRED evidence for exit-led products (bridging, development finance).", "code_list": "exit_strategy" }, { "id": "exit_evidence", "label": "Exit evidence", "tag": "doc", "datatype": "document_ref", "definition": "Evidence supporting the stated exit: sale memorandum/agreement, refinance decision-in-principle, or contracted income." }, { "id": "drawdown_timeline", "label": "Drawdown timeline", "tag": "declare", "datatype": "text", "definition": "When the funds are needed and, for staged facilities, the expected drawdown pattern." }, { "id": "finance_basis", "label": "Finance basis", "tag": "declare", "datatype": "enum", "definition": "OPT-IN switch, per deal: conventional (the default — absent means conventional, nothing changes) or sharia_compliant, which activates the sharia overlay: the sector gate, the chosen structure's evidence requirements, and the S-ladder. See the sharia-structuring companion spec.", "code_list": "finance_basis" }, { "id": "performance_evidence_basis", "label": "Performance evidence basis", "tag": "declare", "datatype": "enum", "code_list": "performance_evidence_basis", "definition": "Which operational system of record proves performance for this borrower - the witness to the moment work was done. Absent or 'none' changes nothing: the pack behaves exactly as before. Naming one selects that vertical's overlay, which requires the verified counterparts that system can supply." } ] }, { "id": "declarations", "title": "Declarations", "fields": [ { "id": "warranty_questionnaire", "label": "Warranty questionnaire (answers attached)", "tag": "declare", "datatype": "text", "definition": "Summary of the applicant's answers to the warranty questionnaire (adverse disclosures itemised)." }, { "id": "truth_statement", "label": "Truth statement signed", "tag": "declare", "datatype": "text", "definition": "The applicant's signed statement that the pack's contents are true and complete — the basis of an attestation." }, { "id": "adverse_history_declaration", "label": "Adverse history declaration", "tag": "declare", "datatype": "text", "definition": "Declared CCJs, defaults, arrears, insolvency events (company or directors), or director disqualifications — 'none' is a valid declaration; the pack's verify fields cross-check it." }, { "id": "litigation_pending", "label": "Pending litigation", "tag": "declare", "datatype": "text", "definition": "Current or threatened litigation involving the business ('none' is a valid answer)." }, { "id": "data_processing_consent", "label": "Data processing consent", "tag": "declare", "datatype": "boolean", "definition": "Confirmation the applicant consents to the processing and onward disclosure of the pack's data to prospective funders." } ] }, { "id": "receivables", "title": "Receivables & debtor book", "note": "Evidence model for invoice discounting / factoring / asset-based lending. NOTE: these are CONTINUOUS facilities — initial onboarding uses this pack; ongoing lending operates on recurring borrowing-base certificates (readiness_mode: continuous in the requirement profile; certificate cadence is future profile work).", "fields": [ { "id": "aged_debtor_ledger", "label": "Aged receivables ledger", "tag": "doc", "datatype": "document_ref", "definition": "Aged debtor ledger showing outstanding invoices by debtor and age band." }, { "id": "debtor_concentration", "label": "Top-debtor concentration", "tag": "declare", "datatype": "ratio", "definition": "Share of the ledger owed by the largest debtor (top-1 concentration)." }, { "id": "dilution_rate", "label": "Historic dilution rate", "tag": "declare", "datatype": "ratio", "definition": "Credit notes, discounts and disputes as a share of gross invoicing over the trailing period." }, { "id": "average_debtor_days", "label": "Average debtor days (DSO)", "tag": "declare", "datatype": "integer", "definition": "Average time to collect receivables, in days." }, { "id": "sample_invoices", "label": "Sample invoices + delivery evidence", "tag": "doc", "datatype": "document_ref", "definition": "Representative recent invoices with proof of delivery/performance." }, { "id": "credit_control_evidence", "label": "Credit-control process evidence", "tag": "doc", "datatype": "document_ref", "definition": "Collections policy and debtor-management reporting evidencing the credit-control process." }, { "id": "debtor_contracts", "label": "Key debtor contracts / terms of trade", "tag": "doc", "datatype": "document_ref", "definition": "Customer contracts or terms of trade underlying the material receivables." }, { "id": "sales_ledger_system", "label": "Sales ledger system", "tag": "declare", "datatype": "string", "definition": "The accounting/ledger system the debtor book is maintained in — funders assess auditability." }, { "id": "terms_of_trade", "label": "Standard terms of trade", "tag": "doc", "datatype": "document_ref", "definition": "The business's standard terms and conditions of sale — assignability clauses matter to receivables funders." }, { "id": "debtor_insurance", "label": "Debtor / credit insurance", "tag": "declare", "datatype": "text", "definition": "Whether the debtor book is credit-insured, and with whom ('none' is a valid answer)." }, { "id": "contra_accounts", "label": "Contra accounts", "tag": "declare", "datatype": "text", "definition": "Customers who are also suppliers — contra balances reduce eligible receivables." }, { "id": "export_debtor_share", "label": "Export debtor share", "tag": "declare", "datatype": "ratio", "definition": "Proportion of the debtor book owed by overseas debtors — often subject to lower advance rates." }, { "id": "eligible_receivables", "label": "Estimated eligible receivables", "tag": "declare", "datatype": "monetary_amount", "definition": "The applicant's estimate of the eligible book after concentration, age, contra and export exclusions." }, { "id": "borrowing_base_certificate", "label": "Borrowing-base certificate", "tag": "doc", "datatype": "document_ref", "definition": "The most recent borrowing-base certificate — the recurring artifact of continuous readiness: eligible collateral, advance rate, and availability, certified at a date." }, { "id": "accounting_debtors_total", "label": "Total trade debtors (from accounting system)", "tag": "verify", "source": "accounting_api", "datatype": "monetary_amount", "definition": "Total outstanding trade debtors at the sync date — the verified counterpart to the aged debtor ledger upload." }, { "id": "pod_verified_value", "label": "Delivered value with proof of delivery", "tag": "verify", "source": "tms_api", "datatype": "monetary_amount", "definition": "Value of invoiced work for which the transport/logistics system holds a proof of delivery. An invoice is only good collateral if the job was actually done; this is that evidence, at source." }, { "id": "delivered_not_invoiced_value", "label": "Delivered but not yet invoiced", "tag": "verify", "source": "tms_api", "datatype": "monetary_amount", "definition": "Value of work completed and proven delivered but not yet invoiced. Invisible to the accounting ledger, which starts at the invoice — and to the funder. Financing at delivery rather than at invoice removes this period from the cash conversion cycle." }, { "id": "verified_dilution_rate", "label": "Dilution rate (from source system)", "tag": "verify", "source": [ "tms_api", "staffing_api" ], "datatype": "ratio", "definition": "Credit notes and disputed deliveries as a decimal fraction of invoiced value, in [0,1], measured in the source system. The verified counterpart to the declared dilution rate." }, { "id": "verified_debtor_days", "label": "Debtor days (from source system)", "tag": "verify", "source": [ "tms_api", "staffing_api" ], "datatype": "integer", "definition": "Measured invoice-to-cash days from the source system — the verified counterpart to declared average debtor days, and the DSO leg of the cash conversion cycle." }, { "id": "approved_unbilled_value", "label": "Approved but unbilled value", "tag": "verify", "source": "staffing_api", "datatype": "monetary_amount", "definition": "Value of work signed off by the client but not yet invoiced, measured in the source system. In recruitment this is the approved-timesheet position: the worker is paid weekly while the client pays on terms, so this is the funding gap itself. Invisible to the ledger, because nothing has been raised." }, { "id": "approved_timesheet_count", "label": "Approved unbilled timesheets (count)", "tag": "verify", "source": "staffing_api", "datatype": "integer", "definition": "Number of client-approved, not-yet-invoiced timesheets behind approved_unbilled_value. Distinguishes one large placement from many small ones, which is a different risk at the same value." }, { "id": "certified_to_date_value", "label": "Certified value to date", "tag": "verify", "source": "construction_pm_api", "datatype": "monetary_amount", "definition": "Value of applications for payment CERTIFIED by the contract administrator or QS - an independent party has confirmed the work was done. The construction analogue of POD-verified value: an application is only good collateral if the work was certified." }, { "id": "applied_not_certified_value", "label": "Applied for but not certified", "tag": "verify", "source": "construction_pm_api", "datatype": "monetary_amount", "definition": "Value applied for that has NOT been certified. Recorded deliberately as its own fact rather than folded into the certified figure: it is the contractor's own claim about the value of their work, and treating it as evidence would be the self-declaration this section exists to remove." }, { "id": "retention_held_value", "label": "Retention held", "tag": "verify", "source": "construction_pm_api", "datatype": "monetary_amount", "definition": "Earned, certified, undisputed money withheld under the contract - typically ~5% of contract value, half released at practical completion and half after the defects liability period. Invisible to the ledger because it sits in a contract schedule, not as a receivable. Release is CONDITIONAL and the counterparty risk sits with the main contractor, not the borrower." }, { "id": "retention_release_next_date", "label": "Next retention release date", "tag": "verify", "source": "construction_pm_api", "datatype": "date", "definition": "The earliest contractual retention release date across the book. What a retention facility is priced against, since the question is when the cash lands, not whether it is owed." }, { "id": "main_contractor_concentration", "label": "Largest counterparty share of retention", "tag": "verify", "source": [ "construction_pm_api" ], "datatype": "ratio", "definition": "Share of retention owed by the single largest main contractor, as a decimal fraction in [0,1]. The real credit question for retention finance: the borrower can be perfectly sound and still lose the money if the payer fails - upstream insolvency is the sector's recurring scandal." } ] }, { "id": "inventory", "title": "Inventory & stock", "note": "Evidence model for stock/inventory finance and the inventory leg of an asset-based lending borrowing base. Stock is an asset class in its own right, treated the same way as receivables: a value, a location, a liquidity discount and a verifying source. CONTINUOUS facility — ongoing lending operates on recurring borrowing-base certificates that carry both the receivables and the inventory line.", "fields": [ { "id": "stock_on_hand_value", "label": "Stock on hand (value at cost)", "tag": "verify", "source": "wms_api", "datatype": "monetary_amount", "definition": "Value of stock on hand at the count date, at cost, read from the inventory/warehouse system. The verified counterpart to a declared stock figure." }, { "id": "stock_count_date", "label": "Stock count date", "tag": "verify", "source": "wms_api", "datatype": "date", "definition": "The date the stock figures in this pack were read or counted. Consumers SHOULD apply their own freshness policy — stock ages faster than most facts in a pack." }, { "id": "stock_valuation_basis", "label": "Stock valuation basis", "tag": "declare", "datatype": "enum", "code_list": "stock_valuation_basis", "definition": "How the stock value is struck. Materially changes what the figure means to a funder: cost is not net realisable value, and neither is orderly liquidation value." }, { "id": "stock_category_mix", "label": "Stock category mix", "tag": "declare", "datatype": "list_string", "definition": "Which categories the stock comprises (raw materials, work in progress, finished goods). Finished goods are ordinarily the most financeable; work in progress ordinarily the least." }, { "id": "aged_stock_share", "label": "Aged / slow-moving stock share", "tag": "verify", "source": "wms_api", "datatype": "ratio", "definition": "Proportion of stock value older than the operator's slow-moving threshold, as a decimal fraction in [0,1]. The inventory analogue of an aged debtor bucket." }, { "id": "stock_turnover_days", "label": "Stock turnover days (DIO)", "tag": "verify", "source": "wms_api", "datatype": "integer", "definition": "Days inventory outstanding — average days stock is held before sale. The inventory leg of the cash conversion cycle (DSO + DIO - DPO)." }, { "id": "nolv_rate", "label": "Net orderly liquidation value (NOLV) rate", "tag": "declare", "datatype": "ratio", "definition": "Appraised net orderly liquidation value as a decimal fraction of cost, in [0,1]. What the stock is expected to realise in an orderly wind-down — the basis most inventory advance rates are struck against." }, { "id": "stock_appraisal", "label": "Stock appraisal / NOLV report", "tag": "doc", "datatype": "document_ref", "definition": "Independent appraisal supporting the NOLV rate." }, { "id": "stock_locations", "label": "Stock locations", "tag": "declare", "datatype": "list_string", "definition": "Sites where the stock is held. Location drives enforceability: stock at a third-party site ordinarily needs a waiver of lien." }, { "id": "third_party_logistics_provider", "label": "Third-party warehouse / 3PL", "tag": "declare", "datatype": "string", "definition": "The third party holding the stock, where it is not held at the applicant's own premises." }, { "id": "waiver_of_lien", "label": "Landlord / 3PL waiver of lien", "tag": "doc", "datatype": "document_ref", "definition": "Waiver from the landlord or third-party warehouse, without which a funder's security over stock held at that site may rank behind theirs." }, { "id": "stock_insurance", "label": "Stock insured", "tag": "declare", "datatype": "boolean", "definition": "Whether the stock is insured to at least its financed value." }, { "id": "inventory_system", "label": "Inventory / warehouse system", "tag": "declare", "datatype": "string", "definition": "The inventory or warehouse management system the stock is tracked in — funders assess auditability and whether figures can be verified at source." }, { "id": "goods_in_transit_value", "label": "Goods in transit (value)", "tag": "verify", "source": "tms_api", "datatype": "monetary_amount", "definition": "Value of goods dispatched but not yet delivered, read from the transport/logistics system. Ordinarily financeable only where title and insurance in transit are established." } ] }, { "id": "capital_structure", "title": "Capital structure & subordination", "note": "Evidence model for mezzanine / subordinated debt: the facility is priced off the whole capital stack, so the stack must be in the pack.", "fields": [ { "id": "existing_debt_schedule", "label": "Existing debt schedule", "tag": "declare", "datatype": "text", "definition": "Schedule of existing borrowings: lender, facility type, balance, maturity, security held." }, { "id": "senior_facility_terms", "label": "Senior facility agreement / term sheet", "tag": "doc", "datatype": "document_ref", "definition": "The senior facility documentation the proposed facility ranks behind." }, { "id": "intercreditor_position", "label": "Proposed ranking / intercreditor arrangements", "tag": "declare", "datatype": "text", "definition": "Proposed subordination and intercreditor arrangements (ranking, standstill, payment blockage)." }, { "id": "enterprise_valuation", "label": "Enterprise valuation", "tag": "doc", "datatype": "document_ref", "definition": "Valuation supporting the capital structure, with the multiple/basis stated." }, { "id": "ebitda", "label": "EBITDA (trailing 12 months)", "tag": "declare", "datatype": "monetary_amount", "definition": "EBITDA for the most recent 12 months, GBP, basis stated (management or audited)." }, { "id": "sponsor_details", "label": "Sponsor / shareholder background", "tag": "declare", "datatype": "text", "data_class": "personal", "definition": "Background of the sponsor or controlling shareholders, where relevant to the credit." }, { "id": "equity_kicker_terms", "label": "Equity participation / warrant terms", "tag": "declare", "datatype": "text", "definition": "Proposed warrant or equity-participation terms attached to the facility, if any." }, { "id": "group_structure_chart", "label": "Group structure chart", "tag": "doc", "datatype": "document_ref", "definition": "Corporate structure showing parents, subsidiaries and cross-holdings — where the borrower sits in the group." }, { "id": "shareholder_loans", "label": "Shareholder / director loans", "tag": "declare", "datatype": "monetary_amount", "definition": "Outstanding loans from shareholders or directors, and whether they will subordinate." }, { "id": "cross_guarantees", "label": "Cross-guarantees within the group", "tag": "declare", "datatype": "text", "definition": "Existing guarantees given for or by other group companies ('none' is a valid answer)." }, { "id": "existing_covenants", "label": "Existing covenants", "tag": "declare", "datatype": "text", "definition": "Financial covenants in existing facilities (leverage, interest cover, etc.) that a new facility must live alongside." }, { "id": "subordination_consent", "label": "Senior lender consent status", "tag": "declare", "datatype": "text", "definition": "Whether the senior lender has consented (or is expected to consent) to the new subordinated facility." } ] }, { "id": "development", "title": "Development finance", "note": "Evidence model for property development finance (staged drawdown against a build programme).", "fields": [ { "id": "gdv", "label": "Gross development value (GDV)", "tag": "declare", "datatype": "monetary_amount", "definition": "Projected gross development value on completion, GBP, basis stated." }, { "id": "total_build_costs", "label": "Total build costs (incl. contingency)", "tag": "declare", "datatype": "monetary_amount", "definition": "Total construction costs including professional fees and contingency, GBP." }, { "id": "drawdown_schedule", "label": "Staged drawdown schedule", "tag": "doc", "datatype": "document_ref", "definition": "Drawdown schedule mapped to the build programme milestones." }, { "id": "planning_permission", "label": "Planning permission evidence", "tag": "doc", "datatype": "document_ref", "definition": "Planning consent or permitted-development evidence for the scheme." }, { "id": "monitoring_surveyor", "label": "Monitoring surveyor (appointed/proposed)", "tag": "declare", "datatype": "string", "definition": "The independent monitoring surveyor overseeing drawdowns." }, { "id": "development_appraisal", "label": "Development appraisal", "tag": "doc", "datatype": "document_ref", "definition": "The full residual appraisal: land cost, build cost, fees, finance, contingency and profit on cost/GDV." }, { "id": "build_cost_breakdown", "label": "Build cost breakdown", "tag": "doc", "datatype": "document_ref", "definition": "Elemental or QS-prepared breakdown supporting total_build_costs." }, { "id": "planning_reference", "label": "Planning reference", "tag": "declare", "datatype": "string", "definition": "The local planning authority and application/decision reference for the consent relied on." }, { "id": "s106_cil_liability", "label": "S106 / CIL liability", "tag": "declare", "datatype": "monetary_amount", "definition": "Planning obligations and Community Infrastructure Levy payable — a real cost line funders check." }, { "id": "professional_team", "label": "Professional team", "tag": "declare", "datatype": "text", "definition": "Architect, QS, structural engineer and principal designer appointed to the scheme." }, { "id": "main_contractor", "label": "Main contractor", "tag": "declare", "datatype": "string", "definition": "The main contractor (or confirmation of self-build/construction management)." }, { "id": "contractor_track_record", "label": "Contractor / developer track record", "tag": "doc", "datatype": "document_ref", "definition": "Evidence of comparable completed schemes by the developer and/or main contractor." }, { "id": "build_programme", "label": "Build programme", "tag": "doc", "datatype": "document_ref", "definition": "The construction programme with milestones — drives the drawdown schedule and interest roll-up." }, { "id": "warranty_provider", "label": "Structural warranty provider", "tag": "declare", "datatype": "string", "definition": "The new-build structural warranty provider for the completed units." }, { "id": "presales_prelets", "label": "Pre-sales / pre-lets", "tag": "doc", "datatype": "document_ref", "definition": "Exchanged pre-sales or agreed pre-lets — the strongest exit evidence a scheme can carry." }, { "id": "certified_work_in_place", "label": "Certified work in place", "tag": "verify", "source": "construction_pm_api", "datatype": "monetary_amount", "definition": "Value of work the monitoring surveyor has CERTIFIED as built, cumulative. A development facility draws down against this rather than against the developer's own view of progress. The development analogue of a certified payment application." }, { "id": "cost_to_complete", "label": "Cost to complete", "tag": "verify", "source": "construction_pm_api", "datatype": "monetary_amount", "definition": "Remaining cost to finish the scheme, as assessed by the monitoring surveyor. Paired with undrawn facility this answers the question development finance actually fails on - is there enough money left to finish? A half-built site is worth far less than either the land or the finished scheme." }, { "id": "drawn_to_date", "label": "Facility drawn to date", "tag": "verify", "source": "construction_pm_api", "datatype": "monetary_amount", "definition": "Cumulative drawdown against the development facility." }, { "id": "last_certificate_date", "label": "Last certificate date", "tag": "verify", "source": "construction_pm_api", "datatype": "date", "definition": "Date of the most recent monitoring surveyor certificate. Staleness matters: a scheme monitored three months ago is not a monitored scheme." }, { "id": "programme_variance_weeks", "label": "Programme variance (weeks)", "tag": "verify", "source": "construction_pm_api", "datatype": "integer", "definition": "Weeks behind (positive) or ahead of (negative) the agreed build programme, per the monitoring surveyor. Signed deliberately - running late is the leading indicator of a cost overrun, and a scheme running early must not be reported as though it were late." }, { "id": "cost_variance_rate", "label": "Cost variance", "tag": "verify", "source": "construction_pm_api", "datatype": "ratio", "definition": "Forecast cost against original budget as a decimal fraction in [0,1] - the overrun to date. Measured by the monitoring surveyor rather than stated by the developer." } ] }, { "id": "trade_finance", "title": "Trade finance", "note": "Evidence for import/export and transaction-cycle facilities. Readiness is per-facility; individual transactions recur over the facility's life (continuous mode).", "fields": [ { "id": "trade_direction", "label": "Trade direction", "tag": "declare", "datatype": "enum", "definition": "Whether the facility funds imports, exports, or both.", "code_list": "trade_direction" }, { "id": "supplier_details", "label": "Key supplier details", "tag": "declare", "datatype": "text", "definition": "The supplier(s) whose goods the facility funds: name, jurisdiction, payment terms." }, { "id": "supplier_track_record", "label": "Supplier relationship track record", "tag": "declare", "datatype": "text", "definition": "Length and volume of the trading relationship with the key supplier(s) — new-supplier transactions carry different risk." }, { "id": "purchase_orders", "label": "Confirmed purchase orders", "tag": "doc", "datatype": "document_ref", "definition": "Confirmed customer purchase orders underpinning the transactions to be funded." }, { "id": "proforma_invoice", "label": "Supplier proforma invoice", "tag": "doc", "datatype": "document_ref", "definition": "The supplier's proforma invoice for the goods being financed." }, { "id": "trade_cycle_days", "label": "Trade cycle (days)", "tag": "declare", "datatype": "integer", "definition": "Order-to-cash cycle length: order → shipment → delivery → customer payment." }, { "id": "shipping_documents", "label": "Shipping / title documents", "tag": "doc", "datatype": "document_ref", "definition": "Transport and title documentation for in-flight transactions (e.g. bill of lading) — recurring per transaction, not required at facility readiness." }, { "id": "delivery_terms", "label": "Delivery terms", "tag": "declare", "datatype": "string", "definition": "The agreed delivery-terms basis for the funded transactions (who carries freight, insurance and risk, and to where)." }, { "id": "currency_exposure", "label": "Currency exposure", "tag": "declare", "datatype": "text", "definition": "Transaction currencies and any hedging in place ('unhedged' is a valid answer)." }, { "id": "trade_credit_insurance", "label": "Trade credit insurance", "tag": "declare", "datatype": "text", "definition": "Whether transactions or buyers are credit-insured, and with whom ('none' is a valid answer)." } ] }, { "id": "card_receipts", "title": "Card receipts (merchant cash advance)", "note": "Evidence for receipts-linked advances repaid as a share of card takings.", "fields": [ { "id": "acquirer_name", "label": "Card acquirer", "tag": "declare", "datatype": "string", "definition": "The merchant-acquiring provider processing the business's card payments." }, { "id": "acquirer_statements", "label": "Acquirer statements", "tag": "doc", "datatype": "document_ref", "definition": "6–12 months of merchant acquirer statements — the primary underwriting evidence for a receipts-linked advance." }, { "id": "monthly_card_turnover", "label": "Average monthly card turnover", "tag": "declare", "datatype": "monetary_amount", "definition": "Average monthly card takings over the statement period." }, { "id": "card_turnover_seasonality", "label": "Card turnover seasonality", "tag": "declare", "datatype": "text", "definition": "Seasonal pattern of card takings — repayments flex with receipts, so the shape matters." }, { "id": "proposed_split_percentage", "label": "Proposed receipts split", "tag": "declare", "datatype": "ratio", "definition": "The proportion of daily card receipts proposed to service the advance." }, { "id": "acquirer_switch_required", "label": "Acquirer switch required", "tag": "declare", "datatype": "boolean", "definition": "Whether the funder requires the business to switch acquirer or add a lockbox/split arrangement." }, { "id": "verified_card_turnover", "label": "Card turnover (from acquirer)", "tag": "verify", "source": "psp_api", "datatype": "monetary_amount", "definition": "Monthly card takings measured at the acquirer or payment service provider, over a stated window. The verified counterpart to declared monthly_card_turnover. Card settlement is among the most predictable receivables in SME lending - daily takings, seasonality and trend are all readable from the same feed." }, { "id": "verified_transaction_count", "label": "Transactions (from acquirer)", "tag": "verify", "source": "psp_api", "datatype": "integer", "definition": "Number of card transactions in the measured window. Distinguishes high-volume low-ticket trade from the reverse at the same turnover, which is a different risk." }, { "id": "verified_average_transaction", "label": "Average transaction value (from acquirer)", "tag": "verify", "source": "psp_api", "datatype": "monetary_amount", "definition": "Mean transaction value in the measured window, measured at the acquirer." }, { "id": "verified_refund_rate", "label": "Refund and chargeback rate (from acquirer)", "tag": "verify", "source": "psp_api", "datatype": "ratio", "definition": "Refunds and chargebacks as a decimal fraction of gross takings in [0,1], measured at the acquirer. The card-trade analogue of dilution: it is what the advance actually shrinks by, and today it is not asked for at all." }, { "id": "pending_settlement_value", "label": "Pending settlement", "tag": "verify", "source": "psp_api", "datatype": "monetary_amount", "definition": "Takings captured by the acquirer but not yet settled to the merchant's bank account. Proof of FORWARD RECEIPT: the money is contractually coming, and the payer is the acquirer rather than a debtor who might dispute it." }, { "id": "settlement_next_date", "label": "Next settlement date", "tag": "verify", "source": "psp_api", "datatype": "date", "definition": "The next contractual settlement date from the acquirer. What a merchant cash advance is serviced against, since repayment is a percentage of takings as they settle." } ] }, { "id": "sharia_compliance", "title": "Sharia-compliant structuring", "note": "Evidence for sharia-compliant deals — active only when the_ask.finance_basis is sharia_compliant. The compliance IS the transaction structure: the standard evidences HOW the deal follows a certified template (structure, sequence, prohibition terms) and WHO certified the template. The standard never rules on religious law itself — where schools of thought differ, the pack states which structure and whose certification; the funder's own board's gates dispose.", "fields": [ { "id": "sharia_structure", "label": "Financing structure", "tag": "declare", "datatype": "enum", "definition": "The Islamic financing structure the deal uses — selects the structure's evidence requirements (requirement-profiles overlay).", "code_list": "sharia_structure" }, { "id": "claimed_level", "label": "Claimed sharia conformance level", "tag": "declare", "datatype": "enum", "definition": "S1-declared (stated) / S2-structure-evidenced (sector gate passed + all structure evidence present + sequence checks pass) / S3-certified (S2 + an in-date board certificate for the template used). Coherence enforced by the reference validator.", "code_list": "sharia_level" }, { "id": "sharia_certificate", "label": "Board / scholar certificate", "tag": "doc", "datatype": "document_ref", "definition": "The certification of the PRODUCT TEMPLATE (contract set + process) by a named board or scholar. Certification covers the template; the pack evidences that this deal followed it." }, { "id": "certifying_board", "label": "Certifying board / scholar", "tag": "declare", "datatype": "string", "definition": "Who certified the template — the board or scholar name and capacity." }, { "id": "certificate_expiry", "label": "Certificate expiry / review date", "tag": "declare", "datatype": "date", "definition": "When the certification lapses or is due for periodic review — consumers apply their own freshness policy (validation itself is clock-free)." }, { "id": "template_ref", "label": "Certified template reference", "tag": "declare", "datatype": "string", "definition": "Which certified product template this deal follows (the board's reference)." }, { "id": "late_payment_charity_clause", "label": "Late-payment charity clause", "tag": "doc", "datatype": "document_ref", "definition": "The contract clause routing late-payment amounts to charity rather than to income — the core no-interest prohibition term, evidenced." }, { "id": "disclosed_cost", "label": "Disclosed cost", "tag": "declare", "datatype": "monetary_amount", "definition": "Murabaha/tawarruq: the funder's acquisition cost, disclosed to the customer as a separate figure." }, { "id": "disclosed_markup", "label": "Disclosed markup", "tag": "declare", "datatype": "monetary_amount", "definition": "Murabaha/tawarruq: the profit element, disclosed separately from cost — a disclosed sale margin, not time-indexed interest." }, { "id": "ownership_transfer_date", "label": "Funder ownership date", "tag": "declare", "datatype": "date", "definition": "The date the funder acquired ownership of the asset/commodity. SEQUENCE RULE (validator-enforced): must not be after sale_contract_date — the funder must own before it sells." }, { "id": "sale_contract_date", "label": "Onward sale date", "tag": "declare", "datatype": "date", "definition": "The date of the onward sale to the customer — must not precede ownership_transfer_date." }, { "id": "ownership_transfer_evidence", "label": "Ownership transfer evidence", "tag": "doc", "datatype": "document_ref", "definition": "Evidence the funder took ownership: supplier invoice in the funder's name, title transfer, or commodity purchase confirmation." }, { "id": "sale_contract", "label": "Onward sale / lease contract", "tag": "doc", "datatype": "document_ref", "definition": "The executed onward contract with the customer (sale, lease, or co-ownership as the structure requires)." }, { "id": "co_ownership_agreement", "label": "Co-ownership agreement", "tag": "doc", "datatype": "document_ref", "definition": "Diminishing musharaka: the joint-ownership agreement between funder and customer." }, { "id": "buyout_schedule", "label": "Buyout schedule", "tag": "doc", "datatype": "document_ref", "definition": "Diminishing musharaka / ijara-to-own: the schedule by which the customer acquires the funder's share." }, { "id": "funder_insurance_evidence", "label": "Funder insurance evidence", "tag": "doc", "datatype": "document_ref", "definition": "Ijara: evidence the FUNDER (as owner) insures the asset and bears ownership risk." }, { "id": "partnership_agreement", "label": "Partnership agreement", "tag": "doc", "datatype": "document_ref", "definition": "The executed musharaka or mudaraba partnership agreement — who contributes what, and how profit and loss are shared." }, { "id": "capital_contribution_funder", "label": "Funder capital contribution", "tag": "declare", "datatype": "monetary_amount", "definition": "The funder's capital contribution to the partnership." }, { "id": "capital_contribution_customer", "label": "Customer capital contribution", "tag": "declare", "datatype": "monetary_amount", "definition": "The customer's capital contribution (musharaka). In a mudaraba the funder provides all the capital and this is zero." }, { "id": "profit_sharing_ratio", "label": "Profit-sharing ratio (customer share)", "tag": "declare", "datatype": "ratio", "definition": "The customer's agreed share of PROFIT, as a 0–1 fraction. Profit may be shared by agreement; losses may not — losses follow capital." }, { "id": "loss_follows_capital", "label": "Losses follow capital — confirmed", "tag": "declare", "datatype": "boolean", "definition": "Confirmation the agreement shares losses in proportion to capital contributed — the partnership rule a certifying board looks for." }, { "id": "agency_agreement", "label": "Agency (wakala) agreement", "tag": "doc", "datatype": "document_ref", "definition": "The executed wakala agreement — what the agent is appointed to do, and on what terms." }, { "id": "agency_fee", "label": "Disclosed agency fee", "tag": "declare", "datatype": "monetary_amount", "definition": "The disclosed wakala fee — a fee for a service, not a return on money." }, { "id": "specification_delivery_schedule", "label": "Specification & delivery schedule", "tag": "doc", "datatype": "document_ref", "definition": "The specification and delivery schedule for goods being commissioned (istisna) or bought forward (salam) — certainty of what, when, and at what price." }, { "id": "advance_payment_evidence", "label": "Advance payment evidence", "tag": "doc", "datatype": "document_ref", "definition": "Salam: evidence the full purchase price was paid up front — the defining feature of the structure." } ] } ] }