Como definir o preço do entregável de documentação em projetos de cliente
A documentação é o entregável mais subfaturado de qualquer projeto de cliente. Três modelos fecham o desvio, cada um com perfil de margem e de renovação distinto.
- Aumento por projeto
- 4 500 €
- Subida de renovação
- 67 % para 92 %
- Intervalo por guia
- 400 a 800 €
- Intervalo de avença
- 800 a 1 500 €
A versão curta.
A documentação é o entregável mais subfaturado de qualquer projeto de cliente. Agências que faturam 200 000 € por um build de seis meses continuam a oferecer a passagem de pasta, e depois vêem as renovações a desfazer-se porque o cliente não consegue manter de pé o que foi entregue. Três modelos fecham o desvio: tarifa fixa por guia, pacote ligado ao projeto, avença mensal.
O entregável subfaturado de qualquer projeto de agência
A documentação é oferecida em cerca de nove projetos em cada dez. O build é faturado. O design é faturado. A página de Notion que explica como manter aquilo a correr depois da saída da equipa fica para a tarde de sexta, escrita na última hora faturável e fora do âmbito.
Isto é uma falha de tarifário, não uma falha de documentação. Uma passagem de pasta limpa é a diferença entre 67 % e 92 % de renovação. A agência que despacha um Loom no dia cento e oitenta volta três meses depois para uma reunião de revisão onde o cliente diz "não conseguimos manter isto a correr" e parte para um concorrente.
Uma agência digital de 14 pessoas em Lisboa juntou um pacote de documentação de 4 500 € ao seu âmbito padrão e viu o projeto transformar-se num fluxo de renovação de 92 %. O pacote tinha oito a doze guias, gravados pelo team lead na semana em que cada funcionalidade saiu para produção.
A investigação da NNGroup sobre porque os utilizadores varrem em vez de ler aplica-se à documentação de cliente: a equipa não lê do início ao fim um documento de Notion com 40 páginas. Varre, procura a resposta concreta, sai. O formato passo a passo está pensado para varrer, não para leitura linear.
As três secções seguintes comparam os modelos em receita, margem, risco de derrapagem e renovação. A escolha certa depende de três sinais.
Modelo A: tarifa fixa por guia
O modelo por guia cobra um preço fixo por workflow documentado, tipicamente 400 a 800 € por guia. Um projeto típico produz seis a doze guias, o que gera 2 400 a 9 600 € em cima da fatura do build.
A margem é a mais alta dos três, à volta de 75 % a 82 %. Gravar um workflow com o Capture, o Scribe ou o Tango leva 25 a 45 minutos. A edição soma 30 minutos. O tempo total fica abaixo de uma hora e meia, a um custo horário carregado de 120 a 180 €. A 600 € por guia, a agência arruma 420 a 480 € líquidos.
O risco de derrapagem de âmbito é o mais elevado. O cliente pergunta "também conseguem documentar o deploy?" depois de o âmbito estar assinado. Sem linha por guia, é um extra gratuito. Com preço por guia, a resposta é "sim, mais um guia a 600 €." As agências que hesitam perdem 15 % a 25 % de margem em derrapagens.
O efeito de renovação é moderado. Cerca de metade dos projetos por guia passa para uma avença de manutenção ao quarto mês, quando começam a aparecer guias desatualizados.
| Eixo | Tarifa fixa por guia |
|---|---|
| Receita por projeto | 2 400 a 9 600 € |
| Margem | 75 % a 82 % |
| Risco de derrapagem | Alto (atenuado pelo preço unitário claro) |
| Efeito de renovação | Moderado; cerca de 50 % migram para avença |
| Encaixe ideal | Projetos com 4 a 8 workflows bem delimitados |
O preço por guia funciona melhor quando os workflows são conhecidos no kickoff: agências de branding, estúdios de design que entregam um sistema visual, consultores que documentam uma migração para Cegid. As avaliações G2 sobre a saída por guia do Scribe confirmam aquilo que o cliente paga: um artefacto limpo, com a marca, exportável. Gravar com a extensão Chrome do Capture mantém o custo por baixo de uma hora por guia.
Modelo B: pacote ligado ao projeto
O pacote ligado ao projeto enrola a documentação numa única linha faturada a 2 % a 4 % do build. Num build de 150 000 €, o pacote fica em 3 000 a 6 000 €. Num build de 400 000 €, sobe para 8 000 a 16 000 €. A entrega é um pacote fixo definido no âmbito: oito a catorze workflows que cobrem deploy, gestão de conteúdo, integrações Talkdesk ou Outsystems, e casos limite comuns.
A margem é sólida, à volta de 65 % a 75 %. Uma agência de 14 pessoas que pôs este modelo a correr observou um pacote médio de 4 500 € por projeto sobre doze meses de trabalho. O esforço caiu de 14 horas para 4 horas por projeto, porque a gravação acontecia na semana em que cada funcionalidade saía, com a memória ainda fresca.
O risco de derrapagem é o mais baixo dos três. O pacote é fechado no âmbito: oito a doze guias, com nome e critérios de aceitação. Pedidos fora do âmbito acionam um aditamento. As agências reportam menos de 10 % de perdas por derrapagem, contra mais de 20 % nos projetos por guia.
O efeito de renovação é o mais forte. A mesma agência subiu de 67 % para 92 % ao longo de quatro projetos. O pacote tornou-se um ativo comercial: prospetos que tinham visto um pacote anterior pediam o mesmo antes de assinar.
| Eixo | Pacote ligado ao projeto |
|---|---|
| Receita por projeto | 3 000 a 16 000 € |
| Margem | 65 % a 75 % |
| Risco de derrapagem | Baixo (definido no âmbito) |
| Efeito de renovação | Forte; +25 pontos documentados |
| Encaixe ideal | Builds de 3 a 9 meses com momento claro de passagem |
O pacote converte a documentação de "aquilo que devíamos fazer" em "aquilo que vendemos". Pôr o preço dentro do âmbito muda três coisas: o cliente espera o pacote, o team lead agenda-o, a agência fatura-o. Uma equipa que trabalha com o plano Capture a 12 $ USD por lugar absorve o custo de produção dentro do preço do pacote.
Modelo C: avença de documentação
A avença cobra uma mensalidade de manutenção depois do fim do projeto, tipicamente 800 a 1 500 € para clientes pequenos e 2 000 a 4 000 € para clientes maiores. O entregável é o que a evolução do produto exigir: regravar guias quando uma UI muda, documentar funcionalidades novas, refrescar capturas de ecrã quando uma ferramenta de terceiros recebe atualização.
A margem é moderada, à volta de 60 % a 70 %. As avenças carregam custos que os modelos por projeto não têm: comunicação com o cliente, controlo de alterações, relatório mensal. Uma avença de 1 000 € cobre 4 a 6 horas de trabalho mais um ponto mensal de 30 minutos. O custo carregado de esforço fica em 300 a 400 € por mês, o que deixa 600 a 700 € líquidos.
O risco de derrapagem é moderado. O cliente pede "mais um guia" entre ciclos, e é para isso que a avença existe, mas tem de haver tecto rígido. As agências fixam um plafond horário documentado (tipicamente 6 horas por mês) e faturam o excedente a 150 a 200 € por hora. Sem plafond, perdem dinheiro em três meses.
O efeito de renovação é o mais forte por euro investido. Uma avença de 1 000 € durante dois anos vale 24 000 € de receita recorrente, muito acima de um pacote de 6 000 € de uma só vez. A retenção do setor neste tipo de microavença anda nos 88 % a 95 % anuais.
| Eixo | Avença de documentação |
|---|---|
| Receita por projeto | 9 600 a 36 000 € (anualizado) |
| Margem | 60 % a 70 % |
| Risco de derrapagem | Moderado (plafond horário) |
| Efeito de renovação | Máximo; cerca de 90 % de retenção anual |
| Encaixe ideal | Clientes com evolução de produto ativa pós-lançamento |
A avença é aquilo que a maioria das agências deixa em cima da mesa. A agência com um pacote Capture a 4 500 € por projeto viu vários clientes pedirem depois um arranjo de manutenção sem ter esse modelo no preçário. As avenças convertem receita pontual num livro recorrente.
Como escolher: os três sinais que decidem
O modelo certo lê-se na assinatura do âmbito a partir de três sinais que determinam qual maximiza receita e probabilidade de renovação.
Primeiro sinal: quão fechado está o universo da documentação. Se os workflows são conhecidos no kickoff (uma migração delimitada, uma passagem de design system definida, um build com âmbito fixo), o pacote vence. Se ficam em aberto, o preço por guia mantém a margem saudável sem absorver âmbito ilimitado.
Segundo sinal: quão ativa será a evolução do produto após o projeto. Um produto entregue e congelado precisa de um pacote único. Um produto que evolui mensalmente é o encaixe perfeito para uma avença. Pergunte ao cliente como é o roadmap dos seis meses depois do fecho. Releases semanais ou quinzenais são sinal claro de avença.
Terceiro sinal: quão sensível ao preço está o cliente. O preço por guia é o mais transparente. O pacote é o mais cómodo para quem prefere certeza de preço fixo. A avença exige que o cliente perceba que documentação é um produto. Clientes na terceira ou quarta agência percebem; estreantes raramente percebem.
Os três modelos não são exclusivos. A estrutura mais sólida combina os três: pacote no âmbito, tarifa por guia para extras, avença mensal proposta na passagem de pasta. A mesma agência viu a renovação subir de 67 % para 92 % e somou avença para metade dos clientes.
A investigação da NNGroup sobre o padrão de leitura em F na web confirma o que as agências observam nos portais de cliente: guias visuais rendem três a quatro vezes mais em leitura completa do que documentação redigida. A página de preços do Capture mostra a economia de plano de equipa que faz os três modelos funcionarem em estruturas de 8 a 30 pessoas. Para quem ainda avalia ferramentas, ver as melhores alternativas ao Scribe em 2026.
Perguntas frequentes.
- Qual é a margem real de cada um dos três modelos?
Por guia anda em 75 % a 82 %. Pacote ligado ao projeto fica em 65 % a 75 %. Avenças ficam em 60 % a 70 %. O fosso reflete a sobrecarga: por guia quase não carrega nada, o pacote tem gestão de âmbito, a avença tem ponto mensal e controlo de alterações. Os três passam o limiar de 50 % que a maioria das agências exige.
- Os clientes resistem ao preço por guia?
Sim no primeiro projeto, raramente depois. A objeção é "600 € por um guia é caro". A resposta é mostrar um guia de exemplo na conversa de âmbito. Assim que o cliente vê o artefacto, o preço deixa de ser abstrato. As agências que hesitam em defender o preço veem a margem a erodir-se. Os princípios da NNGroup sobre legibilidade, leitura e compreensão ajudam a explicar o que justifica o preço.
- Como funciona a avença depois do fim do projeto?
Uma avença de documentação arranca na passagem de pasta e corre a 800 a 1 500 € mensais para clientes pequenos, 2 000 a 4 000 € para clientes maiores. O âmbito é fixado por plafond horário documentado (em geral 6 horas por mês), que cobre regravação de guias, documentação de funcionalidades novas e atualização de capturas de ecrã. O excedente é faturado a 150 a 200 € por hora. Faturação mensal, com compromisso inicial de 90 dias. A retenção anda nos 88 % a 95 % anuais.
- A documentação deve ser um âmbito separado ou uma linha no âmbito do build?
Linha no âmbito do build para os modelos por guia e por pacote, âmbito separado para a avença. O âmbito do build carrega o contexto que torna o que está dentro fácil de explicar. A avença vive depois do build e beneficia de um contrato que não termina automaticamente quando o build fecha. A maioria das agências estrutura isto como "Anexo Pacote Documentação" mais "Acordo de Avença" assinado na passagem de pasta.
- E se o cliente recusar pagar a documentação como linha separada?
Mostre as contas da renovação. A agência que correu a experiência do pacote viu a renovação subir de 67 % para 92 % depois de pôr preço no pacote. Num projeto de 150 000 €, esse aumento de 25 pontos vale cerca de 37 500 € no ciclo seguinte, muito acima da linha de 4 500 €. O recuo é embalar de forma invisível mas explicitar no âmbito. A alavanca perdida é o upsell na avença.
Pronto para faturar a documentação em vez de a oferecer?
O Capture transforma cada workflow de cliente num guia passo a passo em menos de uma hora. O plano Team começa em três lugares, a 12 $ USD por lugar por mês. As agências usam-no para gravar pacotes embalados e guias de avença sem perder margem.
Guias passo a passo: seis equipas, uma só mecânica
A pessoa sénior que conhece o fluxo de trabalho de cor torna-se o estrangulamento. O wiki apodrece. O Loom que ninguém vê acumula pó num ficheiro. Os guias passo a passo quebram esse padrão nas seis equipas que vimos a fazer isto em produção.
Melhores alternativas ao Scribe em 2026: sete ferramentas, comparação honesta
O Scribe faz o trabalho. Não é a única escolha, e para uma equipa de Customer Success ou de TI portuguesa que constrói uma biblioteca multilingue com orçamento abaixo do plano Enterprise, deixou de ser a escolha óbvia. Sete candidatos, ordenados pelos critérios que decidem ao quarto mês, não pelos que brilham na demonstração.
Grave um workflow.
Extensão Chrome gratuita. Sem registo.