Partita IVA Lookup for WooCommerce — find a company by its P.IVA with Openapi

Partita IVA Lookup with Openapi for WooCommerce adds a Partita IVA field and a “Find company” button to the WooCommerce checkout (classic and block). The buyer types the number of an Italian company, the module asks the Company API of Openapi and puts the company name and registered address into the billing details. For shops that sell to Italian companies: B2B, wholesale, invoices with the buyer’s Partita IVA. Requests go through your own Openapi account.

What the free version does

The number first passes the check digit test in the shop, so a typo shows before any request. When the buyer leaves the field or presses “Find company”, the module finds the company with the IT-start method and shows a line like “OPENAPI S.P.A. — Active” under the field. Company name, street, CAP, town and province go into the billing address, on the classic and the block checkout. The Partita IVA field can be added by the plugin, taken from CatCode FatturaPA, or named as a field of another plugin (the last one on the classic checkout only). A company found once is cached (24 hours by default, 1 to 720), so a repeat lookup does not cost you new credit. Everything found stays with the order: a data snapshot, a note and a box on the order screen. If Openapi does not answer or the number is not in the register, the order goes through and the note says why; a separate checkbox refuses unknown numbers. In the settings: Check connection and “Try it” for any number. The token is stored encrypted, and a switch moves the plugin to the Openapi test environment.

What Pro adds

PEC and the SDI recipient code go into the plugin’s own fields, the fields of CatCode FatturaPA or fields you name; when the basic answer has no code, the module asks the IT-sdicode method. For companies ceased in the register (CESSATA) or flagged as closed by the tax office (IT-closed) you choose: refuse the order, only warn, or do nothing. Marks on the order: public administration (PA, IT-pa) and companies subject to split payment (IT-splitpayment). Buyers from other countries: France, Germany, Spain, Portugal, United Kingdom, Belgium, Austria, Switzerland and Poland are looked up through their “-start” methods, the other EU states through EU-vies (valid VAT number and name). “Look up again” on the order screen repeats the request. A daily request limit, a request journal by month and method, and a checkbox to refuse the order when the number cannot be checked.

Good to know before you start

• The module works through your own Openapi account (openapi.com): the token is created in the Openapi console with access to the Company API methods you use.
• Requests in the Openapi production environment are billed by Openapi from the credit of your account. The connection check also sends one billed IT-start request.
• The Openapi test environment answers only for the companies of its example list, so live numbers need a production token.
• So that checkout requests cannot drain your credit, one address may make 20 lookups in 10 minutes. A daily request limit is in Pro.
• A company counts as closed when the register shows CESSATA or the tax office flags it as closed. INATTIVA and SOSPESA only colour the status line.
• The module accepts an SDI code of 7 characters. The fields of another plugin are read on the classic checkout only.
• A cached answer keeps its status wording in the language it was fetched in, so a buyer in another language sees it until the cache expires.
• This is an independent integration: the module is not an official Openapi product, and the Openapi trademark belongs to its owner.
• The module screens and the buyer-facing texts are in English and Italian.

How it works, step by step

1. Create an account at openapi.com, top up the credit and create a token with access to the Company API in the console.
2. WooCommerce → Partita IVA Lookup: paste the token, press “Check connection” and save.
3. Choose where the Partita IVA field comes from: the plugin’s own field, CatCode FatturaPA or a field of another plugin.
4. Open the checkout, type a Partita IVA and press “Find company”: the company name and address fill in by themselves.

Under the hood

• Tokens are stored encrypted and never printed back on the page.
• For a whole checkout each Openapi method is called once: the answer passes from the lookup to the check and to saving the order.
• Checkout requests are protected by a one-time key and a per-address limit.
• The order goes through even when Openapi is unavailable: the reason is written to a note. Pro lets you choose the opposite.
• Compatible with HPOS and with the classic and block checkout; languages: English, italiano.

How to install

1. Plugins → Add New → Upload Plugin: choose the zip and activate it.
2. WooCommerce → Partita IVA Lookup: paste the Openapi token and press “Check connection”.
3. Choose the Partita IVA field and save the settings.
4. Type a number at the checkout to see the result.

The module is not on wordpress.org yet: the free version and Pro are one archive from this page. Without a key it works as the free version.