Booking API
Create truck wash booking.
Creates a booking for a truck wash location. Provide all required booking details so the service partner can deliver the best possible service.
Endpoint
POST - https://api.travisroadservices.com/v1/bookings/truckwash
Copy
Request body
Fields
| Field | Type | Required | Description |
|---|---|---|---|
arrival
|
string (date-time) | Yes | Expected arrival date for the truck wash booking. |
washProgram
|
object | Yes | Wash program selection for the booking. Provide either washProgramId or cleaningType. |
washProgramId
|
integer | No | Unique identifier of the wash program. When provided, other wash program parameters are ignored. |
cleaningType
|
string | No | Cleaning type for the truck wash. Used when no wash program ID is provided. |
isDisinfection
|
boolean | No | Indicates whether disinfection is included in the wash program. |
isNao
|
boolean | No | Indicates whether NAO treatment is included in the wash program. |
isSelfService
|
boolean | No | Indicates whether the booking uses a self-service wash lane. |
location
|
integer | Yes | Location ID for the location you want to place the booking. |
reference
|
string | No | Customer reference attached to the transaction for easy identification. Maximum 50 characters. |
truck
|
object | No | Truck vehicle for the booking. Provide a known vehicle ID from the vehicle API or supply a licensePlate directly. |
vehicleId
|
integer | No | Vehicle ID known at TRAVIS. When provided, other vehicle parameters are ignored. |
licensePlate
|
string | No | License plate of the vehicle. Required when no vehicle ID is provided; otherwise ignored. |
vinNumber
|
string | No | VIN number of the vehicle. Required when no vehicle ID is provided; otherwise ignored. |
vehicleType
|
integer | No | Vehicle type identifier. Required when no vehicle ID is provided; otherwise ignored. |
trailer
|
object | No | Trailer vehicle for the booking. Provide a known vehicle ID from the vehicle API or supply a licensePlate directly. |
vehicleId
|
integer | No | Vehicle ID known at TRAVIS. When provided, other vehicle parameters are ignored. |
licensePlate
|
string | No | License plate of the vehicle. Required when no vehicle ID is provided; otherwise ignored. |
vinNumber
|
string | No | VIN number of the vehicle. Required when no vehicle ID is provided; otherwise ignored. |
vehicleType
|
integer | No | Vehicle type identifier. Required when no vehicle ID is provided; otherwise ignored. |
payment
|
object | No | Payment details for the booking, including invoice customer and optional fuel card. |
recipient
|
object | No | Specifies how the driver receives booking instructions. Possible values: email (sent to the given address), sms (sent to the given phone number), driver_app (pushed to driver app), manual (caller is responsible for delivery). |
type
|
string | Yes | Delivery method for booking instructions: email, sms, manual, or driver_app. |
language
|
string | No | Language code for the instructions delivered to the driver. |
phoneNumber
|
string | No | Phone number for SMS delivery. Required when type is sms. |
email
|
string | No | Email address for email delivery. Required when type is email. |
assignedDriver
|
string (iri-reference) | No | Assigned driver when type is driver_app; must have an active contract with the same customer. |
driverName
|
string | No | Name of the driver associated with the booking. |
Example
Response body
Response 201
BookingTruckWash resource created
Fields
| Field | Type | Description |
|---|---|---|
arrival
|
string (date-time) | Expected arrival date for the truck wash booking. |
washProgram
|
object | Wash program selection for the booking. Provide either washProgramId or cleaningType. |
washProgramId
|
integer | Unique identifier of the wash program. When provided, other wash program parameters are ignored. |
cleaningType
|
string | Cleaning type for the truck wash. Used when no wash program ID is provided. |
isDisinfection
|
boolean | Indicates whether disinfection is included in the wash program. |
isNao
|
boolean | Indicates whether NAO treatment is included in the wash program. |
isSelfService
|
boolean | Indicates whether the booking uses a self-service wash lane. |
driverInstructions
|
object | Driver instructions for the truck wash booking, keyed by language code. |
allowedToUpdate
|
array | List of fields that are allowed to be updated on this booking. |
id
|
integer | Unique identifier of the booking. |
travisCode
|
string | The Travis code uniquely identifying the booking. |
status
|
string | |
location
|
integer | Location ID for the location you want to place the booking. |
reference
|
string | Customer reference attached to the transaction for easy identification. Maximum 50 characters. |
truck
|
object | Truck vehicle for the booking. Provide a known vehicle ID from the vehicle API or supply a licensePlate directly. |
vehicleId
|
integer | Vehicle ID known at TRAVIS. When provided, other vehicle parameters are ignored. |
licensePlate
|
string | License plate of the vehicle. Required when no vehicle ID is provided; otherwise ignored. |
vinNumber
|
string | VIN number of the vehicle. Required when no vehicle ID is provided; otherwise ignored. |
vehicleType
|
integer | Vehicle type identifier. Required when no vehicle ID is provided; otherwise ignored. |
fleetNumber
|
string | Fleet number the vehicle belongs to. |
vehicleDepotName
|
string | Name of the vehicle depot the vehicle belongs to. |
trailer
|
object | Trailer vehicle for the booking. Provide a known vehicle ID from the vehicle API or supply a licensePlate directly. |
vehicleId
|
integer | Vehicle ID known at TRAVIS. When provided, other vehicle parameters are ignored. |
licensePlate
|
string | License plate of the vehicle. Required when no vehicle ID is provided; otherwise ignored. |
vinNumber
|
string | VIN number of the vehicle. Required when no vehicle ID is provided; otherwise ignored. |
vehicleType
|
integer | Vehicle type identifier. Required when no vehicle ID is provided; otherwise ignored. |
fleetNumber
|
string | Fleet number the vehicle belongs to. |
vehicleDepotName
|
string | Name of the vehicle depot the vehicle belongs to. |
payment
|
object | Payment details for the booking, including invoice customer and optional fuel card. |
recipient
|
object | Specifies how the driver receives booking instructions. Possible values: email (sent to the given address), sms (sent to the given phone number), driver_app (pushed to driver app), manual (caller is responsible for delivery). |
type
|
string | Delivery method for booking instructions: email, sms, manual, or driver_app. |
language
|
string | Language code for the instructions delivered to the driver. |
phoneNumber
|
string | Phone number for SMS delivery. Required when type is sms. |
email
|
string | Email address for email delivery. Required when type is email. |
assignedDriver
|
string (iri-reference) | Assigned driver when type is driver_app; must have an active contract with the same customer. |
createdBy
|
string | Identifier of the user or system that created the booking. |
createdAt
|
string (date-time) | Date and time when the booking was created. |
updatedAt
|
string (date-time) | Date and time when the booking was last updated. |
cancelled
|
object | When the booking was cancelled and by which party. Null if it was not. |
at
|
string (date-time) | Date and time of the transition. Null for bookings cancelled before this was recorded; the actor may still be known. |
by
|
object | The party behind the transition, or null when none was recorded. |
type
|
string | Which party acted: customer for the fleet's own user, location for the workshop or parking site, travis for Travis itself. |
name
|
string | Full name of the customer user who acted. Null for location and travis, which are reported as a party rather than as a person. |
declined
|
object | When the booking was declined and by which party. Null if it was not. |
at
|
string (date-time) | Date and time of the transition. Null for bookings cancelled before this was recorded; the actor may still be known. |
by
|
object | The party behind the transition, or null when none was recorded. |
type
|
string | Which party acted: customer for the fleet's own user, location for the workshop or parking site, travis for Travis itself. |
name
|
string | Full name of the customer user who acted. Null for location and travis, which are reported as a party rather than as a person. |
price
|
object | Price of the booking including amount and currency. |
price
|
integer | Price amount in minor currency units (e.g. cents). |
currency
|
string | ISO 4217 currency code. |
driverName
|
string | Name of the driver associated with the booking. |
isDeletable
|
boolean | Indicates whether the booking can be deleted (cancelled). |
qrUrl
|
string | URL to the QR code for the booking. |
shareUrl
|
string | URL that can be shared with the driver to access booking instructions. |
service
|
string | Service type of the booking. Possible values: truckwash, parking, tankcleaning, repair, truckcharging. |
attachments
|
array | List of file attachments associated with the booking. |
locationInformation
|
object | Detailed address and coordinate information for the booking location. |
id
|
integer | Unique identifier of the location. |
name
|
string | Name of the location. |
address
|
string | Street address of the location. |
houseNumber
|
string | House number of the location address. |
zipCode
|
string | Postal/zip code of the location. |
city
|
string | City where the location is situated. |
latitude
|
number | Latitude coordinate of the location. |
longitude
|
number | Longitude coordinate of the location. |
Example
Response 400
Invalid input
Fields
| Field | Type | Description |
|---|---|---|
title
|
string | A short, human-readable summary of the problem. |
detail
|
string | A human-readable explanation specific to this occurrence of the problem. |
status
|
integer | The HTTP status code applicable to this problem. |
instance
|
string | A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced. |
type
|
string | A URI reference that identifies the problem type |
Example
Response 401
No response body - No bearer token set verify if your token is added as bearer tokenResponse 403
No response body - You don't have access to this API resourceResponse 422
An error occurred
Fields
| Field | Type | Description |
|---|---|---|
status
|
integer | The HTTP status code (422). |
violations
|
array | A list of constraint violations that caused the error. |
detail
|
string | A human-readable description of the validation errors. |
type
|
string | A URI reference identifying the validation error type. |
title
|
string | A short summary of the error. |
instance
|
string | A URI reference identifying the specific occurrence of the error. |
Example