Connect Scoro to Uku
Who can do this
Section titled “Who can do this”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.
Request Scoro activation from Uku support
Section titled “Request Scoro activation from Uku support”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.
- Email Uku support and ask for the Scoro integration to be activated for your company.
- Once Uku confirms activation, the Scoro card appears in Settings & Apps → Integrations.
Collect Scoro API details
Section titled “Collect Scoro API details”To connect Scoro to Uku you need three values from your Scoro account: a company account ID, an API key, and your subdomain.
- Sign in to Scoro with an administrator account.
- Go to Settings → API (the path can vary slightly between Scoro versions).
- 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 justacme— not the full URL.
Enable the Scoro integration in Uku
Section titled “Enable the Scoro integration in Uku”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.
- Open Settings & Apps in Uku.
- Find the Scoro card in the Integrations section. (If it is missing, return to the previous step and request activation from Uku support.)
- Click the card to open the integration dialog.
- On the Overview tab, click Enable to turn the integration on.
Connect Scoro with API details
Section titled “Connect Scoro with API details”After enabling Scoro, paste the company account ID, API key, and subdomain into the integration dialog and pick the invoice language.
- In the integration dialog, switch to the Connect (or Settings) tab.
- Paste the company account ID into the matching field.
- Paste the API key into the matching field.
- Paste the subdomain — just the prefix (e.g.
acme), not the full URL. - Choose the language used for invoice exports (Estonian, English, or another supported language).
- Click Test connection. Scoro responds with the account name if the credentials are valid.
- Click Save.
If the test connection fails, see Troubleshooting below.
What data syncs with Scoro
Section titled “What data syncs with Scoro”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.
| Data | Direction | Notes |
|---|---|---|
| Tax rates | Scoro → Uku | Used when sending invoices to Scoro. |
| Invoices | Uku → Scoro | Uku invoices are pushed into Scoro when they are issued. |
| Clients | not synced | Clients are managed in Uku. The Scoro integration does not import customer records into Uku. |
| Work statistics | not synced | Scoro is not used as a source of monthly summary task statistics. |
Connect each client for invoice export
Section titled “Connect each client for invoice export”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:
- In the client list, click the Integration column on the client row.
- Pick Scoro from the integration dropdown.
- Provide the matching Scoro customer reference (the integration dialog walks you through the lookup).
- Save. The next invoice issued for that client is pushed to Scoro using the correct tax rates and language.
Re-syncing Scoro reference data
Section titled “Re-syncing Scoro reference data”To refresh tax rates and other reference data from Scoro:
- Open Settings & Apps → Scoro → Settings.
- Click Reload data at the bottom-left of the dialog.
- 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.
Troubleshooting
Section titled “Troubleshooting”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.
An invoice fails to push to Scoro
Section titled “An invoice fails to push to Scoro”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.
Invoice language is wrong
Section titled “Invoice language is wrong”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.