Event Documentation

DRAFT Events (Version 2)

Summary

Events encapsulate something that happens at a particular time for a given subject (eventable) such as a move, journey or person.

To create them, they are POSTed to the Book a Secure Move API.

Events fall into one of 4 business categories:

• MI (Management Intelligence)
• CDI (Contract Delivery Indicator) - subset of MI (includes financial penalties and target levels)
• Payment
• Incident

Events must indicate their subject (Eventable), which falls into one of the following categories

• Move
• Journey
• PersonEscortRecord
• Person
• Profile

Journey Events

Type	Short Description	On V1?	Result
JourneyAdmitThroughOuterGate	Admitted through outer gate of a Designated location	N
JourneyArriveAtOuterGate	Arrival outside the outer gate of a Designated location	N
JourneyCancel	Journey cancel	Y	Changes journey state from in_progress to cancelled
JourneyChangeVehicle	Change of vehicle mid journey	N	Changes the journey vehicle in the middle of a journey. Typically during a breakdown
JourneyComplete	Journey complete	Y	Changes the journey state from in_progress to completed
JourneyExitThroughOuterGate	Exit through the outer gate of the Designated location	N
JourneyHandoverToDestination	Handover to establishment	N
JourneyLockout DEPRECATED	Lockout (deprecated, use MoveLockout)	Y
JourneyLodging DEPRECATED	Lodging (deprecated, use MoveLodgingStart and MoveLodgingEnd)	Y
JourneyPersonBoardVehicle	Person boards escort vehicle	N
JourneyPersonLeaveVehicle	Person leaves escort vehicle	N
JourneyReadyToExit	Escort vehicle loaded and ready to exit from the Designated location	N
JourneyReject	Journey reject	Y	Changes journey state from proposed to rejected
JourneyStart	Journey start	Y	Changes the proposed journey state to in_progress
JourneyUncancel	Journey uncancel	Y	Changes journey state from cancelled to in_progress
JourneyUncomplete	Journey uncomplete	Y	Changes the journey state from completed to in progress

Move Events

Type	Short Description	On V1?	Result	Details
MoveAccept	Supplier accepts the move	Y	Changes move status from requested to booked
MoveApprove	PMU approves a single prison-to-prison transfer move proposed by the OCA	Y	Changes move status to requested and updates with the provided move date
MoveCancel	Cancel an unwanted move	Y	Changes move status to cancelled
MoveCollectionByEscort	Collected by escort crew	N
MoveComplete	Supplier indicates that the custody of person has been handed over at desginated location	Y	Changes move status to completed
MoveLockout	Supplier unable to handover person at required desginated location resulting in a lockout (temporarily relocating)	Y
MoveLodgingEnd	DateTime a person was collected by supplier from lodging	N
MoveLodgingStart	DateTime person was handed over to temporary lodging location	N
MoveNotifyPremisesOfArrivalIn30Mins	30 mins to destination	N
MoveNotifyPremisesOfEta	Expected arrival time	N
MoveNotifyPremisesOfExpectedCollectionTime	Notified Of Expected Collection Time	N
MoveNotifySupplierOfMoveRequest	Supplier notified of move request	N
MoveOperationHMCTS	Formal arrangement for the utilisation of HMCTS Courthouse cells ("HMCTS Court Cells") to accommodate Prisoners overnight	N
MoveOperationSafeguard	The procedure the Authority has in place to manage the detention of Prisoners when prison operational capacity is reached.	N
MoveOperationTornado	The procedure the Authority has in place to decant detained Prisoners where prisons suddenly need to be vacated	N
MoveRedirect	Person is being redirected to another designated location	Y	Changes move destination (to_location). It does not alter the journeys associated with the move: additional API calls will be necessary to reject, complete or cancel existing journeys and create new journeys
MoveReject	PMU reject a single prison-to-prison transfer proposed by OCA	Y	Changes move status to cancelled, the move cancellation reason to rejected and update with the provided rejection reason
MoveStart	DateTime when the Move started	Y	Changes move status from booked to in_transit	A move should only be started when the Escort Vehicle is loaded and ready for exit from the Designated Location

Person Escort Record Events

Type	Short Description
PerCourtAllDocumentationProvidedToSupplier	All necessary documentation provided to supplier
PerCourtAssignCellInCustody	Assign cell in court custody
PerCourtCellShareRiskAssessment	Cell share risk assement at Court
PerCourtExcessiveDelayNotDueToSupplier	Excessive delay caused by party other than Supplier
PerCourtHearing	Court Hearing
PerCourtPreReleaseChecksCompleted	Pre-release checks
PerCourtReadyInCustody	Person ready and available within court custody area
PerCourtReleaseOnBail	Released on bail
PerCourtRelease	Released
PerCourtReturnToCustodyAreaFromDock	Person returned to court custody area from court dock
PerCourtReturnToCustodyAreaFromVisitorArea	Person returned to court custody area from visitor area
PerCourtTakeFromCustodyToDock	Person taken from court custody to court dock
PerCourtTakeToSeeVisitors	Person taken to see visitors at court
PerCourtTask	Miscellaneous Court Task
PerGeneric	Generic PER event
PerMedicalAid	Medical aid
PerPrisonerWelfare	Prisoner Welfare

Incident events

Type	Short Description
PersonMoveAssault	Assault
PersonMoveDeathInCustody	Death in Custody
PersonMoveMajorIncidentOther	Other Major Incidents
PersonMoveMinorIncidentOther	Other Minor Incidents
PersonMovePersonEscapedKpi	KPI Escape
PersonMovePersonEscaped	Non KPI Escape
PersonMoveReleasedError	Released in error
PersonMoveRoadTrafficAccident	Road traffic accident
PersonMoveSeriousInjury	Serious Injury
PersonMoveUsedForce	Use of Force
PersonMoveVehicleBrokeDown	Vehicle breakdown
PersonMoveVehicleSystemsFailed	Failure of vehicle systems