@planning-inspectorate/data-model 2.0.1 → 2.2.0

package/docs/README.md

@@ -30,6 +30,10 @@
 
 * [NSIP Document](./nsip-document.md "NSIP document schema") – `nsip-document.schema.json`
 
+* [NSIP Invoice](./nsip-invoice.md "NSIP Standalone Invoice Schema for ODW Curated layer") – `nsip-invoice.schema.json`
+
+* [NSIP Meeting](./nsip-meeting.md "NSIP Standalone Meeting Schema for ODW Curated layer") – `nsip-meeting.schema.json`
+
 * [NSIP Project](./nsip-project.md "Subset of Pins Data Model \[Case]") – `nsip-project.schema.json`
 
 * [NSIP Project Update](./nsip-project-update.md "NSIP Project Update (formerly known as Banners)") – `nsip-project-update.schema.json`

package/docs/nsip-invoice.md

@@ -0,0 +1,317 @@
+## NSIP Invoice Type
+
+`object` ([NSIP Invoice](nsip-invoice.md))
+
+# NSIP Invoice Properties
+
+| Property                                          | Type      | Required | Nullable       | Defined by                                                                                                                      |
+| :------------------------------------------------ | :-------- | :------- | :------------- | :------------------------------------------------------------------------------------------------------------------------------ |
+| [caseId](#caseid)                                 | `integer` | Required | cannot be null | [NSIP Invoice](nsip-invoice-properties-caseid.md "nsip-invoice.schema.json#/properties/caseId")                                 |
+| [caseReference](#casereference)                   | `string`  | Required | can be null    | [NSIP Invoice](nsip-invoice-properties-casereference.md "nsip-invoice.schema.json#/properties/caseReference")                   |
+| [invoiceStage](#invoicestage)                     | `string`  | Required | can be null    | [NSIP Invoice](nsip-invoice-properties-invoicestage.md "nsip-invoice.schema.json#/properties/invoiceStage")                     |
+| [invoiceNumber](#invoicenumber)                   | `string`  | Required | cannot be null | [NSIP Invoice](nsip-invoice-properties-invoicenumber.md "nsip-invoice.schema.json#/properties/invoiceNumber")                   |
+| [amountDue](#amountdue)                           | `number`  | Required | cannot be null | [NSIP Invoice](nsip-invoice-properties-amountdue.md "nsip-invoice.schema.json#/properties/amountDue")                           |
+| [paymentDueDate](#paymentduedate)                 | `string`  | Required | can be null    | [NSIP Invoice](nsip-invoice-properties-paymentduedate.md "nsip-invoice.schema.json#/properties/paymentDueDate")                 |
+| [invoicedDate](#invoiceddate)                     | `string`  | Required | can be null    | [NSIP Invoice](nsip-invoice-properties-invoiceddate.md "nsip-invoice.schema.json#/properties/invoicedDate")                     |
+| [paymentDate](#paymentdate)                       | `string`  | Required | can be null    | [NSIP Invoice](nsip-invoice-properties-paymentdate.md "nsip-invoice.schema.json#/properties/paymentDate")                       |
+| [refundCreditNoteNumber](#refundcreditnotenumber) | `string`  | Required | can be null    | [NSIP Invoice](nsip-invoice-properties-refundcreditnotenumber.md "nsip-invoice.schema.json#/properties/refundCreditNoteNumber") |
+| [refundAmount](#refundamount)                     | `number`  | Required | can be null    | [NSIP Invoice](nsip-invoice-properties-refundamount.md "nsip-invoice.schema.json#/properties/refundAmount")                     |
+| [refundIssueDate](#refundissuedate)               | `string`  | Required | can be null    | [NSIP Invoice](nsip-invoice-properties-refundissuedate.md "nsip-invoice.schema.json#/properties/refundIssueDate")               |
+| Additional Properties                             | Any       | Optional | can be null    |                                                                                                                                 |
+
+## caseId
+
+The unique identifier within the Back Office. This is not the same as the case reference
+
+`caseId`
+
+* is required
+
+* Type: `integer`
+
+* cannot be null
+
+* defined in: [NSIP Invoice](nsip-invoice-properties-caseid.md "nsip-invoice.schema.json#/properties/caseId")
+
+### caseId Type
+
+`integer`
+
+### caseId Examples
+
+```json
+1242
+```
+
+## caseReference
+
+
+
+`caseReference`
+
+* is required
+
+* Type: `string`
+
+* can be null
+
+* defined in: [NSIP Invoice](nsip-invoice-properties-casereference.md "nsip-invoice.schema.json#/properties/caseReference")
+
+### caseReference Type
+
+`string`
+
+### caseReference Examples
+
+```json
+"BC0510001"
+```
+
+## invoiceStage
+
+Invoice stage
+
+`invoiceStage`
+
+* is required
+
+* Type: `string`
+
+* can be null
+
+* defined in: [NSIP Invoice](nsip-invoice-properties-invoicestage.md "nsip-invoice.schema.json#/properties/invoiceStage")
+
+### invoiceStage Type
+
+`string`
+
+### invoiceStage Constraints
+
+**enum**: the value of this property must be equal to one of the following values:
+
+| Value                   | Explanation |
+| :---------------------- | :---------- |
+| `"pre_acceptance"`      |             |
+| `"acceptance"`          |             |
+| `"pre_examination"`     |             |
+| `"initial_examination"` |             |
+| `"final_examination"`   |             |
+| `null`                  |             |
+
+### invoiceStage Examples
+
+```json
+"pre_acceptance"
+```
+
+## invoiceNumber
+
+Invoice number
+
+`invoiceNumber`
+
+* is required
+
+* Type: `string`
+
+* cannot be null
+
+* defined in: [NSIP Invoice](nsip-invoice-properties-invoicenumber.md "nsip-invoice.schema.json#/properties/invoiceNumber")
+
+### invoiceNumber Type
+
+`string`
+
+### invoiceNumber Examples
+
+```json
+"1800004419"
+```
+
+## amountDue
+
+Amount due
+
+`amountDue`
+
+* is required
+
+* Type: `number`
+
+* cannot be null
+
+* defined in: [NSIP Invoice](nsip-invoice-properties-amountdue.md "nsip-invoice.schema.json#/properties/amountDue")
+
+### amountDue Type
+
+`number`
+
+### amountDue Examples
+
+```json
+500
+```
+
+## paymentDueDate
+
+Payment due date
+
+`paymentDueDate`
+
+* is required
+
+* Type: `string`
+
+* can be null
+
+* defined in: [NSIP Invoice](nsip-invoice-properties-paymentduedate.md "nsip-invoice.schema.json#/properties/paymentDueDate")
+
+### paymentDueDate Type
+
+`string`
+
+### paymentDueDate Constraints
+
+**date time**: the string must be a date time string, according to [RFC 3339, section 5.6](https://tools.ietf.org/html/rfc3339 "check the specification")
+
+### paymentDueDate Examples
+
+```json
+"2023-07-27T20:30:00.000Z"
+```
+
+## invoicedDate
+
+Invoiced date
+
+`invoicedDate`
+
+* is required
+
+* Type: `string`
+
+* can be null
+
+* defined in: [NSIP Invoice](nsip-invoice-properties-invoiceddate.md "nsip-invoice.schema.json#/properties/invoicedDate")
+
+### invoicedDate Type
+
+`string`
+
+### invoicedDate Constraints
+
+**date time**: the string must be a date time string, according to [RFC 3339, section 5.6](https://tools.ietf.org/html/rfc3339 "check the specification")
+
+### invoicedDate Examples
+
+```json
+"2023-07-27T20:30:00.000Z"
+```
+
+## paymentDate
+
+Date of payment
+
+`paymentDate`
+
+* is required
+
+* Type: `string`
+
+* can be null
+
+* defined in: [NSIP Invoice](nsip-invoice-properties-paymentdate.md "nsip-invoice.schema.json#/properties/paymentDate")
+
+### paymentDate Type
+
+`string`
+
+### paymentDate Constraints
+
+**date time**: the string must be a date time string, according to [RFC 3339, section 5.6](https://tools.ietf.org/html/rfc3339 "check the specification")
+
+### paymentDate Examples
+
+```json
+"2023-07-27T20:30:00.000Z"
+```
+
+## refundCreditNoteNumber
+
+Refund credit note number
+
+`refundCreditNoteNumber`
+
+* is required
+
+* Type: `string`
+
+* can be null
+
+* defined in: [NSIP Invoice](nsip-invoice-properties-refundcreditnotenumber.md "nsip-invoice.schema.json#/properties/refundCreditNoteNumber")
+
+### refundCreditNoteNumber Type
+
+`string`
+
+### refundCreditNoteNumber Examples
+
+```json
+"1800004419"
+```
+
+## refundAmount
+
+Amount refunded
+
+`refundAmount`
+
+* is required
+
+* Type: `number`
+
+* can be null
+
+* defined in: [NSIP Invoice](nsip-invoice-properties-refundamount.md "nsip-invoice.schema.json#/properties/refundAmount")
+
+### refundAmount Type
+
+`number`
+
+### refundAmount Examples
+
+```json
+200
+```
+
+## refundIssueDate
+
+Refund issue date
+
+`refundIssueDate`
+
+* is required
+
+* Type: `string`
+
+* can be null
+
+* defined in: [NSIP Invoice](nsip-invoice-properties-refundissuedate.md "nsip-invoice.schema.json#/properties/refundIssueDate")
+
+### refundIssueDate Type
+
+`string`
+
+### refundIssueDate Constraints
+
+**date time**: the string must be a date time string, according to [RFC 3339, section 5.6](https://tools.ietf.org/html/rfc3339 "check the specification")
+
+### refundIssueDate Examples
+
+```json
+"2023-07-27T20:30:00.000Z"
+```
+
+## Additional Properties
+
+Additional properties are allowed and do not have to follow a specific schema

package/docs/nsip-meeting.md

@@ -0,0 +1,197 @@
+## NSIP Meeting Type
+
+`object` ([NSIP Meeting](nsip-meeting.md))
+
+# NSIP Meeting Properties
+
+| Property                                              | Type      | Required | Nullable       | Defined by                                                                                                                          |
+| :---------------------------------------------------- | :-------- | :------- | :------------- | :---------------------------------------------------------------------------------------------------------------------------------- |
+| [meetingID](#meetingid)                               | `integer` | Required | cannot be null | [NSIP Meeting](nsip-meeting-properties-meetingid.md "nsip-meeting.schema.json#/properties/meetingID")                               |
+| [caseId](#caseid)                                     | `integer` | Required | cannot be null | [NSIP Meeting](nsip-meeting-properties-caseid.md "nsip-meeting.schema.json#/properties/caseId")                                     |
+| [caseReference](#casereference)                       | `string`  | Required | can be null    | [NSIP Meeting](nsip-meeting-properties-casereference.md "nsip-meeting.schema.json#/properties/caseReference")                       |
+| [meetingAgenda](#meetingagenda)                       | `string`  | Required | can be null    | [NSIP Meeting](nsip-meeting-properties-meetingagenda.md "nsip-meeting.schema.json#/properties/meetingAgenda")                       |
+| [planningInspectorateRole](#planninginspectoraterole) | `string`  | Required | can be null    | [NSIP Meeting](nsip-meeting-properties-planninginspectoraterole.md "nsip-meeting.schema.json#/properties/planningInspectorateRole") |
+| [meetingDate](#meetingdate)                           | `string`  | Required | can be null    | [NSIP Meeting](nsip-meeting-properties-meetingdate.md "nsip-meeting.schema.json#/properties/meetingDate")                           |
+| [meetingType](#meetingtype)                           | `string`  | Required | can be null    | [NSIP Meeting](nsip-meeting-properties-meetingtype.md "nsip-meeting.schema.json#/properties/meetingType")                           |
+| Additional Properties                                 | Any       | Optional | can be null    |                                                                                                                                     |
+
+## meetingID
+
+The unique identifier for an NSIP Meeting.
+
+`meetingID`
+
+* is required
+
+* Type: `integer`
+
+* cannot be null
+
+* defined in: [NSIP Meeting](nsip-meeting-properties-meetingid.md "nsip-meeting.schema.json#/properties/meetingID")
+
+### meetingID Type
+
+`integer`
+
+### meetingID Examples
+
+```json
+1234
+```
+
+## caseId
+
+The unique identifier for the case within the Back Office. This is not the same as the case reference
+
+`caseId`
+
+* is required
+
+* Type: `integer`
+
+* cannot be null
+
+* defined in: [NSIP Meeting](nsip-meeting-properties-caseid.md "nsip-meeting.schema.json#/properties/caseId")
+
+### caseId Type
+
+`integer`
+
+### caseId Examples
+
+```json
+1242
+```
+
+## caseReference
+
+
+
+`caseReference`
+
+* is required
+
+* Type: `string`
+
+* can be null
+
+* defined in: [NSIP Meeting](nsip-meeting-properties-casereference.md "nsip-meeting.schema.json#/properties/caseReference")
+
+### caseReference Type
+
+`string`
+
+### caseReference Examples
+
+```json
+"BC0510001"
+```
+
+## meetingAgenda
+
+Meeting agenda
+
+`meetingAgenda`
+
+* is required
+
+* Type: `string`
+
+* can be null
+
+* defined in: [NSIP Meeting](nsip-meeting-properties-meetingagenda.md "nsip-meeting.schema.json#/properties/meetingAgenda")
+
+### meetingAgenda Type
+
+`string`
+
+### meetingAgenda Examples
+
+```json
+"Flood Risk Assessment (FRA)"
+```
+
+## planningInspectorateRole
+
+Planning Inspectorate role
+
+`planningInspectorateRole`
+
+* is required
+
+* Type: `string`
+
+* can be null
+
+* defined in: [NSIP Meeting](nsip-meeting-properties-planninginspectoraterole.md "nsip-meeting.schema.json#/properties/planningInspectorateRole")
+
+### planningInspectorateRole Type
+
+`string`
+
+### planningInspectorateRole Constraints
+
+**enum**: the value of this property must be equal to one of the following values:
+
+| Value           | Explanation |
+| :-------------- | :---------- |
+| `"facilitator"` |             |
+| `"advisor"`     |             |
+| `"observer"`    |             |
+| `null`          |             |
+
+### planningInspectorateRole Examples
+
+```json
+"facilitator"
+```
+
+## meetingDate
+
+Meeting date
+
+`meetingDate`
+
+* is required
+
+* Type: `string`
+
+* can be null
+
+* defined in: [NSIP Meeting](nsip-meeting-properties-meetingdate.md "nsip-meeting.schema.json#/properties/meetingDate")
+
+### meetingDate Type
+
+`string`
+
+### meetingDate Constraints
+
+**date time**: the string must be a date time string, according to [RFC 3339, section 5.6](https://tools.ietf.org/html/rfc3339 "check the specification")
+
+### meetingDate Examples
+
+```json
+"2023-07-27T20:30:00.000Z"
+```
+
+## meetingType
+
+Type of Meeting
+
+`meetingType`
+
+* is required
+
+* Type: `string`
+
+* can be null
+
+* defined in: [NSIP Meeting](nsip-meeting-properties-meetingtype.md "nsip-meeting.schema.json#/properties/meetingType")
+
+### meetingType Type
+
+`string`
+
+## Additional Properties
+
+Additional properties are allowed and do not have to follow a specific schema

package/docs/nsip-project-defs-meeting.md

@@ -4,13 +4,38 @@
 
 # meeting Properties
 
-| Property                                              | Type     | Required | Nullable    | Defined by                                                                                                                                                     |
-| :---------------------------------------------------- | :------- | :------- | :---------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| [meetingAgenda](#meetingagenda)                       | `string` | Optional | can be null | [NSIP Project](nsip-project-defs-meeting-properties-meetingagenda.md "nsip-project.schema.json#/$defs/meeting/properties/meetingAgenda")                       |
-| [planningInspectorateRole](#planninginspectoraterole) | `string` | Optional | can be null | [NSIP Project](nsip-project-defs-meeting-properties-planninginspectoraterole.md "nsip-project.schema.json#/$defs/meeting/properties/planningInspectorateRole") |
-| [meetingDate](#meetingdate)                           | `string` | Optional | can be null | [NSIP Project](nsip-project-defs-meeting-properties-meetingdate.md "nsip-project.schema.json#/$defs/meeting/properties/meetingDate")                           |
-| [meetingType](#meetingtype)                           | `string` | Optional | can be null | [NSIP Project](nsip-project-defs-meeting-properties-meetingtype.md "nsip-project.schema.json#/$defs/meeting/properties/meetingType")                           |
-| Additional Properties                                 | Any      | Optional | can be null |                                                                                                                                                                |
+| Property                                              | Type      | Required | Nullable    | Defined by                                                                                                                                                     |
+| :---------------------------------------------------- | :-------- | :------- | :---------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [meetingId](#meetingid)                               | `integer` | Optional | can be null | [NSIP Project](nsip-project-defs-meeting-properties-meetingid.md "nsip-project.schema.json#/$defs/meeting/properties/meetingId")                               |
+| [meetingAgenda](#meetingagenda)                       | `string`  | Optional | can be null | [NSIP Project](nsip-project-defs-meeting-properties-meetingagenda.md "nsip-project.schema.json#/$defs/meeting/properties/meetingAgenda")                       |
+| [planningInspectorateRole](#planninginspectoraterole) | `string`  | Optional | can be null | [NSIP Project](nsip-project-defs-meeting-properties-planninginspectoraterole.md "nsip-project.schema.json#/$defs/meeting/properties/planningInspectorateRole") |
+| [meetingDate](#meetingdate)                           | `string`  | Optional | can be null | [NSIP Project](nsip-project-defs-meeting-properties-meetingdate.md "nsip-project.schema.json#/$defs/meeting/properties/meetingDate")                           |
+| [meetingType](#meetingtype)                           | `string`  | Optional | can be null | [NSIP Project](nsip-project-defs-meeting-properties-meetingtype.md "nsip-project.schema.json#/$defs/meeting/properties/meetingType")                           |
+| Additional Properties                                 | Any       | Optional | can be null |                                                                                                                                                                |
+
+## meetingId
+
+Unique identifier for the meeting
+
+`meetingId`
+
+* is optional
+
+* Type: `integer`
+
+* can be null
+
+* defined in: [NSIP Project](nsip-project-defs-meeting-properties-meetingid.md "nsip-project.schema.json#/$defs/meeting/properties/meetingId")
+
+### meetingId Type
+
+`integer`
+
+### meetingId Examples
+
+```json
+123
+```
 
 ## meetingAgenda
 

package/docs/nsip-project.md

@@ -3592,13 +3592,38 @@ Reference this group by using
 {"$ref":"nsip-project.schema.json#/$defs/meeting"}
 ```
 
-| Property                                              | Type     | Required | Nullable    | Defined by                                                                                                                                                     |
-| :---------------------------------------------------- | :------- | :------- | :---------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| [meetingAgenda](#meetingagenda)                       | `string` | Optional | can be null | [NSIP Project](nsip-project-defs-meeting-properties-meetingagenda.md "nsip-project.schema.json#/$defs/meeting/properties/meetingAgenda")                       |
-| [planningInspectorateRole](#planninginspectoraterole) | `string` | Optional | can be null | [NSIP Project](nsip-project-defs-meeting-properties-planninginspectoraterole.md "nsip-project.schema.json#/$defs/meeting/properties/planningInspectorateRole") |
-| [meetingDate](#meetingdate)                           | `string` | Optional | can be null | [NSIP Project](nsip-project-defs-meeting-properties-meetingdate.md "nsip-project.schema.json#/$defs/meeting/properties/meetingDate")                           |
-| [meetingType](#meetingtype)                           | `string` | Optional | can be null | [NSIP Project](nsip-project-defs-meeting-properties-meetingtype.md "nsip-project.schema.json#/$defs/meeting/properties/meetingType")                           |
-| Additional Properties                                 | Any      | Optional | can be null |                                                                                                                                                                |
+| Property                                              | Type      | Required | Nullable    | Defined by                                                                                                                                                     |
+| :---------------------------------------------------- | :-------- | :------- | :---------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [meetingId](#meetingid)                               | `integer` | Optional | can be null | [NSIP Project](nsip-project-defs-meeting-properties-meetingid.md "nsip-project.schema.json#/$defs/meeting/properties/meetingId")                               |
+| [meetingAgenda](#meetingagenda)                       | `string`  | Optional | can be null | [NSIP Project](nsip-project-defs-meeting-properties-meetingagenda.md "nsip-project.schema.json#/$defs/meeting/properties/meetingAgenda")                       |
+| [planningInspectorateRole](#planninginspectoraterole) | `string`  | Optional | can be null | [NSIP Project](nsip-project-defs-meeting-properties-planninginspectoraterole.md "nsip-project.schema.json#/$defs/meeting/properties/planningInspectorateRole") |
+| [meetingDate](#meetingdate)                           | `string`  | Optional | can be null | [NSIP Project](nsip-project-defs-meeting-properties-meetingdate.md "nsip-project.schema.json#/$defs/meeting/properties/meetingDate")                           |
+| [meetingType](#meetingtype)                           | `string`  | Optional | can be null | [NSIP Project](nsip-project-defs-meeting-properties-meetingtype.md "nsip-project.schema.json#/$defs/meeting/properties/meetingType")                           |
+| Additional Properties                                 | Any       | Optional | can be null |                                                                                                                                                                |
+
+### meetingId
+
+Unique identifier for the meeting
+
+`meetingId`
+
+* is optional
+
+* Type: `integer`
+
+* can be null
+
+* defined in: [NSIP Project](nsip-project-defs-meeting-properties-meetingid.md "nsip-project.schema.json#/$defs/meeting/properties/meetingId")
+
+#### meetingId Type
+
+`integer`
+
+#### meetingId Examples
+
+```json
+123
+```
 
 ### meetingAgenda
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@planning-inspectorate/data-model",
-  "version": "2.0.1",
+  "version": "2.2.0",
   "description": "JSON Schemas for the Planning Inspectorate's Data Model",
   "main": "src/index.js",
   "type": "module",

package/pins_data_model/models/model_appeal_document.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  appeal-document.schema.json
-#   timestamp: 2025-11-04T12:33:59+00:00
+#   timestamp: 2025-11-12T14:58:30+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_appeal_event.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  appeal-event.schema.json
-#   timestamp: 2025-11-04T12:33:59+00:00
+#   timestamp: 2025-11-12T14:58:30+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_appeal_event_estimate.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  appeal-event-estimate.schema.json
-#   timestamp: 2025-11-04T12:33:59+00:00
+#   timestamp: 2025-11-12T14:58:30+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_appeal_has.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  appeal-has.schema.json
-#   timestamp: 2025-11-07T15:19:29+00:00
+#   timestamp: 2025-11-12T14:58:30+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_appeal_representation.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  appeal-representation.schema.json
-#   timestamp: 2025-11-04T12:33:59+00:00
+#   timestamp: 2025-11-12T14:58:30+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_appeal_s78.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  appeal-s78.schema.json
-#   timestamp: 2025-11-07T15:19:29+00:00
+#   timestamp: 2025-11-12T14:58:31+00:00
 
 from __future__ import annotations