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

Environment update failed due to 'E-Document Core' extension – Field length reduction not allowed

(4) Share

Report

Posted on by PL-28101044-0

While attempting to update our Business Central SaaS environment from version 26.5.38752.38944 to 27.0.38460.39927, the operation failed due to an issue with the 'E-Document Core' extension version 27.0.38460.41225.

Error message:

The extension 'E-Document Core' failed to synchronize the database schema. Table 6101 E-Document Purchase Line :: The field '[BC] Item Reference No.' has reduced the data type length from '50' to '20'. Reducing the data type length of a field is not allowed.

This error prevents the entire environment update from completing successfully. Environment details:

Type: SaaS
Country/region: ES
Scheduled update: October 28, 2025
Start time: 10:44 CET
End time: 11:13 CET
Update status: Failed
Custom date selected: Yes

Question:

Is there an official fix or workaround for this issue in SaaS environments, where running Sync-NavApp is not possible?

Is Microsoft planning to release a corrected version of the 'E-Document Core' extension that avoids this schema conflict?

Any help or guidance would be greatly appreciated.

Categories:

Dynamics 365 Business Central

I have the same question (3)

All responses (6)

Answers (0)

Suggested answer

Sumit Singh 8,146 on at

Like (2)

Report

Environment update failed due to 'E-Document Core' extension – Field length reduction not allowed

Hi, Below link might be related, waiting for fixation as per my understanding.

[Bug]: "[BC] Item Reference No." field length is too short. in E-Document Purchase Line · Issue #29009 · microsoft/ALAppExtensions

Was this reply helpful? Yes No
PL-28101044-0 20 on at

Like (1)

Report
Environment update failed due to 'E-Document Core' extension – Field length reduction not allowed

Hi Sumit,

Thanks for your support.

I’d like to better understand the behavior we’re seeing across different tenants. We’ve successfully updated some environments to version 27.0 where the E-Document Core extension is installed, and the update completed without any issues, even though the extension includes the same field length reduction.

However, in other environments — including some that do not actively use the E-Document module and have no records in table 6101 (E-Document Purchase Line) — the update is blocked due to the same schema conflict.

Could you please clarify:

Why the update proceeds successfully in some environments but fails in others, even when the extension is present?

Is there any way to bypass or defer the E-Document Core extension during the update process in environments where it's not used?

Is Microsoft planning to release a version of the extension that avoids this issue?

We’re trying to understand if there’s a workaround or configuration that allows the update to proceed safely in affected environments.

Thanks in advance for your help.

Best regards.

Was this reply helpful? Yes No
Suggested answer

Nimsara Jayathilaka. 4,814 on at

Like (6)

Report

Environment update failed due to 'E-Document Core' extension – Field length reduction not allowed

Hi

https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/upgrade/known-issues?wt.mc_id=DX-MVP-5004336#removed-tables-and-fields-in-the-e-document-core-extension-cause-synchronization-errors-on-upgrade

Was this reply helpful? Yes No
PL-28101044-0 20 on at

Like (1)

Report
Environment update failed due to 'E-Document Core' extension – Field length reduction not allowed

Hi Nimsara,

Thank you for sharing the workaround involving the Sync-NAVApp command with the ForceSync parameter.

However, our environment is SaaS, and we do not have access to the server instance or the ability to run PowerShell commands like Sync-NAVApp. As such, this workaround is only applicable to OnPrem environments, and unfortunately, it does not help us resolve the issue.

Could you please confirm:

If Microsoft is planning to release a corrected version of the E-Document Core extension that avoids this schema conflict in SaaS?

If there is any way to bypass or defer the update of this extension during the environment upgrade?

We’re currently blocked from upgrading due to this issue, even though the extension is not actively used in our environment.

Thanks again for your support.

Best regards.

Was this reply helpful? Yes No
Suggested answer

OussamaSabbouh 1,070 on at

Like (1)

Report

Environment update failed due to 'E-Document Core' extension – Field length reduction not allowed

Hello,

Microsoft will release a corrected version of the extension.

Don’t retry the update manually, it will continue to fail.

Open a Microsoft support ticket referencing this known issue.

Monitor the Known Issues page for the fix.

Regards,

Oussama

1 people found this reply helpful.

Was this reply helpful? Yes No
Suggested answer

Rishabh Kanaskar 5,126 on at

Like (1)

Report

Environment update failed due to 'E-Document Core' extension – Field length reduction not allowed

Hi,

Yes, Microsoft has acknowledged the field‑length issue in E‑Document Core and marked it to ship in a future update. Monitor the GitHub issue #29009 for the release build. [Bug]: "[BC] Item Reference No." field length is too short. in E-Document Purchase Line · Issue #29009 · microsoft/ALAppExtensions

Thanks

Rishabh

Was this reply helpful? Yes No