ONIX for Books es el estándar de metadatos en XML que mantiene EDItEUR, el organismo internacional que rige las normas del comercio del libro. Es el formato que esperan tiendas, mayoristas, agregadores y bibliotecas cuando reciben la información de un título: identificadores, títulos, contribuidores, descripciones, materias, precios y disponibilidad viajan en un único mensaje estructurado.
Esta guía recorre la forma de un registro ONIX 3 y los errores que hacen que rechacen un feed, con un lenguaje pensado para editores más que para ingenieros. Y si prefieres no escribir XML, Origami puede construir el registro por ti a partir del EPUB que ya tienes.
Qué es ONIX for Books, y por qué la versión 3
ONIX es el idioma común de la cadena de suministro del libro: en lugar de rellenar a mano la ficha de cada tienda, envías un registro estructurado y cada sistema lo lee igual. Lo mantiene EDItEUR, junto con las listas de códigos que dan a cada campo un conjunto controlado de valores.
La versión vigente es ONIX 3.0 (con la revisión compatible 3.1). La antigua ONIX 2.1 dejó de mantenerse a finales de 2014, y muchos socios comerciales ya rechazan o ignoran los feeds en 2.1. Si un sistema todavía exporta 2.1, considéralo deuda técnica que hay que retirar, no una configuración válida.
Los bloques de un registro ONIX
Un registro de producto en ONIX 3 se organiza en bloques. No necesitas memorizar los nombres de las etiquetas, pero saber qué vive en cada sitio ayuda a detectar huecos.
Primero, los identificadores. Cada edición comercial necesita su propio ISBN-13 (que también se expresa como GTIN-13) y un código de product form que indica si es un EPUB, un libro en rústica o un audiolibro. Un formato distinto es un producto distinto: el EPUB y la edición impresa llevan ISBN diferentes.
El bloque descriptivo recoge el título (en TitleDetail, que separa el título propio del subtítulo), los contribuidores, el idioma y el extent (número de páginas o duración). Cada Contributor se etiqueta con un rol de la List 17 de EDItEUR — por ejemplo A01 para autor, B06 para traductor o A12 para ilustrador — para que la tienda muestre a cada persona correctamente.
Los textos de marketing van en el bloque CollateralDetail: la descripción principal, los reclamos cortos, las citas de reseñas y las imágenes de cubierta. Es el texto que se convierte en la página de producto, así que vende de verdad, no solo cumple.
Por último, las condiciones comerciales están en ProductSupply: disponibilidad, proveedor y el Price dentro de SupplyDetail, con su importe, su moneda y su tratamiento fiscal. Un precio sin moneda, o con la moneda equivocada, es una de las formas más rápidas de que rechacen tu feed.
Materias, público y descubribilidad
Los códigos de materia deciden en qué estante acaba tu libro y cómo aparece en las búsquedas. ONIX permite adjuntar varios esquemas a la vez. En Norteamérica domina BISAC; el sustituto global y multilingüe de los antiguos esquemas nacionales es Thema, también de EDItEUR. La buena práctica es enviar ambos, cada uno identificado con su código de esquema para que el sistema receptor sepa cómo leerlo.
Junto a las materias, un código de audiencia señala el público al que se dirige la obra: general, profesional o un rango de edad concreto para títulos infantiles. Acertar aquí mantiene una novela juvenil fuera del catálogo equivocado y ayuda a la clasificación por edades y a la curaduría.
Metadatos de accesibilidad y la EAA
Desde que la European Accessibility Act (Ley Europea de Accesibilidad) entró en vigor en junio de 2025, la información de accesibilidad dejó de ser opcional para los libros electrónicos vendidos en la UE. ONIX 3 la expresa mediante entradas ProductFormFeature que declaran funciones como el índice navegable, las imágenes descritas, el orden lógico de lectura y cualquier limitación conocida.
Estos campos permiten a las tiendas mostrar una declaración de accesibilidad conforme en la página de producto. Si tu EPUB es accesible pero tu registro ONIX no lo menciona, ni los lectores ni las tiendas pueden saberlo: los metadatos tienen que decir en voz alta lo que el archivo ya hace.
Errores frecuentes de ONIX que conviene evitar
Unos pocos errores explican la mayoría de los feeds rechazados. Seguir enviando ONIX 2.1 en lugar de 3.0. Códigos de materia ausentes o sin cualificar, de modo que el libro no tiene BISAC ni Thema. El rol de contribuidor equivocado, como etiquetar a un traductor como autor. Problemas de precio y moneda: una moneda que falta o una regla fiscal que no encaja con el mercado.
El último gran hueco es la accesibilidad: un EPUB 3 que cumple el estándar pero cuyo registro ONIX no lleva datos de ProductFormFeature. Cada uno de estos fallos es barato de corregir en el origen y caro de perseguir una vez que un distribuidor devuelve el archivo.