🚀 B2Sync Sincronizador C# (.NET 8)

Plano Técnico: Correção da Regra de Sincronismo de Vendas

Ajuste mandatório de integridade comercial e fiscal no motor de sincronismo bidirecional Firebird ↔ Nuvem: validação estrita de venda finalizada (STATUS = 2) antes do upload e preservação do estado operacional.

Relatado Por Fernando Luiz (ferbluiz)
Módulo Afetado B2Sync/SyncEngine.cs
Banco de Dados Firebird (ATRATIVA / SGE)
Impacto Alto (Consistência Fiscal & Caixa)

💬 O Relato do Fernando (`ferbluiz`)

WhatsApp - 26/10 14:22
⚠️
Sintoma Crítico: "O B2Sync tá sincronizando sem pedir permissão kkkk, tipo assim nem fechou a venda ele já manda. Lembro da análise que se sinc=0, então sobe e status :=2 e sinc:=1. O certo seria assim:"
If Sinc = 0 and Status = 2 then
    Sobe e
    Sinc := 1;

O integrador local estava coletando vendas em digitação (quando o operador ainda está adicionando itens no caixa) e forçando a subida imediata. Pior: ao confirmar o envio na nuvem, o B2Sync executava UPDATE VENDA SET STATUS = 2 no Firebird, "fechando" uma venda que o operador ainda estava digitando!

⚖️ Comparativo: Comportamento Atual vs. Regra Correta

Etapa do Ciclo Como Está Hoje (Incorreto) Como Deve Ficar (Homologado)
1. Filtro de Vendas (PUSH) SELECT * FROM VENDA WHERE SINC = 0
(Ignora STATUS; pega vendas em aberto STATUS 0 ou 1)
SELECT * FROM VENDA WHERE SINC = 0 AND STATUS = 2
(Apenas vendas faturadas/fechadas pelo PDV)
2. Filtro de Itens (VENDAI) SELECT * FROM VENDAI WHERE SINC = 0
(Sobe itens soltos de vendas não finalizadas)
SELECT i.* FROM VENDAI i WHERE i.SINC = 0 AND EXISTS (SELECT 1 FROM VENDA v WHERE v.EMPRESA = i.EMPRESA AND v.CODIGO = i.VENDA AND v.STATUS = 2)
3. Atualização Pós-Envio UPDATE VENDA SET SINC = 1, STATUS = 2
(B2Sync forçava status 2 em vendas que o PDV não fechou)
UPDATE VENDA SET SINC = 1
(Mantém o STATUS intocado; só carimba SINC = 1)
4. Demais Tabelas (Cadastros) hasStatusCol ? "SET SINC = 1, STATUS = 2" : "SET SINC = 1"
(Risco de corromper STATUS de Produto, Pessoa e Caixa)
UPDATE {tabela} SET SINC = 1
(Status de tabelas cadastrais nunca deve ser sobrescrito pelo sync)

🔄 Máquina de Estados Homologada

1

Venda em Digitação no Caixa (PDV Local)

O operador insere itens na tabela VENDA e VENDAI. O banco mantém STATUS = 1 (ou 0) e SINC = 0. O B2Sync ignora esses registros e não sobe nada para a nuvem.

2

Fechamento / Conclusão pelo Operador

O caixa recebe o pagamento e fecha o cupom. O ERP Delphi grava STATUS = 2 (Finalizado) e mantém SINC = 0.

3

Ciclo de Sincronismo B2Sync

O motor executa a busca por lotes respeitando estritamente a condição:

WHERE SINC = 0 AND STATUS = 2 AND EMPRESA = @empresa
4

Confirmação do Lote na Nuvem

Ao receber HTTP 200/201 do endpoint /api/v1/vendas/lote, o B2Sync atualiza no Firebird exclusivamente SINC = 1, mantendo o STATUS = 2 íntegro.

🛡️ Diretrizes de Segurança

  • ✔ Zero-Downtime: Alteração concentrada no motor C# de filial/matriz. Não requer alteração de DDL no Firebird nem na API.
  • ✔ Proteção de Cadastros: Elimina de vez o risco de sobrescrever produtos com STATUS = 2.
  • ✔ Consistência Relacional: Garante que itens de venda (VENDAI) nunca cheguem antes da capa da venda.
  • ✔ Compatibilidade Semver: Compilação limpa em .NET 8.0 nativo (x64).

💻 Especificação do Patch em C# (`B2Sync/SyncEngine.cs`)

Ajustes cirúrgicos a serem aplicados no método PushGenericAsync e nos seletores específicos de vendas:

// 1. No método PushGenericAsync (SyncEngine.cs):
string sql;
if (tabelaFb == "VENDA")
{
    // Apenas vendas concluídas pelo PDV (STATUS = 2)
    sql = tableHasEmpresaCol
        ? "SELECT * FROM VENDA WHERE SINC = 0 AND STATUS = 2 AND EMPRESA = @empresa"
        : "SELECT * FROM VENDA WHERE SINC = 0 AND STATUS = 2";
}
else if (tabelaFb == "VENDAI")
{
    // Apenas itens de vendas que já estejam com STATUS = 2
    sql = tableHasEmpresaCol
        ? "SELECT i.* FROM VENDAI i WHERE i.SINC = 0 AND i.EMPRESA = @empresa AND EXISTS (SELECT 1 FROM VENDA v WHERE v.EMPRESA = i.EMPRESA AND v.CODIGO = i.VENDA AND v.STATUS = 2)"
        : "SELECT i.* FROM VENDAI i WHERE i.SINC = 0 AND EXISTS (SELECT 1 FROM VENDA v WHERE v.EMPRESA = i.EMPRESA AND v.CODIGO = i.VENDA AND v.STATUS = 2)";
}
else
{
    sql = tableHasEmpresaCol
        ? $"SELECT * FROM {tabelaFb} WHERE SINC = 0 AND EMPRESA = @empresa"
        : $"SELECT * FROM {tabelaFb} WHERE SINC = 0";
}

// 2. Na atualização pós-sucesso do lote:
// NUNCA forçar STATUS = 2 nas tabelas. O status pertence ao ERP de origem.
string updateSetSql = "SET SINC = 1";

Status da Homologação

Pronto para aplicação no SyncEngine.cs, build .NET e teste de regressão.