Stoam B2B · API Stoam B2B
Tu ERP, tu PIM, tu almacén o un desarrollo propio leen y mantienen los datos de la tienda sin pasar por ficheros: productos, stock en tiempo real, promociones y pedidos pendientes. Y tus clientes compran siempre sobre datos reales.
Stock por API · Almacén central
Enviadas
1.000
en una petición
Correctas
997
al momento
SKU inexistente
2
avisadas
Cantidad no válida
1
avisada
Promo distribuidores Norte
Preflight correctoGrupo de clientes
3 clientes
Variantes incluidas
48
Referencias inactivas
0
Publicación
En segundo plano
El punto de partida
El stock llega con el siguiente envío, las promociones se cargan a mano y cada sistema nuevo es otro proyecto de exportaciones. Mientras tanto, tu cliente compra sobre datos que ya no son los de hoy.
✕
El stock se actualiza cuando llega el siguiente fichero.
✕
El cliente pide algo que ya no queda en el almacén.
✕
Las promociones se cargan a mano y se revisan a ojo.
✕
Conectar un PIM, un WMS o una automatización es un proyecto aparte.
✕
Un error en la carga se descubre cuando ya está publicado.
✓
Tu sistema actualiza el stock por almacén, al momento.
✓
El cliente compra sobre la disponibilidad real.
✓
Las promociones se validan antes de llegar a la tienda.
✓
ERP, PIM, WMS o desarrollos propios, conectados sin ficheros.
✓
Los cambios esperan tu aprobación antes de publicarse.
Qué conecta
Cada sistema se ocupa de lo que mejor sabe hacer. La tienda recibe el dato al día, con las mismas validaciones que la importación de siempre.
01
Tu PIM o tu ERP cargan productos nuevos y cambios de ficha. Quedan en espera para que los revises y los apruebes antes de que lleguen al catálogo.
02
Tu almacén actualiza el stock por almacén en el momento en que cambia, o por lotes si lo prefieres. Tú eliges qué sistema manda.
03
Mantén las promociones desde tu sistema. Se comprueban antes de escribirse y se publican cuando tú lo decides. Requiere el Motor de promociones.
04
Carga los pedidos pendientes para que tu cliente los vea en su cuenta, y consulta pedidos, usuarios y datos del ERP conectado desde tus propias herramientas.
¿Ya tienes el conector de tu ERP?
Perfecto: el conector de Stoam ya sincroniza productos, precios, stock, clientes y pedidos. La API es para lo que el conector no cubre: otro sistema que mande en un dato, un stock que no puede esperar al siguiente ciclo o un desarrollo propio.
Lo que aporta
La integración no es un fin en sí misma. Lo que cuenta es lo que cambia en el día a día de quien vende y de quien compra.
Decides qué sistema manda en cada dato y la tienda lo respeta. Se acabó cuadrar exportaciones o corregir cargas a mano.
Ven el stock que de verdad hay, las promociones que les tocan y sus pedidos pendientes al día. Menos llamadas para preguntar y menos pedidos imposibles.
Prepara todos los cambios, revísalos y publícalos juntos cuando quieras. Lo que no cuadra se rechaza antes de tocar la tienda.
Stock al día
Cada tienda tiene una sola fuente de verdad para el stock. Se elige según tu operativa, y la consulta por API funciona siempre, sea cual sea el modo.
El stock llega con la importación automática de tu ERP, como hasta ahora. La API solo lo consulta.
Tu sistema escribe el stock por almacén y el cambio se ve al instante. La importación automática se detiene para no pisar los valores.
Tu sistema sustituye al envío del ERP: carga el lote, lo valida y se importa como siempre.
Pensado para no fallar
Hasta 1.000 líneas por petición y, si una falla, el resto sigue adelante. Reenviar el mismo lote no duplica nada. Nunca hay stock negativo, y las ventas siguen descontando en cualquier modo: el modo solo decide quién repone.
Sin riesgos
Escribir y publicar van por separado. Cada dato sigue su camino, así sabes de antemano si un cambio se verá al momento o esperará a que lo apruebes.
Las cargas quedan en una zona de espera, con un informe de errores por fila. No llegan al catálogo hasta que las apruebas.
Preparas todos los cambios, se comprueban sin tocar nada y se publican juntos al terminar. Mientras tanto, la tienda no cambia.
El cambio se aplica al momento, sin pasos intermedios. Pensado para el dato que no puede esperar al siguiente ciclo de importación.
Validación que falla cerrando
Si a una promoción le falta una referencia, está inactiva o un grupo quedaría vacío, se rechaza entera y te explica por qué. Un descuento pensado para tres clientes nunca acaba aplicándose a toda la tienda.
Para tu equipo técnico
Lo justo para que tu integrador sepa dónde se mete. El detalle completo está en la documentación, dentro de tu propia tienda.
40
rutas documentadas
71
operaciones en la definición OpenAPI
OpenAPI
visor interactivo dentro de la tienda
OAuth 2.0
tokens que puedes revocar cuando quieras
✓
Solo los administradores o los usuarios «Acceso API» pueden tener claves.
✓
Los tokens se generan y se revocan desde Configuración › API, y solo se muestran una vez.
✓
Cada operación indica a qué escribe, para que nada sorprenda al integrador.
✓
Un número de peticiones por minuto según tu plan de hosting.
✓
Cada respuesta dice cuánto te queda y cuándo se reinicia. Si te pasas, no se pierde ningún dato.
✓
La sincronización con nuestros conectores de ERP no cuenta en tu límite.
Contratación
La activa el equipo de Stoam. Desde ese momento aparece Configuración › API en tu panel y ya puedes generar los tokens.
La API es para sistemas. Si quieres trabajar con la tienda desde un asistente de IA en lenguaje natural, eso es el MCP. Comparten permisos y límites.
Ver el servidor MCPNo es lo mismo: la API Stoam B2B abre los datos de tu tienda, y la API Sage 200 abre el propio ERP a integraciones. Se contrata de forma independiente.
Preguntas frecuentes
¿Necesito la API si ya tengo el conector de mi ERP?
No necesariamente. El conector de Stoam ya sincroniza productos, precios, stock, clientes y pedidos. La API es para lo que el conector no cubre: otro sistema que mande en un dato, un stock que no puede esperar a un ciclo o un desarrollo propio.
¿Lo que envío por API se publica al momento?
Depende del dato. El stock en tiempo real, sí. Los productos y las cargas por lotes esperan a tu aprobación. Las promociones se preparan y se publican con un paso explícito, cuando tú lo decides.
¿Puedo romper el catálogo con una carga errónea?
Las cargas pasan por las mismas validaciones que la importación de siempre, con un informe de errores por fila. Las promociones se comprueban antes de escribirse y se rechazan enteras si algo no encaja.
¿Quién puede usar la API?
Los usuarios administrador o de tipo «Acceso API» de la tienda, cada uno con su propio token. Cualquier token se puede revocar en el momento desde el panel.
¿Cuántas llamadas puedo hacer?
Depende de tu plan de hosting: cada plan incluye un número de peticiones por minuto. Si necesitas más, se sube de plan o se amplía la capacidad. La sincronización con nuestros conectores de ERP no cuenta.
¿Dónde está la documentación?
Dentro de tu propia tienda, en un visor interactivo con todas las operaciones y el formato de cada petición y respuesta. También se puede descargar.
¿Qué diferencia hay con el MCP?
La API es para sistemas: un programa que envía y recibe datos. El MCP es para personas que trabajan con un asistente de IA en lenguaje natural. Comparten los mismos permisos y límites de la tienda.
¿Es lo mismo que la API Sage 200?
No. La API Stoam B2B da acceso a los datos de tu tienda. Stoam Connect API Sage 200 es un producto aparte que abre el propio ERP Sage 200 a integraciones.
Sin ficheros · stock real · cambios con red
Cuéntanos qué datos quieres mover y te decimos la forma más sencilla de hacerlo.
Contacta con nosotros