Skip to content
Integrations

Connect Scoro to Uku

Company Admin or Company Owner role on a Team or Elite Uku subscription. You also need a Scoro login with permission to view API settings — typically an administrator on the Scoro account.

Scoro is the right integration for firms in Estonia, the United Kingdom, and globally where Scoro is used as an ERP/business management tool that needs invoice data pushed in from Uku.

Scoro is a sales-led integration in Uku and is not available by default. Before you can configure it, ask Uku support to enable Scoro for your company.

  1. Email Uku support and ask for the Scoro integration to be activated for your company.
  2. Once Uku confirms activation, the Scoro card appears in Settings & Apps → Integrations.

To connect Scoro to Uku you need three values from your Scoro account: a company account ID, an API key, and your subdomain.

  1. Sign in to Scoro with an administrator account.
  2. Go to Settings → API (the path can vary slightly between Scoro versions).
  3. Copy:
    • Company account ID — identifies your Scoro account.
    • API key — the secret used to authenticate API calls.
    • Subdomain — the prefix of your Scoro URL. If your Scoro URL is https://acme.scoro.com, the subdomain is just acmenot the full URL.

Path: Settings & Apps → Scoro

The Scoro integration must be enabled at the company level before it can be used per client. Enabling does not yet pull data; it just makes the integration available.

  1. Open Settings & Apps in Uku.
  2. Find the Scoro card in the Integrations section. (If it is missing, return to the previous step and request activation from Uku support.)
  3. Click the card to open the integration dialog.
  4. On the Overview tab, click Enable to turn the integration on.

After enabling Scoro, paste the company account ID, API key, and subdomain into the integration dialog and pick the invoice language.

  1. In the integration dialog, switch to the Connect (or Settings) tab.
  2. Paste the company account ID into the matching field.
  3. Paste the API key into the matching field.
  4. Paste the subdomain — just the prefix (e.g. acme), not the full URL.
  5. Choose the language used for invoice exports (Estonian, English, or another supported language).
  6. Click Test connection. Scoro responds with the account name if the credentials are valid.
  7. Click Save.

If the test connection fails, see Troubleshooting below.

Scoro is outbound-focused — Uku pushes invoices into Scoro. Tax rates are read from Scoro so invoices use the correct VAT codes. Clients are not imported from Scoro.

DataDirectionNotes
Tax ratesScoro → UkuUsed when sending invoices to Scoro.
InvoicesUku → ScoroUku invoices are pushed into Scoro when they are issued.
Clientsnot syncedClients are managed in Uku. The Scoro integration does not import customer records into Uku.
Work statisticsnot syncedScoro is not used as a source of monthly summary task statistics.

Pushing invoices to Scoro requires linking each Uku client to its Scoro customer. The full per-client connection workflow is covered in Connect a client to accounting software. The short version:

  1. In the client list, click the Integration column on the client row.
  2. Pick Scoro from the integration dropdown.
  3. Provide the matching Scoro customer reference (the integration dialog walks you through the lookup).
  4. Save. The next invoice issued for that client is pushed to Scoro using the correct tax rates and language.

To refresh tax rates and other reference data from Scoro:

  1. Open Settings & Apps → Scoro → Settings.
  2. Click Reload data at the bottom-left of the dialog.
  3. Confirm. Uku re-imports tax rates and reference data and notifies you when ready.

Reload data is the right action whenever you change tax rates in Scoro, or after fixing a connection that was offline.

The Scoro card is not visible in Settings & Apps

Section titled “The Scoro card is not visible in Settings & Apps”

If the Scoro card does not appear in Settings & Apps, Scoro is not yet activated for your Uku company. Contact Uku support to enable it. Without activation the integration card does not appear in the integration list.

Test connection fails with “subdomain not found” or similar

Section titled “Test connection fails with “subdomain not found” or similar”

A “subdomain not found” error from Scoro almost always means the full Scoro URL (https://acme.scoro.com) was pasted into the subdomain field instead of just the prefix (acme). Replace the value with the prefix only and test again.

Test connection fails with an authentication error

Section titled “Test connection fails with an authentication error”

Other common causes of authentication errors with Scoro:

  • The API key has leading or trailing whitespace. Re-copy directly from Scoro.
  • The company account ID does not match the API key (e.g. credentials from a different Scoro account were mixed in).
  • The API key was revoked in Scoro. Generate a new key in Settings → API and paste it into Uku.

If an invoice fails to push to Scoro, open the failed invoice in Uku and check the integration error message. Common causes:

  • The Uku client is not linked to a Scoro customer — set the Integration column to Scoro on the client row.
  • The Scoro tax rate cache is stale — run Reload data to refresh.
  • The Scoro customer was archived or deleted in Scoro.

If invoices push to Scoro in the wrong language, the language is set on the integration Connect tab and applies to all invoices pushed to Scoro from this Uku company. Change the language selector and save to switch the export language going forward — already-pushed invoices keep the language they were created with.

A previously working Scoro connection stopped syncing

Section titled “A previously working Scoro connection stopped syncing”

A Scoro connection that was working but stopped is usually a credential issue. Scoro API keys do not expire automatically, but they can be revoked if a Scoro administrator rotates credentials. Generate a fresh API key in Scoro, paste the new value into Uku, and click Test connection to confirm.