FJFrigo · Faturamento · menu2312 — Compra de Gado

Validações da Compra de Gado

A compra do animal vivo: pecuarista, propriedade, comissão, funrural e as faturas que precisam fechar. Inclui a dupla autorização, que é o que libera o pagamento depois.

Tela: Compra de Gado (2312) Duas autorizações antes de poder pagar Autoridade: o backend — a tela é espelho

Bloqueia

Recusa e não grava. statuscode 400 com a frase abaixo.

Token

Recusa com statuscode 428: a tela pede um token da tela 46 e reenvia. É a única trava desta tela que tem saída.

Aviso

Comportamento calculado pelo sistema, que surpreende quem espera digitar.

Muito é calculado

Funrural, valor líquido, comissão e o total do item saem de fórmula — não são digitados.

Duas autorizações

Duas pessoas diferentes precisam autorizar antes de a compra poder ser paga.

A

O que a tela faz

Para quem atende

Registra a compra do gado vivo: de quem, de qual propriedade, quantas cabeças, a que preço — e gera oito famílias de títulos, entre pagamento ao pecuarista, comissões, frete, funrural e retenções.

O preço é por quilo ou por arroba, conforme o cadastro da filial — e a tela desabilita o campo que não vale. As duas fórmulas não são simétricas: uma arredonda e a outra trunca, e a diferença aparece em centavos.

A compra alimenta o pagamento depois: a baixa do título de compra de gado só é liberada com o faturamento autorizado e com as faturas cobrindo o valor — as duas exigências vêm de parâmetro da filial e são conferidas na hora de pagar, não aqui.

B

Campos obrigatórios

Na ordem em que são conferidos
Bloqueia

Sem Romaneio

QuandoA compra não tem romaneio e a filial tem exige_romaneio_gado ligada — em qualquer país. Sem a coluna no banco, exige. Desde 13/09/2026; antes era só no Brasil, com a filial de apelido GRAO P dispensada.

ConferirO romaneio da compra, ou filial.exige_romaneio_gado (Manutenção › Filiais) para a filial que lança sem ele.

Todos
Bloqueia

Campo [Emitente] em Branco !

Campo [Propriedade] em Branco !

O emitente aquiÉ o pecuarista. A propriedade é a fazenda de origem — e ela precisa estar cadastrada com distância, senão o frete não fecha (abaixo).

Todos
Bloqueia

Campo [Comprador] em Branco !

QuandoFora do Brasil o comprador de gado é obrigatório.

ParaguaiBolívia
Bloqueia

Emitente bloqueado, procure gerente !

ConferirMarcador Bloqueado no cadastro do pecuarista.

Todos
Bloqueia

Propriedade sem distancia definida !

QuandoA propriedade não tem a distância cadastrada — e é ela que entra no cálculo do frete.

SairÉ cadastro da propriedade, não da compra.

Todos
Bloqueia

Campo [Valor Total Liquido] em Branco !

Campo [Valor das Parcelas] em Branco !

Todos
C

O que o sistema calcula sozinho

Não são campos de digitação

Vários valores desta tela parecem editáveis e não são — o servidor recalcula ao gravar. Saber disso evita chamado de "o valor que eu digitei mudou".

ValorComo sai
Funrural Alíquota conforme pessoa física ou jurídica (decidido pelo documento, não pelo cadastro) e a data de entrada. A alíquota aparece ao lado do valor — é assim que se confere se caiu na faixa certa
Valor líquido Calculado dos descontos, cada um convertido pelo câmbio de desconto e arredondado antes de somar. É com ele que as parcelas têm de fechar
Total do item Por quilo: arredonda peso × unitário. Por arroba: trunca peso ÷ 15 × valor da arroba. Um lado arredonda e o outro trunca — não é descuido
Comissão Sai da grade de produtos conforme o tipo (por cabeça, por quilo, quilos por cabeça), com truncamento

Qual peso entra na conta — vivo ou morto — depende do tipo do lançamento; o outro não participa. E o rendimento usa o peso do tipo, não sempre o vivo.

D

Comissão e seus tetos

Recusas de valor
Bloqueia

Problema valor comissao 0

QuandoComissão por cabeça resultando em zero — normalmente o valor por cabeça não foi informado, ou a quantidade está zerada.

Todos
Bloqueia

Valor da Comissao Superior a U$ 10.000

Valor da Comissao Superior a G$ 20.000.000

QuandoA comissão do comprador de gado passa do teto. O teto depende da moeda: um valor em guarani e outro nas demais.

São valores fixos no códigoNão há cadastro para mudá-los.

Todos
Bloqueia

Problema moeda frete

QuandoFalta a moeda do frete numa compra que tem frete.

Todos
E

Vencimento e período fechado

Datas
Bloqueia

Essa data já está fechada — a entrada precisa ser posterior a 2026-07-31.

QuandoData de entrada dentro do período já fechado. A data limite vem na mensagem — o sistema antigo só dizia "data já fechada".

Qual U.D.F.A geral da filial, não a de faturamento.

Todos
Bloqueia

Data de vencimento menor que a entrada!

Data de vencimento nao pode ser sabado/domingo ou segunda!

Segunda também nãoMesma regra da Compra de Carne — e pela mesma razão bancária.

Todos
F

As faturas do pecuarista

Elas têm de fechar com a compra

O pecuarista apresenta uma ou mais notas. A soma delas é conferida contra o valor da compra — e é essa conferência que, mais tarde, libera o pagamento.

Bloqueia

Faturas maiores que o …

Faturas menores que o …

QuandoA soma das faturas não bate com o valor de referência da compra. A mensagem diz para qual lado.

Todos
Bloqueia

Existe fatura já paga — não é permitido regravar as faturas.

QuandoAlguma fatura da compra já foi paga. Regravar a grade apagaria e refaria as faturas, levando o pagamento junto.

Todos
Bloqueia

Informe a data da fatura.

Todos
G

A dupla autorização

Duas pessoas, em ordem

A compra de gado exige duas autorizações, dadas por pessoas diferentes e na ordem. É o que a baixa confere depois: sem as duas, o pagamento não sai.

Bloqueia

A primeira autorização ainda não foi dada.

QuandoAlguém tenta dar a segunda autorização antes da primeira. A ordem importa, em qualquer filial — desde 12/09/2026 também em PJC, onde antes a segunda valia pelas duas.

Todos
Bloqueia

Compra já autorizada por outro usuário — só quem autorizou pode remover.

QuandoTentar retirar uma autorização dada por outra pessoa. Cada um responde pela sua.

Todos
Bloqueia

Usuário sem permissão para esta autorização.

Autorização inválida: …

QuandoO usuário não tem alçada para aquela autorização.

Todos

Onde as duas autorizações fazem falta depois: ao pagar o título da compra de gado. Na baixa individual (221) a exigência depende de parâmetro da filial e o ADM escapa; na baixa coletiva (222) ela vale sempre e o ADM não escapa.

H

Alterar e excluir

Três travas
Bloqueia

Nao sera permitido excluir, ja foi contabilizado !

Compra com titulo ja baixado - nao pode ser excluida. Estorne a baixa antes, ou peça a um usuário ADM/CON/GER/GCO.

A segunda tem saídaA própria mensagem diz: estornar a baixa, ou pedir a alguém dos grupos citados.

Todos
Bloqueia

Esse lancamento ja possui numero de NF autorizada no sefaz !

QuandoA NF-e da compra já foi autorizada pelo fisco. O caminho é cancelar a nota primeiro.

Brasil
Aviso

Dois avisos do sistema antigo que aqui não bloqueiam

ComportamentoO aviso de "sem numeração das páginas do romaneio" avisa e deixa gravar — é assim nos dois sistemas. E dois blocos de regra do sistema antigo (prazo da comissão do comprador e troca de tipo por valor da NF do produtor) estão desativados no próprio fonte: não executam lá nem aqui.

Todos
I

Travas de campo — o que chega desabilitado

Romaneio · Manutenção › Filiais · Token (46)

Fora as recusas de gravação, esta tela trava campos. E o que trava não é permissão: é o romaneio, o país, a cidade da filial e o fato de a compra já existir. Nenhuma regra de acesso destrava isso — a única saída é o token, e só para os campos do romaneio.

CampoFica travado quandoDestrava com
Peso vivo e peso morto do item A compra veio de romaneio — exceto na Bolívia e nas filiais de IPORÁ e GRÃO PARÁ Token (tela 46)
Valor unitário do item A mesma condição do peso — os três estão no mesmo ramo do sistema antigo Token
Valor unitário do item — pelo produto Preço por quilo, filial que não é planta suína (filial.planta_suina) e produto normal. O produto PROAPE (precoce) abre o unitário e trava a arroba; o NC (não chegou) abre peso e arroba. Desde 13/09/2026; antes as cidades IPORÁ, GRÃO PARÁ e BRAÇO DO NORTE ficavam fora — hoje é a marca da filial Token — o botão "Habilitar peso e preço"
Valor por arroba do item A compra veio de romaneio, em qualquer cidade fora da Bolívia. É mais restrito que o peso: aqui IPORÁ e GRÃO PARÁ não escapam Token
Tipo de faturamento A compra já foi gravada. Só na inclusão o combo abre —
Romaneio A compra já tem romaneio, ou já tem título baixado —
Retém funrural No Brasil, sempre — lá o funrural é calculado pelo servidor, e o marcador só mudaria o texto do histórico —
Valor unitário do frete (grade de transportadoras) No Brasil, exceto em GRÃO PARÁ e IPORÁ —
Token

Esta compra veio de romaneio e não permite alterar o peso dos itens — informe um token de liberação.

Esta compra veio de romaneio e não permite alterar o valor por arroba dos itens — informe um token de liberação.

QuandoUm dos três campos do romaneio mudou numa alteração. A tela pede o token e reenvia — é o mesmo fluxo do Título (221).

Onde nasce o tokenManutenção › Token (46), e ele é gerado por um usuário de grupo ADM. Vale para uma gravação e é consumido nela.

PermissãoNão é regra de acesso: é o token. No sistema antigo o caminho é o mesmo — um botão pede "Token para modificación de peso" antes de reabrir o campo.

Todos
Token

O unitário do produto 10111 só se digita em planta suína - informe um token de liberação.

QuandoFilial de preço por quilo que não é planta suína, produto normal (nem PROAPE nem NC), e o unitário do item mudou em relação ao gravado — ou, no item novo, veio preenchido. Desde 13/09/2026.

Na telaO unitário chega travado; o botão "Habilitar peso e preço", na aba de produtos, pede o token e abre peso e preço de todas as linhas. O token é conferido e consumido ao gravar.

Conferirfilial.planta_suina e filial.valor_gado_kg_arroba (Manutenção › Filiais). No fjfrigo_concepcion as 34 filiais são por quilo e nenhuma é suína: lá o preço vem da importação do romaneio, que o web ainda não tem.

Sistema antigoonValidIdProduto (menu2312.prg:8364) e o habilitaPeso (:8257).

Todos
Aviso

Linha "NC" (não chegou) fora da comissão

ComportamentoO produto com NC na descrição (VACA NC, BOI NC) conta para o título, mas não para a comissão. A marca sai do cadastro do produto, na gravação. Até 13/09/2026 a tela não a mandava e a comissão contava essas linhas (178 linhas de compra desde 2025 no central).

Sistema antigo"NC" $ descrição (menu2312.prg:3553).

Todos
Bloqueia

Esta compra não permite alterar o tipo de faturamento — o campo é travado pela configuração da filial.

Esta compra não permite alterar o romaneio — o campo é travado pela configuração da filial.

QuandoUm campo travado sem saída por token mudou numa alteração. A frase troca só o nome do campo: o tipo de faturamento, o romaneio, o marcador de retenção de funrural, o valor unitário do frete.

Onde conferirManutenção › Filiais, campo Cidade; o país sai dos parâmetros da empresa. O romaneio é estado do próprio lançamento.

PermissãoNenhuma. Não há regra que libere, e nem o usuário master passa.

Todos

Por que o romaneio trava o peso. O romaneio é a pesagem oficial: o peso do item veio da balança, não de quem digita. Deixá-lo aberto significaria a compra deixar de corresponder ao que foi pesado — e é por isso que a saída é um token de quem responde por isso, não uma permissão de rotina.

Dois campos que o sistema antigo trava e aqui não: o valor total do item e os totais do cabeçalho, desabilitados sempre lá por serem derivados de peso × preço. Travá-los aqui recusaria alteração legítima de peso ou de preço — a tela continua calculando e o servidor aceita o valor calculado.

E um par que já era assim antes destas travas: valor unitário e valor por arroba nunca são editáveis ao mesmo tempo — quem decide é o campo Preço por kg ou arroba do cadastro da filial, e o outro é derivado.

J

Como o erro chega na tela

Para o QA reproduzir e reportar

Toda resposta sai com HTTP 200; quem diz o que aconteceu é o statuscode no corpo — 400 para as recusas deste documento.

Um detalhe que confunde ao testar: as datas desta tela são gravadas com hora no banco. Um campo de data que aparece vazio na tela, com valor no banco, costuma ser isso.

A ordem das gravações é regra: o COLCAT apaga os títulos de um tipo antes de gravar, e funrural, lavado e pedágio rodam depois dele. Ao investigar títulos faltando, é a ordem que explica.

Ao abrir chamado, copie o código de ocorrência de 8 caracteres dos erros inesperados.

Nenhuma regra bate com essa busca. Tente um trecho menor da mensagem, ou limpe os filtros.