Preços de atacado com outros métodos da API

Consulte ou exclua um registro de preços de atacado pelo ID usando a API pública.

Este documento explica como consultar e excluir registros de preços de atacado usando a API pública.

Consultar um registro de preços de atacado

1. Endpoint

Para consultar um registro de preços de atacado específico:

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

{id} é o ID do registro de preços de atacado

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/wholesale-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 da requisição
Apenas o parâmetro {id} na URL é obrigatório

4. Resposta da API

Respostas de erro

401 – Não autorizado

Este erro ocorre quando a autenticação falha.

Motivos possíveis:

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 – Esta ação não é autorizada

Este erro ocorre quando:

A chave de API não tem permissão de 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 – Excesso de requisições

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

Limites atuais:

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

Resposta de sucesso

200 – Sucesso da API

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

Exemplo:

{
  "id": 1,
  "title": "New Wholesale Pricing",
  "status": true,
  "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,
      "variant_pricing": true,
      "variants": [
        {
          "id": 46747346763943,
          "discount_groups": [
            {
              "name": "all",
              "type": "percent",
              "value": "10"
            }
          ]
        }
      ]
    }
  ],
  "apply_market": {
    "type": "all",
    "handle": []
  },
  "discount_group": {
    "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 preços de atacado

1. Endpoint

Para excluir um ou mais registros de preços de atacado existentes:

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

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