{
  "$schema": "https://govschema.org/spec/v0.3/govschema.schema.json",
  "govschemaVersion": "0.3.0",
  "id": "es/dgp/tarjeta-identidad-extranjero",
  "version": "1.0.0",
  "title": "Spain Foreigner Identity Card Application (TIE, EX-17)",
  "description": "The Dirección General de la Policía (DGP, Spain's national police directorate, part of the Ministerio del Interior)'s EX-17 form, 'Solicitud de Tarjeta de Identidad de Extranjero (TIE)' — the application a foreign national authorized to reside in Spain files, in person, to obtain the physical Tarjeta de Identidad de Extranjero: the credential that documents a foreigner's legal residence status. The single form covers three request types (initial card issuance, renewal, and duplicate for theft/loss/destruction/unusability), selected via the form's own art. 210-referenced checkbox group. Models the applicant's own identification, filiation, and domicile data; an optional distinct-submitter block for when someone other than the applicant physically presents the request (a representative or, for a minor/incapacitated applicant, a legal guardian); an optional notification-address block, including the applicant's opt-in consent to receive notifications via Spain's Dirección Electrónica Habilitada Única (Dehú) electronic notification system; the filing office the request is addressed to; the requested document-type selection; and the closing place/date/signature. Also models the Tasa 790 Código 012 fee-payment proof the DGP's own live procedure page names as a required accompanying document (the fee amount itself is not modelled — see VERIFICATION.md). The form is a fillable AcroForm PDF (70 named widget annotations, including checkboxes matching this schema's three documentRequestType options), also fully self-documenting via its own page-3 numbered instructions key. Deliberately does not model: the form's own printed 'Nombre y apellidos del titular' running-header caption on page 2 (a repeat of the applicant's own name already captured in Section 1, not a distinct field); any online/telematic submission channel (the form's own header states in-person presentation before the competent Policía Nacional unit is the only accepted channel — telematic or public-registry submission is explicitly not admitted); and the fee amount itself (fee schedules change and were not confirmed from a primary government source this cycle — see VERIFICATION.md). This closes Spain's National ID & Civic Documents gap, its 4th of 6 verticals. GovSchema is independent and is not affiliated with, endorsed by, or operated by the Government of Spain or the Dirección General de la Policía.",
  "status": "draft",
  "jurisdiction": {
    "country": "ES",
    "level": "national"
  },
  "authority": {
    "name": "Dirección General de la Policía",
    "abbreviation": "DGP",
    "url": "https://sede.policia.gob.es/portalCiudadano/_es/tramites_extranjeria_tramite_tarjeta_residencia_residenciaytrabajo.php"
  },
  "process": {
    "type": "request",
    "language": "es-ES"
  },
  "source": {
    "url": "https://www.inclusion.gob.es/documents/410169/2156469/17-Formulario_TIE.pdf",
    "retrievedAt": "2026-07-08",
    "documentRef": "EX-17 (edición '03'), Solicitud de Tarjeta de Identidad de Extranjero (TIE) — Ministerio de Inclusión, Seguridad Social y Migraciones' downloadable PDF, a fillable AcroForm (70 named widget annotations across pages 1-2, including checkboxes matching this schema's documentRequestType/sex/civilStatus enums), also fully self-documenting via its own page-3 numbered instructions key. The live inclusion.gob.es domain is WAF-blocked to direct fetch from this environment; retrieved via a Wayback Machine snapshot returning the real PDF (HTTP 200, %PDF-1.7) — see verification.notes."
  },
  "verification": {
    "method": "manual-source-review-v1",
    "lastVerifiedAt": "2026-07-08",
    "verifiedBy": "GovSchema Engineering (Standards Engineer)",
    "nextReviewBy": "2027-01-08",
    "notes": "GOV-1735: GovSchema Standard Research cycle, following up on CATALOG.md's own flagged lead (the EX-15 foreigner-identity-number form) for Spain's open National ID & Civic Documents gap. EX-17 (TIE, Tarjeta de Identidad de Extranjero) was judged the closer fit: EX-15 only assigns a tax/ID number (NIE), while EX-17 is the application for the physical foreign-resident ID card itself, a closer parallel to already-published national-ID schemas like ae/icp/emirates-id-replacement and kr/mois/resident-registration-card-reissuance. inclusion.gob.es (the form's hosting domain) is WAF-blocked to direct fetch from this environment (returns an HTML firewall block page, not the PDF); retrieved instead via a Wayback Machine snapshot (http://web.archive.org/web/20260414195507if_/https://www.inclusion.gob.es/documents/410169/2156469/17-Formulario_TIE.pdf), confirmed HTTP 200 with real %PDF-1.7 bytes. The PDF's AcroForm/widget-annotation layer was inspected via pdfjs-dist and found to be a fillable form (70 named widgets across pages 1-2, including checkboxes matching the documentRequestType/sex/civilStatus enums modelled here) — not the static print/hand-fill template earlier believed. The form's own text layer (also extracted via pdfjs-dist, 3 pages) is fully self-documenting: page 3 is a numbered instructions key explaining every checkbox/footnote marker. Corroborated with a second, live source fetched directly with no WAF issue: the Policía Nacional's own official procedure page (sede.policia.gob.es, 'Tarjeta inicial o renovación residencia o residencia y trabajo', procedure code 994694), which confirms the purpose ('Documento destinado a identificar al extranjero a los efectos de acreditar su situación legal en España'), the in-person-only filing channel at any Oficina de Extranjería or Comisaría de Policía, the required Tasa 790 Código 012 fee-payment-proof document, and the issuing/competent authority (Dirección General de la Policía). IMPORTANT DISCLOSED DISCREPANCY: the live procedure page cites Real Decreto 1155/2024, de 19 de noviembre (which replaced RD 557/2011's implementing regulation) alongside LO 4/2000 as the current governing rules, but the PDF form itself still prints the older '(LO 4/2000 y RD 557/2011)' citation in its own header — the form has apparently not been reprinted since the 2024 regulation renumbering. This document's title/description cite the form's own printed legal basis verbatim (matching the source PDF), but flags RD 1155/2024 as the current governing implementing regulation per the live procedure page; the form's substantive field set is not affected by the renumbering. A publicly reported fee figure (~EUR 16.08 for the initial TIE as of 2026) was found via non-government secondary sources and is deliberately NOT modelled as an authoritative field value (fees change and this figure was not confirmed from a primary government source this cycle); only the fee-payment-proof document requirement itself (Tasa 790 Código 012) is modelled, per the live procedure page's own explicit documentation requirement. See VERIFICATION.md for the full field inventory, both sources, and every other disclosed judgment call (the sex-marker 'X' footnote's own country-of-origin-recognition nuance; the representative/notification-address blocks' conditional applicability; the in-person-only filing constraint)."
  },
  "maturity": {
    "level": "structural-reference",
    "criteria": {
      "structuralReference": true,
      "verifiedSchema": false,
      "agentReadySchema": false,
      "executionTestedSchema": false
    },
    "method": "maturity-self-assessment-v1",
    "assertedBy": "GovSchema Engineering (Standards Engineer)",
    "assertedAt": "2026-07-08"
  },
  "license": "CC-BY-4.0",
  "fields": [
    {
      "name": "identifierType",
      "label": "PASAPORTE / N.I.E.",
      "type": "enum",
      "required": true,
      "description": "Which of the two identifier types the applicant is providing in `identifierNumber`: their passport number, or an already-assigned Número de Identidad de Extranjero (NIE). The form prints a checkbox choosing which applies.",
      "sourceRef": "EX-17 p.1, §1 DATOS DEL EXTRANJERO/A",
      "validation": {
        "enum": ["passport", "nie"]
      }
    },
    {
      "name": "identifierNumber",
      "label": "Nº Pasaporte / N.I.E.",
      "type": "string",
      "required": true,
      "classification": "sensitive-pii",
      "description": "The passport number or NIE identified by `identifierType`.",
      "sourceRef": "EX-17 p.1, §1 DATOS DEL EXTRANJERO/A"
    },
    {
      "name": "firstSurname",
      "label": "1er Apellido",
      "type": "string",
      "required": true,
      "classification": "pii",
      "description": "The applicant's first (paternal) surname.",
      "sourceRef": "EX-17 p.1, §1 DATOS DEL EXTRANJERO/A"
    },
    {
      "name": "secondSurname",
      "label": "2º Apellido",
      "type": "string",
      "required": false,
      "classification": "pii",
      "description": "The applicant's second (maternal) surname, when one applies. Not every naming convention carries a second surname, and the form marks no asterisk making it mandatory.",
      "sourceRef": "EX-17 p.1, §1 DATOS DEL EXTRANJERO/A"
    },
    {
      "name": "givenName",
      "label": "Nombre",
      "type": "string",
      "required": true,
      "classification": "pii",
      "description": "The applicant's given name(s).",
      "sourceRef": "EX-17 p.1, §1 DATOS DEL EXTRANJERO/A"
    },
    {
      "name": "sex",
      "label": "Sexo",
      "type": "enum",
      "required": true,
      "classification": "pii",
      "description": "The applicant's sex, as printed on the form: H (Hombre/male), M (Mujer/female), or X (Indefinido/unspecified). Per the form's own footnote (1), the X/unspecified box may only be checked by a person who has this marker officially recognized in their own country of origin — it is not a free general-purpose 'prefer not to say' option.",
      "sourceRef": "EX-17 p.1, §1 DATOS DEL EXTRANJERO/A; p.3 footnote (1)",
      "validation": {
        "enum": ["male", "female", "unspecified"]
      }
    },
    {
      "name": "dateOfBirth",
      "label": "Fecha de nacimiento",
      "type": "date",
      "required": true,
      "classification": "sensitive-pii",
      "description": "The applicant's date of birth. The form itself splits this into separate day/month/year boxes (footnote (2) instructs dd/mm/aaaa order); modelled here as one ISO 8601 date, consistent with this registry's convention elsewhere.",
      "sourceRef": "EX-17 p.1, §1 DATOS DEL EXTRANJERO/A; p.3 footnote (2)"
    },
    {
      "name": "placeOfBirth",
      "label": "Lugar",
      "type": "string",
      "required": true,
      "classification": "pii",
      "description": "The applicant's place of birth.",
      "sourceRef": "EX-17 p.1, §1 DATOS DEL EXTRANJERO/A"
    },
    {
      "name": "countryOfBirth",
      "label": "País",
      "type": "string",
      "required": true,
      "classification": "pii",
      "description": "The applicant's country of birth.",
      "sourceRef": "EX-17 p.1, §1 DATOS DEL EXTRANJERO/A"
    },
    {
      "name": "nationality",
      "label": "Nacionalidad",
      "type": "string",
      "required": true,
      "classification": "pii",
      "description": "The applicant's current nationality.",
      "sourceRef": "EX-17 p.1, §1 DATOS DEL EXTRANJERO/A"
    },
    {
      "name": "civilStatus",
      "label": "Estado civil",
      "type": "enum",
      "required": true,
      "description": "The applicant's civil status, per the form's own five-way checkbox: S (Soltero/a, single), C (Casado/a, married), V (Viudo/a, widowed), D (Divorciado/a, divorced), or Sep (Separado/a, separated).",
      "sourceRef": "EX-17 p.1, §1 DATOS DEL EXTRANJERO/A; p.3 footnote (3)",
      "validation": {
        "enum": ["single", "married", "widowed", "divorced", "separated"]
      }
    },
    {
      "name": "fatherName",
      "label": "Nombre del padre",
      "type": "string",
      "required": true,
      "classification": "pii",
      "description": "Full name of the applicant's father.",
      "sourceRef": "EX-17 p.1, §1 DATOS DEL EXTRANJERO/A"
    },
    {
      "name": "motherName",
      "label": "Nombre de la madre",
      "type": "string",
      "required": true,
      "classification": "pii",
      "description": "Full name of the applicant's mother.",
      "sourceRef": "EX-17 p.1, §1 DATOS DEL EXTRANJERO/A"
    },
    {
      "name": "residentialAddress",
      "label": "Domicilio en España",
      "type": "string",
      "required": true,
      "classification": "pii",
      "description": "The applicant's residential address (street) in Spain.",
      "sourceRef": "EX-17 p.1, §1 DATOS DEL EXTRANJERO/A"
    },
    {
      "name": "residentialAddressNumber",
      "label": "Nº",
      "type": "string",
      "required": false,
      "classification": "pii",
      "description": "Street number of the applicant's residential address.",
      "sourceRef": "EX-17 p.1, §1 DATOS DEL EXTRANJERO/A"
    },
    {
      "name": "residentialAddressFloor",
      "label": "Piso",
      "type": "string",
      "required": false,
      "classification": "pii",
      "description": "Floor/unit of the applicant's residential address.",
      "sourceRef": "EX-17 p.1, §1 DATOS DEL EXTRANJERO/A"
    },
    {
      "name": "residentialLocality",
      "label": "Localidad",
      "type": "string",
      "required": true,
      "classification": "pii",
      "description": "Town/city of the applicant's residential address.",
      "sourceRef": "EX-17 p.1, §1 DATOS DEL EXTRANJERO/A"
    },
    {
      "name": "residentialPostalCode",
      "label": "C.P.",
      "type": "string",
      "required": true,
      "classification": "pii",
      "description": "Postal code of the applicant's residential address.",
      "sourceRef": "EX-17 p.1, §1 DATOS DEL EXTRANJERO/A"
    },
    {
      "name": "residentialProvince",
      "label": "Provincia",
      "type": "string",
      "required": true,
      "classification": "pii",
      "description": "Province of the applicant's residential address.",
      "sourceRef": "EX-17 p.1, §1 DATOS DEL EXTRANJERO/A"
    },
    {
      "name": "applicantMobilePhone",
      "label": "Teléfono móvil",
      "type": "string",
      "required": false,
      "classification": "pii",
      "description": "The applicant's mobile phone number. Not marked mandatory on the form.",
      "sourceRef": "EX-17 p.1, §1 DATOS DEL EXTRANJERO/A"
    },
    {
      "name": "applicantEmail",
      "label": "E-mail",
      "type": "string",
      "required": false,
      "classification": "pii",
      "description": "The applicant's e-mail address. Not marked mandatory on the form.",
      "sourceRef": "EX-17 p.1, §1 DATOS DEL EXTRANJERO/A",
      "validation": {
        "pattern": "^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$"
      }
    },
    {
      "name": "applicantLegalRepresentativeId",
      "label": "Representante legal, en su caso: DNI/NIE/PAS",
      "type": "string",
      "required": false,
      "classification": "sensitive-pii",
      "description": "DNI/NIE/passport number of the applicant's own legal representative, filled in only when applicable (e.g. a parent/guardian representing a minor or an incapacitated applicant) — the form's own heading reads 'en su caso' ('if applicable').",
      "sourceRef": "EX-17 p.1, §1 DATOS DEL EXTRANJERO/A"
    },
    {
      "name": "applicantLegalRepresentativeTitle",
      "label": "Título",
      "type": "string",
      "required": false,
      "description": "The basis on which the person named in `applicantLegalRepresentativeId` represents the applicant, e.g. 'Padre/Madre del menor' or 'Tutor' (guardian), per the form's own footnote (4) examples.",
      "sourceRef": "EX-17 p.1, §1 DATOS DEL EXTRANJERO/A; p.3 footnote (4)"
    },
    {
      "name": "submitterName",
      "label": "Nombre/Razón Social",
      "type": "string",
      "required": false,
      "classification": "pii",
      "description": "Full name or business name of the person or entity physically presenting this request, when that person is not the applicant. The form's own section heading states this section 2 is filled in 'sólo en el caso de ser persona distinta del solicitante' (only when the submitter is a person distinct from the applicant), per footnote (5).",
      "sourceRef": "EX-17 p.1, §2 DATOS DEL REPRESENTANTE A EFECTOS DE PRESENTACIÓN DE LA SOLICITUD; p.3 footnote (5)"
    },
    {
      "name": "submitterId",
      "label": "DNI/NIE/PAS",
      "type": "string",
      "required": false,
      "classification": "sensitive-pii",
      "description": "DNI/NIE/passport number of the submitter named in `submitterName`.",
      "sourceRef": "EX-17 p.1, §2 DATOS DEL REPRESENTANTE A EFECTOS DE PRESENTACIÓN DE LA SOLICITUD"
    },
    {
      "name": "submitterAddress",
      "label": "Domicilio en España",
      "type": "string",
      "required": false,
      "classification": "pii",
      "description": "Residential/business address in Spain of the submitter named in `submitterName`.",
      "sourceRef": "EX-17 p.1, §2 DATOS DEL REPRESENTANTE A EFECTOS DE PRESENTACIÓN DE LA SOLICITUD"
    },
    {
      "name": "submitterAddressNumber",
      "label": "Nº",
      "type": "string",
      "required": false,
      "classification": "pii",
      "description": "Street number of the submitter's address.",
      "sourceRef": "EX-17 p.1, §2 DATOS DEL REPRESENTANTE A EFECTOS DE PRESENTACIÓN DE LA SOLICITUD"
    },
    {
      "name": "submitterAddressFloor",
      "label": "Piso",
      "type": "string",
      "required": false,
      "classification": "pii",
      "description": "Floor/unit of the submitter's address.",
      "sourceRef": "EX-17 p.1, §2 DATOS DEL REPRESENTANTE A EFECTOS DE PRESENTACIÓN DE LA SOLICITUD"
    },
    {
      "name": "submitterLocality",
      "label": "Localidad",
      "type": "string",
      "required": false,
      "classification": "pii",
      "description": "Town/city of the submitter's address.",
      "sourceRef": "EX-17 p.1, §2 DATOS DEL REPRESENTANTE A EFECTOS DE PRESENTACIÓN DE LA SOLICITUD"
    },
    {
      "name": "submitterPostalCode",
      "label": "C.P.",
      "type": "string",
      "required": false,
      "classification": "pii",
      "description": "Postal code of the submitter's address.",
      "sourceRef": "EX-17 p.1, §2 DATOS DEL REPRESENTANTE A EFECTOS DE PRESENTACIÓN DE LA SOLICITUD"
    },
    {
      "name": "submitterProvince",
      "label": "Provincia",
      "type": "string",
      "required": false,
      "classification": "pii",
      "description": "Province of the submitter's address.",
      "sourceRef": "EX-17 p.1, §2 DATOS DEL REPRESENTANTE A EFECTOS DE PRESENTACIÓN DE LA SOLICITUD"
    },
    {
      "name": "submitterMobilePhone",
      "label": "Teléfono móvil",
      "type": "string",
      "required": false,
      "classification": "pii",
      "description": "Mobile phone number of the submitter named in `submitterName`.",
      "sourceRef": "EX-17 p.1, §2 DATOS DEL REPRESENTANTE A EFECTOS DE PRESENTACIÓN DE LA SOLICITUD"
    },
    {
      "name": "submitterEmail",
      "label": "E-mail",
      "type": "string",
      "required": false,
      "classification": "pii",
      "description": "E-mail address of the submitter named in `submitterName`.",
      "sourceRef": "EX-17 p.1, §2 DATOS DEL REPRESENTANTE A EFECTOS DE PRESENTACIÓN DE LA SOLICITUD",
      "validation": {
        "pattern": "^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$"
      }
    },
    {
      "name": "submitterLegalRepresentativeId",
      "label": "Representante legal, en su caso: DNI/NIE/PAS",
      "type": "string",
      "required": false,
      "classification": "sensitive-pii",
      "description": "DNI/NIE/passport number of the submitter's own legal representative, filled in only when applicable (e.g. the submitter is a legal entity or an incapacitated person represented by a guardian).",
      "sourceRef": "EX-17 p.1, §2 DATOS DEL REPRESENTANTE A EFECTOS DE PRESENTACIÓN DE LA SOLICITUD"
    },
    {
      "name": "submitterLegalRepresentativeTitle",
      "label": "Título",
      "type": "string",
      "required": false,
      "description": "The basis on which the person named in `submitterLegalRepresentativeId` represents the submitter, per footnote (4)'s examples (e.g. 'Padre/Madre del menor', 'Tutor').",
      "sourceRef": "EX-17 p.1, §2 DATOS DEL REPRESENTANTE A EFECTOS DE PRESENTACIÓN DE LA SOLICITUD; p.3 footnote (4)"
    },
    {
      "name": "notificationRecipientName",
      "label": "Nombre/Razón Social",
      "type": "string",
      "required": false,
      "classification": "pii",
      "description": "Full name or business name of the person or entity notifications/communications about this request should be sent to, when different from the applicant's own domicile in Section 1. Unlike Section 2, the form carries no explicit 'only if different' footnote for this section, so this schema treats every field here as optional, following that section's own analogous conditional shape (see VERIFICATION.md).",
      "sourceRef": "EX-17 p.1, §3 DOMICILIO A EFECTOS DE NOTIFICACIONES"
    },
    {
      "name": "notificationRecipientId",
      "label": "DNI/NIE/PAS",
      "type": "string",
      "required": false,
      "classification": "sensitive-pii",
      "description": "DNI/NIE/passport number of the notification recipient named in `notificationRecipientName`.",
      "sourceRef": "EX-17 p.1, §3 DOMICILIO A EFECTOS DE NOTIFICACIONES"
    },
    {
      "name": "notificationAddress",
      "label": "Domicilio en España",
      "type": "string",
      "required": false,
      "classification": "pii",
      "description": "The address notifications about this request should be sent to.",
      "sourceRef": "EX-17 p.1, §3 DOMICILIO A EFECTOS DE NOTIFICACIONES"
    },
    {
      "name": "notificationAddressNumber",
      "label": "Nº",
      "type": "string",
      "required": false,
      "classification": "pii",
      "description": "Street number of the notification address.",
      "sourceRef": "EX-17 p.1, §3 DOMICILIO A EFECTOS DE NOTIFICACIONES"
    },
    {
      "name": "notificationAddressFloor",
      "label": "Piso",
      "type": "string",
      "required": false,
      "classification": "pii",
      "description": "Floor/unit of the notification address.",
      "sourceRef": "EX-17 p.1, §3 DOMICILIO A EFECTOS DE NOTIFICACIONES"
    },
    {
      "name": "notificationLocality",
      "label": "Localidad",
      "type": "string",
      "required": false,
      "classification": "pii",
      "description": "Town/city of the notification address.",
      "sourceRef": "EX-17 p.1, §3 DOMICILIO A EFECTOS DE NOTIFICACIONES"
    },
    {
      "name": "notificationPostalCode",
      "label": "C.P.",
      "type": "string",
      "required": false,
      "classification": "pii",
      "description": "Postal code of the notification address.",
      "sourceRef": "EX-17 p.1, §3 DOMICILIO A EFECTOS DE NOTIFICACIONES"
    },
    {
      "name": "notificationProvince",
      "label": "Provincia",
      "type": "string",
      "required": false,
      "classification": "pii",
      "description": "Province of the notification address.",
      "sourceRef": "EX-17 p.1, §3 DOMICILIO A EFECTOS DE NOTIFICACIONES"
    },
    {
      "name": "notificationMobilePhone",
      "label": "Teléfono móvil",
      "type": "string",
      "required": false,
      "classification": "pii",
      "description": "Mobile phone number for notification purposes.",
      "sourceRef": "EX-17 p.1, §3 DOMICILIO A EFECTOS DE NOTIFICACIONES"
    },
    {
      "name": "notificationEmail",
      "label": "E-mail",
      "type": "string",
      "required": false,
      "classification": "pii",
      "description": "E-mail address for notification purposes.",
      "sourceRef": "EX-17 p.1, §3 DOMICILIO A EFECTOS DE NOTIFICACIONES",
      "validation": {
        "pattern": "^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$"
      }
    },
    {
      "name": "electronicNotificationConsent",
      "label": "CONSIENTO que las comunicaciones y notificaciones se realicen mediante puesta a disposición en la Dirección electrónica habilitada Única (Dehú)",
      "type": "boolean",
      "required": false,
      "description": "Opt-in consent for the applicant to receive communications and notifications about this request via Spain's Dirección Electrónica Habilitada Única (Dehú) single electronic-notification address, which requires a valid electronic certificate or Cl@ve system. Per footnote (6), certain categories of persons are instead obligated to electronic notification under Additional Provision 4 of RD 557/2011 regardless of this checkbox; this schema models only the checkbox itself, not the obligated-subject determination.",
      "sourceRef": "EX-17 p.1, §3 DOMICILIO A EFECTOS DE NOTIFICACIONES; p.3 footnote (6)"
    },
    {
      "name": "filingOfficeName",
      "label": "DIRIGIDA A",
      "type": "string",
      "required": true,
      "description": "The name of the Oficina de Extranjería or Comisaría de Policía competent unit this request is addressed to.",
      "sourceRef": "EX-17 p.2, header row"
    },
    {
      "name": "filingOfficeDir3Code",
      "label": "Código DIR3",
      "type": "string",
      "required": false,
      "description": "The DIR3 directory code (Spain's common public-sector unit directory) identifying the specific administrative unit named in `filingOfficeName`. Left optional: it is not confirmed from this source whether this box is filled in by the applicant or pre-printed/completed by DGP staff, since the form gives no further instruction for it (see VERIFICATION.md).",
      "sourceRef": "EX-17 p.2, header row"
    },
    {
      "name": "filingOfficeProvince",
      "label": "PROVINCIA",
      "type": "string",
      "required": true,
      "description": "Province of the filing office named in `filingOfficeName`.",
      "sourceRef": "EX-17 p.2, header row"
    },
    {
      "name": "documentRequestType",
      "label": "4.1. TIPO DE DOCUMENTO (art. 210)",
      "type": "enum",
      "required": true,
      "description": "Which of the three request types this application is: issuance of a new/initial card, renewal of an existing card, or a duplicate because the existing card was stolen, lost, destroyed, or rendered unusable.",
      "sourceRef": "EX-17 p.2, §4.1 TIPO DE DOCUMENTO (art. 210)",
      "validation": {
        "enum": ["initial_card", "renewal", "duplicate_theft_loss_destruction_unusable"]
      }
    },
    {
      "name": "applicationPlace",
      "label": "……., a ….. de ……. de …….",
      "type": "string",
      "required": true,
      "description": "The place (town/city) where the application is signed, printed on the same line as the date ahead of the signature.",
      "sourceRef": "EX-17 p.2, closing signature line"
    },
    {
      "name": "applicationDate",
      "label": "……., a ….. de ……. de …….",
      "type": "date",
      "required": true,
      "description": "The date the application is signed. The form itself spells this out in day/month(-name)/year prose form; modelled here as one ISO 8601 date, consistent with this registry's convention elsewhere.",
      "sourceRef": "EX-17 p.2, closing signature line"
    }
  ],
  "documents": [
    {
      "id": "feePaymentProof",
      "label": "Justificante de pago Tasa modelo 790 Código 012",
      "category": "payment",
      "required": true,
      "methods": ["tasa-modelo-790-codigo-012"],
      "sourceRef": "Policía Nacional official procedure page (sede.policia.gob.es), 'Tarjeta inicial o renovación residencia o residencia y trabajo', required documentation list. The fee amount itself is not modelled here — see VERIFICATION.md."
    },
    {
      "id": "signatureAttestation",
      "label": "Firma del solicitante (o representante legal, en su caso)",
      "category": "attestation",
      "required": true,
      "sourceRef": "EX-17 p.2, closing signature line 'FIRMA DEL SOLICITANTE (o representante legal, en su caso)'"
    }
  ],
  "steps": [
    {
      "id": "applicant_data",
      "title": "Datos del extranjero/a",
      "fields": ["identifierType", "identifierNumber", "firstSurname", "secondSurname", "givenName", "sex", "dateOfBirth", "placeOfBirth", "countryOfBirth", "nationality", "civilStatus", "fatherName", "motherName", "residentialAddress", "residentialAddressNumber", "residentialAddressFloor", "residentialLocality", "residentialPostalCode", "residentialProvince", "applicantMobilePhone", "applicantEmail", "applicantLegalRepresentativeId", "applicantLegalRepresentativeTitle"],
      "next": "submitter_data"
    },
    {
      "id": "submitter_data",
      "title": "Datos del representante a efectos de presentación de la solicitud (si procede)",
      "fields": ["submitterName", "submitterId", "submitterAddress", "submitterAddressNumber", "submitterAddressFloor", "submitterLocality", "submitterPostalCode", "submitterProvince", "submitterMobilePhone", "submitterEmail", "submitterLegalRepresentativeId", "submitterLegalRepresentativeTitle"],
      "next": "notification_address"
    },
    {
      "id": "notification_address",
      "title": "Domicilio a efectos de notificaciones",
      "fields": ["notificationRecipientName", "notificationRecipientId", "notificationAddress", "notificationAddressNumber", "notificationAddressFloor", "notificationLocality", "notificationPostalCode", "notificationProvince", "notificationMobilePhone", "notificationEmail", "electronicNotificationConsent"],
      "next": "filing_office"
    },
    {
      "id": "filing_office",
      "title": "Oficina a la que se dirige la solicitud",
      "fields": ["filingOfficeName", "filingOfficeDir3Code", "filingOfficeProvince"],
      "next": "request_details"
    },
    {
      "id": "request_details",
      "title": "Datos relativos a la solicitud",
      "fields": ["documentRequestType"],
      "next": "signature"
    },
    {
      "id": "signature",
      "title": "Lugar, fecha y firma",
      "fields": ["applicationPlace", "applicationDate"]
    }
  ]
}