Esta es la documentación para el Plugin Connect Ecommerce Factusol.
Tabla de Contenidos
Guía de Instalación y Configuración — Connect Ecommerce Factusol
Connect Ecommerce Factusol conecta tu tienda WooCommerce con Factusol (Software DELSOL). Permite importar artículos y stock desde Factusol y exportar los pedidos de WooCommerce como albaranes, facturas y cobros.
Requisitos previos
| Requisito | Versión mínima |
|---|---|
| WordPress | 5.0 o superior |
| WooCommerce | 5.0 o superior |
| PHP | 8.0 o superior |
| Plugin base (gratuito) | Connect and EU VAT Compliance for WooCommerce |
| Factusol | Licencia con acceso a la API de Software DELSOL |
Importante: Este plugin es un conector que depende del plugin base Connect and EU VAT Compliance for WooCommerce, que es totalmente gratuito y puedes descargarlo del repositorio oficial de WordPress: es.wordpress.org/plugins/woocommerce-es/. WordPress te guiará para que lo instales y actives antes de instalar este conector.
Nota sobre PHP: este plugin necesita PHP 8.0 o superior. Si no sabes qué versión tiene tu hosting, puedes verlo en Herramientas > Salud del sitio > Información > Servidor. Si tienes una versión anterior, pídele a tu proveedor de hosting que la actualice: es un cambio habitual y gratuito en la mayoría de servicios.
Instalación
- Compra el plugin de Conexión con Factusol.
- Descarga el ZIP y ve a Plugins > Añadir nuevo > Subir plugin.
- Haz clic en Seleccionar archivo y selecciona el archivo
.zipdel plugin. - Haz clic en Instalar ahora y después en Activar plugin.
Cómo obtener las credenciales de la API de Factusol
Para conectar tu tienda con Factusol necesitas cuatro datos:
| Dato | Descripción |
|---|---|
| Código de fabricante | Código numérico que identifica al fabricante en la API de Factusol. |
| Código de cliente | Código numérico de tu licencia de Factusol. |
| Nombre de la base de datos | Nombre de la base de datos de tu empresa en Factusol. |
| API Key | Clave de acceso a la API asociada a tu licencia. |
- Accede a tu cuenta de Factusol.
- Obtén tu API Key y los códigos de fabricante y de cliente. Si no los encuentras o no tienes acceso a la API, contacta con el soporte de Software DELSOL para que la habiliten en tu licencia.
Configuración del plugin
Una vez instalado y activado, ve a WooCommerce > Connect Ecommerce > Factusol para configurarlo.
Campos de conexión
| Campo | Descripción |
|---|---|
| API Key | Clave de acceso a la API de Factusol. |
| Manufacturer Code | Código numérico del fabricante. |
| Customer Code | Código numérico de tu licencia de Factusol. |
| DB Name | Nombre de la base de datos de tu empresa en Factusol. |
Opciones de productos y pedidos
Estas opciones las proporciona el plugin base y están disponibles para el conector de Factusol. Entre paréntesis se indica el nombre tal y como aparece en la pantalla de ajustes:
| Opción | Descripción |
|---|---|
| Obtener los precios con IVA (Get prices with Tax?) | Determina si el precio importado desde Factusol se interpreta con el IVA ya incluido. |
| Tarifa de precios (Product price rate) | Permite indicar la tarifa de precios que se utilizará. |
| Porcentaje de descuento (Percentage to make a discount) | Aplica un porcentaje de descuento sobre el precio y lo guarda como precio rebajado. |
| Sincronizar el stock | Actualiza el stock de WooCommerce con el existente en Factusol. |
| Crear documento en pedidos gratuitos (Create document for free Orders?) | Exporta también los pedidos con importe 0. Activado por defecto en este conector. |
| Estado del pedido para sincronizar (Status to sync Orders?) | Estado de WooCommerce que dispara la exportación. Por defecto Completado. |
| Sincronizar pedidos desde esta fecha (Sync orders from this date?) | Limita la sincronización a los pedidos posteriores a la fecha que indiques. |
| Limpiar caracteres especiales para Verifactu (Clean special characters for Verifactu?) | Elimina los caracteres especiales de los textos que se envían. |
| Modo de depuración (Debug Mode) | Guarda un registro detallado de las operaciones, útil para diagnosticar problemas con el soporte técnico. |
Formas de pago y cuentas de tesorería
El plugin lee automáticamente de tu Factusol las formas de pago que tengas configuradas, así como tus bancos y cajas, que se presentan como una única lista de cuentas de tesorería.
Desde la pantalla de formas de pago del plugin base puedes asociar cada pasarela de pago de WooCommerce (transferencia, tarjeta, contra reembolso…) con una forma de pago y una cuenta de tesorería de Factusol. Así cada pedido se registra en la cuenta que le corresponde.
Verificar la conexión
Al guardar la configuración, el plugin intenta conectarse con Factusol. Si la conexión es correcta verás un mensaje de confirmación. Si falla, el mensaje te indicará que revises el código de fabricante, el código de cliente, el nombre de la base de datos y la API Key.
Importación de productos
El plugin importa los artículos de Factusol a WooCommerce:
- Importa en lotes de 500 artículos para optimizar el rendimiento y evitar cortes por tiempo de espera.
- Utiliza el código de artículo de Factusol como SKU para localizar los productos y evitar duplicados.
- Actualiza el stock con las existencias de Factusol.
- Descarta los códigos de artículo duplicados antes de procesar.
- Tiene en cuenta la fecha de última modificación de cada artículo, lo que permite ver estadísticas de importación y sincronizar solo lo que ha cambiado.
Campos importados
| Campo Factusol | Destino en WooCommerce |
|---|---|
CODART | SKU |
EANART | Código de barras (identificador único global) |
DESART | Nombre del producto |
DEEART | Descripción |
DETART | Descripción corta |
FAMART | Familia |
PCOART | Precio |
TIVART | Tipo de IVA |
STOART | Stock |
PESART | Peso |
FUMART | Fecha de última modificación |
FALART | Fecha de creación |
Envío de pedidos a Factusol
Cuando un pedido alcanza el estado configurado (por defecto Completado), el plugin lo exporta a Factusol siguiendo este proceso:
- Comprueba si el pedido ya existe en Factusol buscando la referencia del pedido de WooCommerce. Si lo encuentra, actualiza el documento en lugar de duplicarlo.
- Localiza o crea el cliente en Factusol.
- Crea el albarán con los datos de facturación del pedido.
- Añade las líneas del albarán con artículo, descripción, cantidad, precio, descuento e IVA. Los gastos de envío se incluyen como una línea más.
- Crea la factura correspondiente con sus líneas.
- Si el pedido está pagado y la pasarela tiene una cuenta de tesorería asociada, registra el cobro.
El número de albarán y de factura se asignan de forma consecutiva a partir del último existente en Factusol. El número resultante se guarda en el pedido de WooCommerce y se añade una nota al pedido con el resultado de la sincronización.
Búsqueda y creación de clientes
- Búsqueda por NIF/CIF.
- Si el pedido no tiene NIF, búsqueda por correo electrónico.
- Si se encuentra, actualiza sus datos con los del pedido.
- Si no existe, crea un cliente nuevo con NIF, nombre fiscal, nombre comercial, dirección, población, código postal, provincia, teléfono, correo electrónico, país y forma de pago.
Reversión automática ante errores
Si algo falla durante la exportación (una línea, la factura, el cobro…), el plugin deshace automáticamente todo lo que había creado y te indica en qué punto se produjo el error.
Esto significa que nunca se queda un pedido a medias en Factusol: o se guarda entero, o no se guarda nada.
Registro de cobros
Si el pedido está pagado y la pasarela de pago tiene una cuenta de tesorería asociada, se registra el cobro en Factusol con:
- Fecha del cobro: la fecha de pago del pedido (o la fecha del documento si no consta).
- Importe: el total del pedido.
- Concepto: referencia al número de pedido de WooCommerce.
- Observaciones: nombre del cliente y referencia del pedido.
- Cuenta de tesorería: el banco o la caja asociados a esa pasarela.
Explorador de datos de Factusol
El plugin añade una pestaña Factusol Data en los ajustes de Connect Ecommerce. Es una herramienta de diagnóstico que te permite ver directamente qué hay en tu Factusol sin salir de WordPress.
| Subpestaña | Contenido |
|---|---|
| Clientes (Customers) | Código, NIF, nombre, correo electrónico y teléfono. |
| Pedidos (Orders) | Los albaranes con sus líneas desplegables. |
| Albaranes (Delivery Notes) | Número, fecha, cliente y total. |
| Facturas (Invoices) | Número, fecha, cliente y total. |
Cómo funciona
- Los datos no se cargan solos: hay que pulsar el botón Cargar datos.
- Muestra los últimos 100 registros, y hasta 1.000 líneas en la vista de pedidos.
- El botón Refrescar vuelve a consultar los datos actualizados de Factusol.
- El botón Ver de un pedido muestra todos sus datos, sus líneas y los datos del cliente asociado.
- El botón Borrar elimina el registro de Factusol. En albaranes y facturas borra también sus líneas.
Atención: el borrado desde el explorador es definitivo. Los datos se eliminan de Factusol y no se pueden recuperar. El plugin te pedirá confirmación antes de hacerlo.
Gestión de la licencia
- Ve a WooCommerce > Connect Ecommerce > Factusol License.
- Introduce tu clave de licencia adquirida en close.technology.
- Activa la licencia para recibir:
- Actualizaciones automáticas del plugin.
- Acceso a nuevas funcionalidades.
- Soporte técnico prioritario.
- Parches de seguridad.
Puedes renovar tu licencia desde tu cuenta en close.technology.
Soporte
Documentación: close.technology/wordpress-plugins/connect-woocommerce-factusol/
Soporte técnico: close.technology/soporte/
Registro de Cambios
= 1.0.0 =
- Primera versión.
