O ONIX for Books é o padrão de metadados em XML que a EDItEUR mantém, o organismo internacional que rege as normas do comércio do livro. É o formato que lojas, atacadistas, agregadores e bibliotecas esperam quando recebem a informação de um título: identificadores, títulos, contribuidores, descrições, assuntos, preços e disponibilidade viajam em uma única mensagem estruturada.
Este guia percorre a forma de um registro ONIX 3 e os erros que fazem um feed ser rejeitado, com uma linguagem pensada para editores mais que para engenheiros. E se você prefere não escrever XML, a Origami pode construir o registro por você a partir do EPUB que você já tem.
O que é o ONIX for Books, e por que a versão 3
O ONIX é o idioma comum da cadeia de suprimentos do livro: em vez de preencher à mão a ficha de cada loja, você envia um registro estruturado e cada sistema o lê igual. Ele é mantido pela EDItEUR, junto com as listas de códigos que dão a cada campo um conjunto controlado de valores.
A versão vigente é o ONIX 3.0 (com a revisão compatível 3.1). O antigo ONIX 2.1 deixou de ser mantido no fim de 2014, e muitos parceiros comerciais já rejeitam ou ignoram os feeds em 2.1. Se um sistema ainda exporta 2.1, considere isso dívida técnica a ser aposentada, não uma configuração válida.
Os blocos de um registro ONIX
Um registro de produto em ONIX 3 organiza-se em blocos. Você não precisa memorizar os nomes das tags, mas saber o que vive em cada lugar ajuda a detectar lacunas.
Primeiro, os identificadores. Cada edição comercial precisa de seu próprio ISBN-13 (que também se expressa como GTIN-13) e de um código de product form que indica se é um EPUB, um livro em brochura ou um audiolivro. Um formato distinto é um produto distinto: o EPUB e a edição impressa levam ISBN diferentes.
O bloco descritivo reúne o título (em TitleDetail, que separa o título propriamente dito do subtítulo), os contribuidores, o idioma e o extent (número de páginas ou duração). Cada Contributor é etiquetado com um papel da List 17 da EDItEUR — por exemplo A01 para autor, B06 para tradutor ou A12 para ilustrador — para que a loja mostre cada pessoa corretamente.
Os textos de marketing vão no bloco CollateralDetail: a descrição principal, os chamados curtos, as citações de resenhas e as imagens de capa. É o texto que se converte na página de produto, então venda de verdade, não apenas cumpra.
Por fim, as condições comerciais estão em ProductSupply: disponibilidade, fornecedor e o Price dentro de SupplyDetail, com seu valor, sua moeda e seu tratamento fiscal. Um preço sem moeda, ou com a moeda errada, é uma das formas mais rápidas de ter seu feed rejeitado.
Assuntos, público e descobribilidade
Os códigos de assunto decidem em que prateleira seu livro acaba e como ele aparece nas buscas. O ONIX permite anexar vários esquemas ao mesmo tempo. Na América do Norte domina o BISAC; o substituto global e multilíngue dos antigos esquemas nacionais é o Thema, também da EDItEUR. A boa prática é enviar ambos, cada um identificado com seu código de esquema para que o sistema receptor saiba como lê-lo.
Junto aos assuntos, um código de público sinaliza a quem a obra se dirige: geral, profissional ou uma faixa etária concreta para títulos infantis. Acertar aqui mantém um romance juvenil fora do catálogo errado e ajuda na classificação por idades e na curadoria.
Metadados de acessibilidade e a EAA
Desde que a European Accessibility Act (Lei Europeia de Acessibilidade) entrou em vigor em junho de 2025, a informação de acessibilidade deixou de ser opcional para os livros eletrônicos vendidos na UE. O ONIX 3 a expressa por meio de entradas ProductFormFeature que declaram funções como o sumário navegável, as imagens descritas, a ordem lógica de leitura e qualquer limitação conhecida.
Esses campos permitem às lojas exibir uma declaração de acessibilidade conforme na página de produto. Se seu EPUB é acessível mas seu registro ONIX não o menciona, nem os leitores nem as lojas podem saber: os metadados têm de dizer em voz alta o que o arquivo já faz.
Erros frequentes de ONIX que convém evitar
Poucos erros explicam a maioria dos feeds rejeitados. Continuar enviando ONIX 2.1 em vez de 3.0. Códigos de assunto ausentes ou sem qualificar, de modo que o livro não tem BISAC nem Thema. O papel de contribuidor errado, como etiquetar um tradutor como autor. Problemas de preço e moeda: uma moeda que falta ou uma regra fiscal que não encaixa no mercado.
A última grande lacuna é a acessibilidade: um EPUB 3 que cumpre o padrão mas cujo registro ONIX não leva dados de ProductFormFeature. Cada uma dessas falhas é barata de corrigir na origem e cara de perseguir depois que um distribuidor devolve o arquivo.