@djust-b2b/djust-front-sdk 2.18.0 → 2.19.0

package/lib/index.d.ts

@@ -74,6 +74,7 @@ export declare const DjustSDK: {
     getLogisticOrderDocumentUrl({ orderId, documentId, }: import("./interfaces").GetLogisticOrderDocumentUrlParameters): Promise<string[]>;
     getLogisticOrderLines({ orderId, page, size, sort, locale, }: import("./interfaces").GetLogisticOrderLinesParameters): Promise<import("./interfaces").GetLogisticOrderLinesResponse>;
     updateOnHoldLogisticOrderLines({ orderId, lines, }: import("./interfaces").UpdateOnHoldLogisticOrderLinesParameters): Promise<import("./interfaces").UpdateOnHoldLogisticOrderLinesResponse>;
+    bulkUpdateLogisticOrderLinesCustomFields({ logisticOrderId, lines, }: import("./interfaces").BulkUpdateLogisticOrderLinesCustomFieldsParameters): Promise<import("./interfaces").BulkUpdateLogisticOrderLinesCustomFieldsResponse>;
     updateLogisticOrderLineCustomFields({ orderId, lineId, locale, customFields, }: import("./interfaces").UpdateLogisticOrderLineCustomFieldsParameters): Promise<import("./interfaces").UpdateLogisticOrderLineCustomFieldsResponse>;
     updateOnHoldLogisticOrderLine({ orderId, orderLineId, quantity, }: import("./interfaces").UpdateOnHoldLogisticOrderLineParameters): Promise<void>;
     updateLogisticOrderShippingAddress({ orderId, shippingAddressId, }: import("./interfaces").UpdateLogisticOrderShippingAddressParameters): Promise<void>;

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

@@ -124,6 +124,25 @@ export interface UpdateOnHoldLogisticOrderLinesParameters {
     orderId: string;
     lines: OrderLogisticLineUpdate[];
 }
+/** ORDER-251 — one entry per logistic order line in the bulk PATCH body. */
+export interface BulkUpdateLogisticOrderLinesCustomFieldsLineItem {
+    customFieldValues: CustomFieldValueRequest[];
+    logisticOrderLineId: string;
+}
+export interface BulkUpdateLogisticOrderLinesCustomFieldsParameters {
+    /** Logistic order reference (e.g. OL-2025-001234). Requires dj-client: ACCOUNT. */
+    logisticOrderId: string;
+    lines: BulkUpdateLogisticOrderLinesCustomFieldsLineItem[];
+}
+/** Per-line warning when bulk update runs in partial success mode (ORDER-251). */
+export interface LogisticOrderLineBulkCustomFieldWarning {
+    code: string;
+    logisticOrderLineId: string;
+    message: string;
+}
+export interface BulkUpdateLogisticOrderLinesCustomFieldsResponse {
+    warnings: LogisticOrderLineBulkCustomFieldWarning[];
+}
 export interface UpdateLogisticOrderLineCustomFieldsParameters {
     orderId: string;
     lineId: string;

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

@@ -1,4 +1,4 @@
-import { AddLogisticOrderReviewParameters, AddLogisticOrderReviewResponse, ApproveLogisticOrderParameters, ApproveLogisticOrderResponse, CancelLogisticOrderParameters, CancelLogisticOrderResponse, ConfirmLogisticOrderReceptionParameters, ConfirmLogisticOrderReceptionResponse, CreateLogisticOrderParameters, CreateLogisticOrderThreadParameters, GetPaginatedLogisticOrdersParameters, GetPaginatedLogisticOrdersResponse, CreateLogisticOrderThreadResponse, DisapproveLogisticOrderParameters, DisapproveLogisticOrderResponse, GetLogisticOrderAccountingDocumentsParameters, GetLogisticOrderAccountingDocumentsResponse, GetLogisticOrderAccountingDocumentUrlParameters, GetLogisticOrderApproversParameters, GetLogisticOrderApproversResponse, GetLogisticOrderCustomFieldsParameters, GetLogisticOrderCustomFieldsResponse, GetLogisticOrderDocumentsParameters, GetLogisticOrderDocumentsResponse, GetLogisticOrderDocumentUrlParameters, GetLogisticOrderLineCustomFieldsParameters, GetLogisticOrderLineCustomFieldsResponse, GetLogisticOrderLinesParameters, GetLogisticOrderLinesResponse, GetLogisticOrderParameters, GetLogisticOrderResponse, GetLogisticOrderReviewParameters, GetLogisticOrderReviewResponse, GetLogisticOrderShippingAddressParameters, GetLogisticOrderShippingAddressResponse, GetLogisticOrdersParameters, GetLogisticOrdersResponse, GetThreadReasonTypesResponse, GetThreadSubReasonsParameters, GetThreadSubReasonsResponse, UpdateLogisticOrderBillingInformationParameters, UpdateLogisticOrderCustomFieldsParameters, UpdateLogisticOrderCustomFieldsResponse, UpdateLogisticOrderLineCustomFieldsParameters, UpdateLogisticOrderLineCustomFieldsResponse, UpdateLogisticOrderShippingAddressParameters, UpdateLogisticOrderShippingInformationParameters, UpdateLogisticOrderShippingTypeParameters, UpdateOnHoldLogisticOrderLineParameters, UpdateOnHoldLogisticOrderLinesParameters, UpdateOnHoldLogisticOrderLinesResponse, CreateLogisticOrderIncidentThreadsParams, CreateLogisticOrderIncidentThreadsResponse, GetLogisticOrderIncidentThreadParams, GetLogisticOrderIncidentThreadResponse, CreateLogisticOrderIncidentThreadMessagesParams, CreateLogisticOrderIncidentThreadMessagesResponse, UpdateLogisticOrderIncidentThreadMessageParams, GetLogisticOrderThreadsParams, GetLogisticOrderThreadsResponse, CreateLogisticOrderThreadParametersV2, CreateLogisticOrderThreadResponseV2, GetLogisticOrderThreadParams, GetLogisticOrderThreadResponse, CreateLogisticOrderThreadMessagesParams, CreateLogisticOrderThreadMessagesResponse, UpdateLogisticOrderThreadMessageParams } from "./definitions";
+import { AddLogisticOrderReviewParameters, AddLogisticOrderReviewResponse, ApproveLogisticOrderParameters, ApproveLogisticOrderResponse, CancelLogisticOrderParameters, CancelLogisticOrderResponse, ConfirmLogisticOrderReceptionParameters, ConfirmLogisticOrderReceptionResponse, CreateLogisticOrderParameters, CreateLogisticOrderThreadParameters, GetPaginatedLogisticOrdersParameters, GetPaginatedLogisticOrdersResponse, CreateLogisticOrderThreadResponse, DisapproveLogisticOrderParameters, DisapproveLogisticOrderResponse, GetLogisticOrderAccountingDocumentsParameters, GetLogisticOrderAccountingDocumentsResponse, GetLogisticOrderAccountingDocumentUrlParameters, GetLogisticOrderApproversParameters, GetLogisticOrderApproversResponse, GetLogisticOrderCustomFieldsParameters, GetLogisticOrderCustomFieldsResponse, GetLogisticOrderDocumentsParameters, GetLogisticOrderDocumentsResponse, GetLogisticOrderDocumentUrlParameters, GetLogisticOrderLineCustomFieldsParameters, GetLogisticOrderLineCustomFieldsResponse, GetLogisticOrderLinesParameters, GetLogisticOrderLinesResponse, GetLogisticOrderParameters, GetLogisticOrderResponse, GetLogisticOrderReviewParameters, GetLogisticOrderReviewResponse, GetLogisticOrderShippingAddressParameters, GetLogisticOrderShippingAddressResponse, GetLogisticOrdersParameters, GetLogisticOrdersResponse, GetThreadReasonTypesResponse, GetThreadSubReasonsParameters, GetThreadSubReasonsResponse, UpdateLogisticOrderBillingInformationParameters, UpdateLogisticOrderCustomFieldsParameters, UpdateLogisticOrderCustomFieldsResponse, UpdateLogisticOrderLineCustomFieldsParameters, UpdateLogisticOrderLineCustomFieldsResponse, UpdateLogisticOrderShippingAddressParameters, UpdateLogisticOrderShippingInformationParameters, UpdateLogisticOrderShippingTypeParameters, UpdateOnHoldLogisticOrderLineParameters, UpdateOnHoldLogisticOrderLinesParameters, UpdateOnHoldLogisticOrderLinesResponse, BulkUpdateLogisticOrderLinesCustomFieldsParameters, BulkUpdateLogisticOrderLinesCustomFieldsResponse, CreateLogisticOrderIncidentThreadsParams, CreateLogisticOrderIncidentThreadsResponse, GetLogisticOrderIncidentThreadParams, GetLogisticOrderIncidentThreadResponse, CreateLogisticOrderIncidentThreadMessagesParams, CreateLogisticOrderIncidentThreadMessagesResponse, UpdateLogisticOrderIncidentThreadMessageParams, GetLogisticOrderThreadsParams, GetLogisticOrderThreadsResponse, CreateLogisticOrderThreadParametersV2, CreateLogisticOrderThreadResponseV2, GetLogisticOrderThreadParams, GetLogisticOrderThreadResponse, CreateLogisticOrderThreadMessagesParams, CreateLogisticOrderThreadMessagesResponse, UpdateLogisticOrderThreadMessageParams } from "./definitions";
 /**
  * @deprecated
  * 🚚 Gets logistic orders.
@@ -639,6 +639,44 @@ export declare function getLogisticOrderLines({ orderId, page, size, sort, local
  * @returns {Promise<UpdateOnHoldLogisticOrderLinesResponse>} A promise resolving to the response containing the error report.
  */
 export declare function updateOnHoldLogisticOrderLines({ orderId, lines, }: UpdateOnHoldLogisticOrderLinesParameters): Promise<UpdateOnHoldLogisticOrderLinesResponse>;
+/**
+ * 🚚 Bulk-updates custom field values on multiple lines of a logistic order (partial success).
+ *
+ * Each line is processed independently: valid lines are updated; failures appear in `warnings`.
+ * An empty `warnings` array means every line succeeded. Requires `dj-client: ACCOUNT`; the order
+ * must belong to the authenticated customer. `logisticOrderId` is the order **reference**
+ * (e.g. OL-2025-001234), not necessarily an internal id.
+ *
+ * 🛠 **Endpoint**: `PATCH /v1/shop/logistic-orders/${logisticOrderId}/lines [ORDER-251]`
+ *
+ * | Parameter          | Type                                              | Required | Description                                      |
+ * |--------------------|---------------------------------------------------|----------|--------------------------------------------------|
+ * | `logisticOrderId`  | `string`                                          | ✅       | Logistic order reference.                        |
+ * | `lines`            | `BulkUpdateLogisticOrderLinesCustomFieldsLineItem[]` | ✅    | Lines with `logisticOrderLineId` and `customFieldValues`. Max 100 entries, no duplicates (422 if invalid). |
+ *
+ * 📤 **Returns**:
+ * A `Promise` resolving to `BulkUpdateLogisticOrderLinesCustomFieldsResponse` (`warnings` only lists lines that failed validation).
+ *
+ * 🛠 **Example usage**:
+ * ```ts
+ * const { warnings } = await bulkUpdateLogisticOrderLinesCustomFields({
+ *   logisticOrderId: "OL-2025-001234",
+ *   lines: [
+ *     {
+ *       logisticOrderLineId: "LOG-LINE-001",
+ *       customFieldValues: [
+ *         { customFieldId: "cf-1", customFieldValue: "value1" },
+ *       ],
+ *     },
+ *   ],
+ * });
+ * ```
+ *
+ * @param {BulkUpdateLogisticOrderLinesCustomFieldsParameters} params - Path id and line payloads.
+ * @throws {Error} If `logisticOrderId` or `lines` is missing.
+ * @returns {Promise<BulkUpdateLogisticOrderLinesCustomFieldsResponse>}
+ */
+export declare function bulkUpdateLogisticOrderLinesCustomFields({ logisticOrderId, lines, }: BulkUpdateLogisticOrderLinesCustomFieldsParameters): Promise<BulkUpdateLogisticOrderLinesCustomFieldsResponse>;
 /**
  * 🚚 Updates specific logistic order line's customFields.
  *

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

@@ -19,6 +19,7 @@ exports.getLogisticOrderDocuments = getLogisticOrderDocuments;
 exports.getLogisticOrderDocumentUrl = getLogisticOrderDocumentUrl;
 exports.getLogisticOrderLines = getLogisticOrderLines;
 exports.updateOnHoldLogisticOrderLines = updateOnHoldLogisticOrderLines;
+exports.bulkUpdateLogisticOrderLinesCustomFields = bulkUpdateLogisticOrderLinesCustomFields;
 exports.updateLogisticOrderLineCustomFields = updateLogisticOrderLineCustomFields;
 exports.updateOnHoldLogisticOrderLine = updateOnHoldLogisticOrderLine;
 exports.updateLogisticOrderShippingAddress = updateLogisticOrderShippingAddress;
@@ -900,6 +901,52 @@ async function updateOnHoldLogisticOrderLines({ orderId, lines, }) {
     });
     return data;
 }
+/**
+ * 🚚 Bulk-updates custom field values on multiple lines of a logistic order (partial success).
+ *
+ * Each line is processed independently: valid lines are updated; failures appear in `warnings`.
+ * An empty `warnings` array means every line succeeded. Requires `dj-client: ACCOUNT`; the order
+ * must belong to the authenticated customer. `logisticOrderId` is the order **reference**
+ * (e.g. OL-2025-001234), not necessarily an internal id.
+ *
+ * 🛠 **Endpoint**: `PATCH /v1/shop/logistic-orders/${logisticOrderId}/lines [ORDER-251]`
+ *
+ * | Parameter          | Type                                              | Required | Description                                      |
+ * |--------------------|---------------------------------------------------|----------|--------------------------------------------------|
+ * | `logisticOrderId`  | `string`                                          | ✅       | Logistic order reference.                        |
+ * | `lines`            | `BulkUpdateLogisticOrderLinesCustomFieldsLineItem[]` | ✅    | Lines with `logisticOrderLineId` and `customFieldValues`. Max 100 entries, no duplicates (422 if invalid). |
+ *
+ * 📤 **Returns**:
+ * A `Promise` resolving to `BulkUpdateLogisticOrderLinesCustomFieldsResponse` (`warnings` only lists lines that failed validation).
+ *
+ * 🛠 **Example usage**:
+ * ```ts
+ * const { warnings } = await bulkUpdateLogisticOrderLinesCustomFields({
+ *   logisticOrderId: "OL-2025-001234",
+ *   lines: [
+ *     {
+ *       logisticOrderLineId: "LOG-LINE-001",
+ *       customFieldValues: [
+ *         { customFieldId: "cf-1", customFieldValue: "value1" },
+ *       ],
+ *     },
+ *   ],
+ * });
+ * ```
+ *
+ * @param {BulkUpdateLogisticOrderLinesCustomFieldsParameters} params - Path id and line payloads.
+ * @throws {Error} If `logisticOrderId` or `lines` is missing.
+ * @returns {Promise<BulkUpdateLogisticOrderLinesCustomFieldsResponse>}
+ */
+async function bulkUpdateLogisticOrderLinesCustomFields({ logisticOrderId, lines, }) {
+    (0, parameters_validation_1.required)({ logisticOrderId, lines });
+    const { data } = await (0, fetch_instance_1.enhancedFetch)({
+        method: "PATCH",
+        path: `/v1/shop/logistic-orders/${logisticOrderId}/lines`,
+        body: JSON.stringify(lines),
+    });
+    return data;
+}
 /**
  * 🚚 Updates specific logistic order line's customFields.
  *

package/package.json

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