@planning-inspectorate/data-model 2.48.1 → 2.50.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (35) hide show
  1. package/docs/README.md +23 -1
  2. package/docs/address.md +366 -0
  3. package/docs/appeal-has.md +10 -7
  4. package/docs/applications-application-defs-address.md +108 -0
  5. package/docs/applications-application-defs-contact.md +98 -0
  6. package/docs/applications-application-defs-organisation.md +117 -0
  7. package/docs/applications-application-defs.md +3 -0
  8. package/docs/{application-update.md → applications-application-update.md} +22 -22
  9. package/docs/applications-application.md +2250 -0
  10. package/docs/applications-notify-email-defs-contact.md +93 -0
  11. package/docs/applications-notify-email-defs.md +3 -0
  12. package/docs/applications-notify-email.md +458 -0
  13. package/docs/applications-representation-definitions-contact.md +93 -0
  14. package/docs/applications-representation-definitions-representationdocument.md +152 -0
  15. package/docs/applications-representation-definitions.md +3 -0
  16. package/docs/applications-representation.md +834 -0
  17. package/package.json +1 -1
  18. package/pins_data_model/models/model_address.py +69 -0
  19. package/pins_data_model/models/model_appeal_has.py +3 -0
  20. package/pins_data_model/models/model_applications_application.py +518 -0
  21. package/pins_data_model/models/model_applications_application_update.py +55 -0
  22. package/pins_data_model/models/model_applications_notify_email.py +124 -0
  23. package/pins_data_model/models/model_applications_representation.py +207 -0
  24. package/schemas/address.schema.json +87 -0
  25. package/schemas/appeal-has.schema.json +2 -2
  26. package/schemas/{application-update.schema.json → applications-application-update.schema.json} +1 -1
  27. package/schemas/applications-application.schema.json +539 -0
  28. package/schemas/applications-notify-email.schema.json +118 -0
  29. package/schemas/applications-representation.schema.json +202 -0
  30. package/src/enums.cjs +147 -7
  31. package/src/enums.d.ts +131 -6
  32. package/src/enums.js +131 -6
  33. package/src/index.cjs +147 -7
  34. package/src/schemas.d.ts +679 -2
  35. package/tests/appeals/appeal-has.test.js +34 -0
@@ -0,0 +1,834 @@
1
+ ## Casework Representation Schema Type
2
+
3
+ `object` ([Casework Representation Schema](applications-representation.md))
4
+
5
+ # Casework Representation Schema Properties
6
+
7
+ | Property | Type | Required | Nullable | Defined by |
8
+ | :------------------------------------------------------------------------ | :-------- | :------- | :------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
9
+ | [id](#id) | `string` | Required | cannot be null | [Casework Representation Schema](applications-representation-properties-id.md "applications-representation.schema.json#/properties/id") |
10
+ | [reference](#reference) | `string` | Required | cannot be null | [Casework Representation Schema](applications-representation-properties-reference.md "applications-representation.schema.json#/properties/reference") |
11
+ | [caseReference](#casereference) | `string` | Required | cannot be null | [Casework Representation Schema](applications-representation-properties-casereference.md "applications-representation.schema.json#/properties/caseReference") |
12
+ | [caseId](#caseid) | `string` | Required | cannot be null | [Casework Representation Schema](applications-representation-properties-caseid.md "applications-representation.schema.json#/properties/caseId") |
13
+ | [caseType](#casetype) | `string` | Required | cannot be null | [Casework Representation Schema](applications-representation-properties-casetype.md "applications-representation.schema.json#/properties/caseType") |
14
+ | [representationStatus](#representationstatus) | `string` | Optional | cannot be null | [Casework Representation Schema](applications-representation-properties-representationstatus.md "applications-representation.schema.json#/properties/representationStatus") |
15
+ | [submittedFor](#submittedfor) | `string` | Required | cannot be null | [Casework Representation Schema](applications-representation-properties-submittedfor.md "applications-representation.schema.json#/properties/submittedFor") |
16
+ | [submittedByContact](#submittedbycontact) | `array` | Optional | can be null | [Casework Representation Schema](applications-representation-properties-submittedbycontact.md "applications-representation.schema.json#/properties/submittedByContact") |
17
+ | [submittedByAgentFlag](#submittedbyagentflag) | `boolean` | Optional | can be null | [Casework Representation Schema](applications-representation-properties-submittedbyagentflag.md "applications-representation.schema.json#/properties/submittedByAgentFlag") |
18
+ | [submittedByAgentOrgName](#submittedbyagentorgname) | `string` | Optional | can be null | [Casework Representation Schema](applications-representation-properties-submittedbyagentorgname.md "applications-representation.schema.json#/properties/submittedByAgentOrgName") |
19
+ | [submittedDate](#submitteddate) | `string` | Required | cannot be null | [Casework Representation Schema](applications-representation-properties-submitteddate.md "applications-representation.schema.json#/properties/submittedDate") |
20
+ | [submittedReceivedMethod](#submittedreceivedmethod) | `string` | Optional | can be null | [Casework Representation Schema](applications-representation-properties-submittedreceivedmethod.md "applications-representation.schema.json#/properties/submittedReceivedMethod") |
21
+ | [submissionMethodReason](#submissionmethodreason) | `string` | Optional | can be null | [Casework Representation Schema](applications-representation-properties-submissionmethodreason.md "applications-representation.schema.json#/properties/submissionMethodReason") |
22
+ | [comment](#comment) | `string` | Required | cannot be null | [Casework Representation Schema](applications-representation-properties-comment.md "applications-representation.schema.json#/properties/comment") |
23
+ | [commentRedacted](#commentredacted) | `string` | Optional | can be null | [Casework Representation Schema](applications-representation-properties-commentredacted.md "applications-representation.schema.json#/properties/commentRedacted") |
24
+ | [representedType](#representedtype) | `string` | Optional | can be null | [Casework Representation Schema](applications-representation-properties-representedtype.md "applications-representation.schema.json#/properties/representedType") |
25
+ | [representedContact](#representedcontact) | `array` | Optional | can be null | [Casework Representation Schema](applications-representation-properties-representedcontact.md "applications-representation.schema.json#/properties/representedContact") |
26
+ | [representedCategory](#representedcategory) | `string` | Optional | can be null | [Casework Representation Schema](applications-representation-properties-representedcategory.md "applications-representation.schema.json#/properties/representedCategory") |
27
+ | [wantsToBeHeard](#wantstobeheard) | `boolean` | Optional | can be null | [Casework Representation Schema](applications-representation-properties-wantstobeheard.md "applications-representation.schema.json#/properties/wantsToBeHeard") |
28
+ | [containsAttachments](#containsattachments) | `boolean` | Optional | can be null | [Casework Representation Schema](applications-representation-properties-containsattachments.md "applications-representation.schema.json#/properties/containsAttachments") |
29
+ | [sharePointFolderCreated](#sharepointfoldercreated) | `boolean` | Optional | can be null | [Casework Representation Schema](applications-representation-properties-sharepointfoldercreated.md "applications-representation.schema.json#/properties/sharePointFolderCreated") |
30
+ | [distressingContentInRepresentation](#distressingcontentinrepresentation) | `boolean` | Optional | can be null | [Casework Representation Schema](applications-representation-properties-distressingcontentinrepresentation.md "applications-representation.schema.json#/properties/distressingContentInRepresentation") |
31
+ | [withdrawalRequestDate](#withdrawalrequestdate) | `string` | Optional | can be null | [Casework Representation Schema](applications-representation-properties-withdrawalrequestdate.md "applications-representation.schema.json#/properties/withdrawalRequestDate") |
32
+ | [withdrawalReason](#withdrawalreason) | `string` | Optional | can be null | [Casework Representation Schema](applications-representation-properties-withdrawalreason.md "applications-representation.schema.json#/properties/withdrawalReason") |
33
+ | [dateWithdrawn](#datewithdrawn) | `string` | Optional | can be null | [Casework Representation Schema](applications-representation-properties-datewithdrawn.md "applications-representation.schema.json#/properties/dateWithdrawn") |
34
+ | [representationDocuments](#representationdocuments) | `array` | Optional | can be null | [Casework Representation Schema](applications-representation-properties-representationdocuments.md "applications-representation.schema.json#/properties/representationDocuments") |
35
+ | Additional Properties | Any | Optional | can be null | |
36
+
37
+ ## id
38
+
39
+ Primary key
40
+
41
+ `id`
42
+
43
+ * is required
44
+
45
+ * Type: `string`
46
+
47
+ * cannot be null
48
+
49
+ * defined in: [Casework Representation Schema](applications-representation-properties-id.md "applications-representation.schema.json#/properties/id")
50
+
51
+ ### id Type
52
+
53
+ `string`
54
+
55
+ ## reference
56
+
57
+ Auto-generated hexadecimal reference: AAAAA-BBBBB
58
+
59
+ `reference`
60
+
61
+ * is required
62
+
63
+ * Type: `string`
64
+
65
+ * cannot be null
66
+
67
+ * defined in: [Casework Representation Schema](applications-representation-properties-reference.md "applications-representation.schema.json#/properties/reference")
68
+
69
+ ### reference Type
70
+
71
+ `string`
72
+
73
+ ## caseReference
74
+
75
+ Business Key for the related case
76
+
77
+ `caseReference`
78
+
79
+ * is required
80
+
81
+ * Type: `string`
82
+
83
+ * cannot be null
84
+
85
+ * defined in: [Casework Representation Schema](applications-representation-properties-casereference.md "applications-representation.schema.json#/properties/caseReference")
86
+
87
+ ### caseReference Type
88
+
89
+ `string`
90
+
91
+ ## caseId
92
+
93
+ The unique ID for the case this representation belongs to.
94
+
95
+ `caseId`
96
+
97
+ * is required
98
+
99
+ * Type: `string`
100
+
101
+ * cannot be null
102
+
103
+ * defined in: [Casework Representation Schema](applications-representation-properties-caseid.md "applications-representation.schema.json#/properties/caseId")
104
+
105
+ ### caseId Type
106
+
107
+ `string`
108
+
109
+ ## caseType
110
+
111
+ The type of case this representation is for.
112
+
113
+ `caseType`
114
+
115
+ * is required
116
+
117
+ * Type: `string`
118
+
119
+ * cannot be null
120
+
121
+ * defined in: [Casework Representation Schema](applications-representation-properties-casetype.md "applications-representation.schema.json#/properties/caseType")
122
+
123
+ ### caseType Type
124
+
125
+ `string`
126
+
127
+ ## representationStatus
128
+
129
+
130
+
131
+ `representationStatus`
132
+
133
+ * is optional
134
+
135
+ * Type: `string`
136
+
137
+ * cannot be null
138
+
139
+ * defined in: [Casework Representation Schema](applications-representation-properties-representationstatus.md "applications-representation.schema.json#/properties/representationStatus")
140
+
141
+ ### representationStatus Type
142
+
143
+ `string`
144
+
145
+ ### representationStatus Constraints
146
+
147
+ **enum**: the value of this property must be equal to one of the following values:
148
+
149
+ | Value | Explanation |
150
+ | :------------------ | :---------- |
151
+ | `"Awaiting review"` | |
152
+ | `"Accepted"` | |
153
+ | `"Rejected"` | |
154
+ | `"Withdrawn"` | |
155
+
156
+ ## submittedFor
157
+
158
+
159
+
160
+ `submittedFor`
161
+
162
+ * is required
163
+
164
+ * Type: `string`
165
+
166
+ * cannot be null
167
+
168
+ * defined in: [Casework Representation Schema](applications-representation-properties-submittedfor.md "applications-representation.schema.json#/properties/submittedFor")
169
+
170
+ ### submittedFor Type
171
+
172
+ `string`
173
+
174
+ ### submittedFor Constraints
175
+
176
+ **enum**: the value of this property must be equal to one of the following values:
177
+
178
+ | Value | Explanation |
179
+ | :------------------------------------------------- | :---------- |
180
+ | `"Myself"` | |
181
+ | `"On behalf of another person or an organisation"` | |
182
+
183
+ ## submittedByContact
184
+
185
+
186
+
187
+ `submittedByContact`
188
+
189
+ * is optional
190
+
191
+ * Type: `object[]` ([Details](applications-representation-definitions-contact.md))
192
+
193
+ * can be null
194
+
195
+ * defined in: [Casework Representation Schema](applications-representation-properties-submittedbycontact.md "applications-representation.schema.json#/properties/submittedByContact")
196
+
197
+ ### submittedByContact Type
198
+
199
+ `object[]` ([Details](applications-representation-definitions-contact.md))
200
+
201
+ ## submittedByAgentFlag
202
+
203
+
204
+
205
+ `submittedByAgentFlag`
206
+
207
+ * is optional
208
+
209
+ * Type: `boolean`
210
+
211
+ * can be null
212
+
213
+ * defined in: [Casework Representation Schema](applications-representation-properties-submittedbyagentflag.md "applications-representation.schema.json#/properties/submittedByAgentFlag")
214
+
215
+ ### submittedByAgentFlag Type
216
+
217
+ `boolean`
218
+
219
+ ## submittedByAgentOrgName
220
+
221
+
222
+
223
+ `submittedByAgentOrgName`
224
+
225
+ * is optional
226
+
227
+ * Type: `string`
228
+
229
+ * can be null
230
+
231
+ * defined in: [Casework Representation Schema](applications-representation-properties-submittedbyagentorgname.md "applications-representation.schema.json#/properties/submittedByAgentOrgName")
232
+
233
+ ### submittedByAgentOrgName Type
234
+
235
+ `string`
236
+
237
+ ## submittedDate
238
+
239
+
240
+
241
+ `submittedDate`
242
+
243
+ * is required
244
+
245
+ * Type: `string`
246
+
247
+ * cannot be null
248
+
249
+ * defined in: [Casework Representation Schema](applications-representation-properties-submitteddate.md "applications-representation.schema.json#/properties/submittedDate")
250
+
251
+ ### submittedDate Type
252
+
253
+ `string`
254
+
255
+ ### submittedDate Constraints
256
+
257
+ **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")
258
+
259
+ ## submittedReceivedMethod
260
+
261
+ How we received the representation
262
+
263
+ `submittedReceivedMethod`
264
+
265
+ * is optional
266
+
267
+ * Type: `string`
268
+
269
+ * can be null
270
+
271
+ * defined in: [Casework Representation Schema](applications-representation-properties-submittedreceivedmethod.md "applications-representation.schema.json#/properties/submittedReceivedMethod")
272
+
273
+ ### submittedReceivedMethod Type
274
+
275
+ `string`
276
+
277
+ ### submittedReceivedMethod Constraints
278
+
279
+ **enum**: the value of this property must be equal to one of the following values:
280
+
281
+ | Value | Explanation |
282
+ | :------------ | :---------- |
283
+ | `"Online"` | |
284
+ | `"Phone"` | |
285
+ | `"Email"` | |
286
+ | `"Post"` | |
287
+ | `"In person"` | |
288
+
289
+ ## submissionMethodReason
290
+
291
+
292
+
293
+ `submissionMethodReason`
294
+
295
+ * is optional
296
+
297
+ * Type: `string`
298
+
299
+ * can be null
300
+
301
+ * defined in: [Casework Representation Schema](applications-representation-properties-submissionmethodreason.md "applications-representation.schema.json#/properties/submissionMethodReason")
302
+
303
+ ### submissionMethodReason Type
304
+
305
+ `string`
306
+
307
+ ## comment
308
+
309
+
310
+
311
+ `comment`
312
+
313
+ * is required
314
+
315
+ * Type: `string`
316
+
317
+ * cannot be null
318
+
319
+ * defined in: [Casework Representation Schema](applications-representation-properties-comment.md "applications-representation.schema.json#/properties/comment")
320
+
321
+ ### comment Type
322
+
323
+ `string`
324
+
325
+ ## commentRedacted
326
+
327
+ redacted version of the comment, null if not redacted
328
+
329
+ `commentRedacted`
330
+
331
+ * is optional
332
+
333
+ * Type: `string`
334
+
335
+ * can be null
336
+
337
+ * defined in: [Casework Representation Schema](applications-representation-properties-commentredacted.md "applications-representation.schema.json#/properties/commentRedacted")
338
+
339
+ ### commentRedacted Type
340
+
341
+ `string`
342
+
343
+ ## representedType
344
+
345
+ When representation is on behalf of a person/org/group
346
+
347
+ `representedType`
348
+
349
+ * is optional
350
+
351
+ * Type: `string`
352
+
353
+ * can be null
354
+
355
+ * defined in: [Casework Representation Schema](applications-representation-properties-representedtype.md "applications-representation.schema.json#/properties/representedType")
356
+
357
+ ### representedType Type
358
+
359
+ `string`
360
+
361
+ ### representedType Constraints
362
+
363
+ **enum**: the value of this property must be equal to one of the following values:
364
+
365
+ | Value | Explanation |
366
+ | :------------------------------------------------------------ | :---------- |
367
+ | `"A person"` | |
368
+ | `"An organisation or charity I work or volunteer for"` | |
369
+ | `"An organisation or charity I do not work or volunteer for"` | |
370
+
371
+ ## representedContact
372
+
373
+ When representation is on behalf of a person/org/group
374
+
375
+ `representedContact`
376
+
377
+ * is optional
378
+
379
+ * Type: `object[]` ([Details](applications-representation-definitions-contact.md))
380
+
381
+ * can be null
382
+
383
+ * defined in: [Casework Representation Schema](applications-representation-properties-representedcontact.md "applications-representation.schema.json#/properties/representedContact")
384
+
385
+ ### representedContact Type
386
+
387
+ `object[]` ([Details](applications-representation-definitions-contact.md))
388
+
389
+ ## representedCategory
390
+
391
+
392
+
393
+ `representedCategory`
394
+
395
+ * is optional
396
+
397
+ * Type: `string`
398
+
399
+ * can be null
400
+
401
+ * defined in: [Casework Representation Schema](applications-representation-properties-representedcategory.md "applications-representation.schema.json#/properties/representedCategory")
402
+
403
+ ### representedCategory Type
404
+
405
+ `string`
406
+
407
+ ### representedCategory Constraints
408
+
409
+ **enum**: the value of this property must be equal to one of the following values:
410
+
411
+ | Value | Explanation |
412
+ | :------------------- | :---------- |
413
+ | `"Consultees"` | |
414
+ | `"Interested party"` | |
415
+
416
+ ## wantsToBeHeard
417
+
418
+ Internal: wants to be heard at a hearing
419
+
420
+ `wantsToBeHeard`
421
+
422
+ * is optional
423
+
424
+ * Type: `boolean`
425
+
426
+ * can be null
427
+
428
+ * defined in: [Casework Representation Schema](applications-representation-properties-wantstobeheard.md "applications-representation.schema.json#/properties/wantsToBeHeard")
429
+
430
+ ### wantsToBeHeard Type
431
+
432
+ `boolean`
433
+
434
+ ## containsAttachments
435
+
436
+ Is a document attached to the representation
437
+
438
+ `containsAttachments`
439
+
440
+ * is optional
441
+
442
+ * Type: `boolean`
443
+
444
+ * can be null
445
+
446
+ * defined in: [Casework Representation Schema](applications-representation-properties-containsattachments.md "applications-representation.schema.json#/properties/containsAttachments")
447
+
448
+ ### containsAttachments Type
449
+
450
+ `boolean`
451
+
452
+ ## sharePointFolderCreated
453
+
454
+ to avoid creating new folders for documents when managing representations
455
+
456
+ `sharePointFolderCreated`
457
+
458
+ * is optional
459
+
460
+ * Type: `boolean`
461
+
462
+ * can be null
463
+
464
+ * defined in: [Casework Representation Schema](applications-representation-properties-sharepointfoldercreated.md "applications-representation.schema.json#/properties/sharePointFolderCreated")
465
+
466
+ ### sharePointFolderCreated Type
467
+
468
+ `boolean`
469
+
470
+ ## distressingContentInRepresentation
471
+
472
+ Flags the representation as containing distressing content
473
+
474
+ `distressingContentInRepresentation`
475
+
476
+ * is optional
477
+
478
+ * Type: `boolean`
479
+
480
+ * can be null
481
+
482
+ * defined in: [Casework Representation Schema](applications-representation-properties-distressingcontentinrepresentation.md "applications-representation.schema.json#/properties/distressingContentInRepresentation")
483
+
484
+ ### distressingContentInRepresentation Type
485
+
486
+ `boolean`
487
+
488
+ ## withdrawalRequestDate
489
+
490
+ Date the representing party requested that the representation be withdrawn
491
+
492
+ `withdrawalRequestDate`
493
+
494
+ * is optional
495
+
496
+ * Type: `string`
497
+
498
+ * can be null
499
+
500
+ * defined in: [Casework Representation Schema](applications-representation-properties-withdrawalrequestdate.md "applications-representation.schema.json#/properties/withdrawalRequestDate")
501
+
502
+ ### withdrawalRequestDate Type
503
+
504
+ `string`
505
+
506
+ ### withdrawalRequestDate Constraints
507
+
508
+ **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")
509
+
510
+ ## withdrawalReason
511
+
512
+ Reason for the withdrawal
513
+
514
+ `withdrawalReason`
515
+
516
+ * is optional
517
+
518
+ * Type: `string`
519
+
520
+ * can be null
521
+
522
+ * defined in: [Casework Representation Schema](applications-representation-properties-withdrawalreason.md "applications-representation.schema.json#/properties/withdrawalReason")
523
+
524
+ ### withdrawalReason Type
525
+
526
+ `string`
527
+
528
+ ### withdrawalReason Constraints
529
+
530
+ **enum**: the value of this property must be equal to one of the following values:
531
+
532
+ | Value | Explanation |
533
+ | :---------------------- | :---------- |
534
+ | `"Change of opinion"` | |
535
+ | `"Mistaken Submission"` | |
536
+ | `"Misunderstanding"` | |
537
+ | `"Personal Reasons"` | |
538
+
539
+ ## dateWithdrawn
540
+
541
+ Date the representation was withdrawn
542
+
543
+ `dateWithdrawn`
544
+
545
+ * is optional
546
+
547
+ * Type: `string`
548
+
549
+ * can be null
550
+
551
+ * defined in: [Casework Representation Schema](applications-representation-properties-datewithdrawn.md "applications-representation.schema.json#/properties/dateWithdrawn")
552
+
553
+ ### dateWithdrawn Type
554
+
555
+ `string`
556
+
557
+ ### dateWithdrawn Constraints
558
+
559
+ **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")
560
+
561
+ ## representationDocuments
562
+
563
+
564
+
565
+ `representationDocuments`
566
+
567
+ * is optional
568
+
569
+ * Type: `object[]` ([Details](applications-representation-definitions-representationdocument.md))
570
+
571
+ * can be null
572
+
573
+ * defined in: [Casework Representation Schema](applications-representation-properties-representationdocuments.md "applications-representation.schema.json#/properties/representationDocuments")
574
+
575
+ ### representationDocuments Type
576
+
577
+ `object[]` ([Details](applications-representation-definitions-representationdocument.md))
578
+
579
+ ## Additional Properties
580
+
581
+ Additional properties are allowed and do not have to follow a specific schema
582
+
583
+ # Casework Representation Schema Definitions
584
+
585
+ ## Definitions group contact
586
+
587
+ Reference this group by using
588
+
589
+ ```json
590
+ {"$ref":"applications-representation.schema.json#/definitions/contact"}
591
+ ```
592
+
593
+ | Property | Type | Required | Nullable | Defined by |
594
+ | :---------------------------------------------------- | :------- | :------- | :------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
595
+ | [contactId](#contactid) | `string` | Required | cannot be null | [Casework Representation Schema](applications-representation-definitions-contact-properties-contactid.md "applications-representation.schema.json#/definitions/contact/properties/contactId") |
596
+ | [contactPreference](#contactpreference) | `string` | Optional | can be null | [Casework Representation Schema](applications-representation-definitions-contact-properties-contactpreference.md "applications-representation.schema.json#/definitions/contact/properties/contactPreference") |
597
+ | [writtenRepOrgName](#writtenreporgname) | `string` | Optional | can be null | [Casework Representation Schema](applications-representation-definitions-contact-properties-writtenreporgname.md "applications-representation.schema.json#/definitions/contact/properties/writtenRepOrgName") |
598
+ | [writtenRepJobTitleorRole](#writtenrepjobtitleorrole) | `string` | Optional | can be null | [Casework Representation Schema](applications-representation-definitions-contact-properties-writtenrepjobtitleorrole.md "applications-representation.schema.json#/definitions/contact/properties/writtenRepJobTitleorRole") |
599
+
600
+ ### contactId
601
+
602
+ Source PK for Contact
603
+
604
+ `contactId`
605
+
606
+ * is required
607
+
608
+ * Type: `string`
609
+
610
+ * cannot be null
611
+
612
+ * defined in: [Casework Representation Schema](applications-representation-definitions-contact-properties-contactid.md "applications-representation.schema.json#/definitions/contact/properties/contactId")
613
+
614
+ #### contactId Type
615
+
616
+ `string`
617
+
618
+ ### contactPreference
619
+
620
+
621
+
622
+ `contactPreference`
623
+
624
+ * is optional
625
+
626
+ * Type: `string`
627
+
628
+ * can be null
629
+
630
+ * defined in: [Casework Representation Schema](applications-representation-definitions-contact-properties-contactpreference.md "applications-representation.schema.json#/definitions/contact/properties/contactPreference")
631
+
632
+ #### contactPreference Type
633
+
634
+ `string`
635
+
636
+ #### contactPreference Constraints
637
+
638
+ **enum**: the value of this property must be equal to one of the following values:
639
+
640
+ | Value | Explanation |
641
+ | :-------- | :---------- |
642
+ | `"email"` | |
643
+ | `"post"` | |
644
+
645
+ ### writtenRepOrgName
646
+
647
+
648
+
649
+ `writtenRepOrgName`
650
+
651
+ * is optional
652
+
653
+ * Type: `string`
654
+
655
+ * can be null
656
+
657
+ * defined in: [Casework Representation Schema](applications-representation-definitions-contact-properties-writtenreporgname.md "applications-representation.schema.json#/definitions/contact/properties/writtenRepOrgName")
658
+
659
+ #### writtenRepOrgName Type
660
+
661
+ `string`
662
+
663
+ ### writtenRepJobTitleorRole
664
+
665
+
666
+
667
+ `writtenRepJobTitleorRole`
668
+
669
+ * is optional
670
+
671
+ * Type: `string`
672
+
673
+ * can be null
674
+
675
+ * defined in: [Casework Representation Schema](applications-representation-definitions-contact-properties-writtenrepjobtitleorrole.md "applications-representation.schema.json#/definitions/contact/properties/writtenRepJobTitleorRole")
676
+
677
+ #### writtenRepJobTitleorRole Type
678
+
679
+ `string`
680
+
681
+ ## Definitions group representationDocument
682
+
683
+ Reference this group by using
684
+
685
+ ```json
686
+ {"$ref":"applications-representation.schema.json#/definitions/representationDocument"}
687
+ ```
688
+
689
+ | Property | Type | Required | Nullable | Defined by |
690
+ | :------------------------------------ | :------- | :------- | :------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
691
+ | [id](#id-1) | `string` | Required | cannot be null | [Casework Representation Schema](applications-representation-definitions-representationdocument-properties-id.md "applications-representation.schema.json#/definitions/representationDocument/properties/id") |
692
+ | [representationId](#representationid) | `string` | Required | cannot be null | [Casework Representation Schema](applications-representation-definitions-representationdocument-properties-representationid.md "applications-representation.schema.json#/definitions/representationDocument/properties/representationId") |
693
+ | [itemId](#itemid) | `string` | Required | cannot be null | [Casework Representation Schema](applications-representation-definitions-representationdocument-properties-itemid.md "applications-representation.schema.json#/definitions/representationDocument/properties/itemId") |
694
+ | [fileName](#filename) | `string` | Required | cannot be null | [Casework Representation Schema](applications-representation-definitions-representationdocument-properties-filename.md "applications-representation.schema.json#/definitions/representationDocument/properties/fileName") |
695
+ | [redactedItemId](#redacteditemid) | `string` | Optional | can be null | [Casework Representation Schema](applications-representation-definitions-representationdocument-properties-redacteditemid.md "applications-representation.schema.json#/definitions/representationDocument/properties/redactedItemId") |
696
+ | [redactedFileName](#redactedfilename) | `string` | Optional | can be null | [Casework Representation Schema](applications-representation-definitions-representationdocument-properties-redactedfilename.md "applications-representation.schema.json#/definitions/representationDocument/properties/redactedFileName") |
697
+ | [status](#status) | `string` | Required | cannot be null | [Casework Representation Schema](applications-representation-definitions-representationdocument-properties-status.md "applications-representation.schema.json#/definitions/representationDocument/properties/status") |
698
+
699
+ ### id
700
+
701
+ Source Key for Representation Document
702
+
703
+ `id`
704
+
705
+ * is required
706
+
707
+ * Type: `string`
708
+
709
+ * cannot be null
710
+
711
+ * defined in: [Casework Representation Schema](applications-representation-definitions-representationdocument-properties-id.md "applications-representation.schema.json#/definitions/representationDocument/properties/id")
712
+
713
+ #### id Type
714
+
715
+ `string`
716
+
717
+ ### representationId
718
+
719
+ The representation this relates to
720
+
721
+ `representationId`
722
+
723
+ * is required
724
+
725
+ * Type: `string`
726
+
727
+ * cannot be null
728
+
729
+ * defined in: [Casework Representation Schema](applications-representation-definitions-representationdocument-properties-representationid.md "applications-representation.schema.json#/definitions/representationDocument/properties/representationId")
730
+
731
+ #### representationId Type
732
+
733
+ `string`
734
+
735
+ ### itemId
736
+
737
+ The id of the item in SharePoint
738
+
739
+ `itemId`
740
+
741
+ * is required
742
+
743
+ * Type: `string`
744
+
745
+ * cannot be null
746
+
747
+ * defined in: [Casework Representation Schema](applications-representation-definitions-representationdocument-properties-itemid.md "applications-representation.schema.json#/definitions/representationDocument/properties/itemId")
748
+
749
+ #### itemId Type
750
+
751
+ `string`
752
+
753
+ ### fileName
754
+
755
+ The name of the file
756
+
757
+ `fileName`
758
+
759
+ * is required
760
+
761
+ * Type: `string`
762
+
763
+ * cannot be null
764
+
765
+ * defined in: [Casework Representation Schema](applications-representation-definitions-representationdocument-properties-filename.md "applications-representation.schema.json#/definitions/representationDocument/properties/fileName")
766
+
767
+ #### fileName Type
768
+
769
+ `string`
770
+
771
+ ### redactedItemId
772
+
773
+ The id of the redacted version of the item in sharepoint
774
+
775
+ `redactedItemId`
776
+
777
+ * is optional
778
+
779
+ * Type: `string`
780
+
781
+ * can be null
782
+
783
+ * defined in: [Casework Representation Schema](applications-representation-definitions-representationdocument-properties-redacteditemid.md "applications-representation.schema.json#/definitions/representationDocument/properties/redactedItemId")
784
+
785
+ #### redactedItemId Type
786
+
787
+ `string`
788
+
789
+ ### redactedFileName
790
+
791
+ the name of the redacted file
792
+
793
+ `redactedFileName`
794
+
795
+ * is optional
796
+
797
+ * Type: `string`
798
+
799
+ * can be null
800
+
801
+ * defined in: [Casework Representation Schema](applications-representation-definitions-representationdocument-properties-redactedfilename.md "applications-representation.schema.json#/definitions/representationDocument/properties/redactedFileName")
802
+
803
+ #### redactedFileName Type
804
+
805
+ `string`
806
+
807
+ ### status
808
+
809
+ The status of the document
810
+
811
+ `status`
812
+
813
+ * is required
814
+
815
+ * Type: `string`
816
+
817
+ * cannot be null
818
+
819
+ * defined in: [Casework Representation Schema](applications-representation-definitions-representationdocument-properties-status.md "applications-representation.schema.json#/definitions/representationDocument/properties/status")
820
+
821
+ #### status Type
822
+
823
+ `string`
824
+
825
+ #### status Constraints
826
+
827
+ **enum**: the value of this property must be equal to one of the following values:
828
+
829
+ | Value | Explanation |
830
+ | :------------------ | :---------- |
831
+ | `"Awaiting review"` | |
832
+ | `"Accepted"` | |
833
+ | `"Rejected"` | |
834
+ | `"Withdrawn"` | |