Descripción
WC – APG Campo NIF/CIF/NIE añade a tu tienda WooCommerce un nuevo campo NIF/CIF/NIE a todos los formularios de facturación y envío disponibles tanto para el administrador como para el cliente en WooCommerce.
Requisitos: el plugin necesita WooCommerce 2.4.0 o superior y la clase PHP SoapClient para la validación VIES/EORI.
Características
- Totalmente compatible con el bloque Finalizar compra del editor de bloques de WordPress.
- Puedes hacer obligatorio el campo NIF/CIF/NIE en el formulario de facturación.
- Puedes hacer obligatorio el campo NIF/CIF/NIE en el formulario de envío.
- Puedes ocultar el campo NIF/CIF/NIE del formulario de envío.
- Puedes personalizar la prioridad (posición) del campo.
- Puedes validar el campo NIF/CIF/NIE.
- Puedes validar el campo VIES VAT number para aplicar una exención de impuestos.
- Puedes validar el campo EORI para impedir la venta si no se introduce un número válido.
- Puedes seleccionar el/los país/es donde se validará el campo EORI.
- Puedes personalizar la etiqueta y el marcador de posición del campo NIF/CIF/NIE, VIES VAT number o EORI.
- Puedes personalizar el mensaje de error del campo NIF/CIF/NIE, VIES VAT number o EORI.
- Puedes personalizar el mensaje de error si se supera el máximo de consultas a la API de comprobación del campo VIES VAT number.
- Añade como requeridos los campos teléfono y correo electrónico al formulario de envío.
- Puedes eliminar los campos de teléfono y correo electrónico de la dirección predeterminada.
- Puedes mostrar y personalizar un mensaje de error para el formulario de facturación utilizando los filtros
apg_nif_display_error_messageyapg_nif_error_message. - Puedes quitar los campos Correo electrónico y Teléfono del formulario de envío con el filtro
apg_nif_add_fields. - Puedes omitir la validación por país o condición externa con el filtro
apg_nif_skip_validation. - Puedes anular la obligatoriedad del campo en facturación o envío con el filtro
apg_nif_skip_required. - Añade un botón de descarga de clientes en WooCommerce (Clientes) que incluye el campo NIF/CIF/NIE en el CSV.
- Valida documentos de:
- Albania.
- Andorra.
- Austria.
- Argentina.
- Islas Åland.
- Bélgica.
- Bulgaria.
- Bielorusia.
- Suiza.
- Chile.
- Chipre.
- República Checa.
- Alemania.
- Dinamarca.
- Estonia.
- España.
- Unión Europea.
- Finlandia.
- Islas Feroe.
- Francia.
- Gran Bretaña.
- Grecia.
- Croacia.
- Hungría.
- Irlanda.
- Islandia.
- Italia.
- Liechtenstein.
- Lituania.
- Luxemburgo.
- Letonia.
- Mónaco.
- Moldavia.
- Montenegro.
- Macedonia del Norte.
- Malta.
- Países Bajos.
- Noruega.
- Polonia.
- Portugal.
- Rumanía.
- Serbia.
- Suecia.
- Eslovenia.
- República Eslovaca.
- San Marino.
- Ucrania.
- 100% compatible con WooCommerce PDF Invoices & Packing Slips.
- 100% compatible con WPML.
- 100% compatible con Checkout Field Editor (Checkout Manager) for WooCommerce
Traducciones
- Inglés: by Art Project Group (idioma por defecto).
- Español: por Art Project Group.
Más información
Puedes obtener más información sobre WC – APG Campo NIF/CIF/NIE en nuestro sitio web oficial y seguir el desarrollo en GitHub.
Agradecimientos
Gracias a todos los que usáis el plugin, ayudáis a mejorarlo, hacéis donaciones o nos animáis con vuestros comentarios.
Si te resulta útil, puedes apoyar su desarrollo con una pequeña donación.
Servicios Externos
-
A la API de plugins de WordPress.org para obtener información sobre plugins.
- Envía el enlace permanente del plugin cuando solicita datos.
- Más información: https://wordpress.org/about/privacy/
-
A la API de validación de números de IVA (VIES) y de números EORI de la Comisión Europea.
- Envía el país y el número de IVA — validación VIES —.
- Envía el número EORI.
- Más información: https://commission.europa.eu/privacy-policy-websites-managed-european-commission_es
-
A la API de validación de número EORI del Gobierno del Reino Unido.
- Envía el número EORI.
- Más información: https://www.gov.uk/help/privacy-notice
-
A la API de validación de número EORI de VatApp.
- Envía el número EORI.
- Más información: https://vatapp.net/privacy-policy
Capturas



Instalación
- Instala el plugin de una de las siguientes maneras:
- Sube la carpeta
wc-apg-nifcifnie-fieldal directorio/wp-content/plugins/vía FTP. - Subir el archivo ZIP completo vía Plugins -> Añadir nuevo -> Subir en el Panel de Administración de tu instalación de WordPress.
- Buscar WC – APG Campo NIF/CIF/NIE en el buscador disponible en Plugins -> Añadir nuevo y pulsar el botón Instalar ahora.
- Sube la carpeta
- Activar el plugin a través del menú Plugins en el Panel de Administración de WordPress.
- Configura el plugin en WooCommerce -> Campo NIF/CIF/NIE o a través del enlace Ajustes en la página de plugins.
FAQ
-
¿Cómo se configura el plugin?
-
La configuración del plugin es muy simple: solo debes indicar si quieres que el campo NIF/CIF/NIE se valide o no, y configurar la validación opcional de VIES y EORI si las necesitas.
-
¿Cómo corrijo los metadatos NIF duplicados de pedidos antiguos?
-
Si tu tienda realizó pedidos con el Bloque de Finalizar compra (o con el checkout clásico) usando una versión anterior del plugin, es posible que algunos pedidos tengan filas de metadatos
billing_nif/shipping_nifduplicadas o heredadas que impiden que el campo se actualice correctamente desde el panel de administración.Opción 1 – Página de ajustes (recomendado): Ve aWooCommerce Campo NIF/CIF/NIE. Si se detectan duplicados, aparecerá el botón «Corregir los metadatos duplicados del NIF» al final de la página. Haz clic para ejecutar la limpieza. El botón desaparece automáticamente cuando no quedan duplicados.
Opción 2 – WP-CLI (tiendas grandes): Ejecuta el siguiente comando desde la raíz de tu instalación de WordPress para evitar tiempos de espera HTTP:
wp eval-file wp-content/plugins/wc-apg-nifcifnie-field/includes/admin/limpieza-meta-duplicados.php -
¿Dónde puedo obtener soporte?
-
WC – APG Campo NIF/CIF/NIE es un plugin gratuito. Art Project Group no proporciona soporte técnico gratuito, pero ofrece un servicio de soporte técnico de pago para instalación y configuración.
Reseñas
Colaboradores y desarrolladores
«WC – APG Campo NIF/CIF/NIE» es un software de código abierto. Las siguientes personas han colaborado con este plugin.
Colaboradores«WC – APG Campo NIF/CIF/NIE» está traducido en 4 idiomas. Gracias a los traductores por sus contribuciones.
Traduce «WC – APG Campo NIF/CIF/NIE» a tu idioma.
¿Interesado en el desarrollo?
Revisa el código , echa un vistazo al repositorio SVN o suscríbete al registro de desarrollo por RSS.
Registro de cambios
4.14.1
- Corregido: la limpieza de metadatos y la migración automática (una sola vez) no llegaban a procesar la tabla de pedidos HPOS (
wc_orders_meta); dependían de la propiedad$wpdb->wc_orders_meta, que WooCommerce no define, así que en tiendas con HPOS la migración de la 4.14.0 solo tocabapostmetay dejaba los pedidos sin cambiar. Ahora la tabla HPOS se detecta a partir del prefijo de la base de datos, y la limpieza automática se vuelve a ejecutar al actualizar a la 4.14.1 para migrar esos pedidos a_billing_nif/_shipping_nif.
4.14.0
- La clave de metadatos del NIF/CIF/NIE en el pedido pasa a ser
_billing_nif/_shipping_nif(con guion bajo inicial), siguiendo la convención nativa de WooCommerce para el meta de pedido ((_billing_*), de modo que la leen las integraciones con ERP como Holded y otras que esperan la clave con guion bajo. La lectura mantiene compatibilidad con la clave heredadabilling_nif/shipping_nifpara pedidos de versiones anteriores. - La herramienta de limpieza de metadatos duplicados ahora migra las claves heredadas
billing_nif/shipping_nifa la canónica_billing_nif/_shipping_nif(tanto enpostmetacomo en la tabla HPOSwc_orders_meta). Ejecútala desde los ajustes del plugin o vía WP-CLI en tiendas grandes. - Esta limpieza también se ejecuta automáticamente una sola vez, en el panel de administración, justo después de actualizar a esta versión, de modo que la migración ocurre sin necesidad de pulsar el botón (el botón de ajustes y el script WP-CLI siguen disponibles como alternativa para tiendas muy grandes).
- El meta de usuario/cliente no cambia: sigue siendo
billing_nif/shipping_nif, ya que WooCommerce guarda los campos de cliente sin guion bajo.
4.13.0
- Corregido que el campo NIF/CIF/NIE no se rellenara al seleccionar un cliente al crear o editar un pedido en el panel de administración. El campo se renderiza ahora con el id que espera el script de datos de cliente de WooCommerce (
_billing_nif/_shipping_nif), mientras que el valor se sigue guardando con las claves canónicasbilling_nif/shipping_nif. - Unificada la clave de metadatos del NIF en todas las vías de guardado. El checkout clásico ya no deja una copia heredada
_billing_nif/_shipping_nif, y editar un pedido desde el panel de administración ya no crea un segundo metadato. - Reescrita la detección y la herramienta de limpieza de metadatos duplicados del NIF. La detección identifica ahora también los pedidos donde
billing_nify_billing_nif(oshipping_nify_shipping_nif) coexisten, actúa sobrepostmetaywc_orders_meta(HPOS, incluido el modo sincronización y las configuraciones en las que antes no aparecía el botón de limpieza) y cachea la consulta durante una hora para evitar problemas de rendimiento en tiendas grandes. La limpieza migra las claves heredadas solitarias a la canónica, elimina las heredadas cuando ya existe la canónica y deduplica filas repetidas, de modo que detección y limpieza siempre coinciden (corrigiendo el caso en que el botón aparecía pero indicaba «0 corregidos»). - Revisados y corregidos los textos en inglés del plugin. Corregida la redacción de la descripción de los ajustes y de las ayudas de los campos (por ejemplo «validate the field before submission», «allow and validate the VIES VAT number / the EORI number») y del cuadro de información («Contact us», «If you enjoy this plugin and find it helpful»), y renombrada la referencia «End Purchase block» al término correcto de WooCommerce «Checkout block».
4.12.2
- Corregida la causa raíz del problema por el que el campo NIF no se guardaba al editar un pedido existente desde el panel de administración: faltaba un
idexplícito en la definición del campo, por lo que WooCommerce escribía el valor introducido en la administración en_billing_nif/_shipping_nifen lugar de enbilling_nif/shipping_nif. Como resultado, la pantalla siempre mostraba el valor original del pedido sin cambios. - Corregida la función de detección de metadatos duplicados para que compruebe tanto
postmetacomowc_orders_meta(HPOS) independientemente del modo de almacenamiento activo. Anteriormente el botón de limpieza podía no aparecer en tiendas con HPOS en modo sincronización o con ciertas configuraciones de HPOS.
4.12.1
- Corregida una regresión introducida en la versión 4.12.0 que hacía que al editar el campo NIF de un pedido existente desde el panel de administración y guardar, el nuevo valor se descartara en silencio y quedara el valor anterior en la base de datos. El problema se daba en tiendas con filas duplicadas de metadatos NIF creadas por versiones anteriores del plugin. Se ha eliminado el hook de deduplicación automática; para limpiar los duplicados usa el botón en los ajustes del plugin o el script WP-CLI.
4.12.0
- Corregida la creación de filas duplicadas de metadatos
billing_nif/shipping_nifal realizar pedidos con el Bloque de Finalizar compra, que impedía que el campo NIF se actualizara correctamente al editar un pedido desde el panel de administración. - Añadido el botón «Corregir los metadatos duplicados del NIF» en la página de ajustes del plugin para limpiar las filas duplicadas existentes en las tiendas afectadas por versiones anteriores.
4.11.4
- Corregida una regresión en el Bloque de Finalizar compra introducida en la versión 4.11.3 por la que el campo NIF/CIF/NIE podía tratarse como un campo nativo de dirección durante las peticiones Store API y lanzar incorrectamente un error de campo obligatorio al finalizar la compra.
4.11.3
- Corregido el campo NIF/CIF/NIE en la edición de direcciones de Mi cuenta cuando la página de cuenta se muestra con el shortcode
[woocommerce_my_account]en tiendas que usan el Bloque de Finalizar compra.
4.11.2
- Corregida la carga del NIF en la administración del pedido y en las direcciones formateadas para pedidos creados con el Bloque de Finalizar compra, leyendo primero
billing_nifyshipping_nify manteniendo compatibilidad con metas heredadas.
4.11.1
- Corregido
requerido_envioen el checkout clásico para que el campo NIF/CIF/NIE de envío sólo sea obligatorio cuando el cliente marque «Enviar a una dirección diferente».
4.11.0
- Añadido el filtro
apg_nif_skip_requiredpara anular por hook la obligatoriedad del campo en facturación o envío.
4.10.0
- Añadido soporte para la validación de
Codice Fiscaleitaliano. - Corregida la detección de prefijos internacionales para no tratar letras iniciales no ISO como prefijos de país.
- Corregida la inicialización de la validación VIES en el bloque Finalizar compra en
valida-bloques-nif.js.
4.9.1
- Corregida la compatibilidad con la validación del checkout personalizado de FunnelKit Builder al mostrar el campo de envío.
- Arreglos menores.
4.9.0
- Añadida la declaración de compatibilidad con
product_instance_caching. - Mejorada la validación de VIES, EORI y la gestión de la exención de IVA.
4.8.3
- Añadida una nueva opción para ocultar el campo NIF/CIF/NIE del formulario de envío.
- Mejorado el manejo de campos requeridos en facturación y envío en el bloque Finalizar compra.
- Corregida la compatibilidad con Checkout Field Editor (Checkout Manager) for WooCommerce.
- Arreglos menores.
4.8.2
- Arreglos menores.
4.8.1
- Añadido filtro
apg_nif_skip_validation. - Arreglos menores.
4.8.0
- Corregida la validación JavaScript.
4.7.0.6
- Arreglos menores.
4.7.0.5
- Arreglos menores.
4.7.0.4
- Arreglos menores.
4.7.0.3
- Arreglos menores.
4.7.0.2
- Arreglos menores.
4.7.0.1
- Arreglos menores.
4.7
- Adición de botón de descarga de clientes en WooCommerce (Clientes) que incluye el campo NIF/CIF/NIE en el CSV.
- Arreglos menores.
4.6.0.1
- Arreglos menores.
4.6
- Adición de validación de documentos para nuevos países.
- Arreglos menores.
4.5.0.2
- Arreglos menores.
4.5.0.1
- Arreglos menores.
4.5
- Añadidos los phpDocs en el código.
- Corregida la compatibilidad con Checkout Field Editor (Checkout Manager) for WooCommerce.
- Arreglos menores.
4.4.0.1
- Arreglos menores.
4.4
- Corregida la gestión de la excepción del impuesto.
- Arreglos menores.
4.3
- Corregida la gestión de los campos requeridos en las direcciones de Mi cuenta.
- Arreglos menores.
4.2
- Corregida la validación JavaScript.
- Arreglos menores.
4.1.0.1
- Corrección y unificación de usermetas.
4.1
- Añadida comprobación del país de envío en la excepción del impuesto.
- Arreglos menores.
4.0.0.9
- Arreglos menores.
4.0.0.8
- Arreglos menores.
4.0.0.7
- Arreglos menores.
4.0.0.6
- Añadido el campo NIF a la dirección del bloque de Finalizar compra.
4.0.0.5
- Arreglos menores.
4.0.0.4
- Añadida validación en tiempo real.
- Mejora de la seguridad.
- Arreglos menores.
4.0.0.3
- Arreglos menores.
4.0.0.2
- Arreglos menores.
4.0.0.1
- Arreglos menores.
4.0
- Añadida compatibilidad completa de la validación VIES y EORI al Bloque de Finalizar compra.
- Mejora de rendimiento general.
- Adecuación completa del código a los estándares de seguridad marcadas por WordPress.
- Adición de validación de documentos para nuevos países.
- Arreglos menores.
3.2.0.1
- Pequeños arreglos.
3.2
- Añadido filtro
apg_nif_add_fields. - Mejora de la validación.
3.1.0.2
- Pequeños arreglos.
3.1.0.1
- Pequeños arreglos.
3.1
- Mejora de la seguridad.
- Mejora el proceso de validación internacional.
- Pequeños arreglos.
3.0.15
- Pequeños arreglos.
3.0.14
- Pequeños arreglos.
3.0.13
- Pequeños arreglos.
3.0.12
- Pequeños arreglos.
3.0.11
- Pequeños arreglos.
3.0.10
- Limita funcionalidades al bloque Finalizar compra.
3.0.9
- Pequeños arreglos.
3.0.8
- Pequeños arreglos.
3.0.7
- Pequeños arreglos.
3.0.6
- Pequeños arreglos.
3.0.5
- Pequeños arreglos.
3.0.4
- Mejora de la compatibilidad con plugins de terceros.
3.0.3
- Mejora de la compatibilidad con plugins de terceros.
3.0.2
- Pequeños arreglos.
3.0.1
- Corregido un error que afecta a versiones anteriores a WooCommerce 8.9.
3.0
- Añade soporte al bloque Finalizar compra.
- Mejora de la compatibilidad con plugins de terceros.
2.1.0.2
- Pequeños arreglos.
2.1.0.1
- Pequeños arreglos.
2.1
- Añadido soporte para HPOS.
2.0.1
- Pequeños arreglos.
2.0
- Añadida opción de validación del número EORI Actualización patrocinada por OldWood – Ground, Oil Varnishes & Natural Colours.
- Añadida opción de selección de prioridad del campo NIF/CIF/NIE.
- Añadidos dos filtros para mostrar y personalizar un mensaje de error para el formulario de facturación:
apg_nif_display_error_messageyapg_nif_error_message. - Actualización de captura de pantalla.
1.7.4.1
- Actualización de cabecera.
- Actualización de hoja de estilo.
- Actualización de captura de pantalla.
1.7.4
- Valida el formulario de envío sólo si se ha activado.
- Valida el número VIES sólo para los países soportados.
1.7.3.1
- Indica el formulario correspondiente en la validación del campo.
1.7.3
- * Añade el campo NIF/CIF/NIE en la búsqueda de pedidos.
1.7.2.6
- Pequeños arreglos.
1.7.2.5
- Pequeños arreglos.
1.7.2.4
- Pequeños arreglos.
1.7.2.3
- * Añadida compatibilidad con Polylang.
1.7.2.2
- Pequeños arreglos.
1.7.2.1
- Pequeños arreglos.
1.7.2
- Arreglo de la validación VIES para Grecia e Irlanda.
1.7.1
- Ajuste para hacer compatible la nueva opción con WooCommerce PDF Invoices & Packing Slips.
1.7
- Ahora puedes quitar los campos teléfono y correo electrónico de la dirección predeterminada.
1.6
- Mensajes de error personalizables y traducibles con WPML.
- Pequeños arreglos.
1.5.1
- Adición de la exclusión de impuestos en los gastos de envío.
1.5
- Eliminada la exención de impuestos en los costes de envío.
- Añadidos los campos de teléfono y correo electrónico en las direcciones internacionales.
- Pequeños arreglos.
1.4.2
- Eliminados el teléfono y la dirección de correo electrónico duplicados en la página de agradecimiento.
1.4.1
- Nombre de campo de texto traducible con WPML.
1.4.0.2
- Actualización de la plantilla de cuentas de correo electrónico.
- Pequeños arreglos.
1.4.0.1
- Pequeños arreglos.
1.4
- Añadida personalización de la etiqueta y marcador de posición del campo.
- Actualización de captura de pantalla.
1.3.0.2
- Pequeños arreglos.
- Quitados todos los cambios del orden de campos.
1.3.0.1
- Pequeños arreglos.
1.3
- Añadidos los campos en WooCommerce PDF Invoices & Packing Slips para facturas con direcciones fuera de España.
1.2.1.3
- Pequeños arreglos.
1.2.1.2
- Añadido mensaje de error y desactivación cuando la clase PHP SoapClient no existe.
1.2.1.1
- Añadida compatibilidad con WooCommerce 3.4.
1.2.1
- Pequeños arreglos.
1.2.0.4
- Eliminación de doble teléfono y dirección de correo electrónico en el correo electrónico de pedido.
- Arreglo de la validación del número CIF.
1.2.0.3
- Eliminación de doble teléfono y dirección de correo electrónico en el correo electrónico de pedido.
1.2.0.2
- Actualización de cabecera.
- Actualización de hoja de estilo.
- Actualización de captura de pantalla.
1.2.0.1
- Arreglo de la validación del número CIF.
1.2
- Evita la validación del campo NIF/CIF/NIE fuera de España.
- Arreglos menores.
1.1.0.6
- Mostrar el campo de correo electrónico en los pedidos creados manualmente en WooCommerce 3.x.
- Impedir la validación del NIF/CIF/NIE con la validación del número VIES seleccionada.
1.1.0.5
- Nombre de campo de texto traducible.
1.1.0.4
- Mejora del rendimiento.
1.1.0.3
- Arreglo de localización.
1.1.0.2
- Mejora de la validación del número VIES.
1.1.0.1
- Internacionalización de la validación del número VIES.
1.1
- Añadida opción de validación del número VIES.
1.0.1.3
- Ajuste para optimizar la compatibilidad con WooCommerce 3.0.
1.0.1.2
- Soporte para instalaciones multisitio.
1.0.1.1
- Muestra todos los campos en los clientes no registrados.
1.0.1
- Arreglo del formato de direcciones en los correos electrónicos.
- Arreglo de traducciones faltantes en español.
1.0
- Muestra el campo correo en los pedidos creados manualmente.
- Muestra el correo electrónico en los datos de cliente.
- Eliminadas todas las clases personalizadas de los campos para mejorar la compatibilidad universal con las plantillas.
- Estructura interna del plugin totalmente reescrita para facilitar su mantenimiento.
0.3
- Carga del valor del campo NIF/CIF/NIE en los pedidos creados manualmente.
0.2
- Añadidas nuevas opciones de configuración.
- Actualización de traducción.
- Actualización de captura de pantalla.
0.1
- Versión inicial.
