BIbigchange
Invoices

Create an invoice

Changed on

Create a new invoice (required scope finance:write)

post/v1/finance/invoices

Request

  • Base URL
    https://api.bigchange.com
  • URL
    https://api.bigchange.com/v1/finance/invoices
  • Auth
    HTTP bearer

Headers

Customer-Idinteger required

The customer identifier

Request body

jobIdinteger nullable

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

jobGroupIdinteger nullable

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

contactIdinteger nullable

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

createdAtstring date-time nullable

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

referencestring nullable

The reference of the invoice. 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 invoice, if applicable

bankAccountIdinteger nullable

The unique identifier of the bank account associated with this invoice, if applicable

departmentCodeIdinteger nullable

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

nominalCodeIdinteger nullable

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

clientNotesstring nullable

Notes on the invoice

internalNotesstring nullable

Internal notes not visible to the client

salesOpportunityIdinteger nullable

The unique identifier of the sales opportunity associated with this invoice, if applicable

Example request

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

Response

Created

idinteger

Identifier of the newly created record

Changes

  • 553de7d50a1cRevision changes
    • info

      added the new optional request property (media type: application/json-patch+json)

    • info

      added the new optional request property (media type: application/json)

    • info

      added the new optional request property (media type: application/*+json)