Ir al contenido

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:

Ventana de terminal
npx @redcumbrecl/cli init

y 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.

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.

ComandoPara qué sirveBanderas
redcumbreSin comando muestra la ayuda y la lista de comandos.--version --help
redcumbre initConecta 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-produccionRevisa 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 loginInicia 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 logoutCierra la sesión: la revoca en el servidor de identidad y la borra de este computador.—
redcumbre solicitar-cuentaPide una cuenta en REDCUMBRE para tu empresa; lo hace una persona.—
redcumbre doctorRevisa la sesión, la empresa, las llaves, las exclusiones de git y el documento de la API.—
redcumbre panelAbre en el navegador el panel de la empresa del proyecto.--empresa --sin-navegador
redcumbre instalarDeja 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 actualizarActualiza 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
ComandoPara qué sirveBanderas
redcumbre llavesLista las llaves de la empresa y marca las de este proyecto.--empresa
redcumbre llaves revocarRevoca una llave; pide confirmar con el slug de la empresa.--empresa --confirmar
redcumbre llaves validafirmaCrea 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 resellerAdministra tu panel de reseller.—
redcumbre reseller credencialesCredenciales de API de tu reseller; sin subcomando las lista.--empresa
redcumbre reseller credenciales listarLista las credenciales de API de tu reseller.--empresa
redcumbre reseller credenciales crearCrea una credencial; el secreto queda en keys/, nunca en pantalla.--tipo --entorno --nombre --vence --empresa
redcumbre reseller credenciales revocarRevoca una credencial.--empresa
ComandoPara qué sirveBanderas
redcumbre llamadasLas últimas llamadas a la API hechas con la llave del proyecto.--llave --produccion --desde --hasta --limite
redcumbre estadoEn qué modo está cada llave del proyecto y cuánto queda del tope diario de prueba.--produccion
redcumbre apiSin 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 describirExplica una operación: parámetros, cuerpo, efecto y cobro.—
redcumbre api buscarBusca operaciones por texto.—
redcumbre buscarBusca en las guías y en la referencia de la API, con la llave del proyecto o con tu sesión.—
redcumbre consumoLo consumido del plan y los topes del día.--produccion
redcumbre tarifasEl 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.

ComandoPara qué sirveBanderas
redcumbre guiaTrae 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—
ComandoPara qué sirveBanderas
redcumbre webhooksLos webhooks de la empresa: su configuración y entregas, y recibirlos en tu computador.—
redcumbre webhooks escucharRecibe en tu computador los webhooks de la empresa y los reenvía a tu sitio.--reenviar-a --eventos --empresa
redcumbre eventosLos eventos de webhook que puedes disparar en el modo de prueba.—
redcumbre eventos dispararDispara uno de esos eventos en el modo de prueba.—
redcumbre pruebaComprobaciones de tu sitio contra el modo de prueba.—
redcumbre prueba verificarComprueba que tu sitio recibe los webhooks, valida la firma y no repite el efecto de una entrega duplicada.--reenviar-a --efectos --eventos --empresa
redcumbre escenariosLos emisores, RUT y simulaciones del modo de prueba de la empresa.—
redcumbre bandejaLos correos y mensajes que el modo de prueba retuvo en vez de enviarlos.--canal --destinatario --limite
redcumbre restaurarBorra lo emitido en el modo de prueba y vuelve a sembrar los escenarios; pide confirmar.--empresa --confirmar
ComandoPara qué sirveBanderas
redcumbre tokenizarInscribe 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 canjearCanjea el código de una autorización y muestra el emisor inscrito.--codigo --produccion --confirmar
redcumbre emisoresAdministra los emisores de la empresa con la llave del proyecto: DTE, tributarios, sucursales y representantes.—
redcumbre emisores dteEmisores de documentos tributarios electrónicos (DTE).—
redcumbre emisores dte listarLista los emisores DTE.--rut --estado --integracion --limite --desde --todas
redcumbre emisores dte por-defectoLista los emisores DTE fijados por defecto.—
redcumbre emisores dte existeVerifica si un RUT ya es emisor DTE de la empresa.—
redcumbre emisores dte verMuestra el detalle de un emisor DTE.--incluir-archivados
redcumbre emisores dte certificacionCertificación de un emisor DTE ante el SII.—
redcumbre emisores dte certificacion verificarVerifica la certificación de un tipo de DTE.—
redcumbre emisores dte certificacion tiposLista los tipos de DTE que se pueden certificar.—
redcumbre emisores dte certificacion estadoConsulta el estado de la certificación de un RUT.—
redcumbre emisores dte certificacion certificar-tiposSolicita la certificación de los tipos del carril del emisor.--tipos --correo --telefono
redcumbre emisores dte certificacion desistirDesiste de una certificación en curso.--rut --motivo
redcumbre emisores dte mipymePortal MiPyme del SII para un emisor DTE.—
redcumbre emisores dte mipyme estadoConsulta el estado del emisor en el portal MiPyme.—
redcumbre emisores dte mipyme habilitarRegistra al emisor en el portal MiPyme.—
redcumbre emisores dte solicitudesLista las solicitudes de certificación de un emisor DTE.—
redcumbre emisores dte logoLogo de un emisor DTE.—
redcumbre emisores dte logo verMuestra el logo del emisor.—
redcumbre emisores dte logo subirSube el logo del emisor.--archivo
redcumbre emisores dte logo quitarQuita el logo del emisor.—
redcumbre emisores dte editarActualiza un emisor DTE.--cuerpo
redcumbre emisores dte fijar-por-defectoFija un emisor DTE por defecto.—
redcumbre emisores dte reactivarReactiva un emisor DTE archivado.--cuerpo
redcumbre emisores dte tipos-integracionTipos de integración de un emisor DTE.—
redcumbre emisores dte tipos-integracion crearCrea un tipo de integración.--cuerpo
redcumbre emisores dte tipos-integracion editarActualiza un tipo de integración.--cuerpo
redcumbre emisores dte info-pagoInformación de pago que sale en los DTE del emisor.—
redcumbre emisores dte info-pago guardarGuarda la información de pago.--cuerpo
redcumbre emisores dte info-pago quitarElimina la información de pago.—
redcumbre emisores dte resolver-conflictosResuelve los conflictos de un emisor DTE.--cuerpo
redcumbre emisores dte migrarSolicita la migración de un emisor DTE.--tipos --correo --telefono
redcumbre emisores dte ambienteCambia el ambiente de un tipo de DTE del emisor.--tipo-dte --ambiente
redcumbre emisores dte archivarArchiva un emisor DTE.--rut
redcumbre emisores dte sincronizarActualiza los datos de un emisor DTE desde el SII.—
redcumbre emisores dte credencialCredencial del emisor ante el portal del SII.—
redcumbre emisores dte credencial reintentarReintenta validar la credencial del emisor.—
redcumbre emisores dte volver-a-mipymeVuelve al Portal MiPyme un RUT con certificación propia de facturas, en todas las empresas que lo usan.--rut
redcumbre emisores dte crearCrea un emisor DTE con la llave del proyecto (servicio «Alta de emisores con certificado por API»).--cuerpo
redcumbre emisores tributariosEmisores tributarios (boletas de honorarios y de terceros).—
redcumbre emisores tributarios archivarArchiva un emisor tributario.—
redcumbre emisores tributarios listarLista los emisores tributarios.--rut --estado --credencial --limite --desde --todas
redcumbre emisores tributarios por-defectoMuestra el emisor tributario por defecto.—
redcumbre emisores tributarios existeConsulta si un RUT ya es emisor tributario de la empresa.—
redcumbre emisores tributarios verMuestra el detalle de un emisor tributario.--incluir-archivados
redcumbre emisores tributarios logoLogo de un emisor tributario.—
redcumbre emisores tributarios logo verMuestra el logo del emisor.—
redcumbre emisores tributarios logo subirSube el logo del emisor.--archivo
redcumbre emisores tributarios logo quitarQuita el logo del emisor.—
redcumbre emisores tributarios certificadoMuestra el certificado del emisor tributario.—
redcumbre emisores tributarios editarActualiza un emisor tributario.--cuerpo
redcumbre emisores tributarios fijar-por-defectoFija el emisor tributario por defecto.—
redcumbre emisores tributarios reactivarReactiva un emisor tributario archivado.--cuerpo
redcumbre emisores tributarios crearCrea un emisor tributario con la llave del proyecto (servicio «Alta de emisores con certificado por API»).--cuerpo
redcumbre emisores tributarios certificado-subirSube el certificado digital del emisor tributario; la clave del archivo no va por argumento.--archivo --clave-desde-stdin
redcumbre emisores tributarios certificado-quitarQuita el certificado digital del emisor tributario.—
redcumbre emisores tributarios credencialCredencial del emisor ante el SII.—
redcumbre emisores tributarios credencial reintentarReintenta validar la credencial del emisor.—
redcumbre emisores sucursalesSucursales de los emisores DTE.—
redcumbre emisores sucursales listarLista las sucursales.--activo --tributaria --limite --desde --todas
redcumbre emisores sucursales crearCrea una sucursal.--cuerpo
redcumbre emisores sucursales editarActualiza una sucursal.--cuerpo
redcumbre emisores sucursales desactivarDesactiva una sucursal.—
redcumbre emisores representantesRepresentantes legales de los emisores.—
redcumbre emisores representantes listarLista los representantes legales y la vigencia de su certificado.--rut --limite --desde --todas
redcumbre emisores representantes renovar-certRenueva el certificado digital de un representante legal.--archivo --clave-desde-stdin
redcumbre emisores revocarRevoca un emisor inscrito por tokenización.--tipo --motivo
redcumbre certificadosCertificados digitales de la empresa (servicio «Alta de emisores con certificado por API»), con la llave del proyecto.—
redcumbre certificados listarLista los certificados de la empresa.--buscar --pagina --limite
redcumbre certificados verMuestra el detalle de un certificado.—
redcumbre certificados verificarVerifica un certificado: vigencia y clave.—
redcumbre certificados subirSube un certificado digital; la clave del archivo no va por argumento.--archivo --clave-desde-stdin
redcumbre certificados eliminarElimina un certificado.—
redcumbre foliosFolios de los emisores: CAF, solicitud y anulación de folios ante el SII, con la llave del proyecto.—
redcumbre folios subirSube el CAF de un emisor.--emisor --archivo
redcumbre folios listarLista los CAF de la empresa.--emisor --tipo-dte --estado --limite --desde --todas
redcumbre folios estadisticasMuestra las estadísticas de folios de los CAF.--emisor
redcumbre folios anularAnula un CAF completo.--rut --clave
redcumbre folios anular-foliosAnula un rango de folios de un CAF.--folio-desde --folio-hasta --motivo --rut --clave
redcumbre folios documentos-autorizadosConsulta los documentos que el SII tiene autorizados para el emisor.--emisor --ambiente
redcumbre folios consultarConsulta en el SII los folios disponibles de un tipo de documento.--emisor --tipo-dte --cantidad
redcumbre folios solicitarSolicita folios al SII.--emisor --tipo-dte --cantidad --rut --clave
redcumbre folios tipos-disponiblesLista los tipos de folios que el emisor puede pedir.--emisor
redcumbre folios automaticaSolicitud automática de folios.—
redcumbre folios automatica verMuestra la solicitud automática de folios.--emisor
redcumbre folios automatica cambiarCambia la solicitud automática de folios.--emisor --tipo-dte --habilitado --umbral --cantidad --maximo
redcumbre folios anulacionesAnulaciones de folios y su reporte al SII.—
redcumbre folios anulaciones listarLista las anulaciones de folios y el estado de su reporte al SII.--emisor --tipo-dte --estado --origen --limite --desde --todas
redcumbre folios anulaciones verMuestra el detalle de una anulación de folios.—
redcumbre folios anulaciones reintentarReintenta el reporte de una anulación al SII.--rut --clave
redcumbre configuracionConfiguració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 validafirmaConfiguración de ValidaFirma.—
redcumbre configuracion validafirma verMuestra la configuración de ValidaFirma de la empresa.—
redcumbre configuracion validafirma crearCrea la configuración de ValidaFirma.--cuerpo
redcumbre configuracion validafirma actualizarActiva o desactiva ValidaFirma.--activo
redcumbre configuracion validafirma quitarElimina la configuración de ValidaFirma.—
redcumbre configuracion logoLogo de la empresa.—
redcumbre configuracion logo subirSube el logo de la empresa.--archivo
redcumbre configuracion logo verMuestra el logo de la empresa.—
redcumbre configuracion logo quitarQuita el logo de la empresa.—
redcumbre configuracion bheConfiguración documental de boletas de honorarios.—
redcumbre configuracion bhe verMuestra la configuración documental de boletas de honorarios.—
redcumbre configuracion bhe cambiarCambia la configuración documental de boletas de honorarios.--modo
redcumbre configuracion bhetConfiguración documental de boletas de terceros.—
redcumbre configuracion bhet verMuestra la configuración documental de boletas de terceros.—
redcumbre configuracion bhet cambiarCambia la configuración documental de boletas de terceros.--modo
redcumbre configuracion dteConfiguración documental de los DTE.—
redcumbre configuracion dte verMuestra la configuración documental de los DTE.—
redcumbre configuracion dte cambiarCambia la configuración documental de los DTE.--modo
redcumbre configuracion boletaConfiguración documental de las boletas.—
redcumbre configuracion boleta verMuestra la configuración documental de las boletas.—
redcumbre configuracion boleta cambiarCambia la configuración documental de las boletas.--modo
redcumbre configuracion cache-contribuyentesCaché de contribuyentes.—
redcumbre configuracion cache-contribuyentes verMuestra la configuración de la caché de contribuyentes.—
redcumbre configuracion cache-contribuyentes cambiarCambia la configuración de la caché de contribuyentes.--cuerpo
redcumbre configuracion info-pagoInformación de pago de la empresa.—
redcumbre configuracion info-pago verMuestra la información de pago de la empresa.—
redcumbre configuracion info-pago guardarGuarda la información de pago de la empresa.--html
redcumbre configuracion info-pago quitarElimina la información de pago de la empresa.—
redcumbre configuracion plantillasPlantillas de los documentos.—
redcumbre configuracion plantillas listarLista las plantillas del catálogo.--tipo-documento --formato-papel --estado
redcumbre configuracion plantillas verMuestra una plantilla del catálogo.—
redcumbre configuracion plantillas tipos-de-documentoLista los tipos de documento que tienen plantilla.—
redcumbre configuracion plantillas formatos-de-papelLista los formatos de papel de las plantillas.—
redcumbre configuracion plantillas vista-previaGenera la vista previa de una plantilla.--formato --salida
redcumbre configuracion plantillas vista-previa-con-datosGenera la vista previa de una plantilla con los datos que le pasas.--formato --cuerpo --salida
redcumbre configuracion plantillas elegidasMuestra las plantillas que eligió la empresa.—
redcumbre configuracion plantillas elegirElige las plantillas de la empresa.--cuerpo
redcumbre configuracion plantillas opcionesLista las plantillas disponibles para un tipo de documento.—
redcumbre configuracion plantillas vista-previa-de-empresaGenera la vista previa de una plantilla con los datos de la empresa.--formato --salida

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.

Lee los topes de la empresa y pide una ampliación. El historial de protección y la solicitud no se cobran.

ComandoPara qué sirveBanderas
redcumbre configuracion topesTopes de ValidaFirma de la empresa.—
redcumbre configuracion topes verMuestra los topes de ValidaFirma de la empresa.—
redcumbre configuracion topes historial-de-proteccionLista el historial de la protección de topes.--limite --desde --todas
redcumbre configuracion topes pedir-ampliacionPide ampliar un tope; la empresa tiene una solicitud pendiente a la vez.--valor --motivo

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.

ComandoPara qué sirveBanderas
redcumbre configuracion llamadasRegistro de llamadas de las llaves de la empresa.—
redcumbre configuracion llamadas listarLista 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

Lee los adicionales, el plan y el resumen de pagos de la suscripción de la empresa.

ComandoPara qué sirveBanderas
redcumbre configuracion suscripcionSuscripción de la empresa.—
redcumbre configuracion suscripcion adicionalesAdicionales de la suscripción.—
redcumbre configuracion suscripcion adicionales listarLista los adicionales de la suscripción.—
redcumbre configuracion suscripcion adicionales verMuestra un adicional de la suscripción con su consumo.—
redcumbre configuracion suscripcion planMuestra el plan de la suscripción y su consumo.—
redcumbre configuracion suscripcion resumenMuestra 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.

ComandoPara qué sirveBanderas
redcumbre configuracion pinIntegraciones de PIN de la empresa.—
redcumbre configuracion pin listarLista las integraciones de PIN.—
redcumbre configuracion pin crearCrea una integración de PIN.--cuerpo
redcumbre configuracion pin actualizarActualiza una integración de PIN.--cuerpo
redcumbre configuracion pin desactivarDesactiva una integración de PIN.—
redcumbre configuracion pin reactivarReactiva una integración de PIN.—
redcumbre configuracion pin estadisticasMuestra las estadísticas de una integración de PIN en un período.--periodo

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.

ComandoPara qué sirveBanderas
redcumbre configuracion canalCanal de agentes de la empresa.—
redcumbre configuracion canal actividadLista 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-actividadLista las personas y los asistentes por los que puedes filtrar la actividad.—
redcumbre configuracion canal conexionesLista las conexiones de asistentes de la empresa.—
redcumbre configuracion canal hechosLista los hechos del canal: quién lo apagó, lo prendió o quitó una conexión.--limite --desde --todas
redcumbre configuracion canal estadoMuestra si el canal está apagado y quién lo dejó así.—
redcumbre configuracion canal apagarApaga el canal y revoca las autorizaciones vigentes.—
redcumbre configuracion canal prenderPrende el canal; no revive las autorizaciones revocadas.—
redcumbre configuracion canal quitarQuita la conexión de un asistente de la empresa.—

Administra las casillas de correo de ventas y los campos de la nota.

ComandoPara qué sirveBanderas
redcumbre configuracion ventasVentas de la empresa.—
redcumbre configuracion ventas casillasCasillas de correo de ventas.—
redcumbre configuracion ventas camposCampos de la nota de venta.—
redcumbre configuracion ventas casillas listarLista las casillas de ventas con sus usos y alertas.—
redcumbre configuracion ventas casillas alertasLista las casillas con una alerta vigente.—
redcumbre configuracion ventas casillas tomarToma una casilla de ventas.--parte-local
redcumbre configuracion ventas casillas quitarQuita una casilla de ventas; queda reservada 180 días para la misma empresa.—
redcumbre configuracion ventas campos listarLista los campos de la nota.--archivo --tipo --visibilidad --busqueda --limite --desde --todas
redcumbre configuracion ventas campos crearCrea un campo de la nota.--cuerpo
redcumbre configuracion ventas campos verMuestra un campo de la nota.—
redcumbre configuracion ventas campos actualizarActualiza un campo de la nota.--cuerpo
redcumbre configuracion ventas campos archivarArchiva 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.

ComandoPara qué sirveBanderas
redcumbre configuracion correoCorreo de la empresa.—
redcumbre configuracion correo identidadesIdentidades de correo de la empresa.—
redcumbre configuracion correo verMuestra la configuración de correo y su identidad por defecto.—
redcumbre configuracion correo cambiarCambia la identidad de correo por defecto.--cuerpo
redcumbre configuracion correo identidades listarLista las identidades de correo.—
redcumbre configuracion correo identidades crearCrea una identidad de correo.--cuerpo
redcumbre configuracion correo identidades actualizarActualiza una identidad de correo.--cuerpo
redcumbre configuracion correo identidades quitarElimina una identidad de correo.—
redcumbre configuracion correo identidades verificar-conexionVerifica la conexión SMTP de una identidad.—
redcumbre configuracion correo identidades enviar-pruebaEnvía un correo de prueba desde una identidad.--a

Administra las plantillas de los correos de documentos que la empresa envía.

ComandoPara qué sirveBanderas
redcumbre configuracion plantillas correoPlantillas de los correos de documentos.—
redcumbre configuracion plantillas correo listarLista las plantillas de correo.—
redcumbre configuracion plantillas correo asignacionesMuestra qué plantilla atiende cada subtipo de documento.--proceso
redcumbre configuracion plantillas correo contenido-por-defectoMuestra el contenido por defecto de un proceso.--proceso
redcumbre configuracion plantillas correo verMuestra una plantilla de correo.—
redcumbre configuracion plantillas correo crearCrea una plantilla de correo.--cuerpo
redcumbre configuracion plantillas correo actualizarActualiza una plantilla de correo.--cuerpo
redcumbre configuracion plantillas correo quitarElimina una plantilla de correo.—
redcumbre configuracion plantillas correo vista-previaGenera la vista previa de una plantilla de correo.--dte-id
redcumbre usuariosPersonas de la empresa: invitar, editar, quitar, roles, sesiones, restablecer la clave y el PIN del puesto, con la llave del proyecto.—
redcumbre usuarios invitarInvita a una persona a la empresa: Zitadel le envía el correo y ella elige su clave.--cuerpo
redcumbre usuarios verificar-correoVerifica si un correo ya es de una persona de la empresa.--correo
redcumbre usuarios listarLista las personas de la empresa.--buscar --rol --pagina --limite --todas
redcumbre usuarios verMuestra a una persona de la empresa.—
redcumbre usuarios editarEdita nombre, apellido o teléfono de una persona.--cuerpo
redcumbre usuarios quitarQuita a una persona de la empresa.—
redcumbre usuarios pin-del-puestoConsulta el estado del PIN del puesto de una persona.—
redcumbre usuarios opera-en-puestosMarca si una persona opera en puestos.--opera
redcumbre usuarios asignar-rolesAsigna roles a una persona, dentro del techo de roles de la llave.--cuerpo
redcumbre usuarios rolesLista los roles de una persona en la empresa.—
redcumbre usuarios restablecer-claveEnvía a la persona el correo para elegir una clave nueva; la respuesta no trae la clave.—
redcumbre usuarios sesionesLista las sesiones abiertas de una persona.—
redcumbre usuarios cerrar-sesionesCierra todas las sesiones abiertas de una persona.--motivo
redcumbre rolesRoles que una llave puede asignar a las personas de la empresa.—
redcumbre roles listarLista los roles que una llave puede asignar.—
redcumbre roles asignablesLista los roles asignables.—
redcumbre roles asignables-de-empresaLista los roles asignables en la empresa de la llave.—
redcumbre roles verMuestra un rol.—
redcumbre grupos-de-rolesGrupos de roles de la empresa y las personas que los tienen.—
redcumbre grupos-de-roles listarLista los grupos de roles de la empresa.--activo --con-conteo
redcumbre grupos-de-roles sincronizacionConsulta si los grupos de roles están sincronizados.—
redcumbre grupos-de-roles verMuestra un grupo de roles.—
redcumbre grupos-de-roles usuariosLista las personas que tienen un grupo de roles.—
redcumbre grupos-de-roles crearCrea un grupo de roles.--cuerpo
redcumbre grupos-de-roles editarEdita un grupo de roles.--cuerpo
redcumbre grupos-de-roles eliminarElimina un grupo de roles.—
redcumbre grupos-de-roles activar-o-desactivarActiva o desactiva un grupo de roles.—
redcumbre grupos-de-personasGrupos de personas de la empresa.—
redcumbre grupos-de-personas listarLista los grupos de personas.--buscar --limite --desde --todas
redcumbre grupos-de-personas crearCrea un grupo de personas.--cuerpo
redcumbre grupos-de-personas verMuestra un grupo de personas.—
redcumbre grupos-de-personas editarRenombra un grupo de personas.--nombre
redcumbre grupos-de-personas archivarArchiva un grupo de personas.—
redcumbre grupos-de-personas agregar-personaAgrega una persona a un grupo.--usuario
redcumbre grupos-de-personas consultar-quitar-personaConsulta qué pasa al quitar a una persona de un grupo.—
redcumbre grupos-de-personas quitar-personaQuita a una persona de un grupo.—
redcumbre areasÁreas de trabajo de la empresa y sus bodegas.—
redcumbre areas listarLista las áreas de trabajo.--buscar --estado --pagina --limite --todas
redcumbre areas crearCrea un área de trabajo.--cuerpo
redcumbre areas opcionesLista las áreas para elegir una.—
redcumbre areas verMuestra un área con sus puestos y bodegas.—
redcumbre areas quien-operoLista quién operó en un área.--pagina --limite --todas
redcumbre areas disponiblesMuestra las personas disponibles en los puestos de un área.—
redcumbre areas editarEdita un área de trabajo.--cuerpo
redcumbre areas archivarArchiva un área de trabajo.—
redcumbre areas asociar-bodegasDefine las bodegas de un área.--cuerpo
redcumbre puestosConfiguración y consulta de los puestos de trabajo. Registrar, reconectar, anular y levantar el bloqueo no son de la llave.—
redcumbre puestos configuracionMuestra la configuración de los puestos.—
redcumbre puestos cambio-rapidoEnciende o apaga el cambio rápido de puestos.--cuerpo
redcumbre puestos tiemposCambia los tiempos de los puestos.--cuerpo
redcumbre puestos listarLista los puestos de trabajo.--buscar --estado --area --pagina --limite --todas
redcumbre puestos verMuestra un puesto de trabajo.—
redcumbre puestos editarEdita un puesto de trabajo.--cuerpo
redcumbre puestos desactivarDa de baja un puesto de trabajo.—
redcumbre puestos movimientosLista los movimientos de un puesto.--pagina --limite --todas
redcumbre sucursales-de-usuariosSucursales asignadas a las personas de la empresa.—
redcumbre sucursales-de-usuarios asignarAsigna sucursales a una persona.--cuerpo
redcumbre sucursales-de-usuarios para-asignacionLista las sucursales que se pueden asignar.—
redcumbre sucursales-de-usuarios listarLista las sucursales asignadas a una persona.—
redcumbre sucursales-de-usuarios quitar-de-emisorQuita las sucursales de una persona en un emisor.—

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 -).

ComandoPara qué sirveBanderas
redcumbre webhooks configuracionConfiguración de webhooks de la empresa.—
redcumbre webhooks configuracion verMuestra la configuración de webhooks y si el secreto ya está configurado.—
redcumbre webhooks configuracion crearCrea la configuración de webhooks y entrega el secreto de firma una sola vez.--cuerpo
redcumbre webhooks configuracion actualizarCambia la URL, los eventos, las cabeceras o el encendido de los webhooks.--cuerpo
redcumbre webhooks configuracion regenerar-secretoGenera un secreto de firma nuevo, lo entrega una sola vez y pide confirmar con el slug.--anterior
redcumbre webhooks entregasHistorial de entregas de webhooks.—
redcumbre webhooks entregas listarLista las entregas de webhooks, con su resultado y el código HTTP.--resultado --evento --desde-fecha --hasta-fecha --pagina --limite
redcumbre webhooks entregas verMuestra una entrega con sus intentos.—
ComandoPara qué sirveBanderas
redcumbre skillLa skill del integrador que el CLI instala en tus carpetas de skills.—
redcumbre skill quitarQuita la skill de tus carpetas y del proyecto; login e init no la vuelven a instalar.—
redcumbre skill renovarRenueva 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 mcpEl servidor MCP de REDCUMBRE en tu asistente de código.—
redcumbre mcp agregarConecta el servidor MCP de REDCUMBRE en tu asistente.--asistente
redcumbre mcp quitarDesconecta el servidor MCP de REDCUMBRE de tu asistente.--asistente

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».

Estas banderas las traen todos los comandos que se ejecutan (los que no tienen subcomandos) dentro del alcance que indica la primera columna.

AlcanceBanderasQué hacen
redcumbre--jsonModo agente: no pregunta y deja un solo JSON en la salida estándar, nunca el secreto de una llave
redcumbre emisores--produccion --confirmar --ensayoOperan 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 --ensayoOperan 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 --ensayoOperan 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 --ensayoOperan 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 --ensayoOperan 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 --ensayoOperan 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 --ensayoOperan 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 --ensayoOperan 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 --ensayoOperan 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 --ensayoOperan 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 --ensayoOperan 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 --ensayoOperan 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 --ensayoOperan con la llave de producción, la confirman con el slug de la empresa o muestran la petición sin hacerla

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.

El CLI trabaja con la llave de prueba salvo que le pidas lo contrario. Para tocar producción hay que pedirlo y confirmarlo:

BanderaQué hace
--produccionUsa 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
--ensayoMuestra 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.

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ódigoSignificadoerror.codigo
0Listo—
1Error 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 instalarERROR_DEL_CLI
2Uso incorrecto: un comando, una opción o un valor que no existeUSO_INCORRECTO
3Falta la confirmación de una personaFALTA_CONFIRMACION
4Falta iniciar sesión, o la sesión vencióSIN_SESION
5Falta la llave, o la API la rechazaSIN_LLAVE
6La API respondió un error 4xx; también un límite de uso alcanzadoAPI_RECHAZO
7La 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
8La llave es de otro modo: de prueba en vez de producción, o al revésPROHIBIDO_POR_EL_MODO
9prueba verificar: tu sitio no pasó la verificaciónVERIFICACION_FALLIDA
10Tu 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 correrloNODE_NO_SOPORTADO

En tu proyecto, en la carpeta donde corres el comando:

  • keys/redcumbre-prueba.json y keys/redcumbre-produccion.json: la llave de cada modo, con el mismo formato JSON que descarga la pantalla web de llaves y permisos 0600.
  • keys/validafirma-<empresa>-<alcance>-<modo>.json y keys/reseller-<empresa>-<tipo>-<entorno>.json: las llaves que crean llaves validafirma y reseller credenciales crear.
  • .env: sólo apunta a la llave, con REDCUMBRE_LLAVE_PRUEBA o REDCUMBRE_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 en AGENTS.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 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.