FirmaEC

Plataforma API para firmar, verificar y consultar certificados electrónicos asociados a documentos PDF.

Servicios disponibles

Guia tecnica

Firmar un documento

Genera una firma electrónica visible en un archivo PDF usando un certificado P12 o PFX.

Comprobar una firma

Analiza la integridad y la información de las firmas presentes en un documento PDF.

Revisar un certificado

Consulta la vigencia y los datos de un certificado electrónico P12 o PFX.

Guia tecnica de integracion

Base URL: https://firma.impulsa.ec/APIREST. Todos los servicios reciben JSON con el encabezado Content-Type: application/json.

Ver ejemplos de integracion y parametros

Firmar un PDF

curl -X POST https://firma.impulsa.ec/APIREST/Firmarpdf/ \
  -H "Content-Type: application/json" \
  -d "{
    \"documentopdf\":\"$(base64 -w 0 /ruta/documento.pdf)\",
    \"archivop12\":\"$(base64 -w 0 /ruta/certificado.p12)\",
    \"contrasena\":\"CONTRASENA_CERTIFICADO\",
    \"pagina\":0,
    \"ubicacion\":\"Ecuador, EC\",
    \"razon\":\"Documento firmado electronicamente\",
    \"h\":100,
    \"v\":100
  }"

La respuesta incluye el documento firmado en Base64.

Verificar un PDF firmado

curl -X POST https://firma.impulsa.ec/APIREST/Validarpdf/ \
  -H "Content-Type: application/json" \
  -d "{
    \"documentopdf\":\"$(base64 -w 0 /ruta/documento_firmado.pdf)\"
  }"

La respuesta contiene los datos de la firma y su estado de validez.

Consultar un certificado

curl -X POST https://firma.impulsa.ec/APIREST/Validarcertificado/ \
  -H "Content-Type: application/json" \
  -d "{
    \"archivop12\":\"$(base64 -w 0 /ruta/certificado.p12)\",
    \"contrasena\":\"CONTRASENA_CERTIFICADO\"
  }"

Parametro	Descripcion
`documentopdf`	Archivo PDF codificado en Base64.
`archivop12`	Certificado P12 o PFX codificado en Base64.
`contrasena`	Clave del certificado electronico.
`pagina`	Pagina donde se ubica la firma; `0` usa la ultima pagina.
`ubicacion`, `razon`	Informacion declarada en la firma.
`h`, `v`	Coordenadas horizontal y vertical de la firma visible.

Use HTTPS y evite registrar el documento, certificado o contrasena en los logs de su sistema.