The List of VAT payers is an electronic register of registered taxpayers, their tax numbers (NIPs) and bank accounts. In some Polish business scenarios, a payer can only transfer funds to a white-listed bank account of the payee.
This application uses the SAP Business Technology Platform (SAP BTP)[1] and Cloud Platform Integration (CPI) to integrate your SAP S/4HANA system with the List of VAT payers, published daily by the Polish tax authorities. The application can be used to validate business partner tax numbers (NIPs) and bank accounts with the List of VAT payers, and to manage such an extension on the SAP S/4HANA Cloud. This extensibility is a part of Localization Toolkit for SAP S/4HANA Cloud. You can copy or deploy this sample application to your SAP Business Technology Platform space.
Within SAP S/4HANA, the Online Validation Framework is used to validate business partner tax numbers and bank account details. This framework conducts checks at key processing points (such as during invoicing or during a payment run). The framework is also used to complete mass validation checks, enabling validation results to be stored for improved system performance.
If you would like to integrate your SAP S/4HANA system with the published List of VAT payers using the Business Technology Platform, then you can use this sample application. The application downloads the List of VAT payers and serves the requests to validate the tax number and bank account number pairs. The Online Validation Framework can then refer to this data for mass validation checks of business partners, individual validation checks (during master data creation or change), and validation checks which occur during invoicing and payment processing.
Information provided is published as a minimum working example. You can use the sample application as a starting point and adapt it to your business requirements.
The List of VAT payers is published as a .json file compressed with the 7zip algorithm. The List of VAT payers is one-directional and uses specific conventions for the data it contains.
The application validates the bank accounts with the List of VAT payers and returns the checksum of the .json file in the form of SHA512 hash for each bank account successfully validated. This checksum is a confirmation that your data has been validated with the List of VAT payers. The Polish tax authorities considers this file and the validated data as proof of the validation. For more information about how to store and read the checksum, see the SAP Note 3041667. Note that, as part of SAP’s commitment to social justice and equality, SAP is replacing insensitive terms in our software and documentation with inclusive language – defined as “language free from expressions or words that reflect prejudice”. One of the terms we are replacing is the term “whitelist” in SAP documentation with “List of VAT payers” across our solution over time.
- You have administrative access to your SAP system and have implementation experience on this system. Coding experience is also required to build the application.
- An SAP Business Technology Platform (SAP BTP) Global account, and an SAP BTP subaccount in the Cloud Foundry environment.
- SAP BTP Services with Application Runtime (minimum 4 GB memory), and Application Logging (recommended). The recommened memory might change in the future as the published .7zip file will grow.
- One of the following tools to build the app
The Business Application Studio is a SAP provided all-in-one tool that allows you to build the application. Follow the instructions for BAS.
You can also use standard tools to build the application. The list of tools and necessary steps are described here.
After the application has been deployed and run, navigate to the application in your space and you will see the application routes in the URL form. This route will be further referred to as APP_ROUTE. The application has two exposed endpoints, which are expected to be consumed in a client application.
- APP_ROUTE/download This endpoint can be called (via HTTP GET) to download the List of VAT payers data for current date. Given the List of VAT payers archive is approximately 200 MB, you should define an appropriate timeout value (minimum 3 minutes) to prevent timeout during downloading.
- APP_ROUTE/validate This endpoint can be called (via HTTP GET) to validate the tax number/bank account pairs. The format of the HTTP is described in the Request.xsd and Response.xsd in the APP_HOME directory. Processing error responses are described in the Error.xsd, for example 'List of VAT payers data not available'.
Here you can find a description how to test whether the deployed application runs correctly.
In case you have issues with this sample, you can:
- Check the GitHub repository for the latest changes. Alternatively you can check the SAP Note 3034848. All changes of the GitHub repository will be also documented there.
- Contact your SAP contact to obtain support.
- Post questions directly to our SAP Community.
- Report an incident on SAP Support Portal, under the FI-LOC-OVF component
Copyright © 2020 SAP SE or an SAP affiliate company. All rights reserved. This project is licensed under the Apache Software License, version 2.0 except as noted otherwise in the LICENSE file.
[1]: SAP decided to replace the previously used term SAP Cloud Platform with Business Technology Platform.