Rastreabilidade · lote, histórico e a página pública do QR
Rastreabilidade é conseguir contar a história de um lote de grão: de que talhão veio, que insumos foram aplicados, quando foi colhido, quando foi recebido e por onde passou. Esta página explica como criar o lote, alimentar o histórico de eventos e usar o código do QR, que abre uma página pública com a origem do lote e nada de comercial.
O que é um lote aqui
O lote é a unidade de rastreabilidade: um volume de grão identificado por um código seu, com commodity, volume, unidade e data de colheita. Ele pode apontar produtor, talhão de origem e safra. Quando nasce apontando um talhão, o sistema já grava a origem como primeiro evento do histórico, e essa origem não é reescrita depois.
Criar o lote
- Abra o menu Agro e vá à aba Rastreabilidade.
- Escolha o produtor. A lista de lotes dele aparece.
- Preencha o Código do lote, a commodity, o volume, a unidade e a data de colheita.
- Se quiser, escreva uma observação.
- Clique em Novo lote. O lote nasce com a situação aberto e já com um código de QR próprio.
- Clique no lote na lista para abrir o detalhe.
O histórico de eventos
No detalhe do lote você adiciona eventos. Cada evento tem um tipo, um nome de produto, uma referência e uma data. Os tipos disponíveis são origem no talhão, insumo aplicado, colheita, recebimento, transporte e um tipo livre para o que não se encaixa. O histórico é acumulativo: eventos são acrescentados, não editados por cima.
O detalhe também mostra um resumo calculado: total de eventos, se a origem está registrada, a data do primeiro e do último evento e a lista dos insumos distintos aplicados. Isso responde de relance a pergunta mais comum, que é se aquele lote tem cadeia completa ou está com buraco.
Carência entre aplicação e colheita
O intervalo mínimo entre a última aplicação de um insumo e a colheita é o que o receituário chama de carência, e ele vem do rótulo do produto cadastrado na aba Receituário. Quando existem a data de aplicação, a data de colheita e o intervalo do rótulo, o sistema compara os dias e diz se a colheita respeitou o intervalo. Se qualquer um dos três faltar, a resposta é indefinida, nunca conforme. O sistema não afirma conformidade sem base.
A situação do lote
- Aberto: o lote está sendo formado e ainda recebe eventos.
- Embarcado: o lote saiu.
- Fechado: o lote está encerrado.
O código do QR e a página pública
Todo lote nasce com um código de rastreabilidade próprio, mostrado no detalhe do lote como Token QR. Esse código é a chave de uma página pública que qualquer pessoa abre sem login, e que serve para imprimir num QR na embalagem, na nota ou no romaneio. O endereço é o da página de rastreio seguido do código.
A página pública é deliberadamente limitada. Ela mostra o código do lote, a commodity, a data de colheita, a situação, o resumo e a linha do tempo dos eventos, em dez idiomas conforme o idioma do visitante. Ela não mostra preço, cotação, crédito, valor, nome do produtor nem qualquer dado comercial, porque o serviço que a alimenta simplesmente não devolve esses campos.
Onde mais o lote aparece
- No portal do produtor: o produtor autorizado vê os próprios lotes e o código de rastreabilidade de cada um.
- Um código malformado ou inexistente devolve a página de lote não encontrado, sem revelar se o código existe em outra organização.
- Excluir um lote apaga também o histórico dele, e o código do QR deixa de resolver. Um QR já impresso passa a levar à página de não encontrado.
Permissões
Criar lote, adicionar evento e mudar a situação exigem acesso ao módulo Agro com permissão de escrita. A leitura interna respeita o isolamento por organização: você só vê os lotes da sua. A página pública é a única exceção deliberada, e ela é aberta pelo código, não pela sessão.