Articles in this section

Quote Integration

Dan Mackay
  • Updated
Follow

Overview

The Unimarket Quote request / response integration point is used to provide suppliers with the means to send an electronic quote to a Unimarket user. The basic process is as follows:

  • The user contacts the supplier and requests a quote
  • The supplier creates the quote within their system
  • The supplier system generates the quote and sends the XML create-quote-request to Unimarket
  • Unimarket receives the create-quote-request and routes it to the appropriate user's shopping cart
  • The user is alerted via email there is a quote to review in their cart
  • If happy, the user checks-out the quote, generates a requisition and sends it for approval
  • Once approved, an order is created and sent to the supplier

Unbundled (Simple) and Bundled Quotes

Unimarket supports the ability to create a quote with either unbundled or bundled items. If items in the quote are bundled then the user only has the option to checkout the entire quote (and vice versa). They cannot pick and choose items from the quote. This is useful for suppliers where the quote pricing is based on the user purchasing all the quoted items.

Simple Example

Simple example of a quote with one line/product for 'user1' in the 'AACC' Community.

Single Line Quote Example

<?xml version='1.0' encoding='UTF-8'?>
<create-quote-request xmlns='http://www.unimarket.com/schema/unimarket-ws'>
    <header>
        <to>
            <!-- Unique Unimarket username of the user the quote is for -->
            <user-ref identity='user1'/>
            <!-- Unique Unimarket code of the user's community -->
            <tenant-ref identity='AACC'/>
        </to>
        <summary>summary value</summary>
        <reference-code>quote ref value</reference-code>
        <expiry>2009-08-01T15:30:00</expiry>
    </header>
    <!-- e.g. line with tax -->
    <line quantity="2">
        <code>product code</code>
        <name>name value</name>
        <description>desc value</description>
        <unit-of-measure unit="EA"/>
        <unit-price iso-currency-code="USD">50.00</unit-price>
        <subtotal iso-currency-code="USD">100.00</subtotal>
        <tax iso-currency-code="USD">15</tax>
        <total iso-currency-code="USD">115</total>
    </line>
</create-quote-request>

 

Product Bundle Example

Example of a quote containing a product bundle with two lines/products.

Bundle Quote Example

<?xml version='1.0' encoding='UTF-8'?>
<create-quote-request xmlns='http://www.unimarket.com/schema/unimarket-ws'>
    <header>
        <to>
            <user-ref identity='user1'/>
            <tenant-ref identity='AACC'/>
        </to>
        <summary>summary value</summary>
        <reference-code>ref value</reference-code>
        <expiry>2009-08-01T15:30:00</expiry>
    </header>
    <bundle>
        <code>bundle code</code>
        <name>bundle name</name>
        <description>bundle description</description>
        <!-- e.g. line where any tax is included in price -->
        <line quantity="2">
            <code>product code</code>
            <name>product name</name>
            <description>product description</description>
            <unit-of-measure unit="EA"/>
            <unit-price iso-currency-code="USD">50.00</unit-price>
            <subtotal iso-currency-code="USD">100.00</subtotal>
            <tax iso-currency-code="USD">0</tax>
            <total iso-currency-code="USD">100</total>
        </line>
        <!-- e.g. line with tax -->
        <line quantity="2">
            <code>product code</code>
            <name>name value</name>
            <description>desc value</description>
            <unit-of-measure unit="EA"/>
            <unit-price iso-currency-code="USD">50.00</unit-price>
            <subtotal iso-currency-code="USD">100.00</subtotal>
            <tax iso-currency-code="USD">15</tax>
            <total iso-currency-code="USD">115</total>
        </line>
    </bundle>
</create-quote-request>

 

Technical Information

Technical documentation and examples relating to the full list of Unimarket webservice interfaces can be found below:

Integration > General

Related articles