web
You’re offline. This is a read only version of the page.
close
Skip to main content

Announcements

Community site session details

Community site session details

Session Id :
Small and medium business | Business Central, N...
Suggested Answer

Best Practice for Connecting General Ledger Data with Customer Details in Business Central API

(1) ShareShare
ReportReport
Posted on by 2
Hi Microsoft Support Team,
I am currently working on connecting customer details with General Ledger data via the Business Central API and would like guidance on the recommended approach.
BACKGROUND:
Based on my research, a direct connection between the General Ledger and customer data does not appear to be natively supported. One possible approach I identified is linking the data using the Source Type column — for example, if the Source Type is 'Sales Invoice', the related customer data would be retrieved from the Sales Invoice table.
ALTERNATIVE APPROACH FOUND:
While reviewing the Finance Reports documentation, I noticed that the Customer Ledger Entry table is available under the Beta endpoint:
GET https://api.businesscentral.dynamics.com/v2.0/{tenantId}/{environmentName}/api/microsoft/reportsFinance/beta/companies({companyId})/customerLedgerEntries
Using this endpoint, I am able to retrieve customer data and successfully join it with General Ledger entries. This approach appears to work, but since it is a Beta endpoint, I have concerns about using it in a production environment.
QUESTIONS:
1. Is it safe and recommended to use the reportsFinance Beta API endpoint in a production scenario?
2. Is the Source Type-based approach (linking GL entries to customer data via Sales Invoice / source tables) the officially recommended method?
3. Is there a more standard or stable API approach to establish a direct connection between General Ledger entries and customer details?
4. When is the customerLedgerEntries Beta endpoint expected to be promoted to a stable release?
I would appreciate your guidance on the best practice for this scenario to ensure we are building a reliable and future-proof integration.
Thank you.
I have the same question (0)
  • Suggested answer
    OussamaSabbouh Profile Picture
    10,510 Super User 2026 Season 1 on at
    Hello,
     
    You shouldn’t rely on the reportsFinance / beta endpoints for a production integration because beta APIs can change and aren’t officially supported for production use; the stable Business Central API v2.0 generalLedgerEntry doesn’t expose the linking fields you’re using (like sourceType/sourceNumber), so the clean and future-proof approach is to create a custom API page or query that exposes the proper join between G/L Entry No. and Customer No. (for example via Customer Ledger Entry), and keep the rest of your integration on the stable v2.0 endpoints; Microsoft typically does not publish timelines for promoting specific beta endpoints to stable.
     
    Regards,
    Oussama Sabbouh

Under review

Thank you for your reply! To ensure a great experience for everyone, your content is awaiting approval by our Community Managers. Please check back later.

Helpful resources

Quick Links

Introducing the 2026 Season 1 community Super Users

Congratulations to our 2026 Super Stars!

Congratulations to our 2025 Community Spotlights

Thanks to all of our 2025 Community Spotlight stars!

Leaderboard > Small and medium business | Business Central, NAV, RMS

#1
OussamaSabbouh Profile Picture

OussamaSabbouh 2,296 Super User 2026 Season 1

#2
YUN ZHU Profile Picture

YUN ZHU 1,174 Super User 2026 Season 1

#3
Dhiren Nagar Profile Picture

Dhiren Nagar 1,034 Super User 2026 Season 1

Last 30 days Overall leaderboard

Featured topics

Product updates

Dynamics 365 release plans