WooCommerce REST API: cómo automatizar tu tienda virtual en Perú

En Lima y todo el Perú, los negocios e-commerce que automatizan sus procesos a través de la WooCommerce REST API reducen errores operativos, ahorran horas de trabajo manual y escalan más rápido. Con un mercado de e-commerce peruano que movió US$15,600 millones en 2024 (CAPECE), gestionar pedidos, inventario y facturación de forma manual se vuelve insostenible conforme crece tu volumen de ventas.

La REST API de WooCommerce permite que sistemas externos se comuniquen con tu tienda para leer y escribir datos: productos, pedidos, clientes, cupones, impuestos y más. Esto abre la puerta a integraciones con ERPs locales, sistemas de facturación electrónica SUNAT, plataformas de envío peruanas y herramientas de marketing. Esta guía te explica cómo funciona, cómo configurarla y qué integraciones son más útiles para el contexto peruano.

Qué es la WooCommerce REST API y para qué sirve

Una API (Application Programming Interface) es un puente que permite que dos sistemas se comuniquen entre sí. La REST API de WooCommerce expone los datos de tu tienda a través de endpoints HTTP que cualquier aplicación puede consultar o modificar, siempre que tenga las credenciales de autenticación correctas.

En términos prácticos, esto significa que puedes crear un script que cada noche sincronice tu inventario de WooCommerce con tu sistema de almacén, que tu sistema de facturación electrónica genere automáticamente comprobantes cuando se complete un pedido, o que tu herramienta de email marketing actualice los segmentos de clientes basándose en sus compras recientes.

WooCommerce ofrece endpoints para las principales entidades de una tienda: Products (crear, leer, actualizar, eliminar productos y variaciones), Orders (gestionar pedidos y sus estados), Customers (datos de clientes y su historial), Coupons (cupones de descuento), Reports (informes de ventas), Settings (configuración de la tienda), Shipping (zonas y métodos de envío), y Tax (tasas de impuesto como el IGV).

La API sigue los principios REST: usa verbos HTTP estándar (GET para leer, POST para crear, PUT para actualizar, DELETE para eliminar), retorna datos en formato JSON, y utiliza códigos de estado HTTP para indicar el resultado de cada operación.

Configuración inicial: credenciales y autenticación

Para usar la API necesitas generar credenciales de acceso. En tu panel de WordPress, ve a WooCommerce → Ajustes → Avanzado → REST API. Haz clic en «Agregar clave» y configura una descripción identificable (por ejemplo, «Integración ERP»), el usuario al que se asociará, y el nivel de permisos (lectura, escritura, o lectura/escritura).

WooCommerce genera dos credenciales: Consumer Key y Consumer Secret. Guarda ambas de forma segura porque el Consumer Secret solo se muestra una vez. Estas credenciales se envían con cada solicitud a la API para autenticar la conexión.

Para sitios con HTTPS (que deberían ser todos si manejas datos de pago), la autenticación se realiza enviando las credenciales como parámetros en la URL o como cabeceras de autorización HTTP Basic. La segunda opción es más segura porque las credenciales no quedan registradas en logs del servidor.

Un punto importante de seguridad: crea credenciales separadas para cada integración con los permisos mínimos necesarios. Si tu sistema de facturación solo necesita leer pedidos, dale solo permisos de lectura. Si alguna credencial se ve comprometida, el daño potencial se limita a los permisos otorgados.

Endpoints fundamentales para tiendas peruanas

Los endpoints que más utilizan las tiendas en Perú están relacionados con la gestión de pedidos, la sincronización de inventario y la facturación electrónica.

Para consultar los pedidos recientes de tu tienda, una solicitud GET a /wp-json/wc/v3/orders retorna la lista de pedidos con todos sus datos: cliente, productos, totales, estado, método de pago y dirección de envío. Puedes filtrar por estado (processing, completed, on-hold), por fecha, o por cliente específico. Esto es la base para integrar con sistemas de despacho como Olva Courier o Shalom.

La gestión de productos a través de la API permite actualizar precios y stock masivamente. Si manejas un catálogo de 500 productos y necesitas actualizar los precios por un cambio en el tipo de cambio del dólar (algo frecuente en Perú donde muchos productos importados se cotizan en dólares), un script que consulte los precios actuales, aplique el nuevo tipo de cambio, y actualice cada producto puede hacer en minutos lo que manualmente tomaría un día completo.

El endpoint de clientes (/wp-json/wc/v3/customers) permite segmentar tu base de datos según el historial de compras. Puedes identificar clientes que no han comprado en los últimos 90 días para enviarles una campaña de reactivación, o a los que compraron más de S/1,000 en el último mes para ofrecerles beneficios exclusivos.

Integración con facturación electrónica SUNAT

La facturación electrónica es obligatoria para la mayoría de negocios en Perú, y automatizar su emisión a través de la API de WooCommerce elimina uno de los cuellos de botella operativos más comunes en e-commerce peruano.

El flujo típico funciona así: cuando un pedido cambia a estado «completado» o «procesando» en WooCommerce, un webhook (notificación automática) envía los datos del pedido al sistema de facturación electrónica. El sistema genera la boleta o factura electrónica según el tipo de comprobante solicitado por el cliente, la envía a SUNAT, y retorna el número de comprobante y el enlace al PDF para que se almacene en el pedido de WooCommerce.

Proveedores como Nubefact, Bsale, eFact y Greenter ofrecen APIs propias que se pueden conectar con la API de WooCommerce mediante un middleware (un script intermediario) o mediante plugins ya desarrollados que hacen esta integración. Los plugins de facturación electrónica para WooCommerce varían en precio desde S/200 hasta S/800 dependiendo de las funcionalidades.

Un detalle técnico importante: el RUC o DNI del cliente debe capturarse durante el checkout para poder emitir factura. WooCommerce no incluye este campo por defecto, pero se añade fácilmente con un plugin como «Jeremías Peru Fields» o con código personalizado que agregue campos al formulario de checkout.

Sincronización de inventario con sistemas externos

Para tiendas que manejan inventario en un almacén físico o que venden en múltiples canales (tienda virtual, marketplace, tienda física), mantener el stock sincronizado es crítico. Vender un producto que ya no tienes en stock genera una pésima experiencia para el cliente y puede provocar reclamos en Indecopi.

La API de WooCommerce permite actualizar el stock de un producto con una solicitud PUT a /wp-json/wc/v3/products/{id}, enviando solo el campo stock_quantity. Un script programado (cron job) que se ejecute cada 15 minutos puede consultar tu sistema de almacén, comparar las cantidades con WooCommerce, y actualizar las diferencias.

Para tiendas que también venden en Mercado Libre o Linio (los marketplaces más populares en Perú), la sincronización de inventario entre múltiples canales requiere un sistema centralizado que actúe como «fuente de verdad» y actualice todos los canales cuando se registra una venta en cualquiera de ellos. Herramientas como Multichannel by CedCommerce se integran con WooCommerce y los principales marketplaces.

El manejo de variaciones de producto (talla, color, modelo) a través de la API requiere atención especial. Cada variación tiene su propio stock independiente, y la actualización debe hacerse a nivel de variación, no del producto padre. El endpoint es /wp-json/wc/v3/products/{product_id}/variations/{variation_id}.

Webhooks: notificaciones automáticas de eventos

Los webhooks son el complemento perfecto de la API. Mientras que la API requiere que tu sistema externo pregunte periódicamente por cambios («polling»), los webhooks hacen que WooCommerce envíe una notificación automática cada vez que ocurre un evento específico.

Puedes configurar webhooks desde WooCommerce → Ajustes → Avanzado → Webhooks. Los eventos disponibles incluyen: pedido creado/actualizado/eliminado, producto creado/actualizado, cliente creado/actualizado, y cupón creado/actualizado. Cada webhook envía un POST con los datos completos del objeto a una URL que tú definas.

Los casos de uso más comunes en Perú incluyen: notificar al sistema de despacho cuando se paga un pedido (para que prepare el envío inmediatamente), actualizar el CRM cuando se registra un nuevo cliente, enviar una notificación al equipo de ventas por Slack o WhatsApp cuando se recibe un pedido de alto valor, y sincronizar la base de datos de email marketing después de cada compra.

Un punto técnico: los webhooks requieren que la URL de destino esté disponible y responda rápidamente (menos de 5 segundos). Si el servicio de destino está caído o tarda en responder, WooCommerce reintentará el envío, pero después de varios fallos desactivará el webhook. Configura un sistema de monitoreo que te alerte si algún webhook falla repetidamente.

Ejemplos prácticos de automatización para e-commerce peruano

La automatización que más impacto tiene en tiendas peruanas es la gestión de envíos. Un flujo automatizado puede funcionar así: cuando un pedido pasa a «procesando», la API envía los datos del destinatario (nombre, dirección, distrito, provincia, departamento) al sistema del courier, genera la guía de remisión automáticamente, actualiza el pedido en WooCommerce con el número de seguimiento, y envía un email al cliente con el tracking.

La actualización masiva de precios es otra automatización valiosa. Para tiendas que importan productos, el tipo de cambio del dólar afecta los precios diariamente. Un script que consulte el tipo de cambio actual en la API del BCRP (Banco Central de Reserva del Perú), calcule los nuevos precios en soles, y actualice todos los productos afectados a través de la API de WooCommerce puede ejecutarse automáticamente cada mañana.

La generación de reportes automatizados es otra aplicación práctica. Un script semanal puede consultar los endpoints de reportes de WooCommerce, compilar datos de ventas por categoría, productos más vendidos, ticket promedio y métodos de pago, y enviar un resumen por email al dueño del negocio sin que nadie tenga que entrar al panel de administración.

Seguridad y buenas prácticas al usar la API

La API de WooCommerce tiene acceso directo a los datos de tu tienda, incluyendo información sensible de clientes y pedidos. Implementar buenas prácticas de seguridad no es opcional.

Usa siempre HTTPS. Las credenciales de API viajan en cada solicitud, y sin encriptación SSL pueden ser interceptadas. Tu instalación de WooCommerce debe tener un certificado SSL válido, que la mayoría de hostings incluyen gratuitamente con Let’s Encrypt.

Limita el acceso a la API por IP cuando sea posible. Si tu sistema de facturación se ejecuta siempre desde la misma IP, configura tu servidor web para que solo acepte solicitudes a la API desde esa IP específica. Esto previene el uso de credenciales robadas desde otras ubicaciones.

Implementa rate limiting (límite de solicitudes por minuto) para prevenir abusos. Un plugin como WP Cerber o una configuración en el servidor web puede limitar, por ejemplo, a 100 solicitudes por minuto por credencial de API. Esto previene tanto ataques como errores de programación que podrían saturar tu servidor.

Registra todas las operaciones de escritura (POST, PUT, DELETE) en un log. Si algo sale mal (un script actualiza todos los precios a 0, por ejemplo), el log te permite identificar rápidamente qué pasó y revertir los cambios.

Preguntas frecuentes sobre WooCommerce REST API

¿Necesito saber programar para usar la WooCommerce REST API?

Para integraciones básicas con herramientas que ya tienen conectores (Zapier, Make), no necesitas programar. Para integraciones personalizadas como sincronizar inventario con un ERP local o automatizar facturación electrónica, necesitas conocimientos de programación en Python, PHP, JavaScript u otro lenguaje que pueda hacer solicitudes HTTP.

¿La API afecta la velocidad de mi tienda?

Las consultas a la API consumen recursos del servidor, pero en cantidades normales (decenas o cientos de solicitudes por hora) el impacto es insignificante. Si necesitas hacer miles de solicitudes para una sincronización masiva, programa esas operaciones en horarios de bajo tráfico (madrugada) y usa batch endpoints que permiten hacer múltiples operaciones en una sola solicitud.

¿Puedo conectar WooCommerce con Mercado Libre a través de la API?

No directamente, porque Mercado Libre tiene su propia API con un sistema de autenticación diferente. Necesitas un middleware que conecte ambas APIs: consulte pedidos y stock en ambas plataformas y mantenga la sincronización. Existen plugins como Multichannel que hacen esto, o puedes desarrollar una solución a medida si tienes requisitos específicos.

¿Qué versión de la API debo usar?

Usa siempre la versión más reciente, que actualmente es la v3 (endpoint base: /wp-json/wc/v3/). Las versiones anteriores (v1, v2) siguen funcionando por compatibilidad pero tienen menos funcionalidades y eventualmente serán descontinuadas. Verifica la documentación oficial de WooCommerce para los cambios de cada versión.

La WooCommerce REST API transforma tu tienda virtual de un sistema aislado a una pieza integrada de tu operación de negocio. En KOM Agencia Digital desarrollamos integraciones a medida con ERPs, facturación electrónica SUNAT y sistemas de despacho para tiendas WooCommerce en Perú. Contáctanos al +51 923 222 223 para automatizar tu e-commerce.