SimplBooks
Estonian cloud accounting and invoicing
Overview
Connect a client's SimplBooks company so Taxxa can read its accounting data directly from SimplBooks: sales and purchase invoices, payments and receipts, customers and suppliers, the chart of accounts, items and stock, and orders. You can then ask questions about the client in Taxxa without exporting reports. You connect with an API user that the company's SimplBooks admin creates, and the API user's user group decides what Taxxa can reach. This is an office connection: people who can manage office access, a permission a workspace admin gives, connect it. Everyone else can use it only with access to its client, given per client or to all clients on the Office access page.
What Taxxa can access
- Sales invoices and credit notes, with their rows, PDFs and e-invoice XML, and the receipts linked to them.
- Purchase invoices, with their rows, documents and payments.
- Customers and suppliers, and the money received and paid out.
- The chart of accounts, VAT types, bank accounts, items, warehouses and stock, sales orders, purchase orders, price offers and employees.
- Taxxa can also prepare changes, such as a new customer, a sales or purchase invoice, or a payment, for members with Read & write access to the client. SimplBooks allows only what the API user's user group permits. Keep the API token like a password.
Before you connect
- A SimplBooks company whose plan includes the API. SimplBooks offers the API in its Premium plan.
- An admin of the company in SimplBooks, who creates the API user. Each API user gives access to one company only.
- A user group for the API user that allows what Taxxa may do. SimplBooks checks it on every request, so Taxxa can only do what the group allows. In Taxxa, an office access manager can narrow this further for each member, never widen it.
- The office access permission in Taxxa, given by a workspace admin. Only office access managers can connect SimplBooks.
How to connect
- In SimplBooks, select the client's company in the top-right corner. These steps use the labels of SimplBooks's English interface.
- Go to Settings → Users in the top menu, click New user and choose API User.
- Enter a name, for example Taxxa, choose the user group whose rights Taxxa may use, and click Save.
- In the user list, click the three dots next to the API user and choose View API Token. Copy the token.
- Copy the company ID from the address bar: it is the part straight after app.simplbooks.com/, for example 0fdf33a5c10c384986f81fc45a444f22.
- In Taxxa, open Connectors, choose the client company and select SimplBooks. Select Connect.
- Enter the company ID and the API token, and select Connect. Taxxa checks them with SimplBooks.
- In Taxxa, open the Office access page from Connectors and give members access per client or to all clients: Read for the read actions, or Read & write for every action. People who can manage office access have full access. A write action still follows each member's own approval setting: Taxxa asks before each change unless that member chose to allow changes without asking.
- To give access to many clients at once, select Edit next to a member on the Office access page, filter the clients, for example by connector, select all matching clients, choose Read or Read & write, and save.
- Each API user gives access to one company. To connect another client, create an API user in that client's SimplBooks company and connect it in Taxxa as above.
Where to find your details
- Company ID
- The ID of the client's SimplBooks company. Sign in to SimplBooks, select the company, and copy the part of the address straight after app.simplbooks.com/, for example 0fdf33a5c10c384986f81fc45a444f22. It has only letters and numbers.
- API token
- The token of the API user. In SimplBooks, go to Settings → Users, click the three dots next to the API user and choose View API Token. Keep it like a password: with the company ID, it opens what the API user's user group allows in that company.
Troubleshooting
- Taxxa says the company ID or the API token is not valid.
- Check that the company ID is only the part of the address straight after app.simplbooks.com/, without the slashes or anything after it, and that you copied the whole token. Check also that the API user is still active under Settings → Users.
- Some requests fail while others work.
- SimplBooks refuses a request that the API user's user group does not allow, with the same error as a wrong token. Ask the company's SimplBooks admin to give the API user a user group that allows the request, then try again.
- Settings → Users does not offer an API user.
- The company's SimplBooks plan does not include the API. SimplBooks offers the API in its Premium plan. Change the plan or contact SimplBooks support.
- Taxxa shows data from the wrong company.
- The company ID and the API user belong to one company. Select the right company in SimplBooks, create an API user there, and reconnect SimplBooks in Taxxa for that client with that company's ID and token.
- Taxxa says SimplBooks is busy.
- SimplBooks allows 60 requests a minute for each company. Wait a minute and try again, or ask for fewer records at a time.
Disconnect
In SimplBooks, deactivate or delete the API user under Settings → Users. Its token then stops working. You can also disconnect SimplBooks in Taxxa under Connectors.
Connect SimplBooks in Taxxa
Already a customer? Go to Connectors and choose SimplBooks.