Skip to main content
Connect Uniconta so Floral can work with accounting data from one Uniconta company. A workspace connects to one Uniconta company at a time. Once connected, Floral keeps companies and people in step with Uniconta customers and contacts. You choose what syncs, preview the first run, and decide on records Floral can’t match with certainty. Assistants such as Penny can also work in Uniconta through the same connection. See Use Uniconta with assistants.

Before you start

You need workspace administrator access in Floral, and the following in Uniconta:
  • A Uniconta subscription with at least one normal user.
  • The Serverlogin add-on, about 119 kr. per month excl. VAT, billed by Uniconta.
  • A server user created for Floral. It can’t be the company owner and can’t use two-factor authentication.
Floral signs in with the server user’s username and password. You don’t need an API key or any other registration from Uniconta. A trial company works for evaluation only.

Connect Uniconta

1

Open Uniconta

In Floral, open Settings > Workspace > Integrations, choose the Accounting category, and select Connect on the Uniconta tile.
2

Check the prerequisites

The first step lists what Uniconta needs. Select Continue to sign-in when the server user is ready.
3

Sign in with the server user

Enter the server user’s Username and Password, then select Find companies. Floral checks the login with Uniconta and lists the companies the user can reach. Floral stores the login encrypted and never shows the password again.
4

Choose the company

Select the company to connect. When the user reaches only one company, it is already selected. Select Connect. Floral opens the Uniconta connection page.

Check the connection

The connection page shows the company name, the Uniconta company ID, the currency, who connected it and when, when Floral last checked the login, and the status: Connected, Needs attention, or Disconnected. If the status needs attention, the last error from Uniconta appears under Last error.

Choose what syncs

Workspace administrators set up sync under What syncs on the connection page. Each change saves at once.

Companies and customers

Turn on Sync companies to make Floral companies customers in Uniconta.

People and contacts

Turn on Sync people to make people contacts on their company’s customer. Choose Primary contacts of synced Work records or All people at synced companies. People without a company aren’t synced yet.

Customer defaults

Floral applies these to customers it creates in Uniconta:
  • Debtor group and Payment term. Leave them on Uniconta default to use Uniconta’s own defaults.
  • Account numbers. By default Floral numbers new customers with a prefix and a sequence, such as FL000042. You can change the prefix (1 to 6 letters, digits, or dashes). Choose Uniconta numbers them through the debtor group only when the debtor group has a number series in Uniconta; Uniconta refuses a customer without an account number otherwise.

Field mapping

Core fields always sync: Floral never clears a field in Uniconta: a blank value in Floral isn’t sent. The CVR always follows Floral. With Two-way direction, Who wins decides each customer field: Floral keeps Floral’s value, Uniconta lets Uniconta’s value replace it. Floral supplies contact details. For contacts marked for invoicing in Uniconta, two-way sync preserves their billing name and email until you choose a recipient in Floral. On the company, select Edit → Invoice recipient to choose a person or enter a shared mailbox. Use accounting recipient lets Uniconta supply the address. Import existing customers again to refresh their recipients, or enable two-way company sync for ongoing updates. If the customer has no invoice email, Floral uses a single contact marked for invoices. To send more, select Add custom field, choose a company custom field, and enter the field name the way Uniconta’s Web API spells it, such as Dimension1. Select Save mapping.

Preview the first sync

The first time you turn on Sync companies, Floral shows Preview the first sync before anything is written. It counts the companies (and people, when people sync is on) that would be created in Uniconta, updated, left unchanged, matched by CVR, name, or email, held for review, excluded, or left out of scope, with up to 10 example names per group. Select Start sync to turn sync on and start the first run. Floral matches a company to an existing customer by CVR first, then by the same name and postal code. When neither is certain, the record waits in Review. Floral never creates a customer while a possible match is waiting for your decision.

Work rules for memberships

A Work rule connects one workflow to Uniconta. Active members get a status on their Uniconta customer, and renewals become invoice drafts (Uniconta sales orders) ahead of each period. Floral never books or sends an invoice, and never changes a draft it created. Work rules need Work and companies sync. Without Work, companies and people still sync, and the Work rules card explains what’s missing.

Add a rule

Under Work rules, choose the workflow in Add rule and select Add rule. A workflow installed from the Membership template arrives pre-filled: the Aktiv stage is active, the status goes to your first dimension with the values that look like active and resigned, periods follow the calendar from January, and the billing cadence, exit date, and category come from the template’s fields. Check the choices and select the Uniconta item. Every setting is a dropdown over the workflow’s stages and fields or values Floral found in Uniconta. Invoice periods starting on or after defaults to the day you switch invoice drafts on, so periods you already invoiced in Uniconta are never billed again. Change it if you want Floral to bill earlier periods.

Preview and switch on

Select Preview to see what the rule would do now: active records and customers, status changes, and the next run’s orders and lines per period and what they add up to, with the records that won’t be billed and why (no company, different currency, no item, no price, and so on). If an item the rule uses no longer exists in Uniconta, the preview says so. Save and switch on becomes available after the preview. Floral creates due drafts once a day. To create them right away, select Create due drafts now on the rule.

How drafts are built

  • One sales order per customer and period, with one line per membership. A customer with more than 200 memberships in a period gets an extra order for each further 200, marked :2, :3, and so on. The member’s name is the order reference, and the order remark carries the period, such as Floral 2027 [floral:1a2b3c4d:2027-01-01].
  • With the Uniconta item’s price, Floral reads the item’s sales price for the customer’s price group (sales price 1, 2, or 3) and puts it on the line. A member whose price group has no price on the item isn’t billed and shows Needs attention; set the price in Uniconta and the next run bills it.
  • If an item the rule uses is deleted or blocked in Uniconta, the rule creates no drafts and its members waiting for a draft go to Review. Choose another item in the rule, or restore the item in Uniconta: the next run creates the drafts and clears the review.
  • A draft is never changed afterwards. New prices and categories apply from the next period.
  • A record whose currency differs from the customer’s goes to Review instead of being converted.
  • A member who resigns while a draft is open goes to Review with the order number, so you can credit or remove it in Uniconta.
  • Members without a company aren’t billed yet.

On the Work record

Records under a rule show the latest draft next to the header actions, such as Invoice draft 191006 · 2027, then Invoiced. The Invoice drafts section lists each period. Select the status and choose Sync now to write the record’s status right away. When the record is Excluded, a workspace administrator chooses Include in sync. Abandoned drafts stay blocked. Uniconta removes an order when it’s invoiced. When Uniconta lets Floral read invoices, the period shows Invoiced; otherwise Floral shows that the order is no longer open (invoiced or removed).

Import customers from Uniconta

To bring Uniconta customers into Floral, select Import customers under Activity. The import:
  • Groups customers as Already in Floral (matched by CVR), Likely matches (same name and postal code), and Not in Floral.
  • Filters by Debtor group. Select all ticks every customer in the current filter.
  • Creates companies and their contacts as people, or links customers to the matching company. It never creates Work records.
You can run the import again; customers already linked are skipped.

Follow sync in Activity

Activity lists recent runs with what started them, their scope, status, start time, duration, and how many records were created, updated, unchanged, failed, or held for review. Select Sync now to run a sync right away.

Review

Records Floral couldn’t match with certainty appear under Review with the reason and the possible Uniconta customers: Work records appear in Review when a resigned member has an open invoice draft, when the record’s currency differs from the customer’s, when the rule’s Uniconta item no longer exists, or when Uniconta didn’t confirm a draft. Select Mark as handled once you’ve dealt with it in Uniconta, Exclude to leave the record out of Work rules, or, for an unconfirmed draft, enter the order number from Uniconta and select Link order, or select Create the draft again. Before you choose Create new or Create the draft again, look for the record in Uniconta. When Uniconta didn’t confirm a change, it may still have made it. An unconfirmed draft’s order remark carries the period, such as [floral:1a2b3c4d:2027-01-01]. If you exclude a Work record while its draft is unconfirmed, Floral marks the draft as abandoned and never tries it again. Check Uniconta for the order and remove it if you don’t want it. An excluded record stays out of sync until a workspace administrator includes it again. On the company, person, or Work record, select the status and choose Include in sync. The record syncs on the next run and may appear in Review. A record without a Uniconta customer or contact is matched again. Abandoned invoice drafts on a Work record stay blocked and are never retried.

Failed

Records whose last change Uniconta refused appear under Failed with Uniconta’s message. Fix the cause, then select Retry to sync that record again. When review items or failures are waiting, workspace administrators see a marker on Settings > Workspace > Integrations and a Uniconta item on Home.

Sync status on companies and people

Company and person pages show the Uniconta status next to the header actions: Hover the status to see the Uniconta account number and the last error. Select it and choose Sync now to sync that record right away; anyone who can edit the record can do this. When the status is Excluded, a workspace administrator can choose Include in sync. The External systems section on the record lists its CRM link and its Uniconta customer with the account number, balance, overdue amount, last invoice, and whether the customer is blocked in Uniconta. In Relationships, open View > Columns and turn on Uniconta to see each company’s and person’s status in the list.

Change notifications

Uniconta can tell Floral when a customer changes, so updates arrive within minutes instead of with the nightly sync. Floral registers change notifications while companies sync is on. If changes from Uniconta stop arriving, select Register under Change notifications. If Uniconta doesn’t accept the registration (for example because the server user lacks the right), Floral shows a webhook URL once. Add it in Uniconta yourself:
1

Copy the URL

Select Copy URL. Floral shows the URL once, so copy it before you leave the page.
2

Open the change URL setting in Uniconta

In Uniconta, open Company, then Maintenance, then Change URL.
3

Paste the URL

Add the URL for the Debtor table and save.

Use Uniconta with assistants

Penny, the accounting assistant, can read Uniconta and prepare changes for your approval through the integration’s own login. No second login is stored.
1

Turn it on

On the Uniconta connection page, turn on Enable for assistants under Assistants. Floral checks the login and the company with Uniconta first, then makes the connection available to Penny.
2

Choose which changes Penny may make

Assistants can only read until you allow changes. Select Choose which changes assistants may make and tick the kinds of change: customers, suppliers and contacts; draft invoices; posting invoices; items; supplier invoices; journal lines and posting them. Every change still waits for a person to approve it.
You can also connect Uniconta as an assistant app from Marketplace: open the Uniconta assistant app and select Connect. Floral opens the connect step under Settings > Workspace > Assistants > Apps, where you choose Use the Uniconta integration account, or Use a separate server login for a Uniconta company Floral doesn’t sync with. What to expect:
  • Penny checks that Uniconta opens the connected company every time she uses it.
  • A draft invoice is a sales order in Uniconta. Posting it does not send it; send it from Uniconta.
  • Registering a payment isn’t available in Floral yet. Register payments in Uniconta.
  • Some Uniconta logins can’t read invoices, open items or ledger lines through Uniconta’s API, or post invoices. Floral hasn’t confirmed this with every kind of login yet. When Uniconta refuses, Penny says the information isn’t available on this Uniconta account, and shows each customer’s balance or the financial year’s account totals instead, labelled as such.
  • Disconnect stops assistants at once. After connecting again, turn on Enable for assistants again. Reconnect with a new password keeps assistants working.

Reconnect or disconnect

Troubleshooting