Ir al contenido

Beta privada · apertura 23 de diciembre

Lista tus RUC emisores

GET /v1/emisores

RUC emisores de tu cuenta a los que tiene acceso la clave.

Dato Valor
Permiso comprobantes:leer
Cobro No cobra.
Idempotency-Key No aplica
Herramienta MCP emisor_listar (Próximamente)
Nombre En Requerido Tipo Descripción
cursor query No string Cursor opaco que devolvió la página anterior en siguiente_cursor.
limite query No integer Cuántos elementos traer (1 a 100; por defecto 20).
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/emisores" \
-H "Authorization: Bearer onx_test_…"

Página de emisores.

Campo Tipo Requerido Descripción
elementos object[] Sí
elementos[].ruc string Sí RUC de 11 dígitos. Se valida el dígito verificador (módulo 11 de SUNAT).
elementos[].razon_social string Sí
elementos[].nombre_comercial string | null Sí
elementos[].direccion_fiscal object | null Sí
elementos[].direccion_fiscal.ubigeo string Sí Ubigeo INEI de 6 dígitos.
elementos[].direccion_fiscal.direccion string Sí
elementos[].direccion_fiscal.codigo_establecimiento string No Código de establecimiento anexo en SUNAT; 0000 es el domicilio fiscal.
elementos[].entorno “beta” | “produccion” Sí beta en sandbox (SUNAT beta); produccion en producción.
elementos[].modo_credenciales “por_llamada” | “boveda” Sí por_llamada: envías credenciales en cada emisión. boveda: las guardamos cifradas.
elementos[].credenciales_guardadas boolean Sí
elementos[].creado_en string (date-time) Sí Fecha y hora ISO 8601 con la zona de Lima (-05:00).
siguiente_cursor string | null Sí Pásalo como cursor para la página siguiente; null si ya no hay más.

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