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

# criar pedidos por planilha

a importação por planilha cria e atualiza vários pedidos ao mesmo tempo, a partir de um arquivo em que cada linha é um item de pedido.

## importar

1. **decida entre criar e atualizar**

   as duas colunas de código abrem o caminho, e uma das duas é sempre obrigatória.

   * para criar pedidos novos, preencha a coluna de código de referência com um código de sua escolha e deixe a de código do pedido vazia. os itens que compartilham o mesmo código de referência são reunidos num único pedido, e a teceo gera o código definitivo dele.
   * para atualizar pedidos que já existem, preencha a coluna de código do pedido com o código da teceo. o código de referência pode ficar vazio.

2. **baixe o modelo**

   em [**importações de arquivo**](https://app.teceo.co/imports), abra **modelos de importação** e baixe o modelo de pedidos.

   o arquivo tem duas abas: orientações, que descreve cada coluna e a obrigatoriedade dela, e dados, que é onde o preenchimento acontece.

3. **preencha uma linha por item**

   cada linha corresponde a um item, com produto, cor, tamanho e disponibilidade. um pedido com dez itens ocupa dez linhas, todas com o mesmo código.

   o mesmo produto e a mesma cor em disponibilidades diferentes ocupam linhas separadas.

   as colunas de produto, cor, tamanho, cliente, representante, consultor, janela, forma de pagamento e coleção recebem códigos de registros que já existem na teceo. cadastre antes de importar: a planilha não cria nenhum deles.

4. **envie o arquivo**

   clique em **importar arquivo** e selecione a planilha preenchida. o processamento roda em segundo plano, e a listagem de importações continua disponível.

5. **confira o resultado**

   a importação termina em um de três estados: importado com sucesso, importado com erros ou falha.

   abra a importação para ver as inconsistências. cada uma aponta a coluna, a linha e a quantidade de erros, e o resumo mostra quantas linhas de quantas entraram.

   em importado com erros, as linhas válidas entram e apenas as inconsistentes ficam de fora. corrija as linhas apontadas e reenvie só elas.

## as colunas da planilha

| coluna | o que recebe | obrigatória |
| - | - | - |
| código do pedido | código do pedido na teceo, para atualizar um pedido existente | quando o código de referência não é informado |
| código de referência | código de sua escolha, repetido nas linhas que formam o mesmo pedido | quando o código do pedido não é informado |
| pedido sugerido | define se o pedido é criado como sugestão. vale só para pedido novo, e em branco equivale a não | não |
| código do cliente | código da loja. em branco, o pedido é criado sem cliente | não |
| código do representante | código do representante | não |
| código do consultor | código do consultor | não |
| código do produto | código do produto | sim |
| código da cor | código da cor | sim |
| tamanho | código do tamanho | sim |
| disponibilidade | uma das opções da lista da própria planilha | sim |
| código da janela de entrega | código da janela | quando a disponibilidade é pré-venda ou estoque-futuro. em pronta-entrega, não preencha |
| quantidade de peças | quantidade do item | não |
| código da forma de pagamento | código da forma de pagamento | não |
| código da coleção do pedido | código da coleção | não |

## as colunas que não pertencem ao item

as colunas de forma de pagamento e de coleção ficam na mesma linha do item, mas não descrevem o item. as duas se comportam de forma diferente das demais, e é onde a importação costuma surpreender.

a forma de pagamento vale por divisão, e só na criação: ela é considerada quando uma divisão nova é criada. em divisão que já existe, o valor da planilha é ignorado, mesmo que as linhas tragam formas diferentes. deixar a coluna em branco não limpa nada: a divisão existente continua como está, e a divisão nova é criada sem forma de pagamento, a menos que exista uma única forma elegível, que a teceo preenche sozinha.

a coleção vale para o pedido inteiro, e preencher uma única linha define a coleção do pedido todo. se as linhas trouxerem coleções diferentes, vale a última. deixar em branco também não limpa: a coleção atual do pedido é mantida.

<Note>
  as duas colunas ignoram valores em conflito em vez de recusar a linha. uma planilha com formas de pagamento diferentes nas linhas de uma mesma divisão importa sem erro, e o resultado é a forma que entrou primeiro.
</Note>

## conteúdos relacionados

<div className="relacionados">
  <CardGroup cols={1}>
    <Card title="criar pedidos" icon="file-lines" href="/docs/pedidos/criar-pedidos-v2" horizontal />

    <Card title="listagem de pedidos" icon="file-lines" href="/docs/pedidos/listagem-de-pedidos-v2" horizontal />
  </CardGroup>
</div>


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