Exportando extratos de royalties para CSV

Baixe seus extratos de royalties em arquivos CSV para analisar os ganhos em uma planilha, se preparar para a temporada de impostos ou manter um registro financeiro detalhado.

Antes de começar

• Você precisa ter pelo menos um extrato de royalties pago (os extratos aparecem depois que o seu primeiro pagamento é processado)
• Um aplicativo de planilhas como Excel, Google Sheets ou Numbers para abrir o arquivo CSV

---

Baixe um extrato

1. Acesse Royalties no menu principal
2. Vá até a aba Extratos
3. Localize o período do extrato que você quer baixar
4. Clique no botão de download (ícone de seta) ao lado do extrato

O sistema vai gerar o seu arquivo CSV. Para extratos menores, o download começa imediatamente. Para extratos maiores, você verá um indicador de progresso enquanto o arquivo é preparado.

Dica

Use o menu Baixar por ano, no topo, para exportar todos os extratos de um ano inteiro em um único arquivo. Isso é útil para a declaração anual de impostos.

---

O que acontece durante a exportação

Downloads instantâneos

Para a maioria dos extratos, o CSV fica pronto na hora. Aparece uma janela com um botão Download para salvar o arquivo.

Processamento de extratos grandes

Para extratos com muitos itens, o sistema processa a exportação em segundo plano:

1. Aparece uma janela de “Preparando exportação”
2. O sistema gera o arquivo (isso pode levar alguns instantes)
3. Quando estiver pronto, aparece um botão Download
4. Clique em Download para salvar o arquivo

Nota

Só é possível executar uma exportação por vez. Se você vir a mensagem “Exportação em andamento”, aguarde a exportação atual terminar antes de iniciar outra.

---

Referência das colunas do CSV

Cada linha do CSV representa um único item do seu extrato de royalties. Veja o que cada coluna significa.

Colunas básicas

Coluna	Descrição	Exemplo
pay_period	Período de pagamento no formato AAAAMM	202601
label	Nome do seu selo	Midnight Records
retailer	Nome da plataforma	Spotify
territory	Código de país ou região	US, GB, DE
type	Tipo de transação	Stream, Download, UGC
cat	Número de catálogo	MR-2026-001
upc	Código de barras UPC do lançamento	840123456789
release	Título do lançamento	Neon Skyline
isrc	Código ISRC da faixa (um identificador exclusivo para cada faixa)	USRC12400001
track_artist	Nome do artista	Luna Rivera
track_title	Título da faixa	Golden Hour
track_version	Informação de versão ou remix (vazio quando não houver)	Acoustic Version
track_count	Número de faixas	1
purchase_qty	Número de reproduções ou vendas	4523
dsp_transaction_date	Data da transação informada pela plataforma	2026-01-15
dsp_statement_id	ID de referência do extrato	SP-2026-0001

Colunas de receita

Coluna	Descrição	Exemplo
gross_usd	Receita bruta em USD (após o desconto das taxas do provedor do extrato)	18.09000000

Nota

O valor de gross_usd é o valor após o seu provedor de extratos (como a Merlin ou a The Orchard) ter retido a parte dele. É o valor que chega à LabelGrid para a sua conta.

Colunas de taxas da LabelGrid

Coluna	Descrição	Exemplo
platform_fee_rate	Taxa de plataforma da LabelGrid conforme o seu plano	0.05000000 (5%)
platform_fee_usd	Valor da taxa de plataforma da LabelGrid (exibido como valor negativo)	-0.90450000
ugc_fee_rate	Taxa de UGC (conteúdo gerado pelo usuário) para plataformas de UGC	0.20000000 (20%)
ugc_fee_usd	Valor da taxa das plataformas de UGC (exibido como valor negativo)	-1.74400000
total_labelgrid_fee	Total de todas as taxas da LabelGrid (valor negativo)	-2.18000000
net_revenue_usd	Seus ganhos finais após todas as taxas	17.18550000

---

Especificação técnica

Se você for integrar esse CSV a um software de contabilidade ou a um sistema financeiro, veja os detalhes exatos do formato.

Propriedade	Valor
Codificação	UTF-8
Delimitador	Vírgula (,)
Caractere de aspas	Aspas duplas (")
Caractere de escape	Barra invertida (\)
Fim de linha	LF (\n)
Linha de cabeçalho	Sempre presente como a primeira linha
Total de colunas	23 (ordem fixa, veja a referência de colunas acima)

Tipos de dados e precisão

Grupo de colunas	Tipo	Precisão
pay_period	Texto	AAAAMM (6 caracteres)
dsp_transaction_date	Texto	AAAA-MM-DD (10 caracteres)
purchase_qty	Inteiro	Número inteiro
gross_usd, *_fee_usd, net_revenue_usd	Decimal	Até 8 casas decimais
platform_fee_rate, ugc_fee_rate	Decimal	Até 8 casas decimais (ex.: 0.05000000 = 5%)
Todas as outras colunas	Texto	Comprimento variável

Dica

Os valores de taxas são sempre negativos (são descontos). As colunas de taxa são frações decimais, não porcentagens: multiplique por 100 para obter a porcentagem.

Fórmulas de receita

platform_fee_usd  = -1 × platform_fee_rate × gross_usd
ugc_fee_usd       = -1 × ugc_fee_rate × gross_usd
total_labelgrid_fee = platform_fee_usd + ugc_fee_usd
net_revenue_usd   = gross_usd + total_labelgrid_fee

Observações para processamento automatizado

• Campos vazios: track_version e cat podem ficar vazios (duas vírgulas seguidas)
• Uso de aspas em texto: os campos que contêm vírgulas ou aspas ficam entre aspas duplas. As aspas duplas dentro dos valores de campo são removidas durante a exportação.
• Exportações grandes: as exportações acima de 150 MB são divididas em vários arquivos CSV (cada um com a sua própria linha de cabeçalho) e entregues em um arquivo ZIP
• Ordenação: as linhas são ordenadas por pay_period em ordem decrescente e, em seguida, por dsp_transaction_date em ordem decrescente

---

Entenda as taxas no CSV

Como a receita líquida é calculada

net_revenue_usd = gross_usd + total_labelgrid_fee

Como as taxas são valores negativos, elas reduzem o seu valor bruto. Por exemplo:

	Valor
Receita bruta	$18.09000000
Taxa de plataforma (5%)	-$0.90450000
Taxa de UGC	$0.00000000
Receita líquida	$17.18550000

Taxas das plataformas de UGC

A taxa de UGC se aplica apenas às plataformas de conteúdo gerado pelo usuário, como YouTube, TikTok e SoundCloud. Para plataformas de streaming padrão, como Spotify ou Apple Music, as colunas ugc_fee_rate e ugc_fee_usd mostrarão 0.00.

Aviso sobre a inclusão das taxas

As taxas passaram a constar nas exportações em CSV a partir do período de extrato de outubro de 2024. Os extratos anteriores mostram os dados de receita sem as colunas de detalhamento das taxas.

---

Baixe um CSV de exemplo

Quer ver como fica a exportação antes de baixar a sua? Baixe o nosso arquivo de exemplo:

Baixar CSV de exemplo

O exemplo contém dados fictícios que mostram itens típicos de várias plataformas e territórios.

---

Dicas para trabalhar com os dados

Abrindo no Google Sheets

1. Acesse o Google Sheets
2. Clique em Arquivo → Importar
3. Envie o seu arquivo CSV
4. Selecione “Vírgula” como separador
5. Clique em Importar dados

Abrindo no Excel

1. Abra o Excel
2. Clique em Arquivo → Abrir e selecione o arquivo CSV
3. O Excel vai detectar automaticamente o formato separado por vírgulas

Ideias comuns de análise

• Filtre por loja para ver os ganhos por plataforma
• Crie uma tabela dinâmica por território para descobrir os seus mercados mais fortes
• Some net_revenue_usd para conferir o valor total do seu extrato
• Ordene por purchase_qty para encontrar as suas faixas mais reproduzidas
• Agrupe por lançamento para comparar o desempenho dos álbuns

---

Solução de problemas

A exportação está demorando demais

Extratos grandes, com muitos itens, podem levar mais tempo para serem gerados. O sistema verifica o andamento por até 5 minutos. Se a exportação expirar:

1. Feche a janela
2. Aguarde alguns minutos
3. Tente baixar de novo

Erro “Exportação em andamento”

Só é possível processar uma exportação por vez. Aguarde qualquer exportação atual terminar e tente novamente.

O CSV mostra caracteres inesperados

Verifique se o seu aplicativo de planilhas está configurado para a codificação UTF-8 ao importar. Isso garante que nomes de artistas e títulos de faixas com caracteres especiais sejam exibidos corretamente.

Faltam colunas de taxas

As colunas de taxas (platform_fee_rate, platform_fee_usd etc.) só estão disponíveis para os períodos de extrato a partir de outubro de 2024. Os períodos anteriores mostram os dados de receita sem o detalhamento das taxas.

---

Guias relacionados

• Entendendo os relatórios de royalties - Como ler os seus dados de royalties
• Calendário de pagamentos - Quando os royalties são pagos
• Informações fiscais - Como usar os dados exportados para a declaração de impostos

---

Precisa de ajuda com a sua exportação? Fale com a nossa equipe de suporte.