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

Announcements

No record found.

News and Announcements icon
Community site session details

Community site session details

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

Posting shortcutDimension1Code via API v2 to purchaseOrder header

(0) ShareShare
ReportReport
Posted on by
Hello,
 
I'm rather new to BC developent and I try to connect an application via API v2 to BC. The application creates a puchase order which generally works fine. What does not work is to post  the codes for shortcutDimension1Code and shortcutDimension2Code.
 
I prototype with Postman.
The JSON I use to post is as follows:
 
{
   /orderDate/: /2024-5-16/,
   /vendorNumber/: /600354/,
   /shortcutDimension1Code/: /some value/,
   /shortcutDimension2Code/: /another value/
}
 
Status response is 201.
 
The body of the response is:
 
{
    /@odata.context/: ...
    
    /number/: /BE02-000035/,
    /orderDate/: /2024-05-16/,
    /postingDate/: /2024-05-16/,
    /vendorId/: /8d3fc854-e338-ed11-97e8-0022485d2640/,
    /vendorNumber/: /600354/,
...
    /shortcutDimension1Code/: //,
    /shortcutDimension2Code/: //,
...
}
 
In BC the dimensions are empty.
 
Does anyone know how to post dimension values to BC using the API?
 
Thanks and kind regards,
Thomas
 
  • Gerardo Rentería García Profile Picture
    27,623 Super User 2026 Season 2 on at
  • Suggested answer
    Saurav.Dhyani Profile Picture
    14,481 User Group Leader on at
    Hi,
     
    You can pass dimension the API allows you to enter shortcutDimension1Code & shortcutDimension2Code. These fields are available in standard API V2. 
     
    If you would like to insert additional dimensions other than 1 and 2 then you can use part - dimensionSetLines.
     
    To use parts in API you can use $expand. If you don't know then refer this video https://youtu.be/i0luLg2vfgk
     
    Regards,
    Saurav Dhyani
  • Aaron Bauldree Profile Picture
    19 on at
    Do you have Global Dimensions set up? If so (especially when declaring Shortcut Dimension 1), the Global Dimension 1 "overrides" the Shortcut Dimension 1, so this could be causing your issue.

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

Season of Sharing Community Challenge Winners!

Congratulations to our community stars!

Women in Power Builds Momentum

Expanding mentorship, skilling, and AI innovation

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

#1
OussamaSabbouh Profile Picture

OussamaSabbouh 728 Super User 2026 Season 2

#2
YUN ZHU Profile Picture

YUN ZHU 545 Super User 2026 Season 2

#3
AndrewThomas81 Profile Picture

AndrewThomas81 328 Super User 2026 Season 2

Last 30 days Overall leaderboard

Featured topics

Microsoft Training Manuals

Product updates

Dynamics 365 release plans