BeyondERP.Newsletter
Menu

Setup step on the Import header page · Asset leasing

Review a lease import before migrating it

Check each staged import, its process type and its staged values before it changes leases.

Used by
Lease accountant, Lease manager, Accountant and 1 more role
Business process
Lease assets
Menu item
AssetLeaseLeaseImportHeader
Main table
AssetLeaseLeaseImportHea
Data entity
AssetLeaseLeaseImportHeaderDataEntity
Setup steps
1 on this page
Show what matters for
SETUP GUIDEHow to set it up8 sections. Choose a role to highlight what matters to you.
Everyone

1What it is and why

What it isA page that lists every lease import loaded through the Lease staging, Payment contract staging and Executory contract staging data entities.
What you do hereUse this page to view and edit staged lease data, compare and validate it, and then migrate individual lease records into Asset leasing.
ExampleFor example, you import a set of leases to add new leases, update nonfinancial details or adjust existing leases.
Import header page in Dynamics 365
The page in Dynamics 365. page title tab to open what to set or check
Functional consultant · Solution architect

2Where it fits

End user · Functional consultant

3How to do it

About the examples: Examples and screenshots in this guide use BEAT, a demo company in a Dynamics 365 test environment. Use your own company's codes and values instead of copying them.

Setup steps on this page

Review a lease import before migrating it

Check each staged import, its process type and its staged values before it changes leases.

Steps from Microsoft

  1. Go to Asset leasing > Lease import framework > Import header.
  2. Select an import, and then select Staging data.
  3. Select a lease, and then select Compare; use See differences to review values.
  4. Select Validate.
  5. Select Migrate lease records.

Source: Microsoft Learn

Fields on the page

FieldWhat it meansExample
Process typeThe action the system performs when the lease is migrated: add, update or adjust a record.Microsoft Learn Add record
New ValueThe staged value, which you can change before migration and save with Update staging.Microsoft Learn

Common errors and fixes

MessageWhat to do
Compare shows nothing for an importCompare doesn't work for the Add record process type; it compares staged values with existing leases. Validate and migrate Add record imports directly. Microsoft Learn
Migrated leases have no posted entriesAdd record creates the lease only. Confirm each payment schedule and post initial recognition; Adjust record leaves the new schedule unconfirmed and the adjustment journal unposted. Microsoft Learn

Test checklist

  1. Import a file through the Lease staging, Payment contract staging and Executory contract staging entities and check the import appears on Import header.
  2. For an Update record or Adjust record line, select Compare, then See differences, and check current and staging values side by side.
  3. Select Validate and fix any record that fails before migrating.
  4. Select Migrate lease records and check that an Add record lease still needs its payment schedule confirmed and initial recognition posted.
  5. For an Adjust record line, check that a new payment schedule exists and that the adjustment entry isn't posted yet.

Source: Microsoft Learn

Functional consultant

4Setup decisions

Setup stepRecommended value and whyDecision, common mistake and test
Review a lease import before migrating itUse one process type per import (Add record, Update record or Adjust record), open Staging data to check the values, and run Compare and the Differences report before migrating an Update or Adjust import.Update record overwrites only the fields in Update fields selection without adjusting the lease, while Adjust record is a financial modification that creates a new payment schedule; mixing them in one import makes the result hard to check.Which process type carries each kind of change?Sending payment changes as Update record: the values change but the lease isn't remeasured.Test: Update import changes only selected fields

Feature management and licence

Feature to turn onAsset leasing (Must be on)
Licence or add-inAsset leasing must be turned on in Feature management (feature Asset leasing). Microsoft Learn describes three Asset leasing roles: Maintain lease (add, edit and post leases), View lease (view leases and schedules and run reports) and Lease clerk (create new leases only). Maintain lease users run imports; the upload itself needs access to Data management.

Microsoft Learn

Solution architect

5Design impact

Shared or per companyPer company: leases with their books, schedules and journals belong to the legal entity you are working in, and Lease ID numbers come from a number sequence set per company. Turn on Cross entity batch in Asset leasing parameters to create journals for other legal entities from the current one. Microsoft Learn
Can it be undoneReversible: Staged imports change nothing until Migrate lease records runs; import records can be deleted (version 10.0.41 and later).
If you change it laterMigrating a record with the Adjust record process type makes a financial modification of the lease and creates a new payment schedule. Microsoft Learn
Technical architect

6Technical

Menu itemAssetLeaseLeaseImportHeader Checked in Dynamics 365
FormAssetLeaseLeaseImportHeader Checked in Dynamics 365
TableAssetLeaseLeaseImportHeaShown as “LEASE IMPORT HEADER” in Record infoKey field: ProcessIdChecked in Dynamics 365
Data entitiesAssetLeaseLeaseImportHeaderDataEntityLease import header Checked in Dynamics 365
Who can open itPrivilegesMaintain lease AssetLeaseLeaseMaintainMaintain lease without vendor invoice access AssetLeaseLeaseMaintainWithoutVendInvoiceAccessView lease AssetLeaseLeaseViewDutiesLease inquire AssetLeaseLeaseInquireMaintain lease AssetLeaseLeaseMaintainMaintain lease without vendor invoice access AssetLeaseLeaseMaintainWithoutVendInvoiceAccess
4 security rolesLease accountant AssetLeaseLeaseMaintainLease manager AssetLeaseLeaseViewAccountant LedgerAccountantAccounting manager LedgerAccountingManager
Checked in Dynamics 365
Roles to set it up and use itTo set it up or change itLease accountant AssetLeaseLeaseMaintainAccountant LedgerAccountantTo use itLease manager AssetLeaseLeaseViewAccounting manager LedgerAccountingManagerGive people one of these roles. On this system, 4 roles can open this page.Checked in Dynamics 365
Actions on the page(Action Pane without tabs): Staging dataChecked in Dynamics 365
Developer

7Developer

Open it by URLhttps://<your-environment>/?mi=AssetLeaseLeaseImportHeader
Integrate withAssetLeaseLeaseImportHeaderDataEntity data entity Checked in Dynamics 365
Data migrationAssetLeaseLeaseImportHeaderDataEntity (Lease import header): reads the import headers. Upload the file in the Data management workspace into Lease staging, Payment contract staging and Executory contract staging; each upload shows as one import on Import header.Load order: Load the Asset leasing setup in Microsoft's order: lease books, lease groups, then the parameters (journal names, posting accounts, executory cost accounts), expense types, payment amount types, index rate types and locations, and only then the leases. Then upload the staging entities, Compare (not for Add record), Validate and Migrate lease records.Load first: Lease books, Lease groups, Update fields selectionMicrosoft Learn
Everyone

8Sources

To cite this step: AL-IMPORT-020, Review a lease import before migrating it. Beyond ERP Atlas Hub, 2026-11-11. https://www.beyonderp.cloud/atlas/step/AL-IMPORT-020