Pasarela DILVE→Libranda
En esta sección se describen con detalle las tareas de preparación y carga de metadatos en DILVE, su envío a Libranda y el posterior seguimiento del proceso.
El uso de la pasarela DILVE → Libranda evita tener que usar otros procedimientos de envío de datos, aprovechando las ventajas DILVE (solicitud ISBN integrada, disponibilidad para otros consumidores de información, etc.).
Alta en la pasarela
La editorial deberá solicitar a Libranda el alta en la pasarela desde DILVE y una vez gestionada, ponerse en contacto con el servicio de Asistencia de DILVE para activar los permisos.
Proceso general de la pasarela DILVE→ Libranda
Este proceso completo consta de dos tipos de envíos: por un lado los metadatos enviados desde DILVE y por otro el envío del archivo eBook (ePub / PDF) con el contenido del libro mediante los medios establecidos a tal efecto por Libranda y ajenos a DILVE.
Como se explica con detalle más adelante, los usuarios DILVE pueden realizar el seguimiento de este proceso mediante la sección Libranda > Gestión a la que podrán acceder los usuarios autorizados. También es posible automatizar los envíos de metadatos a Libranda y recibir el resultado de los envíos y las respuestas mediante correo electrónico, sin necesidad de acceder a la pasarela manualmente.
Carga de metadatos en DILVE
Cargas automáticas. Si su editorial carga de forma automática los datos en DILVE deberá comprobar, y ampliar si es necesario, el repertorio de campos obligatorios y opcionales para Libranda.
Carga mediante CSV. Si sus sistemas automatizados no cubren el repertorio de campos requeridos o hace las cargas de forma manual, se recomienda la preparación de uno o varios archivos con los datos completos (o parte de ellos, si ya dispone de algunos en DILVE) de todos los libros para su carga mediante CSV. Para ello dispone del una plantilla con todos los campos necesarios.
Plantilla de metadatos para LibrandaXLSNo todos los campos requeridos para Libranda están disponibles en el formulario, pero sí son únicamente accesibles mediante archivos CSV y ONIX. Para saber más sobre cómo preparar y cargar el archivo CSV consulte la sección ¿Cómo preparar y cargar un archivo CSV en DILVE?.
Descripción de campos
Campos CSV
A continuación se indican los campos obligatorios y opcionales para Libranda. Para saber más detalle sobre los campos su formato, etc. consulte el manual de campos CSV:
- isbn13. Obligatorio. Con o sin guiones
- referencia_editorial. Código interno de identificación del producto en la editorial.
- titulo. Obligatorio. Debe figurar tal y como aparece en el libro.
- subtitulo. Obligatorio si existe. Debe figurar tal y como aparece en el libro.
- formato_libro_3.0. Obligatorio. Para libros digitales deberá enviarse el valor EB o ED y para los audiolibros el valor AJ seguido de los valores del formato interno (E101 para EPUB o E107 para PDF).
- peso_archivo_edicion_digital. Indicar el tamaño del archivo. Ejemplo: 5,43 MB o 5430 KB.
- drm_edicion_digital. Obligatorio. Tipos de protección del libro digital.
- autor. Obligatorio. Apellidos, Nombre (en todas las palabras, obligatorio, primera letra en mayúscula y resto en minúscula). Si hay varios autores, se separan cada uno de ellos con punto y coma.
- nota_biografica_autor1, nota_biografica_autor2, nota_biografica_autor3. Notas biográficas de los tres primeros autores.
- web_autor1, web_autor2, web_autor3.** Sitios web de los tres primeros autores, si existen.
- ilustrador, ilustrador_cubierta, autor_prologo, autor_notas, editor_literario. Apellidos, Nombre (en todas las palabras, obligatorio, primera letra en mayúscula y resto en minúscula). Si hay varios, se separan cada uno de ellos con punto y coma.\
- otras_menciones1, otras_menciones2, otras_menciones3. En estos campos podrán enviarse hasta tres menciones de responsabilidad (una en cada campo) que no tengan un campo específico.
- coleccion. Nombre de la colección. Primera letra en mayúsculas y resto en minúsculas.
- codigo_coleccion. Código interno de la colección en la editorial, si existe. Solo debe enviarse si se manda el campo colección.
- num_en_coleccion. Número del libro en la colección. Se recomienda que sea un valor numérico, aunque se admite texto libre. Solo debe enviarse si se manda el campo colección.
- sello. Nombre del sello editorial.
- idioma. Obligatorio. Idioma de publicación del libro. Se debe indicar un código de idioma ONIX. Podrán incluirse todos los códigos que sean necesarios separándolos por ";" en el caso de ediciones en varios idiomas.
- codigo_thema_materia. Obligatorio. Especifica, en el sistema de clasificación Thema. Podrán incluirse todos los códigos que sean necesario separándolos por ";"]. V
- titular_promocional. Texto corto, titular o frase breve. La información debe cargarse en texto plano.
- idioma_titular_promocional. Código del idioma en que está el titular promocional, solo se admite un valor.
- texto_resumen. Breve resumen o descripción del libro. La información debe cargarse en texto plano.
- idioma_resumen. Código del idioma en que está el resumen, solo se admite un valor.
- imagen_cubierta. Debe indicarse mediante un enlace. La URL debe enlazar directamente al archivo jpg de la imagen y no a una ficha genérica del libro.
- url_hojeo_producto. Si existe un "widget" de hojeo del producto.
- premio_nombre. Si el libro ha recibido un premio, o ha sido finalista, seleccionado, etc. en algún concurso o certamen, se indicará el nombre correspondiente en este campo.
- premio_año. Año del premio, valor numérico de cuatro cifras (AAAA). Solo debe enviarse si se manda el campo premio_nombre.
- premio_pais. País del premio codificado según ONIX (España = ES). Solo debe enviarse si se manda algo en el campo premio_nombre.
- premio_posicion. Posición alcanzada en el premio (Ganador = 01; Finalista = 02)
- premio_jurado. Composición del jurado del premio.
- editorial. Solo para cargas de datos con usuario de grupo editorial.
- fecha_public. Obligatorio. Campo fecha con el formato AAAAMMDD.
- isbn13_edicion_impresa. Obligatorio cuando se trata de un libro digital basado en un libro impreso.
- num_pags_edicion_impresa. Número de páginas de la edición impresa si existe.
- precio_con_iva. Obligatorio. Utilizar la coma como separador de decimales.
- iva. Obligatorio. Indicar el valor sin decimales.
- precios_extranjero_restricciones. Precios para países extranjeros. Uno o varios bloques separados por | (barra).
- territorios_derecho_venta_incluidos. Obligatorio. Territorios o países (Todo el mundo = WORLD; España = ES...) en los que la editorial ha decidido ejercer sus derechos de venta y para los cuales se indican las condiciones de venta.
- situ_catalogo_editorial. Obligatorio.
- disponibilidad. Obligatorio.
- fecha_disponibilidad. Campo fecha en formato AAAAMMDD Puede ser distinta de la fecha de edición.
El campo Libranda estado del producto en ONIX 3.1 se forma a partir de combinaciones de los siguientes campos, los valores que en este momento se consideran válidos son:
- publico_objetivo. Obligatorio. Audiencia del libro.
- Libro_publico. Posibles valores: Si / No. Los libros no públicos únicamente podrá consultarlos la editorial propietaria. Los libros públicos pueden ser consultados por cualquier usuario de DILVE.
- envio_libranda. Posibles valores: Si / No. El valor Sí (o S o 0) desencadena el proceso completo de envío (Alta, comprobación eBook y Activación) de forma automática, sin necesidad de utilizar la pasarela manual (consultar).
Campos ONIX
Equivalencia en ONIX 3.1 de los campos CSV.
Para identificar los campos obligatorios y opcionales, consultar el apartado de campos CSV.
Equivalencia ONIX 3.1 de campos CSV para Libranda
| Campo CSV | Campo ONIX 3.1 |
| isbn13 | /ProductIdentifier/ProductIDType(=03) - IDValue(=valor) |
| referencia_editorial | /ProductIdentifier/ProductIDType(=01) - IDTypeName(=“referencia”) – IDValue(=valor) |
| titulo | /TitleDetail/TitleType(=01) - /TitleElement/TitleElementLevel(=01)/Ti-tleText(=valor) |
| subtitulo | /TitleDetail/TitleType(=01) - /TitleElement/TitleElementLevel(=01)/ Subtitle(=valor) |
| formato_libro_3.0 | /ProductForm(=valor) /ProductFormDetail(=valor) |
| peso_archivo_edicion_digital | Extent/ExtentType(=22)/ExtentValue(=valor)/ExtentUnit(=valor_convertido) |
| drm_edicion_digital | EpubTechnicalProtection(=valor) |
| autor | /Contributor |
nota_biografica_autor1 | /Contributor |
web_autor1 | /Contributor |
ilustrador_cubierta | /Contributor |
otras_menciones1 | /Contributor |
| colección | /Collection/CollectionType(=10) - /TitleDetail/TitleType(=01) - /TitleElement/TitleElementLevel(=02) - TitleText(=valor) |
| codigo_coleccion | /Collection/CollectionType(=10) - /TitleDetail/TitleType(=01) - /TitleElement/TitleElementLevel(=02) - TitleText(=valor) |
| num_en_coleccion | /Collection/CollectionType(=10) - /TitleDetail/TitleType(=01) - /TitleElement/TitleElementLevel(=01) - PartNumber(=valor) |
| sello | /Imprint/ImprintName (=valor) |
| idioma | /Language |
| codigo_thema_materia | /Subject /SubjectSchemeIdentifier(=93) -- SubjectSchemeVersion(=1.6) -- SubjectCode(=valor_codigo_materia) /Subject /SubjectSchemeIdentifier(=99) -- SubjectSchemeVersion(=1.6) -- SubjectCode(=valor_calif_estilo) |
| titular_promocional | /TextContent/TextType(=10) - ContentAudience(=00) - Text(=valor) |
| idioma_titular_promocional | /TextContent/TextType(=10) - ContentAudience(=00) - <Text language="valor"> |
| texto_resumen | /TextContent/TextType(=03) - ContentAudience(=00) - Text(=valor) |
| idioma_resumen | /TextContent/TextType(=03) - ContentAudience(=00) - <Text language="valor"> |
| imagen_cubierta | /SupportingResource/ResourceContentType(=01) - ContentAudience(=00) - ResourceMode(=03) - /ResourceVersion/ResourceForm(=02) - ResourceLink(=valor) |
| url_hojeo_producto | /SupportingResource/ResourceContentType(=16) - ContentAudience(=00) - ResourceMode(=01) - /ResourceVersion/ResourceForm(=02) - ResourceLink(=valor) |
| premio_nombre | /Prize /PrizeName(=valor) |
| premio_año | /Prize /PrizeYear(=valor) |
| premio_pais | /Prize /PrizeCountry(=valor) |
| premio_posicion | /Prize /PrizeCode(=valor) |
| premio_jurado | /Prize /PrizeJury(=valor) |
| editorial | /Publisher /PublisherName (=valor) |
| fecha_public | /PublishingDetail/PublishingDate/PublishingDateRole(=01) - Date(=valor) |
| isbn13_edicion_impresa | /RelatedProduct |
| num_pags_edicion_impresa | /Extent /ExtentType(=08) /ExtentValue (=valor) /ExtentUnit(=03) |
precio_sin_iva | /ProductSupply/Market/Territory/CountriesIncluded(=ES) - MarketPublishingDetail |
| precios_extranjero_restricciones | /ProductSupply/Market/Territory/CountriesIncluded(=países en países_territorios) - RegionsIncluded (territorios en países_territorios) - MarketPublishingDetail/MarketPublishingStatus(=valor_convertido_disponibilidad) |
| territorios_derecho_venta_incluidos | /SalesRights/SalesRightsType(=01) - |
| situ_catalogo_editorial | /PublishingStatus(=valor) |
| disponibilidad | Market/Territory/CountriesIncluded(=ES) - MarketPublishingDetail/MarketPublishingStatus(=valor_convertido) - SupplyDetail/ProductAvailability(=valor) |
| fecha_disponibilidad | /SupplyDate/SupplyDateRole(=08) - Date(=valor) |
| publico_objetivo | /AudienceCode (=valor) |
| envio_libranda | ProductIdentifier/ProductIDType(=01) - IDTypeName(=ENVIO-LIBRANDA) - IDValue(=AUTO) |
Pasarela DILVE → Libranda
Los usuarios autorizados para el envío de datos a Libranda disponen de la correspondiente sección en el menú de DILVE.
Si no ve este menú, comunique a servicio de asistencia de DILVE cuál de sus usuarios DILVE hará los envíos a Libranda para habilitarle los privilegios.
En esta sección:
- Se valida el contenido de los campos obligatorios
- Se realiza el envío de datos al servidor de Libranda
- Se reciben las respuestas de Libranda a los envíos de metadatos (DILVE).
Existe la posibilidad de automatizar los envíos de metadatos a Libranda (ver apartado Automatización de envíos).
Libranda > Envíos
Validación
Para que aparezcan libros en la esta sección es necesario marcarlos en algún listado de DILVE para incluirlos en la selección actual. Para conocer en detalle la funcionalidad de las selecciones de libros, consulte la sección: Selecciones.
Con los libros en la selección actual, se procederá a la validación de cada ficha. Se recomienda hacer las primeras validaciones sobre uno o dos títulos hasta conseguir el resultado correcto.
Existe la posibilidad de validar los datos de los libros individualmente, utilizando el botón Validar de cada libro del listado o validar todos mediante la opción Otras acciones > Validar todos.
El detalle de los errores de validación se muestra en el informe al que se acceder haciendo clic en el enlace Ver informe del libro correspondiente:
Deberán corregirse los errores del informe hasta obtener un resultado OK. Cuando los metadatos pasan la validación correctamente, debe realizarse el envío a Libranda. Al igual que en el caso de la validación, se puede realizar el envío de forma individual (botón **Enviar**del listado) o enviar todos los libros del listado (de la selección actual) que pasen la validación, utilizando la opción Otras acciones > Enviar todo.
Los códigos de error que pueden aparecer en el informe de validación son los siguientes:
- A El libro debe tener al menos una autoría con nombre de persona o entidad.
- D La fecha de publicación no es correcta o no está en un formato adecuado (YYYYMM o YYYYMMDD).
- E El producto debe tener formato de e-book descargable (ProductForm=ED o EB) o de audiolibro descargable (ProductForm=AJ).
- F La información sobre el formato interno del libro no es correcta o es insuficiente.
- L Debe indicar el idioma de publicación (/language/LanguageRole=01).
- I ISBN erróneo.
- P El bloque precio es incorrecto o no existe.
- R Es obligatorio indicar país o territorio en los que se permite la venta (SalesRights/SalesRightsType=01).
- V Los valores de situación en el catálogo (PublishingStatus) y disponibilidad (ProductAvailability) no son válidos.
- M Debe indicar la moneda de todos los precios.
Además del primer envío de los metadatos para dar de alta el libro en Libranda, es importante reenviar los metadatos cada vez que se realice una modificación en los campos que se procesan en Libranda. Especialmente los relacionados con el precio y el estado de disponibilidad.
Libranda > Gestión
En este listado se muestran todos los ISBN que hayan sido enviados a Libranda y el resultado del último envío.
Al acceder al listado, se consulta el servidor de Libranda para actualizar el estado de los envíos, por lo que es posible que puntualmente tarde un tiempo en mostrarse la información.
Los posibles estados de los envíos son:
- Enviado. Los metadatos se han enviado correctamente a Libranda y están pendientes de respuesta.
- Datos Error. Libranda ha detectado algún error en los metadatos enviados, solicite más información a Asistencia DILVE.
- Completo. Libranda ha aceptado los metadatos.
Automatización de envíos
Es posible automatizar el envío de metadatos a Libranda prescindiendo del interfaz manual descrito anteriormente.
Para el uso de este dispositivo es necesario:
- Solicitar a Asistencia DILVE el uso automatizado proporcionando un correo electrónico para la recepción del log de resultados.
- Completar el campo envio_libranda para cada libro que debe enviarse a Libranda. Este campo debe cargarse mediante archivos de carta (ONIX o CSV).
El envío se ejecuta periódicamente y se realizan dos acciones: 1.- Comprobación de la respuesta de Libranda a envíos anteriores 2.- Envío de metadatos de altas o modificaciones de libros con la marca de envío automático a Libranda.
Con el resultado de estas dos acciones, se envía un log al correo electrónico indicado en el que se muestra el resultado de cada envío y la respuesta de Libranda a los envíos anteriores.
Anexo 1. Ejemplo Product ONIX 3.1 varios mercados
Siguiendo las indicaciones del estándar ONIX 3.1, la forma que DILVE recomienda para reflejar en un <Product> varios precios de aplicación en distintos mercados, es la utilización de un bloque <SupplyDetail> para cada grupo de países/territorios que comportan precio, moneda y disponibilidad. Indicando los países y territorios en los campos <SupplyToCountry>, <SupplyToTerritory> y <SupplyToCountryExcluded>^.
Cada editorial tiene especificaciones concretas de Libranda sobre los precios que debe informar y que son de aplicación en otros mercados. A continuación se muestra un ejemplo concreto que no necesariamente es de aplicación para todas las editoriales.
Por ejemplo, un producto de venta en:
- España (ES), disponible.
- En Argentina disponible a partir del 1 de noviembre y con especificaciones de Libranda de que debe informarse el precio agency neto en dólares americanos y en pesos argentinos.
Se representará con dos bloques SupplyDetail:
- Uno para España con ProductAvailability=20 (disponible) con bloques de precio con IVA (PriceTypeCode=04) indicando explícitamente el valor del IVA.
- Un SupplyDetail para Argentina con ProductAvailability=10 (no disponible todavía) e indicando en ExpectedShipDate la fecha prevista en la que estará disponible y dos bloques de precio uno para cada moneda..
Por tanto los valores en ONIX quedarán como sigue:
Ejemplo ONIX 3.1
<ProductSupply>
<Market>
<Territory>
<CountriesIncluded>ES</CountriesIncluded>
</Territory>
</Market>
<MarketPublishingDetail>
<MarketPublishingStatus>04</MarketPublishingStatus>
<MarketDate>
<MarketDateRole>01</MarketDateRole>
<Date dateformat="00">20120910</Date>
</MarketDate>
</MarketPublishingDetail>
<SupplyDetail>
<Supplier>
<SupplierRole>00</SupplierRole>
<SupplierName>Siruela</SupplierName>
</Supplier>
<ProductAvailability>20</ProductAvailability>
<SupplyDate>
<SupplyDateRole>08</SupplyDateRole>
<Date dateformat="00">20120910</Date>
</SupplyDate>
<Price>
<PriceType>04</PriceType>
<PriceAmount>11.99</PriceAmount>
<Tax>
<TaxType>01</TaxType>
<TaxRateCode>S</TaxRateCode>
<TaxRatePercent>21.0</TaxRatePercent>
<TaxableAmount>9.9100</TaxableAmount>
</Tax>
<CurrencyCode>EUR</CurrencyCode>
</Price>
</SupplyDetail>
</ProductSupply>
<ProductSupply>
<Market>
<Territory>
<CountriesIncluded>AR</CountriesIncluded>
</Territory>
</Market>
<MarketPublishingDetail>
<MarketPublishingStatus>04</MarketPublishingStatus>
<MarketDate>
<MarketDateRole>01</MarketDateRole>
<Date dateformat="00">20180404</Date>
</MarketDate>
</MarketPublishingDetail>
<SupplyDetail>
<Supplier>
<SupplierRole>00</SupplierRole>
<SupplierName>Siruela</SupplierName>
</Supplier>
<ProductAvailability>20</ProductAvailability>
<SupplyDate>
<SupplyDateRole>08</SupplyDateRole>
<Date dateformat="00">20180404</Date>
</SupplyDate>
<Price>
<PriceType>41</PriceType>
<PriceAmount>170.00</PriceAmount>
<CurrencyCode>ARS</CurrencyCode>
</Price>
</SupplyDetail>
</ProductSupply>
Es recomendable consultar la documentación de ONIX 3.1 y contactar con el servicio de asistencia de DILVE para cualquier consulta.
Anexo 2. Plantilla para precios_extranjero_restricciones
Cada editorial, una vez consultados con Libranda los tipos de precios y territorios que necesita, deberá ponerse en contacto con el servicio de asistencia de DILVE para solicitar la plantilla de carga de precios extranjeros personalizada.
Deberá cumplimentar, en la hoja Precios_Extranjero, para cada ISBN los bloques de cada país/región en los que el libro esté a la venta.
Debe cumplimentar para cada país los 3 campos:
- precio (en su moneda correspondiente)
- disponibilidad (código ONIX). Ver posibles valores en la hoja Disponibilidad. Si lo deja en blanco, se asume '20' (=Disponible)
- fecha disponibilidad. Campo fecha en formato AAAAMMDD Puede ser distinta de la fecha de edición. Ejemplo: 20070610.
Cuando haya completado los datos deberá:
- Pulsar el botón 'Generar datos carga DILVE' en la hoja de Instrucciones.
- IMPORTANTE: Guardar el archivo completo en Excel (.xlsx), y conservarlo como archivo maestro para futuros cambios.
- Exportar la hoja 'Carga_Dilve' en formato CSV
- Cargar en DILVE la hoja 'Carga_Dilve' exportada a CSV.
Después de hacer la carga, conviene revisar las fichas en DILVE de los libros para verificar que el resultado es correcto.