Extracted field types

The Elis Invoice Extractor currently automatically extracts the following fields at the all endpoint, subject to ongoing expansion. See detailed description of individual field types down below.

English (US and World)

  • amount_total, amount_total_base, amount_total_tax
  • amount_rounding, amount_paid, amount_due
  • tax_details (contains tax_detail_base, tax_detail_rate, tax_detail_tax, tax_detail_total)
  • invoice_id, order_id, customer_id
  • date_issue, date_due
  • terms
  • sender_name, sender_addrline, sender_vat_id (vat id)
  • recipient_name, recipient_addrline, recipient_vat_id (vat id)

English (UK), German (DE)

  • amount_total, amount_total_base, amount_total_tax
  • amount_rounding, amount_paid, amount_due
  • tax_details (contains tax_detail_base, tax_detail_rate, tax_detail_tax, tax_detail_total)
  • account_num, bank_num, iban, bic
  • invoice_id, order_id, customer_id -date_issue, date_due
  • terms
  • sender_name, sender_addrline, sender_vat_id (vat id)
  • recipient_name, recipient_addrline, recipient_vat_id (vat id)

Czech (CZ), Slovak (SK)

  • account_num, bank_num, iban, bic
  • var_sym, const_sym, spec_sym
  • amount_total, amount_total_base, amount_total_tax, amount_rounding, amount_paid, amount_due
  • tax_details (contains tax_detail_base, tax_detail_rate, tax_detail_tax, tax_detail_total)
  • date_issue, date_due, date_uzp
  • invoice_id, order_id, customer_id
  • sender_name, sender_addrline, sender_ic, sender_dic (cz vat id), sender_vat_id (sk vat id)
  • recipient_name, recipient_addrline, recipient_ic, recipient_dic (cz vat id), recipient_vat_id (sk vat id)

Field Types Descriptions

Amounts

  • amount_total (Amount total)
    • Subtotal over all items, including tax.
  • amount_total_base (Total amount (tax excluded))
    • Subtotal over all items, excluding tax (i.e. sum of tax bases).
  • amount_total_tax (Total tax)
    • Total VAT amount.
  • amount_rounding (Amount rounding)
    • Remainder after rounding amount_total.
  • amount_paid (Amount paid)
    • Amount paid in advance.
  • amount_due (Amount due)
    • Final amount including tax to be paid after deducting all discounts and advances.

Typical relations (may depend on local laws):

amount_total = amount_total_base + amount_total_tax
amount_rounding = amount_total - round(amount_total)
amount_due = amount_total - amount_paid + amount_rounding

Amounts are of type decimal represented as a string with decimal dot, eg. "1234.56".

All amounts are in the main currency of the invoice (as identified in the currency response field). Amounts in other currencies are generally excluded.

Tax details

Tax details table and breakdown by tax rates.

  • tax_detail_base (Detail: Tax base)
    • Sum of tax bases for items with this tax rate.
  • tax_detail_rate (Detail: Tax rate)
    • One of the tax rates in the tax breakdown.
  • tax_detail_tax (Detail: VAT tax)
    • Sum of taxes for items with this tax rate.
  • tax_detail_total (Detail: Total (tax incl.))
    • Total amount including tax for all items with this tax rate.

Tax rate is a decimal represented as a string with decimal dot, eg. "12.34" or "22"".

Identifiers

  • invoice_id (Invoice number)
    • Invoice number. It is often different from the variable symbol. Used to identify the document.
  • order_id (Purchase order number)
    • Order identification. It may not always have a numerical form.
  • customer_id (Customer number/account)
    • Customer reference number. The number by which the customer is registered in the system.
  • date_issue
    • Date of issue of the document.
  • date_due
    • The due date of the invoice.
  • terms
    • Payment terms information. It is a variety of information for payment. (For example: Pay 45 days from receipt of the invoice).
  • sender_name
    • Official supplier name in the Registry.
  • sender_addrline
    • A line from the official address of the company’s registered office.
  • sender_address
    • Official address of the company’s registered office.
  • sender_ic
    • Bussiness/organization identification number of the supplier.
  • sender_dic
    • Tax identification number of the supplier.
  • sender_vat_id
    • VAT identification number of the supplier.
  • recipient_name
    • The official name of the customer.
  • recipient_addrline
    • A line from the official address of the customer.
  • recipient_address
    • Official address of the customer.
  • recipient_ic
    • Bussiness/organization identification number of the customer.
  • recipient_dic
    • Tax identification number of the customer.
  • recipient_vat_id
    • VAT identification number of the customer.

Identifiers and addresses are represented as a string, dates as string in format YYYY-MM-DD.