Ir al contenido

Beta privada · apertura 23 de diciembre

Dice quién eres

GET /v1/yo

Devuelve la cuenta (id público y nombre), el entorno, el tipo de credencial (clave o token OAuth), sus permisos, los RUC a los que llega y su tope. Basta una credencial válida y no cobra. Nunca devuelve la clave ni el token.

Dato Valor
Permiso clave_valida
Cobro No cobra.
Idempotency-Key No aplica
Herramienta MCP yo_ver (Próximamente)
Nombre En Requerido Tipo Descripción
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 "https://api-sandbox.opennexum.com/v1/yo" \
-H "Authorization: Bearer onx_test_…"

La cuenta y lo que puede hacer tu credencial.

Campo Tipo Requerido Descripción
cuenta object Sí La cuenta a la que pertenece la credencial.
cuenta.id string Sí Identificador público de tu cuenta.
cuenta.nombre string Sí Nombre de la cuenta.
entorno “live” | “test” Sí live en producción; test en sandbox (SUNAT beta).
credencial “clave” | “oauth” Sí Con qué preguntas: una clave onx_live_/onx_test_ o el token OAuth de un agente conectado.
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í Lo que puede hacer esta credencial.
emisores string[] | null Sí RUC a los que llega: null = todos los de tu cuenta; una lista vacía = ninguno.
tope object | null Sí Tope de gasto de la credencial; null si no tiene. Lo consumido está en GET /v1/cuenta/saldo.
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.

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