---
title: "Subir .p12 (se cifra con envelope AES-256-GCM)"
method: POST
path: "/certificados"
tags: ["certificados"]
---

# Subir .p12 (se cifra con envelope AES-256-GCM)

`POST /certificados`

## Request

- Base URL: `https://contadeo.com/api`
- URL: `https://contadeo.com/api/certificados`
- Auth: HTTP bearer

## Request body

- object
  - `emisorId` string, uuid, required
  - `p12Base64` string, required: Contenido del .p12 en base64
  - `passphrase` string, required
  - `declaraTitularidadFirma` boolean, required: Declaración expresa de titularidad de la firma: quien la sube declara ser su titular o contar con autorización de este para firmar con ella. Obligatoria (400 sin ella); se guardan fecha, usuario, IP y versión del texto como evidencia.
  - `alias` string
  - `ponerEnUso` boolean: Omitido o true: la firma entra en uso y jubila a la anterior. false: queda EN ESPERA (estado inactivo, la actual sigue firmando) para probarla contra el SRI con POST /certificados/{id}/probar antes de que reemplace a la actual.

## Response `201`

Certificado registrado

- object
  - `id` string, uuid
  - `subject` string
  - `notAfter` string
  - `estado` 'activo' | 'inactivo': activo = en uso; inactivo = en espera (ponerEnUso: false).
  - `advertencia` string: Presente si el RUC del emisor no aparece en el titular del certificado: probable .p12 equivocado. Se guarda igualmente; el SRI es el control duro.
  - `solicitudFirmaCerrada` boolean: Presente (y true) solo cuando este .p12 cerró una solicitud de firma que estaba EN_REVISION ante NewBest, en la misma transacción que el alta del certificado. Solo ocurre si el issuer del certificado es NewBest; con otra certificadora la solicitud sigue abierta. Ausente en el resto de subidas.

## Other responses

- `400`: Cuerpo inválido o validación de negocio (previene errores SRI 62/52/65/69/39)

---

[API](https://skmtc.dev/contadeo/apis/api-de-contadeo.md) · [All operations](https://skmtc.dev/contadeo/apis/api-de-contadeo/llms.txt) · [OpenAPI document](https://skmtc.dev/contadeo/apis/api-de-contadeo/revisions/461bbb9a74ce?raw)