Documentatie

Titels en producten importeren

Producten met ISBN's, metadata en publicatiegegevens in bulk importeren of bijwerken via CSV-upload.

Deze pagina begeleidt u door de stappen om uw titels te importeren, of het nu gaat om het importeren van nieuwe producten of het importeren van updates voor bestaande producten.

Als u slechts één of twee nieuwe titels wilt toevoegen, kunt u dit wellicht liever doen via de gebruikersinterface. Als u echter titels en gegevens in bulk wilt importeren, bent u hier aan het juiste adres.

Houd er rekening mee dat producten specifieke edities van een titel zijn. Een titel kan bijvoorbeeld “Mijn Boek” heten en meerdere formaten hebben: softcover, hardcover, e-book en audioboek. Elk van deze edities/formaten staat in Royalties HQ bekend als een product, en elk zal zijn eigen product-ID hebben (bijv. ISBN).

Producten kunnen in bulk worden geïmporteerd met behulp van de CSV-uploadfunctie. Een sjabloon is beschikbaar om te downloaden vanaf de pagina Rechthebbenden > Importeren.

Download het titels importsjabloon

  1. Ga naar het hoofdmenu, linksboven, en klik op Titels, dan Producten.
  2. Klik op de pagina Productlijst op de knop Importeren.
  3. Kies onder ‘Wat uploadt u?’ voor ‘Producten’.
  4. Klik hieronder op ‘Download Producten sjabloonbestand’.
  5. Het CSV-bestandsjabloon wordt gedownload naar uw apparaat.

Formatteer uw titelsgegevens

  1. Open het Products CSV-importsjabloon dat in de vorige stap is gedownload (zie hierboven) – we raden aan om Google Sheets te gebruiken.
  2. Elke rij is één product (in Royalties HQ is een titel de ‘ouder’ en kan deze meerdere formaten hebben – we noemen deze producten).
  3. Elk product moet ten minste één product-ID hebben zoals ISBN, ASIN of andere product-ID (en deze moeten uniek zijn).
  4. Alle andere velden zijn optioneel.
  5. Wanneer uw gegevens klaar zijn, sla ze op als een CSV. In Google Sheets is dit Bestand > Downloaden > CSV.

Bij het formatteren van uw gegevens moet u aan deze vereisten voldoen:

  • U moet getallen als tekst formatteren
  • Data moeten in dit formaat zijn: JJJJ-MM-DD (bijv. “30 december 2020” moet worden ingevoerd als “2020-12-30”)
  • Het tier-berekeningstype (tier-type kolom) moet units-sold of total-net-receipts zijn (Meer informatie over tiers en tier-berekeningstype hier).
KolomnaamBeschrijvingVerplichtFormaat/Waarden
nameVolledige titel van het boekJaTekstreeks
title-codeUnieke identificatie voor de titel (bovenliggend record)JaAlfanumeriek (bijv. T000047). Moet 7 tekens zijn. Er wordt automatisch een aangemaakt als deze leeg wordt gelaten.
royalty-period-start-monthStartmaand voor royaltyberekeningenJaEen maand volledig uitgeschreven of afgekort (bijv. “Jan” of “Januari”)
royalty-period-lengthLengte van royaltyperiodeJamonthly, two-monthly, quarterly, six-monthly, annual
product-typeFormaattype van deze editieJasoftcover, hardcover, ebook, audiobook, wire-bound
statusPublicatiestatusJaactive, inactive, withdrawn
imprintUitgever imprint naamNeeTekstreeks
isbnISBN-13 voor fysieke formatenVoorwaardelijk*13-cijferig ISBN zonder koppeltekens
asinAmazon Standard Identification NumberVoorwaardelijk*10-tekens alfanumeriek
number-pagesPaginaaantal voor fysieke boekenNeeGeheel getal (bijv. 300)
legacy-units-soldHistorische verkochte eenheden vóór gebruik van Royalties HQNeeGeheel getal (bijv. 250)
legacy-earned-royaltiesHistorische verdiende royalty’s vóór gebruik van Royalties HQNeeDecimaal (bijv. 16.95)
date-first-publishedEerste publicatiedatumNeeJJJJ-MM-DD formaat
date-withdrawnDatum waarop formaat uit de verkoop is genomenNeeJJJJ-MM-DD formaat

*Ten minste één product-ID (ISBN, ASIN of andere) is vereist voor elk product

Andere gegevens

Titelcodes

  • Op Royalties HQ krijgt elke titel een unieke identificatie – een titelcode. Let op: een titel is GEEN ISBN.
  • Alle formaten van hetzelfde boek delen dezelfde titelcode.
  • Een titelcode wordt automatisch gegenereerd wanneer u een nieuwe titel aanmaakt – via de gebruikersinterface of via import. U kunt een titelcode opgeven bij import. Dit is belangrijk voor het groeperen van producten onder één titel. Als u bijvoorbeeld een nieuwe editie van een titel importeert, moet u deze importeren met de relevante titelcode.
  • Als u geen titelcode opgeeft bij import, worden alle nieuwe producten gegenereerd onder nieuwe titels.

Rechthebbenden

  • Moet overeenkomen met bestaande rechthebbendecodes in Royalties HQ.
  • Importeer eerst rechthebbenden als ze nog niet bestaan in Royalties HQ.
  • Laat leeg als er nog geen rechthebbende is toegewezen.

Legacy-gegevens

  • Optioneel.
  • Gebruik legacy-velden om historische verkopen vast te leggen voordat u Royalties HQ gebruikte.
  • Deze bedragen zijn essentieel wanneer een contract totaal verkochte eenheden gebruikt om het huidige royaltypercentage van een rechthebbende voor een product (ISBN) te bepalen.

Aanvullende Product-ID’s

  • Aanvullende Product-ID omvat ACX, Google Play en meer – dit zijn optionele velden voor het opslaan van alternatieve productidentificaties
  • Gebruik deze voor propriëtaire codes, interne SKU’s of aangepaste identificaties die geen ISBN’s of ASIN’s zijn
  • Product-ID’s moeten uniek zijn voor alle producten
  • Dit veld is handig voor het volgen van titels in meerdere systemen

Taal

  • Taal is een optioneel veld voor het aangeven van de taal van het product
  • Gebruik ISO 639-3 drieletterige codes (bijv. “eng” voor Engels, “deu” voor Duits, etc.), of gewone Engelse labels (“English”, “German”, etc.)
  • Laat leeg indien niet van toepassing of als taal niet relevant is
  • Dit kan automatisch worden ingevuld via Google Books metadata fetch voor nieuwe producten

Maand- en periodeformaatondersteuning

royalty-period-start-month ondersteunt flexibele maandbeschrijvingen:

  • Volledige maandnamen: “Januari”, “Februari”, “Maart”, etc.
  • Drieletterige afkortingen: “Jan”, “Feb”, “Mrt”, etc.
  • Numeriek formaat: 1-12 (bijv. 3 voor maart)

Upload uw producten CSV

Wanneer u uw productgegevens nogmaals heeft gecontroleerd, kunt u deze importeren in Royalties HQ. Hier is hoe u dit doet:

  1. Ga naar het hoofdmenu, linksboven, en klik op Importeren.
  2. Selecteer voor het type ‘Titels’.
  3. Klik onder ‘Kies uw bestand’ op ‘Bladeren’ en navigeer naar uw CSV-bestand.
  4. Klik op ‘Volgende’
  5. Het bestand wordt geüpload en gevalideerd (gecontroleerd op problemen). U ziet de resultaten op een voorbeeldpagina.
  6. Als de resultaten er goed uitzien, klik dan op ‘Doorgaan’ en de producten worden geïmporteerd (of, als de voorbeeldstap problemen benadrukt, moet u de gegevens corrigeren – lees de foutmelding en controleer de onderstaande vereisten).

Producten in bulk bijwerken

U kunt het bovenstaande proces ook gebruiken om producten in bulk bij te werken.

De CSV-import komt overeen met bestaande producten op ISBN of ASIN. Lege velden worden genegeerd; deze zullen bestaande gegevens niet overschrijven.

Houd er rekening mee dat nieuwe product-ID’s (inclusief ISBN’s of ASIN’s) in uw CSV die zich niet in een rij bevinden met een herkende product-ID, zullen resulteren in een nieuw product.