[{"data":1,"prerenderedAt":514},["ShallowReactive",2],{"kb-api-rest-40":3,"kb-siblings-api-rest-40":368},{"id":4,"title":5,"articleOrder":6,"body":7,"categories":349,"date":351,"description":352,"descriptionEdited":353,"draft":353,"extension":354,"knowledgeBase":28,"meta":355,"navigation":356,"order":357,"originalId":358,"originalUrl":359,"path":360,"readingTime":361,"seo":362,"slug":363,"stem":364,"subcategory":350,"subcategoryOrder":336,"tags":365,"updated":366,"__hash__":367},"kb\u002Fkb\u002Fapi-rest-40.md","API REST 40",1,{"type":8,"value":9,"toc":328},"minimark",[10,15,19,30,46,50,59,64,67,70,74,91,95,109,113,116,120,126,133,137,166,182,189,193,196,199,203,206,210,213,220,228,232,235,261,267,271,274,277,313,317,320],[11,12,14],"h2",{"id":13},"firma-digital-full-rest-api-v40-bienvenido","Firma digital – FULL REST API v40 – Bienvenido",[16,17,18],"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 digital en tus aplicaciones de negocio mediante API REST.",[16,20,21,22,29],{},"Aquí encontrarás todos los métodos y esquemas de ",[23,24,28],"a",{"href":25,"rel":26},"https:\u002F\u002Ffirmar.online",[27],"nofollow","firmar.online"," para integrar en tus procesos de negocio diferentes flujos de firma:",[31,32,33,37,40,43],"ul",{},[34,35,36],"li",{},"Enviar a firmar: envía documentos a otras Personas para que el firmen sobre su propio dispositivo (Firma Remota)",[34,38,39],{},"Solicitar la firma presencial en tus dispositivos: solicita la firma digital manuscrita a tus propios dispositivos",[34,41,42],{},"Firma de documentos con certificado electrónico y aplicar en sello de tiempo con garantías probatorias en servidor",[34,44,45],{},"Validar la firma digital de documentos",[11,47,49],{"id":48},"cómo-puedo-comenzar-a-solicitar-la-firma-digital","¿Cómo puedo comenzar a solicitar la firma digital?",[16,51,52,53,58],{},"Puedes seguir nuestra guía paso a paso: ",[23,54,57],{"href":55,"rel":56},"https:\u002F\u002Ffirmaronline.typeform.com\u002Fto\u002FBlv0dD37\u002F?utm_source=web&utm_medium=soporteFO",[27],"acceder a la guía",".",[60,61,63],"h3",{"id":62},"paso-1-regístrate-y-accede-a-tu-api-key","Paso 1: regístrate y accede a tu API KEY",[16,65,66],{},"Lo primero, tienes que registrarte en nuestra aplicación web. Contamos con un entorno de producción, que ofrece los servicios de firma digital para tus documentos, y un entorno de pruebas (“sandbox”) que podrás utilizar para la fase de integración.",[16,68,69],{},"Sólo por registrarte, tendrás acceso a un paquete de 10 firmas para comenzar a funcionar!",[60,71,73],{"id":72},"entorno-de-producción","entorno de producción",[16,75,76,77,80,81,85,87,88],{},"Aquí deberán estar los documentos reales",[78,79],"br",{},"\n– Aplicación web: ",[23,82,83],{"href":83,"rel":84},"https:\u002F\u002Fapp.firmar.online",[27],[78,86],{},"\n– endpoint API REST: ",[23,89,83],{"href":83,"rel":90},[27],[60,92,94],{"id":93},"entorno-de-pruebas-sandbox","entorno de pruebas – Sandbox",[16,96,97,98,80,100,104,87,106],{},"Puedes utilizarlo para pruebas de integración",[78,99],{},[23,101,102],{"href":102,"rel":103},"https:\u002F\u002Fapp.firmar.info",[27],[78,105],{},[23,107,102],{"href":102,"rel":108},[27],[60,110,112],{"id":111},"paso-2-integración","Paso 2: Integración",[16,114,115],{},"Aquí tienes algunos recursos que te ayudarán a integrar la firma digital en tus procesos de negocio:",[60,117,119],{"id":118},"definiciones-swagger","Definiciones Swagger",[16,121,122,123,125],{},"Accede a las definiciones de los métodos en Swagger.",[78,124],{},"\nRecuerda que tienes una definición para cada tipo de flujo",[16,127,128],{},[23,129,132],{"href":130,"rel":131},"https:\u002F\u002Frestapi.firmar.online\u002F",[27],"Definiciones swagger",[60,134,136],{"id":135},"colección-postman","COLECCIÓN POSTMAN",[16,138,139,140,142,143,145,146,148,149,151,152,154,155,159,160,162,163,165],{},"Descárgate la colección API REST para utilizarla en tus peticiones.",[78,141],{},"\nEsta colección contiene ejemplos de peticiones que comparten la misma estructura y parámetros de configuración.",[78,144],{},"\nLa colección invoca distintas VARIABLES: Si estás utilizando POSTMAN, estas variables están pre-configuradas para usar como referencia, pero puedes cambiarlas segun te convenga.",[78,147],{},"\nLo PRIMERO. Modificar la variable API-KEY que has generado en la WebApp en el paso anterior.",[78,150],{},"\nTendrás 2 API – Key, una para Producción y otra para SandBox.",[78,153],{},"\nEl endpoint contiene la variable: ",[156,157],"binding",{"value":158},"base\\_url","\u002F…\u002F…",[78,161],{},"\nDependiendo del ambiente en el que quieras firmar, debes modificar la variable ",[156,164],{"value":158},". Recuerda:",[31,167,168,175],{},[34,169,170,171],{},"Sandbox: ",[23,172,173],{"href":173,"rel":174},"https:\u002F\u002Frestapi.firmar.info",[27],[34,176,177,178],{},"Producción: ",[23,179,180],{"href":180,"rel":181},"https:\u002F\u002Frestapi.firmar.online",[27],[16,183,184],{},[23,185,188],{"href":186,"rel":187},"https:\u002F\u002Fdocumenter.getpostman.com\u002Fview\u002F9780542\u002FTVmHDetH",[27],"Colección de POSTMAN",[60,190,192],{"id":191},"paso-3-pase-a-producción-estamos-en-el-aire","Paso 3: Pase a producción «estamos en el aire!!»",[16,194,195],{},"Si has realizado la integración en el entorno de pruebas, sólo tienes que cambiar el endpoint de producción.",[16,197,198],{},"Recuerda que también tienes que tomar el API KEY de la aplicación web de producción!!",[11,200,202],{"id":201},"firma-digital-parámetros-del-api","Firma digital – Parámetros del API",[16,204,205],{},"En este apartado podrás ver los parámetros más relevantes para la automatización de tus procesos de firma digital",[60,207,209],{"id":208},"visualización-de-la-firma-digital-en-el-documento-pdf","Visualización de la firma digital en el documento PDF",[16,211,212],{},"La firma digital aplica a todo el documento, independientemente de cómo se visualiza en el mismo. Es decir, aporta las mismas garantías si la firma digital se mantiene oculta, se visualiza en una sola página o en todas las páginas del documento electrónico. ",[16,214,215,219],{},[216,217,218],"strong",{},"Llamamos Widget a la visualización de la firma digital en el documento PDF",". Si abrimos el documento con Adobe Reader y pulsamos sobre el widget, el propio Adobe nos verifica la validez de la firma.",[16,221,222,223],{},"En este artículo te explicamos cómo se visualiza la firma digital en el PDF ",[23,224,227],{"href":225,"rel":226},"https:\u002F\u002Fsoporte.firmar.online\u002Fcomo-se-ve-la-firma-digital-en-el-documento-pdf\u002F",[27],"saber más",[60,229,231],{"id":230},"estado-de-los-documentos-enviar-a-firmar-y-firma-presencial","Estado de los documentos (enviar a firmar y firma presencial)",[16,233,234],{},"Estos son los posibles estados de los documentos en los procesos de firma presencial y firma remota*:",[31,236,237,240,243,246,249,252,255,258],{},[34,238,239],{},"00 – Sin estado (None)",[34,241,242],{},"100- Documento Creado (Created)",[34,244,245],{},"200 – en progreso (In Process)",[34,247,248],{},"300 Flujo de documento Completado (Completed)",[34,250,251],{},"400 Flujo cancelado (Canceled)",[34,253,254],{},"500 El interesado ha rechazado firmar el documento (Rejected)",[34,256,257],{},"600 Documento eliminado (Deleted)",[34,259,260],{},"700 Vencido: ha pasado el plazo para firmar el documento (Expired)",[16,262,263,266],{},[216,264,265],{},"*Nota",": recuerda que la firma digital en servidor y la validación de la firma son métodos “sincronos”. La acción se realiza en el momento de la solicitud y el documento no se guarda en el servidor. Por eso, documentos no tienen estado.",[60,268,270],{"id":269},"enviar-a-firmar-firma-remota-comportamiento-de-los-participantes","Enviar a firmar – firma remota – Comportamiento de los participantes",[16,272,273],{},"Cuando enviamos un nuevo sobre, podemos escoger cómo queremos autenticar al participante y qué acciones deben realizar sobre el documento.",[16,275,276],{},"Para ello, disponemos de los parámetros",[31,278,279,293],{},[34,280,281,287,288,292],{},[282,283,284],"em",{},[216,285,286],{},"authType",": forma de autenticación del participante en el flujo del documento. Esta acción se realiza de forma previa a la visualización del documento. (",[23,289,227],{"href":290,"rel":291},"https:\u002F\u002Fedatalia.com\u002Fkb\u002Fautenticacion-de-firmantes-en-procesos-de-firma-electronica-remota\u002F",[27],")",[34,294,295,300,301,304,305,309],{},[282,296,297],{},[216,298,299],{},"actionType",": ",[23,302,28],{"href":25,"rel":303},[27]," dispone de diferentes métodos que garantizan la aceptación expresa del firmante al contenido del documento. Esto se traduce en la acción requerida al participante tras visualizar el documento (",[23,306,227],{"href":307,"rel":308},"https:\u002F\u002Fedatalia.com\u002Fkb\u002Faccion-requerida-al-firmante-en-procesos-de-firma-electronica-remota\u002F",[27],[23,310,292],{"href":311,"rel":312},"https:\u002F\u002Fsoporte.firmar.online\u002Faccion-requerida-al-firmante-en-procesos-de-firma-electronica-remota\u002F",[27],[60,314,316],{"id":315},"webhook","Webhook",[16,318,319],{},"El webhook te informará de los cambios de estado de los documentos, por lo que te permitirá realizar un seguimiento automatizado de cada uno de ellos.",[16,321,322,323],{},"Puedes definir tu URL en el área de ajustes de la aplicación web. ",[23,324,327],{"href":325,"rel":326},"https:\u002F\u002Fedatalia.com\u002Fkb\u002Fwebhook-de-firma-digital\u002F",[27],"Saber más",{"title":329,"searchDepth":330,"depth":330,"links":331},"",2,[332,333,343],{"id":13,"depth":330,"text":14},{"id":48,"depth":330,"text":49,"children":334},[335,337,338,339,340,341,342],{"id":62,"depth":336,"text":63},3,{"id":72,"depth":336,"text":73},{"id":93,"depth":336,"text":94},{"id":111,"depth":336,"text":112},{"id":118,"depth":336,"text":119},{"id":135,"depth":336,"text":136},{"id":191,"depth":336,"text":192},{"id":201,"depth":330,"text":202,"children":344},[345,346,347,348],{"id":208,"depth":336,"text":209},{"id":230,"depth":336,"text":231},{"id":269,"depth":336,"text":270},{"id":315,"depth":336,"text":316},[350],"Integradores","2023-05-30","Firma digital – FULL REST API v40 – Bienvenido El siguiente documento tiene como objetivo dar detalles de las configuraciones y parámetros…",false,"md",{},true,null,7705,"https:\u002F\u002Fedatalia.com\u002Fkb\u002Fapi-rest-40\u002F","\u002Fkb\u002Fapi-rest-40",4,{"title":5,"description":352},"api-rest-40","kb\u002Fapi-rest-40",[],"2023-05-31","58xT_F52N9nlT2vXvS7D9wFTrhRey1tbvHhLfZjf4lo",[369,372,375,378,379,382,385,388,391,394,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],{"slug":370,"title":371},"accion-requerida-al-firmante-en-procesos-de-firma-electronica-remota","Acción requerida al firmante en procesos de firma electrónica remota",{"slug":373,"title":374},"adjuntar-documentos","Adjuntar documentos",{"slug":376,"title":377},"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":363,"title":5},{"slug":380,"title":381},"autenticacion-de-firmantes-en-procesos-de-firma-electronica-remota","Autenticación de firmantes en procesos de firma electrónica remota",{"slug":383,"title":384},"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":386,"title":387},"captura-de-firma-digital-comparativa-entre-dispositivos","Captura de Firma Digital: Comparativa entre Dispositivos",{"slug":389,"title":390},"codigos-de-trazabilidad","Códigos de trazabilidad",{"slug":392,"title":393},"combinacion-de-correspondencia","Envíos mediante Lotes (Combinación de correspondencia)",{"slug":395,"title":396},"como-adquirir-o-renovar-un-certificado-de-firma","¿Cómo adquirir o renovar un certificado de firma?",{"slug":398,"title":399},"como-conseguir-una-firma-ltv","Cómo conseguir una firma LTV",{"slug":401,"title":402},"como-se-ve-la-firma-digital-en-el-documento-pdf","Como se ve la firma digital en el documento PDF",{"slug":404,"title":405},"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":407,"title":408},"descarga-masiva","Descarga masiva: Descarga de los documentos firmados y de la trazabilidad de los envíos",{"slug":410,"title":411},"descargas","Descarga del esquema de funcionalidades de firmar.online",{"slug":413,"title":414},"documentos-recibidos","Documentos recibidos: Firma de documentos por parte del usuario",{"slug":416,"title":417},"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":419,"title":420},"el-firmante-no-recibe-el-sms-en-su-telefono-para-firmar","El firmante no recibe el SMS en su teléfono para firmar",{"slug":422,"title":423},"equipos","Gestión de equipos y usuarios",{"slug":425,"title":426},"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":428,"title":429},"firma-corporativa","Firma corporativa",{"slug":431,"title":432},"firma-en-tabletas-ios-y-android","Firma en Tabletas (iOS, Android y Wacom)",{"slug":434,"title":435},"firma-presencial","Firma Presencial",{"slug":437,"title":438},"firma-remota","Pantalla Inicial: Menú de Aplicaciones",{"slug":440,"title":441},"firma-remota-notificaciones","Firma Remota – notificaciones",{"slug":443,"title":444},"firmar-online-presentacion","Presentación firmar.online",{"slug":446,"title":447},"firmar-un-documento-ya-firmado","Firmar un documento ya firmado",{"slug":449,"title":450},"flujos","Flujos: Configuración predeterminada de envíos",{"slug":452,"title":453},"guia-de-productos-edatalia","Guía de Productos Edatalia",{"slug":455,"title":456},"guia-rapida-de-integracion-para-la-firma-presencial","Guía rápida de integración para la Firma Presencial",{"slug":458,"title":459},"iniciar-sesion-2","Registro y acceso a firmar.online",{"slug":461,"title":462},"la-firma-digital-manuscrita-requiere-instalacion-en-dispositivo","¿La firma digital manuscrita requiere instalación en dispositivo?",{"slug":464,"title":465},"manual-webforms","Manual para la generación de Formularios – WebForms",{"slug":467,"title":468},"metodos-de-autenticacion","Métodos de autenticación",{"slug":470,"title":471},"metodos-de-envio","Métodos de envío",{"slug":473,"title":474},"metodos-de-firma","Métodos de firma",{"slug":476,"title":477},"modificacion-de-un-documento-firmado","Modificación de un documento firmado",{"slug":479,"title":480},"perfil","Mi Perfil",{"slug":482,"title":483},"perfil-de-usuario","Herramientas: Firma digital, sellado de tiempo y validación de firmas",{"slug":485,"title":486},"plantilla-estandar-en-los-correos-de-firmar-online","Plantillas pre-formateadas en los correos de firmar.online",{"slug":488,"title":489},"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":491,"title":492},"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":494,"title":495},"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":497,"title":498},"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":500,"title":501},"que-es-el-token","¿Qué es el token?",{"slug":503,"title":504},"seguimiento-de-envios-en-firmar-online","Seguimiento de envíos en firmar.online",{"slug":506,"title":507},"servicios-avanzados-de-firma","Servicios avanzados de firma",{"slug":509,"title":510},"solicitud-de-documentacion-anexa-al-firmante","Solicitud de documentación anexa al firmante",{"slug":512,"title":513},"webhook-de-firma-digital","Webhook de firma digital",1780912530988]