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_skue desupplier_idousupplier_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.
- As colunas de condições (
statusaprice_scale, enotes) são lidas da primeira linha do grupo. Repita-as em todas as linhas, se quiser; as linhas seguintes não as alteram. - Cada linha com
min_qtyouunit_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. - 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.
- Uma linha sem
min_qtynemunit_priceapenas atualiza as condições. - 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.
- 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)."
- 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
- 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."
- Em Arquivo CSV, escolha o arquivo (
.csvou.txt). O nome dele aparece abaixo do campo. - 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.
- 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.
- Quando não houver nenhum, você vê "Nenhum erro encontrado. Aplique a importação para salvar estas linhas." Clique em Aplicar importação.
- 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. |