Beta privada · apertura 23 de diciembre
Guarda credenciales en la bóveda
PUT /v1/emisores/{ruc}/credenciales
Guarda el certificado y el usuario SOL secundario cifrados. Solo funciona con la bóveda activa; mientras tanto responde boveda_inactiva y debes enviar credenciales en cada llamada. No se expone a agentes por MCP: un certificado no debe pasar por el chat.
| Dato | Valor |
|---|---|
| Permiso | emisores:administrar |
| Cobro | No cobra. |
Idempotency-Key |
No aplica |
| Herramienta MCP | No se ofrece a agentes. |
Parámetros
Sección titulada «Parámetros»| Nombre | En | Requerido | Tipo | Descripción |
|---|---|---|---|---|
ruc |
path | Sí | string | RUC del emisor o contribuyente. |
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 |
|---|---|---|---|
certificado |
object | Sí | Certificado digital del emisor. Nunca se guarda en registros ni se devuelve. |
certificado.pfx_base64 |
string (base64) | Sí | Archivo .pfx o .p12 del certificado digital, en base64. |
certificado.clave |
string (password) | Sí | Contraseña del archivo .pfx. |
sol |
object | Sí | Usuario secundario SOL del emisor. Nunca se guarda en registros ni se devuelve. |
sol.usuario |
string | Sí | Usuario secundario SOL, sin el RUC (lo agregamos con el RUC del emisor). |
sol.clave |
string (password) | Sí | Clave SOL del usuario secundario. |
api_sunat |
object | No | Credenciales de la API de SUNAT (guías y SIRE), generadas en SOL. Nunca se guarda en registros ni se devuelve. |
api_sunat.client_id |
string | Sí | |
api_sunat.client_secret |
string (password) | Sí |
Ejemplo
Sección titulada «Ejemplo»Contra el sandbox, con una clave onx_test_…:
curl -X PUT "https://api-sandbox.opennexum.com/v1/emisores/20000000001/credenciales" \ -H "Authorization: Bearer onx_test_…" \ -H "Content-Type: application/json" \ -d '{ "certificado": { "pfx_base64": "texto", "clave": "texto" }, "sol": { "usuario": "texto", "clave": "texto" }}'Respuestas
Sección titulada «Respuestas»Credenciales guardadas (sin datos secretos).
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
ruc |
string | Sí | RUC de 11 dígitos. Se valida el dígito verificador (módulo 11 de SUNAT). |
modo |
“boveda” | Sí | |
certificado |
object | Sí | |
certificado.titular_ruc |
string | Sí | RUC de 11 dígitos. Se valida el dígito verificador (módulo 11 de SUNAT). |
certificado.vence_el |
string (date) | Sí | Fecha AAAA-MM-DD (día en Lima). |
certificado.huella_sha256 |
string | Sí | Huella del certificado, para reconocerlo. |
sol |
object | Sí | |
sol.usuario |
string | Sí | |
api_sunat |
object | null | Sí | |
api_sunat.client_id |
string | Sí | |
actualizadas_en |
string (date-time) | Sí | Fecha y hora ISO 8601 con la zona de Lima (-05:00). |
version |
integer | Sí | Sube con cada cambio de credenciales. |
Errores
Sección titulada «Errores»Cada código tiene su explicación en Errores.
- 400
validacion - 401
clave_invalida - 403
permiso_faltante - 404
no_encontrado - 409
boveda_inactiva - 422
credenciales_sunat - 429
limite_uso - 500
error_interno - 501
operacion_no_disponible - 503
no_disponible