@pinelab/vendure-plugin-qls-fulfillment 1.9.0 → 2.0.0

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+# 2.0.0 (2026-06-10)
+
+- Restructure plugin options into nested `orderSync` and `productSync` objects. This is a **breaking change**: all plugin options must now be organized under `orderSync` (for order-related hooks) and `productSync` (for product-related hooks).
+- Renamed `getAdditionalOrderFields` to `pushAdditionalOrderFields` in `orderSync` options.
+- Added `pullAdditionalOrderFields` hook in `orderSync` options, called after an order is successfully created in QLS. Errors in this hook are caught and logged, and will not fail the order push job.
+
 # 1.9.0 (2026-08-05)
 
 - Upgraded to Vendure 3.6.3

package/README.md

@@ -23,7 +23,52 @@ This plugin contains:
 
 ## Getting started
 
-// TODO
+```ts
+import { QlsPlugin } from '@pinelab/vendure-plugin-qls-fulfillment';
+
+// In your VendureConfig:
+plugins: [
+  QlsPlugin.init({
+    getConfig: (ctx) => {
+      // Return config for the current channel, or undefined to disable QLS for this channel
+      return {
+        username: 'qls-username',
+        password: 'qls-password',
+        companyId: 'your-company-id',
+        brandId: 'your-brand-id',
+      };
+    },
+    webhookSecret: 'your-random-secret',
+    productSync: {
+      // Required: map Vendure variants to QLS product fields
+      getAdditionalVariantFields: (ctx, variant) => ({
+        ean: variant.sku,
+        image_url: `https://your-cdn.com/${variant.featuredAsset?.preview}`,
+        additionalEANs: ['1234567890'],
+      }),
+      // Optional: exclude certain variants from being synced to QLS
+      excludeVariantFromSync: (ctx, injector, variant) => {
+        return variant.sku.startsWith('DONOTSYNC');
+      },
+    },
+    orderSync: {
+      // Optional: push additional fields to QLS when creating an order
+      pushAdditionalOrderFields: (ctx, injector, order) => ({
+        custom_values: [
+          {
+            key: 'vendureOrder',
+            value: `https://your-admin.com/admin/orders/${order.code}`,
+          },
+        ],
+      }),
+      // Optional: delay order processing in QLS by 2 hours
+      processOrderFrom: (ctx, order) => {
+        return new Date(Date.now() + 1000 * 60 * 60 * 2);
+      },
+    },
+  }),
+];
+```
 
 This plugin requires the default order process to be configured with `checkFulfillmentStates: false`, so that orders can be transitioned to Shipped and Delivered without the need of fulfillment. Fulfillment is the responsibility of Picqer, so we won't handle that in Vendure when using this plugin.
 

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

@@ -165,3 +165,395 @@ export interface FulfillmentOrder {
 }
 export type IncomingStockWebhook = Pick<FulfillmentProduct, 'sku' | 'amount_available'>;
 export type IncomingOrderWebhook = Pick<FulfillmentOrder, 'customer_reference' | 'status' | 'cancelled' | 'amount_delivered' | 'amount_total'>;
+/**
+ * This is the full data returend by the QLS API when fetching a fulfillment product by ID
+ * Getting via list, sku or filtering does NOT return this full object
+ */
+export interface FulfillmentProductDetail {
+    data: Data;
+    meta: Meta;
+    errors: any[];
+    pagination: any;
+}
+export interface Data {
+    id: string;
+    company_id: string;
+    collection_id: any;
+    dimensions: Dimensions;
+    article_number: any;
+    ean: string;
+    name: string;
+    sku: string;
+    image_url: string;
+    country_code_of_origin: any;
+    hs_code: any;
+    need_barcode_picking: boolean;
+    need_best_before_stock: boolean;
+    need_serial_number: boolean;
+    amount_available: number;
+    amount_reserved: number;
+    amount_total: number;
+    price_cost: number;
+    price_store: any;
+    weight: number;
+    created: string;
+    modified: string;
+    foldable: boolean;
+    fulfillment_product_brand_id: string;
+    description: any;
+    amount_blocked: number;
+    status: any;
+    bundles: any[];
+    product_brand: ProductBrand;
+    product_values: ProductValue[];
+    suppliers: Supplier[];
+    vas: Va[];
+    product_master_cartons: any[];
+    product_measurements: ProductMeasurement[];
+    barcodes: any[];
+    warehouse_stock_transfers: WarehouseStockTransfer[];
+    bundle_products: any[];
+    warehouse_stocks: WarehouseStock[];
+    mappings: Mapping[];
+    order_unit: any;
+    image_url_handheld: string;
+    barcodes_and_ean: string[];
+}
+export interface Dimensions {
+    length: string;
+    width: string;
+    height: string;
+}
+export interface ProductBrand {
+    id: string;
+    company_id: string;
+    name: string;
+}
+export interface ProductValue {
+    id: number;
+    fulfillment_product_id: string;
+    key: string;
+    value: string;
+}
+export interface Supplier {
+    id: string;
+    company_id: string;
+    name: string;
+    _joinData: JoinData;
+}
+export interface JoinData {
+    id: number;
+    fulfillment_product_id: string;
+    supplier_id: string;
+    supplier_code: any;
+}
+export interface Va {
+    id: number;
+    fulfillment_product_id: string;
+    vas_id: number;
+    value_added_service: ValueAddedService;
+}
+export interface ValueAddedService {
+    id: number;
+    short: string;
+    name: string;
+    type_id: number;
+    price: number;
+    description: string;
+    entity_type?: string;
+    entity_id?: number;
+    company_id: any;
+    enabled: boolean;
+    parent_id: any;
+    sort: number;
+    visible: boolean;
+    setting: Setting;
+    vas_type: VasType;
+}
+export interface Setting {
+    use_for_tote_hash: number;
+}
+export interface VasType {
+    id: number;
+    short: string;
+    name: string;
+    description: any;
+    type: string;
+    info_text?: string;
+}
+export interface ProductMeasurement {
+    id: string;
+    product_id: string;
+    dimensions: Dimensions2;
+    weight: number;
+    product_measurementscol: any;
+    creator: string;
+    creator_company_id?: string;
+    creator_user_id?: string;
+    created: string;
+    creator_user?: CreatorUser;
+}
+export interface Dimensions2 {
+    length: string;
+    width: string;
+    height: string;
+}
+export interface CreatorUser {
+    id: string;
+    email: string;
+    firstname: string;
+    lastname: string;
+    role: string;
+    permissions: any;
+    created: string;
+    modified: string;
+    language_id: number;
+    personnel_number: string;
+    has_beta_version: boolean;
+    password_changed: string;
+    remember_token: string;
+    email_verified_at: any;
+}
+export interface WarehouseStockTransfer {
+    id: string;
+    company_id: string;
+    product_id: string;
+    source_stock_id: any;
+    amount_total: number;
+    amount_transferred: number;
+    remarks: any;
+    source: string;
+    status: string;
+    created: string;
+    modified: string;
+    best_before: any;
+    fulfillment_product_batch_id: any;
+    creator_user_id: string;
+    purchase_order_label_product_id: any;
+    purchase_order_label_product: any;
+    warehouse_stock_transfer_box_mappings: WarehouseStockTransferBoxMapping[];
+    creator: Creator;
+    company: Company;
+    amount_pending: number;
+}
+export interface WarehouseStockTransferBoxMapping {
+    id: string;
+    box_id: string;
+    transfer_id: string;
+    created: string;
+    modified: string;
+    deleted: any;
+    warehouse_box: WarehouseBox;
+}
+export interface WarehouseBox {
+    id: string;
+    company_id: string;
+    trolley_id: any;
+    warehouse_id: number;
+    type_id: any;
+    code: string;
+    position: any;
+    created: string;
+    modified: string;
+    deleted: any;
+    prefix: string;
+}
+export interface Creator {
+    id: string;
+    email: string;
+    firstname: string;
+    lastname: string;
+    role: string;
+    permissions: any;
+    created: string;
+    modified: string;
+    language_id: number;
+    personnel_number: any;
+    has_beta_version: boolean;
+    password_changed: string;
+    remember_token: string;
+    email_verified_at: any;
+}
+export interface Company {
+    id: string;
+    tenant_id: string;
+    affiliate_id: any;
+    name: string;
+    anonymous_name: string;
+    invoice_contact_id: string;
+    active: boolean;
+    shipments_last_7_days: number;
+    legacy_shipments_last_7_days: number;
+    heavy_shipments: boolean;
+    default_user_role_id: string;
+    financial_relation_id: string;
+    has_employee: boolean;
+    has_fulfillment: boolean;
+    has_route: boolean;
+    has_signed_gdpr: boolean;
+    pickup_timeframe_start: any;
+    pickup_timeframe_end: any;
+    fulfillment_average_handling_time: any;
+    outstanding_invoices_status: string;
+    outstanding_invoices_amount: number;
+    legal_companyname: any;
+    legal_coc: any;
+    legal_vat: any;
+    onboarding_status: string;
+    status: string;
+    created: string;
+    modified: string;
+    deleted: any;
+    price_change: any;
+    auto_secondwave: boolean;
+    priority_support: boolean;
+    mollie_customer_id: any;
+    company_group_id: any;
+    test: boolean;
+    enable_software_charge: boolean;
+}
+export interface WarehouseStock {
+    id: number;
+    product_id: string;
+    autostore_bin_id: string;
+    zone_id: number;
+    row_number: string;
+    rack_number: string;
+    shelf_number: string;
+    number: string;
+    amount_current: number;
+    amount_reserved: number;
+    best_before: any;
+    created: string;
+    modified: string;
+    deleted: any;
+    best_before_cutoff: any;
+    blocked: any;
+    autostore_bin: AutostoreBin;
+    warehouse_zone: WarehouseZone;
+    product_batch: any[];
+    amount_available: number;
+    code: string;
+    code_formatted: string;
+    is_changed_for_replenishment: boolean;
+    location: string;
+}
+export interface AutostoreBin {
+    id: string;
+    autostore_id: string;
+    autostore_bin_id: number;
+    autostore_bin_layout_id: string;
+    zone_id: number;
+    content_code: string;
+    bin_type: number;
+    created?: string;
+    modified: string;
+    deleted: any;
+    depth: number;
+    xpos: number;
+    ypos: number;
+    transferred_in: string;
+    mode: string;
+}
+export interface WarehouseZone {
+    id: number;
+    company_id: string;
+    name: string;
+    pickable: boolean;
+    flip_row_numbers: boolean;
+    warehouse_id: number;
+    batchable: boolean;
+    isolated: boolean;
+    autostore_id: string;
+    has_pallets: boolean;
+    block_reservation_after: any;
+    warehouse_zone_group_id: any;
+    has_quarantine: boolean;
+    partially_replenishment_allowed: boolean;
+    allow_automatic_replenishment: boolean;
+    company: Company2;
+}
+export interface Company2 {
+    id: string;
+    tenant_id: string;
+    affiliate_id: any;
+    name: string;
+    anonymous_name: string;
+    invoice_contact_id: string;
+    active: boolean;
+    shipments_last_7_days: number;
+    legacy_shipments_last_7_days: number;
+    heavy_shipments: boolean;
+    default_user_role_id: string;
+    financial_relation_id: string;
+    has_employee: boolean;
+    has_fulfillment: boolean;
+    has_route: boolean;
+    has_signed_gdpr: boolean;
+    pickup_timeframe_start: any;
+    pickup_timeframe_end: any;
+    fulfillment_average_handling_time: any;
+    outstanding_invoices_status: string;
+    outstanding_invoices_amount: number;
+    legal_companyname: any;
+    legal_coc: any;
+    legal_vat: any;
+    onboarding_status: string;
+    status: string;
+    created: string;
+    modified: string;
+    deleted: any;
+    price_change: any;
+    auto_secondwave: boolean;
+    priority_support: boolean;
+    mollie_customer_id: any;
+    company_group_id: any;
+    test: boolean;
+    enable_software_charge: boolean;
+}
+export interface Mapping {
+    id: string;
+    product_id: string;
+    shop_integration_id: string;
+    shop_integration_reference: string;
+    shop_integration_reference2: string;
+    stock: number;
+    sync_stock: boolean;
+    created: string;
+    modified: string;
+    deleted: any;
+    synced: string;
+    exception_count: number;
+    name: string;
+    ean: string;
+    sku: string;
+    shop_integration: ShopIntegration;
+}
+export interface ShopIntegration {
+    id: string;
+    company_id: string;
+    brand_id: string;
+    type_id: number;
+    name: string;
+    created: string;
+    modified: string;
+    deleted: any;
+    last_imported: string;
+    last_imported_order_insights: any;
+    last_imported_shipment_insights: any;
+    last_imported_purchase_order: any;
+    fulfillment_sync_orders: boolean;
+    fulfillment_sync_products: boolean;
+    fulfillment_sync_stock: boolean;
+    fulfillment_sync_purchase_orders: boolean;
+    fulfillment_product_create_new: boolean;
+    fulfillment_product_match_by_name: boolean;
+    fulfillment_product_match_by_ean: boolean;
+    fulfillment_product_match_by_sku: boolean;
+    fulfillment_product_match_fields: string;
+    last_imported_products: any;
+    exception_count_importing_products: number;
+}
+export interface Meta {
+    code: number;
+}

package/dist/lib/client-types.js

@@ -1,4 +1,5 @@
 "use strict";
+/* eslint-disable @typescript-eslint/no-explicit-any */
 /**
  * QLS API types only
  */

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

@@ -1,6 +1,6 @@
 import { RequestContext } from '@vendure/core';
 import { QlsClientConfig, QlsPluginOptions } from '../types';
-import type { FulfillmentOrder, FulfillmentOrderInput, FulfillmentProduct, FulfillmentProductInput, QlsApiResponse } from './client-types';
+import type { FulfillmentOrder, FulfillmentOrderInput, FulfillmentProduct, FulfillmentProductDetail, FulfillmentProductInput, QlsApiResponse } from './client-types';
 import { QlsServicePoint } from '../api/generated/graphql';
 export declare function getQlsClient(ctx: RequestContext, pluginOptions: QlsPluginOptions): Promise<QlsClient | undefined>;
 /**
@@ -15,7 +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>;
+    getFulfillmentProductById(fulfillmentProductId: string): Promise<FulfillmentProductDetail | undefined>;
     /**
      * Get stock for all fulfillment products.
      * Might require multiple requests if the result is paginated.

package/dist/qls-plugin.js

@@ -26,10 +26,16 @@ const qls_order_entity_entity_1 = require("./entities/qls-order-entity.entity");
 let QlsPlugin = QlsPlugin_1 = class QlsPlugin {
     static init(options) {
         this.options = {
-            synchronizeStockLevels: true,
-            autoPushOrders: true,
-            qlsProductIdUiTab: 'QLS',
             ...options,
+            orderSync: {
+                autoPushOrders: true,
+                ...options.orderSync,
+            },
+            productSync: {
+                synchronizeStockLevels: true,
+                qlsProductIdUiTab: 'QLS',
+                ...options.productSync,
+            },
         };
         return QlsPlugin_1;
     }
@@ -55,7 +61,7 @@ exports.QlsPlugin = QlsPlugin = QlsPlugin_1 = __decorate([
         configuration: (config) => {
             config.authOptions.customPermissions.push(permissions_1.qlsFullSyncPermission);
             config.authOptions.customPermissions.push(permissions_1.qlsPushOrderPermission);
-            config.customFields.ProductVariant.push(...(0, custom_fields_1.getVariantCustomFields)(QlsPlugin.options?.qlsProductIdUiTab));
+            config.customFields.ProductVariant.push(...(0, custom_fields_1.getVariantCustomFields)(QlsPlugin.options?.productSync?.qlsProductIdUiTab));
             config.customFields.Order.push(...custom_fields_1.orderCustomFields);
             return config;
         },

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

@@ -37,7 +37,7 @@ let QlsOrderService = class QlsOrderService {
     onApplicationBootstrap() {
         // Listen for OrderPlacedEvent and add a job to the queue
         this.eventBus.ofType(core_2.OrderPlacedEvent).subscribe((event) => {
-            if (!this.options.autoPushOrders) {
+            if (!this.options.orderSync.autoPushOrders) {
                 core_2.Logger.info(`Auto push orders disabled, not triggering push order job for order ${event.order.code}`, constants_1.loggerCtx);
                 return;
             }
@@ -111,7 +111,7 @@ let QlsOrderService = class QlsOrderService {
             const qlsProducts = [];
             await Promise.all(order.lines.map(async (line) => {
                 // Check if product variant should be excluded from sync
-                if (await this.options.excludeVariantFromSync?.(ctx, new core_2.Injector(this.moduleRef), line.productVariant)) {
+                if (await this.options.productSync.excludeVariantFromSync?.(ctx, new core_2.Injector(this.moduleRef), line.productVariant)) {
                     core_2.Logger.info(`Product variant '${line.productVariant.sku}' not sent to QLS in order '${order.code}' because it is excluded from sync.`, constants_1.loggerCtx);
                     return;
                 }
@@ -127,7 +127,7 @@ let QlsOrderService = class QlsOrderService {
             }));
             // Add additional order items, if any
             try {
-                const additionalOrderItems = await this.options.addAdditionalOrderItems?.(ctx, new core_2.Injector(this.moduleRef), order);
+                const additionalOrderItems = await this.options.orderSync.addAdditionalOrderItems?.(ctx, new core_2.Injector(this.moduleRef), order);
                 if (additionalOrderItems) {
                     qlsProducts.push(...additionalOrderItems);
                 }
@@ -142,7 +142,7 @@ let QlsOrderService = class QlsOrderService {
                 core_2.Logger.info(message, constants_1.loggerCtx);
                 return message;
             }
-            const additionalOrderFields = await this.options.getAdditionalOrderFields?.(ctx, new core_2.Injector(this.moduleRef), order);
+            const additionalOrderFields = await this.options.orderSync.pushAdditionalOrderFields?.(ctx, new core_2.Injector(this.moduleRef), order);
             const customerName = [order.customer?.firstName, order.customer?.lastName]
                 .filter(Boolean)
                 .join(' ');
@@ -160,8 +160,9 @@ let QlsOrderService = class QlsOrderService {
                 !order.shippingAddress.countryCode) {
                 throw new Error(`Shipping address for order '${order.code}' is missing one of required fields: streetLine1, postalCode, city, streetLine2, countryCode. Can not push order to QLS.`);
             }
-            const processable = (await this.options.processOrderFrom?.(ctx, order)) ?? new Date();
-            const receiverContact = this.options.getReceiverContact?.(ctx, order);
+            const processable = (await this.options.orderSync.processOrderFrom?.(ctx, order)) ??
+                new Date();
+            const receiverContact = this.options.orderSync.getReceiverContact?.(ctx, order);
             const qlsOrder = {
                 customer_reference: order.code,
                 processable: processable.toISOString(),
@@ -206,6 +207,13 @@ let QlsOrderService = class QlsOrderService {
                 const error = (0, catch_unknown_1.asError)(e);
                 core_2.Logger.error(`Error saving QLS order entity for order '${order.code}': ${error.message}`, constants_1.loggerCtx, error.stack);
             });
+            try {
+                await this.options.orderSync.pullAdditionalOrderFields?.(ctx, new core_2.Injector(this.moduleRef), order, result);
+            }
+            catch (e) {
+                const error = (0, catch_unknown_1.asError)(e);
+                core_2.Logger.error(`Error in pullAdditionalOrderFields for order '${order.code}': ${error.message}`, constants_1.loggerCtx, error.stack);
+            }
             return `Order '${order.code}' created in QLS with id '${result.id}'`;
         }
         catch (e) {

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

@@ -218,11 +218,12 @@ let QlsProductService = class QlsProductService {
                 else if (result.status === 'updated') {
                     updatedInQls.push(variant);
                 }
-                if (result.qlsProductId && this.options.saveAdditionalData) {
+                if (result.qlsProductId &&
+                    this.options.productSync.saveAdditionalVariantData) {
                     try {
                         const qlsProduct = await client.getFulfillmentProductById(result.qlsProductId);
                         if (qlsProduct) {
-                            await this.options.saveAdditionalData(ctx, new core_1.Injector(this.moduleRef), qlsProduct, variant);
+                            await this.options.productSync.saveAdditionalVariantData(ctx, new core_1.Injector(this.moduleRef), qlsProduct, variant);
                         }
                     }
                     catch (e) {
@@ -289,7 +290,7 @@ let QlsProductService = class QlsProductService {
      * Determines if a product needs to be created or updated in QLS based on the given variant and existing QLS product.
      */
     async createOrUpdateProductInQls(ctx, client, variant, existingProduct) {
-        if (await this.options.excludeVariantFromSync?.(ctx, new core_1.Injector(this.moduleRef), variant)) {
+        if (await this.options.productSync.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 { status: 'not-changed' };
         }
@@ -305,7 +306,7 @@ let QlsProductService = class QlsProductService {
         }
         let qlsProduct = existingProduct;
         let createdOrUpdated = 'not-changed';
-        const { additionalEANs, ...additionalVariantFields } = this.options.getAdditionalVariantFields(ctx, variant);
+        const { additionalEANs, ...additionalVariantFields } = this.options.productSync.getAdditionalVariantFields(ctx, variant);
         if (!existingProduct) {
             const result = await client.createFulfillmentProduct({
                 name: variant.name,
@@ -430,7 +431,7 @@ let QlsProductService = class QlsProductService {
      * Update stock level for a variant based on the given available stock
      */
     async updateStock(ctx, variantId, availableStock) {
-        if (!this.options.synchronizeStockLevels) {
+        if (!this.options.productSync.synchronizeStockLevels) {
             core_1.Logger.warn(`Stock sync disabled. Not updating stock for variant '${variantId}'`, constants_1.loggerCtx);
             return;
         }

package/dist/types.d.ts

@@ -1,69 +1,86 @@
 import { ID, Injector, Order, ProductVariant, RequestContext, SerializedRequestContext } from '@vendure/core';
-import { CustomValue, FulfillmentOrderInput, FulfillmentOrderLineInput, FulfillmentProduct, FulfillmentProductInput } from './lib/client-types';
+import { CustomValue, FulfillmentOrder, FulfillmentOrderInput, FulfillmentOrderLineInput, FulfillmentProductDetail, FulfillmentProductInput } from './lib/client-types';
 export interface QlsPluginOptions {
     /**
      * Get the QLS client config for the current channel based on given context
      */
     getConfig: (ctx: RequestContext) => QlsClientConfig | undefined | Promise<QlsClientConfig | undefined>;
-    /**
-     * Required to get the EAN and image URL for a product variant.
-     * Also allows you to override other product attributes like name, price, etc.
-     */
-    getAdditionalVariantFields: (ctx: RequestContext, variant: ProductVariant) => AdditionalVariantFields;
-    /**
-     * Function to get the set service point code for an order.
-     * Return undefined to not use a service point at all.
-     */
-    getAdditionalOrderFields?: (ctx: RequestContext, injector: Injector, order: Order) => Promise<AdditionalOrderFields | undefined> | AdditionalOrderFields | undefined;
     /**
      * A key used to verify if the caller is authorized to call the webhook.
      * Set this to a random string
      */
     webhookSecret: string;
     /**
-     * Allows you to disable the pulling in of stock levels from QLS. When disabled, stock in Vendure will not be modified based on QLS stock levels.
-     * Defaults to true.
-     */
-    synchronizeStockLevels?: boolean;
-    /**
-     * Allows you to disable the automatic pushing of orders to QLS. You can still push orders manually via the Admin UI.
-     * Defaults to true.
-     */
-    autoPushOrders?: boolean;
-    /**
-     * Allows you to define a date from when the order should be processed by QLS.
-     * You can for example make orders processable 2 hours from now, so that you can still edit the order in QLS
-     * Defaults to now.
-     */
-    processOrderFrom?: (ctx: RequestContext, order: Order) => Date | Promise<Date>;
-    /**
-     * Optional function to determine if a product variant should be excluded from syncing to QLS.
-     * Return true to exclude the variant from sync, false or undefined to include it.
-     */
-    excludeVariantFromSync?: (ctx: RequestContext, injector: Injector, variant: ProductVariant) => boolean | Promise<boolean>;
-    /**
-     * Optional function to customize the receiver contact details when creating a QLS order.
-     * Allows you to set different fields or override default mapping from the order's shipping address and customer.
-     * If not provided, default mapping will be used.
-     */
-    getReceiverContact?: (ctx: RequestContext, order: Order) => FulfillmentOrderInput['receiver_contact'] | undefined;
-    /**
-     * Admin UI tab name where the QLS Product ID custom field is shown on ProductVariant.
-     * `null` will show the custom field on the default tab.
-     * Defaults to 'QLS'.
-     */
-    qlsProductIdUiTab?: string | null;
-    /**
-     * Optional hook called after syncing a variant to QLS.
-     * Receives the full QLS product, a RequestContext, and an Injector, allowing
-     * you to save any additional data to your own database. The saving itself
-     * happens inside this hook — if not provided, nothing is persisted.
+     * Options related to order pushing to QLS
      */
-    saveAdditionalData?: (ctx: RequestContext, injector: Injector, qlsProduct: FulfillmentProduct, variant: ProductVariant) => Promise<void> | void;
+    orderSync: {
+        /**
+         * Function to get additional order fields when pushing an order to QLS.
+         * Return undefined to not use additional fields at all.
+         */
+        pushAdditionalOrderFields?: (ctx: RequestContext, injector: Injector, order: Order) => Promise<AdditionalOrderFields | undefined> | AdditionalOrderFields | undefined;
+        /**
+         * Allows you to disable the automatic pushing of orders to QLS. You can still push orders manually via the Admin UI.
+         * Defaults to true.
+         */
+        autoPushOrders?: boolean;
+        /**
+         * Allows you to define a date from when the order should be processed by QLS.
+         * You can for example make orders processable 2 hours from now, so that you can still edit the order in QLS
+         * Defaults to now.
+         */
+        processOrderFrom?: (ctx: RequestContext, order: Order) => Date | Promise<Date>;
+        /**
+         * Optional function to customize the receiver contact details when creating a QLS order.
+         * Allows you to set different fields or override default mapping from the order's shipping address and customer.
+         * If not provided, default mapping will be used.
+         */
+        getReceiverContact?: (ctx: RequestContext, order: Order) => FulfillmentOrderInput['receiver_contact'] | undefined;
+        /**
+         * Optional hook called after an order has been successfully created in QLS.
+         * Receives the Vendure order, the created QLS order, a RequestContext, and an Injector.
+         * Errors in this hook are caught and logged, and will not fail the order push job.
+         */
+        pullAdditionalOrderFields?: (ctx: RequestContext, injector: Injector, order: Order, createdQlsOrder: FulfillmentOrder) => Promise<void> | void;
+        /**
+         * Additional order items to add to the QLS order.
+         */
+        addAdditionalOrderItems?: (ctx: RequestContext, injector: Injector, order: Order) => FulfillmentOrderLineInput[] | Promise<FulfillmentOrderLineInput[]>;
+    };
     /**
-     * Additional order items to add to the QLS order.
+     * Options related to product syncing to QLS
      */
-    addAdditionalOrderItems?: (ctx: RequestContext, injector: Injector, order: Order) => FulfillmentOrderLineInput[] | Promise<FulfillmentOrderLineInput[]>;
+    productSync: {
+        /**
+         * Required to get the EAN and image URL for a product variant.
+         * Also allows you to override other product attributes like name, price, etc.
+         */
+        getAdditionalVariantFields: (ctx: RequestContext, variant: ProductVariant) => AdditionalVariantFields;
+        /**
+         * Allows you to disable the pulling in of stock levels from QLS. When disabled, stock in Vendure will not be modified based on QLS stock levels.
+         * Defaults to true.
+         */
+        synchronizeStockLevels?: boolean;
+        /**
+         * Optional function to determine if a product variant should be excluded from syncing to QLS.
+         * Return true to exclude the variant from sync, false or undefined to include it.
+         * This is also used during order pushing: variants that are excluded from sync will not be pushed to QLS in an order.
+         */
+        excludeVariantFromSync?: (ctx: RequestContext, injector: Injector, variant: ProductVariant) => boolean | Promise<boolean>;
+        /**
+         * Optional hook called after syncing a variant to QLS.
+         * Receives the full QLS product, a RequestContext, and an Injector, allowing
+         * you to save any additional data to your own database. The saving itself
+         * happens inside this hook — if not provided, nothing is persisted.
+         */
+        saveAdditionalVariantData?: (ctx: RequestContext, injector: Injector, qlsProduct: FulfillmentProductDetail, variant: ProductVariant) => Promise<void> | void;
+        /**
+         * Admin UI tab name where the QLS Product ID custom field is shown on ProductVariant.
+         * `null` will show the custom field on the default tab.
+         * Defaults to 'QLS'.
+         */
+        qlsProductIdUiTab?: string | null;
+    };
 }
 /**
  * Additional fields for a product variant that are used to create or update a product in QLS

package/package.json

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