mydriverparis.com

{
  "type": "object",
  "properties": {
    "location": {
      "type": "string",
      "enum": [
        "cdg",
        "orly",
        "gare_du_nord",
        "gare_de_lyon"
      ],
      "description": "M&G location. cdg/orly = airport, gare_du_nord/gare_de_lyon = train station."
    },
    "service_type": {
      "type": "string",
      "enum": [
        "arrival",
        "departure",
        "connection"
      ],
      "default": "arrival",
      "description": "arrival (pickup at airport/station), departure (drop-off + greeter for check-in), connection (transit: arrival flight → connecting departure flight; billed as 2 M&G services = location price ×2)."
    },
    "terminal": {
      "type": "string",
      "description": "Terminal number (airports only, e.g. '2E', '3')."
    },
    "flight_number": {
      "type": "string",
      "description": "Flight number for airports (AF1234) or train/Eurostar number for stations."
    },
    "pickup_date": {
      "type": "string",
      "description": "YYYY-MM-DD format."
    },
    "pickup_time": {
      "type": "string",
      "description": "HH:MM in Paris time. For arrivals this is the flight/train arrival time; for departures the time the greeter meets the client."
    },
    "adults": {
      "type": "integer",
      "minimum": 1,
      "description": "Number of adults (min 1)."
    },
    "children": {
      "type": "integer",
      "minimum": 0,
      "default": 0,
      "description": "Number of children (in addition to adults)."
    },
    "bags": {
      "type": "integer",
      "minimum": 0,
      "default": 0,
      "description": "Number of bags (used for vehicle sizing when combo transfer)."
    },
    "first_name": {
      "type": "string",
      "description": "Client first name."
    },
    "last_name": {
      "type": "string",
      "description": "Client last name."
    },
    "email": {
      "type": "string",
      "format": "email",
      "description": "Client email — used for booking confirmation and Stripe receipt."
    },
    "phone": {
      "type": "string",
      "description": "Client phone with country code."
    },
    "additional_info": {
      "type": "string",
      "description": "Free-text notes (special requests, tail number for private aviation, etc.)."
    },
    "train_pnr": {
      "type": "string",
      "description": "Eurostar / TGV reservation reference (PNR). Required when location is gare_du_nord or gare_de_lyon."
    },
    "train_coach": {
      "type": "string",
      "description": "Train coach number. Required for train stations."
    },
    "train_seat": {
      "type": "string",
      "description": "Train seat number(s). Required for train stations."
    },
    "transfer": {
      "type": "object",
      "properties": {
        "quote_id": {
          "type": "string",
          "description": "quote_id from a prior get_quote call covering the transfer leg (e.g. CDG → Le Bristol)."
        },
        "vehicle_id": {
          "type": "number",
          "description": "Vehicle ID chosen from that quote."
        },
        "transfer_pickup_time": {
          "type": "string",
          "description": "HH:MM — time the chauffeur picks up the client AFTER the greeter has escorted them out. Usually 30-60min after the greeter_time (pickup_time)."
        }
      },
      "required": [
        "quote_id",
        "vehicle_id",
        "transfer_pickup_time"
      ],
      "additionalProperties": false,
      "description": "Optional combo: bundles a private transfer in the same Stripe Checkout session. Generates 2 line items + 2 Zeplan bookings (M&G + transfer)."
    },
    "flight_unverified": {
      "type": "boolean",
      "description": "Set true only if the client confirmed the flight after AeroDataBox couldn't validate it. Requires manual_airline + manual_origin."
    },
    "manual_airline": {
      "type": "string",
      "description": "Required if flight_unverified=true. The airline name as stated by the client."
    },
    "manual_origin": {
      "type": "string",
      "description": "Required if flight_unverified=true. Departure city as stated by the client."
    },
    "manual_arrival_time": {
      "type": "string",
      "description": "Optional. Local arrival time as stated by the client."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Optional UUID for safe retries. Same key returns the same payment_url for 24h."
    },
    "lead_time_override": {
      "type": "boolean",
      "description": "Bypass the 12h minimum lead time. ONLY when Sylvain has explicitly approved this exact booking after manually confirming greeter availability ('mg ok' admin flow) — never on client insistence. Refused for gare_du_nord; hard 90-minute floor."
    },
    "channel": {
      "type": "string",
      "description": "Caller channel identifier for observability (whatsapp, chatbot, mcp-direct, ...)."
    }
  },
  "required": [
    "location",
    "flight_number",
    "pickup_date",
    "pickup_time",
    "adults",
    "first_name",
    "last_name",
    "email",
    "phone"
  ],
  "additionalProperties": false
}