Skip to main content

How To Guide Fiscal Poland

Fiscal Overview

For shared background, see Fiscal Overview.

Polish Introduction

The fiscal approach in Poland is based around the use of Fiscal Printers. Enactor has already integrated the UPOS FP-20 and FP-T88 FVA devices in this market. These fiscal printers contain a write once read of many fiscal memory, which is used to store the values for each transaction. However, the fiscalisation approach recently changed in Poland. Presently it is possible to use either the old system where transactions are recorded only on a fiscal memory in the printer or the new system where transactions must also be submitted to the authorities online. It will be possible to purchase the old style of offline printer until the end of 2022 after which time only the new online version will be available. Although, it will be possible to use old-style printers until their fiscal memory is exhausted.

UPOS offers an online version of both the FP-20 and the FP-T88 FVA and since the online communication is handled solely by the printer, Enactor's interface to the printer is the same across the models.

In Poland the fiscal printers must be certified but there is no requirement to certify the POS or the overall solution.

The fiscal printer memory has several limits and once one of these is reached the printer is at the end of life and will need to be replaced.

  • 2,100 Closed Fiscal Days

  • 30 Tax Rate Changes

  • 350,000 Unique Products Ever Sold

alt="Text, letter Description automatically generated" />

Each fiscal transaction on the POS will result in the printing of a fiscal receipt which must contain the fiscal mark. The format of the receipt is defined in the legislation and can only be altered in limited ways by including custom headers, footers, and a logo at the start of the receipt. The receipt must contain an identifier for the operator although this can be an ID rather than their name; this should be considered when setting up Polish users.

It is possible to discount items at the time of sale or to change the price of items, but the total of the receipt must always be positive. For this reason, returns and like for like exchanges are handled as non-fiscal receipts. The accounting of tax for returns must be manually handled by the retailers accounting department.

As well as printing fiscal receipts the printer can also be used to print non-fiscal receipts in the same way as any normal thermal receipt printer. The only requirement of a non-fiscal receipt is that it must not contain the fiscal mark and it has text in Polish (NIEFISKALNY) to announce that it is a non-fiscal receipt at the beginning and the end. These non- fiscal receipts can be used for things like printing cash management slips since cash management transactions are non-fiscal in Poland. Receipt Copies are also non-fiscal receipts and must not contain the fiscal mark.

It is necessary to be able to print X, Y and Periodic reports. The production of these reports is handled by the printer but triggered by the POS, in the case of the Periodic report the POS also supplies the from and to dates to the printer, after capturing them from the operator. Of these reports the only one which must be produced is the Z report, which must be produced at least once every 24-hour period and the report receipt must be kept by the retailer for 5 years. For this reason, it is recommended to link the production of this report to the day end process.

In the case of an invoice being issued, the fiscal receipt must contain the tax id of the customer, which will be captured on the POS when requesting an invoice. An invoice number must also be generated either by the POS or some retailer specific backend process which will be passed to the printer and included on the receipt. The layout of fiscal invoice receipts is managed by the printer and contains a more detailed tax breakdown than normal fiscal receipts. The retailer may also print an additional non-fiscal invoice document as well as the fiscal invoice receipt. These optional additional receipts can be printed on either the fiscal printer or some other printer, for example, an A4 laser printer.

When taking a deposit for an item, a fiscal receipt must be issued for the value of the deposit. When the customer returns and pays the balance a second fiscal receipt should be issued for the full amount but with a discount of the original amount paid as a deposit.

Deployment Overview

  1. Using the EM application update broadcaster first send the

    application updater update.zip’ to the devices you wish to deploy the fiscal solution on to.

  2. Wait until it succeeds.

  3. Then send the ‘update POS min.zip’ file.

  4. Wait until it succeeds.

  5. Send the Fiscal Module Update.

  6. Then, send the Poland printer resources update.

  7. Once both updates are completed, the POS will be ready with the new

    POS Fiscal Module.

  8. To verify the updates:

    1. Check the installation location's custom-lib (pos/custom-lib)

      folder for JAR files containing "fiscal" in their names.

    2. Check the ext-lib folder for these files:

      1. commons-lang-2.6.jar

      2. jSerialComm-2.10.4.jar

      3. javapos-1.14.3.jar

      4. jcl.jar

      5. log4j-api-2.19.0.jar

      6. log4j-core-2.19.0.jar

      7. log4j-slf4j2-impl-2.19.0.jar

      8. slf4j-api-2.0.6.jar

      9. upos-jpos-pl.jar

      10. xercesImpl-2.12.2.jar

      11. xml-apis-1.4.01.jar

    3. Check the config folder for the jpos.xml file. Ensure that

      the jpos.properties file is also present inside the jpos/res directory.

Configuration Overview

The following configuration changes are required and must be broadcast to all Poland devices in preparation for go live. Detailed steps for how to do this are contained in supplementary How to Guides available on the Enactor Insights portal, as well as being covered in the Introduction to Enactor training course

Region

The region must be configured to continue the other configurations related to the fiscalisation. Region for Poland should be created within the Region Group Hierarchy.

Location

There are no required configurations for the location but the header, footer and logo for the receipt will be picked up from here if they are configured.

In line with your procedures, it may be desirable to set these at the location template level rather than the location level. A possible exception to this would be situations where you have footers for each location.

The logo must satisfy the following conditions:

  • Width - maximum of 360 pixels

  • Height - maximum of 256 pixels

  • Width and Height both divisible by 8

  • The image must be a monochrome bitmap

Tax Groups

The following tax groups should be configured and broadcast to the appropriate Polish devices.

Tax Group IDDescription
PL_0Liable for no tax
PL_1Liable for full tax
PL_2Liable for reduced tax
PL_3Liable for reduced tax

Tax Scheme

The following tax scheme should be configured and broadcast to the appropriate Polish devices.

Tax Scheme IDDescriptionPrice Include Tax
PLPL VATTRUE

Tax Rates

The following tax rates should be configured and broadcast to the appropriate Polish devices. Products to be sold in Poland should have the relevant Tax Rate configured against them.

Tax Rate TypeTax Rate IDEffective DateDescriptionDisplay CodePercentageFiscal Tax Rate Reference
VATPL_0Date the VAT rate became effective in PLLiable for no taxD0%0
VATPL_1Date the VAT rate became effective in PLLiable for full taxAAt time of writing 23%1
VATPL_2Date the VAT rate became effective in PLLiable for reduced taxBAt time of writing 8%2
VATPL_3Date the VAT rate became effective in PLLiable for reduced taxCAt time of writing 5%3

Tax Region

If it does not already exist, a Tax Region for Poland should be created within the Tax Region Group Hierarchy. It should have the ID: “PL” and the Name: “Poland”, it is not necessary to configure an External Reference ID.

Tax Group Tax Methods

The following tax group tax methods should be configured and broadcast to the appropriate Polish devices.

Tax GroupTax RegionTax SchemeTax Rate
PL Liable for no taxPolandPL VATLiable for no tax
PL Liable for full taxPolandPL VATLiable for full tax
PL Liable for reduced taxPolandPL VATLiable for reduced tax
PL Liable for reduced taxPolandPL VATLiable for reduced tax

POS Terminal Template

The POS Terminal Template used by all devices in Poland should be configured to have the fiscalisation Type set to Poland. Currency should be set to Polish Zloty and Locale to Polish (Poland). Also add the POS terminal reference as well. (This helps to identify the receipts when using the shared printer functionality)

The peripherals tab should be completed as follows.

FieldDetail
Receipt Printer TypeFP-T88 FVA Polish Fiscal Printer
Fiscal Printer AddressUPOSFPPL, or name defined in jpos.xml
Customer Display TypeFPT88 FVA Line Display
Customer Display ConfiglineDisplayWaitSecs = 1

The Receipt Printer Address should be defined in the jpos.xml file, which must be placed inside the config folder.

An example of the jpos.xml structure:

The value of the address property should be the IP address of the physical printer.

The primary receipts should be set to the fiscal standard 44 col width versions and Customer Signature Slip should be Customer Signature Slip 44 Col .

Within the Tax section the Tax Region should be set to Poland and the Tax Scheme to the Polish tax scheme.

Privileges

The following privileges will need to be configured and broadcast to the appropriate Polish devices.

For more detail on Privileges and roles refer to the How-To Guide Configuring User, User Roles and User Templates

Privilege IDPackage
enactor.pos.fiscal.SetHeaderAllowedPOS Fiscalisation
enactor.pos.fiscal.AuthorisesSetHeaderPOS Fiscalisation
enactor.pos.fiscal.SetFooterAllowedPOS Fiscalisation
enactor.pos.fiscal.AuthorisesSetFooterPOS Fiscalisation
enactor.pos.fiscal.SetLogoAllowedPOS Fiscalisation
enactor.pos.fiscal.AuthorisesSetLogoPOS Fiscalisation
enactor.pos.PrintFiscalReportsAllowedPOS Fiscalisation
enactor.pos.fiscal.SyncVATAllowedPOS Fiscalisation
enactor.pos.fiscal.AuthorisesSyncVATPOS Fiscalisation
enactor.pos.fiscal.SyncTimeAllowedPOS Fiscalisation
enactor.pos.fiscal.AuthorisesSyncTimePOS Fiscalisation
enactor.pos.RequestSimpleFiscalInvoiceAllowedEnactor POS
enactor.pos.ChangeFiscalInvoiceNumberAllowedPOS Fiscalisation

At an appropriate point within your Polish POS menu structure, suggested on the Admin menu, a fiscalisation menu with the following 5 items will need to be configured and broadcast to all the Polish POS devices.

EventIDButton LabelData NameData TypeData Value
Fiscal_Set_HeaderFiscal_Set_HeaderSet HeaderConfigTypeStringSET_HEADER
Fiscal_Set_FooterFiscal_Set_FooterSet FooterConfigTypeStringSET_FOOTER
Fiscal_Set_LogoFiscal_Set_LogoSet LogoConfigTypeStringSET_LOGO
Fiscal_PrintReports_XFiscal_PrintReports_XX ReportReportTypeStringX
Fiscal_PrintReports_ZFiscal_PrintReports_ZZ ReportReportTypeStringZ

The following items also need to be configured at a convenient point in the sales menu.

EventIDButton LabelData NameData TypeData Value
RequestSimpleFiscalInvoiceRequestSimpleFiscalInvoiceRequest Simple Fiscal Invoice---
Fiscal_Print_Receipt_CopyFiscal_Print_Receipt_CopyFiscal Receipt Copy---
Fiscal_PrintReports_XFiscal_PrintReports_XFiscal X ReportReportTypeStringX
Fiscal_PrintReports_ZFiscal_PrintReports_ZFiscal Z ReportReportTypeStringZ
Fiscal_PrintReports_PeriodicFiscal_PrintReports_PeriodicFiscal Periodic ReportReportTypeStringPeriodic

For more detail on menu creation refer to the How-to Guide Configure POS Behaviour (Menus)

Product Tax

The following tax configurations should be configured againts the products and broadcast to the appropriate Poland devices.Tax group can be defined to either configure the tax group or have a tax group by tax region.

Shared Printer Configurations

This configuration should only be added when sharing the printer by the MPOS devices.

Pos Terminal

Configure the following for the POS Terminal of thin clients and PDP Server, for a production environment this should be done using a POS Terminal Template to ensure consistency and simplify management.

FieldValue
Is Remote Terminaltrue
Receipt Printer ConnectionAt Server
Receipt Printer Sharedtrue
Customer Display At Servertrue
Receipt Printer ConfigserverClaimOnStartUp = true
Customer Line DisplayFPT88 FVA LineDisplay
Receipt printer typeFP-T88 FVA Polish Fiscal Printer
Receipt Printer AddressUPOSFPPL
Customer Display ConfiglineDisplayWaitSecs = 1

Printer Commissioning

Production printers as delivered by UPOS will be in a non-fiscalised state. Before they can be used in production, they will need to be fiscalised. This operation is performed by a service person authorised to do so and involves use of the service tool as well as setting a hardware jumper on the printer to make the change. At the time of fiscalisation certain parameters are burned to the printer memory and can’t be modified, all subsequent transactions will be fiscal, stored in the fiscal memory and included in the submissions to the tax authority.

Prior to fiscalisation it is possible to perform test transactions on the printer which will not be fiscalised or committed to the fiscal memory and will not contain the fiscal mark on the receipts printed.

However, there are some settings that can be altered by the POS both when being used for testing before it is fiscalised and after it is fiscalised in production. Unusually, the configuration and broadcast of these details from the Estate Manager will not automatically submit them to the printer. The reason for this is that the printer will only permit these parameters to be changed when it is in a neutral state. The printer is in a neutral state when it has completed a Z report and no new transactions have been started. Since there is no guarantee or even likelihood that the printer will be in a neutral state when it receives a broadcast, it is necessary for an operator to trigger the submission to the printer from the POS after running a Z report.

The printer can include a footer after the main body of the receipt, and this can be used to include promotional information or a message to your customers, for example warranty and returns information. This is configured in the location/location template as described in the configuration section. To submit the footer to the printer it is necessary to configure the footer text on the EM and broadcast the location to the POS. An operator will then need to run a Z report and click the Set Footer menu button on the appropriate POS menu (suggested Admin).

Set Header

The printer can include a header before the main body of the receipt, and this should include details of the store such as the address as required by the fiscal legislation. This is configured in the location/location template as described in the configuration section. To submit the header to the printer it is necessary to configure the text on the EM and broadcast the location to the POS. An operator will then need to run a Z report and click the Set Header menu button on the appropriate POS menu (suggested Admin).

It appears that this operation is not possible with the later online models of printer, instead the service person will set the Header at the time of fiscalisation, and it can’t be changed after this time.

Sync VAT

From time to time the VAT rates in Poland may change. When this happens, the rates can be updated in the Estate Manager and broadcast to the POS. It will then be necessary for an operator to run a Z report and click the Sync VAT menu button on the appropriate POS menu (suggested Admin).

The printers have a limited number of VAT rate changes permitted before they are end of life. To limit the risk of accidental updates rendering an otherwise functional printer end of life the sync process will first compare the current VAT rates on the printer to the new rates and only perform the update if there are differences.

Sync Time

It is necessary for the time on the printer to match the system time on the POS. If the printer and POS lose time synchronisation for some reason, e.g. the printer has been powered off for a long time. The Sync Time button on the admin menu can be used to resolve this issue, again this can only be performed after running a Z report.

The time will be set on the printer according to the system time on the POS therefore it is necessary to ensure that the POS OS time is set correctly prior to performing this operation. This is especially important with the online models of printers where the time should also match the time at the tax authority during the online communication between the tax authority and the printer.

The printer can include an image logo at the start of the receipt, this would usually be used to include the company logo on the receipt. This is configured in the location/location template as described in the configuration section. To submit the logo to the printer it is necessary to configure the logo on the EM and broadcast the location and image entities to the POS. An operator will then need to run a Z report and click the Set Logo menu button on the appropriate POS menu (suggested Admin).

Operations

Fiscal X Report

  • X Report gives a report of the transactions. This does not close the

    fiscal day

  • The location of this button in the menu structure will be

    configurable.

  • The function will be privilege controlled

Fiscal Z Report

  • Z Report closes the fiscal day

  • This should be generated At the end of a shift or day