Skip to main content
SmartPyme expone endpoints de webhook que aceptan eventos entrantes de WooCommerce y Shopify, reenviándolos a tu cuenta de SmartPyme como ventas y actualizaciones de inventario. Tú registras estas URLs dentro de cada plataforma externa y SmartPyme se encarga de todo a partir de ahí — sin importaciones manuales.

Endpoints de webhook disponibles

Todos los endpoints están alojados en la URL base https://api.smartpyme.site.

Cómo encontrar tu token de webhook

Cada usuario de SmartPyme tiene un token único que autentica las llamadas entrantes de webhook. Para ubicar el tuyo:
  1. Ve a Configuración → Usuarios y abre tu perfil de usuario.
  2. Haz clic en la pestaña Integraciones.
  3. Copia el token mostrado — lo pegarás en la URL del webhook al configurar la plataforma externa.

Seguridad

El segmento {token} en cada URL de webhook actúa como un secreto único por usuario que autoriza las solicitudes a tu cuenta de SmartPyme. Trátalo como una contraseña:
  • No compartas tu token en repositorios públicos, documentación ni código del lado del cliente.
  • No lo expongas en capturas de pantalla ni tickets de soporte.
  • Si crees que tu token está comprometido, contacta de inmediato al administrador de SmartPyme para rotar tus credenciales.

Procesamiento del payload

Cuando SmartPyme recibe un evento de webhook válido, automáticamente:
  • Crea una nueva venta a partir de los datos del pedido, incluyendo detalles del cliente, líneas de detalle, totales y método de pago.
  • Descuenta inventario por cada producto vendido, manteniendo precisos los niveles de stock.
  • Vincula el ID del pedido externo al registro de la venta en SmartPyme para que puedas rastrear cualquier transacción hasta su origen.
No se requiere configuración adicional — SmartPyme interpreta los formatos estándar de payload de WooCommerce y Shopify de fábrica.

Pruebas de webhooks

Antes de pasar a producción, verifica que tu endpoint de webhook funciona correctamente enviando un payload de muestra.
Después de enviar la solicitud, abre SmartPyme y confirma que se creó un nuevo registro de venta con los detalles correctos.
En WooCommerce puedes reenviar un webhook sin hacer un pedido real. Ve a WooCommerce Admin → Settings → Webhooks, selecciona el webhook que quieres probar y haz clic en Deliver. Esto reenvía el evento más reciente a tu endpoint de SmartPyme.