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.

16etapas do projeto
1loja piloto para homologação
A medirvolume real durante o piloto
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.
RailwayHospedagem contínua do motor SEFAZ em nuvem, sem depender de computador ligado na loja.

Base FARE45 já disponível para a Gendai

Capacidades construídas e aperfeiçoadas no ecossistema FARE45. A implantação Gendai permanece separada e só é considerada homologada após teste no ambiente próprio.

ATUALIZADO · 31/08/2026 · 22:45
Fundação e segurançaSupabase isolado, RLS, migrations, tenant, loja, usuários, perfis, dispositivos, credenciais e auditoria campo a campo.
Catálogo multicanalCategorias, produtos, variações, complementos, mídia, disponibilidade por loja, canais, preços, vigência e ordenação.
Fiscal por loja e produtoRegime, CRT, NCM, CEST, CFOP, origem, CSOSN/CST, PIS/COFINS, validação e preparação para IBS/CBS.
Compras, estoque e CMVNF-e de compras, certificado A1, motor SEFAZ no Railway, De-Para assistido, notas de entrada, fornecedores, lista de compras, breaks, desperdícios, estoque, custos e proteção contra duplicidade.
Financeiro e rastreabilidadeDestino DRE/CMV, DFC, fornecedores, ocorrências, linha do tempo por nota e auditoria do lançamento.
Formulários e lançamentos assistidosContagem, break e desperdícios por loja, formulários PDF/Excel, fotografia ou upload, OCR, conferência obrigatória, valorização e atualização do estoque.
Homologação protegidaChecklist auditável, justificativa, histórico e retorno seguro; a Gendai ABC (loja 001) será a unidade piloto de homologação, protegida contra promoção acidental.
Dependência técnica da NeoFalta a Neo documentar os campos e funcionalidades do PDV para IBS/CBS, payload, validações, cálculo, XML e retorno de rejeições.
Arquitetura Gendai Neofare · roadmap vivo para validação conjunta · Fare45, Gendai e Neo
Comunicação de implantação

Alinhamento Técnico
Gendai Neofare × NeoStore

Rascunho técnico interno para conferir a integração Gendai antes do compartilhamento com a Neo.

ReferênciaGEN-NEO-ALIN-001
Data28/08/2026
Primeiro ambienteHomologação · Gendai ABC
StatusRASCUNHO · NÃO COMPARTILHAR
Documento em validação internaA especificação fiscal Neo versão 1.0, de 28/08/2026, é a referência recebida. Este documento somente poderá ser compartilhado após os endpoints, payloads, credenciais, classificação fiscal e cenários de retorno serem comprovados em homologação.

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

ComponenteSituação comprovadaStatus
Banco e ambientesProjeto Supabase Gendai de homologação isolado. O ambiente físico de produção ainda não foi criado.PENDENTE PRODUÇÃO
API e endpointEndpoint de homologação publicado com contrato 2.0, snapshot, cursor incremental e confirmação/rejeição. Testado internamente; ainda não homologado pela Neo.TESTE INTERNO OK
CredenciaisCredencial exclusiva para a Neo ainda não foi emitida; API e polling permanecem desligados.PENDENTE
IdentificadoresLoja 001, store_id e integration_uuid exclusivos foram conferidos diretamente no banco.VALIDADO
AuditoriaCursor, request_id, idempotência, confirmação e rejeição foram testados. Nenhuma requisição real da Neo foi registrada.TESTE INTERNO OK

2.1 Identificação da loja no consumo Neo

CampoValor da Gendai ABCFinalidade
integration_uuidGERADO E CONFERIDO
Valor reservado ao guia técnico privado		Identificador técnico principal, exclusivo e imutável. Acompanha consultas, confirmações e rejeições.
store_idGERADO E CONFERIDO
Valor reservado ao guia técnico privado		UUID interno preservado para rastreabilidade; não é substituído pelo CNPJ ou nome.
store_number001Número operacional legível da loja piloto Gendai.
codeGND-ABC-001Código estável para diagnóstico, suporte e telas administrativas.
trade_nameGendai ABCNome de exibição; pode mudar sem romper o vínculo técnico.
CNPJCADASTRADO
FICTÍCIO — SOMENTE HOMOLOGAÇÃO		O valor completo fica no ambiente privado. Não identifica a loja na API e não pode ser utilizado em emissão fiscal real.

2.2 Catálogo, sugestões e novas regras comerciais

O contrato 2.0 entrega um snapshot completo seguido de mudanças incrementais. Ele cobre identidade da loja, categorias, produtos, configuração por loja, preços, disponibilidade, fiscal, badges, opções, sugestões, jornadas e mídias do totem.

Produtos e categoriasNome, descrição, imagem, ordem, disponibilidade, canal, preço, vigência e situação.
Complementos e opçõesGrupo, itens, mínimo, máximo, obrigatoriedade, quantidade, preço adicional e agenda.
Sugestões de vendaProduto de origem, sugerido, posição da oferta, texto, quantidade, preço, canal, vigência, prioridade e ativação.
Combos e jornadasEtapas, escolhas, substituições, sugestões, banners e regras de apresentação do totem.
Novas regras · implementadoO cursor incremental abrange categorias, produtos, disponibilidade, opções, sugestões, jornadas e inativações.
Confirmação e rejeição · teste interno OKrequest_id, cursor, diagnóstico e idempotência foram testados; falta o teste com a Neo.

2.3 Evidências verificadas em 30/08/2026

VerificaçãoResultadoConclusão
Produtos ativos da marca274Base cadastrada
Produtos vinculados à Gendai ABC268Os 6 produtos ativos restantes serão classificados como fora da loja ou vinculados após conferência
Categorias ativas36Incluídas no snapshot 2.0
Grupos de opções ativos24Incluídos no snapshot e no incremental 2.0
Jornadas ativas1Snapshot retornou 102 linhas de jornada; falta validação Neo
Fiscal de produtos publicado0Bloqueia homologação fiscal e compartilhamento final
Requisições Neo reais0Teste interno passou; falta consumo da Neo

3. Fiscal por loja e produto

Regime e CRTEstrutura por loja criada para regime, CRT, inscrições, ambiente e série. A configuração da Gendai ABC ainda precisa ser revisada e publicada.
ICMSCampos separados para CSOSN, CST ICMS, alíquota, origem da mercadoria, benefício, NCM, CEST e CFOP já existem.
PIS e COFINSCST e alíquotas separados já existem. O “tipo de cálculo” citado no documento ainda não possui campo próprio e deve ser confirmado com a Neo.
OrigemOrigem operacional e origem fiscal ICMS foram separadas para impedir classificação tributária por inferência.
Publicação fiscalNenhum produto da Gendai ABC está atualmente com classificação fiscal publicada; não está pronto para teste de NFC-e.
ComponentesOpções possuem regra de itemização fiscal, mas o comportamento completo em adicionais e combos ainda precisa ser validado no XML da Neo.
IBS e CBSDependência Neo: campos disponíveis no PDV, payload aceito, validações, cálculo, XML e retorno de rejeições ainda não foram informados.

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

VALIDADO
Identidade e base cadastral
Loja, identificadores, produtos, categorias, opções e jornada foram conferidos diretamente no banco Gendai.
TESTE INTERNO OK
Contrato Fare45 2.0
Snapshot, incremental, endpoint de homologação, autenticação, paginação, confirmação, rejeição e idempotência foram implementados e testados.
FARE45 + FISCAL
Antes de entregar à Neo
Conferir os 6 produtos fora do vínculo da loja, publicar a matriz fiscal aprovada e emitir a credencial definitiva em canal privado.
DEPENDÊNCIA NEO
Depois da entrega técnica
A Neo deverá configurar o consumo, confirmar o formato, devolver confirmações e rejeições, informar IBS/CBS e participar do teste completo de NFC-e.
FARE45 · responsável / data
Neo · ciência / data
Gendai / Fiscal · ciência / data