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 item 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. Exportar CSV fornece as condições atuais para revisar em uma planilha; Importar lista de preços carrega os novos preços de um fornecedor para muitos itens de uma vez. Cada condição é explicada na aba Fornecedores do item.

Uma importação é sempre verificada antes de qualquer coisa ser salva, salva todas as linhas ou nenhuma, e nunca exclui uma faixa que não esteja no arquivo.

#Onde encontrar

Botão Onde Exporta ou importa
Exportar CSV, Importar lista de preços Compras → Fornecedores, cabeçalho da página Exportação: todos os fornecedores e itens.
Exportar CSV, Importar lista de preços A aba Itens de um fornecedor Exportação: os itens deste fornecedor.
Exportar CSV, Importar lista de preços A aba Fornecedores de um item Exportação: os fornecedores deste item.
  • Exportar CSV exige Ver itens e Exportar relatórios de inventário. Importar lista de preços exige Criar / editar / desativar itens. Um botão que você não pode usar não é exibido. "A exportação de listas de preços de fornecedor não está disponível para o seu acesso." aparece se o servidor recusar uma exportação.
  • Ambos fazem parte do recurso de plano Fornecedores (stock.suppliers).
  • Uma importação pode conter quaisquer itens e fornecedores, qualquer que seja a página em que você comece.
  • O arquivo é vendor-pricelist-YYYYMMDD.csv, UTF-8 com marca de ordem de bytes. Durante a exportação, o botão mostra Exportando…; "Não foi possível exportar a lista de preços." se falhar.

#As colunas

A linha de cabeçalho, nesta ordem (SupplierTermsCsv::COLUMNS):

Coluna Exportar Importação
item_sku O SKU do item. Obrigatório. "Nenhum item com este SKU."
supplier_code O código do fornecedor. Obrigatório. O fornecedor é encontrado somente pelo código. "Nenhum fornecedor com este código."
supplier_name O nome do fornecedor. Ignorado (para sua leitura).
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 O código do item do fornecedor. Opcional.
supplier_item_name O nome do produto do fornecedor. Opcional.
currency_code Moeda dos preços. Opcional, 3 letras.
purchase_unit O código da unidade de compra, por exemplo CTN. Opcional; a unidade deve existir ("Nenhuma unidade com este código.") e converter para a unidade base do item.
minimum_order_qty Pedido mínimo, na unidade de compra. Opcional.
order_multiple Múltiplo de pedido, na unidade de compra. 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, por unidade de compra. 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.
  • O cabeçalho deve conter item_sku e supplier_code: "O arquivo não tem as colunas obrigatórias: supplier_code." Outras colunas podem faltar ou estar em outra ordem.
  • Cada linha precisa de ambos: "item_sku e supplier_code são obrigatórios."
  • No máximo 5,000 linhas de dados ("Importe no máximo 5000 linhas por vez.") e 2 MB ("O arquivo é maior que 2 MB. Divida-o em arquivos menores.").
  • Os decimais usam ponto. Separadores de milhar e espaços são removidos, portanto 1,250.50 é lido como 1250.50.
  • O texto que começa com =, +, - ou @ é exportado com um apóstrofo inicial para que as planilhas não o executem como fórmula; a importação remove o apóstrofo.
  • As condições sem faixas são exportadas como uma linha com as colunas de faixa vazias. A descrição do fornecedor e a caixa Ativo de uma faixa não estão no arquivo; as faixas importadas são sempre ativas.

#Como uma importação é aplicada

As linhas com os mesmos item_sku e supplier_code formam um grupo.

  1. As colunas de condições (status a price_scale e notes) vêm da primeira linha do grupo.
  2. Cada linha com min_qty ou unit_price é uma faixa, associada a uma faixa existente por quantidade mínima, válido de e válido até. Uma correspondência recebe o novo preço e volta a ficar ativa; caso contrário, a faixa é adicionada.
  3. As faixas existentes que não estão no arquivo são mantidas. Para aposentar um preço, encerre-o ou desmarque Ativo na aba Fornecedores do item.
  4. Uma linha sem min_qty nem unit_price apenas atualiza as condições.
  5. O grupo é salvo com as mesmas regras da janela de condições: casas decimais, faixas sobrepostas, fornecedor preferido, fornecedores inativos, conversão de unidade. Uma mensagem é exibida em cada linha do grupo.
  6. Duas linhas de um grupo com a mesma quantidade mínima e datas: "Duplicata da linha 3 (mesmo item, fornecedor, quantidade mínima e datas)."

Se alguma linha tiver erro, nada é salvo, nem na verificação nem ao aplicar.

#Importar uma lista de preços

  1. Clique em Importar lista de preços. Abre-se a janela Importar lista de preços de fornecedor: "Verifique primeiro o arquivo e depois aplique-o. As faixas existentes que não estão no arquivo são mantidas."
  2. Em Arquivo CSV, escolha o arquivo ("CSV UTF-8 com linha de cabeçalho, como o gerado por Exportar CSV. Até 5.000 linhas."). Colunas abre a lista de colunas e "item_sku e supplier_code são obrigatórios. As datas usam AAAA-MM-DD e os decimais usam ponto."
  3. O arquivo é verificado imediatamente ("Verificando o arquivo…"). Indicadores mostram o número de linhas, novas, atualizadas, inalteradas e erros.
  4. Com erros: "Algumas linhas têm erros. Nada foi salvo. Corrija o arquivo e escolha-o novamente." Corrija o arquivo, escolha-o novamente ou clique em Verifique novamente depois de corrigir os dados no SolaStock (por exemplo, adicionando uma unidade que falta).
  5. Sem erros: "O arquivo é válido. Nada foi salvo ainda — escolha Aplicar importação para salvá-lo." Clique em Aplicar importação (mostra Trabalhando… durante o salvamento).
  6. Em caso de sucesso, a janela se fecha com "Lista de preços importada: 2 criadas, 1 atualizada, 0 inalteradas." e as listas abertas são atualizadas. Se o servidor encontrar um erro nesse momento, nada é salvo: "Nada foi salvo porque algumas linhas têm erros." e as linhas são exibidas novamente.

Tabela de linhas: Linha (número da linha no arquivo; o cabeçalho é a linha 1), SKU do item, Código do fornecedor, Quantidade mínima, Preço unitário, Moeda, Estado e Mensagem. As linhas com erro ficam destacadas.

Estado Significado
Novo Uma faixa para um fornecedor que não tinha condições para o item, ou novas condições.
Atualizar Um preço alterado, uma faixa reativada ou uma faixa adicionada a condições existentes.
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; veja Mensagem.
Não verificada Não processada.

Outras mensagens: "O arquivo está vazio.", "O arquivo não tem linhas de dados.", "Não foi possível ler o arquivo.", "Não foi possível verificar o arquivo.", "Não foi possível aplicar a importação." e "Você não pode fazer esta alteração com sua função ou plano atual. Nada foi salvo."

#Exemplo prático 1: novos preços por caixa de um fornecedor local (AED)

{Supplier 5 name} (SUP-DEMO-05) envia novos preços para o quarto trimestre. {User 2 name} abre a aba Itens do fornecedor, clica em Exportar CSV e edita o arquivo:

Linha item_sku supplier_code currency_code purchase_unit minimum_order_qty order_multiple min_qty unit_price valid_from valid_to
2 CAR-250 SUP-DEMO-05 AED CTN 5 5 5 360.00 2026-01-01
3 CAR-250 SUP-DEMO-05 AED CTN 5 5 20 338.00 2026-10-01 2026-12-31
4 CUM-500 SUP-DEMO-05 AED CTN 2 1 2 410.00 2026-10-01
5 TUR-500 SUP-DEMO-05 AED BOX 1 55.00 2026-10-01

Ele clica em Importar lista de preços e escolhe o arquivo. A verificação mostra 4 linhas, 2 novas, 1 atualizada, 1 inalterada, 0 erros: linha 2 Inalterada, linha 3 Atualizar (342.00 passa a 338.00), linhas 4 e 5 Nova ({Supplier 5 name} não tinha condições para cominho e cúrcuma). Ele clica em Aplicar importação e vê "Lista de preços importada: 2 criadas, 1 atualizada, 1 inalterada." A página do cardamomo agora mostra 338.00 para 20 caixas; a faixa de 5 caixas permanece inalterada.

Se BOX não existisse como unidade, a linha 5 mostraria "Nenhuma unidade com este código." e nada teria sido salvo, incluindo as linhas 2 a 4.

#Exemplo prático 2: um fornecedor em USD com duplicata e erro de casas decimais

{Supplier 6 name} (SUP-DEMO-06) cota em USD com 4 casas decimais de preço. O comprador prepara:

Linha item_sku supplier_code currency_code price_scale discount_percent min_qty unit_price valid_from
2 CAR-250 SUP-DEMO-06 USD 4 5 10 88.0000 2026-10-01
3 CAR-250 SUP-DEMO-06 USD 4 5 50 84.12345 2026-10-01
4 CAR-250 SUP-DEMO-06 USD 4 5 10 87.5000 2026-10-01
5 CAR-250 SUP-KERLA USD 4 5 10 88.0000 2026-10-01

A verificação informa 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." (84.12345 tem cinco casas decimais; o grupo inteiro mostra a mensagem).
  • Linha 5: "Nenhum fornecedor com este código." (um erro de digitação).

Depois de excluir as linhas 4 e 5 e corrigir o preço para 84.1235, a verificação fica limpa e Aplicar importação salva duas faixas em USD. Em uma organização do SolaStock vinculada ao SolaCount, esses preços são comparados com os de fornecedores em AED usando a taxa do SolaCount (1 AED = 0.2723 USD faz 88.00 menos 5% ÷ 24 resultar em cerca de 12.79 AED por peça); sem o SolaCount, eles são listados na comparação com Sem taxa de câmbio.

#Dicas e problemas comuns

Problema Causa Solução
"O arquivo não tem as colunas obrigatórias: …" A linha de cabeçalho está ausente ou foi renomeada. Comece a partir de um arquivo exportado.
"Nenhum fornecedor com este código." O código está escrito errado; os nomes não são usados para encontrar fornecedores. Copie o código de Fornecedores.
As faixas antigas permanecem As importações nunca excluem faixas. Encerre-as ou desative-as no item.
"Esta unidade de compra não tem conversão para a unidade base do item…" O código da unidade existe, mas não converte para a unidade base do item. Adicione a conversão de unidade em Configurações.
O texto em árabe aparece corrompido no Excel O arquivo foi salvo em outra codificação. Salve como CSV UTF-8.
Nenhum botão Exportar CSV Você não tem Exportar relatórios de inventário. Veja Acesso da equipe.