Documentazione

Importare titoli e prodotti

Importa o aggiorna in blocco i prodotti con ISBN, metadati e dettagli di pubblicazione tramite caricamento CSV.

Questa pagina ti guiderà attraverso i passaggi per importare i tuoi titoli, sia che tu stia importando nuovi prodotti o aggiornamenti a prodotti esistenti.

Se vuoi aggiungere solo uno o due nuovi titoli, potresti preferire farlo attraverso l’interfaccia utente. Tuttavia, se stai cercando di importare titoli e dati in blocco, sei nel posto giusto.

Nota che i prodotti sono edizioni specifiche di un titolo. Ad esempio, un titolo potrebbe chiamarsi “Il Mio Libro” e potrebbe avere più formati: brossura, copertina rigida, ebook e audiolibro. Ciascuna di queste edizioni/formati è conosciuta in Royalties HQ come prodotto, e ciascuna avrà il proprio ID prodotto (ad es. ISBN).

I prodotti possono essere importati in blocco usando la funzione di caricamento CSV. Un modello è disponibile per il download dalla pagina Titolari dei diritti > Importa.

Scarica il modello di importazione titoli

  1. Vai al menu principale, in alto a sinistra, e clicca Titoli, poi Prodotti.
  2. Nella pagina elenco Prodotti, clicca il pulsante Importa.
  3. Sotto ‘Cosa stai caricando?’, scegli ‘Prodotti’.
  4. Sotto questo, clicca ‘Scarica file modello Prodotti’.
  5. Il file modello CSV verrà scaricato sul tuo dispositivo.

Formatta i dati dei tuoi titoli

  1. Apri il modello di importazione CSV Prodotti scaricato nel passaggio precedente (vedi sopra) – consigliamo di usare Google Sheets.
  2. Ogni riga è un prodotto (in Royalties HQ, un titolo è il ‘genitore’ e può avere più formati – li chiamiamo prodotti).
  3. Ogni prodotto deve avere almeno un ID prodotto come ISBN, ASIN o altro ID prodotto (e questi devono essere unici).
  4. Tutti gli altri campi sono facoltativi.
  5. Quando i tuoi dati sono pronti, salva come CSV. In Google Sheets, questo è File > Scarica > CSV.

Quando formatti i tuoi dati, devi seguire questi requisiti:

Nome ColonnaDescrizioneObbligatorioFormato/Valori
nameTitolo completo del libroStringa di testo
title-codeIdentificatore univoco per il titolo (record genitore)Alfanumerico (ad es. T000047). Deve essere di 7 caratteri. Ne verrà creato uno automaticamente se lasciato vuoto.
royalty-period-start-monthMese di inizio per i calcoli delle royaltyUn mese scritto per esteso o abbreviato (ad es. “Gen” o “Gennaio”)
royalty-period-lengthDurata del periodo royaltymonthly, two-monthly, quarterly, six-monthly, annual
product-typeTipo di formato di questa edizionesoftcover, hardcover, ebook, audiobook, wire-bound
statusStato di pubblicazioneactive, inactive, withdrawn
imprintNome del marchio editorialeNoStringa di testo
isbnISBN-13 per formati fisiciCondizionale*ISBN a 13 cifre senza trattini
asinAmazon Standard Identification NumberCondizionale*Alfanumerico a 10 caratteri
number-pagesConteggio pagine per libri fisiciNoIntero (ad es. 300)
legacy-units-soldUnità storiche vendute prima di usare Royalties HQNoIntero (ad es. 250)
legacy-earned-royaltiesRoyalty storiche guadagnate prima di usare Royalties HQNoDecimale (ad es. 16.95)
date-first-publishedData di prima pubblicazioneNoFormato AAAA-MM-GG
date-withdrawnData in cui il formato è stato ritirato dalla venditaNoFormato AAAA-MM-GG

*Almeno un ID prodotto (ISBN, ASIN o altro) è richiesto per ogni prodotto

Altri dati

Codici titolo

  • Su Royalties HQ, ogni titolo riceve un identificatore univoco – un codice titolo. Nota: un titolo NON è un ISBN.
  • Tutti i formati dello stesso libro condividono lo stesso codice titolo.
  • Un codice titolo verrà generato automaticamente quando crei un nuovo titolo – sia tramite l’interfaccia utente che tramite importazione. Puoi specificare un codice titolo durante l’importazione. Questo è importante per raggruppare i prodotti sotto un unico titolo. Ad esempio, se stai importando una nuova edizione di un titolo, dovresti importarla con il codice titolo pertinente.
  • Se non specifichi un codice titolo durante l’importazione, eventuali nuovi prodotti verranno generati sotto nuovi titoli.

Titolari dei diritti

  • Devono corrispondere ai codici dei titolari dei diritti esistenti in Royalties HQ.
  • Importa prima i titolari dei diritti se non esistono ancora in Royalties HQ.
  • Lascia vuoto se nessun titolare dei diritti è ancora assegnato.

Dati legacy

  • Facoltativo.
  • Usa i campi legacy per registrare le vendite storiche prima di usare Royalties HQ.
  • Questi importi sono essenziali quando un contratto utilizza le unità totali vendute per determinare il tasso di royalty corrente di un titolare dei diritti per un prodotto (ISBN).

ID prodotto aggiuntivi

  • Gli ID Prodotto Aggiuntivi includono ACX, Google Play e altro – questi sono campi facoltativi per memorizzare identificatori di prodotto alternativi
  • Usali per codici proprietari, SKU interni o identificatori personalizzati che non sono ISBN o ASIN
  • Gli ID prodotto devono essere unici tra tutti i prodotti
  • Questo campo è utile per tracciare i titoli in più sistemi

Lingua

  • Lingua è un campo facoltativo per indicare la lingua del prodotto
  • Usa codici ISO 639-3 a tre lettere (ad es. “ita” per Italiano, “deu” per Tedesco, ecc.), o etichette in italiano (“Italiano”, “Tedesco”, ecc.)
  • Lascia vuoto se non applicabile o se la lingua non è rilevante
  • Questo può essere popolato automaticamente tramite recupero metadati Google Books per i nuovi prodotti

Supporto formato mese e periodo

royalty-period-start-month supporta descrittori di mese flessibili:

  • Nomi completi dei mesi: “January”, “February”, “March”, ecc.
  • Abbreviazioni a tre lettere: “Jan”, “Feb”, “Mar”, ecc.
  • Formato numerico: 1-12 (ad es. 3 per Marzo)

Carica il tuo CSV prodotti

Quando hai ricontrollato i dati dei tuoi prodotti, puoi procedere a importarli in Royalties HQ. Ecco come farlo:

  1. Vai al menu principale, in alto a sinistra, e clicca Importa.
  2. Per il tipo, seleziona ‘Titoli’.
  3. Sotto ‘Scegli il tuo file’ clicca ‘Sfoglia’ e naviga fino al tuo file CSV.
  4. Clicca ‘Avanti’
  5. Il file verrà caricato e validato (controllato per problemi). Vedrai i risultati in una pagina di anteprima.
  6. Se i risultati sembrano buoni, clicca ‘Continua’ e i prodotti verranno importati (oppure, se il passaggio di anteprima evidenzia problemi, dovrai correggere i dati – leggi il messaggio di errore e controlla i requisiti sotto).

Aggiornare prodotti in blocco

Puoi anche usare il processo sopra per aggiornare prodotti in blocco.

L’importazione CSV abbinerà i prodotti esistenti su ISBN o ASIN. I campi vuoti verranno ignorati; questi non sovrascriveranno i dati esistenti.

Nota che eventuali nuovi ID prodotto (inclusi ISBN o ASIN) nel tuo CSV che non sono in una riga con un ID prodotto riconosciuto risulteranno in un nuovo prodotto.