Intégrations

Essayez

La démo en direct n'est pas activée ici. Le code ci-dessous fonctionne avec votre propre clé.

Plugin WooCommerce

Gratuit et open source. Fonctionne avec le checkout classique et le checkout en blocs, et avec HPOS.

• Recherche d'entreprise dans le champ entreprise du checkout ; l'adresse et le numéro de TVA se remplissent
• Un champ TVA avec contrôle des numéros belges dans la BCE et VIES ; vous choisissez : accepter avec une note, refuser ou ne pas contrôler
• Si l'API tombe, la commande passe quand même
• Numéro d'entreprise, numéro de TVA et réception des factures Peppol sur la commande, lisibles par votre plugin de facturation
• En néerlandais, français et anglais

1. Créez un compte gratuit et ouvrez Clés API.
2. Avec « Pour votre boutique », créez une clé publiable pour l'adresse de votre boutique, et une clé secrète.
3. Installez le plugin et ouvrez WooCommerce › Réglages › FirmAtlas.
4. Collez les deux clés, enregistrez et cliquez sur « Test connection ».

Ce que le plugin enregistre sur la commande

_billing_vat_number

Le numéro de TVA, normalisé

_kbo_enterprise_number

Le numéro d'entreprise, pour les numéros belges qui passent le contrôle

_firmatlas_vat_status

Le résultat du contrôle : valid, invalid, unknown ou foreign

_firmatlas_peppol

Si l'entreprise reçoit des factures Peppol : yes, no ou unknown

L'identifiant Peppol d'une entreprise belge est 0208: suivi du numéro d'entreprise. Avec _firmatlas_peppol, votre plugin de facturation choisit par commande entre Peppol et l'e-mail.

Widget pour tout formulaire

Moins de 5 Ko, sans dépendances, accessible au clavier et aux lecteurs d'écran. Mettez des attributs sur le champ ou appelez-le depuis votre code.

Avec des attributs

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

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

Gravity Forms, Contact Form 7, WPForms et autres constructeurs de formulaires : donnez aux champs un id ou une classe et reliez-les avec le code ci-dessus.

Les clés et ce qu'elles coûtent

Une clé publiable est dans votre page. Elle ne sert qu'à la recherche et à l'autocomplétion, et seulement depuis les adresses que vous indiquez.

Une clé secrète reste sur votre serveur. Le plugin vérifie les numéros de TVA avec elle.

La recherche dans votre boutique ne compte pas dans votre quota API : 20 000 par mois sur Free, 200 000 sur Pro, illimitée sur Business, et 60 par minute par visiteur. Les contrôles TVA comptent comme des appels API ordinaires.