> For the complete documentation index, see [llms.txt](https://ajuda.pdvlegal.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.pdvlegal.com.br/oem/materiais-oem/importacao-de-produtos-em-massa-via-planilha.md).

# Importação de produtos em massa via planilha

Processo para importar produtos em massa no sistema via planilha Excel/CSV, ideal para cadastrar ou atualizar grandes volumes de produtos.

{% hint style="danger" %}
Conteúdo exclusivo para canais autorizados.
{% endhint %}

Use este processo para preparar a planilha e importar produtos em massa no OEM.

### Preparar a planilha

{% stepper %}
{% step %}

### Divida a planilha em lotes

* **Máximo de 3.000 produtos por planilha** (evite erros de processamento).
* Exemplo: 10.000 produtos = 4 planilhas (3 com 3.000 itens e 1 com 1.000).
  {% endstep %}

{% step %}

### Limpe os dados

* **Remova células vazias:** Copie os dados para uma nova planilha para evitar "sujeiras" de formatação.
* **Verifique códigos duplicados ou inválidos:**
  * **Colunas críticas:** A (Código Interno), C (Código do Grupo), F (Código de Venda), N (EAN/GTIN).
    {% endstep %}
    {% endstepper %}

| Coluna: |              Descrição:              |                                                                         Regras:                                                                        |
| :-----: | :----------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------: |
|  **A**  |      Código interno do sistema.      | <ul><li><strong>Novos produtos:</strong> Preencha com <strong>0</strong>.</li><li><strong>Atualizações:</strong> Mantenha o código original.</li></ul> |
|  **C**  |     Código do grupo de produtos.     |         <ul><li><strong>Novos grupos:</strong> Preencha com <strong>0</strong> e insira o nome do grupo na coluna <strong>D</strong>.</li></ul>        |
|  **F**  | Código de venda (único por produto). |                            <ul><li><strong>Não pode ser duplicado</strong> (ex.: sequência numérica: 1, 2, 3...).</li></ul>                            |
|  **N**  |  Código EAN/GTIN (validação fiscal). |        <ul><li><strong>Obrigatório</strong> para emissão fiscal.</li><li><strong>Valide</strong> no site da GS1 ou ferramentas online.</li></ul>       |

### Importar classes de produtos

Use a última coluna da planilha, **Classes**, para vincular classes aos produtos.

Informe os nomes das classes separados por barra vertical (`|`). Por exemplo:

```
Bebidas Geladas|Promoção|Zero Açúcar
```

O OEM vincula ao produto todas as classes informadas.

Se a coluna **Classes** não existir ou estiver vazia, o OEM não altera os vínculos atuais.

Para remover todos os vínculos de classe do produto, preencha a célula exatamente assim:

```
[NENHUMA]
```

### Importar no OEM

{% stepper %}
{% step %}

### Acesse o OEM

* Navegue até a seção de **Importação de Produtos**.
  {% endstep %}

{% step %}

### Selecione a planilha

* Faça upload do arquivo (formato CSV ou Excel).
  {% endstep %}

{% step %}

### Valide os dados

* Confira erros destacados pelo sistema (ex.: códigos duplicados, EAN inválido).
  {% endstep %}

{% step %}

### Execute a importação

* Aguarde a conclusão e verifique o relatório de erros (se houver).

<figure><img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2F04t5maRiD5QOY92AzoPV%2FComo%20importar%20produtos%20em%20massa%20via%20planilha.gif?alt=media&amp;token=9f1136d2-c08d-4a6e-9290-3462f8266ad2" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://ajuda.pdvlegal.com.br/oem/materiais-oem/importacao-de-produtos-em-massa-via-planilha.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.