Billion Integration (Marketplace)

Overview

Billion is our marketplace syndication subsystem that allows Power‑Rent to publish vehicles, manage availability and prices, and ingest reservations placed through the marketplace.

Key Features

• Vehicle Publishing: Own and static vehicle sync to marketplace
• Master Data: Companies, brands, models, locations synchronization
• Order Flow: Reservation ingestion and status updates from marketplace
• Legal Documents: Marketplace-specific terms, agreements, and consent forms
• Moderation: Pre-publishing workflows and SEO optimization

Architecture

The integration uses a public API layer for marketplace communication, GraphQL resolvers for internal operations, and dedicated admin UI for management. Vehicle data is stored in existing vehicles and orders tables with Billion-specific fields added via JSON columns and flags.

Data Flow

1. Marketplace fetches inventory via public endpoints
2. Orders placed on marketplace are ingested via webhook endpoints
3. Internal order creation and price reconciliation
4. Status updates propagate back to marketplace via hooks

For detailed implementation information, see: docs/features/integrations/billion.md