Documentazione

Importare vendite personalizzate

Importa vendite e-commerce, all'ingrosso o da distributori personalizzati usando il modello CSV di Royalties HQ.

Puoi importare dati di vendita personalizzati – ad es. le tue vendite e-commerce o vendite da un distributore non supportato – usando il modello CSV per le vendite di Royalties HQ. Per importare vendite da Amazon KDP, Lightning Source o InAudio (precedentemente Findaway), consulta invece questa pagina di aiuto.

Suggerimento: Se stai importando ordini all’ingrosso o vendite e-commerce, potresti trovare utile la nostra guida ‘Elaborazione ordini all’ingrosso’.

Scaricare il modello di importazione vendite

Prima di tutto, scarica il modello di importazione vendite dalla pagina ‘Aggiungi Nuove Vendite’:

  1. Nel menu principale (icona in alto a sinistra) clicca Aggiungi Nuove Vendite.
  2. Clicca il link “Scarica modello importazione vendite”.
  3. Il modello verrà scaricato sul tuo computer.

Preparare i dati di vendita

Successivamente, usa il tuo software per fogli di calcolo (ad esempio Google Sheets o Excel) per popolare il modello con i tuoi dati di vendita. Nota: Excel e Google Sheets tendono a essere ‘utili’ e formattare i tuoi numeri, quindi evitalo. Devi formattare i numeri come testo.

Dati di vendita personalizzati

Il modello di caricamento vendite include alcune istruzioni su ogni riga che inizia con un #. Queste informazioni ti aiutano a formattare correttamente i tuoi dati per l’importazione. Qualsiasi riga che inizia con ‘#’ verrà saltata nel processo di importazione, quindi può essere ignorata o eliminata in sicurezza prima dell’importazione.

Campi obbligatori

CampoDescrizioneEsempio
isbn o asinIdentificatore del prodotto (almeno uno obbligatorio)9781234567890
royalty_monthMese a cui si applica la royalty2024-08
currencyCodice valuta ISO-4217USD, GBP, EUR
royaltyImporto netto guadagnato (royalty sulle vendite più royalty sui rimborsi), senza simbolo di valuta3.78
royalty_on_salesRoyalty totale dalle vendite prima dei rimborsi, senza simbolo di valuta4.50
units_soldNumero di copie vendute (obbligatorio se royalty_on_sales > 0)15
sales_channelPer importazioni personalizzate, usa “other”other
sale_countryObbligatorio solo se i tuoi contratti hanno regole specifiche per paeseUS, GB
discount_percentObbligatorio solo per contratti royalty a prezzo di listino20

Campi facoltativi

CampoDescrizioneEsempio
royalty_on_refundsImporto detratto dalle royalty per rimborsi o resi. Obbligatorio se units_refunded ha un valore positivo. Inserisci come decimale negativo, o lascia vuoto se non ci sono resi/rimborsi.-10.50
units_refundedNumero di unità rimborsate o rese. Inserisci come positivo, o lascia vuoto se non ci sono resi/rimborsi. Obbligatorio se royalty_on_refunds è maggiore di 03
marketplaceDistributore o tipo di vendita (consigliato)wholesale, Shopify
list_pricePrezzo di vendita, senza simbolo di valuta (consigliato)12.99
title e authorUtili per la verifica visiva durante l’importazione

Gestione dei rimborsi

Se devi registrare resi o rimborsi, usa questi campi:

  • royalty_on_refunds – Importo detratto dalle royalty (inserisci come negativo, ad es. -10.50)
  • units_refunded – Numero di copie rimborsate (inserisci come positivo, ad es. 5)

Ricorda: Le quantità sono sempre positive (5 libri rimborsati), ma gli importi dei rimborsi devono essere negativi (-10.50) poiché riducono le tue royalty.

Quando sei pronto per importare i tuoi dati di vendita personalizzati, segui i passaggi seguenti:

Come caricare dati di vendita personalizzati

Per caricare i tuoi file di vendita personalizzati:

  1. Vai al menu principale (icona in alto a sinistra) e clicca Aggiungi Nuove Vendite.
  2. Trascina il tuo file di vendita nella zona di rilascio (o clicca sulla zona di rilascio e seleziona il tuo file)
  3. Royalties HQ tenterà di riconoscere il tipo di file. Questo verrà mostrato in un menu a tendina. Una volta selezionato il tipo di file corretto, clicca Continua.
  4. Il file verrà ora controllato e mostrerà lo stato ‘In validazione’ mentre Royalties HQ verifica che il file possa essere importato.
  5. Se il file mostra ‘Pronto per l’importazione’, clicca il pulsante Importa (oppure, se mostra ‘Rifiutato’, clicca sul nome del file per vedere maggiori dettagli, poi clicca su ‘Righe non valide’ – verranno mostrati i dettagli degli errori).
  6. Dopo l’importazione, il contenuto del file verrà importato. Ogni riga diventa una riga di vendita, raggruppata in uno o più batch di vendita. Clicca il pulsante Visualizza Batch per vedere i batch di vendita importati.

Una volta caricati i dati di vendita, devi aggiungere un pagamento di ricavi editoriali per ogni batch di vendita che ha vendite non nella valuta del tuo editore.