Certificados
Estas rutas permiten importar un certificado y consultar el certificado asociado a una empresa.
Lectura rápida
- Importá el certificado con
POST /certificado/importar. - Verificá el estado con
GET /certificado/consultar.
POST /certificado/importar
POST https://api-test.facturaelectronica.com.uy/certificado/importar
Authorization: Bearer ACCESS_TOKEN
X-Emisor: 219999830019
Content-Type: multipart/form-data
Importa un certificado para la empresa indicada en X-Emisor.
Headers requeridos
| Header | Tipo o valor esperado | Requerido | Descripción |
|---|---|---|---|
Authorization | Bearer ACCESS_TOKEN | Sí | Bearer token obtenido en Autenticación. |
X-Emisor | String o Int64 | Sí | RUT de la empresa sobre la que se importa el certificado. |
Body multipart/form-data
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
archivo | File | Sí | Archivo del certificado a importar. |
clavePrivada | String | Sí | Clave privada asociada al certificado. |
Ejemplo con curl:
curl -X POST "https://api-test.facturaelectronica.com.uy/certificado/importar" \
-H "Authorization: Bearer ACCESS_TOKEN" \
-H "X-Emisor: 219999830019" \
-F "archivo=@certificado.pfx" \
-F "clavePrivada=mi-clave"
Cuidado con secretos
No registres clavePrivada ni el archivo del certificado en logs, ejemplos públicos o repositorios.
Respuesta
| Campo | Tipo | Descripción |
|---|---|---|
body | Obj no documentado | La colección publicada no define el cuerpo de respuesta de la importación. Esta guía no inventa campos no declarados. |
GET /certificado/consultar
GET https://api-test.facturaelectronica.com.uy/certificado/consultar
Authorization: Bearer ACCESS_TOKEN
X-Emisor: 219999830019
Consulta el certificado asociado a la empresa indicada en X-Emisor.
Headers requeridos
| Header | Tipo o valor esperado | Requerido | Descripción |
|---|---|---|---|
Authorization | Bearer ACCESS_TOKEN | Sí | Bearer token obtenido en Autenticación. |
X-Emisor | String o Int64 | Sí | RUT de la empresa consultada. |
Respuesta
| Campo | Tipo | Descripción |
|---|---|---|
body | Obj no documentado | La colección publicada no define el cuerpo de respuesta de esta consulta. Esta guía no inventa campos no declarados. |
Flujo sugerido
- Importá el certificado una sola vez por empresa o cuando renueve.
- Ejecutá
GET /certificado/consultarpara validar que la empresa quedó asociada al certificado esperado.