FacturaDirecta

Esta es la documentación para el Plugin Connect Ecommerce FacturaDirecta.

Guía de Instalación y Configuración — Connect Ecommerce FacturaDirecta

Requisitos previos

Antes de instalar el plugin, asegúrate de cumplir los siguientes requisitos:

Requisito	Versión mínima
WordPress	5.0 o superior
WooCommerce	5.0 o superior
PHP	7.4 o superior
Plugin base	Connect and EU VAT Compliance for WooCommerce (woocommerce-es)

Importante: Este plugin es un conector que depende del plugin base Connect and EU VAT Compliance for WooCommerce. WordPress te guiará para que lo instales y actives antes de instalar este conector.

---

Instalación

Subir el plugin desde el panel de WordPress

1. Compra el plugin de Conexión con FacturaDirecta.
2. Descárga el ZIP y ve a Plugins > Añadir nuevo > Subir plugin.
3. Haz clic en Seleccionar archivo y selecciona el archivo .zip del plugin.
4. Haz clic en Instalar ahora.
5. Una vez instalado, haz clic en Activar plugin.

Cómo obtener las credenciales de la API de FacturaDirecta

El plugin se comunica con FacturaDirecta mediante su API REST. Necesitas dos datos: el ID de empresa y la clave de API.

Paso 1 — Accede a tu cuenta de FacturaDirecta

1. Inicia sesión en tu cuenta en app.facturadirecta.com.

Paso 2 — Accede a la configuración de la API

1. En el menú lateral, ve a Configuración (icono de engranaje).
2. Busca el apartado API o Integraciones.
3. Verás tu Clave de API (API Key). Cópiala y guárdala en un lugar seguro.

Paso 3 — Localiza el ID de empresa

El ID de empresa es el identificador de tu organización en FacturaDirecta. Lo encontrarás en:

• La URL de tu cuenta: https://app.facturadirecta.com/app/{ID_EMPRESA}/...
• En el apartado Configuración > Mi empresa.

La autenticación utiliza la cabecera HTTP facturadirecta-api-key con tu clave de API. No es necesario que gestiones esta cabecera manualmente — el plugin lo hace de forma automática usando los datos que configures.

---

Configuración del plugin

Una vez instalado y activado el plugin, ve a WooCommerce > Connect Ecommerce > FacturaDirecta para configurarlo.

Campos de configuración

Campo	Descripción
ID de empresa (company)	El identificador de tu organización en FacturaDirecta.
Clave de API (apipassword)	La API Key generada en tu cuenta de FacturaDirecta.
Tipo de documento (doctype)	El tipo de documento que se creará al exportar pedidos: invoice (factura), estimate (presupuesto) o deliveryNote (albarán).
Aprobar documento (approve_document)	Si está activado, los documentos se aprueban automáticamente al crearse.

Verificar la conexión

Después de guardar la configuración, el plugin realiza una comprobación de conexión con el endpoint settings/themes de la API. Si la conexión es correcta, verás un mensaje de confirmación. Si falla, revisa el ID de empresa y la clave de API.

---

Funcionalidades disponibles

Importación de productos

El plugin importa productos desde FacturaDirecta a WooCommerce:

• Importa hasta 500 productos por lote para optimizar el rendimiento.
• Sincroniza precios con y sin IVA incluido.
• Actualiza el stock de forma automática.
• Utiliza el SKU como referencia para evitar duplicados.

Envío de pedidos

Cuando se completa un pedido en WooCommerce, el plugin puede exportarlo automáticamente a FacturaDirecta:

• Crea el tipo de documento configurado (factura, presupuesto o albarán).
• Resuelve o crea el contacto en FacturaDirecta mediante una búsqueda en tres pasos:

1. Búsqueda por NIF/CIF fiscal.
2. Búsqueda por correo electrónico.
3. Creación de nuevo contacto si no existe.

• Aplica automáticamente los tipos de IVA españoles según el pedido:
• IVA 21 % (S_IVA_21)
• IVA 10 % (S_IVA_10)
• IVA 4 % (S_IVA_4)
• IVA 0 % (S_IVA_0)

Series de numeración

Si FacturaDirecta tiene series de numeración configuradas, puedes seleccionar qué serie usar para cada tipo de documento desde los ajustes del plugin.

---

Gestión de la licencia

El plugin incluye un sistema de licencias para gestionar actualizaciones automáticas y el soporte técnico.

1. Ve a WooCommerce > Connect Ecommerce > FacturaDirecta License.
2. Introduce tu clave de licencia adquirida en close.technology.
3. Activa la licencia para recibir:

• Actualizaciones automáticas del plugin.
• Acceso a nuevas funcionalidades.
• Soporte técnico prioritario.
• Parches de seguridad.

---

Preguntas frecuentes

¿El plugin funciona sin el plugin base woocommerce-es?
No. El plugin base es obligatorio. Sin él, el conector no se inicializa correctamente.

¿Dónde encuentro la API Key de FacturaDirecta?
En tu cuenta de FacturaDirecta, en Configuración > API. Si no ves esta opción, contacta con el soporte de FacturaDirecta para habilitarla.

¿Qué pasa si el contacto no existe en FacturaDirecta?
El plugin lo crea automáticamente con los datos del pedido (nombre, email, teléfono, dirección).

¿Puedo usar el plugin con múltiples empresas en FacturaDirecta?
El conector está configurado para una empresa. Para varias empresas necesitarías instancias separadas.

¿Los pedidos gratuitos también se exportan?
Sí, por defecto. Puedes desactivar esta opción desde la configuración avanzada.

Soporte

API FacturaDirecta: facturadirecta.com/api/

Documentación: close.technology/wordpress-plugins/conecta-ecommerce-facturadirecta/

Soporte técnico: close.technology/soporte/

Registro de Cambios

= 1.0.0 =

• Primera versión.