> Por que sistemas legados de PDV falham ao integrar com APIs modernas (e como resolver)
Sistemas fiscais construídos nos anos 90 e 2000 operam de forma síncrona e blocante. Quando expostos diretamente a webhooks financeiros ou redes instáveis, travam o caixa.
[01] O Gargalo da Thread Única no Frente de Caixa
[ ^ TOPO ]Grande parte do varejo brasileiro ainda roda sobre bases de código escritas há duas décadas (Delphi, Clipper/Harbour, VB6, Cobol). São sistemas extremamente rápidos naquilo que foram projetados para fazer localmente, mas que entram em colapso quando precisam conversar com o mundo externo via HTTP/REST.
O erro mais comum em operações de médio e grande porte é tentar embutir chamadas de API diretamente na thread principal do frente de caixa. Uma oscilação de 3 segundos no provedor de pagamentos ou no DNS local se transforma imediatamente em uma fila parada no supermercado.
[02] Arquitetura Sidecar / Daemon Local
[ ^ TOPO ]A solução arquitetural não é reescrever o ERP inteiro do dia para a noite, mas isolar a comunicação externa através de um serviço local leve (Sidecar Pattern) operando de forma assíncrona na mesma máquina ou servidor de loja.
Neste modelo, o PDV conversa apenas localmente (via arquivo em RAMDisk, Named Pipes, Socket TCP loopback ou tabela local), garantindo latência sub-milissegundo, enquanto o daemon gerencia toda a complexidade da nuvem:
- Pool de Conexões Persistentes (Keep-Alive): elimina o custo repetitivo de handshake TLS/SSL a cada venda.
- Retries com Backoff Exponencial: absorve micro-quedas de link sem expor o erro ao operador de caixa.
- Reconciliação Híbrida (Webhook + Polling): recebe confirmação instantânea via webhook, mas mantém fallback ativo caso o roteador da loja perca pacotes.
- Fila Local Transacional (SQLite WAL): garante zero perda de estado mesmo se a máquina sofrer desligamento abrupto.
// Fluxo de Isolamento: PDV Legado <-> Sidecar Daemon <-> Cloud API
[PDV Legado] --(IPC Local < 1ms)--> [Daemon MPPix Local]
│
├──> [Fila SQLite WAL]
└──> [TLS 1.3 Keep-Alive] ──> [API Pagamentos] [03] Comparativo em Produção
[ ^ TOPO ]Abaixo, os números reais observados após migrar a comunicação direta do legado para um middleware orquestrado:
| Métrica Operacional | Integração Direta | Com Sidecar Local | Impacto |
|---|---|---|---|
| Tempo de bloqueio da UI | 1.200ms a 15.000ms | 2ms a 8ms | Zero travamento |
| Handshake TLS por venda | Sim (300ms+) | Reutilizado (0ms) | Redução de latência |
| Tolerância a queda de DNS | Falha imediata | Cache + IP Fallback | Alta resiliência |
| Visibilidade de Logs | Nenhuma / Caixa Preta | Telemetria estruturada | Auditoria total |
Se o seu sistema de PDV ou ERP sofre com lentidão ao processar PIX, TEF ou integrações externas, esse é exatamente o problema que resolvemos com arquitetura de middlewares sob medida e com a plataforma MPPix.
