Começar de graça

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#

  1. No módulo Pecuária, abra Lotes e toque em Novo lote
  2. 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.
  3. Em Identificação, informe o Código do lote, a Propriedade, a Categoria e a Fase
  4. Em Entrada, confira a Data de entrada, as Cabeças na entrada e o Peso médio de entrada (kg)
  5. Em Rendimento, informe o Rendimento de carcaça (%) do lote, ou deixe vazio para usar o padrão (ver Rendimento de carcaça)
  6. 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.

  1. No detalhe do lote, toque em Registrar pesagem
  2. Informe a Data da pesagem e as Cabeças pesadas
  3. Em Como informar o peso, escolha Peso médio por cabeça ou Peso total das cabeças pesadas, e informe um dos dois
  4. 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:

  1. Na venda, o peso de carcaça informado dá o rendimento real só das cabeças vendidas
  2. No lote, o rendimento informado no cadastro vence o padrão
  3. 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#

  1. No detalhe do lote, toque em Manejos e depois em Novo manejo
  2. Escolha o Tipo e a Data
  3. Se houver prestador, escolha o Prestador de serviço (opcional) e informe o Custo de terceiros (R$)
  4. 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.

  1. No manejo planejado, toque em Concluir manejo
  2. 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

  1. No detalhe do lote, toque em Registrar morte
  2. Informe a Data da morte e as Cabeças mortas
  3. 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
  4. 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.

  1. No detalhe do lote, toque em Apartar lote
  2. Informe a Data da apartação e as Cabeças apartadas
  3. Em Lote novo, informe o Código do lote novo
  4. 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.

  1. No detalhe do lote, toque em Mudar categoria ou fase
  2. Em O que muda, escolha categoria ou fase
  3. Escolha a Nova categoria ou a Nova fase e a data em Vale a partir de
  4. 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

  1. No detalhe do lote, toque em Encerrar lote
  2. Informe a Data do encerramento e o Motivo do encerramento
  3. 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#

  1. No módulo Pecuária, abra Animais e toque em Novo animal — ou abra Animais com brinco no detalhe do lote
  2. Informe o Brinco (até 40 caracteres), o Sexo e, se souber, o Nascimento
  3. 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#

  1. No detalhe do lote, toque em Mover animais
  2. Escolha o Lote de destino (só lotes ativos) e a Data da mudança
  3. Escolha os animais e confirme

Marcar animais vendidos#

  1. No detalhe do lote, toque em Marcar animais vendidos — a ação aparece quando o lote tem venda, mesmo encerrado
  2. 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.