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_TOKENSíBearer token obtenido en Autenticación.
X-EmisorString o Int64SíRUT de la empresa sobre la que se importa el certificado.

Body multipart/form-data​

CampoTipoRequeridoDescripción
archivoFileSíArchivo del certificado a importar.
clavePrivadaStringSí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​

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_TOKENSíBearer token obtenido en Autenticación.
X-EmisorString o Int64SíRUT 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.