Skip to content

Navigation Finland ​

The embedded payroll UI supports two ways to navigate. Pick the one that fits your product:

  • Built-in horizontal navigation — the fastest to ship; there is no menu to build. The quick start uses it.
  • Your own navigation — full control; the menu blends into your application.

Examples use the test hosts and assume a session is already established. The URL contract is in URL parameters and sizing; getting the access token is in the quick start.

Built-in horizontal navigation ​

Embed embedded-horizontal.html and Salaxy renders a horizontal menu bar inside the iframe:

html
<iframe
  id="salaxyIframe"
  name="salaxyIframe"
  src="https://test-embed.palkkaus.fi/embedded-horizontal.html?lang=fi&skin=palkkaus#access_token=YOUR_TOKEN_HERE"
  style="width: 100%; height: calc(100vh - 200px); border: 0;"
></iframe>

The menu moves between the payroll views; your application's own header, footer and navigation around the embed stay yours. The URL contract is the same as for embedded.html: ?lang and ?skin behave the same, and the access token is needed only on the first load, in the #access_token hash.

Your own navigation ​

Embed embedded.html and render the menu yourself. Navigation is client-side routing inside the iframe — no page reloads. You:

  • give the iframe a name,
  • point your menu links at it with target="<iframe name>",
  • change only the hash (#/route).
html
<a
  href="https://test-embed.palkkaus.fi/embedded.html?lang=fi&skin=palkkaus#/payroll"
  target="salaxyIframe">
  Payroll
</a>

No token in navigation links

Do not put access_token in navigation links — the session is already established. And keep everything before # exactly as on the first load.

Routes ​

RouteView
#/homeHome
#/calcSalary calculation
#/payrollPayrolls
#/workersEmployees
#/reportsReports
#/settingsSettings
#/messagesMessages
#/infoInformation

The routes are the same in both pages. #/ also opens Home. Messages is in the menu only when messaging is enabled for the account.

Every page is also available as Markdown: add .md to its URL — a folder page such as white-label/ is white-label/index.md. Index for LLMs: llms.txt. Questions: Support.