Items from the "quotations" domain represent a quote.


Structure URL’s:

/api/v1/quotes: Offertegegevens

/api/v1/quotes/4004: Offerte met ID 4004

/api/v1/quotes/4004/items: Items van offerte met ID 4004

/api/v1/quotes/4004/items/5004: Item met ID 5004 van offerte met ID 4004

/api/v1/quotes/4004/remarks: Opmerkingen van offerte met ID 4004

/api/v1/quotes/4004/remarks/5010: Opmerking met ID 5010 van offerte met ID 4004

/api/v1/quotes/4004/events: Gebeurtenissen van offerte met ID 4004

/api/v1/quotes/4004/events/5030: Gebeurtenis met ID 5030 van offerte met ID 4004


Domain : receipts

Field name
TypeDescription
Example
receipt_idintUnique ID of the receipt. Generated by the system. Required to be specified in URL (except for creation).5005
uritextURL to the receipt. Generated by the system. To be used when addressing receipt via the API.
external_receipt_idtext(Unique) ID of the receipt that can be set by a third party. Maximum 50 characters long. Uniqueness of the value is not enforced.Receipt-0983984
client_idintUnique ID of the customer. Optional to be specified.1001
client_uritextURL to the customer. Generated by the system. To be used when addressing the customer via the API.
client_nametextName of the customer. Is automatically taken from the customer data if not specified.
IT Services BVBA
client_attentiontextAttn of the customer. Is automatically taken from the customer data if not specified.
Administration Department
typetextType of receipt. Always contains the value: 'receipt'. It is determined by the system and cannot be passed on by itself.invoice
numbertextUnique number of the receipt as shown on the receipt. Generated if not provided. Maximum 255 characters long.
00000001
layout_idintUnique ID of the layout. If not specified, the default layout is determined automatically. Can be empty if no layout has been set for the account.8001
referencetextSelf-specified reference of the receipt. Not required. Maximum 250 characters long.ID123456789
datedateDate of creation of the receipt. Generated if not provided. Format YYYY-MM-DD.2012-02-15
statustextStatus of the receipt. Possible values: 'open', 'closed'. Defined by the system and cannot be specified by yourself.
open
billing_addressAddressCustomer billing address. Is automatically taken from the customer data if not specified.
delivery_addressAddressCustomer's shipping address. Is automatically taken from the customer data if not specified.
site_addressAddressCustomer site address. Is automatically taken from the customer data if not specified.
discount_percentagefloatDiscount percentage that applies to the entire receipt. Amount must be between 0 and 100. Numbers up to 2 digits after the decimal point are allowed. If not specified, this value is 0.5
languagetextThe language in which the receipt is formatted. This value can contain 'dutch', 'french', 'english' or 'german' but can also be empty. If empty (= default value), the default language (dutch) is used.dutch
tax_calculationtextThe VAT calculation method of the receipt. Possible values: 'total', 'item'. By default, 'total' is used. With the calculation method 'total' the VAT is calculated on the total amount of the receipt, with the calculation method 'item' the VAT is calculated per receipt line. Switching between the calculation method can cause rounding differences. If 'tax_included'='yes', only 'item' is a valid value.total
tax_includedtextIndicates whether or not the amounts of the receipt have been entered including VAT and are therefore printed including VAT. Can have value 'yes' or 'no'. If empty, the default value is determined as set for the account (default 'no').no
itemslistList of receipt items.
discount_total_without_taxfloatTotal amount of the discount on the total receipt without taking into account VAT. Calculated automatically and cannot be specified by yourself.
10.00
total_refundable_depositfloatTotal amount of invoice lines with refundable packaging (tax_rate_special_status = DR). Calculated automatically and cannot be specified by yourself.5.00
total_without_taxfloatTotal amount across all invoice items without taking into account VAT. Any discounts (discount_total_without_tax) and refundable packaging (total_refundable_deposit) are already included in this total. Calculated automatically and cannot be specified by yourself.200.00
tax_rate_1float1st VAT percentage that can be used on the receipt. Taken from the settings during creation and cannot be specified by yourself.21
total_tax_1floatTotal amount of VAT according to 1st VAT percentage across all items. Calculated automatically and cannot be specified by yourself.42.00
tax_rate_2float2nd VAT percentage that can be used on the receipt. Taken from the settings during creation and cannot be specified by yourself.12
total_tax_2floatTotal amount of VAT according to 2nd VAT percentage over all items. Calculated automatically and cannot be specified by yourself.0.00
tax_rate_3float 3rd VAT percentage that can be used on the receipt. Taken from the settings during creation and cannot be specified by yourself.6
total_tax_3floatTotal amount of VAT according to 3rd VAT percentage over all items. Calculated automatically and cannot be specified by yourself.0.00
discount_total_with_taxfloatTotal amount of the discount granted on the total of the receipt including VAT. Calculated automatically and cannot be specified by yourself.12.10
total_with_taxfloatTotal amount across all items including VAT. Calculated automatically and cannot be specified by yourself.242.00
total_paidfloatTotal amount already paid by customer. Is the summation of all amounts in payments. Calculated automatically and cannot be specified by yourself.25.00
notetextNote shown at the bottom of the receipt. Optional to give. Maximum 2000 characters long.Warranty conditions applicable
note_htmlhtmlNote shown at the bottom of the receipt. Optional to give. Maximum 2000 characters long.
<p>Warranty conditons applicable</p>
last_activitydatetimeTime with the last activity of the receipt. Cannot be specified, automatically determined by the system.2018-05-03 11:33:45
custom_valueslistList of standard fields that can be added to the receipt. The available standard fields can be set via “Settings” > “Advanced”.
tagslistList of tags indicating which actions have already been performed for the receipt.
paymentslistList of payments received from the receipt.
remarkslistList of personal notes on the receipt.
eventslistList of cash receipt events.


Subdomain : items ( < receipts )

Field nameTypeDescription
Example
item_idintUnique ID of the receipt item. Generated by the system. Required to be specified in URL (except for creation).4004
receipt_idintUnique ID of the receipt. Generated by the system. Required to be specified in URL.3003
uritextURL to receipt item. Generated by the system. To be used when addressing a receipt item via the API.
amountfloatAmount per unit (1 quantity) of the receipt item excluding VAT. Mandatory to be used if field tax_included='no'. Can be specified to 4 decimal places. The maximum amount is 9,999,999,9999. Will be calculated automatically if amount is specified via 'amount_with_tax'.100.00
amount_with_taxfloatAmount per unit (1 quantity) of the receipt item including VAT. Mandatory to be used if field tax_included='yes'. Can be specified to 4 decimal places. The maximum amount is 9,999,999,9999. Will be calculated automatically if amount was entered via 'amount'.121.00
quantityfloatNumber of units of the receipt item. Can be specified to 2 decimal places. If not specified, '1' is used by default. The maximum amount is 999,999.99.2
unittextUnit of the item. Not required. Maximum 10 characters long and must start with a letter. Must not contain spaces.stuk
stockitem_codetextItem code linked to the item. Not required. Maximum 20 characters long. Adding an item code does not affect the number of items in stock on the item list.A0000001
stockitem_idintUnique ID of the article. Not required. Can only be used during creation or editing. By submitting this ID, the stock of the item will be automatically adjusted and fields that are not specified, such as “description”, “amount”, “stockitem_code”, “tax_rate”, “tax_rate_special_status” and “general_ledger_account” are automatically completed.2002
quantity_with_unittextQuantity and unit of the item separated by a space. Can only be used during creation or editing. Cannot be used in combination with field 'quantity' or 'unit'. The same restrictions as 'quantity' and 'unit' fields apply.
2 stuk
descriptiontextDescription of the receipt item. Mandatory to be specified when creating.product description
description_htmlhtmlDescription of the receipt item. Mandatory to be specified at creation (alternatively, field description can be used).
<p>product description</p>
total_without_taxfloatTotal amount of the receipt item excluding VAT. Is calculated by means of fields 'amount' and 'quantity'.200.00
tax_ratefloatTax percentage of the receipt item. Must match one of the sales tax percentages of the receipt or must be '0'. If not specified, '0' is assumed.21
tax_rate_special_statustextCode deviating VAT rate from the used VAT percentage (tax_rate) of the receipt item. Can only be used if the VAT percentage is 0. The field is optional and can be up to 20 characters long.MC
total_with_taxfloatTotal amount of the receipt item including VAT. Is calculated using the fields 'amount', 'quantity' and 'tax_rate'.242.00
general_ledger_accounttextCode of the ledger account associated with the receipt item. Not required. Between 6 and 8 characters long, only numbers are allowed.700000
custom_valueslist List of standard fields. The available fields are added via “Settings” > “Advanced”.


Subdomain : custom_values ( < receipts + items < receipts )

Field name
TypeDescription
Example
nametextInternal name of the default field. Determined when the default field is created and can be used as an unique identifier for the default field. Mandatory when adding or changing the value of this field. myreference
descriptiontextName or description of the default field as it appears when used. Returned for informational purposes only and cannot be modified via the API.Our reference 
valuetextValue of the default field. Maximum 75 characters long.123456


Subdomain : tags ( < receipts )

Field name
TypeDescription
Example
tag_idnumberUnique ID of the tag3
nametextTag name or code. Possible values: 'printed' (tag_id=3), 'sent' (tag_id=6), 'accountant' (tag_id=9).printed

Note: The 'tags' subdomain is not a full-fledged subdomain and cannot be accessed separately from domain 'receipts'. It is not possible to adjust values in tags via the API. This data is automatically added based on actions performed.


Subdomain : payments ( < receipts )

Field nameTypeDescription
Example
payment_idintUnique ID of the payment. Generated by the system. Required to be specified in URL (except for creation).5010
receipt_idintUnique ID of the receipt. Generated by the system. Required to be specified in URL.3003
uritextURL to payment. Generated by the system. To be used when requesting payment via the API.
datedateDate the payment was recorded. Has the format YYYY-MM-DD. If not specified at creation, current date is used.2012-02-15
amountfloatPayment amount. Mandatory when creating, alternatively field 'remaining_amount' can be specified.25.00
methodtextPayment method of payment. Optional to give. Valid values: transfer, cash, debit card, credit card, direct collection, online, bancontact, ideal.cash
descriptiontextDescription of the payment. Optional to give. Maximum 255 characters long.Advance
remaining_amounttextOnly applicable when adding a payment (POST/PUT). This designation ensures that the 'amount' field contains the full remaining unpaid amount of the receipt. Not required field, if specified it always has value 'yes'.yes


Subdomain : remarks ( < receipts )

Field name
TypeDescriptionExample
remark_idintUnique ID of the comment. Generated by the system. Required to be specified in URL (except for creation).
5020
receipt_idintUnique ID of the receipt. Generated by the system. Required to be specified in URL.3003
uritextURL to comment. Generated by the system. To be used when addressing comment via the API.
datedateDate the comment was added. If not specified, the current date is used. Format is YYYY-MM-DD.2012-02-15
descriptiontextDescription of the comment. Mandatory to be specified when creating or modifying.Customer has already received goods
description_htmlhtmlDescription of the comment. Mandatory to be specified when creating or modifying (alternatively, field description can be used).
<p>Customer has already received goods</p>


Subdomain : events ( < receipts )

Field name
TypeDescription
Example
event_idintUnique ID of the event. Generated by the system. Required to be specified in URL.5030
receipt_idintUnique ID of the receipt. Generated by the system. Required to be specified in URL.3003
uritextURL to event. Generated by the system. To be used when calling event via the API.
datedateDate when the event occurred. Format YYYY-MM-DD.2012-02-15
typetextEvent type. Currently only 'email sent' possible.email sent
contenttextContent or description of the event. With type 'email sent' the content of the email will be sent here.    attached your receipt
recipientslistLijst met ontvangers van de gebeurtenis.

Note: An element of the 'events' subdomain cannot be modified or created by yourself. Only the system can create an 'event'.


Subdomain : recipients ( < events < receipts )

Field name
TypeDescription
Example
nametextName (first name + last name) of the recipient.
Bart Decouster
email_addresstextEmail address of the recipient.[email protected]
external_event_recipient_idtextExternal unique reference to this record.17ad5dfc-b03e-4fd3-b66b-05b264cfa0c6
statustextStatus that returns whether the event has already arrived at the recipient. Possible statuses are: sending, sent, open, failed.sending
informationtextAdditional information about the status. An error message will appear here if status is set to 'failed'.

Note: An element of the 'events' subdomain cannot be changed or created by yourself. Only the system can create an 'event'.


Type : Address

Field nameTypeDescription
Example
streettextStreet + house number of the address. Not required, maximum 150 characters long.Langestraat 189
street2textSecond address line of the address. Not required, maximum 150 characters long.
citytextCity of the address. Not required, maximum 50 characters long.Antwerp
postal_codetextThe postal code of the city of the address. Not required, maximum 10 characters long.2000
countrytextCountry of the customer. Cannot be specified. Is automatically determined by country_code.Belgium
country_codetextCustomer country code. Mandatory, 2 characters long, in capital letters.BE


Example in  XML of a receipt:

<quote>
  <quote_id>4004</quote_id>
  <uri>https://eenvoudigfactureren.be/api/v1/quotes/4004</uri>
  <external_quote_id>Offerte-151098587</external_quote_id>
  <client_id>1001</client_id>
  <client_uri>https://eenvoudigfactureren/api/v1/clients/1001</client_uri>
  <client_name>IT Services BVBA</client_name>
  <client_attention>Dienst administratie</client_attention>
  <type>quote</type>
  <number>EST2012-001</number>
  <layout_id>8001</layout_id>
  <reference>ID123456789</reference>
  <date>2012-02-15</date>
  <deposit_paid>10.00</deposit_paid>
  <status>open</status>
  <days_valid>10</days_valid>
  <date_expired>2012-02-25</date_expired>
  <billing_address>
    <street>Olifantstraat 200</street>
    <street2></street2>
    <postal_code>9000</postal_code>
    <city>Gent</city>
    <country_code>BE</country_code>
    <country>België</country>
  </billing_address>
  <delivery_address>
    <street>Olifantstraat 200</street>
    <street2></street2>
    <postal_code>9000</postal_code>
    <city>Gent</city>
    <country_code>BE</country_code>
    <country>België</country>
  </delivery_address>
  <site_address>
    <street>Olifantstraat 200</street>
    <street2></street2>
    <postal_code>9000</postal_code>
    <city>Gent</city>
    <country_code>BE</country_code>
    <country>België</country>
  </site_address>
  <discount_percentage>5</discount_percentage>
  <currency>EUR</currency>
  <exchange_rate>1</exchange_rate>
  <language>dutch</language>
  <tax_calculation>total</tax_calculation>
  <tax_included>no</tax_included>
  <items>
    <item>
      <item_id>5005</item_id>
      <uri>https://eenvoudigfactureren.be/api/v1/quotes/4004/items/5005</uri>
      <description>product omschrijving</description>
      <description_html><![CDATA[<p>product omschrijving</p>]]></description_html>
      <amount>100.00</amount>
      <amount_with_tax>121.00</amount_with_tax>
      <quantity>2</quantity>
      <unit>stuk</unit>
      <stockitem_code>A000001</stockitem_code>
      <total_without_tax>200.00</total_without_tax>
      <tax_rate>21</tax_rate>
      <total_with_tax>242.00</total_with_tax>
      <general_ledger_account>700000</general_ledger_account>
      <custom_values>
          <custom_value>
              <name>ean</name>
              <description>EAN</description>
              <value>100000000000001</value>
          </custom_value>
      </custom_values>
    </item>
  </items>
  <discount_total_without_tax>10.00</discount_total_without_tax>
  <total_without_tax>190.00</total_without_tax>
  <tax_rate_1>21</tax_rate_1>
  <total_tax_1>42.00</total_tax_1>
  <tax_rate_2>12</tax_rate_2>
  <total_tax_2>0.00</total_tax_2>
  <tax_rate_3>6</tax_rate_3>
  <total_tax_3>0.00</total_tax_3>
  <discount_total_with_tax>12.10</discount_total_with_tax>
  <total_with_tax>229.90</total_with_tax>
  <note>Schriftelijk te bevestigen bij goedkeuring.</note>
  <note_html><![CDATA[<p>Schriftelijk te bevestigen bij goedkeuring.</p>]]></note_html>
  <last_activity>2018-05-03 11:33:45</last_activity>
  <custom_values>
    <custom_value>
      <name>myreference</name>
      <description>Onze referentie</description>
      <value>123456</value>
    </custom_value>
  </custom_values>
  <tags>
    <tag>
      <tag_id>3</tag_id>
      <name>printed</name>
    </tag>
  </tags>
  <remarks>
    <remark>
        <remark_id>5020</remark_id>
        <uri>https://eenvoudigfactureren.be/api/v1/quotes/3003/remarks/5020</uri>
        <date>2012-02-15</date>
        <description>Klant heeft goederen reeds ontvangen</description>
        <description_html><![CDATA[<p>Klant heeft goederen reeds ontvangen</p>]]></description_html>
    </remark>
  </remarks>
  <events>
    <event>
      <event_id>5030</event_id>
      <uri>https://eenvoudigfactureren.be/api/v1/quotes/3003/events/5030</uri>
      <date>2012-02-16</date>
      <type>email sent</type>
      <content>In bijlage uw factuur</content>
      <recipients>
        <recipient>
          <name>Bart Decouster</name>
          <email_address>[email protected]</email_address>
          <external_event_recipient_id>17ad5dfc-b03e-4fd3-b66b-05b264cfa0c6</external_event_recipient_id>
          <status>sending</status>
          <information>-</information>
        </recipient>
      </recipients>
    </event>
  </events>
</quote>