# README - Definición de Campos XML Marcas Comerciales

## Introducción

Este documento describe la estructura y definición de todos los campos contenidos en los archivos XML de marcas comerciales que siguen el estándar TM-XML ST66 versión 0.6. Cada archivo XML representa una transacción que puede contener información de una o múltiples marcas comerciales, incluyendo solicitudes nuevas, renovaciones, marcas con elementos gráficos, y diferentes tipos de representación legal.

## Estructura Jerárquica del XML

```
Transaction
├── TransactionHeader
│   └── SenderDetails
└── TradeMarkTransactionBody
    └── TransactionContentDetails
        ├── TransactionIdentifier
        ├── TransactionCode
        └── TransactionData
            └── TradeMarkDetails
                └── TradeMark (puede repetirse)
```

## Definición Detallada de Campos

### 1. NIVEL TRANSACCIÓN

#### `<Transaction>`
**Descripción:** Elemento raíz que contiene toda la información de la transacción.  

#### `<TransactionHeader>`
**Descripción:** Cabecera de la transacción con metadatos del envío.

#### `<RequestProducerDateTime>`
**Descripción:** Fecha y hora de generación del archivo XML.  
**Formato:** ISO 8601 (AAAA-MM-DDTHH:MM:SS.sss±ZZ:ZZ)  
**Ejemplo:** `2025-08-27T14:54:00.022-03:00`

#### `<TransactionIdentifier>`
**Descripción:** Identificador de la transacción o sistema origen.  
**Valor procesado:** "UY DNPI" 

#### `<TransactionCode>`
**Descripción:** Tipo de transacción.  
**Valores permitidos:** "Trade Mark List"

### 2. NIVEL MARCA COMERCIAL

#### `<TradeMark>`
**Descripción:** Contenedor principal de información de una marca comercial.

#### `<RegistrationOfficeCode>`
**Descripción:** Código de la oficina de registro según estándar WIPO ST3.  
**Ejemplo:** "UY" (Uruguay)

#### `<InternationalMarkIndicator>`
**Descripción:** Indica si es una marca internacional (Protocolo de Madrid).  
**Tipo:** Booleano  
**Valores:** `true` | `false`

#### `<ReceivingOfficeDate>`
**Descripción:** Fecha de recepción en la oficina de registro.  
**Formato:** AAAA-MM-DD  
**Ejemplo:** `2025-08-27`

#### `<ApplicationNumber>`
**Descripción:** Número único de la solicitud de marca.  
**Tipo:** Cadena numérica  
**Ejemplo:** `577901`

#### `<ApplicationDate>`
**Descripción:** Fecha de presentación de la solicitud.  
**Formato:** AAAA-MM-DD  
**Ejemplo:** `2025-08-14`

#### `<IPRKind>`
**Descripción:** Tipo de derecho de propiedad intelectual.  
**Valores ejemplos:**
- `Trade mark`
- `Trade mark renewal`
- `Slogan`

#### `<ApplicationLanguageCode>`
**Descripción:** Idioma de la solicitud según ISO 639.  
**Ejemplo:** "es" (español)

#### `<MarkCurrentStatusCode>`
**Descripción:** Estado actual de la marca.  
**Valores ejemplos:**
- `Application filed` → Solicitud presentada
- `Application published` → Solicitud publicada

#### `<KindMark>`
**Descripción:** Clasificación jurídica de la marca.  
**Valores posibles:**
- `Individual` → Individual/ordinaria
- `Collective` → Colectiva
- `Certificate` → De certificación
- `Guarantee` → De garantía

#### `<MarkFeature>`
**Descripción:** Características físicas/tipo de signo de la marca.  
**Valores ejemplos:**
- `Combined` 
- `Word`
- `Figurative` 
- `3-D` 

### 3. ESPECIFICACIÓN DE MARCA DENOMINATIVA

#### `<WordMarkSpecification>`
**Descripción:** Contiene el texto de marcas denominativas.

#### `<MarkVerbalElementText>`
**Descripción:** Texto literal de la marca denominativa. 

### 4. CLASIFICACIÓN DE PRODUCTOS Y SERVICIOS

#### `<GoodsServicesDetails>`
**Descripción:** Contenedor de la clasificación de productos y servicios.

#### `<ClassificationKindCode>`
**Descripción:** Sistema de clasificación utilizado.  
**Valor principal:** "Nice" (Clasificación Internacional de Niza)  

#### `<ClassDescriptionDetails>`
**Descripción:** Contenedor de las clases reivindicadas.

#### `<ClassDescription>`
**Descripción:** Información de cada clase individual.

#### `<ClassNumber>`
**Descripción:** Número de clase según Clasificación de Niza.  
**Rango:** 1-45  

#### `<GoodsServicesDescription>`
**Descripción:** Texto descriptivo de productos/servicios en la clase.  

### 5. INFORMACIÓN DEL SOLICITANTE

#### `<ApplicantDetails>`
**Descripción:** Contenedor de información del solicitante de la marca.

#### `<Applicant>`
**Descripción:** Datos individuales del solicitante.

#### `<ApplicantNationalityCode>`
**Descripción:** Código de nacionalidad según ISO 3166-1.  
**Ejemplos encontrados:** "FR" (Francia), "AR" (Argentina), "UY" (Uruguay), "PA" (Panamá)

#### `<ApplicantAddressBook>`
**Descripción:** Información de contacto del solicitante.

### 6. INFORMACIÓN DEL REPRESENTANTE

#### `<RepresentativeDetails>`
**Descripción:** Contenedor de información del representante legal.

#### `<Representative>`
**Descripción:** Datos del representante/agente.

#### `<RepresentativeKindCode>`
**Descripción:** Tipo de representante.  

#### `<RepresentativeNationalityCode>`
**Descripción:** Nacionalidad del representante.  
**Formato:** Código ISO 3166-1

### 8. ELEMENTOS GRÁFICOS DE LA MARCA

#### `<MarkImageDetails>`
**Descripción:** Contenedor de información sobre elementos gráficos de la marca (para marcas mixtas o figurativas).

#### `<MarkImage>`
**Descripción:** Detalles individuales de una imagen de marca.

#### `<MarkImageFilename>`
**Descripción:** Nombre del archivo de imagen asociado a la marca.  
**Formato:** Nombre de archivo con extensión

#### `<MarkImageColourIndicator>`
**Descripción:** Indica si la marca incluye colores específicos reivindicados.  
**Tipo:** Booleano  
**Valores:** `true` | `false` 

#### `<MarkImageColourClaimedText>`
**Descripción:** Descripción textual de los colores reivindicados en la marca.  

### 9. INFORMACIÓN DE REGISTROS Y RENOVACIONES

#### `<MarkRecordDetails>`
**Descripción:** Contenedor de información sobre registros administrativos (principalmente para renovaciones).

#### `<MarkRecord>`
**Descripción:** Registro individual asociado a la marca.

#### `<BasicRecord>`
**Descripción:** Información básica del registro administrativo.

#### `<BasicRecordKind>`
**Descripción:** Tipo de registro básico. 

### 10. REGISTROS PREVIOS (RENOVACIONES)

#### `<PreviousRegistrationDetails>`
**Descripción:** Contenedor de información sobre registros anteriores (usado en renovaciones).

#### `<PreviousRegistration>`
**Descripción:** Detalles del registro previo que se está renovando.

#### `<PreviousRegistrationNumber>`
**Descripción:** Número del registro anterior que se renueva.  
**Tipo:** Cadena numérica  

### 11. INFORMACIÓN DE CONTACTO

#### `<FormattedNameAddress>`
**Descripción:** Contenedor de nombre y dirección estructurados.

#### `<Name>`
**Descripción:** Información del nombre (persona física o jurídica). 

#### `<FreeFormatName>`
**Descripción:** Nombre en formato libre.

#### `<FreeFormatNameLine>`
**Descripción:** Línea de nombre sin formato estructurado.  
**Ejemplo:** "APRIL GROUP", "Carmela Bacot"

#### `<Address>`
**Descripción:** Información de dirección postal.

#### `<AddressCountryCode>`
**Descripción:** Código de país de la dirección.  
**Formato:** ISO 3166-1  
**Ejemplo:** "FR", "UY"

#### `<FreeFormatAddress>`
**Descripción:** Dirección en formato libre.

#### `<FreeFormatAddressLine>`
**Descripción:** Línea de dirección completa.  
**Nota:** Este campo se enmascara con X en el procesamiento por privacidad.  
**Ejemplo original:** "25 de Mayo 576, Montevideo, UY"  
**Ejemplo procesado:** "XX XX XXXX XXX, XXXXXXXXXX, XX"