Integraties

Probeer het

De live demo staat hier niet aan. De code hieronder werkt met je eigen sleutel.

WooCommerce-plugin

Gratis en open source. Werkt met de klassieke checkout en de blok-checkout, en met HPOS.

• Bedrijf zoeken in het bedrijfsveld van de checkout; adres en btw-nummer vullen zich in
• Een btw-veld met controle van Belgische nummers in de KBO en VIES; jij kiest: aanvaarden met een notitie, weigeren of niet controleren
• Valt de API uit, dan gaat de bestelling gewoon door
• Ondernemingsnummer, btw-nummer en of het bedrijf Peppol-facturen ontvangt op de bestelling, leesbaar voor je facturatieplugin
• In het Nederlands, Frans en Engels

1. Maak een gratis account en open API-sleutels.
2. Maak met 'Voor je webshop' een publiceerbare sleutel voor het adres van je winkel, en een geheime sleutel.
3. Installeer de plugin en open WooCommerce › Instellingen › FirmAtlas.
4. Plak beide sleutels, bewaar en klik op 'Test connection'.

Wat de plugin op de bestelling bewaart

_billing_vat_number

Het btw-nummer, genormaliseerd

_kbo_enterprise_number

Het ondernemingsnummer, voor Belgische nummers die de controle doorstaan

_firmatlas_vat_status

Het resultaat van de controle: valid, invalid, unknown of foreign

_firmatlas_peppol

Of het bedrijf Peppol-facturen ontvangt: yes, no of unknown

De Peppol-ID van een Belgisch bedrijf is 0208: gevolgd door het ondernemingsnummer. Met _firmatlas_peppol kiest je facturatieplugin per bestelling tussen Peppol en e-mail.

Widget voor elk formulier

Onder 5 KB, zonder afhankelijkheden, toegankelijk met het toetsenbord en schermlezers. Zet attributen op het veld of roep het aan vanuit je eigen code.

Met attributen

<input
  data-kbo-autocomplete
  data-kbo-key="kbo_pk_live_…"
  data-kbo-lang="nl"
  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>

Vanuit je 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: "nl",
      fields: { vat: "#vat", street: "#street", number: "#number", zipcode: "#zipcode", city: "#city" },
    });
  });
</script>

Gravity Forms, Contact Form 7, WPForms en andere formulierbouwers: geef de velden een id of klasse en koppel ze met de code hierboven.

Sleutels en wat ze kosten

Een publiceerbare sleutel staat in je pagina. Hij werkt alleen voor zoeken en autocomplete, en alleen vanaf de adressen die je opgeeft.

Een geheime sleutel blijft op je server. De plugin controleert er btw-nummers mee.

Zoeken in je webshop telt niet mee voor je API-quotum: 20.000 per maand op Free, 200.000 op Pro, onbeperkt op Business, en 60 per minuut per bezoeker. Btw-controles tellen als gewone API-calls.