@insurance-broker/api-client 1.26.0 → 1.27.0

package/dist/schema.d.ts

@@ -1197,6 +1197,128 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/claims/{id}/outstanding-items": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Read what a claim is or was waiting on
+         * @description CLM-005. Everything recorded as outstanding on this claim, newest raised first.
+         *
+         *     `outstanding=true` narrows it to what is still being waited on - the operational question, *what is holding this up* - and `outstanding=false` to what has arrived. Absent, the whole history comes back.
+         *
+         *     Ordered on when an item was **raised** and never on when it was resolved: the list is a history, and ordering on a column that changes moves the boundaries under a reader.
+         *
+         *     **Staff only.** A customer is told what you need from them by being told, on their timeline, in words you chose - not by being handed the working list, which also names everything you owe.
+         */
+        get: operations["ListClaimOutstandingItems"];
+        put?: never;
+        /**
+         * Record that a claim is waiting on something
+         * @description CLM-005. Records what this claim is waiting on, and which side owes it.
+         *
+         *     **This creates a row and never changes the claim's status.** A claim waiting on a customer's photographs is still `Notified`, because the broker is still assisting - which is what that status says (ADR-0041 section 5). A status could not have said *what* is outstanding in any case, which is the other half of why this is a row.
+         *
+         *     **What is outstanding is your own words, not a code from a list.** This platform does not name insurance fields, so there is no vocabulary of permitted items and there will not be one; a broker's own list of the things it asks for is that broker's configuration.
+         *
+         *     **The side is a closed set of two.** `Customer` means the customer owes it and you are waiting on them. `Broker` means you owe it - including when it is your insurer who is waiting. If you in turn need something from the customer to produce it, that is a second item, because it is a different wait with a different person to chase.
+         *
+         *     Refused with 409 once the claim has concluded: nobody is waiting on a claim you have stopped working, and closing starts the disposal clock on everything filed against it.
+         */
+        post: operations["RaiseClaimOutstandingItem"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/claims/{id}/outstanding-items/{itemId}/resolution": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Record that what a claim was waiting on has arrived
+         * @description CLM-005. Marks one outstanding item as received, naming you and the instant.
+         *
+         *     **This is allowed after the claim has concluded**, which is the one place this surface differs from everything else that hangs off a claim. Filing evidence or recording a dealing with an insurer against a closed claim is refused, because both write a row that would carry no disposal clock. This writes no row - it stamps two columns on one that already has a clock - and a police report that arrives in January against a claim closed in December is a fact the record may not be made to deny.
+         *
+         *     A second resolution is refused with 409 naming who dealt with it. Somebody read the item outstanding and decided from it, and overwriting their name would lose the only record of who did the work. Nothing here edits the description or moves the side: correcting a mistake is resolving the wrong item and raising the right one, which is what happened.
+         */
+        post: operations["ResolveClaimOutstandingItem"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/claims/{id}/appointments": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Read the visits arranged about a claim
+         * @description CLM-005. Every visit recorded against this claim, soonest first, cancelled ones included and marked as such - a diary is read forwards, and a visit that was called off is part of the account of how the claim went.
+         *
+         *     **Staff only**, for the same reason the outstanding items are.
+         */
+        get: operations["ListClaimAppointments"];
+        put?: never;
+        /**
+         * Record a visit arranged about a claim
+         * @description CLM-005. Records that somebody is expected - an assessor, a repairer, a surveyor - and when.
+         *
+         *     **There is no appointment type and no provider directory, and that is deliberate.** This platform does not name a trade, a service or a provider on behalf of every broker in every country it serves (ADR-0041 section 6). What the visit is for, and who is coming if you want that written down, is `purpose` - your own words.
+         *
+         *     **The time may be in the past**, so last week's visit can be written up on Friday. It is an instant rather than a day, because the time of day is the operative fact about a visit.
+         *
+         *     **Nothing here is a status on the claim.** A claim with an assessor booked is still `Notified`.
+         *
+         *     **There is no reschedule.** Moving a visit is cancelling one and arranging another, which is what actually happened and what a customer told twice experienced; a date that could be edited would leave nothing saying anybody was ever expected on the first day.
+         *
+         *     Refused with 409 once the claim has concluded.
+         */
+        post: operations["ArrangeClaimAppointment"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/claims/{id}/appointments/{appointmentId}/cancellation": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Record that a visit was called off
+         * @description CLM-005. Marks one appointment cancelled, naming you and the instant.
+         *
+         *     **Allowed after the claim has concluded**, for the same reason resolving an outstanding item is: it writes no row, and an assessor stood down in January for a claim closed in December is a thing that happened.
+         *
+         *     A second cancellation is refused with 409. There is no reason field - why a visit was called off is a note, and who did it and when is on the row and in the audit trail.
+         */
+        post: operations["CancelClaimAppointment"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/customer/claims": {
         parameters: {
             query?: never;
@@ -3271,6 +3393,11 @@ export interface components {
             insurerId: null | string;
             channel: null | string;
         };
+        ArrangeClaimAppointmentRequest: {
+            /** Format: date-time */
+            scheduledAtUtc: string;
+            purpose: string;
+        };
         AskAboutQuoteRequest: {
             /** Format: uuid */
             presentationVersionId: null | string;
@@ -3317,6 +3444,22 @@ export interface components {
             items: components["schemas"]["ProductResponse"][];
             nextCursor: null | string;
         };
+        ClaimAppointmentResponse: {
+            /** Format: uuid */
+            id: string;
+            /** Format: uuid */
+            claimId: string;
+            /** Format: date-time */
+            scheduledAtUtc: string;
+            purpose: string;
+            arrangedBySubjectId: string;
+            /** Format: date-time */
+            arrangedAtUtc: string;
+            cancelledBySubjectId: null | string;
+            /** Format: date-time */
+            cancelledAtUtc: null | string;
+            isCancelled: boolean;
+        };
         ClaimEvidenceResponse: {
             /** Format: uuid */
             id: string;
@@ -3351,6 +3494,21 @@ export interface components {
             /** Format: date-time */
             publishedAtUtc: null | string;
         };
+        ClaimOutstandingItemResponse: {
+            /** Format: uuid */
+            id: string;
+            /** Format: uuid */
+            claimId: string;
+            awaitedFrom: string;
+            description: string;
+            raisedBySubjectId: string;
+            /** Format: date-time */
+            raisedAtUtc: string;
+            resolvedBySubjectId: null | string;
+            /** Format: date-time */
+            resolvedAtUtc: null | string;
+            isOutstanding: boolean;
+        };
         ClaimResponse: {
             /** Format: uuid */
             id: string;
@@ -4408,6 +4566,10 @@ export interface components {
             /** Format: date-time */
             declinedAtUtc: null | string;
         };
+        RaiseClaimOutstandingItemRequest: {
+            awaitedFrom: string;
+            description: string;
+        };
         RaiseOutstandingItemRequest: {
             awaitedFrom: null | string;
             description: null | string;
@@ -7930,6 +8092,255 @@ export interface operations {
             };
         };
     };
+    ListClaimOutstandingItems: {
+        parameters: {
+            query?: {
+                outstanding?: boolean;
+            };
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ClaimOutstandingItemResponse"][];
+                };
+            };
+            /** @description Bad Request */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["HttpValidationProblemDetails"];
+                };
+            };
+            /** @description Not Found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    RaiseClaimOutstandingItem: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["RaiseClaimOutstandingItemRequest"];
+            };
+        };
+        responses: {
+            /** @description Created */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ClaimOutstandingItemResponse"];
+                };
+            };
+            /** @description Bad Request */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["HttpValidationProblemDetails"];
+                };
+            };
+            /** @description Not Found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Conflict */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ProblemDetails"];
+                };
+            };
+        };
+    };
+    ResolveClaimOutstandingItem: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+                itemId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ClaimOutstandingItemResponse"];
+                };
+            };
+            /** @description Not Found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Conflict */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ProblemDetails"];
+                };
+            };
+        };
+    };
+    ListClaimAppointments: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ClaimAppointmentResponse"][];
+                };
+            };
+            /** @description Not Found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    ArrangeClaimAppointment: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ArrangeClaimAppointmentRequest"];
+            };
+        };
+        responses: {
+            /** @description Created */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ClaimAppointmentResponse"];
+                };
+            };
+            /** @description Bad Request */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["HttpValidationProblemDetails"];
+                };
+            };
+            /** @description Not Found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Conflict */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ProblemDetails"];
+                };
+            };
+        };
+    };
+    CancelClaimAppointment: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+                appointmentId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ClaimAppointmentResponse"];
+                };
+            };
+            /** @description Not Found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Conflict */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ProblemDetails"];
+                };
+            };
+        };
+    };
     ReportOwnClaim: {
         parameters: {
             query?: never;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@insurance-broker/api-client",
-  "version": "1.26.0",
+  "version": "1.27.0",
   "description": "Generated TypeScript client for the Insurance Broker Platform API. Do not edit by hand: regenerate with scripts/update-api-contract.",
   "license": "UNLICENSED",
   "private": false,