In order to reserve an appointment, the buyer should provide the UPRN, product and the appointment slot that they desire to the seller
The meta-data of the request. It includes information regarding the message UUID, transaction ID and the sent timestamp
Represents the appointment slot details. Simple orders always carry the single-day appointmentDate, appointmentStartTime and appointmentEndTime. Complex installation orders (orderSurvey/orderExternal/orderInternal) additionally carry cfh:startDateTime/cfh:endDateTime; for these the single-day triple is present only when the slot starts and ends on the same day and is omitted for multi-day slots (possible for orderExternal).
Identifies the type of appointment being queried, reserved or amended. Complex installation orders progress through the survey, build-to-wall and standard-install appointment types in turn.
Indicates whether the appointment is reappointing a previous appointment
- Mock serverhttps://ala-api.docs.cityfibre.com/_mock/openapi/reserveAppointment
- Main (production) serverhttps://api-gw.cityfibre.com:41223/prod/api2/reserveAppointment
- CFStaging serverhttps://api-gw.cityfibre.com:41223/cfstaging/api2/reserveAppointment
- CFSit serverhttps://api-gw.cityfibre.com:41223/cfsit/api2/reserveAppointment
- Order
- Fault
- Order Survey
- Order External
- Order Internal
- Reserve Appointment Example
- Reserve Appointment with Project Reference Example
- Reserve a Complex Order Survey Appointment
- Reserve a multi-day Build to Wall (orderExternal) appointment
<reserveAppointmentRequest xmlns="http://www.niccstandards.org.uk/ala_1.0.xsd" xmlns:cfh="http://www.cityfibre.com/ala/ext1">
<message>
<messageId>b68b2cf4-475e-11e1-a92e-fb2ff6467c99</messageId>
<correlationId>bac72cfa-475e-11e1-a92e-fb2ff6467c99</correlationId>
<sentAt>2012-01-20T18:30:43Z</sentAt>
</message>
<buyer>
<buyerIdentifier>SPDEV1</buyerIdentifier>
</buyer>
<seller>
<sellerIdentifier>CITYFIBRE</sellerIdentifier>
</seller>
<appointmentSlot>
<appointmentDate>2012-01-20</appointmentDate>
<appointmentStartTime>08:00</appointmentStartTime>
<appointmentEndTime>13:00</appointmentEndTime>
</appointmentSlot>
<appointmentType>
<order/>
</appointmentType>
<cfh:productName>ftthl2r</cfh:productName>
<cfh:addressKey>123456789012</cfh:addressKey>
<cfh:ispMigration>false</cfh:ispMigration>
<cfh:reappointment>false</cfh:reappointment>
</reserveAppointmentRequest>Reserve Appointment Response
The meta-data of the request. It includes information regarding the message UUID, transaction ID and the sent timestamp
- ReserveAppointmentAccepted
- ReserveAppointmentRejected
- Appointment reserved successfully
- Complex installation (orderExternal) multi-day appointment reserved
- Appointment reserved unsuccessfully
- Validation Error (Invalid Project Reference Example)
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<reserveAppointmentResponse xmlns="http://www.niccstandards.org.uk/ala_1.0.xsd" xmlns:cfh="http://www.cityfibre.com/ala/ext1">
<message>
<messageId>c6d0b303-625a-4ee3-ab53-5e616d728755</messageId>
<correlationId>bac72cfa-475e-11e1-a92e-fb2ff6467c99</correlationId>
<sentAt>2022-05-20T09:58:23.439Z</sentAt>
</message>
<buyer>
<buyerIdentifier>SPDEV1</buyerIdentifier>
</buyer>
<seller>
<sellerIdentifier>CITYFIBRE</sellerIdentifier>
</seller>
<reserveAppointmentAccepted>
<appointment>
<appointmentDate>2022-05-24</appointmentDate>
<appointmentStartTime>08:00</appointmentStartTime>
<appointmentEndTime>13:00</appointmentEndTime>
<appointmentReservationKey>EI7PBRU6TL8KN1YNGO8ICEUI0UDFE9M8</appointmentReservationKey>
<appointmentReservationValidUntil>2022-05-20T21:58:26…