Saltar al contingut principal
La signatura electrònica permet que una persona signi els teus documents dins del mateix flux. La persona passa per cada document, hi afegeix la seva signatura, les inicials i qualsevol dada que sol·licitis i, en el nivell Avançat (AES), ho confirma amb un codi d’un sol ús enviat al correu electrònic o telèfon que ha verificat anteriorment. Didit retorna cada document signat, a més d’un PDF d’evidències que registra qui ha signat i com. La signatura electrònica té tres nivells. Simple és el predeterminat i no requereix verificació d’identitat, correu electrònic ni telèfon. Avançada (AES) requereix una verificació d’identitat aprovada i un correu electrònic o telèfon verificat, i vincula la signatura a la identitat verificada. Qualificada (QES) és un complement que encara no està disponible. Consulta Nivells de signatura. Funciona per a la verificació d’usuaris (KYC), on signa la persona verificada, i per a la verificació d’empreses (KYB), on els representants legals o les persones clau de l’empresa signen en nom seu.

Nivells de signatura

El nivell Avançat (AES) signa només en PAdES. Els valors de signature_format xades i cades es rebutgen per a AES amb signature_format_not_supported. Comprova signature_availability al flux de treball abans de desar un pas AES: mentre aes sigui false, desar-ne un de nou retornarà 400 amb aes_not_available.

Com funciona

1

En el nivell Avançat (AES), el flux de treball verifica primer el signant

En el nivell Avançat (AES), el pas de signatura s’executa després dels passos que estableixen qui està signant: verificació d’identitat, i verificació de correu electrònic o de telèfon per al contacte al qual s’envia el codi. Consulta Abans de començar. El nivell Simple no requereix cap pas previ.
2

Didit prepara els documents

Quan el signant arriba al pas, Didit copia els documents i els seus camps a la sessió i registra l’SHA-256 de cada document. Els canvis posteriors al flux de treball no poden canviar el que veu aquest signant.
3

El signant revisa cada document

En un document amb camps, es guia el signant de camp a camp. Defineix la seva signatura una sola vegada i aquesta s’aplica a cada camp de signatura i d’inicials, i emplena els camps de text i marca les caselles de selecció. Els valors que Didit pren de la identitat verificada, de la sessió o del teu sistema ja apareixen a la pàgina. En un document sense camps, el llegeix i l’accepta.
4

En el nivell Avançat (AES), el signant confirma amb un codi

Quan algun document té camps, el signant primer accepta signar els documents electrònicament. En el nivell Avançat (AES), Didit envia un codi de sis dígits al correu electrònic o telèfon que ha verificat anteriorment a la sessió, i introduir-lo autoritza la signatura en tots els documents del pas. En el nivell Simple no hi ha cap codi: acceptar és el que autoritza la signatura.
5

Didit signa i segella

Didit emplena la data de signatura, estampa el valor de cada camp a cada PDF i hi afegeix la pàgina d’evidències. En el nivell Avançat (AES), a continuació aplica la signatura PAdES i la marca de temps, de manera que la signatura cobreix tot el contingut de la pàgina. En el nivell Simple, el fitxer és un PDF amb la pàgina d’evidències i sense cap signatura digital, segell ni marca de temps.
6

Reps els resultats

Els webhooks de decisió i de sessió inclouen signatures[] amb el signant, la confirmació, el certificat, la marca de temps, els valors resum de cada document i el valor de cada camp. Descarregues els PDF signats i el PDF d’evidències, i Didit pot enviar una còpia per correu electrònic al signant.

Abans de començar

En el nivell Avançat (AES), cal verificar el signant abans que pugui signar. Didit extreu el seu nom i les seves dades de contacte dels registres verificats de la mateixa sessió, mai del que tu o el signant escriviu. El nivell Simple no necessita res d’això: no té verificació d’identitat, correu electrònic, telèfon ni codi, i es rebutja per als signants de KYB. Per a la Verificació d’usuaris (KYC), afegeix aquests passos abans de la Signatura electrònica al flux de treball:
  • Verificació d’identitat, aprovada, amb un nom llegible. Sense això, el pas registra SIGNATURE_IDENTITY_NOT_VERIFIED.
  • Verificació de correu electrònic quan el codi s’envia per correu electrònic (l’opció per defecte), o Verificació de telèfon quan s’envia per SMS. El codi només s’envia a un contacte verificat en la mateixa sessió.
  • Si el flux de treball també inclou la Prova de vida, ha d’estar aprovada.
Per enviar per correu electrònic al signant una còpia dels documents signats, la sessió també necessita un correu electrònic verificat, fins i tot quan el codi s’enviï per SMS. Per a la Verificació d’empreses (KYB), els signants són les persones clau de l’empresa, cadascuna amb el seu propi KYC aprovat: Un pas de KYB té entre 1 i 20 signants, i cadascun necessita un KYC aprovat en el moment de signar. Cadascun signa la seva pròpia còpia dels documents i confirma amb un codi enviat al contacte verificat en la seva pròpia sessió de KYC. El nom declarat per a la persona clau ha de coincidir amb el seu nom verificat, sense distingir majúscules ni minúscules ni espais, o el pas registrarà SIGNATURE_NAME_MISMATCH. El pas finalitza un cop tots els signants hagin signat o rebutjat.

Documents

D’on provenen els documents

signature_documents_source defineix d’on obté els documents un pas: Els documents per sessió són la manera de fer que una persona signi un contracte amb el seu propi nom, import o termes ja emplenats pel teu sistema.

Fitxers compatibles

Quan puges un document Word, Didit el converteix a PDF durant la pujada, en un màxim de 60 segons. Les pàgines convertides són les que el signant veu i signa; per tant, revisa-les abans de col·locar els camps: els salts de línia poden variar lleugerament respecte a Word. El fitxer Word i el seu PDF pertanyen al mateix document i s’eliminen amb ell. El PDF d’evidències registra la conversió i el SHA-256 de tots dos fitxers. Didit rebutja un fitxer Word amb signature_document_not_supported i un reason quan allò que se signaria és ambigu: té macros (macros), canvis controlats no acceptats (tracked_changes), enllaços a contingut extern (external_links) o objectes incrustats (embedded_objects). Accepta o rebutja els canvis controlats abans de pujar-lo, de manera que el PDF mostri el text que has acordat. Un fitxer que no es pot convertir es rebutja amb signature_document_conversion_failed i un d’aquests motius:

Camps al document

Els camps converteixen un document en una plantilla que el signant emplena, tal com prepararies un sobre en una eina de signatura d’escriptori. Un document sense camps manté el flux més simple: el signant el llegeix i l’accepta. No hi ha cap selector de dates en aquesta versió. Utilitza un camp text per a una data que hagi d’introduir el signant. Un camp té aquestes propietats:
Un document admet fins a 200 camps, i un signant fins a 500 en el conjunt dels seus documents. Un pas només emplena i estampa els camps del seu propi signant. Un document només pot contenir camps per a diversos rols quan l’utilitzen diversos passos de signatura del flux de treball: cada pas emplena els camps del seu propi rol i deixa buits els altres a la seva còpia. Un camp per a un rol que cap pas de signatura del flux de treball utilitza es rebutja amb role_not_used. Cada rol que té camps en un document necessita com a mínim un camp signature o initials en aquest document, o la versió del flux de treball no es podrà publicar (signature_field_missing).

Validació

validation s’aplica als camps text:
  • kind: any; letters (lletres en qualsevol sistema d’escriptura, espais, guions i apòstrofs); number (dígits amb un separador decimal opcional); email; o pattern.
  • min_length: des de 0 fins a max_length.
  • max_length: des d’1 fins a 500. Per defecte 120.
  • pattern: obligatori amb kind: "pattern". Una expressió regular de fins a 200 caràcters amb la qual ha de coincidir el valor complet. Les afirmacions de context i les referències enrere no són compatibles.
  • message: fins a 120 caràcters, es mostra en lloc de l’error per defecte.
La previsualització de la consola, el flux de signatura i l’API apliquen les mateixes regles.

Valors emplenats prèviament

prefill indica l’origen del valor d’un camp: Un camp data ha de tenir un prefill. Un camp full_name sempre utilitza identity.full_name i un camp email utilitza contact.email, i un camp text també en pot tenir un. Els valors dels camps data, full_name i dels camps email verificats es fixen quan el signant comença a signar: els canvis posteriors a la sessió no els modifiquen. Un camp text o email emplenat prèviament és de només lectura tret que configuris editable_when_prefilled. Quan l’origen d’un camp obligatori no té cap valor en aquell moment, per exemple en una sessió sense adreça, el camp roman buit i el signant pot continuar signant. No es genera cap advertència, i value_unavailable_reason a l’informe n’indica el motiu.

Configura-ho a la consola

  1. Ves a Fluxos de treball, obre un flux de treball i afegeix el pas de Signatura electrònica després dels passos que verifiquen el signant.
  2. A Documents, selecciona Pujar per afegir fitxers PDF o Word, i arrossega’ls a l’ordre en què els ha de veure el signant. Els fitxers Word es converteixen a PDF: revisa les pàgines convertides abans de col·locar camps. Canviar substitueix el fitxer d’un document i en manté els camps, excepte els de pàgines que el fitxer nou ja no tingui.
  3. A Col·loca camps als documents, selecciona Obre l’editor. Arrossega un camp des de la paleta fins a la pàgina, o selecciona’l i fes clic on vagi, i després mou-lo i canvia’n la mida. Per a cada camp, defineix Qui l’emplena, la seva etiqueta, si és Obligatori, què accepta, d’on prové el seu valor i la seva Clau d’API (la key del camp). L’opció Previsualitza com a signant mostra el document tal com el veu el signant en un mòbil o en un ordinador. L’editor desa a mesura que avances (Desat a l’esborrany) i llista el que cal corregir abans de seleccionar Fet.
  4. Encara a Documents, tria d’on provenen els documents: Aquest flux de treball, Cada sessió o Totes dues. Per a documents sense camps, tria si el signant ha de Llegir fins al final abans de signar i donar Un consentiment per document.
  5. A Signatura, tria el Signant, el Nivell (Simple, per defecte, o Avançat (AES); Qualificat (QES) es mostra com a Properament), el Format i per on s’envia el codi (Codi d’un sol ús per).
  6. A Regles, defineix com afecta cada advertència al veredicte.
  7. A Avançat, tria si vols Enviar la còpia signada per correu electrònic i Afegir una pàgina d’evidències, i quants dies roman vàlid l’enllaç de signatura. També pots afegir regles d’estat personalitzades.
  8. Desa el flux de treball.
Per configurar el mateix pas mitjançant l’API, consulta Configuracions de funcionalitats del flux de treball. Els documents del flux de treball i els seus camps es gestionen a la consola; mitjançant l’API, envia documents i camps per sessió.

L’experiència de signatura

El pas de signatura s’executa a la pàgina de verificació allotjada, al Web SDK i als SDK natius, tant a ordinadors com a mòbils. No cal que creïs cap interfície de signatura.
  1. Introducció. El signant veu els documents que està a punt de signar.
  2. Cada document, per ordre. Per a un document amb camps, es guia el signant pels seus camps en l’ordre de position. El primer camp de signatura o d’inicials obre un panell emergent on adopta una signatura. Els camps opcionals es marquen com a Opcional. Els valors que ha emplenat Didit es mostren a la pàgina amb un cadenat i no són passos. Si es toca un camp de la pàgina, es salta cap a aquest. En un telèfon mòbil, els camps es mostren un a un en un panell que es manté per sobre del teclat. En una pantalla d’almenys 1200 px d’amplada, la pàgina se situa al costat de la llista de camps. En finalitzar un document si encara queda algun camp obligatori buit, es mostra quants en queden i es salta al primer. Un document sense camps es llegeix i s’accepta, tal com hagis configurat.
  3. Revisió. El signant torna a veure els documents i, si algun d’ells té camps, accepta signar-los electrònicament.
  4. Codi (només Avançat (AES)). El signant sol·licita el seu codi. És vàlid durant 5 minuts, se’n pot enviar un de nou al cap de 60 segons, i el signant rep fins a 5 codis i té 3 intents incorrectes. Si s’esgoten, es registra SIGNATURE_OTP_FAILED. En el nivell Simple no hi ha codi: el signant passa directament de la revisió a la signatura.
  5. Signat. Després de signar, el signant pot descarregar els seus documents signats. Si ho has activat, Didit també li envia una còpia per correu electrònic.
  6. Rebutjar. El signant pot rebutjar en lloc de signar. Això registra SIGNATURE_DECLINED. Un rebuig es pot reobrir mentre l’enllaç de signatura sigui vàlid, de manera que el signant encara pot signar si canvia d’opinió.
El flux informa el signant quan el seu codi ha caducat, un document ha canviat, la signatura ha fallat o l’enllaç de signatura ha caducat. L’enllaç de signatura continua sent vàlid durant signature_link_validity_days (d’1 a 30, per defecte 7), a comptar des de la creació de la sessió. La sessió roman oberta almenys durant aquest temps.
Els SDK natius mostren el pas de signatura a partir de la versió que l’afegeix, indicada a la visió general dels SDK natius un cop publicada. Els documents amb camps necessiten una versió compatible amb camps: una versió anterior no pot mostrar-los, i en el seu lloc el pas mostra un error. Els documents sense camps funcionen en totes les versions que inclouen el pas de signatura. Fins que la teva aplicació no utilitzi una versió compatible amb el que fa servir el teu flux de treball, redirigeix els usuaris a la pàgina allotjada o al Web SDK.

Adoptar una signatura

El signant adopta la seva signatura i les seves inicials una sola vegada, en una mateixa pantalla emergent, la primera vegada que un document sol·licita alguna de les dues:
  • Escrita: el seu nom verificat en un estil manuscrit que triï, marcat com a Del teu document d’identitat. No pot escriure un nom diferent. Les inicials escrites són les primeres lletres d’aquest nom.
  • Dibuixada: la signatura i les inicials es dibuixen amb el dit o el ratolí.
Qualsevol camp posterior de signatura o inicials s’aplica amb un sol toc, i prémer sobre un de ja aplicat el torna a retirar.

Resultats

El resultat de cada signant és un element de signatures[] a la decisió de la sessió i al camp decision dels webhooks de la sessió. No hi ha cap webhook separat per a la signatura: l’esdeveniment status.updated de la sessió t’indica quan has d’obtenir la decisió. Obtens el PDF signat de cada document, un PDF d’evidències per a cada signant i el SHA-256 de cada fitxer original i de cada fitxer signat, per poder demostrar posteriorment que res no ha canviat. Per als documents amb camps, també obtens el valor de cada camp, d’on prové i quan es va emplenar, a més de la signatura adoptada i el moment en què el signant va acceptar signar electrònicament. Consulta l’informe de signatura electrònica per conèixer cada camp, les descàrregues i com tornar a validar una signatura. A la consola, la pestanya Signatura de la sessió mostra els documents, seguits d’un bloc de Camps amb una previsualització de cada pàgina, la signatura i les inicials adoptades, així com el valor, l’hora i l’origen de cada camp. L’informe en PDF inclou una secció de signatura i una pàgina Signatura electrònica · camps quan els documents tenen camps.

Preus

La signatura electrònica costa $0.10 per sessió signada, inclosa en el teu crèdit gratuït, independentment del nombre de documents en un mateix procés de signatura i de si el nivell és Simple o Avançat (AES). Una signatura rebutjada, fallida o caducada no es cobra. La signatura qualificada (QES) és un complement que encara no està disponible i no té preu.

Eliminar dades de signatura

Quan elimines una sessió, les seves dades de signatura s’eliminen amb ella: els documents enviats amb la sessió i els seus fitxers de Word originals, les còpies preparades per a cada signant, els PDF signats, els PDF d’evidències, les imatges de la signatura i de les inicials adoptades, i el valor de cada camp. Els seus enllaços de descàrrega deixen de funcionar. El mateix passa quan una sessió s’elimina en finalitzar el teu període de conservació de dades. L’eliminació no es pot desfer, així que descarrega abans tot el que necessitis conservar.
  • Els documents signats d’una Verificació d’empreses (KYB) pertanyen a la sessió de l’empresa. Eliminar aquesta sessió els elimina.
  • Si elimines un document d’un flux de treball, s’elimina juntament amb els seus camps i el seu fitxer de Word original. Un signant que ja hagi començat a signar conserva la còpia que se li va mostrar, com a part de la seva sessió, fins que eliminis aquesta sessió. Elimina documents només de fluxos de treball que no tinguin sessions pendents de signar.
  • Una còpia que Didit ja hagi enviat per correu electrònic al signant es troba a la seva bústia d’entrada i no es veu afectada.

Relacionat

Darrera modificació el 7 de novembre del 2026