Documentação de Especificação Funcional & Técnica - Edição Completa

1. Visão Geral

O Sellora é uma plataforma SaaS de gestão centralizada de operações de e-commerce para vendedores que atuam em múltiplos marketplaces (Shopee, Mercado Livre, Amazon, e outros). Esta edição documenta o sistema de referência de forma completa: todos os nove módulos e seus submódulos, além da área de configurações.

O produto unifica num único painel: gestão de produtos e anúncios, processamento de pedidos multicanal, controle de compras e fornecedores, gestão de estoque e armazéns, atendimento ao cliente (SAC), analytics, gestão financeira e emissão fiscal (NF-e).

HomeProdutosPedidosComprasEstoqueSACAnálisesFinanceiroIntegraçõesConfigurações

2. Modelo de Negócio e Planos

Modelo freemium: o núcleo operacional é acessível e recursos avançados ficam atrás de paywalls. Há ainda créditos de IA para recursos assistidos (geração de imagem por IA, criação de produto por IA, sugestão de respostas no SAC).

Camada	Recursos	Acesso
Básico	Produtos, pedidos, estoque, contagem, SAC, relatórios de vendas, integrações	Incluído
Avançado	Análise ABC, Sugestão de Compras, Gestão Financeira (contas a pagar/receber)	Upgrade
Créditos IA	Gerar Imagem por IA, Criar Produto por IA, respostas automáticas	Consumo

3. Arquitetura de Navegação

A aplicação é uma SPA com aproximadamente 440 rotas internas (incluindo variantes por marketplace). A navegação principal se organiza em 8 menus de topo, cada um com grupos de submódulos, além de uma área de Configurações. O mapa completo está detalhado nas seções por módulo a seguir.

4. Módulo Produtos

Gerenciamento · Anúncios · Ferramentas

Estrutura: Gerenciamento de Produtos (Produtos do Armazém, Gerenciar Mapeamento, Categorias), Gestão de Anúncios por marketplace (Rascunhos, Ativo, Criar Anúncio, Marketing) e Ferramentas (Copiador de Anúncios, Migração de Anúncios, Controle de Código/Barcode, Modelo de Precificação, Detectar Palavras Proibidas, Gerar Imagem por IA, Criar Produto por IA, Espaço de Dados).

4.1 Produtos do Armazém (catálogo)

Catálogo interno com SKU, imagem, variações (cor/tamanho), preço e vínculo com anúncios.

4.2 Cadastro de Produto - campo a campo

Formulário em 7 seções (navegação lateral): Info. Básica, Info. de Venda e Atributos, Mídia, Mapeado SKU do Anúncio, Info. de Impostos, Detalhes do estoque, Fornecedores.

Informação Básica

SKU, Nome do Produto, Apelido do Produto (com opção de substituir o título ao emitir NF-e para privacidade), Categorias, Código de Barras (EAN/UPC/GTIN), Apelido de SKU (mapeamento ML/FNSKU), Data de Lançamento, Status da Venda e Vendedor.

Informação de Venda e Atributos

Preço de varejo, Custo de Compra, Descrição, Link do Fornecedor, Marca, Peso do Pacote e Tamanho da Embalagem.

Informação de Impostos

Grupo de Classe de Impostos, NCM (com auxílio de IA), CEST, Unidade e Origem da mercadoria.

4.3 Gerenciar Mapeamento (SKU ↔ Anúncio)

Vincula o SKU interno aos SKUs/anúncios dos marketplaces, base para o controle de estoque unificado.

4.4 Gestão de Anúncios - Ativos

Anúncios publicados por marketplace, com preço, estoque e status; ações de edição em massa.

4.5 Copiador / Migração de Anúncios

Importa e replica anúncios entre lojas/marketplaces, acelerando a expansão de catálogo.

4.6 Importar Lista de Produtos

4.7 Detectar Palavras Proibidas

Verifica títulos/descrições contra listas de palavras banidas (com lista branca e nuvem de termos).

4.8 Controle de Código de Barras

4.9 Ferramentas de IA

Recursos assistidos por IA que consomem créditos: geração de imagens de produto e criação de produto por IA.

Requisitos do módulo de Produtos

• Produto com variações (matriz cor × tamanho), cada variação com SKU e estoque próprios.
• Campos fiscais (NCM/CEST/CFOP/origem) validados antes de emitir NF-e.
• Mapeamento N:N entre SKU interno e anúncios de marketplaces.
• Importação/edição em massa; copiador entre canais.
• Verificação de palavras proibidas e recursos de IA com controle de créditos.

5. Módulo Pedidos

Gerenciamento · Escaneamento · Notas Fiscais · Ferramentas

Reúne pedidos de todos os canais com filtros e abas por etapa: Todos, Não Pago, Pendente, Para Reservar, Para Emitir, Para Enviar, Para Imprimir, Para Retirada, Enviado, Completo. Inclui fluxos de separação, escaneamento, emissão fiscal e devoluções.

5.1 Todos os Pedidos

5.2 Detalhe do Pedido

Modal com trilha de progresso e abas Resumo, Endereço do Destinatário, Método de Envio, Nota Fiscal e Logs. Painel lateral com loja, plataforma, valor, cupons, horas, frete, CPF/CNPJ e comprador (mascarados).

5.3 Processando Pedidos

5.4 Separação por Ondas (Wave Picking)

Agrupa pedidos em ondas de separação para otimizar o picking no armazém.

5.5 Agrupamento de Pacotes

5.6 Escaneamento (Checkout / Envio)

Conferência por leitura de código: checkout por produto/pedido e escanear para enviar.

5.7 Gestão de Notas Fiscais (Brasil NF-e)

Central de NF-e: em emissão, emitidas, falhas, números inutilizados, importação, etc.

5.8 Devoluções

5.9 Alocação de Pedidos

Requisitos do módulo de Pedidos

• Máquina de estados com transições auditáveis (log por evento).
• Filas por etapa com ações em lote (emitir, imprimir, enviar).
• Separação por ondas e agrupamento de pacotes para o armazém.
• Conferência por escaneamento (picking e despacho).
• Central de NF-e integrada e gestão de devoluções.
• Mascaramento de PII conforme LGPD.

6. Configurações de Pedido

Configurações

6.1 NF-e Automática

Regras para emitir NF-e automaticamente conforme critérios (canal, status, tipo de venda).

6.2 Configuração de Impressão / Etiqueta

6.3 Regras de Alocação de Armazém

Requisitos de Configurações de Pedido

• Motor de regras para emissão automática de NF-e.
• Templates configuráveis de etiquetas/impressão.
• Regras de alocação multi-armazém (prioridade, proximidade, estoque).

7. Módulo Compras

Controle de Compras · NF-e de Compra · Fornecedores

7.1 Sugestão de Compras

Reposição inteligente (recurso avançado): recomenda o que e quanto comprar com base em vendas, estoque e prazo de entrega.

7.2 Pedidos de Compras

Ciclo completo: a comprar, a enviar, em trânsito, parcialmente recebido, concluído, cancelado.

7.3 NF-e de Compra

Importação e gestão de notas fiscais de entrada (compra), com pendências de importação e devolução.

7.4 Gestão de Fornecedores

Cadastro de fornecedores, relações de fornecimento (fornecedor × SKU) e condições comerciais.

Requisitos do módulo de Compras

• Ordem de compra com itens, quantidades, custos e fornecedor; recebimento parcial/total.
• Atualização automática de estoque e custo médio na entrada.
• Importação de NF-e de entrada e conciliação.
• Cadastro de fornecedores com relação fornecedor×SKU e prazo de entrega.
• Integração com Sugestão de Compras (avançado).

8. Módulo Estoque

Gerenciamento · Armazém de Plataforma · Entrada/Saída · Recebimento · Controle de Armazém

8.1 Lista de Estoque

8.2 Contagem de Estoque

8.3 Entrada Manual

8.4 Saída Manual

8.5 Transferência entre Armazéns

8.6 Recebimento (por Compra / Transferência)

8.7 Armazém de Plataforma (3PL - Shopee FBS / Mercado Envios Full)

Estoque em fulfillment do marketplace (3PL), sincronizado e reportado à parte.

8.8 Sincronização de Estoque

Requisitos do módulo de Estoque

• Saldo por SKU e por armazém/local; reserva para pedidos em processamento.
• Movimentações rastreáveis: entrada, saída, ajuste, transferência.
• Recebimento de compra e de transferência (parcial/total).
• Integração com estoques 3PL (Shopee FBS, Mercado Envios Full).
• Sincronização bidirecional de saldos com marketplaces, com log.
• Contagem cíclica com aprovação de divergências; controle de estante/armazém.

9. Módulo SAC

Shopee · Mercado Livre · Amazon · Gestão de Cliente

Atendimento unificado por canal: avaliações e devolução/reembolso (Shopee); perguntas, mensagens, reclamações, devoluções e lista de bloqueio (Mercado Livre); solicitação de avaliação (Amazon); e Gestão de Cliente (lista de compradores, listas de bloqueio, Chatbot de IA). Inclui respostas automáticas, modelos e regras por palavra-chave.

9.1 Perguntas (Mercado Livre)

9.2 Reclamações

9.3 Modelos de Resposta

Templates reutilizáveis e regras de resposta automática (inclusive por palavra-chave).

9.4 Avaliações (Shopee)

9.5 Gestão de Cliente - Lista de Compradores

Requisitos do módulo de SAC

• Caixa unificada por canal (perguntas, mensagens, reclamações) com status e SLA.
• Modelos de resposta e automação por palavra-chave; Chatbot de IA (créditos).
• Vínculo da conversa ao pedido/produto; gestão de compradores e bloqueios.
• Solicitação de avaliação (Amazon) e gestão de avaliações (Shopee/ML).

10. Módulo Análises

Relatórios de Vendas · Operacionais · Estoque · Mercado Livre · Shopee

Grupos: Relatórios de Vendas (Vista Geral, Performance das Vendas, Vendas por Anúncio, Análise ABC, Vendas por Estado), Relatórios Operacionais, Relatórios de Estoque, Análises Mercado Livre (ex.: Reputação) e Análise da Shopee.

10.1 Vista Geral de Vendas

10.2 Vendas por Produto/Anúncio

10.3 Vendas por Estado

10.4 Relatórios Operacionais

10.5 Relatórios de Estoque

10.6 Reputação (Mercado Livre)

Requisitos de Análises

• Dashboards com filtros de período, plataforma e loja; séries temporais.
• Rankings de produtos/lojas; vendas por região; giro de estoque.
• Análise ABC (avançado) e relatórios específicos por marketplace.
• Exportação (CSV/Excel).

11. Módulo Financeiro

Relatórios de Lucros · Gestão Financeira · Relatórios de NF-e

11.1 Lucro por Pedido

Consolida receita, taxas do marketplace, frete, custo do produto, impostos e margem por transação.

11.2 Lucro por Loja

11.3 Gestão Financeira - Fluxo de Contas (avançado)

Fluxo de caixa e contas; visão consolidada de entradas/saídas.

11.4 Contas a Pagar

11.5 Relatórios de NF-e (por Empresa / NCM)

Requisitos do Financeiro

• Lucro por pedido: preço − taxas − frete − custo − impostos; consolidação por período/canal/produto.
• Conciliação de repasses do marketplace.
• Gestão de contas a pagar/receber e fluxo de caixa (avançado).
• Relatórios fiscais por empresa e por NCM (compra/venda).

12. Integrações

Conexão a marketplaces via API oficial (OAuth), com sincronização de anúncios, pedidos, estoque e mensagens. Canais observados: Shopee e Mercado Livre, com arquitetura extensível (Amazon, Shein, TikTok Shop, Shopify, Magalu, entre outros exibidos na interface).

Requisitos de Integração

• OAuth por marketplace com renovação/reautorização de token.
• Sincronização bidirecional (importar pedidos/anúncios; empurrar estoque/preço).
• Fila com reprocessamento e log de erros por loja; mapeamento SKU↔anúncio.

13. Recursos Premium (paywalls)

Recursos avançados documentados via prévia do paywall.

13.1 Sugestão de Compras

13.2 Análise ABC

13.3 Gestão Financeira

14. Modelo de Dados (ERD) - visão lógica

Entidade	Campos principais	Relações
Conta/Usuário	id, nome, plano, créditos_IA	1:N Loja, Armazém
Loja/Integração	id, canal, token, status_sync	N:1 Conta; 1:N Anuncio/Pedido
Produto	id, sku, nome, categoria, custo, ncm, cest, cfop, origem	1:N Variacao/Anuncio
Variacao	id, sku, cor, tamanho, ean, preco	N:1 Produto; 1:1 Estoque
Anuncio	id, id_marketplace, preco, status	N:1 Produto/Loja (mapeamento N:N via MapSKU)
MapSKU	sku_interno, sku_anuncio, loja	N:N Produto×Anuncio
Pedido	id, num_plataforma, valor, status, frete, cupom	N:1 Loja; 1:N ItemPedido; 1:1 NFe
ItemPedido	id, sku, qtd, preco_unit	N:1 Pedido; N:1 Variacao
Estoque	sku, saldo, reservado, armazem	1:N Movimentacao
Movimentacao	id, tipo(entrada/saida/ajuste/transf), qtd	N:1 Estoque
Armazem	id, nome, tipo(próprio/3PL)	1:N Estoque/Estante
OrdemCompra	id, fornecedor, status, custo	N:1 Fornecedor; 1:N ItemCompra
Fornecedor	id, nome, prazo_entrega	1:N OrdemCompra; N:N Produto (SupplyRel)
NFe	id, tipo(entrada/saida), serie, numero, chave, status	1:1 Pedido / N:1 OrdemCompra
MensagemSAC	id, canal, tipo(pergunta/reclamação), status	N:1 Pedido/Comprador
Comprador	id(mascarado), canal, bloqueado	1:N Pedido/Mensagem
ContaFinanceira	id, tipo(pagar/receber), valor, vencimento	N:1 Conta

15. Backlog e MVP em Fases

Épico	Prioridade	Descrição
Integração de canais	Alta	OAuth, sync anúncios/pedidos/estoque, fila e logs
Catálogo	Alta	Cadastro com variações e fiscal, mapeamento, importação/copiador
Pedidos	Alta	Filas por etapa, lote, detalhe, ondas, agrupamento, escaneamento
Estoque	Alta	Saldos, reservas, movimentações, recebimento, 3PL, sync, contagem
NF-e	Média	Emissão individual/lote/automática, entrada e saída, DANFE
SAC	Média	Caixa unificada, modelos, automação, chatbot IA
Análises	Média	Dashboards, ABC, relatórios por canal, exportação
Financeiro	Média	Lucro por pedido/loja, contas a pagar/receber, fiscal
Recursos avançados/IA	Baixa	Sugestão de compras, curva ABC, geração por IA, créditos

MVP em Fases

Fase 1 - Núcleo: 1 canal (Shopee), catálogo com variações, importação de pedidos, filas por etapa, estoque básico.

Fase 2 - Operação completa: NF-e (emissão/automação), compras/fornecedores, recebimento, contagem, SAC unificado, transferências e 3PL.

Fase 3 - Inteligência/Monetização: análises avançadas (ABC), financeiro completo, sugestão de compras, recursos de IA e créditos.

16. Requisitos Não-Funcionais

• Segurança/LGPD: mascaramento de PII, criptografia de tokens e certificados A1, RBAC por perfil.
• Escalabilidade: processamento assíncrono de sincronizações e emissões em lote.
• Confiabilidade: reprocessamento de filas, idempotência nas sincronizações.
• Observabilidade: logs por evento de pedido e por sincronização.
• Performance: listas paginadas com filtros server-side (220+ pedidos/página no referência).
• Disponibilidade: resiliência a instabilidade das APIs dos marketplaces.

17. Cobertura e Limitações

Esta edição v3.0 cobre os 9 módulos e a área de configurações, com 60 telas reais embutidas, incluindo submódulos de cada área, o formulário de produto (3 seções), o modal de detalhe do pedido (Resumo + Nota Fiscal) e as prévias dos 3 recursos premium. O mapa de rotas real da aplicação contém ~440 rotas (muitas são variantes por marketplace do mesmo recurso, representadas aqui por telas canônicas).

Limitações

• Variantes por marketplace (Amazon, Shein, TikTok, etc.) representadas por telas canônicas para evitar redundância.
• Recursos premium documentados pela prévia do paywall (sem acesso ao detalhe interno).
• Dados de comprador mascarados na origem; o ERD é reconstrução lógica sujeita a refinamento.