Cuentica Connector

Quiero recibir información sobre este plugin

Conecta WooCommerce con Cuéntica para crear facturas automáticamente cuando un pedido se completa.

== Description ==

Cuentica Connector for WooCommerce es la solución definitiva para integrar tu tienda de WooCommerce con tu cuenta de Cuéntica.

Este plugin automatiza la creación de facturas. Cuando un pedido de WooCommerce se marca como «Completado», el plugin se conecta automáticamente a la API de Cuéntica, crea o actualiza al cliente, y genera la factura correspondiente (ya sea como borrador o emitida), ahorrándote horas de trabajo manual.

= Características Principales =

Creación Automática de Facturas: Los pedidos completados generan una factura en Cuéntica con todas las líneas de producto, envíos, tasas y descuentos.
Sincronización de Etiquetas: Las «Etiquetas de Producto» de WooCommerce se añaden automáticamente a la factura en Cuéntica para facilitar la clasificación.
Personalización Avanzada: Configura el formato del título de la factura con variables dinámicas y añade descripciones extra (usuario, mes, año) a líneas de producto específicas, ideal para suscripciones.
Avisos de Reembolso: Cuando realizas un reembolso en WooCommerce, el plugin envía automáticamente un aviso por email al administrador con todos los detalles necesarios para generar la factura rectificativa en Cuéntica manualmente.
Gestión de Clientes Inteligente: Busca a los clientes por su NIF/CIF (tax_id) para evitar duplicados. Si el cliente no existe, lo crea automáticamente.
Campos de Facturación Obligatorios: Añade los campos «Tipo de Cliente» (Particular, Empresa) y «NIF/CIF» al formulario de pago de WooCommerce para asegurar el cumplimiento fiscal.
Manejo de Impuestos Avanzado:
- Detecta automáticamente si la venta es «fuera de España» y aplica el código de exención N2 (No sujeta por localización).
- Permite seleccionar el motivo de exención de IVA (ej. E1, E5…) directamente en la página del producto para artículos con 0% de IVA.
Panel de Configuración Integrado: Todos los ajustes se encuentran en WooCommerce > Ajustes > Cuentica.
Opciones Flexibles: Configura tu API Token, selecciona la cuenta bancaria de destino para cada método de pago (cargada automáticamente desde tu API) y elige si las facturas deben emitirse directamente o guardarse como borrador.
Anotaciones y Etiquetas: Añade automáticamente los detalles del pago (ej. «Tarjeta de Crédito») y las notas del cliente a la factura de Cuéntica. Etiqueta las facturas con «WooCommerce», el método de pago (ej. «stripe») y el nombre del sitio web.
Registro de Errores Centralizado: Todos los errores se registran en WooCommerce > Estado > Registros para una depuración fácil y centralizada.

== Installation ==

Sube la carpeta cuentica-connector al directorio /wp-content/plugins/ de tu WordPress.
Activa el plugin a través del menú ‘Plugins’ en WordPress.
Ve a WooCommerce > Ajustes > Cuentica.
Introduce tu API Token de Cuéntica.
Pulsa «Verificar Conexión de API» para asegurarte de que funciona.
Introduce el «Email para Avisos (Admin)» donde recibirás las notificaciones de reembolso.
En la sección «Mapeo de Cuentas de Destino», selecciona la cuenta de Cuéntica para cada método de pago.
Configura las opciones de «Emitir Factura», «Enviar Email al Cliente» y las nuevas opciones de personalización de título según tus preferencias.
¡Guarda los cambios y ya está listo!

== Frequently Asked Questions ==

= ¿Qué campos añade al checkout? =

El plugin añade los campos obligatorios «Tipo de Cliente» (Particular, Empresa, Otros) y «NIF / CIF» al formulario de pago, ya que son necesarios para crear la factura en Cuéntica.

= ¿Qué pasa si la factura falla? =

Si la creación de la factura falla (por ejemplo, por un NIF incorrecto o un error de la API), el plugin no se rompe. Añade una nota privada al pedido con el error exacto y lo registra en WooCommerce > Estado > Registros (buscando el log cuentica-connector) para que puedas revisarlo.

= ¿Cómo maneja los impuestos exentos (0% IVA)? =

El plugin es inteligente.

Si un producto tiene 0% IVA («Ninguno» o «Zero Rate»), puedes seleccionar el motivo de exención (E1, E2, N2…) en la página de edición del producto.
Si la venta es internacional, el plugin aplica automáticamente N2 (No sujeta por localización).

= ¿Cómo funcionan los reembolsos? =

Cuando realizas un reembolso en WooCommerce, el plugin enviará un email a la dirección configurada con los datos del pedido, el importe devuelto y el enlace directo. Debes entrar en Cuéntica y generar la factura rectificativa manualmente para asegurar la integridad de tus datos contables.

== Screenshots ==

Página de ajustes del plugin en WooCommerce, mostrando el mapeo de cuentas de pago.
Campos «Tipo de Cliente» y «NIF/CIF» añadidos al checkout.
Campos «NIF/CIF» y «Tipo de Cliente» en la página «Mi Cuenta > Direcciones» del usuario.
Nuevo desplegable en la página de edición del producto para impuestos exentos.
Registro de errores en WooCommerce > Estado > Registros.

Página de ajustes del plugin en WooCommerce, mostrando el mapeo de cuentas de pago.

Campos «Tipo de Cliente» y «NIF/CIF» añadidos al checkout.

Campos «NIF/CIF» y «Tipo de Cliente» en la página «Mi Cuenta > Direcciones» del usuario.

Nuevo desplegable en la página de edición del producto para impuestos exentos.

Registro de errores en WooCommerce > Estado > Registros.

== Changelog ==

= 3.2.0 =

MEJORA: Implementada sincronización inteligente de clientes. Ahora, si un cliente existente en Cuéntica (buscado por NIF) tiene datos diferentes a los del pedido actual (dirección, email, nombre…), el plugin actualizará la ficha del cliente en Cuéntica antes de generar la factura.

= 3.1.0 =

NUEVO: Ahora las Etiquetas de Producto de WooCommerce se añaden automáticamente como etiquetas (tags) a la factura generada en Cuéntica.

= 3.0.1 =

NUEVO: Añadida la variable {user_name} (Usuario de WordPress) a las opciones de personalización del título de factura.
CORRECCIÓN: Solucionado un error que ocultaba el botón de ‘Guardar Cambios’ en la página de ajustes.

= 3.0.0 =

NUEVO: Opciones avanzadas para personalizar el título de la factura con variables (ej: {order_number}, {order_date}).
NUEVO: Opción para añadir descripciones extra (Nombre Usuario, Mes/Año) a productos o suscripciones específicas.

= 2.9.6 =

NUEVO: Añadido hook para permitir la modificación externa de los datos de la factura antes de enviarla a la API (necesario para Add-ons como Centros de Coste).

= 2.9.5 =

CORRECCIÓN: Se ha actualizado la URL del logotipo de Cuéntica para cargarla desde un servidor propio y evitar errores de carga (CORS/Hotlinking).

= 2.9.4 =

MEJORA: Se ha añadido el logotipo oficial de Cuéntica a la página de configuración para mejorar la identidad visual del plugin.

= 2.9.3 =

ESTILO: Se ha personalizado la página de ajustes del plugin con los colores corporativos de Cuéntica (#018FAD) para una mejor integración visual.

= 2.9.2 =

MEJORA: El correo electrónico de aviso de reembolso ahora muestra el importe limpio (sin etiquetas HTML) y con un formato más profesional y fácil de leer.

= 2.9.1 =

CORRECCIÓN: Solucionado un error visual que mostraba «Selecciona un tipo…» en las direcciones de facturación de los emails transaccionales de WooCommerce. Ahora muestra el NIF correctamente o nada si el campo está vacío.

= 2.9.0 =

CAMBIO: Se ha sustituido la creación automática de rectificativas vía API (que causaba errores de validación) por un sistema de notificación por email al administrador.
NUEVA FUNCIÓN: Campo «Email para Avisos (Admin)» en los ajustes.
MEJORA: Al realizar un reembolso, se envía un email con los detalles necesarios para crear la rectificativa manualmente.

= 2.8.1 =

CORRECCIÓN: Se ha aumentado la precisión de los importes unitarios enviados a la API (de 2 a 6 decimales) para evitar errores de redondeo («got X, expected Y»).

= 2.8.0 =

(Revertido en 2.9.0) Intento de soporte para reembolsos automáticos.

= 2.7.1 =

CORRECCIÓN: Solucionado un error en la lógica que muestra el NIF/CIF en las direcciones formateadas (tanto en admin como en frontend).

= 2.7.0 =

NUEVA FUNCIÓN: Añadidos campos de edición de «Tipo de Cliente» y «NIF/CIF» dentro de la pantalla de edición del pedido en el admin (sección Facturación), permitiendo corregir datos antes de reintentar una factura.

= 2.6.0 =

MEJORA: La fecha de la factura en Cuéntica ahora es la fecha en que el pedido se marca como ‘Completado’, en lugar de la fecha de creación del pedido.
ELIMINADO: Se ha eliminado la pestaña ‘Registro de Errores’ (que causaba un Error Crítico de PHP con los reembolsos). Los errores ahora se deben consultar en ‘WooCommerce > Estado > Registros’.

= 2.5.0 =

NUEVA FUNCIÓN: Las facturas creadas en Cuéntica ahora incluyen el ‘Detalle del cargo’ (método de pago) y las ‘Notas del cliente’ en el campo ‘Anotaciones’.
MEJORA: Las facturas ahora se etiquetan automáticamente en Cuéntica con ‘WooCommerce’, el ID del método de pago (ej: ‘stripe’) y el nombre del sitio web.

= 2.4.0 =

MEJORA: No se generarán facturas para pedidos con un importe total de 0€.

= 2.3.0 =

NUEVA FUNCIÓN: Mapeo de Cuentas de Destino. Ahora puedes asignar una cuenta de Cuéntica diferente (ej. ‘Banco’, ‘PayPal’, ‘Caja’) a cada método de pago de WooCommerce (ej. ‘Stripe’, ‘PayPal’, ‘Contra reembolso’).
MEJORA: La página de ajustes ahora lista dinámicamente todos tus métodos de pago activos y todas tus cuentas de Cuéntica.

= 2.2.3 =

CORRECCIÓN: Arreglado un error por el que los campos NIF/CIF y Tipo de Cliente no se mostraban en la vista principal de ‘Mi Cuenta > Direcciones’.

= 2.2.2 =

MEJORA: Los campos NIF/CIF y Tipo de Cliente ahora se pueden ver y editar desde el Perfil de Usuario en el panel de administración de WordPress.

= 2.2.1 =

CORRECCIÓN: Arreglado un Error Crítico de PHP al cargar el actualizador (error tipográfico ‘PacFactory’).

= 2.2.0 =

NUEVA FUNCIÓN: Los campos NIF/CIF y Tipo de Cliente ahora se guardan en el perfil del usuario.
MEJORA: Los campos NIF/CIF y Tipo de Cliente ahora se pre-rellenan en el checkout si el usuario ha iniciado sesión.
NUEVA FUNCIÓN: Los usuarios ahora pueden ver y editar su NIF/CIF y Tipo de Cliente desde la página ‘Mi Cuenta > Detalles de la cuenta’.

= 2.1.4 =

CORRECCIÓN: Se declara la compatibilidad con el Almacenamiento de pedidos de alto rendimiento (HPOS) de WooCommerce.
CORRECCIÓN: Se corrige la pestaña ‘Registro de Errores’ para que sea compatible con HPOS.

= 2.1.3 =

CORRECCIÓN: Arreglado un error crítico por el que los campos NIF/CIF y Tipo de Cliente no se guardaban al finalizar el pedido.

= 2.1.2 =

CORRECCIÓN: Arreglado un Error Crítico de PHP que ocurría después de la actualización a v2.1 (los nombres de los archivos y las clases no coincidían).

= 2.1.1 =

CORRECCIÓN: Arreglado un Error Crítico de PHP al llamar a la biblioteca del actualizador (Puc_v5_Factory).

= 2.1.0 =

¡RENOMBRADO! El plugin ahora se llama ‘Cuentica Connector for WooCommerce’.
REFACTORIZACIÓN: Se han renombrado todas las funciones, clases, constantes y claves de opciones (de wcl_ a cwc_) para evitar colisiones y seguir las buenas prácticas.
IMPORTANTE: Se elimina el sistema de actualizaciones automáticas (plugin-update-checker) para cumplir con las directrices del repositorio oficial de WordPress.org.

= 2.0.0 =

MEJORA MAYOR: La búsqueda de clientes ahora se basa exclusivamente en el NIF/CIF (tax_id).
ELIMINADO: Se ha eliminado la lógica de «fallback» que intentaba buscar por email si el NIF no se encontraba.

= 1.0.0 =

Versión inicial del plugin.

== Upgrade Notice ==

= 2.9.6 =
Actualización necesaria para soportar el Add-on de Centros de Coste.