Módulo Kowal_Gus - Descarga automática de datos de empresa desde GUS en Magento 2
- Compatibilidad
- 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
Descripción / Módulo Kowal_Gus - Descarga automática de datos de empresa desde GUS en Magento 2
MAGENTO 2 · B2B · DATOS DE EMPRESA · CHECKOUT
Introduce el NIP y completa datos desde GUS.
Kowal Gus
Facilita compras empresariales obteniendo nombre y dirección del registro GUS en lugar de introducirlos manualmente. Utiliza lo mismo al crear pedidos en Magento Admin.
Nombre y dirección · Checkout y Admin · Modo de prueba
CÓMO FUNCIONA EN LA PRÁCTICA
01 · Configuras el acceso
Activas el módulo y la clave de usuario de GUS.
02 · El usuario introduce el NIP
Cambiar el campo inicia la consulta empresarial.
03 · El formulario completa datos
Nombre, calle, código postal y localidad aparecen en la dirección.
¿Qué gana tu tienda?
Descubre las funciones, el uso y la configuración del módulo.
Introducción
El módulo Kowal_Gus es una solución innovadora para tiendas basadas en Magento 2 que descarga automáticamente los datos de la empresa a partir del número NIP. Gracias a la integración con la API de la Oficina Central de Estadística de Polonia (GUS), los usuarios pueden completar los datos de dirección al instante sin tener que introducir la información manualmente.
Funcionalidades del módulo
- Descarga automática de los datos de la empresa a partir del número NIP
- Relleno de los campos del formulario: nombre de la empresa, dirección, código postal, ciudad
- Compatibilidad tanto con la página de pedido (checkout) como con el panel de administración
- Opción para activar o desactivar el módulo en la configuración de Magento
- Integración fluida con los formularios nativos de Magento
Ventajas de implementar el módulo
- Ahorro de tiempo: eliminación de la introducción manual de datos
- Mayor precisión: evita errores tipográficos y direcciones incorrectas
- Mejor atención al cliente: proceso de compra más rápido e intuitivo
- Cumplimiento de los requisitos fiscales: datos de empresa correctos en las facturas
¿Cómo funciona el módulo?
Tras introducir el número NIP en el formulario de pedido, el módulo envía una consulta a la API de GUS y completa automáticamente los campos del formulario con los datos correspondientes. El mecanismo funciona tanto en la página de checkout como durante la creación manual de un pedido en el panel de administración.
Instalación y configuración
El módulo puede instalarse fácilmente en Magento 2 añadiéndolo al directorio app/code/Kowal/Gus y activándolo en la configuración del sistema. En el panel de administración se encuentra la opción para activar el módulo e introducir la clave API para el acceso autorizado a los datos de GUS.
Resumen
El módulo Kowal_Gus es la solución ideal para propietarios de tiendas Magento 2 que desean optimizar el proceso de introducción de datos de clientes de empresa. Gracias a la automatización, reduce significativamente el tiempo necesario para realizar pedidos, mejora su precisión y eleva la calidad de la atención al cliente.
Acceso a GUS y formulario
En Stores → Configuration → Kowal → nipfromgus → Ajustes activas el módulo, modo de prueba y clave GUS. El paquete utiliza la biblioteca gusapi/gusapi. Necesita acceso a GUS y un campo NIP visible.
El script elimina caracteres no numéricos y consulta al cambiar el campo si hay diez dígitos. Completa empresa, calle con edificio y local, código postal y ciudad. Incluye layouts para checkout, Amasty Checkout y creación administrativa; comprueba el checkout y tema concretos.
Datos adecuados para la gestión posterior
Los datos registrales reducen escritura manual y posibles erratas. Compruébalos antes de pedidos o facturas. El módulo no realiza verificación fiscal independiente de la empresa.
Instalación mediante Composer
Paquete kowal/module-gus, módulo Kowal_Gus. Tras configurar el acceso al repositorio de Kowal, instala el paquete, activa el módulo, actualiza Magento y limpia la caché. En producción, ten en cuenta la compilación y el despliegue de contenido estático de acuerdo con el proceso de la tienda.
De la configuración al resultado
1. Configuras el acceso
Activas el módulo y la clave de usuario de GUS.
2. El usuario introduce el NIP
Cambiar el campo inicia la consulta empresarial.
3. El formulario completa datos
Nombre, calle, código postal y localidad aparecen en la dirección.
Menos escritura en compras empresariales
El cliente introduce NIP. Tras respuesta correcta de GUS, el módulo completa nombre y dirección; el cliente los comprueba antes de pedir.
El administrador también consulta datos al crear pedidos manualmente.
Simplifica pedidos de empresas
¿Quieres adaptar el módulo a tu tienda? Consulta la implementación de Kowal Gus y comenta la configuración o las ampliaciones necesarias.
Más Información
| Conformidad con la plantilla | Luma / Blank, KOWAL |
|---|
Instrucciones de instalación del módulo
Instalación e implementación
Para instalar el módulo, basta con:
- Instalar el módulo: - Añade el repositorio de Composer a la configuración ejecutando
Recibirás por correo electrónico los datos de acceso al repositorio Composer (dirección de e-mail del cliente y token de licencia) después de la compra. También están disponibles en el panel de cliente tras iniciar sesión en kowal.store. Sustituye
TWOJ_EMAIL_KLIENTApor la dirección de e-mail de tu cuenta yTWOJ_TOKENpor el token recibido. Ejecuta los comandos en el directorio raíz de Magento.composer config repositories.kowal composer https://repo.kowal.store
Añade el token de acceso al repositorio privadocomposer config http-basic.repo.kowal.store "TWOJ_EMAIL_KLIENTA" "TWOJ_TOKEN"
Instala el módulo de Composer ejecutandocomposer require kowal/module-gus
Activa el módulo ejecutandophp bin/magento module:enable Kowal_Gus
- Ejecutar los comandos:
bin/magento setup:upgrade bin/magento setup:di:compile bin/magento cache:flush bin/magento indexer:reindex sales_order_grid - Ir a Kowal.co → GUS → Configuración y activa el módulo.
- Ve a la página https://api.stat.gov.pl/Home/RegonApi y sigue las instrucciones para obtener la clave de usuario de la API