Skip to main content
La impresión fiscal y la cancelación hablan con Fire con un host y una API key. Si la cocina usa el default de la cuenta en un local de otro vendor, el ticket no imprime y la cancelación no llega — y en pantalla el pedido sigue viéndose “listo”. Esta página es para quien configura KDS → Credenciales Fire. El operador en la TV de cocina no ve este formulario.
Lo mínimo que hay que saber
  • Vendor ID vacío = Default de cuenta. Una fila con vendor ID reemplaza ese default solo para ese vendor.
  • Base URL es solo el host de Fire (https://br.app.fire.rest). Sin path, query ni hash: fire-kds agrega solo las rutas de print y cancel.
  • La misma key guardada sirve para ambos trabajos: fiscal print la envía como Bearer; cancel la envía como x-api-key.

​
El camino simple

1

Abre Credenciales Fire

Ve a KDS → Credenciales Fire (/kds/admin/fire-credentials).
2

Agrega un default de cuenta

Pulsa Agregar credencial. Deja Vendor ID vacío. Pega la Base URL (solo host https) y la API key. Deja Activa encendido. Pulsa Crear.
3

Agrega un override por vendor solo si lo necesitas

Si una marca habla con otro host o key de Fire, crea una segunda fila y completa Vendor ID. Esa fila gana para ese vendor; el resto de locales sigue usando el default de cuenta.
Listado de credenciales Fire API con default de cuenta y alcances por vendor
Si todos los locales de la cuenta usan el mismo entorno Fire, el default de cuenta alcanza. Puedes parar aquí.

​
Default de cuenta vs override por vendor

La resolución en runtime siempre es: fila de vendor → default de cuenta → variables de entorno (FISCAL_PRINT_* para print; cancel puede caer a FIRE_*). Print nunca lee FIRE_API_*.
Formulario de nueva credencial Fire API con vendor vacío para el default de cuenta
Formulario de credencial Fire API con un Vendor ID de override

​
Campos

​
Recetas

  1. Crea una sola fila con Vendor ID vacío.
  2. Usa el host de ese país (por ejemplo https://br.app.fire.rest).
  3. Déjala Activa.
  4. No crees filas de vendor salvo que una marca use otra key de verdad.
  1. Mantén el default de cuenta para el resto de locales.
  2. Agregar credencial, pega el Vendor ID de esa franquicia y su propia key.
  3. Confirma que el listado muestra Vendor para ese id y Default de cuenta para el resto.
  1. Abre Editar en la fila.
  2. Pega la API key nueva (la anterior nunca se muestra).
  3. Guarda. El siguiente print o cancel usa la key nueva.
  1. Desactiva o Elimina la fila de vendor.
  2. Eliminar es permanente: runtime cae al default de cuenta y luego al env.
  3. Confirma que una impresión de prueba sigue funcionando en un local de ese vendor.

​
Ejemplo con números

​
Errores que salen caros

Un path en la Base URL. Valores como https://br.app.fire.rest/v1/print se rechazan. fire-kds arma /fiscal-print y cancel solo. Si fuerzas un path, print y cancel fallan el endpoint.
Default de cuenta en el vendor equivocado. Un local del vendor B que cae a la key A recibe 401 / 403. Los comprobantes quedan en cola y la cancelación muestra Fire rechazó la cancelación.
http:// o una URL con query o hash. Solo se acepta host https:// (puerto opcional). Tampoco se acepta userinfo (user:pass@).

​
Glosario

​
Preguntas frecuentes

No. Solo el host. Los paths no se editan en esta pantalla.
No. Una sola key guardada. Print envía Bearer; cancel envía x-api-key.
Runtime usa las variables de entorno del servidor fire-kds, si están definidas. Si no, print y cancel fallan hasta que agregues otra fila.
No. El backoffice responde conflicto: ya existe una credencial para ese default de cuenta o vendor.

​
Lo que esta página no hace

  • No configura el Agente Fire (impresora local). Ver Periféricos, impresión y validación.
  • No elige Brasil v1 frente a Ecuador v2: fire-kds toma la versión según el país de la tienda.
  • No muestra un formulario al operador de cocina. Solo ve el resultado de print/cancel.
Para la cascada y la llamada HTTP, ver Credenciales Fire del KDS (técnico).