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

# adicionar itens ao pedido

o item entra no pedido por quatro caminhos. o que muda entre eles é quanto contexto do produto fica à vista na hora de decidir a quantidade.

## o pedido ativo decide o destino

o catálogo e a página do produto entregam o item ao **pedido ativo**, que é o pedido escolhido no talão e aparece no botão do topo da tela.

sem pedido ativo, o catálogo pede que um seja escolhido antes de adicionar. trocar o pedido ativo troca o destino do que for adicionado a partir dali.

o pedido também precisa aceitar edição. numa sugestão aberta em modo de leitura, o topo traz **editar** no lugar da ação de adicionar.

## pelo código, dentro do pedido

o caminho mais rápido para quem já sabe o código, e o único que funciona com leitor de código de barras.

1. **escolha o modo**

   na aba de produtos, clique no seletor ao lado de **adicionar**, e selecione o modo de adição que melhor funcionar para a criação do seu pedido.

   * **produto:** identifica apenas o produto, e exige a escolha da cor para adicionar ao pedido.
   * **produto-cor:** adiciona o produto com uma cor, e a entrega se mantém em branco sempre que houver mais de uma para escolher.
   * **sku:** identifica o sku, e cada leitura do código acrescenta uma peça no tamanho correto, facilitando a montagem da grade.

   o modo escolhido fica salvo como preferência do usuário para facilitar o dia a dia.

   *observação:* cor sempre será obrigatória em qualquer um dos modos, porque não existe item de pedido sem cor. então, caso não seja possível identificar a cor através do código, a teceo seleciona a primeira disponível — com exceção do modo produto, em que a escolha é sempre sua.

2. **informe o código do produto**

   no campo **código do produto**, digite o código ou use o leitor pelo ícone de câmera.

   pode-se preenchê-lo utilizando:

   * código do produto ou kit,
   * referência do produto,
   * código do produto + da cor,
   * código do sku completo,
   * código de barras.

   o código do produto, a referência e o código do produto + da cor são encontrados com ou sem espaços, independentemente de como estão no cadastro.

   a forma como será adicionado no pedido depende do modo selecionado e de qual código foi utilizado, como descrito mais detalhadamente na seção [formas de adicionar](#formas-de-adicionar).

3. **complete o item do pedido**

   o campo **cor** exibe todas as cores disponíveis do produto identificado pelo código; já o campo **entrega**, reúne a disponibilidade (pronta-entrega e as variações da pré-venda) e suas janelas compatíveis.

   caso qualquer um destes campos tenha somente uma opção possível, esta será automaticamente preenchida para facilitar a montagem da grade. no modo produto isso vale só para a cor: a entrega continua em branco, mesmo quando há uma única.

   no modo produto, selecionar uma cor é obrigatório e o restante dos campos são opcionais para poder adicionar ao pedido.

   já no modo produto-cor, a cor é identificada pelo código, restando somente informar a entrega e a grade, que não são obrigatórios. ao usar o enter, o item entra no pedido na hora e a grade passa a ser preenchida no próprio item da lista.

   por fim, no modo sku, o preenchimento dos campos vem completo do código lido e a quantidade é somada direto. ou seja, ler dez vezes o mesmo código resulta em dez peças no mesmo item, sem esforço manual de fazer grade. quando o produto tem mais de uma disponibilidade, a primeira leitura usa a primeira disponível, e as leituras seguintes do mesmo sku adicionam sempre para a mesma.

4. **confirme**

   para finalizar, clique no **botão +** ou simplesmente use o **enter** como atalho, e assim, o produto é adicionado no pedido.

### formas de adicionar

para atender as diferentes situações na hora de criar o pedido, incluímos dois atalhos:

nos modos produto-cor e sku, pressionar **enter** após preencher o campo código tenta sempre adicionar no pedido, desde que tenha o mínimo das informações necessárias. este atalho é útil para aqueles que desejam incluir o produto no pedido rapidamente, sem se preocupar em completar a grade.

no modo produto o enter não adiciona: ele traz o produto e espera a cor, que é justamente o que define o modo.

já pressionar **tab**, avança o foco para o próximo campo a ser preenchido, o que ajuda aqueles que não recordam do código da cor, querem já definir uma entrega ou fazer grade.

cada tipo de código tem um nível de informação:

* código do produto: traz só o produto, sem cor nem entrega.
* referência do produto: traz só o produto, sem cor nem entrega.
* código do produto + da cor: traz o produto e a cor.
* código do sku ou código de barras: traz o produto, a cor e também o tamanho.

portanto, não adianta selecionar um modo específico sem informar um código no nível que ele pede.

> exemplo: escolher o modo sku e digitar só o código do produto faz com que o item seja adicionado com a primeira cor disponível e sem o tamanho.

### o que cada modo faz no enter

| código informado | produto | produto-cor | sku |
| - | - | - | - |
| código do produto ou referência | leva o foco para escolher uma cor | adiciona no pedido com a primeira cor disponível e grade vazia | adiciona no pedido com a primeira cor disponível e grade vazia |
| código do produto + cor | mesmo que tenha a cor, o campo fica vazio | adiciona no pedido aquele produto-cor, com grade vazia | adiciona no pedido aquele produto-cor, com grade vazia |
| código do sku | mesmo com todas as informações, os campos vêm vazios | adiciona no pedido aquele produto-cor, com grade vazia | adiciona uma peça no sku informado |
| código de barras | mesmo com todas as informações, os campos vêm vazios | adiciona no pedido aquele produto-cor, com grade vazia | adiciona uma peça no sku informado |
| código de kit | libera o **botão +** para adicionar | adiciona os itens do kit direto no pedido | adiciona os itens do kit direto no pedido |

<Note>
  nos modos produto-cor e sku, o código é recusado quando o pedido já tem um item de qualquer cor daquele produto. para incluir outra cor ou outra entrega, use o modo produto, que deixa a escolha com você, ou a página de detalhes do produto.
</Note>

só é permitido adicionar o kit uma vez só, e este será recusado se algum item dele já foi adicionado avulso.

## pelo catálogo em lista

o caminho de quem compra rápido, com a grade aberta ao lado do produto e sem entrar no detalhe de cada um.

1. **abra o catálogo na visualização em lista**

   as duas visualizações e como alternar entre elas estão em [navegar pelo catálogo](/docs/catalogo/navegar-pelo-catalogo-v3).

2. **escolha a entrega**

   na linha do produto, selecione entre as disponibilidades e janelas oferecidas. **mais** abre as que não couberam na linha.

   a grade muda conforme a escolha: o mesmo produto-cor pode ter tamanhos diferentes em cada janela.

3. **preencha a grade e confirme**

   preencha a quantidade por tamanho e confirme na própria linha. o item entra no pedido ativo sem sair do catálogo.

## pelo catálogo em card

o caminho de quem está escolhendo o que comprar e precisa ver a coleção antes de decidir a quantidade.

1. **abra o catálogo na visualização em card**

   as duas visualizações e como alternar entre elas estão em [navegar pelo catálogo](/docs/catalogo/navegar-pelo-catalogo-v3).

2. **marque o produto no pedido**

   no card, clique no **+**, ao lado do nome do produto. o produto-cor entra no pedido ativo sem grade preenchida, e o **+** vira um sinal de confirmação, que indica que ele já está no pedido. clicar de novo tira o produto do pedido.

   é o caminho de quem está montando a seleção antes de decidir quantidade: o produto fica reservado na lista do pedido para receber a grade depois.

3. **abra o produto para preencher a grade**

   clique no card, ou na cor que interessa, para abrir os detalhes do produto. a grade abre com as cores, as disponibilidades e as janelas de entrega daquele produto.

4. **preencha a quantidade e confirme**

   preencha a grade por tamanho e confirme. o item passa a compor a divisão correspondente à disponibilidade, à janela e à classificação dele.

## pela página do produto

o caminho de quem precisa da grade inteira à vista, com todas as cores, disponibilidades e janelas: dali é possível preencher a grade para vários pedidos do talão ao mesmo tempo.

## o menu grade do item

cada item traz um menu **grade**, ao lado da grade de tamanhos, com quatro recursos que evitam preenchimento manual.

**aplicar sugestão** preenche a grade com a quantidade sugerida para aquele produto, e informa quantas peças a sugestão traz. depois de aplicada, a opção fica indisponível e indica que a sugestão já foi usada.

**consultar sell-out** abre os dados de venda daquele produto na ponta da loja, para dimensionar a compra pelo que já vendeu.

**selecionar packs** monta a grade pelos packs cadastrados, em vez de tamanho a tamanho. em pedido finalizado a opção passa a só exibir os packs.

**copiar grade** e **colar** repetem uma grade preenchida em outro item, e **colar em todas** aplica de uma só ação a todos os itens compatíveis. quando os tamanhos não correspondem, o item indica grade incompatível e não recebe a cópia.

## o cadeado da grade

o máximo aceito pela grade depende da quantidade configurada pela marca em **valor de bloqueio na grade**, nas definições gerais, e vale enquanto o cadeado está fechado.

abrir o cadeado, no topo da aba de produtos, libera o preenchimento acima desse limite. o limite existe para evitar que um dígito a mais em digitação rápida vire uma quantidade que ninguém pretendeu.

## por planilha

a montagem fora da plataforma, para vários pedidos ao mesmo tempo, está em [criar pedidos por planilha](/docs/pedidos/criar-pedidos-por-planilha-v2).

## conteúdos relacionados

<div className="relacionados">
  <CardGroup cols={1}>
    <Card title="a visão completa dos pedidos" icon="file-lines" href="/docs/pedidos/a-visao-completa-dos-pedidos-v2" horizontal />

    <Card title="as divisões e as condições do pedido" icon="file-lines" href="/docs/pedidos/as-divisoes-e-as-condicoes-do-pedido-v2" horizontal />
  </CardGroup>
</div>


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