Guía de Usuario: Woo Reciplus Connector

¿Qué hace este plugin?

Woo Reciplus Connector sincroniza automáticamente tus pedidos de WooCommerce con Reciplus (FacturaScripts). Cuando un cliente realiza una compra en tu tienda online, el plugin crea automáticamente la factura correspondiente en tu sistema de gestión, asociándola al cliente correcto (existente o nuevo).

Requisitos previos (IMPORTANTE)

Antes de configurar el plugin, debes solicitar a tu técnico de Recipok que prepare la integración:
  1. Habilitar la API de Reciplus: Tu técnico debe activar el acceso API en tu instalación de Reciplus/FacturaScripts
  2. Solicitar los datos de conexión: Deberás pedirle que te proporcione:
    • URL de la API: Normalmente tiene este formato: https://tudominio.com/api/3 (tu técnico te dará la exacta)
    • Token de acceso: Una clave de seguridad única para tu tienda (larga cadena de texto)
⚠️ Nota: Sin estos datos proporcionados por el técnico de Recipok, el plugin no podrá funcionar.

Configuración inicial

Una vez tengas los datos de tu técnico:
  1. Ve a Ajustes > Reciplus en el menú de WordPress
  2. Completa los campos:
    • URL API: Pega la dirección que te dio tu técnico (ej: https://plus.recipok.com/demo/api/3)
    • API Token: Pega la clave de seguridad proporcionada
    • Serie Facturas: Indica la serie por defecto para las facturas online (ej: «A» o «Web»)
  3. Marca la opción «Creación automática» si quieres que se generen las facturas automáticamente al recibir el pago
  4. Guarda los cambios

Cómo funciona

Modo Automático (recomendado)
  • Cuando un pedido pasa a estado «Procesando» o «Completado», el plugin crea automáticamente la factura en Reciplus
  • Si el cliente es nuevo, lo da de alta automáticamente con los datos del pedido (nombre, email, dirección, teléfono)
  • Si el cliente ya existe (mismo email), asocia la factura a su ficha existente
  • En el pedido de WooCommerce verás una nota confirmando la creación con el número de factura
Modo Manual
  • Si desactivas la creación automática, puedes generar facturas individualmente
  • Dentro de cada pedido de WooCommerce verás una caja lateral llamada «Reciplus»
  • Pulsa «Sincronizar ahora» cuando quieras generar la factura de ese pedido específico

Verificación del funcionamiento

Para comprobar que todo funciona correctamente:
  1. Realiza una compra de prueba en tu tienda (puedes usar el modo «Transferencia bancaria» para no procesar pagos reales)
  2. Marca el pedido como «Procesando» o «Completado»
  3. Entra en el pedido de WooCommerce: deberías ver una nota diciendo «Factura XXXX creada en Reciplus»
  4. Accede a tu Reciplus y verifica que aparezca la factura en Ventas > Facturas, asociada al cliente correcto

Solución de problemas comunes

«Error: Pedido sin email»
  • El cliente no completó el email en el checkout. Esto es raro, pero el plugin no puede crear clientes sin email.
«Error creando cliente» o «HTTP 400»
  • Verifica que la URL y el Token sean correctos (copia y pega exactamente como te los dio el técnico, sin espacios)
  • Contacta con tu técnico de Recipok para verificar que la API esté activa y el token no haya expirado
La factura no aparece en Reciplus
  • Revisa en el pedido de WooCommerce la pestaña «Reciplus» (caja lateral derecha) para ver el mensaje de error específico
  • Comprueba que el cliente tenga email válido y los productos tengan precio mayor a 0
¿Necesitas ayuda técnica? Si tras revisar esta guía el plugin no funciona correctamente, contacta con tu técnico de Recipok y proporciónele:
  • El mensaje de error exacto que aparece en el pedido
  • La URL de tu tienda WooCommerce
  • Confirmación de que has introducido correctamente la URL de la API y el Token

Desarrollado por: Recipok
Soporte: soporte@recipok.com

Aviso mantenimiento servidores

Hoy (19/11/2025) estaremos realizando trabajos en los servidores de la aplicación de Recipok.

Puede haber cortes o interrupciones durante las próximas horas.
Recomendamos evitar acciones muy largas o, si es posible, esperar hasta mañana.

Gracias por tu comprensión