Module Kowal_Gus - Récupération automatique des données d’entreprise depuis le GUS dans Magento 2
- Compatibilité
- 2.4.9, 2.4.8, 2.4.7, 2.4.6, 2.4.5, 2.4.4, 2.4.3, 2.4.2, 2.4.1, 2.4.0, 2.3.7, 2.3.6, 2.3.5, 2.3.4
Description / Module Kowal_Gus - Récupération automatique des données d’entreprise depuis le GUS dans Magento 2
MAGENTO 2 · B2B · DONNÉES D’ENTREPRISE · CHECKOUT
Saisissez le NIP. Complétez les données d’entreprise depuis le GUS.
Kowal Gus
Facilitez la passation de commandes pour vos clients professionnels : récupérez le nom de l’entreprise et son adresse depuis le registre GUS au lieu de saisir chaque élément manuellement. Utilisez la même fonction lors de la création de commandes dans le panneau Magento.
Nom et adresse · Checkout et Magento Admin · Mode test
COMMENT CELA FONCTIONNE EN PRATIQUE
01 · Vous configurez l’accès
Vous activez le module et définissez la clé utilisateur du service GUS.
02 · L’utilisateur saisit le NIP
La modification du champ déclenche la récupération des données de l’entreprise.
03 · Le formulaire complète les données
Le nom, la rue, le code postal et la ville sont ajoutés aux champs d’adresse.
Quels avantages pour votre boutique ?
Découvrez les fonctionnalités, les usages et les paramètres du module.
Introduction
Le module Kowal_Gus est une solution innovante pour les boutiques basées sur Magento 2, qui récupère automatiquement les données d’entreprise à partir du numéro NIP. Grâce à l’intégration avec l’API de l’Office central des statistiques polonais (GUS), les utilisateurs peuvent remplir instantanément les données d’adresse sans devoir saisir les informations manuellement.
Fonctionnalités du module
- Récupération automatique des données d’entreprise à partir du numéro NIP
- Remplissage des champs du formulaire : nom de l’entreprise, adresse, code postal, ville
- Prise en charge à la fois de la page de commande (checkout) et du panneau d’administration
- Option d’activation/désactivation du module dans la configuration Magento
- Intégration fluide avec les formulaires natifs de Magento
Avantages de la mise en place du module
- Gain de temps – suppression de la saisie manuelle des données
- Précision accrue – réduction des fautes de frappe et des adresses incorrectes
- Meilleure expérience client – processus de commande plus rapide et plus intuitif
- Données d’entreprise correctes pour le traitement ultérieur et les factures ; la récupération des données depuis le registre contribue à leur exactitude, mais ne confirme pas à elle seule la conformité fiscale.
Comment fonctionne le module ?
Après la saisie du numéro NIP dans le formulaire de commande, le module envoie une requête à l’API GUS et complète automatiquement les champs du formulaire avec les données correspondantes. Le mécanisme fonctionne aussi bien sur la page checkout que lors de la création manuelle d’une commande dans le panneau d’administration.
Installation et configuration
Le module peut être facilement installé dans Magento 2 en l’ajoutant au répertoire app/code/Kowal/Gus et en l’activant dans la configuration système. Dans le panneau administrateur, une option permet d’activer le module et de saisir la clé API pour un accès autorisé aux données GUS.
Résumé
Le module Kowal_Gus est une solution idéale pour les propriétaires de boutiques Magento 2 qui souhaitent optimiser la saisie des données des clients professionnels. Grâce à l’automatisation, il réduit nettement le temps nécessaire pour passer commande, améliore leur précision et augmente la qualité du service client.
Accès au GUS et gestion du formulaire
Dans Stores → Configuration → Kowal → nipfromgus → Paramètres, vous activez le module, définissez le mode test et la clé utilisateur GUS. Le package utilise la bibliothèque gusapi/gusapi. Il nécessite un accès au service GUS ainsi qu’un champ NIP visible.
Le script supprime du NIP les caractères autres que les chiffres et envoie une requête après modification du champ lorsque le numéro comporte 10 chiffres. Après réception de la réponse, il renseigne le nom de l’entreprise, la rue avec le numéro de bâtiment et de local, le code postal ainsi que la ville. Le code inclut les mises en page du checkout, d’Amasty Checkout et de la création de commandes dans le panneau ; la compatibilité avec un checkout et un thème spécifiques doit être vérifiée lors de la mise en place.
Données correctes pour le traitement ultérieur
La récupération des données de registre limite la saisie manuelle et peut réduire le nombre de fautes de frappe. Les données doivent être vérifiées avant leur utilisation pour une commande ou une facture. Le module n’effectue pas de vérification fiscale distincte de l’entreprise.
Installation via Composer
Package kowal/module-gus, module Kowal_Gus. Après avoir configuré l’accès au dépôt Kowal, installez le package, activez le module, mettez Magento à jour et videz le cache. En production, prévoyez la compilation et le déploiement du contenu statique conformément au processus de la boutique.
De la configuration au résultat
1. Vous configurez l’accès
Vous activez le module et définissez la clé utilisateur du service GUS.
2. L’utilisateur saisit le NIP
La modification du champ déclenche la récupération des données de l’entreprise.
3. Le formulaire complète les données
Le nom, la rue, le code postal et la ville sont ajoutés aux champs d’adresse.
Moins de saisie lors d’un achat professionnel
Le client indique son NIP dans le checkout. Après une réponse correcte du GUS, le module renseigne le nom de l’entreprise et l’adresse. Le client vérifie les données avant de passer commande.
L’administrateur peut également utiliser la récupération des données lors de la création manuelle d’une commande.
Simplifiez les commandes pour les clients professionnels
Vous souhaitez adapter le module à votre boutique ? Demandez la mise en place de Kowal Gus et discutez de la configuration ou des extensions nécessaires.
Caractéristiques
| Compatibilité avec le modèle | Luma / Blank, KOWAL |
|---|
Notice d'installation du module
Installation et mise en place
Pour installer le module, il suffit de :
- Installer le module : - Ajoutez le dépôt Composer à la configuration en exécutant
Les identifiants d’accès au dépôt Composer (adresse e-mail du client et token de licence) vous seront envoyés par e-mail après l’achat. Ils sont également disponibles dans l’espace client après connexion sur kowal.store. Remplacez
TWOJ_EMAIL_KLIENTApar l’adresse e-mail de votre compte etTWOJ_TOKENpar le token reçu. Exécutez les commandes dans le répertoire racine de Magento.composer config repositories.kowal composer https://repo.kowal.store
Ajoutez le token d’accès au dépôt privécomposer config http-basic.repo.kowal.store 'TWOJ_EMAIL_KLIENTA' 'TWOJ_TOKEN'
Installez le module Composer en exécutantcomposer require kowal/module-gus
Activez le module en exécutantphp bin/magento module:enable Kowal_Gus
- Exécuter les commandes :
bin/magento setup:upgrade bin/magento setup:di:compile bin/magento cache:flush bin/magento indexer:reindex sales_order_grid
- Accédez à Kowal.co → GUS → Paramètres et activez le module.
- Rendez-vous sur la page https://api.stat.gov.pl/Home/RegonApi et suivez les instructions afin d’obtenir la clé utilisateur API