Listar Mercadorias
Mercadorias
Importação em lote: na listagem há o painel Importação em lote com duas abas — Dados (XLSX) e Fotos (ZIP).
Dados (XLSX): exige permissão Mercadorias — Importar. O modelo contém as colunas: Nome, SKU, Modo do produto, Unidade, Estoque mínimo, Marca, Grupo, Subgrupo, Código fabricante, Quantidade por embalagem, NCM, Detalhes, Altura (cm), Largura (cm), Profundidade (cm), Peso (g). Obrigatórios: Nome e Unidade. Cubagem e peso são opcionais (decimais com até duas casas; valores negativos são rejeitados). O campo Modo do produto aceita SIMPLE ou VARIABLE; se omitido, o sistema considera SIMPLE. Se informar Subgrupo, o Grupo é obrigatório. O SKU deve ser único no arquivo e no sistema. Unidades, marcas, grupos e subgrupos inexistentes são criados automaticamente na importação. O limite de produtos do plano é respeitado. A importação não substitui a configuração completa da grade (eixos e combinações): produtos VARIABLE importados precisam ser abertos em Editar para cadastrar variantes. Planilhas antigas sem as colunas de cubagem/peso continuam válidas. Em Baixar modelo XLSX, escolha Cadastro (planilha vazia, sem o código da mercadoria) ou Edição (planilha preenchida com todas as mercadorias e a coluna ID). A de edição não traz preço, custo nem saldo; o envio atualiza as mercadorias desses IDs e exige também a permissão Mercadorias — Editar. Preços continuam nos ajustes já existentes. Ao importar, a interface exibe carregamento até o fim do processamento.
Fotos (ZIP): exige permissão Mercadorias — Editar. Compacte as fotos em um arquivo .zip (até 50 MB, máximo 150 imagens). Cada imagem deve ser nomeada pelo ID, SKU ou código de barras da mercadoria já cadastrada (ex.: 42.jpg, SKU001.webp). Formatos aceitos: JPEG, PNG, WebP, GIF ou HEIC/HEIF (máx. 8 MB por imagem). O botão Baixar guia XLSX (quando você também possui permissão de importar dados) lista as mercadorias com sugestão de nome de arquivo. O sistema envia cada foto ao Cloudinary e atualiza a miniatura da mercadoria — o mesmo fluxo do upload individual em Editar. Não cria mercadorias novas. Em falha parcial, um bloco Detalhes dos erros (fotos ZIP) indica o arquivo e o motivo; mercadorias fora do escopo do vendedor restrito por rota são ignoradas com mensagem de permissão. Requer Cloudinary configurado no servidor.
Filtros: busca por nome ou SKU; filtros por marca, grupo e subgrupo (subgrupo depende do grupo). Paginação: 20 por página. Use «« / »» para ir à primeira ou última página, ou informe o número no campo Página e clique em Ir.
Exportações: na listagem, o botão Exportar Excel abre um modal para escolher o modo de estoque (todas as mercadorias do filtro ou apenas linhas com estoque positivo). A geração de catálogo em PDF na web é feita em Ferramentas → Gerar catálogos PDF (seção dedicada, em segundo plano). O app mobile continua usando a API síncrona de catálogo PDF.

