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

# importar e exportar metas

a coluna código da meta decide o comportamento de cada linha da planilha: em branco cria uma meta nova, preenchida atualiza a meta daquele código.

## importar metas

1. **baixe o modelo**

   na listagem de metas, clique em **exportar modelo de importação**. o modelo vem com dados de exemplo e com as colunas de classificação de produto e de cliente da sua marca.

2. **preencha a planilha**

   preencha uma linha por meta, com o código do representante, uma das três formas de período, a disponibilidade e o valor.

3. **envie o arquivo**

   na listagem de metas, clique em **importar metas** e escolha a planilha. a importação aceita só arquivo .xlsx.

4. **acompanhe o resultado**

   em [**importações de arquivo**](https://app.teceo.co/settings/imports), o modelo aparece com o nome metas de representantes.

## o que a planilha apaga

<Warning>
  numa linha de atualização, deixar em branco a coluna de janelas de entrega, de classificações de clientes ou de classificações de produtos remove os vínculos da meta. as três colunas têm esse efeito.
</Warning>

vínculo em branco apaga, texto em branco não: deixar o nome da meta em branco não apaga o nome.

deixar as colunas de coleção em branco limpa as coleções e muda o tipo da meta para data, porque o tipo vem das colunas preenchidas.

**exemplo, uma linha que atualiza a meta 120 com quatro células em branco**

* código da meta: 120
* nome da meta: em branco, e o nome atual é mantido
* códigos das coleções do produto: em branco, as coleções são removidas e a meta passa a ser do tipo data
* código das janelas de entrega: em branco, as janelas são removidas
* classificações de clientes: em branco, as classificações são removidas

## as colunas da planilha

| coluna | o que preencher |
| - | - |
| código da meta | em branco cria uma meta nova, preenchida atualiza a meta daquele código |
| nome da meta | o nome que identifica a meta. opcional |
| código do representante | o código de um representante já cadastrado. obrigatório |
| códigos das coleções do pedido | uma das três formas de definir o período. várias separadas por vírgula |
| códigos das coleções do produto | uma das três formas de definir o período. várias separadas por vírgula |
| data inicial | uma das três formas de definir o período, no formato DD/MM/AAAA |
| data final | obrigatória com data inicial preenchida, no formato DD/MM/AAAA. pode ser igual à data inicial |
| pré-venda | sim ou não. em branco vale não |
| pronta-entrega | sim ou não. em branco vale não |
| código das janelas de entrega | só com pré-venda em sim. várias separadas por vírgula |
| classificações de produtos | o código do tipo e o código da classificação separados por dois-pontos. várias separadas por vírgula |
| classificações de clientes | o código do tipo e o código da classificação separados por dois-pontos. várias separadas por vírgula |
| valor da meta | o valor na moeda da marca, sem sinal negativo e com até duas casas decimais. obrigatório |
| ativa | sim ou não. em branco vale não |

o tipo de período não é uma coluna: ele vem das colunas que você preenche, nesta ordem. com códigos das coleções do pedido preenchidos, a meta é de coleção do pedido; senão, com códigos das coleções do produto preenchidos, é de coleção do produto; senão, é de data.

## por que uma linha é recusada

| causa | a mensagem |
| - | - |
| nenhuma das três formas de período foi preenchida | nenhum tipo de período foi informado: preencha um entre coleções do pedido, coleções do produto ou período em data. |
| mais de uma forma de período foi preenchida | a linha contém mais de um tipo de período: preencha apenas um entre coleções do pedido, coleções do produto ou período em data. |
| a data final é anterior à data inicial | a "data final" preenchida é anterior à "data inicial". |
| a data final foi preenchida sem a data inicial | a "data final" foi informada, mas a "data inicial" não foi preenchida. |
| a data inicial foi preenchida sem a data final | a "data inicial" foi informada, mas a "data final" não foi preenchida. |
| a data está em outro formato | o valor preenchido está em um formato inválido: use DD/MM/AAAA. |
| pré-venda e pronta-entrega estão as duas em não | "pré-venda" e "pronta-entrega" estão com "não": preencha ao menos um com "sim". |
| a janela de entrega está preenchida com pré-venda em não | "pré-venda" está como "não", mas a "janela de entrega" está preenchida. |
| uma coluna de sim ou não tem outro valor | o valor informado é inválido: preencha com "sim", "não" ou deixe em branco. |
| a classificação está em outro formato | o valor preenchido está em um formato inválido: use o padrão \[código do tipo da classificação]:\[código da classificação]. |
| o valor da meta está negativo | o valor preenchido está negativo: remova o sinal. |
| o valor da meta tem mais de duas casas decimais | o valor preenchido possui mais de duas casas decimais. |
| o valor da meta está em outra moeda | o valor foi preenchido com um símbolo de moeda diferente do utilizado pela marca. |
| o código da meta, do representante, da coleção, da janela, do tipo de classificação ou da classificação não existe na marca | o valor preenchido não corresponde a nenhum registro cadastrado na teceo. |
| a planilha tem uma coluna fora do modelo | coluna não reconhecida no modelo de importação |

uma coluna fora do modelo recusa a linha inteira, e não só aquela célula. na planilha de metas isso é diferente das outras planilhas da plataforma, que ignoram coluna a mais.

uma linha recusada não afeta as outras: o lote continua, e as demais metas são criadas e atualizadas.

## exportar metas

a exportação é uma das ações em massa da [listagem de metas](/docs/metas/listagem-de-metas#as-ações-em-massa), e o arquivo leva a data no nome.

o arquivo sai no formato do modelo, com as mesmas 14 colunas, e pode ser reimportado: coleções, janelas de entrega e classificações de produto e de cliente saem como código.

## conteúdos relacionados

<div className="relacionados">
  <CardGroup cols={1}>
    <Card title="listagem de metas" icon="file-lines" href="/docs/metas/listagem-de-metas" horizontal />

    <Card title="referência de campos da meta" icon="file-lines" href="/docs/metas/referencia-de-campos-da-meta" horizontal />
  </CardGroup>
</div>


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