@djust-b2b/djust-front-sdk 1.11.1 → 1.13.0

package/lib/services/incident/definitions.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/services/incident/index.d.ts

@@ -0,0 +1,222 @@
+import { getOrderLogisticIncidentsParameters, getOrderLogisticIncidentParameters, getOrderLogisticLineIncidentsParameters, createOrderLogisticIncidentParameters, createOrderLogisticLineIncidentParameters, getCustomerAccountIncidentsParameters, getOrderLogisticIncidentsResponse, getOrderLogisticIncidentResponse, getOrderLogisticLineIncidentsResponse, createOrderLogisticIncidentResponse, createOrderLogisticLineIncidentResponse, getCustomerAccountIncidentsResponse } from "./definitions";
+/**
+ * 🚚 Fetches logistic order incidents.
+ *
+ * This function retrieves a paginated list of incidents for a specific logistic order,
+ * filtered by status and other parameters. The `logisticOrderId` parameter is mandatory
+ * and validated before the request is executed.
+ *
+ * 🛠 **Endpoint**: `GET /v1/shop/logistic-orders/{logisticOrderId}/incidents [ORDER-557]`
+ *
+ * | Parameter         | Type                            | Required   | Description                              |
+ * |-------------------|---------------------------------|------------|------------------------------------------|
+ * | `logisticOrderId` | `string`                       | ✅         | The ID of the logistic order to fetch incidents for. |
+ * | `status`          | `IncidentStatus[]`             | ❌         | Array of statuses to filter incidents (e.g., `["OPEN"]`). |
+ * | `idType`          | `IncidentIdType`               | ❌         | Specifies whether the ID is internal (`DJUST_ID`) or external (`EXTERNAL_ID`). |
+ * | `page`            | `number`                       | ❌         | The page number for pagination.          |
+ * | `size`            | `number`                       | ❌         | The number of results per page.          |
+ * | `sort`            | `String[]`                    | ❌         | Sorting criteria (e.g., `["createdAt,desc"]`). |
+ *
+ * 📤 **Returns**:
+ * A `Promise` resolving to an array of `IncidentDto` objects representing the incidents.
+ *
+ * 🛠 **Example usage**:
+ * ```ts
+ * const incidents = await getOrderLogisticIncidents({
+ *   logisticOrderId: "12345",
+ *   status: ["OPEN", "CLOSED"],
+ *   idType: "EXTERNAL_ID",
+ *   page: 1,
+ *   size: 10,
+ *   sort: ["createdAt,desc"],
+ * });
+ * ```
+ *
+ * @param {getOrderLogisticIncidentsParameters} params - The parameters for the request.
+ * @throws {Error} If `logisticOrderId` is missing.
+ * @returns {Promise<getOrderLogisticIncidentsResponse>} A promise resolving to the response containing the incidents.
+ */
+export declare function getOrderLogisticIncidents({ logisticOrderId, status, idType, page, size, sort, }: getOrderLogisticIncidentsParameters): Promise<getOrderLogisticIncidentsResponse>;
+/**
+ * 🚚 Fetches a specific logistic order incident.
+ *
+ * This function retrieves a specific incident for a logistic order, identified by both
+ * the `logisticOrderId` and `incidentId`. Both parameters are mandatory and validated
+ * before the request is executed.
+ *
+ * 🛠 **Endpoint**: `GET /v1/shop/logistic-orders/{logisticOrderId}/incidents/{incidentId} [ORDER-503]`
+ *
+ * | Parameter         | Type                            | Required   | Description                              |
+ * |-------------------|---------------------------------|------------|------------------------------------------|
+ * | `logisticOrderId` | `string`                       | ✅         | The ID of the logistic order to fetch the incident for. |
+ * | `incidentId`      | `string`                       | ✅         | The ID of the specific incident to fetch. |
+ * | `idType`          | `IncidentIdType`               | ❌         | Specifies whether the ID is internal (`DJUST_ID`) or external (`EXTERNAL_ID`). |
+ *
+ * 📤 **Returns**:
+ * A `Promise` resolving to a single `getOrderLogisticIncidentResponse` object representing the incident.
+ *
+ * 🛠 **Example usage**:
+ * ```ts
+ * const incident = await getOrderLogisticIncident({
+ *   logisticOrderId: "12345",
+ *   incidentId: "incident_1",
+ *   idType: "EXTERNAL_ID",
+ * });
+ * ```
+ *
+ * @param {getOrderLogisticIncidentParameters} params - The parameters for the request.
+ * @throws {Error} If `logisticOrderId` or `incidentId` is missing.
+ * @returns {Promise<getOrderLogisticIncidentResponse>} A promise resolving to the response containing the incident.
+ */
+export declare function getOrderLogisticIncident({ logisticOrderId, incidentId, idType, }: getOrderLogisticIncidentParameters): Promise<getOrderLogisticIncidentResponse>;
+/**
+ * 🚚 Fetches incidents for a specific line of a logistic order.
+ *
+ * This function retrieves a list of incidents for a specific line in a logistic order,
+ * filtered by status and other parameters. The `logisticOrderId` and `lineId` parameters
+ * are mandatory and validated before the request is executed.
+ *
+ * 🛠 **Endpoint**: `GET /v1/shop/logistic-orders/{logisticOrderId}/incidents/lines/{lineId} [ORDER-559]`
+ *
+ * | Parameter         | Type                            | Required   | Description                              |
+ * |-------------------|---------------------------------|------------|------------------------------------------|
+ * | `logisticOrderId` | `string`                       | ✅         | The ID of the logistic order to fetch incidents for. |
+ * | `lineId`          | `string`                       | ✅         | The ID of the line in the logistic order to fetch incidents for. |
+ * | `status`          | `IncidentStatus[]`             | ❌         | Array of statuses to filter incidents (e.g., `["OPEN"]`). |
+ * | `idType`          | `IncidentIdType`               | ❌         | Specifies whether the ID is internal (`DJUST_ID`) or external (`EXTERNAL_ID`). |
+ * | `page`            | `number`                       | ❌         | The page number for pagination.          |
+ * | `size`            | `number`                       | ❌         | The number of results per page.          |
+ * | `sort`            | `String[]`                     | ❌         | Sorting criteria (e.g., `["createdAt,desc"]`). |
+ *
+ * 📤 **Returns**:
+ * A `Promise` resolving to an array of `getOrderLogisticLineIncidentsResponse` objects representing the incidents.
+ *
+ * 🛠 **Example usage**:
+ * ```ts
+ * const incidents = await getOrderLogisticLineIncidents({
+ *   logisticOrderId: "12345",
+ *   lineId: "line_1",
+ *   status: ["OPEN"],
+ *   idType: "EXTERNAL_ID",
+ *   page: 1,
+ *   size: 10,
+ *   sort: ["createdAt,desc"],
+ * });
+ * ```
+ *
+ * @param {getOrderLogisticLineIncidentsParameters} params - The parameters for the request.
+ * @throws {Error} If `logisticOrderId` or `lineId` is missing.
+ * @returns {Promise<getOrderLogisticLineIncidentsResponse>} A promise resolving to the response containing the incidents.
+ */
+export declare function getOrderLogisticLineIncidents({ logisticOrderId, lineId, status, idType, page, size, sort, }: getOrderLogisticLineIncidentsParameters): Promise<getOrderLogisticLineIncidentsResponse>;
+/**
+ * 🚚 Creates a new incident for a specific logistic order.
+ *
+ * This function allows the creation of an incident for a given logistic order,
+ * requiring essential parameters like the `logisticOrderId` and `reasonCode`.
+ * The `customField` and `idType` are used to provide additional information for the incident creation.
+ *
+ * 🛠 **Endpoint**: `POST /v1/shop/logistic-orders/{logisticOrderId}/incidents [ORDER-101]`
+ *
+ * | Parameter        | Type                                | Required   | Description                                              |
+ * |------------------|-------------------------------------|------------|----------------------------------------------------------|
+ * | `logisticOrderId`| `string`                            | ✅         | The ID of the logistic order for which the incident is created. |
+ * | `idType`         | `IncidentIdType`                    | ❌         | The type of incident ID (e.g., `DJUST_ID`, `EXTERNAL_ID`). |
+ * | `customField`    | `{ customFieldValues: CustomFieldValueRequest[], idType: IncidentIdType }` | ❌         | The custom field data for the incident, including custom field values and ID type. |
+ * | `reasonCode`     | `string[]`                          | ✅         | The reason codes for the incident (e.g., `["PRODUCT_DEFECT"]`). |
+ *
+ * 📤 **Returns**:
+ * A `Promise` resolving to a `createOrderLogisticIncidentResponse` object,
+ * containing the `incidentId` and `externalId` of the created incident.
+ *
+ * 🛠 **Example usage**:
+ * ```ts
+ * const incident = await createOrderLogisticIncident({
+ *   logisticOrderId: "12345",
+ *   idType: "EXTERNAL_ID",
+ *   customField: { customFieldValues: [], idType: "EXTERNAL_ID" },
+ *   reasonCode: ["PRODUCT_DEFECT"]
+ * });
+ * ```
+ *
+ * @param {createOrderLogisticIncidentParameters} params - The parameters for creating the incident.
+ * @throws {Error} If `logisticOrderId` or `reasonCode` is missing.
+ * @returns {Promise<createOrderLogisticIncidentResponse>} A promise resolving to the response containing the created incident's details.
+ */
+export declare function createOrderLogisticIncident({ logisticOrderId, idType, customField, reasonCode, }: createOrderLogisticIncidentParameters): Promise<createOrderLogisticIncidentResponse>;
+/**
+ * 🚚 Creates a new incident for a specific line within a logistic order.
+ *
+ * This function allows the creation of an incident for one or more lines within a logistic order.
+ * The `logisticOrderId`, `reasonCode`, and `orderLines` are required parameters.
+ * The `customFieldIdType` and `idType` are used for specifying additional information about the incident.
+ *
+ * 🛠 **Endpoint**: `POST /v1/shop/logistic-orders/{logisticOrderId}/lines/incidents [ORDER-102]`
+ *
+ * | Parameter          | Type                                | Required   | Description                                              |
+ * |--------------------|-------------------------------------|------------|----------------------------------------------------------|
+ * | `logisticOrderId`  | `string`                            | ✅         | The ID of the logistic order for which the line incident is created. |
+ * | `idType`           | `IncidentIdType`                    | ❌         | The type of incident ID (e.g., `DJUST_ID`, `EXTERNAL_ID`). |
+ * | `customFieldIdType`| `IncidentIdType`                    | ❌         | The ID type for custom field values (e.g., `EXTERNAL_ID`). |
+ * | `orderLines`       | `{ customFieldValues: CustomFieldValueRequest[], lineId: string, quantity: number }[]` | ✅         | An array of objects describing the order lines, including custom field values, line ID, and quantity. |
+ * | `reasonCode`       | `string[]`                          | ✅         | The reason codes for the incident (e.g., `["PRODUCT_DEFECT"]`). |
+ *
+ * 📤 **Returns**:
+ * A `Promise` resolving to a `createOrderLogisticLineIncidentResponse` object,
+ * containing the `incidentId` and `externalId` of the created incident.
+ *
+ * 🛠 **Example usage**:
+ * ```ts
+ * const incident = await createOrderLogisticLineIncident({
+ *   logisticOrderId: "12345",
+ *   idType: "EXTERNAL_ID",
+ *   customFieldIdType: "DJUST_ID",
+ *   orderLines: [
+ *     { customFieldValues: [], lineId: "line_1", quantity: 2 }
+ *   ],
+ *   reasonCode: ["PRODUCT_DEFECT"]
+ * });
+ * ```
+ *
+ * @param {createOrderLogisticLineIncidentParameters} params - The parameters for creating the incident.
+ * @throws {Error} If `logisticOrderId`, `reasonCode`, or `orderLines` is missing.
+ * @returns {Promise<createOrderLogisticLineIncidentResponse>} A promise resolving to the response containing the created incident's details.
+ */
+export declare function createOrderLogisticLineIncident({ logisticOrderId, idType, customFieldIdType, orderLines, reasonCode, }: createOrderLogisticLineIncidentParameters): Promise<createOrderLogisticLineIncidentResponse>;
+/**
+ * 🧑‍💼 Fetches incidents for a specific customer account.
+ *
+ * This function retrieves incidents associated with a particular customer account,
+ * using parameters such as `status`, `page`, `size`, and `sort` to filter and paginate the results.
+ * The `customerAccountId` is a mandatory parameter and is validated before making the request.
+ *
+ * 🛠 **Endpoint**: `GET /v1/shop/customer-accounts/{customerAccountId}/incidents [ACCOUNT-551]`
+ *
+ * | Parameter         | Type                            | Required   | Description                              |
+ * |-------------------|---------------------------------|------------|------------------------------------------|
+ * | `customerAccountId`| `string`                       | ✅         | The ID of the customer account for which incidents are to be fetched. |
+ * | `status`          | `IncidentStatus[]`             | ❌         | Array of statuses to filter incidents by (e.g., `["OPEN"]`). |
+ * | `page`            | `number`                       | ❌         | The page number for pagination.          |
+ * | `size`            | `number`                       | ❌         | The number of results per page.          |
+ * | `sort`            | `string[]`                     | ❌         | Sorting criteria (e.g., `["createdAt,desc"]`). |
+ *
+ * 📤 **Returns**:
+ * A `Promise` resolving to an array of `getCustomerAccountIncidentsResponse` objects,
+ * representing the incidents for the given customer account.
+ *
+ * 🛠 **Example usage**:
+ * ```ts
+ * const incidents = await getCustomerAccountIncidents({
+ *   customerAccountId: "98765",
+ *   status: ["OPEN"],
+ *   page: 1,
+ *   size: 10,
+ *   sort: ["createdAt,desc"],
+ * });
+ * ```
+ *
+ * @param {getCustomerAccountIncidentsParameters} params - The parameters for the request.
+ * @throws {Error} If `customerAccountId` is missing.
+ * @returns {Promise<getCustomerAccountIncidentsResponse>} A promise resolving to the incidents response.
+ */
+export declare function getCustomerAccountIncidents({ customerAccountId, status, page, size, sort, }: getCustomerAccountIncidentsParameters): Promise<getCustomerAccountIncidentsResponse>;

package/lib/services/incident/index.js

@@ -0,0 +1,311 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getOrderLogisticIncidents = getOrderLogisticIncidents;
+exports.getOrderLogisticIncident = getOrderLogisticIncident;
+exports.getOrderLogisticLineIncidents = getOrderLogisticLineIncidents;
+exports.createOrderLogisticIncident = createOrderLogisticIncident;
+exports.createOrderLogisticLineIncident = createOrderLogisticLineIncident;
+exports.getCustomerAccountIncidents = getCustomerAccountIncidents;
+const parameters_validation_1 = require("../../helpers/parameters-validation");
+const fetch_instance_1 = require("../../settings/fetch-instance");
+/**
+ * 🚚 Fetches logistic order incidents.
+ *
+ * This function retrieves a paginated list of incidents for a specific logistic order,
+ * filtered by status and other parameters. The `logisticOrderId` parameter is mandatory
+ * and validated before the request is executed.
+ *
+ * 🛠 **Endpoint**: `GET /v1/shop/logistic-orders/{logisticOrderId}/incidents [ORDER-557]`
+ *
+ * | Parameter         | Type                            | Required   | Description                              |
+ * |-------------------|---------------------------------|------------|------------------------------------------|
+ * | `logisticOrderId` | `string`                       | ✅         | The ID of the logistic order to fetch incidents for. |
+ * | `status`          | `IncidentStatus[]`             | ❌         | Array of statuses to filter incidents (e.g., `["OPEN"]`). |
+ * | `idType`          | `IncidentIdType`               | ❌         | Specifies whether the ID is internal (`DJUST_ID`) or external (`EXTERNAL_ID`). |
+ * | `page`            | `number`                       | ❌         | The page number for pagination.          |
+ * | `size`            | `number`                       | ❌         | The number of results per page.          |
+ * | `sort`            | `String[]`                    | ❌         | Sorting criteria (e.g., `["createdAt,desc"]`). |
+ *
+ * 📤 **Returns**:
+ * A `Promise` resolving to an array of `IncidentDto` objects representing the incidents.
+ *
+ * 🛠 **Example usage**:
+ * ```ts
+ * const incidents = await getOrderLogisticIncidents({
+ *   logisticOrderId: "12345",
+ *   status: ["OPEN", "CLOSED"],
+ *   idType: "EXTERNAL_ID",
+ *   page: 1,
+ *   size: 10,
+ *   sort: ["createdAt,desc"],
+ * });
+ * ```
+ *
+ * @param {getOrderLogisticIncidentsParameters} params - The parameters for the request.
+ * @throws {Error} If `logisticOrderId` is missing.
+ * @returns {Promise<getOrderLogisticIncidentsResponse>} A promise resolving to the response containing the incidents.
+ */
+async function getOrderLogisticIncidents({ logisticOrderId, status, idType, page, size, sort, }) {
+    (0, parameters_validation_1.required)({ logisticOrderId });
+    const { data } = await (0, fetch_instance_1.enhancedFetch)({
+        method: "GET",
+        path: `/v1/shop/logistic-orders/${logisticOrderId}/incidents`,
+        params: {
+            status,
+            idType,
+            page,
+            size,
+            sort,
+        },
+    });
+    return data;
+}
+/**
+ * 🚚 Fetches a specific logistic order incident.
+ *
+ * This function retrieves a specific incident for a logistic order, identified by both
+ * the `logisticOrderId` and `incidentId`. Both parameters are mandatory and validated
+ * before the request is executed.
+ *
+ * 🛠 **Endpoint**: `GET /v1/shop/logistic-orders/{logisticOrderId}/incidents/{incidentId} [ORDER-503]`
+ *
+ * | Parameter         | Type                            | Required   | Description                              |
+ * |-------------------|---------------------------------|------------|------------------------------------------|
+ * | `logisticOrderId` | `string`                       | ✅         | The ID of the logistic order to fetch the incident for. |
+ * | `incidentId`      | `string`                       | ✅         | The ID of the specific incident to fetch. |
+ * | `idType`          | `IncidentIdType`               | ❌         | Specifies whether the ID is internal (`DJUST_ID`) or external (`EXTERNAL_ID`). |
+ *
+ * 📤 **Returns**:
+ * A `Promise` resolving to a single `getOrderLogisticIncidentResponse` object representing the incident.
+ *
+ * 🛠 **Example usage**:
+ * ```ts
+ * const incident = await getOrderLogisticIncident({
+ *   logisticOrderId: "12345",
+ *   incidentId: "incident_1",
+ *   idType: "EXTERNAL_ID",
+ * });
+ * ```
+ *
+ * @param {getOrderLogisticIncidentParameters} params - The parameters for the request.
+ * @throws {Error} If `logisticOrderId` or `incidentId` is missing.
+ * @returns {Promise<getOrderLogisticIncidentResponse>} A promise resolving to the response containing the incident.
+ */
+async function getOrderLogisticIncident({ logisticOrderId, incidentId, idType, }) {
+    (0, parameters_validation_1.required)({ logisticOrderId, incidentId });
+    const { data } = await (0, fetch_instance_1.enhancedFetch)({
+        method: "GET",
+        path: `/v1/shop/logistic-orders/${logisticOrderId}/incidents/${incidentId}`,
+        params: {
+            idType,
+        },
+    });
+    return data;
+}
+/**
+ * 🚚 Fetches incidents for a specific line of a logistic order.
+ *
+ * This function retrieves a list of incidents for a specific line in a logistic order,
+ * filtered by status and other parameters. The `logisticOrderId` and `lineId` parameters
+ * are mandatory and validated before the request is executed.
+ *
+ * 🛠 **Endpoint**: `GET /v1/shop/logistic-orders/{logisticOrderId}/incidents/lines/{lineId} [ORDER-559]`
+ *
+ * | Parameter         | Type                            | Required   | Description                              |
+ * |-------------------|---------------------------------|------------|------------------------------------------|
+ * | `logisticOrderId` | `string`                       | ✅         | The ID of the logistic order to fetch incidents for. |
+ * | `lineId`          | `string`                       | ✅         | The ID of the line in the logistic order to fetch incidents for. |
+ * | `status`          | `IncidentStatus[]`             | ❌         | Array of statuses to filter incidents (e.g., `["OPEN"]`). |
+ * | `idType`          | `IncidentIdType`               | ❌         | Specifies whether the ID is internal (`DJUST_ID`) or external (`EXTERNAL_ID`). |
+ * | `page`            | `number`                       | ❌         | The page number for pagination.          |
+ * | `size`            | `number`                       | ❌         | The number of results per page.          |
+ * | `sort`            | `String[]`                     | ❌         | Sorting criteria (e.g., `["createdAt,desc"]`). |
+ *
+ * 📤 **Returns**:
+ * A `Promise` resolving to an array of `getOrderLogisticLineIncidentsResponse` objects representing the incidents.
+ *
+ * 🛠 **Example usage**:
+ * ```ts
+ * const incidents = await getOrderLogisticLineIncidents({
+ *   logisticOrderId: "12345",
+ *   lineId: "line_1",
+ *   status: ["OPEN"],
+ *   idType: "EXTERNAL_ID",
+ *   page: 1,
+ *   size: 10,
+ *   sort: ["createdAt,desc"],
+ * });
+ * ```
+ *
+ * @param {getOrderLogisticLineIncidentsParameters} params - The parameters for the request.
+ * @throws {Error} If `logisticOrderId` or `lineId` is missing.
+ * @returns {Promise<getOrderLogisticLineIncidentsResponse>} A promise resolving to the response containing the incidents.
+ */
+async function getOrderLogisticLineIncidents({ logisticOrderId, lineId, status, idType, page, size, sort, }) {
+    (0, parameters_validation_1.required)({ logisticOrderId, lineId });
+    const { data } = await (0, fetch_instance_1.enhancedFetch)({
+        method: "GET",
+        path: `/v1/shop/logistic-orders/${logisticOrderId}/incidents/lines/${lineId}`,
+        params: {
+            status,
+            idType,
+            page,
+            size,
+            sort,
+        },
+    });
+    return data;
+}
+/**
+ * 🚚 Creates a new incident for a specific logistic order.
+ *
+ * This function allows the creation of an incident for a given logistic order,
+ * requiring essential parameters like the `logisticOrderId` and `reasonCode`.
+ * The `customField` and `idType` are used to provide additional information for the incident creation.
+ *
+ * 🛠 **Endpoint**: `POST /v1/shop/logistic-orders/{logisticOrderId}/incidents [ORDER-101]`
+ *
+ * | Parameter        | Type                                | Required   | Description                                              |
+ * |------------------|-------------------------------------|------------|----------------------------------------------------------|
+ * | `logisticOrderId`| `string`                            | ✅         | The ID of the logistic order for which the incident is created. |
+ * | `idType`         | `IncidentIdType`                    | ❌         | The type of incident ID (e.g., `DJUST_ID`, `EXTERNAL_ID`). |
+ * | `customField`    | `{ customFieldValues: CustomFieldValueRequest[], idType: IncidentIdType }` | ❌         | The custom field data for the incident, including custom field values and ID type. |
+ * | `reasonCode`     | `string[]`                          | ✅         | The reason codes for the incident (e.g., `["PRODUCT_DEFECT"]`). |
+ *
+ * 📤 **Returns**:
+ * A `Promise` resolving to a `createOrderLogisticIncidentResponse` object,
+ * containing the `incidentId` and `externalId` of the created incident.
+ *
+ * 🛠 **Example usage**:
+ * ```ts
+ * const incident = await createOrderLogisticIncident({
+ *   logisticOrderId: "12345",
+ *   idType: "EXTERNAL_ID",
+ *   customField: { customFieldValues: [], idType: "EXTERNAL_ID" },
+ *   reasonCode: ["PRODUCT_DEFECT"]
+ * });
+ * ```
+ *
+ * @param {createOrderLogisticIncidentParameters} params - The parameters for creating the incident.
+ * @throws {Error} If `logisticOrderId` or `reasonCode` is missing.
+ * @returns {Promise<createOrderLogisticIncidentResponse>} A promise resolving to the response containing the created incident's details.
+ */
+async function createOrderLogisticIncident({ logisticOrderId, idType, customField, reasonCode, }) {
+    (0, parameters_validation_1.required)({ logisticOrderId, reasonCode });
+    const { data } = await (0, fetch_instance_1.enhancedFetch)({
+        method: "POST",
+        path: `/v1/shop/logistic-orders/${logisticOrderId}/incidents`,
+        params: {
+            idType,
+        },
+        body: JSON.stringify({
+            customField,
+            reasonCode,
+        }),
+    });
+    return data;
+}
+/**
+ * 🚚 Creates a new incident for a specific line within a logistic order.
+ *
+ * This function allows the creation of an incident for one or more lines within a logistic order.
+ * The `logisticOrderId`, `reasonCode`, and `orderLines` are required parameters.
+ * The `customFieldIdType` and `idType` are used for specifying additional information about the incident.
+ *
+ * 🛠 **Endpoint**: `POST /v1/shop/logistic-orders/{logisticOrderId}/lines/incidents [ORDER-102]`
+ *
+ * | Parameter          | Type                                | Required   | Description                                              |
+ * |--------------------|-------------------------------------|------------|----------------------------------------------------------|
+ * | `logisticOrderId`  | `string`                            | ✅         | The ID of the logistic order for which the line incident is created. |
+ * | `idType`           | `IncidentIdType`                    | ❌         | The type of incident ID (e.g., `DJUST_ID`, `EXTERNAL_ID`). |
+ * | `customFieldIdType`| `IncidentIdType`                    | ❌         | The ID type for custom field values (e.g., `EXTERNAL_ID`). |
+ * | `orderLines`       | `{ customFieldValues: CustomFieldValueRequest[], lineId: string, quantity: number }[]` | ✅         | An array of objects describing the order lines, including custom field values, line ID, and quantity. |
+ * | `reasonCode`       | `string[]`                          | ✅         | The reason codes for the incident (e.g., `["PRODUCT_DEFECT"]`). |
+ *
+ * 📤 **Returns**:
+ * A `Promise` resolving to a `createOrderLogisticLineIncidentResponse` object,
+ * containing the `incidentId` and `externalId` of the created incident.
+ *
+ * 🛠 **Example usage**:
+ * ```ts
+ * const incident = await createOrderLogisticLineIncident({
+ *   logisticOrderId: "12345",
+ *   idType: "EXTERNAL_ID",
+ *   customFieldIdType: "DJUST_ID",
+ *   orderLines: [
+ *     { customFieldValues: [], lineId: "line_1", quantity: 2 }
+ *   ],
+ *   reasonCode: ["PRODUCT_DEFECT"]
+ * });
+ * ```
+ *
+ * @param {createOrderLogisticLineIncidentParameters} params - The parameters for creating the incident.
+ * @throws {Error} If `logisticOrderId`, `reasonCode`, or `orderLines` is missing.
+ * @returns {Promise<createOrderLogisticLineIncidentResponse>} A promise resolving to the response containing the created incident's details.
+ */
+async function createOrderLogisticLineIncident({ logisticOrderId, idType, customFieldIdType, orderLines, reasonCode, }) {
+    (0, parameters_validation_1.required)({ logisticOrderId, reasonCode, orderLines });
+    const { data } = await (0, fetch_instance_1.enhancedFetch)({
+        method: "POST",
+        path: `/v1/shop/logistic-orders/${logisticOrderId}/lines/incidents`,
+        params: {
+            idType,
+        },
+        body: JSON.stringify({
+            customFieldIdType,
+            orderLines,
+            reasonCode,
+        }),
+    });
+    return data;
+}
+/**
+ * 🧑‍💼 Fetches incidents for a specific customer account.
+ *
+ * This function retrieves incidents associated with a particular customer account,
+ * using parameters such as `status`, `page`, `size`, and `sort` to filter and paginate the results.
+ * The `customerAccountId` is a mandatory parameter and is validated before making the request.
+ *
+ * 🛠 **Endpoint**: `GET /v1/shop/customer-accounts/{customerAccountId}/incidents [ACCOUNT-551]`
+ *
+ * | Parameter         | Type                            | Required   | Description                              |
+ * |-------------------|---------------------------------|------------|------------------------------------------|
+ * | `customerAccountId`| `string`                       | ✅         | The ID of the customer account for which incidents are to be fetched. |
+ * | `status`          | `IncidentStatus[]`             | ❌         | Array of statuses to filter incidents by (e.g., `["OPEN"]`). |
+ * | `page`            | `number`                       | ❌         | The page number for pagination.          |
+ * | `size`            | `number`                       | ❌         | The number of results per page.          |
+ * | `sort`            | `string[]`                     | ❌         | Sorting criteria (e.g., `["createdAt,desc"]`). |
+ *
+ * 📤 **Returns**:
+ * A `Promise` resolving to an array of `getCustomerAccountIncidentsResponse` objects,
+ * representing the incidents for the given customer account.
+ *
+ * 🛠 **Example usage**:
+ * ```ts
+ * const incidents = await getCustomerAccountIncidents({
+ *   customerAccountId: "98765",
+ *   status: ["OPEN"],
+ *   page: 1,
+ *   size: 10,
+ *   sort: ["createdAt,desc"],
+ * });
+ * ```
+ *
+ * @param {getCustomerAccountIncidentsParameters} params - The parameters for the request.
+ * @throws {Error} If `customerAccountId` is missing.
+ * @returns {Promise<getCustomerAccountIncidentsResponse>} A promise resolving to the incidents response.
+ */
+async function getCustomerAccountIncidents({ customerAccountId, status, page, size, sort, }) {
+    (0, parameters_validation_1.required)({ customerAccountId });
+    const { data } = await (0, fetch_instance_1.enhancedFetch)({
+        method: "GET",
+        path: `/v1/shop/customer-accounts/${customerAccountId}/incidents`,
+        params: {
+            status,
+            page,
+            size,
+            sort,
+        },
+    });
+    return data;
+}

package/lib/services/quote/definitions.d.ts

@@ -1,5 +1,7 @@
-import { MasterQuote, PageMasterQuote, SupplierQuoteDto } from "../../interfaces/models/quote";
+import { MasterQuote, PageMasterQuote, SupplierQuoteDto, SupplierQuoteIdType } from "../../interfaces/models/quote";
+import { OrderCommercialDto } from "../../interfaces/models/order";
 import { PageableParameters } from "../../interfaces/models/common";
+import { CustomFieldValueRequest } from "../../interfaces/models/custom-field";
 /**
  * Request parameters type definitions
  */
@@ -46,6 +48,9 @@ export interface CreateSupplierQuotesParameters {
 export interface GetSupplierQuoteParameters {
     supplierQuoteId: string;
 }
+export interface AcceptSupplierQuoteParameters {
+    supplierQuoteId: string;
+}
 export interface DeclineSupplierQuoteParameters {
     supplierQuoteId: string;
 }
@@ -54,6 +59,19 @@ export interface PostMessageToSupplierQuoteParameters {
     message: string;
     username: string;
 }
+export interface UpdateSupplierQuoteCustomFieldsParameters {
+    supplierQuoteId: string;
+    customFieldValues: CustomFieldValueRequest[];
+    idType: SupplierQuoteIdType;
+}
+export interface InitializeOrderFromSupplierQuoteParameters {
+    supplierQuoteId: string;
+    nbPreviewLines: number;
+    quoteLineIdsAndQuantities: {
+        quantity: number;
+        quoteLineId: string;
+    };
+}
 /**
  * Response type definitions
  */
@@ -71,5 +89,11 @@ export interface GetSupplierQuoteResponse extends SupplierQuoteDto {
 }
 export interface DeclineSupplierQuoteResponse extends SupplierQuoteDto {
 }
+export interface AcceptSupplierQuoteResponse extends SupplierQuoteDto {
+}
 export interface PostMessageToSupplierQuoteResponse extends SupplierQuoteDto {
 }
+export interface UpdateSupplierQuoteCustomFieldsResponse extends SupplierQuoteDto {
+}
+export interface InitializeOrderFromSupplierQuoteResponse extends OrderCommercialDto {
+}