Instalar WooCommerce

Requisitos previos

Antes de iniciar la instalación, asegúrese de que:

• Su WordPress esté actualizado (se recomienda la versión 5.8+)
• WooCommerce esté instalado y activo (se recomienda la versión 6.0+)
• Tenga acceso al back office de WordPress con permisos de administrador
• Su sitio sea accesible a través de HTTPS

Generar claves de API de WooCommerce

Para utilizar la REST API de WooCommerce con Order Invoicer, necesita generar claves de API seguras.

1. Acceder a la configuración de la API

1. Inicie sesión en el back office de WordPress
2. Navegue a WooCommerce > Settings
3. Haga clic en la pestaña Advanced
4. Vaya a la sección REST API

2. Crear una nueva clave de API

1. Haga clic en Add key para crear una nueva clave de API
2. Configure la clave con los siguientes ajustes:

Configuración básica

• Description: Añada una descripción clara (p. ej. "Order Invoicer - Sellsy Integration")
• User: Seleccione un usuario administrador o un usuario con permisos suficientes
• Permissions: en el menú desplegable Permissions, seleccione Read/Write. Este nivel es obligatorio — no seleccione "Read", o la conexión no funcionará.

Por qué debe elegir "Read/Write"

WooCommerce le permite elegir un único nivel de permiso para la clave: Read, Write o Read/Write. No puede autorizar solo ciertos datos — es un único ajuste que lo cubre todo. Elija siempre Read/Write.

Order Invoicer lee lo siguiente de su tienda para crear sus facturas:

• Sus pedidos
• Sus clientes
• Sus productos
• Sus impuestos

Order Invoicer también necesita enviar algunos datos de vuelta a su tienda, por lo que una clave "Read" (solo lectura) no es suficiente:

• Recoge sus nuevos pedidos automáticamente, para que nunca tenga que importarlos a mano
• Marca un pedido como pagado en WooCommerce una vez confirmado el pago
• Mantiene sus productos y niveles de stock actualizados, si ha activado la sincronización de productos y stock

Importante: si elige "Read" en lugar de "Read/Write", la conexión fallará. Asegúrese de seleccionar Read/Write.

3. Haga clic en Generate API key

3. Recuperar la información de conexión

Después de generar la clave, anote inmediatamente la siguiente información:

• La URL de su tienda: https://your-store.com
• Consumer Key: La clave pública generada
• Consumer Secret: La clave privada generada

Importante:

• Conserve esta información de forma segura
• La clave secreta ya no será visible después de cerrar esta página
• La necesitará para configurar el conector en Order Invoicer

4. Verificar la configuración

Probar la API

Para comprobar que su configuración funciona:

1. Pruebe el acceso a la API: https://your-store.com/wp-json/wc/v3/
2. Debería ver una página JSON con la información de la API
3. Si obtiene un error, compruebe que:
   • WooCommerce está activo
   • Su sitio es accesible
   • Los permisos están configurados correctamente

Probar con las claves

Puede probar el acceso con sus claves utilizando una herramienta como cURL:

curl -X GET "https://your-store.com/wp-json/wc/v3/orders" \
  -H "Authorization: Basic [your-base64-encoded-key]"

Resolución de problemas comunes

Errores de configuración

Error "WooCommerce not active"

• Compruebe que WooCommerce esté instalado y activo
• Compruebe que está utilizando la versión correcta de WooCommerce

Error "Invalid API keys"

• Compruebe que ha copiado las claves completas
• Asegúrese de que la clave esté activa
• Compruebe los permisos concedidos al usuario

Error "Access denied"

• Compruebe que la URL de su tienda es correcta
• Asegúrese de que su sitio es accesible a través de HTTPS
• Compruebe que el usuario tiene permisos suficientes

Error "API not accessible"

• Compruebe que los enlaces permanentes (permalinks) de WordPress están configurados
• Desactive temporalmente los plugins de seguridad
• Compruebe la configuración del servidor web

Plugins incompatibles

WooCommerce Price Based on Country (WCPBC)

Si utiliza el plugin Price Based on Country for WooCommerce (versión Pro), debe desactivar la opción "Round to Nearest" en la configuración de sus zonas de precios.

Esta opción redondea los precios convertidos por el tipo de cambio para obtener precios más "elegantes" (por ejemplo, redondear al 0,50 CHF más cercano). Esto genera discrepancias entre los importes reales del pedido de WooCommerce y los importes calculados por Order Invoicer, lo que puede provocar diferencias en las facturas generadas.

Cómo desactivarla

1. Vaya a WooCommerce → Settings → Zone Pricing → Zones
2. Sitúe el cursor sobre el nombre de la zona correspondiente y haga clic en Edit
3. Localice el campo "Round to Nearest"
4. Vacíe el campo (déjelo en blanco)
5. Haga clic en Save changes
6. Repita para cada zona de precios

Importante: Los valores que ofrece el plugin (500, 50, 5, 0,50, 0,05) modifican los precios unitarios. Esto provoca incoherencias entre el importe facturado por WooCommerce y el importe recalculado por Order Invoicer.

Configuración avanzada

Modo multitienda

Si utiliza WooCommerce en modo multitienda:

1. Cree una clave de API para cada tienda
2. Configure cada conector con las claves correctas
3. Compruebe los permisos de cada tienda

Personalización de campos

Order Invoicer puede recuperar campos personalizados:

1. Asegúrese de que sus campos personalizados sean visibles a través de la API
2. Configure las asignaciones (mappings) en Order Invoicer si es necesario
3. Pruebe la recuperación de los datos personalizados

Soporte

Si tiene dificultades:

1. Consulte la sección de resolución de problemas anterior
2. Consulte la documentación oficial de WooCommerce
3. Póngase en contacto con nuestro soporte: contact@orderinvoicer.com

Nota: Una vez completada esta configuración, puede pasar al siguiente paso: configurar el conector en Order Invoicer.