Sistemas conectados
Registra los sistemas de tu operación —tu tienda, SAP, el almacén, el ERP— con la llave con que llaman y el endpoint al que Bruxel les avisa, y revisa si su canal está sano.
¿Qué es un sistema conectado y para qué sirve?
Es el registro de un sistema de tu empresa que habla con Bruxel: tu tienda en línea, SAP, el almacén (WMS), el ERP o un middleware. Vive en Canales → Sistemas conectados y dice dos cosas: con qué llave de API de Bruxel llama ese sistema y a qué endpoint de webhook le avisa Bruxel.
Con eso Bruxel sabe de quién es cada aviso y cada llamada. Los flujos lo usan para dar por hechos los pasos del carril de ese sistema (guía «Flujos y recorridos»), y la conciliación por fuente, para saber qué sistema reportó cada valor (guía «Conciliación por fuente»).
¿Quién puede ver y registrar sistemas conectados?
Ver la lista es de Operador para arriba; un Lector o un Editor ve un aviso de que su rol no alcanza. Registrar, cambiar la llave y el endpoint, diagnosticar, pausar, reactivar y eliminar es de Administrador o Propietario. Un proveedor no ve esta pantalla.
Si la pantalla dice «Esta función todavía no está disponible en tu cuenta», tu organización la tiene apagada.
¿Cómo registro un sistema?
En «Registrar un sistema» llena estos campos y da «Registrar»:
- Nombre: cómo lo reconoce tu equipo, por ejemplo «SAP middleware».
- Tipo: SAP, Almacén (WMS), ERP, Otra tienda en línea, Middleware u Otro sistema. Adobe Commerce solo aparece si tu organización tiene esa conexión (guía «Conectar tu tienda Adobe Commerce»).
- Clave (opcional): el nombre del sistema en los flujos. Va en minúsculas, empieza con letra y admite dígitos y guion bajo, hasta 40. Si la dejas vacía sale del nombre («SAP middleware» → sap_middleware).
- Llave con la que llama y Endpoint al que le avisamos (abajo).
- Dirección de la tienda (opcional): solo la piden los tipos de tienda.
¿Cómo ligo la llave de API y el endpoint de un sistema?
La llave se crea en Canales → Llaves de API y el endpoint en Canales → Webhooks: créalos ahí primero. Solo se ofrecen llaves vigentes, ni revocadas ni vencidas, y del endpoint se ve solo su dominio. Una llave y un endpoint son de un solo sistema: los que ya tiene otro no aparecen.
Un sistema que no es tienda puede llevar solo la llave (si solo llama a Bruxel) o solo el endpoint (si solo recibe avisos). Para cambiarlos después, «Cambiar llave y endpoint», elige y «Guardar». Lo que ya llegó se queda con el sistema que tenía en ese momento: cambiar una liga solo mueve lo que llega después.
Una llave sin ligar cuenta por su nombre: lo que llega con una llave llamada «SAP» es de sap, salvo que sap ya tenga su propia llave ligada.
¿Qué significa el estado de cada sistema?
Cada sistema muestra con qué llave llama y a quién le avisamos, cuándo llamó por última vez y quién llamó, cuántos avisos faltan por entregar, cuántos fallos seguidos lleva y el último error. Arriba a la derecha, su estado:
| Estado | Qué significa |
|---|---|
| Al corriente | El canal está sano. En una tienda dice que vino por el contenido, no que lo haya escrito: si algo no aparece allá, revísalo en el panel de tu tienda. |
| Entregando | Todo sano, pero hay avisos en cola sin entregar. Es normal unos segundos; si dura, revisa el sistema. |
| Con fallos | El endpoint sigue encendido, pero acumula fallos seguidos. A los 20 se apaga solo. |
| Sin canal | Su endpoint se apagó solo tras demasiados fallos o, en una tienda, no tiene endpoint: no le llega ningún aviso. |
| En pausa | Alguien de tu equipo lo pausó en esta pantalla. |
| Sin ligar | No tiene llave ni endpoint: los flujos no pueden reconocer lo suyo. |
¿Qué hago si un sistema no recibe avisos o sale con fallos?
«Diagnosticar» revisa, en orden, que haya una llave vigente, que ya haya llamado con ella, que haya un endpoint, que esté encendido y que haya llegado al menos un aviso. En una tienda revisa las cinco; en otro sistema, solo lo que tiene ligado. Te dice la primera que falla y qué hacer. Solo lee: no manda nada a ninguna parte.
Si el endpoint se apagó solo, arregla el sistema y da «Reactivar canal»: lo vuelve a encender y su cuenta de fallos empieza de cero. Si ya tienes el máximo de endpoints encendidos, apaga o borra otro en Webhooks antes. Los intentos de entrega, uno por uno, están en Webhooks (guía «Webhooks»).
¿Qué pasa si pauso o elimino un sistema?
«Pausar» lo marca «En pausa» en esta pantalla y «Reanudar» lo regresa. No apaga su webhook ni revoca su llave: eso se hace en Webhooks y en Llaves de API.
«Eliminar» y luego «Sí, eliminar» borran solo el registro del sistema: su webhook y su llave siguen como están. No se puede eliminar un sistema cuyos avisos lee un flujo: cambia ese paso o archiva el flujo antes.