[{"data":1,"prerenderedAt":542},["ShallowReactive",2],{"kb-webhook-de-firma-digital":3,"kb-siblings-webhook-de-firma-digital":396},{"id":4,"title":5,"articleOrder":6,"body":7,"categories":378,"date":380,"description":381,"descriptionEdited":382,"draft":382,"extension":383,"knowledgeBase":20,"meta":384,"navigation":385,"order":386,"originalId":387,"originalUrl":388,"path":389,"readingTime":374,"seo":390,"slug":391,"stem":392,"subcategory":379,"subcategoryOrder":374,"tags":393,"updated":394,"__hash__":395},"kb\u002Fkb\u002Fwebhook-de-firma-digital.md","Webhook de firma digital",4,{"type":8,"value":9,"toc":370},"minimark",[10,26,38,41,46,49,52,63,66,72,75,78,81,84,87,90,93,96,99,102,105,108,110,113,116,118,121,124,127,130,133,135,138,141,143,146,151,158,163,168,171,174,177,180,183,186,189,192,195,198,201,204,207,209,212,215,218,220,223,226,229,231,234,237,240,242,245,248,250,253,256,259,262,265,268,271,274,277,280,283,286,289,294,297,303,306,310,318,324,331,344,354,358,361,364],[11,12,13,14,21,22,25],"p",{},"El webhook de ",[15,16,20],"a",{"href":17,"rel":18},"https:\u002F\u002Ffirmar.online",[19],"nofollow","firmar.online"," informa de los eventos que propician cambios en el estado de los documentos, por lo que te permitirá realizar un seguimiento automatizado de cada uno de ellos. Cada vez que el documento enviado para su firma electrónica (DocumentSet) cambie de estado, ",[15,23,20],{"href":17,"rel":24},[19]," te informará de qué acción ha ocurrido para provocar este cambio de estado. Esta comunicación se realiza al instante por medio de una llamada http.",[11,27,28,29,33,34,37],{},"Aplica exclusivamente a los documentos procesados mediante las funciones de “",[30,31,32],"strong",{},"enviar a firmar","” y “",[30,35,36],{},"firma presencial","”. Es decir, cuando se quiere solicitar la firma electrónica de un documento a otra persona, ya sea en un proceso presencial o remoto (recuerda que la firma digital en servidor y la validación de la firma digital de documentos se realizan de forma síncrona. Por tanto, los documentos se devuelven automáticamente firmados. No tienen gestión de estados)",[11,39,40],{},"Puedes definir tu URL en el área de ajustes de la aplicación web.",[42,43,45],"h3",{"id":44},"notificaciones-webhook-firma-digital","Notificaciones “webhook” – firma digital",[11,47,48],{},"Las notificaciones se realizan en formato JSON",[11,50,51],{},"Un ejemplo de “nuevo sobre en la plataforma” sería el siguiente:",[53,54,59],"pre",{"className":55,"code":57,"language":58},[56],"language-text","{\"eventType\": 101,\"timestamp\": \"2021-09-22T10:14:30.7106693Z\",\"data\": {\"documentSetToken\": \"8283524AF3C44AD3A43C295735050446\"}}\n","text",[60,61,57],"code",{"__ignoreMap":62},"",[11,64,65],{},"Un ejemplo de “sobre completado” sería:",[53,67,70],{"className":68,"code":69,"language":58},[56],"{\"eventType\": 102,\"timestamp\": \"2022-02-23T09:10:58.3288864Z\",\"data\": {\"documentSetId\": \"10380\",\"numAttachments\": \"0\",\"documentSetToken\": \"2CBD36556DBC4921BE0803F8101CF003\",\"reference\": \"W2L|NIF|Nombre del firmante|TimeStamp\"}}\n",[60,71,69],{"__ignoreMap":62},[11,73,74],{},"La información enviada sería la siguiente:",[11,76,77],{},"eventType",[11,79,80],{},"Código tipo evento",[11,82,83],{},"integer",[11,85,86],{},"timestamp",[11,88,89],{},"Fecha evento",[11,91,92],{},"ISO 8601",[11,94,95],{},"data.recipientActionId",[11,97,98],{},"identificador interno persona documento",[11,100,101],{},"intenger",[11,103,104],{},"data.documentSetId",[11,106,107],{},"Identificador interno sobre",[11,109,83],{},[11,111,112],{},"data.numAttachments",[11,114,115],{},"Numero de ficheros adjuntados por el firmante",[11,117,83],{},[11,119,120],{},"data.documentSetToken",[11,122,123],{},"Identificador sobre",[11,125,126],{},"texto",[11,128,129],{},"data.motivoRechazo",[11,131,132],{},"Motivo rechazo sobre",[11,134,126],{},[11,136,137],{},"data.reference",[11,139,140],{},"Referencia externa sobre",[11,142,126],{},[11,144,145],{},"Las posibles acciones de las que informa el webhook, para firma remota, son las siguientes:",[11,147,148],{},[30,149,150],{},"Evento",[11,152,153],{},[30,154,155],{},[30,156,157],{},"Descripción evento",[11,159,160],{},[30,161,162],{},"Nuevo estado",[11,164,165],{},[30,166,167],{},"Descripción estado",[11,169,170],{},"100",[11,172,173],{},"Documento creado",[11,175,176],{},"101",[11,178,179],{},"Sobre creado",[11,181,182],{},"200",[11,184,185],{},"En proceso",[11,187,188],{},"102",[11,190,191],{},"Sobre completado",[11,193,194],{},"300",[11,196,197],{},"Completado",[11,199,200],{},"103",[11,202,203],{},"Caducado",[11,205,206],{},"700",[11,208,203],{},[11,210,211],{},"104",[11,213,214],{},"Cancelado",[11,216,217],{},"400",[11,219,214],{},[11,221,222],{},"105",[11,224,225],{},"Eliminado",[11,227,228],{},"600",[11,230,225],{},[11,232,233],{},"106",[11,235,236],{},"Rechazado",[11,238,239],{},"500",[11,241,236],{},[11,243,244],{},"107",[11,246,247],{},"Recordatorio enviado",[11,249,182],{},[11,251,252],{},"En progreso",[11,254,255],{},"108",[11,257,258],{},"Error en el sobre",[11,260,261],{},"307",[11,263,264],{},"Firmado por uno de los participantes",[11,266,267],{},"1000",[11,269,270],{},"Descarga masiva creada",[11,272,273],{},"1001",[11,275,276],{},"Descarga masiva en proceso",[11,278,279],{},"1002",[11,281,282],{},"Descarga masiva completada",[11,284,285],{},"1003",[11,287,288],{},"Descarga masiva errónea",[290,291,293],"h2",{"id":292},"política-de-reintentos","Política de reintentos",[11,295,296],{},"El webhook sigue una política de reintentos para asegurar que la información ha sido recibida de forma correcta.",[11,298,299,300,25],{},"Cada vez que el DocumentSet cambia de estado, ",[15,301,20],{"href":17,"rel":302},[19],[11,304,305],{},"Si la llamada http devuelve el código 200 (OK), entendemos que se ha registrado correctamente y no se vuelve a enviar. En caso de no recibir ese código 200 (OK) de la llamada http, el webhook entra en una política de reintentos. Se volverá a tratar de informar del evento hasta tres veces.",[290,307,309],{"id":308},"pasos-para-probar-el-webhook-de-firma-digital","Pasos para probar el webhook de firma digital",[11,311,312,313,317],{},"Puedes probar la funcionalidad y ver cómo llegan las respuestas en este portal web, ",[15,314,315],{"href":315,"rel":316},"https:\u002F\u002Fwebhook.site\u002F",[19]," Para ello, tendrías que seguir los siguientes pasos:",[11,319,320,321],{},"1.- Acceder a ",[15,322,315],{"href":315,"rel":323},[19],[11,325,326,327],{},"Verás que automáticamente te asigna una URL, con este formato ",[15,328,329],{"href":329,"rel":330},"https:\u002F\u002Fwebhook.site\u002F#!\u002Fd0d83771-363c-4e09-aae0-6c8a447181cd",[19],[11,332,333,334,338,339,343],{},"2.- Copia esta URL en la sección de Ajustes de la aplicación web. Funciona tanto en el entorno de producción (",[15,335,336],{"href":336,"rel":337},"https:\u002F\u002Fapp.firmar.online",[19],") como en el de integraciones (",[15,340,341],{"href":341,"rel":342},"https:\u002F\u002Fapp.firmar.info",[19],"). Puedes configurar la misma URL de mismo webhook a los dos entornos.",[11,345,346,347,350,351],{},"3.- El la web ",[15,348,315],{"href":315,"rel":349},[19]," verás cómo se van reflejando las diferentes acciones realizadas en ",[15,352,20],{"href":17,"rel":353},[19],[290,355,357],{"id":356},"cómo-añadir-usuario-y-contraseña-del-webhook","¿Cómo añadir usuario y contraseña del Webhook?",[11,359,360],{},"Se trata de enviar la información de autenticación en una cabecera de manera similar a como se hace en Postman o en webhook.site",[11,362,363],{},"Se añadiría a la configuración del Webhook y sería válido para todo tipo de autenticación.",[11,365,366],{},[367,368],"img",{"alt":62,"src":369},"\u002Fimages\u002Fkb\u002Fwebhook-de-firma-digital\u002Fapp.firmar.online_usuario-en-webhook-scaled.png",{"title":62,"searchDepth":371,"depth":371,"links":372},2,[373,375,376,377],{"id":44,"depth":374,"text":45},3,{"id":292,"depth":371,"text":293},{"id":308,"depth":371,"text":309},{"id":356,"depth":371,"text":357},[379],"Integradores","2023-05-31","El webhook de firmar.online informa de los eventos que propician cambios en el estado de los documentos, por lo que te permitirá realizar…",false,"md",{},true,null,7735,"https:\u002F\u002Fedatalia.com\u002Fkb\u002Fwebhook-de-firma-digital\u002F","\u002Fkb\u002Fwebhook-de-firma-digital",{"title":5,"description":381},"webhook-de-firma-digital","kb\u002Fwebhook-de-firma-digital",[],"2025-04-29","ltDvJhnSnYu1zyB2AgIOLm_oBlVI0diEThXmOHtlM7c",[397,400,403,406,409,412,415,418,421,424,427,430,433,436,439,442,445,448,451,454,457,460,463,466,469,472,475,478,481,484,487,490,493,496,499,502,505,508,511,514,517,520,523,526,529,532,535,538,541],{"slug":398,"title":399},"accion-requerida-al-firmante-en-procesos-de-firma-electronica-remota","Acción requerida al firmante en procesos de firma electrónica remota",{"slug":401,"title":402},"adjuntar-documentos","Adjuntar documentos",{"slug":404,"title":405},"al-abrir-un-documento-firmado-con-adobe-me-dice-que-la-firma-no-se-ha-verificado","Al abrir un documento firmado con Adobe me dice que la firma no se ha verificado",{"slug":407,"title":408},"api-rest-40","API REST 40",{"slug":410,"title":411},"autenticacion-de-firmantes-en-procesos-de-firma-electronica-remota","Autenticación de firmantes en procesos de firma electrónica remota",{"slug":413,"title":414},"caduco-el-certificado-en-los-los-documentos-que-se-firmaron-no-aparece-el-mensaje-firmado-y-todas-las-firmas-son-validas","Caducó el certificado. En los los documentos que se firmaron no aparece el mensaje “Firmado y todas las firmas son válidas”",{"slug":416,"title":417},"captura-de-firma-digital-comparativa-entre-dispositivos","Captura de Firma Digital: Comparativa entre Dispositivos",{"slug":419,"title":420},"codigos-de-trazabilidad","Códigos de trazabilidad",{"slug":422,"title":423},"combinacion-de-correspondencia","Envíos mediante Lotes (Combinación de correspondencia)",{"slug":425,"title":426},"como-adquirir-o-renovar-un-certificado-de-firma","¿Cómo adquirir o renovar un certificado de firma?",{"slug":428,"title":429},"como-conseguir-una-firma-ltv","Cómo conseguir una firma LTV",{"slug":431,"title":432},"como-se-ve-la-firma-digital-en-el-documento-pdf","Como se ve la firma digital en el documento PDF",{"slug":434,"title":435},"como-solucionar-la-compatibilidad-de-google-chrome-para-conexiones-seguras-tls-1-0-y-1-1-al-utilizar-el-flujo-web-error-err-ssl-obsolete-version","Cómo solucionar la compatibilidad de Google Chrome para conexiones seguras TLS 1.0 y 1.1 al utilizar el flujo web (error ERR_SSL_OBSOLETE_VERSION)",{"slug":437,"title":438},"descarga-masiva","Descarga masiva: Descarga de los documentos firmados y de la trazabilidad de los envíos",{"slug":440,"title":441},"descargas","Descarga del esquema de funcionalidades de firmar.online",{"slug":443,"title":444},"documentos-recibidos","Documentos recibidos: Firma de documentos por parte del usuario",{"slug":446,"title":447},"el-firmante-no-recibe-el-email-para-acceder-a-firmar-un-documento","El firmante no recibe el email para acceder a firmar un documento",{"slug":449,"title":450},"el-firmante-no-recibe-el-sms-en-su-telefono-para-firmar","El firmante no recibe el SMS en su teléfono para firmar",{"slug":452,"title":453},"equipos","Gestión de equipos y usuarios",{"slug":455,"title":456},"es-posible-realizar-firmas-pades-ltv-con-certificados-de-la-fabrica-nacional-de-moneda-y-timbre","¿Es posible realizar firmas PADES-LTV con certificados de la Fabrica Nacional de Moneda y Timbre?",{"slug":458,"title":459},"firma-corporativa","Firma corporativa",{"slug":461,"title":462},"firma-en-tabletas-ios-y-android","Firma en Tabletas (iOS, Android y Wacom)",{"slug":464,"title":465},"firma-presencial","Firma Presencial",{"slug":467,"title":468},"firma-remota","Pantalla Inicial: Menú de Aplicaciones",{"slug":470,"title":471},"firma-remota-notificaciones","Firma Remota – notificaciones",{"slug":473,"title":474},"firmar-online-presentacion","Presentación firmar.online",{"slug":476,"title":477},"firmar-un-documento-ya-firmado","Firmar un documento ya firmado",{"slug":479,"title":480},"flujos","Flujos: Configuración predeterminada de envíos",{"slug":482,"title":483},"guia-de-productos-edatalia","Guía de Productos Edatalia",{"slug":485,"title":486},"guia-rapida-de-integracion-para-la-firma-presencial","Guía rápida de integración para la Firma Presencial",{"slug":488,"title":489},"iniciar-sesion-2","Registro y acceso a firmar.online",{"slug":491,"title":492},"la-firma-digital-manuscrita-requiere-instalacion-en-dispositivo","¿La firma digital manuscrita requiere instalación en dispositivo?",{"slug":494,"title":495},"manual-webforms","Manual para la generación de Formularios – WebForms",{"slug":497,"title":498},"metodos-de-autenticacion","Métodos de autenticación",{"slug":500,"title":501},"metodos-de-envio","Métodos de envío",{"slug":503,"title":504},"metodos-de-firma","Métodos de firma",{"slug":506,"title":507},"modificacion-de-un-documento-firmado","Modificación de un documento firmado",{"slug":509,"title":510},"perfil","Mi Perfil",{"slug":512,"title":513},"perfil-de-usuario","Herramientas: Firma digital, sellado de tiempo y validación de firmas",{"slug":515,"title":516},"plantilla-estandar-en-los-correos-de-firmar-online","Plantillas pre-formateadas en los correos de firmar.online",{"slug":518,"title":519},"porque-no-puedo-firmar-un-documento-certificado-o-certificar-un-documento-anteriormente-firmado","¿Porqué no puedo firmar un documento certificado o certificar un documento anteriormente firmado?",{"slug":521,"title":522},"porque-se-muestra-en-distinto-formato-la-hora-en-la-ventana-propiedades-de-la-firma-de-adobe-y-en-el-widget-de-la-firma","¿Porqué se muestra en distinto formato la hora en la ventana Propiedades de la firma de Adobe y en el Widget de la firma?",{"slug":524,"title":525},"puedo-ver-las-firmas-contenidas-en-un-pdf-con-el-visor-del-navegador","¿Puedo ver las firmas contenidas en un PDF con el visor del navegador?",{"slug":527,"title":528},"que-caracteristicas-debe-cumplir-un-documento-pdf-para-poder-ser-firmado-segun-los-estandares-de-adobe","¿Qué características debe cumplir un documento PDF para poder ser firmado según los estándares de Adobe?",{"slug":530,"title":531},"que-es-el-token","¿Qué es el token?",{"slug":533,"title":534},"seguimiento-de-envios-en-firmar-online","Seguimiento de envíos en firmar.online",{"slug":536,"title":537},"servicios-avanzados-de-firma","Servicios avanzados de firma",{"slug":539,"title":540},"solicitud-de-documentacion-anexa-al-firmante","Solicitud de documentación anexa al firmante",{"slug":391,"title":5},1780912531224]