How to work with quotes
  • 29 Sep 2025
  • 2 Minutes to read
  • Contributors
  • Dark
    Light

How to work with quotes

  • Dark
    Light

Article summary

Creating quotes

Quotes can only be created via the configurator, or more precisely during the Checkout of a configuration. To configure the creation of your quotes, simply click on the checkout component within your configurator. You will see the Quote property which can be used to enrich every newly created quote with configuration data.

Checkout.ValidateQuote(new Quote {
  pdfAssetPath: "asset.pdf",
  quoteHubName: "HUB1",
  subject: "sub",
  projectId: "test",
  currency: "EUR",
  customer: new QuoteCustomer {
    firstName: "John",
    lastName: "Doe",
    companyName: "My Company GmbH",
    addressLine1: "AddressLine1",
    addressLine2: "AddressLine2",
    city: "City",
    street: "Street 13",
    postalCode: "PostalCode",
    country: "Country",
    emailAddress: "john.doe@mail.com",
    phoneNumber: "+43 1 12345678"
  },
  items: [
    new QuoteItemSection {
      name: "Products"
    },
    new QuoteLineItem {
      name : "Product 1",
      description : "My description",
      quantity : new QuoteQuantity {
        value: 10,
        unit: "pcs."
      },
      priceNet : 32,
      tax : 323
    }
  ]
})

Keep in mind

Always include thequoteHubName to select the correct quote hub.

Please ensure that this property is not missing and the quote hub is correctly configured, otherwise the quote cannot be created and the checkout will not proceed.

The QuoteOnCheckout property indicates if a quote should be created during the checkout. This means, you can for example create a quote depending on any condition or component (e.g. only for a dedicated region or product combination). The following example uses the CreateQuotecomponent which is connected with a check box control with the user interface of the configurator.

CreateQuote or False

As previously described, every configurator can create quotes in any hub (see the quoteHubName property). In the following example, configurator A, B and C create quotes in their dedicated hubs, but configurator D creates quotes in HUB2 and HUB3. This allows you to create quotes from different configurators, but ensure the same number sequence described in the next section.
This is crucial if products from different configurators should use the same quote numbers in their offers (quote PDFs).

Changing quotes

After you have configured the quote creation and users have already created quotes, you can use them in the quote overview page.
Once you have clicked on a dedicated quote, all details of this quote are shown.
It’s conveniently possible to change all details of the quote and directly see the resulting quote PDF which is ready to be sent to your customer.

You can modify contact details, quote contents, tax rules and custom fields of the quote.
The button on the right hand side allows you to see a preview of the quote PDF, download or send it by mail.
A quote is always linked to a configuration which is is protected and can no be longer be modified to avoid inconsistences between the configuration and the resulting quote.


Was this article helpful?