> ## 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.

# packs

o pack é uma quantidade pré-definida de peças por tamanho, criado dentro de uma [grade de tamanhos](/docs/grades/grades-de-tamanhos), que o cliente aplica em um único passo. depois de criar o pack, defina quais produtos o usam, quanto o cliente pode alterar e se aquele uso consome um estoque próprio.

## criar packs numa grade

1. **abra a aba packs da grade**

   em **configurações**, no bloco produtos, abra [**grades**](https://app.teceo.co/settings/grids), clique sobre a grade e abra a aba **packs**.

2. **nomeie o pack**

   na linha adicionar packs, acima da tabela, insira o nome. o nome é único dentro da grade, e não existe campo de código.

3. **preencha a quantidade de cada tamanho**

   ainda na linha de criação, insira quantas peças o pack tem em cada tamanho. o pack cobre todos os tamanhos da grade, e o tamanho deixado em branco entra como zero.

4. **crie o pack**

   clique em **+**. o botão fica indisponível enquanto o nome estiver vazio, e pressionar Enter equivale a clicar nele.

   o pack entra na tabela, a linha de criação se limpa e o foco volta para o campo de nome. a plataforma confirma com ação realizada com sucesso!

5. **ajuste ou exclua um pack**

   clique no nome ou numa quantidade da tabela e edite. para excluir, clique em **excluir** na linha do pack.

a aba packs não tem botão salvar: o nome é gravado ao sair do campo, e a quantidade, automaticamente.

alterar as quantidades de um pack não altera os pedidos que já o aplicaram. pack com vínculo válido a um produto-cor não pode ser excluído: tire o pack dos produtos antes.

## escolher os packs de cada produto

<Info>
  as abas packs e estoque de packs do produto ficam indisponíveis enquanto o produto não tem sku cadastrado.
</Info>

1. **abra a aba packs do produto**

   no cadastro do produto, abra a aba **packs**. cada linha é um produto-cor, com duas colunas: packs de pré-venda e packs de pronta-entrega.

2. **escolha os packs de cada disponibilidade**

   na linha do produto-cor, clique na coluna da disponibilidade e selecione os packs. a escolha é gravada imediatamente, sem botão salvar. para tirar um pack do produto-cor, remova-o da coluna.

o mesmo produto-cor pode ter packs diferentes na pré-venda e na pronta-entrega.

a lista traz só os packs cuja grade é válida para aquele produto-cor, e a grade só é válida quando os tamanhos dela são exatamente os tamanhos ativos dos skus daquele produto-cor.

quando o pack vem do seu sistema de gestão, o vínculo que não foi enviado na sincronização é removido.

para ligar muitos produtos ao mesmo tempo, use [associar packs por planilha](/docs/grades/associar-packs-por-planilha).

## definir como o cliente aplica o pack

quanto o cliente pode alterar a grade do item é definido por produto-cor e por disponibilidade. os dois controles começam no estado mais permissivo: grade fechada desligada e aplicação parcial permitida.

1. **defina se o cliente pode alterar a grade**

   no cadastro do produto, abra a aba **definições por cor**, descrita em [configurar cada cor do produto](/docs/produtos/configurar-cada-cor-do-produto). cada produto-cor tem grade fechada para pré-venda e grade fechada para pronta-entrega.

   * para o cliente aplicar o pack e ainda ajustar tamanho a tamanho, mantenha grade fechada desligada.
   * para a quantidade ficar exatamente como foi definida no pack, ligue grade fechada daquela disponibilidade. a grade daquela cor não aceita alteração no pedido nem no catálogo.

2. **defina se o pack pode entrar pela metade**

   na aba **packs**, abaixo da coluna da disponibilidade, marque ou desmarque **bloquear aplicação parcial**. a opção fica disponível depois que há pelo menos um pack escolhido naquela coluna.

   * para o pack entrar mesmo sem estoque para todas as peças, deixe a opção desmarcada. cada tamanho entra com o que o estoque cobrir, até a quantidade do pack.
   * para o pack só entrar quando houver estoque para todas as peças dele, marque a opção.

a grade do item também não aceita alteração quando o item já tem pack aplicado.

## controlar o estoque dos packs

o estoque do pack é contado em packs e é separado do estoque por tamanho do sku. controlá-lo é opcional, e a decisão vale por vínculo: cada pack, em cada produto-cor, em cada disponibilidade.

o controle só é aceito com **grade fechada** ligada e **bloquear aplicação parcial** marcado naquela disponibilidade. com um dos dois no estado permissivo, a plataforma recusa e responde 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".

1. **abra a aba estoque de packs**

   no cadastro do produto, abra a aba **estoque de packs**. cada linha é um pack vinculado a um produto-cor numa disponibilidade.

2. **ligue o controle de estoque do pack**

   na linha do pack, ligue **controle de estoque**. a mudança é gravada imediatamente.

3. **informe o estoque total**

   na coluna estoque total, insira quantos packs existem. estoque reservado e estoque disponível são calculados.

enquanto houver vínculo de pack com controle de estoque ativo, nenhum dos dois controles pode ser desligado, e a plataforma responde não é possível alterar pois há um ou mais vínculos de pack com controle de estoque ativo.

<Note>
  o mesmo pack vinculado a mais de um produto compartilha o estoque: reduzir o estoque total em um produto afeta os demais produtos que usam aquele pack.
</Note>

reduzir o estoque total desfaz, nos pedidos que já reservavam aquele pack, a reserva que passar do novo total.

## o que acontece ao ligar ou desligar o controle depois

cada pedido guarda o controle de estoque que valia quando o pack foi aplicado nele. ao ligar ou desligar o controle de um vínculo, os pedidos abertos que já aplicaram aquele pack não podem ser finalizados, e exibem controle de estoque do pack alterado, refaça os packs para reservar o estoque.

para liberar o pedido, os packs precisam ser aplicados de novo no item, em [aplicar packs no pedido](#aplicar-packs-no-pedido).

o pedido já enviado ao seu sistema de gestão, e cujo estoque ainda não foi baixado, continua liberado e mantém a reserva.

## aplicar packs no pedido

1. **abra a seleção de packs**

   no item do pedido, abra o menu da grade e clique em **selecionar packs**. em pedido finalizado o item exibe **ver packs**, que só mostra o que foi aplicado.

2. **escolha os packs**

   a janela lista um pack por linha, com o nome e as quantidades por tamanho. use pesquisar packs para achar pelo nome.

3. **defina as repetições**

   à direita de cada pack, no campo x, insira quantas vezes o pack se repete. digitar zero remove o pack do item.

quando aquele vínculo controla estoque, o estoque disponível do pack aparece ao lado das repetições enquanto o pedido não está finalizado. sem controle de estoque, o campo aceita até 999 repetições.

as mensagens de pack que aparecem no pedido:

| mensagem | o que aconteceu |
| - | - |
| atualmente este pack para este produto-cor não é válido | o pack aplicado deixou de estar entre os packs daquele produto-cor e disponibilidade |
| estoque do pack insuficiente | o estoque disponível do pack não cobre as repetições pedidas |
| pack sem reserva de estoque, refaça os packs para finalizar o pedido | o item ficou sem reserva, e a finalização depende de aplicar os packs de novo |
| controle de estoque do pack alterado, refaça os packs para reservar o estoque | o controle de estoque mudou depois que o pack foi aplicado no item |

## campos do pack e do estoque de packs

o pack:

| campo | obrigatório | comportamento |
| - | - | - |
| nome | sim | único dentro da grade. não existe campo de código |
| quantidade por tamanho | uma por tamanho da grade | número inteiro, a partir de zero. em branco entra como zero |

a aba estoque de packs, uma linha por pack vinculado:

| coluna | o que traz |
| - | - |
| produto-cor | a imagem e o nome da cor |
| disponibilidade | pré-venda ou pronta-entrega do vínculo |
| pack | o nome do pack vinculado |
| controle de estoque | liga e desliga o estoque próprio daquele vínculo. editável |
| estoque total | quantos packs existem. editável |
| estoque reservado | quantos packs os pedidos já reservaram. calculado |
| estoque disponível | o total menos o reservado, e nunca negativo. calculado |


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