# Conectar la tienda WooCommerce ## ¿Por qué se usan claves de API? El sistema se comunica con tu tienda por la **API REST de WooCommerce**. Para eso WooCommerce te da dos claves (**Consumer Key** y **Consumer Secret**) que funcionan como un usuario y contraseña **exclusivos para la integración**: no hace falta compartir tu contraseña de WordPress y podés revocarlas en cualquier momento sin afectar nada más. ## Paso 1 — Crear las claves en WordPress 1. Entrá al panel de WordPress de tu tienda como administrador. 2. Andá a **WooCommerce → Ajustes → Avanzado → REST API**. 3. Hacé clic en **Añadir clave**. 4. **Descripción:** algo que identifique el uso, por ejemplo *Sistema de gestión*. 5. **Usuario:** un administrador. 6. **Permisos:** **Lectura/Escritura** (con "Lectura" solamente no se pueden publicar productos ni actualizar stock). 7. **Generar clave API**. 8. Copiá la **Clave del cliente** (Consumer Key, empieza con `ck_`) y la **Clave secreta** (Consumer Secret, empieza con `cs_`). **WooCommerce las muestra una sola vez**: si las perdés, generá un par nuevo. ## Paso 2 — Cargarlas en el sistema 1. Menú **Woocommerce → Configuraciones API**. 2. En la columna izquierda elegí **Configuraciones API**. 3. Completá: | Campo | Qué poner | Por qué | |---|---|---| | **URL de la aplicación de Woocommerce** | La dirección de la tienda, ej. `https://mitienda.com.uy` (sin `/wp-admin` ni barra final) | Es a donde el sistema le "habla" a la API | | **Woocommerce Consumer Key** | La clave `ck_…` | Identifica la integración | | **Woocommerce Consumer Secret** | La clave `cs_…` | La "contraseña" de la integración | | **Ubicaciones comerciales** | La sucursal que alimenta la web | Su stock es el que se publica y en ella se registran los pedidos web | | **Habilitar sincronización automática** | Tildalo cuando todo esté probado | Activa los procesos automáticos (ver *Dirección del stock y del contenido*) | 4. Guardá con el botón rojo de abajo a la derecha (**update**). ![Configuraciones API: URL, claves, sucursal y sincronización automática](/uploads/manual/woo/woo-04-api.jpg) ## Paso 3 — Comprobar la conexión Volvé a la pestaña **Woocommerce** (el panel). Si la conexión está bien: - No aparece ningún cartel rojo arriba. - En **Mapa de tasas de impuestos** la lista de la derecha muestra las tasas de impuesto de tu tienda. Si aparece el cartel rojo *"Unable to connect with WooCommerce, Check API settings"*, revisá la sección de errores de abajo. > La pestaña **Instrucciones** de Configuraciones API tiene un resumen de estos requisitos. ![Pestaña Instrucciones](/uploads/manual/woo/woo-03-instrucciones.jpg) ## Errores comunes / qué revisar - **La URL tiene `http://`** o termina en `/wp-admin` → usá `https://` y solo el dominio. - **Claves con espacios** al copiar y pegar → volvé a pegarlas con cuidado. - **Permisos de solo lectura** → editá la clave en WordPress y cambiá a Lectura/Escritura. - **Enlaces permanentes en "Simple"** → WordPress → Ajustes → Enlaces permanentes → *Nombre de la entrada*. Si aun así no conecta, guardá esa pantalla otra vez sin cambios (eso "resetea" los enlaces). - **Un plugin de seguridad o firewall bloquea la API** (Wordfence, Cloudflare, etc.) → pedile a quien administra la web que permita el acceso a `/wp-json/wc/`. - **El panel tarda unos segundos en abrir** → es normal: en ese momento consulta las tasas de impuesto a tu tienda.