Ir al contenido

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.
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í

Contra el sandbox, con una clave onx_test_…:

Ventana de terminal
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"
}
}'

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.

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