marketplace.evaluate_used_vehicle

Get a price evaluation / certified inspection of a used vehicle (own car/bike, OR a private listing the user is considering buying) through TOMO partners (OBV / CarDekho Inspection / Spinny Doorstep Inspection / GoMechanic Inspection). Standalone evaluation — NOT a sale or purchase flow. Output = certified PDF report + plain-English chip + ₹ band.

1. Identity

Intent ID: marketplace.evaluate_used_vehicle
Vertical: marketplace
Verb: evaluate
Noun: used_vehicle
Primary agent: MarketplaceAgent
Sub-agents (DATA only): SafetyAgent (RC blacklist / theft / accident DB), FinanceAgent (loan-NOC visibility)
Single-intent → completed action: choose vehicle → schedule inspector → receive certified report + price band
Handoff layer: L2

2. NL Coverage

"evaluate my car"
"get inspection for used car i want to buy"
"obv inspection my swift"
"doorstep car inspection nakkalgutta"
"certified inspection of used scooter"
"is this swift dzire fair price"
"car valuation for insurance"
"inspect used royal enfield before buying"
"third party car check"
"200 point inspection report"

Must NOT match: "buy used car" (full purchase), "sell my car" (full sale).

3. Input (slots)

Slot	Type	Required	Source
`vehicle_type`	enum [car, bike, scooter, ev_car, ev_bike]	HARD	NL
`rc_number`	string	HARD	NL or photo OCR
`purpose`	enum [pre_purchase, sale_quote, insurance_renewal, loan_valuation, dispute]	HARD	NL or quiz
`inspection_address`	geo	HARD	saved or NL
`inspection_slot`	datetime	HARD	partner calendar
`inspection_depth`	enum [basic_50pt, standard_140pt, deep_200pt, dyno_full]	HARD	partner offerings
`report_format`	enum [pdf, json, both]	SOFT	default `pdf`

4. Provider Tools

quote_inspection(vehicle_type, depth, address) → {fee_inr, eta_min}
schedule_inspection(rc_number, address, slot, depth) → {inspection_id, inspector_name}
verify_rc(rc_number) → {owner_name, fitness_valid_to, insurance_valid_to, puc_valid_to, hypothecation, blacklist, accident_record}
submit_report(inspection_id) → {report_pdf_url, report_json, score, price_band_low, price_band_high, blemishes[], hard_issues[]}
request_re_inspection(inspection_id, reason) → {re_inspection_id, fee_inr}
cancel_inspection(inspection_id, reason) → {cancellation_fee_inr}

5. Response Shape

Region 1 — INTELLIGENCE: inspection_depth, rc_parivahan_verified, accident_record_present, hypothecation_status, report_eta_hours, inspector_certified_by_partner
Region 2 — summary: "₹{fee_inr} {depth} inspection. Certified report in {eta_hours}h."
Region 3 — visual: stock vehicle reference + sample partner report PDF preview
Region 4 — NOW pin: nearest slot + inspector ID badge + female-inspector toggle
Region 5 — CHOICES: OK (basic_50pt, cheapest), GOOD (standard_140pt, balanced), GREAT (deep_200pt or dyno, most thorough)

6. Controlled Vocabularies

vehicle_type: car | bike | scooter | ev_car | ev_bike
inspection_depth: basic_50pt | standard_140pt | deep_200pt | dyno_full
purpose: pre_purchase | sale_quote | insurance_renewal | loan_valuation | dispute
partner: obv | cardekho_inspection | spinny_doorstep | gomechanic_inspection | mahindra_first_choice
report_format: pdf | json | both
hard_issue: accident_chassis_repair | flood_damage | odometer_tamper | engine_blow_by | transmission_slip_severe | rc_blacklist | airbag_deployed_undeclared | structural_weld_fail | ev_battery_health_below_60
inspector_certification: oem | partner_in_house | third_party_audited

7. TTBS Dimensions

Dim	Weight	Signal
Time	0.15	inspection slot ETA, report turnaround
Taste	0.10	partner brand preference
Budget	0.20	fee transparency, no upsell pressure
Safety	0.55	inspector certification, accident DB query, RC verify, report tamper-evident PDF, female-inspector toggle

Locked: safety = 0.55 — evaluation is a trust product; safety dominates the ranking.

8. Completion Contract

Complete when:

Inspector visit completed (timestamp + GPS pinned)
Report PDF generated AND price band populated
Report delivered to user (TOMO chat + email if opted)
CPC: event=evaluation_completed, amount_inr = referral fee on inspection fee, pass_through_inr = 0

9. Widget

CHOICES card: 3 depth tiers across partners with fee + report ETA
DETAIL bubble: sample report preview, inspector certification chip, what 200pt covers vs 140pt
SLOT picker: nearest inspector + female-toggle + ID badge
REPORT delivery bubble: PDF + price band + plain-English summary + hard_issues highlighted
RE-INSPECTION CTA if buyer disputes report

NEVER show: AI-rendered vehicle photos, synthetic "₹X above market" claims without partner cite, paid-placement of inspectors.

10. Caching Policy

Key	TTL	Invalidate on
`inspection_fee:{partner}:{depth}:{vehicle_type}:{pincode}`	24 h	partner price refresh
`parivahan:rc:{rc}`	30 days	blacklist event
`inspector:availability:{partner}:{pincode}`	15 min	bookings
`report:{inspection_id}`	listing lifetime	re-inspection issued

No caching of price band or hard_issues (always per-inspection).

11. Error Codes

Code	Meaning	UX
`MKT_RC_INVALID`	RC not on Parivahan	reject + reason
`MKT_RC_BLACKLIST`	hard block	reason chip
`MKT_INSPECTOR_NO_SHOW`	SLA breach	reschedule + credit
`MKT_VEHICLE_NOT_DRIVEABLE`	partner can't road-test	OBD-only report + chip
`MKT_REPORT_DISPUTED`	user reports incorrect	re-inspection workflow
`MKT_PARTNER_DOWN`	API unreachable	retry queue

12. Sandbox → Production Checklist

50 sample RCs Parivahan-verified
Inspector dispatch in 3 cities
Sample 200pt report rendered byte-equal to partner
Accident-DB query tested
EV battery-health diagnostic path validated
CPC HMAC 50 events
Female-inspector toggle wired
Hard-issue ENUM audit per partner
Anti-fab audit

13. Anti-Fabrication Rules

NEVER paid placement
NEVER AI-rendered vehicle photos
NEVER synthesise inspection score
NEVER synthesise price band — must be partner-quoted
NEVER hide hard_issues
NEVER claim TOMO certifies (partner does; TOMO surfaces)
NEVER cache price band
NEVER claim "guaranteed accurate" — surface confidence_band on the price

14. Regulatory Framing

MV Act 1988 + CMVR 1989 — fitness + emission compliance fields surfaced
Insurance Act 1938 + IRDAI — IDV (Insured Declared Value) for insurance_renewal purpose must reference IRDAI depreciation table
CPCB BS-VI / E-Waste Rules — EV battery health and disposal compliance flagged
DPDPA 2023 — RC owner PII surfaced only to authenticated owner OR with explicit OTP consent flow when buyer-side evaluation
Consumer Protection Act 2019 — partner-issued report is the legal valuation; TOMO is conduit
IT Act 2000 — tamper-evident PDF (digital signature) required for loan_valuation + dispute purposes