BeyondERP.Newsletter
Menu

Setup page · Retail and Commerce

Fiscal document providers

A setup page where you upload the XML configuration of each fiscal document provider, the component that generates fiscal documents (such as an XML fiscal receipt) for transactions and events registered on the POS.

Used by
Retail service
Business process
Manage sales channels
Menu item
RetailFiscalIntegrationDocumentProviderList
Main table
RetailFiscalIntegrationD
Data entity
RetailFiscalIntegrationDocumentProviderTableEntity
Setup steps
1 on this page
Show what matters for
PAGE GUIDEWhat the page does and how to use it8 sections. Choose a role to highlight what matters to you.
Everyone

1What it is and why

What it isA setup page where you upload the XML configuration of each fiscal document provider, the component that generates fiscal documents (such as an XML fiscal receipt) for transactions and events registered on the POS.
What you do hereUse this page to load one document provider configuration for each fiscal device or service, including its data mapping; create separate providers when different data mappings are needed for the same connector.
ExampleFor example, a document provider generates the fiscal receipt as XML, which a fiscal connector then sends to the printer.
Fiscal document providers 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

Business processDevelop sales policies › Manage sales channels
Menu pathRetail and Commerce › Channel setup › Fiscal integration › Fiscal document providers
Set up firstCommerce shared parameters (Enable fiscal integration) Microsoft Learn
Used next byConnector functional profiles Microsoft Learn
Related pagesFiscal connectors Microsoft Learn
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

Set up Fiscal document providers

Use this page to load one document provider configuration for each fiscal device or service, including its data mapping; create separate providers when different data mappings are needed for the same connector.

Steps from Microsoft

  1. Go to Retail and Commerce > Channel setup > Fiscal integration > Fiscal document providers.
  2. Upload an XML configuration for each device or service that you plan to use.
  3. Select View to see the functional profiles related to the provider.
  4. Create a connector functional profile for each connector and provider combination.

Source: Microsoft Learn

Test checklist

  1. Upload the provider XML and select View to see the related functional profiles.
  2. Create a functional profile pairing it with its connector and check the default VAT and tender mappings appear.
  3. Validate the fiscal registration process and run jobs 1070 and 1090.
  4. Complete a POS sale and check the fiscal receipt shows the expected VAT and tender codes.

Source: Microsoft Learn

Functional consultant

4Setup decisions

Setup stepRecommended value and whyDecision, common mistake and test
Set up Fiscal document providersOne document provider per device or service, and a separate provider wherever a different data mapping is needed for the same connector (for example state-specific rules)Data mapping is part of the document provider, so different mappings need different providers.Trying to handle two mapping variants in one provider. The provider drives how taxes and payments are transformed into the fiscal document, so one provider gives one mapping.
Solution architect

5Design impact

Can it be undoneReversible: You can load a new configuration version; connector functional profiles keep their manual mapping changes until you select Update on the Connector functional profiles page. Microsoft Learn
If you change it laterThe provider's data mapping drives how taxes and payments are transformed into the fiscal document, and loading a new configuration does not overwrite manual changes in functional profiles until Update is selected. Microsoft Learn
Technical architect

6Technical

Menu itemRetailFiscalIntegrationDocumentProviderList Checked in Dynamics 365
FormRetailFiscalIntegrationDocumentProviderList Checked in Dynamics 365
TableRetailFiscalIntegrationDShown as “FISCAL INTEGRATION DOCUMENT PROVIDER TABLE” in Record infoChecked in Dynamics 365
Data entitiesRetailFiscalIntegrationDocumentProviderTableEntityFiscal integration document provider table Checked in Dynamics 365
Who can open itPrivileges RetailFiscalIntegrationDocumentProviderListMaintainDuties RetailFiscalIntegrationMaintain
1 security roleRetail service RetailService
Checked in Dynamics 365
Roles to set it up and use itTo set it up or change itRetail service RetailServiceGive people one of these roles. On this system, 1 role can open this page.Checked in Dynamics 365
Actions on the pageLoadView: ProfileChecked in Dynamics 365
Developer

7Developer

Open it by URLhttps://<your-environment>/?mi=RetailFiscalIntegrationDocumentProviderList
Integrate withRetailFiscalIntegrationDocumentProviderTableEntity data entity Checked in Dynamics 365
Everyone

8Sources