Flexibee: how to connect Fakturqa to your instance

Flexibee plays a slightly different role in the Czech accounting landscape — you use it either in the cloud (managed instance on Flexibee servers) or in on-premise (your own installation). In both cases you authenticate to the REST API using credentials for the instance. That's different from OAuth-based iDoklad or Fakturoid — but equally simple to set up.

What you'll need upfront

• URL of your Flexibee instance. Cloud looks like https://demo.flexibee.eu/ or https://my-account.flexibee.eu/. On-premise is the URL of your server installation.
• Username and password — or better an API token. We recommend a dedicated user with minimal access (Received Invoices module).
• Company code if you have multiple companies in Flexibee — Fakturqa needs to know which one to post into.

1. Connection in Fakturqa

1. In Fakturqa go to Settings → Connections → Connect Flexibee.
2. Fill in instance URL, company code, username and password.
3. Click Test connection. Fakturqa tells you right away whether it can authenticate and pull the supplier list. If yes, save.
4. Your credentials are stored encrypted via AES-256-GCM with a key held only by the running app — unreadable in the DB even to us. You can delete them anytime with one click.

2. What the document looks like in Flexibee after creation

Fakturqa creates a document of type faktura-prijata via the Flexibee REST endpoint. From extracted data we fill in:

• Document number (from the invoice, not from a Flexibee number series)
• Variable symbol, KS, SS — if they were on the invoice
• Supplier (Fakturqa attempts to match an existing supplier by business ID; if it doesn't exist we create one)
• Issue date, due date, date of taxable supply
• Line items with name, quantity, unit price and VAT rate
• Total amount including VAT

3. Multi-company

If you have multiple companies in Flexibee (e.g. operations + holding), you can create multiple connections in Fakturqa — each pointing to a different company code. Typically:

• Connection A: company code demo, inbound address demo@mail.fakturqa.com
• Connection B: company code holding, inbound address holding@mail.fakturqa.com

Invoices forwarded to a specific address then go to the correct company in Flexibee.

4. Send your first invoice

1. In Settings → Inbound addresses you'll find your address, e.g. flex-2891@mail.fakturqa.com.
2. Forward any received invoice (from email, or snap it in the mobile app).
3. Within ~5 seconds a record appears in Fakturqa under Reviewing. Check the data, fix if needed, click Confirm.
4. Fakturqa calls the Flexibee REST endpoint and creates the incoming invoice. Open Flexibee and find it in Received invoices.

Common issues

Connection test failed with 401 Unauthorized

• Check the URL — Flexibee is sensitive to trailing slashes. Try with and without.
• Verify the user can actually access the REST endpoint — some Flexibee roles have REST API explicitly disabled.
• For on-premise installations, verify the server runs HTTPS with a valid certificate. Self-signed certificates are rejected.

Supplier created repeatedly (duplicates)

Fakturqa matches suppliers by business ID (IČO). If you have suppliers in Flexibee without an IČO, matching fails and a new record is created. We recommend going through suppliers in Flexibee once and filling in the IČO — duplicates won't repeat.

VAT rate maps incorrectly

Flexibee has its own VAT rate codebook. Fakturqa maps standard CZ rates (21%, 15%, 12%, 10%, 0%, exempt) per the default codebook. If you have custom VAT codes in Flexibee, email me — send the list of your VAT codes and we'll map them.

Summary

• In Flexibee create a dedicated fakturqa-api user with minimal rights.
• In Fakturqa enter the instance URL, company code and credentials. Test the connection.
• Forward invoices to your inbound address — Fakturqa extracts and creates them in Flexibee.
• For multiple companies in Flexibee, create multiple connections with separate inbound addresses.

Try with Flexibee — free

5 invoices per month free forever. Connection takes a minute.