📘 Guía de configuración – Woo ⬌ WHMCS Connector

Este instructivo explica cómo configurar el plugin que conecta WooCommerce con WHMCS, para que cada compra en tu tienda se registre automáticamente como cliente y orden en tu sistema de gestión.

⚙️ 1. Requisitos previos #

Antes de comenzar, asegurate de tener:

• WordPress con WooCommerce activo.
• Una instalación de WHMCS accesible por HTTPS.
• Acceso de administrador a ambos sistemas.
• Credenciales API en WHMCS.

🔑 2. Crear credenciales API en WHMCS #

1. Ingresá en WHMCS como administrador.
2. Ir a Configuración → Seguridad → Administrar API Credentials.
3. Crear un nuevo par de credenciales:
   • Identificador (Identifier)
   • Clave secreta (Secret)
4. Autorizar la IP de tu servidor de WordPress en la whitelist de la API. ⚠️ Si no autorizás la IP, el plugin devolverá el error Invalid IP.

🔗 3. Configuración del plugin en WordPress #

1. En WordPress, ir a Ajustes → WHMCS Connector.
2. Completar los campos:
   • API URL → https://tudominio.com/whmcs/includes/api.php
   • API Identifier → (dato de WHMCS)
   • API Secret → (dato de WHMCS)
3. Guardar cambios.
4. Usar el botón de Probar conexión para confirmar que todo está OK.

📦 4. Mapeo de productos #

El plugin necesita saber qué producto de Woo corresponde a qué producto en WHMCS.

1. Ir a la pestaña Mapeo de Productos en el admin del plugin.
2. Para cada producto de WooCommerce, ingresar el ID del producto (PID) de WHMCS.
   • Podés ver el PID en la URL del producto en WHMCS: https://clientes.tudominio.com/admin/configproducts.php?action=edit&id=145 👉 En este caso, el PID es 145.
3. Guardar el mapeo.

🧾 5. Configuración de campos fiscales #

El plugin añade en el checkout de Woo los campos que WHMCS requiere para facturación:

• Tipo de Persona (Física / Jurídica)
• CUIT / CUIL
• Posición IVA (Consumidor Final, Responsable Monotributo, Responsable Inscripto, Exento, Otros)
• Jurisdicción

⚠️ Son obligatorios. Si no se completan, WHMCS rechazará la creación del cliente.

🔄 6. Flujo de funcionamiento #

1. El cliente compra un producto en Woo.
2. Al completarse el pedido:
   • Se busca al cliente en WHMCS por email.
   • Si no existe → se crea con los datos fiscales incluidos.
   • Si existe → se actualizan sus datos.
3. Se crea una orden en WHMCS con el producto mapeado.
4. La orden se marca como aceptada automáticamente.

📜 7. Logs de depuración #

El plugin registra todos los eventos en:

/wp-content/wwc-log.txt

Ahí vas a encontrar:

• Datos fiscales recibidos desde Woo.
• Payloads enviados a WHMCS.
• Respuestas de WHMCS.
• Errores de conexión o validación.

✅ 8. Recomendaciones #

• Probar siempre con un pedido de test antes de pasar a producción.
• Revisar que los valores de IVA en Woo coincidan con los de WHMCS.
• Mapear todos los productos antes de lanzar la tienda.
• Mantener activo el log mientras se hacen pruebas, luego se puede limpiar.