Ir al contenido

Beta privada · apertura 23 de diciembre

Revoca una clave

DELETE /v1/claves/{id}

La clave deja de funcionar al instante. No se puede deshacer; crea otra si la necesitas. Puedes revocar tu propia clave o una que creó ella (o sus descendientes); una clave nunca revoca a la que la creó. Las demás se revocan desde el panel.

Dato Valor
Permiso claves:administrar
Cobro No cobra.
Idempotency-Key No aplica
Herramienta MCP clave_revocar (Próximamente)
Nombre En Requerido Tipo Descripción
id path Sí string Identificador que empieza con clv_.
X-Request-Id header No string Identificador de la petición. Va en cada respuesta; menciónalo al escribir a soporte.

Contra el sandbox, con una clave onx_test_…:

Ventana de terminal
curl -X DELETE "https://api-sandbox.opennexum.com/v1/claves/clv_8f2c1a7d9e" \
-H "Authorization: Bearer onx_test_…"

Clave revocada.

Campo Tipo Requerido Descripción
id string Sí Identificador que empieza con clv_.
nombre string Sí
prefijo string Sí Inicio visible de la clave, para reconocerla. La clave completa solo se muestra al crearla.
entorno “live” | “test” Sí live en producción; test en sandbox (SUNAT beta).
permisos “datos:leer” | “emisores:administrar” | “comprobantes:emitir” | “comprobantes:leer” | “comprobantes:anular” | “guias:emitir” | “sire:leer” | “conecta:leer” | “conecta:enviar” | “conecta:administrar” | “webhooks:administrar” | “cuenta:leer” | “cuenta:recargar” | “claves:administrar” | “credenciales:por_llamada”[] Sí Puede estar vacía (una clave sin permisos solo autentica).
emisores string[] | null Sí RUC a los que puede acceder; null = todos los de tu cuenta.
tope object | null Sí
tope.periodo “diario” | “semanal” | “mensual” | “total” Sí
tope.limite string Sí Monto como texto con dos decimales y punto decimal, sin separador de miles. “1250.50” es S/ 1,250.50.
confirmacion object Sí Qué operaciones de esta clave esperan la aprobación de una persona en el panel. Por omisión: notas de crédito, bajas, montos mayores a S/ 5,000.00 y todo lo que pida un agente (token OAuth o MCP).
confirmacion.notas boolean Sí Notas de crédito (07).
confirmacion.bajas boolean Sí Bajas: comunicación de baja (RA) y resumen diario de anulación (RC).
confirmacion.mensajes boolean Sí Envío de mensajes y comprobantes por Conecta.
confirmacion.agentes boolean Sí Toda emisión o baja que pida un agente con un token OAuth o por MCP, sea cual sea su tipo o monto.
confirmacion.monto_mayor_a string | null Sí Comprobantes cuyo total pasa de este monto (por omisión, “5000.00”); null para no pedirla por monto.
vence_el string (date) | null Sí
ultimo_uso_en string (date-time) | null Sí
creada_en string (date-time) Sí Fecha y hora ISO 8601 con la zona de Lima (-05:00).
revocada_en string (date-time) | null Sí

Cada código tiene su explicación en Errores.