Tuno Integration — Alcance de Integración

Cómo conecta A con B

Selecciona un sistema o plataforma para ver qué fluye a través de Tuno

Selecciona un nodo

Haz clic en cualquier
sistema o plataforma

Tipos de flujo

Sistema → Tuno → Plataforma

Plataforma → Tuno → Sistema

Próximamente

Arquitectura Bidireccional

Tus sistemas empresariales como fuente de datos — Tuno conecta cada módulo con Shopify o BigCommerce

ERP

CRM

WMS

PIM

Marketing

Contabilidad

BI / Analytics

Push — Sistema → Tuno → Plataforma

Tu sistema de negocio envía datos a Tuno. Tuno transforma y ejecuta en Shopify o BigCommerce.

Catálogo / Productos (ERP, PIM)→ PLATFORM

Inventario / Stock (ERP, WMS)→ PLATFORM

Precios y Listas (ERP)→ PLATFORM

Clientes / Segmentos (CRM)→ PLATFORM

Campañas / Flows (Marketing)→ PLATFORM

Fulfillment / Tracking (WMS)→ PLATFORM

Eventos — Plataforma → Tuno → Sistema

La plataforma emite Webhooks. Tuno valida, transforma y enruta al sistema destino correspondiente.

Pedidos → ERP / OMS← WEBHOOK

Pago → ERP / Contabilidad← WEBHOOK

Clientes → CRM← WEBHOOK

Eventos → Marketing Automation← WEBHOOK

Productos → ERP / PIM← WEBHOOK

Reembolsos → ERP / Contabilidad← WEBHOOK

Shopify

REST + GraphQL Admin · 81 Webhooks

Webhooks

28+

Ops API

Módulos

BigCommerce

REST + GraphQL Storefront · 90+ Webhooks

90+

Webhooks

35+

Ops API

Módulos

TUNO INTEGRATION

Un solo motor — cualquier sistema, cualquier plataforma

Tu ecosistema de sistemas se conecta con Tuno una sola vez. Tuno gestiona la comunicación con la plataforma de ecommerce que elijas, con logging, retry automático y observabilidad en cada flujo.

Sistemas de Negocio

Integraciones disponibles por tipo de sistema — cada uno conectado bidireccialmente con Shopify y BigCommerce

Tipos de sistema

40+

Ops → Plataforma

30+

Eventos ← Plataforma

ERP — Enterprise Resource Planning

JD Edwards · SAP · Oracle · Microsoft Dynamics · Odoo · Infor

CRM — Customer Relationship Management

Salesforce · HubSpot · Zoho CRM · Pipedrive · Microsoft Dynamics CRM

WMS — Warehouse Management System

Manhattan Associates · Blue Yonder · Infor WMS · HighJump · Deposco · Logiwa

PIM — Product Information Management

Akeneo · Salsify · inRiver · Plytix · Contentful

Marketing Automation

Klaviyo · Mailchimp · ActiveCampaign · Brevo · Iterable · Omnisend

Contabilidad / Fiscal

QuickBooks · CONTPAQi · Aspel · SAP FI · Oracle Financials · Facturación CFDI

Shopify — Alcance de Integración

REST Admin API + GraphQL Admin API · 81 Webhooks · 16 módulos bidireccionales

Webhooks disponibles

28+

Operaciones API

Módulos

REST+GQL

Protocolos

Bidireccional completo

Cualquier sistema → Shopify y Shopify → cualquier sistema en todos los módulos principales.

20 eventos fulfillment

Trazabilidad detallada de cada etapa de preparación y logística.

Markets multi-región

Precios por mercado y moneda. B2B con Shopify Plus.

BigCommerce — Alcance de Integración

REST Admin API + GraphQL Storefront · 90+ Webhooks · 18 módulos · B2B Edition nativo

90+

Webhooks disponibles

35+

Operaciones API

Módulos

B2B Ed.

Nativo

B2B Edition nativo

Empresas, cotizaciones, PO, aprobaciones y términos de pago sin apps de terceros.

Price Lists por grupo

Precios distintos por grupo de cliente. Descuentos por categoría y volumen.

Multi-storefront

Catálogos y precios distintos por canal. Ideal para B2B + B2C simultáneos.

Principios de integración BigCommerce

Eficiencia

Mínimas llamadas. Paginación hasta 250 items. Solo campos necesarios.

Propósito claro

POST/PUT son más costosos que GET. Disparar solo por eventos de negocio.

Adaptabilidad

Webhooks en lugar de polling. Retry con backoff. Monitorear status page.

Manejo de errores HTTP

404 / 422 Re-evaluar ubicación o propiedades del recurso 429 Usar retry-after header — no reintentar inmediatamente 500–504 Esperar más en escrituras — revisar status.bigcommerce.com

APIs deprecadas — Tuno usa V3 exclusivamente

Endpoint V2 deprecado	Reemplazo V3
`/v2/products`	Catalog V3 Products
`/v2/categories`	Catalog V3 Catalog Trees — Categories
`/v2/brands`	Catalog V3 Brands
`/v2/customers`	Customers V3
`/v2/options · /v2/option_sets`	Product Modifiers + Variant Options V3
`/v2/redirects`	Redirects V3
`/v2/pages`	Pages V3

Tuno usa exclusivamente V3 — todas las integraciones BigCommerce implementadas por Spacebar utilizan los endpoints vigentes, garantizando compatibilidad a largo plazo.

TunoCommerce — by Spacebar

Plataforma de comercio headless · REST API v1 · Catálogo completo · Inventario · B2B · Diseñada para integrarse con cualquier sistema

50+

Endpoints REST

500

items / bulk-upsert

B2B

Nativo

Métodos de auth

Upsert por SKU

Crea o actualiza productos sin conocer UUIDs. Ideal para integraciones ERP/PIM.

Inventario bulk

Ajuste absoluto o relativo de stock para hasta 500 SKUs en una sola llamada.

B2B nativo

Clientes empresa, múltiples usuarios por cuenta, roles, direcciones y campos extra.

Autenticación

API Token · JWT Bearer · Cookie de sesión

API Token

Authorization: Bearer pk_… · Rate limiting por token · Máquina a máquina

JWT Bearer

Token firmado con JWT_SECRET · companyId desde payload · Sesiones backend

Cookie NextAuth

next-auth.session-token · Uso desde frontend web

Marcas

CRUD · Scope global o empresa · Slug check

GET/api/v1/brands — lista con filtros (search, scope, is_active) POST/api/v1/brands — crear marca · slug auto-generado PUT/api/v1/brands/:id — actualizar · scope inmutable DEL/api/v1/brands/:id — soft delete · bloqueado si tiene productos POST/api/v1/brands/:id/restore — restaurar GET/api/v1/brands/slug-check — verificar disponibilidad

Categorías

Árbol jerárquico · 3 niveles · Path materializado · Reorder

GET/api/v1/categories — lista con parent_id, depth, search GET/api/v1/categories/tree — árbol completo anidado POST/api/v1/categories — crear · máx. profundidad 3 PUT/api/v1/categories/:id — actualizar · parentId inmutable aquí POST/api/v1/categories/:id/move — mover en árbol · actualiza path + depth POST/api/v1/categories/reorder — asignar sortOrder en lote

Productos

CRUD · Upsert por SKU · Bulk-upsert 100 · Simple y Variable · Estado draft→active→archived

GET/api/v1/products — listado lean · include=variants,images,custom_fields,options POST/api/v1/products — crear con variantes, imágenes y campos inline PUT/api/v1/products/:id — actualizar campos y sub-recursos GET/api/v1/products/by-sku/:sku — búsqueda por SKU sin UUID POST/api/v1/products/upsert — crear o actualizar por SKU POST/api/v1/products/bulk-upsert — hasta 100 productos por lote · fallos parciales reportados por SKU POST/api/v1/products/bulk-status — cambio masivo de estado hasta 100 IDs DEL/api/v1/products/:id — soft delete · restaurable POST/api/v1/products/:id/duplicate — copia completa con opciones y variantes

Sub-recursos inline

variants[] — explicit-ID en PUT: con id→update, sin id→create

images[] — replace-all en PUT · variantSku resuelto automáticamente

custom_fields[] — replace-all · pares name/value ilimitados

tags[] · visibility[] — replace-all · por empresa o storefront

Variantes y Opciones

Producto cartesiano automático · Swatch · Rectangles · Dropdown

POST/api/v1/products/:id/options — crea opción (Talla, Color…) POST/api/v1/products/:id/options/:oId/values — agrega valor → genera variantes automáticamente POST/api/v1/products/:id/variants — crea variante directa con option_values[] PUT/api/v1/products/:id/variants/:vId — actualiza sku, price, stock, salePrice… POST/api/v1/products/:id/variants/reorder — reordenar por array de IDs

Al agregar un valor a una opción, el backend genera el producto cartesiano de todas las opciones y crea las variantes faltantes automáticamente.

Inventario

Ajuste absoluto y relativo por SKU · Hasta 500 items · Sin UUIDs

GET/api/v1/inventory?skus=SKU1,SKU2 — consulta stock de hasta 50 SKUs PUT/api/v1/inventory/adjustments/absolute — stock exacto · sincronización con ERP/WMS POST/api/v1/inventory/adjustments/relative — delta +/- · stock nunca baja de 0

Absoluto

{ sku, quantity, location_id } — asigna el valor final. Ideal para sincronización con ERP o conteo físico.

Relativo

{ sku, delta } — suma o resta al stock actual. Para recepciones (+N), devoluciones (+N) y ventas (−N).

Modificadores

Campos extra en checkout · Alcance global, categoría, tag o producto

global — aplica a todos los productos

category — aplica a una categoría y sus descendientes

tag / product — alcance específico

Tipos: text · number · select · multiselect · checkbox · date · Prioridad resuelta con /modifiers/resolved

Clientes B2B

Empresa · Múltiples usuarios · Roles · Direcciones · Campos extra

GET/api/v1/customersB2B — lista con filtro por status (pending/active/suspended) POST/api/v1/customersB2B — crea empresa + usuario principal en una llamada PUT/api/v1/customersB2B/:id — actualiza datos empresa y extraFields POST/api/v1/customersB2B/:id/users — agregar contacto · roles: admin/comprador/aprobador/visor POST/api/v1/customersB2B/:id/addresses — dirección billing/shipping/other

Campos personalizados vía extraFields[] — ej. RFC, número de proveedor, límite de crédito.

Etiquetas e Imágenes

Tags transversales · Imágenes por URL · Alcance producto o variante

POST/api/v1/tags · PUT /products/:id/tags — replace-all de etiquetas POST/api/v1/products/:id/images — imagen por URL · isPrimary · variantId o variantSku POST/api/v1/products/:id/images/reorder — reordenar por array de IDs PUT/api/v1/products/:id/secondary-categories — replace-all categorías secundarias PUT/api/v1/products/:id/visibility — replace-all visibilidad por empresa o storefront

Códigos de error comunes

400 VALIDATION_ERROR — campos inválidos · details[] con errores Zod 401 UNAUTHORIZED — sesión inválida, token expirado o revocado 403 FORBIDDEN — permiso insuficiente para la operación 409 CONFLICT — slug/SKU duplicado, delete bloqueado por dependencias 422 Transición de estado inválida, profundidad de categoría excedida 429 RATE_LIMIT_EXCEEDED — límite de peticiones por token excedido 503 SERVICE_UNAVAILABLE — error de conexión a base de datos

Capa de Confiabilidad

Aplica igual para Shopify y BigCommerce — observabilidad y recuperación integrada en todos los flujos

Validación

Cada payload se valida contra schema. Malformados → log + rechazo controlado. HMAC verification en webhooks entrantes.

Logging completo

Timestamp, origen, payload, resultado, tiempo y status code en cada ejecución. Panel Tuno para visualización en tiempo real.

Retry automático

Backoff exponencial ante timeouts, rate limits (429) y errores 5xx. Hasta 3 reintentos automáticos con espera creciente.

Alertas

Notificación inmediata ante fallos consecutivos. Email de conciliación post-sync con resumen de éxitos, omitidos y errores.

Dead Letter Queue

Items fallidos se almacenan para reprocesamiento manual o automático. Cero pérdida de datos.

Delta Detection

Solo se envían cambios reales. Si precio/inventario no cambió respecto al último sync, se omite. Reduce llamadas API hasta un 80%.

Flujo estándar — aplica a ambas plataformas

TRIGGER

Sistema de negocio dispara evento

POST desde ERP/CRM/WMS o Webhook entrante de Shopify / BigCommerce

VALIDATE

Validación y transformación

Schema, HMAC, tipos. Mapeo sistema ↔ Shopify/BigCommerce. Delta detection.

SEND

Envío a destino

REST + GraphQL (Shopify) · REST V3 (BigCommerce) · REST/API (Sistema origen)

CONFIRM + LOG

Verificación y registro

2xx confirmado. Retry si falla. Log en panel Tuno. Email de conciliación post-sync.

Ecosistema de Conectores

Tuno va más allá de un middleware — orquesta todo tu ecosistema digital con cientos de conectores listos para usar

500+

Conectores disponibles

Categorías de sistemas

REST

+ Webhooks + GraphQL

Código requerido

Orquestación completa

No solo mueve datos — coordina lógica de negocio entre múltiples sistemas con ramificaciones, condiciones y transformaciones.

Tiempo real o programado

Webhooks para eventos instantáneos, Cron para sincronizaciones periódicas. Ambos modos en el mismo flujo.

Multi-sistema en un flujo

Un pedido puede actualizar ERP, notificar Slack, crear ticket en Jira y enviar email. Todo en un solo flujo automatizado.

Low-code — código incluido

Construimos sobre plataforma low-code, pero el código lo ponemos nosotros. Tú defines la lógica de negocio; Spacebar se encarga del resto.

Los conectores se activan según el plan contratado · Integraciones custom disponibles bajo scoping

Panel Tuno Integration

Observabilidad completa de cada flujo — en tiempo real, por cliente, por plataforma

Ejecuciones

4,287

4,112 exitosas

Tasa de éxito

95.9%

4,112 de 4,287

Latencia promedio

1,840 ms

últimas 24 horas

Errores

175

en el período

Ejecuciones por hora — últimas 24h

Éxito Error Aviso

Workflows activos

Últimas ejecuciones

Exportar PDF CSV

Iniciado	Workflow	Estado	Duración	Items

Tiempo real

Datos actualizados en vivo. Filtra por flujo, estado, dirección o período con un clic.

Multi-empresa

Cada empresa ve solo sus datos. Panel aislado por proyecto, app y credencial.

Exportable

PDF con gráfica + tabla de ejecuciones. CSV con todos los logs filtrables.