startOnSiteJobsAppointmentBookingSession
Start the appointment booking process.
Arguments
The appointment booking details.
Whether to override appointment booking check warnings. Defaults to False.
Whether to override request creation check warnings. Defaults to False.
The request booking details.
Possible Errors
- KT-CT-1113: Disabled GraphQL field requested.
- KT-CT-13002: Supply point not found.
- KT-CT-13003: Supply points must belong to the same account.
- KT-CT-13004: No account found for the given supply points.
- KT-CT-13006: No properties found for the given supply points.
- KT-CT-13007: At least one of the request checks failed.
- KT-CT-13008: At least one of the request checks has warnings.
- KT-CT-13010: No booking adapter found for agent.
- KT-CT-13012: Viewer is not allowed to create a request.
- KT-CT-13013: Reporter post init error.
- KT-CT-13014: Request reason is not supported.
- KT-CT-13015: Request sub_reason is not supported.
- KT-CT-13020: Could not identify agent from property.
- KT-CT-13021: Invalid job type.
- KT-CT-13022: Work category not found for job type.
- KT-CT-13023: Appointment booking checks failed.
- KT-CT-13024: Appointment booking checks returned warnings.
- KT-CT-13047: Multiple supply points found.
- KT-CT-13048: Cannot provide both supply_point_identifier_to_market_name_mapping and supply_point_internal_ids.
- KT-CT-13049: Neither supply_point_identifier_to_market_name_mapping nor supply_point_internal_ids provided.
- KT-CT-13063: Failed to derive property for the given supply points.
- KT-CT-13064: Provided supply point(s) not supported by the On-Site Jobs market manager.
- KT-CT-13073: Job type not available for self-serve booking.
- KT-CT-13074: Cannot start appointment booking session for a request that requires approval.
- KT-CT-13075: Viewer is not allowed to create an appointment.
- KT-CT-7899: An internal error occurred.
Allowed Viewers
Required Permissions
Can create on site jobs appointments Can create on site jobs requestsQuery Complexity
1Examples
The example data in the variables and responses below are autogenerated values designed to resemble real inputs. They do not represent actual customer data, and in some cases may require additional validation.
mutation StartOnSiteJobsAppointmentBookingSession(
$appointmentBookingDetails: OnSiteJobsAppointmentBookingDetailsInput!,
$overrideAppointmentCheckWarnings: Boolean,
$overrideRequestCheckWarnings: Boolean,
$requestBookingDetails: OnSiteJobsRequestBookingDetailsInput!
) {
startOnSiteJobsAppointmentBookingSession(
appointmentBookingDetails: $appointmentBookingDetails,
overrideAppointmentCheckWarnings: $overrideAppointmentCheckWarnings,
overrideRequestCheckWarnings: $overrideRequestCheckWarnings,
requestBookingDetails: $requestBookingDetails
) {
appointmentBookingSessionId
}
}
Variables
{
"appointmentBookingDetails": OnSiteJobsAppointmentBookingDetailsInput,
"overrideAppointmentCheckWarnings": true,
"overrideRequestCheckWarnings": true,
"requestBookingDetails": OnSiteJobsRequestBookingDetailsInput
}
Response
{
"data": {
"startOnSiteJobsAppointmentBookingSession": {
"appointmentBookingSessionId": "a55361fd-a88d-4a76-bdc1-599c101c417f"
}
}
}