Conecta tu tienda con otros sistemas 🔌
Tu tienda rara vez trabaja sola. Los productos vienen de un proveedor, el inventario vive en un sistema de almacén, los pedidos siguen su camino hacia una herramienta de contabilidad o de entregas. La API de la tienda permite que esos sistemas hablen directamente con tu tienda, para que nadie tenga que copiar datos a mano.
Un desarrollador, una agencia o una herramienta de programación con IA pueden usarla para:
- Añadir productos en bloque, con sus opciones (color, talla, etc.), un precio y un inventario por opción, y sus fotos
- Mantener el inventario sincronizado con un proveedor o un almacén, cada pocos minutos
- Leer los pedidos nuevos a medida que llegan y pasarlos a otro sistema
- Hacer avanzar los pedidos: aceptado, en reparto, entregado, cancelado
- Gestionar categorías
Dónde vive la API
Cada tienda tiene su propia API, en su propia dirección:
https://your-store.trinavo.com/api/v1, ohttps://www.your-domain.com/api/v1si usas tu propio dominio
No existe un api.trinavo.com central ni un ID de tienda que buscar: la dirección de tu tienda es lo que la selecciona.
Cómo obtener acceso
- En tu panel de administración, abre Gestión de usuarios → Tokens de API y crea un token.
- Elige qué puede hacer: leer o escribir productos, categorías y pedidos, o todo.
- Copia el token (se muestra una sola vez) y entrégaselo al desarrollador o a la herramienta. Cada solicitud lo lleva como
Authorization: Bearer <token>.
Puedes ver todos los tokens, regenerarlos o revocarlos desde la misma pantalla en cualquier momento.
Documentación pensada para desarrolladores y herramientas de IA
Cada tienda publica su documentación en su propia dirección:
- Referencia interactiva:
/api/documentation - Especificación OpenAPI:
/api/openapi.yaml(también/api/openapi.json), lista para importar en Postman, un cliente de API o un GPT personalizado - Guía para asistentes de IA:
/llms-full.txt, con ejemplos prácticos, para que herramientas como ChatGPT, Claude o Gemini escriban llamadas correctas en lugar de adivinar
Puedes ver un ejemplo real en nuestra tienda de demostración: demo.trinavo.com/api/documentation.
Qué cubre
| Área | Qué puedes hacer |
|---|---|
| Productos | Listar, leer, crear, actualizar y eliminar; opciones y variaciones por nombre; fotos por URL; SKU, código de barras, costo, peso y tamaño |
| Inventario | Definir la cantidad de un producto o de cada variación, por ID o SKU |
| Categorías | Listar, leer, crear, actualizar y desactivar |
| Pedidos | Listar y leer pedidos (con un filtro de "modificados desde" para consultas periódicas), crear pedidos, cambiar el estado de un pedido |
Los cambios hechos a través de la API se comportan exactamente igual que en tu panel de administración: los movimientos de inventario se registran, y cambiar el estado de un pedido descuenta inventario, hace reembolsos y notifica al cliente igual que el botón Cambiar estado.
Conviene saber
- Las llamadas cambian tu tienda en vivo. No hay una tienda de pruebas aparte, así que prueba una integración nueva con un producto creado para ese fin.
- Las actualizaciones llegan por consulta periódica. Todavía no hay webhooks; una integración pide los pedidos modificados desde su última ejecución, cada pocos minutos.
- Límites: 60 solicitudes por minuto por token.
- Guarda los tokens en un servidor. Un token colocado en una página web pública puede ser leído por cualquier visitante.
¿Prefieres simplemente preguntar?
Si lo que quieres son respuestas sobre tus ventas, tu inventario y tu ganancia en lugar de una integración, no necesitas la API en absoluto: conecta ChatGPT o Claude a tu tienda y pregunta con palabras sencillas.