> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apexx.work/llms.txt
> Use this file to discover all available pages before exploring further.

# Produtos

> O cadastro que sustenta estoque, vendas e anúncios.

Em **Cadastros → Produtos**. O produto é o cadastro comercial; quem guarda
saldo, SKU e código de barras é a **variação** dentro dele.

> [!NOTE]
>
> Produto sem grade também tem variação: uma só, criada automaticamente e
> invisível na tela. É o que faz o estoque funcionar igual para todo mundo.

## A lista

Cada linha mostra o produto, o **SKU**, o **Tipo** (Simples, Variações com a
quantidade, Kit com o número de itens), o **Preço** (no produto com grade, a
faixa de preço das variações), o **Estoque** e o **Status**. O estoque é o
disponível: em vermelho quando zerou, e com **Acabando** quando está no mínimo
ou abaixo dele.

Os filtros são **Tipo**, **Status**, **Categoria**, **Marca** e **Estoque**
(Em estoque, Estoque baixo, Sem estoque). O kit abre na própria lista e mostra
os itens dele.

## Formato

O **Formato**, logo abaixo do nome, decide o resto do formulário.

> [card] Simples
>
> O caso normal: um produto, um saldo.

> [card] Com variações
>
> Cor, tamanho, numeração. A grade aparece logo abaixo e cada combinação tem
> saldo próprio. Veja [Variações](https://docs.apexx.work/cadastros/variacoes.md).

> [card] Kit
>
> Vendido como um, composto por vários produtos do cadastro, cada um com a
> sua quantidade.

> [!NOTE]
>
> O kit tem saldo próprio: você dá entrada no kit já montado, e a venda baixa
> o kit, não os itens dele. O kit que tira o saldo dos componentes ainda não
> existe. Na lista do Estoque, o kit mostra quantos dá para montar com o que
> há dos componentes, só como referência.

## O formulário

> [accordion] Geral
>
> **Produto**: foto de capa, nome, formato, **Código (SKU)**, preço de venda,
> preço de compra, preço de custo e descrição. O código vem sugerido
> (`PROD-0001`, ou `KIT-0001` no kit) e pode ser trocado; não pode repetir.
> O preço de compra é o que você paga ao fornecedor pela unidade, e é com ele
> que o produto entra no pedido de compra. O preço de custo é o que a unidade
> custa com tudo.
>
> **Características**: categoria, subcategoria, marca, condição (novo,
> usado, recondicionado), produção (terceiros ou própria) e unidade de
> medida. Escolher uma marca que tem fornecedor ligado preenche o
> fornecedor, se ele estiver vazio.
>
> **Atributos**: a ficha técnica que a categoria pede (voltagem, material) e
> os atributos que são só deste produto.
>
> **Mídias**: fotos, vídeos, documentos e links. Cada foto vai até 10 MB.

> [accordion] Estoque
>
> **Dimensões**: peso líquido, peso bruto, altura, largura e comprimento da
> embalagem, volumes e itens por caixa.
>
> **Controle**: **Controla estoque**, **Controla lote e validade**, estoque
> atual, mínimo e máximo. Desligar o controle de estoque apaga os números do
> estoque e o produto deixa de ser reservado na venda (serve para brinde e
> item de consumo).
>
> **Lotes**: os lotes do produto, com chegada, validade, físico e reservado.
>
> **Localização**: o depósito do produto e onde ele fica dentro dele
> (corredor, prateleira). **Fornecedor**: de quem você compra e o código que
> o fornecedor usa para o item, que é o que casa a linha da nota de entrada
> com o produto.

> [accordion] Fiscal
>
> Código de barras (GTIN/EAN), DUN-14, NCM, CEST, origem, tipo do item,
> situação do ICMS e IPI. Cada campo diz para que serve. São usados na NF-e
> que você emite. Veja [Fiscal](https://docs.apexx.work/configuracoes/fiscal.md).

> [accordion] Observações
>
> O que não cabe em outro campo: cuidados no manuseio, combinados com o
> fornecedor.

Categorias, marcas, atributos e listas de preços se cadastram em
**Configurações → Produtos**. No campo **Categoria**, **Nova categoria** cria
uma sem sair do produto.

> [!NOTE]
>
> O preço promocional não aparece no formulário do produto, só no de cada
> variação.

## O estoque no cadastro

No produto novo, o **Estoque Atual** vira a entrada de saldo inicial, no
depósito do produto (ou no padrão), com o preço de custo. Depois, mudar o
número lança um ajuste com a diferença, que fica no extrato. O produto com
variações não tem esse campo: o saldo é de cada variação.

Com **Controla lote e validade** ligado, o estoque atual fica só de leitura:
ele é a soma dos lotes, e o lote entra pela nota de entrada ou por um
lançamento. Veja [Lotes e validade](https://docs.apexx.work/estoque/lotes-e-validade.md).

## Importar e exportar

Os dois ficam em **Ações**.

**Importar produtos** abre um diálogo: solte a planilha (.xlsx ou .csv) ou o
XML de uma NF-e, até 500 linhas por arquivo. A exportação de produtos do
**Bling** e do **Tiny** entra como saiu de lá, e **Baixar a planilha modelo**
mostra as colunas para montar a sua. O diálogo mostra só um resumo: as linhas
com problema ficam de fora e saem numa planilha com o motivo, em **Baixar com
os motivos**. Não há conferência linha a linha.

* Código já cadastrado é ignorado; produto sem código ganha o próximo da
  sequência.
* Variações em linhas próprias, com o **Código do pai**, viram um produto com
  grade.
* O estoque inicial entra no depósito padrão.
* Categorias que ainda não existem são criadas.
* Kit entra como produto simples: a composição não vem no arquivo.

**Exportar produtos** gera Excel ou CSV com as colunas da lista: todos, os da
busca e dos filtros de agora, ou os selecionados. Produto na lixeira nunca sai
na exportação.

## Excluir um produto

> [!WARNING]
>
> Produto com saldo não vai para a lixeira: nem em estoque, nem reservado,
> nem bloqueado. A mensagem diz o que segura o cadastro. Lance uma saída ou um
> balanço que zere o saldo antes de excluir.

Na lixeira (**Ver excluídos**, em Ações), o produto pode ser restaurado.
Excluir de vez é recusado para o produto com histórico em movimentação,
pedido ou nota: os documentos antigos precisam continuar legíveis, e o
produto fica arquivado na lixeira.

## Importar do marketplace

Se você já vende no Mercado Livre, não digite o catálogo: crie os produtos a
partir dos anúncios, com grade, fotos e SKUs. Veja
[Criar produtos a partir dos anúncios](https://docs.apexx.work/integracoes/mercado-livre/produtos.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.