Ir al contenido

Campos

Campos de la categoría Producto general

Todos los campos de un pasaporte de producto general: qué es cada campo, cómo enviarlo y qué pide la publicación.

Esta página enumera cada campo que devuelve GET /categories/{category}/schema. Algunas filas añaden lo que el endpoint no devuelve, por ejemplo el formato que debe tener un valor de texto, los símbolos de cuidado que acepta un campo o las claves de las entradas de una lista. Esa información procede del propio código de la API. El endpoint también devuelve las condiciones y las notas que acompañan a cada referencia legal. Esta página no enumera las comprobaciones propias de cada categoría. Una de esas comprobaciones puede pedir un campo aunque la fila del campo no muestre ninguna línea de publicación, o muestre una excepción que se aplica a su producto. Una comprobación también puede rechazar un valor. POST …/validate ejecuta estas comprobaciones sobre su pasaporte y nombra cada problema que encuentra.

Las rutas, los métodos, los ámbitos, los nombres de campo, los códigos de error y los nombres de las reglas de validación se publican en inglés, porque el inglés es el idioma de la propia interfaz: es lo que quien llama escribe o compara. Lo mismo ocurre con cada ejemplo de código, cada carga JSON y la frase exacta que lleva una respuesta de error: /v1 no lee Accept-Language, y traducir lo que la API envía realmente sería describirla mal. Todo lo que se escribe sobre ello sigue el idioma de esta página.

Tipos

text
Una cadena de texto. "…" Algunos campos de texto también comprueban el formato. Su fila indica la comprobación.
multiselect
Una lista de cadenas de texto. ["EU"]
url
Una cadena de texto con una dirección web. "https://example.com/document.pdf"
number
Un número. 50
select
Una cadena de texto. "kg_co2e"
array
Una lista. Su fila indica qué contiene cada entrada. ["…"]

Identificación del producto

product_nameNombre del producto

Nombre comercial del producto

Aparece como título principal en el pasaporte público y en las búsquedas.

Tipo

text

Publicación

La publicación lo pide.

Nivel de acceso

public Público

gtinGTIN

¿Ya tiene un código de barras? El número debajo es su GTIN. Obligatorio para publicar.

El GTIN vincula el pasaporte digital con el código de barras físico de la etiqueta.

Tipo

text

Formato

format_gtin La publicación rechaza un valor con otro formato.

Publicación

La publicación lo pide.

También cuenta una talla o un color guardados con su propio código de barras.

Fuentes
  • GS1 / GTIN GS1 General Specifications voluntary
  • ESPR (Reg (EU) 2024/1781) Annex III(b), (c) anticipated

El estado es la clasificación propia del endpoint.

Nivel de acceso

public Público

serial_numberNúmero de serie

Número de serie a nivel de unidad para identificación individual

Tipo

text

Fuentes
  • GPSR (Reg (EU) 2023/988) Art. 9 in_force
Nivel de acceso

public Público

product_descriptionDescripción del producto

Descripción clara del producto y su uso previsto

Tipo

text

Publicación

La publicación lo pide.

Nivel de acceso

public Público

product_categoryCategoría de producto

Tipo de producto general (p. ej. Camiseta, Chaqueta, Ropa de cama). Opcional — ayuda a organizar sus pasaportes.

Tipo

text

Nivel de acceso

public Público

markets_sold_intoMercados de comercialización

Mercados en los que se pone en circulación este producto. Determina qué normativas específicas de cada mercado (p. ej., la ley AGEC de Francia) resultan aplicables. Seleccione Francia (FR) de forma expresa si vende en ese mercado.

Se utiliza únicamente para personalizar la orientación de cumplimiento — nunca se muestra en el pasaporte público.

Tipo

multiselect

Valores de la lista
Los 11 valores
  • EU Unión Europea / EEE (general)
  • FR Francia
  • DE Alemania
  • IT Italia
  • ES España
  • NL Países Bajos
  • BE Bélgica
  • PL Polonia
  • UK Reino Unido
  • US Estados Unidos
  • OTHER Otro / resto del mundo

La publicación puede rechazar un valor que no esté en la lista. POST …/validate indica cuál.

Nivel de acceso

restricted Restringido

Fabricante / Operador económico

manufacturer_nameNombre del fabricante

El nombre, el nombre comercial registrado o la marca registrada del fabricante.

Tipo

text

Publicación

La publicación lo pide.

Fuentes
  • GPSR (Reg (EU) 2023/988) Art. 9(6) in_force
Nivel de acceso

public Público

manufacturer_addressDirección del fabricante

La dirección postal del fabricante. Si un punto de contacto único tiene otra dirección postal, indíquela también.

Tipo

text

Publicación

La publicación lo pide.

Fuentes
  • GPSR (Reg (EU) 2023/988) Art. 9(6) in_force
Nivel de acceso

public Público

manufacturer_countryPaís del fabricante

Seleccione el país del fabricante.

Tipo

text

Formato

format_country_code La publicación rechaza un valor con otro formato.

Publicación

La publicación lo pide.

Fuentes
  • GPSR (Reg (EU) 2023/988) Art. 9(6) in_force
Nivel de acceso

public Público

manufacturer_emailCorreo electrónico del fabricante

La dirección de correo electrónico del fabricante.

Cuando es aplicable el Reglamento relativo a la seguridad general de los productos, este solicita a los fabricantes una dirección postal y una dirección de correo electrónico.

Tipo

text

Formato

format_email La publicación rechaza un valor con otro formato.

Fuentes
  • GPSR (Reg (EU) 2023/988) Art. 9(6) in_force_conditional

    Se aplican condiciones. El endpoint las devuelve en regulatory_basis[].applies_when.

Nivel de acceso

public Público

manufacturer_websiteSitio web del fabricante

El sitio web del fabricante.

Tipo

url

Nivel de acceso

public Público

eori_numberNúmero EORI

Número de registro e identificación de operadores económicos para aduanas de la UE

Tipo

text

Formato

format_eori La publicación rechaza un valor con otro formato.

Nivel de acceso

restricted Restringido

eu_responsible_personResponsable en la UE

Nombre y datos de contacto de la persona responsable en la UE — necesario para vender en la UE cuando el fabricante está establecido fuera de la UE, salvo que indique un importador de la UE en su lugar

Tipo

text

Fuentes
  • GPSR (Reg (EU) 2023/988) Art. 16(1) in_force
  • Market Surveillance Reg (EU) 2019/1020 Art. 4 in_force
  • ESPR (Reg (EU) 2024/1781) Annex III(k) anticipated
Nivel de acceso

public Público

eu_importerImportador de la UE

Cuando sea otra empresa, y no usted, quien introduzca el producto en el mercado de la UE, registre aquí a ese importador. Indique su nombre, su nombre comercial registrado o su marca registrada, su dirección postal y su dirección de correo electrónico.

El importador es un operador económico distinto del fabricante: la empresa establecida en la UE que introduce el producto en la Unión.

Tipo

text

Fuentes
  • GPSR (Reg (EU) 2023/988) Art. 11(3) in_force_conditional

    Se aplican condiciones. El endpoint las devuelve en regulatory_basis[].applies_when.

  • ESPR (Reg (EU) 2024/1781) Art. 29(3) anticipated
  • ESPR (Reg (EU) 2024/1781) Annex III(j) anticipated
Nivel de acceso

public Público

Datos medioambientales

carbon_footprint_valueHuella de carbono

Huella de carbono del producto. Seleccione la unidad de medida correspondiente en la lista.

Tipo

number

Unidad de medida

Se envía en carbon_footprint_unit.

carbon_footprint_unit: kg_co2e, kg_co2e_per_kg, kg_co2e_per_m2

Nivel de acceso

public Público

carbon_footprint_unitUnidad de medida de la huella de carbono

Unidad de medida del valor de huella de carbono.

Tipo

select

Valores de la lista
  • kg_co2e kg CO₂e (por unidad)
  • kg_co2e_per_kg kg CO₂e / kg (por peso)
  • kg_co2e_per_m2 kg CO₂e / m² (por superficie)

La publicación puede rechazar un valor que no esté en la lista. POST …/validate indica cuál.

Nivel de acceso

public Público

carbon_footprint_basisBase de cálculo de la huella de carbono

Método utilizado para calcular la huella de carbono.

Este campo registra el método de cálculo. Conserve pruebas que respalden la huella de carbono; seleccionar un método no acredita el resultado.

Tipo

select

Valores de la lista
  • iso_14067 ISO 14067 (huella de carbono del producto)
  • pef EU PEF / PEFCR
  • ghg_protocol GHG Protocol Product Standard
  • iso_14040_44 ISO 14040/44 LCA
  • supplier_data Datos del proveedor / EPD
  • estimate Estimación interna

La publicación puede rechazar un valor que no esté en la lista. POST …/validate indica cuál.

Fuentes
  • UCPD (Dir 2005/29/EC) Art. 12 in_force
Nivel de acceso

public Público

recyclable_content_percentageContenido reciclable (%)

Porcentaje del producto que es reciclable al final de su vida útil

Tipo

number

Límites

min: 0 max: 100

Nivel de acceso

public Público

recycled_content_percentageContenido reciclado (%)

Porcentaje del producto fabricado con materiales reciclados

Tipo

number

Límites

min: 0 max: 100

Fuentes
  • AGEC Décret 2022-748 recycled-material % FR in_force_conditional

    Se aplican condiciones. El endpoint las devuelve en regulatory_basis[].applies_when.

  • ESPR (Reg (EU) 2024/1781) Annex I(h) anticipated
Nivel de acceso

public Público

Cumplimiento normativo

substances_of_concernSustancias preocupantes

Lista de sustancias preocupantes presentes por encima de las concentraciones umbral, o «ninguna declarada»

Tipo

array item_type: string

Fuentes
  • REACH (Reg (EC) 1907/2006) Art. 33 in_force
  • SCIP / WFD (Dir 2008/98/EC) Art. 9(1)(i) in_force
  • AGEC Décret 2022-748 Code de l'environnement art. R. 541-228 IX FR in_force_conditional

    Se aplican condiciones. El endpoint las devuelve en regulatory_basis[].applies_when.

  • ESPR (Reg (EU) 2024/1781) Art. 7(5) anticipated
Nivel de acceso

public Público

conformity_declaration_urlURL de la declaración de conformidad

Enlace al documento de declaración de conformidad UE, o suba el PDF.

Tipo

url

Nivel de acceso

authority Solo autoridades

Un documento puede sustituirlo

conformity_declaration

El identificador del documento se envía en conformity_declaration_url__document_id.

compliance_standardsNormas de cumplimiento

Seleccione las normas que cumple su producto.

Tipo

multiselect

Valores de la lista
  • reach REACH (CE 1907/2006)
  • eu_ecolabel Etiqueta ecológica de la UE

La publicación puede rechazar un valor que no esté en la lista. POST …/validate indica cuál.

Nivel de acceso

public Público

Fin de vida útil

recycling_instructionsInstrucciones de reciclaje

Instrucciones para reciclar el producto al final de su vida útil

Tipo

text

Nivel de acceso

public Público

disposal_instructionsInstrucciones de eliminación

Instrucciones para la eliminación segura si el producto no puede reciclarse

Tipo

text

Nivel de acceso

public Público

Economía circular

mono_material_percentagePorcentaje de monomaterial

Porcentaje del producto fabricado con un único material reciclable (0-100). Los productos con más del 85% son significativamente más fáciles de reciclar.

Tipo

number

Límites

min: 0 max: 100

Nivel de acceso

public Público

recyclability_gradeGrado de reciclabilidad

Se conserva para los valores ya introducidos; ya no se pide.

Tipo

select

Valores de la lista
  • A A — Totalmente reciclable (monomaterial, sin contaminantes)
  • B B — Reciclable con separación (partes no reciclables desmontables)
  • C C — Parcialmente reciclable (mezcla de fibras, algunos componentes recuperables)
  • D D — Difícil de reciclar (mezclas complejas, recubrimientos)
  • E E — No reciclable (materiales inseparables o componentes contaminantes)

La publicación puede rechazar un valor que no esté en la lista. POST …/validate indica cuál.

Nivel de acceso

public Público

No se muestra en la página pública del pasaporte. self_declared_label

disassembly_instructions_urlInstrucciones de desensamblaje

URL con la guía para separar componentes no reciclables (cremalleras, botones, recubrimientos) para su reciclaje — o suba el archivo.

Tipo

url

Nivel de acceso

public Público

Un documento puede sustituirlo

document

El identificador del documento se envía en disassembly_instructions_url__document_id.

takeback_scheme_urlPrograma de recogida

URL con información del programa de recogida o devolución — o suba el archivo.

Tipo

url

Fuentes
  • ESPR (Reg (EU) 2024/1781) Art. 7(2)(b)(ii) anticipated
Nivel de acceso

public Público

Un documento puede sustituirlo

document

El identificador del documento se envía en takeback_scheme_url__document_id.