PROPRIEDADE INTELECTUAL
Conteúdo pertencente a PDVPOS LTDA. Esta documentação é disponibilizada para fins de consulta, utilização e suporte aos produtos e serviços PDVPOS. É proibida sua reprodução, redistribuição, comercialização ou utilização fora dessa finalidade sem autorização expressa.
© 2026 PDVPOS LTDA. Todos os direitos reservados.
README principal | Introdução | Módulos —
Breadcrumbs: Início / Introdução / CORE-CONCEPTS
Core Business Concepts & Product Architecture
Documento Arquitetural Oficial do PDVPOS ERP
Este documento descreve os conceitos fundamentais que sustentam a arquitetura funcional do PDVPOS ERP.
Ao contrário dos demais documentos da plataforma, este arquivo não documenta funcionalidades.
Seu objetivo é explicar como o produto foi concebido, quais entidades representam o núcleo do sistema e como elas se relacionam.
Todo novo módulo desenvolvido deverá respeitar estes conceitos.
O PDVPOS ERP foi projetado como uma plataforma integrada.
Cada módulo existe para resolver um domínio específico do negócio, porém todos compartilham a mesma base de dados.
Não existem módulos isolados.
Existe apenas uma plataforma.
O ERP é o centro de toda operação.
Todos os sistemas externos devem consumir ou produzir informações através do PDVPOS ERP.
Marketplace
│
SmartPOS ─── ERP ─── Contabilidade
│
Financeiro
│
Fiscal
│
APIs
│
Webhooks
O ERP nunca deve depender de outro sistema para conhecer sua própria operação.
Toda a plataforma é construída sobre um conjunto reduzido de entidades principais.
Essas entidades representam o núcleo do sistema.
A empresa representa a unidade organizacional responsável pela operação.
Ela define:
Todas as demais entidades pertencem a uma empresa.
Uma filial representa uma unidade operacional.
Cada filial pode possuir:
A filial determina o contexto da operação.
O produto é uma das entidades centrais da plataforma.
Ele não pertence apenas ao módulo de estoque.
Um produto pode ser utilizado por:
Toda informação relacionada ao produto deve permanecer centralizada.
Serviços seguem a mesma filosofia dos produtos.
Participam de:
Clientes, fornecedores, transportadoras, vendedores, contatos comerciais e contadores representam especializações do conceito de Pessoa.
A plataforma reutiliza a mesma estrutura cadastral sempre que possível.
Isso reduz duplicidade e mantém consistência.
Usuários representam pessoas autorizadas a utilizar o ERP.
Eles não representam operadores de caixa.
Usuários:
Operadores pertencem ao ecossistema PDV.
Eles representam os atendentes responsáveis pelas vendas realizadas nos caixas.
Sua função é distinta do usuário do ERP.
O Técnico representa o responsável pela execução de Ordens de Serviço.
Quando vinculado a um usuário, pode acessar apenas suas próprias atividades.
A venda representa um dos principais eventos da plataforma.
Ela conecta diversos domínios.
Venda
│
├── Cliente
├── Produto
├── Estoque
├── Financeiro
├── Fiscal
├── Cobrança
├── Comissão
├── Relatórios
└── Ordem de Serviço (quando necessário)
A venda nunca deve ser tratada como um processo isolado.
Produtos definem comportamentos.
Exemplo.
Um produto pode:
Ou seja.
O comportamento da venda depende do produto.
A Ordem de Serviço não é um módulo independente.
Ela representa uma consequência operacional.
Ela pode nascer:
A geração automática ocorre quando uma venda contém produtos configurados para exigir instalação.
A origem da venda é irrelevante.
Pode ser:
O gatilho sempre será o cadastro do produto.
Cobranças representam uma consequência financeira.
Elas podem ser originadas a partir do faturamento da empresa.
O módulo centraliza:
Sempre integrados ao financeiro.
O Perfil Tributário representa uma entidade reutilizável.
Seu objetivo é evitar repetição de parametrizações fiscais.
Produtos e serviços podem compartilhar o mesmo perfil.
A resolução tributária segue uma hierarquia.
Produto / Serviço
↓
Perfil Tributário
↓
Empresa
Sempre prevalece a configuração mais específica.
A plataforma foi concebida para operar grupos empresariais.
Cada empresa mantém autonomia operacional.
Ao mesmo tempo, compartilha a mesma plataforma.
Integrações fazem parte da arquitetura.
Não representam funcionalidades adicionais.
A plataforma comunica-se naturalmente com:
Sempre que um processo exigir muitas etapas, deve existir um assistente.
Exemplos.
Sempre que possível.
Configurações devem obedecer uma hierarquia.
Exemplo.
Empresa
↓
Perfil
↓
Item
Isso reduz manutenção.
Toda informação deve existir apenas uma vez.
Exemplos.
Perfil Tributário.
Categorias.
Centro de Custo.
Naturezas.
Perfis.
Usuários.
A plataforma é orientada por eventos.
Exemplo.
Venda realizada.
↓
Atualiza estoque.
↓
Atualiza financeiro.
↓
Atualiza fiscal.
↓
Atualiza dashboards.
↓
Sincroniza PDVs.
↓
Sincroniza integrações.
↓
Gera notificações.
O ERP adapta-se ao segmento da empresa.
Não existem funcionalidades obrigatórias para todos.
Recursos são habilitados conforme:
O PDVPOS ERP deve ser entendido como uma plataforma composta por domínios especializados.
PDVPOS ERP
┌────────────┬────────────┐
Comercial Financeiro
├────────────┼────────────┤
Estoque Fiscal
├────────────┼────────────┤
Serviços Cobranças
├────────────┼────────────┤
Relatórios Integrações
└────────────┴────────────┘
Todos compartilham as mesmas entidades centrais.
O PDVPOS ERP não foi desenvolvido como um conjunto de telas.
Ele foi desenvolvido como um conjunto de regras de negócio reutilizáveis.
As telas apenas apresentam essas regras ao usuário.
Sempre que uma nova funcionalidade for criada, ela deverá integrar-se naturalmente aos conceitos descritos neste documento.
Este documento representa a base conceitual da plataforma.
Ele deve ser utilizado como referência para:
Toda evolução do PDVPOS ERP deve preservar estes conceitos, garantindo consistência, simplicidade e escalabilidade ao longo do tempo.
Navegacao: Início | Introdução