> ## Documentation Index > Fetch the complete documentation index at: https://docs.teceo.co/llms.txt > Use this file to discover all available pages before exploring further. # referência de campos do produto o cadastro do produto se divide em 13 abas: dados gerais, categoria, variações, skus, pré-venda, estoque-futuro, pronta-entrega, matéria-prima, consumo, mídias e tags, definições por cor, packs e estoque de packs. dados gerais é um formulário; as demais abas são listas, e cada linha é um sku ou um produto-cor. as abas a partir de pré-venda ficam indisponíveis enquanto o produto não tem nenhum sku. ## dados gerais os sete campos do formulário, na ordem da tela. | campo | tipo | obrigatório | comportamento | | - | - | - | - | | nome do produto | texto | obrigatório, na criação e na edição | | | produto ativo? | marcação | não | marcada por padrão no produto novo | | código do produto | texto | obrigatório, na criação e na edição | não se repete entre os produtos da marca | | referência do produto | texto | não | pode se repetir entre os produtos da marca | | coleção | seleção única entre as coleções cadastradas pela marca | obrigatório, na criação e na edição | | | descrição | texto com formatação | não | | | detalhes | texto com formatação | não | | a descrição e os detalhes aceitam negrito, itálico, sublinhado, três tamanhos de texto, lista com marcadores, lista numerada e link. nenhum campo de texto do produto tem limite de caracteres. o botão salvar existe apenas em dados gerais e grava os sete campos acima. nas demais abas, cada alteração é gravada na própria lista, sem botão de salvar. ## categoria a aba mostra a árvore de categorias e subcategorias cadastradas pela marca. | campo | tipo | obrigatório | comportamento | | - | - | - | - | | categoria | seleção única na árvore | não | o produto tem uma categoria por vez. marcar uma subcategoria marca também a categoria acima dela. a seleção é gravada na própria aba | o cadastro das categorias está em [criar categorias e subcategorias](/docs/categorias/criar-categorias-e-subcategorias). ## variações duas seções, cores e tamanhos. | campo | tipo | obrigatório | comportamento | | - | - | - | - | | digite o nome da cor | seleção múltipla entre as cores cadastradas pela marca | não | cada opção aparece como código e nome. a seleção é gravada a cada cor escolhida, e remover uma cor é imediato, sem confirmação | | digite o nome do tamanho | seleção múltipla entre os tamanhos cadastrados pela marca | não | tamanho inativo já vinculado ao produto aparece com o sufixo (inativo). a seleção é gravada a cada tamanho escolhido, e remover um tamanho é imediato, sem confirmação | o produto sem cor e sem tamanho selecionados recebe a cor única e o tamanho único cadastrados pela marca. ## skus a lista tem um sku por linha. o sku é a combinação do produto com uma cor e um tamanho, e o botão gerar skus abre a matriz de cores por tamanhos. o código, o código de barras, a unicidade e o que o sincronismo altera estão em [referência de campos do sku](/docs/skus/referencia-de-campos-do-sku). | coluna | o que mostra | editável | | - | - | - | | sku | a cor e o tamanho da combinação | não | | código do sku | o código do sku | sim, na própria célula | | código de barras | o código de barras do sku | sim, na própria célula | | preço de sell-in | o preço de sell-in do sku | sim, na própria célula | | preço médio de sell-out | o preço médio de sell-out do sku | sim, na própria célula | cada célula editada é gravada ao sair do campo. sem código informado na geração, o código do sku é o código do produto mais o código da cor mais o nome do tamanho. as ações da aba: | ação | o que faz | | - | - | | editar preço sell-in | aplica um preço de sell-in aos skus selecionados | | editar preço sell-out | aplica um preço médio de sell-out aos skus selecionados | | editar peso e dimensões | aplica peso e medidas aos skus selecionados. deixar um campo em branco mantém o peso ou a dimensão atual do sku | | adicionar à promoção | adiciona os skus selecionados a uma promoção | | remover sku | remove o sku. é ação de linha, não de seleção. o sku vinculado a janela de entrega, pedido ou tabela de preço não pode ser removido | os campos de editar peso e dimensões: | campo | tipo | obrigatório | comportamento | | - | - | - | - | | peso (g) | número inteiro, em gramas | não, e o campo em branco mantém o peso atual do sku | maior que zero, e abaixo do máximo permitido | | comprimento (cm) | número | não, e o campo em branco mantém a dimensão atual do sku | maior que zero, e abaixo do máximo permitido | | largura (cm) | número | não, e o campo em branco mantém a dimensão atual do sku | maior que zero, e abaixo do máximo permitido | | altura (cm) | número | não, e o campo em branco mantém a dimensão atual do sku | maior que zero, e abaixo do máximo permitido | ## pré-venda o topo traz quatro campos, no bloco pedido mínimo, gravados automaticamente depois da digitação. | campo | tipo | obrigatório | comportamento | | - | - | - | - | | por produto | número | não | aceita zero | | por item(cor) | número | não | aceita zero | | múltiplo por produto | número | não | aceita zero | | múltiplo por item(cor) | número | não | aceita zero | as colunas da lista: | coluna | o que mostra | editável | | - | - | - | | sku | a cor e o tamanho da combinação | não | | código do sku | o código do sku | não | | disponibilidade | se o sku está disponível para venda em pré-venda | sim, na própria coluna | | janelas de entrega | a janela de entrega da disponibilidade | sim, na própria célula | | data inicial | o início do período da pré-venda | sim, na própria célula | | data final | o fim do período da pré-venda | sim, na própria célula | ## estoque-futuro | coluna | o que mostra | editável | | - | - | - | | sku | a cor e o tamanho da combinação | não | | código do sku | o código do sku | não | | disponibilidade | se o sku está disponível para venda em estoque-futuro | sim, na própria coluna | | janela de entrega | a janela de entrega da disponibilidade | sim, na própria célula | | estoque total | a quantidade total do estoque futuro | sim, na própria célula, depois que a linha tem disponibilidade criada | | estoque reservado | a quantidade já comprometida com pedidos em aberto | não | | estoque disponível | o estoque total menos o estoque reservado | não | | estoque não reservado | a quantidade não reservada | não | | data inicial | o início do período | sim, na própria célula | | data final | o fim do período | sim, na própria célula | ## pronta-entrega o topo traz os mesmos quatro campos do bloco pedido mínimo descritos em pré-venda. | coluna | o que mostra | editável | | - | - | - | | sku | a cor e o tamanho da combinação | não | | código do sku | o código do sku | não | | local | o nome e o código do local do estoque. a coluna fica oculta até ser marcada no controle de colunas | não | | disponibilidade | se o sku está disponível para venda em pronta-entrega | sim, na própria coluna | | estoque total | a quantidade total em estoque | sim, na própria célula | | estoque reservado | a quantidade já comprometida com pedidos em aberto | não | | estoque disponível | o estoque total menos o estoque reservado | não | | estoque não reservado | a quantidade não reservada | não | | data inicial | o início do período | sim, na própria célula | | data final | o fim do período | sim, na própria célula | pronta-entrega não tem coluna de janela de entrega. ## matéria-prima a aba lista a pré-venda por matéria-prima dos skus deste produto. a matéria-prima não é cadastrada pela plataforma: ela entra pela integração com o sistema de gestão. | coluna | o que mostra | editável | | - | - | - | | sku | a cor e o tamanho da combinação | não | | código do sku | o código do sku | não | | disponibilidade | se o sku está disponível para venda por matéria-prima | sim, na própria coluna, depois que a linha tem disponibilidade criada | | janela de entrega | a janela de entrega da disponibilidade | sim, na própria célula | | estoque total | o total da matéria-prima | não | | estoque reservado | a quantidade de matéria-prima já comprometida com pedidos em aberto | não | | estoque disponível | o estoque total menos o estoque reservado | não | | data inicial | o início do período | sim, na própria célula, depois que a linha tem disponibilidade criada | | data final | o fim do período | sim, na própria célula, depois que a linha tem disponibilidade criada | ## consumo o consumo é a quantidade de cada matéria-prima que uma unidade do sku gasta. | coluna | o que mostra | editável | | - | - | - | | sku | a cor e o tamanho da combinação | não | | código do sku | o código do sku | não | | matéria-prima | as matérias-primas vinculadas ao sku, uma por linha | não, o vínculo se faz por adicionar consumo | | consumo | quanto o sku gasta de cada matéria-prima, em número decimal | sim, na própria célula | as ações da aba: | ação | o que faz | | - | - | | adicionar consumo | vincula uma matéria-prima aos skus selecionados, ou ao sku da linha | | remover matéria-prima | remove o vínculo de matéria-prima. é ação de linha, e só aparece na linha que já tem ao menos uma matéria-prima | ## mídias e tags | coluna | o que mostra | editável | | - | - | - | | cor | a imagem ou a cor sólida do produto-cor | não | | nome | o código e o nome da cor | não | | mídia | as fotos e os vídeos já enviados para a cor. o sinal de mais abre o envio | sim, pelo sinal de mais | | tag | a tag da cor, ou nenhuma | sim, na própria célula | cada cor aceita até 7 mídias. os formatos e os tamanhos de cada um estão em [guia de tamanhos de fotos e vídeos](/docs/midias/guia-de-tamanhos-de-fotos-e-videos). no envio, a ordem das mídias muda por arrastar, e nada é gravado sem aplicar. ## definições por cor | coluna | o que mostra | editável | | - | - | - | | imagem | a imagem ou a cor sólida do produto-cor | não | | nome | o nome da cor, com link para o cadastro dela, exceto quando é a cor única da marca | não | | grade fechada para pré-venda | ligada, a grade daquela cor não aceita alteração na pré-venda | sim, na própria coluna | | grade fechada para pronta-entrega | ligada, a grade daquela cor não aceita alteração na pronta-entrega | sim, na própria coluna | | classificações | as classificações de produto vinculadas ao produto-cor. mostra três e resume o restante num contador | sim, pelo sinal de mais | classificar o produto-cor está descrito em [classificar produtos por cor](/docs/classificacoes/classificar-produtos-por-cor). ## packs packs são quantidades pré-definidas de peças por tamanho. o vínculo é por produto-cor e por disponibilidade, e as duas colunas aceitam packs diferentes. | coluna | o que mostra | editável | | - | - | - | | produto-cor | a imagem e o nome da cor | não | | packs de pré-venda | os packs vinculados à cor na pré-venda, e a marcação bloquear aplicação parcial | sim, na própria célula | | packs de pronta-entrega | os packs vinculados à cor na pronta-entrega, e a marcação bloquear aplicação parcial | sim, na própria célula | bloquear aplicação parcial é marcada dentro de cada uma das duas colunas e vale só para aquela disponibilidade. ## estoque de packs | coluna | o que mostra | editável | | - | - | - | | produto-cor | a imagem e o nome da cor | não | | disponibilidade | a disponibilidade do vínculo de pack | não | | pack | o pack vinculado, com as quantidades por tamanho | não | | controle de estoque | marcação que liga o controle de saldo daquele vínculo | sim, na própria coluna | | estoque total | a quantidade total do pack | sim, na própria célula | | estoque reservado | a quantidade já comprometida com pedidos em aberto | não | | estoque disponível | o estoque total menos o estoque reservado | não | controlar estoque por pack depende de duas marcações em duas abas: grade fechada, em definições por cor, e bloquear aplicação parcial, em packs. as regras de pack estão em [packs](/docs/grades/packs). ## ações em massa das abas de disponibilidade as ações abaixo valem para pré-venda, estoque-futuro, pronta-entrega e matéria-prima. | ação | o que faz | em que abas aparece | | - | - | - | | criar novas disponibilidades | cria disponibilidades para os skus selecionados a partir das janelas de entrega escolhidas. combinações já existentes são ignoradas | estoque-futuro e matéria-prima | | editar janelas de entrega | define uma nova janela de entrega para os itens selecionados. ao deixar o campo vazio, os dados atuais serão removidos | pré-venda, estoque-futuro e matéria-prima | | editar estoque total | define um novo valor de estoque para os itens selecionados. ao deixar o campo vazio, os dados atuais serão removidos | estoque-futuro e pronta-entrega | | editar períodos | define um novo período para os itens selecionados. ao deixar o campo vazio, os campos de datas serão limpos | as quatro abas | | ativar disponibilidades | torna os itens selecionados disponíveis para venda, quando as configurações necessárias estiverem finalizadas. só aparece com ao menos um item selecionado que ainda não está disponível | as quatro abas | | inativar disponibilidades | tira da venda os itens selecionados. só aparece com ao menos um item selecionado que está disponível | as quatro abas | | integrar estoques | traz o estoque dos itens selecionados do sistema de gestão. só aparece com a integração de estoque ativa | pronta-entrega | | limpar campos | apaga a disponibilidade da linha. é ação de linha, não de seleção | estoque-futuro, pronta-entrega e matéria-prima | | remover disponibilidade | apaga a disponibilidade da linha. é ação de linha, não de seleção | pré-venda | as linhas sem janela de entrega são ignoradas por editar estoque total, editar períodos, ativar disponibilidades e inativar disponibilidades. ## mensagens | mensagem | quando aparece | | - | - | | obrigatório | ao salvar dados gerais com nome do produto, código do produto ou coleção em branco | | código do produto já cadastrado | ao salvar um código do produto já usado por outro produto da marca | | sku necessário para venda | no sinal vermelho da aba skus, enquanto o produto não tem nenhum sku | | já existe um sku cadastrado no produto para a cor e tamanho informado | ao gerar um sku para uma combinação de cor e tamanho que o produto já tem | | nenhuma categoria cadastrada / cadastre uma categoria e tente novamente. | na aba categoria, quando a marca não tem nenhuma categoria cadastrada | | o peso deve ser um número inteiro, em gramas | ao informar peso com casas decimais em editar peso e dimensões | | o valor deve ser maior que zero | ao informar zero ou valor negativo em editar peso e dimensões | | o valor é maior que o máximo permitido | ao informar peso ou dimensão acima do limite em editar peso e dimensões | | deixar um campo em branco mantém o peso ou a dimensão atual do sku | como texto de apoio de editar peso e dimensões | | ao deixar o campo vazio, os dados atuais serão removidos. | como texto de apoio de editar janelas de entrega e de editar estoque total | | ao deixar o campo vazio, os campos de datas serão limpos. | como texto de apoio de editar períodos | | esta ação pode levar alguns minutos. combinações já existentes serão ignoradas. | como texto de apoio de criar novas disponibilidades | | ao inativar, pedidos em aberto com os itens selecionados ficarão inválidos e precisarão de correções manuais. | ao confirmar inativar disponibilidades | | ao confirmar, pedidos em aberto com este item ficarão inválidos e precisarão de correções manuais. | ao confirmar remover disponibilidade | | atenção: ao remover a disponibilidade com controle de estoque de material ativo, as reservas de material dos pré-pedidos em aberto deste sku poderão ser liberadas automaticamente. | ao remover uma disponibilidade com controle de estoque de matéria-prima | | as alterações realizadas em lote podem demorar até 30 minutos para serem aplicadas nos itens selecionados | ao confirmar uma ação em massa | | nenhuma das linhas selecionadas tem janela de entrega | ao aplicar uma ação em massa de disponibilidade a linhas sem janela de entrega | | o estoque disponível para venda é igual ao estoque total menos o estoque reservado em pedidos! (disponível = total - reservado) | no texto de apoio da coluna estoque disponível | | para controlar estoque por packs, ative as opções "grade fechada" na aba "definições por cor" e "bloquear aplicação parcial" na aba "packs". | ao ligar controle de estoque em estoque de packs sem as duas marcações | | não é possível alterar pois há um ou mais vínculos de pack com controle de estoque ativo. | ao alterar o vínculo de packs de uma cor que já tem controle de estoque ligado | | ação não disponível pois há skus com controle de estoque de material | ao alterar o vínculo de packs de uma cor com sku controlado por matéria-prima | This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.