API y Webhooks

API y Webhooks

Conectá tu tienda con sistemas externos, automatizá procesos y mantené sincronizada tu operación ecommerce.

GET /api/v1/productos?sku=REM-001
Authorization: Bearer wk_live_••••

{
  "sku": "REM-001",
  "stock": 24,
  "estado": "activo"
}
orden.pagada Webhook enviado
Stock ERP sincronizado
Para sellers y equipos técnicos

Tu tienda conectada

Wendo permite conectar tu tienda con herramientas externas mediante API y Webhooks. Podés sincronizar productos, actualizar stock, consultar órdenes, enviar información a sistemas propios y recibir eventos en tiempo real cuando algo importante sucede.

Generar una API key desde el panelConectar sistemas externos de forma seguraConsultar productos y variantesFiltrar por SKU, estado o paginaciónActualizar stock por SKUConsultar órdenes y detalle de ventaFiltrar órdenes por estado o fechaActualizar estado de una ordenAgregar número de seguimientoConsultar carritos abandonadosAdministrar webhooks desde la APIConectar ERPs, dashboards o automatizaciones
Cómo se conecta

Leé, actualizá y reaccioná

La API permite que un sistema externo consulte o modifique información operativa. Los webhooks evitan consultar todo el tiempo: Wendo envía una notificación HTTP cuando ocurre un evento relevante.

01

Generá una API key

Creá una credencial privada desde el panel para autorizar requests externos.

02

Conectá tu sistema

Consultá productos, órdenes, carritos o actualizá stock desde tu ERP o desarrollo propio.

03

Recibí eventos

Configurá webhooks para disparar acciones cuando cambia algo importante en la tienda.

API Key

Tu clave API

Desde el panel de Wendo, el seller puede generar una clave API para conectar sistemas externos. Podés revocarla o regenerarla cuando lo necesites.

La clave se genera desde el panel.Se muestra completa una sola vez.Luego se visualiza enmascarada.Se puede revocar o regenerar.Si se regenera, la clave anterior deja de funcionar.Se usa en cada request con Authorization: Bearer.
Endpoints para sellers

Endpoints disponibles

Estos bloques están pensados para que una tienda pueda conectar Wendo con ERPs, sistemas de stock, dashboards, logística o automatizaciones internas.

Productos

/api/v1/productos

Consultá el catálogo, leé variantes y sincronizá stock con sistemas externos.

  • Listar productos
  • Consultar variantes
  • Ver SKU, precio, stock y estado
  • Filtrar por SKU
  • Filtrar productos activos o inactivos
  • Actualizar stock por SKU
  • Actualizar stock en lote

Órdenes

/api/v1/ordenes /api/v1/ordenes/{id}

Leé ventas, consultá detalle operativo y mantené actualizada la preparación de pedidos.

  • Listar órdenes
  • Filtrar por estado
  • Filtrar por fecha
  • Ver detalle de una orden
  • Consultar ítems y total
  • Actualizar estado
  • Agregar número de seguimiento

Carritos abandonados

/api/v1/carritos-abandonados

Consultá carritos para análisis, recuperación externa o automatizaciones comerciales.

  • Listar carritos abandonados
  • Ver datos del carrito
  • Consultar ítems y total
  • Filtrar por fecha
  • Filtrar si ya se envió recuperación

Webhooks

/api/v1/webhooks /api/v1/webhooks/{id}

Creá, pausá y administrá URLs que reciben eventos de tu tienda en tiempo real.

  • Listar webhooks
  • Crear un webhook
  • Activar o pausar
  • Cambiar URL o eventos
  • Eliminar webhooks
  • Enviar un ping de prueba
Webhooks

Eventos en tiempo real

Con Webhooks podés recibir eventos de tu tienda y disparar acciones automáticas en sistemas externos, como actualizar un ERP, enviar una alerta, crear una tarea o sincronizar una orden.

Eventos disponibles

orden.creadaorden.pagadaorden.preparandoorden.enviadaorden.envio_mayorista_actualizadoorden.canceladacarrito.abandonadodevolucion.actualizada

Qué puede hacer el seller

  • Agregar una URL de destino
  • Elegir qué eventos recibir
  • Crear varios webhooks
  • Ver el último intento de envío
  • Ver si el último envío fue exitoso
  • Ver errores de entrega
  • Enviar ping de prueba
  • Copiar el secret al crear un webhook
  • Verificar la firma X-Wendo-Signature
Casos de uso

Automatizá tu operación

La API y los Webhooks ayudan a reducir tareas manuales y mantener cada sistema con la información correcta.

Sincronizar stock

Conectá Wendo con un sistema de inventario para actualizar stock automáticamente.

Conectar un ERP

Consultá órdenes, productos y carritos desde un sistema de gestión externo.

Automatizar logística

Enviá datos de órdenes a un sistema operativo, depósito o herramienta de despacho.

Crear dashboards propios

Usá la API para alimentar reportes con datos de productos, ventas y carritos.

Automatizar postventa

Dispará acciones cuando una orden cambia de estado o se genera una devolución.

Recuperar carritos

Consultá carritos abandonados para campañas, análisis o automatizaciones externas.

Próximamente

Developer Platform

Wendo está preparando una plataforma developer para apps, OAuth, permisos, sandbox y publicación de integraciones revisadas.

PróximamenteApps privadas o públicasPróximamenteNombre, descripción, icono y URLsPróximamenteOAuth para autorizar tiendasPróximamenteScopes y permisos específicosPróximamenteAccess tokens y refresh tokensPróximamenteTienda sandboxPróximamenteAPI ExplorerPróximamenteLogs de APIPróximamenteWebhooks de appPróximamenteWebhooks firmadosPróximamenteReleases y changelogPróximamenteRevisión de appsPróximamenteMarketplace de Wendo
Próximamente

Scopes y eventos

Scopes disponibles

Próximamenteproducts.readPróximamenteproducts.writePróximamenteorders.readPróximamenteorders.writePróximamentecustomers.readPróximamentenewsletter.readPróximamentewebhooks.write

Eventos developer

Próximamenteorder.createdPróximamenteorder.updatedPróximamenteproduct.updatedPróximamenteapp.uninstalled
Dos formas de integrar

Dos caminos

Separar estos caminos ayuda a elegir la integración correcta según si conectás una tienda propia o construís una app para varias tiendas.

API seller

Para una tienda que quiere conectar su propio sistema operativo.

  • Mi ERP
  • Mi sistema de stock
  • Mi dashboard
  • Mi automatización interna
  • Mi depósito
Próximamente

Developer Platform

Próximamente, para partners o developers que quieran crear apps instalables en varias tiendas.

  • Apps de marketing
  • Integraciones logísticas
  • Conectores ERP
  • Reporting
  • Marketplace
Preguntas frecuentes

Sobre API y Webhooks

1. ¿Para quién está pensada la API de Wendo?

Principalmente para sellers, marcas y equipos técnicos que necesitan conectar una tienda con sistemas propios, ERPs, stock, logística, dashboards o automatizaciones internas.

2. ¿Cuál es la diferencia entre API y Webhooks?

La API permite consultar o actualizar información cuando tu sistema lo necesita. Los Webhooks permiten que Wendo avise automáticamente a otro sistema cuando ocurre un evento importante.

3. ¿Puedo actualizar stock desde un sistema externo?

Sí. La API está pensada para permitir actualizaciones de stock por SKU y operaciones en lote, según el alcance disponible para cada tienda o plan.

4. ¿Los webhooks están firmados?

La estructura prevista contempla un secret por webhook y verificación mediante la cabecera X-Wendo-Signature para validar que el evento proviene de Wendo.

5. ¿La plataforma developer es lo mismo que la API seller?

No. La API seller conecta una tienda con sus propios sistemas. La plataforma developer será un entorno próximo para apps privadas o públicas, OAuth y permisos específicos.

Conectá tu operación

Conectá stock, órdenes y eventos

Contanos qué sistema necesitás conectar y te ayudamos a evaluar el alcance técnico para tu tienda o integración.