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
- Vá para o menu principal, canto superior esquerdo, e clique em Títulos, depois Produtos.
- Na página de listagem de Produtos, clique no botão Importar.
- Em ‘O que você está enviando?’, escolha ‘Produtos’.
- Abaixo disso, clique em ‘Baixar arquivo modelo de Produtos’.
- O arquivo modelo CSV será baixado para o seu dispositivo.
Formate seus dados de títulos
- Abra o modelo de importação CSV de Produtos baixado no passo anterior (veja acima) – recomendamos usar o Google Sheets.
- Cada linha é um produto (no Royalties HQ, um título é o ‘pai’ e pode ter múltiplos formatos – chamamos estes de produtos).
- Cada produto deve ter pelo menos um ID de produto como ISBN, ASIN, ou outro ID de produto (e estes devem ser únicos).
- Todos os outros campos são opcionais.
- Quando seus dados estiverem prontos, salve como CSV. No Google Sheets, isso é Arquivo > Baixar > CSV.
Ao formatar seus dados, você deve seguir estes requisitos:
- Você deve formatar números como texto
- Datas devem estar neste formato: AAAA-MM-DD (por exemplo, “30 de dezembro de 2020” deve ser inserido como “2020-12-30”)
- O tipo de cálculo de camada (coluna tier-type) deve ser units-sold ou total-net-receipts (Mais informações sobre camadas e tipo de cálculo de camada está aqui).
| Nome da Coluna | Descrição | Obrigatório | Formato/Valores |
|---|---|---|---|
| name | Título completo do livro | Sim | String de texto |
| title-code | Identificador único para o título (registro pai) | Sim | Alfanumérico (por exemplo, T000047). Deve ter 7 caracteres. Um será criado automaticamente se deixado em branco. |
| royalty-period-start-month | Mês de início para cálculos de royalties | Sim | Um mês escrito por extenso ou abreviado (por exemplo, “Jan” ou “Janeiro”) |
| royalty-period-length | Duração do período de royalty | Sim | monthly, two-monthly, quarterly, six-monthly, annual |
| product-type | Tipo de formato desta edição | Sim | softcover, hardcover, ebook, audiobook, wire-bound |
| status | Status de publicação | Sim | active, inactive, withdrawn |
| imprint | Nome do selo da editora | Não | String de texto |
| isbn | ISBN-13 para formatos físicos | Condicional* | ISBN de 13 dígitos sem hífens |
| asin | Amazon Standard Identification Number | Condicional* | Alfanumérico de 10 caracteres |
| number-pages | Contagem de páginas para livros físicos | Não | Inteiro (por exemplo, 300) |
| legacy-units-sold | Unidades vendidas historicamente antes de usar o Royalties HQ | Não | Inteiro (por exemplo, 250) |
| legacy-earned-royalties | Royalties ganhos historicamente antes de usar o Royalties HQ | Não | Decimal (por exemplo, 16.95) |
| date-first-published | Data de publicação inicial | Não | Formato AAAA-MM-DD |
| date-withdrawn | Data em que o formato foi retirado da venda | Não | Formato 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:
- Vá para o menu principal, canto superior esquerdo, e clique em Importar.
- Para o tipo, selecione ‘Títulos’.
- Em ‘Escolha seu arquivo’ clique em ‘Procurar’ e navegue até seu arquivo CSV.
- Clique em ‘Próximo’
- O arquivo será enviado e validado (verificado quanto a problemas). Você verá os resultados em uma página de pré-visualização.
- 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.