@pinelab/vendure-plugin-qls-fulfillment 2.1.0 → 2.2.1

package/CHANGELOG.md

@@ -1,3 +1,11 @@
+# 2.2.1 (2026-07-15)
+
+- Emit `StockMovementEvent` with corresponding `StockAdjustment` whenever a QLS webhook updates stock of a variant.
+
+# 2.2.0 (2026-07-15)
+
+- Added buttons on variant and order detail to view the product and order in QLS dashboard.
+
 # 2.1.0 (2026-07-08)
 
 - Added `addAdditionalEANSToQLS` admin mutation to manually add additional EANs/barcodes to existing QLS products.

package/dist/api/api-extensions.js

@@ -11,6 +11,18 @@ exports.adminApiExtensions = (0, graphql_tag_1.default) `
     QLS order id(s) for this Vendure order.
     """
     qlsOrderIds: [String!]!
+
+    """
+    Direct URL to the most recent QLS order for this Vendure order, or null if none exists.
+    """
+    qlsOrderUrl: String
+  }
+
+  extend type ProductVariant {
+    """
+    Direct URL to the QLS product for this Vendure variant, or null if none exists.
+    """
+    qlsProductUrl: String
   }
 
   extend type Mutation {

package/dist/api/generated/graphql.d.ts

@@ -42,6 +42,13 @@ export type Order = {
     __typename?: 'Order';
     /** QLS order id(s) for this Vendure order. */
     qlsOrderIds: Array<Scalars['String']>;
+    /** Direct URL to the most recent QLS order for this Vendure order, or null if none exists. */
+    qlsOrderUrl?: Maybe<Scalars['String']>;
+};
+export type ProductVariant = {
+    __typename?: 'ProductVariant';
+    /** Direct URL to the QLS product for this Vendure variant, or null if none exists. */
+    qlsProductUrl?: Maybe<Scalars['String']>;
 };
 export type QlsServicePoint = {
     __typename?: 'QlsServicePoint';

package/dist/api/qls-admin.resolver.d.ts

@@ -1,4 +1,4 @@
-import { Order, RequestContext } from '@vendure/core';
+import { Order, ProductVariant, RequestContext } from '@vendure/core';
 import { QlsOrderService } from '../services/qls-order.service';
 import { QlsProductService } from '../services/qls-product.service';
 import { MutationAddAdditionalEansToQlsArgs, MutationPushOrderToQlsArgs } from './generated/graphql';
@@ -7,6 +7,8 @@ export declare class QlsAdminResolver {
     private qlsOrderService;
     constructor(qlsProductService: QlsProductService, qlsOrderService: QlsOrderService);
     qlsOrderIds(ctx: RequestContext, order: Order): Promise<string[]>;
+    qlsOrderUrl(ctx: RequestContext, order: Order): Promise<string | null>;
+    qlsProductUrl(ctx: RequestContext, productVariant: ProductVariant): Promise<string | null>;
     triggerQlsProductSync(ctx: RequestContext): Promise<boolean>;
     addAdditionalEANSToQLS(ctx: RequestContext, input: MutationAddAdditionalEansToQlsArgs): Promise<string[]>;
     pushOrderToQls(ctx: RequestContext, input: MutationPushOrderToQlsArgs): Promise<string>;

package/dist/api/qls-admin.resolver.js

@@ -26,6 +26,12 @@ let QlsAdminResolver = class QlsAdminResolver {
     async qlsOrderIds(ctx, order) {
         return this.qlsOrderService.getQlsOrderIdsForOrder(ctx, order.id);
     }
+    async qlsOrderUrl(ctx, order) {
+        return this.qlsOrderService.getQlsOrderUrl(ctx, order.id);
+    }
+    async qlsProductUrl(ctx, productVariant) {
+        return this.qlsProductService.getQlsProductUrl(ctx, productVariant);
+    }
     async triggerQlsProductSync(ctx) {
         await this.qlsProductService.triggerFullSync(ctx);
         return true;
@@ -50,6 +56,28 @@ __decorate([
         core_1.Order]),
     __metadata("design:returntype", Promise)
 ], QlsAdminResolver.prototype, "qlsOrderIds", null);
+__decorate([
+    (0, graphql_1.ResolveField)(),
+    (0, graphql_1.Resolver)('Order'),
+    (0, core_1.Allow)(permissions_1.qlsPushOrderPermission.Permission),
+    (0, core_1.Allow)(core_1.Permission.UpdateAdministrator),
+    __param(0, (0, core_1.Ctx)()),
+    __param(1, (0, graphql_1.Parent)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [core_1.RequestContext,
+        core_1.Order]),
+    __metadata("design:returntype", Promise)
+], QlsAdminResolver.prototype, "qlsOrderUrl", null);
+__decorate([
+    (0, graphql_1.ResolveField)(),
+    (0, graphql_1.Resolver)('ProductVariant'),
+    __param(0, (0, core_1.Ctx)()),
+    __param(1, (0, graphql_1.Parent)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [core_1.RequestContext,
+        core_1.ProductVariant]),
+    __metadata("design:returntype", Promise)
+], QlsAdminResolver.prototype, "qlsProductUrl", null);
 __decorate([
     (0, graphql_1.Mutation)(),
     (0, core_1.Transaction)(),

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

@@ -36,6 +36,11 @@ export declare class QlsOrderService implements OnModuleInit, OnApplicationBoots
      * Get QLS order id(s) for a Vendure order (for Order.qlsOrderIds field).
      */
     getQlsOrderIdsForOrder(ctx: RequestContext, orderId: ID): Promise<string[]>;
+    /**
+     * Get the direct URL to the most recent QLS order for a Vendure order (for Order.qlsOrderUrl field).
+     * Returns the URL or null if no QLS order exists.
+     */
+    getQlsOrderUrl(ctx: RequestContext, orderId: ID): Promise<string | null>;
     getServicePoints(ctx: RequestContext, input: QlsServicePointSearchInput): Promise<QlsServicePoint[]>;
     private getVendureOrderState;
 }

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

@@ -281,9 +281,30 @@ let QlsOrderService = class QlsOrderService {
             .getRepository(ctx, qls_order_entity_entity_1.QlsOrderEntity)
             .find({
             where: { vendureOrderId: orderId },
+            order: { createdAt: 'DESC' },
         });
         return entities.map((e) => String(e.qlsOrderId));
     }
+    /**
+     * Get the direct URL to the most recent QLS order for a Vendure order (for Order.qlsOrderUrl field).
+     * Returns the URL or null if no QLS order exists.
+     */
+    async getQlsOrderUrl(ctx, orderId) {
+        const entities = await this.connection
+            .getRepository(ctx, qls_order_entity_entity_1.QlsOrderEntity)
+            .find({
+            where: { vendureOrderId: orderId },
+            order: { createdAt: 'DESC' },
+        });
+        if (entities.length === 0) {
+            return null;
+        }
+        const config = await Promise.resolve(this.options.getConfig(ctx));
+        if (!config) {
+            return null;
+        }
+        return `https://mijn.pakketdienstqls.nl/company/${config.companyId}/fulfillment/order/${entities[0].qlsOrderId}`;
+    }
     async getServicePoints(ctx, input) {
         const client = await (0, qls_client_1.getQlsClient)(ctx, this.options);
         if (!client) {

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

@@ -55,15 +55,21 @@ export declare class QlsProductService implements OnModuleInit, OnApplicationBoo
      * Trigger a product sync job for particular product variants
      */
     triggerSyncVariants(ctx: RequestContext, productVariantIds: ID[]): Promise<import("@vendure/core/dist/job-queue/subscribable-job").SubscribableJob<QlsProductJobData> | undefined>;
+    /**
+     * Get the direct URL to the QLS product for a Vendure product variant.
+     * Returns the URL or null if no QLS product exists.
+     */
+    getQlsProductUrl(ctx: RequestContext, productVariant: ProductVariant): Promise<string | null>;
     /**
      * Add additional EANs/barcodes to an existing QLS product.
      * Removal of EANs must be done in QLS itself.
      */
     addAdditionalEANsToQls(ctx: RequestContext, variantId: ID, additionalEANs: string[]): Promise<string[]>;
     /**
-     * Update the stock level for a variant based on the given available stock
+     * Update the stock level for a variant based on the given available stock.
+     * Returns true if the stock changed
      */
-    updateStockBySku(ctx: RequestContext, sku: string, availableStock: number): Promise<void>;
+    updateStockBySku(ctx: RequestContext, sku: string, availableStock: number): Promise<boolean>;
     /**
      * Determines if a product needs to be created or updated in QLS based on the given variant and existing QLS product.
      */
@@ -80,7 +86,8 @@ export declare class QlsProductService implements OnModuleInit, OnApplicationBoo
      */
     private getAllVariants;
     /**
-     * Update stock level for a variant based on the given available stock
+     * Update stock level for a variant based on the given available stock.
+     * Returns true if the stock changed.
      */
     private updateStock;
 }

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

@@ -269,6 +269,21 @@ let QlsProductService = class QlsProductService {
             productVariantIds,
         }, { retries: 1 });
     }
+    /**
+     * Get the direct URL to the QLS product for a Vendure product variant.
+     * Returns the URL or null if no QLS product exists.
+     */
+    async getQlsProductUrl(ctx, productVariant) {
+        const qlsProductId = productVariant.customFields?.qlsProductId;
+        if (!qlsProductId) {
+            return null;
+        }
+        const config = await Promise.resolve(this.options.getConfig(ctx));
+        if (!config) {
+            return null;
+        }
+        return `https://mijn.pakketdienstqls.nl/company/${config.companyId}/fulfillment/product/${qlsProductId}`;
+    }
     /**
      * Add additional EANs/barcodes to an existing QLS product.
      * Removal of EANs must be done in QLS itself.
@@ -297,20 +312,22 @@ let QlsProductService = class QlsProductService {
         return eansToAdd;
     }
     /**
-     * Update the stock level for a variant based on the given available stock
+     * Update the stock level for a variant based on the given available stock.
+     * Returns true if the stock changed
      */
     async updateStockBySku(ctx, sku, availableStock) {
         const result = await this.variantService.findAll(ctx, {
             filter: { sku: { eq: sku } },
         });
         if (!result.items.length) {
-            return core_1.Logger.info(`Variant with sku '${sku}' not found, not updating stock`, constants_1.loggerCtx);
+            core_1.Logger.info(`Variant with sku '${sku}' not found, not updating stock`, constants_1.loggerCtx);
+            return false;
         }
         const variant = result.items[0];
         if (result.items.length > 1) {
             core_1.Logger.error(`Multiple variants found for sku '${sku}', using '${variant.id}'`, constants_1.loggerCtx);
         }
-        await this.updateStock(ctx, variant.id, availableStock);
+        return await this.updateStock(ctx, variant.id, availableStock);
     }
     /**
      * Determines if a product needs to be created or updated in QLS based on the given variant and existing QLS product.
@@ -416,24 +433,43 @@ let QlsProductService = class QlsProductService {
         return allVariants;
     }
     /**
-     * Update stock level for a variant based on the given available stock
+     * Update stock level for a variant based on the given available stock.
+     * Returns true if the stock changed.
      */
     async updateStock(ctx, variantId, availableStock) {
         if (!this.options.productSync.synchronizeStockLevels) {
             core_1.Logger.warn(`Stock sync disabled. Not updating stock for variant '${variantId}'`, constants_1.loggerCtx);
-            return;
+            return false;
         }
         // Find default Stock Location
         const defaultStockLocation = await this.stockLocationService.defaultStockLocation(ctx);
-        // Get current stock level id
-        const { id: stockLevelId } = await this.stockLevelService.getStockLevel(ctx, variantId, defaultStockLocation.id);
-        // Update stock level
-        await this.connection.getRepository(ctx, core_1.StockLevel).save({
-            id: stockLevelId,
-            stockOnHand: availableStock,
-            stockAllocated: 0, // Reset allocations, because allocation is handled by QLS
-        });
+        // Get current stock level
+        const stockLevel = await this.stockLevelService.getStockLevel(ctx, variantId, defaultStockLocation.id);
+        const delta = availableStock - stockLevel.stockOnHand;
+        if (delta !== 0) {
+            const adjustment = new core_1.StockAdjustment({
+                quantity: delta,
+                stockLocation: { id: defaultStockLocation.id },
+                productVariant: { id: variantId },
+            });
+            // Update stock level
+            await this.connection.getRepository(ctx, core_1.StockLevel).save({
+                id: stockLevel.id,
+                stockOnHand: availableStock,
+                stockAllocated: 0, // Reset allocations, because allocation is handled by QLS
+            });
+            await this.eventBus.publish(new core_1.StockMovementEvent(ctx, [adjustment]));
+        }
+        else {
+            // No stock change, but still reset allocations to ensure consistency
+            await this.connection.getRepository(ctx, core_1.StockLevel).save({
+                id: stockLevel.id,
+                stockOnHand: availableStock,
+                stockAllocated: 0, // Reset allocations, because allocation is handled by QLS
+            });
+        }
         core_1.Logger.info(`Updated stock for variant ${variantId} to ${availableStock}`, constants_1.loggerCtx);
+        return delta !== 0;
     }
 };
 exports.QlsProductService = QlsProductService;

package/dist/ui/providers.ts

@@ -1,8 +1,10 @@
 import {
   addActionBarDropdownMenuItem,
+  addActionBarItem,
   ModalService,
 } from '@vendure/admin-ui/core';
-import { firstValueFrom } from 'rxjs';
+import { firstValueFrom, of } from 'rxjs';
+import { map, catchError } from 'rxjs/operators';
 import gql from 'graphql-tag';
 
 export default [
@@ -38,6 +40,82 @@ export default [
         });
     },
   }),
+  // QLS order link button on order detail page
+  addActionBarItem({
+    id: 'qls-visit-order',
+    label: 'QLS',
+    locationId: 'order-detail',
+    buttonColor: 'primary',
+    buttonStyle: 'outline',
+    icon: 'link',
+    buttonState: (context) => {
+      return context.entity$.pipe(
+        map((entity) => ({
+          visible: !!entity?.orderPlacedAt,
+          disabled: false,
+        }))
+      );
+    },
+    onClick: async (event, { route, dataService, notificationService }) => {
+      const orderId = route.snapshot.params.id;
+      const res = await firstValueFrom(
+        dataService.query(
+          gql`
+            query Order($orderId: ID!) {
+              order(id: $orderId) {
+                id
+                qlsOrderUrl
+              }
+            }
+          `,
+          { orderId }
+        ).single$
+      );
+      const url = (res as any).order.qlsOrderUrl;
+      if (url) {
+        window.open(url, '_blank');
+      } else {
+        notificationService.notify({
+          message: 'No QLS order found for this order.',
+          type: 'error',
+        });
+      }
+    },
+  }),
+  // QLS product link button on product variant detail page
+  addActionBarItem({
+    id: 'qls-visit-product',
+    label: 'QLS',
+    locationId: 'product-variant-detail',
+    buttonColor: 'primary',
+    buttonStyle: 'outline',
+    icon: 'link',
+    onClick: async (event, { route, dataService, notificationService }) => {
+      const variantId = route.snapshot.params.id;
+      const res = await firstValueFrom(
+        dataService.query(
+          gql`
+            query ProductVariant($id: ID!) {
+              productVariant(id: $id) {
+                id
+                qlsProductUrl
+              }
+            }
+          `,
+          { id: variantId }
+        ).single$
+      );
+      const url = (res as any).productVariant.qlsProductUrl;
+      if (url) {
+        window.open(url, '_blank');
+      } else {
+        notificationService.notify({
+          message: 'No QLS product found for this variant.',
+          type: 'error',
+        });
+      }
+    },
+  }),
   // Push order to QLS button on order detail page
   addActionBarDropdownMenuItem({
     id: 'qls-fulfillment-push-order',

package/package.json

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