Fiscal Integrations

Context

We have built a Fiscal API so that various middleware gateways that have integrations to Fiscal Providers can integrate directly with PAR Ordering Ecosystem. This way, you are not bound to a middleware gateway and reduce the need to integrate any Fiscal integrations - this speeds up the implementation.

Configuration

Here's how to configure Fiscal Integration.

Please note: the creation of Fiscal Providers can only be done by a PAR Ordering Administrator.

To create a Fiscal Provider following fields are required:

• Fiscal Provider name

• Logo Image

• Integration Type
  Please note: there is currently only one option, so the dropdown is disabled and predefined with the only integration that exists

Setting fields specific to the provider can also be configured, such as:

• End point

• Token

• Error Logger

To add the provider's required brand configurable fields select Add Custom Field.
You can hover over each icon - this will display popover information with explanations for each field:

• Click on the Field Type and Validations - this reveals the dropdown menu

• Clicking on Add button will add that Custom Field.

You can set which level the custom field is required to be configured at: Global or Store level. If you want this configuration on the global one, you will have to provide:

• Display Name
• Field Name
• Value

If you want to edit one of the Custom Fields - selecting the one you want to update and make your changes. If you want to remove a field from your configuration, select the Trash Bin icon.

Setup

This section will tell you how to enable a Fiscal Provider.

Please note: to enable the fiscal integration, the feature first needs to be enabled by a PAR Ordering Administrator.

Also: Store Groups can be created only by Users with the appropriate permissions.

You can decide to create a designated Fiscal Integration Store group or choose to add a Fiscal Integration to a pre-existing Store group. The only difference in the setup is that for the second option, you start with the second step here (adding a purpose):

• Create a Store Group and name as you see fit
  
• Add the Purpose and Fiscal Integration to the Store Group
  
• Select the Fiscal Provider you want to enable from the drop down
• Based on the provider you have selected, the globally defined configuration fields will appear
• Add the required details to enable the provider

Store Assignment & Management

By selecting Manage, you can assign the Store in which you want to use the Fiscal Integration. This action can also be used to manage Stores assigned to the Store Group. You can move stores from one group to another if multiple Integration providers are used.