Documentação

Importar títulos e produtos

Importe ou atualize produtos em massa com ISBNs, metadados e detalhes de publicação via upload de CSV.

Esta página guiará você pelos passos para importar seus títulos, seja importando novos produtos ou importando atualizações para produtos existentes.

Se você deseja adicionar apenas um ou dois novos títulos, você pode preferir fazer isso através da interface do usuário. No entanto, se você está procurando importar títulos e dados em massa, você está no lugar certo.

Observe que produtos são edições específicas de um título. Por exemplo, um título pode ser chamado “Meu Livro” e pode ter múltiplos formatos: brochura, capa dura, e-book e audiolivro. Cada uma dessas edições/formatos é conhecida no Royalties HQ como um produto, e cada um terá seu próprio ID de produto (por exemplo, ISBN).

Produtos podem ser importados em massa usando o recurso de upload de CSV. Um modelo está disponível para download na página Titulares de Direitos > Importar.

Baixe o modelo de importação de títulos

  1. Vá para o menu principal, canto superior esquerdo, e clique em Títulos, depois Produtos.
  2. Na página de listagem de Produtos, clique no botão Importar.
  3. Em ‘O que você está enviando?’, escolha ‘Produtos’.
  4. Abaixo disso, clique em ‘Baixar arquivo modelo de Produtos’.
  5. O arquivo modelo CSV será baixado para o seu dispositivo.

Formate seus dados de títulos

  1. Abra o modelo de importação CSV de Produtos baixado no passo anterior (veja acima) – recomendamos usar o Google Sheets.
  2. Cada linha é um produto (no Royalties HQ, um título é o ‘pai’ e pode ter múltiplos formatos – chamamos estes de produtos).
  3. Cada produto deve ter pelo menos um ID de produto como ISBN, ASIN, ou outro ID de produto (e estes devem ser únicos).
  4. Todos os outros campos são opcionais.
  5. Quando seus dados estiverem prontos, salve como CSV. No Google Sheets, isso é Arquivo > Baixar > CSV.

Ao formatar seus dados, você deve seguir estes requisitos:

Nome da ColunaDescriçãoObrigatórioFormato/Valores
nameTítulo completo do livroSimString de texto
title-codeIdentificador único para o título (registro pai)SimAlfanumérico (por exemplo, T000047). Deve ter 7 caracteres. Um será criado automaticamente se deixado em branco.
royalty-period-start-monthMês de início para cálculos de royaltiesSimUm mês escrito por extenso ou abreviado (por exemplo, “Jan” ou “Janeiro”)
royalty-period-lengthDuração do período de royaltySimmonthly, two-monthly, quarterly, six-monthly, annual
product-typeTipo de formato desta ediçãoSimsoftcover, hardcover, ebook, audiobook, wire-bound
statusStatus de publicaçãoSimactive, inactive, withdrawn
imprintNome do selo da editoraNãoString de texto
isbnISBN-13 para formatos físicosCondicional*ISBN de 13 dígitos sem hífens
asinAmazon Standard Identification NumberCondicional*Alfanumérico de 10 caracteres
number-pagesContagem de páginas para livros físicosNãoInteiro (por exemplo, 300)
legacy-units-soldUnidades vendidas historicamente antes de usar o Royalties HQNãoInteiro (por exemplo, 250)
legacy-earned-royaltiesRoyalties ganhos historicamente antes de usar o Royalties HQNãoDecimal (por exemplo, 16.95)
date-first-publishedData de publicação inicialNãoFormato AAAA-MM-DD
date-withdrawnData em que o formato foi retirado da vendaNãoFormato AAAA-MM-DD

*Pelo menos um ID de produto (ISBN, ASIN, ou outro) é obrigatório para cada produto

Outros dados

Códigos de título

  • No Royalties HQ, cada título recebe um identificador único – um código de título. Nota: um título NÃO é um ISBN.
  • Todos os formatos do mesmo livro compartilham o mesmo código de título.
  • Um código de título será gerado automaticamente quando você criar um novo título – seja através da interface do usuário ou através da importação. Você pode especificar um código de título na importação. Isso é importante para agrupar produtos sob um título. Por exemplo, se você está importando uma nova edição de um título, você deve importá-la com o código de título relevante.
  • Se você não especificar um código de título na importação, quaisquer novos produtos serão gerados sob novos títulos.

Titulares de Direitos

  • Devem corresponder aos códigos de titulares de direitos existentes no Royalties HQ.
  • Importe os titulares de direitos primeiro se eles ainda não existirem no Royalties HQ.
  • Deixe em branco se nenhum titular de direitos estiver atribuído ainda.

Dados Legados

  • Opcional.
  • Use campos legados para registrar vendas históricas antes de você usar o Royalties HQ.
  • Estes valores são essenciais onde um contrato usa o total de unidades vendidas para determinar a taxa de royalty atual de um titular de direitos para um produto (ISBN).

IDs de Produto Adicionais

  • ID de Produto Adicional incluem ACX, Google Play e mais – estes são campos opcionais para armazenar identificadores de produto alternativos
  • Use-os para códigos proprietários, SKUs internos, ou identificadores personalizados que não são ISBNs ou ASINs
  • IDs de produto devem ser únicos em todos os produtos
  • Este campo é útil para rastrear títulos em múltiplos sistemas

Idioma

  • Idioma é um campo opcional para indicar o idioma do produto
  • Use códigos ISO 639-3 de três letras (por exemplo, “eng” para inglês, “deu” para alemão, etc), ou rótulos em inglês simples (“English”, “German”, etc.)
  • Deixe em branco se não aplicável ou se o idioma não for relevante
  • Isso pode ser automaticamente preenchido através da busca de metadados do Google Books para novos produtos

Suporte para formato de mês e período

royalty-period-start-month suporta descritores de mês flexíveis:

  • Nomes completos de meses: “January”, “February”, “March”, etc.
  • Abreviações de três letras: “Jan”, “Feb”, “Mar”, etc.
  • Formato numérico: 1-12 (por exemplo, 3 para março)

Faça upload do seu CSV de produtos

Quando você tiver verificado seus dados de produto, você pode prosseguir e importá-los para o Royalties HQ. Veja como fazer isso:

  1. Vá para o menu principal, canto superior esquerdo, e clique em Importar.
  2. Para o tipo, selecione ‘Títulos’.
  3. Em ‘Escolha seu arquivo’ clique em ‘Procurar’ e navegue até seu arquivo CSV.
  4. Clique em ‘Próximo’
  5. O arquivo será enviado e validado (verificado quanto a problemas). Você verá os resultados em uma página de pré-visualização.
  6. Se os resultados parecerem bons, clique em ‘Continuar’ e os produtos serão importados (ou, se a etapa de pré-visualização destacar problemas, você precisará corrigir os dados – leia a mensagem de erro e verifique os requisitos abaixo).

Atualizar produtos em massa

Você também pode usar o processo acima para atualizar produtos em massa.

A importação CSV corresponderá produtos existentes por ISBN ou ASIN. Campos em branco serão ignorados; estes não sobrescreverão dados existentes.

Observe que quaisquer novos IDs de produto (incluindo ISBNs ou ASINs) no seu CSV que não estejam em uma linha com um ID de produto reconhecido resultarão em um novo produto.