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.

Renovamos la capa que conecta tu Intelisis con el mundo: expone inventario y precios a tus clientes y canales, y recibe sus pedidos. No empieza en una hoja en blanco — es un camino que ya recorrimos muchas veces, ajustado a tu caso con configuración, no con código nuevo.

IntelisisSQL ServerAPI REST .NET AzureOAuth2 / JWT
Intelisis artículos · precios · existencias lee La API token · contrato · bitácora · reintentos inventario + precio consulta o push programado Tienday portal B2B Puntode venta Appmóvil Integradorexterno pedido con autorización idempotente, a buzón 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. Ese know-how es lo que aplicamos a tu Intelisis.

La renovación

Tu API no está rota. El mundo al que se conecta, sí cambió.

Si ya tienes una integración, lo más probable es que sea REST de hace ocho o diez años y que funcione bien. El problema no es esa API. Es que la tecnología de conexión y de seguridad cambió más en el último año que en los siete anteriores.

~2008 Handlers HTTP

Cada integración se escribía a mano de principio a fin. Lo que aprendías en un cliente no servía para el siguiente.

El principio
~2012 Servicios SOAP

Contratos rígidos y XML pesado. Ordenado, pero caro de mover cada vez que el negocio cambiaba.

La era del XML
2017 API REST

Ligera, legible y suficiente para lo que se pedía entonces. Es muy probable que esta sea la tuya.

Tu versión hoy
2026 REST moderno y seguridad

Tokens de vida corta, reglas configurables, bitácora de todo y entregas en las dos direcciones.

La renovación
Lo que sigue MCP y agentes

La misma API expuesta como herramientas que una IA puede descubrir y usar.

Se cotiza aparte
La parte incómoda

Renovar no es reconectar.

Instalar lo nuevo es la mitad del trabajo. La otra mitad es acompañar a tus clientes a moverse al estándar nuevo, uno por uno, sin tumbarles la operación mientras tanto. Esa parte no la hace un instalador.

Qué es

Una capa, muchos canales

Una sola capa, montada sobre tu Intelisis. Expone catálogo, existencias y precios hacia afuera; recibe pedidos hacia adentro.

La arquitectura es la misma en todos los casos que hemos hecho; lo que cambia de uno a otro es la configuración y las vistas del lado de Intelisis. Por eso ajustar el comportamiento no significa reescribir la capa.

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í

No lo inventamos en tu proyecto. Lo adaptamos a tu proyecto.

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.

El panel

Una API no se ve. Su administración sí.

Lo que distingue una integración que alguien cuida de una de la que nadie sabe nada no es el código. Es si hay dónde ver qué está pasando, y dónde cambiarlo sin llamarle a nadie.

El cambio de fondo

Lo que hoy pides por correo, lo operas tú.

Dashboard de uso

Medición
48,217requests
9accesos
1,342pedidos
134mslatencia

Cuántas llamadas, de quién, a qué hora y contra qué endpoint. Cuando un cliente diga que la API está lenta, la discusión deja de ser de opiniones.

Accesos

Altas
ConsumidorClient-idEstado
Cyberpuertacyberpuerta-feedActivo
Mayoreo Tecmayoreotec-apiActivo
PuntoFríopuntofrio-b2bPausado

Das de alta un consumidor y el panel genera su token y le envía el correo de bienvenida con la colección de Postman. Lo que hoy son tres correos y una llamada.

Reglas de exposición

Configuración
Tope de existencia99
MonedaUSD · FIX 17.9780 + 0.50
Refurbished ≠ 1Grupo: MayoreoSKU: CT-*

Tope de existencia, moneda con el tipo de cambio FIX de Banxico más tu spread, y filtros por campo, familia o prefijo de SKU. Se configura, no se programa.

Pedidos por API

Operación
ClienteFolioEstatus
CompudaboVtaAPI-70188Asentado
Distribuidora RGVtaAPI-70191En proceso
PuntoFríosin créditoError

Qué entró, qué se asentó en Intelisis con su folio, y qué se atoró y por qué. Los que fallan traen el motivo en español, no un código.

Integración saliente

Entregas
DestinatarioModoEstado
CyberpuertaSFTP · 07:00OK
CompudabowebhookOK
Mayoreo TecExcel lunesReintento 2/5

Para el cliente que dice «yo no consumo tu API, depósitame el archivo»: SFTP, push HTTP, webhook o Excel por correo. Programado y con reintentos.

Bitácora

Rastro
Regla: tope 99 → 50Admin
Distribuidora RG · 429Límite
Alta de acceso · ActeckOK
Entrega SFTP · CyberpuertaOK

Quién hizo qué y cuándo, incluidos los cambios que hiciste tú. Si alguien pregunta por qué un cliente dejó de ver un artículo en marzo, ahí está.

El límite, dicho aquí y no en la junta de arranque El panel opera el día a día: accesos, reglas, reportes, reintentos. El contrato de qué se expone y con qué reglas se define contigo, y esa parte no se cambia desde una pantalla. Lo que ganas no es autonomía total: es dejar de esperar a que alguien tenga un rato.
Recorrer el panel → Prototipo · no funcional
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 método probado, tu versión

Método

Almacenes, listas de precios, topes, formato de salida: todo por configuración. Tu caso no arranca en una hoja en blanco. Arranca en lo que ya aprendimos en los anteriores.

  • Camino recorrido
  • Configuración por caso

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.

Lo que sigue · módulo aparte

Tu API, lista para la era de los agentes

Un agente de IA no navega tu portal ni llena un formulario: pide herramientas. MCP es el estándar con el que se las das. Es la misma API que ya tienes, expuesta como herramientas que un agente puede descubrir y usar — heredando la misma seguridad y la misma bitácora.

HerramientaQué haceRiesgoEstado
consultar_disponibilidadExistencia y precio de un artículoLecturaListo para activar
buscar_articuloBúsqueda por SKU, MPN o UPCLecturaListo para activar
cotizarCotiza varios artículos en una sola llamadaLecturaListo para activar
levantar_pedidoLevanta un pedido, con confirmaciónEscrituraTras candado
Fuera del alcance base Las tres herramientas de lectura van primero; la que escribe queda tras candado y confirmación. Este módulo se cotiza aparte y no está incluido en la renovación — ni creemos que deba estarlo todavía. Primero conviene que la API nueva lleve unos meses corriendo. Lo dejamos dibujado para que el día que lo quieras no haya que rehacer nada.
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 misma experiencia es la que aplicamos al tuyo.

2Direcciones: consulta hacia afuera, pedidos hacia adentro
3Esquemas de autenticación según quién consume
6Módulos en el panel, para operar sin pedirlo por correo
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í.