> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Signatura electrònica: signa documents després del KYC

> Amb Didit, la persona verificada o els representants d'una empresa signen documents PDF i Word dins del flux de verificació, a nivell simple o avançat (AES).

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](#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.

Prompt d'integració de signatura electrònica
        Copia el prompt al porta-retalls



      
      

\<pre>

\`Goal:
Add Didit E-signature to a verification workflow: the verified person (KYC) or a company's representatives (KYB) sign PDF or Word documents inside the Didit flow, and your backend receives the signed PDFs and the evidence.

Delivery mode:
E-signature is a workflow step (feature SIGNATURE). There is no standalone signing API: the signer signs inside the hosted Didit flow, the Web SDK or a native SDK.

Prerequisites in the workflow (Advanced (AES) level only; the default Simple level needs no earlier step and no code):
\- KYC: an ID Verification step before the signature step (the signer's identity must be Approved), plus Email Verification (email codes, the default) or Phone Verification (SMS codes) so the code goes to a verified contact. If the workflow has Liveness, it must be Approved too.
\- KYB: a Key People step whose people complete their own KYC with the same prerequisites. signature_signer "legal_representative" picks the key people with the role representative or authorized_signatory; "key_people" picks every eligible key person (1 to 20 signers). For these KYB signers always set signature_level to "aes": "simple" is refused with signature_simple_requires_verified_person, so the workflow cannot be saved.

Steps:
1\. Add the E-signature step to the workflow in the Business Console (or POST /v3/workflows/ with {"feature": "SIGNATURE", "config": {...}}). Upload the documents in the console, or set signature_documents_source to "session" (or "both") to send them per session.
2\. Optional: place fields on each document: signature, initials, full_name, date_signed, text, checkbox, email and read-only data. Workflow documents get their fields in the console's template editor. Session documents carry them in sign.documents[].fields, placed by page and position or by anchor text. Every field has a key; a field with prefill "api.<key>" takes its value from sign.field_values.
3\. Create a session. For per-session documents, send sign.documents with base64 content:

curl -X POST 'https://verification.didit.me/v3/session/' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"workflow_id": "YOUR_WORKFLOW_ID",
"vendor_data": "user-1234",
"sign": {
  "documents": [
    \{
      "title": "Account agreement",
      "file_name": "agreement.pdf",
      "content_base64": "<base64 of the PDF>",
      "fields": [
        \{ "key": "signature", "type": "signature", "page": 3, "x": 0.09, "y": 0.62, "width": 0.36, "height": 0.085 },
        \{ "key": "credit_limit", "type": "data", "page": 1, "x": 0.34, "y": 0.31, "width": 0.3, "height": 0.03, "prefill": "api.credit_limit" }
      ]
    }
  ],
  "field_values": { "credit_limit": "3,000 EUR" }
}
}'

4\. Send the user to session.url (or open it with the Web or native SDK). Documents with fields need a native SDK release that supports fields; the hosted page and the Web SDK always do.
5\. Wait for the status.updated webhook, then GET /v3/session/{session_id}/decision/.

Decision surface:
signatures[] (one item per signer and signature step). Read:
\- status: the signing stage (intro, review, code, signing, signed, declined).
\- verdict: Not Finished | Approved | In Review | Declined.
\- level ("simple" or "aes"), format ("pdf" for simple, "pades" for aes), profile ("PAdES-B-LT" once an aes step is signed, otherwise null).
\- signer, identity_used, confirmation, certificate, timestamp, adopted_signature, electronic_signature_consent_at.
\- documents[]: mode ("fields" or "read_and_agree"), sha256_original, sha256_signed, status, signed_file (download path), source_format, conversion, fields[] (key, type, value, display_value, value_source, filled_at, image_url).
\- evidence_file (download path), warnings[] ({code, node_id}).

Downloads (x-api-key works):
\- GET /v3/session/{session_id}/signatures/{node_id}/documents/{document_id}/file/ -> signed PDF
\- GET /v3/session/{session_id}/signatures/{node_id}/evidence/?signature_id={id} -> evidence PDF
\- GET /v3/session/{session_id}/signatures/{node_id}/fields/{field_id}/image/ -> applied signature or initials (PNG); use the image_url of the field
\- POST /v3/session/{session_id}/signatures/{node_id}/validate/ -> re-checks the stored signatures

Warnings:
SIGNATURE_DECLINED (default REVIEW), SIGNATURE_OTP_FAILED, SIGNATURE_NAME_MISMATCH, SIGNATURE_IDENTITY_NOT_VERIFIED, SIGNATURE_DOCUMENT_CHANGED (default DECLINE). Each maps to a signature_*_action setting.

Rules:
\- Level: "simple" (default) or "aes". "qes" is an add-on that is not available yet and saving it returns 400 qes_not_available. While signature_availability.aes is false on the workflow, saving a new "aes" step returns 400 aes_not_available.
\- PDF: up to 20 MB and 100 pages each, no password, scripts or attachments. Up to 20 documents and 50 MB per signer.
\- Word: .docx only (.doc, .docm, .odt and .rtf are refused with unsupported_type), up to 20 MB, converted to PDF while the upload or create-session request runs. Fields refer to the converted pages. Macros, tracked changes, external links and embedded objects are refused with signature_document_not_supported; a file that can't be converted returns signature_document_conversion_failed. Both carry a reason.
\- Fields: key matches ^[a-z][a-z0-9_]{0,63}$ and is unique in its document; role defaults to the step's signer; up to 200 fields per document and 500 per signer. Every role with fields on a document needs a signature or initials field. There is no date picker type: use text.
\- Never show success until status is "signed". That is the check at every level. For an aes signature a null certificate, timestamp or signed_file also means "not signed"; a signed simple signature has a signed_file but a null certificate and timestamp.

See also:
\- /core-technology/electronic-signature/report-electronic-signature
\- /core-technology/electronic-signature/warnings-electronic-signature
\- /management-api/workflows/feature-configs#e-signature`

\</pre>



      
      

Enganxa a

## Nivells de signatura| Nivell | Requisits | En què consisteix |
| - | - | - |
| **Simple** | Per defecte. Sense verificació d'identitat, correu electrònic ni telèfon | La persona signa a l'enllaç de la sessió sense verificació d'identitat, correu electrònic, telèfon ni codi. Si la sessió ja té un nom verificat, s'utilitza aquest; en cas contrari, escriu el seu nom, i la signatura i l'informe indiquen que el nom s'ha escrit i no s'ha verificat. Qualsevol persona que tingui l'enllaç de la sessió pot signar, així que tria Simple per a acords de baix risc; els contractes regulats o d'alt valor haurien d'utilitzar Avançada (AES). El fitxer signat és un PDF amb una pàgina d'evidències i no porta cap signatura digital, segell ni marca de temps. Didit conserva l'SHA-256 del registre i de cada fitxer signat, de manera que qualsevol canvi posterior és detectable. |
| **Avançada (AES)**, signatura electrònica avançada | Una verificació d'identitat aprovada i un correu electrònic o telèfon verificat a la mateixa sessió | Cada document se signa en PAdES, el format de signatura PDF, amb un perfil de validació a llarg termini (`PAdES-B-LT`): la signatura inclou una marca de temps RFC 3161 emesa per Didit i les dades de revocació necessàries per validar-la posteriorment. Està vinculada de manera única al signant a través de la seva identitat verificada i del codi d'un sol ús que ha confirmat, i qualsevol canvi al document després de signar la invalida. |
| **Qualificada (QES)**, signatura electrònica qualificada | Complement, encara no disponible | Se signaria amb un certificat qualificat emès per al signant. La consola mostra l'opció com a **Properament**, i desar `signature_level: "qes"` mitjançant l'API retorna `400` amb `qes_not_available`. Mai no se substitueix silenciosament per AES. |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](#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çarEn 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:| `signature_signer` | Qui signa |
| - | - |
| `legal_representative` | Cada persona clau amb el rol `representative` o `authorized_signatory` |
| `key_people` | Cada persona clau individual amb una sessió de KYC |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:| Valor | Documents |
| - | - |
| `workflow` (per defecte) | Els documents que has pujat al flux de treball a la consola. Cada sessió signa els mateixos. |
| `session` | Els documents que envies a `sign.documents` quan [crees la sessió](https://docs.didit.me/ca/sessions-api/create-session.md#documents-de-signatura-electrònica). Cada sessió signa els seus propis. |
| `both` | Primer els documents del flux de treball i després els de la sessió. |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| | Límit |
| - | - |
| PDF | Fins a 20 MB i 100 pàgines cadascun. Sense contrasenya, scripts ni fitxers adjunts. |
| Word (`.docx`) | Fins a 20 MB. Es converteix a PDF quan el puges o crees la sessió, i el PDF convertit té els mateixos límits que un PDF. Els fitxers `.doc`, `.docm`, `.odt` i `.rtf` es rebutgen amb `unsupported_type`. |
| Per signant | Fins a 20 documents i 50 MB en total. |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:| `reason` | Què ha fallat |
| - | - |
| `docx_password_protected` | El fitxer té contrasenya. Elimina-la i torna a pujar-lo. |
| `docx_unreadable` | El fitxer no és un document Word llegible. |
| `docx_too_many_pages` | El PDF convertit té més de 100 pàgines. |
| `docx_too_large` | El fitxer és massa gran per convertir-lo. |
| `conversion_timeout` | La conversió ha trigat massa temps. Torna-ho a provar o puja el document com a PDF. |### Camps al documentEls 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.| Tipus | Què fa el signant | Valor |
| - | - | - |
| `signature` | Hi toca per aplicar la seva signatura adoptada. El primer camp de signatura o d'inicials obre el pas on l'adopta. | `true` un cop aplicada |
| `initials` | Hi toca per aplicar les seves inicials adoptades. | `true` un cop aplicades |
| `text` | Escriu un valor, comprovat contra la [validació](#validació) del camp. Es pot preemplenar. | String |
| `checkbox` | La marca o la desmarca. Una casella obligatòria s'ha de marcar. | Boolean |
| `email` | Res quan la sessió té un correu electrònic verificat, que l'emplena en mode de només lectura. En cas contrari, l'escriu. | String |
| `full_name` | Res: Didit emplena el nom verificat en mode de només lectura. | String |
| `date_signed` | Res: Didit emplena la data en què es van signar els documents. | String |
| `data` | Res: Didit emplena un valor de la identitat verificada, de la sessió o del teu sistema, en mode de només lectura. Indica a `prefill` d'on prové. | String |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:| Propietat | Regles |
| - | - |
| `id` | Establert per Didit. |
| `key` | Dona nom al camp en els resultats i a `sign.field_values`. Lletres minúscules, dígits i guions baixos, començant per una lletra, fins a 64 caràcters (`^[a-z][a-z0-9_]{0,63}$`), i únic dins del document. |
| `type` | Un dels tipus anteriors. |
| `role` | Qui l'emplena, amb els valors de `signature_signer`: `verified_person`, `legal_representative` o `key_people`. En un document de sessió, per defecte és el signant del pas. |
| `page` | De l'1 al nombre total de pàgines del document. Per a un document Word, una pàgina del PDF convertit. |
| `x`, `y`, `width`, `height` | Fraccions de la pàgina tal com es mostra (de `0` a `1`), mesurades des de la cantonada superior esquerra i arrodonides a 4 decimals. El camp ha de cabre dins de la pàgina. Fa com a mínim `0.02` d'amplada i `0.012` d'alçada, i una signatura, com a mínim, de `0.12` per `0.035`. |
| `required` | `signature` i `initials` són obligatoris tret que defineixis `false`. `full_name`, `date_signed` i `data` són sempre obligatoris. |
| `label` | D'1 a 80 caràcters, es mostra al signant i en els resultats. |
| `placeholder` | Només `text` i `email`. Fins a 80 caràcters. |
| `position` | L'ordre en què es guia el signant, a partir de `0`. Didit l'estableix segons la ubicació del camp: per pàgina, de dalt a baix i d'esquerra a dreta. |
| `validation` | Només `text`. Consulta [Validació](#validació). |
| `prefill` | D'on prové el valor. Consulta [Valors preemplenats](#valors-emplenats-prèviament). |
| `editable_when_prefilled` | Només `text` i `email`: el signant pot canviar un valor preemplenat. Per defecte `false`. |
| `checked_by_default` | Només `checkbox`: la casella comença marcada. |
| `date_format` | Només `date_signed`: `DD/MM/YYYY` (per defecte), `MM/DD/YYYY`, `YYYY-MM-DD` o `D MMMM YYYY`. |```json theme={null}
{
  "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
}
```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`:```json theme={null}
{ "kind": "any", "min_length": 0, "max_length": 80, "pattern": null, "message": null }
```- `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:| `prefill` | Valor |
| - | - |
| `identity.full_name`, `identity.first_name`, `identity.last_name` | El nom que figura al document d'identitat verificat del signant. |
| `identity.date_of_birth` | Del document d'identitat verificat, com a `DD/MM/YYYY`. |
| `identity.nationality`, `identity.document_number`, `identity.document_type`, `identity.issuing_country` | Del document d'identitat verificat. |
| `identity.address` | L'adreça amb format del document d'identitat verificat, o d'un comprovant de domicili a la mateixa sessió. |
| `contact.email`, `contact.phone` | El correu electrònic o telèfon verificat del signant. |
| `company.name`, `company.registration_number`, `company.address`, `company.country` | L'empresa verificada, per a KYB. |
| `session.vendor_data` | El `vendor_data` de la sessió. |
| `metadata.<key>` | El valor de `<key>` a les `metadata` de la sessió, com a cadena de text. |
| `api.<key>` | El valor de `<key>` a `sign.field_values`, enviat quan [crees la sessió](https://docs.didit.me/ca/sessions-api/create-session.md#valors-dels-camps). |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](https://docs.didit.me/ca/core-technology/electronic-signature/report-electronic-signature.md) n'indica el motiu.## Configura-ho a la consola1) 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](https://docs.didit.me/ca/core-technology/electronic-signature/warnings-electronic-signature.md) 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](https://docs.didit.me/ca/management-api/workflows/feature-configs.md#e-signature). 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 signaturaEl pas de signatura s'executa a la pàgina de verificació allotjada, al [Web SDK](https://docs.didit.me/ca/integration/web-sdks/overview.md) i als [SDK natius](https://docs.didit.me/ca/integration/native-sdks/overview.md), 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](#adoptar-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.> [!NOTE]
>
> Els SDK natius mostren el pas de signatura a partir de la versió que l'afegeix, indicada a la [visió general dels SDK natius](https://docs.didit.me/ca/integration/native-sdks/overview.md) 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 signaturaEl 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.## ResultatsEl resultat de cada signant és un element de `signatures[]` a la [decisió de la sessió](https://docs.didit.me/ca/sessions-api/retrieve-session.md) i al camp `decision` dels [webhooks de la sessió](https://docs.didit.me/ca/integration/webhooks.md). 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](https://docs.didit.me/ca/core-technology/electronic-signature/report-electronic-signature.md) 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](https://docs.didit.me/ca/sessions-api/generate-pdf.md) inclou una secció de signatura i una pàgina **Signatura electrònica · camps** quan els documents tenen camps.## PreusLa 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 signaturaQuan [elimines una sessió](https://docs.didit.me/ca/sessions-api/delete-session.md), 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- [Informe de signatura electrònica](https://docs.didit.me/ca/core-technology/electronic-signature/report-electronic-signature.md): `signatures[]`, el PDF signat, el PDF d'evidències i les descàrregues.
- [Advertències de signatura electrònica](https://docs.didit.me/ca/core-technology/electronic-signature/warnings-electronic-signature.md): totes les advertències i la regla que les controla.
- [Crear sessió](https://docs.didit.me/ca/sessions-api/create-session.md#documents-de-signatura-electrònica): envia documents, camps i valors de camp per sessió.
- [Configuracions de funcionalitats del flux de treball](https://docs.didit.me/ca/management-api/workflows/feature-configs.md#e-signature): totes les configuracions del pas.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.