Pecuária
Na pecuária, o custo mora no lote, não no animal. O lote é o grupo de animais de uma categoria, manejado junto, numa propriedade — é a chave de rateio da pecuária, do jeito que o cultivo é a da lavoura. Tudo o que o lote custa (a compra dos animais e os manejos) e tudo o que sai dele (mortes, vendas, apartações) se acumula ali.
O módulo Pecuária aparece no painel quando o Produtor declara a pecuária como atividade. Custo de lote e custo de cultivo nunca se somam: o lote não pertence a safra, e a leitura é por lote.
Lote de animais não é lote de insumo. Neste guia, "lote" é sempre o grupo de animais. O lote de fabricação de um insumo (com validade) é escrito por extenso: lote de insumo.
Lote
O lote tem código, propriedade, categoria (bezerro, bezerra, garrote, novilha, boi, vaca ou touro), fase (cria, recria ou engorda), cabeças e peso de entrada, data de entrada e origem. Machos e fêmeas misturados são dois lotes. A fase é declarada e não depende da categoria: engordar vaca de descarte e recriar novilha são práticas comuns.
Formar o lote#
- No módulo Pecuária, abra Lotes e toque em Novo lote
- Em Formação, escolha a Origem:
- Compra: escolha o Item de compra. Só aparecem itens de lote de animais de compras confirmadas, em reais e que ainda não formaram lote (ver Compras). As cabeças e o peso médio vêm preenchidos pelo item.
- Nascimento: informe as cabeças e o peso de entrada.
- Em Identificação, informe o Código do lote, a Propriedade, a Categoria e a Fase
- Em Entrada, confira a Data de entrada, as Cabeças na entrada e o Peso médio de entrada (kg)
- Em Rendimento, informe o Rendimento de carcaça (%) do lote, ou deixe vazio para usar o padrão (ver Rendimento de carcaça)
- Toque em salvar
Formado por compra, o lote tem as mesmas cabeças do item: número diferente é recusado. O custo da compra vira a reposição do lote. O lote é só em reais: compra em outra moeda não forma lote.
O código é único: repetir o código de outro lote é recusado. Depois de formado, o lote só muda o código e o rendimento de carcaça; categoria e fase mudam por evento datado (ver Mudar categoria ou fase).
Lista de lotes#
A lista busca por código e filtra por situação (ativo ou encerrado), categoria e propriedade. Sem nenhum lote, a tela convida a formar o primeiro, a partir de uma compra de gado ou de nascimentos.
Pesagem
Ninguém pesa 200 cabeças todo mês. A pesagem aceita amostra, e o registro diz qual foi.
- No detalhe do lote, toque em Registrar pesagem
- Informe a Data da pesagem e as Cabeças pesadas
- Em Como informar o peso, escolha Peso médio por cabeça ou Peso total das cabeças pesadas, e informe um dos dois
- Salve
O sistema decide o tipo pelas cabeças presentes na data:
- Lote inteiro: as cabeças pesadas são todas as presentes
- Amostra: menos cabeças que as presentes
- Recusada: mais cabeças que as presentes — a mensagem mostra quantas havia na data
Toda leitura que depende de amostra é rotulada como estimativa. Ganho médio diário, arrobas produzidas, custo por @ e ponto de equilíbrio aparecem com (estimativa por amostra) ao lado do valor quando a última pesagem foi por amostra.
O peso de entrada é a primeira referência: sem nenhuma pesagem depois dele, o lote ainda não tem ganho para mostrar.
Excluir uma pesagem#
Pesagem errada se exclui na seção Pesagens do detalhe do lote, com motivo obrigatório (exige livestock:weighing:delete). Os indicadores voltam a ser calculados sem ela.
Rendimento de carcaça e arroba
Arroba (@) é 15 kg de carcaça. Toda arroba no Agronfe é de carcaça, e o peso vivo vira carcaça pelo rendimento de carcaça.
O rendimento vem de três lugares, nesta ordem:
- Na venda, o peso de carcaça informado dá o rendimento real só das cabeças vendidas
- No lote, o rendimento informado no cadastro vence o padrão
- O padrão, em Pecuária → Rendimento de carcaça (exige
livestock:lot:update), vale para todo lote sem rendimento próprio
O detalhe do lote mostra o rendimento usado com a origem ao lado: definido no lote ou padrão da fazenda. Deixar o padrão vazio é permitido, mas os lotes sem rendimento próprio ficam sem os indicadores por arroba — a tela diz Sem rendimento de carcaça definido, nunca zero.
Manejo
O manejo é o evento que gera custo no lote, como a operação de campo na lavoura. Tem tipo — Alimentação, Suplementação, Marcação, Castração, Desmama, Triagem ou Outro — e linhas de insumo, máquina e mão de obra, mais o custo de terceiros.
Planejar#
- No detalhe do lote, toque em Manejos e depois em Novo manejo
- Escolha o Tipo e a Data
- Se houver prestador, escolha o Prestador de serviço (opcional) e informe o Custo de terceiros (R$)
- Salve: o manejo nasce Planejado
No detalhe do manejo, adicione as linhas:
- Adicionar insumo: o Insumo, o Local de estoque de onde ele sai, a Unidade (vazio usa a do produto), a Quantidade e o Custo unitário (R$). Em insumo rastreado por lote de insumo, o lote de insumo sai ao concluir, e lote de insumo vencido é recusado
- Adicionar máquina: o Equipamento e as Horas. O valor-hora do equipamento (ver Maquinário) congela quando o manejo é realizado
- Adicionar mão de obra: o Trabalhador com vínculo ativo na data do manejo e os Dias ou Horas. O valor da diária ou da hora (ver Mão de obra) congela quando o manejo é realizado
Linha de insumo se edita. Linha de máquina e de mão de obra não se edita: para trocar, remova a linha e adicione de novo. Tudo isso só enquanto o manejo está planejado — manejo realizado esconde a edição de linhas; para corrigir, reabra-o.
O custo só existe quando o manejo é realizado#
Manejo planejado não custa nada no lote. O custo do manejo — Insumos, Máquinas, Terceiros e Mão de obra — só aparece e só entra no lote quando ele é realizado.
Linha sem valor não custa zero. Insumo sem custo unitário, equipamento sem valor-hora ou trabalhador sem taxa deixam a linha Sem valor: a parcela aparece como (incompleto) e a tela conta quantas linhas ficaram fora do custo.
Concluir#
Concluir exige duas permissões: livestock:handling:update e inventory:movement:create — concluir baixa estoque. Sem as duas, a ação nem aparece.
- No manejo planejado, toque em Concluir manejo
- Confirme: os insumos saem do estoque e os valores de máquina e mão de obra congelam na data do manejo
A conclusão é tudo ou nada, e é recusada com a razão quando:
- não há saldo suficiente do insumo no local de estoque
- um dos lotes de insumo está vencido (ver Lotes e Validades)
- há trabalhador sem vínculo ativo na data do manejo
- o lote está encerrado
Reabrir, cancelar e excluir#
As três ações exigem livestock:handling:cancel:
- Reabrir manejo (realizado) pede motivo: os insumos voltam ao estoque e o manejo volta a planejado para ser corrigido
- Cancelar manejo pede motivo: um manejo realizado devolve os insumos ao estoque e deixa de contar no custo do lote. Manejo cancelado não tem mais ação
- Excluir (só planejado) pede confirmação: o manejo sai do lote com as linhas dele
Alteração simultânea#
Se outra pessoa alterou o manejo enquanto você trabalhava, a gravação é recusada com "Alguém alterou este manejo enquanto você trabalhava. Confira o que está gravado antes de salvar de novo." A tela recarrega o que está gravado: confira e refaça.
O manejo na mão de obra e no maquinário#
O manejo é apontamento como a operação de campo: trabalhador ou equipamento apontado num manejo não pode ser excluído, e as horas e diárias apontadas no manejo entram na conciliação da folha.
Morte
- No detalhe do lote, toque em Registrar morte
- Informe a Data da morte e as Cabeças mortas
- Escolha a Causa: doença, acidente, predador, parto, causa desconhecida ou outra causa. Outra causa exige a Descrição da causa; nas demais, a observação é opcional
- Salve
Cada cabeça morta leva a média por cabeça do custo do lote na data da morte. Esse valor vira perda e aparece separado no custo do lote — nunca é redistribuído em silêncio sobre quem ficou.
Morte acima das cabeças presentes na data é recusada, com as presentes na mensagem.
Desfazer uma morte#
Na seção Mortes do detalhe do lote, Desfazer morte pede motivo (exige livestock:lot:update). As cabeças voltam ao lote e a perda volta ao saldo.
Apartação
Apartar é separar cabeças de um lote para formar outro. Exige duas permissões: livestock:lot:create e livestock:lot:update.
- No detalhe do lote, toque em Apartar lote
- Informe a Data da apartação e as Cabeças apartadas
- Em Lote novo, informe o Código do lote novo
- Salve
A tela mostra o saldo de hoje e as cabeças presentes: sai a média por cabeça do saldo na data da apartação, e esse valor entra como reposição do lote novo. O lote novo nasce com origem Apartação.
Não há desfazer apartação. Confira as cabeças antes de salvar.
Mudar categoria ou fase
O bezerro que vira garrote continua no mesmo lote, com o mesmo custo acumulado.
- No detalhe do lote, toque em Mudar categoria ou fase
- Em O que muda, escolha categoria ou fase
- Escolha a Nova categoria ou a Nova fase e a data em Vale a partir de
- Salve
A categoria só anda para frente e dentro do mesmo sexo:
- Machos: bezerro → garrote → boi, e garrote → touro
- Fêmeas: bezerra → novilha → vaca
A tela só oferece as categorias permitidas. Boi, touro e vaca são a última categoria: nelas, só a fase muda.
Custo do lote
O detalhe do lote mostra o Custo do lote em parcelas:
| Parcela | O que é |
|---|---|
| Reposição | O que custou formar o lote: a compra dos animais, ou o custo trazido pela apartação |
| Insumos, Máquinas, Serviços de terceiros, Mão de obra | O custo dos manejos realizados, por parcela |
| Custeio | A soma das quatro parcelas dos manejos |
| Perdas | O custo que saiu com as mortes |
| Custo saído | O custo que saiu com vendas e apartações |
| Saldo no lote | O custo que continua no lote, com as cabeças presentes: reposição + custeio − custo saído − perdas |
Perdas e custo saído são a parte do saldo que saiu, e não somam de novo ao custo. O app nunca soma reposição, custeio e perdas num total único: cada número é lido na sua linha.
Lançamento sem preço deixa o custo incompleto: a tela conta quantos lançamentos ficaram fora, em vez de mostrar um custo menor como se fosse completo.
Toda baixa leva a média por cabeça#
Em toda baixa — morte, venda ou apartação — sai o custo acumulado do lote até a data da baixa, dividido pelas cabeças presentes naquela data, vezes as cabeças que saem. Custos da mesma data entram antes da baixa. Manejo com data posterior se divide só pelas cabeças que ficaram.
Como tudo é derivado dos eventos, um manejo ou uma pesagem lançados com data anterior a uma baixa recalculam o custo que saiu naquela baixa.
Desempenho: custo por @ e ponto de equilíbrio
O topo do detalhe do lote mostra dois números, cada um no seu cartão:
- Custo por @ produzida = custeio ÷ arrobas produzidas
- Ponto de equilíbrio por @ = saldo no lote ÷ arrobas das cabeças presentes, onde saldo = reposição + custeio − custo saído − perdas
A seção Desempenho mostra de onde as arrobas vêm:
- Ganho médio diário, em kg de peso vivo por dia, entre referências de peso consecutivas — o peso de entrada é a primeira
- Arrobas produzidas: o ganho de peso vivo convertido em @ pelo rendimento
Custo por @ e ponto de equilíbrio são números diferentes. O custo por @ produzida deixa a reposição de fora: dividir o preço do bezerro pelas arrobas que ele ganhou não diz nada. O ponto de equilíbrio é o preço da @ abaixo do qual vender hoje dá prejuízo.
A seção Rebanho mostra as Cabeças presentes, a Mortalidade e o Rendimento de carcaça usado.
Indicador sem dado mostra a razão, nunca zero#
Quando falta dado para um indicador, ele não aparece como zero — aparece a razão:
| Mensagem | Quando |
|---|---|
| Sem pesagem registrada | Não há pesagem depois do peso de entrada |
| Sem ganho de peso no período | O ganho foi zero ou negativo: não existe custo por @ produzida |
| Sem rendimento de carcaça definido | Nem o lote nem o padrão têm rendimento |
| Nenhuma cabeça presente no lote | Todas as cabeças já saíram |
Vendas no lote#
A seção Vendas lista cada venda do lote com a receita e, à parte, o custo saído com aquela venda. A margem é a leitura dos dois lado a lado. A venda é feita no módulo de Vendas (ver Vendas).
Encerrar o lote
- No detalhe do lote, toque em Encerrar lote
- Informe a Data do encerramento e o Motivo do encerramento
- Confirme em Encerrar
Se ainda houver cabeças presentes, a tela avisa quantas antes de encerrar.
Lote encerrado não aceita mais lançamento: pesagem, morte, apartação, mudança de categoria ou fase e manejo são recusados, e as ações somem do detalhe. Os animais com brinco só saem dele marcados como vendidos (ver Animal com brinco).
Uma venda cancelada devolve as cabeças ao lote mesmo encerrado. Nesse caso o detalhe avisa: "Uma venda cancelada devolveu cabeças a este lote encerrado".
Animal com brinco
O animal individual é opcional: existe para quem usa brinco e quer rastreabilidade. O animal nunca mostra custo — o custo mora no lote.
Cadastrar#
- No módulo Pecuária, abra Animais e toque em Novo animal — ou abra Animais com brinco no detalhe do lote
- Informe o Brinco (até 40 caracteres), o Sexo e, se souber, o Nascimento
- Escolha o Lote ativo: o animal entra hoje nele
O brinco é único: repetir o brinco de outro animal é recusado. Um lote nunca fica com mais animais com brinco do que cabeças presentes.
Na edição mudam só o brinco, o sexo e o nascimento. O lote muda por movimentação, no detalhe do lote.
A lista busca por brinco e filtra por situação (ativo, morto ou vendido) e lote. O detalhe mostra o Histórico: entrada, mudança de lote, apartação, morte, venda e desfeito, cada um com a data e o lote de origem e de destino.
Mover animais#
- No detalhe do lote, toque em Mover animais
- Escolha o Lote de destino (só lotes ativos) e a Data da mudança
- Escolha os animais e confirme
Marcar animais vendidos#
- No detalhe do lote, toque em Marcar animais vendidos — a ação aparece quando o lote tem venda, mesmo encerrado
- Escolha a Venda e os animais: eles saem na data da venda
As duas telas listam até 100 animais ativos do lote. Com mais animais, a tela avisa "Mostrando só os primeiros 100 animais ativos do lote".
Uma data anterior à última movimentação do animal é recusada, assim como um animal que não está mais ativo no lote. Quando o lote tem mais animais com brinco do que cabeças presentes — depois de uma morte ou venda —, o detalhe avisa "Há animais com brinco que ainda precisam sair do lote".
Limite conhecido: animais marcados como vendidos numa venda que depois é cancelada continuam vendidos. Não há desfazer a marcação.
Permissões
| Permissão | O que libera |
|---|---|
livestock:lot:list |
Abrir o módulo e listar lotes |
livestock:lot:read |
Ver o lote, o custo e os indicadores |
livestock:lot:create |
Formar lote; apartar exige também livestock:lot:update |
livestock:lot:update |
Editar o lote, registrar e desfazer morte, mudar categoria ou fase, encerrar, e o rendimento de carcaça padrão |
livestock:weighing:list |
Consultar as pesagens pela API; no app, as pesagens aparecem no detalhe do lote, com livestock:lot:read |
livestock:weighing:create |
Registrar pesagem |
livestock:weighing:delete |
Excluir pesagem com motivo |
livestock:handling:list |
Listar e ver manejos |
livestock:handling:create |
Planejar manejo |
livestock:handling:update |
Editar o manejo planejado e as linhas; concluir exige também inventory:movement:create |
livestock:handling:cancel |
Reabrir, cancelar e excluir manejo |
livestock:animal:list |
Listar animais com brinco |
livestock:animal:read |
Ver o animal e o histórico |
livestock:animal:create |
Cadastrar animal |
livestock:animal:update |
Editar animal, mover animais e marcar vendidos |
Sem a permissão, a ação some da tela e o servidor recusa.