Saltar al contenido principal

Certificados

Estas rutas permiten importar un certificado y consultar el certificado asociado a una empresa.

Lectura rápida

  1. Importá el certificado con POST /certificado/importar.
  2. 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

HeaderTipo o valor esperadoRequeridoDescripción
AuthorizationBearer ACCESS_TOKENBearer token obtenido en Autenticación.
X-EmisorString o Int64RUT de la empresa sobre la que se importa el certificado.

Body multipart/form-data

CampoTipoRequeridoDescripción
archivoFileArchivo del certificado a importar.
clavePrivadaStringClave 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

CampoTipoDescripción
bodyObj no documentadoLa 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

HeaderTipo o valor esperadoRequeridoDescripción
AuthorizationBearer ACCESS_TOKENBearer token obtenido en Autenticación.
X-EmisorString o Int64RUT de la empresa consultada.

Respuesta

CampoTipoDescripción
bodyObj no documentadoLa colección publicada no define el cuerpo de respuesta de esta consulta. Esta guía no inventa campos no declarados.

Flujo sugerido

  1. Importá el certificado una sola vez por empresa o cuando renueve.
  2. Ejecutá GET /certificado/consultar para validar que la empresa quedó asociada al certificado esperado.