Sign in
latestOpenAPI 3.0.12026-08-192092911.2 MB

916e669fc527

Quotes

Create a quote

Create a new quote (required scope finance:write)

post/v1/finance/quotes

Headers

Customer-Idinteger required

The customer identifier

Request body

jobIdinteger nullable

The unique identifier of the job associated with this quote, if applicable

jobGroupIdinteger nullable

The unique identifier of the job group associated with this quote, if applicable

contactIdinteger nullable

The unique identifier of the contact associated with this quote. Will reference the job or job group contact if not provided

createdAtstring date-time nullable

The dateTime the quote was created. If null, will default to the current dateTime

referencestring nullable

The reference of the quote. If null, will default to an auto-generated reference

currencyCode'EUR' | 'AUD' | 'GBP' | 'BGN' | 'CAD' | 'CZK' | 'DKK' | 'HUF' | 'ILS' | 'LVL' | 'LTL' | 'MXN' | 'NZD' | 'NOK' | 'PLN' | 'RON' | 'RUB' | 'ZAR' | 'SEK' | 'CHF' | 'AED' | 'USD'

CurrencyCode definitions enum, matches currencies available in the BigChange Client Site<p>Possible values:</p><ul><li><b>EUR</b>: Euro</li><li><b>AUD</b>: Australian Dollar</li><li><b>GBP</b>: Pound Sterling</li><li><b>BGN</b>: Bulgarian Lev</li><li><b>CAD</b>: Canadian Dollar</li><li><b>CZK</b>: Czech Koruna</li><li><b>DKK</b>: Danish Krone</li><li><b>HUF</b>: Forint</li><li><b>ILS</b>: New Israeli Sheqel</li><li><b>LVL</b>: Latvian Lats - replaced by Euro</li><li><b>LTL</b>: Lithuanian Litas - replaced by Euro</li><li><b>MXN</b>: Mexican Peso</li><li><b>NZD</b>: New Zealand Dollar</li><li><b>NOK</b>: Norwegian Krone</li><li><b>PLN</b>: Zloty</li><li><b>RON</b>: Romanian Leu</li><li><b>RUB</b>: Russian Ruble</li><li><b>ZAR</b>: Rand</li><li><b>SEK</b>: Swedish Krona</li><li><b>CHF</b>: Swiss Franc</li><li><b>AED</b>: UAE Dirham</li><li><b>USD</b>: US Dollar</li></ul>

deliverySiteContactIdinteger nullable

The unique identifier of the delivery site contact associated with this quote, if applicable

departmentCodeIdinteger nullable

The unique identifier of the department associated with this quote, if applicable

nominalCodeIdinteger nullable

The unique identifier of the nominal code associated with this quote, if applicable

clientNotesstring nullable

Notes on the quote

internalNotesstring nullable

Internal notes not visible to the client

daysValidForinteger nullable

The number of days the quote is valid for

Example request

{
  "jobId": 12345,
  "jobGroupId": 54321,
  "contactId": 1234,
  "createdAt": "2022-11-29T16:50:16.0000000+00:00",
  "reference": "quoteNote101",
  "currencyCode": "EUR",
  "deliverySiteContactId": 56789,
  "departmentCodeId": 23456,
  "clientNotes": "Please pay within 30 days",
  "internalNotes": "Follow up in two weeks",
  "daysValidFor": 7,
  "customFields": [
    {
      "definitionId": 5514123,
      "value": "High net worth"
    }
  ]
}

Response

Created

idinteger

Identifier of the newly created record