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.

O que você recebe

O download é um arquivo ZIP que contém:

• o arquivo CSV (ou vários arquivos CSV, se a exportação passar do limite de tamanho e for dividida)
• COLUMNS.txt, uma referência em texto simples que descreve cada coluna do arquivo

Cada exportação gerada fica disponível por 24 horas. Se você pedir outra exportação com a mesma conta, o mesmo intervalo de datas e o mesmo agrupamento dentro desse prazo, o sistema entrega o arquivo já gerado, em vez de processar tudo de novo.

---

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

Os exemplos abaixo mostram uma linha de streaming padrão e uma linha de UGC.

Coluna	Descrição	Linha de streaming	Linha de UGC
gross_usd	Receita bruta em USD daquela linha, antes das taxas da LabelGrid	18.09000000	4.63000000

Colunas de taxas da LabelGrid

Coluna	Descrição	Linha de streaming	Linha de UGC
platform_fee_rate	Alíquota da taxa de plataforma do seu plano	0.05000000 (5%)	0.00000000
platform_fee_usd	Valor da taxa de plataforma (exibido como valor negativo)	-0.90450000	0.00000000
ugc_fee_rate	Alíquota da taxa de UGC / Content ID do seu plano	0.00000000	0.20000000 (20%)
ugc_fee_usd	Valor da taxa de UGC / Content ID (exibido como valor negativo)	0.00000000	-0.92600000
total_labelgrid_fee	As duas taxas somadas (valor negativo)	-0.90450000	-0.92600000
net_revenue_usd	Seus ganhos finais após todas as taxas da LabelGrid	17.18550000	3.70400000

Nota

As alíquotas são definidas por extrato. Todas as linhas de um mesmo extrato trazem o mesmo platform_fee_rate e o mesmo ugc_fee_rate.

---

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)
Entrega	Arquivo ZIP com o CSV e um arquivo de referência COLUMNS.txt

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

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. Veja uma linha de streaming completa do arquivo de exemplo, com alíquota de plataforma de 5%:

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

A taxa de plataforma e a taxa de UGC são categorias separadas e não incidem uma sobre a outra

Se você está montando uma contabilidade a partir desta exportação, este é o ponto que mais vale acertar.

• As duas alíquotas incidem sobre o mesmo valor.
• Nenhuma das duas incide sobre o resultado da outra: a taxa de UGC não é aplicada ao que sobra depois da taxa de plataforma, nem a taxa de plataforma ao que sobra depois da taxa de UGC.
• Os dois valores são somados: total_labelgrid_fee = platform_fee_usd + ugc_fee_usd.

Veja um exemplo prático de uma linha de um extrato que traz os dois tipos de taxa, com alíquota de plataforma de 5% e alíquota de UGC de 20% sobre esse mesmo valor de $100.00000000:

Cálculo	Correto (somando)	Incorreto (acumulando)
Taxa de plataforma	-$5.00000000	-$5.00000000
Taxa de UGC / Content ID	-$20.00000000 (20% de $100.00)	-$19.00000000 (20% de $95.00)
Total de taxas da LabelGrid	-$25.00000000	-$24.00000000

A coluna da esquerda é a que fecha. Uma alíquota de plataforma de 5% e uma alíquota de UGC de 20% dão um desconto de 25% sobre esse valor, e não os 24% que aparecem quando você aplica uma alíquota sobre o que sobrou da outra.

Quando cada taxa aparece

A taxa de UGC / Content ID se aplica aos ganhos de conteúdo gerado pelo usuário em plataformas como YouTube, TikTok e SoundCloud. Nas linhas de plataformas de streaming padrão, como Spotify ou Apple Music, ugc_fee_rate e ugc_fee_usd mostram 0.00.

Como as alíquotas são definidas por extrato, na maioria das linhas uma alíquota vem preenchida e a outra fica em zero: um extrato costuma trazer só um tipo de ganho. Quando um extrato traz os dois tipos, as duas alíquotas aparecem em todas as linhas dele, e vale a regra da soma acima. Não presuma que só uma das duas colunas de alíquota virá preenchida: leia as que tiverem valor e some.

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.

Taxas na API de extratos

Se você consulta os extratos pela API pública em vez da exportação em CSV, os endpoints de extratos retornam o mesmo detalhamento em três campos adicionais:

Campo	Descrição
platform_fee_usd	Taxa de distribuição padrão cobrada no extrato
ugc_fee_usd	Taxa de UGC / Content ID cobrada no extrato
labelgrid_ugc_rate	Alíquota da taxa de UGC / Content ID vigente quando o extrato foi gerado

Os dois valores são negativos e somam labelgrid_fee. As taxas incidem sobre o valor total liquidado no extrato, o que inclui qualquer saldo levado adiante de períodos anteriores, então multiplicar uma alíquota apenas pelos ganhos daquele período nem sempre bate com o valor — valem os valores retornados.

Os três campos são null em extratos gerados antes de o detalhamento passar a ser registrado. Trate null como “sem detalhamento”, e não como zero, e continue usando labelgrid_fee como total de taxas em todos os casos.

---

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, no formato de 23 colunas descrito acima. Todas as linhas dele seguem as fórmulas deste artigo, então você pode usá-lo como base de teste ao desenvolver o seu importador.

---

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.