Ir al contenido

Beta privada · apertura 23 de diciembre

Registra un RUC emisor

POST /v1/emisores

Agrega un RUC a tu cuenta para emitir. Revisamos el padrón: si el RUC está obligado a OSE, no se acepta en la v1; si ya está en otra cuenta, responde ya_registrado (se transfiere por soporte).

Dato Valor
Permiso emisores:administrar
Cobro No cobra.
Idempotency-Key Opcional
Herramienta MCP emisor_crear (Próximamente)
Nombre En Requerido Tipo Descripción
Idempotency-Key header No string Identifica una operación para que repetirla no la duplique. Si repites la petición con la misma clave y el mismo cuerpo, recibes la misma respuesta; con otro cuerpo, idempotencia_en_conflicto. Se guarda 24 horas.
X-Request-Id header No string Identificador de la petición. Va en cada respuesta; menciónalo al escribir a soporte.

application/json, obligatorio. Los campos anidados van con punto y los de listas con []. No se aceptan campos desconocidos.

Campo Tipo Requerido Descripción
ruc string Sí RUC de 11 dígitos. Se valida el dígito verificador (módulo 11 de SUNAT).
nombre_comercial string No
direccion_fiscal object No Si no la envías, usamos la del padrón de SUNAT.
direccion_fiscal.ubigeo string Sí Ubigeo INEI de 6 dígitos.
direccion_fiscal.direccion string Sí
direccion_fiscal.codigo_establecimiento string No Código de establecimiento anexo en SUNAT; 0000 es el domicilio fiscal.

Contra el sandbox, con una clave onx_test_…:

Ventana de terminal
curl -X POST "https://api-sandbox.opennexum.com/v1/emisores" \
-H "Authorization: Bearer onx_test_…" \
-H "Content-Type: application/json" \
-d '{
"ruc": "20000000001"
}'

Emisor registrado.

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

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