VEHICLE PURCHASE AGREEMENT - FORM FIELD MAPPING
================================================

Form Name: Vehicle Purchase Agreement
Category: Legal & Contracts
Description: UK garage/dealer stock purchase form - suitable for private seller, trader, auction, customer part-exchange or business purchase

Total Sections: 13
Total Fields: 70+ fillable fields

FIELD BREAKDOWN BY SECTION:
===========================

HEADER INFORMATION (4 fields)
- Agreement reference / stock number | text | required
- Date of purchase | date | required
- Time of purchase | text | optional
- Purchase source | checkbox (6 options) | required
  Options: [ ] Private seller [ ] Trader [ ] Auction [ ] Business [ ] Customer PX [ ] Other

ADDITIONAL HEADER (2 fields)
- Place of purchase | text | required
- Purchase agreed by | text | required

SECTION 1: SELLER DETAILS (10 fields)
- Seller full legal name | text | required
- Trading / business name, if applicable | text | optional
- Seller address | text | required
- Seller postcode | text | required
- Telephone | tel | required
- Email | email | required
- Seller type | checkbox (5 options) | required
  Options: [ ] Private individual [ ] Motor trader [ ] Business [ ] Auction [ ] Other
- Company number / VAT number | text | optional
- Photo ID checked | checkbox (Yes/No) | optional
- Photo ID type/reference | text | conditional (if ID checked Yes)
- Proof of address checked | checkbox (Yes/No) | optional
- Proof of address details | text | conditional (if address checked Yes)

SECTION 2: BUYER / GARAGE DETAILS (8 fields)
- Garage legal name | text | required
- Trading name | text | required
- Business address | text | required
- Postcode | text | required
- Company number | text | required
- VAT number | text | required
- Telephone | tel | required
- Email | email | required
- Authorised buyer name | text | required
- Position / role | text | optional

SECTION 3: VEHICLE DETAILS (14 fields)
- Registration number | text | required
- VIN / chassis number | text | required
- Stock number | text | optional
- Make | text | required
- Model | text | required
- Trim / derivative | text | optional
- Body type | text | optional
- Colour | text | optional
- Fuel type | text | optional
- Transmission | text | optional
- Engine size | text | optional
- Date first registered | date | optional
- Current mileage | number | optional
- Mileage status | checkbox (3 options) | optional
  Options: [ ] Warranted [ ] Not warranted [ ] Discrepancy disclosed
- MOT expiry date | date | optional
- Number of keys | number | optional
- Service history | checkbox (4 options) | optional
  Options: [ ] Full [ ] Part [ ] None [ ] Digital
- V5C document reference | text | optional

SECTION 4: PURCHASE PRICE AND PAYMENT (10 fields)
- Agreed purchase price GBP | number (currency) | required
- Deposit paid GBP | number (currency) | optional
- Balance payable GBP | number (currency) | required
- Payment method | checkbox (5 options) | required
  Options: [ ] Bank transfer [ ] Card [ ] Cash [ ] Finance settlement [ ] Other
- Payment reference | text | optional
- Payment due / paid date | date | optional
- Finance settlement deduction GBP | number (currency) | conditional
- Amount payable direct to seller GBP | number (currency) | conditional
- Seller bank account name | text | conditional
- Sort code | text | conditional
- Account number | text | conditional
- Payment authorised by | text | conditional

SECTION 5: DOCUMENTS, ITEMS AND CHECKS RECEIVED (12 checkbox fields)
- V5C / logbook seen | checkbox | optional
- V5C / logbook received | checkbox | optional
- New keeper / trader section completed | checkbox | optional
- DVLA notification completed or required | checkbox | optional
- Service book | checkbox | optional
- Service invoices | checkbox | optional
- MOT certificate / MOT history checked | checkbox | optional
- Handbook / manuals | checkbox | optional
- Spare key | checkbox | optional
- Locking wheel nut | checkbox | optional
- HPI / history check completed | checkbox | optional
- Outstanding finance checked | checkbox | optional
- Seller ID checked | checkbox | optional
- Proof of address checked | checkbox | optional
- Mileage checked against MOT history | checkbox | optional
- Photos / condition record attached | checkbox | optional

SECTION 6: SELLER DECLARATIONS (1 field - read-only text)
- Seller declarations (7-point statement) | read-only text area | N/A

SECTION 7: KNOWN FAULTS, HISTORY, FINANCE OR OTHER DISCLOSURES (1 field)
- Known faults/issues disclosure | textarea | optional
  Label: Record any known faults, accident damage, write-off category, previous use, mileage concern, outstanding finance, missing documents, missing keys, mechanical issues, warning lights, MOT advisories or other matters disclosed by the seller

SECTION 8: BUYER / GARAGE ACKNOWLEDGEMENTS (1 field - read-only text)
- Buyer acknowledgements (4-point statement) | read-only text area | N/A

SECTION 9: DVLA / V5C TRANSFER RECORD (4 fields)
- DVLA notified | checkbox (3 options) | optional
  Options: [ ] Yes [ ] No [ ] Not applicable
- Notification method | checkbox (3 options) | conditional
  Options: [ ] Online [ ] Postal [ ] To be completed
- DVLA confirmation reference | text | optional
- Date/time completed | datetime | optional
- V5C document reference number | text | optional
- Name of person completing DVLA task | text | optional

SECTION 10: CONTRACT TERMS (1 field - read-only text)
- Contract terms (5-point statement) | read-only text area | N/A

SECTION 11: ADDITIONAL NOTES / SPECIAL CONDITIONS (1 field)
- Additional notes / special conditions | textarea | optional
  Label: Add any special conditions, subject-to clauses, finance settlement instructions, agreed repairs before purchase, collection arrangements, trade disposal notes, or other terms agreed by the parties

SECTION 12: SIGNATURES (6 fields per party + witness)
SELLER SECTION:
- Seller Name | text | required
- Seller Signature | signature field | required
- Seller Date | date | required
- Seller Time | time | optional
- Seller Capacity / role | text | optional

BUYER / GARAGE SECTION:
- Buyer/Garage Name | text | required
- Buyer/Garage Signature | signature field | required
- Buyer/Garage Date | date | required
- Buyer/Garage Time | time | optional
- Buyer/Garage Capacity / role | text | optional

WITNESS SECTION (optional):
- Witness Name | text | optional
- Witness Signature | signature field | optional
- Witness Date | date | optional
- Witness Role | text | optional

SECTION 13: OFFICE USE ONLY (6 fields - internal staff only)
- Stock record created | checkbox (Yes/No) | optional
- VAT status checked | checkbox (4 options) | optional
  Options: [ ] Margin [ ] Qualifying [ ] Non-VAT [ ] Review needed
- HPI/history report saved | checkbox (Yes/No) | optional
- Prep sheet created | checkbox (Yes/No) | optional
- Vehicle photos uploaded | checkbox (Yes/No) | optional
- Retail readiness decision | checkbox (4 options) | optional
  Options: [ ] Retail [ ] Repair [ ] Trade [ ] Auction
- Manager approval | text | optional
- Date approved | date | optional


FIELD COUNT SUMMARY:
====================
Text fields: ~35
Date/Time fields: 8
Number (Currency) fields: 4
Email fields: 2
Telephone fields: 3
Checkbox groups: ~20
Textarea fields: 3
Signature fields: 3
Read-only text areas: 3
Total: 80+ fields

RECOMMENDED IMPLEMENTATION APPROACH:
====================================

PHASE 1 - CORE FORM (Priority fields)
Create this first to get the form working:
- Header info (agreement ref, date)
- Seller details (name, address, contact)
- Buyer/Garage details (name, address, contact)
- Vehicle details (reg, VIN, make, model, mileage)
- Purchase price and payment (price, payment method)
- Signatures (seller and buyer)

PHASE 2 - COMPREHENSIVE
Add additional fields:
- All checkbox groups (documents, checks, declarations)
- Additional notes/special conditions
- DVLA transfer record
- Office use only

SUGGESTED FORM TYPES FOR OTHER CATEGORIES:
==========================================
Based on this comprehensive contract form, your other 34 categories likely need:
- Service Agreements
- Warranty Certificates
- Trade-In Forms
- Finance Application Forms
- Inspection Report Forms
- Recall & Repair Authorization Forms
- Customer Consent Forms
- Work Estimates
- Invoice Templates
- Receipt Templates

NEXT STEPS:
===========
1. Review this field mapping
2. Log into manage-forms.php
3. Select "Legal & Contracts" category
4. Create new form "Vehicle Purchase Agreement"
5. Add fields according to the phase 1 core fields listed above
6. Once tested, add remaining fields from phase 2
7. Create a test PDF to verify formatting
