@planning-inspectorate/data-model 2.56.0 → 2.57.0

package/src/enums.js

@@ -88,6 +88,7 @@ export const APPEAL_CASE_DECISION_OUTCOME = Object.freeze({
   ALLOWED: 'allowed',
   DISMISSED: 'dismissed',
   INVALID: 'invalid',
+  NOTICE_QUASHED: 'notice_quashed',
   NOTICE_UPHELD: 'notice_upheld',
   NOTICE_VARIED_AND_UPHELD: 'notice_varied_and_upheld',
   PLANNING_PERMISSION_GRANTED: 'planning_permission_granted',
@@ -139,6 +140,20 @@ export const APPEAL_CASE_STATUS = Object.freeze({
   WITNESSES: 'witnesses',
 });
 
+export const APPEAL_CASE_SUB_TYPE = Object.freeze({
+  AFFORDABLE_HOUSING: 'affordable_housing',
+  ANTI_POLLUTION_WORKS_NOTICE: 'anti_pollution_works_notice',
+  CONTAMINATED_LAND: 'contaminated_land',
+  ENVIRONMENTAL_LIABILITY: 'environmental_liability',
+  ENVIRONMENTAL_PERMITTING: 'environmental_permitting',
+  HAZARDOUS_SUBSTANCES: 'hazardous_substances',
+  MARINE_LICENSING: 'marine_licensing',
+  SILAGE_AND_SLURRY: 'silage_and_slurry',
+  SSSI: 'sssi',
+  WASTE_CARRIERS: 'waste_carriers',
+  WATER_ABSTRACTION: 'water_abstraction',
+});
+
 export const APPEAL_CASE_TYPE = Object.freeze({
   C: 'C',
   D: 'D',
@@ -190,6 +205,7 @@ export const APPEAL_DISCONTINUANCE_NOTICE_SERVED_REASON = Object.freeze({
 export const APPEAL_DOCUMENT_TYPE = Object.freeze({
   ADDITIONAL_DOCUMENTS_LPA: 'additionalDocumentsLPA',
   APPEAL_NOTIFICATION: 'appealNotification',
+  APPELLANT_CASE: 'appellantCase',
   APPELLANT_CASE_CORRESPONDENCE: 'appellantCaseCorrespondence',
   APPELLANT_CASE_WITHDRAWAL_LETTER: 'appellantCaseWithdrawalLetter',
   APPELLANT_COSTS_APPLICATION: 'appellantCostsApplication',
@@ -256,6 +272,7 @@ export const APPEAL_DOCUMENT_TYPE = Object.freeze({
   LPA_ENFORCEMENT_NOTICE_WITHDRAWAL: 'lpaEnforcementNoticeWithdrawal',
   LPA_FINAL_COMMENT: 'lpaFinalComment',
   LPA_PROOF_OF_EVIDENCE: 'lpaProofOfEvidence',
+  LPA_QUESTIONNAIRE: 'lpaQuestionnaire',
   LPA_STATEMENT: 'lpaStatement',
   LPA_WITNESSES_EVIDENCE: 'lpaWitnessesEvidence',
   MAIN_PARTY_CORRESPONDENCE: 'mainPartyCorrespondence',
@@ -311,6 +328,20 @@ export const APPEAL_EIA_ENVIRONMENTAL_IMPACT_SCHEDULE = Object.freeze({
   SCHEDULE_2: 'schedule-2',
 });
 
+export const APPEAL_ENVIRONMENTAL_PERMIT_SUBTYPES = Object.freeze({
+  CLOSURE_NOTICE: 'closure_notice',
+  CONDITIONS_ATTACHED_TO_A_PERMIT: 'conditions_attached_to_a_permit',
+  DECISION_TO_IMPOSE_CONDITIONS_BY_REGULATOR: 'decision_to_impose_conditions_by_regulator',
+  DEEMED_REFUSAL: 'deemed_refusal',
+  DEEMED_WITHDRAWAL: 'deemed_withdrawal',
+  ENFORCEMENT_NOTICE: 'enforcement_notice',
+  FLOOD_RISK_ACTIVITY: 'flood_risk_activity',
+  PROHIBITION_NOTICE: 'prohibition_notice',
+  REFUSAL_OF_A_PERMIT: 'refusal_of_a_permit',
+  REVOCATION_NOTICE: 'revocation_notice',
+  SUSPENSION_NOTICE: 'suspension_notice',
+});
+
 export const APPEAL_EVENT_STATUS = Object.freeze({
   CHANGE_OF_PROCEDURE: 'change_of_procedure',
   CONFIRMED: 'confirmed',
@@ -428,17 +459,24 @@ export const APPEAL_SOURCE_SYSTEM = Object.freeze({
 
 export const APPEAL_TYPE_OF_PLANNING_APPLICATION = Object.freeze({
   ADVERTISEMENT: 'advertisement',
+  COMMUNITY_INFRASTRUCTURE_LEVY: 'community-infrastructure-levy',
   DISCONTINUANCE_NOTICE: 'discontinuance-notice',
+  ENVIRONMENTAL: 'environmental',
   FULL_APPEAL: 'full-appeal',
+  HEDGEROWS_APPEAL: 'hedgerows-appeal',
+  HIGH_HEDGE_APPEAL: 'high-hedge-appeal',
   HOUSEHOLDER_PLANNING: 'householder-planning',
   LAWFUL_DEVELOPMENT_CERTIFICATE: 'lawful-development-certificate',
   LISTED_BUILDING: 'listed-building',
   MINOR_COMMERCIAL_DEVELOPMENT: 'minor-commercial-development',
   OUTLINE_PLANNING: 'outline-planning',
   PERMISSION_IN_PRINCIPLE: 'permission-in-principle',
+  PLANNING_OBLIGATION: 'planning-obligation',
   PRIOR_APPROVAL: 'prior-approval',
   REMOVAL_OR_VARIATION_OF_CONDITIONS: 'removal-or-variation-of-conditions',
   RESERVED_MATTERS: 'reserved-matters',
+  TREE_PRESERVATION_ORDER: 'tree-preservation-order',
+  TREE_REPLACEMENT_NOTICE: 'tree-replacement-notice',
 });
 
 export const APPEAL_VIRUS_CHECK_STATUS = Object.freeze({

package/src/index.cjs

@@ -171,6 +171,7 @@ const APPEAL_CASE_DECISION_OUTCOME = Object.freeze({
   ALLOWED: 'allowed',
   DISMISSED: 'dismissed',
   INVALID: 'invalid',
+  NOTICE_QUASHED: 'notice_quashed',
   NOTICE_UPHELD: 'notice_upheld',
   NOTICE_VARIED_AND_UPHELD: 'notice_varied_and_upheld',
   PLANNING_PERMISSION_GRANTED: 'planning_permission_granted',
@@ -222,6 +223,20 @@ const APPEAL_CASE_STATUS = Object.freeze({
   WITNESSES: 'witnesses',
 });
 
+const APPEAL_CASE_SUB_TYPE = Object.freeze({
+  AFFORDABLE_HOUSING: 'affordable_housing',
+  ANTI_POLLUTION_WORKS_NOTICE: 'anti_pollution_works_notice',
+  CONTAMINATED_LAND: 'contaminated_land',
+  ENVIRONMENTAL_LIABILITY: 'environmental_liability',
+  ENVIRONMENTAL_PERMITTING: 'environmental_permitting',
+  HAZARDOUS_SUBSTANCES: 'hazardous_substances',
+  MARINE_LICENSING: 'marine_licensing',
+  SILAGE_AND_SLURRY: 'silage_and_slurry',
+  SSSI: 'sssi',
+  WASTE_CARRIERS: 'waste_carriers',
+  WATER_ABSTRACTION: 'water_abstraction',
+});
+
 const APPEAL_CASE_TYPE = Object.freeze({
   C: 'C',
   D: 'D',
@@ -273,6 +288,7 @@ const APPEAL_DISCONTINUANCE_NOTICE_SERVED_REASON = Object.freeze({
 const APPEAL_DOCUMENT_TYPE = Object.freeze({
   ADDITIONAL_DOCUMENTS_LPA: 'additionalDocumentsLPA',
   APPEAL_NOTIFICATION: 'appealNotification',
+  APPELLANT_CASE: 'appellantCase',
   APPELLANT_CASE_CORRESPONDENCE: 'appellantCaseCorrespondence',
   APPELLANT_CASE_WITHDRAWAL_LETTER: 'appellantCaseWithdrawalLetter',
   APPELLANT_COSTS_APPLICATION: 'appellantCostsApplication',
@@ -339,6 +355,7 @@ const APPEAL_DOCUMENT_TYPE = Object.freeze({
   LPA_ENFORCEMENT_NOTICE_WITHDRAWAL: 'lpaEnforcementNoticeWithdrawal',
   LPA_FINAL_COMMENT: 'lpaFinalComment',
   LPA_PROOF_OF_EVIDENCE: 'lpaProofOfEvidence',
+  LPA_QUESTIONNAIRE: 'lpaQuestionnaire',
   LPA_STATEMENT: 'lpaStatement',
   LPA_WITNESSES_EVIDENCE: 'lpaWitnessesEvidence',
   MAIN_PARTY_CORRESPONDENCE: 'mainPartyCorrespondence',
@@ -394,6 +411,20 @@ const APPEAL_EIA_ENVIRONMENTAL_IMPACT_SCHEDULE = Object.freeze({
   SCHEDULE_2: 'schedule-2',
 });
 
+const APPEAL_ENVIRONMENTAL_PERMIT_SUBTYPES = Object.freeze({
+  CLOSURE_NOTICE: 'closure_notice',
+  CONDITIONS_ATTACHED_TO_A_PERMIT: 'conditions_attached_to_a_permit',
+  DECISION_TO_IMPOSE_CONDITIONS_BY_REGULATOR: 'decision_to_impose_conditions_by_regulator',
+  DEEMED_REFUSAL: 'deemed_refusal',
+  DEEMED_WITHDRAWAL: 'deemed_withdrawal',
+  ENFORCEMENT_NOTICE: 'enforcement_notice',
+  FLOOD_RISK_ACTIVITY: 'flood_risk_activity',
+  PROHIBITION_NOTICE: 'prohibition_notice',
+  REFUSAL_OF_A_PERMIT: 'refusal_of_a_permit',
+  REVOCATION_NOTICE: 'revocation_notice',
+  SUSPENSION_NOTICE: 'suspension_notice',
+});
+
 const APPEAL_EVENT_STATUS = Object.freeze({
   CHANGE_OF_PROCEDURE: 'change_of_procedure',
   CONFIRMED: 'confirmed',
@@ -511,17 +542,24 @@ const APPEAL_SOURCE_SYSTEM = Object.freeze({
 
 const APPEAL_TYPE_OF_PLANNING_APPLICATION = Object.freeze({
   ADVERTISEMENT: 'advertisement',
+  COMMUNITY_INFRASTRUCTURE_LEVY: 'community-infrastructure-levy',
   DISCONTINUANCE_NOTICE: 'discontinuance-notice',
+  ENVIRONMENTAL: 'environmental',
   FULL_APPEAL: 'full-appeal',
+  HEDGEROWS_APPEAL: 'hedgerows-appeal',
+  HIGH_HEDGE_APPEAL: 'high-hedge-appeal',
   HOUSEHOLDER_PLANNING: 'householder-planning',
   LAWFUL_DEVELOPMENT_CERTIFICATE: 'lawful-development-certificate',
   LISTED_BUILDING: 'listed-building',
   MINOR_COMMERCIAL_DEVELOPMENT: 'minor-commercial-development',
   OUTLINE_PLANNING: 'outline-planning',
   PERMISSION_IN_PRINCIPLE: 'permission-in-principle',
+  PLANNING_OBLIGATION: 'planning-obligation',
   PRIOR_APPROVAL: 'prior-approval',
   REMOVAL_OR_VARIATION_OF_CONDITIONS: 'removal-or-variation-of-conditions',
   RESERVED_MATTERS: 'reserved-matters',
+  TREE_PRESERVATION_ORDER: 'tree-preservation-order',
+  TREE_REPLACEMENT_NOTICE: 'tree-replacement-notice',
 });
 
 const APPEAL_VIRUS_CHECK_STATUS = Object.freeze({
@@ -1100,6 +1138,7 @@ exports.APPEAL_CASE_DECISION_OUTCOME = APPEAL_CASE_DECISION_OUTCOME;
 exports.APPEAL_CASE_PROCEDURE = APPEAL_CASE_PROCEDURE;
 exports.APPEAL_CASE_STAGE = APPEAL_CASE_STAGE;
 exports.APPEAL_CASE_STATUS = APPEAL_CASE_STATUS;
+exports.APPEAL_CASE_SUB_TYPE = APPEAL_CASE_SUB_TYPE;
 exports.APPEAL_CASE_TYPE = APPEAL_CASE_TYPE;
 exports.APPEAL_CASE_VALIDATION_OUTCOME = APPEAL_CASE_VALIDATION_OUTCOME;
 exports.APPEAL_DEVELOPMENT_TYPE = APPEAL_DEVELOPMENT_TYPE;
@@ -1107,6 +1146,7 @@ exports.APPEAL_DISCONTINUANCE_NOTICE_SERVED_REASON = APPEAL_DISCONTINUANCE_NOTIC
 exports.APPEAL_DOCUMENT_TYPE = APPEAL_DOCUMENT_TYPE;
 exports.APPEAL_EIA_DEVELOPMENT_DESCRIPTION = APPEAL_EIA_DEVELOPMENT_DESCRIPTION;
 exports.APPEAL_EIA_ENVIRONMENTAL_IMPACT_SCHEDULE = APPEAL_EIA_ENVIRONMENTAL_IMPACT_SCHEDULE;
+exports.APPEAL_ENVIRONMENTAL_PERMIT_SUBTYPES = APPEAL_ENVIRONMENTAL_PERMIT_SUBTYPES;
 exports.APPEAL_EVENT_STATUS = APPEAL_EVENT_STATUS;
 exports.APPEAL_EVENT_TYPE = APPEAL_EVENT_TYPE;
 exports.APPEAL_HAS_CASE_DECISION_OUTCOME = APPEAL_HAS_CASE_DECISION_OUTCOME;

package/src/schemas.d.ts

@@ -137,6 +137,7 @@ export interface AppealDocument {
    * The type of document, used for exchange, migrations and consumption from the appeal back-office system
    */
   documentType:
+    | 'appellantCase'
     | 'appellantCaseCorrespondence'
     | 'appellantCaseWithdrawalLetter'
     | 'appellantCostsApplication'
@@ -151,6 +152,7 @@ export interface AppealDocument {
     | 'whoNotifiedLetterToNeighbours'
     | 'whoNotifiedPressAdvert'
     | 'conservationMap'
+    | 'lpaQuestionnaire'
     | 'lpaCaseCorrespondence'
     | 'lpaCostsApplication'
     | 'lpaCostsCorrespondence'
@@ -394,6 +396,278 @@ export interface AppealEvent {
   [k: string]: unknown;
 }
 
+/**
+ * Group C - Schema defining the metadata for generic and low-volume appeals
+ */
+export interface AppealGroupCCase {
+  /**
+   * Internal case identifier
+   */
+  caseId: number | null;
+  /**
+   * External case identifier for Group C appeals (7 digit number starting in 6)
+   */
+  caseReference: string;
+  /**
+   * The internal letter code for an appeal type, e.g. W (Environmental)
+   */
+  caseType: 'C' | 'D' | 'F' | 'G' | 'H' | 'L' | 'Q' | 'S' | 'V' | 'W' | 'X' | 'Y' | 'Z' | 'ZA' | 'ZP';
+  /**
+   * The processing status for the appeal
+   */
+  caseStatus:
+    | 'assign_case_officer'
+    | 'validation'
+    | 'ready_to_start'
+    | 'lpa_questionnaire'
+    | 'issue_determination'
+    | 'statements'
+    | 'evidence'
+    | 'witnesses'
+    | 'final_comments'
+    | 'complete'
+    | 'invalid'
+    | 'closed'
+    | 'withdrawn'
+    | 'awaiting_transfer'
+    | 'transferred'
+    | 'event'
+    | 'awaiting_event'
+    | 'notice_withdrawn'
+    | 'closed_opened_in_error';
+  /**
+   * The type of procedure for the appeal
+   */
+  caseProcedure: 'written' | 'hearing' | 'inquiry' | 'writtenPart1' | 'writtenPart2' | null;
+  /**
+   * The date the appeal was received
+   */
+  caseCreatedDate: string;
+  /**
+   * The date the appeal was submitted by the appellant
+   */
+  caseSubmittedDate: string | null;
+  /**
+   * The date the appeal was last updated in the back-office
+   */
+  caseUpdatedDate: string | null;
+  /**
+   * The date since when the appeal was considered valid
+   */
+  caseValidDate: string | null;
+  /**
+   * The date the appeal was validated in the back-office
+   */
+  caseValidationDate: string | null;
+  /**
+   * The outcome of the validation action
+   */
+  caseValidationOutcome: 'valid' | 'invalid' | 'incomplete' | null;
+  /**
+   * A date indicating when the case was started, resulting in the creation of a timetable
+   */
+  caseStartedDate: string | null;
+  /**
+   * A date indicating when the case was published
+   */
+  casePublishedDate: string | null;
+  /**
+   * The date the LPA response was received
+   */
+  lpaQuestionnaireCreatedDate: string | null;
+  /**
+   * The date the LPA provided a response to the case
+   */
+  lpaQuestionnaireSubmittedDate: string | null;
+  /**
+   * The outcome of the LPA questionnaire validation action
+   */
+  lpaQuestionnaireValidationOutcome: 'complete' | 'incomplete' | null;
+  /**
+   * If the case is started and has a timetable, a deadline for the LPA to provide a response
+   */
+  lpaQuestionnaireDueDate: string | null;
+  /**
+   * The date of the appeal decision
+   */
+  caseDecisionOutcomeDate: string | null;
+  /**
+   * The final outcome for the decision
+   */
+  caseDecisionOutcome:
+    | 'allowed'
+    | 'split_decision'
+    | 'dismissed'
+    | 'invalid'
+    | 'notice_upheld'
+    | 'planning_permission_granted'
+    | 'quashed_on_legal_grounds'
+    | 'notice_varied_and_upheld'
+    | 'notice_quashed'
+    | null;
+  /**
+   * The date the appeal decision letter was issued
+   */
+  caseCompletedDate: string | null;
+  /**
+   * A unique identifier for the Local Planning Authority
+   */
+  lpaCode: string | null;
+  /**
+   * Unique identifier for the case officer assigned to the case
+   */
+  caseOfficerId: string | null;
+  /**
+   * Unique identifier for the inspector assigned to the case
+   */
+  inspectorId: string | null;
+  /**
+   * padsSapId for PADS inspectors
+   */
+  padsSapId: string | null;
+  /**
+   * A level used for allocation purposes
+   */
+  allocationLevel: 'A' | 'B' | 'C' | 'D' | 'E' | 'F' | 'G' | 'H' | null;
+  /**
+   * A band used for allocation purposes
+   */
+  allocationBand: 1 | 2 | 3 | null;
+  /**
+   * A list of specialisms for allocation purposes
+   */
+  caseSpecialisms: string[] | null;
+  /**
+   * First line of address for the appeal site
+   */
+  siteAddressLine1: string | null;
+  /**
+   * Second line of address for the appeal site
+   */
+  siteAddressLine2: string | null;
+  /**
+   * Town / City of the site address
+   */
+  siteAddressTown: string | null;
+  /**
+   * County of the site address
+   */
+  siteAddressCounty: string | null;
+  /**
+   * Postal code of the site address
+   */
+  siteAddressPostcode: string | null;
+  /**
+   * The date of the Case Management Conference (CMC)
+   */
+  caseManagementConferenceDate?: string | null;
+  /**
+   * Deadline for statements
+   */
+  statementDueDate?: string | null;
+  /**
+   * Deadline for proofs of evidence
+   */
+  proofsOfEvidenceDueDate?: string | null;
+  /**
+   * Deadline for final comments
+   */
+  finalCommentsDueDate?: string | null;
+  /**
+   * Deadline for interested party representations
+   */
+  interestedPartyRepsDueDate?: string | null;
+  /**
+   * Deadline for statement of common ground
+   */
+  statementOfCommonGroundDueDate?: string | null;
+  /**
+   * Deadline for planning obligation
+   */
+  planningObligationDueDate?: string | null;
+  /**
+   * The type of application or notice that is the subject of the appeal
+   */
+  typeOfPlanningApplication?:
+    | 'full-appeal'
+    | 'householder-planning'
+    | 'outline-planning'
+    | 'prior-approval'
+    | 'reserved-matters'
+    | 'removal-or-variation-of-conditions'
+    | 'listed-building'
+    | 'minor-commercial-development'
+    | 'advertisement'
+    | 'lawful-development-certificate'
+    | 'discontinuance-notice'
+    | 'permission-in-principle'
+    | 'tree-preservation-order'
+    | 'tree-replacement-notice'
+    | 'high-hedge-appeal'
+    | 'hedgerows-appeal'
+    | 'community-infrastructure-levy'
+    | 'planning-obligation'
+    | 'environmental'
+    | null;
+  /**
+   * Sub-type categorization for generic/low-volume appeals
+   */
+  caseSubType?:
+    | 'anti_pollution_works_notice'
+    | 'contaminated_land'
+    | 'marine_licensing'
+    | 'waste_carriers'
+    | 'water_abstraction'
+    | 'environmental_liability'
+    | 'environmental_permitting'
+    | 'hazardous_substances'
+    | 'silage_and_slurry'
+    | 'sssi'
+    | 'affordable_housing'
+    | null;
+  /**
+   * The date the appeal was withdrawn by the appellant
+   */
+  caseWithdrawnDate: string | null;
+  /**
+   * The date the appeal was transferred to a new case of a different type
+   */
+  caseTransferredDate: string | null;
+  /**
+   * The reference number of the enforcement notice
+   */
+  enforcementNoticeReference?: string | null;
+  /**
+   * The unique identifier of the LPA or regulator application
+   */
+  applicationReference?: string | null;
+  /**
+   * Indicates if the case is linked, and the type of relationship
+   */
+  linkedCaseStatus?: 'lead' | 'child' | null;
+  /**
+   * The reference of the lead case, if the case is a child case
+   */
+  leadCaseReference?: string | null;
+  /**
+   * Case sub-division applying to Environmental Permitting caseSubType
+   */
+  environmentalPermitSubtypes?:
+    | 'refusal_of_a_permit'
+    | 'deemed_refusal'
+    | 'conditions_attached_to_a_permit'
+    | 'decision_to_impose_conditions_by_regulator'
+    | 'deemed_withdrawal'
+    | 'enforcement_notice'
+    | 'suspension_notice'
+    | 'closure_notice'
+    | 'flood_risk_activity'
+    | 'revocation_notice'
+    | 'prohibition_notice'
+    | null;
+  [k: string]: unknown;
+}
+
 /**
  * Group A - Schema defining the metadata for an appeal
  */
@@ -1211,6 +1485,7 @@ export type AppealS78Case = (GridReference | SiteAddress) & {
     | 'planning_permission_granted'
     | 'quashed_on_legal_grounds'
     | 'notice_varied_and_upheld'
+    | 'notice_quashed'
     | null;
   /**
    * The date the appeal decision letter
@@ -1591,6 +1866,13 @@ export type AppealS78Case = (GridReference | SiteAddress) & {
     | 'lawful-development-certificate'
     | 'discontinuance-notice'
     | 'permission-in-principle'
+    | 'tree-preservation-order'
+    | 'tree-replacement-notice'
+    | 'high-hedge-appeal'
+    | 'hedgerows-appeal'
+    | 'community-infrastructure-levy'
+    | 'planning-obligation'
+    | 'environmental'
     | null;
   developmentType:
     | 'householder'
@@ -5922,6 +6204,7 @@ export type SchemaMap = {
     'appeal-document.schema.json': AppealDocument;
     'appeal-event-estimate.schema.json': AppealEventEstimate;
     'appeal-event.schema.json': AppealEvent;
+    'appeal-group-c.schema.json': AppealGroupCCase;
     'appeal-has.schema.json': AppealHASCase;
     'appeal-representation.schema.json': AppealRepresentation;
     'appeal-s78.schema.json': AppealS78Case;