{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"b08e9b1a-419a-4931-9bdc-23189538127b","name":"API FV WSFV v1.22 Clientes","description":"# **Bienvenido al API de FirmaVirtual**\n\nLos Servicios Web de Firma Virtual (WSFV) son un conjunto de servicios web que permiten a los clientes interactuar con FirmaVirtual para llevar a cabo diversas operaciones. Estas operaciones incluyen registrarse en el sistema, iniciar sesión, crear contratos, gestionar documentos, firmar contratos con Firma Electrónica Simple, así como pagar y administrar contratos. Nuestro WSFV está diseñado para clientes que deseen automatizar el proceso de firma de documentos, ya sea con protocolización o certificación notarial, dependiendo de los servicios ofrecidos por nuestra empresa.\n\nPodrás contar con los siguientes servicios:\n\n1. TSA (TimeStamp Authority)\n    \n2. Firma electrónica simple con o sin notaría y roles de usuario\n    \n3. Firma electrónica simple con o sin notaría sin roles de usuario (trámite express)\n    \n4. \\*Firma electrónica avanzada con o sin notaría\n    \n5. \\*Autorización notarial de firma (Beta)\n    \n6. \\*Notaria a domicilio (Beta)\n    \n7. Notaria documentos ya firmados\n    \n\nPara utilizar esta API, es necesario obtener un Token Bearer después de autenticarse previamente en nuestro sistema de registro. Para obtener más información, por favor contáctese con [info@firmavirtual.legal](https://null).\n\n\\*Se debe solicitar el servicio a nuestro departamento de ventas [karianny@firmavirtual.legal](https://null).\n\n## **Flujo de creación de trámites con o sin notaria y roles.**\n\nA continuación se describe el flujo completo del proceso para el registro de un usuario, creación del contrato, obtención de firma electrónica simple y certificación o protocolización de un documento (Firma electrónica simple con o sin notaría y roles de usuario).\n\n<img src=\"https://content.pstmn.io/e53e4593-8cdf-4488-b499-ee959b65d0a2/ZGlhZ3JhbWEgYXBpLnBuZw==\">\n\n1. Registro del usuario:\n    \n    - El usuario accede al sistema de registro de nuestra plataforma.\n        \n    - Proporciona la información requerida, como nombre, dirección de correo electrónico y contraseña.\n        \n    - El sistema verifica la validez de los datos proporcionados y registra al usuario en la plataforma.\n        \n    - El usuario recibe una confirmación de registro.\n        \n2. Creación del contrato:\n    \n    - El usuario inicia sesión en la plataforma utilizando sus credenciales.\n        \n    - Accede a la funcionalidad de creación de contratos.\n        \n    - Proporciona los detalles necesarios del contrato, como partes involucradas, términos y condiciones.\n        \n    - El sistema genera un contrato electrónico basado en la información proporcionada.\n        \n    - El contrato se guarda en la plataforma y se asigna un identificador único.\n        \n3. Obtención de firma electrónica simple:\n    \n    - El usuario selecciona el contrato que desea firmar electrónicamente.\n        \n    - El sistema genera un enlace de firma electrónica y lo envía al usuario por correo electrónico.\n        \n    - El usuario recibe la notificación por correo y accede al enlace de firma.\n        \n    - Desde su dispositivo (teléfono o PC), el usuario es guiado a través del proceso de firma electrónica.\n        \n    - El sistema registra la firma electrónica y la asocia al contrato correspondiente.\n        \n4. Certificación o protocolización del documento:\n    \n    - Una vez que el contrato ha sido firmado electrónicamente, el usuario puede optar por certificar o protocolizar el documento.\n        \n    - El usuario selecciona la opción correspondiente en la plataforma.\n        \n    - El sistema guía al usuario a través de los pasos necesarios para el proceso de certificación o protocolización.\n        \n    - Se pueden requerir datos adicionales, como información notarial o de certificación, según las necesidades legales.\n        \n    - El sistema genera el documento certificado o protocolizado y lo almacena en la plataforma.\n        \n    - El usuario recibe una confirmación por correo o callback de la certificación o protocolización exitosa.\n        \n    - El usuario tiene la posibilidad de enviar su documento ya firmado y nosotros notariarlo e informarle por api cuando este listo.\n        \n\nEste flujo de proceso completo permite a los usuarios registrarse, crear contratos, obtener firmas electrónicas simples y certificar o protocolizar documentos, todo ello de manera eficiente y segura dentro de nuestra plataforma.\n\n## **Consideraciones.**\n\n- Este servicio tiene un límite de solicitudes para el envío de correos electrónicos a los participantes. La notificación de entrega, revisión, pago y finalización de documentos se realiza exclusivamente a través de correo electrónico.\n    \n- El número máximo de participantes permitidos por contrato es de 10.\n    \n- Además, este servicio tiene un límite de solicitudes para la cantidad de archivos que se pueden unificar.\n    \n- En el modo de prueba (QA), el peso máximo permitido por archivo PDF a subir es de 50MB.\n    \n- La pasarela de pago integrada actualmente en nuestro sistema es el entorno de prueba de Webpay Plus, utilizando los datos de tarjeta de prueba proporcionados en la documentación de Transbank ([https://www.transbankdevelopers.cl/documentacion/como_empezar#ambiente-de-integracion](https://null)).\n    \n- Nuestra API en modo de prueba cuenta con una plataforma web ([https://qa.firmavirtual.com](https://null)) en dondes podrás realizar algunas tareas de firma electrónica con o sin notaria.\n    \n\n# Bloqueo y desbloqueo de Credenciales\n\nEn caso de realizar dos consultas consecutivas con credenciales incorrectas, FirmaVirtual implementa una medida de seguridad de bloqueo preventivo. Si tus credenciales quedan bloqueadas, deberás solicitar el desbloqueo enviando un correo a [info@firmavirtual.legal](https://null). En el correo, debes proporcionar una justificación exponiendo la razón del uso indebido del endpoint. Es importante explicar detalladamente las circunstancias y proporcionar la información necesaria para verificar tu identidad y validar la solicitud de desbloqueo. Una vez recibida tu solicitud, el equipo de FirmaVirtual revisará el caso y tomará las acciones necesarias para el desbloqueo de tus credenciales, siempre y cuando se cumplan las condiciones establecidas por el servicio.","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"49982086","team":11474448,"collectionId":"b08e9b1a-419a-4931-9bdc-23189538127b","publishedId":"2sB3WttJvB","public":true,"publicUrl":"https://documenter-api.postman.tech/view/49982086/2sB3WttJvB","privateUrl":"https://go.postman.co/documentation/49982086-b08e9b1a-419a-4931-9bdc-23189538127b","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"documentationLayout":"classic-double-column","customisation":{"metaTags":[{"name":"description","value":""},{"name":"title","value":""}],"appearance":{"default":"light","themes":[{"name":"dark","logo":"https://content.pstmn.io/ae192110-264b-49d4-8bb7-038be7830714/Ykc5bmIxOUdTVkpOUVY5V1NWSlVWVUZNWHpFeU1UQXVjRzVuLnBuZw==","colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"FF6C37"}},{"name":"light","logo":"https://content.pstmn.io/ae192110-264b-49d4-8bb7-038be7830714/Ykc5bmIxOUdTVkpOUVY5V1NWSlVWVUZNWHpFeU1UQXVjRzVuLnBuZw==","colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"}}]}},"version":"8.10.1","publishDate":"2025-12-10T15:16:30.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"","description":""},"logos":{"logoLight":"https://content.pstmn.io/ae192110-264b-49d4-8bb7-038be7830714/Ykc5bmIxOUdTVkpOUVY5V1NWSlVWVUZNWHpFeU1UQXVjRzVuLnBuZw==","logoDark":"https://content.pstmn.io/ae192110-264b-49d4-8bb7-038be7830714/Ykc5bmIxOUdTVkpOUVY5V1NWSlVWVUZNWHpFeU1UQXVjRzVuLnBuZw=="}},"statusCode":200},"environments":[],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/20189562d4d9cf848f8bf742b0cde0f018b4843606bac0ed16e2ef65d52689fe","favicon":""},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"}],"canonicalUrl":"https://documenter.gw.postman.com/view/metadata/2sB3WttJvB"}