[{"data":1,"prerenderedAt":478},["ShallowReactive",2],{"kb-guia-rapida-de-integracion-para-la-firma-presencial":3,"kb-siblings-guia-rapida-de-integracion-para-la-firma-presencial":333},{"id":4,"title":5,"articleOrder":6,"body":7,"categories":312,"date":314,"description":315,"descriptionEdited":316,"draft":316,"extension":317,"knowledgeBase":318,"meta":319,"navigation":320,"order":321,"originalId":322,"originalUrl":323,"path":324,"readingTime":325,"seo":326,"slug":327,"stem":328,"subcategory":313,"subcategoryOrder":329,"tags":330,"updated":331,"__hash__":332},"kb\u002Fkb\u002Fguia-rapida-de-integracion-para-la-firma-presencial.md","Guía rápida de integración para la Firma Presencial",10,{"type":8,"value":9,"toc":302},"minimark",[10,14,19,26,30,41,71,78,82,89,92,95,106,111,114,119,124,129,132,135,138,142,197,201,204,266,270,273,283,287,293,296],[11,12,13],"p",{},"El siguiente documento tiene como objetivo dar detalles de las configuraciones y parámetros básicos para poder integrar la funcionalidad de la firma digitalizada manuscrita en tus aplicaciones de negocio mediante API Rest.",[15,16,18],"h2",{"id":17},"arquitectura-de-la-solución","Arquitectura de la solución",[11,20,21],{},[22,23],"img",{"alt":24,"src":25},"","\u002Fimages\u002Fkb\u002Fguia-rapida-de-integracion-para-la-firma-presencial\u002Fimage-16.png",[15,27,29],{"id":28},"pasos-a-seguir","Pasos a seguir",[11,31,32,33,40],{},"Te dejamos aquí los pasos a seguir para realizar la integración mediante API en tu empresa, pero si lo prefieres puedes visitar ",[34,35,39],"a",{"href":36,"rel":37},"https:\u002F\u002Ffirmaronline.typeform.com\u002Fto\u002FYA94MNQR?typeform-source=firmar.online",[38],"nofollow","este enlace interactivo"," en el que te lo mostramos de manera más detallada.",[42,43,44,48,51,54,57],"ul",{},[45,46,47],"li",{},"Descárgate la colección API Rest para utilizarla en tus peticiones.",[45,49,50],{},"Regístrate en nuestra WebApp: app.firmar.INFO (este es el entorno Sandbox para pruebas)",[45,52,53],{},"Genera tu API-Key (desde ajustes de la WebApp)",[45,55,56],{},"Solicita tu paquete de firmas a tu contacto comercial",[45,58,59,60],{},"Listo. Ya podrás consumir los cuatro servicios del PSC:\n",[42,61,62,65,68],{},[45,63,64],{},"Firma Remota (enviar a firmar)",[45,66,67],{},"Firma Presencial (firmar en el dispostivo asociado)",[45,69,70],{},"eFirma",[11,72,73,77],{},[74,75,76],"strong",{},"Nota",": Para realizar el paso a PRODUCCIÓN solo deberás modificar el endpoint y actualizar tu API Key.",[15,79,81],{"id":80},"firma-presencial","Firma presencial",[11,83,84,85,88],{},"En esta sección revisaremos el API Rest y su uso para invocar la funcionalidad de firma digitalizada manuscrita.",[86,87],"br",{},"\nEsta solución permite enviar documentos a un dispositivo móvil que tenga instalada la aplicación de edatalia SIGNply.",[11,90,91],{},"Seguimiento de los envíos: WebHook",[11,93,94],{},"Desde la WebApp podrás informar una URL a la que la plataforma informará los cambios de estado de los documentos. De esta manera podrás lanzar tu petición GET en el momento adecuado.",[42,96,97,100,103],{},[45,98,99],{},"Ingresa a la WebApp",[45,101,102],{},"Ve a «Intregación API»",[45,104,105],{},"En la sección WebHook agrega la URL deseada y guarda el cambio",[11,107,108],{},[22,109],{"alt":24,"src":110},"\u002Fimages\u002Fkb\u002Fguia-rapida-de-integracion-para-la-firma-presencial\u002Fimage-17.png",[11,112,113],{},"Asocia los dispositivos donde podrás visualizar y firmar los documentos:",[11,115,116],{},[22,117],{"alt":24,"src":118},"\u002Fimages\u002Fkb\u002Fguia-rapida-de-integracion-para-la-firma-presencial\u002Fimage-20.png",[11,120,121],{},[22,122],{"alt":24,"src":123},"\u002Fimages\u002Fkb\u002Fguia-rapida-de-integracion-para-la-firma-presencial\u002Fimage-21.png",[11,125,126],{},[22,127],{"alt":24,"src":128},"\u002Fimages\u002Fkb\u002Fguia-rapida-de-integracion-para-la-firma-presencial\u002Fimage-22.png",[11,130,131],{},"Desde tu dispositivo Móvil descárgate la aplicación SFA firmar.online",[11,133,134],{},"Desde la WebApp ve a la pestaña Dispositivos (en firma presencial) y haz click en «asociar dispositivo»",[11,136,137],{},"Desde SFA permite el uso de la cámara y captura el código QR mostrado en la WebApp",[15,139,141],{"id":140},"conociendo-la-api","Conociendo la API",[42,143,144,147,155,163,173],{},[45,145,146],{},"La colección pública contiene ejemplos de peticiones que comparten la misma estructura y parámetros de configuración.",[45,148,149,150],{},"La colección invoca distintas VARIABLES.\n",[42,151,152],{},[45,153,154],{},"Si estás utilizando POSTMAN, estas variables están pre-configuradas para usar como referencia.",[45,156,157,158],{},"Lo PRIMERO. Modificar la variable API-KEY que has generado en la WebApp en el paso anterior.\n",[42,159,160],{},[45,161,162],{},"Tendrás 2 API – Key, una para Producción y otra para SandBox.",[45,164,165,166],{},"El endpoint contiene la variable: ",[74,167,168,172],{},[169,170],"binding",{"value":171},"base\\_url","\u002F…\u002F…",[45,174,175,176,180,181],{},"Dependiendo del ambiente en el que quieras firmar, debes modificar la variable ",[74,177,178],{},[169,179],{"value":171},":\n",[42,182,183,190],{},[45,184,185,186],{},"Sandbox: ",[34,187,188],{"href":188,"rel":189},"https:\u002F\u002Frestapi.firmar.info",[38],[45,191,192,193],{},"Producción: ",[34,194,195],{"href":195,"rel":196},"https:\u002F\u002Frestapi.firmar.online",[38],[15,198,200],{"id":199},"firma-presencial-signfromapp","Firma Presencial – SignFromApp",[11,202,203],{},"Dentro de esta carpeta estan los métodos para comenzar un proceso de firma. En todos los casos al lanzar los métodos en la respuesta se devuelve un ID de documento\u002Fsobre que será necesario para recuperar del mismo.",[42,205,206,216,253],{},[45,207,208,211],{},[74,209,210],{},"Carpeta Nuevo Documento",[42,212,213],{},[45,214,215],{},"A01 – Nuevo_Documento: Este método POST permite lanzar una petición y que el documento se visualice en el dispositivo móvil.",[45,217,218,221],{},[74,219,220],{},"Carpeta Ciclo de vida del documento",[42,222,223,250],{},[45,224,225,226,228,229,231,232,234,235,237,238,240,241,243,244,246,247,249],{},"Obtener estado del documento – Este método GET devuelve un resultado numérico con el estado del documento:",[86,227],{},"\n0 None",[86,230],{},"\n100 Created",[86,233],{},"\n200 In Process",[86,236],{},"\n300 Completed",[86,239],{},"\n400 Canceled",[86,242],{},"\n500 Rejected",[86,245],{},"\n600 Deleted",[86,248],{},"\n700 Expired",[45,251,252],{},"Cancelar Proceso: Este método PUT cancela el proceso.",[45,254,255,258],{},[74,256,257],{},"Carpeta Fin de Ciclo",[42,259,260,263],{},[45,261,262],{},"Obtiene los dispositivos asociados – Este método GET devuelve los ID de los dispositivos asociados al API-Key que esta realizando la petición.",[45,264,265],{},"Obtener Histórico de documentos: Permite recuperar los ID y nombre de los envíos realizados con la API – Key.",[15,267,269],{"id":268},"los-parámetros-básicos","Los parámetros básicos",[11,271,272],{},"Los parámetros de configuración básicos que modifican los envíos realizados son:",[274,275,280],"pre",{"className":276,"code":278,"language":279},[277],"language-text","{ \"deviceId\": Aqui va el ID del dispositivo al que queremos enviar el documento. Lo podemos averiguar desde el dispositivo, desde la WebApp o realizando la petición \"Obtener los dispositivos Asociados\",\n    \"document\": {\n    \"name\": \"Titulo del documento\",\n    \"b64PDFContent\": El documento informado en Base 64,\n    \"description\": \"Descripción del Documento PDF a firmar\",\n    \"id\": Este campo permite informar un nombre personalizado a la petición para luego poder recuperar el documento con este ID },\n    \"widget\": { \"customtext\" :\n                  [ { \"text\": Texto personalizado que ira en el widget de la firma. Se puede repetir esta linea para lograr incorporar más texto.],\n     \"text\": Ubicación de la firma flotante. Aqui puedes informar la palabra a buscar en el documento\n     \"gapX\": posicionamiento con desfasaje en el eje X,\n     \"gapY\": posicionamiento con desfasaje en el eje Y,\n     \"width\" : Ancho del widget de firma,\n     \"height\" : Alto del widget de firma} ,\n     \"autoOpen\": Valor: true o false. Esta opción fuerza la apertura del documento o en contrario permite dejar en la bandeja de entrada de SIGNply los documentos para que sean abiertos manualmente.}\n","text",[281,282,278],"code",{"__ignoreMap":24},[15,284,286],{"id":285},"ejemplo-de-llamada-completa","Ejemplo de llamada completa",[274,288,291],{"className":289,"code":290,"language":279},[277],"IMPORTANTE: El valor de los siguientes parámetros no es modificable.\n\n\"sendMethod\": 4,\n\"authtype\": 0,\n\"actionType\": 30,\n",[281,292,290],{"__ignoreMap":24},[11,294,295],{},"Un ejemplo de llamada sería el siguiente:",[274,297,300],{"className":298,"code":299,"language":279},[277],"curl --location 'https:\u002F\u002Frestapi.firmar.info\u002FPSC\u002Fv40\u002FDocumentSet\u002Fsimple' \\\n--data-raw '{\n    \"documentSetName\": \"Nombre que queremos dar al envío\",\n    \"description\": \"Descripcion que se podra visualizar en la App, bajo el nombre del documento\",\n    \"sendermail\": \"noresponda@firmar.online\",\n    \"Sendername\": \"Nombre del emisor - firmar.online\",\n    \"expirationDaysTimeout\": 3,\n    \"sendMethod\": 4,\n    \"document\": {\n        \"name\": \"Nombre que queremos dar al documento\",\n        \"b64PDFContent\": \"PDF en Base64\"\n    },\n    \"recipient\": {\n        \"name\": \"Nombre del firmante\",\n        \"deviceId\": \"Identificador del dispositivo de firma\",\n        \"authtype\": 0,\n        \"actionType\": 30,\n        \"widget\": {\n            \"customtext\": [\n                {\n                    \"text\": \"Documento firmado digitalmente\",\n                    \"fontSize\": 3\n                },\n                {\n                    \"text\": \"Firmante: Nombre del firmante\",\n                    \"fontSize\": 3\n                },\n                {\n                    \"text\": \"Fecha ISO: ##TIMESTAMP##\",\n                    \"fontSize\": 2\n                }\n            ],\n            \"page\": 99,\n            \"x\": 50,\n            \"y\": 10,\n            \"width\": 100,\n            \"height\": 50\n        }\n    }\n}'\n",[281,301,299],{"__ignoreMap":24},{"title":24,"searchDepth":303,"depth":303,"links":304},2,[305,306,307,308,309,310,311],{"id":17,"depth":303,"text":18},{"id":28,"depth":303,"text":29},{"id":80,"depth":303,"text":81},{"id":140,"depth":303,"text":141},{"id":199,"depth":303,"text":200},{"id":268,"depth":303,"text":269},{"id":285,"depth":303,"text":286},[313],"Integradores","2023-06-28","El siguiente documento tiene como objetivo dar detalles de las configuraciones y parámetros básicos para poder integrar la funcionalidad de…",false,"md","firmar.online",{},true,null,7822,"https:\u002F\u002Fedatalia.com\u002Fkb\u002Fguia-rapida-de-integracion-para-la-firma-presencial\u002F","\u002Fkb\u002Fguia-rapida-de-integracion-para-la-firma-presencial",4,{"title":5,"description":315},"guia-rapida-de-integracion-para-la-firma-presencial","kb\u002Fguia-rapida-de-integracion-para-la-firma-presencial",3,[],"2025-07-07","ux7cCAW7RrPt0vUKYL9QYUk9LBPMoOCGR2DyrrMRLiM",[334,337,340,343,346,349,352,355,358,361,364,367,370,373,376,379,382,385,388,391,394,397,400,402,405,408,411,414,417,420,421,424,427,430,433,436,439,442,445,448,451,454,457,460,463,466,469,472,475],{"slug":335,"title":336},"accion-requerida-al-firmante-en-procesos-de-firma-electronica-remota","Acción requerida al firmante en procesos de firma electrónica remota",{"slug":338,"title":339},"adjuntar-documentos","Adjuntar documentos",{"slug":341,"title":342},"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":344,"title":345},"api-rest-40","API REST 40",{"slug":347,"title":348},"autenticacion-de-firmantes-en-procesos-de-firma-electronica-remota","Autenticación de firmantes en procesos de firma electrónica remota",{"slug":350,"title":351},"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":353,"title":354},"captura-de-firma-digital-comparativa-entre-dispositivos","Captura de Firma Digital: Comparativa entre Dispositivos",{"slug":356,"title":357},"codigos-de-trazabilidad","Códigos de trazabilidad",{"slug":359,"title":360},"combinacion-de-correspondencia","Envíos mediante Lotes (Combinación de correspondencia)",{"slug":362,"title":363},"como-adquirir-o-renovar-un-certificado-de-firma","¿Cómo adquirir o renovar un certificado de firma?",{"slug":365,"title":366},"como-conseguir-una-firma-ltv","Cómo conseguir una firma LTV",{"slug":368,"title":369},"como-se-ve-la-firma-digital-en-el-documento-pdf","Como se ve la firma digital en el documento PDF",{"slug":371,"title":372},"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":374,"title":375},"descarga-masiva","Descarga masiva: Descarga de los documentos firmados y de la trazabilidad de los envíos",{"slug":377,"title":378},"descargas","Descarga del esquema de funcionalidades de firmar.online",{"slug":380,"title":381},"documentos-recibidos","Documentos recibidos: Firma de documentos por parte del usuario",{"slug":383,"title":384},"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":386,"title":387},"el-firmante-no-recibe-el-sms-en-su-telefono-para-firmar","El firmante no recibe el SMS en su teléfono para firmar",{"slug":389,"title":390},"equipos","Gestión de equipos y usuarios",{"slug":392,"title":393},"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":395,"title":396},"firma-corporativa","Firma corporativa",{"slug":398,"title":399},"firma-en-tabletas-ios-y-android","Firma en Tabletas (iOS, Android y Wacom)",{"slug":80,"title":401},"Firma Presencial",{"slug":403,"title":404},"firma-remota","Pantalla Inicial: Menú de Aplicaciones",{"slug":406,"title":407},"firma-remota-notificaciones","Firma Remota – notificaciones",{"slug":409,"title":410},"firmar-online-presentacion","Presentación firmar.online",{"slug":412,"title":413},"firmar-un-documento-ya-firmado","Firmar un documento ya firmado",{"slug":415,"title":416},"flujos","Flujos: Configuración predeterminada de envíos",{"slug":418,"title":419},"guia-de-productos-edatalia","Guía de Productos Edatalia",{"slug":327,"title":5},{"slug":422,"title":423},"iniciar-sesion-2","Registro y acceso a firmar.online",{"slug":425,"title":426},"la-firma-digital-manuscrita-requiere-instalacion-en-dispositivo","¿La firma digital manuscrita requiere instalación en dispositivo?",{"slug":428,"title":429},"manual-webforms","Manual para la generación de Formularios – WebForms",{"slug":431,"title":432},"metodos-de-autenticacion","Métodos de autenticación",{"slug":434,"title":435},"metodos-de-envio","Métodos de envío",{"slug":437,"title":438},"metodos-de-firma","Métodos de firma",{"slug":440,"title":441},"modificacion-de-un-documento-firmado","Modificación de un documento firmado",{"slug":443,"title":444},"perfil","Mi Perfil",{"slug":446,"title":447},"perfil-de-usuario","Herramientas: Firma digital, sellado de tiempo y validación de firmas",{"slug":449,"title":450},"plantilla-estandar-en-los-correos-de-firmar-online","Plantillas pre-formateadas en los correos de firmar.online",{"slug":452,"title":453},"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":455,"title":456},"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":458,"title":459},"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":461,"title":462},"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":464,"title":465},"que-es-el-token","¿Qué es el token?",{"slug":467,"title":468},"seguimiento-de-envios-en-firmar-online","Seguimiento de envíos en firmar.online",{"slug":470,"title":471},"servicios-avanzados-de-firma","Servicios avanzados de firma",{"slug":473,"title":474},"solicitud-de-documentacion-anexa-al-firmante","Solicitud de documentación anexa al firmante",{"slug":476,"title":477},"webhook-de-firma-digital","Webhook de firma digital",1780912531447]