Manual Quotations

A simple quotation adapter that creates quotations with a 1-hour expiration time. Ideal for manual price negotiation workflows.

Included in Base Preset

This plugin is part of the base preset and loaded automatically. Using the base preset is strongly recommended, so explicit installation is usually not required.

Installation

import '@unchainedshop/plugins/quotations/manual';

Features

• Automatic Activation: Activated for all products
• 1-Hour Expiry: Quotations expire after 1 hour by default
• Simple Implementation: Minimal configuration required
• Manual Workflow: Designed for human-reviewed quotations

How It Works

1. Customer requests a quotation for a product
2. The adapter creates a quotation that expires in 1 hour
3. Admin reviews and can adjust the quotation
4. Customer accepts or the quotation expires

Usage

Request a Quotation

mutation RequestQuotation {
  requestQuotation(
    productId: "product-id"
    configuration: [
      { key: "quantity", value: "100" }
      { key: "notes", value: "Bulk order for corporate event" }
    ]
  ) {
    _id
    status
    expires
  }
}

Query Quotations

query MyQuotations {
  me {
    quotations {
      _id
      status
      product {
        texts { title }
      }
      expires
      quotationNumber
    }
  }
}

Admin: Update Quotation

mutation UpdateQuotation {
  updateQuotation(
    quotationId: "quotation-id"
    quotation: {
      price: 8999
      currency: "CHF"
    }
  ) {
    _id
    status
  }
}

Accept Quotation

mutation AcceptQuotation {
  verifyQuotation(quotationId: "quotation-id") {
    _id
    status
  }
}

Quotation States

Status	Description
REQUESTED	Customer has requested a quotation
PROCESSING	Quotation is being processed
PROPOSED	A price has been proposed
FULLFILLED	Quotation has been accepted and used
REJECTED	Quotation was rejected or expired

Extending the Adapter

For custom quotation logic:

import { QuotationDirector, QuotationAdapter, type IQuotationAdapter } from '@unchainedshop/core';

const CustomQuotationAdapter: IQuotationAdapter = {
  ...QuotationAdapter,

  key: 'my-shop.quotations.custom',
  version: '1.0.0',
  label: 'Custom Quotations',
  orderIndex: 0,

  isActivatedFor: (product) => {
    // Only activate for specific products
    return product?.meta?.quotationEnabled === true;
  },

  actions: (params) => {
    const { quotation, modules } = params;

    return {
      ...QuotationAdapter.actions(params),

      quote: async () => {
        // Custom logic to calculate quote
        const product = await modules.products.findProduct({
          productId: quotation.productId,
        });

        // Auto-calculate bulk discount
        const quantity = quotation.configuration?.find(c => c.key === 'quantity')?.value || 1;
        const basePrice = product?.commerce?.pricing?.[0]?.amount || 0;
        const discount = quantity > 100 ? 0.15 : quantity > 50 ? 0.10 : 0.05;

        return {
          expires: new Date(Date.now() + 24 * 60 * 60 * 1000), // 24 hours
          price: Math.round(basePrice * quantity * (1 - discount)),
        };
      },
    };
  },
};

QuotationDirector.registerAdapter(CustomQuotationAdapter);

Adapter Details

Property	Value
Key	shop.unchained.quotations.manual
Version	1.0.0
Order Index	0
Source	quotations/manual.ts

Related

• Plugins Overview - All available plugins
• Custom Quotation Plugins - Write your own