Primeiros passos de uma loja nova#
A sequência recomendada para deixar uma loja pronta para operar: identidade, acesso, estrutura, catálogo, preço, posição inicial de estoque e caixa — na ordem em que o produto exige.
Antes de começar — quem executa precisa de retaguarda.loja_gerenciar,
retaguarda.usuario_gerenciar, retaguarda.perfil_gerenciar, retaguarda.parametro_gerenciar,
retaguarda.produto_gerenciar, estoque.local_gerenciar e retaguarda.checkout_gerenciar. A
decisão fiscal é do responsável fiscal da empresa, não de quem configura.
O princípio que ordena tudo: uma etapa só libera a seguinte quando as dependências dela estão conferidas. Integração que fornece dado mestre se valida antes de importar esse dado, e cadastro provisório não é sobrescrito sem conciliação.
Sequência recomendada#
| # | Etapa | Onde | Por que nesta ordem |
|---|---|---|---|
| 1 | Cadastrar a loja (tipo, regime, identidade fiscal, endereço) | Administração > Lojas | Sem loja não há a quem vincular usuário, local, preço nem caixa |
| 2 | Instalar o certificado A1 e configurar NFE/NFCe | Abas Certificado e NFE/NFCe da ficha da loja | Emissão depende de identidade fiscal e certificado |
| 3 | Criar perfis e acessos (retaguarda e frente de loja) | Administração > Perfis e acessos | O perfil define o que cada pessoa pode fazer |
| 4 | Criar usuários (retaguarda e PDV) com loja e perfis | Administração > Usuários e Usuários do PDV | Sem acesso ninguém opera — e o convite de senha é do usuário |
| 5 | Cadastrar locais de estoque e definir os padrões | Compras e estoque > Locais de estoque | Sem local padrão, venda e entrada caem no local ativo mais antigo |
| 6 | Revisar Parâmetros (e valores por loja, quando houver) | Administração > Parâmetros | Parâmetro muda o comportamento de tudo o que vem depois |
| 7 | Cadastrar parceiros, formas de pagamento, adquirentes e taxas | Parceiros e o domínio Financeiro | Compra, venda B2B, caixa e conciliação dependem desses cadastros |
| 8 | Configurar Catálogo Cosmos, se utilizado | Administração > Catálogo Cosmos | Conferir a consulta por EAN antes de completar o cadastro de produtos |
| 9 | Cadastrar produtos (fiscal, preço por loja, balança quando houver) | Operação e PDV > Produtos | É o que o caixa vende |
| 10 | Registrar a posição inicial (estoque contado e títulos) | Compras e estoque > Inventário e o domínio Financeiro | O saldo inicial precisa ser contado e assinado |
| 11 | Cadastrar os caixas (PDVs) e ativar cada um | Operação e PDV > Checkout — caixas | O caixa precisa existir para receber a carga |
| 12 | Enviar a Carga PDV (catálogo, preço e promoções) | Operação e PDV > Carga PDV | É o que faz o caixa vender com o preço certo |
| 13 | Configurar EasyAssist, se utilizado | EasyAssist | Validar a integração de vendas antes da primeira importação, após preparar os cadastros e a carga |
1. Cadastrar a loja#
Siga Como cadastrar uma loja. O essencial aqui: Tipo (matriz ou filial), Regime tributário e a identidade fiscal (CNPJ, Inscrição estadual, UF, Município, Cód. município (IBGE)). O regime muda o cálculo de imposto na precificação — errar aqui contamina todo preço sugerido.
2. Certificado A1 e emissão#
Na aba Certificado, envie o A1 (.pfx/.p12) e a senha. Na aba NFE/NFCe, configure Ambiente, Fuso horário fiscal, Série NF-e (modelo 55), Prazo contingência (h), Permite contingência offline e, se a loja emite NFC-e, ID token CSC e CSC.
Lembre: a série da NFC-e é de cada PDV — ela se define no cadastro do caixa, não na loja.
Detalhes: Certificado A1.
3. Perfis e acessos#
Crie pelo menos um perfil de Retaguarda para a gestão e um de Frente de loja para o caixa, marcando apenas as rotinas que a função realmente usa. Veja Como criar um perfil de acesso.
4. Usuários#
- Crie os usuários da retaguarda com Lojas com acesso e Perfis e gere o link de acesso para cada um (Usuários).
- Crie os Usuários do PDV com Código (matrícula), PIN do caixa e Papel (Usuários do PDV).
- Oriente cada pessoa a ativar o 2FA pelo próprio menu de conta — a ativação é do dono da conta.
5. Locais de estoque#
Cadastre os locais da loja (depósito, área de venda, câmara) e marque um como Padrão para venda e um como Padrão para recebimento. Sem isso, venda e entrada caem no local ativo mais antigo e o saldo por local fica sem sentido. Veja Locais de estoque.
6. Parâmetros#
Percorra Administração > Parâmetros com o responsável da loja. Parâmetro de risco alto exige motivo escrito, e o motivo fica no histórico. Parâmetros de Frente de loja aceitam valor por loja (bloco Valores por loja) quando a loja nova precisa de regra diferente da rede. Veja Como mudar um parâmetro.
Se a loja usa o clube de fidelidade, ajuste o parâmetro fidelidade.cashback — percentual 0
desliga o programa.
7. Parceiros e meios de pagamento#
Cadastre os fornecedores e clientes (Parceiros).
Os cadastros de Formas de pagamento, Adquirentes e Taxas de cartão são do domínio
Financeiro do conjunto docs/uso/ e precisam existir antes de o caixa receber — o mapa lista cada
tela com a permissão exigida.
8. Catálogo Cosmos#
Se a loja usa dados de produto por EAN, configure e valide o Catálogo Cosmos antes de completar os produtos.
9. Produtos#
Cadastre o catálogo começando pelos itens que a loja mais vende (Como cadastrar um produto). Garanta, por produto: NCM e perfil fiscal, preço e custo por loja e, se o item é pesado, a aba Balança com Código PLU.
Produto criado pela Entrada de NF-e nasce aguardando liberação fiscal e sai da fila Liberar venda — resolver o fiscal é ato do responsável fiscal.
Se a loja pesa ou etiqueta na balança, prepare também a carga para balanças.
10. Posição inicial#
- Conte o estoque inicial com o Inventário e processe a sessão.
- Registre os títulos em aberto do domínio Financeiro, conforme o que foi acordado com o cliente.
- Confira os totais antes de liberar a loja para vender.
11. Caixas (PDVs)#
- Abra Operação e PDV > Checkout — caixas e clique em Novo caixa.
- Cadastre o caixa com Tipo, Nome, Modo, Porta, Protocolo, Timeout (ms) e Habilitado.
- Cada caixa tem um código de ativação, usado na primeira conexão do terminal.
- Acompanhe pelos chips Comunicando, Sem sinal, Atualização pendente, App desatualizado, Em ativação e Inativos.
- Use a ação de linha de ativação e auditorias para ver o histórico do caixa.
12. Enviar a Carga PDV#
Com o catálogo e os preços revisados, envie a Carga PDV para a loja. Confira o KPI Preços pendentes: ele deve zerar. Se a loja tem gôndola com etiqueta de preço, gere e troque as etiquetas antes de enviar.
13. EasyAssist#
Se a loja importa vendas pelo EasyAssist, configure e valide o EasyAssist por loja antes da primeira importação. O Catálogo Cosmos pertence à etapa 8, pois fornece dados de produtos.
Resultado esperado#
- A loja aparece ativa, com identidade fiscal e emissão configuradas.
- Cada pessoa tem o perfil da função e as lojas corretas.
- Existe um local padrão de venda e um de recebimento.
- O catálogo chega ao caixa pela Carga PDV, com preço e promoções.
- O estoque inicial está contado e a diferença está registrada.
Se algo der errado#
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| O caixa vende com preço antigo | Carga PDV não enviada | Envie a carga e confira o KPI Preços pendentes |
| A venda baixa do local errado | Sem local Padrão para venda | Marque o padrão em Locais de estoque |
| A nota de entrada vai para o local errado | Sem local Padrão para recebimento | Marque o padrão |
| O usuário não vê a loja nova | Loja não marcada em Lojas com acesso | Ajuste o cadastro do usuário |
| O produto entra no caixa bloqueado | Fiscal pendente ou fila Liberar venda | Trate com o responsável fiscal |
| A NFC-e não emite | Certificado ou CSC ausentes | Complete as abas Certificado e NFE/NFCe |
| A loja não sincroniza | idestabelecimento ausente ou loja pausada | Veja EasyAssist |