# WooCommerce Spare Parts Marketplace – Complete Project Specification ## 1. Introduction This document defines the **complete functional and technical scope** for developing an **online spare parts marketplace** using **WooCommerce**. The platform will serve **both B2B and B2C customers**, operate under a **hybrid fulfilment model** (local warehouse, Australian dropship suppliers, and China-based dropship suppliers), and support **vehicle-based part identification**, including **optional Redbook API integration** using vehicle registration number or VIN. --- ## 2. Business Model Overview ### Sales Channels * B2C (Retail customers) * B2B (Workshops, fleet operators, resellers) ### Fulfilment Sources 1. Local warehouse (Brisbane, Australia) 2. Australian dropship suppliers 3. China-based dropship suppliers ### Key Objectives * Accurate part compatibility * Reduced returns * Transparent delivery timelines * Tiered pricing and account control * End-to-end order lifecycle management --- ## 3. User Roles & Access Control ### User Roles * Guest Customer * Registered Retail Customer * B2B Trade Customer * B2B Corporate Customer * Warehouse Staff * Customer Support Staff * Administrator ### Role-Based Permissions * Pricing visibility * Payment method access * Order approval requirements * Credit limits * Backend access control --- ## 4. Product & Catalog Management ### Product Types * Simple products * Variable products * Bundled / Kit products * Service products (optional) ### Product Taxonomy * Vehicle Make * Vehicle Model * Year range * Engine type * Variant / Trim * Fuel type * Transmission * Part category * OEM / Aftermarket * Quality grade ### Product Metadata * OEM part number * Aftermarket equivalent numbers * Superseded part references * Compatible vehicle list * Warranty period * Country of origin * Compliance notes (ADR / AU standards) --- ## 5. Vehicle-Based Part Identification ### Global Rego / VIN Quick Search * Prominent Rego / VIN search bar in header (available on all pages) * Instant vehicle detection using Registration Number or VIN * Auto-apply detected vehicle across site navigation and search ### Standard Vehicle Selector * Make → Model → Year → Engine → Variant * Manual selection fallback if Rego/VIN is unavailable ### Redbook API Integration (Optional Search Method) * Vehicle identification via: * Registration number (Australia) * VIN * Auto-population of vehicle details * Display only compatible parts * Compatibility confidence indicators: * Exact match * Likely compatible (manual verification recommended) * Not compatible (hidden by default) ### My Garage (Saved Vehicles) * Save multiple vehicles per user account * Quick switch between saved vehicles * Default vehicle auto-selected on login ### Fitment Confirmation * Visual fitment badge on product cards (Verified / Likely / Check Fitment) * Mandatory confirmation checkbox before checkout * Fitment summary stored against order --- ## 6. Search, Filtering & UX * Keyword search (part number, OEM number, description) * Vehicle-aware search results * Advanced faceted filters: * Brand * OEM vs Aftermarket * Price range * Warranty * Availability (Local / AU / China) * Recently viewed parts * Saved vehicles (logged-in users) * Mega menu with deep part categories and vehicle makes --- ## 7. Inventory & Fulfilment Management ### Inventory Sources * Brisbane warehouse (real stock) * AU dropship suppliers (virtual stock) * China dropship suppliers (virtual stock) ### Inventory Logic * Multi-location stock handling * Stock priority rules (Local → AU → China) * Lead time management per source * Backorder handling with ETA * Split shipment support --- ## 7A. Dropshipping Operating Model (Mandatory) This project must fully support a **white-label dropshipping model** for both Australian and China-based suppliers. Dropshipping is a **core operating requirement**, not an add-on. ### Supplier Abstraction Rules * End customers must **never see supplier identities** * All customer-facing communication must use **store branding only** * Packing slips, invoices, and emails must not expose supplier details * China suppliers must appear as “International Fulfilment Partner” only ### Supplier Configuration * Ability to configure multiple suppliers per product * Supplier attributes per SKU: * Cost price (AUD / CNY) * Fulfilment location (Warehouse / AU / China) * Dispatch SLA * Return eligibility * Warranty handling rules ### Order Routing Logic * Automatic supplier selection based on: * Stock availability * Fulfilment priority * Customer location * Automatic purchase order generation per supplier * Support for one order → multiple supplier POs ### Partial Fulfilment Handling * Single customer order may be fulfilled from multiple sources * Partial shipment tracking per fulfilment source * Consolidated customer invoice * Automated partial shipment notifications ### Payment & Risk Controls * Ability to restrict payment methods for China-fulfilled items * Manual review for high-value or high-risk dropship orders * Cancellation rules based on supplier dispatch status ### China Dropshipping Constraints * Extended dispatch and delivery timelines * Import GST and landed cost handling * Restricted return windows * Clear customer communication for international fulfilment ### Supplier Cost & Margin Tracking * Separation of: * Supplier cost * Freight cost * Import cost * Retail price * Margin reporting by supplier and fulfilment source --- ## 8. Pricing, Tax & Compliance ### Pricing Models * B2C pricing (GST inclusive) * B2B pricing (GST exclusive) * Tiered wholesale pricing * Volume-based discounts ### Tax Handling * Australian GST compliance * Import GST logic for China shipments * ABN capture & validation * Tax invoice generation --- ## 9. B2B-Specific Features * Account registration & approval workflow * Custom price lists per customer * Minimum order quantities * Credit limits * Net payment terms (7/14/30 days) * Bulk order upload (CSV) --- ## 10. Shipping & Logistics * Courier integrations (Australia) * Weight & dimension-based shipping rules * Supplier-based shipping logic * Dynamic delivery ETA by postcode * Clear delivery speed labels (Same Day / Next Day / Import) * Click & Collect (Brisbane warehouse) * Pickup readiness ETA * Tracking number assignment per shipment * Split-shipment customer notifications --- ## 11. Payments ### Payment Methods * Credit/Debit Cards (Stripe) * PayPal * Bank Transfer * BNPL (optional) ### Payment Rules * Method restrictions based on fulfilment source * Manual approval for large B2B orders * Partial payments / deposits (optional) --- ## 12. Order Lifecycle & Automation ### Order Status Flow * Pending * Processing * Supplier Ordered * Dispatched * Delivered * Completed ### Automation * Supplier notifications * Purchase order generation * Status-based email/SMS updates * Delay alerts --- ## 13. Returns, Warranty & Claims ### Returns Management * Online RMA (Return Merchandise Authorisation) portal * Fitment-based return eligibility validation * Supplier-specific return routing * Restocking fee handling * Return status tracking in customer account ### Warranty Claims * Warranty badge display on product and category pages * Online warranty claim submission * Proof of fitment & installation upload * Warranty claim workflow tracking --- ## 14. Customer Communication * Order confirmation with fitment summary * Shipping & delay notifications * Warranty & return updates * Account-based messaging --- ## 15. Content, SEO & Trust * Fitment guides & help articles * Installation guides & videos * Part-number SEO optimisation * Vehicle-based landing pages * Structured data (schema.org) * Verified buyer reviews & ratings * Product Q&A section * Trust badges (Warranty, Genuine, Certified Supplier) * Brand & supplier logo display --- ## 16. Reporting & Analytics * Sales by vehicle * Sales by supplier * Margin analysis * Inventory ageing * Return rate reporting --- ## 17. Security & Compliance * HTTPS & secure hosting * API key protection * Role-based backend access * Audit logs * Privacy compliance (Australia) --- ## 18. Performance & Scalability * Object caching * CDN * Optimised database queries * Search indexing (ElasticSearch / Algolia preferred) --- ## 19. Integrations & Extensibility * Redbook API integration * Supplier inventory & pricing feeds * Loyalty / rewards program readiness * Accounting system integration (future) * ERP integration readiness (future) --- ## 20. Project Deliverables * Fully functional WooCommerce website * All configured plugins * Custom code & integrations * Documentation * Admin training * Post-launch support (handover) --- ## 21. Out-of-Scope (Unless Quoted Separately) * Native mobile applications * Custom ERP implementation * Advanced AI recommendation engine * Custom courier network software --- ## 22. Acceptance Criteria * Accurate part compatibility * Successful multi-source fulfilment * Correct pricing & tax logic * Stable performance under load * Secure, compliant system ---