Download data from GUS PrestaShop module

Company data by NIP in PrestaShop – automatic download from CSO

How to automatically complete company data after NIP number in PrestaShop?

The GUS module for PrestaShop allows the customer to download company data based on the NIP number and automatically fill in the address form when placing an order.

After entering the NIP number, the customer chooses the option to download the data. The module checks the correctness of the NIP number, sends a request to the GUS API, and then completes the available company data in the order form.

How does downloading company data from GUS work?

The customer enters the NIP number when placing an order and selects the "Download" button. The module first performs the built-in validation of the NIP number, and then downloads the company data from the GUS database via API.

The downloaded information is automatically entered into the appropriate fields of the address form. Thanks to this, the customer does not have to manually rewrite the company name and address data.

What company data is downloaded?

• company name,
• company address,
• city,
• postal code.

GUS PrestaShop – less manual data entry

Manually rewriting company data when placing an order increases the risk of mistakes in the company name or address. Integration with the Central Statistical Office allows the customer to download available data based on one NIP number and use it directly in the order form.

The data download button can be added without the need to modify the store template.

Validation of the NIP number before requesting the Central Statistical Office

Before sending a request to the GUS API, the module checks the correctness of the entered NIP number. This allows you to limit the sending of incorrect requests and inform the customer about the incorrectly entered number faster.

In the event of a problem, the customer receives a clear error message, so that he can correct the data without having to leave the purchase process.

Company details in the PrestaShop order form

The downloaded information is used directly in the customer's address form. The module has been designed to streamline the ordering process without having to rebuild the entire checkout.

It is also possible to use your own hook, thanks to which the data download button can be placed in a selected place of the non-standard purchasing process.

CUS module configuration

The module allows you to match the way the data retrieval function is presented to the appearance and operation of the store.

• choosing the appearance of a button or checkbox,
• possibility to add additional instructions for the customer,
• predefined message colors based on alert style,
• possibility to add information to the order confirmation e-mail,
• possibility to hide the "Company name" and "NIP" fields when selecting a receipt type document,
• rememoring the customer's choice until the browser is closed,
• possibility of using your own hooking in a custom checkout.

Information for the store administrator

The module can provide additional information about the customer's choice for the order, making it easier for the person handling the order to check how the customer provided the data.

The administrator can also change the type of document in the back office, for example, after contacting the customer and determining the correct way to settle the order.

Integration with GUS API

The module uses the GUS API to retrieve the entity's data based on the NIP number. Using the GUS API and obtaining an access key is free of charge.

To use the integration, you need to obtain access data to the GUS API.

Information about GUS API and access registration

What PrestaShop stores is the module intended for?

The module will work especially well in online stores that support sales for companies and want to make it easier for customers to provide invoice data when placing an order.

It is especially useful for stores that:

• sell products or services to business customers,
• often handle company orders,
• want to limit manual rewriting of company data,
• want to reduce the number of errors in address data,
• use a custom PrestaShop checkout.

Compatibility with PrestaShop

The module supports Bootstrap 5 and has the ability to switch the way of presenting integration elements. By using its own attachment, it can also work with custom checkout solutions, depending on their design.

Frequently Asked Questions

Does the module download company data by NIP number?

Yes. The customer enters the NIP number, and then can download the company data from the GUS API. The available data is then used to complete the address form.

What company data is collected from the Central Statistical Office?

The module takes, among other things, the company name, address, city and postal code.

Does the customer have to manually enter company data?

No. After entering the NIP number, the customer can use the "Download" button, and the data available in the GUS API will be used to automatically complete the form.

Does the module check the correctness of the NIP number?

Yes. Before sending a request to the GUS API, the NIP number is validated.

Is the use of the GUS API paid?

Using the GUS API and obtaining an access key is free of charge.

Do I need to modify the PrestaShop template?

The standard addition of a data download button does not require modification of the store template. The module also offers the possibility of using your own hook in the case of a non-standard checkout.

Is it possible to hide company data when choosing a receipt?

Yes. The module allows you to hide the "Company name" and "NIP" fields if the "receipt" option is selected.