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 HMAC son parte del roadmap (sin fechas comprometidas).

API global del widget en window​

No existe window.NeuroonWidget.init(), window.NeuroonWidget.search(), window.NeuroonWidget.destroy() ni similares. La docu vieja los describía; no estaban implementados. La configuración del widget se hace exclusivamente mediante atributos data-* en la etiqueta <script>.

Callbacks JS públicos​

onSearch, onResultClick, onFilterChange, onError aparecen como types en TypeScript dentro del repositorio del widget, pero no están conectados a un punto de extensión público. No los uses; no funcionan.

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​

Hoy no hay /v1/, /v2/, etc. en las rutas. Mantenemos compatibilidad por contrato: los cambios breaking se anuncian con antelación en el Changelog. Habrá versionado en URL en el futuro; cuando llegue, será aditivo (las rutas actuales seguirán funcionando con periodo de gracia). Si necesitas pinning estricto hoy, identifica tu cliente en User-Agent o haz contract tests 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 tipo Stripe test mode que aísle datos por request. Lo más cercano es nuestro entorno de Desarrollo (dev-api.neuroon.ai), que es un cluster separado. Ver Entornos.

Roadmap (sin fechas comprometidas)​

  • SDKs oficiales (Python, PHP, Node, .NET).
  • Webhooks salientes con firma HMAC.
  • API global del widget para integraciones avanzadas (window.NeuroonWidget).
  • Callbacks JS públicos (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