Volume Pricing com outros métodos de API

Obtenha ou exclua um único registro de Volume Pricing pelo ID usando a API pública.

Este documento explica como obter e excluir registros de Volume Pricing usando a API pública.

Obter um registro de Volume Pricing

1. Endpoint

Para obter um registro de Volume Pricing específico:

GET https://wholesale.samita.io/api/v1/volume-pricings/{id}

{id} é o ID do registro de Volume Pricing

O ID pode ser obtido na interface do app
Não inclua o símbolo “#” ao usar o ID

Exemplo:

GET https://wholesale.samita.io/api/v1/volume-pricings/1

2. Cabeçalhos da requisição

Todas as requisições GET devem incluir os seguintes cabeçalhos obrigatórios:

Cabeçalho	Descrição	Obrigatório
`X-SAMITA-API-KEY`	Chave de API fornecida no app Wholesale	Sim
`X-SAMITA-SHOP-URL`	Domínio da loja Shopify no formato xxx.myshopify.com	Sim
`CONTENT-TYPE`	Deve ser `application/json`	Sim

Se algum desses cabeçalhos estiver ausente, a requisição será rejeitada.

3. Corpo da requisição

A API GET não exige corpo na requisição
Apenas o parâmetro {id} na URL é obrigatório

4. Resposta da API

Respostas de erro

401 – Unauthorized

Este erro ocorre quando a autenticação falha.

Possíveis motivos:

URL da loja ausente
Chave de API ausente
URL da loja incorreta
Chave de API incorreta
A chave de API não corresponde à loja informada

403 – This action is unauthorized

Este erro ocorre quando:

A chave de API não tem a permissão View
O ID informado não existe
A chave de API não tem direitos de acesso suficientes

Cada chave de API pode receber as seguintes permissões:

View
Create
Update
Delete

A API GET exige a permissão View.

429 – Too Many Requests

Este erro ocorre quando o limite de requisições é excedido.

Limites atuais:

No máximo 1 requisição a cada 5 minutos
No máximo 50 requisições por dia

Resposta de sucesso

200 – API Success

A requisição é válida
O registro foi obtido com sucesso
A resposta é retornada em formato JSON

Exemplo:

{
  "id": 1,
  "title": "New Volume Pricing",
  "status": true,
  "type": "quantity",
  "apply_customer": {
    "type": "all",
    "tags": []
  },
  "exclude_customer": {
    "type": "none",
    "tags": []
  },
  "apply_product": {
    "type": "all",
    "product_ids": [],
    "product_tags": [],
    "collection_ids": [],
    "apply_for_variants": false
  },
  "exclude_product": {
    "type": "none",
    "product_ids": [],
    "collection_ids": []
  },
  "discount_for_variants": [
    {
      "id": 8516448190631,
      "duplicated": false,
      "variant_pricing": true,
      "from_qty": "0",
      "from_amount": "0",
      "to_qty": "10",
      "to_amount": "0",
      "discount_groups": [
        {
          "name": "all",
          "type": "percent",
          "value": "10"
        }
      ],
      "variants": [
        {
          "id": 46747346763943,
          "duplicated": false,
          "from_qty": "0",
          "from_amount": "0",
          "to_qty": "10",
          "to_amount": "0",
          "discount_groups": [
            {
              "name": "all",
              "type": "percent",
              "value": "10"
            }
          ]
        }
      ]
    }
  ],
  "apply_market": {
    "type": "all",
    "handle": []
  },
  "discount_method": "variant",
  "discount_groups": [
    {
      "from_qty": "0",
      "from_amount": "0",
      "to_qty": "10",
      "to_amount": "0",
      "type": "percent",
      "value": "10"
    }
  ],
  "active_date": {
    "types": [],
    "start_at": "",
    "end_at": ""
  },
  "created_at": "2026-01-15T10:00:00",
  "updated_at": "2026-01-15T10:00:00"
}

Excluir um registro de Volume Pricing

1. Endpoint

Para excluir um ou mais registros de Volume Pricing existentes:

DELETE https://wholesale.samita.io/api/v1/volume-pricings/{id}

O {id} na URL deve ser um ID de registro válido, mas a API exclui, na verdade, os registros listados no parâmetro ids (veja Corpo da requisição, abaixo) — e não o segmento da URL.