docs

    ↑↓ to move ↵ to open esc to close

    The page in Clockify

    Business Central Connector adds a page inside Clockify, a product of CAKE.com, that shows where your approved time stands in Microsoft Dynamics 365 Business Central, a product of Microsoft. Spainlink built it, and neither company did.

    This describes the add-on as it runs in our test workspace: see the Overview for availability.

    Where to find it

    Choose Business Central in Clockify’s left menu, under Add-ons. The page opens inside Clockify, on its Overview tab.

    Who can open it

    Every workspace member can open the page, limited by their Clockify role. It has no sign-in of its own: Security and data explains how it knows who you are, and Roles and access shows what each role sees.

    The four tabs

    The page has four tabs, and your role decides which of them you see.

    TabWhat it shows
    OverviewThe tiles, then posted hours by person and by project
    Time EntriesOne row per entry: the person, with the Clockify entry id under their name, the date, when it posted, the Clockify project, where it went in Business Central, the hours and the status. A failed entry shows its reason under the status. This tab holds the newest rows, and the complete list is in Business Central
    Sync LogWhat the connector did in Business Central, one event per row, newest first. This tab holds the newest events, and the complete audit log is in Business Central
    MappingWhich Clockify person is which Business Central resource, and which Clockify project posts to which project and task. The mapping model has the rules

    Overview, Time Entries and Sync Log are read live from Business Central when the page loads. Time Entries and Sync Log can be searched, filtered and sorted, within the rows each tab holds.

    The tiles

    Five tiles at the top of the Overview tab show where your entries stand, and a sixth appears when entries need review.

    TileWhat it shows
    ReceivedEntries that have reached Business Central and have no journal line yet
    In JournalEntries with a project journal line written, not posted yet. The Time Entries tab calls this status Written
    PostedEntries in the project ledger, with their total hours underneath
    FailedEntries Business Central refused, with the reason on the row on the Time Entries tab
    Posted costThe total cost of the posted entries, for the roles that see cost figures
    Needs reviewShown only when there are any, captioned “changed in Clockify after posting”: posted entries flagged for review: changed or deleted in Clockify afterwards, or with an approval withdrawn for more than 7 days. See Corrections
    Received:reached Business Central In Journal:journal line written Posted:in the project ledger Failed:reason on the row Received:reached Business Central In Journal:journal line written Posted:in the project ledger Failed:reason onthe row
    Received and In Journal normally clear within seconds, so a number that stays in either one needs a look.

    Each count opens the Clockify Time Entries list in Business Central, filtered to that status. A failed entry stays in Failed until someone fixes the cause and uses Retry there: see In Business Central.

    The actions

    The actions sit in the page’s header, so they are there on every tab.

    ActionWhat it does
    RefreshReads everything again from Business Central
    Open Business CentralOpens the connected company in a new tab, where you sign in with your own Business Central account
    Run sync nowQueues a sync over the last 14 days, ahead of the next scheduled one, and it starts within seconds. Only owners and workspace admins have this button. When the run ends, a note at the top of the page shows how it ended until you close it: Sync finished, Sync finished with failures, Sync stopped, or Sync skipped if another sync was already running. The note gives the dates the run covered, how long it took, and how many entries were written, already present or skipped, or why it stopped. Details repeats those counts or that reason, and the Sync Log tab shows what happened to each entry. The skipped count is not only unmapped entries. It also includes entries left out for other reasons, such as a timesheet not approved yet, a timer still running, a rate not in USD or a closed period. A number above zero does not by itself mean a mapping is missing. While any sync is queued or running, a scheduled one included, the button says so and stays disabled
    Help panelThe question mark button opens help for the tab you are on, with a glossary of Business Central words. Its search covers every tab you can open, and it leaves out what your role cannot use