Preços

O TradeCatalog calcula todos os preços dos clientes em um só lugar, da mesma forma para o app, o portal comercial, o MCP e a API. Você nunca calcula preços manualmente.

Produtos configurados, taxas medidas, limites de quantidade, extras líquidos e arredondamento explícito também usam este serviço de preços. Cite uma linha completa com POST /products/{id}/quote; um preço ausente pode significar configurationRequired, enquanto uma especificação não precificada válida é Preço sob consulta. Use o total da linha retornado. Veja configuração do catálogo de compras para precedência, tratamento líquido e publicação.

Como os preços são calculadosLink para esta seção#

A regra mais específica vence, e as ajustes nunca são acumuladas:

1. Preço acordado. Se o cliente tem um preço fixo para o produto, esse é o preço.
2. Caso contrário, o preço da lista com uma porcentagem, a primeira que se aplica. Uma porcentagem é um desconto (deduzido) ou um acréscimo (adicionado):
   1. a porcentagem do cliente para esse produto
   2. a porcentagem do cliente para a categoria do produto (a mais próxima vence)
   3. a porcentagem do cliente para a marca do produto
   4. a porcentagem do cliente sobre a lista inteira
3. Caso contrário, o preço da lista.

Um desconto de categoria de 10% e um acréscimo de lista de 5% dão 10% de desconto, não os dois. A unidade nunca é inferior a zero e é arredondada para cima até a unidade menor inteira. O total da linha é unit × qty.

Preços da lista e preços acordados são versões por data. A API sempre fornece o preço válido agora. Preços futuros de uma mudança agendada entram em vigor a partir da data.

Listas de preços e acesso ao catálogoLink para esta seção#

Standard é o catálogo mestre do fornecedor. Outras listas de preços podem conter produtos com preços e produtos aguardando cotação. A ausência de preço em uma lista atribuída não retorna para Standard.

No espaço de trabalho, abra Listas de preços e escolha uma lista nomeada. Clientes atribuídos podem ver tem duas opções:

• Todos os produtos do catálogo permitidos é o padrão. A lista define os preços; os compradores atribuídos também podem navegar por outros produtos permitidos, conforme solicitado por preço.
• Apenas os produtos desta lista limita o catálogo, buscas, links de produtos e novos pedidos de cada comprador atribuído a apenas os produtos desta lista. A visibilidade de outros produtos e restrições de lista aprovada ainda se aplicam. Os clientes em outras listas mantêm seu acesso existente.

Cada lista mostra sua contagem de clientes, produtos com preço, produtos sem preço e total de produtos. Totais incluem produtos inativos, portanto podem exceder o que um comprador vê atualmente. Um preço zero é considerado como produto com preço. Um preço futuro é considerado como produto sem preço até sua data de início.

Para adicionar produtos, selecione-os em Produtos, escolha Adicionar à lista de preços, depois copie os preços Padrão com uma porcentagem opcional ou selecione Adicionar sem preços. Membros existentes mantêm seus preços. Produtos sem preço Padrão são adicionados como Preço sob consulta. Na página de uma lista nomeada, salvar um SKU com preço em branco o adiciona sem preço ou limpa seu preço atual. Remover o retira dessa lista, mantendo o produto principal e os pedidos anteriores. Resolva qualquer alteração de preço pendente para esse produto primeiro.

Estes controles exigem o plano Pro e direitos de edição de preços globais. Listas existentes mantêm seu acesso ao catálogo até que um fornecedor o altere. Importações via API para uma lista nomeada incluem linhas ordinárias de produtos com nenhum preço como membros sem preço; uma célula vazia em uma importação apenas de preços deixa o acesso inalterado.

O objeto de preçoLink para esta seção#

Cada produto’s price tem esta forma. GET /prices retorna os mesmos campos no nível superior de data.

{
  "unit": 1573,
  "line": 15730,
  "list": 1850,
  "discountBp": 1500,
  "adjustment": "discount",
  "source": "brand",
  "label": "15% off your list",
  "remark": null
}

Verificar preço do clienteLink para esta seção#

GET/api/v1/prices

O que o cliente paga por um SKU em uma quantidade, e por quê. Use para responder "Quanto Oakfield paga por 10 caixas do HX-8510?".

curl "https://tradecatalog.app/api/v1/prices?customer=OAK01&sku=HX-8510&qty=10" \
  -H "Authorization: Bearer $TRADECATALOG_API_KEY"

const params = new URLSearchParams({
  customer: 'OAK01',
  sku: 'HX-8510',
  qty: '10',
})
const res = await fetch(`https://tradecatalog.app/api/v1/prices?${params}`, {
  headers: { Authorization: `Bearer ${process.env.TRADECATALOG_API_KEY}` },
})
const { data: price, currency } = await res.json()

{
  "data": {
    "customer": {
      "id": "7d2e4f0a-1b3c-4d5e-8f90-a1b2c3d4e5f6",
      "accountCode": "OAK01",
      "name": "Oakfield Joinery"
    },
    "sku": "HX-8510",
    "name": "Hex bolt M10 x 50 zinc",
    "qty": 10,
    "unit": 1573,
    "line": 15730,
    "list": 1850,
    "discountBp": 1500,
    "source": "brand",
    "label": "15% off your list",
    "remark": null
  },
  "currency": "GBP"
}

Este ponto de acesso verifica apenas o preço. Ele não verifica se o cliente pode ver o produto. Para isso, use GET /products/{id}?customer=….

Preços para muitos produtosLink para esta seção#

Para precificar uma página inteira de produtos para um cliente, use GET /products?customer=OAK01. Cada linha’s price é o preço desse cliente, e os produtos exclusivos para outros clientes são omitidos. Veja Produtos.

Alterando preçosLink para esta seção#

• Preços da lista mudam por meio de alterações de preços, então os clientes recebem notificação. Envie novos preços com PUT /products; eles entram em um rascunho que você publica no aplicativo.
• Margens, descontos e preços acordados são definidos por cliente no aplicativo. Leia-os com GET /customers/{id}.
• Preços acordados para muitos clientes são definidos com PUT /agreed-prices.
• O percentual da lista inteira de um cliente pode ser definido com PUT /customers (discountBp, e opcional adjustment).

Definir preços acordadosLink para esta seção#

PUT/api/v1/agreed-pricesescreva a chave

Crie ou substitua preços acordados para clientes e produtos existentes. Envie até 2.000 linhas. Os preços são unidades menores inteiras. Deixe commit como falso para visualizar: nada é salvo e cada conta ou SKU desconhecida retorna como erro de linha. Defina commit como verdadeiro para salvar. Salvar fecha o preço acordado válido agora e insere o novo a partir deste momento, em lotes de 100. Apenas para Pro.

curl -X PUT https://tradecatalog.app/api/v1/agreed-prices \
  -H "Authorization: Bearer $TRADECATALOG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"commit":false,"prices":[{"accountCode":"OAK01","sku":"HX-8510","price":1250,"note":"Contract"}]}'