Dhara Beneficiamento - Manual de Ajuda do Add-on

Dhara Beneficiamento — Manual de Ajuda do Add-on

Dhara Tecnologia. Documento de ajuda • Uso do sistema e referência técnica.

SUMÁRIO:

1. Visão Geral do Módulo

2. Estrutura de Menu

3. Cadastros

4. Rotinas

5. Dashboard

6. Apêndice Técnico — Dicionário de Dados

1. VISÃO GERAL DO MÓDULO:

O add-on Dhara Beneficiamento é um módulo desenvolvido para a plataforma Sankhya que controla todo o ciclo de beneficiamento agrícola. Ele acompanha o produto desde a matéria-prima (a safra colhida) até o produto acabado, passando pelas etapas de processamento, pelo registro de quebras e descartes, pela composição de insumos e embalagens e, ao final, pelo cálculo do custo indireto de produção (CIP).

A partir de um único documento de beneficiamento, o sistema organiza as matérias-primas consumidas, os serviços/etapas aplicados e os produtos gerados, e materializa esse processo em notas de produção dentro do ERP Sankhya. O módulo também oferece cadastros de apoio (safras, áreas de plantio, categorias, máquinas, variedades, origens e motivos de quebra) e uma rotina dedicada ao rateio de custos indiretos.

1.1 Principais recursos

Registro completo do processo de beneficiamento em um documento mestre-detalhe.

Controle de matéria-prima por lote, com origem, variedade e área de plantio.

Gestão de produtos acabados, insumos, embalagens e etapas de processamento.

Registro de motivos de quebra e observações complementares com histórico.

Geração automática de notas de produção e de baixa de quebra no ERP.

Produção parcial de produtos acabados antes do encerramento total.

Cálculo e rateio do Custo Indireto de Produção (CIP) por período e empresa.

1.2 Como este manual está organizado

O documento reúne, para cada tela, a explicação de uso para o usuário final (o que a tela faz e como operá-la) e, quando aplicável, o detalhamento técnico dos campos e tabelas do banco de dados. As telas seguem a mesma organização do menu do add-on: Cadastros, Rotinas e Dashboard. A seção de Rotinas inclui também as regras de negócio implementadas no processamento do servidor. Ao final, o Apêndice Técnico consolida o dicionário de dados completo, incluindo tabelas auxiliares, views e extensões feitas em entidades padrão do Sankhya.

2. ESTRUTURA DE MENU:

O add-on é acessado pelo menu Dhara Beneficiamento, organizado em três grupos:

Cadastros (Dhara Beneficiamento » Cadastros)

Safras — Cadastro dos anos-safra.

Áreas de Plantio — Cadastro das áreas de plantio.

Categoria Produtos — Categorias com regras de descarte, quebra e rendimento.

Configurações Beneficiamento — Parâmetros gerais do módulo.

Máquinas — Máquinas usadas no beneficiamento.

Motivos de Quebra — Motivos padronizados de quebra.

Origem — Origem da matéria-prima.

Variedades Produtos — Variedades dos produtos.

Filtro cálculo CIP - Dhara — Filtros de custos que compõem o CIP.

Rotinas (Dhara Beneficiamento » Rotinas)

Beneficiamento — Tela principal do processo de beneficiamento.

Cálculo CIP — Apuração e rateio do custo indireto de produção.

Dashboard (Dhara Beneficiamento » Dashboard)

Nota Produção com Custo — Painel de produção com custos.

3. CADASTROS:

As telas de cadastro são formulários padrão da plataforma Sankhya (formulários dinâmicos). A operação é sempre a mesma: use o botão Incluir (ou o atalho de nova linha) para criar um registro, preencha os campos e salve; para alterar, selecione a linha, edite e salve; para excluir, selecione a linha e use Excluir. Os campos marcados como obrigatórios precisam ser preenchidos antes de salvar.

3.1 Safras

Cadastra os anos-safra usados no beneficiamento. Cada safra tem um período (início e fim) e pode ter a data prevista de colheita. A abreviação é utilizada na composição de códigos de barras.

Campos

ID_SAFRA — Inteiro, PK (automático). Código da safra.

ABREVIACAO — Inteiro. Abreviação usada em código de barras.

DESCRSAFRA — Texto, Obrigatório. Descrição da safra (apresentação).

DTINICIO — Data, Obrigatório. Data de início da safra.

DTFIM — Data, Obrigatório. Data de fim da safra.

DTPREVINICIO — Data. Data prevista de colheita.

3.2 Áreas de Plantio

Cadastra as áreas de plantio de onde provém a matéria-prima. É um cadastro simples, usado como referência nas matérias-primas do beneficiamento.

Campos

ID_AREAPLAN — Inteiro, PK (automático). Identificador da área de plantio.

DESCRAREA — Texto. Descrição da área (apresentação).

3.3 Categoria Produtos

Classifica os produtos e concentra regras importantes do beneficiamento: qual produto representa o descarte, qual representa a quebra, o local de descarte e se é permitido rendimento (ganho) e produção sem matéria-prima. A categoria também pode ter uma fórmula de composição de insumos associada.

Campos

ID_CATPROD — Inteiro, PK (automático). Identificador da categoria.

DESCRCATEGORIA — Texto, Obrigatório. Descrição da categoria.

CODPRODDESCA — Inteiro (FK Produto), Obrigatório. Produto usado para descarte.

CODPRODQUEBRA — Inteiro (FK Produto). Produto usado para a quebra (matéria-prima).

CODLOCALDESC — Inteiro (FK Local), Obrigatório. Local de estoque para descarte.

PERMRENDIMENTO — Checkbox. Permitir rendimento no beneficiamento?

PERCRENDIMENTO — Decimal. Percentual de rendimento permitido.

PERMPRODSEMMP — Checkbox. Permitir produção sem matéria-prima?

3.4 Configurações Beneficiamento

Tela de parâmetros gerais do módulo. Normalmente existe um único registro (ID 1) que define o comportamento de todo o beneficiamento: tipos de operação (TOP), naturezas, centros de resultado, regras de lote/controle, casas decimais, geração de nota de quebra e a data-base do cálculo CIP. Os campos são organizados em abas.

Campos por aba

Aba Produção

TOPQUEBRA — Inteiro (FK TOP). TOP de quebra.

CODTIPVENDA — Inteiro (FK). Tipo de negociação.

CODCENCUS — Inteiro (FK). Centro de resultado.

CODNAT — Inteiro (FK). Natureza.

Aba Produção Parcial

TOPPRODPARC — Inteiro (FK TOP). TOP de produção parcial.

CODCENCUSPARC — Inteiro (FK). Centro de resultado.

CODNATPARC — Inteiro (FK). Natureza.

PERPARCIALNEG — Checkbox. Permitir produção parcial com estoque negativo?

Aba Beneficiamento

PERALTQTDMP — Checkbox. Permitir alterar qtd. de MP com lançamentos em PA?

PERLOTDUPLI — Checkbox. Permitir lote de MP duplicado?

TAMMAXCONTROLE — Inteiro, Obrigatório. Tamanho máximo do lote/controle.

COMPOCONTROLE — Lista, Obrigatório. Composição do lote/controle: S=Sequencial, C=Complemento do produto, Q=Query.

QUERYLOTE — Texto. Query de composição do lote/controle.

NOTAQUEBRA — Checkbox. Gerar nota de quebra automaticamente?

MOVESTQUEBRA — Checkbox. Movimenta estoque de quebra e descarte?

QTDCASASDECIMALMP — Inteiro, Obrigatório. Casas decimais para matéria-prima.

QTDCASASDECIMALPA — Inteiro, Obrigatório. Casas decimais para produto acabado.

QTDCASASDECIMALIN — Inteiro, Obrigatório. Casas decimais para insumo.

MOVEFUT — Checkbox. Permite MP com estoque futuro.

PAMP — Checkbox. Permite produto acabado como matéria-prima.

PERCREXCLUSAOMP — Decimal. Percentual de exclusão de MP.

Aba Reserva M.P.

CODNATMP — Inteiro (FK). Natureza da movimentação interna.

CODCENCUSMP — Inteiro (FK). Centro de resultado.

TOPMP — Inteiro (FK TOP). TOP de movimentação interna.

Aba Cálculo CIP

DTCALCCIP — Lista, Obrigatório. Data-base do cálculo financeiro: B=Data da baixa, E=Data entrada/saída, N=Data da negociação.

3.5 Máquinas

Cadastra as máquinas utilizadas no beneficiamento, que podem ser associadas ao documento de beneficiamento.

Campos

ID_MAQUINA — Inteiro, PK (automático). Identificador da máquina.

NOMEMAQUINA — Texto. Nome da máquina (apresentação).

3.6 Motivos de Quebra

Cadastra os motivos padronizados de quebra, usados na aba de quebra do documento de beneficiamento para justificar perdas.

Campos

ID_MOTVQUE — Inteiro, PK (automático). Identificador do motivo.

DESQUEBRA — Texto, Obrigatório. Descrição do motivo de quebra.

3.7 Origem

Cadastra as origens da matéria-prima. Usado como referência nas matérias-primas do beneficiamento.

Campos

ID_ORIGEM — Inteiro, PK (automático, somente leitura). Identificador da origem.

DESCRICAO — Texto. Descrição da origem (apresentação).

3.8 Variedades Produtos

Cadastra as variedades dos produtos. Referenciada nas matérias-primas e produtos acabados do beneficiamento.

Campos

ID_VARPROD — Inteiro, PK (automático). Identificador da variedade.

DESCRVAR — Texto. Variedade (apresentação).

3.9 Filtro cálculo CIP - Dhara

Define os filtros de custos que compõem o Custo Indireto de Produção (CIP). Cada filtro determina o percentual do valor a ser utilizado, o tipo de origem do custo (Requisição interna ou Financeiro) e, em grades filhas, os centros de resultado e as naturezas considerados no cálculo.

Campos do cabeçalho (DhCipCabecalho)

ID_CIP — Inteiro, PK (automático). Identificador do filtro.

DESCRICAO — Texto. Descrição (apresentação).

PERC — Decimal. Percentual do valor usado no custo.

CODPROD — Inteiro (FK Serviço). Tarifa CIP (cadastro de serviço).

EXPRESSAO — Texto. Expressão de cálculo.

TIPO — Lista. Origem do custo: R=Requisição Interna, F=Financeiro.

Grades filhas

Centro de Resultado (DhCipCus): relaciona os centros de resultado considerados — campo CODCENCUS.

Natureza (DhCipNat): relaciona as naturezas consideradas — campo CODNAT.

4. ROTINAS:

As rotinas são as telas operacionais do módulo, construídas em HTML5 sobre a plataforma Sankhya. São telas do tipo mestre-detalhe, com abas para os itens e botões de ação que disparam processamentos no servidor. Nesta seção, a descrição de cada campo, de cada aba e de cada botão vem acompanhada das regras de negócio aplicadas pelo sistema, para que o comportamento da tela fique claro em um único lugar.

4.1 Beneficiamento

É a tela principal do módulo. Nela o usuário registra todo o processo de beneficiamento em um documento mestre-detalhe: o cabeçalho identifica o processo (empresa, parceiro, safra, categoria, máquina e responsável) e as abas detalham as matérias-primas consumidas, os produtos acabados gerados, os insumos/embalagens, as etapas de processamento, os motivos de quebra e as observações. A partir desse documento o sistema gera as notas de produção no ERP.

Campos do cabeçalho

ID_BENEF — Inteiro, PK (automático). Identificador do beneficiamento.

CODEMP — Inteiro (FK Empresa). Empresa. Não pode ser alterada enquanto houver MP ou PA lançados.

CODPARC — Inteiro (FK Parceiro). Parceiro.

TIPO — Lista. Tipo: U=Lote único, V=Vários lotes.

DATABENEF — Data. Data do beneficiamento. Usada para validar a data de entrada do lote da MP.

CODSAF — Inteiro (FK Safra). Ano/safra.

ID_CATPROD — Inteiro (FK Categoria). Categoria do produto. Define regras de descarte, quebra e se é permitida produção sem MP.

ID_MAQUINA — Inteiro (FK Máquina). Máquina.

CODTIPOPER — Inteiro (FK TOP). Tipo de operação.

CODRESP — Inteiro (FK Usuário). Gerente de projeto / responsável.

STATUS — Lista. A=Não finalizado, F=Concluído. Com status F, o documento e seus itens ficam bloqueados para alteração/exclusão.

OBSERVACAO — Texto. Instruções para o beneficiamento.

REBENEFICIO — Checkbox. Indica rebeneficiamento.

TOTBENEFICIADO — Decimal, Calculado. Total beneficiado.

TOTPRODACABADO — Decimal, Calculado. Total de produto acabado.

TOTQUEBRA — Decimal, Calculado. Total de quebra.

SALDO — Decimal, Calculado. Saldo (beneficiado – acabado – quebra).

SITUACAO — Texto, Calculado. Situação do beneficiamento.

NUNOTA — Inteiro, Calculado. Nota de produção gerada (preenchida ao gerar a produção).

NUNOTABXQUEBRA — Inteiro, Calculado. Nota de baixa de quebra.

IMPORTANTE:

Regras do cabeçalho: o beneficiamento já faturado (status F) não pode ser alterado ("Não é permitido ALTERAR o beneficiamento. Motivo: Beneficiamento já faturado (STATUS = 'F')."); a empresa não pode ser trocada havendo itens lançados ("Não é permitido alterar a empresa enquanto houver Matéria Prima ou Produto Acabado..."); e a exclusão é bloqueada quando o documento está faturado ou possui itens ("Não é permitido EXCLUIR o beneficiamento.", com os motivos aplicáveis).

Aba Matérias Primas

Itens de matéria-prima consumidos, informados por lote/controle, com quantidade, unidade, local, origem, variedade e área de plantio. A aba mostra a quantidade disponível em estoque e em quilos. Quando a quantidade é informada como zero, o sistema assume o saldo disponível do lote e preenche automaticamente produto, local, área, variedade, controle e unidade, convertendo o valor para quilos. Se as Configurações tiverem TOP de movimentação interna (TOPMP), a inclusão de MP também gera automaticamente uma movimentação interna de reserva do estoque.

IMPORTANTE:

Validações aplicadas ao incluir, alterar ou excluir uma matéria-prima:

MP de outra empresa — "A Matéria Prima selecionada pertence a outra empresa."

Lote com entrada posterior à data do beneficiamento (config MOVEFUT = N) — "Produto com entrada de lote posterior a data do beneficiamento atual."

Controle gerado por produção parcial deste beneficiamento — "Controle de lote não permitido. Este controle foi gerado por uma produção parcial deste beneficiamento."

Lote duplicado no mesmo local (config PERLOTDUPLI = N) — "Já existe este lote neste mesmo local para este Beneficiamento!"

Alterar MP havendo PA (config PERALTQTDMP ≠ S) — "Já existe movimentação parcial para este beneficiamento!"

Beneficiamento finalizado — "Este beneficiamento já foi finalizado!"

MP de outro grupo de produto — "(MP) Existem produtos de outro Grupo já vinculados nesse Beneficiamento!"

Controle acima do tamanho máximo (config TAMMAXCONTROLE) — "Tamanho do Lote/Controle maior que o permitido!"

Exclusão de MP acima do percentual de tolerância (config PERCREXCLUSAOMP) — "A exclusão desta Matéria Prima ultrapassaria o percentual permitido de {perc}% sobre o total de MP."

Aba Produtos Acabados

Produtos gerados no processo, com quantidade, unidade, local, lote, variedade e quantidade de caixas. Cada produto acabado possui, internamente, a grade de Insumos. O lote/controle é montado conforme a configuração "Composição do Lote/Controle": complemento do produto, resultado de uma query configurada, ou o controle da MP acrescido do identificador do item. Ao incluir um produto acabado, o sistema insere automaticamente os insumos/embalagens da fórmula de composição associada.

IMPORTANTE:

Validações aplicadas ao incluir, alterar ou excluir um produto acabado:

Beneficiamento finalizado — "Este beneficiamento já foi finalizado!"

PA com movimento parcial já gerado — "Já foi gerado Movimento Parcial!"

PA de outro grupo de produto — "(PA) Existem produtos de outro Grupo já vinculados nesse Beneficiamento!"

Lançar PA sem MP (categoria não permite produção sem MP) — "Antes de preencher os Produtos Acabados, é necessário preencher pelo menos uma Materia Prima!"

Composição do lote por query sem query configurada — "É necessário realizar a configuração do query na tela 'Configurações Beneficiamento'!"

Alterar o produto de um PA já salvo — "Não é permitido alterar o produto!"

PA acima do percentual de tolerância sobre a MP — "A quantidade de Produto Acabado ultrapassaria o percentual permitido de {perc}% sobre o total de MP."

Excluir PA com beneficiamento concluído — "Um produto acabado não pode ser excluído caso possua um beneficiamento concluído."

Aba Insumos

Insumos e embalagens vinculados a cada produto acabado, com origem manual ou por fórmula de composição (categoria, produto, unidade alternativa ou etapas). O sistema busca automaticamente o custo de reposição e calcula a quantidade total (ou a quantidade unitária, se a total for informada) com base na quantidade do produto acabado e no número de casas decimais de insumo definido nas Configurações. Regras: é obrigatório informar quantidade ou quantidade total ("É obrigatório preencher o campo Quantidade ou Qtd. Total."); itens marcados como não alteráveis não podem ser editados ("Este item não pode ser alterado!").

Aba Etapas

Serviços/etapas de beneficiamento aplicados ao documento, com observação. Não é permitido alterar ou excluir uma etapa quando já existe produto acabado lançado ("Não é permitido Excluir ou Alterar Etapa com produto acabado informado!").

Aba Motivos de Quebra

Motivos de quebra associados ao documento, com observação, usados para justificar as perdas do processo.

Aba Observações

Observações complementares/histórico do documento, com data e usuário preenchidos automaticamente.

Botões do cabeçalho ("Outras Opções")

As ações abaixo são aplicadas ao registro selecionado (ou ao corrente, se nenhum estiver marcado); com a grade vazia, o sistema alerta "Selecione um ou mais registros!".

Gerar Produção Beneficiamento — Gera a nota de produção final. Só permite um registro por vez ("Selecione apenas um registro!") e é bloqueada se o documento já tem nota ou está concluído ("Produção Beneficiamento finalizada!"). Valida as quantidades: PA maior que MP sem permissão da categoria ("Quantidade de Produtos Acabados Maior que a Quantidade de Matérias Primas!"), ausência de MP ("Não informada quantidade de Matérias Primas!") e ausência de PA ("Não informada quantidade de Produtos Acabados!"). Ao concluir, executa em sequência: gera os itens de quebra (produto de descarte da categoria); cria a nota de produção (PA como entrada, MP como saída em KG); exclui movimentos parciais existentes; gera a nota de baixa de quebra quando aplicável (só se NOTAQUEBRA estiver ativo e MOVESTQUEBRA ligado); cria o rateio; confirma as notas; grava o NUNOTA e altera o status para Concluído (F). Em caso de erro, estorna automaticamente os movimentos gerados. Mensagem final: "Produção Gerada com Sucesso!".

Excluir Nota de Produção — Estorna a nota de produção e reabre o beneficiamento. Exige nota preenchida ("Nro. unico Nota Produção não preenchido!"). Regenera a produção parcial dos PAs que a tinham, exclui a nota de baixa de quebra (se existir) e a nota de produção, e volta o status para A limpando os campos de nota e lote.

Abrir Nota de Produção — Abre a Central de Notas no número da nota de produção (NUNOTA).

Abrir Baixa Quebra — Abre a Central de Notas na nota de baixa de quebra (NUNOTABXQUEBRA).

Botões da aba Produto Acabado ("Outras Opções")

Gerar Produção Parcial — Gera uma nota parcial para o produto acabado, sem finalizar o beneficiamento, usando a TOP, a natureza e o centro de resultado de produção parcial das Configurações; ao final grava o número do movimento (NRMOVPARC) e marca o PA como parcial ("Movimento gerado com sucesso!"). É bloqueada se: já existe movimento parcial no Portal ("Existe um movimento parcial no Portal de Mov. Interna para este Produto Acabado, Nro. único: {n}"); o PA já teve movimento gerado ("Geração Movimento Parcial já realizado!"); o estoque de quebra está desligado e o PA é produto de descarte/quebra ("O Beneficiamento selecionado não permite movimentar o estoque de produtos de quebra ou descarte."); PA maior que MP sem permissão de produção sem MP nem de parcial com estoque negativo ("Quantidade de Produtos Acabados Maior que a Quantidade de Materias Primas!"); ou o beneficiamento já está concluído ("Beneficiamento já está concluído!").

Excluir Produção Parcial — Estorna o movimento parcial e libera o PA (zera NRMOVPARC e desmarca o parcial). Exige o número do movimento ("Nro. unico Movimento de Produção Parcial não preenchido!").

Abrir Movimento — Abre a Central de Notas no movimento parcial (NRMOVPARC).

Como as Configurações influenciam esta rotina

NOTAQUEBRA / MOVESTQUEBRA — Controlam se a nota de baixa de quebra é gerada e se o estoque de quebra/descarte é movimentado.

TOPQUEBRA / CODNAT / CODCENCUS — TOP, natureza e centro de resultado das notas de produção e de baixa de quebra.

TOPPRODPARC / CODNATPARC / CODCENCUSPARC / PERPARCIALNEG — Parâmetros e permissão de estoque negativo da produção parcial.

TOPMP / CODNATMP / CODCENCUSMP — Ativam e parametrizam a movimentação interna de reserva de MP.

MOVEFUT / PERLOTDUPLI / PERALTQTDMP / PERCREXCLUSAOMP / TAMMAXCONTROLE — Regras de validação de lote, alteração/exclusão de MP e tolerância de percentual.

COMPOCONTROLE / QUERYLOTE — Definem como o lote/controle do produto acabado é composto.

QTDCASASDECIMALIN — Casas decimais no cálculo de quantidade de insumos.

Fluxo típico de uso

Crie o cabeçalho informando empresa, parceiro, safra, categoria e máquina.

Lance as matérias-primas por lote/controle, com origem, variedade e área de plantio.

Defina as etapas de processamento e, se houver, os motivos de quebra.

Registre os produtos acabados e seus insumos/embalagens.

Use o botão "Gerar Produção Beneficiamento" para materializar a nota no ERP.

Se necessário, use "Gerar Produção Parcial" para entregar parte do produto antes do encerramento total.

4.2 Cálculo CIP

Tela responsável por calcular o Custo Indireto de Produção (CIP) por período e empresa, e ratear o custo entre os produtos beneficiados. O cabeçalho define o filtro de cálculo (cadastrado em Filtro cálculo CIP), a empresa e o período; a grade de resultados mostra, por produto, a quantidade produzida, o custo unitário e o custo total apurados. A grade de resultados é somente de leitura — os botões de incluir, remover e copiar linhas ficam ocultos, pois os valores são gerados pelo cálculo.

Campos do cabeçalho

ID_CIP — Inteiro, PK (automático). Identificador do cálculo.

ID_FILTRO_CALCULO — Inteiro (FK Filtro). Filtro de cálculo CIP utilizado (naturezas, centros de resultado, percentual e origem).

CODEMP — Inteiro (FK Empresa). Empresa.

DATAINIP — Data. Início do período.

DATAFIMP — Data. Fim do período.

Grade de resultados

CODPROD — Inteiro (FK Produto). Produto.

QTDPRDUZIDA — Decimal, Calculado. Quantidade produzida no período.

CUSTOUNI — Decimal, Calculado. Custo unitário (valor total ÷ quantidade produzida, 2 casas).

CUSTOTOTAL — Decimal, Calculado. Custo total apurado.

DHCALCULO — Data, Calculado. Data/hora do cálculo.

Botões

Calcular CIP — Após confirmação, apura o custo indireto do registro selecionado. Percorre cada filtro configurado e soma os valores conforme o tipo: Financeiro (desdobramentos financeiros) ou Requisição/Portal (valor das notas), sempre aplicando empresa, período, centros de resultado, naturezas e a expressão do filtro. A data usada segue a data-base do CIP (baixa, entrada/saída ou negociação). O valor é multiplicado pelo percentual do filtro e dividido pela quantidade produzida para obter o custo unitário. O resultado só é gravado quando o valor total e a quantidade forem maiores que zero, atualizando os custos totais por produto, os movimentos de origem e o custo do produto no cadastro de custos. Mensagem: "Cálculo CIP realizado com sucesso!".

Incluir Insumos Tardio — Após confirmação, trata insumos/matérias-primas lançados após a nota de produção já gerada. Para cada insumo tardio do período/empresa: cria o registro do insumo no produto acabado correspondente; insere um novo item de matéria-prima (saída) na nota de produção existente; e cria o rateio ligando o insumo tardio ao produto acabado de origem, recompondo o custo.

Fluxo típico de uso

Crie ou selecione um cálculo apontando o filtro, a empresa e o período (início e fim).

Clique em "Calcular CIP" — o sistema apura e rateia os custos e grava o resultado por produto.

Se houver custos que entraram depois, use "Incluir Insumos Tardio" para reprocessar.

5. DASHBOARD:

5.1 Nota Produção com Custo

Painel gerencial (dashboard) do add-on que apresenta as notas de produção do beneficiamento junto com seus custos, permitindo acompanhar de forma consolidada o resultado da produção beneficiada.

6. APÊNDICE TÉCNICO — DICIONÁRIO DE DADOS:

Esta seção consolida a estrutura de dados do add-on, incluindo tabelas auxiliares, views e extensões feitas em entidades padrão do Sankhya que não possuem tela própria (são operadas como grades/abas das telas principais ou por integração). As tabelas de cadastros e rotinas já detalhadas nas seções anteriores não são repetidas aqui.

6.1 Documento de Beneficiamento — grades de detalhe

DH_BENEFMP — Matérias Primas (DhBenefMateriaPrima)

ID_BENEF / ID_BENEFMP — Inteiro, PK. Chave do beneficiamento + item.

CODPROD — Inteiro (FK). Produto.

QUANTIDADE — Decimal. Quantidade.

CODVOL — Texto. Sigla da unidade.

CODLOCAL — Inteiro (FK). Local de estoque.

CONTROLE — Texto. Lote.

QTDDISPKG — Decimal. Quantidade em quilos.

QTDDISPEST — Decimal, Calculado. Quantidade disponível em estoque.

ID_VARPROD — Inteiro (FK). Variedade.

ID_AREAPLAN — Inteiro (FK). Área de plantio.

ORIGEM — Inteiro (FK). Origem.

REBENEFIC — Checkbox. Re-beneficiamento.

PLLOTE — Texto. Plantio.

CHAVELOTE — Texto (FK View). Chave do lote.

DH_BENEFPA — Produtos Acabados (DhBenefProdutoAcabado)

ID_BENEF / ID_BENEFPA — Inteiro, PK. Chave do beneficiamento + item.

CODPROD — Inteiro (FK). Produto.

QUANTIDADE — Decimal. Quantidade.

CODVOL — Texto. Sigla da unidade.

CODLOCAL — Inteiro (FK). Local de estoque.

QTDEMKG — Decimal. Quantidade em quilos.

ID_VARPROD — Inteiro (FK). Variedade.

NUMLOTE — Texto. Lote do produto.

QTDCAIXA — Decimal. Quantidade de caixas.

OBS — HTML. Observação complementar.

MOVPARCIAL — Checkbox. Movimento parcial.

NRMOVPARC — Inteiro. Número do movimento parcial.

SALDODISPONIVEL — Decimal, Calculado. Saldo disponível.

STATUS — Texto, Calculado. Status da produção parcial.

DH_BENEFEMB — Insumos (DhBenefEmbalagem)

ID_BENEF / ID_BENEFPA / ID_BENEFEMB — Inteiro, PK. Chave do beneficiamento + PA + insumo.

CODPRODEMB — Inteiro (FK). Produto insumo.

CODVOL — Texto. Sigla da unidade.

QTDEMB — Decimal. Quantidade.

CUSTOREP — Decimal. Custo de reposição.

CODLOCAL — Inteiro (FK). Local de estoque.

QTDEST — Decimal, Calculado. Quantidade em estoque.

CONTROLE — Texto. Controle.

ORIGEM — Lista. MM=Manual, FC=Fórmula categoria, FP=Fórmula produto, FU=Fórmula unidade alt., EB=Etapas.

QTDTOTAL — Decimal. Quantidade total.

PERMITEALTERACAO — Checkbox. Permite alteração.

Demais grades do documento

DH_BENEFETA / DhBenefEtapa — Etapas (serviços) do beneficiamento.

Campos-chave: ID_BENEF, ID_BENEFETA, CODPROD (serviço), OBS

DH_BENEFQBA / DhBenefMotivoQuebra — Motivos de quebra do documento.

Campos-chave: ID_BENEF, ID_MOTVQUE, OBS

DH_BENEFOBS / DhBenefObservacao — Observações com data/usuário automáticos.

Campos-chave: ID_BENEF, ID_BENEFOBS, OBSCOMPLE, DTREG, CODUSU

DH_BENEFEMP_LOCAL / DhBenefEmpLocal — Locais permitidos por empresa.

Campos-chave: CODEMP, CODLOCAL

6.2 Fórmulas de Composição

Definem a composição automática de insumos/embalagem por diferentes chaves. Todas têm o mesmo detalhe: produto/insumo (CODPRODMP), quantidade (QTD), local (CODLOCAL), unidade (CODVOL) e observação (OBS).

DH_FORMCOMPCAT / DhFormCompCat — Por categoria de produto (ID_CATPROD).

DH_FORMCOMPPROD / DhFormCompProd — Por produto (CODPROD).

DH_FORMCOMPSERV / DhFormCompServ — Por serviço (CODPROD).

DH_FORMCOMPUNDALT / DhFormCompUndAlt — Por unidade alternativa (CODPROD + CODVOL + CONTROLE).

6.3 Cálculo de CIP — tabelas de apoio

DH_CIPCUS / DhCipCus — Centros de resultado do filtro CIP.

Campos principais: ID_CIP, CODCENCUS

DH_CIPNAT / DhCipNat — Naturezas do filtro CIP.

Campos principais: ID_CIP, CODNAT

DH_BNECC_CIP / DhBenefCustoCalculadoCIP — Custos totais por produto.

Campos principais: CODPROD, QTDPRDUZIDA, CUSTOUNI, CUSTOTOTAL, DHCALCULO

DH_CIPMOV / DhBenefCIPMov — Movimentos que compuseram o custo.

Campos principais: NUNOTA, NUFIN, CODNAT, CODCENCUS, VALOR

6.4 Views (consultas)

DH_BENEFCTLVW / DhBenefControleView — Saldo por lote/controle (lookup de insumos).

Campos principais: CODEMP, CONTROLE, CODPROD, CODLOCAL

DH_BENEFLTEVW / DhBenefLoteView — Disponibilidade de MP por lote.

Campos principais: CHAVELOTE, CODPROD, QTDDISPKG, RESERVADO, SALDO, CONTROLE, VARIEDADE, AREA

DH_BENEFPAVOLVW / DhBenefPaVolView — Unidades válidas por produto.

Campos principais: CODVOL, CODPROD

6.5 Extensões em entidades padrão do Sankhya

O add-on adiciona campos e relações a tabelas nativas do ERP para integrar o beneficiamento:

CabecalhoNota (TGFCAB) — DH_ID_BENEF — liga a nota de produção ao documento de beneficiamento.

ItemNota (TGFITE) — DH_ID_BENEFPA, DH_ID_BENEF, DH_QTDPRODUCAO, DH_CODPRODFINAL, DH_ID_VARPROD, DH_ID_AREAPLAN, DH_TIPOMOVIM, DH_EXITEM.

Empresa — Relação com DhBenefEmpLocal (locais permitidos).

GrupoProduto — DH_ID_CATPROD — associa o grupo à categoria de beneficiamento.

ProdutoServico (TGFPRO) — DH_ETAPA (CL=Classificado, TO=Tolerado) + fórmulas de composição por produto/serviço.

VolumeAlternativo — Relação com DhFormCompUndAlt.

6.6 Regras de integridade e listeners

As validações descritas na seção de Rotinas são implementadas no servidor por listeners de entidade (disparados na inclusão, alteração e exclusão dos registros) e por um guardião de integridade que bloqueia o cabeçalho do beneficiamento antes de qualquer operação nos itens. Os principais componentes são:

BeneficiamentoListener — Bloqueia alteração/exclusão de beneficiamento faturado ou com itens; impede troca de empresa com itens lançados.

MateriaPrimaListener — Valida empresa, data do lote, duplicidade, grupo e tolerância de MP; gera a reserva de estoque (movimentação interna).

ProdutoAcabadoListener — Valida grupo, exigência de MP, composição do lote e tolerância; insere automaticamente os insumos da fórmula.

EmbalagemListener — Valida quantidade e bloqueio de alteração; calcula quantidade total e custo de reposição do insumo.

EtapaListener — Impede alterar/excluir etapa quando já há produto acabado.

CabecalhoNotaListener / ItemNotaListener — Protegem as notas e itens vinculados ao beneficiamento contra exclusão indevida.

BeneficiamentoIntegrityGuard — Bloqueio (row-lock) e carga do cabeçalho; exige empresa informada antes da matéria-prima.

6.7 Observações técnicas

Os arquivos de dicionário de dados (datadictionary) estão em codificação ISO-8859-1; os rótulos neste manual já estão com a acentuação corrigida.

Campos marcados como "Calculado" são somente leitura, preenchidos automaticamente pelo sistema.

As gerações de notas e os cálculos são processados no servidor por ServicePools Java (BeneficiamentoSP, ProdutoAcabadoSP e CalculoCIPSP); as telas apenas coletam os registros e disparam a ação. As confirmações de notas usam o barramento de confirmação silenciosa.

Alguns trechos de código legado (validação de beneficiamento anterior aberto, recálculo de custo de entrada e ajuste de estoque por falta) estão desativados no fonte e, por isso, não descrevem o comportamento atual.

A visão de negócio complementar descrita no documento do Google Drive não pôde ser incorporada automaticamente por exigir autenticação; caso deseje, o conteúdo pode ser mesclado a este manual posteriormente.