How to work with quotes

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.

new Quote {
  quoteHubName : "QuoteHubName",
  // pdfAssetPath : "assetFolder.pdfAssetName",
  subject : "Subject",
  projectId : "ProjectId",
  currency : Currency.EUR,
  // taxRule : QuoteTaxRule.RevealSalesTax,
  // paymentDueDays : 30,
  // offerValidityDays : 90,
  // contributionMarginRatioThreshold : 60,
  customer : new {
    firstName : "John",
    lastName : "Doe",
    companyName : "My Company GmbH",
    city : "City",
    street : "Street 13",
    // addressLine1 : "My Company GmbH",
    // addressLine2 : "Building C",
    postalCode : "PostalCode",
    country : "Country",
    emailAddress : "john.doe@mail.com",
    phoneNumber : "+43 1 12345678"
  },
  items : [
    new QuoteItemSection { name : "Main" },
    new QuoteLineItem {
      name : "My Product 1",
      description : "Description text",
      quantity : 10,
      unit : "m",
      priceNet : 10,
      tax : 20
    },
    new QuoteLineItem {
      name : "My Product 2",
      sku : "MP-2",
      description : "Description text",
      quantity : 1,
      unit : "pc.",
      priceNet : 20.5,
      variableCostNet : 15,
      // contributionMarginRatioThreshold : 50,
      tax : 30,
      discount : new {
        value : 5,
        // type : PriceAdjustmentType.Percent
      },
      isOptional : true,
      imageUrl : "https://picsum.photos/id/2/200"
    }
  ]
}

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.
A quote is always linked to a configuration which is is protected and can no longer be modified to avoid inconsistences between the configuration and the resulting quote.
Once you have clicked on a dedicated quote, all details of this quote are shown. You can directly see the resulting quote PDF which is ready to be sent to your customer.
In addition, it’s conveniently possible to change all details of the quote by clicking on the Edit Quote button.

In a quote draft, you can modify contact details, contents and details (tax rules, custom fields, etc.) of the quote.
The button on the right hand side allows you to see a preview of the quote PDF.

Restoring quotes

If you would like to go back to a previous version or check all changes which have been performed for a quote, then simply click on the history button.