Volume Pricing con otros métodos de la API

Consulta o elimina un registro de Volume Pricing por ID con la Public API.

Este documento explica cómo consultar y eliminar registros de Volume Pricing con la Public API.

Obtener un registro de Volume Pricing

1. Endpoint

Para consultar un registro de Volume Pricing concreto:

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

{id} es el ID del registro de Volume Pricing

El ID se puede obtener en la interfaz de la aplicación
No incluyas el símbolo “#” al usar el ID

Ejemplo:

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

2. Encabezados de la solicitud

Todas las solicitudes GET deben incluir los siguientes encabezados obligatorios:

Encabezado	Descripción	Obligatorio
`X-SAMITA-API-KEY`	Clave de API proporcionada en la aplicación Wholesale	Sí
`X-SAMITA-SHOP-URL`	Dominio de la tienda de Shopify con el formato xxx.myshopify.com	Sí
`CONTENT-TYPE`	Debe ser `application/json`	Sí

Si falta alguno de estos encabezados, la solicitud se rechazará.

3. Cuerpo de la solicitud

La API GET no requiere cuerpo de la solicitud
Solo se necesita el parámetro {id} de la URL

4. Respuesta de la API

Respuestas de error

401 – Unauthorized

Este error se produce cuando falla la autenticación.

Posibles motivos:

Falta la URL de la tienda
Falta la clave de API
URL de la tienda incorrecta
Clave de API incorrecta
La clave de API no corresponde a la tienda indicada

403 – This action is unauthorized

Este error se produce cuando:

La clave de API no tiene el permiso View
El ID indicado no existe
La clave de API no tiene derechos de acceso suficientes

A cada clave de API se le pueden asignar los siguientes permisos:

View
Create
Update
Delete

La API GET requiere el permiso View.

429 – Too Many Requests

Este error se produce cuando se supera el límite de solicitudes.

Límites actuales:

Máximo 1 solicitud cada 5 minutos
Máximo 50 solicitudes al día

Respuesta correcta

200 – API Success

La solicitud es válida
El registro se obtiene correctamente
La respuesta se devuelve en formato JSON

Ejemplo:

{
  "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"
}

Eliminar un registro de Volume Pricing

1. Endpoint

Para eliminar uno o más registros de Volume Pricing existentes:

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

{id} en la URL debe ser un ID de registro válido, pero la API elimina en realidad los registros que se indiquen en el parámetro ids (consulta el cuerpo de la solicitud más abajo), no el segmento de la URL.