createOnSiteJobsAppointmentWithoutDateOrTime
Create an Appointment using WITHOUT_DATE_OR_TIME booking mode. Used when the field agent arranges the appointment date and time externally. Once arranged, the field service system will inform on-site jobs of the date and time.
Arguments
The appointment booking details.
Whether to override appointment booking check warnings. Defaults to False.
The ID of the request to book an appointment for.
Returns
CreateOnSiteJobsAppointmentWithoutDateOrTimeCreate an Appointment using WITHOUT_DATE_OR_TIME booking mode. Used when the field agent arranges the appointment date and time externally. Once arranged, the field service system will inform on-site jobs of the date and time.
Possible Errors
- KT-CT-1113: Disabled GraphQL field requested.
- KT-CT-13010: No booking adapter found for agent.
- KT-CT-13019: Vendor not found.
- 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-13027: Booking system error occurred.
- KT-CT-13028: Agent not found.
- KT-CT-13029: Could not confirm duplicate property.
- KT-CT-13032: Request does not exist.
- KT-CT-13034: Appointment already exists for this request.
- KT-CT-13035: Request is inactive.
- KT-CT-13036: Booking service currently unavailable.
- KT-CT-13037: Appointment reference not provided by booking service.
- KT-CT-13073: Job type not available for self-serve booking.
- KT-CT-13077: Without-date-or-time booking mode is not applicable for this request.
- KT-CT-7899: An internal error occurred.
Allowed Viewers
Required Permissions
Can create on site jobs appointmentsQuery Complexity
5Examples
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 CreateOnSiteJobsAppointmentWithoutDateOrTime(
$appointmentBookingDetails: OnSiteJobsAppointmentBookingDetailsInput!,
$overrideAppointmentCheckWarnings: Boolean,
$requestId: UUID!
) {
createOnSiteJobsAppointmentWithoutDateOrTime(
appointmentBookingDetails: $appointmentBookingDetails,
overrideAppointmentCheckWarnings: $overrideAppointmentCheckWarnings,
requestId: $requestId
) {
onSiteJobsAppointment {
...OnSiteJobsAppointmentTypeFragment
}
}
}
Variables
{
"appointmentBookingDetails": OnSiteJobsAppointmentBookingDetailsInput,
"overrideAppointmentCheckWarnings": true,
"requestId": "fc315153-08f3-4f18-88db-f8cc7ac5d58c"
}
Response
{
"data": {
"createOnSiteJobsAppointmentWithoutDateOrTime": {
"onSiteJobsAppointment": OnSiteJobsAppointmentType
}
}
}