Integração REST com PDV de varejo e resposta à reforma tributária

Desafio

Uma confecção multimarcas opera lojas próprias sobre uma plataforma de PDV de mercado, e o faturamento, o estoque e o crediário vivem no ERP. As duas pontas precisavam conversar em nove frentes: cliente, produto, preço, estoque, nota, pedido, devolução, crediário e status fiscal. O complicador estava na API do PDV, que impõe limite de requisições. Uma carga completa diária estourava esse limite bem antes de terminar.

No meio do projeto veio a reforma tributária brasileira. Notas já emitidas precisavam passar a carregar IBS e CBS, e o cliente não tinha como esperar o próximo ciclo de versão do ERP.

Solução

Em vez de carga completa, implementei sincronização incremental apoiada no log nativo de alteração do próprio ERP: o monitor lê o que mudou desde o último ponto processado e publica só o delta. Isso derrubou o volume de chamadas à API para uma fração do anterior e deixou a janela de sincronização praticamente contínua.

O limite de requisições continua existindo mesmo com volume menor, então construí um limitador de taxa próprio, com fila e recuo progressivo em caso de rejeição, para que um pico de vendas não derrubasse a integração inteira. Falha de item vira pendência individual e é reprocessada depois, sem abortar o lote.

Para a reforma tributária, escrevi a rotina de reimportação e recálculo de IBS/CBS em lote sobre notas já emitidas, item a item, com relatório de divergência antes da gravação. Junto veio um conjunto de correções pontuais para os efeitos colaterais que apareceram: série fiscal trocada, chave de NF-e e retorno da Sefaz faltantes, zeragem indevida de ICMS na categoria “outras”.

Resultado

A loja passou a enxergar estoque e preço do ERP em minutos, em vez de no dia seguinte, e o ERP passou a receber venda, devolução e crediário sem digitação. O backfill tributário foi concluído dentro do prazo legal, sobre a base já emitida, sem esperar release do produto padrão.

O que esse case mostra

Integrei com uma API de terceiro que tem restrição real de taxa, e a sincronização incremental por log foi a escolha que caberia dentro dessa restrição. O trecho tributário mostra resposta rápida a mudança de legislação, incluindo correção retroativa de dado fiscal já persistido.