@pinelab/vendure-plugin-qls-fulfillment 1.6.0 → 1.8.0

package/CHANGELOG.md

@@ -1,3 +1,11 @@
+# 1.8.0 (2026-04-21)
+
+- Added configurable `saveRawWarehouseStockData` option
+
+# 1.7.0 (2026-03-15)
+
+- Pass order phone number to QLS
+
 # 1.6.0 (2026-03-09)
 
 - Skip syncing disabled products/variants to QLS

package/dist/custom-fields.d.ts

@@ -2,6 +2,7 @@ import { CustomFieldConfig } from '@vendure/core';
 declare module '@vendure/core' {
     interface CustomProductVariantFields {
         qlsProductId?: string;
+        qlsRawWarehouseStockData?: string;
     }
     interface CustomOrderFields {
         qlsServicePointId?: string;

package/dist/custom-fields.js

@@ -15,6 +15,20 @@ function getVariantCustomFields(uiTab) {
             readonly: true,
             ui: { tab: uiTab },
         },
+        {
+            name: 'qlsRawWarehouseStockData',
+            type: 'text',
+            label: [
+                {
+                    value: 'QLS Raw Warehouse Stock Data',
+                    languageCode: core_1.LanguageCode.en,
+                },
+            ],
+            nullable: true,
+            public: false,
+            readonly: true,
+            ui: { tab: uiTab },
+        },
     ];
 }
 exports.orderCustomFields = [

package/dist/lib/client-types.d.ts

@@ -69,6 +69,7 @@ export type FulfillmentProduct = {
      * All EANs of the product, including the main EAN
      */
     barcodes_and_ean: string[];
+    warehouse_stocks?: unknown[];
 };
 export interface FulfillmentOrderInput {
     brand_id: string;

package/dist/lib/qls-client.d.ts

@@ -15,6 +15,7 @@ export declare class QlsClient {
      * Returns the first product found, or undefined if no product is found.
      */
     getFulfillmentProductBySku(sku: string): Promise<FulfillmentProduct | undefined>;
+    getFulfillmentProductById(fulfillmentProductId: string): Promise<FulfillmentProduct | undefined>;
     /**
      * Get stock for all fulfillment products.
      * Might require multiple requests if the result is paginated.

package/dist/lib/qls-client.js

@@ -34,6 +34,13 @@ class QlsClient {
         }
         return result.data[0];
     }
+    async getFulfillmentProductById(fulfillmentProductId) {
+        const result = await this.rawRequest('GET', `fulfillment/products/${fulfillmentProductId}`);
+        if (!result.data) {
+            return undefined;
+        }
+        return result.data;
+    }
     /**
      * Get stock for all fulfillment products.
      * Might require multiple requests if the result is paginated.

package/dist/qls-plugin.js

@@ -29,6 +29,7 @@ let QlsPlugin = QlsPlugin_1 = class QlsPlugin {
             synchronizeStockLevels: true,
             autoPushOrders: true,
             qlsProductIdUiTab: 'QLS',
+            saveRawWarehouseStockData: false,
             ...options,
         };
         return QlsPlugin_1;

package/dist/services/qls-order.service.js

@@ -177,7 +177,7 @@ let QlsOrderService = class QlsOrderService {
                     locality: order.shippingAddress.city,
                     country: order.shippingAddress.countryCode.toUpperCase(),
                     email: order.customer.emailAddress,
-                    phone: order.customer.phoneNumber,
+                    phone: order.shippingAddress.phoneNumber ?? order.customer.phoneNumber,
                 },
                 products: qlsProducts,
                 ...(additionalOrderFields ?? {}),

package/dist/services/qls-product.service.d.ts

@@ -62,7 +62,10 @@ export declare class QlsProductService implements OnModuleInit, OnApplicationBoo
     /**
      * Determines if a product needs to be created or updated in QLS based on the given variant and existing QLS product.
      */
-    createOrUpdateProductInQls(ctx: RequestContext, client: QlsClient, variant: ProductVariant, existingProduct: FulfillmentProduct | null): Promise<'created' | 'updated' | 'not-changed'>;
+    createOrUpdateProductInQls(ctx: RequestContext, client: QlsClient, variant: ProductVariant, existingProduct: FulfillmentProduct | null): Promise<{
+        status: 'created' | 'updated' | 'not-changed';
+        qlsProductId?: string;
+    }>;
     /**
      * Update the additional EANs/barcodes for a product in QLS if needed
      */

package/dist/services/qls-product.service.js

@@ -127,13 +127,13 @@ let QlsProductService = class QlsProductService {
                 try {
                     const existingQlsProduct = allQlsProducts.find((p) => p.sku == variant.sku);
                     const result = await this.createOrUpdateProductInQls(ctx, client, variant, existingQlsProduct ?? null);
-                    if (result === 'created') {
+                    if (result.status === 'created') {
                         createdQlsProducts.push(variant);
                     }
-                    else if (result === 'updated') {
+                    else if (result.status === 'updated') {
                         updatedQlsProducts.push(variant);
                     }
-                    if (result === 'created' || result === 'updated') {
+                    if (result.status === 'created' || result.status === 'updated') {
                         // Wait only if we created or updated a product, otherwise no calls have been made yet.
                         await waitToPreventRateLimit();
                     }
@@ -212,12 +212,23 @@ let QlsProductService = class QlsProductService {
             try {
                 const existingQlsProduct = await client.getFulfillmentProductBySku(variant.sku);
                 const result = await this.createOrUpdateProductInQls(ctx, client, variant, existingQlsProduct ?? null);
-                if (result === 'created') {
+                if (result.status === 'created') {
                     createdInQls.push(variant);
                 }
-                else if (result === 'updated') {
+                else if (result.status === 'updated') {
                     updatedInQls.push(variant);
                 }
+                if (result.qlsProductId && this.options.saveRawWarehouseStockData) {
+                    const qlsProduct = await client.getFulfillmentProductById(result.qlsProductId);
+                    // Update QLS warehouse stock data in Vendure, only on sync variants to prevent rate limit issues, and only if the option is enabled
+                    if (qlsProduct && qlsProduct.warehouse_stocks) {
+                        await this.connection.getRepository(ctx, core_1.ProductVariant).update({ id: variant.id }, {
+                            customFields: {
+                                qlsRawWarehouseStockData: JSON.stringify(qlsProduct.warehouse_stocks),
+                            },
+                        });
+                    }
+                }
             }
             catch (e) {
                 const error = (0, catch_unknown_1.asError)(e);
@@ -280,7 +291,7 @@ let QlsProductService = class QlsProductService {
     async createOrUpdateProductInQls(ctx, client, variant, existingProduct) {
         if (await this.options.excludeVariantFromSync?.(ctx, new core_1.Injector(this.moduleRef), variant)) {
             core_1.Logger.info(`Variant '${variant.sku}' excluded from sync to QLS.`, constants_1.loggerCtx);
-            return 'not-changed';
+            return { status: 'not-changed' };
         }
         if (!variant.enabled || !variant.product?.enabled) {
             const disabledEntity = !variant.enabled ? 'Variant' : 'Product';
@@ -290,7 +301,7 @@ let QlsProductService = class QlsProductService {
             else {
                 core_1.Logger.info(`${disabledEntity} '${variant.sku}' is disabled, skipping sync to QLS.`, constants_1.loggerCtx);
             }
-            return 'not-changed';
+            return { status: 'not-changed', qlsProductId: existingProduct?.id };
         }
         let qlsProduct = existingProduct;
         let createdOrUpdated = 'not-changed';
@@ -332,7 +343,7 @@ let QlsProductService = class QlsProductService {
         if (createdOrUpdated === 'not-changed') {
             core_1.Logger.info(`Variant '${variant.sku}' not updated in QLS, because no changes were found.`, constants_1.loggerCtx);
         }
-        return createdOrUpdated;
+        return { status: createdOrUpdated, qlsProductId: qlsProduct?.id };
     }
     /**
      * Update the additional EANs/barcodes for a product in QLS if needed

package/dist/types.d.ts

@@ -53,6 +53,12 @@ export interface QlsPluginOptions {
      * Defaults to 'QLS'.
      */
     qlsProductIdUiTab?: string | null;
+    /**
+     * After syncing a variant to QLS, fetch the full product from QLS and save
+     * the raw warehouse stock data in the `qlsRawWarehouseStockData` custom field.
+     * Defaults to false.
+     */
+    saveRawWarehouseStockData?: boolean;
     /**
      * Additional order items to add to the QLS order.
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pinelab/vendure-plugin-qls-fulfillment",
-  "version": "1.6.0",
+  "version": "1.8.0",
   "description": "Vendure plugin to fulfill orders via QLS.",
   "keywords": [
     "fulfillment",