API de inventario y pedidos · sobre Intelisis

Tu Intelisis ya sabe qué tienes y a cuánto. El problema es dejar que otros lo consulten — y que te compren.

Una API que se instala sobre tu Intelisis para exponer inventario y precios a tus clientes y canales, y recibir sus pedidos. Segura, rápida, y la misma para todos: lo que cambia entre un cliente y otro es configuración, no código.

IntelisisSQL ServerAPI REST .NET AzureOAuth2 / JWT
Intelisis artículos · precios · existencias lee La API token · contrato · bitácora · reintentos Tienday portal B2B Puntode venta Appmóvil Integradorexterno los pedidos regresan por aquí asienta
Una sola capa. Lee hacia afuera, escribe hacia adentro.
El problema

El tramo que falta

El punto de partida

El dato existe. Lo que no existe es la puerta.

Tu ERP tiene el dato: existencia por almacén y la lista de precios de cada cliente. Pero ese dato vive puertas adentro.

Cuando un cliente quiere consultar su precio, cuando tu tienda necesita saber si hay stock, cuando llega un pedido y hay que meterlo sin corromper el inventario — ahí empieza el trabajo que Intelisis no hace solo.

Ese tramo es esta API.

Y no es un invento nuevo. Es la capa de integración que llevamos años construyendo a la medida para cada cliente, empaquetada para que ahora se instale.

Qué es

Una capa, muchos canales

Una sola API, instalada por cliente. Expone catálogo, existencias y precios hacia afuera; recibe pedidos hacia adentro.

El mismo binario corre en cada instalación. Su comportamiento se ajusta con configuración y con vistas del lado de Intelisis, no reescribiendo la API.

Eso significa que la tienda, el punto de venta, la app y el integrador externo de tu cliente grande leen todos de la misma fuente, con las mismas reglas y el mismo precio.

Por eso lo decimos así

Construida una vez, instalable muchas.

Cómo funciona

Tres decisiones que lo explican casi todo

Las tres se tomaron por la misma razón: que el ERP nunca quede expuesto a algo que no controle.

Lee por vistas, nunca toca lo que no debe

La API lee el inventario a través de vistas sobre Intelisis. Tu ERP sigue siendo la única fuente de verdad, y lo que se expone hacia afuera se decide en esas vistas, no en el código.

Ver detalle técnico

Acceso de solo lectura mediante synonyms hacia los objetos de Intelisis. La aplicación nunca ejecuta escritura arbitraria sobre el ERP. El catálogo se entrega paginado, con sincronización por deltas para que un consumidor no tenga que volver a bajarlo completo, y se puede buscar por varias llaves —SKU interno, MPN, UPC— porque cada canal identifica el mismo artículo de manera distinta. La existencia viaja con los tres números que Intelisis maneja: existencia, reservado y disponible. Hay consulta batch para cotizar varios artículos en una sola llamada.

Los pedidos entran a un buzón, no directo al ERP

Un pedido que llega se valida y se deposita en una tabla intermedia. Un proceso del lado de Intelisis lo asienta con la lógica del ERP y regresa el folio. Nunca se escribe en línea sobre el ERP.

Ver detalle técnico

El depósito es idempotente: el consumidor manda una llave de idempotencia y un reintento por corte de red no duplica el pedido. El asiento es asíncrono, del lado de Intelisis, con la misma lógica que usa el ERP para cualquier otro pedido. De regreso viene el folio, y con él se consulta el estatus sin volver a tocar Intelisis.

El precio que se consulta es el precio que se factura

La API resuelve el precio con la misma lógica que Intelisis usa al facturar. Cotizar y facturar nunca se contradicen —que es de donde sale la mitad de las llamadas enojadas a un área de ventas.

Ver detalle técnico

Resolución de lista específica por cliente con caída a la lista general cuando no existe. El tipo de cambio se aplica con factor y se expone en la respuesta, para que el consumidor pueda mostrar de dónde salió la cifra. Antes de pasar a producción se corre una verificación de paridad contra el motor de facturación: si un precio no coincide, no se libera.

Por qué esta y no otra

Cinco decisiones que se notan al año, no a la semana

Versátil sin reescribir la API

Mantenimiento

Las reglas de negocio —qué SKUs se exponen, con qué formato, de qué almacenes— viven en la capa de Intelisis bajo un contrato definido una sola vez. Un cambio se resuelve ahí, sin tocar ni redesplegar la API y sin arriesgar el resto del sistema.

  • Contrato fijo
  • Reglas por vista
  • Sin redespliegue

Seguridad que aguanta una auditoría

Acceso

OAuth2 y JWT, con esquemas distintos para cada tipo de consumidor: tu backend, una app móvil, un cliente que consulta su propia lista. Tokens de vida corta y revocación efectiva. El que pregunta solo ve lo suyo, y se prueba.

  • OAuth2 + JWT
  • Tres esquemas
  • Revocación

El inventario no miente

Confianza

Puedes topar lo que un cliente ve —mostrar «99» en vez de tu existencia real— y la API lo marca como tope, no como dato exacto. Nunca expone de más ni finge precisión que no tiene.

  • Tope configurable
  • Marcado explícito
  • Por almacén

Un producto, muchos clientes

Instalación

Almacenes, listas de precios, topes, formato de salida: todo por configuración. Instalar en el siguiente cliente cuesta configuración, no un desarrollo nuevo.

  • Un binario
  • Configuración por instancia

También empuja, no solo responde

Salida

Notifica por webhook cuando un pedido se procesa, y puede enviar la lista de precios de cada cliente por correo en Excel o depositarla por SFTP —programado y con reintentos. La integración va en las dos direcciones.

  • Webhooks firmados
  • Correo y SFTP
  • Programado
Y lo que no hace

Hay panel para operar, no para cambiar el contrato.

Prefiero decirlo aquí que en la junta de arranque: hay un panel para la operación del día a día —almacenes, topes, notificaciones—, pero el contrato de qué se expone y con qué reglas se define con nosotros, no se cambia desde una pantalla. Las reglas de negocio viven en la capa de Intelisis, bajo un contrato acordado. Lo que ganas no es autonomía total: es que un cambio se resuelva sin redesplegar ni arriesgar lo que ya funciona.

Prueba

No es una demo

Es la capa que ya corre en producción con clientes reales sobre Intelisis —la misma que está detrás de nuestros casos de configurador con IA y de retail. La empaquetamos para que se instale en el tuyo.

2Direcciones: consulta hacia afuera, pedidos hacia adentro
3Esquemas de autenticación según quién consume
1Binario, tantas instalaciones como clientes
0Escrituras en línea sobre el ERP
Dónde verlo

Los dos casos del sitio corren sobre esta misma arquitectura: el configurador con IA, donde el catálogo y los precios de nueve distribuidores se normalizan contra una sola fuente, y el retail sobre Intelisis, donde la tienda, el cajero y el almacén escriben el mismo registro.

Para quién es

Si corres Intelisis, sigue leyendo

Tus clientes preguntan

Necesitas que consulten su inventario y su precio sin llamarle a nadie, y que lo que vean sea lo que se les va a facturar.

Tus canales se contradicen

La tienda, la app y el punto de venta deberían leer de una sola fuente, y hoy cada uno tiene su propia versión del catálogo.

Alguien captura a mano

Los pedidos llegan por correo, por WhatsApp o por teléfono, y alguien los vuelve a teclear en Intelisis. Ahí es donde se pierde el margen.

Un caso más

Si tienes un integrador externo —un marketplace, un cliente grande, tu propia plataforma— que necesita conectarse, esta API es su puerta. Y es la misma puerta para todos, con permisos distintos.

Cómo se entrega

Primero ver, después cotizar

Igual que todo lo demás que hacemos. Cotizar antes de ver tu Intelisis sería adivinar.

Fase 1 Diagnóstico sobre tu Intelisis

Qué expones, a quién, con qué reglas. Se revisan almacenes, listas de precios y quién va a consumir. De ahí sale el alcance y el contrato de la capa.

Fase 2 Instalación y lectura

Se instala la API, se montan las vistas y se libera primero la consulta: catálogo, existencias y precios. El ERP todavía no se toca para escribir nada.

Fase 3 Pedidos

Se abre el buzón de pedidos y el proceso de asiento. Antes de producción se corren las pruebas de contrato y la verificación de paridad de precio.

Fase 4 Acompañamiento

Monitoreo, alertas y los cambios de reglas que vayan saliendo. El objetivo declarado es que no te quedes con una integración de la que nadie sepa.

Contacto

Cuéntanos qué necesitas exponer

Puede ser tu catálogo para un cliente grande, la existencia para tu propia tienda, o los pedidos que hoy alguien recaptura cada mañana.

No necesitas tener resuelto cómo.

Dinos qué necesitas exponer y a quién, y empezamos por ahí.