Dokumentation

Importera titlar och produkter

Massimportera eller uppdatera produkter med ISBN, metadata och publiceringsinformation via CSV-uppladdning.

Denna sida kommer att guida dig genom stegen för att importera dina titlar, oavsett om du importerar nya produkter eller importerar uppdateringar till befintliga produkter.

Om du bara vill lägga till en eller två nya titlar kanske du föredrar att göra detta genom användargränssnittet. Men om du vill importera titlar och data i bulk är du på rätt plats.

Observera att produkter är specifika utgåvor av en titel. Till exempel kan en titel kallas “Min bok” och kan ha flera format: pocket, inbunden, e-bok och ljudbok. Var och en av dessa utgåvor/format är känd i Royalties HQ som en produkt, och var och en kommer att ha sitt eget produkt-ID (t.ex. ISBN).

Produkter kan importeras i bulk med hjälp av CSV-uppladdningsfunktionen. En mall finns tillgänglig för nedladdning från sidan Rättighetsinnehavare > Importera.

Ladda ner importmallen för titlar

  1. Gå till huvudmenyn, uppe till vänster, och klicka på Titlar, sedan Produkter.
  2. På sidan med produktlistor, klicka på knappen Importera.
  3. Under ‘Vad laddar du upp?’, välj ‘Produkter’.
  4. Under detta, klicka på ‘Ladda ner mallfil för produkter’.
  5. CSV-mallfilen kommer att laddas ner till din enhet.

Formatera dina titeldata

  1. Öppna CSV-importmallen för produkter som laddades ner i föregående steg (se ovan) – vi rekommenderar att använda Google Sheets.
  2. Varje rad är en produkt (i Royalties HQ är en titel “föräldern” och den kan ha flera format – vi kallar dessa produkter).
  3. Varje produkt måste ha minst ett produkt-ID såsom ISBN, ASIN eller annat produkt-ID (och dessa måste vara unika).
  4. Alla andra fält är valfria.
  5. När dina data är klara, spara som en CSV. I Google Sheets är det Arkiv > Ladda ner > CSV.

När du formaterar dina data måste du följa dessa krav:

KolumnnamnBeskrivningObligatoriskFormat/Värden
nameFullständig titel på bokenJaTextsträng
title-codeUnik identifierare för titeln (föräldraposten)JaAlfanumerisk (t.ex. T000047). Måste vara 7 tecken. En kommer att skapas automatiskt om den lämnas tom.
royalty-period-start-monthStartmånad för royaltyberäkningarJaEn månad antingen stavad i sin helhet eller förkortad (t.ex. “Jan” eller “January”)
royalty-period-lengthLängd på royaltyperiodJamonthly, two-monthly, quarterly, six-monthly, annual
product-typeFormattyp för denna utgåvaJasoftcover, hardcover, ebook, audiobook, wire-bound
statusPubliceringsstatusJaactive, inactive, withdrawn
imprintFörlagsimprint-namnNejTextsträng
isbnISBN-13 för fysiska formatVillkorlig*13-siffrigt ISBN utan bindestreck
asinAmazon Standard Identification NumberVillkorlig*10-tecken alfanumeriskt
number-pagesSidantal för fysiska böckerNejHeltal (t.ex. 300)
legacy-units-soldHistoriska sålda enheter före användning av Royalties HQNejHeltal (t.ex. 250)
legacy-earned-royaltiesHistoriska royalties intjänade före användning av Royalties HQNejDecimaltal (t.ex. 16.95)
date-first-publishedFörsta publiceringsdatumNejYYYY-MM-DD-format
date-withdrawnDatum då formatet drogs tillbaka från försäljningNejYYYY-MM-DD-format

*Minst ett produkt-ID (ISBN, ASIN eller annat) krävs för varje produkt

Övrig data

Titelkoder

  • På Royalties HQ ges varje titel en unik identifierare – en titelkod. Obs: en titel är INTE ett ISBN.
  • Alla format av samma bok delar samma titelkod.
  • En titelkod kommer att genereras automatiskt när du skapar en ny titel – vare sig via användargränssnittet eller via import. Du kan ange en titelkod vid import. Detta är viktigt för att gruppera produkter under en titel. Till exempel, om du importerar en ny utgåva av en titel, bör du importera den med relevant titelkod.
  • Om du inte anger en titelkod vid import kommer alla nya produkter att genereras under nya titlar.

Rättighetsinnehavare

  • Måste matcha befintliga rättighetsinnehavarkoder i Royalties HQ.
  • Importera rättighetsinnehavare först om de ännu inte finns i Royalties HQ.
  • Lämna tomt om ingen rättighetsinnehavare är tilldelad ännu.

Legacy-data

  • Valfritt.
  • Använd legacy-fält för att registrera historisk försäljning innan du använde Royalties HQ.
  • Dessa belopp är väsentliga där ett kontrakt använder totala sålda enheter för att bestämma en rättighetsinnehavares aktuella royaltysats för en produkt (ISBN).

Ytterligare produkt-ID

  • Ytterligare produkt-ID inkluderar ACX, Google Play och mer – dessa är valfria fält för att lagra alternativa produktidentifierare
  • Använd dessa för proprietära koder, interna SKU:er eller anpassade identifierare som inte är ISBN eller ASIN
  • Produkt-ID måste vara unika för alla produkter
  • Detta fält är användbart för att spåra titlar i flera system

Språk

  • Språk är ett valfritt fält för att ange produktens språk
  • Använd ISO 639-3 tresiffriga koder (t.ex. “eng” för engelska, “deu” för tyska, etc.), eller vanliga engelska etiketter (“English”, “German”, etc.)
  • Lämna tomt om inte tillämpligt eller om språk inte är relevant
  • Detta kan automatiskt fyllas i via Google Books metadata-hämtning för nya produkter

Stöd för månads- och periodformat

royalty-period-start-month stöder flexibla månadsbeskrivare:

  • Fullständiga månadsnamn: “January”, “February”, “March”, etc.
  • Treåriga förkortningar: “Jan”, “Feb”, “Mar”, etc.
  • Numeriskt format: 1-12 (t.ex. 3 för mars)

Ladda upp din produkt-CSV

När du har dubbelkollat dina produktdata kan du gå vidare och importera dem till Royalties HQ. Så här gör du:

  1. Gå till huvudmenyn, uppe till vänster, och klicka på Importera.
  2. För typen, välj ‘Titlar’.
  3. Under ‘Välj din fil’ klicka på ‘Bläddra’ och navigera till din CSV-fil.
  4. Klicka på ‘Nästa’
  5. Filen kommer att laddas upp och valideras (kontrolleras för problem). Du kommer att se resultaten på en förhandsgranskningssida.
  6. Om resultaten ser bra ut, klicka på ‘Fortsätt’ så importeras produkterna (eller, om förhandsgranskningssteget visar problem, behöver du åtgärda data – läs felmeddelandet och kontrollera kraven nedan).

Uppdatera produkter i bulk

Du kan också använda ovanstående process för att uppdatera produkter i bulk.

CSV-importen kommer att matcha befintliga produkter på ISBN eller ASIN. Tomma fält kommer att ignoreras; dessa kommer inte att skriva över befintliga data.

Observera att alla nya produkt-ID (inklusive ISBN eller ASIN) i din CSV som inte finns i en rad med ett igenkänt produkt-ID kommer att resultera i en ny produkt.