Saltar al contenido principal

Qué no está soportado

Esta página existe porque la documentación anterior describía funcionalidades que no existen en el código. Aquí enumeramos lo que aún no está disponible. Si una capacidad no aparece aquí y tampoco en otra sección, asume que no existe y abre un ticket con Soporte antes de diseñar tu integración alrededor de ella.

No existe (hoy)​

Paquete npm del widget​

No publicamos @neuroon/widget en npm. La única vía de distribución soportada es el CDN versionado con SRI:

https://cdn.neuroon.ai/widget@0.9.10/widget.js

Hay un package.json interno en el repositorio widget/ con "name": "@neuroon/widget" y "version": "0.9.10", pero no se publica al registro público. Cualquier guía o blog que indique npm install @neuroon/widget está desactualizado.

SDKs oficiales​

No existen clients oficiales en PHP, Python, Ruby, Go, Java o C#. La integración server-to-server se hace con cualquier cliente HTTP (cURL, HttpClient en .NET, requests en Python, axios en Node, etc.) y JSON. Los Recipes incluyen ejemplos copiables para cada stack.

Webhooks salientes​

Neuroon no envía webhooks a tus sistemas todavía. Para reaccionar a eventos del catálogo, usa polling con /api/plugin/shops/me.

Mientras tanto, si necesitas reaccionar a eventos de tu cuota o catálogo, usa polling:

  • GET /api/plugin/shops/me — datos de la tienda y cuota.
  • GET /api/plugin/shops/{shopId}/products?modifiedAfter=... — productos modificados.

Webhooks salientes con firma son parte del roadmap (sin fechas comprometidas).

Control imperativo de la búsqueda desde JS​

La API global window.NeuroonWidget expone solo control de ciclo de vida: init, getInstance, destroy, setTheme, setStyles, más los hooks de token (onTokenExpiring, onTokenRefreshed). Ningún método permite disparar búsquedas, leer resultados o limpiar la query — la UI del widget es la única vía para que el usuario interactúe con la búsqueda.

Callbacks JS públicos​

Solo hay callbacks para gestión del Widget Token (onTokenExpiring, onTokenRefreshed). No hay callbacks públicos para search, result-click, filter-change, conversion ni error — para reaccionar a actividad del widget desde tu tienda, usa los CustomEvents del DOM:

window.addEventListener('neuroon-theme-change', (e) => {
  // tu lógica
});

Y para empujar contexto al widget (carrito), dispara:

window.dispatchEvent(new CustomEvent('neuroon:cart-update', {
  detail: { items: [{ externalId: 'wc_prod_123', quantity: 2 }] }
}));

Versionado de la API HTTP​

No hay /v1/, /v2/, etc. en las rutas. Mantenemos compatibilidad por contrato: las modificaciones breaking se anuncian con antelación en el Changelog. Si necesitas pinning estricto, fija el campo version en cabeceras User-Agent o haz tu propio contract test contra los DTO documentados.

CSV / Excel para el sync vía API Plugin​

POST /api/plugin/shops/{shopId}/products/sync acepta únicamente JSON. La carga por archivo CSV/JSON existe pero vive bajo otro endpoint del Dashboard (uso humano, no integración programática). Si necesitas importar desde un ERP que sólo exporta CSV, parsea el CSV en tu lado y envíalo como JSON al endpoint de sync.

Sandbox aislado por petición​

No existe un sandbox que aísle datos por request. Lo más cercano es nuestro entorno de Desarrollo (dev-api.neuroon.ai), que es un entorno separado de Producción. Ver Entornos.

Roadmap (sin fechas comprometidas)​

  • SDKs oficiales (Python, PHP, Node, .NET).
  • Webhooks salientes.
  • Control imperativo de búsqueda desde JS (search, clearResults).
  • Callbacks JS públicos de búsqueda (onSearch, onResultClick, onError).
  • Versionado explícito de la API.

Cuando alguno se libere, lo verás aquí marcado como disponible y referenciado en Changelog.

Cómo reportar una funcionalidad faltante​

Si dependes de algo que no existe, abre un ticket vía Soporte describiendo:

  • Tu caso de uso.
  • Workaround que tengas que aplicar mientras tanto.
  • Stack (ayuda priorizar SDKs).
Última actualización en