Cadastro de Mercadoria

Mercadorias

  1. Acesse Cadastros → Mercadorias e use o botão + (ou Cadastrar mercadoria na listagem).
  2. Preencha nome e unidade de medida (obrigatórios), SKU, marca, grupo e subgrupo (o subgrupo depende do grupo selecionado).
  3. Escolha o modo do produto:
    • Produto simples: um único registro operacional — custo, preço, markup, estoque mínimo, saldo e código de barras ficam no próprio cadastro do pai. Atualização de custo e preço de tabela ocorre principalmente nas compras (e promoções para o preço de venda).
    • Produto com variações: o item vira um produto pai com grade. Após salvar como com variações, não é possível voltar ao modo simples. No formulário, os campos de custo, preço, markup, estoque e código de barras do bloco principal deixam de ser o operacional: passam a valer os valores por variante na grade (custo/preço/markup/estoque atualizados nas compras por variante). O pai continua com dados gerais (nome, unidade, imagem, NCM, fabricante, cubagem, peso, grupo etc.). O endereço no depósito fica em cada variante.
    • Converter simples com saldo: se a mercadoria simples tem saldo no catálogo, marcar com variações abre a aba Grade antes de gravar. É obrigatório definir ao menos um eixo e informar a quantidade de cada variante. A soma precisa ser igual ao saldo (variante com zero é válida). O preço de venda pode ser ajustado em cada variante. O custo permanece o da última compra e só muda numa compra nova; o markup acompanha o preço sobre esse custo. O saldo do pai não entra nem sai: ele passa a ser a soma das variantes. O código de barras do cadastro simples deixa de valer para todas as variantes. A conversão é recusada com saldo negativo, com soma diferente, se ainda houver saldo numa rota de venda ativa (devolva o saldo ou encerre a rota) ou se a mercadoria estiver num orçamento aberto (cancele o orçamento ou transforme-o em venda antes). Os lançamentos feitos enquanto ela era simples não são reescritos. Depois da conversão, essa venda não cancela nem reabre, a nota dessa venda não cancela, a compra antiga não cancela, o orçamento antigo não vira venda e a devolução dessa mercadoria (no recebimento ou por NF-e) é recusada: estoque e títulos ficam como foram gravados. Sem saldo, salvar como com variações e montar a grade em seguida: cada variante nasce com quantidade zero e recebe o custo, o preço e o markup do cadastro simples. Esses valores permanecem até uma compra nova. A planilha de edição não faz esse desmembramento.
  4. A tela de cadastro e a de edição usam abas (os campos de todas as abas salvam juntos):
    • Dados: nome, SKU e, logo abaixo, unidade, grupo, subgrupo e marca. Em seguida, modo (simples ou com variações), código fabricante, quantidade por embalagem, cubagem, peso e detalhes. No produto simples, o endereço no depósito fica junto da cubagem. Na mercadoria com variações, o endereço é informado em cada linha da grade. A foto da mercadoria fica nesta aba, no cadastro e na edição. Ao lado do SKU, o botão Gerar sugere o próximo código — veja a regra abaixo. Ele não grava sozinho.
    • Comercial: em produto simples, custo, preço, markup, código de barras, estoque mínimo e (na edição) saldo atual. Em produto com variações esta aba some: esses valores passam a ser por variante na aba Grade. O botão Gerar código preenche um código numérico interno da loja, único no cadastro, a partir do ID da empresa e do ID da mercadoria. Na grade, o botão de cada linha usa o ID da variante já salva. O botão não grava sozinho: salve o cadastro. Use quando não houver código do fabricante. O número fica marcado como código interno: o PDV e a etiqueta leem, mas ele não é código de barras de fabricante e não entra como código válido em vendas online nem como GTIN da nota. Se o campo for trocado por um código do fabricante, a marca some.
    • Fiscal: NCM, origem (0–8), CEST e CSOSN se diferente do padrão da empresa. Opcionais e disponíveis mesmo sem o add-on de NF-e. Produto sem NCM continua salvando; o NCM de 8 dígitos só é exigido na pré-checagem da nota. Com a diretiva Mercadorias — sugerir dados fiscais (NCM) ligada, o botão Sugerir com IA propõe NCM (e, com cautela, CEST/CSOSN) a partir do nome e dos demais dados já preenchidos. Na mesma linha do NCM, Consultar NCM explica o código (TIPI) via IA; a primeira consulta consome tokens e fica em cache no tenant — nas visitas seguintes a descrição aparece sem nova cobrança. A sugestão não grava sozinha, conta na cota mensal de tokens de IA e pode estar incorreta — confirme com o contador antes de emitir NF-e. Origem da mercadoria não é preenchida pela IA.
    • Grade: na edição de produto com variações e, na conversão de um produto simples (com ou sem saldo), assim que o modo com variações é marcado. Eixos, valores e combinações — veja 4.2 Grade de variações.
  5. Em modo simples, cubagem, peso e NCM são opcionais. Clique em Salvar em qualquer aba.
  6. Em modo com variações, após salvar, use Editar para abrir a grade de variações (eixos, valores e combinações).
  7. Opcionalmente escolha uma foto na aba Dados (JPEG, PNG, WebP, GIF ou HEIC/HEIF, até 8 MB). No cadastro novo, a imagem fica só neste navegador: nada é enviado enquanto você não clica em Salvar. Ao salvar, a mercadoria é gravada e, em seguida, a foto sobe para o armazenamento. Se o envio da foto falhar, a mercadoria permanece salva e a tela de edição abre para você escolher o arquivo de novo. Se o salvamento da mercadoria falhar (SKU repetido, limite do plano etc.), a foto não é enviada e é preciso escolhê-la outra vez. Na edição, escolher uma foto envia na hora e substitui a anterior, sem esperar o Salvar do formulário. A miniatura aparece na listagem e nas telas de venda. Quem só consulta a mercadoria não troca a foto.
  8. Clique em Salvar. A tela mostra Salvando... e ignora outro clique enquanto grava. O sistema verifica o limite de produtos do plano antes de criar.
  9. O SKU não pode se repetir. Se já existir em outra mercadoria (ou em uma variante de outro cadastro), a tela mostra o código informado e a mercadoria existente (#id e nome), em vez de um erro genérico. Altere o valor ou edite o cadastro já existente.
  10. O botão Gerar, ao lado do SKU na aba Dados (cadastro e edição) e em cada linha da grade, sugere um código no formato marca-grupo-sequencial. Marca Samsung e grupo Eletrônicos geram SAM-ELE-005 quando já existem quatro códigos nesse prefixo. Cada trecho usa as três primeiras letras ou números do nome, sem acento. Nome com menos de três caracteres completa com zero (LG vira LG0). O número é o próximo daquele prefixo, com pelo menos três dígitos, e olha mercadorias, variantes e os SKUs já preenchidos na tela. Sem marca, o primeiro trecho fica 000 (000-ELE-001). Sem grupo, o do meio fica 000 (SAM-000-001). Sem os dois, o código fica 000-000-001. Se o campo já tiver SKU, a tela pede confirmação antes de substituir. Quem só consulta a mercadoria não vê o botão. A permissão é a de cadastrar ou editar mercadorias. O botão não grava: é preciso salvar.
  11. Excluir: administradores (permissão Mercadorias — Excluir (sem movimentação)) podem excluir uma mercadoria recém-cadastrada na listagem ou na tela de edição, com confirmação. Se já existir qualquer movimentação (compra, venda, orçamento, rota de venda, estoque ou promoção — inclusive em variantes), o botão não aparece e o sistema recusa a exclusão.

Visualizar sem editar: usuários sem permissão de edição podem abrir a mercadoria em modo somente leitura (sem gravar alterações na grade).

No mesmo módulo

Quer usar isso na operação?

Estoque, vendas, rotas e financeiro no mesmo sistema. O teste dura 7 dias.

Ver planos