Skip to content

A Java program is provided to download and extract the white list of the encoded bank account/tax number pairs from Polish authorities. It also provides a service to check if a requested pair is included in the downloaded list.

License

Notifications You must be signed in to change notification settings

SAP-samples/localization-toolkit-s4hana-cloud-bank-account-validation

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

33 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

REUSE status

Poland: Using the List of VAT payers

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.

Description

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.

Implementation

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.

About the List of VAT payers

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.

Requirements

  • 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

Business Application Studio

The Business Application Studio is a SAP provided all-in-one tool that allows you to build the application. Follow the instructions for BAS.

Standard SDK tools

You can also use standard tools to build the application. The list of tools and necessary steps are described here.

Consumption of the end points

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'.

Testing

Here you can find a description how to test whether the deployed application runs correctly.

How to obtain Support

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

License

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.

About

A Java program is provided to download and extract the white list of the encoded bank account/tax number pairs from Polish authorities. It also provides a service to check if a requested pair is included in the downloaded list.

Topics

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published