Acciones

Es la entidad que maneja la asignación de las acciones que cada promoción va a realizar cuando se cumplen sus condiciones (reglas). Para que una promoción se ejecute, necesita al menos una regla y una acción (aunque puede tener múltiples combinaciones de ambas). Acciones actualmente disponibles:

1. Crear ajuste / Tarifa plana (por pedido): aplica un descuento de importe fijo a toda la compra (por ejemplo: RD$ 200 pesos de descuento).

2. Crear ajuste / Porcentaje fijo (por pedido): aplica un descuento porcentual a toda la compra (por ejemplo: 20% de descuento).

3. Crear ajuste / Tarifa flexible (por pedido): aplica un descuento de importe fijo a toda la compra pero con mayor flexibilidad de configuración (por ejemplo: RD$ 100 pesos de descuento al primer producto y RD$ 200 pesos más por producto / unidad adicional).

4. Crear ajuste / Tarifa plana por niveles: aplica un descuento de importe fijo a toda la compra pero permite especificar niveles (por ejemplo: RD$ 100 pesos de descuento como base, pero si la compra supera RD$ 5,000 pesos entonces RD$ 300 pesos de descuento y así por N niveles que se necesiten).

5. Crear ajuste / Porcentaje por niveles: aplica un descuento porcentual a toda la compra pero permite especificar niveles (por ejemplo: 5% de descuento como base, pero si la compra supera RD$ 5,000 pesos un 10%, si supera RD$ 10,000 un 15% y así por N niveles que se necesiten).

6. Crear un ajuste por línea / Tarifa plana: aplica un descuento de importe fijo por producto (no a toda la compra). Útil para crear descuentos de importe fijo a productos específicos (independientemente del resto de productos del carrito).

7. Crear un ajuste por línea / Porcentaje fijo: aplica un descuento porcentual por producto (no a toda la compra). Útil para crear descuentos porcentuales a productos específicos (independientemente del resto de productos del carrito).

8. Crear un ajuste por línea / Tarifa flexible: aplica un descuento de importe fijo por producto (no a toda la compra) pero con mayor flexibilidad de configuración (por ejemplo: RD$ 100 pesos de descuento a la primera unidad y RD$ 200 pesos de descuento para unidad adicional).

9. Crear líneas de artículos: agrega al carrito X unidades de un producto. Útil para incluir productos regalos en la compra de manera automática.

Envío gratuito: aplica un descuento del 100% en cualquier método de envío seleccionado durante la compra.

Crear ajuste / Tarifa plana (por pedido)

POST https://tiendagoshop.com/api/v1/promotions/:promotion_id/promotion_actions

Path Parameters

Name	Type	Description
promotion_id	integer	ID de la promoción

Request Body

Name	Type	Description
type	string	Tipo de regla Valor: Spree::Promotion:: Actions::CreateAdjustment
calculator_type	string	Tipo de tarifa Valor: Spree::Calculator:: FlatRate
calculator_attributes	object	Atributos de los ajustes de tarifa. Objeto con la siguiente propiedad: preferred_amount

200

{
  "id": 56,
  "promotion_id": 4,
  "type": "Spree::Promotion::Actions::CreateAdjustment"
}

Crear ajuste / Porcentaje fijo (por pedido)

POST https://tiendagoshop.com/api/v1/promotions/:promotion_id/promotion_actions

Path Parameters

Name	Type	Description
promotion_id	integer	ID de la promoción

Request Body

Name	Type	Description
type	string	Tipo de regla Valor: Spree::Promotion:: Actions::CreateAdjustment
calculator_type	string	Tipo de tarifa Valor: Spree::Calculator:: FlatPercentItemTotal
calculator_attributes	object	Atributos de los ajustes de tarifa. Objeto con la siguiente propiedad: preferred_flat_percent

200

{
  "id": 57,
  "promotion_id": 4,
  "type": "Spree::Promotion::Actions::CreateAdjustment"
}

Crear ajuste / Tarifa flexible (por pedido)

POST https://tiendagoshop.com/api/v1/promotions/:promotion_id/promotion_actions

Path Parameters

Name	Type	Description
promotion_id	integer	ID de la promoción

Request Body

Name	Type	Description
type	string	Tipo de regla Valor: Spree::Promotion::Actions ::CreateAdjustment
calculator_type	string	Tipo de tarifa Valor: Spree::Calculator ::FlexiRate
calculator_attributes	object	Atributos de los ajustes de tarifa. Objeto con las siguientes propiedades: preferred_first_item, preferred_additional_item, preferred_max_items

200

{
  "id": 58,
  "promotion_id": 4,
  "type": "Spree::Promotion::Actions::CreateAdjustment"
}

Crear ajuste / Tarifa plana por niveles

POST https://tiendagoshop.com/api/v1/promotions/:promotion_id/promotion_actions

Path Parameters

Name	Type	Description
promotion_id	integer	ID de la promoción

Request Body

Name	Type	Description
type	string	Tipo de regla Valor: Spree::Promotion::Actions ::CreateAdjustment
calculator_type	string	Tipo de tarifa Valor: Spree::Calculator::TieredFlatRate
calculator_attributes	object	Atributos de los ajustes de tarifa. Objeto con las siguientes propiedades. "preferred_base_amount" :integer, "preferred_tiers": { "2000.0":integer, "3000.0":integer}

200

{
  "id": 60,
  "promotion_id": 4,
  "type": "Spree::Promotion::Actions::CreateAdjustment"
}

Crear ajuste / Porcentaje por niveles

POST https://tiendagoshop.com/api/v1/promotions/:promotion_id/promotion_actions

Path Parameters

Name	Type	Description
promotion_id	integer	ID de la promoción

Request Body

Name	Type	Description
type	string	Tipo de regla Valor: Spree::Promotion::Actions:: CreateAdjustment
calculator_type	string	Tipo de tarifa Valor: Spree::Calculator ::TieredPercent
calculator_attributes	object	Atributos de los ajustes de tarifa. "preferred_base_percent": integer, "preferred_tiers": { "2000.0":integer, "3000.0":integer}

200

{
  "id": 59,
  "promotion_id": 4,
  "type": "Spree::Promotion::Actions::CreateAdjustment"
}

Crear un ajuste por línea / Tarifa plana

POST https://tiendagoshop.com/api/v1/promotions/:promotion_id/promotion_actions

Path Parameters

Name	Type	Description
promotion_id	integer	ID de la promoción

Request Body

Name	Type	Description
type	string	Tipo de regla Valor: Spree::Promotion::Actions:: CreateItemAdjustments
calculator_type	string	Tipo de tarifa Valor: Spree::Calculator ::FlatRate
calculator_attributes	array	Atributos de los ajustes de tarifa. Objeto con la siguiente propiedad: preferred_amount

200

{
  "id": 62,
  "promotion_id": 4,
  "type": "Spree::Promotion::Actions::CreateItemAdjustments"
}

Crear un ajuste por línea / Porcentaje fijo

POST https://tiendagoshop.com/api/v1/promotions/:promotion_id/promotion_actions

Path Parameters

Name	Type	Description
promotion_id	integer	ID de la promoción

Request Body

Name	Type	Description
type	string	Tipo de regla. Valor: Spree::Promotion::Actions:: CreateItemAdjustments
calculator_type	string	Tipo de tarifa Valor: Spree::Calculator ::PercentOnLineItem
calculator_attributes	array	Atributos de los ajustes de tarifa. Objeto con la siguiente propiedad: preferred_percent:integer

200

{
  "id": 61,
  "promotion_id": 4,
  "type": "Spree::Promotion::Actions::CreateItemAdjustments"
}

Crear un ajuste por línea / Tarifa flexible

POST https://tiendagoshop.com/api/v1/promotions/:promotion_id/promotion_actions

Path Parameters

Name	Type	Description
promotion_id	integer	ID de la promoción

Request Body

Name	Type	Description
type	string	Tipo de regla. Valor: Spree::Promotion::Actions:: CreateItemAdjustments
calculator_type	string	Tipo de tarifa Valor: Spree::Calculator ::FlexiRate
calculator_attributes	array	Atributos de los ajustes de tarifa. Objeto con las siguientes propiedades: preferred_first_item: integer, preferred_additional_item: integer, preferred_max_items:integer

200

{
  "id": 63,
  "promotion_id": 4,
  "type": "Spree::Promotion::Actions::CreateItemAdjustments"
}

Crear líneas de artículos

POST https://tiendagoshop.com/api/v1/promotions/:promotion_id/promotion_actions

Path Parameters

Name	Type	Description
promotion_id	integer	ID de la promoción

Request Body

Name	Type	Description
type	string	Tipo de regla. Valor: Spree::Promotion::Actions:: CreateLineItems
promotion_action_line_items_attributes	array	Atributos de los ajustes de tarifa Array de objetos con las siguientes propiedades: { "variant_id":,"quantity": }

200

{
  "id": 64,
  "promotion_id": 4,
  "type": "Spree::Promotion::Actions::CreateLineItems"
}

Envío gratuito

POST https://tiendagoshop.com/api/v1/promotions/:promotion_id/promotion_actions

Path Parameters

Name	Type	Description
promotion_id	integer	ID de la promoción

Request Body

Name	Type	Description
type	string	Tipo de regla, valor: Spree::Promotion::Actions:: FreeShipping

200

{
  "id": 65,
  "promotion_id": 4,
  "type": "Spree::Promotion::Actions::FreeShipping"
}

Eliminar una acción dentro de una promoción.

DELETE /api/v1/promotions/:promotion_id/promotion_actions/:id

Path Parameters

Name	Type	Description
id	integer	ID de la acción
promotion_id	integer	ID de la promoción

204