Há três formas de cadastrar um preço base:
- pelo Admin
- por planilha
- por API REST
Siga o passo a passo abaixo para cadastrar os preços base de seus SKUs:
Admin
- No Admin VTEX, acesse Preços > Lista de preços, ou digite Lista de preços na barra de busca no topo da página.
- Cada caixa contém um produto com seus respectivos SKUs. Clique na primeira coluna da linha do SKU desejado. Uma barra lateral será aberta.
- Preencha os campos descritos abaixo.
- Preço de custo: preencha com o custo do SKU.
- Markup: preencha com a margem de lucro a ser obtida com a venda do SKU.
- Clique na própria barra lateral para salvar o preço.
- O Preço base será calculado em função dos dados fornecidos nos passos anteriores.
Caso você deseje, é possível cadastrar um preço de lista associado ao preço base do SKU. Para isso, siga os passos abaixo:
- Na barra lateral onde é feito o cadastro do preço base, clique em + Preço de lista.
- No campo Preço de lista, preencha com o valor desejado para o SKU.
- Clique na própria barra lateral para salvar o preço de lista.
API REST
As autenticações para as chamadas de API REST do módulo de Preços devem ser feitas via AppKey e AppToken. Para entender mais, acesse nosso artigo sobre como gerar um Appkey e um AppToken para autenticar suas integrações.
Para cadastrar o preço base de um SKU, você precisa enviar um PUT para o seguinte endpoint:
https://api.vtex.com/{{account}}/pricing/prices/{{itemId}}
Você também pode cadastrar um preço de lista associado ao preço base do SKU. No entanto, este campo não é obrigatório.
- O objeto do request tem as seguintes propriedades:
| Propriedades | Tipos | Descrição |
|---|---|---|
| costPrice | integer | Preço de Custo do SKU |
| markup | integer | Markup do SKU |
| basePrice | integer | Preço Base do SKU |
| listPrice | integer | Preço de lista do SKU |
- O objeto de response tem as seguintes propriedades:
| Propriedades | Tipos | Descrição |
|---|---|---|
| itemId | string | ID do SKU |
| costPrice | integer | Preço de Custo do SKU |
| basePrice | integer | Preço Base do SKU |
| listPrice | integer | Preço de Lista do SKU |
| markup | integer | Markup do SKU |
| fixedPrices | array | Preço Fixo |
| tradePolicyId | integer | ID da Politica Comercial |
| value | integer | Valor do Preço Fixo |
| listPrice | integer | Preço de Lista |
| minQuantity | integer | Quantidade mínima de itens |
| dateRange | string | Variação de data do preço fixo |
- Abaixo, temos um exemplo de Header e três exemplos possíveis de Body a serem passados no request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.vtex.pricing.v3+json |
| Content-Type | application/json |
| X-VTEX-API-AppKey | {{X-VTEX-API-AppKey}} |
| X-VTEX-API-AppToken | {{X-VTEX-API-AppToken}} |
Body - Exemplo 1
{ "costPrice": null, "markup": 100, "basePrice": 300}
costPrice * (1 + markup%) = basePrice
Neste exemplo, como markup = 100 e basePrice = 300, o costPrice será calculado pelo sistema com valor de 150.
Body - Exemplo 2
{ "costPrice": 150, "markup": null, "basePrice": 300, "listPrice": 500}
costPrice * (1 + markup%) = basePrice
Neste exemplo, como costPrice = 150 e basePrice = 300, o markup será calculado pelo sistema com o valor de 100.
Também incluímos um preço de lista de valor 500.
Body - Exemplo 3
{ "costPrice": 150, "markup": 100, "basePrice": null,}
costPrice * (1 + markup%) = basePrice
Neste exemplo, como costPrice = 150 e markup = 100, o basePrice será calculado pelo sistema com o valor de 300.