Samuelz Chauffeur Booking

PrepareCreate one unpaid reservation andwith a binding offer for an eligible new ride, only after thefor customera explicitlycustomer-requested requestsnew it.ride. Use quote_ride for price alone, orand prepare_booking_change for an existing booking. PublicNo offercustomer preparationaccount needsis noneeded account;for preparation; private booking access remainsneeds separatelyseparate authorized.authorization.

PairBind caller-generatedthe retry pair to the intent:
- Generate submissionId and private resumeToken once. Keep both with onethe unchangedoriginal ride, contact, locale, service selectionofferKey and supplied partner capability.
- ChangingA languagechanged recipient or recipientlanguage conflicts;conflicts with that intent; it does not editupdate the original offer. KeepContact thatidentifies pairthe forreachable retriesrecipient, andnot get_offer_status;a neverbooking-access creategrant.

Act anotheron pairthe merelyresult:
- toprepared: escapeopen pending,checkoutUrl; ambiguousthe orcustomer conflict.reviews Contactthe suppliesbound aamount, reachableexpiry recipientand full terms, notthen booking-accessexplicitly authority.

Reviewconfirms. andNo explicitlycharge confirmor theconfirmation boundoccurs offerin viathis checkoutUrl,call.
- thenpending/rate_limited: usewait get_offer_statusretryAfterSeconds; resume with the original pair tothrough readget_offer_status.
- ambiguous/conflict: inspect the outcome.original Waitsubmission; retryAfterSecondsnever whengenerate pendinga ornew rate_limited.pair Theto resumebypass proofit.
- lastsavailable: 24use hoursthat frombooking's firstID/reference claimedonly intake;within offerits expiryseparately isauthorized separate.lifecycle.

The preparedresume returnsproof reviewlasts links;24 availablehours suppliesfrom thisfirst booking'sclaimed identifiersintake. forRetries itsrenew customer-authorizedneither lifecycle.that Thislifetime callnor doesthe notseparate chargeoffer.expiresAt. orKeep confirmreview alinks booking.and resume proof private.

UseResume afterexactly one prepare_offer withsubmission theusing its original submissionId/resumeTokensubmissionId pair.and Itsprivate storedresumeToken. proofUse expiresthis 24while hoursthe submission is pending or after firstthe claimedcustomer intake;reviews retriescheckout; doget_booking_status reads an already selected OAuth booking instead.

The pair identifies the original intent, not renewa it.supplier ThisofferKey differsor a customer login. Do not combine credentials from offer.expiresAt.different Nosubmissions. locale;Unchanged retries preserve the original language isand preserved.do not renew the 24-hour resume-proof lifetime or offer expiry.

prepared returnssupplies review links; available returnssupplies thisthat booking's bookingKey/bookingReferenceidentifiers and recorded booking/payment/fulfillment. Supplier offerKey is notoutcome. aWait bookingretryAfterSeconds identifier.for Forpending. pendingOn waitambiguous retryAfterSecondsor andconflict retryinspect the pair. Inspectoriginal ambiguous/conflictintent before retrying prepare_offerpreparation. unchanged.

not_found denies proof access; unavailable is not vehicle-availability evidence. Use quote_ride for price, customerPortalUrl for private login. No mutation, history, cancellationbooking oraction modification.occurs.

Use first to read publishedRead servicesupported scopeservices, required ride facts and localthe timeZone;service-location notime pricezone orbefore availabilitycollecting isa confirmed.

Optionalnew offerKeyride. selectsUse anget_customer_policy existingfor publishedpurchase offer'srules, configuredquote_ride location;for omitprice, or prepare_offer for thean defaultexplicitly scope.

HTTPrequested usesoffer.

Language no-store.and Re-readlocation beforeare quoting;independent: nolocale=de freshnessdoes windownot isselect promised.Germany, Thisand readlocale=en does not consumemove the quoteservice rate-limitelsewhere. budget.

CorrectOmit invalid_requestofferKey input;for unavailablethe meanspublished scopedefault; couldotherwise notuse bea read.known Usepublished get_customer_policyselection forand ruleskeep it across policy, quote_ridequote forand priceoffer. Changing location requires reading its timeZone before interpreting pickup times.

This uncached read consumes no quote admission. available describes supported requests, ornot prepare_offerreserved forvehicles; anre-read explicitlybefore requestedquoting. offer.Correct invalid_request facts. unavailable leaves service scope unverified.

UsePrepare onlyone forunpaid anreservation explicitand binding offer request:for offerRequested=true,an completeeligible new ride facts,only emailafter ORthe E.164customer phone.explicitly Forrequests it. Use quote_ride for price onlyalone, useor quote_ride.prepare_booking_change for an existing booking. Public offer preparation needs no account; private booking access remains separately authorized.

EligiblePair ridescaller-generated getsubmissionId and private resumeToken with one unpaidunchanged draftride, contact and offerservice link.selection. ReviewKeep boundthat termspair for retries and confirmget_offer_status; vianever checkoutUrl;create noanother chargepair ormerely bookingto confirmationescape occurspending, here.

Retryambiguous unchangedor submissionId/resumeToken/inputs.conflict. ForContact pending/rate_limitedsupplies waita retryAfterSeconds;reachable onrecipient, ambiguous/conflictnot inspectbooking-access get_offer_status.authority.

ChangedReview factsand needexplicitly aconfirm newthe explicitbound intent.offer Thevia callercheckoutUrl, generatesthen submissionIduse (UUID)get_offer_status andwith resumeTokenthe (32original randompair bytesto asread 64the hexoutcome. characters);Wait theretryAfterSeconds storedwhen pending or rate_limited. The resume proof expireslasts 24 hours afterfrom first claimed intake,intake; separatelyoffer fromexpiry offer.expiresAt.is separate. prepared returns links, notreview bookinglinks; IDs.available Onlysupplies availablethis returnsbooking's bookingKey/bookingReferenceidentifiers for thatits samecustomer-authorized booking;lifecycle. supplierThis offerKeycall isdoes not acharge bookingor ID.confirm a booking.

Use after get_service_options forCalculate a price preview withfor complete ride facts without contact details. Use for pricing; prepare_offer creates an explicitly requested new offer, while prepare_booking_change reviews an existing booking's amendment.

Keep ride times in the timeZone returned timeZone;for nothe contactsame isofferKey. needed.

Return tripsservice needneeds returnDate/returnTime.its Hourlylater return pickup; hourly service needs serviceType=hourly,one_way tripType=one_wayand duration. Vehicle preference and hours.

RevalidatespecialRequests share a 500-character combined note limit, including the calculatedAtpreference preview.label Forand rate_limitedseparator: waitindividually retryAfterSeconds;valid followfields review_requiredcan guidancetogether withoutexceed inferringit. vehicleKeep unavailability.volunteered requirements intact; ask for clarification rather than silently truncate them.

Createsquoted noreturns offer,a reservationprice/tax/inclusion breakdown by leg, chargenot orreserved message.capacity. UseRoute/pricing prepare_offerreads onlyconsume forquote admission and repeated calls may differ. Revalidate before an explicitoffer. Wait retryAfterSeconds on rate_limited; follow review_required guidance. No offer, request.reservation, charge or message is created.

Use after prepare_offer with the original submissionId/resumeToken pair,pair. validIts forstored proof expires 24 hours.hours after first claimed intake; retries do not renew it. This differs from offer.expiresAt. No locale; original language is preserved.

Readsprepared offerreturns statereview orlinks; available returns this booking's bookingKey/bookingReference and recorded booking/payment/fulfillment. Supplier offerKey is not a booking identifier. For pending wait retryAfterSeconds and retry the pair. ⟨28 unchanged words⟩ 

 ⟨5 unchanged words⟩ ,"properties":{"resumeToken":{"description":"PrivateCaller-generated private 64-character hexadecimal secret generated for this submission.submission Reuse(32 random bytes). Keep its original pairsubmissionId withpair. submissionIdThe forstored resume proof expires 24 hours after first claimed intake; unchanged retries do not renew it. This is separate from offer.expiresAt and status;is nevernot substitutean account credentials.

 ⟨7 unchanged words⟩ :{"status":{"const":"invalid_request","description":"Input does not match this operation's contract; correct the facts before retrying.","type":"string"}},"required":["status ⟨2 unchanged words⟩ additionalProperties":false,"properties":{"bookingUrl":{"description":"Published customer booking page for this provider and locale; the URL does not grant private booking access or confirm availability.","format":"uri","type":"string"},"status":{"const":"unavailable","description":"The requested information could not be supplied safely; this is not vehicle-unavailability evidence.","type":"string"}},"required":["status ⟨2 unchanged words⟩ additionalProperties":false,"properties":{"retryAfterSeconds":{"description":"Wait at least this many seconds, then use the same original submissionId/resumeToken pair for status or unchanged retry.","exclusiveMinimum":0,"maximum":9007199254740991,"type":"integer"},"status":{"const":"pending","description":"The original offer-intent execution is still pending; no completed offer result is available.","type":"string"}},"required":["status ⟨3 unchanged words⟩ additionalProperties":false,"properties":{"retryAfterSeconds":{"description":"Wait at least this many seconds before retrying the unchanged submissionId/resumeToken and facts.","exclusiveMinimum":0,"maximum":9007199254740991,"type":"integer"},"status":{"const":"rate_limited","description":"Offer preparation admission was rate-limited; retry only the unchanged explicit offer intent.","type":"string"}},"required":["status ⟨3 unchanged words⟩ additionalProperties":false,"properties":{"status":{"description":"conflict means stored intent/offer facts disagree; ambiguous means execution or bound evidence cannot safely be resolved; not_found denies access to the original submission proof. Inspect status rather than blindly creating another offer.","

 ⟨43 unchanged words⟩ "offerKey":{"description":"Optional existing published providerprovider/supplier offer key. Selects its configured service location; it is not a customer bookingKey or bookingReference and grants no booking authority.access.","pattern":"^[a-z0-9][a-z0-9_-]{0 ⟨6 unchanged words⟩ 

 ⟨7 unchanged words⟩ :{"status":{"const":"invalid_request","description":"Input does not match this operation's contract; correct the facts before retrying.","type":"string"}},"required":["status ⟨2 unchanged words⟩ additionalProperties":false,"properties":{"bookingUrl":{"description":"Published customer booking page for this provider and locale; the URL does not grant private booking access or confirm availability.","format":"uri","type":"string"},"status":{"const":"unavailable","description":"The requested information could not be supplied safely; this is not vehicle-unavailability evidence.","type":"string"}},"required":["status ⟨2 unchanged words⟩ additionalProperties":false,"properties":{"bookingUrl":{"description":"Published customer booking page for this provider and locale; the URL does not grant private booking access or confirm availability.","format":"uri","type":"string"},"hourlyRideFacts":{"description":"Additional hourly-service fields and required service/trip-type values.","items":{"type":"string"},"type":"array"},"location":{"additionalProperties":false,"description":"Location configured for the supplied published offerKey; omitted for the default service scope.","properties":{"countryCode":{"description":"Country code configured for this service location.","type":"string"},"key":{"description":"Configured service-location key selected by the published supplier offerKey.","type":"string"},"label":{"description":"Location label in the requested language.","type":"string"}},"required":["key ⟨2 unchanged words⟩ ,"type":"object"},"nextAction":{"description":"Guidance to collect complete ride facts and request a price preview; no contact details are required for quoting.","type":"string"},"provider":{"description":"Published display name of the service provider.","type":"string"},"requiredRideFacts":{"description":"Ride fields to collect before quoting a transfer.","items":{"type":"string"},"type":"array"},"returnRideFacts":{"description":"Additional return-trip fields to collect for an outbound and later return pickup.","items":{"type":"string"},"type":"array"},"services":{"description":"Published service definitions and supported trip types.","items":{"additionalProperties":false,"properties":{"availability":{"const":"requires_offer_review","description":"Availability/acceptance still require review of an actual offer.","type":"string"},"key":{"description":"Published service identifier, such as transfer or hourly service.","type":"string"},"tripTypes":{"description":"Trip types supported by this service definition; not confirmed availability.","items":{"enum":["one_way","return" ⟨12 unchanged words⟩ },"status":{"const":"available","description":"Published service information is readable; no price, acceptance or availability is confirmed.","type":"string"},"timeZone":{"description":"Configured local provider time zone for ride dates and pickup times.","type":"string"}},"required":[" ⟨13 unchanged words⟩ 

 ⟨52 unchanged words⟩ inspect get_offer_status.

Changed facts need a new explicit intent;intent. expired/revisedThe offerscaller needgenerates currentsubmissionId review.(UUID) and resumeToken (32 random bytes as 64 hex characters); the stored resume proof expires 24 hours after first claimed intake, separately from offer.expiresAt. prepared returns links, not booking IDs. Only available returns bookingKey/bookingReference for that same booking; supplier offerKey is not a booking ID.

 ⟨224 unchanged words⟩ "offerKey":{"description":"Optional existing published providerprovider/supplier offer key. Selects its configured service location; it is not a customer bookingKey or bookingReference and grants no booking authority.access.","pattern":"^[a-z0-9][a-z0-9_-]{0 ⟨27 unchanged words⟩ :"boolean"},"resumeToken":{"description":"PrivateCaller-generated private 64-character hexadecimal secret generated for this submission.submission Reuse(32 random bytes). Keep its original pairsubmissionId withpair. submissionIdThe forstored resume proof expires 24 hours after first claimed intake; unchanged retries do not renew it. This is separate from offer.expiresAt and status;is nevernot substitutean account credentials.credential.","pattern":"^[a-f0-9]{64}$" ⟨388 unchanged words⟩ :"string"},"submissionId":{"description":"IdentifiesCaller-generated UUID for one explicitly requested offer intent. GenerateKeep athe UUIDsame submissionId/resumeToken and unchanged facts for aretries requestedand newstatus; offer;a keepnew itexplicit withintent theneeds samea resumeTokennew forpair. unchangedThis retriesis andnot status.a bookingKey.","format":"uuid","pattern":"^ ⟨28 unchanged words⟩ 

 ⟨7 unchanged words⟩ :{"status":{"const":"invalid_request","description":"Input does not match this operation's contract; correct the facts before retrying.","type":"string"}},"required":["status ⟨2 unchanged words⟩ additionalProperties":false,"properties":{"bookingUrl":{"description":"Published customer booking page for this provider and locale; the URL does not grant private booking access or confirm availability.","format":"uri","type":"string"},"status":{"const":"unavailable","description":"The requested information could not be supplied safely; this is not vehicle-unavailability evidence.","type":"string"}},"required":["status ⟨2 unchanged words⟩ additionalProperties":false,"properties":{"retryAfterSeconds":{"description":"Wait at least this many seconds, then use the same original submissionId/resumeToken pair for status or unchanged retry.","exclusiveMinimum":0,"maximum":9007199254740991,"type":"integer"},"status":{"const":"pending","description":"The original offer-intent execution is still pending; no completed offer result is available.","type":"string"}},"required":["status ⟨3 unchanged words⟩ additionalProperties":false,"properties":{"retryAfterSeconds":{"description":"Wait at least this many seconds before retrying the unchanged submissionId/resumeToken and facts.","exclusiveMinimum":0,"maximum":9007199254740991,"type":"integer"},"status":{"const":"rate_limited","description":"Offer preparation admission was rate-limited; retry only the unchanged explicit offer intent.","type":"string"}},"required":["status ⟨3 unchanged words⟩ additionalProperties":false,"properties":{"status":{"description":"conflict means stored intent/offer facts disagree; ambiguous means execution or bound evidence cannot safely be resolved; not_found denies access to the original submission proof. Inspect status rather than blindly creating another offer.","

 ⟨43 unchanged words⟩ "offerKey":{"description":"Optional existing published providerprovider/supplier offer key. Selects its configured service location; it is not a customer bookingKey or bookingReference and grants no booking authority.access.","pattern":"^[a-z0-9][a-z0-9_-]{0 ⟨395 unchanged words⟩ 

 ⟨7 unchanged words⟩ :{"status":{"const":"invalid_request","description":"Input does not match this operation's contract; correct the facts before retrying.","type":"string"}},"required":["status ⟨2 unchanged words⟩ additionalProperties":false,"properties":{"bookingUrl":{"description":"Published customer booking page for this provider and locale; the URL does not grant private booking access or confirm availability.","format":"uri","type":"string"},"status":{"const":"unavailable","description":"The requested information could not be supplied safely; this is not vehicle-unavailability evidence.","type":"string"}},"required":["status ⟨2 unchanged words⟩ additionalProperties":false,"properties":{"bookingUrl":{"description":"Published customer booking page for this provider and locale; the URL does not grant private booking access or confirm availability.","format":"uri","type":"string"},"retryAfterSeconds":{"description":"Wait at least this many seconds before retrying the same quote request.","exclusiveMinimum":0,"maximum":9007199254740991,"type":"integer"},"status":{"const":"rate_limited","description":"Quote admission is currently rate-limited; no quote was returned.","type":"string"}},"required":["status ⟨4 unchanged words⟩ additionalProperties":false,"properties":{"bookingUrl":{"description":"Published customer booking page for this provider and locale; the URL does not grant private booking access or confirm availability.","format":"uri","type":"string"},"message":{"description":"Customer-language explanation of the required review.","type":"string"},"review":{"additionalProperties":false,"description":"Structured review reason and next step when supplied; not an availability confirmation.","properties":{"availabilityConfirmed":{"const":false,"description":"This review result does not confirm availability.","type":"boolean"},"code":{"description":"Reason for further requirements, model, address, service-scope, booking-window or route review; not vehicle-unavailability evidence.","enum":["additional_requirements_review","model_guarantee_review","address_review", ⟨4 unchanged words⟩ string"},"customerContactRequired":{"const":false,"description":"No customer contact is required for this price/requirements review.","type":"boolean"},"nextAction":{"const":"review_requirements","description":"Review the stated requirements before proceeding; do not infer acceptance or confirmed availability.","type":"string"}},"required":["code ⟨5 unchanged words⟩ },"status":{"const":"review_required","description":"The ride facts or requirements require further review; no availability conclusion is made.","type":"string"}},"required":["status ⟨6 unchanged words⟩ properties":{"bookingConfirmed":{"const":false,"description":"A quote does not confirm or create a booking.","type":"boolean"},"bookingUrl":{"description":"Published customer booking page for this provider and locale; the URL does not grant private booking access or confirm availability.","format":"uri","type":"string"},"nextAction":{"description":"Guidance to proceed only to an explicitly requested offer after reviewing the preview.","type":"string"},"quote":{"additionalProperties":false,"description":"Calculated price preview and tax/inclusion breakdown; no reservation or availability confirmation.","properties":{"billableHoursPerServiceLine":{"description":"Billable hours used for each calculated service line.","exclusiveMinimum":0,"type":"number"},"calculatedAt":{"description":"Timestamp of this preview calculation, not a guaranteed price-validity window.","type":"string"},"currency":{"description":"Currency of the price preview.","type":"string"},"grossTotalCents":{"description":"Gross total of the preview in the returned currency's minor units (EUR cents).","maximum":9007199254740991,"minimum":0,"type":"integer"},"parkingIncluded":{"description":"Whether parking costs are included in the preview.","type":"boolean"},"pricesIncludeVat":{"description":"Whether the returned price includes VAT.","type":"boolean"},"revalidationRequired":{"const":true,"description":"Revalidate price and terms before preparing or confirming an offer.","type":"boolean"},"serviceLines":{"description":"Price breakdown by outbound/return service line.","items":{"additionalProperties":false,"properties":{"direction":{"description":"The outbound or return leg priced by this service line.","enum":["outbound","return"],"type":"string"},"grossAmountCents":{"description":"Gross price for this service line in the returned currency's minor units.","maximum":9007199254740991,"minimum":0,"type":" ⟨6 unchanged words⟩ ,"type":"array"},"tollsIncluded":{"description":"Whether toll costs are included in the preview.","type":"boolean"},"vatRateBasisPoints":{"description":"VAT rate in basis points: 10000 basis points equal 100 percent.","maximum":9007199254740991,"minimum":0,"type":"integer"},"vehicleCount":{"description":"Vehicle count used in this price calculation, not confirmed vehicle availability.","exclusiveMinimum":0,"maximum":9007199254740991,"type":" ⟨14 unchanged words⟩ "object"},"status":{"const":"quoted","description":"A price preview was calculated; it must be revalidated before an actual offer.","type":"string"}},"required": ⟨9 unchanged words⟩ 

Use to read one existingafter requestprepare_offer with itsthe original submissionId/resumeToken pair within the original 24-hour, window.valid Returnsfor offer24 statehours. orNo recordedlocale; booking/payment/fulfillmentoriginal afterlanguage payment;is nopreserved.

Reads pricingoffer callstate or new businessrecorded action.booking/payment/fulfillment. For pending, wait retryAfterSeconds and retry thatthe pair. ForInspect ambiguous/conflict inspectbefore thatretrying intent;prepare_offer unchanged.

not_found denies access andaccess; unavailable is not vehiclevehicle-availability evidence. OpenUse quote_ride for price, customerPortalUrl for private login. No locale (original language)mutation, history, cancellation or modification.

Use first to learn thisread provider'spublished service scope, required ride facts and local timeZone.timeZone; Readno currentprice publishedor facts;availability dois notconfirmed.

Optional assumeofferKey additionalselects locations.an Languageexisting defaultspublished tooffer's English;configured passlocation; locale=deomit for German,the withoutdefault changingscope.

HTTP timeZone.uses Itno-store. givesRe-read before quoting; no pricefreshness orwindow availabilityis confirmation.promised. This read does not consume the quote rate-limit budget.

Correct invalid_request input; unavailable means scope could not be read. Use get_customer_policy for booking rules, quote_ride for a price, or prepare_offer only afterfor an explicitexplicitly offerrequested request.offer.

Use only for an explicit offer request with: offerRequested=true, complete ride facts and, email OR E.164 phone. CreatesFor price only use quote_ride.

Eligible rides get one unpaid draft and an offer link; the customerlink. reviewsReview bound terms and confirmsconfirm via checkoutUrl.checkoutUrl; Nono charge or booking confirmation. Use quote_ride forconfirmation price-onlyoccurs questions.here.

Retry Keepunchanged submissionId,submissionId/resumeToken/inputs. resumeTokenFor andpending/rate_limited inputswait unchangedretryAfterSeconds; on retries;ambiguous/conflict inspect get_offer_status on ambiguous/conflict. On rate_limited wait retryAfterSeconds. get_offer_status.

Changed facts need an explicitly requesteda new intent; expiredexplicit orintent; revisedexpired/revised offers requireneed current review.

Use after get_service_options to calculate anfor anonymousa price preview forwith complete ride facts in the providerreturned timeZone.timeZone; Nono contact is needed. Resolve missing return or hourly

Return factstrips beforeneed quoting.returnDate/returnTime. TheHourly calculatedAtservice previewneeds requiresserviceType=hourly, revalidation;tripType=one_way noand price-validityhours.

Revalidate windowthe iscalculatedAt guaranteed.preview. For rate_limited wait retryAfterSeconds. For review_requiredretryAfterSeconds; follow the returned guidance; itreview_required doesguidance notwithout proveinferring vehicle unavailability.

Creates Nono offer, reservation, charge or message is created.message. CallUse prepare_offer only for an explicit offer request.

Use to check progress or read the result of one previously requestedexisting offerrequest with its original submissionId/resumeToken pair, includingwithin pending,the prepared,original expired24-hour window. Returns offer state or recorded booking/payment/fulfillment after payment. Openpayment; customerPortalUrlno forpricing existingcall Samuelzor IDnew loginbusiness andaction. privateFor own-bookingpending, view.wait ThisretryAfterSeconds isand oneretry originalthat submission,pair. neverFor accountambiguous/conflict history,inspect athat newintent; quote,not_found cancellationdenies oraccess modification.and Useunavailable quote_rideis fornot avehicle priceevidence. orOpen prepare_offercustomerPortalUrl for an explicitly requested newprivate offer.login. No businesslocale or(original providerlanguage), requesthistory, iscancellation created.or modification.

 ⟨5 unchanged words⟩ ,"properties":{"resumeToken":{"description":"Client-generatedPrivate 64-character hexadecimal secret generated for this submission. Keep private;Reuse reuseits theoriginal exactpair submissionId/tokenwith pairsubmissionId for retries and status.status; Notnever ansubstitute account or booking-history credential.credentials.","pattern":"^[a-f0-9]{64}$","type":"string"},"submissionId":{"description":"Client-generatedIdentifies one offer intent. Generate a 

 ⟨7 unchanged words⟩  scope, required ride facts and local timeZone. Read current published facts; do not assume additional locations. Language defaults to English; pass locale=de for German, without changing timeZone. It gives no price or availability confirmation. Use  ⟨16 unchanged words⟩ 

 ⟨5 unchanged words⟩ ,"properties":{"locale":{"default":"deen","description":"ResponseUse the customer's requested language for text and booking links: deen (German,by default), orde enfor (English).German. Preserve it on retries; pickup times stay in the provider time zone.","enum":["de","en"],"type":"string"},"offerKey":{"description":"Optional existing published provider offer key. Selects its configured service location; not booking authority.","pattern":"^[a-z0-9][a-z0-9_-]{0,79}$","type":"string"}},"type":"object"}

 ⟨44 unchanged words⟩ :"string"},"type":"array"},"location":{"additionalProperties":false,"properties":{"countryCode":{"type":"string"},"key":{"type":"string"},"label":{"type":"string"}},"required":["key","countryCode","label"],"type":"object"},"nextAction":{"type":"string"},"provider" ⟨66 unchanged words⟩ 

Use only after thefor customeran explicitlyexplicit requestsoffer anrequest offerwith (offerRequested=true), with complete ride facts and email OR E.164 phone. Creates one unpaid draft and an offer linklink; withthe customer reviews bound terms;terms itand doesconfirms notvia checkoutUrl. No charge or confirmbooking aconfirmation. booking.Use Forquote_ride for price-only questionsquestions. useKeep quote_ride.submissionId, ReuseresumeToken theand sameinputs submissionId/resumeTokenunchanged foron retries; useinspect get_offer_status toon readambiguous/conflict. thatOn offer.rate_limited Changedwait ride/contactretryAfterSeconds. needsChanged afacts newneed intent.an Neverexplicitly treatrequested annew intent; expired or revised offer as current; the customer must review terms andoffers confirmrequire viacurrent checkoutUrl.review.

 ⟨183 unchanged words⟩ :"string"},"locale":{"default":"deen","description":"ResponseUse the customer's requested language for text and booking links: deen (German,by default), orde enfor (English).German. Preserve it on retries; pickup times stay in the provider time zone.","enum":["de","en"],"type":"string"},"offerKey":{"description":"Optional existing published provider offer key. Selects its configured service location; not booking authority.","pattern":"^[a-z0-9][a-z0-9_-]{0,79}$","type":"string"},"offerRequested":{"const":true,"description":"Must ⟨18 unchanged words⟩ :"boolean"},"resumeToken":{"description":"Client-generatedPrivate 64-character hexadecimal secret generated for this submission. 

Use forafter get_service_options to calculate an anonymous current price preview oncefor complete ride facts arein complete;the get_service_optionsprovider givestimeZone. requiredNo factscontact andis timeZone.needed. DoResolve notmissing includereturn contactor details.hourly Nofacts offer,before reservation,quoting. message,The chargecalculatedAt orpreview availabilityrequires guaranteerevalidation; no price-validity window is created.guaranteed. IfFor rate_limited wait retryAfterSeconds. For review_required follow the customerreturned explicitlyguidance; requestsit andoes offer,not useprove prepare_offer;vehicle anunavailability. existingNo offer, reservation, charge or message is readcreated. withCall get_offer_status.prepare_offer only for an explicit offer request.

 ⟨5 unchanged words⟩ ,"properties":{"locale":{"default":"deen","description":"ResponseUse the customer's requested language for text and booking links: deen (German,by default), orde enfor (English).German. Preserve it on retries; pickup times stay in the provider time zone.","enum":["de","en"],"type":"string"},"offerKey":{"description":"Optional existing published provider offer key. Selects its configured service location; not booking authority.","pattern":"^[a-z0-9][a-z0-9_-]{0,79}$","type":"string"},"ride":{"additionalProperties":false,"description":"Complete rideRide facts forwith adistinct

 ⟨589 unchanged words⟩ one_way","return"],"type":"string"},"vehiclePreference":{"description":"Volunteered vehicle preference only; no class, price or availability guarantee. Additional requirements may require review.","maxLength":240,"minLength":1,"type":"string"}},"required":["pickup","destination"," ⟨95 unchanged words⟩ 

 ⟨87 unchanged words⟩ "},{"additionalProperties":false,"properties":{"booking":{"additionalProperties":false,"properties":{"recordedStatus":{"maxLength":64,"minLength":1,"type":"string"}},"required":["recordedStatus"],"type":"object"},"bookingKey":{"maxLength":128,"minLength":1,"type":"string"},"bookingReference":{"minLength":1,"type":"string"},"customerPortalUrl":{"format":"uri","type":"string"},"fulfillment":{"additionalProperties":false,"properties":{"chauffeurAssignmentRecorded":{"type":"boolean"},"completionRecorded":{"type":"boolean"},"vehicleAssignmentRecorded":{"type":"boolean"}},"required":["chauffeurAssignmentRecorded","vehicleAssignmentRecorded","completionRecorded"],"type":"object"},"payment":{"additionalProperties":false,"properties":{"recordedStatus":{"maxLength":64,"minLength":1,"type":"string"}},"required":["recordedStatus"],"type":"object"},"status":{"const":"available","type":"string"}},"required":["status","bookingKey","bookingReference","booking","payment","fulfillment","customerPortalUrl"],"type":"object"},{"additionalProperties":false,"properties":{"bookingUrl":{"format":"uri","type":"string"},"message":{"type":"string"},"review":{"additionalProperties":false,"properties":{"availabilityConfirmed":{"const":false,"type":"boolean"},"code":{"enum":["additional_requirements_review","model_guarantee_review","address_review","service_scope_review","booking_window_review","route_review"],"type":"string"},"customerContactRequired":{"const":false,"type":"boolean"},"nextAction":{"const":"review_requirements","type":"string"}},"required":["code","customerContactRequired","availabilityConfirmed","nextAction"],"type":"object"},"status":{"const":"review_required","type":"string"}},"required":["status","bookingUrl","message","review"],"type":"object"},{"additionalProperties":false,"properties":{"status":{"const":"expired","type":"string"}},"required" ⟨7 unchanged words⟩ const":false,"type":"boolean"},"checkoutUrl":{"format":"uri","type":"string"},"customerPortalUrl":{"format":"uri","type":" ⟨62 unchanged words⟩ 

 ⟨354 unchanged words⟩ one_way","return"],"type":"string"},"vehiclePreference":{"description":"Volunteered vehicle preference only; no class, price or availability guarantee. Additional requirements may require review.","maxLength":240,"minLength":1,"type":"string"}},"required":["pickup","destination"," ⟨41 unchanged words⟩ 

 ⟨67 unchanged words⟩ ,"message":{"type":"string"},"review":{"additionalProperties":false,"properties":{"availabilityConfirmed":{"const":false,"type":"boolean"},"code":{"enum":["additional_requirements_review","model_guarantee_review","address_review","service_scope_review","booking_window_review","route_review"],"type":"string"},"customerContactRequired":{"const":false,"type":"boolean"},"nextAction":{"const":"review_requirements","type":"string"}},"required":["code","customerContactRequired","availabilityConfirmed","nextAction"],"type":"object"},"status":{"const":"review_required","type": ⟨127 unchanged words⟩ 

ReadUse to check progress or read the result of one preparedpreviously requested offer bywith its submissionIdoriginal andsubmissionId/resumeToken resumeToken.pair, Noincluding quotepending, prepared or expired status. It is not booking history, paymenta new price quote, messagecancellation or modification. Use quote_ride for a price or prepare_offer for an explicitly requested new offer. No business or provider request is created.

 ⟨3 unchanged words⟩ additionalProperties":false,"properties":{"resumeToken":{"description":"Client-generated 64-character hexadecimal secret for this submission. Keep private; reuse the exact submissionId/token pair for retries and status. Not an account or booking-history credential.","pattern":"^[a-f0-9]{64}$","type":"string"},"submissionId":{"description":"Client-generated UUID identifying exactly one offer intent. Reuse unchanged with the same resumeToken for prepare retries and get_offer_status; changed ride/contact needs a new UUID.","format":"uuid","pattern":"^([ ⟨25 unchanged words⟩ 

 ⟨87 unchanged words⟩ "},{"additionalProperties":false,"properties":{"status":{"const":"expired","type":"string"}},"required":["status"],"type":"object"},{"additionalProperties":false,"properties":{"bookingConfirmed":{"const":false,"type":"boolean ⟨66 unchanged words⟩ 

ReadUse first to learn this provider's public service scope, required ride facts and local timeZone. It gives no price or availability confirmation. Use get_customer_policy for booking link.rules, quote_ride for a price, or prepare_offer only after an explicit offer request.

 ⟨6 unchanged words⟩ :{"locale":{"default":"de","description":"Response language: de (German, default) or en (English).","enum":["de","en"],"type" ⟨3 unchanged words⟩ 

 ⟨38 unchanged words⟩ ":"uri","type":"string"},"hourlyRideFacts":{"items":{"type":"string"},"type":"array"},"nextAction":{"type":"string"},"provider" ⟨56 unchanged words⟩ ","bookingUrl","services","requiredRideFacts","returnRideFacts","hourlyRideFacts","nextAction"],"type":"object"}] ⟨2 unchanged words⟩ 

Prepare aan bindingunpaid chauffeur offer

PrepareUse exactlyonly after the customer explicitly requests an offer (offerRequested=true), with complete ride facts and email OR E.164 phone. Creates one unpaid reservationdraft and bindingan offer forlink anwith authorizedbound transfer,terms; returnit transferdoes not charge or hourlyconfirm service.a Requiresbooking. realFor customerprice-only contactquestions datause andquote_ride. aReuse client-generatedthe submissionIdsame andsubmissionId/resumeToken resumeToken.for Approvedretries; distributionuse partnersget_offer_status mayto addread theirthat opaqueoffer. capabilityChanged forride/contact tenant-boundneeds attribution.a Thenew customerintent. mustNever reviewtreat thean completeexpired boundor termsrevised andoffer confirmas oncurrent; checkoutUrl;the thiscustomer doesmust notreview chargeterms orand confirm thevia booking.checkoutUrl.

 ⟨5 unchanged words⟩ properties":{"contact":{"additionalProperties":false,"description":"Customer/booker contact for this explicitly requested offer: email OR E.164 phone is required. Contact does not authorize private booking/history access.","properties":{"email":{"description":"Reachable customer/booker email, at most 254 characters; required if no phone is supplied.","format":"email","maxLength":254,"pattern" ⟨14 unchanged words⟩ ,"type":"string"},"fullName":{"description":"Optional customer/booker full name, 2–120 characters.","maxLength":120,"minLength":2,"type":"string"},"phone":{"description":"Reachable international E.164 phone, + followed by 7–15 digits, no spaces; required if no email is supplied.","pattern":"^\\+[1-9][0-9]{6,14} ⟨3 unchanged words⟩ ,"type":"object"},"distributionPartnerCapability":{"description":"Optional existing opaque dp_live_ capability issued to an approved distribution partner. Omit for normal customers; do not create or guess one.","pattern":"^dp_live_[a-f0-9]{64}$","type":"string"},"firstTouchTrackingToken":{"description":"Optional existing server-issued first-touch UUID token for this tenant and consented attribution. Omit if none; never invent a token or source.","pattern":"^[0-9a-f]{8}-[0-9a-f]{ ⟨14 unchanged words⟩ },"locale":{"default":"de","description":"Response language: de (German, default) or en (English).","enum":["de","en"],"type":"string"},"offerRequested":{"const":true,"description":"Must be true only after the customer explicitly requests an offer; a price question alone is insufficient consent.","type":"boolean"},"resumeToken":{"description":"Client-generated 64-character hexadecimal secret for this submission. Keep private; reuse the exact submissionId/token pair for retries and status. Not an account or booking-history credential.","

 ⟨87 unchanged words⟩ "},{"additionalProperties":false,"properties":{"status":{"const":"expired","type":"string"}},"required":["status"],"type":"object"},{"additionalProperties":false,"properties":{"bookingConfirmed":{"const":false,"type":"boolean ⟨66 unchanged words⟩ 

GetUse afor an anonymous current price preview for completeonce ride facts, usingare localcomplete; serviceget_service_options timegives required facts and addressestimeZone. withDo citynot orinclude postcode.contact Nodetails. availabilityNo guaranteeoffer, bookingreservation, chargemessage, messagecharge or reservation.availability Doguarantee notis includecreated. If the customer contactexplicitly details.requests an offer, use prepare_offer; an existing offer is read with get_offer_status.

 ⟨6 unchanged words⟩ :{"locale":{"default":"de","description":"Response language: de (German, default) or en (English).","enum":["de","en"],"type":"string"},"ride":{"additionalProperties":false,"description":"Complete ride facts for a transfer, return transfer or hourly service. Distinct pickup/destination and valid local dates/times are required.","properties":{"date":{"description":"Service date as YYYY-MM-DD in the provider timeZone returned by get_service_options; resolve relative dates first.","pattern":"^\\d{4}-\\d{2}-\\d{2}$","type":"string"},"destination":{"description":"Destination distinct from pickup, with city/municipality or postcode; e.g. München Hauptbahnhof, 80335 München. For hourly service describe the planned route or As directed.","maxLength":240,"minLength":2,"type":"string"},"flightNumber":{"description":"Optional flight number for the airport ride, such as LH123; at most 240 characters.","maxLength":240,"minLength":1,"type":"string"},"hours":{"description":"Booked hourly-service duration, integer 1–24 hours; required with serviceType=hourly and forbidden for transfers.","maximum":24,"minimum":1,"type":"integer"},"luggage":{"description":"Optional luggage count/type or fit requirements, at most 240 characters; unusual luggage may require review.","maxLength":240,"minLength":1,"type":"string"},"passengers":{"description":"Total passenger count, integer 1–60; vehicle requirements and acceptance are evaluated separately.","maximum":60,"minimum":1,"type":"integer"},"pickup":{"description":"Pickup address or named place with city/municipality or postcode; e.g. Flughafen München (MUC), 85356 München-Flughafen.","maxLength":240,"minLength":2,"type":"string"},"returnDate":{"description":"Return service date YYYY-MM-DD; required only when tripType=return. The return must follow the outbound pickup.","pattern":"^\\d{4}-\\d{2}-\\d{2}$","type":"string"},"returnTime":{"