Before you begin
- Use a SmartAccounts package that includes API access. The Pro package lists “API ja välised liidesed” (API and external interfaces); the pay-per-entry Starter package does not. If an accounting firm keeps your books, ask which package your company is on.
- Ask a SmartAccounts administrator to create the API key. If your accounting firm administers the company, they create it.
- Connect one SmartAccounts company per Control entity. Create the entity first, with Estonia as its country and EUR as its currency. SmartAccounts is available only for entities in Estonia.
Create an API key in SmartAccounts
- In SmartAccounts, open Seaded → Liidetud teenused → API (Settings → Connected services → API).
- Turn on the API and copy the public API key and the secret key.
- Under Seaded → Kasutajagrupid (Settings → User groups), open the API user group and limit it to what Control reads:
- keep the general ledger, the settings lists (accounts, objects, report rows), and the client invoice, vendor invoice and payment lists;
- add the General ledger privilege, which Control uses to check balances against SmartAccounts;
- turn off Saving enabled and Deleting enabled.
Connect in Control
- Open the entity in and select Add data source.
- Select SmartAccounts.
- Paste the API key and the secret key.
- Select Verify. Control checks the key, the chart of accounts, objects and recent entries.
Data imported
- The chart of accounts, with Estonian and English names.
- Every general-ledger entry in EUR: manual entries, client and vendor invoices, bank and cash payments, VAT returns, salary, depreciation, warehouse movements and opening balances.
- Objects, as a dimension.
Balance sheet classification
SmartAccounts has asset, liability, income and expense accounts. Control treats a liability account as equity when it sits in the equity block of the balance sheet (rows starting with B25 in the standard Estonian chart), or when its balance sheet row is named as equity. You can adjust the classification in your group account mapping.How syncing works
- Control picks up new, changed and deleted entries every night, and always reads the current and previous month again.
- Once a week, Control reads the full history again.
- SmartAccounts allows 1,000 API requests a day per company, shared by every integration that uses it. Control uses at most 600 of them, so your other integrations keep working.