Instalar WordPress en el servidor

Utiliza tu panel de hosting (cPanel, Plesk, etc.) o instala manualmente vía FTP. El servidor debe tener HTTPS activo con un certificado SSL válido antes de continuar — vrsPOS rechaza conexiones no cifradas.

Instalar el plugin vrsPOS Store

Descarga el plugin oficial desde vrspos.com e instálalo en WordPress (Plugins → Añadir nuevo → Subir plugin). Actívalo una vez instalado.

Instalar WooCommerce

Desde el panel de WordPress ve a Plugins → Añadir nuevo, busca “WooCommerce” e instala la versión oficial de Automattic. Completa el asistente de configuración inicial.

Actualizar estructura de enlaces permanentes

Ve a Ajustes → Enlaces permanentes y selecciona cualquier opción que no sea “Simple” (Plain). La API REST de WooCommerce requiere URLs amigables para funcionar.

Recomendado: Nombre de la entrada o /%postname%/

Instalar Cost of Goods for WooCommerce

Busca e instala el plugin “Cost of Goods for WooCommerce” desde el repositorio de plugins de WordPress. Necesario para el seguimiento de costos y márgenes en vrsPOS.

Instalar JWT Authentication for WP REST API

Busca e instala el plugin “JWT Authentication for WP REST API” desde el repositorio de WordPress. Este plugin permite la autenticación segura de vrsPOS con el servidor.

Generar la clave secreta JWT

En el panel del plugin JWT Authentication, genera una clave secreta aleatoria (mínimo 64 caracteres). Copia ambas líneas define() que el plugin te proporciona — las necesitarás en el siguiente paso.

Añadir las claves JWT a wp-config.php

Abre el archivo wp-config.php desde el File Manager de tu hosting (raíz del sitio) y añade las dos líneas generadas antes del comentario /* That's all, stop editing! */.

/* JWT Authentication — añadir antes de "stop editing" */
define('JWT_AUTH_SECRET_KEY', 'tu_clave_generada_aqui_minimo_64_caracteres');
define('JWT_AUTH_CORS_ENABLE', true);

Actualizar el archivo .htaccess

Abre el archivo .htaccess en el directorio raíz del sitio y añade las siguientes líneas dentro del bloque <IfModule mod_rewrite.c>, justo después de RewriteEngine On. Esto permite que el encabezado de autorización llegue a PHP.

# Pasar el header Authorization a PHP (requerido por JWT)
RewriteCond %{HTTP:Authorization} ^(.*)
RewriteRule ^(.*) - [E=HTTP_AUTHORIZATION:%1]

Generar el par de claves de autenticación

Ve a WooCommerce → Ajustes → Avanzado → REST API y crea un nuevo par de claves con permisos de Lectura/Escritura. Copia las credenciales en la aplicación vrsPOS durante la configuración inicial.