Solavel Documentos
Português

Listas de preços de fornecedores

Última atualização

Uma lista de preços de fornecedor é um arquivo CSV de condições do item por fornecedor: uma linha por faixa de preço, com o código do fornecedor, moeda, unidade de compra, pedido mínimo, múltiplo de pedido, prazo de entrega, desconto e o preço e as datas da faixa. Exporte-a para revisar ou compartilhar preços em uma planilha, e importe-a para atualizar muitos itens e fornecedores de uma só vez. O significado de cada coluna está explicado em Condições do item por fornecedor.

Uma importação nunca exclui nada: as faixas que não estão no arquivo são mantidas. Ela é verificada primeiro (Pré-visualização) e só é salva quando você clica em Aplicar importação, e somente se todas as linhas forem válidas.

#Onde encontrar

Botão Onde Exporta ou importa
Exportar CSV Página do item → seção Fornecedores As condições desse item, para todos os fornecedores.
Exportar CSV Página do fornecedor → seção Itens fornecidos As condições desse fornecedor, para todos os itens.
Importar lista de preços As mesmas duas seções Quaisquer itens e fornecedores do arquivo; a página de onde você começa não limita a importação.
  • Exportar CSV exige Condições do item por fornecedor: Visualizar. Importar lista de preços exige Condições do item por fornecedor: Gerenciar, e na página do item só é exibido enquanto as condições do item são editáveis no SolaCount.
  • Ambos fazem parte do recurso de plano Fornecedores. Consulte Permissões e planos.
  • O arquivo se chama vendor-pricelist-YYYYMMDD.csv (a data do download). Ele é UTF-8 com marca de ordem de bytes, para que o Excel abra corretamente o texto em árabe.

#As colunas

A linha de cabeçalho de uma exportação, nesta ordem (SupplierTermsCsv::COLUMNS):

Coluna Exportar Importação
item_sku O SKU do item. Obrigatório. Localiza o item pelo SKU. "Nenhum item com este SKU."
item_name O nome do item. Ignorado (apenas para sua leitura).
supplier_id O número do fornecedor no SolaCount. Localiza o fornecedor quando é um número.
supplier_name O nome do fornecedor. Usado quando supplier_id está vazio: o nome deve corresponder a exatamente um fornecedor, sem diferenciar maiúsculas de minúsculas. "Nenhum fornecedor corresponde a este id ou nome."
status approved, blocked ou historical. Opcional; vazio mantém o status atual (novas condições: aprovado).
preferred yes ou no. 1, yes, true, y ou نعم significam sim; qualquer outro valor significa não; vazio deixa sem alteração.
supplier_sku SKU do fornecedor. Opcional.
supplier_item_name Nome do produto do fornecedor. Opcional.
currency_code Moeda dos preços. Opcional, 3 letras.
purchase_unit Texto da unidade de compra. Opcional.
purchase_unit_factor Unidades do item por unidade de compra. Opcional, maior que 0.
minimum_order_qty Pedido mínimo. Opcional.
order_multiple Múltiplo de pedido. Opcional.
lead_time_days Prazo de entrega em dias. Opcional, de 0 a 3650.
discount_percent Desconto do fornecedor %. Opcional, de 0 a 100.
price_scale Casas decimais do preço, ou vazio para o padrão da organização. Opcional, de 3 a 6.
min_qty A quantidade mínima da faixa. Vazio com um preço significa 1.
unit_price O preço unitário da faixa. Obrigatório para uma linha de faixa.
valid_from Data inicial, YYYY-MM-DD. Opcional; "As datas devem usar o formato AAAA-MM-DD."
valid_to Data final, YYYY-MM-DD. Opcional.
notes Notas. Opcional.
managed_in SolaCount ou SolaStock: o aplicativo que gerencia estas condições. Ignorado.
  • Um arquivo precisa de pelo menos item_sku e de supplier_id ou supplier_name; caso contrário, nada é lido: "O arquivo precisa de uma coluna item_sku e de uma coluna supplier_id ou supplier_name." As outras colunas podem ser omitidas ou colocadas em qualquer ordem.
  • Cada linha precisa das duas chaves: "item_sku e supplier_id ou supplier_name são obrigatórios."
  • No máximo 5,000 linhas por arquivo: "Importe no máximo 5000 linhas por vez." O arquivo pode ter até 2 MB.
  • Os números usam ponto para as casas decimais. Separadores de milhar e espaços são removidos, portanto 1,250.50 é lido como 1250.50.
  • A exportação coloca um apóstrofo antes do texto que começa com =, +, - ou @, para que uma planilha não o execute como fórmula; a importação remove esse apóstrofo novamente.
  • Condições sem faixas são exportadas como uma linha com as colunas de faixa vazias.

#Como uma importação é aplicada

Linhas com o mesmo item e fornecedor formam um grupo.

  1. As colunas de condições (status a price_scale, e notes) são lidas da primeira linha do grupo. Repita-as em todas as linhas, se quiser; as linhas seguintes não as alteram.
  2. Cada linha com min_qty ou unit_price é uma faixa. Uma faixa é associada a uma faixa existente por quantidade mínima, válido de e válido até. Uma correspondência atualiza seu preço e a torna ativa novamente; qualquer outra é adicionada como uma nova faixa.
  3. As faixas existentes que não estão no arquivo são mantidas sem alteração. Para encerrar um preço antigo, edite-o na página do item: desmarque Ativo, defina Válido até ou remova-o.
  4. Uma linha sem min_qty nem unit_price apenas atualiza as condições.
  5. O grupo inteiro é então salvo com as mesmas verificações da janela de condições: casas decimais, faixas sobrepostas, fornecedor preferido, fornecedor inativo e assim por diante. Qualquer mensagem é exibida em todas as linhas do grupo.
  6. Duas linhas de um mesmo grupo com a mesma quantidade mínima e as mesmas datas são um erro: "Duplicata da linha 4 (mesmo item, fornecedor, quantidade mínima e datas)."
  7. Linhas de um item cujas condições são gerenciadas pelo SolaStock são recusadas: "As condições de fornecedor deste item são gerenciadas no SolaStock. Importe esta linha no SolaStock." Importe essas linhas na tela de lista de preços de fornecedores do SolaStock.

Um erro interrompe tudo. Pré-visualização executa todas as verificações e depois desfaz o trabalho, portanto nada é salvo. Aplicar importação verifica novamente e salva todas as linhas juntas, ou nenhuma se alguma linha tiver erro.

#Importar uma lista de preços

  1. Clique em Importar lista de preços. A janela Importar lista de preços abre com "Uma linha por faixa de preço. Obrigatório: item_sku e supplier_id ou supplier_name. As faixas existentes que não estão no arquivo são mantidas."
  2. Em Arquivo CSV, escolha o arquivo (.csv ou .txt). O nome dele aparece abaixo do campo.
  3. Clique em Pré-visualização. O resumo diz, por exemplo, "12 linhas: 3 novas, 8 atualizadas, 1 sem alteração, 0 com erros", e uma tabela lista cada linha.
  4. Se houver erros, você vê "Corrija as linhas com erros e faça a pré-visualização novamente. Nada foi salvo." Corrija o arquivo, escolha-o novamente e clique em Pré-visualização.
  5. Quando não houver nenhum, você vê "Nenhum erro encontrado. Aplique a importação para salvar estas linhas." Clique em Aplicar importação.
  6. Você vê "Importação aplicada."; as seções da página são recarregadas. Clique em Fechar.

Colunas da tabela de pré-visualização: Linha (o número da linha no arquivo; o cabeçalho é a linha 1), Item (SKU e nome), Fornecedor, Qtd. mín., Preço unitário (com a moeda), Status e Mensagem.

Estado Significado
Novo A linha adiciona uma faixa a um fornecedor que não tinha condições para o item, ou cria as condições.
Atualizado A linha altera o preço de uma faixa existente, adiciona uma faixa a condições existentes ou reativa uma faixa.
Inalterado A faixa já tem este preço, ou é uma linha somente de condições para condições existentes.
Erro A linha não pode ser salva; o motivo está em Mensagem.

Aplicar importação fica acinzentado até haver uma pré-visualização sem erros e com pelo menos uma linha. Enquanto processa, os botões ficam desativados e um indicador de carregamento é exibido.

#Exemplo prático 1: uma atualização trimestral de preços (AED)

A {Organization name} recebe novos preços da {Supplier 2 name} (fornecedor número 14) para o último trimestre. {User 1 name} abre a página do fornecedor, clica em Exportar CSV em Itens fornecidos e edita o arquivo:

Linha item_sku supplier_id currency_code purchase_unit purchase_unit_factor min_qty unit_price valid_from valid_to
2 PAP-A4-80 14 AED Box 5 10 95.00 2026-01-01
3 PAP-A4-80 14 AED Box 5 50 88.50 2026-10-01 2026-12-31
4 PAP-A3-80 14 AED Box 5 5 160.00 2026-10-01

Ela clica em Importar lista de preços, escolhe o arquivo e clica em Pré-visualização: "3 linhas: 1 nova, 1 atualizada, 1 sem alteração, 0 com erros". A linha 2 é Sem alteração (mesma faixa, mesmo preço), a linha 3 é Atualizado (90.00 passa a ser 88.50) e a linha 4 é Novo porque a Emirates ainda não tinha condições para o papel A3. Ela clica em Aplicar importação e vê "Importação aplicada." Qualquer outra faixa de A4 que não esteja no arquivo, como uma faixa promocional que ela adicionou manualmente, é mantida.

#Exemplo prático 2: um arquivo de fornecedor em USD com erros

{User 1 name} prepara um arquivo para a {Supplier 3 name}, um novo fornecedor que cota em USD e ainda não tem condições, para uma organização em AED, identificando o fornecedor pelo nome:

Linha item_sku supplier_name currency_code price_scale min_qty unit_price valid_from
2 PAP-A4-80 pacific paper exports inc. USD 4 1 24.50 2026-10-01
3 PAP-A4-80 pacific paper exports inc. USD 4 100 23.12345 2026-10-01
4 PAP-A4-80 pacific paper exports inc. USD 4 1 24.40 2026-10-01
5 CAR-250 pacific paper exports inc. USD 4 1 3.10 01/10/2026

Pré-visualização encontra quatro erros e não salva nada:

  • Linha 4: "Duplicata da linha 2 (mesmo item, fornecedor, quantidade mínima e datas)."
  • Linhas 2 e 3: "Use no máximo 4 casas decimais para este fornecedor." (23.12345 tem cinco casas decimais; a mensagem é exibida no grupo inteiro).
  • Linha 5: "As datas devem usar o formato AAAA-MM-DD."

Ela exclui a linha 4, muda 23.12345 para 23.1235 e a data para 2026-10-01, e faz a pré-visualização novamente. Agora a linha 5 mostra "As condições de fornecedor deste item são gerenciadas no SolaStock. Importe esta linha no SolaStock.", porque Cardamomo 250g é um item do SolaStock nesta organização conectada. Ela remove essa linha, faz a pré-visualização ("2 linhas: 2 novas, 0 atualizadas, 0 sem alteração, 0 com erros") e aplica. O nome correspondeu mesmo digitado em minúsculas. Os preços em USD são convertidos para AED apenas para comparação, usando a taxa mais recente na data ou antes dela; os preços armazenados permanecem em USD.

#Dicas e problemas comuns

Problema Causa Solução
"O arquivo precisa de uma coluna item_sku…" A linha de cabeçalho está ausente ou foi renomeada. Comece a partir de um arquivo exportado.
"Nenhum fornecedor corresponde a este id ou nome." Nenhum fornecedor, ou vários fornecedores, têm esse nome. Use supplier_id de uma exportação.
Os preços antigos ainda estão lá após uma importação As importações nunca excluem faixas. Desative ou encerre a faixa antiga na página do item.
Um grupo inteiro mostra o mesmo erro O grupo é salvo como uma unidade. Corrija a linha a que a mensagem se refere e faça a pré-visualização novamente.
Linhas do SolaStock são recusadas O SolaStock gerencia as condições desses itens. Importe-as no SolaStock.
O Excel transformou 0012 em 12 As planilhas eliminam zeros à esquerda. Formate a coluna como texto antes de digitar os SKUs.