Solavel Docs

Integrations

Last updated

The workspace Integrations page manages the connection between SolaProjects and SolaCount for your whole organization. Connecting adds financial visibility to your existing projects — linked invoices, expenses and bills, project profitability, approved time turned into draft invoices, and budget versus actual — without copying, recreating or renumbering your projects. SolaCount simply uses the same project records and IDs.

Owners and finance managers use this page to connect, pause, disconnect, resume and health-check the connection. Everyone else can open it to see the status and ask an administrator to act.

This page is the workspace sidebar item. The project-level Integrations tab (webhooks, API tokens, native integrations) is covered in Integrations (project tab).

Where to find it

How Details
Sidebar Menu → Integrations (plug icon), last item of the Menu group.
Dashboard View details on the SolaCount card.
Notifications Open on any SolaCount notification.
Command palette Ctrl K → Integrations.
URL /projects/settings/integrations. The older /projects/integration-status opens the same page.

Who sees it: every SolaProjects user. Who can act:

Role in the organization Can do
Owner, admin, accountant (including client owner/accountant) or anyone granted manage integration Connect, pause, disconnect, resume, reconnect, run checks, stop reminders.
Everyone else View status and counts; Notify an administrator when shown.

The connection itself needs SolaCount on the plan (SolaCount Premium, or a bundle that includes it) and SolaProjects Professional or higher.

Screen tour

Area Content
Header SolaCount connection — "Connect project operations with financial visibility—without copying your projects."
Readiness card SolaCount logo, status badge, one sentence, action buttons, then Plan, Billing (Available, subject to permissions / Not available yet) and Last checked.
Counters Seven tiles (below).
Action row Buttons that depend on the status and your rights.
Recent connection activity Only when a connection exists: events (for example connected, paused, health check completed) with date and time.

If the page cannot load: We couldn't load the SolaCount connection. with Retry.

Counters

Tile Meaning
Active projects Non-archived projects that will use the connection.
Archived Archived projects (kept as they are).
With time entries Projects that have time logged.
Historical links Existing relationships between projects and finance records.
Linked documents Finance documents already linked to projects.
Ready to bill Approved billable time items ready for invoicing.
Requires review Relationships that need checking before or after connecting.

Statuses and buttons

Badge Sentence Buttons (managers) Buttons (others)
Ready to connect Finance is ready. Continue the connection setup when you are ready. Connect SolaCount, Review what will happen, Not now, Don't remind me —
Finance setup incomplete Complete your Finance setup to continue connecting SolaProjects. Complete Finance setup Complete Finance setup if offered
Finance provisioning pending Your Finance workspace is being prepared. Check again shortly. — (wait) —
Finance access unavailable Review the Finance access required for this connection. / Review your product access to restore financial integration. Manage apps and plans Manage apps and plans
(SolaCount ready, you lack the role) "SolaCount Premium is ready, but an organization owner or Finance administrator must complete the connection." — Notify an administrator
Connected Your Finance connection is active. View details for billing availability. Pause Finance integration, Disconnect, Run connection check —
Integration paused Financial integration is paused. Review details before resuming. Resume integration, Run connection check —
Disconnected — history preserved The connection is disconnected. Your existing history is preserved. Reconnect SolaCount, Run connection check —
Connection in progress Connection setup is in progress. Review the next required step. Run connection check —
Connection needs attention Financial actions need attention. Review the connection details. Review connection issue, Run connection check Review connection issue
Unable to verify connection status Connection status is temporarily unavailable. Please try again. Retry Retry

Non-managers also see "Ask your organization owner or Finance administrator to complete setup." whenever the status is not Connected. The page re-checks the status each time you return to the browser tab.

Automatic connection for new organizations

Usually you do not need to connect by hand. When an organization's plan has both SolaCount and SolaProjects, SolaCount connects SolaProjects automatically right after SolaCount setup is finished — but only for a fresh organization where all of these are true:

  • the plan includes both apps;
  • SolaCount setup is complete (chart of accounts and base currency);
  • the organization has an active owner;
  • nobody has made a connection choice yet (no earlier connect, pause, disconnect, dismissed reminder or custom switch);
  • there is no business data yet (no projects, journal entries, invoices, bills, expenses, payments or sales receipts).

Otherwise the page shows Ready to connect for an owner to review. Automatic connection never resumes a paused or disconnected connection and never creates projects, accounting documents or journal entries.

Tasks

Connect SolaCount

  1. Open Integrations. The badge must read Ready to connect.

  2. Click Connect SolaCount (or Review what will happen — same review). The dialog SolaProjects ↔ SolaCount · 1/4 opens.

  3. Step 1 · Overview — Organization, Plan, Finance setup (Complete / Incomplete), Connecting as, Existing projects, and: "Your existing projects will become available in SolaCount using their current records and IDs. They will not be copied or recreated." Click Continue.

  4. Step 2 · Readiness check — each check shows Ready, Warning or Blocked with a message. Continue stays disabled while any check is Blocked.

  5. Step 3 · Review what will be enabled — "Projects created: 0 · Project IDs changed: 0 · Automatic accounting documents: 0". Toggle features (all on by default):

    Toggle Effect
    Link invoices to projects SolaCount invoices can carry a project.
    Link expenses and bills to projects Costs can be assigned to projects.
    Show project costs and profitability Profitability appears on project Overviews.
    Enable approved time → draft invoice Approved billable time can become a SolaCount draft invoice.
    Show budget versus actual The Budget tab compares with posted actuals.
  6. Step 4 · Confirm connection — "Connecting enables financial features for your existing projects without copying or changing them. No accounting documents will be created automatically." Click Connect SolaCount.

  7. You see SolaCount connected. Your project IDs were preserved. The badge turns Connected and admins receive a Connection complete notification.

Each step is saved as you go — close the dialog and Connect SolaCount resumes where you left off. Back returns a step. Errors: Could not start the connection review., Could not save this step., Connection checks are blocked. Review the readiness results.

Postpone or stop reminders

  • Not now — closes the prompt; reminders continue.
  • Don't remind me — stops reminder notifications: Connection reminders stopped. Without it, owners and finance managers get up to two reminders (after about 24 hours and 7 days).

Ask an administrator

  1. Click Notify an administrator.
  2. You see An administrator was notified. Owners and finance managers receive SolaCount connection requested in Notifications. Repeated clicks on the same day send one request.

Pause, disconnect, resume, reconnect

Button Confirmation title Message
Pause Finance integration Pause Finance connection "Shared Finance features will pause. Historical data remains available."
Disconnect Disconnect Finance "This stops shared Finance features. Projects, documents, and historical relationships remain available."
Resume integration / Reconnect SolaCount Resume Finance connection "This resumes the connection using the same projects and identifiers."

Confirm → Connection status updated. (or Could not update the connection.). Nothing is deleted; invoices, bills and billed time already in SolaCount stay.

Run a connection check

Click Run connection check → Connection check completed. If a safety check newly fails, the badge becomes Connection needs attention and admins are notified.

Complete Finance setup

On Finance setup incomplete, click Complete Finance setup (shows Opening Finance setup…) to open SolaCount setup for this organization. If it cannot open: "Could not open Finance setup. Please retry."

Lifecycle

State What works
Not connected / Ready to connect SolaProjects works fully; no finance sections.
Connected All enabled finance features.
Paused Shared finance features stop; history visible.
Disconnected — history preserved Finance features off; links and documents kept; can reconnect with the same IDs.
Needs attention Financial actions may be blocked until reviewed.

A single project can opt out with Settings → Integrations → Internal project / finance disabled — see Settings and Integrations (project tab).

Permissions

Action Owner / admin / accountant Other users
View status, counters, activity Yes Yes
Connect, pause, disconnect, resume, reconnect Yes No
Run connection check, stop reminders Yes No
Notify an administrator — Yes (when offered)
Receive connection notifications Yes No

Worked examples

Example 1 — a team member asks for the connection

Sara Khan (Projects Member) at Al Noor Trading LLC wants to bill approved time. She opens Integrations: "SolaCount Premium is ready, but an organization owner or Finance administrator must complete the connection." She clicks Notify an administrator → An administrator was notified. Fatima (owner) gets SolaCount connection requested — Sara Khan asked an administrator to review the SolaCount connection.

Example 2 — owner connects, then pauses at year-end

  1. Fatima opens the page: Ready to connect, counters Active projects 9 · Archived 3 · With time entries 6 · Ready to bill 14.
  2. Connect SolaCount → Overview (Plan Premium, Finance setup Complete) → Readiness: all Ready → she leaves all five features on → Connect SolaCount.
  3. SolaCount connected. Your project IDs were preserved. Al Noor Showroom Fit-out (ALN-FIT) keeps its ID; its Overview now shows revenue, cost and margin in AED.
  4. In December, while closing the books, she clicks Pause Finance integration → confirms → Connection status updated. Badge: Integration paused.
  5. In January she clicks Resume integration → Connected again; Recent connection activity lists paused and resumed with times.

How it connects

Screen Relationship
Dashboard SolaCount readiness card links here.
Overview Finance section appears when connected.
Budget and finance Budget versus actual, linked documents.
Time approval & billing Approved billable time → draft invoices in SolaCount.
Notifications Connection notifications for admins.
SolaCount Projects in SolaCount.

Tips and common problems

Problem Cause Fix
No buttons, only status. You cannot manage the connection. Use Notify an administrator or ask the owner.
Continue disabled on step 2. A readiness check is Blocked. Fix the listed issue, then reopen.
Finance setup incomplete. SolaCount setup not finished. Complete Finance setup.
Finance access unavailable. Plan lacks SolaCount Premium or it lapsed. Manage apps and plans (opens the organization's Apps page in the Solavel portal in a new tab).
Will connecting duplicate my projects? No. Projects created: 0; IDs unchanged.
A project should never be billed. — Set it to Internal project / finance disabled in its Settings.
Unable to verify connection status. Temporary problem. Retry.

Related