Cadastro de Mercadoria
Mercadorias
- Acesse Cadastros → Mercadorias e use o botão + (ou Cadastrar mercadoria na listagem).
- Preencha nome e unidade de medida (obrigatórios), SKU, marca, grupo e subgrupo (o subgrupo depende do grupo selecionado).
- 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.
- 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.
- Em modo simples, cubagem, peso e NCM são opcionais. Clique em Salvar em qualquer aba.
- Em modo com variações, após salvar, use Editar para abrir a grade de variações (eixos, valores e combinações).
- 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.
- 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.
- 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.
- 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-005quando 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 (LGviraLG0). 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 fica000(000-ELE-001). Sem grupo, o do meio fica000(SAM-000-001). Sem os dois, o código fica000-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. - 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).

