Guia de importação para uploads CSV do PPWR

Last updated: September 7, 2026

Use importações em massa via CSV para inserir rapidamente seus fornecedores, produtos e itens de embalagem na plataforma. Este guia apresenta cada arquivo, a estrutura de colunas obrigatória e os erros mais comuns a evitar.


Antes de começar

Baixe os modelos diretamente da plataforma: acesse a página de Produtos ou Fornecedores, clique em Importar no canto superior direito e clique em Baixar.


Abrindo o modelo CSV no Excel

O modelo é um .csv arquivo. Abrir clicando duas vezes costuma corromper o layout das colunas. Use o método de importação correto em vez disso:

  1. Abra o Microsoft Excel.

  2. Vá para a Dados aba.

  3. Clique Obter Dados → De Texto/CSV.

  4. Selecione o modelo baixado e carregue os dados.

  5. Depois de preencher os dados, certifique‑se de salvar como csv-utf.

Suas colunas agora serão exibidas corretamente.


Arquivo 1: Fornecedores

Nome da coluna

Tipo de dado

Descrição

Obrigatório

external_id

texto

ID único do seu ERP ou CRM

FALSO

company_name

texto

Nome legal do fornecedor

VERDADEIRO

descrição

texto

Observações opcionais sobre o fornecedor

FALSO

country_code

texto (2 caracteres)

Código ISO 3166-1 alfa-2 (ex.: NL, DE)

VERDADEIRO

is_self_managed

VERDADEIRO ou FALSO

Defina como VERDADEIRO se você está auto-declarando em nome deste fornecedor

FALSO

contact_name

texto

Pessoa de contato principal, deixe em branco se auto-gerenciar

FALSO

contact_email

texto

Email de contato usado para convites, deixe em branco se auto-gerenciar

FALSO

type

texto

O tipo de parceiro da cadeia de valor. Sempre preencha "supplier"

VERDADEIRO

Importante: contact_email é usado para enviar ao fornecedor o convite da plataforma. Um email incorreto impede que o fornecedor o receba.


Arquivo 2: Produtos e itens de embalagem

Tanto os produtos quanto os itens de embalagem são inseridos no mesmo arquivo CSV. A plataforma os separa automaticamente com base na estrutura das linhas.

Como a plataforma distingue produtos de itens de embalagem:

  • Uma linha é tratada como um item de embalagem se o SKU estiver referenciado na coluna packaging_items de outra linha.

Ordem de colunas requerida dentro do arquivo:

Coloque os itens de embalagem nas primeiras linhas, e os produtos nas últimas linhas. O importador lê linha por linha. Quando chega a uma linha de produto, os itens de embalagem referenciados por ela já precisam ter sido processados.

Nome da coluna

Tipo de dado

Descrição

Obrigatório

external_id

texto

ID exclusivo do seu ERP ou CRM

FALSE

sku

texto

Sua unidade interna de manutenção de estoque

TRUE

name

texto

Nome do produto ou item de embalagem

TRUE

description

texto

Descrição opcional

FALSE

type

texto

Use sempre purchased para itens PPWR, mesmo para produtos acabados fabricados internamente

TRUE

packaging_items

texto

SKUs de itens de embalagem separados por vírgulas e anexados a este produto — é isso que vincula as embalagens aos produtos

FALSE

Estrutura de exemplo:

sku,        name,                  type,       packaging_items
PKG-001,    Cardboard box 200g,    purchased,
PKG-002,    Plastic lid,           purchased,
PRD-001,    Oat biscuits,          purchased,  PKG-001, PKG-002

Neste exemplo, PKG-001 e PKG-002 são itens de embalagem (eles são referenciados na coluna PRD-001de packaging_items ). PRD-001 é o produto.


Enviando seu CSV

Quando seu arquivo estiver pronto:

  1. Vá para a seção relevante na plataforma (Fornecedores ou Produtos).

  2. Clique Importar no canto superior direito.

  3. Arraste e solte seu arquivo na área de upload, ou clique para navegar.

  4. Clique Importar para iniciar o upload.


Erros comuns

  1. Os nomes das colunas não correspondem exatamente O importador é rigoroso. Os nomes das colunas devem ser idênticos aos do modelo — incluindo sublinhados, uso de maiúsculas e minúsculas e espaços. Não renomeie as colunas.

  2. Itens de embalagem listados depois dos produtos Se uma linha de produto fizer referência a um SKU de item de embalagem que ainda não foi processado, o vínculo falhará. Sempre coloque os itens de embalagem primeiro.

  3. Espaços depois das vírgulas em packaging_items Ao listar vários SKUs de embalagem na coluna packaging_items , inclua um espaço depois de cada vírgula (por exemplo, PKG-001, PKG-002). A ausência de espaços pode causar erros de vinculação.

  4. Valor type incorreto para PPWR Use purchased como o tipo para todos os itens PPWR — incluindo produtos acabados que você mesmo fabrica. O PPWR se concentra na embalagem, não no produto.


E se eu ainda não tiver meu inventário de embalagens?

Você não precisa ter um inventário completo de embalagens para começar. É possível importar apenas os produtos (SKUs), sem anexar itens de embalagem. Depois que seus fornecedores estiverem na plataforma, envie-lhes uma solicitação no nível do produto; eles adicionarão os itens de embalagem relevantes e a documentação diretamente do espaço de trabalho deles.


Perguntas frequentes

  1. Como a plataforma sabe se uma linha é um produto ou um item de embalagem? Ela verifica a coluna packaging_items . Se outra linha listar seu SKU nessa coluna, sua linha se tornará um item de embalagem. Se nenhuma linha fizer referência a ele e packaging_items estiver em branco, ele se tornará um produto.

  2. Posso mover um item da aba de produtos para a aba de itens de embalagem após o upload? Não dentro da aba PPWR. Depois que um item é definido como produto, ele permanece como produto. Alternativa: itens enviados ao catálogo geral de produtos (fora do PPWR) podem ser selecionados em massa e movidos para a seção de itens de embalagem a partir dali.

  3. O que fazer se meu upload falhar sem apresentar um erro claro? Verifique se todos os nomes das colunas correspondem exatamente ao modelo, se os itens de embalagem estão listados acima dos produtos e se as referências de SKU em packaging_items estão formatadas corretamente após as vírgulas. Entre em contato com o suporte pelo chat do aplicativo se o problema persistir.

  4. Preciso ter um inventário completo de embalagens antes de começar? Não. Você pode começar importando sua lista de produtos (SKUs) e enviando solicitações aos fornecedores no nível do produto. Em seguida, os fornecedores adicionam as camadas de embalagem por conta própria.