Pagamento do leite: explica cada euro ao sócio

«Porque recebi menos pelo leite este mês, se a qualidade até melhorou?»

Se geres uma cooperativa ou acompanhas os seus pagamentos, precisas de responder com mais do que o preço médio do mês. Tens de mostrar as entregas consideradas, as análises que contaram, a tabela aplicada e os movimentos que explicam o valor transferido. Se és o produtor, precisas de conseguir seguir essa conta sem andar a pedir ficheiros a três pessoas.

O problema não se resolve com uma resposta mais simpática. Resolve-se tornando o pagamento verificável. Uma camada de IA fundada nos dados da cooperativa, só de leitura e auditada, pode ajudar a fazer essa consulta. Mas as contas e as regras têm de continuar fora da imaginação do modelo.

O total está no ERP. A explicação pode estar espalhada

Um mapa de pagamento mostra o resultado. Nem sempre mostra, de forma acessível, o caminho que levou até ele.

As quantidades podem estar no registo de receção; os resultados laboratoriais, noutro sistema; a tabela de valorização, num documento com uma data de entrada em vigor; os acertos, na conta-corrente. O atendimento acaba por reconstruir esse caminho sempre que alguém pergunta por uma diferença.

Imagina que o sócio compara o valor recebido em setembro com o de outubro. Uma melhoria da composição não demonstra, por si só, que deveria ter recebido mais. Pode ter entregue menos quantidade. Pode existir um acerto de outro período. Ou pode haver um erro. A resposta tem de separar essas hipóteses e demonstrar qual delas está documentada.

No fecho de outubro, faz mais sentido testar esta explicação num período já fechado do que lançar um assistente com acesso a tudo. O objetivo inicial é limitado: reproduzir um pagamento, identificar as suas fontes e explicar a diferença para o período anterior.

Análise disponível não é análise elegível para pagamento

Nos Açores, há uma distinção concreta que um chatbot genérico facilmente perde. A Portaria n.º 24/2019, republicada pela Portaria n.º 105/2024, de 26 de dezembro, estabelece regras de classificação do leite cru à produção. Esta última portaria produz efeitos desde 1 de janeiro de 2025.

O artigo 13.º da versão republicada prevê médias mensais ponderadas para a matéria gorda e a matéria proteica. Determina também que os teores médios usados no pagamento são expressos ao centésimo dos valores percentuais, com arredondamento. Para outros parâmetros, o método é diferente: as células somáticas usam uma média geométrica que considera o mês em causa e os dois anteriores, nas condições ali previstas; os microrganismos consideram o mês em causa e o anterior.

Isto impede uma simplificação tentadora: ir buscar a última análise e tratá-la como a classificação de todo o mês.

Há outra diferença importante. O artigo 16.º prevê análises de apoio solicitadas ao SERCLA, mas exclui os seus resultados da classificação do leite. Um resultado pode ser útil para acompanhar a exploração e, ainda assim, não poder entrar na conta do pagamento.

Por isso, a integração precisa de conservar a finalidade da análise, o período, o estado do resultado e a identificação da unidade de produção. Não basta juntar ficheiros pelo nome do produtor. Também não se deve presumir que cada entrega tem uma análise individual: a ligação entre entregas e classificação tem de respeitar o método aplicável, validado pelo responsável.

Um exemplo: melhor qualidade, menos dinheiro recebido

Os valores seguintes são inteiramente fictícios. Servem para demonstrar a explicação, não são preços atuais, uma tabela comercial ou uma recomendação de pagamento.

Admite uma cooperativa com esta tabela de exemplo, validada para todo o período:

| Elemento | Regra fictícia |
| — | — |
| Preço base | 0,400 €/litro |
| Referência de matéria gorda | 3,70% |
| Referência de matéria proteica | 3,20% |
| Acréscimo por cada 0,01 ponto percentual de gordura acima da referência | 0,0005 €/litro |
| Acréscimo por cada 0,01 ponto percentual de proteína acima da referência | 0,0010 €/litro |

As referências de 3,70% e 3,20% constam do anexo do diploma referido; os preços e coeficientes monetários desta tabela são inventados. A portaria não permite deduzir daqui quanto paga uma cooperativa concreta: é necessário consultar a tabela que efetivamente se aplica.

Neste exercício, o produtor entregou 20 000 litros. A classificação mensal elegível, já apurada segundo as regras aplicáveis, apresenta 3,82% de matéria gorda e 3,28% de matéria proteica. Não estamos a calcular estas médias a partir de uma análise isolada.

A gordura fica 12 centésimos de ponto percentual acima da referência: 12 × 0,0005 = 0,006 €/litro. A proteína fica oito centésimos acima: 8 × 0,0010 = 0,008 €/litro.

Sem outras bonificações ou penalizações neste exemplo, o preço resulta em 0,400 + 0,006 + 0,008 = 0,414 €/litro. A valorização das entregas é, portanto, 20 000 × 0,414 = 8 280 euros, antes dos restantes movimentos e do tratamento fiscal aplicável.

No mês anterior, o mesmo produtor tinha entregue 22 000 litros a 0,410 €/litro: 9 020 euros, nessa mesma base de comparação. A diferença de menos 740 euros decompõe-se assim:

• Menos 2 000 litros, valorizados ao preço anterior: menos 820 euros.
• Melhoria de 0,004 €/litro sobre os 20 000 litros atuais: mais 80 euros.
• Efeito conjunto: −820 + 80 = menos 740 euros.

A qualidade melhorou e acrescentou valor. Não compensou a redução da quantidade entregue. Esta decomposição responde à pergunta sem culpar a qualidade nem esconder a quantidade num preço médio.

Se existirem ainda 180 euros de deduções documentadas na conta-corrente, esse subtotal passa para 8 100 euros, antes de outros movimentos eventualmente aplicáveis. Não se deve chamar «penalização de qualidade» a esse desconto sem verificar a sua natureza. E não se deve confundir valorização do leite com montante transferido.

A IA explica; o código calcula

Uma implementação séria separa três responsabilidades.

Primeiro, uma ligação autorizada consulta os dados necessários: entregas aceites, classificação elegível, versões das tabelas, documento de liquidação e movimentos associados. Pode começar por exportações controladas ou por uma interface existente. Não pressupõe que o laboratório ou o ERP disponibilizam uma API, nem exige substituir esses sistemas.

Depois, código testável executa as regras aprovadas: unidades, períodos, ponderações quando aplicáveis, arredondamentos e coeficientes. Litros e quilogramas não são intercambiáveis sem uma regra de conversão validada. Uma tabela atual não pode ser aplicada retroativamente só porque é a primeira que aparece na pesquisa.

Só então o modelo transforma o resultado estruturado numa explicação. Pode responder a «quanto desta diferença veio da quantidade?» e indicar os registos que sustentam cada parcela. Não deve escolher uma fórmula porque encontrou um documento parecido, nem inventar um coeficiente em falta.

Fundada nos teus dados significa isto: os montantes vêm de registos identificados e de cálculos reproduzíveis. Não significa apenas que o chatbot recebeu alguns PDF. Mesmo assim, a resposta precisa de validação: os valores apresentados devem ser confrontados com o resultado calculado, e uma explicação sem suporte deve ser bloqueada.

Quando faltam dados, a resposta tem de ficar incompleta

Suponhamos que o ERP usa uma classificação e o ficheiro recebido do laboratório contém uma correção posterior. O sistema não deve escolher silenciosamente o resultado mais recente e declarar que o pagamento está errado. Tem de mostrar a divergência, as datas e o estado de cada versão. Pode estar a comparar o que era conhecido no fecho com informação chegada depois.

O mesmo vale para uma tabela sem vigência identificada ou uma amostra em falta. O diploma prevê situações específicas para ausência de amostras; isso não autoriza o assistente a preencher qualquer lacuna com a média anterior. As condições de aplicação têm de estar demonstradas.

Uma resposta útil seria: «Consigo justificar a quantidade e os movimentos da conta-corrente. Não consigo validar a bonificação porque falta identificar a tabela aplicável ao período.» É menos vistosa do que uma conta completa inventada. Também é muito mais útil a quem tem de prestar contas.

Só de leitura não significa acesso de todos a tudo

O assistente não altera análises, tabelas, liquidações ou ordens de pagamento. Uma divergência segue para o processo normal de revisão, com o responsável competente. A conta usada para consultar os sistemas deve ter permissões técnicas só de leitura, não apenas uma instrução escrita para «não alterar».

O produtor consulta os seus dados; o trabalhador da cooperativa consulta o que a sua função autoriza. Se a interface for WhatsApp, ter um número de telefone não dispensa autenticação e controlo de acesso. Não é aceitável responder a um sócio com resultados ou movimentos de outro.

A auditoria deve permitir reconstruir a consulta: quem perguntou, que período consultou, que fontes e versões foram usadas, qual a versão da regra de cálculo e que resposta foi apresentada. O registo precisa de proteção e de uma política de conservação adequada, não de guardar indefinidamente cópias desnecessárias de dados pessoais.

«Mas o nosso programa já faz esse mapa»

Então começa por esse mapa. Se permite reproduzir as parcelas, consultar as fontes e esclarecer o sócio sem trabalho adicional, não precisas de acrescentar IA a esse passo.

A camada conversacional faz sentido quando a pergunta atravessa registos que o relatório não reúne ou quando o utilizador precisa de explorar a diferença: «Que entregas entraram?», «Esta análise contou porquê?», «O que mudou face ao mês anterior?» A vantagem proposta é esse acesso orientado à evidência, não a promessa de que nenhum fornecedor já o faz.

Para validar, escolhe um mês fechado e um conjunto limitado de pagamentos, incluindo uma situação normal, um acerto e uma divergência conhecida. Confere se o sistema reproduz os valores, apresenta as fontes certas, recusa o que não consegue demonstrar e impede consultas a dados de outros sócios. Mede o tempo de esclarecimento antes e depois; não pressuponhas uma poupança.

Na Leiritech, a proposta é construir esse circuito contigo, com uma equipa pequena que escreve o código: integração com os teus sistemas, cálculo determinístico e IA só de leitura, auditada e fundada nos teus dados. O âmbito do projeto não precisa de ficar dependente da aprovação de financiamento.

Escreve para hello@leiritech.com para definir um teste com um mapa de pagamento anonimizado, a tabela aplicável e os registos que o suportam, partilhados por um canal acordado. O primeiro resultado a exigir é simples: conseguir explicar cada parcela sem alterar um único pagamento.