CLI de REDCUMBRE
El CLI conecta tu proyecto con la API de REDCUMBRE en el modo de prueba, opera la API desde la terminal y pasa a producción cuando estás listo. Se empieza con:
npx @redcumbrecl/cli inity se usa instalado, como redcumbre: corrido por npx, init lo deja instalado antes que nada, en
la misma versión, y npx @redcumbrecl/cli instalar lo hace en cualquier momento. Esta página lista todo lo que el CLI hace: cada
comando con su propósito, las banderas de cada uno, los códigos con los que termina y los archivos
que escribe. Para integrar con un asistente de código, mira
Integrar con tu agente de IA.
Con --json, o sin terminal, el CLI no pregunta nada: la salida estándar trae sólo un JSON y los
avisos van a la salida de errores. Lo que necesita a una persona (iniciar sesión, crear la llave de
producción, confirmar una operación en producción) sale con un código distinto de 0 y deja en
error.comando lo que la persona tiene que correr.
Comandos
Sección titulada «Comandos»Cada comando acepta además -h, --help, que muestra su ayuda. Las banderas que comparten varios
comandos están en Banderas comunes y no se repiten en cada fila.
Empezar y la sesión
Sección titulada «Empezar y la sesión»| Comando | Para qué sirve | Banderas |
|---|---|---|
redcumbre | Sin comando muestra la ayuda y la lista de comandos. | --version --help |
redcumbre init | Conecta el proyecto: deja la llave de prueba en keys/, el puntero en .env, la skill del integrador y comprueba la llave. No escribe código ni emite nada. | --empresa --carpeta --sin-navegador |
redcumbre pasar-a-produccion | Revisa que todo esté en orden y agrega la llave de producción al proyecto. La confirma una persona escribiendo el slug de la empresa. | --empresa --servicios --confirmar --instalar --comprobar --sin-navegador |
redcumbre login | Inicia sesión con tu cuenta de REDCUMBRE. Sin terminal o con --sin-navegador entrega el enlace y el código para que la persona los apruebe. | --completar --sin-navegador |
redcumbre logout | Cierra la sesión: la revoca en el servidor de identidad y la borra de este computador. | — |
redcumbre solicitar-cuenta | Pide una cuenta en REDCUMBRE para tu empresa; lo hace una persona. | — |
redcumbre doctor | Revisa la sesión, la empresa, las llaves, las exclusiones de git y el documento de la API. | — |
redcumbre panel | Abre en el navegador el panel de la empresa del proyecto. | --empresa --sin-navegador |
redcumbre instalar | Deja instalado en el computador el CLI que corre por npx, en la misma versión, con npm install --global, comprueba que el redcumbre del PATH sea ése y renueva la skill donde ya está, incluso la que editaste (guarda tu copia al lado) y la que quitaste con redcumbre skill quitar. npx @redcumbrecl/cli@latest instalar deja al día el CLI y la skill desde cualquier versión. No pregunta ni pide confirmar; --confirmar se acepta por compatibilidad, sin efecto. | --confirmar |
redcumbre actualizar | Actualiza el CLI a la última versión publicada (por npm o pnpm global; desde npx lo deja instalado) y renueva la skill donde ya está, incluso la que editaste (guarda tu copia al lado). No repone lo que quitaste con redcumbre skill quitar. No pregunta ni pide confirmar; --confirmar se acepta por compatibilidad, sin efecto. | --confirmar |
Llaves y reseller
Sección titulada «Llaves y reseller»| Comando | Para qué sirve | Banderas |
|---|---|---|
redcumbre llaves | Lista las llaves de la empresa y marca las de este proyecto. | --empresa |
redcumbre llaves revocar | Revoca una llave; pide confirmar con el slug de la empresa. | --empresa --confirmar |
redcumbre llaves validafirma | Crea la llave con la que el CLI de ValidaFirma trabaja en una empresa; la de producción pide confirmar con el slug. | --empresa --alcance --modo --confirmar |
redcumbre reseller | Administra tu panel de reseller. | — |
redcumbre reseller credenciales | Credenciales de API de tu reseller; sin subcomando las lista. | --empresa |
redcumbre reseller credenciales listar | Lista las credenciales de API de tu reseller. | --empresa |
redcumbre reseller credenciales crear | Crea una credencial; el secreto queda en keys/, nunca en pantalla. | --tipo --entorno --nombre --vence --empresa |
redcumbre reseller credenciales revocar | Revoca una credencial. | --empresa |
Operar la API
Sección titulada «Operar la API»| Comando | Para qué sirve | Banderas |
|---|---|---|
redcumbre llamadas | Las últimas llamadas a la API hechas con la llave del proyecto. | --llave --produccion --desde --hasta --limite |
redcumbre estado | En qué modo está cada llave del proyecto y cuánto queda del tope diario de prueba. | --produccion |
redcumbre api | Sin operación lista las operaciones de la API; con una, la ejecuta con la llave del proyecto. | --param --cuerpo --archivo --campo --produccion --confirmar --ensayo --clave --todas --campos --salida |
redcumbre api describir | Explica una operación: parámetros, cuerpo, efecto y cobro. | — |
redcumbre api buscar | Busca operaciones por texto. | — |
redcumbre buscar | Busca en las guías y en la referencia de la API, con la llave del proyecto o con tu sesión. | — |
redcumbre consumo | Lo consumido del plan y los topes del día. | --produccion |
redcumbre tarifas | El precio de cada operación (o de la que indiques) en tu plan: lo incluido, la siguiente unidad y su tramo. | --produccion |
Cuando la operación recibe archivos (su cuerpo es multipart/form-data, como la carga del XML de una venta o de un
documento recibido), en vez de --cuerpo usas --archivo <campo>=@<ruta> por cada archivo y --campo <nombre>=<valor>
por cada campo de texto; las dos se repiten. redcumbre api describir <operación> muestra qué campos espera.
Guías del sitio
Sección titulada «Guías del sitio»| Comando | Para qué sirve | Banderas |
|---|---|---|
redcumbre guia | Trae una guía, ficha o mecánica del sitio en Markdown, sin sesión ni llave: redcumbre guia <tema> imprime ese tema y sin tema lista los que hay. Sin red entrega la última copia y dice su fecha | — |
Modo de prueba
Sección titulada «Modo de prueba»| Comando | Para qué sirve | Banderas |
|---|---|---|
redcumbre webhooks | Los webhooks de la empresa: su configuración y entregas, y recibirlos en tu computador. | — |
redcumbre webhooks escuchar | Recibe en tu computador los webhooks de la empresa y los reenvía a tu sitio. | --reenviar-a --eventos --empresa |
redcumbre eventos | Los eventos de webhook que puedes disparar en el modo de prueba. | — |
redcumbre eventos disparar | Dispara uno de esos eventos en el modo de prueba. | — |
redcumbre prueba | Comprobaciones de tu sitio contra el modo de prueba. | — |
redcumbre prueba verificar | Comprueba que tu sitio recibe los webhooks, valida la firma y no repite el efecto de una entrega duplicada. | --reenviar-a --efectos --eventos --empresa |
redcumbre escenarios | Los emisores, RUT y simulaciones del modo de prueba de la empresa. | — |
redcumbre bandeja | Los correos y mensajes que el modo de prueba retuvo en vez de enviarlos. | --canal --destinatario --limite |
redcumbre restaurar | Borra lo emitido en el modo de prueba y vuelve a sembrar los escenarios; pide confirmar. | --empresa --confirmar |
Emisores
Sección titulada «Emisores»| Comando | Para qué sirve | Banderas |
|---|---|---|
redcumbre tokenizar | Inscribe un emisor: la persona autoriza el uso de sus credenciales del SII y el CLI canjea el código. | --rut --tipo --autenticacion --correo --invitar --integracion --boletas --correo-empresa --contacto-correo --contacto-telefono --clave --espera --sin-navegador --produccion --confirmar |
redcumbre tokenizar canjear | Canjea el código de una autorización y muestra el emisor inscrito. | --codigo --produccion --confirmar |
redcumbre emisores | Administra los emisores de la empresa con la llave del proyecto: DTE, tributarios, sucursales y representantes. | — |
redcumbre emisores dte | Emisores de documentos tributarios electrónicos (DTE). | — |
redcumbre emisores dte listar | Lista los emisores DTE. | --rut --estado --integracion --limite --desde --todas |
redcumbre emisores dte por-defecto | Lista los emisores DTE fijados por defecto. | — |
redcumbre emisores dte existe | Verifica si un RUT ya es emisor DTE de la empresa. | — |
redcumbre emisores dte ver | Muestra el detalle de un emisor DTE. | --incluir-archivados |
redcumbre emisores dte certificacion | Certificación de un emisor DTE ante el SII. | — |
redcumbre emisores dte certificacion verificar | Verifica la certificación de un tipo de DTE. | — |
redcumbre emisores dte certificacion tipos | Lista los tipos de DTE que se pueden certificar. | — |
redcumbre emisores dte certificacion estado | Consulta el estado de la certificación de un RUT. | — |
redcumbre emisores dte certificacion certificar-tipos | Solicita la certificación de los tipos del carril del emisor. | --tipos --correo --telefono |
redcumbre emisores dte certificacion desistir | Desiste de una certificación en curso. | --rut --motivo |
redcumbre emisores dte mipyme | Portal MiPyme del SII para un emisor DTE. | — |
redcumbre emisores dte mipyme estado | Consulta el estado del emisor en el portal MiPyme. | — |
redcumbre emisores dte mipyme habilitar | Registra al emisor en el portal MiPyme. | — |
redcumbre emisores dte solicitudes | Lista las solicitudes de certificación de un emisor DTE. | — |
redcumbre emisores dte logo | Logo de un emisor DTE. | — |
redcumbre emisores dte logo ver | Muestra el logo del emisor. | — |
redcumbre emisores dte logo subir | Sube el logo del emisor. | --archivo |
redcumbre emisores dte logo quitar | Quita el logo del emisor. | — |
redcumbre emisores dte editar | Actualiza un emisor DTE. | --cuerpo |
redcumbre emisores dte fijar-por-defecto | Fija un emisor DTE por defecto. | — |
redcumbre emisores dte reactivar | Reactiva un emisor DTE archivado. | --cuerpo |
redcumbre emisores dte tipos-integracion | Tipos de integración de un emisor DTE. | — |
redcumbre emisores dte tipos-integracion crear | Crea un tipo de integración. | --cuerpo |
redcumbre emisores dte tipos-integracion editar | Actualiza un tipo de integración. | --cuerpo |
redcumbre emisores dte info-pago | Información de pago que sale en los DTE del emisor. | — |
redcumbre emisores dte info-pago guardar | Guarda la información de pago. | --cuerpo |
redcumbre emisores dte info-pago quitar | Elimina la información de pago. | — |
redcumbre emisores dte resolver-conflictos | Resuelve los conflictos de un emisor DTE. | --cuerpo |
redcumbre emisores dte migrar | Solicita la migración de un emisor DTE. | --tipos --correo --telefono |
redcumbre emisores dte ambiente | Cambia el ambiente de un tipo de DTE del emisor. | --tipo-dte --ambiente |
redcumbre emisores dte archivar | Archiva un emisor DTE. | --rut |
redcumbre emisores dte sincronizar | Actualiza los datos de un emisor DTE desde el SII. | — |
redcumbre emisores dte credencial | Credencial del emisor ante el portal del SII. | — |
redcumbre emisores dte credencial reintentar | Reintenta validar la credencial del emisor. | — |
redcumbre emisores dte volver-a-mipyme | Vuelve al Portal MiPyme un RUT con certificación propia de facturas, en todas las empresas que lo usan. | --rut |
redcumbre emisores dte crear | Crea un emisor DTE con la llave del proyecto (servicio «Alta de emisores con certificado por API»). | --cuerpo |
redcumbre emisores tributarios | Emisores tributarios (boletas de honorarios y de terceros). | — |
redcumbre emisores tributarios archivar | Archiva un emisor tributario. | — |
redcumbre emisores tributarios listar | Lista los emisores tributarios. | --rut --estado --credencial --limite --desde --todas |
redcumbre emisores tributarios por-defecto | Muestra el emisor tributario por defecto. | — |
redcumbre emisores tributarios existe | Consulta si un RUT ya es emisor tributario de la empresa. | — |
redcumbre emisores tributarios ver | Muestra el detalle de un emisor tributario. | --incluir-archivados |
redcumbre emisores tributarios logo | Logo de un emisor tributario. | — |
redcumbre emisores tributarios logo ver | Muestra el logo del emisor. | — |
redcumbre emisores tributarios logo subir | Sube el logo del emisor. | --archivo |
redcumbre emisores tributarios logo quitar | Quita el logo del emisor. | — |
redcumbre emisores tributarios certificado | Muestra el certificado del emisor tributario. | — |
redcumbre emisores tributarios editar | Actualiza un emisor tributario. | --cuerpo |
redcumbre emisores tributarios fijar-por-defecto | Fija el emisor tributario por defecto. | — |
redcumbre emisores tributarios reactivar | Reactiva un emisor tributario archivado. | --cuerpo |
redcumbre emisores tributarios crear | Crea un emisor tributario con la llave del proyecto (servicio «Alta de emisores con certificado por API»). | --cuerpo |
redcumbre emisores tributarios certificado-subir | Sube el certificado digital del emisor tributario; la clave del archivo no va por argumento. | --archivo --clave-desde-stdin |
redcumbre emisores tributarios certificado-quitar | Quita el certificado digital del emisor tributario. | — |
redcumbre emisores tributarios credencial | Credencial del emisor ante el SII. | — |
redcumbre emisores tributarios credencial reintentar | Reintenta validar la credencial del emisor. | — |
redcumbre emisores sucursales | Sucursales de los emisores DTE. | — |
redcumbre emisores sucursales listar | Lista las sucursales. | --activo --tributaria --limite --desde --todas |
redcumbre emisores sucursales crear | Crea una sucursal. | --cuerpo |
redcumbre emisores sucursales editar | Actualiza una sucursal. | --cuerpo |
redcumbre emisores sucursales desactivar | Desactiva una sucursal. | — |
redcumbre emisores representantes | Representantes legales de los emisores. | — |
redcumbre emisores representantes listar | Lista los representantes legales y la vigencia de su certificado. | --rut --limite --desde --todas |
redcumbre emisores representantes renovar-cert | Renueva el certificado digital de un representante legal. | --archivo --clave-desde-stdin |
redcumbre emisores revocar | Revoca un emisor inscrito por tokenización. | --tipo --motivo |
redcumbre certificados | Certificados digitales de la empresa (servicio «Alta de emisores con certificado por API»), con la llave del proyecto. | — |
redcumbre certificados listar | Lista los certificados de la empresa. | --buscar --pagina --limite |
redcumbre certificados ver | Muestra el detalle de un certificado. | — |
redcumbre certificados verificar | Verifica un certificado: vigencia y clave. | — |
redcumbre certificados subir | Sube un certificado digital; la clave del archivo no va por argumento. | --archivo --clave-desde-stdin |
redcumbre certificados eliminar | Elimina un certificado. | — |
redcumbre folios | Folios de los emisores: CAF, solicitud y anulación de folios ante el SII, con la llave del proyecto. | — |
redcumbre folios subir | Sube el CAF de un emisor. | --emisor --archivo |
redcumbre folios listar | Lista los CAF de la empresa. | --emisor --tipo-dte --estado --limite --desde --todas |
redcumbre folios estadisticas | Muestra las estadísticas de folios de los CAF. | --emisor |
redcumbre folios anular | Anula un CAF completo. | --rut --clave |
redcumbre folios anular-folios | Anula un rango de folios de un CAF. | --folio-desde --folio-hasta --motivo --rut --clave |
redcumbre folios documentos-autorizados | Consulta los documentos que el SII tiene autorizados para el emisor. | --emisor --ambiente |
redcumbre folios consultar | Consulta en el SII los folios disponibles de un tipo de documento. | --emisor --tipo-dte --cantidad |
redcumbre folios solicitar | Solicita folios al SII. | --emisor --tipo-dte --cantidad --rut --clave |
redcumbre folios tipos-disponibles | Lista los tipos de folios que el emisor puede pedir. | --emisor |
redcumbre folios automatica | Solicitud automática de folios. | — |
redcumbre folios automatica ver | Muestra la solicitud automática de folios. | --emisor |
redcumbre folios automatica cambiar | Cambia la solicitud automática de folios. | --emisor --tipo-dte --habilitado --umbral --cantidad --maximo |
redcumbre folios anulaciones | Anulaciones de folios y su reporte al SII. | — |
redcumbre folios anulaciones listar | Lista las anulaciones de folios y el estado de su reporte al SII. | --emisor --tipo-dte --estado --origen --limite --desde --todas |
redcumbre folios anulaciones ver | Muestra el detalle de una anulación de folios. | — |
redcumbre folios anulaciones reintentar | Reintenta el reporte de una anulación al SII. | --rut --clave |
redcumbre configuracion | Configuración documental de la empresa con la llave del proyecto: ValidaFirma, logo, documentos, plantillas, topes, llamadas, suscripción, PIN, canal de agentes, ventas y correo. | — |
redcumbre configuracion validafirma | Configuración de ValidaFirma. | — |
redcumbre configuracion validafirma ver | Muestra la configuración de ValidaFirma de la empresa. | — |
redcumbre configuracion validafirma crear | Crea la configuración de ValidaFirma. | --cuerpo |
redcumbre configuracion validafirma actualizar | Activa o desactiva ValidaFirma. | --activo |
redcumbre configuracion validafirma quitar | Elimina la configuración de ValidaFirma. | — |
redcumbre configuracion logo | Logo de la empresa. | — |
redcumbre configuracion logo subir | Sube el logo de la empresa. | --archivo |
redcumbre configuracion logo ver | Muestra el logo de la empresa. | — |
redcumbre configuracion logo quitar | Quita el logo de la empresa. | — |
redcumbre configuracion bhe | Configuración documental de boletas de honorarios. | — |
redcumbre configuracion bhe ver | Muestra la configuración documental de boletas de honorarios. | — |
redcumbre configuracion bhe cambiar | Cambia la configuración documental de boletas de honorarios. | --modo |
redcumbre configuracion bhet | Configuración documental de boletas de terceros. | — |
redcumbre configuracion bhet ver | Muestra la configuración documental de boletas de terceros. | — |
redcumbre configuracion bhet cambiar | Cambia la configuración documental de boletas de terceros. | --modo |
redcumbre configuracion dte | Configuración documental de los DTE. | — |
redcumbre configuracion dte ver | Muestra la configuración documental de los DTE. | — |
redcumbre configuracion dte cambiar | Cambia la configuración documental de los DTE. | --modo |
redcumbre configuracion boleta | Configuración documental de las boletas. | — |
redcumbre configuracion boleta ver | Muestra la configuración documental de las boletas. | — |
redcumbre configuracion boleta cambiar | Cambia la configuración documental de las boletas. | --modo |
redcumbre configuracion cache-contribuyentes | Caché de contribuyentes. | — |
redcumbre configuracion cache-contribuyentes ver | Muestra la configuración de la caché de contribuyentes. | — |
redcumbre configuracion cache-contribuyentes cambiar | Cambia la configuración de la caché de contribuyentes. | --cuerpo |
redcumbre configuracion info-pago | Información de pago de la empresa. | — |
redcumbre configuracion info-pago ver | Muestra la información de pago de la empresa. | — |
redcumbre configuracion info-pago guardar | Guarda la información de pago de la empresa. | --html |
redcumbre configuracion info-pago quitar | Elimina la información de pago de la empresa. | — |
redcumbre configuracion plantillas | Plantillas de los documentos. | — |
redcumbre configuracion plantillas listar | Lista las plantillas del catálogo. | --tipo-documento --formato-papel --estado |
redcumbre configuracion plantillas ver | Muestra una plantilla del catálogo. | — |
redcumbre configuracion plantillas tipos-de-documento | Lista los tipos de documento que tienen plantilla. | — |
redcumbre configuracion plantillas formatos-de-papel | Lista los formatos de papel de las plantillas. | — |
redcumbre configuracion plantillas vista-previa | Genera la vista previa de una plantilla. | --formato --salida |
redcumbre configuracion plantillas vista-previa-con-datos | Genera la vista previa de una plantilla con los datos que le pasas. | --formato --cuerpo --salida |
redcumbre configuracion plantillas elegidas | Muestra las plantillas que eligió la empresa. | — |
redcumbre configuracion plantillas elegir | Elige las plantillas de la empresa. | --cuerpo |
redcumbre configuracion plantillas opciones | Lista las plantillas disponibles para un tipo de documento. | — |
redcumbre configuracion plantillas vista-previa-de-empresa | Genera la vista previa de una plantilla con los datos de la empresa. | --formato --salida |
Configuración general
Sección titulada «Configuración general»Con la llave del proyecto, redcumbre configuracion también administra los topes, el registro de llamadas, la suscripción, el PIN, el canal de agentes, las ventas y el correo de la empresa. Cada subgrupo tiene su tabla.
Topes de ValidaFirma
Sección titulada «Topes de ValidaFirma»Lee los topes de la empresa y pide una ampliación. El historial de protección y la solicitud no se cobran.
| Comando | Para qué sirve | Banderas |
|---|---|---|
redcumbre configuracion topes | Topes de ValidaFirma de la empresa. | — |
redcumbre configuracion topes ver | Muestra los topes de ValidaFirma de la empresa. | — |
redcumbre configuracion topes historial-de-proteccion | Lista el historial de la protección de topes. | --limite --desde --todas |
redcumbre configuracion topes pedir-ampliacion | Pide ampliar un tope; la empresa tiene una solicitud pendiente a la vez. | --valor --motivo |
Registro de llamadas
Sección titulada «Registro de llamadas»Lista las llamadas que las llaves de la empresa hicieron a la API en los últimos 30 días. Las fechas van en formato ISO 8601 con --desde-fecha y --hasta-fecha; --desde es el desplazamiento de la página.
| Comando | Para qué sirve | Banderas |
|---|---|---|
redcumbre configuracion llamadas | Registro de llamadas de las llaves de la empresa. | — |
redcumbre configuracion llamadas listar | Lista las llamadas de las llaves, con su código de respuesta, duración y traza. | --desde-fecha --hasta-fecha --codigo --metodo --ruta --llave-id --traza --limite --desde --todas |
Suscripción
Sección titulada «Suscripción»Lee los adicionales, el plan y el resumen de pagos de la suscripción de la empresa.
| Comando | Para qué sirve | Banderas |
|---|---|---|
redcumbre configuracion suscripcion | Suscripción de la empresa. | — |
redcumbre configuracion suscripcion adicionales | Adicionales de la suscripción. | — |
redcumbre configuracion suscripcion adicionales listar | Lista los adicionales de la suscripción. | — |
redcumbre configuracion suscripcion adicionales ver | Muestra un adicional de la suscripción con su consumo. | — |
redcumbre configuracion suscripcion plan | Muestra el plan de la suscripción y su consumo. | — |
redcumbre configuracion suscripcion resumen | Muestra los pagos pendientes y vencidos de la suscripción. | — |
Administra las integraciones de PIN de la empresa. Una integración desactivada se puede reactivar; el slug no cambia nunca.
| Comando | Para qué sirve | Banderas |
|---|---|---|
redcumbre configuracion pin | Integraciones de PIN de la empresa. | — |
redcumbre configuracion pin listar | Lista las integraciones de PIN. | — |
redcumbre configuracion pin crear | Crea una integración de PIN. | --cuerpo |
redcumbre configuracion pin actualizar | Actualiza una integración de PIN. | --cuerpo |
redcumbre configuracion pin desactivar | Desactiva una integración de PIN. | — |
redcumbre configuracion pin reactivar | Reactiva una integración de PIN. | — |
redcumbre configuracion pin estadisticas | Muestra las estadísticas de una integración de PIN en un período. | --periodo |
Canal de agentes
Sección titulada «Canal de agentes»Lee la actividad del canal por el que los asistentes operan en nombre de la empresa, lo apaga o lo prende y quita la conexión de un asistente.
| Comando | Para qué sirve | Banderas |
|---|---|---|
redcumbre configuracion canal | Canal de agentes de la empresa. | — |
redcumbre configuracion canal actividad | Lista la actividad del canal de los últimos 180 días. | --desde-fecha --hasta-fecha --persona-id --asistente --herramienta --resultado --cliente-id --limite --desde --todas |
redcumbre configuracion canal opciones-de-actividad | Lista las personas y los asistentes por los que puedes filtrar la actividad. | — |
redcumbre configuracion canal conexiones | Lista las conexiones de asistentes de la empresa. | — |
redcumbre configuracion canal hechos | Lista los hechos del canal: quién lo apagó, lo prendió o quitó una conexión. | --limite --desde --todas |
redcumbre configuracion canal estado | Muestra si el canal está apagado y quién lo dejó así. | — |
redcumbre configuracion canal apagar | Apaga el canal y revoca las autorizaciones vigentes. | — |
redcumbre configuracion canal prender | Prende el canal; no revive las autorizaciones revocadas. | — |
redcumbre configuracion canal quitar | Quita la conexión de un asistente de la empresa. | — |
Administra las casillas de correo de ventas y los campos de la nota.
| Comando | Para qué sirve | Banderas |
|---|---|---|
redcumbre configuracion ventas | Ventas de la empresa. | — |
redcumbre configuracion ventas casillas | Casillas de correo de ventas. | — |
redcumbre configuracion ventas campos | Campos de la nota de venta. | — |
redcumbre configuracion ventas casillas listar | Lista las casillas de ventas con sus usos y alertas. | — |
redcumbre configuracion ventas casillas alertas | Lista las casillas con una alerta vigente. | — |
redcumbre configuracion ventas casillas tomar | Toma una casilla de ventas. | --parte-local |
redcumbre configuracion ventas casillas quitar | Quita una casilla de ventas; queda reservada 180 días para la misma empresa. | — |
redcumbre configuracion ventas campos listar | Lista los campos de la nota. | --archivo --tipo --visibilidad --busqueda --limite --desde --todas |
redcumbre configuracion ventas campos crear | Crea un campo de la nota. | --cuerpo |
redcumbre configuracion ventas campos ver | Muestra un campo de la nota. | — |
redcumbre configuracion ventas campos actualizar | Actualiza un campo de la nota. | --cuerpo |
redcumbre configuracion ventas campos archivar | Archiva un campo de la nota. | — |
Administra la identidad de correo con que sale lo que la empresa envía. La contraseña SMTP se entrega por --cuerpo @archivo o por la entrada estándar y el API no la devuelve nunca.
| Comando | Para qué sirve | Banderas |
|---|---|---|
redcumbre configuracion correo | Correo de la empresa. | — |
redcumbre configuracion correo identidades | Identidades de correo de la empresa. | — |
redcumbre configuracion correo ver | Muestra la configuración de correo y su identidad por defecto. | — |
redcumbre configuracion correo cambiar | Cambia la identidad de correo por defecto. | --cuerpo |
redcumbre configuracion correo identidades listar | Lista las identidades de correo. | — |
redcumbre configuracion correo identidades crear | Crea una identidad de correo. | --cuerpo |
redcumbre configuracion correo identidades actualizar | Actualiza una identidad de correo. | --cuerpo |
redcumbre configuracion correo identidades quitar | Elimina una identidad de correo. | — |
redcumbre configuracion correo identidades verificar-conexion | Verifica la conexión SMTP de una identidad. | — |
redcumbre configuracion correo identidades enviar-prueba | Envía un correo de prueba desde una identidad. | --a |
Plantillas de correo
Sección titulada «Plantillas de correo»Administra las plantillas de los correos de documentos que la empresa envía.
| Comando | Para qué sirve | Banderas |
|---|---|---|
redcumbre configuracion plantillas correo | Plantillas de los correos de documentos. | — |
redcumbre configuracion plantillas correo listar | Lista las plantillas de correo. | — |
redcumbre configuracion plantillas correo asignaciones | Muestra qué plantilla atiende cada subtipo de documento. | --proceso |
redcumbre configuracion plantillas correo contenido-por-defecto | Muestra el contenido por defecto de un proceso. | --proceso |
redcumbre configuracion plantillas correo ver | Muestra una plantilla de correo. | — |
redcumbre configuracion plantillas correo crear | Crea una plantilla de correo. | --cuerpo |
redcumbre configuracion plantillas correo actualizar | Actualiza una plantilla de correo. | --cuerpo |
redcumbre configuracion plantillas correo quitar | Elimina una plantilla de correo. | — |
redcumbre configuracion plantillas correo vista-previa | Genera la vista previa de una plantilla de correo. | --dte-id |
redcumbre usuarios | Personas de la empresa: invitar, editar, quitar, roles, sesiones, restablecer la clave y el PIN del puesto, con la llave del proyecto. | — |
redcumbre usuarios invitar | Invita a una persona a la empresa: Zitadel le envía el correo y ella elige su clave. | --cuerpo |
redcumbre usuarios verificar-correo | Verifica si un correo ya es de una persona de la empresa. | --correo |
redcumbre usuarios listar | Lista las personas de la empresa. | --buscar --rol --pagina --limite --todas |
redcumbre usuarios ver | Muestra a una persona de la empresa. | — |
redcumbre usuarios editar | Edita nombre, apellido o teléfono de una persona. | --cuerpo |
redcumbre usuarios quitar | Quita a una persona de la empresa. | — |
redcumbre usuarios pin-del-puesto | Consulta el estado del PIN del puesto de una persona. | — |
redcumbre usuarios opera-en-puestos | Marca si una persona opera en puestos. | --opera |
redcumbre usuarios asignar-roles | Asigna roles a una persona, dentro del techo de roles de la llave. | --cuerpo |
redcumbre usuarios roles | Lista los roles de una persona en la empresa. | — |
redcumbre usuarios restablecer-clave | Envía a la persona el correo para elegir una clave nueva; la respuesta no trae la clave. | — |
redcumbre usuarios sesiones | Lista las sesiones abiertas de una persona. | — |
redcumbre usuarios cerrar-sesiones | Cierra todas las sesiones abiertas de una persona. | --motivo |
redcumbre roles | Roles que una llave puede asignar a las personas de la empresa. | — |
redcumbre roles listar | Lista los roles que una llave puede asignar. | — |
redcumbre roles asignables | Lista los roles asignables. | — |
redcumbre roles asignables-de-empresa | Lista los roles asignables en la empresa de la llave. | — |
redcumbre roles ver | Muestra un rol. | — |
redcumbre grupos-de-roles | Grupos de roles de la empresa y las personas que los tienen. | — |
redcumbre grupos-de-roles listar | Lista los grupos de roles de la empresa. | --activo --con-conteo |
redcumbre grupos-de-roles sincronizacion | Consulta si los grupos de roles están sincronizados. | — |
redcumbre grupos-de-roles ver | Muestra un grupo de roles. | — |
redcumbre grupos-de-roles usuarios | Lista las personas que tienen un grupo de roles. | — |
redcumbre grupos-de-roles crear | Crea un grupo de roles. | --cuerpo |
redcumbre grupos-de-roles editar | Edita un grupo de roles. | --cuerpo |
redcumbre grupos-de-roles eliminar | Elimina un grupo de roles. | — |
redcumbre grupos-de-roles activar-o-desactivar | Activa o desactiva un grupo de roles. | — |
redcumbre grupos-de-personas | Grupos de personas de la empresa. | — |
redcumbre grupos-de-personas listar | Lista los grupos de personas. | --buscar --limite --desde --todas |
redcumbre grupos-de-personas crear | Crea un grupo de personas. | --cuerpo |
redcumbre grupos-de-personas ver | Muestra un grupo de personas. | — |
redcumbre grupos-de-personas editar | Renombra un grupo de personas. | --nombre |
redcumbre grupos-de-personas archivar | Archiva un grupo de personas. | — |
redcumbre grupos-de-personas agregar-persona | Agrega una persona a un grupo. | --usuario |
redcumbre grupos-de-personas consultar-quitar-persona | Consulta qué pasa al quitar a una persona de un grupo. | — |
redcumbre grupos-de-personas quitar-persona | Quita a una persona de un grupo. | — |
redcumbre areas | Áreas de trabajo de la empresa y sus bodegas. | — |
redcumbre areas listar | Lista las áreas de trabajo. | --buscar --estado --pagina --limite --todas |
redcumbre areas crear | Crea un área de trabajo. | --cuerpo |
redcumbre areas opciones | Lista las áreas para elegir una. | — |
redcumbre areas ver | Muestra un área con sus puestos y bodegas. | — |
redcumbre areas quien-opero | Lista quién operó en un área. | --pagina --limite --todas |
redcumbre areas disponibles | Muestra las personas disponibles en los puestos de un área. | — |
redcumbre areas editar | Edita un área de trabajo. | --cuerpo |
redcumbre areas archivar | Archiva un área de trabajo. | — |
redcumbre areas asociar-bodegas | Define las bodegas de un área. | --cuerpo |
redcumbre puestos | Configuración y consulta de los puestos de trabajo. Registrar, reconectar, anular y levantar el bloqueo no son de la llave. | — |
redcumbre puestos configuracion | Muestra la configuración de los puestos. | — |
redcumbre puestos cambio-rapido | Enciende o apaga el cambio rápido de puestos. | --cuerpo |
redcumbre puestos tiempos | Cambia los tiempos de los puestos. | --cuerpo |
redcumbre puestos listar | Lista los puestos de trabajo. | --buscar --estado --area --pagina --limite --todas |
redcumbre puestos ver | Muestra un puesto de trabajo. | — |
redcumbre puestos editar | Edita un puesto de trabajo. | --cuerpo |
redcumbre puestos desactivar | Da de baja un puesto de trabajo. | — |
redcumbre puestos movimientos | Lista los movimientos de un puesto. | --pagina --limite --todas |
redcumbre sucursales-de-usuarios | Sucursales asignadas a las personas de la empresa. | — |
redcumbre sucursales-de-usuarios asignar | Asigna sucursales a una persona. | --cuerpo |
redcumbre sucursales-de-usuarios para-asignacion | Lista las sucursales que se pueden asignar. | — |
redcumbre sucursales-de-usuarios listar | Lista las sucursales asignadas a una persona. | — |
redcumbre sucursales-de-usuarios quitar-de-emisor | Quita las sucursales de una persona en un emisor. | — |
Webhooks de la empresa
Sección titulada «Webhooks de la empresa»Con la llave del proyecto, redcumbre webhooks también administra la configuración de los webhooks de la empresa (la URL, los eventos, las cabeceras y el secreto de firma) y lee su historial de entregas. crear y regenerar-secreto imprimen el secreto de firma una sola vez, con el aviso «Guárdalo: no se vuelve a mostrar»: cópialo en ese momento a la configuración de tu sitio. Después ni ver ni el panel lo vuelven a entregar. Con --cuerpo van la URL, los eventos, las cabeceras y activo (JSON, @archivo o -).
| Comando | Para qué sirve | Banderas |
|---|---|---|
redcumbre webhooks configuracion | Configuración de webhooks de la empresa. | — |
redcumbre webhooks configuracion ver | Muestra la configuración de webhooks y si el secreto ya está configurado. | — |
redcumbre webhooks configuracion crear | Crea la configuración de webhooks y entrega el secreto de firma una sola vez. | --cuerpo |
redcumbre webhooks configuracion actualizar | Cambia la URL, los eventos, las cabeceras o el encendido de los webhooks. | --cuerpo |
redcumbre webhooks configuracion regenerar-secreto | Genera un secreto de firma nuevo, lo entrega una sola vez y pide confirmar con el slug. | --anterior |
redcumbre webhooks entregas | Historial de entregas de webhooks. | — |
redcumbre webhooks entregas listar | Lista las entregas de webhooks, con su resultado y el código HTTP. | --resultado --evento --desde-fecha --hasta-fecha --pagina --limite |
redcumbre webhooks entregas ver | Muestra una entrega con sus intentos. | — |
Asistentes
Sección titulada «Asistentes»| Comando | Para qué sirve | Banderas |
|---|---|---|
redcumbre skill | La skill del integrador que el CLI instala en tus carpetas de skills. | — |
redcumbre skill quitar | Quita la skill de tus carpetas y del proyecto; login e init no la vuelven a instalar. | — |
redcumbre skill renovar | Renueva la skill donde ya está con la de esta versión del CLI. Lo que editaste lo reemplaza igual, sin preguntar, y guarda tu copia al lado. --reemplazar-editada y --confirmar se aceptan por compatibilidad, sin efecto. | --reemplazar-editada --confirmar |
redcumbre mcp | El servidor MCP de REDCUMBRE en tu asistente de código. | — |
redcumbre mcp agregar | Conecta el servidor MCP de REDCUMBRE en tu asistente. | --asistente |
redcumbre mcp quitar | Desconecta el servidor MCP de REDCUMBRE de tu asistente. | --asistente |
La clave de un certificado digital
Sección titulada «La clave de un certificado digital»Los comandos que suben un archivo .pfx o .p12 (certificados subir, emisores tributarios certificado-subir,
emisores representantes renovar-cert) llevan el archivo con --archivo y la clave del archivo nunca por
argumento, para que no quede en el historial del terminal. La clave sale de la entrada estándar con
--clave-desde-stdin, de la variable de entorno REDCUMBRE_CLAVE_PFX o, con terminal, de una pregunta que no
muestra lo que escribes. Sin ninguna de las tres, el comando sale con el código 2 sin llamar a la API. Estas operaciones son del servicio
«Alta de emisores con certificado por API».
Banderas comunes
Sección titulada «Banderas comunes»Estas banderas las traen todos los comandos que se ejecutan (los que no tienen subcomandos) dentro del alcance que indica la primera columna.
| Alcance | Banderas | Qué hacen |
|---|---|---|
redcumbre | --json | Modo agente: no pregunta y deja un solo JSON en la salida estándar, nunca el secreto de una llave |
redcumbre emisores | --produccion --confirmar --ensayo | Operan con la llave de producción, la confirman con el slug de la empresa o muestran la petición sin hacerla |
redcumbre certificados | --produccion --confirmar --ensayo | Operan con la llave de producción, la confirman con el slug de la empresa o muestran la petición sin hacerla |
redcumbre folios | --produccion --confirmar --ensayo | Operan con la llave de producción, la confirman con el slug de la empresa o muestran la petición sin hacerla |
redcumbre configuracion | --produccion --confirmar --ensayo | Operan con la llave de producción, la confirman con el slug de la empresa o muestran la petición sin hacerla |
redcumbre usuarios | --produccion --confirmar --ensayo | Operan con la llave de producción, la confirman con el slug de la empresa o muestran la petición sin hacerla |
redcumbre roles | --produccion --confirmar --ensayo | Operan con la llave de producción, la confirman con el slug de la empresa o muestran la petición sin hacerla |
redcumbre grupos-de-roles | --produccion --confirmar --ensayo | Operan con la llave de producción, la confirman con el slug de la empresa o muestran la petición sin hacerla |
redcumbre grupos-de-personas | --produccion --confirmar --ensayo | Operan con la llave de producción, la confirman con el slug de la empresa o muestran la petición sin hacerla |
redcumbre areas | --produccion --confirmar --ensayo | Operan con la llave de producción, la confirman con el slug de la empresa o muestran la petición sin hacerla |
redcumbre puestos | --produccion --confirmar --ensayo | Operan con la llave de producción, la confirman con el slug de la empresa o muestran la petición sin hacerla |
redcumbre sucursales-de-usuarios | --produccion --confirmar --ensayo | Operan con la llave de producción, la confirman con el slug de la empresa o muestran la petición sin hacerla |
redcumbre webhooks configuracion | --produccion --confirmar --ensayo | Operan con la llave de producción, la confirman con el slug de la empresa o muestran la petición sin hacerla |
redcumbre webhooks entregas | --produccion --confirmar --ensayo | Operan con la llave de producción, la confirman con el slug de la empresa o muestran la petición sin hacerla |
Versión nueva y actualización
Sección titulada «Versión nueva y actualización»Una vez al día, con 1,5 segundos de tope, el CLI pregunta al registro de paquetes si hay una versión más nueva. Con una persona en la terminal lo avisa en una línea. En modo agente el JSON trae, en la raíz y con el mismo código de salida,
{ "actualizacion": { "instalada": "0.5.0", "disponible": "0.6.0", "comando": "redcumbre actualizar" } }y un texto en avisos. Si el registro no responde, no se informa nada. redcumbre actualizar detecta cómo está
instalado el CLI y corre la actualización con la versión exacta: npm install --global o pnpm add --global;
desde npx, lo deja instalado con npm install --global. Si no reconoce la instalación —por ejemplo, un CLI que es dependencia de un proyecto—
no cambia nada, sale 1 con INSTALACION_NO_RECONOCIDA y dice qué correr a mano. Sin red sale 7
(REGISTRO_NO_DISPONIBLE).
Mientras el CLI corre por npx, cada respuesta en modo agente trae también
{ "instalacion": { "version": "0.6.0", "enElPath": null, "instalado": false, "comando": "npx @redcumbrecl/cli@0.6.0 instalar", "prefijo": "npx @redcumbrecl/cli@0.6.0" } }y un texto en avisos: el agente lo instala él mismo con comando, sin preguntarle a la persona. Mientras tanto, en
cada comando que diga redcumbre … usa prefijo, con la versión fija. Con instalado: true, el redcumbre del PATH ya
es esa versión o una posterior. Por npx, actualizacion.comando también va por npx. Con una persona en la terminal, el
mismo aviso es una línea en la salida de errores.
La skill sabe de qué versión es. Al instalarla, el CLI escribe una línea <!-- redcumbre-cli: <versión> -->
justo después del frontmatter. En cada comando, si la skill instalada es de una versión anterior, el CLI la renueva
y lo dice en avisos, también si la editaste: la reemplaza igual, sin preguntar, y guarda tu versión al lado
(SKILL.md.editada-<fecha>), con la ruta en el mismo aviso. Sólo si no pudo guardar esa copia (la carpeta no se
puede escribir) no la toca y avisa, como máximo una vez al día, cómo renovarla a mano. Nunca la cambia por una
versión más vieja, y lo que quitaste con redcumbre skill quitar sigue quitado salvo que corras redcumbre instalar
o redcumbre skill renovar; lo que borraste a mano, sin skill quitar, el CLI lo vuelve a instalar. La skill que se
instala a mano desde redcumbre/skills, sin el CLI, no se renueva sola.
Banderas de producción
Sección titulada «Banderas de producción»El CLI trabaja con la llave de prueba salvo que le pidas lo contrario. Para tocar producción hay que pedirlo y confirmarlo:
| Bandera | Qué hace |
|---|---|
--produccion | Usa la llave de producción del proyecto en vez de la de prueba. Un comando que escribe en producción pide además confirmar |
--confirmar <slug> | Confirma sin preguntar, con el slug de la empresa (el tenantSlug). Es obligatoria sin terminal o con --json; con otro slug sale con el código 3 |
--ensayo | Muestra la petición que haría, sin hacerla |
--instalar <comando> | De pasar-a-produccion: después de crear la llave corre tu comando con la llave sólo en la variable de entorno REDCUMBRE_VALOR_LLAVE_PRODUCCION de ese proceso |
--comprobar <comando> | De pasar-a-produccion, con --instalar: corre tu comando sin la variable y comprueba que imprime el whoami de la empresa en producción |
Para operar en producción se escribe --produccion --confirmar <slug>: sin eso no se toca nada. Lo
emitido en producción es de verdad ante el SII y se cobra según tu plan; un documento tributario
emitido no se deshace, se anula. La llave de producción se agrega sólo con redcumbre pasar-a-produccion.
Códigos de salida
Sección titulada «Códigos de salida»Son estables: un agente decide con ellos. La tercera columna es el error.codigo que lleva el JSON
de error cuando el error no trae uno más específico.
| Código | Significado | error.codigo |
|---|---|---|
| 0 | Listo | — |
| 1 | Error del CLI o del proyecto; también CLI_DESACTUALIZADO (actualiza con npx @redcumbrecl/cli@latest instalar), INSTALACION_NO_RECONOCIDA, ACTUALIZACION_FALLIDA y ACTUALIZACION_INCOMPLETA de redcumbre actualizar, e INSTALACION_FALLIDA e INSTALACION_INCOMPLETA de redcumbre instalar | ERROR_DEL_CLI |
| 2 | Uso incorrecto: un comando, una opción o un valor que no existe | USO_INCORRECTO |
| 3 | Falta la confirmación de una persona | FALTA_CONFIRMACION |
| 4 | Falta iniciar sesión, o la sesión venció | SIN_SESION |
| 5 | Falta la llave, o la API la rechaza | SIN_LLAVE |
| 6 | La API respondió un error 4xx; también un límite de uso alcanzado | API_RECHAZO |
| 7 | La API respondió un error 5xx o no respondió; también redcumbre guia sin red y sin una copia del tema (GUIA_NO_DISPONIBLE), o cuando el sitio respondió algo que no es una guía: otro tipo de contenido, una página HTML, más de 2 MiB o una versión sin hash: (GUIA_INVALIDA); y redcumbre actualizar sin respuesta del registro de paquetes (REGISTRO_NO_DISPONIBLE) | API_NO_DISPONIBLE |
| 8 | La llave es de otro modo: de prueba en vez de producción, o al revés | PROHIBIDO_POR_EL_MODO |
| 9 | prueba verificar: tu sitio no pasó la verificación | VERIFICACION_FALLIDA |
| 10 | Tu versión de Node es menor que la que el CLI necesita (Node 20 o superior): el mensaje dice cuál tienes; actualiza Node en https://nodejs.org y vuelve a correrlo | NODE_NO_SOPORTADO |
Dónde quedan los archivos
Sección titulada «Dónde quedan los archivos»En tu proyecto, en la carpeta donde corres el comando:
keys/redcumbre-prueba.jsonykeys/redcumbre-produccion.json: la llave de cada modo, con el mismo formato JSON que descarga la pantalla web de llaves y permisos0600.keys/validafirma-<empresa>-<alcance>-<modo>.jsonykeys/reseller-<empresa>-<tipo>-<entorno>.json: las llaves que creanllaves validafirmayreseller credenciales crear..env: sólo apunta a la llave, conREDCUMBRE_LLAVE_PRUEBAoREDCUMBRE_LLAVE_PRODUCCION. El secreto no está en el.env..redcumbre/estado.json: el avance del proyecto (la empresa y, por modo, el nombre de la variable y el id de la llave)..claude/skills/redcumbre/,.agents/skills/redcumbre/y un bloque delimitado enAGENTS.md: la skill del integrador.
keys/, .redcumbre/ y el .env (si no lo versionabas ya) quedan fuera del control de versiones
desde que existen.
Tu sesión va al llavero del sistema (servicio redcumbrecl-cli). Sólo si el computador no tiene llavero —un
Linux sin servicio de secretos, un contenedor— queda en sesion.json (0600) dentro de la carpeta de configuración
del CLI; REDCUMBRE_SESION_EN_ARCHIVO=1 fuerza ese archivo aunque haya llavero.
En tu computador, fuera del proyecto, en la carpeta de configuración del CLI
($XDG_CONFIG_HOME/redcumbre, ~/.config/redcumbre o %APPDATA%\redcumbre): la sesión cuando no hay llavero,
el inicio de sesión pendiente, una copia del documento de la API
(api-docs.json), el registro de la skill (skill.json, con el hash de lo que escribió en cada ruta), la marca de la última consulta de
versión y guias/, las copias de las guías que baja redcumbre guia. Nunca guarda tu sesión
dentro de un proyecto.
La llave de producción no aparece
Sección titulada «La llave de producción no aparece»La llave de producción no aparece en la pantalla, en la salida del CLI (tampoco con --json),
en la línea de comandos de otro proceso, en el historial de tu shell ni en los logs. Con
--instalar, el CLI la entrega sólo en la variable de entorno REDCUMBRE_VALOR_LLAVE_PRODUCCION
del comando que le indicas, y un comando que la imprime la ve como [oculto].
El límite: la llave queda además en keys/redcumbre-produccion.json, así que un agente con acceso al
disco de tu proyecto puede leerla. Por eso la skill del integrador le prohíbe leer keys/, ponerla
en el código o mostrarla en la conversación.