empenho1n — Cadastro de Rotina v3 (Mestre-Detalhe) Fabmed

🗺 Rota de transporte

📝

Pedido venda PE

Origem5 FABMED_PE

Destino5 FABMED_PE

Tipo de Operação10001 Pedido venda

Natureza3.01.001 Rec Venda

Centro de ResultadoPE-VND Vendas PE

🔒

Reserva BA→PE

Origem1 FABMED_BA

Destino5 FABMED_PE

Tipo de Operação900 Reserva

Natureza9.99.001 Reserva

Centro de ResultadoBA-LOG Logística BA

📦

Transf BA→PE

Origem1 FABMED_BA

Destino5 FABMED_PE

Tipo de Operação1012 Transf PE A

Markup8.50%

Natureza5.01.010 Transf int

Centro de ResultadoBA-LOG Logística BA

🔒

Reserva MS→PE

Origem2 MS

Destino5 FABMED_PE

Tipo de Operação900 Reserva

Natureza9.99.001 Reserva

Centro de ResultadoMS-LOG Logística MS

📦

Transf MS→PE

Origem2 MS

Destino5 FABMED_PE

Tipo de Operação1012 Transf PE A

Markup8.50%

Natureza5.01.010 Transf int

Centro de ResultadoMS-LOG Logística MS

🔒

Reserva ZUCK→PE

Origem3 ZUCK

Destino5 FABMED_PE

Tipo de Operação900 Reserva

Natureza9.99.001 Reserva

Centro de ResultadoZK-LOG Logística ZK

📦

Transf ZUCK→PE

Origem3 ZUCK

Destino5 FABMED_PE

Tipo de Operação1012 Transf PE A

Markup8.50%

Natureza5.01.010 Transf int

Centro de ResultadoZK-LOG Logística ZK

TOPs em uso · view do Fluxo

Lista derivada automaticamente dos nodes no canvas. Pra mudar TOP, edite o node correspondente em Fluxo.

ℹ View read-only: esta tabela é gerada lendo cada node do fluxo. Sem cadastro próprio — fonte da verdade é o canvas.

📦 TOPs usados em FabmedPE (3 nodes)

CODTIPOPER	Apelido	Categoria	Em quantos nodes	Usado em
10001	PEDIDO	pedido venda	1	Pedido venda PE (origem=destino=5)
900	RESERVA	reserva	3	Reserva BA→PE · Reserva MS→PE · Reserva ZUCK→PE
1012/1013	TRANSF_PE_A/B	transf interestadual	3	Transf BA→PE · Transf MS→PE · Transf ZUCK→PE

📋 Detalhamento node × TOP

Node	Tipo	Empresa origem	Empresa destino	CODTIPOPER	Ação
Pedido venda PE	pedido	5	5	10001	→ editar no Fluxo
Reserva BA→PE	reserva	1	5	900	→ editar no Fluxo
Transf BA→PE	transferência	1	5	1012/1013	→ editar no Fluxo
Reserva MS→PE	reserva	2	5	900	→ editar no Fluxo
Transf MS→PE	transferência	2	5	1012/1013	→ editar no Fluxo
Reserva ZUCK→PE	reserva	3	5	900	→ editar no Fluxo
Transf ZUCK→PE	transferência	3	5	1012/1013	→ editar no Fluxo

⚙ Regras fixas no código (Java/TS). Não aparecem no layout — só executam.

ID	Regra	Condição	Ação se falhar	Origem Java
P1	transf_automatica_habilitada	parceiro.AD_TRANSAUTOMATICA = 'S'	SKIP fluxo	TransferenciaServicePE.L77-90
P2	estoque_suficiente_origem	empresa origem tem QTD > 0 do lote	SKIP item	EstoqueDAO
P3	estoque_maior_agrupmin	estoque >= AGRUPMIN do produto	SKIP item	PedidoService.L92
P4	validade_lote_ok	DTVAL >= hoje + EMPVALMIN meses (se parceiro.AD_ACEITATROCAVALIDADE != 'S')	SKIP lote	Utils.filtrarPorValidade
P5	status_empenho_ativo	AD_CONTRLICITEEMPENHOS.STATUS in ['AP','E','FS']	SKIP item	ItemEmpenhoAutomaticoDAO.L96
P6	produto_existe_no_destino	TGFPRO existe no CODEMP destino com CODVOL válido	SKIP item	PedidoService
P7	parceiro_destino_valido	TGFPAR destino existe e ativo	BLOQUEIA fluxo	PedidoService
P8	top_pertence_categoria_correta	CODTIPOPER bate com tipo de operação esperado (pedido/transf/reserva)	BLOQUEIA	novo · pre-flight

🔴 Validações de bloqueio (THROW — não envia)

ID	Regra	Condição	Ação	Origem Java
V9	qtd_zero_priorizado	PRIORIDADE>0 e QUANTIDADEP=0	BLOQUEIA item	EvtItens.L118
V10	qtd_excede_item	QUANTIDADEP > QUANTIDADE	BLOQUEIA item	EvtItens.L132
V11	saldo_v3_divergente	AD_CONTRLICITEEMPENHOS mudou desde v1 (SELECT FOR UPDATE)	BLOQUEIA rodada	novo · pre-flight
V12	contrato_finalizado	STATUS='F' externamente entre v1 e v3	BLOQUEIA item	novo · pre-flight
V13	contrato_alterado	QTDNEG mudou externamente	BLOQUEIA item	novo · pre-flight

🟡 Validações de pulo (SKIP — pula item, segue rodada)

ID	Regra	Condição	Ação	Origem Java
V1	empenho_inexistente	saldo livre IS NULL	SKIP	BtnGerarPedidos.L164
V2	saldo_excedido	QUANTIDADEP > saldo_livre	SKIP	BtnGerarPedidos.L168
V3	sem_estoque	produto sem estoque em nenhuma empresa	SKIP	BtnGerarPedidos.L173
V4	emp_errada	estoque existe mas em empresa errada	SKIP	BtnGerarPedidos.L177
V5	agrupmin_zero	AGRUPMIN=0	SKIP	ItemEmpenhoAutomaticoDAO.L79
V6	produto_null	produto não existe	SKIP	ItemEmpenhoAutomaticoDAO.L87
V7	status_inativo	STATUS not in ['AP','E','FS']	SKIP	ItemEmpenhoAutomaticoDAO.L96
V8	saldo_insuf	SALDO_EMPENHO < QUANTIDADEP	SKIP	ItemEmpenhoAutomaticoDAO.L138

🟢 Validações de integridade Sankhya (espelham regras do ERP)

Regra Sankhya (TGFCAB/TGFITE)	Pre-flight no painel
CODEMP existe em TSIEMP	cruza com espelho snk_tsiemp · bloqueia se NOT FOUND
CODPARC existe em TGFPAR	cruza com espelho snk_tgfpar
CODPROD existe em TGFPRO	cruza com espelho snk_tgfpro
CODTIPOPER existe em TGFTOP	cruza com snk_tgftop + categoria correta
CODVOL é unidade válida do produto	cruza com snk_tgfpro.CODVOL
VLRUNIT > 0	se markup zerado por divisão errada · bloqueia
QTDNEG múltiplo de AGRUPMIN	menor_multiplo() pré-calcula · garantia
CONTROLE do lote ainda existe em TGFEST	v2 refresh estoque · race
Saldo >= QTDNEG no instante do envio	v3 refresh saldo com lock · race
Sessão Sankhya válida (JSESSIONID)	refresh login se 401 · retry

📋 Regras de saneamento (executam antes de cada rodada)

Regra	Ação	Origem Java
QTDPED < 0	vira 0	ProdutoEmpenhoDAO.L82
QTDCAN < 0	vira 0	ProdutoEmpenhoDAO.L82
QTDCAN > QTDNEG	vira QTDNEG	ProdutoEmpenhoDAO.L82

⚠ Não editável: regras espelham o código Java. Mudar regra exige PR no engine TS, deploy e nova versão. Painel só executa.

ℹ Catálogos refletem views do Sankhya em tempo real (cache 1h). Pra alterar valor → mudar no ERP. Painel só consulta.

🏢 Empresas view de TSIEMP

CODEMP	Nome	CNPJ	UF	Matriz	CODPARC
1	FABMED_BA Fabmed Bahia	12.345.678/0001-00	BA	1	— auto
2	MS MS Distribuição	12.345.678/0002-91	BA	1	— auto
3	ZUCK Zuck	12.345.678/0003-72	BA	1	— auto
5	FABMED_PE Fabmed Pernambuco	12.345.678/0004-53	PE	5	— auto

📋 TOPs · Tipos de Operação view de TGFTOP

CODTIPOPER	Descrição	Categoria	Usado em estratégias
10001	Pedido de venda	pedido	4 estratégias
900	Reserva	reserva	1 (FabmedPE)
1012	Transf PE A	transferência	1 (FabmedPE)
1013	Transf PE B	transferência	1 (FabmedPE)
1014	Entrada após transf PE	entrada	auto-gerado
1120	Transf intra-matriz	transferência	3 (BA/MS/ZUCK)
1124	Transf inter-matriz	transferência	—

💰 Naturezas Financeiras view de TGFNAT

CODNAT	Descrição	Tipo	Aplicado em
3.01.001	Receita Venda Mercadoria	Receita	Pedido venda (TOP 10001)
5.01.010	Transferência interestadual Saída CFOP 6.151	Transferência	TOP 1012/1013
9.99.001	Reserva interna Sem efeito fiscal	Reserva	TOP 900
5.02.001	Devolução compra CFOP 5.202	Devolução	—
3.02.001	Receita serviço	Receita	—

📊 Centros de Resultado view de TGFCEN

CODCENCUS	Descrição	Empresa vinculada	Aplicado em
PE-VND	Vendas Pernambuco	5 — FABMED_PE	Pedido venda PE
PE-LOG	Logística PE	5 — FABMED_PE	—
BA-LOG	Logística Bahia	1 — FABMED_BA	Reserva + Transf BA→PE
BA-VND	Vendas Bahia	1 — FABMED_BA	—
MS-LOG	Logística MS	2 — MS	Reserva + Transf MS→PE
ZK-LOG	Logística Zuck	3 — ZUCK	Reserva + Transf ZUCK→PE

ℹ Preferências do Sankhya (MGECoreParameter) que afetam a rotina. Snapshot copiado pra cada rodada — alterar aqui só afeta próximas.

Chave	Default	Uso
LOGSLACK	N	ativa logger Slack
LOGSLACK_WEBHOOK	—	URL webhook
MODPEDLIC	—	NUNOTA modelo pra clonar cabeçalho
EMPVALMIN	12	meses validade mínima de lote
BANCODADOS	ORC	dialeto pra OBTEMCUSTO
FATORPEBA	—	markup % transf PE
CODTIPVENDA_TRANSF	81	tipo negociação transf
META_PEDIDOS	50	máximo agrupamentos por rodada

💰 Markup VLRUNIT (configuração global)

Parâmetro	Valor	Aplicado em
FATORPEBA	%	fórmula `VLRUNIT = CUSTO × (1 + FATORPEBA/100)`
Aplica em pedido (TIPMOV=P)		quando ligado, pedido também recebe markup
Aplica em venda (TIPMOV=V)		quando ligado, venda recebe markup
Aplica em transferência (TIPMOV=T)		regra padrão Java · só transf interestadual usa
Aplica em orçamento (ORCAMENTO=S)		reservas geralmente sem markup

ℹ Valores aplicados a TODA estratégia. Cada estratégia pode sobrescrever via aba Mapeamento & markup.

📋 TGFCAB · campos default (13 invariantes)

Campo TGFCAB	Valor	Origem
SERIENOTA	'1'	fixo
DTNEG, DTENTSAI, DTMOV	GETDATE()	auto
CIF_FOB (pedido)		do item
CIF_FOB (transferência)		fixo TransferenciaService.L161
CODTIPVENDA (transf)		fixo
OBSERVACAO (prefixo)		template

📋 TGFITE · campos default (15 invariantes)

Campo TGFITE	Valor	Origem
PERCDESC	0	fixo
ATUALESTTERC	'N'	fixo
TERCEIROS	'N'	fixo
INFORMARPRECO	TRUE	fixo
CODVOL	produto.CODVOL	auto
QTDNEG	calcularMenorMultiplo(qtd, AGRUPMIN)	auto Utils

ℹ Infraestrutura: cache, snapshots, retenção de audit.

⚡ Cache (Redis local)

Endpoint	TTL	Estratégia
/rodadas/atual		SWR
/saldo		SWR · forced refresh pré-envio
/estoque		SWR · forced refresh pré-envio
/empresas, /tops, /naturezas, /centros		long

📸 Snapshot da rodada (AD_EMPAUT)

Campo	Configuração
Retenção snapshots v1/v2/v3
Audit log retenção
Threshold drift v1→v2 (% itens)
Tolerância divergência saldo v3	unidades

FABMED PE

TOPs em uso · view do Fluxo

Excluir nó da rota?

Em breve

FABMED PE

TOPs em uso · view do Fluxo

Adicionar nó ao fluxo

Excluir nó da rota?

Em breve