{"id":48245,"date":"2024-05-31T13:47:05","date_gmt":"2024-05-31T11:47:05","guid":{"rendered":"https:\/\/www.viafirma.com\/?post_type=ayuda&#038;p=48245"},"modified":"2024-12-12T11:00:14","modified_gmt":"2024-12-12T10:00:14","slug":"guia-rapida-de-integracion","status":"publish","type":"ayuda","link":"https:\/\/www.viafirma.com\/es\/documentacion\/guia-rapida-de-integracion\/","title":{"rendered":"Gu\u00eda r\u00e1pida de integraci\u00f3n"},"content":{"rendered":"<p>Esta gu\u00eda te ayudar\u00e1 a comenzar a trabajar con las API de Viafirma Documents r\u00e1pidamente, haciendo uso de los principales servicios con los que deber\u00edas poder agregar la utilidad de firma digital a tu negocio.<\/p>\n<p>Para realizar una integraci\u00f3n completa con Viafirma Documents desde un sistema externo como puede ser cualquier CRM, SAP, web o aplicaci\u00f3n de escritorio se ofrece una API REST que permite el uso de la mayor\u00eda de servicios y funcionalidades ofrecidas por el producto.<\/p>\n<p>Para comenzar aqu\u00ed tienes enlaces y ayuda a la documentaci\u00f3n publicada:<\/p>\n<ul>\n<li><a href=\"https:\/\/doc.viafirma.com\/documents\/api\/latest\/es\/\" target=\"_blank\" rel=\"noopener\"><span style=\"font-weight: 400;\">Gu\u00eda API para desarrolladores<\/span><\/a><\/li>\n<li><a href=\"https:\/\/www.viafirma.com\/es\/faqs\/configuracion-de-las-politicas\/\"><span style=\"font-weight: 400;\">Configuraci\u00f3n de las pol\u00edticas para integraciones v\u00eda API<\/span><\/a><\/li>\n<li><a href=\"https:\/\/www.viafirma.com\/es\/documentacion\/\"><span style=\"font-weight: 400;\">Documentaci\u00f3n de funcionalidades y ayuda.<\/span><\/a><\/li>\n<li><a href=\"https:\/\/www.viafirma.com\/es\/documents-videotutoriales\/\"><span style=\"font-weight: 400;\">Videotutoriales<\/span><\/a><\/li>\n<li><a href=\"https:\/\/www.viafirma.com\/es\/category\/versiones\/documents-changelog\/\"><span style=\"font-weight: 400;\">Hist\u00f3rico de versiones<\/span><\/a><\/li>\n<\/ul>\n<h2>Seguridad<\/h2>\n<p>Los servicios del API de Viafirma Documents requieren seguridad, pudiendo optar por mecanismos Basic Authorization y OAuth v2.<\/p>\n<h2>Creaci\u00f3n de una solicitud de firma<\/h2>\n<p>Para la creaci\u00f3n de una solicitud haremos uso del servicio que encontrar\u00e1s en el siguiente apartado de la documentaci\u00f3n:<br \/>\n<a href=\"https:\/\/doc.viafirma.com\/documents\/api\/latest\/es\/set_new.html\" target=\"_blank\" rel=\"noopener\">https:\/\/doc.viafirma.com\/documents\/api\/latest\/es\/set_new.html<\/a><\/p>\n<p>Los documentos que se env\u00edan a firmar se informan al crear la solicitud y existen diferentes posibilidades:<br \/>\n<a href=\"https:\/\/doc.viafirma.com\/documents\/api\/latest\/es\/document_origin.html\" target=\"_blank\" rel=\"noopener\">https:\/\/doc.viafirma.com\/documents\/api\/latest\/es\/document_origin.html<\/a><\/p>\n<p>Si el proceso de firma cuenta con un formulario o bien el documento hace uso de variables \/ acrofields y se quiere completar con datos de un sistema externo se puede indicar en el momento de hacer la solicitud:<br \/>\n<a href=\"https:\/\/doc.viafirma.com\/documents\/api\/latest\/es\/forms_from_api.html\" target=\"_blank\" rel=\"noopener\">https:\/\/doc.viafirma.com\/documents\/api\/latest\/es\/forms_from_api.html<\/a><\/p>\n<h2>Seguimiento de la solicitud<\/h2>\n<p>Para hacer un seguimiento de la solicitud tenemos dos mecanismos b\u00e1sicos que son complementarios:<\/p>\n<ul>\n<li>Recepci\u00f3n de un correo electr\u00f3nico una vez finalizada la solicitud indicando si se complet\u00f3, se rechaz\u00f3, expir\u00f3 o hubo alg\u00fan error, incluyendo el documento firmado y\/o fichero de auditor\u00eda<\/li>\n<li>Uso de una URL del sistema cliente para recibir feedback del estado de la solicitud (callbackURL). Al llamar al servicio de creaci\u00f3n de la solicitud si se indica una URL en el par\u00e1metro callbackURL se realizar\u00e1 una llamada POST a esa URL cada vez que finalice uno de los firmantes y cuando la solicitud llegue a un estado final. En este servicio que desarrolla el cliente es donde puede descargarse el documento firmado, guardar en su sistema informaci\u00f3n detallada (datos de un formulario, firmante, etc.) o el estado de la solicitud. Para mejorar la trazabilidad, el JSON dispone de un atributo externalCode que facilita la asociaci\u00f3n entre solicitudes de ambos sistemas. Tambi\u00e9n podr\u00e1s <a href=\"https:\/\/www.viafirma.com\/es\/documentacion\/como-consultar-estado-de-un-callbackurl-y-realizar-un-reenvio\/\">consultar el estado de un callbackURL e incluso realizar un reenv\u00edo<\/a> en caso de error.<\/li>\n<\/ul>\n<p>La informaci\u00f3n detallada se encuentra en la siguiente URL:<br \/>\n<a href=\"https:\/\/doc.viafirma.com\/documents\/api\/latest\/es\/response_set_callback.html\" target=\"_blank\" rel=\"noopener\">https:\/\/doc.viafirma.com\/documents\/api\/latest\/es\/response_set_callback.html<\/a><\/p>\n<h2>Almacenamiento del documento firmado<\/h2>\n<p>La \u00faltima parte despu\u00e9s de la creaci\u00f3n de solicitudes y su seguimiento es el almacenamiento del documento firmado.<\/p>\n<p>Viafirma Documents ofrece un complejo sistema para la persistencia de documentos firmados con posibilidad de alternar distintas configuraciones y procedimientos, as\u00ed como la integraci\u00f3n con repositorios de terceros para la transferencia de documentos firmados.<\/p>\n<p>Viafirma cuenta con pol\u00edticas de retenci\u00f3n del documento donde un administrador puede establecer el tiempo de permanencia en nuestros sistemas y podr\u00e1s optar por delegar el almacenamiento en nuestros sistemas y\/o custodiar los documentos en un entorno propio (externo a Viafirma).<\/p>\n<p>Para ello a trav\u00e9s del servicio Callback de respuesta autom\u00e1tica se recibir\u00e1 una llamada con el JSON de la solicitud donde se indica el estado de la misma. Cuando el proceso ha finalizado correctamente ser\u00e1 el momento de descargar los documentos que componen la solicitud de firma.<\/p>\n<p>En el siguiente enlace se describe el proceso de llamada a la API:<br \/>\n<a href=\"https:\/\/doc.viafirma.com\/documents\/api\/latest\/es\/download_signed_document.html\" target=\"_blank\" rel=\"noopener\">https:\/\/doc.viafirma.com\/documents\/api\/latest\/es\/download_signed_document.html<\/a><\/p>\n<p>Para integraciones m\u00e1s avanzadas Viafirma Documents dispone de sistemas de transferencias que consisten en transferir autom\u00e1ticamente los documentos una vez finalizada la solicitud al gestor documental del cliente. Disponemos de implementaciones a medida para algunos clientes y otras gen\u00e9ricas como transferencias por FTP o Sharepoint.<\/p>\n","protected":false},"template":"","meta":{"_acf_changed":false,"site-sidebar-layout":"default","site-content-layout":"","ast-site-content-layout":"default","site-content-style":"default","site-sidebar-style":"default","ast-global-header-display":"","ast-banner-title-visibility":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","ast-disable-related-posts":"","theme-transparent-header-meta":"default","adv-header-id-meta":"","stick-header-meta":"default","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","astra-migrate-meta-layouts":"set","ast-page-background-enabled":"default","ast-page-background-meta":{"desktop":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"ast-content-background-meta":{"desktop":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}}},"categories":[233],"class_list":["post-48245","ayuda","type-ayuda","status-publish","hentry","category-integracion"],"acf":[],"_links":{"self":[{"href":"https:\/\/www.viafirma.com\/es\/wp-json\/wp\/v2\/ayuda\/48245","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.viafirma.com\/es\/wp-json\/wp\/v2\/ayuda"}],"about":[{"href":"https:\/\/www.viafirma.com\/es\/wp-json\/wp\/v2\/types\/ayuda"}],"wp:attachment":[{"href":"https:\/\/www.viafirma.com\/es\/wp-json\/wp\/v2\/media?parent=48245"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.viafirma.com\/es\/wp-json\/wp\/v2\/categories?post=48245"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}