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:
Abra o Microsoft Excel.
Vá para a Dados aba.
Clique Obter Dados → De Texto/CSV.
Selecione o modelo baixado e carregue os dados.
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_itemsde 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 | 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:
Vá para a seção relevante na plataforma (Fornecedores ou Produtos).
Clique Importar no canto superior direito.
Arraste e solte seu arquivo na área de upload, ou clique para navegar.
Clique Importar para iniciar o upload.
Erros comuns
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.
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.
Espaços depois das vírgulas em
packaging_itemsAo listar vários SKUs de embalagem na colunapackaging_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.Valor
typeincorreto para PPWR Usepurchasedcomo 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
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 epackaging_itemsestiver em branco, ele se tornará um produto.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.
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_itemsestão formatadas corretamente após as vírgulas. Entre em contato com o suporte pelo chat do aplicativo se o problema persistir.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.