@insurance-broker/api-client 2.16.0 → 2.17.0

package/dist/schema.d.ts

@@ -4526,7 +4526,7 @@ export interface paths {
          *
          *     **`Declined` and `ChangesRequested` change nothing about your cover.** They are recorded for your broker to act on, they satisfy no condition, and they do not end your policy: concluding a renewal is your broker's act, because it expires cover that is still in force. Either may carry one short `note` saying what needs to change.
          *
-         *     Sending the same answer twice reads the first one back rather than recording it twice, so a lost response or a double tap is safe. You may ask for changes and confirm later; you cannot un-say an answer, and a renewal your broker has already concluded is refused.
+         *     Sending the same answer twice - the same `note` too, ignoring surrounding spaces - reads the first one back rather than recording it twice, so a lost response or a double tap is safe. The same answer with a different `note` is refused with a `409`: your broker already has your answer, and changing or adding to it is done with them. You may ask for changes and confirm later; you cannot un-say an answer, and a renewal your broker has already concluded is refused.
          */
         post: operations["RespondToCustomerRenewal"];
         delete?: never;
@@ -4562,7 +4562,14 @@ export interface paths {
         /** The broker's quote requests, newest first, one page at a time. */
         get: operations["ListQuoteRequests"];
         put?: never;
-        /** Raises a quote request against a submitted form. */
+        /**
+         * Raises a quote request against a submitted form.
+         * @description QTE-001. Raises a quote request from a submitted form on the customer's behalf; the product, the owner and the risk details all come from the form and never from this request.
+         *
+         *     **A `409` here is one of three things, and `type` is what tells them apart** (#430). `urn:brokerplatform:problem:quote-already-requested` means an active request already exists against this form and it is named in `quoteRequestId`, so open that one rather than showing the sentence in `detail`. `urn:brokerplatform:problem:product-not-open-to-new-business` means the product is not open to new business, so there is nothing to open and nothing to retry. `urn:brokerplatform:problem:concurrency-conflict` means somebody wrote first; read again and retry.
+         *
+         *     **A `422` is `urn:brokerplatform:problem:unquotable-submission`**, and its `violations` say why: `submission-not-submitted` covers a draft, another broker's form and a form that does not exist, deliberately as one; `submission-has-no-customer` is its own code because the fix is different.
+         */
         post: operations["RaiseQuoteRequest"];
         delete?: never;
         options?: never;
@@ -5031,7 +5038,14 @@ export interface paths {
         /** Lists the caller's own quote requests, newest first. */
         get: operations["ListCustomerQuotes"];
         put?: never;
-        /** Asks the broker for a quote against one of the caller's submitted forms. */
+        /**
+         * Asks the broker for a quote against one of the caller's submitted forms.
+         * @description QTE-001. Raises a quote request from one of your submitted forms; the product, the owner and the risk details all come from the form and never from this request.
+         *
+         *     **A `409` here is one of three things, and `type` is what tells them apart** (#430). `urn:brokerplatform:problem:quote-already-requested` means a request is already open against this form and the one to resume is named in `quoteRequestId`, so open that one rather than showing the sentence in `detail`. `urn:brokerplatform:problem:product-not-open-to-new-business` means the product is no longer offered, so there is nothing to open and nothing to retry. `urn:brokerplatform:problem:concurrency-conflict` means somebody wrote first; read again and retry.
+         *
+         *     **A `422` is `urn:brokerplatform:problem:unquotable-submission`**: the form is a draft, is not yours, or does not exist — one refusal for all three, so this route cannot be used to discover which forms exist. Its `violations` name the form.
+         */
         post: operations["RaiseCustomerQuote"];
         delete?: never;
         options?: never;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@insurance-broker/api-client",
-  "version": "2.16.0",
+  "version": "2.17.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,