Allimedia ICO Lookup for WooCommerce

Description

Allimedia ICO Lookup for WooCommerce adds Company ID (IČO) and VAT ID (DIČ) fields to the WooCommerce checkout. A customer can look up a Czech company by its Company ID and fill the company name, street, city, postal code, and country from the public ARES register.

The plugin supports both the classic shortcode checkout and the WooCommerce block checkout. Order data is saved through the WooCommerce CRUD API for compatibility with High-Performance Order Storage (HPOS).

It is a focused checkout utility with theme-native default styling, optional visual controls, customer-profile prefilling, customer and store-wide ARES request budgets, and no account, API key, tracking, license server, or connection to Allimedia.cz.

Features

  • Validates the Czech Company ID checksum before sending a request.
  • Supports manual lookup and optional automatic lookup after entering eight digits.
  • Caches successful ARES responses for 24 hours.
  • Limits each customer to 10 and each store to 120 uncached ARES requests per minute to prevent abuse.
  • Validates the VAT ID format before storing checkout data.
  • Saves Company ID and VAT ID to the order and the signed-in customer’s billing profile.
  • Includes Company ID and VAT ID in personal data exports and integrates their erasure with WooCommerce privacy settings.
  • Displays Company ID in both HPOS and legacy order lists.
  • Provides optional, validated visual controls for the fields and lookup button.
  • Adds suggested disclosure text to the WordPress Privacy Policy Guide.

External service: ARES

This plugin connects to the public ARES service operated by the Ministry of Finance of the Czech Republic at https://ares.gov.cz/. The connection is made when a customer clicks the lookup button or, if automatic lookup is enabled, after an eight-digit Company ID is entered.

The request sends the entered Company ID in the URL. The standard WordPress HTTP User-Agent may also contain the WordPress version and the store URL. ARES returns public company identification and address data. No ARES account or API key is required, and the plugin does not send the data to Allimedia.cz.

Privacy

The plugin does not track users and does not contact Allimedia.cz. Successful ARES responses are stored in WordPress transients for 24 hours. Temporary per-customer request counters contain only a site-salted hash of the WooCommerce session identifier or IP address and expire after one minute.

Company ID and VAT ID are stored as billing data in the order. For signed-in customers, they are also saved to the customer billing profile for the next purchase.

Company ID and VAT ID are included in WordPress personal data exports. An approved erasure request removes them from the customer billing profile. Their anonymization or removal from orders follows the WooCommerce account erasure and data retention settings, so store retention choices remain in effect.

Screenshots

Installation

  1. Install the plugin from the WordPress plugin directory, or upload the allimedia-ico-lookup-for-woocommerce folder to /wp-content/plugins/.
  2. Activate the plugin. WooCommerce must also be active.
  3. Open WooCommerce > Settings > Allimedia ICO Lookup for WooCommerce to configure the lookup and appearance.

FAQ

Does the plugin add Company ID and VAT ID fields automatically?

Yes. The fields are added to both the classic WooCommerce checkout and the block checkout.

Does the plugin support HPOS?

Yes. The plugin declares HPOS compatibility and stores order data through the WooCommerce CRUD API.

Do I need an ARES account or API key?

No. ARES provides a public lookup service and does not require an account or API key.

Can I change how long successful lookup results are cached?

Yes. Developers can use the allimedia_woo_ico_lookup_ares_cache_ttl filter. The minimum cache duration is one minute.

Can I change the ARES request limit?

Yes. Developers can use allimedia_woo_ico_lookup_ares_client_rate_limit for the per-customer limit and allimedia_woo_ico_lookup_ares_rate_limit for the store-wide limit. Defaults are 10 and 120 uncached requests per minute respectively.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“Allimedia ICO Lookup for WooCommerce” is open source software. The following people have contributed to this plugin.

Contributors

“Allimedia ICO Lookup for WooCommerce” has been translated into 1 locale. Thank you to the translators for their contributions.

Translate “Allimedia ICO Lookup for WooCommerce” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

1.1.14

  • Initial public release.
  • Added Company ID (IČO) and VAT ID (DIČ) fields for Classic and Block Checkout.
  • Added Czech company lookup and address autofill through the public ARES service.
  • Added HPOS support, customer-profile prefilling, request limiting and ARES response caching.
  • Added privacy export and erasure integration.
  • Added validated appearance controls for checkout fields and the lookup button.