Roadmap de implantação

Arquitetura Gendai Neofare

Plano validável para construir a marca Gendai com banco, API, endpoints e credenciais isolados, integrando Fare45 e Neo com segurança desde a loja piloto Gendai ABC.

15etapas do projeto
150lojas previstas em 12 meses
30 milvendas por dia na rede
100%isolado da Patroni
Cronograma-base de 45 diasEtapas sobrepostas, validação conjunta e implantação assistida.
Início31/08/2026
Entrega prevista15/10/2026
Progresso de validação0 de 0 itens validados

Isolamento real

Supabase, API, endpoints, credenciais, Storage e IDs exclusivos da Gendai.

Fiscal por loja

Simples Nacional, Lucro Presumido ou Lucro Real com regras versionadas por produto.

Operação resiliente

Caixa, PDV, totem e KDS com idempotência, cache local e sincronização auditável.

Responsabilidades no projeto

Fare45Arquitetura, banco, APIs, aplicativos, segurança, versionamento e auditoria.
NeoPolling, vínculo dos IDs, processamento fiscal, XML, retornos e homologação da integração.
GendaiRegras de negócio, operação das lojas, catálogo, materiais e aceite funcional.
Fiscal GendaiRegime tributário, fichas fiscais, validações, vigências e aprovação contábil.
Arquitetura Gendai Neofare · roadmap vivo para validação conjunta · Fare45, Gendai e Neo
Comunicação de implantação

Alinhamento Técnico
Gendai Neofare × NeoStore

Registro da forma como a FARE45 implementará a nova marca Gendai seguindo a especificação fiscal encaminhada pela equipe Neo.

ReferênciaGEN-NEO-ALIN-001
Data28/08/2026
Primeiro ambienteHomologação · Gendai ABC
Confirmação de entendimentoA FARE45 adotará como referência funcional a “Especificação de Integração — Tratamento fiscal da NFC-e — versão 1.0”, encaminhada pela Neo em 28/08/2026. O objetivo deste registro é comunicar a abordagem da nova marca, sem propor alteração no fluxo operacional já utilizado pela Neo.

1. Diretriz da implantação

A FARE45 será a fonte dos dados cadastrais, comerciais e fiscais publicados para consumo da Neo. A Neo seguirá responsável pela normalização, validação, persistência, montagem da NFC-e, transmissão à SEFAZ, interpretação do retorno, XML, cancelamento e reimpressão, conforme seu manual.

Mesmo modelo operacionalO polling seguirá a mesma forma já utilizada na integração Patroni × Neo.
Nova marca isoladaA operação Gendai terá recursos, credenciais e identificadores próprios, sem correlação técnica com a Patroni.

2. Isolamento exclusivo da Gendai

ComponenteTratamento Gendai
Banco e ambientesSupabase, Postgres, Auth e Storage exclusivos; homologação e produção separadas.
API e endpointURLs e serviços exclusivos da Gendai, preservando o formato de consumo já utilizado pela Neo.
CredenciaisChaves próprias, com escopo e rotação independentes.
IdentificadoresMarca, loja, produto, venda e versões com IDs próprios; nenhum ID da Patroni será reutilizado.
AuditoriaPolling, versões, alterações, rejeições e retornos rastreados no ambiente Gendai.

3. Fiscal por loja e produto

Regime da lojaSimples Nacional, Lucro Presumido ou Lucro Real, com CRT e vigência definidos por unidade.
ICMSCRT 1/2 utilizará CSOSN; CRT 3 utilizará CST ICMS. Os campos serão separados no cadastro FARE45.
PIS e COFINSCST, tipo de cálculo e alíquotas serão armazenados separadamente, respeitando exceções por produto.
ClassificaçãoNCM, CEST condicional, CFOP, origem, unidade, benefícios e demais parâmetros previstos no manual Neo.
Matriz fiscalA classificação considerará produto × loja × regime × UF, com vigência, versão e aprovação fiscal.
ComponentesProdutos principais, adicionais, combos e componentes fiscais passarão pelas mesmas validações.

4. Regras de segurança adotadas

Cadastro incompleto bloqueiaProduto vendável com campo fiscal obrigatório ausente ou incompatível não será publicado para venda.
Sem inferência silenciosaNão serão aplicados códigos ou alíquotas genéricas para completar classificação pendente.
Histórico preservadoAlterações terão versão, vigência, responsável e auditoria; ausência de campo não apagará dado homologado.
XML como evidênciaO XML autorizado e seus eventos serão vinculados ao pedido como evidência fiscal definitiva.

5. Homologação da loja piloto

Cadastro e matriz fiscal da Gendai ABC conferidos antes da carga.
Polling no modelo atual da Neo testado com endpoint, credenciais e IDs exclusivos Gendai.
Produtos principais, adicionais, combos e exceções fiscais validados.
XML conferido item a item, incluindo bases, alíquotas, totais e pagamentos.
Autorização, rejeição, contingência, cancelamento, reimpressão e retorno fiscal testados.
Produção liberada somente após aceite conjunto da massa de homologação.

6. Próximo marco conjunto

CRIADO
Base e alinhamento registrados
O ambiente isolado Gendai, a referência fiscal Neo e este documento de alinhamento foram registrados. A evolução continuará por etapas criadas e testadas.
DEPENDÊNCIA NEO
Ativação do consumo em homologação
Quando os endereços, credenciais e identificadores Gendai forem entregues, caberá à Neo configurar e validar o consumo no mesmo padrão operacional já praticado com a Patroni.
FARE45 · responsável / data
Neo · ciência / data
Gendai / Fiscal · ciência / data