API de firma electrónica: firma documentos tras el KYC

​

Niveles de firma

​

Cómo funciona

​

Antes de empezar

• Verificación de identidad, aprobada, con un nombre legible. Sin ella, el paso registra SIGNATURE_IDENTITY_NOT_VERIFIED.
• Verificación de correo electrónico cuando el código se envía por correo (el valor predeterminado), o Verificación de teléfono cuando se envía por SMS. El código solo se envía a un contacto verificado en la misma sesión.
• Si el flujo también tiene prueba de vida, debe estar aprobada.

​

Documentos

​

De dónde proceden los documentos

​

Archivos admitidos

​

Campos en el documento

{
  "id": "6a2f1c0e-4d8b-4f5e-9a51-0c7b2e9d3f10",
  "key": "occupation",
  "type": "text",
  "role": "verified_person",
  "page": 1,
  "x": 0.34,
  "y": 0.4618,
  "width": 0.57,
  "height": 0.0325,
  "required": true,
  "label": "Occupation",
  "placeholder": "For example, nurse",
  "position": 5,
  "validation": { "kind": "any", "min_length": 0, "max_length": 80, "pattern": null, "message": null },
  "prefill": null,
  "editable_when_prefilled": false,
  "checked_by_default": false,
  "date_format": null
}

​

Validación

{ "kind": "any", "min_length": 0, "max_length": 80, "pattern": null, "message": null }

• kind: any; letters (letras de cualquier alfabeto, espacios, guiones y apóstrofos); number (dígitos con un separador decimal opcional); email; o pattern.
• min_length: de 0 hasta max_length.
• max_length: de 1 a 500. Por defecto, 120.
• pattern: obligatorio con kind: "pattern". Una expresión regular de hasta 200 caracteres que debe coincidir con todo el valor. No se admiten lookarounds ni referencias inversas.
• message: hasta 120 caracteres, se muestra en lugar del error predeterminado.

​

Valores rellenados previamente

​

Configúralo en la consola

1. Ve a Flujos de trabajo, abre un flujo y añade el paso Firma electrónica después de los pasos que verifican al firmante.
2. En Documentos, selecciona Subir para añadir archivos PDF o Word, y arrástralos al orden en el que los ve el firmante. Los archivos de Word se convierten a PDF: revisa las páginas convertidas antes de colocar campos. Reemplazar cambia el archivo de un documento y conserva sus campos, excepto los de las páginas que el nuevo archivo ya no tiene.
3. En Coloca campos en los documentos, selecciona Abrir el editor. Arrastra un campo de la paleta a la página, o selecciónalo y haz clic donde va, y después muévelo y cambia su tamaño. Para cada campo, define Quién lo rellena, su etiqueta, si es Obligatorio, qué acepta, de dónde procede su valor y su Clave en la API (el key del campo). Vista previa como firmante muestra el documento tal como lo ve el firmante en un teléfono o en un escritorio. El editor guarda sobre la marcha (Guardado en el borrador) y enumera lo que debes corregir antes de seleccionar Listo.
4. Sin salir de Documentos, elige de dónde proceden los documentos: Este flujo de trabajo, Cada sesión o Ambas. Para documentos sin campos, elige si el firmante debe Leer hasta el final antes de firmar y define Un consentimiento por documento.
5. En Firma, elige el Firmante, el Nivel (Avanzada (AES)), el Formato y adónde se envía el código (Código de un solo uso por).
6. En Rules, define qué efecto tiene cada advertencia sobre el veredicto.
7. En Advanced, elige si quieres Enviar la copia firmada por correo electrónico y Añadir una página de evidencias, y cuántos días sigue siendo válido el enlace de firma. También puedes añadir reglas de estado personalizadas.
8. Guarda el flujo.

​

La experiencia de firma

1. Introducción. El firmante ve los documentos que va a firmar.
2. Cada documento, en orden. En un documento con campos, se guía al firmante por sus campos en el orden de position. El primer campo de firma o de iniciales abre una hoja donde adopta una firma. Los campos opcionales están marcados como Opcional. Los valores que Didit rellenó aparecen en la página con un candado y no son pasos. Al tocar un campo de la página, se salta a él. En un teléfono, se muestra un campo cada vez en un panel que permanece sobre el teclado. En una pantalla de al menos 1200 px de ancho, la página se sitúa junto a la lista de campos. Al terminar un documento con un campo obligatorio aún vacío, se muestra cuántos quedan y se salta al primero. Un documento sin campos se lee y se acepta, según lo configurado.
3. Revisión. El firmante ve de nuevo los documentos y, cuando alguno tiene campos, acepta firmarlos electrónicamente.
4. Código. El firmante solicita su código. Es válido durante 5 minutos, se puede enviar uno nuevo pasados 60 segundos, y un firmante dispone de hasta 5 códigos y 3 intentos erróneos. Agotarlos registra SIGNATURE_OTP_FAILED.
5. Firmado. Tras firmar, el firmante puede descargar sus documentos firmados. Si lo activaste, Didit también le envía una copia por correo electrónico.
6. Rechazo. El firmante puede rechazar en lugar de firmar. Esto registra SIGNATURE_DECLINED. Un rechazo se puede reabrir mientras el enlace de firma sea válido, de modo que el firmante aún puede firmar si cambia de opinión.

​

Adopción de una firma

• Escrita: su nombre verificado en un estilo de caligrafía que elige, marcado como From your ID. No puede escribir un nombre distinto. Las iniciales escritas son las primeras letras de ese nombre.
• Dibujada: dibujada con un dedo o con un ratón, tanto la firma como las iniciales.

​

Resultados

​

Precios

​

Eliminación de los datos de firma

• Los documentos firmados de una verificación de empresas pertenecen a la sesión de la empresa. Al eliminar esa sesión, se eliminan.
• Quitar un documento de un flujo lo elimina, con sus campos y su archivo original de Word. Un firmante que ya empezó a firmar conserva la copia que se le mostró, como parte de su sesión, hasta que elimines esa sesión. Quita documentos solo de flujos sin sesiones pendientes de firma.
• Una copia que Didit ya envió por correo electrónico al firmante está en su buzón y no se ve afectada.

​

Relacionado

• Informe de firma electrónica: signatures[], el PDF firmado, el PDF de evidencias y las descargas.
• Advertencias de firma electrónica: cada advertencia y la regla que la controla.
• Crear sesión: envía documentos, campos y valores de campo por sesión.
• Configuraciones de funciones del flujo: cada ajuste del paso.