En este apartado se relacionan los campos CSV disponibles en DILVE para la carga y extracción de información, con una breve descripción de cada uno de ellos. Para cada campo se indican, además, los nombres de campo alternativos o sinónimos que DILVE reconoce como equivalentes a dicho campo, así como el tipo de dato que se espera en cada uno de ellos.
Un libro en DILVE puede tener dos estados: público y no público.
En el primer caso, el libro (y toda su información asociada) es visible por cualquier usuario de DILVE.
Los libros no públicos solo están accesibles por la editorial que los haya cargado en DILVE. No aparecerán en búsquedas, listados, etc. ejecutados por otros usuarios. Se tratar de la visibilidad de los datos en DILVE, no tiene relación con la publicación del libro en el mercado.
Esto permite a las editoriales cargar y gestionar en DILVE libros con información incompleta, no comprobada, etc. o novedades que no quieran hacer públicas todavía.
Por defecto, salvo que se indique lo contrario de forma explícita, todos los libros cargados mediante archivos CSV son "no públicos".
Este campo permite modificar el estado de cualquier libro, pasándolo de no público a público y viceversa. Despublicar los datos de un libro que ya estado público implica que dejarán de estar visibles para otros usuarios por lo que si figuraba en la cadena como activo, seguirá estando así. Se recomienda modificar los metadatos y mantenerlo público.
Si se desea que, en una carga inicial, los libros se den de alta directamente como públicos, los registros correspondientes deben incluir el campo libro_público en el que, explícitamente, se les asigne ese estado.
Formato
Para pasar un libro a estado público, el campo debe contener uno de los siguientes valores: S, SÍ o 1. Puede utilizarse cualquier combinación de mayúsculas y minúsculas. La tilde es opcional.
Para pasar un libro a estado no público, el campo debe contener uno de los siguientes valores: N, NO o 0. Puede utilizarse cualquier combinación de mayúsculas y minúsculas.
Cualquier otro valor se ignora y no se altera el estado del libro correspondiente.
Este campo se utiliza para borrar (eliminar) los libros correspondientes de la base de datos de DILVE.
NOTA: Este campo debe utilizarse con la máxima precaución ya que el borrado de los registros correspondientes se lleva a cabo sin ningún aviso adicional y no es reversible. No es posible recuperar la información de los libros eliminados.
Formato
Puede contener cualquiera de los siguientes textos o caracteres: S, SÍ o 1. Puede utilizarse cualquier combinación de mayúsculas y minúsculas. La tilde es opcional.
Cualquier otro valor se ignora y no se borra el registro correspondiente.
Campo ONIX
Comentarios
Si se introduce cualquier valor distinto de los enumerados (o si el campo está en blanco) se genera un aviso y no se modifica la base de datos.
Si el ISBN13 (o id_dilve) referenciado no existe en DILVE, se genera un aviso.
Este campo se utiliza para indicar si el libro se debe incluir entre los envíos automáticos a Libranda.
Formato
Puede contener cualquiera de los siguientes textos o caracteres: S, SÍ o 1. Puede utilizarse cualquier combinación de mayúsculas y minúsculas. La tilde es opcional.
Si se envía vacío se asume "No" y cualquier otro valor se ignora.
Obligatorio para el alta del libro (Debe figurar al menos uno de los campos ISBN13, ISBN13 con guiones o id_dilve)
Nombre
isbn13_guiones
Función
En general, en DILVE se gestionan, internamente, los ISBN sin guiones (salvo en los entornos de visualización: fichas, formularios, etc.), siguiendo las recomendaciones de la Agencia Internacional del ISBN.
En las extracciones de datos, los valores mostrados en el campo ISBN13 tampoco incluye guiones.
Si se desea obtener el valor del ISBN con guiones, se debe especificar el campo isbn13_guiones.
En las cargas de datos se pueden utilizar indistintamente los campos con o sin guiones. En cualquier caso, en las cargas, DILVE ignora los guiones (u otros caracteres no numéricos) incluidos en estos campos.
Opcional si figura el ISBN13 (con o sin guiones). Obligatorio para el alta del libro en caso contrario.
Nombre
id_dilve, dilve_id, dilveid
Función
Es un identificador opcional para obras que no dispongan de ISBN13.
Este identificador tiene que ser único en DILVE, es decir, se debe tener la garantía de que no existirán dos registros con la misma identificación.
Para ello, este campo se construye a partir de dos partes diferenciadas:
La primera es el "identificador DILVE de la editorial", que es un campo de 8 caracteres alfanuméricos adjudicado de forma unívoca por DILVE a cada editorial en el momento del alta. Se puede consultar en la ficha de la editorial.
La segunda parte del identificador id_dilve de obra es también un campo alfanumérico de hasta 8 caracteres pero, en este caso, generado por la propia editorial (puede ser su código de almacén, código de pedido, etc.).
De esta forma, una editorial puede utilizar un código interno propio para identificar a estos registros con la seguridad de que no habrá "colisiones" con los identificadores que pudieran utilizar otras editoriales en las mismas circunstancias.
Por ejemplo, supongamos que dos editoriales dan de alta a un registro cada una, y ambas utilizan su código interno de referencia o almacén, y este es el 070157 para ambas. Si el código DILVE de la primera editorial es editprim y el de la segunda es editsegu, DILVE dará de alta a estos registros con los códigos id_dilve editprim070157 y editsegu07157, con lo que se evita la duplicación de la identificación de ambos registros.
Formato
Hasta 16 caracteres: los 8 primeros son el identificador DILVE de la editorial (fijo para cada editorial), generado y asignado por DILVE, y los restantes 8 caracteres son de libre disposición por parte de la editorial.
El campo debe tener más de 9 caracteres ya que los 8 primeros son el código DILVE de la editorial. Si estos 8 caracteres no coinciden con el código DILVE de la editorial, se genera un error y no se procesa el registro.
Si el campo coincide con un valor ya existente, se asume que los campos contenidos en el registro sustituyen a los que ya pudieran existir. En otras palabras, si una editorial da de alta a dos libros distintos con el mismo código, los valores del segundo sustituyen a los del primero y no se genera ningún aviso. A todos los efectos, DILVE asume que el segundo registro contiene una corrección de los datos que figuraban en el primer registro. Es responsabilidad de la editorial que no se repitan los 8 dígitos de identificación interna de la obra.
La aplicación valida que los primeros 8 caracteres coincidan con el código DILVE de la editorial del usuario que hace la carga.
Es un identificador opcional que permite identificar al título dentro del catálogo de la editorial. Puede ser el "código de almacén", un "código de pedido", etc.
En el proceso de alta de la editorial se puede definir el término que la editorial desea utilizar para designar a este campo, por ejemplo, "código pedido". Si este término se ha definido, en el registro ONIX se asigna ese valor a "IDTypeName" en lugar del texto genérico "referencia".
Si la editorial cambia el término utilizado para ese campo, por ejemplo de "código pedido" a "ref.almacén", los registros que ya estuvieran cargados mantienen "IDTypeName" igual al término antiguo. En el ejemplo, coexistirían registros con "IDTypename = código pedido" y "IDTypeName = ref.almacén". Esto podría ocasionar problemas en las consultas o extracciones de los libros con el término anterior, por lo que debe repetirse la carga del valor de ese campo para esos libros.
La aplicación no realiza ninguna comprobación sobre este campo.
Opcional. (**Obligatorio para el alta del libro en las cargas realizadas por usuarios tipo Grupos Editorial**)
Nombre
editorial
Función
En el caso de cargas realizadas por usuarios tipo Grupos Editorial, este campo es imprescindible para la asignación de cada registro a la editorial que corresponda.
Formato
Texto libre. El contenido debe coincidir con el valor asignado en el campo Nombre DILVE de cada editorial. Se puede consultar en la ficha de la editorial.
En el caso de cargas realizadas por usuarios tipo Editorial la aplicación ignorará este campo.
En el caso de cargas realizadas por usuarios tipo Grupos editorial, el contenido deberá coincidir con alguno de los valores del campo Nombre DILVE de alguna de las editoriales del grupo. Si no es así, se genera un error y se ignora el resto del registro.
Deben indicarse los nombres comerciales de las personas participantes en la obra y detallando el tipo de participación. En el caso del autor, es posible que la Agencia del ISBN solicite el nombre real (con nombre y 2 apellidos) para identificar correctamente a la persona que corresponda en el proceso de catalogación. En ese caso, la información puede enviarse en el campo Notas para ISBN, que es un campo privado.
Obligatorio para el alta del libro. (Debe figurar al menos uno de los campos Autor, Autor Entidad o Nombre Congreso).
Nombre
autor, autores
Formato
Cuando se introduzca un nombre de persona este debe figurar siempre en la forma: Apellido(s), Nombre.
Se recomienda no emplear mayúsculas salvo para la inicial de cada apellido o nombre.
El contenido de este campo, independientemente del número de nombres que contenga, debe ir entre comillas dobles ("). Si se utiliza Excel, las comillas se añadirán automáticamente al crear el archivo CSV.
Si hay más de un autor, deben separarse por punto y coma (";") o por una barra ("/").
Para indicar "... y otros", debe figurar como un autor más cualquiera de los siguientes textos: "y otros", "otros", "Altres", "i altres" o "et al.". Es decir, este término deberá estar separado de los demás nombres por un punto y coma o por una barra ("/").
Para indicar Varios Autores (es decir, una autoría colectiva con autores no nombrados individualmente) debe figurar como único autor cualquiera de los siguientes textos: " Varios", "Varios autores", "v.v.a.a. " y "vv.aa.".
Para indicar que es anónimo o de autoría desconocida el campo deberá contener, como único valor, el término Anónimo o Desconocido respectivamente.
Para indicar el ISNI del autor utilizar el carácter separador # después del nombre, seguido del valor del ISNI que corresponda. En las extracciones no se incluirá el ISNI, para ello se debe utilizar el campo autor_isni.
Existen 3 campos (otras_menciones1, otras_menciones2 y otras_menciones3) con las mismas características y que permiten cargar 3 tipos más de responsabilidades de los tipos que no tienen un campo CSV específico.
Deberá estar compuesto por un código ONIX de autoría (Lista 17 de código ONIX) y el nombre (en formato Apellidos, Nombre) separados por ";".
Con el mismo formato que para el campo Autor, puede enviarse: Anónimo, Desconocido y Varios Autores.
Se admitirán todos los códigos ONIX de autoría, excepto los que tengan un campo CSV específico que son los siguientes: A01, A12, A16, A20, A36, B06, B24.
Solo se permite un grupo "código; apellido(s), nombre" en este campo.
Para indicar el ISNI del autor utilizar el carácter separador # después del nombre, seguido del valor del ISNI que corresponda.
En las extracciones no se incluirá el ISNI, para ello se debe utilizar el campo otras_menciones1_isni, otras_menciones1_isni2 o otras_menciones1_isni3.
Si se recibe la marca de que la publicación ha pasado por un proceso anónimo de revisión por pares (Sí, s o 1) se guardará el bloque Contributor indicado.
Si el campo llega vacío o con No, no o 0 se eliminarán los bloques Contributor del tipo Revisado por pares.
Existen 3 campos (nota_biografica_autor1, nota_biografica_autor2 y nota_biografica_autor3) con las mismas características que permiten indicar notas biográficas de los 3 primeros autores del texto indicados en el libro.
Permite introducir una breve nota biográfica del autor que se envíe en primer lugar en el campo autor. El texto debe incluir el nombre del autor y no debe incluir hiperenlaces. Si se desea indicar una dirección web del autor, se hará mediante el campo correspondiente.
Formato
Texto libre. Debe estar en formato de texto plano (sin ningún tipo de formateo o saltos de línea y sin marcas HTML)
La aplicación no realiza ninguna comprobación o modificación sobre el contenido de este campo.
El contenido del campo se incluirá en el bloque Contributor tipo A01 correspondiente según el orden en la ficha ONIX del libro, siempre que tenga formato de nombre de persona o entidad.
En caso de que no existan bloques Contributor de tipo A01 o estos tengan campos UnnamedPersons, se dará un aviso y se ignorará el campo.
Existen 3 campos (web_autor1, web_autor2 y web_autor3) con las mismas características que permiten indicar las direcciones web de los 3 primeros autores del texto indicados en el libro.
Tipo
Opcional
Nombre
web_autor1 / web_autor2 / web_autor3
Función
Permite introducir una dirección web de una página (blog, biográfica, etc.) correspondiente al autor que se envíe en primer lugar en el campo autor.
Formato
Debe comenzar por "https://" o por "http://" (sin las comillas).
La aplicación no realiza ninguna comprobación o modificación sobre el contenido de este campo.
El contenido del campo se incluirá en el bloque Contributor tipo A01 correspondiente según el orden en la ficha ONIX del libro, siempre que tenga formato de nombre de persona o entidad.
En caso de que no existan bloques Contributor de tipo A01 o estos tengan campos UnnamedPersons, se dará un aviso y se ignorará el campo.
Obligatorio para el alta del libro. (Debe figurar al menos uno de los campos Autor, Autor Entidad o Nombre Congreso).
Nombre
Autor_isni, autores_isni
Formato
Cuando se introduzca un nombre de persona este debe figurar siempre en la forma: Apellido(s), Nombre.
Se recomienda no emplear mayúsculas salvo para la inicial de cada apellido o nombre.
El contenido de este campo, independientemente del número de nombres que contenga, debe ir entre comillas dobles ("). Si se utiliza Excel, las comillas se añadirán automáticamente al crear el archivo CSV.
Si hay más de un autor, deben separarse por punto y coma (";") o por una barra ("/").
Para indicar "... y otros", debe figurar como un autor más cualquiera de los siguientes textos: "y otros", "otros", "Altres", "i altres" o "et al.". Es decir, este término deberá estar separado de los demás nombres por un punto y coma o por una barra ("/").
Para indicar Varios Autores (es decir, una autoría colectiva con autores no nombrados individualmente) debe figurar como único autor cualquiera de los siguientes textos: " Varios", "Varios autores", "v.v.a.a. " y "vv.aa.".
Para indicar que es anónimo o de autoría desconocida el campo deberá contener, como único valor, el término Anónimo o Desconocido respectivamente.
Para indicar el ISNI del autor utilizar el carácter separador # después del nombre seguido del valor del ISNI correspondiente. En las extracciones se incluirá también la información del ISNI.
Existen 3 campos (otras_menciones1_isni, otras_menciones2_isni y otras_menciones3_isni) con las mismas características y que permiten cargar 3 tipos más de responsabilidades que no figuren en campos CSV específicos junto son el isni de cada una de ellas.
Deberá estar compuesto por un código ONIX de autoría (Lista 17 de código ONIX) y el nombre (en formato Apellidos, Nombre) separados por ";".
Con el mismo formato que para el campo Autor, puede enviarse: Anónimo, Desconocido y Varios Autores.
Se admitirán todos los códigos ONIX de autoría, excepto los que tengan un campo CSV específico que son los siguientes: A01, A12, A16, A20, A36, B06, B24.
Solo se permite un grupo "código; apellido(s), nombre" en este campo.
Para indicar el ISNI del autor utilizar el carácter separador #, después del nombre, seguido del valor del ISNI que corresponda. En las extracciones se incluirá el ISNI.
La aplicación valida que el código ONIX sea correcto. Si no es así, DILVE ignora el contenido del campo. comprueba también el valor del ISNI en caso de que se envíe. Si es incorrecto se actualizará sólo el nombre
Para borrar una mención de responsabilidad existente deberá enviarse el mismo código ONIX sin nombre.
Si se incluye un ISNI no válido se actualizará la autoría pero no se guardará el ISNI.
DILVE permite cargar, simultáneamente, hasta tres campos para el título de la obra, con distintos valores:
El campo título debe contener el título de la obra tal como figura en la misma.
El campo título_distribuidor permite introducir un texto más abreviado o con indicaciones adicionales. Este texto, si figura, es el que se incluirá en las extracciones de datos en formato SINLI.
El campo título_original permite introducir el título original para obra traducidas.
Texto libre. Se recomienda no escribir los textos en mayúsculas, salvo que aparezcan así en la cubierta del libro. En general, solo se deben utilizar mayúsculas al inicio del título y de los nombres propios.
El texto facilitado como Título debe coincidir con el que figure en la cubierta de la obra. No debe añadirse información adicional: p.ej. "Novedad", "2a edición", etc.
Este campo permite incluir una redacción alternativa al título real de la obra, destinada al canal de distribución y venta.
En caso de figurar, será el título que se incluya en las extracciones en formato SINLI. En caso de no figurar, la aplicación enviará el contenido de campo Título en estas extracciones.
En cualquier caso debe tenerse en cuenta la limitación de longitud del campo título en el formato SINLI (80 caracteres).
Contiene el título original de la obra, en el caso de traducciones.
Formato
Texto libre. Debe respetarse la grafía del título tal como figure en la obra original. Como norma general, se recomienda no escribir los textos en mayúsculas, salvo que aparezcan así en la cubierta del original.
Texto libre. Se recomienda no escribir los textos en mayúsculas, salvo que aparezcan así en la cubierta del libro. En general, solo se deben utilizar mayúsculas al inicio del título y de los nombres propios.
El texto facilitado como "subtítulo" debe coincidir con el que figure en la cubierta de la obra. No debe añadirse información adicional: p.ej. "Novedad", "2a edición", etc.
Opcional porque si no figura este campo o el campo Idioma ANELE se asume que el libro está en castellano, por lo que deberá figurar el campo explícitamente en el caso de obras en otros idiomas.
Nombre
idioma, lengua
Función
Especifica el idioma en que está publicada la obra. En el caso de obras multilingües se pueden incluir varios códigos, separados por punto y coma ";".
Para manuales o guías de aprendizaje de una lengua extranjera esta NO deberá codificarse como idioma de la obra, sino la lengua materna del público a quién va dirigida. Así, un libro de texto de francés para Cataluña deberá indicar el "catalán" como idioma, sin hacer mención alguna al francés en este campo.
Formato
Debe utilizarse un código ONIX de la Lista 74 (que, básicamente, coincide con el estándar ISO 639-2/B). Algunos valores relevantes son: ast Asturiano baq Euskera cat Catalán glg Gallego spa Castellano qav Valenciano
Opcional porque si no figura este campo o el campo Idioma ANELE se asume que el libro está en castellano, por lo que deberá figurar el campo explícitamente en el caso de obras en otros idiomas.
Nombre
idioma_anele
Función
Este campo se utilizará exclusivamente para libro de texto.
Especifica el idioma en que está publicada la obra.
Para manuales o guías de aprendizaje de una lengua extranjera esta NO deberá codificarse como idioma de la obra, sino la lengua materna del público a quién va dirigida. Así, un libro de texto de francés para Cataluña deberá indicar el "catalán" como idioma, sin hacer mención alguna al francés en este campo.
Básicamente, este campo funciona como el campo idioma, salvo que permite utilizar los códigos de idioma de ANELE (valores textuales) en lugar de los códigos ONIX (ISO 639-2/B) y solo admite un idioma.
Formato
Debe contener un valor de idioma ANELE. Estos son: Catalán Español Euskera Gallego Valenciano
Debe utilizarse uno o varios códigos ONIX de la Lista 74 (que, básicamente, coincide con el estándar ISO 639-2/B). Algunos valores relevantes son: ast Asturiano baq Euskera cat Catalán eng Inglés fre Francés (Moderno) ger Alemán glg Gallego grc Griego clásico ita Italiano lat Latín spa Castellano qav Valenciano
Especifica el idioma utilizado para la traducción de la obra, cuando este no coincide con el idioma original en que ha sido escrita.
Formato
Debe utilizarse un código ONIX de la Lista 74 (que, básicamente, coincide con el estándar ISO 639-2/B). Algunos valores relevantes son: ast Asturiano baq Euskera cat Catalán qav Valenciano eng Inglés fre Francés (Moderno) ger Alemán glg Gallego grc Griego clásico ita Italiano lat Latín spa Castellano
Este campo se utiliza solo en el caso de que la obra sea una traducción. En caso de ser necesario, pueden enviarse varios valores separados por ";".
El valor se almacena dentro del bloque <Contributor> asociado a una mención de autoría referida a traductor. Se ignorarán todos los idiomas para los que no exista una mención de traducción.
Si no figura no se supone ningún valor. En caso de ser necesario, pueden enviarse varios valores separados por ";".
Si el código no es correcto se genera un aviso y el campo queda vacío en la ficha ONIX.
Permite introducir un resumen, descripción o texto explicativo de la obra.
Formato
Puede enviarse un texto libre que se guardará en la ficha ONIX en el que no podrán incluirse saltos de línea ("retornos de carro").
Se pueden enviar textos mediante archivos adjuntos al CSV. Este proceso se describe en el documento Cargas de textos e imágenes, disponible en www.dilve.es.
Si se envía el resumen mediante un archivo, en el campo CSV deberá indicarse el nombre de archivo (que deberá incluirse en la carpeta comprimida en la que se envíe el archivo CSV). El campo CSV deberá comenzar por el texto "file://" (sin comillas), seguido por el nombre del archivo correspondiente. Este nombre deberá comenzar por el isbn13 del libro, según se describe en el documento mencionado.
Si se envía el resumen como una URL esta debe empezar por "https://" o "http://" en caso contrario el contenido del campo se interpretará como un texto.
El formato de dicho archivo podrá ser tipo texto (con extensión txt) o PDF, si bien se recomienda la utilización del formato texto.
Si se desea utilizar este texto para extracciones en formato SINLI debe limitarse su longitud a 255 caracteres. En caso contrario, el texto se truncará a esta longitud.
Los textos cargados mediante archivos en formato PDF no se incluirán en las extracciones SINLI.
Campo ONIX
Para textos: /TextContent/TextType(=03) - ContentAudience(=00) - Text(=valor)
Para archivos pdf: /SupportingResource/ResourceContentType(=31) - ContentAudience(=00) - ResourceMode(=04) - ResourceVersion/ResourceForm(=02) - ResourceL-ink(="file://"+valor)
Para URL: /SupportingResource/ResourceContentType(=31) - ContentAudience(=00) - ResourceMode(=04) - ResourceVersion/ResourceForm(=02) - ResourceL-ink(=valor))
Comentarios
La aplicación no realiza ninguna comprobación o modificación sobre el contenido de este campo.
En caso de que un campo textual (resumen, índice de contenidos, etc.) contenga saltos de línea (y no se trate de un archivo pdf), la extracción de la información se realizará en un archivo en formato texto que se nombrará según el siguiente convenio: NNNNNNNNNNNNN_153_TT_SS.txt donde: NNNNNNNNNNNNN es el ISBN13, TT indica el tipo de campo según la lista 153 de ONIX y SS es un número secuencial que se utilizará cuando exista más de un archivo del mismo tipo.
Existen también los campos texto_resumen2 y texto_resumen3. Cuando en un registro CSV figura alguno de estos tres campos, la aplicación borra todos los campos del tipo /TextContent/TextType(=03) - ContentAudience(=00) y /SupportingResource/ResourceContentType(=31) - ContentAudience(=00) - ResourceMode(=04) - ResourceVersion/ResourceForm(=02) que pudieran existir en la ficha ONIX y crea los que corresponden a los vengan en el archivo CSV, independientemente de su numeración 1, 2 o 3. Es decir, si se envía un archivo con los campos texto_resumen1 y texto_resumen2, y, posteriormente, se envía un archivo que solo incluye el campo texto_resumen3, en el registro ONIX se borran los dos primeros y solo figurará el enviado como texto_resumen3.
En la salida, y sólo para el primer texto_resumen, si el registro en DILVE no tiene descripción principal pero tiene cargado algún otro campo textual en formato texto plano, se extraerá en este campo según una prioridad concreta entre los distintos tipos de campos (puede solicitarse más información al servicio de Asistencia de DILVE).
Existen 3 campos (idioma_resumen1, idioma_resumen2 y idioma_resumen3) con las mismas características que permiten indicar el idioma de los resúmenes cargados en los campos correspondientes (texto_resumen1, texto_resumen2 y texto_resumen3). Deberá cargarse en el mismo CSV el texto y su idioma correspondiente.
Permite especificar el idioma del resumen o texto explicativo de la obra introducido en el campo texto_resumen, texto_resumen2 o texto_resumen3,respectivamente.
Formato
Debe utilizarse un código ONIX de la Lista 74. Algunos valores relevantes de esa lista son:
ast Asturiano
baq Euskera
cat Catalán
glg Gallego
spa Castellano
qav Valenciano
Campo ONIX
Para textos: /TextContent/TextType(=03) - ContentAudience(=00) - <Text language="valor">
Para archivos pdf y URL: /SupportingResource/ResourceContentType(=31) - ContentAudience(=00) - ResourceMode(=04) - ResourceVersion/ResourceForm(=02) - <ResourceLink language="valor">
Comentarios
Si no figura se supone que el resumen está en castellano.
Si el código no es correcto se genera un aviso y el atributo "language" toma el valor establecido por omisión (castellano).
Existen también los campos idioma_resumen2 e idioma_resumen3.
Existen 3 campos (idioma_resumen_breve, idioma_resumen_breve2 y idioma_resumen_breve3) con las mismas características que permiten indicar el idioma de los resúmenes breves cargados en los campos correspondientes (resumen_breve, resumen_breve2 y resumen_breve3). Deberá cargarse en el mismo CSV el texto y su idioma correspondiente.
Existen 3 campos (idioma_índice1, idioma_índice2 y idioma_índice3) con las mismas características que permiten indicar el idioma de los índices cargados en los campos correspondientes (índice1, índice2 y índice3). Deberá cargarse en el mismo CSV el texto y su idioma correspondiente.
Permite introducir un texto con una reseña crítica o un comentario sobre el libro.
No debe utilizarse este campo para introducir un resumen o descripción del libro por parte de la editorial: este debe ir en los campos Resumen o Resumen breve.
IMPORTANTE: La editorial que realice la carga es responsable de la gestión de los derechos de reproducción de la reseña. DILVE no se responsabiliza de la carga de reseñas cuyos derechos de reproducción no hayan sido cedidos a la editorial correspondiente.
Existen 3 campos (idioma_reseña, idioma_reseña2 y idioma_reseña3) con las mismas características que permiten indicar el idioma de las reseñas o citas de reseñas cargadas en los campos correspondientes (reseña, reseña2 y reseña3). Deberá cargarse en el mismo CSV el texto y su idioma correspondiente.
Existen 3 campos (titular_promocional, titular_promocional2 y titular_promocional3) que permiten introducir un titular o frase promocional de la obra en varios idiomas.
Existen 3 campos (idioma_titular_promocional, idioma_titular_promocional2 y idioma_titular_promocional3) con las mismas características que permiten indicar el idioma de los titulares promoci cargados en los campos correspondientes (titular_promocional, titular_promocional2 y titular_promocional3). Deberá cargarse en el mismo CSV el texto y su idioma correspondiente.
Existen 3 campos (idioma_comentario_autor, idioma_comentario_autor2 y idioma_comentario_autor3) con las mismas características que permiten indicar el idioma de los comentarios del autor cargados en los campos correspondientes (comentario_autor, comentario_autor2 y comentario_autor3). Deberá cargarse en el mismo CSV el comentario y su idioma correspondiente.
Existen 3 campos (descripcion_lector, descripcion_lector2 y descripcion_lector3) que permiten introducir descripciones para el lector en varios idiomas.
Existen 3 campos (idioma_descripcion_lector1, idioma_descripcion_lector2 y idioma_descripcion_lector3) con las mismas características que permiten indicar el idioma de las descripciones para el lector cargadas en los campos correspondientes (descripcion_lector, descripcion_lector2 y descripcion_lector3). Deberá cargarse en el mismo CSV el texto y su idioma correspondiente.
Existen 3 campos (descripcion_medios, descripcion_medios2 y descripcion_medios3) que permiten introducir descripciones para la prensa en varios idiomas.
Existen 3 campos (idioma_descripcion_medios1, idioma_descripcion_medios2 y idioma_descripcion_medios3) con las mismas características que permiten indicar el idioma de las descripciones para la prensa cargadas en los campos correspondientes (descripcion_medios, descripcion_medios2 y descripcion_medios3). Deberá cargarse en el mismo CSV el texto y su idioma correspondiente.
Existen 3 campos (descripcion_libreria, descripcion_libreria2 y descripcion_libreria3) que permiten introducir descripciones para librerías en varios idiomas.
Existen 3 campos (idioma_descripcion_libreria1, idioma_descripcion_libreria2 y idioma_descripcion_libreria3) con las mismas características que permiten indicar el idioma de las descripciones para librerías cargadas en los campos correspondientes (descripcion_libreria, descripcion_libreria2 y descripcion_libreria3). Deberá cargarse en el mismo CSV el texto y su idioma correspondiente.
Existen 3 campos (texto_solapa, texto_solapa2 y texto_solapa3) que permiten introducir el texto de la solapa o de la contracubierta de la obra en varios idiomas.
Existen 3 campos (idioma_texto_solapa, idioma_texto_solapa2 y idioma_texto_solapa3) con las mismas características que permiten indicar el idioma de los textos de solapa o de comracubierta cargados en los campos correspondientes (texto_solapa, texto_solapa2 y texto_solapa3). Deberá cargarse en el mismo CSV el texto y su idioma correspondiente.
Permite introducir un extracto de la obra. IMPORTANTE: La editorial debe asegurarse de que la carga de este texto en DILVE y su utilización por parte de los usuarios de la plataforma no vulneran ningún derecho de copia o reproducción.
Existen 3 campos (idioma_extracto1, idioma_extracto2 y idioma_extracto3) con las mismas características que permiten indicar el idioma de los extractos cargados en los campos correspondientes (extracto1, extracto2 y extracto3). Deberá cargarse en el mismo CSV el texto y su idioma correspondiente.
Opcional porque si no figura se asume que es la 1ª edición.
Nombre
num_edic, num_edicion, num_edición
Formato
Numérico, en números arábigos: p.ej. 3. No se debe incluir ningún otro carácter o símbolo, o palabra. Los siguientes valores serían incorrectos "2a", "3ª ampliada y corregida", "12/2005", "Tercera", etc...
No debe emplearse este campo para el número de reimpresión.
Campo ONIX
/EditionNumber(=valor)
Comentarios
Este campo debe emplearse exclusivamente para indicar el número de la edición.
Si el campo no figura, se toma el valor "1" (Primera edición) por omisión.
Si el campo tiene un valor incorrecto (no asimilable a un valor numérico menor de 999), se genera un aviso de error y el campo queda vacío en la ficha ONIX.
NOTA: Excepcionalmente, si el campo comienza por una cadena de dígitos, se toma como número de edición el valor correspondiente a la primera cadena de dígitos. En los ejemplos anteriores se tomaría, para "2a" el valor "2", para "3ª ampliada y corregida " el valor "3", para "12/2005" el valor "12" (que, probablemente, sería incorrecto) y para "Tercera" se generaría un aviso de error y el campo quedaría vacío en la ficha ONIX.
Alfabético. Se recomienda que el texto no figure todo en mayúsculas: p.ej. "CASTELLON DE LA PLANA" sería incorrecto, debiendo figurar "Castellón de la Plana".
Campo ONIX
/CityOfPublication(=valor)
Comentarios
- La aplicación no realiza ninguna comprobación o modificación sobre el contenido de este campo.
Imprescindible para el canal. Debe figurar año_public y **mes_public (**puede cargarse también con fecha_public o con fecha_public_dma).
Nombre
dia_public, día_public
Formato
Se admite el formato "DD" o D"
Campo ONIX
PublishingDetail/PublishingDate/PublishingDateRole(=01) -- Date(=valor). Solo día
Comentarios
Si el valor no está entre 1 y 31, o si no corresponde al mes y año especificados. Se genera un aviso y no se crea el campo ONIX correspondiente a PublicationDate
Si figura este campo, pero no figura el campo "mes_public", se genera un aviso y no se crea el campo ONIX correspondiente a PublicationDate.
Si utiliza este campo, NO debe incluir ninguno de los demás campos referidos a fecha de publicación, SALVO año_public y mes_public.
No se deben utilizar textos escritos exclusivamente en letras mayúsculas, salvo que esa sea la grafía original dada por la editorial al nombre del sello.
En el caso de Grupos Editoriales, no debe confundirse este campo con el campo Editorial
El texto debe ir entre comillas ("). Este carácter no puede formar parte del texto. Si se utiliza Excel, las comillas se añadirán automáticamente al crear el archivo CSV.
NOTA: En general se debe utilizar el campo editorial, incluso para aquellas entidades que no tengan personalidad jurídica. Antes de utilizar el campo sello, les rogamos que se pongan en contacto con el servicio de Asistencia de DILVE.
Campo ONIX
/Imprint/ImprintName(=valor)
Comentarios
- La aplicación no realiza ninguna comprobación o modificación sobre el contenido de este campo.
Solo debe utilizarse si el "número de edición" es 2 o superior. No debe confundirse "edición" con "impresión". En el caso de reimpresiones no cambia el ISBN, por lo que no es de aplicación este campo.
Si no figura el campo isbn13_edicion_anterior, la aplicación lo construye a partir del isbn10_edicion_anterior y viceversa.
Se admiten guiones y blancos, aunque se eliminan al guardar el campo sin comprobar si su ubicación es correcta.
Si el campo está presente se comprueba con el isbn10 de la edición anterior. Si no coinciden, se da un aviso y se descartan los valores.
Se comprueba la corrección del identificador; si no cumple las condiciones de ISBN no se guardará el campo.
Si el valor es vacío se elimina el bloque ProductIdentifier dentro del bloque RelatedProduct.
Se admiten guiones y blancos, aunque se eliminan al guardar el campo sin comprobar si su ubicación es correcta. Internamente, siempre se guarda el ISBN13.
Si el campo está vacío y ya existe algún RelatedProduct con ProductRelationCode=03, se eliminan todos esos bloques RelatedProduct.
Se admiten guiones y blancos, aunque se eliminan al guardar el campo sin comprobar si su ubicación es correcta. Internamente, siempre se guarda el ISBN13.
Si el campo está vacío y ya existe algún bloque RelatedProduct con ProductRelationCode=05, se eliminan todos esos bloques RelatedProduct.
Opcional. Solo se puede utilizar para libros en formato impreso, de los cuales exista una o varias versiones digitales.
Nombre
isbn13_edición_digital, isbn13_edicion_digital
Función
En el caso de ediciones en formato impreso de obras que existan en versiones digitales, permite identificarlas.
Formato
13 dígitos. Puede incluir guiones.
Campo ONIX
/RelatedProduct/ProductRelationCode(=27)/ProductIdentifier/ProductIDType(=03) -- IDValue(=valor pasado a ISBN13)
Comentarios
Se pueden incluir varios ISBN, separados por punto y coma.
Solo debe utilizarse si el registro describe a una obra en formato impreso de la cual exista una o varias versiones en formato digital.
Se admiten guiones y blancos, aunque se eliminan al guardar el campo sin comprobar si su ubicación es correcta. Internamente, siempre se guarda el ISBN13.
Si en el mismo archivo figura también el campo ISBN10_edicion_digital, ambos campos deben ser correctos y sus valores deben corresponderse. Si no es así, se descartan los valores.
Si el campo está vacío y ya existe un bloque RelatedProduct con ProductRelationCode=27, se elimina este bloque RelatedProduct.
Permite indicar, mediante su isbn13, los productos relacionados con el ISBN de carga.
Formato
Debe contener registros que respeten en siguiente formato: cod_relacion,isbn13, donde "cod_relacion" debe ser un valor de la Lista 51 de códigos ONIX e isbn13 puede figurar con o sin guiones.
Puede contener tantos registros, separados por punto y coma (;), como sean necesarios.
Los valores del campo cod_relacion deben pertenecer a la Lista 51 de códigos ONIX. Si alguno no es válido la carga CSV dará un aviso y se ignorará el campo.
Los valores de los isbn13 deberán ser válidos. Si alguno no lo es la carga dará un aviso y se ignorará el campo.
Si el campo llega vacío se borrarán todos los bloques de relación que tenga el libro.
IMPORTANTE: este campo sustituye información que puede cargarse con los siguientes campos CSV:
isbn13_edición_anterior (cod_relacion=03)
isbn13_edicion_sustituye_a (cod_relacion=03)
isbn13_edicion_sustituida_por (cod_relacion=05)
isbn13_edición_digital (cod_relacion=27)
isbn13_edición_impresa (cod_relacion=13)
La aplicación comprueba que cada valor sea numérico y menor de 999, en caso de ser un valor no válido, se deja vacío.
Al ser un conjunto de valores ha de ir entrecomillado.
Es necesario que exista un valor de Fecha de Reimpresión por cada número que figura en este campo.
Para borrar los datos de una reimpresión será necesario enviar el número de reimpresión que se desee borrar y los campos fecha_impresion y tirada vacíos.
La aplicación comprueba que cada valor tenga formato fecha, en caso de ser un valor no válido, se deja vacío.
Si el campo se envía vacío se eliminara el valor correspondiente.
Al ser un conjunto de valores ha de ir entrecomillado.
Es necesario que exista un valor de número de Reimpresión por cada fecha que figura en este campo.
Para borrar los datos de una reimpresión será necesario enviar el número de reimpresión que se desee borrar y los campos fecha_impresion y tirada vacíos.
La aplicación comprueba que cada valor sea numérico (entero y sin separador de miles), en caso de ser un valor no válido, se deja vacío.
Si el campo está vacío se eliminara el valor correspondiente.
Al ser un conjunto de valores ha de ir entrecomillado.
Cada valor del campo se hará corresponder con los conjuntos de número de reimpresión y fecha de reimpresión.
Para borrar los datos de una reimpresión será necesario enviar el número de reimpresión que se desee borrar y los campos fecha_impresion y tirada vacíos.
Se recomienda no utilizar textos escritos exclusivamente en letras mayúsculas, salvo que esa sea la grafía original dada por la editorial al nombre de la colección.
El texto debe ir entre comilla" ("). Este carácter no puede formar parte del texto. Si se utiliza Excel, las comillas se añadirán automáticamente al crear el archivo CSV.
Permite indicar el nombre de una Subcolección/Serie.
Formato
Texto libre.
Se recomienda no utilizar textos escritos exclusivamente en letras mayúsculas, salvo que esa sea la grafía original dada por la editorial al nombre de la subcolección.
El texto debe ir entre comillas ("). Este carácter no puede formar parte del texto. Si se utiliza Excel, las comillas se añadirán automáticamente al crear el archivo CSV.
Indica la numeración, o identificación, del libro dentro de la serie, si se ha informado, o dentro de la colección.
Formato
Texto libre, aunque, en general, será numérico.
Deben evitarse los textos escritos exclusivamente en letras mayúsculas.
El texto debe ir entre comillas dobles ("). Este carácter no puede formar parte del texto. Si se utiliza Excel, las comillas se añadirán automáticamente al crear el archivo CSV.
Permite introducir la descripción de la colección y/o la subcolección o serie.
Formato
Puede enviarse un texto libre que se guardará en la ficha ONIX en el que no podrán incluirse saltos de línea ("retornos de carro").
Se pueden enviar textos mediante archivos adjuntos al CSV. Este proceso se describe en el documento Cargas de textos e imágenes, disponible en www.dilve.es.
Si se envía la descripción mediante un archivo, en el campo CSV deberá indicarse el nombre de archivo (que deberá incluirse en la carpeta comprimida en la que se envíe el archivo CSV). El campo CSV deberá comenzar por el texto "file://" (sin comillas), seguido por el nombre del archivo correspondiente. Este nombre deberá comenzar por el isbn13 del libro, según se describe en el documento mencionado.
No se permite la carga de la descripción como una URL o con un archivo PDF.
Campo ONIX
Para textos: /TextContent/TextType(=17) - ContentAudience(=00) - Text(=valor)
Para archivos pdf: /SupportingResource/ResourceContentType(=42) - ContentAudience(=00) - ResourceMode(=04) - ResourceVersion/ResourceForm(=02) - ResourceL-ink(="file://"+valor)
Para URL: /SupportingResource/ResourceContentType(=42) - ContentAudience(=00) - ResourceMode(=04) - ResourceVersion/ResourceForm(=02) - ResourceL-ink(=valor))
Comentarios
La aplicación no realiza ninguna comprobación o modificación sobre el contenido de este campo.
En caso de que un campo textual (resumen, índice de contenidos, etc.) contenga saltos de línea, la extracción de la información se realizará en un archivo en formato texto que se nombrará según el siguiente convenio: NNNNNNNNNNNNN_153_TT_SS.txt donde: NNNNNNNNNNNNN es el ISBN13, TT indica el tipo de campo según la Lista 153 de ONIX y SS es un número secuencial que se utilizará cuando exista más de un archivo del mismo tipo.
Permite especificar el idioma de la descripción de la colección/serie introducida en el campo descripcion_coleccion.
Formato
Debe utilizarse un código ONIX de la Lista 74. Algunos valores relevantes de esa lista son: ast Asturiano baq Euskera cat Catalán glg Gallego spa Castellano qav Valenciano
Campo ONIX
Para textos: /TextContent/TextType(=17) - ContentAudience(=00) - <Text language="valor">
Para archivos pdf y URL: /SupportingResource/ResourceContentType(=42) - ContentAudience(=00) - ResourceMode(=04) - ResourceVersion/ResourceForm(=02) - <ResourceLink language="valor">
Comentarios
Si no figura se supone que la descripción está en castellano.
Si el código no es correcto se genera un aviso y el atributo "language" toma el valor establecido por omisión (castellano)
Imprescindible para el canal si el producto es una obra en varios volúmenes.
Nombre
obra_completa
Función
Indica si el producto correspondiente es o no una Obra en varios volúmenes.
Formato
Un carácter. Se admite 1 y 0 (1=sí; 0=no), así como s y n (s=sí; n=no). En el caso de letras estas pueden ser mayúsculas o minúsculas.
Campo ONIX
Si Obra_completa: /ProductComposition(=10/11) - /Collection/CollectionType(=10) - /CollectionIdentifier/CollectionIDType(=15) - IDValue(=valor del ISBN13 del <Product>)
Comentarios
En la ficha ONIX del producto se almacenará el isbn13 del registro también en la estructura Collection. Así cuando coincidan los valores de los identificadores del libro con los del bloque Collection /CollectionType(=10) - CollectionIdentifier /CollectionIDType(=15), DILVE considerará que se trata de una Obra en varios volúmenes.
Texto libre, aunque, en general, será numérico. Máximo de 20 caracteres.
Deben evitarse los textos escritos exclusivamente en letras mayúsculas.
El texto debe ir entre comillas doble" ("). Este carácter no puede formar parte del texto. Si se utiliza Excel, las comillas se añadirán automáticamente al crear el archivo CSV.
NOTA: Si se va a utilizar la pasarela DILVE-ISBN, este campo es obligatorio y debe ser numérico.
Campo ONIX
/ProductPart/PrimaryPart - ProductForm(=Valor del ProductForm del Product) - NumberOfItemsOfThisForm(=valor)
Opcional. Obligatorio para volúmenes de obra en varios volúmenes.
Nombre
titulo_volumen, título_volumen
Formato
Texto libre. Máximo de 300 caracteres.
Deben evitarse los textos escritos exclusivamente en letras mayúsculas.
El texto debe ir entre comillas doble" ("). Este carácter no puede formar parte del texto. Si se utiliza Excel, las comillas se añadirán automáticamente al crear el archivo CSV.
Indica el título del libro dentro de la obra en varios volúmenes correspondiente. No tiene por qué ser igual al contenido del campo titulo.
Si este campo tiene valor y no figura ningún campo de identificación de obra en varios volúmenes (isbn13_obra_completa), se genera un aviso y el campo queda vacío en la ficha ONIX.
La aplicación no realiza ninguna otra comprobación o modificación sobre el contenido de este campo.
Opcional. Obligatorio para volúmenes de obra en varios volúmenes.
Nombre
num_volumen
Formato
Texto libre, aunque, en general, será numérico. Máximo de 20 caracteres.
Deben evitarse los textos escritos exclusivamente en letras mayúsculas.
El texto debe ir entre comillas doble" ("). Este carácter no puede formar parte del texto. Si se utiliza Excel, las comillas se añadirán automáticamente al crear el archivo CSV.
Indica la numeración, o identificación, del libro dentro de la obra en varios volúmenes correspondiente.
Si este campo tiene valor y no figura campo de identificación de obra en varios volúmenes (isbn_obra_completa o isbn13_obra_completa), se genera un aviso y el campo queda vacío en la ficha ONIX.
La aplicación no realiza ninguna otra comprobación o modificación sobre el contenido de este campo.
Opcional. Obligatorio para volúmenes de obra en varios volúmenes.
Nombre
titulo_obra_completa, título_obra_completa
Función
Indica la identificación de la obra en varios volúmenes de la cual el libro descrito forma parte.
Formato
Texto libre. Máximo de 300 caracteres.
Deben evitarse los textos escritos exclusivamente en letras mayúsculas.
Campo ONIX
/Collection/CollectionType(=10) - /CollectionIdentifier/CollectionIDType(=15) - IDValue(=ISBN13 de la OVV) - /TitleDetail/TitleType(=01) - /TitleElement/TitleElementLevel(=02) - TitleText(=valor)
Comentarios
Indica el título de la obra en varios volúmenes a la que pertenece el libro.
Si este campo no tiene valor y figura algún campo relacionado con obra en varios volúmenes (titulo_volumen, num_volumen, isbn13_obra_completa), se genera un aviso y dichos campos quedarán vacíos en la ficha ONIX.
La aplicación no realiza ninguna otra comprobación o modificación sobre el contenido de este campo.
Se admiten guiones y blancos, aunque se eliminan al guardar el campo.
No se comprueba la posición de los guiones o blancos.
Si figuran ambos campos, ambos deben ser correctos y sus valores deben corresponderse. Si no es así, se rechazan los datos relativos a la obra en varios volúmenes.
Si no figura el campo, o si está en blanco, o si es incorrecto, se rechaza el registro como erróneo.
Permite indicar la situación de la obra en el catálogo de la editorial. Puede ser necesario añadir el campo de disponibilidad. Su valor se introduce en el campo ONIX <PublishingStatus>.
Permite incluir un texto para ampliar la información enviada en el campo Situación en el catálogo Editorial. Su valor se introduce en el campo ONIX <PublishingStatusNote>.
Formato
Texto libre.
Campo ONIX
/PublishingStatusNote(=valor)
Comentarios
- Para que el campo sea procesado en las cargas CSV es necesario enviar el campo situ_catalogo_editorial.
- Si el valor del campo no figura en la tabla y el libro tiene un precio asignado se genera un aviso y si se guarda un valor por defecto en función de la situación del libro en el catálogo de la editorial (ver tabla).
Valores por defecto de disponibilidad según Situación en catálogo
Permite indicar un código de público objetivo (audiencia) de acuerdo con la tabla ONIX correspondiente. Su valor se introduce en el campo ONIX <AudienceCodeValue>.
Permite indicar un rango de edades para especificar el nivel de lectura.
Formato
Suponiendo que X e Y sean edades en años, el campo admite los siguientes formatos:
X = Nivel de lectura, X años.
X:Y = Nivel de lectura, de X a Y años
:Y = Nivel de lectura, hasta Y años
X: = Nivel de lectura, desde X años
Permite indicar un rango de edades de interés no vinculadas necesariamente con el nivel de lectura.
Formato
Suponiendo que X e Y sean edades en años, el campo admite los siguientes formatos:
X = Edad de interés, X años.
X:Y = Edad de interés, de X a Y años
:Y = Edad de interés, hasta Y años
X: = Edad de interés, desde X años
Permite indicar un código de audiencia de acuerdo con los códigos de la tabla SINLI correspondiente. Su valor se introduce en la ficha ONIX siguiendo los criterios de correspondencia expuestos en el documento Conversión DILVE-SINLI.
Formato
Código de tres dígitos tomado de la tabla que figura a continuación.
Campo ONIX
Ver conversión en documento Conversión DILVE- SINLI
Comentarios
- Si el valor del campo no figura en la tabla, se genera un error y se asigna el valor 000 (Sin calificar).
ONIX permite especificar la materia de un libro a dos niveles: materiadestacada y materia. Cada una de ellas se almacena en lugares específicos de la ficha ONIX.
En el caso particular de la adaptación a España del sistema de marcado de materias Thema, esta materia se puede indicar mediante uno o más códigos. En el caso de que sean necesarios más de un código, estos valores deben ir separados por punto y coma.
Para más detalles sobre el sistema Thema, consulte la página correspondiente en DILVE: https://www.dilve.es/thema.
En materia pueden especificarse todas aquellas materias que se considere oportuno. La primera materia de cada tipo se considerará la materia destacada del tipo que corresponda.
Permite extraer, en el sistema de clasificación iBIC, adaptado al mercado español del libro, el código de la materia y los calificadores destacados del producto.
Formato
Se extraerán el código de materia destacada seguida de los códigos de calificadores, separados por punto y coma.
Descripción de materia iBIC (para materia destacada)
Tipo
Opcional (solo de salida)
Nombre
texto_bic_materia_destacada
Función
Permite extraer, en el sistema de clasificación iBIC, adaptado al mercado español del libro, la descripción correspondiente a la materia y los calificadores destacados del producto.
Formato
Se extraerán la descripción de materia destacada seguida de las descripciones de calificadores, separados por punto y coma.
Especifica, en el sistema de clasificación Thema el código de la materia del producto. Pueden incluirse varios códigos Thema, separados por punto y coma. Podrán indicarse tanto código de materia como calificadores.
Formato
Deberá indicarse al menos un código de materia.
Si hay más de una materia o calificadores los códigos deben ir separados por punto y coma (;).
El contenido del campo debe ir entre comillas dobles ("). Si se utiliza Excel, las comillas se añadirán automáticamente al crear el archivo CSV.
Se guardará en bloques MainSubject el primer código de materia y el primer calificador de cada tipo y en bloques Subject todos los códigos.
Campo ONIX
Códigos de Materia (empiezan por letra): /Subject/SubjectSchemeIdentifier(=93) - SubjectSchemeVersion(=2.1) - SubjectCode(=valor)
Calificador geográfico (empiezan por 1): /Subject/SubjectSchemeIdentifier(=94) - SubjectSchemeVersion(=2.1) - SubjectCode(=valor)
Calificador de legnua (empiezan por 2): /Subject/SubjectSchemeIdentifier(=95) - SubjectSchemeVersion(=2.1) - SubjectCode(=valor)
Calificador temporal (empiezan por 3): /Subject/SubjectSchemeIdentifier(=96) - SubjectSchemeVersion(=2.1) - SubjectCode(=valor)
Calificador nivel educativo (empiezan por 4): /Subject/SubjectSchemeIdentifier(=97) - SubjectSchemeVersion(=2.1) - SubjectCode(=valor)
Calificador nivel de lectura/edad de interés (empiezan por 5): /Subject/SubjectSchemeIdentifier(=98) - SubjectSchemeVersion(=2.1) - SubjectCode(=valor)
Calificador estilo artístico (empiezan por 6): /Subject/SubjectSchemeIdentifier(=99) - SubjectSchemeVersion(=2.1) - SubjectCode(=valor)
Comentarios
La aplicación comprueba que los códigos sean correctos según el listado completo disponible en https://ns.editeur.org/thema/es/. Si alguno de los códigos no es correcto se ignorará el campo.
En la extracción se incluirán todos los códigos Thema que haya en el Product (independientemente de que sean destacadas o no) eliminando los duplicados.
Especifica, en el sistema de clasificación iBIC, adaptado al mercado español del libro, el código de la materia del producto. Pueden incluirse varios códigos BIC, separados por punto y coma. Podrán indicarse tanto código de materia como calificadores.
Formato
Deberá indicarse al menos un código de materia.
Si hay más de una materia o calificadores los códigos deben ir separados por punto y coma (;).
El contenido del campo debe ir entre comillas dobles ("). Si se utiliza Excel, las comillas se añadirán automáticamente al crear el archivo CSV.
Se guardará en bloques MainSubject el primer código de materia y el primer calificador de cada tipo y en bloques Subject todos los códigos.
La aplicación comprueba que los códigos sean correctos. Si alguno de los códigos no es correcto o es una categoría (códigos iBIC de longitud 1) se ignorará el campo.
Permite extraer, en el sistema de clasificación iBIC, adaptado al mercado español del libro, la descripción correspondiente a la materia y los calificadores asignados al producto.
Formato
Se extraerán las descripciones de las materias seguidas de las descripciones de calificadores, separados por punto y coma.
Permite indicar el número de páginas con numeración arábiga. IMPORTANTE: Este campo sólo debe incluirse si existen páginas con numeración romana (es decir si figura el campo de número de páginas en romanos) y se quieren reseñar ambas por separado. En el caso general debe utilizarse num_pags.
Si el valor no es estrictamente numérico se genera un aviso y el campo correspondiente queda vacío en la ficha ONIX.
Si tiene el valor 9999, se almacenará información de que contiene ilustraciones en blanco y negro, pero no el número (/AncillaryContent/AncillaryContentType(=01)).
En las extracciones saldrá el valor 9999 en el caso de que no haya indicación de número concreto de ilustraciones en blanco y negro pero si indicación de que el producto las contiene.
La aplicación no realiza ninguna otra comprobación o modificación sobre el contenido de este campo.
Si el valor no es estrictamente numérico se genera un aviso y el campo correspondiente queda vacío en la ficha ONIX.
Si tiene el valor 9999, se almacenará información de que contiene ilustraciones en color, pero no el número (/AncillaryContent/AncillaryContentType(=02)).
En las extracciones saldrá el valor 9999 en el caso de que no haya indicación de número concreto de ilustraciones en color pero si indicación de que el producto las contiene.
La aplicación no realiza ninguna otra comprobación o modificación sobre el contenido de este campo.
Si el valor no es estrictamente numérico se genera un aviso y el campo correspondiente queda vacío en la ficha ONIX.
Si tiene el valor 9999, se almacenará información de que contiene fotografías, pero no el número (/AncillaryContent/AncillaryContentType(=10)).
En las extracciones saldrá el valor 9999 en el caso de que no haya indicación de número concreto de fotografías pero si indicación de que el producto las contiene.
La aplicación no realiza ninguna otra comprobación o modificación sobre el contenido de este campo.
Permite introducir un texto que describa las ilustraciones cuando no sea suficiente con indicar su número, p.ej. "Incluye dibujos a pluma del propio autor".
Formato
Texto libre. Se recomienda un máximo de 100 caracteres.
Campo ONIX
/IllustrationsNote(=valor)
Comentarios
- La aplicación no realiza ninguna comprobación o modificación sobre el contenido de este campo.
Alfabético, numérico o alfanumérico.
Se permiten los siguientes valores:
- Códigos "sencillos" C (o BB o Cartoné) para Cartoné R (o BC o Rústica) para Rústica
- Alternativamente, se puede incluir una serie formada por un código ONIX de la Lista 7 (dos letras), seguido de uno o más códigos de la Lista 78 (una letra y tres dígitos). En este caso, los elementos de la lista deben estar separados por punto y coma.
- O bien, se puede incluir un código de Encuadernación SINLI, formado por dos dígitos, de acuerdo con la tabla que figura a continuación.
- IMPORTANTE: Este campo se utiliza también para indicar que un libro está en formato DIGITAL. Para ello se utilizará uno de los dos códigos siguientes (tomados de la Lista 7 de ONIX): DG: Libro en formato digital descargable para su lectura "off-line" DH: Recurso digital exclusivamente accesible "on-line"
Si el campo no figura, no se genera ningún aviso y se asigna el código BZ ("Libro en otro formato") en la ficha ONIX.
Si el valor es incorrecto, la aplicación genera un aviso y se asigna el código BZ ("Libro en otro formato") en la ficha ONIX.
En este campo se recibirán valores de las listas 7 y 78 de ONIX que habrá que convertir a valores de las listas 150 y 175 según los criterios de conversión definidos.
Alfabético, numérico o alfanumérico.
Se permiten los siguientes valores:
- Códigos "sencillos" C (o BB o Cartoné) para Cartoné R (o BC o Rústica) para Rústica
- Alternativamente, se puede incluir una serie formada por un código ONIX de la Lista 150 (dos letras), seguido de uno o más códigos de la Lista 175 (una letra y tres dígitos). En este caso, los elementos de la lista deben estar separados por punto y coma.
- O bien, se puede incluir un código de Encuadernación SINLI, formado por dos dígitos, de acuerdo con la tabla que figura a continuación.
- IMPORTANTE: Este campo se utiliza también para indicar que un libro está en formato DIGITAL. Para ello se utilizará uno de los dos códigos siguientes (tomados de la Lista 150 de ONIX): ED: Libro en formato digital descargable para su lectura "off-line" EC: Recurso digital exclusivamente accesible "on-line"
Campo ONIX
/ProductForm(=valor) /ProductFormDetail(=valor)
Comentarios
Si el campo no figura, no se genera ningún aviso y se asigna el código BZ ("Libro en otro formato") en la ficha ONIX.
Si el valor es incorrecto, la aplicación genera un aviso y se asigna el código BZ ("Libro en otro formato") en la ficha ONIX.
Permite indicar el número de unidades. Sólo se debe incluir en el caso de que el producto descrito se componga de un número de elementos iguales superior a 1. Por ejemplo, un pack de cuadernos para el estudiante que tenga un ISBN único y varios ejemplares iguales del mismo cuaderno.
Formato
Numérico.
Campo ONIX
Si > 1: /ProductComposition(=10)
En todo caso salvo que el libro sea una OVV: /ProductPart/ProductForm(=el del Product) - ProductFormDetail(=el del Product) - NumberOfItemsOfThisForm(=valor)
Comentarios
Está especialmente pensado para los productos en formato no librario.
En la salida si el campo no tiene valor se tomará por defecto 1.
Permite indicar uno o más países o territorios en los que la editorial tiene (o permite), y ha decidido ejercer, los derechos de comercialización de la obra.
Este campo no indica los países para los que la editorial tiene los derechos sobre la obra, sino exclusivamente aquellos en los que la editorial ha decidido comercilaizar la misma. IMPORTANTE: Para todos los países y territorios indicados en este campo, se deben indicar los precios correspondientes. No es correcto incluir en este campo países para los que no se indique el precio.
Si un país no figura en este campo (o en el campo de territorios excluidos de venta), no se debe asumir nada respecto al mismo.
La aplicación valida que todos los códigos pertenecen a las listas 49 o 91 de ONIX. Si alguno de los códigos no es válido se ignorará el campo completo.
La aplicación no valida que la combinación de territorios y países sea correcta como tampoco en relación con los territorios excluidos.
Los códigos de países se incluirán en el campo CountriesIncluded separados por espacio en blanco.
Los códigos de países se incluirán en el campo RegionsIncluded separados por espacio en blanco.
Solo se puede incluir este campo si figura el campo territorios_ derecho_venta_incluidos.
La aplicación valida que todos los códigos pertenecen a las listas 49 o 91 de ONIX. Si alguno de los códigos no es válido se ignorará el campo completo.
La aplicación no valida que la combinación de territorios y países sea correcta como tampoco en relación con los territorios excluidos.
Los códigos de países se incluirán en el campo CountriesExcluded separados por espacio en blanco.
Los códigos de países se incluirán en el campo RegionsExcluded separados por espacio en blanco.
Imprescindible para el canal (Se recomienda enviar sólo precio_con_iva o precio_con_iva_cod e iva).
Nombre
precio, precio_sin_iva
Formato
En euros, sin IVA. Numérico con decimales.
No se debe incluir el símbolo €, ni EUR, etc.
Se puede utilizar la coma decimal en lugar del punto. En el caso de que no figuren decimales, se asume un valor en euros enteros, sin céntimos.
En caso de tratarse de un libro de texto de Precio Libre deberá indicarse enviando el texto Libre o el valor 9999,99. (En la extracción CSV saldrá el texto "Libre").
En el caso de precios superiores a 1000 euros no deben utilizarse separadores de miles.
Campo ONIX
Si llega un varlo número correcto /ProductSupply/Market/Territory/CountriesIncluded(=ES) - MarketPublishingDetail/MarketPublishingStatus(=valor_convertido) - SupplyDetail/Supplier/SupplierRole(=01) - SupplierName(=editorial) ProductAvailability(=20) /Price/PriceType(=04) - PriceAmount(=precio_sin_iva) - /Tax/TaxType(=01) - TaxRatePercent(=iva) - TaxableAmount(precio_sin_iva) - CurrencyCode(=EUR)
Si llega un valor equivalente a 0.0: /ProductSupply/Market/Territory/CountriesIncluded(=ES) - MarketPublishingDetail/MarketPublishingStatus(=valor_convertido) - SupplyDetail/Supplier/SupplierRole(=01) - SupplierName(=editorial) ProductAvailability(=20) /Price/PriceType(=04) -- UnpricedItemType(=01) - CurrencyCode(=EUR)
Comentarios
Se asume un IVA del 4% o del 21% en función del formato, salvo si figuran tanto este campo como el campo Precio con IVA o IVA.
Si el dato es negativo o no numérico, la aplicación genera un aviso y el campo queda vacío en la ficha ONIX.
Si un valor se introduce con más de cuatro decimales se redondea a esa precisión.
La aplicación no realiza ninguna otra comprobación o modificación sobre el contenido de este campo.
La aplicación rellena automáticamente los siguientes campos ONIX: Pri-ceAmount, CurrencyCode, Tax/TaxType, Tax/TaxRateCode, Tax/TaxRatePercent y TaxRateAmount, dentro del bloque Price.
Si se trata de un libro de Precio Libre se sustituirá el bloque Price por el campo <UnpricedItemType>=04.
Imprescindible para el canal (Se recomienda enviar sólo precio_con_iva o precio_con_iva_cod e iva).
Nombre
precio_sin_iva_cod
Formato
Admite los mismos formatos que el campo precio_sin_iva (precio numérico decimal y precio libre) y se añade la posibilidad de incluir información de precio codificada, con el formato "L57-CC", donde CC corresponde a un código de la Lista 57 de ONIX.
Campo ONIX
/ProductSupply/Market/Territory/CountriesIncluded(=ES) - MarketPublishingDetail/MarketPublishingStatus(=valor_convertido) /SupplyDetail/Supplier/SupplierRole(=01) - SupplierName(=editorial) ProductAvailability(=20) /Price/PriceType(=04) - PriceAmount(=precio_con_iva) - /Tax/TaxType(=01) - TaxRatePercent(=iva) - TaxableAmount(precio_sin_iva) - CurrencyCode(=EUR)
Si llega un valor equivalente a 0.0: /ProductSupply/Market/Territory/CountriesIncluded(=ES) - MarketPublishingDetail/MarketPublishingStatus(=valor_convertido) /SupplyDetail/Supplier/SupplierRole(=01) - SupplierName(=editorial) ProductAvailability(=20) /Price/PriceType(=04) -- UnpricedItemType(=01) - CurrencyCode(=EUR)
Si llega un valor codificado: /ProductSupply/Market/Territory/CountriesIncluded(=ES) - MarketPublishingDetail/MarketPublishingStatus(=valor_convertido) /SupplyDetail/Supplier/SupplierRole(=01) - SupplierName(=editorial) ProductAvailability(=20) - UnpricedItemType(=01)
Comentarios
Este campo es una extensión del campo precio_sin_iva que, además de valores numéricos para el importe precio, permite introducir en su lugar valores codificados con la Lista 57 de ONIX.
Se puede utilizar la coma decimal en lugar del punto. En el caso de que no figuren decimales, se asume un valor en euros enteros, sin céntimos.
En caso de tratarse de un libro de texto de Precio Libre deberá indicarse enviando el texto Libre o el valor 9999,99. (En la extracción CSV saldrá el texto "Libre").
En el caso de precios superiores a 1000 euros no deben utilizarse separadores de miles.
Campo ONIX
/ProductSupply/Market/Territory/CountriesIncluded(=ES) - MarketPublishingDetail/MarketPublishingStatus(=valor_convertido) /SupplyDetail/Supplier/SupplierRole(=01) - SupplierName(=editorial) ProductAvailability(=20) /Price/PriceType(=04) - PriceAmount(=precio_con_iva) - /Tax/TaxType(=01) - TaxRatePercent(=iva) - TaxableAmount(precio_sin_iva) - CurrencyCode(=EUR)
Si llega un valor equivalente a 0.0: /ProductSupply/Market/Territory/CountriesIncluded(=ES) - MarketPublishingDetail/MarketPublishingStatus(=valor_convertido) - SupplyDetail/Supplier/SupplierRole(=01) - SupplierName(=editorial) ProductAvailability(=20) /Price/PriceType(=04) -- UnpricedItemType(=01) - CurrencyCode(=EUR)
Comentarios
Se asume un IVA del 4% o del 21% en función del formato, salvo si figuran tanto este campo como el campo Precio sin IVA o el IVA.
Si el dato es negativo o no numérico, la aplicación genera un aviso y el campo queda vacío en la ficha ONIX.
Si un valor se introduce con más de cuatro decimales se redondea a esa precisión.
La aplicación no realiza ninguna otra comprobación o modificación sobre el contenido de este campo.
La aplicación rellena automáticamente los siguientes campos ONIX: PriceAmount, Cu-rrencyCode, Tax/TaxType, Tax/TaxRateCode, Tax/TaxRatePercent y Tax/TaxRateAmount, dentro del bloque Price.
Si se trata de un libro de Precio Libre se sustituirá el bloque Price por el campo <UnpricedItemType>=04.
Admite información de precio codificada, con el formato "L57-CC", donde CC corresponde a un código de la Lista 57 de ONIX.
Campo ONIX
/ProductSupply/Market/Territory/CountriesIncluded(=ES) - MarketPublishingDetail/MarketPublishingStatus(=valor_convertido) /SupplyDetail/Supplier/SupplierRole(=01) - SupplierName(=editorial) ProductAvailability(=20) /Price/PriceType(=04) - PriceAmount(=precio_con_iva) - /Tax/TaxType(=01) - TaxRatePercent(=iva) - TaxableAmount(precio_sin_iva) - CurrencyCode(=EUR)
Si llega un valor equivalente a 0.0 (Código 01): /ProductSupply/Market/Territory/CountriesIncluded(=ES) - MarketPublishingDetail/MarketPublishingStatus(=valor_convertido) /SupplyDetail/Supplier/SupplierRole(=01) - SupplierName(=editorial) ProductAvailability(=20) /Price/PriceType(=04) -- UnpricedItemType(=01) - CurrencyCode(=EUR)
Si llega un valor codificado: /ProductSupply/Market/Territory/CountriesIncluded(=ES) - /SupplyDetail/Supplier/SupplierRole(=01) - SupplierName(=editorial) ProductAvailability(=20) /UnpricedItemType(Código lista 57)
Comentarios
Este campo es una extensión del campo precio_con_iva que, además de valores numéricos para el importe precio, permite introducir en su lugar valores codificados con la Lista 57 de ONIX.
El campo debe enviarse siempre con alguno de los campos de precio (precio_sin_iva o precio_con_iva) en caso contrario se ignorará.
Si el dato que llega es negativo o no numérico, la aplicación genera un aviso y no se modificarán los valores relacionados con el precio en la ficha ONIX.
Permite indicar varios precios para el mercado español con distinta fecha de vigencia.
Formato
Debe respetar el siguiente formato:
precio;iva;fecha_desde;fecha_hasta
Puede contener varios bloques separados por |. El precio deberá enviarse entre paréntesis en caso de que se trate de precio con IVA incluido.
Permite indicar varios precios para el mercado español de distinto tipo, fechas de vigencia, restricciones no territoriales, calificadores y códigos de descuento.
Formato
Debe respetar el siguiente formato:
precio_sin_impuestos(precio_con_impuestos);moneda;disponibilidad;fecha_disponibilidad; fecha_desde;fecha_hasta;tipo_precio;tipo_restriccion;tienda;calific_precio; descr_tipo_precio;cod_descuento
Podrá contener tantos bloques como el descrito como sean necesarios separados por | (barra).
precio_sin_impuestos: Obligatorio (si no se incluye precio con impuestos). Un número con decimales separados por coma (si vienen más de 4 decimales se redondeará antes de guardarlo)
precio_con_impuestos: Obligatorio (si no se incluye precio sin impuestos). Un número con decimales separados por coma (si vienen más de 2 decimales se redondeará antes de guardarlo)
moneda: Opcional. Puede tener cualquier valor de la lista 96 (Currency) de ONIX. Si llegara vació se guardaría EUR por defecto.
disponibilidad: Opcional (obligatorio si se envía fecha_disponibilidad). Deberá ser un valor de la lista 65 de ONIX. Si llega vacío se asignará el valor 20 por defecto.
fecha_disponibilidad: Opcional. Una fecha válida con formato YYYYMMDD.
fecha_desde: Opcional. Una fecha válida con formato YYYYMMDD.
fecha_hasta: Opcional. Una fecha válida con formato YYYYMMDD.
tipo_precio: Opcional. Si llega deberá ser un valor de la lista 58 de ONIX. Si llega vacío se tomará el valor 04 por defecto.
tipo_restriccion: Opcional. Deberá ser un valor de la lista 71 de ONIX.
tienda: Opcional. Será un texto libre que podrá corresponder con un valor de la lista 139 de ONIX.
calific_precio: Opcional. Deberá ser un valor de la lista 59 de ONIX.
descr_tipo_precio: Opcional. Texto libre que incluirá la descripción del tipo de precio.
cod_descuento: Opcional. Texto libre que contendrá un código de descuento acordado previamente entre la editorial y el/los consumidor/es de información.
Si alguno de los bloques de valores es erróneo, se ignorará el contenido completo del campo.
El envío de un valor correcto sustituirá a todos los precios para España que tuviera la ficha ONIX.
Precios para España codificado con restricciones de venta
Tipo
Opcional
Nombre
precios_españa_restricciones_cod
Función
Permite indicar varios precios para el mercado español de distinto tipo, fechas de vigencia, restricciones no territoriales, calificadores y códigos de descuento.
Formato
Debe respetar el siguiente formato:
precio_sin_impuestos(precio_con_impuestos);moneda;disponibilidad;fecha_disponibilidad; fecha_desde;fecha_hasta;tipo_precio;tipo_restriccion;tienda;calific_precio; descr_tipo_precio;cod_descuento
Podrá contener tantos bloques como el descrito como sean necesarios separados por | (barra).
precio_sin_impuestos o precio_con_impuestos: Obligatorio (si no se incluye precio con impuestos). Puede ser un número con decimales separados por coma (si vienen más de 4 decimales se redondeará antes de guardarlo) o un texto con el formato "L57-CC" donde CC corresponde a un código de la Lista 57 de ONIX.
Para el resto de elementos del campo ver campo precios_españa_restricciones
En caso de indicarse un precio codificado los campos moneda, fecha_desde, fecha_hasta, tipo_precio, calific_precio, descr_tipo_precio y cod_descuento deberán ser vacíos.
Precios para extranjero con restricciones de venta
paises_territorios: Obligatorio. Deberán ser una serie de valores de las listas 91 (países) y/o 49 (regiones) de ONIX separados por blancos.
tipo_restriccion: Opcional. Deberá ser un valor de la lista 71 de ONIX.
tienda: Opcional. Será un texto libre que podrá corresponder con un valor de la lista 139 de ONIX.
disponibilidad: Opcional (obligatorio si se envía fecha_disponibilidad). Deberá ser un valor de la lista 65 de ONIX.
fecha_disponibilidad: Opcional. Una fecha válida con formato YYYYMMDD.
tipo_precio: Obligatorio. Deberá ser un valor de la lista 58 de ONIX.
precio_sin_impuestos: Obligatorio (si no se incluye precio con impuestos). Un número con decimales separados por coma (si vienen más de 4 decimales se redondeará antes de guardarlo)
precio_con_impuestos: Obligatorio (si no se incluye precio sin impuestos). Un número con decimales separados por coma (si vienen más de 2 decimales se redondeará antes de guardarlo)
moneda: Obligatorio. Cualquier valor de la lista 96 (Currency) de ONIX.
fecha_desde: Opcional. Una fecha válida con formato YYYYMMDD.
fecha_hasta: Opcional. Una fecha válida con formato YYYYMMDD.
calific_precio: Opcional. Deberá ser un valor de la lista 59 de ONIX.
descr_tipo_precio: Opcional. Texto libre que incluirá la descripción del tipo de precio.
cod_descuento: Opcional. Texto libre que contendrá un código de descuento acordado previamente entre la editorial y el/los consumidor/es de información.
Si alguno de los bloques de valores es erróneo, se ignorará el contenido completo del campo.
El envío de un valor correcto sustituirá a todos los precios para fuera de España que tuviera la ficha ONIX.
Precios para extranjero codificado con restricciones de venta
Tipo
Opcional.
Nombre
precios_extranjero_restricciones_cod
Formato
Debe respetar el siguiente formato:
paises_territorios;tipo_restriccion;tienda;disponibilidad;fecha_disponibilidad;
tipo_precio;precio_sin_impuestos(precio_con_impuestos);moneda;
fecha_desde;fecha_hasta;calific_precio;descr_tipo_precio;cod_descuento
Campo ONIX
Ambos precios: /ProductSupply/Market/Territory/CountriesIncluded(=países en países_territorios) - RegionsIncluded (territorios en países_territorios) - MarketPublishingDetail/MarketPublishingStatus(=valor_convertido_disponibilidad) /SalesRestriction/SalesRestrictionType(=tipo_restriccion)/SalesOutlet/SalesOutletName(=tienda) /SupplyDetail/Supplier/SupplierRole(=01) - SupplierName(=editorial) - ProductAvailability(disponibilidad) - /SupplyDate/SupplyDateRole(=08)/Date(=fecha_disponibilidad)
/Price/PriceType(=tipo_precio) - PriceQualifier(=calific_precio) - PriceTypeDescription(=descr_tipo_precio) - DiscountCoded/DiscountCodeType(=02) --DiscountCode(=cod_descuento) - PriceAmount(=precio_con_impuestos) /Tax/TaxType(=01) - TaxRatePercent(=impuestos_calculados) - TaxableAmount(=precio_sin_impuestos) - CurrencyCode(=moneda) /PriceDate/PriceDateRole(=14) - Date(=fecha_desde)
/PriceDate/PriceDateRole(=15) - Date(=fecha_hasta)
Solo un precio: /ProductSupply/Market/Territory/CountriesIncluded(=países en países_territorios) -- RegionsIncluded(territorios en paiese_territorios) - MarketPublishingDetail/MarketPublishingStatus(=valor_convertido_disponibilidad) /SalesRestriction/SalesRestrictionType(=tipo_restriccion)/SalesOutlet/SalesOutletName(=tienda) /SupplyDetail/Supplier/SupplierRole(=01) - SupplierName(=editorial) - ProductAvailability(disponibilidad) - /SupplyDate/SupplyDateRole(=08)/Date(=fecha_disponibilidad) /Price/PriceType(=tipo_precio) - PriceQualifier(=calific_precio) - PriceTypeDescription(=descr_tipo_precio) - DiscountCoded/DiscountCodeType(=02) --DiscountCode(=cod_descuento) - PriceAmount(=precio_con_impuestos) - CurrencyCode(=moneda) /PriceDate/PriceDateRole(=14) - Date(=fecha_desde) /PriceDate/PriceDateRole(=15) - Date(=fecha_hasta)
Precio codificado o con valor equivalente a 0.0 (Código 01): /ProductSupply/Market/Territory/CountriesIncluded(=países en países_territorios) -- RegionsIncluded(territorios en paiese_territorios) - MarketPublishingDetail/MarketPublishingStatus(=valor_convertido_disponibilidad) /SalesRestriction/SalesRestrictionType(=tipo_restriccion)/SalesOutlet/SalesOutletName(=tienda) /SupplyDetail/Supplier/SupplierRole(=01) - SupplierName(=editorial) - ProductAvailability(disponibilidad) - /SupplyDate/SupplyDateRole(=08)/Date(=fecha_disponibilidad) /Price/PriceType(=tipo_precio) - PriceQualifier(=calific_precio) - PriceTypeDescription(=descr_tipo_precio) -- UnpricedItemType(Código de la lista 57) - CurrencyCode(=moneda) /PriceDate/PriceDateRole(=14) - Date(=fecha_desde) /PriceDate/PriceDateRole(=15) - Date(=fecha_hasta)
Comentarios
precio_sin_impuestos o precio_con_impuestos: Obligatorio al menos uno de los dos. Un número con decimales separados por coma (si vienen más de 4 decimales se redondeará antes de guardarlo) o un texto con el formato "L57-CC" donde CC corresponde a un código de la Lista 57 de ONIX.
Para el resto de elementos ver el campo precios_extranjero_restricciones.
Para precios codificados los elementos moneda, fecha_desde, fecha_hasta, calific_precio, descr_tipo_precio y cod_descuento deberán ser vacíos.
Se asume un IVA del 4%, salvo si figuran tanto este campo como el campo Precio de cesión con IVA y su diferencia es distinta al 4%.
Si el dato es negativo o no numérico, la aplicación genera un aviso y no se creará el bloque en la ficha ONIX.
Si el libro no es de precio libre, la aplicación genera un aviso y no se creará el bloque en la ficha ONIX.
Si un valor se introduce con más de cuatro decimales se redondea a esa precisión.
La aplicación no realiza ninguna otra comprobación o modificación sobre el contenido de este campo.
La aplicación rellena automáticamente los siguientes campos ONIX: Currency-Code, CountryCode, Tax/TaxType, Tax/TaxRateCode, Tax/TaxRatePercent y Tax/TaxRateAmount, dentro del bloque Price.
Se asume un IVA del 4%, salvo si figuran tanto este campo como el campo Precio de cesión sin IVA y su diferencia es distinta al 4%.
Si el dato es negativo o no numérico, la aplicación genera un aviso y no se creará el bloque SupplyDetail en la ficha ONIX.
Si el libro no es de precio libre, la aplicación genera un aviso y no se creará el bloque SupplyDetail en la ficha ONIX.
Si un valor se introduce con más de cuatro decimales se redondea a esa precisión.
La aplicación no realiza ninguna otra comprobación o modificación sobre el contenido de este campo.
La aplicación rellena automáticamente los siguientes campos ONIX: Currency-Code, CountryCode, Tax/TaxType, Tex/TaxRateCode1, Tax/TaxRatePercent y Tax/TaxRateAmount, dentro del bloque Price.
Existen 2 campos (imagen_cubierta, imagen_cubierta2) que permiten introducir la imagena de cubierta de la obra.
Tipo
Imprescindible para el canal.
Nombre
imagen_cubierta / imagen_cubierta2
Función
Permite introducir o bien el nombre del archivo con la imagen de la cubierta o bien un URL, externo a DILVE, en el que se puede acceder a la imagen.
El objetivo de esta imagen es su visualización en entornos web. Esto debe tenerse en cuenta a la hora de preparar el archivo correspondiente en lo que se refiere a su formato, tamaño y "peso" en KB. Se recomienda la lectura del documento Cargas de textos e imágenes, disponible en www.dilve.es.
Formato
O bien un nombre de archivo que debe comenzar por el ISBN (sin guiones) del libro, o bien un URL, que debe empezar por http:// o https://.
El tamaño mínimo recomendable de la imagen es de 1.500 píxeles en su lado mayor.
Campo ONIX
Si es URL: /SupportingResource/ResourceContentType(=01) - ContentAudience(=00) - ResourceMode(=03) - /ResourceVersion/ResourceForm(=02) - ResourceL-ink(=valor)
Si es archivo adjunto: /SupportingResource/ResourceContentType(=01) - ContentAudience(=00) - ResourceMode(=03) - /ResourceVersion/ResourceForm(=02) - ResourceL-ink(="file://"+valor)
Comentarios
La aplicación no realiza ninguna comprobación o modificación sobre el contenido de este campo en el caso en que se envíe una URL.
Los archivos de imagen deberán estar en formato jpg o png, con la codificación de colores RGB y no superar el tamaño de 3MB.
Es importante seguir el convenio de nombres de archivos indicado, aunque DILVE no lo comprueba ni exige un nombre en particular.
Existen 2 campos (formato_imagen_cubierta_3.0, formato_imagen_cubierta2_3.0) con las mismas características que permiten indicar el formato internos de los archivos de las imágens de cubiertas cargadas en los campos correspondientes(imagen_cubierta, imagen_cubierta2). Deberá cargarse en el mismo CSV las imágenes y el formato correspondiente.
Debe ir acompañado siempre del campo imagen_cubierta en la misma carga.
Si la imagen de cubierta se sube físicamente a DILVE y el formato indicado no coincide con el del archivo se mostrará un aviso y se asignará el valor real del archivo. Si no se envía el archivo físico en la misma carga no se procesará la información del formato.
Si la imagen de cubierta se carga en forma de URL no se realizará ninguna validación.
En la extracción, si no existe información en el bloque SupportingResource y el archivo está cargado en DILVE se deduce el valor a partir de la extensión del archivo.
Existen 2 campos (fecha_mod_imagen_cubierta, fecha_mod_imagen_cubierta2) con las mismas características que permiten indicar la fecha de última modificación de las imágenes de cubiertas cargadas en los campos correspondientes(imagen_cubierta, imagen_cubierta2). Deberá cargarse en el mismo CSV las imágenes y el formato correspondiente.
Existen 2 campos (imagen_cubierta_normalizada, imagen_cubierta2_normalizada) que permiten extraer los nombres normalizados de las imágenes de cubierta que hayan sido cargadas físicamente en DILVE.
Tipo
Este campo solo se puede utilizar en extracciones CSV (Solo salida).
Permite renombrar los archivos de imágenes de cubierta (que deben estar cargados anteriormente) según el convenio para los nombres de imágenes, descrito a continuación y explicado con más detalle en el documento Cargas de textos e imágenes, disponible en www.dilve.es.
Formato
Comentarios
Este campo facilitará a las editoriales la actualización de los datos cargados en DILVE que no cumplan el convenio para los nombres de las imágenes.
Asegurará a los usuarios de DILVE la obtención de los archivos de las imágenes con los nombres normalizados independientemente de cómo haya sido realizada la carga por parte de las editoriales.
Convenio para los nombres de archivos de imágenes en DILVE
Los nombres de archivos deberán tener la siguiente estructura: nnnnnnnnnnnnn_01_X.jpg
donde:
nnnnnnnnnnnnn será el ISBN13 de la publicación. En todo caso, sin guiones ni otros separadores.
01 Indica el tipo de archivo. Debe ser 01 para la cubierta.
X Es un código propio, de uso interno, que facilita más detalles sobre el tipo de archivo (ver más adelante).
jpg Es la extensión del archivo. Este debe estar en formato JPEG.
Para imágenes de cubierta e ilustraciones en general se utilizarán los siguientes códigos para f, en función del tamaño aproximado de la imagen contenida en el archivo (en píxeles):
x mayor de 1500 x 1500
g entre 1500 x 1500 y 675 x 675
h entre 675 x 675 y 450 x 450
l entre 450 x 450 y 300 x 300 (es una letra "L" minúscula)
m entre 300 x 300 y 200 x 200
n entre 200 x 200 y 135 x 135
s entre 135 x 135 y 90 x 90
t 90 x 90 o menos
Ejemplo:
9781572316218_01_n.jpg es una imagen de la cubierta ("01") del libro con ISBN13=9781572316218, de tamaño aproximado 135x200 píxeles ("n") y en formato JPEG.
Permite cargar y extraer imágenes del libro en formato URL de todos los tipos que contempla el formato ONIX, distintas de la imagen de cubierta. (Ver tabla más adelante).
Formato
Puede contener uno o más registros con el siguiente formato de campos, separados por coma: tipo_imagen,URL,fecha_modificacion donde
"tipo_imagen" debe ser un valor de la Lista 158 de códigos ONIX que corresponda a un tipo de imagen exceptuando la imagen de cubierta (01)
URL debe ser una URL válida y accesible (que empiece por http:// o https://) que apunte a una imagen
fecha_modificacion (opcional) con la fecha de última modificación de la imagen y con formato AAAAMMDD.
Puede contener tantos registros, separados por barra vertical (|), como sean necesarios.
Si el campo tiene más de un carácter de longitud, se toma el primero. Si este es distinto de 1, 0, s o n, se asume, por omisión, el valor n (no es material de enseñanza).
Si el registro incluye el campo tipo_material_educ, el valor del campo ONIX <AudienceCodeValue> se toma de ese campo. En caso contrario se asume que <AudienceCodeValue> vale "00" (=Tipo de material no especificado).
Opcional, pero si se trata de material de enseñanza debe figurar o bien este campo o bien el campo material_educ.
Nombre
tipo_material_educ
Función
En el caso de "material de enseñanza ", este campo indica el tipo de material de que se trata: libro del alumno, libro del profesor, cuaderno de vacaciones, etc.
Formato
Numérico. Código de dos dígitos tomado de la lista Material de enseñanza en España que se muestra a continuación.
Si figura este campo, no es necesario que figure material_educ ya que se asumirá, por omisión, que se trata de material de enseñanza.
Si el valor del campo no figura en la lista Material de enseñanza en España, se generará un aviso y se almacenará el valor 00 en el campo <AudienceCodeValue> de la ficha ONIX.
Si figuran tanto material_educ como tipo_ material_educ, y el primero vale 0 (o n), se ignora el valor de tipo_material_educ, y se asume que no se trata de material de enseñanza. En este caso, si el segundo campo no está en blanco, se genera un aviso.
Opcional, pero si se trata de material de enseñanza debe figurar o bien este campo o bien el campo tipo_material_educ.
Nombre
tipo_material_educ_anele
Función
En el caso de "material de enseñanza ", este campo indica el tipo de material de que se trata: libro del alumno, libro del profesor, cuaderno de vacaciones, etc.
Se recomienda utilizar el campo tipo_material_educ.
Es un campo alternativo a tipo_material_educ que permite utilizar los códigos empleados por ANELE (Textos).
Formato
Texto alfanumérico perteneciente a la tabla ANELE correspondiente.
Si figura este campo, no es necesario que figure material_educ ya que se asumirá, por omisión, que se trata de material de educación.
Si el valor del campo no figura en la lista Material de enseñanza en España, se generará un aviso y se almacenará el valor 00 en el campo <AudienceCodeValue> de la ficha ONIX.
Si figuran tanto material_educ como tipo_ material_educ, y el primero vale 0 (o n), se ignora el valor de tipo_material_educ, y se asume que no se trata de material de enseñanza. En este caso, si el segundo campo no está en blanco, se genera un aviso.
Opcional en general. Obligatorio para libros de texto si no figura el campo combinado de tipo_enseñanza, nivel, ciclo y curso (código TNCC) o el campo tipo_enseñanza_anele.
Nombre
tipo_enseñanza
Función
En el caso de material de enseñanza, este campo indica el tipo de que se trata: general, enseñanza de idiomas, música, etc.
Formato
Numérico. Código de dos dígitos tomado de la lista Tipo de enseñanza que se muestra a continuación.
Si el valor no figura o no es correcto se almacena el valor por defecto 00 ("General"), generando un aviso en caso de error.
El valor de este campo se combina con los de los campos nivel, ciclo, curso y Comunidad Autónoma, para su almacenamiento en la ficha ONIX. Si el código resultante no es válido, se genera un aviso y no se almacena nada en el campo correspondiente de ONIX.
Opcional en general. Obligatorio para libros de texto si no figura el campo combinado de tipo_enseñanza, nivel, ciclo y curso (código TNCC) o el campo tipo_enseñanza.
Nombre
tipo_enseñanza_anele
Función
En el caso de material de enseñanza, este campo indica el tipo de que se trata: general, enseñanza de idiomas, música, etc.
Es un campo alternativo a tipo_enseñanza que permite utilizar los códigos empleados por ANELE (Textos en lugar de códigos numéricos).
Formato
Texto alfanumérico perteneciente a la tabla ANELE correspondiente.
Si el valor no es correcto, se genera un aviso y se almacena como Enseñanza General.
El valor de este campo se combina con los de los campos nivel, ciclo, curso y Comunidad Autónoma, para su almacenamiento en la ficha ONIX. Si el código resultante no es válido, se genera un aviso y no se almacena nada en el campo correspondiente de ONIX.
Opcional en general. Obligatorio para libros de texto si no figura el campo combinado de tipo_enseñanza, nivel, ciclo y curso (código TNCC) o el campo nivel_educ_anele.
Nombre
nivel, nivel_educ
Función
En el caso de material de enseñanza, este campo indica el nivel escolar de aplicación.
Formato
Código de dos dígitos tomado de la tabla que figura a continuación. Si no existe asignación a un nivel concreto debe utilizarse el código 00.
Si el valor no es correcto, se genera un aviso y no se almacena nada en el campo correspondiente de ONIX.
El valor de este campo se combina con los de los campos tipo de enseñanza, ciclo, curso y Comunidad Autónoma, para su almacenamiento en la ficha ONIX. Si el código resultante no es válido, se genera un aviso y no se almacena nada en el campo correspondiente de ONIX.
Opcional en general. Obligatorio para libros de texto si no figura el campo combinado de tipo_enseñanza, nivel, ciclo y curso (código TNCC) o el campo nivel_educ.
Nombre
nivel_anele, nivel_educ_anele
Función
En el caso de material de enseñanza, este campo indica el nivel escolar de aplicación.
Es un campo alternativo a nivel_educ que permite utilizar los códigos empleados por ANELE (Textos en lugar de códigos numéricos)
Formato
Texto alfanumérico perteneciente a la tabla ANELE correspondiente.
Si el valor no es correcto, se genera un aviso y no se almacena nada en el campo correspondiente de ONIX.
El valor de este campo se combina con los de los campos tipo de enseñanza, ciclo, curso y Comunidad Autónoma, para su almacenamiento en la ficha ONIX. Si el código resultante no es válido, se genera un aviso y no se almacena nada en el campo correspondiente de ONIX.
Valores de entrada de Nivel educativo ANELE
Valor del campo CSV
Valor del campo ONIX
(vacío)
00
Educación Infantil
01
Educación Primaria
02
Educación Secundaria Obligatoria
03
Bachillerato LOGSE
04
Formación Profesional
05
Universitario / Superior
06
Valores de salida (depende de valor de "tipo_enseñanza") Nivel educativo ANELE
Valor ONIX del campo Nivel
Valor ONIX del campo Tipo de enseñanza
00
10
21,22
23
24
30
40,50,60,70
00
No especificado
No especificado
No especificado
X
No especificado
No especificado
No especificado
01
Educación Infantil
Básico
Elemental
--
Ciclo formativo
1er nivel
--
02
Educación Primaria
Intermedio
Medio
--
Estudios superiores
2º nivel
--
03
E.S.O.
Avanzado
Superior
--
--
--
--
04
Bachillerato
--
--
--
--
--
--
05
Formación profesional
--
--
--
--
--
--
06
Universitario / Superior
--
--
--
--
--
--
Nota
El valor "X" significa que, para el Tipo de enseñanza correspondiente, solo se puede utilizar este valor para el Nivel.
El valor "--" indica que, para el Tipo de enseñanza correspondiente, no se puede utilizar este valor para el Nivel
Opcional en general. Obligatorio para libros de texto si no figura el campo combinado de tipo_enseñanza, nivel, ciclo y curso (código TNCC) o el campo ciclo_educ_anele y si el libro no tiene una asignación a un curso concreto.
Nombre
ciclo, ciclo_educ
Función
En el caso de material de enseñanza, este campo indica el ciclo o grado escolar de aplicación.
Formato
Código de dos dígitos tomado de la tabla que figura a continuación. Si no existe asignación a un ciclo concreto debe utilizarse el código 00.
Si el valor no es correcto, se genera un aviso y no se almacena nada en el campo correspondiente de ONIX.
El valor de este campo se combina con los de los campos tipo de enseñanza, nivel, curso y Comunidad Autónoma, para su almacenamiento en la ficha ONIX. Si el código resultante no es válido, se genera un aviso y no se almacena nada en el campo correspondiente de ONIX.
Valores de Ciclo educativo
Valor del campo CSV
Significado
00
Sin indicación de Ciclo
01
Primer ciclo (o Grado medio de Formación Profesional)
02
Segundo ciclo (o Grado Superior de Formación Profesional)
Opcional en general. Obligatorio para libros de texto si no figura el campo combinado de tipo_enseñanza, nivel, ciclo y curso (código TNCC) o el campo ciclo_educ y si el libro no tiene una asignación a un curso concreto.
Nombre
ciclo_anele, ciclo_educ_anele
Función
En el caso de material de enseñanza, este campo indica el ciclo escolar de aplicación.
Es un campo alternativo a ciclo_educ que permite utilizar los códigos empleados por ANELE (Textos en lugar de códigos numéricos)
Formato
Texto alfanumérico perteneciente a la tabla ANELE correspondiente.
Si el valor no es correcto, se genera un aviso y no se almacena nada en el campo correspondiente de ONIX.
El valor de este campo se combina con los de los campos tipo de enseñanza, nivel, curso y Comunidad Autónoma, para su almacenamiento en la ficha ONIX. Si el código resultante no es válido, se genera un aviso y no se almacena nada en el campo correspondiente de ONIX.
Valores de entrada de Ciclo educativo ANELE
Valor leído en CSV
Valor para el campo ONIX
(vacío)
00
Si (Nivel == tipo_enseñanza == 00 y nivel == 05)
Grado Medio F.P.
01
Grado Superior F.P.
02
FP Básica
03
Resto de casos
Primero
01
Segundo
02
Tercero
03
Valores de salida (depende de valor de "tipo_enseñanza" y de y "nivel") Ciclo educativo ANELE
Valor del campo ONIX
Valor en salida CSV
00
(vacío)
Si (tipo_enseñanza == 00 y nivel == 05) o tipo_enseñanza == 24
Opcional en general. Obligatorio para libros de texto si no figura el campo combinado de tipo_enseñanza, nivel, ciclo y curso (código TNCC) o el campo curso_educ_anele.
Nombre
curso, curso_educ
Función
En el caso de material de enseñanza, este campo indica el curso escolar de aplicación.
Formato
Código de dos dígitos tomado de la tabla que figura a continuación. Si no existe asignación a un curso concreto debe utilizarse el código 00.
Si el valor no es correcto, se genera un aviso y no se almacena nada en el campo correspondiente de ONIX.
El valor de este campo se combina con los de los campos tipo de enseñanza, nivel, ciclo y Comunidad Autónoma, para su almacenamiento en la ficha ONIX. Si el código resultante no es válido, se genera un aviso y no se almacena nada en el campo correspondiente de ONIX.
Valores de Curso educativo
Valor del campo CSV
Valor para el campo ONIX
00
Sin indicación de Curso
01
Primero (en Infantil = 3 años)
02
Segundo (en Infantil = 4 años)
03
Tercero (en Infantil = 5 años)
04
Cuarto
05
Quinto
06
Sexto
Recuerda
En primer ciclo de Educación Infantil, 0-3 años (cód. etapa=01, cód. ciclo=01) no hay división en cursos, por lo que el código de curso será el 00.
Opcional en general. Obligatorio para libros de texto si no figura el campo combinado de tipo_enseñanza, nivel, ciclo y curso (código TNCC) o el campo curso_educ.
Nombre
curso_anele, curso_educ_anele
Función
En el caso de material de enseñanza, este campo indica el curso escolar de aplicación.
Es un campo alternativo a curso_educ que permite utilizar los códigos empleados por ANELE (Textos en lugar de códigos numéricos)
Formato
Texto alfanumérico perteneciente a la tabla ANELE correspondiente.
Si el valor no es correcto, se genera un aviso y no se almacena nada en el campo correspondiente de ONIX.
El valor de este campo se combina con los de los campos tipo de enseñanza, nivel, ciclo y Comunidad Autónoma, para su almacenamiento en la ficha ONIX. Si el código resultante no es válido, se genera un aviso y no se almacena nada en el campo correspondiente de ONIX.
Valores de entrada de Curso educativo ANELE
Valor leído en CSV
Valor para el campo ONIX
(vacío)
00
3 años
01
4 años
02
5 años
03
Primero
01
Segundo
02
Tercero
03
Cuarto
04
Quinto
05
Sexto
06
Valores de salida (depende de valor de tipo_enseñanza y de nivel) Curso educativo ANELE
Opcional en general. Obligatorio para libros de texto si no figura este dato en el campo combinado de nivel, ciclo y curso (código TNCC).
Nombre
com_autonom
Función
En el caso de material de enseñanza, este campo indica la Comunidad Autónoma de aplicación.
Formato
Dos dígitos, de acuerdo con la tabla que figura a continuación.
Si son más de una C.A. se pondrán los códigos correspondientes, separados por puntos y comas (";"). Si no existe una asignación concreta debe incluirse el código 00.
Si es de aplicación en todas la CC.AA. se usará el código 99.
Opcional en general, pero obligatorio para libro de texto si no figuran los campos tipo de enseñanza, nivel, ciclo y curso.
Nombre
etapa_ciclo_curso
Función
En el caso de material de enseñanza, este campo combina en un solo código los valores de tipo_enseñanza, nivel, ciclo y curso (TNCC), así como el de Comunidad Autónoma de aplicación.
Formato
Es un código alfanumérico formado por la combinación de los códigos de tipo_enseñanza, nivel, ciclo y curso, de acuerdo con la tabla que figura a continuación. En esta tabla, todos los códigos comienzan por el dígito "2" que identifica la versión del convenio de codificación empleado.
Al código TNCC se debe añadir el de la Comunidad Autónoma de aplicación, tomado de la tabla que figura en el apartado correspondiente de este documento. En los casos en los que no exista asignación a una C.A. concreta (o esta se desconozca), esto debe hacerse explícito utilizando el código 00 para la C.A.
Si un determinado producto es de aplicación en más de un nivel educativo, se incluirán todos los códigos completos correspondientes, separados por punto y coma (";"). Para cada uno de los códigos se crea un bloque <AudienceRange> en la ficha ONIX.
Si un determinado producto es de aplicación en más de una Comunidad Autónoma, se incluirán todos los códigos de las CC.AA correspondientes seguidos, sin ningún separador.
Si figuran tanto este campo como alguno de los campos tipo_enseñanza, nivel, ciclo, curso o com_autonom, el campo TNCC tendrá prioridad sobre los demás, ignorándose el valor de los anteriores aunque el valor contenido en el campo sea incorrecto.
Si el valor de este campo es inválido (bien porque sea erróneo el código combinado TNCC, bien porque sea incorrecto el código de Comunidad Autónoma), se genera un aviso y no se crea el bloque <AudienceRange> correspondiente.
Si el valor de este campo es válido pero no tiene indicación de Comunidad Autónoma, se genera un error y no se crea el bloque <AudienceRange> correspondiente.
Tabla Código combinado TNCC: Tipo_enseñanza + Nivel + Ciclo + Curso
Especifica el código de la asignatura. Solo puede utilizarse para libro de texto.
Formato
Debe ser un código de la lista de asignaturas que figura más adelante.
Si la asignatura no figura en la tabla, se puede solicitar su inclusión a través de un correo electrónico a sugerencias@dilve.es, o incluir aquí el código 1999000 y su descripción en el campo siguiente. Esta última práctica, sin embargo, podría dificultar las búsquedas de libro por la asignatura.
Este bloque de campos permite incluir datos de premios o certámenes en los que haya participado la obra correspondiente. Se puede indicar el nombre del premio, el año y lugar de celebración, la posición alcanzada por la obra (ganadora, finalista, selccionada...) así como la composición del jurado.
Mediante campos CSV solo es posible indicar un premio. En ONIX no existe esta limiación.
Indica el nombre del premio, concurso o certamen a que se refiere este conjunto de campos. P.Ej.: "Premio Internacional de Ensayo y Narrativa", "Certamen Nacional de Poesía Amantes de Teruel", etc.
Formato
Texto libre.
El texto debe ir entre comillas ("). Este carácter no puede formar parte del texto. Si se utiliza Excel, las comillas se añadirán automáticamente al crear el archivo CSV.
Campo ONIX
/Prize/PrizeName(=valor)
Comentarios
La aplicación no realiza ninguna comprobación o modificación sobre el contenido de este campo.
Este bloque de campos permite incluir los datos de los libros digitales. La distinción entre productos digitales y no digitales se hace mediante los campos formato_libro o formato_libro_3.0 (ProductForm). Para el caso de libros digitales accesibles en línea se utiliza el valor DH (de la lista 7 de ONIX) para el campo formato_libro y el valor EC (de la lista 150 de ONIX) para el campo formato_libro_3.0; y para los libros digitales externos en formato propietario o estándar el código DG (de la lista 7 de ONIX) para el campo formato_libro y el código ED (de la lista 150 de ONIX) para el campo formato_libro_3.0.
Opcional. Solo se puede utilizar para libros en formato digital, de los cuales exista una o varias versiones impresas.
Nombre
isbn13_edición_impresa, isbn13_edicion_impresa
Función
En el caso de ediciones en formato digital de obras que existan en versiones impresas, permite identificarlas.
Formato
13 dígitos. Puede incluir guiones.
Campo ONIX
/RelatedProduct/ProductRelationCode(=13)/ProductIdentifier/ProductIDType(=03) - IDValue(=valor pasado a ISBN13)
Comentarios
Se pueden incluir varios ISBN, separados por punto y coma.
Solo debe utilizarse si el registro describe a una obra en formato digital si existe una o varias versiones impresas de la misma.
Se admiten guiones y blancos, aunque se eliminan al guardar el campo sin comprobar si su ubicación es correcta. Internamente, siempre se guarda el ISBN13.
Si el campo está vacío y ya existe un bloque RelatedProduct con ProductRelationCode=13, se elimina este bloque RelatedProduct.
En el caso de una edición en formato digital basada en una obra impresa, permite tener una idea de la extensión de la obra mediante el número de páginas de la versión impresa.
Efectivamente, el número de páginas de la versión digital será variable ya que puede depender del entorno de lectura, del tamaño de letra elegido, etc.
Solo debe utilizarse si el registro describe a una obra en formato digital basada en una obra impresa.
URL para descarga directa de publicación electrónica
Tipo
Opcional. En general, solo se usará para publicaciones en formato electrónico.
Nombre
URL_descarga_producto
Función
Indica el URL (Uniform Resource Locator - Localizador Uniforme de Recursos) de descarga de una publicación en formato electrónico.
Debe apuntar directamente a la ubicación del producto, no a una página web desde la que se pueda acceder a la descarga. En este segundo caso, debe utilizarse el campo web_descarga_producto.
Formato
Texto.
El contenido de este campo debe formar un URL correcto.
Debe comenzar por http://, https:// o ftp://, dependiendo del tipo de descarga.
El URL debe apuntar directamente al producto, p.ej.: http://www.editorial.com/descargas/9781234567890_L38_01_01.pdf
Este campo no debe utilizarse para referenciar una página web, a partir de la cual, mediante un enlace, se acceda al URL de descarga. En estos casos debe utilizarse el campo web_descarga_producto.
Si el texto no empieza por https:// o http:// o ftp://, se genera un aviso y se ignora el contenido del campo. No se realiza ninguna otra comprobación.
WEB de acceso a un entorno de descarga de publicación electrónica
Tipo
Opcional. En general, solo se usará para publicaciones en formato electrónico.
Nombre
web_descarga_producto
Función
Indica el URL (Uniform Resource Locator - Localizador Uniforme de Recursos) de acceso a una página web que incluye algún tipo de enlace o acceso para la descarga de una publicación en formato electrónico.
No debe apuntar directamente a la ubicación del producto (en este caso se debe utilizar el campo URL_descarga_producto), sino a una página web desde la que se pueda acceder al entorno de descarga.
Formato
Texto.
El contenido de este campo debe formar un URL correcto.
Debe comenzar por http:// o https://
Este campo no debe utilizarse para referenciar directamente un URL de descarga del producto. En estos casos debe utilizarse el campo URL_descarga_producto.
Si el texto no empieza por https:// o http://. No se realiza ninguna otra comprobación.
Indica el URL (Uniform Resource Locator - Localizador Uniforme de Recursos) de una ubicación que implementa la funcionalidad de "hojeo" del interior de la obra. Esta puede estar limitada a una parte de la misma.
Debe apuntar directamente a la ubicación de esta funcionalidad para la obra concreta a que haga referencia el registro, no a una página web desde la que se pueda acceder a la misma.
Formato
Texto. El contenido de este campo debe formar un URL correcto.
Permite indicar la versión del formato del libro digital.
Formato
Texto libre.
En los siguientes casos es recomendable respetar la grafía para la correcta interpretación de la versión en la versión 3.1 de ONIX: EPUB 2.0.1, EPUB 3.0, EPUB 3.0.1, EPUB 3.1, EPUB 3.2, EPUB 3.3, PDF 1.3, PDF 1.4, PDF 1.6, PDF 1.7, PDF 2.0, Kindle mobi 7, Kindle KF 8 y Kindle KFX.
Existen 3 campos (restricc_uso_edicion_digital1, restricc_uso_edicion_digital2, restricc_uso_edicion_digital3) qe permiten indicar las restricciones de uso del libro digital.
Tipo
Opcional
Nombre
restricc_uso_edicion_digital1
Función
Permite indicar las restricciones de uso del libro digital.
Formato
Debe utilizarse una combinación de códigos de las tablas que figuras a continuación: Lista ONIX 145 (Tipo de uso), Lista ONIX 146 (Estaus de restricción) y Lista ONIX 147 (Unidades de uso).
Campo ONIX
/EpubUsageConstraint/EpubUsageType(=valor Lista 145) - EpubUsageStatus(=valor lista 146)- /EpubUsageLimit/Quantity=(valor numérico nn) - EpubUsageUnit(=valor listas 147)
Comentarios
Sólo se admitirá este campo si el producto tiene formato de libro digital (Campo Formato / Encuadernación =ED)
Se validará que los códigos pertenecen a la lista correspondiente y que el contenido es correcto según las siguientes especificaciones.
La cadena de descripción del detalle de restricción tiene la siguiente estructura:
v145;v146([;nn;v147]...)
Dónde:
v145 un valor de la Lista 145
v146 un valor de la Lista 146
nn valor numérico
v147 un valor de la lista 147
El bloque ";nn;v147" es opcional y repetible. Todos los valores estarán separados por punto y coma.
Por ejemplo:
Un producto que no se puede imprimir se codificaría: 02;03
Un producto que se puede imprimir hasta un 50%: 02;02;50;05
Sólo se admitirá este campo si el producto tiene formato de libro digital (Campo Formato / Encuadernación=ED, EC, EB o EA)
Cada elemento separado por | dentro de campo dará lugar a un bloque ONIX como el descrito.
Para indicar si el libro tiene DRM y su tipo, deberá incluirse un elemento que empiece por DLV-L144- seguido por un código de la lista 144 de ONIX.
Para indicar restricciones de uso deberán incluirse elementos que comiencen por DLV-L145- y el formato descrito en el campo restricc_uso_edicion_digital1.
Si llega algún elemento válido que comience por DLV-L144- sustituirá a los que hubiera de ese mismo tipo. Si llega un elemento "DLV-L144-" sin código se borrará el bloque correspondiente.
Los elementos DLV-L145- que lleguen sustituirán a los que hubiera de ese mismo tipo. Si llega un elemento DLV-L145- sin valores después se eliminarán todos los bloques de restricciones de uso.
Si no llega ningún elemento que comience por "DLV-L144-" no se modificará la información de DRM .
Si no llega ninguno que comience por "DLV-L145-" se mantendrá la información que hubiera sobre restricciones de uso.
El resto de elementos sustituirán a todos los bloques ProductFormFeature, con ProductFormFeatureType=07 que tuviera el libro y cuyo campo ProductFormFeatureDescription no empiece por "DLV-L144" o "DLV-L145" (si las comillas).
Si el campo llega vacío se eliminarán todos los bloques ProductFormFeature con ProductFormFeatureType=07.
Si el ISBN13 referenciado no existe en DILVE, se genera un aviso.
Se utiliza para indicar una duración en horas y minutos.
Formato
Numérico, sin decimales.
Debe responder al formato HHHMM por lo que los dos últimos dígitos deben ser menores de 60.
Si tiene menos de cinco dígitos, se completa con ceros por la izquierda.
Permite cargar información sobre las algunas características del formato del producto (accesibilidad de productos digitales e información para el cumplimiento del reglamento de la UE sobre Productos Libres de Deforestación (EUDR))
Formato
Puede contener uno o más registros con el siguiente formato de campos, separados por punto y coma: tipo;codigo;texto donde:
"tipo" debe ser alguno de los valores permitidos de la lista 79 de códigos ONIX Ver los valores permitidos en la siguiente tabla. El valor 13 se gestiona en el campo CSV aviso_riesgo_seguridad. Obligatorio en cada bloque.
"codigo" debe ser un valor de la lista ONIX que corresponda según el valor de "tipo" (ver tabla). Opcional.
"texto" es un texto descriptivo que debe incluirse si es necesario para complementar la información del código. Opcional.
Puede contener tantos registros, separados por la barra vertical (|), como sean necesarios.
Si la estructura del campo es errónea o el contenido de alguno de los registros es erróneo, se ignora el campo completo.
El contenido del campo sustituye a todos los bloques de características de formato de producto de alguno de los tipos admitidos en el campo.
Si el campo llega vacío se eliminan todos los bloques de características de formato de producto de alguno de los tipos admitidos en el campo.
Valores de lista 79 permitidos en caracteristicas_formato_producto
Relación de los valores de la Lista ONIX 79, oficialmente permitidos en DILVE para el campo CSV caracteristicas_formato_producto, a junio de 2025. Para algunos valores de «tipo», el valor del campo «codigo», debe ser un código de la Lista ONIX cuyo número figura en la última columna de la tabla. Esta lista se irá ampliando en el futuro, a medida que se añadan nuevas funcionalidades al campo CSV caracteristicas_formato_producto. Consulte con el servicio de Asistencia DILVE si tiene alguna necesidad específica.
Tipo
Descripción
Notas
Lista ONIX Códigos
03
Fuente del texto
Fuente tipográfica principal utilizada para el cuerpo del texto cuando constituye una parte importante de la descripción del producto, por ejemplo, en algunas Biblias o en libros con letra grande. El valor de <ProductFormFeatureDescription> debe ser un texto que especifique el nombre de la fuente. El tamaño se puede indicar junto con el nombre, pero es preferible que se especifique por separado (en puntos) en el campo <ProductFormFeatureValue>.
-
09
Detalle de accesibilidad para publicación digital
Ver lista 196 para los códigos permitidos en <ProductFormFeatureValue>.
Utilizado en EE.UU. por exigencia de la CPSIA (Consumer Product Safety Improvement Act) u otra legislación estadounidense. Exigido, cuando sea de aplicación, para productos comercializados en los EE.UU. El valor de <ProductFormFeatureValue> se debe tomar de la Lista 143. Se puede añadir una explicación en <ProductFormFeatureDescription>. En general se utiliza para libros infantiles que puedan incluir algún objeto o juguete susceptible de provocar asfixia u otros daños en niños pequeños.
Código de versión de formato para publicación digital
Utilizar para publicaciones digitales en las que la versión del formato sea relevante, por ejemplo, EPUB 2.0.1 o EPUB 3.0. El valor de <ProductFormFeature> se debe tomar de la Lista 220. Usar solo con ONIX 3.0 o posterior.
"texto" es un texto descriptivo que debe incluirse si es necesario para complementar la información del código. Opcional.
Puede contener tantos registros, separados por punto y coma (;), como sean necesarios.