Pular para o conteúdo
Worklog Report

Controle de horas no Jira

A Atlassian encerrou esse pedido em 2014. Este Jira Worklog Report responde.

Não existe um Jira Worklog Report agrupado por pessoa, projeto ou cliente — o Jira só exporta o CSV, e a Atlassian marcou esse pedido como Won't Fix. Solte a exportação e obtenha os totais com os quais você realmente fatura.

"Export Excel CSV (all fields)" do Jira · apenas .csv

Grátis · nada para conectar, nada para instalar · seu arquivo nunca sai do navegador

PROJ — Migração de cliente3 pessoas
  • Jane Smith

    34,5h

    Faturável
  • Omar Wright

    12h

    Faturável
  • Priya Patel

    6h

    Não faturável
3 projetos · 52,5h no total, 46,5h faturáveis

O Jira registra o tempo. Não o totaliza.

Todo apontamento é uma data, uma duração e um item — preciso, atômico, e inútil para faturamento até alguém abrir uma planilha. A Atlassian já declarou, nominalmente, que construir esse relatório não é algo que vão fazer.

  1. A resposta de 20 anos

    A Atlassian encerrou o pedido como Won't Fix

    JRACLOUD-6137, “Generate worklog report”, aberto em 8 de março de 2005 com 124 votos, encerrado como Won't Fix em 31 de julho de 2014: “Reconhecemos a importância deste pedido de funcionalidade, mas não é algo a que poderemos dedicar tempo de desenvolvimento”, apontando para o Marketplace em vez disso.

  2. A verdadeira barreira

    Todo app do Marketplace precisa ser instalado

    Os apps que preenchem essa lacuna — de US$ 60 a US$ 5.210 por ano — todos exigem instalação no Jira do cliente. Quem precisa do número geralmente não é administrador do Jira contra o qual está faturando; consegue rodar um filtro e exportar, não instalar um app.

  3. O defeito em aberto

    A data da exportação não é a data do trabalho

    JRACLOUD-77926 e seu gêmeo de servidor JRASERVER-64025, ambos abertos desde 7 de fevereiro de 2017: a exportação CSV traz a data em que um apontamento foi enviado, não a data a que o trabalho se refere. Os totais em toda a exportação não são afetados; uma divisão dia a dia seria um palpite disfarçado de fato — por isso esta ferramenta não oferece isso.

Números de itens, contagens de votos e datas verificados em jira.atlassian.com e na própria documentação de suporte da Atlassian.

Solte o arquivo. Receba os totais.

O CSV exportado pelo Jira

Issue key,Summary,Log Work

"PROJ-118","Client migration",

 "comment;16/Sep/24;jsmith;7200"

Comparado com suas regras

PROJ-118 · 2h00m

Corresponder por projeto

Faturável

Totais, prontos para faturar

3 projetos · 52,5h no total, 46,5h faturáveis

Lê a exportação real

O Jira repete o cabeçalho da coluna para cada sprint, apontamento e etiqueta que um item carrega; um analisador simples mantém silenciosamente apenas o último. Esta ferramenta lê cada coluna repetida e cada linha de apontamento, na gramática comment;date;user;seconds que o Jira escreve.

Totaliza por projeto, pessoa e item

As mesmas durações, agrupadas de três formas ao mesmo tempo — por projeto para uma fatura de cliente, por pessoa para uma questão de folha de pagamento, por item para uma divisão em nível de ticket.

Regras de faturamento que você escreve

Combine uma regra por projeto ou por uma palavra-chave no item, marque-a como faturável ou não, e cada apontamento é reordenado instantaneamente. O mesmo motor de regras que o Calendar Timesheet usa.

Três passos, nada para conectar ou instalar.

  1. Exportar do Jira

    No buscador de itens, filtre com JQL os apontamentos de que você precisa, depois Export → Export Excel CSV (all fields). Qualquer usuário do Jira que consiga rodar uma busca pode fazer isso — não é preciso ser administrador.

  2. Soltar o CSV

    O arquivo é lido na sua aba do navegador. Nada é enviado, e não há nada para instalar no Jira contra o qual você está faturando.

  3. Revisar e exportar

    Confira os totais, marque as regras de faturamento e exporte um CSV formatado para uma fatura de cliente ou uma questão de folha de pagamento — não o conjunto de colunas do próprio Jira.

O que o relatório realmente contém

Cada número abaixo vem do arquivo que você soltou, calculado da mesma forma seja para um item ou para mil.

Horas totais
Todos os apontamentos do arquivo, somados.
Horas faturáveis
O subconjunto que suas regras marcam como faturável — o número a partir do qual você fatura.
Horas por projeto
Uma linha por projeto do Jira, pronta para ser cotejada com um cliente ou centro de custo.
Horas por pessoa
Uma linha por autor, em todos os projetos em que apontou horas — não só um.
Horas por item
O total de cada ticket, para a divisão em nível de ticket que um cliente pede.
Linhas truncadas ou ilegíveis são sinalizadas
Uma exportação que atingiu o limite ou uma linha de apontamento malformada é relatada, nunca descartada silenciosamente nem somada como se não existisse.

Feito para quem fatura contra o Jira de outra pessoa. Consultorias e agências que faturam um cliente no fim do mês, freelancers com vários Jiras de clientes, times financeiros que conferem o que um time registrou antes de ir para a fatura, e PMs que transformam os worklogs de uma sprint em um relatório de custos.

Diga o que conta como faturável

Um critério de correspondência por vez: por projeto, ou por uma palavra-chave na chave e no resumo do item. As regras são aplicadas em ordem, então uma exceção específica pode ficar acima de uma regra ampla.

  • Corresponder por projeto

    Todo apontamento em um projeto do Jira vira uma categoria — o formato que corresponde a um cliente ou centro de custo.

  • Corresponder por palavra-chave

    Capture um item específico ou um tipo de trabalho independente do projeto, por uma palavra na chave ou no resumo.

  • Substituir manualmente qualquer apontamento

    Uma regra acerta quase sempre; a vez que erra é um ajuste manual, não uma reescrita da regra.

  • A primeira correspondência vence

    As regras são aplicadas de cima para baixo, então uma exceção específica colocada acima de uma regra ampla é lida como está escrita.

Regras e substituições são salvas apenas neste navegador — nada é sincronizado com um servidor.

Feito para faturar a partir do Jira de outra pessoa

  • Agências e consultorias

    Você registra horas no Jira de um cliente, não no seu, e precisa de um número para colocar em uma fatura no fim do mês.

  • Freelancers e prestadores

    Uma pessoa, vários Jiras de clientes, uma planilha que hoje você monta manualmente todo mês.

  • Rateio entre equipes

    O tempo registrado em um projeto compartilhado do Jira precisa ser dividido de volta entre as equipes que o usaram.

  • Uma passagem para o financeiro ou para o PM

    Outra pessoa roda o filtro JQL e exporta o CSV; você transforma isso no número que o financeiro realmente precisa.

O que não faz

Dito com clareza — incluindo o que nem o próprio Jira corrigiu.

  • A coluna de data mostra quando foi enviado, não quando o trabalho ocorreu

    JRACLOUD-77926 (em aberto desde 2017): a exportação do Jira não dá nenhuma forma de diferenciar os dois. Os totais por pessoa, projeto e item em todo o arquivo continuam corretos mesmo assim; uma divisão dia a dia ou semana a semana não estaria, então esta ferramenta não oferece isso.

  • Não se conecta ao Jira

    Não há sincronização ao vivo — um novo apontamento significa exportar de novo e soltar o arquivo mais uma vez.

  • A própria exportação do Jira é limitada a 1.000 ou 10.000 linhas

    O arquivo não traz nenhuma marca quando é cortado. Esta ferramenta sinaliza quando o número de linhas cai exatamente em um desses limites, para que você confira o número de resultados da sua JQL antes de faturar com base nele.

  • O autor costuma ser um ID de conta, não um nome

    A exportação do Jira Cloud frequentemente traz um identificador de conta opaco para quem registrou o tempo, em vez de um nome de exibição. Os totais continuam corretos; o rótulo pode exigir conferência no Jira.

Privacidade

A exportação nunca sai do seu navegador

Uma exportação de apontamentos pode carregar identificadores de conta e resumos de itens — motivo suficiente para que isso funcione da mesma forma que qualquer outra ferramenta da WorkAlio.

A sua exportação nunca é enviada a um servidor. O arquivo é lido nesta aba do navegador e nenhum código desta página o envia: quem cumpre isso é o nosso código, não o navegador. O que o navegador impõe é mais estreito: a Content-Security-Policy da página só admite a nossa própria origem, os dois nomes de host de análise da Cloudflare e o host de onde os nossos vídeos de demonstração são incorporados — esta página não tem vídeo e nunca o alcança. Nenhum deles recebe a sua exportação.

Sem conexão com o Jira. Sem token de API, sem OAuth, sem app para instalar no Jira contra o qual você está faturando — a entrada é o arquivo CSV que você já exportou manualmente.

Sem conta, sem login. Não há nada para criar nem nada para apagar.

Sua exportação não é armazenada. Entre carregamentos de página, só ficam guardadas as regras que você escreve e as alterações que você faz em um único apontamento, salvas com a chave do item e apenas neste navegador.

Perguntas frequentes

Respondidas pelo que a ferramenta faz hoje.

O que esta ferramenta Jira Worklog Report faz?
Ele lê uma exportação CSV de apontamentos do Jira e totaliza as horas por projeto, por pessoa e por item, com regras de faturável/não faturável que você escreve. Roda inteiramente no seu navegador e exporta um CSV formatado para faturamento.
Onde consigo o arquivo CSV?
No buscador de itens do Jira, pesquise com um filtro JQL os apontamentos de que você precisa (por exemplo, worklogDate >= startOfMonth()), depois escolha Export → Export Excel CSV (all fields). Qualquer usuário que consiga rodar essa busca pode exportá-la — não é preciso permissão de administrador.
Por que o Jira não faz isso diretamente?
O próprio rastreador da Atlassian tem o pedido — JRACLOUD-6137, “Generate worklog report”, 124 votos desde 2005 — encerrado como Won't Fix, apontando para o Marketplace. Todo app do Marketplace que preenche essa lacuna precisa ser instalado no Jira contra o qual você está faturando, o que a maioria de quem faz o faturamento não consegue fazer.
Posso confiar nas datas deste relatório?
Para um total em todo o arquivo — por pessoa, por projeto, por item — sim: somar segundos não depende de qual data está na linha. Para uma visão dia a dia ou semana a semana, não: a exportação CSV do Jira traz a data em que um apontamento foi enviado, não a data a que o trabalho se refere (JRACLOUD-77926, em aberto desde 2017), então esta ferramenta não oferece essa divisão de jeito nenhum.
Preciso de acesso de administrador ao Jira?
Não. Você precisa conseguir rodar uma busca JQL e exportar os resultados, o que geralmente qualquer usuário com acesso ao projeto consegue fazer. Nada é instalado no Jira de onde você exporta.
E se minha exportação for grande demais?
O buscador de itens do Jira limita uma exportação CSV a 1.000 linhas historicamente, ou a 10.000 desde que a Atlassian aumentou o limite em 19 de março de 2025 — e o arquivo não traz nenhuma marca quando é cortado. Se o número de linhas cair exatamente em um desses valores, esta ferramenta avisa você para conferir o número de resultados da sua JQL antes de faturar com base no arquivo.
Por que a coluna de autor mostra um código em vez de um nome?
A exportação CSV do Jira Cloud frequentemente reporta o autor do apontamento como um identificador de conta opaco em vez de um nome de exibição — a própria exportação não resolve isso. Os totais por pessoa continuam corretos; cruzar o identificador com um nome pode exigir uma checagem no Jira.
Quanto custa?
Nada. Não há conta, teste nem envio de arquivos, então não há custo para usar.

Controla suas horas em uma agenda em vez do Jira?

Experimente o Calendar Timesheet

Pare de terminar isso numa planilha. Solte a exportação.

Grátis · nada para conectar, nada para instalar · seu arquivo nunca sai do navegador