Integrations

Try it

The live demo isn't switched on here. The code below works with your own key.

WooCommerce plugin

Free and open source. Works with the classic and the block checkout, and with HPOS.

• Company search in the checkout's company field; address and VAT number fill themselves
• A VAT field that checks Belgian numbers in the KBO and VIES; you choose: accept with a note, refuse, or don't check
• If the API is down, the order still goes through
• Enterprise number, VAT number and whether the company receives Peppol invoices on the order, readable by your invoicing plugin
• In Dutch, French and English

1. Create a free account and open API keys.
2. With 'For your webshop', make a publishable key for your shop's address, and a secret key.
3. Install the plugin and open WooCommerce › Settings › FirmAtlas.
4. Paste both keys, save and click 'Test connection'.

What the plugin saves on the order

_billing_vat_number

The VAT number, normalised

_kbo_enterprise_number

The enterprise number, for Belgian numbers that pass the check

_firmatlas_vat_status

The check's result: valid, invalid, unknown or foreign

_firmatlas_peppol

Whether the company receives Peppol invoices: yes, no or unknown

A Belgian company's Peppol ID is 0208: followed by the enterprise number. With _firmatlas_peppol your invoicing plugin picks Peppol or email per order.

A widget for any form

Under 5 KB, no dependencies, usable by keyboard and screen readers. Put attributes on the field or call it from your own code.

With attributes

<input
  data-kbo-autocomplete
  data-kbo-key="kbo_pk_live_…"
  data-kbo-lang="en"
  data-kbo-fill-vat="#vat"
  data-kbo-fill-street="#street"
  data-kbo-fill-number="#number"
  data-kbo-fill-zipcode="#zipcode"
  data-kbo-fill-city="#city"
/>
<script src="https://cdn.jsdelivr.net/npm/@firmatlas/[email protected]/dist/firmatlas-autocomplete.iife.js" defer></script>

From your code

<script src="https://cdn.jsdelivr.net/npm/@firmatlas/[email protected]/dist/firmatlas-autocomplete.iife.js" defer></script>
<script>
  addEventListener("DOMContentLoaded", () => {
    KboAutocomplete.attach(document.querySelector("#company"), {
      key: "kbo_pk_live_…",
      lang: "en",
      fields: { vat: "#vat", street: "#street", number: "#number", zipcode: "#zipcode", city: "#city" },
    });
  });
</script>

Gravity Forms, Contact Form 7, WPForms and other form builders: give the fields an id or class and connect them with the code above.

Keys and what they cost

A publishable key sits in your page. It only works for search and autocomplete, and only from the addresses you list.

A secret key stays on your server. The plugin checks VAT numbers with it.

Search in your webshop doesn't count against your API quota: 20.000 a month on Free, 200.000 on Pro, unlimited on Business, and 60 a minute per visitor. VAT checks count as ordinary API calls.