@djust-b2b/djust-front-sdk 2.16.1 → 2.17.1

package/lib/index.d.ts

@@ -35,7 +35,7 @@ export declare const DjustSDK: {
     createOrderLogisticIncidentThread({ logisticOrderId, incidentId, idType, customField, message, name, reasonCode, }: import("./services/incident/definitions").createOrderLogisticIncidentThreadParameters): Promise<import("./services/incident/definitions").createOrderLogisticIncidentThreadResponse>;
     createIncident({ customField, externalId, logisticOrderId, reasonCodes, idType, }: import("./services/incident/definitions").createIncidentParameters): Promise<import("./services/incident/definitions").createIncidentResponse>;
     getCommercialOrders({ locale, nbPreviewLines, page, size, sort, connectedUserOnly, customerAccountIds, sourceTypes, isValidated, }: import("./interfaces").GetCommercialOrdersParameters): Promise<import("./interfaces").GetCommercialOrdersResponse>;
-    getCommercialOrdersV2({ page, size, sort, locale, connectedUserOnly, customerAccountIds, sourceTypes, sourceIds, isValidated, nbPreviewLines, }: import("./interfaces").GetCommercialOrdersV2Parameters): Promise<import("./interfaces").GetCommercialOrdersV2Response>;
+    getCommercialOrdersV2({ page, size, sort, locale, connectedUserOnly, customerAccountIds, sourceTypes, sourceIds, isValidated, nbPreviewLines, cf, }: import("./interfaces").GetCommercialOrdersV2Parameters): Promise<import("./interfaces").GetCommercialOrdersV2Response>;
     createCommercialOrder({ nbPreviewLines, channel, customFields, locale, origin, originId, paymentInfo, }: import("./interfaces").CreateCommercialOrderParameters): Promise<import("./interfaces").CreateCommercialOrderResponse>;
     createCommercialOrderV2({ customFieldIdType, customFields, isFull, sourceId, sourceType, }: import("./interfaces").CreateCommercialOrderV2Parameters): Promise<import("./interfaces").CreateCommercialOrderV2Response>;
     getCommercialOrder({ orderId, idType, locale, nbPreviewLines, }: import("./interfaces").GetCommercialOrderParameters): Promise<import("./interfaces").GetCommercialOrderResponse>;
@@ -101,7 +101,7 @@ export declare const DjustSDK: {
     createMasterQuote({ description, name, }: import("./interfaces").CreateMasterQuoteParameters): Promise<import("./interfaces").CreateMasterQuoteResponse>;
     deleteMasterQuote({ masterQuoteId, }: import("./interfaces").DeleteMasterQuoteParameters): Promise<void>;
     getMasterQuote({ masterQuoteId, }: import("./interfaces").GetMasterQuoteParameters): Promise<import("./interfaces").GetMasterQuoteResponse>;
-    updateMasterQuote({ masterQuoteId, customFieldValues, masterQuoteDetailsToAdd, masterQuoteDetailsToRemove, }: import("./interfaces").UpdateMasterQuoteParameters): Promise<import("./interfaces").UpdateMasterQuoteResponse>;
+    updateMasterQuote({ masterQuoteId, customFieldValues, masterQuoteDetailsToAdd, masterQuoteDetailsToRemove, idType, }: import("./interfaces").UpdateMasterQuoteParameters): Promise<import("./interfaces").UpdateMasterQuoteResponse>;
     createSupplierQuotes({ billingAddressId, createSupplierQuoteRequests, masterQuoteId, supplierQuoteUrl, }: import("./interfaces").CreateSupplierQuotesParameters): Promise<import("./interfaces").CreateSupplierQuotesResponse>;
     getSupplierQuote({ supplierQuoteId, }: import("./interfaces").GetSupplierQuoteParameters): Promise<import("./interfaces").GetSupplierQuoteResponse>;
     acceptSupplierQuote({ supplierQuoteId, }: import("./interfaces").AcceptSupplierQuoteParameters): Promise<import("./interfaces").AcceptSupplierQuoteResponse>;

package/lib/services/commercial-order/definitions.d.ts

@@ -28,6 +28,7 @@ export interface GetCommercialOrdersV2Parameters {
     sourceIds?: string[];
     isValidated?: boolean;
     nbPreviewLines?: number;
+    cf?: string[];
 }
 export interface GetOrderCommercialLinesParameters {
     commercialOrderId: string;

package/lib/services/commercial-order/index.d.ts

@@ -47,20 +47,28 @@ export declare function getCommercialOrders({ locale, nbPreviewLines, page, size
  * This function retrieves all commercial orders (Version 2). The parameter locale is mandatory and validated
  * before the request is executed.
  *
- * 🛠 **Endpoint**: `GET /v2/shop/commercial-orders [ORDER-560-v2]`
+ * 🛠 **Endpoint**: `GET /v2/shop/commercial-orders [ORDER-560]`
  *
  * | Parameter              | Type                | Required | Description                              |
  * |------------------------|---------------------|----------|------------------------------------------|
  * | `page`                 | `number`            | ❌       | The page number to retrieve. |
  * | `size`                 | `number`            | ❌       | The number of items per page. |
- * | `sort`                 | `string[]`          | ❌       | The sort to apply to the results. |
- * | `locale`               | `string`            | ✅       | The locale in which to return the commercial order. |
+ * | `sort`                 | `string[]`          | ❌       | The sort to apply to the results. Format: `field:direction` (e.g., `["createdAt:desc", "reference:asc"]`). Supported fields: `createdAt`, `validatedAt`, `updatedAt`, `sourceType`, `sourceId`, `reference`. |
+ * | `locale`               | `string`            | ✅       | The locale (IETF BCP 47) in which to return the commercial order. |
  * | `connectedUserOnly`    | `boolean`           | ❌       | Filter to show only orders for the connected user. |
  * | `customerAccountIds`   | `string[]`          | ❌       | Filter by customer account IDs. |
  * | `sourceTypes`          | `string[]`          | ❌       | Filter by source types. |
  * | `sourceIds`            | `string[]`          | ❌       | Filter by source IDs. |
  * | `isValidated`          | `boolean`           | ❌       | Filter by validation status. |
  * | `nbPreviewLines`       | `number`            | ❌       | The number of lines to display in the commercial order. |
+ * | `cf`                   | `string[]`          | ❌       | Custom field filtering. Format: `<CF_EXTERNAL_ID>|<CF_VALUE>`. AND between different CF external IDs; OR between multiple values of the same CF. |
+ *
+ * **Filters**: AND between different keys; OR between values of the same key.
+ * Unknown or malformed values are silently ignored; empty lists mean no filter.
+ *
+ * **Sorting**: Multiple criteria supported (comma-separated). Default: `createdAt:desc` then `reference:asc` as tie-breaker.
+ * Invalid/malformed sort entries are silently ignored. When sorting by reference, collation is case-insensitive and locale-aware.
+ * Null values are always placed last, regardless of sort direction.
  *
  * 📤 **Returns**:
  * A `Promise` resolving to a single `GetCommercialOrdersV2Response` object representing the page of commercial orders.
@@ -71,8 +79,9 @@ export declare function getCommercialOrders({ locale, nbPreviewLines, page, size
  *   locale: "fr",
  *   page: 0,
  *   size: 20,
- *   sort: ["createdAt,desc"],
- *   connectedUserOnly: true
+ *   sort: ["createdAt:desc", "reference:asc"],
+ *   connectedUserOnly: true,
+ *   cf: ["customField1|value1", "customField1|value2", "customField2|value3"]
  * });
  * ```
  *
@@ -80,7 +89,7 @@ export declare function getCommercialOrders({ locale, nbPreviewLines, page, size
  * @throws {Error} If `locale` is missing.
  * @returns {Promise<GetCommercialOrdersV2Response>} A promise resolving to the response containing page object.
  */
-export declare function getCommercialOrdersV2({ page, size, sort, locale, connectedUserOnly, customerAccountIds, sourceTypes, sourceIds, isValidated, nbPreviewLines, }: GetCommercialOrdersV2Parameters): Promise<GetCommercialOrdersV2Response>;
+export declare function getCommercialOrdersV2({ page, size, sort, locale, connectedUserOnly, customerAccountIds, sourceTypes, sourceIds, isValidated, nbPreviewLines, cf, }: GetCommercialOrdersV2Parameters): Promise<GetCommercialOrdersV2Response>;
 /**
  * 🚚 Creates commercial orders.
  *

package/lib/services/commercial-order/index.js

@@ -89,20 +89,28 @@ async function getCommercialOrders({ locale, nbPreviewLines, page, size, sort, c
  * This function retrieves all commercial orders (Version 2). The parameter locale is mandatory and validated
  * before the request is executed.
  *
- * 🛠 **Endpoint**: `GET /v2/shop/commercial-orders [ORDER-560-v2]`
+ * 🛠 **Endpoint**: `GET /v2/shop/commercial-orders [ORDER-560]`
  *
  * | Parameter              | Type                | Required | Description                              |
  * |------------------------|---------------------|----------|------------------------------------------|
  * | `page`                 | `number`            | ❌       | The page number to retrieve. |
  * | `size`                 | `number`            | ❌       | The number of items per page. |
- * | `sort`                 | `string[]`          | ❌       | The sort to apply to the results. |
- * | `locale`               | `string`            | ✅       | The locale in which to return the commercial order. |
+ * | `sort`                 | `string[]`          | ❌       | The sort to apply to the results. Format: `field:direction` (e.g., `["createdAt:desc", "reference:asc"]`). Supported fields: `createdAt`, `validatedAt`, `updatedAt`, `sourceType`, `sourceId`, `reference`. |
+ * | `locale`               | `string`            | ✅       | The locale (IETF BCP 47) in which to return the commercial order. |
  * | `connectedUserOnly`    | `boolean`           | ❌       | Filter to show only orders for the connected user. |
  * | `customerAccountIds`   | `string[]`          | ❌       | Filter by customer account IDs. |
  * | `sourceTypes`          | `string[]`          | ❌       | Filter by source types. |
  * | `sourceIds`            | `string[]`          | ❌       | Filter by source IDs. |
  * | `isValidated`          | `boolean`           | ❌       | Filter by validation status. |
  * | `nbPreviewLines`       | `number`            | ❌       | The number of lines to display in the commercial order. |
+ * | `cf`                   | `string[]`          | ❌       | Custom field filtering. Format: `<CF_EXTERNAL_ID>|<CF_VALUE>`. AND between different CF external IDs; OR between multiple values of the same CF. |
+ *
+ * **Filters**: AND between different keys; OR between values of the same key.
+ * Unknown or malformed values are silently ignored; empty lists mean no filter.
+ *
+ * **Sorting**: Multiple criteria supported (comma-separated). Default: `createdAt:desc` then `reference:asc` as tie-breaker.
+ * Invalid/malformed sort entries are silently ignored. When sorting by reference, collation is case-insensitive and locale-aware.
+ * Null values are always placed last, regardless of sort direction.
  *
  * 📤 **Returns**:
  * A `Promise` resolving to a single `GetCommercialOrdersV2Response` object representing the page of commercial orders.
@@ -113,8 +121,9 @@ async function getCommercialOrders({ locale, nbPreviewLines, page, size, sort, c
  *   locale: "fr",
  *   page: 0,
  *   size: 20,
- *   sort: ["createdAt,desc"],
- *   connectedUserOnly: true
+ *   sort: ["createdAt:desc", "reference:asc"],
+ *   connectedUserOnly: true,
+ *   cf: ["customField1|value1", "customField1|value2", "customField2|value3"]
  * });
  * ```
  *
@@ -122,7 +131,7 @@ async function getCommercialOrders({ locale, nbPreviewLines, page, size, sort, c
  * @throws {Error} If `locale` is missing.
  * @returns {Promise<GetCommercialOrdersV2Response>} A promise resolving to the response containing page object.
  */
-async function getCommercialOrdersV2({ page, size, sort, locale, connectedUserOnly, customerAccountIds, sourceTypes, sourceIds, isValidated, nbPreviewLines, }) {
+async function getCommercialOrdersV2({ page, size, sort, locale, connectedUserOnly, customerAccountIds, sourceTypes, sourceIds, isValidated, nbPreviewLines, cf, }) {
     (0, parameters_validation_1.required)({ locale });
     const { data } = await (0, fetch_instance_1.enhancedFetch)({
         method: "GET",
@@ -138,6 +147,7 @@ async function getCommercialOrdersV2({ page, size, sort, locale, connectedUserOn
             sourceIds,
             isValidated,
             nbPreviewLines,
+            cf,
         },
     });
     return data;

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

@@ -1,6 +1,6 @@
 import { MasterQuote, PageMasterQuote, SupplierQuoteDto, SupplierQuoteIdType } from "../../interfaces/models/quote";
 import { OrderCommercialDto } from "../../interfaces/models/order";
-import { PageableParameters } from "../../interfaces/models/common";
+import { IdType, PageableParameters } from "../../interfaces/models/common";
 import { CustomFieldValueRequest } from "../../interfaces/models/custom-field";
 /**
  * Request parameters type definitions
@@ -30,6 +30,8 @@ export interface UpdateMasterQuoteParameters {
         quantity: number;
     }[];
     masterQuoteDetailsToRemove: string[];
+    /** Type des productVariantId dans masterQuoteDetailsToAdd (ex. EXTERNAL_ID pour utiliser des externalId). */
+    idType?: IdType;
 }
 export interface CreateSupplierQuotesParameters {
     billingAddressId?: string;

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

@@ -129,6 +129,7 @@ export declare function getMasterQuote({ masterQuoteId, }: GetMasterQuoteParamet
  * | `customFieldValues`          | `{ customFieldId: string; customFieldValue?: string; }[]` | ❌         | Custom field values to update for the master quote.  |
  * | `masterQuoteDetailsToAdd`    | `{ productVariantId: string; quantity: number; }[]` | ❌         | Details to add to the master quote.                 |
  * | `masterQuoteDetailsToRemove` | `string[]`                                | ❌         | IDs of details to remove from the master quote.      |
+ * | `idType`                     | `"DJUST_ID" \| "EXTERNAL_ID"`             | ❌         | Query param: type for productVariantId and customField id. Default BUSINESS_ID (Swagger: DJUST_ID). |
  *
  * 📤 **Returns**:
  * A `Promise` resolving to an `UpdateMasterQuoteResponse` object, which contains the updated details of the master quote.
@@ -149,7 +150,7 @@ export declare function getMasterQuote({ masterQuoteId, }: GetMasterQuoteParamet
  * @throws {Error} If `masterQuoteId` is missing.
  * @returns {Promise<UpdateMasterQuoteResponse>} A promise resolving to the updated details of the master quote.
  */
-export declare function updateMasterQuote({ masterQuoteId, customFieldValues, masterQuoteDetailsToAdd, masterQuoteDetailsToRemove, }: UpdateMasterQuoteParameters): Promise<UpdateMasterQuoteResponse>;
+export declare function updateMasterQuote({ masterQuoteId, customFieldValues, masterQuoteDetailsToAdd, masterQuoteDetailsToRemove, idType, }: UpdateMasterQuoteParameters): Promise<UpdateMasterQuoteResponse>;
 /**
  * ✏️ Creates supplier quotes.
  *

package/lib/services/quote/index.js

@@ -180,6 +180,7 @@ async function getMasterQuote({ masterQuoteId, }) {
  * | `customFieldValues`          | `{ customFieldId: string; customFieldValue?: string; }[]` | ❌         | Custom field values to update for the master quote.  |
  * | `masterQuoteDetailsToAdd`    | `{ productVariantId: string; quantity: number; }[]` | ❌         | Details to add to the master quote.                 |
  * | `masterQuoteDetailsToRemove` | `string[]`                                | ❌         | IDs of details to remove from the master quote.      |
+ * | `idType`                     | `"DJUST_ID" \| "EXTERNAL_ID"`             | ❌         | Query param: type for productVariantId and customField id. Default BUSINESS_ID (Swagger: DJUST_ID). |
  *
  * 📤 **Returns**:
  * A `Promise` resolving to an `UpdateMasterQuoteResponse` object, which contains the updated details of the master quote.
@@ -200,11 +201,12 @@ async function getMasterQuote({ masterQuoteId, }) {
  * @throws {Error} If `masterQuoteId` is missing.
  * @returns {Promise<UpdateMasterQuoteResponse>} A promise resolving to the updated details of the master quote.
  */
-async function updateMasterQuote({ masterQuoteId, customFieldValues, masterQuoteDetailsToAdd, masterQuoteDetailsToRemove, }) {
+async function updateMasterQuote({ masterQuoteId, customFieldValues, masterQuoteDetailsToAdd, masterQuoteDetailsToRemove, idType, }) {
     (0, parameters_validation_1.required)({ masterQuoteId });
     const { data } = await (0, fetch_instance_1.enhancedFetch)({
         method: "PUT",
         path: `/v1/shop/master-quotes/${masterQuoteId}`,
+        params: idType ? { idType } : {},
         body: JSON.stringify({
             masterQuoteDetailsToAdd,
             masterQuoteDetailsToRemove,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@djust-b2b/djust-front-sdk",
-  "version": "2.16.1",
+  "version": "2.17.1",
   "description": "DJUST Front SDK is a versatile JavaScript Software Development Kit (SDK)",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",