Manage Appointment API
Errors
The Manage Appointment API returns the following error codes and messages.
| API error code | Http status code | API endpoint | Http status message | Description |
|---|---|---|---|---|
| 401-86 | 401 | All | Unauthorized | Indicates that authentication credentials haven't been provided in the request header or the credentials provided are incorrect. Check if the correct authentication credentials are in the header and try again. |
| 429-89 | 429 | All | Too many requests | Occurs when a request is blocked due to rate limit restrictions. Learn more about API rate limits. |
| FCA-400-16 | 400 | /siteVisitAppointment/siteVisitAppointmentAvailability | Bad request | Occurs when the requested date and time combination is not in the correct format. Check the appointment date and time and try again. |
| FCA-400-20 | 400 | /siteVisitAppointment | Bad request | Occurs when you haven’t accepted the charge that's associated with the reschedule. To continue, accept the charge and resubmit the reschedule request. |
| FCA-400-29 | 400 | /siteVisitAppointment/rfsAppointment | Bad request | Occurs when the current order state does not allow scheduling. Check the order state or wait for the state to change and try again. |
| FCA-400-30 | 400 | All | Bad request | Your request couldn’t be performed because the Order ID provided belongs to another customer. Check the Order ID is correct and try again. |
| FCA-400-31 | 400 | /siteVisitAppointment | Bad request | Occurs when the site visit appointment you’re requesting to update has already been completed. Check order notifications for the latest update and order status. |
| FCA-400-35 | 400 | /siteVisitAppointment | Bad request | Occurs when the site visit appointment date and time you’ve requested isn’t available anymore. To continue, retrieve available appointments and then choose an appointment to reserve. |
| FCA-400-36 | 400 | /siteVisitAppointment | Bad request | Occurs when a site visit appointment can’t be brought forward, as it’s been booked by a Service Partner due to an exception with the order. Check order notifications for the latest update and exception details. |
| FCA-400-38 | 400 | /siteVisitAppointment | Bad request | Occurs when the site visit for the order isn’t bookable. If you continue to receive this error, contact your Chorus representative to assist. |
| FCA-400-42 | 400 | /rfsAppointment | Bad request | Occurs when the rfsAppointmentType doesn’t match the order type. Check you’ve supplied the correct rfsAppointmentType of either Connect or Disconnect that corresponds to the order and try again. |
| FCA-400-43 | 400 | /rfsAppointment | Bad request | Occurs when the appointment details don’t match the type of appointments on the order. For an order: - with a site visit, you can’t use an RFS appointment - without a site visit, you can’t use a Site Visit ID. |
| FCA-400-45 | 400 | All | Bad request | Occurs when the Order ID isn’t from a valid Product Family Type: Bitstream or PONFAS Distribution. Check you’ve supplied a supported Order ID and try again. |
| FCA-400-85 | 400 | All | Bad request | Occurs when there is an issue with the syntax, message or header of a request. Check the syntax and formatting of the request and ensure that all required parameters are included. |
| FCA-400-70 | 400 | All | Bad request | Occurs when your amendment request couldn’t be performed. For more information, see the Bad Request response for the details and explanation. If you're still unsure, contact your Chorus representative. |
| FCA-401-84 | 401 | All | Unauthorized | Occurs when an organisation name can't be found for authentication purposes. Check your organisation credentials are correct and try again. If the problem persists, contact your Chorus representative. |
| FCA-404-0 | 404 | All | Not found | Occurs when a resource can't be found. Check if you've supplied the correct resource and try again. |
| FCA-404-15 | 404 | /siteVisitAppointment /siteVisitAppointmentAvailability | Not found | Occurs when a Site Visit ID can’t be found. Check the Site Visit ID and try again. |
| FCA-404-19 | 404 | All | Not found | Occurs when an Order ID can’t be found. Check the Order ID and try again. |
| FCA-405-0 | 405 | All | Method not allowed | Indicates that the requested method isn't supported for the resource. Choose another method and try again. |
| FCA-406-0 | 406 | All | Not acceptable | Occurs when a request doesn’t list acceptable response content types that can be returned. Check you've listed acceptable content types and try again. |
| FCA-415-0 | 415 | All | Unsupported | Indicates that a request doesn’t contain a content type that is recognised. Try again using a recognisable content type. |
| FCA-500-0 | 500 | All | Internal server error | Occurs when a Chorus internal server error has occurred. Try again and if the problem persists, contact your Chorus representative. |
| FCA-500-50 | 500 | All | Not implemented | Occurs when a Chorus internal server error has occurred when requesting an appointment. Try again and if the problem persists, contact your Chorus representative. |
| FCA-501-0 | 501 | All | Not implemented | Indicates that the requested resource hasn't been implemented yet. For more information, contact your Chorus representative. |