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
- Ga naar het hoofdmenu, linksboven, en klik op Titels, dan Producten.
- Klik op de pagina Productlijst op de knop Importeren.
- Kies onder ‘Wat uploadt u?’ voor ‘Producten’.
- Klik hieronder op ‘Download Producten sjabloonbestand’.
- Het CSV-bestandsjabloon wordt gedownload naar uw apparaat.
Formatteer uw titelsgegevens
- Open het Products CSV-importsjabloon dat in de vorige stap is gedownload (zie hierboven) – we raden aan om Google Sheets te gebruiken.
- Elke rij is één product (in Royalties HQ is een titel de ‘ouder’ en kan deze meerdere formaten hebben – we noemen deze producten).
- Elk product moet ten minste één product-ID hebben zoals ISBN, ASIN of andere product-ID (en deze moeten uniek zijn).
- Alle andere velden zijn optioneel.
- 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).
| Kolomnaam | Beschrijving | Verplicht | Formaat/Waarden |
|---|---|---|---|
| name | Volledige titel van het boek | Ja | Tekstreeks |
| title-code | Unieke identificatie voor de titel (bovenliggend record) | Ja | Alfanumeriek (bijv. T000047). Moet 7 tekens zijn. Er wordt automatisch een aangemaakt als deze leeg wordt gelaten. |
| royalty-period-start-month | Startmaand voor royaltyberekeningen | Ja | Een maand volledig uitgeschreven of afgekort (bijv. “Jan” of “Januari”) |
| royalty-period-length | Lengte van royaltyperiode | Ja | monthly, two-monthly, quarterly, six-monthly, annual |
| product-type | Formaattype van deze editie | Ja | softcover, hardcover, ebook, audiobook, wire-bound |
| status | Publicatiestatus | Ja | active, inactive, withdrawn |
| imprint | Uitgever imprint naam | Nee | Tekstreeks |
| isbn | ISBN-13 voor fysieke formaten | Voorwaardelijk* | 13-cijferig ISBN zonder koppeltekens |
| asin | Amazon Standard Identification Number | Voorwaardelijk* | 10-tekens alfanumeriek |
| number-pages | Paginaaantal voor fysieke boeken | Nee | Geheel getal (bijv. 300) |
| legacy-units-sold | Historische verkochte eenheden vóór gebruik van Royalties HQ | Nee | Geheel getal (bijv. 250) |
| legacy-earned-royalties | Historische verdiende royalty’s vóór gebruik van Royalties HQ | Nee | Decimaal (bijv. 16.95) |
| date-first-published | Eerste publicatiedatum | Nee | JJJJ-MM-DD formaat |
| date-withdrawn | Datum waarop formaat uit de verkoop is genomen | Nee | JJJJ-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:
- Ga naar het hoofdmenu, linksboven, en klik op Importeren.
- Selecteer voor het type ‘Titels’.
- Klik onder ‘Kies uw bestand’ op ‘Bladeren’ en navigeer naar uw CSV-bestand.
- Klik op ‘Volgende’
- Het bestand wordt geüpload en gevalideerd (gecontroleerd op problemen). U ziet de resultaten op een voorbeeldpagina.
- 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.