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_skuesupplier_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.
- As colunas de condições (
statusaprice_scaleenotes) vêm da primeira linha do grupo. - Cada linha com
min_qtyouunit_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. - 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.
- Uma linha sem
min_qtynemunit_priceapenas atualiza as condições. - 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.
- 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
- 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."
- 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."
- O arquivo é verificado imediatamente ("Verificando o arquivo…"). Indicadores mostram o número de linhas, novas, atualizadas, inalteradas e erros.
- 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).
- 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).
- 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. |