Skip to content
Book a demoStart free
Connectors

Fennoa connector

Set up the Fennoa connector in Kaivo: authentication, configuration, the 18 BigQuery tables it syncs, and answers to common questions.

Fennoa connector pricing, tier and credits on kaivo.io

Kaivo is a fully managed data platform that syncs your Fennoa data into a Google BigQuery warehouse and keeps it up to date automatically. There is no pipeline to build and no infrastructure to run, so you can spend your time analysing your payment and finance data instead of moving it.

Sync your Fennoa accounting data into BigQuery with Kaivo to report on invoices, ledgers, and financials alongside the rest of your business.

CategoryFinance & Payments
AuthenticationAPI key
SetupSelf-service
  1. Sign up for Kaivo and create a workspace.
  2. Connect your Fennoa account.
  3. Choose which tables to sync.
  4. Wait for the initial sync to finish.
  5. Query your data in BigQuery or your favourite AI or BI tool.

Authenticate with your API Key.

Field Description
API Key

When you set up the connector, you provide:

Field Description
API User
To create an API user and API key:
  1. Navigate to Fennoa > Users > Create new api user > Select “QuickBI” > Create api user
  2. Once the user has been created, a prompt should open with the user and key information. Make sure to copy these before closing the prompt, as they wont be shown again!

|

Kaivo syncs 18 tables from Fennoa into a dedicated dataset in your BigQuery warehouse. Click any table to see its columns and types.

account (11 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
code INT64
name STRING
name_sv STRING
name_en STRING
vatcode_id INT64
vatcode_type STRING
vatcode STRING
vatpercent FLOAT64
is_active INT64
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
account_balance (7 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
account INT64
date DATE
sum_debit FLOAT64
sum_credit FLOAT64
sum_total FLOAT64
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
dimension_type_name STRING
dimension_code STRING
dimension_id INT64
dimension_name STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
account_opening_balance (7 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
period_id INT64
account_code INT64
total_sum FLOAT64
debit_sum FLOAT64
credit_sum FLOAT64
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
accounting_ledger (13 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
statement_id INT64
account INT64
date DATE
debit FLOAT64
credit FLOAT64
vatcode_id INT64
description STRING
series STRING
number INT64
opening FLOAT64
closing FLOAT64
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
dimension_type_name STRING
dimension_code STRING
dimension_id INT64
dimension_name STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
type STRING
id INT64
url STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
accounting_period (6 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
id INT64
start_date DATE
end_date DATE
name STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
accounting_vatcode (6 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
id INT64
name STRING
vatpercent FLOAT64
type STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
customer (61 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
id INT64
name STRING
name2 STRING
contact_person STRING
customer_no STRING
owner_user_id INT64
parent_customer_id INT64
account_type_id INT64
address STRING
postalcode STRING
city STRING
country_id STRING
email STRING
phone STRING
fax STRING
website STRING
business_id STRING
vat_number STRING
identity_number STRING
einvoice_address STRING
einvoice_operator_id STRING
einvoice_unit_number INT64
payment_terms_id INT64
auxliary_name_id INT64
locale_id INT64
sales_invoice_layout_id INT64
sales_pricelist_id INT64
terms_of_payment STRING
description STRING
sales_factoring_partner_id INT64
sales_invoice_taxclass_id INT64
sales_invoice_incl_vat INT64
auto_reminder_override INT64
auto_reminder_setting INT64
auto_reminder_count INT64
auto_reminder_interval INT64
auto_reminder_last_step INT64
shipping_date DATE
our_reference STRING
your_reference STRING
shipping_name STRING
shipping_name2 STRING
shipping_address STRING
shipping_postalcode STRING
shipping_city STRING
shipping_country_id INT64
currency_id INT64
sales_is_refused INT64
use_en16931 INT64
order_identifier STRING
agreement_identifier STRING
tender_reference STRING
delivery_method STRING
delivery_terms STRING
account_code INT64
modified TIMESTAMP
title STRING
locale_code STRING
sales_invoice_delivery_method STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
customer_group_customer (6 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
id INT64
customer_group_id INT64
customer_id INT64
modified TIMESTAMP
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
dimension (12 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
id INT64
code STRING
name_fi STRING
name_en STRING
name_sv STRING
description STRING
is_active INT64
active_after DATE
active_before DATE
dimension_type_id INT64
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
dimension_type (8 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
id INT64
name_fi STRING
name_en STRING
name_sv STRING
description STRING
is_active INT64
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
purchase_invoice (30 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
id INT64
supplier_name STRING
supplier_business_id STRING
supplier_vat_number STRING
invoice_date DATE
due_date DATE
entry_date DATE
modified TIMESTAMP
total_gross FLOAT64
total_due FLOAT64
total_gross_hc FLOAT64
total_net FLOAT64
total_net_hc FLOAT64
currency_rate FLOAT64
our_reference STRING
your_reference STRING
invoice_number STRING
order_number STRING
purchase_order_id STRING
bank_account STRING
bank_bic STRING
bank_message STRING
bank_reference STRING
terms_of_payment STRING
is_receipt INT64
is_first_invoice INT64
payable_account_code FLOAT64
created TIMESTAMP
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
purchase_invoice_row (15 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
article_identifier INT64
article_name STRING
freetext STRING
price FLOAT64
unit STRING
quantity FLOAT64
sum_net FLOAT64
sum_gross FLOAT64
vatpercent FLOAT64
discount_value FLOAT64
discount_percent FLOAT64
purchase_invoice_id INT64
purchase_invoice_row_index INT64
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
purchase_invoice_tag (10 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
id INT64
purchase_invoice_id INT64
description STRING
account_code STRING
sum FLOAT64
percent FLOAT64
vatcode_id INT64
created TIMESTAMP
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
purchase_supplier (34 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
id INT64
name STRING
name2 STRING
address STRING
postalcode STRING
city STRING
country_id INT64
country_code STRING
business_id STRING
vat_number STRING
bank_account STRING
bank_bic STRING
bank_account_2 STRING
bank_bic_2 STRING
bank_account_3 STRING
bank_bic_3 STRING
bank_account_4 STRING
bank_bic_4 STRING
bank_clearing_code STRING
bank_name STRING
bank_name2 STRING
bank_address STRING
bank_postalcode STRING
bank_city STRING
bank_country_id INT64
bank_country_code STRING
default_account_code STRING
default_currency_id INT64
default_currency_code STRING
default_payment_terms_id INT64
created TIMESTAMP
modified TIMESTAMP
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
sales_invoice (47 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
id INT64
invoice_no INT64
invoice_type_id INT64
auxiliary_name_id INT64
customer_id INT64
name STRING
name2 STRING
address STRING
postalcode STRING
city STRING
shipping_name STRING
shipping_name2 STRING
shipping_address STRING
shipping_postalcode STRING
shipping_city STRING
total_net FLOAT64
total_gross FLOAT64
total_vat FLOAT64
total_paid FLOAT64
total_due FLOAT64
banking_reference STRING
invoice_date DATE
due_date DATE
cash_discount_date DATE
cash_discount_sum FLOAT64
cash_discount_percent FLOAT64
vat_number STRING
our_reference STRING
your_reference STRING
penal_interest FLOAT64
complaint_days INT64
notes_internal STRING
notes_before STRING
delivery_method STRING
delivery_terms STRING
shipping_date DATE
delivery_period_start DATE
delivery_period_end DATE
order_identifier STRING
agreement_identifier STRING
tender_reference STRING
delivery_note_identifier STRING
waybill_identifier STRING
created TIMESTAMP
approved TIMESTAMP
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
sales_invoice_delivery (9 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
address STRING
einvoice_operator_id INT64
bic STRING
sent TIMESTAMP
confirmed TIMESTAMP
sales_invoice_id INT64
sales_invoice_delivery_index INT64
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
sales_invoice_payment (9 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
id INT64
date DATE
description STRING
credited_invoice_id INT64
sum FLOAT64
created TIMESTAMP
sales_invoice_id INT64
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
sales_invoice_row (22 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
product_id INT64
code STRING
name STRING
name_fi STRING
name_en STRING
name_sv STRING
description STRING
price FLOAT64
price_with_vat FLOAT64
include_vat INT64
quantity FLOAT64
unit STRING
vatpercent FLOAT64
discount_percent FLOAT64
total_net FLOAT64
total_vat FLOAT64
total_gross FLOAT64
dim STRING
sales_invoice_id INT64
sales_invoice_row_index INT64
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

After the first load, Kaivo keeps your BigQuery warehouse up to date for you. Where Fennoa supports it, each sync pulls only new and changed records so it stays fast; otherwise it refreshes the whole table. Every record keeps its original ID, so you won’t get duplicate rows.

How long does the initial sync take for Fennoa?

Section titled “How long does the initial sync take for Fennoa?”

It depends on how much history is in your Fennoa account. Most initial syncs finish within minutes, while large accounts can take a few hours. After that, syncs only fetch new and changed records, so they’re much faster.

Yes. You pick which tables to sync when you set up the connection and can change the selection later. Tables you don’t select are never copied to your warehouse.

What happens when Fennoa’s schema changes?

Section titled “What happens when Fennoa’s schema changes?”

New fields are never added automatically. You choose which fields to sync, so data you haven’t selected (sensitive personal data, for example) never lands in your warehouse. When a new field appears, it becomes available for you to add. What happens to removed or renamed fields depends on a table’s sync mode: full-refresh tables always match what’s currently in Fennoa, so dropped fields disappear, while incremental tables keep their existing columns and history, so an old field stays and newly added fields fill in over time.

How do I handle GDPR or data deletion requests?

Section titled “How do I handle GDPR or data deletion requests?”

Your data lives in your own Kaivo-managed BigQuery warehouse, so the most direct option is to delete or anonymise specific records right in BigQuery. If you delete data in Fennoa instead, full-refresh tables drop it on the next sync, while incremental tables keep it, so you would remove the row in BigQuery or ask us to run a full refresh. To remove everything, delete the Fennoa connector in Kaivo and all of its synced data is deleted with it.

Build profit and loss and balance reporting from your Fennoa ledger data.

Track sales and purchase invoices to monitor receivables, payables, and cash flow.

Join Fennoa financials with your sales or CRM data in BigQuery for a full picture.

Report on financials over time to compare months, quarters, and years.

Once Fennoa data lands in your Kaivo-managed BigQuery warehouse, you can explore it with AI tools or any BI tool that connects to BigQuery. Here’s how the most common destinations work with Fennoa data.

Use Kaivo’s MCP server to give Claude secure, workspace-scoped access to your data. Setup guide →

Microsoft’s BI tool with a native BigQuery connector. Supports direct query and scheduled refresh. Setup guide →

Free Google BI tool with native BigQuery support. One-click connection to your Kaivo warehouse; great for SMB teams on Google Workspace. Setup guide →

The premium analytics standard, with native BigQuery integration. Setup guide →

Use Connected Sheets to query BigQuery directly from a spreadsheet, with no SQL. Setup guide →

Connect via Power Query’s BigQuery connector. Setup guide →

Open-source BI tool with strong BigQuery support. Setup guide →

See our pricing page for Fennoa connector pricing and plan details.