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) |
Parámetros
Sección titulada «Parámetros»| 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. |
Ejemplo
Sección titulada «Ejemplo»Contra el sandbox, con una clave onx_test_…:
curl -X POST "https://api-sandbox.opennexum.com/v1/emisores" \ -H "Authorization: Bearer onx_test_…" \ -H "Content-Type: application/json" \ -d '{ "ruc": "20000000001"}'Respuestas
Sección titulada «Respuestas»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). |
Errores
Sección titulada «Errores»Cada código tiene su explicación en Errores.
- 400
validacion - 401
clave_invalida - 403
permiso_faltante - 403
emisor_obligado_ose - 409
idempotencia_en_conflicto - 409
solicitud_en_curso - 409
ya_registrado - 429
limite_uso - 500
error_interno - 501
operacion_no_disponible - 503
no_disponible