{"info":{"_postman_id":"d76988c0-1060-4cfd-abd5-e05ec7f4c8de","name":"Firma Digital LOCAL","description":"

Firma Digital

Esta colección agrupa los endpoints del microservicio Firma Digital, un servicio local que corre en https://localhost:7061/api/firmadigital y provee capacidades de firma digital para documentos PDF utilizando certificados instalados en el sistema.

Endpoints

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Método	Endpoint	Descripción
GET	`/status`	Health check — verifica que el servicio esté activo y operativo.
GET	`/certificados`	Retorna la lista de certificados digitales disponibles en el almacén de certificados del sistema, identificados por su Thumbprint.
POST	`/firmarPDF`	Firma digitalmente un archivo PDF utilizando un certificado seleccionado. Requiere la ruta absoluta al PDF (`PdfPath`) y el Thumbprint del certificado.
POST	`/verificarcertificado`	Valida un certificado digital por su Thumbprint, verificando que esté vigente, no revocado y sea apto para firmar.

Notas de uso

Todas las operaciones de firma y verificación dependen de certificados instalados localmente en la máquina host.
El campo Thumbprint es el identificador clave utilizado para seleccionar o validar un certificado en todos los endpoints relevantes.
Este servicio está pensado para ser consumido por otros servicios internos o aplicaciones que requieran firmas digitales con validez legal sobre documentos PDF.

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"24363379","collectionId":"d76988c0-1060-4cfd-abd5-e05ec7f4c8de","publishedId":"2sBXwmRt6j","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-05-27T21:55:38.000Z"},"item":[{"name":"Status","id":"1f61a394-c0c9-4674-94ea-c7faa8d55f28","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://localhost:7061/api/firmadigital/status","description":"

Verifica el estado del servicio de Firma Digital.

Retorna información sobre si el servicio está activo y operativo. Útil para health checks y monitoreo del microservicio.

Respuesta exitosa (200 OK):\nIndica que el servicio está en funcionamiento.

\n","urlObject":{"protocol":"https","port":"7061","path":["api","firmadigital","status"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"1f61a394-c0c9-4674-94ea-c7faa8d55f28"},{"name":"Certificados","id":"03e45361-a566-4f9e-86a1-7b3d69a23873","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://localhost:7061/api/firmadigital/certificados","description":"

Obtiene la lista de certificados digitales disponibles en el almacén de certificados del sistema.

Retorna los certificados instalados que pueden ser utilizados para firmar documentos PDF. Cada certificado se identifica por su Thumbprint.

Respuesta exitosa (200 OK):\nLista de certificados disponibles con sus datos (nombre, thumbprint, fecha de vencimiento, etc.).

\n","urlObject":{"protocol":"https","port":"7061","path":["api","firmadigital","certificados"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"03e45361-a566-4f9e-86a1-7b3d69a23873"},{"name":"FirmarPDF","id":"97532c69-0d88-47f4-a05b-0a53f5261a4f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"PdfUrl\":\"https://qa-static-files.dotech.io/pdf/19498.pdf\",\r\n \"PdfNombre\":\"19498.pdf\",\r\n \"Thumbprint\":\"093176DE785060A8C073A34EE3EC6735C8B81B92\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://localhost:7061/api/firmadigital/firmarPDF","description":"

Firma digitalmente un documento PDF utilizando un certificado digital instalado en el sistema.

Body (JSON):

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Descripción
PdfPath	string	Ruta absoluta al archivo PDF a firmar (ej: `d:\\temp\\pdfs\\19495.pdf`)
Thumbprint	string	Huella digital (thumbprint) del certificado a utilizar para la firma

Ejemplo de body:

{\n    \"PdfPath\": \"d:\\\\temp\\\\pdfs\\\\19495.pdf\",\n    \"Thumbprint\": \"093176DE785060A8C073A34EE3EC6735C8B81B92\"\n}\n

Respuesta exitosa (200 OK):\nEl PDF es firmado digitalmente con el certificado indicado.

\n","urlObject":{"protocol":"https","port":"7061","path":["api","firmadigital","firmarPDF"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"97532c69-0d88-47f4-a05b-0a53f5261a4f"},{"name":"Verificar Certificado","id":"5c4dd084-e3a7-4294-a5bb-016994f21b2c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"Thumbprint\":\"157EFCB6B87CB60FCD1AE6CF33970E61E22CB5F7\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://localhost:7061/api/firmadigital/verificarcertificado","description":"

Verifica la validez de un certificado digital a partir de su Thumbprint.

Permite comprobar si un certificado está vigente, no ha sido revocado y es válido para su uso en la firma de documentos.

Body (JSON):

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Descripción
Thumbprint	string	Huella digital (thumbprint) del certificado a verificar

Ejemplo de body:

{\n    \"Thumbprint\": \"157EFCB6B87CB60FCD1AE6CF33970E61E22CB5F7\"\n}\n\n

Respuesta exitosa (200 OK):
Retorna información sobre la validez del certificado consultado.

\n","urlObject":{"protocol":"https","port":"7061","path":["api","firmadigital","verificarcertificado"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"5c4dd084-e3a7-4294-a5bb-016994f21b2c"}]}