Small and medium business | Business Central, N...

Creating web links from outside into Business Central

(4) Share

Report

Posted on by BN-26111159-0

Hi,

I have an application which creates a webpage for our users (actually it's a CTI application). I'd like to create some links on this page which lead the users straight into the appropriate page in BC, e.g. into one of the latest five sales orders of the customer who's calling in.
The application is completely agnostic about the user, whether the user is already logged in into BC, whether the user is allowed to see the respective page in BC, and so on. Our BC is hosted on-prem (if this is relevant). The application can retrieve the SO numbers directly from the SQL server, so these are known.

If I copy the link to the respective page in BC, all I got is e.g.

https://xxxxx.example.com/PRD240_WIN01/?company=XYZ&bookmark=21_JAAAAACLAQAAAAJ7_1MATwAxADQAOQA5ADAANA&page=42

What I would like to have is something like

https://xxxx.example.com/PRD240_WIN01/?company=XYZ&page=42&No_=SO0123456

i.e. the SO number in clear text instead of coding it into an obfuscated bookmark.

Does anybody know a solution for this issue?

Thank you in advance!

Bernhard

I have the same question (0)

All responses (4)

Answers (0)

Suggested answer

Jainam M. Kothari 15,732 Super User 2026 Season 1 on at

Like (1)

Report
Copy link

Link copied!

Hello,

Business Central URLs use an internal bookmark parameter to identify records, and there’s no built-in way to replace it with a clear-text key like No_.

To achieve this, you can either

(1) retrieve the bookmark via API/OData and construct the link dynamically, or

(2) build a small custom page or handler that accepts No_ as a query parameter and redirects to the correct record using AL code.

1 people found this reply helpful.

Was this reply helpful? Yes No
BN-26111159-0 12 on at

Like (1)

Report
Copy link

Link copied!

Hello Jainam,

thank you for your swift reply!

But unfortunately, this answers my question only halfways: now that I know that BC uses only bookmarks, the remaining question is, of course, how to create such a bookmark. From what I googled, the bookmark is something like a coded $systemID and the PageID (fun fact: the PageID is given additionally as clear text in the URL). Is there any documentation how to create the bookmark code?

Thank you in advance!

Bernhard

1 people found this reply helpful.

Was this reply helpful? Yes No
Suggested answer

Valentin Castravet 32,157 Super User 2026 Season 1 on at

Like (2)

Report
Copy link

Link copied!

Bookmarks are not the only way. Take a look at the documentation here because this is possible to do - Web client URL - Business Central | Microsoft Learn

For example, the URL to open SO0123456 would be: https://businesscentral.dynamics.com/XXXXXXXX/YYYYYYYY?company=CRONUS%20Canada%2c%20Inc.&page=42&filter='Document Type' is 'Order' and 'No.' is 'SO0123456'

Replace XXXXXXXX with the tenant ID and YYYYYYYY with the environment name. That URL is for the SaaS version but I'm guessing it's similar for on-prem. If I paste that into a web browser I can open any sales order no. added in the URL.

Valentin Castravet
Work: Zander ERP Services
Blog: Dynamics 365 Business Central Insights
LinkedIn: www.linkedin.com/in/valentin-c-0500a247/

1 people found this reply helpful.

Was this reply helpful? Yes No
Suggested answer

OussamaSabbouh 12,808 Super User 2026 Season 1 on at

Like (1)

Report
Copy link

Link copied!

Hello,

You can’t generate BC bookmarks yourself.

But you don’t need them.

Just use a page URL + filter, which is fully supported:

https://yourserver/PRD240_WIN01/?company=XYZ&page=42&

filter='Document Type' IS 'Order' AND 'No.' IS 'SO0123456'

This opens the exact Sales Order directly. Works on-prem too.

Regards,

Oussama Sabbouh

2 people found this reply helpful.

Was this reply helpful? Yes No