BranchPriceList

Lista de precios de una sucursal. Contiene los parámetros para calcular el precio de venta de todos los productos y servicios a partir de su costo base, con una fórmula sencilla; además se puede fijar un valor personalizado por producto/servicio dentro de la lista (goodPrices).

multiplied_price = branch_good.min_price_e2 * price_multiplier; rounded_price_e2 = roundUpToNearestInt(multiplied_price, price_multiple_e2); price_e2 = rounded_price_e2 + price_adjustment_e2;

Notas

  • Cada sucursal tiene una única lista is_default = true; al marcar una como predeterminada se desmarcan las demás, y al desmarcarla se reasigna otra automáticamente (preferentemente la de la moneda local).
  • clients son los clientes a los que se asigna explícitamente esta lista.
  • Sólo las listas enabled se usan para cotizar.

Estructura de Datos

Atributo Tipo Descripción
id int
name string Nombre de la lista de precios.
price_multiplier float Factor por el que se multiplica el costo base del producto.
price_multiple_e2 int Múltiplo (céntimos) al que se redondea hacia arriba el precio resultante.
price_adjustment_e2 int Ajuste fijo (céntimos) que se suma tras redondear.
enabled bool true si la lista está activa y puede usarse para cotizar.
is_default bool true si es la lista predeterminada de la sucursal (única por sucursal).
created_at datetime\|null Fecha de creación.
updated_at datetime\|null Fecha de última modificación.
branch_id int Sucursal dueña de la lista.
currency_id int\|null Moneda de la lista; null usa la de la sucursal.
allLogs ApiLog> Registros de auditoría de la API, incluidos los internos.
branch Branch Sucursal dueña de la lista.
clients Client> Clientes a los que se asigna explícitamente esta lista.
currency Currency\|null Moneda de la lista.
goodPrices BranchGoodPrice> Precios personalizados por producto dentro de la lista.
logs ApiLog> Registros de auditoría de la API visibles. 
{
    "id": 118,
    "name": "USD default",
    "price_multiplier": 1,
    "price_multiple_e2": 1,
    "price_adjustment_e2": 0,
    "enabled": true,
    "is_default": true,
    "created_at": "2021-01-26 20:11:41",
    "updated_at": "2025-11-25 13:41:35",
    "branch_id": 1,
    "currency_id": 26
}

Endpoints

Insertar BranchPriceList

Crear una lista de precios

Crea una BranchPriceList para la sucursal (name, price_multiplier, price_multiple_e2, price_adjustment_e2, currency_id).

Método URI Cabeceras
POST /companies/{companyId}/branches/{branchId}/price-lists Authorization 
{
    "name": "required|string|max:64",
    "price_multiplier": "numeric|min:0.00001",
    "price_multiple_e2": "integer|min:1",
    "price_adjustment_e2": "integer",
    "currency_id": "integer"
}

Listar BranchPriceList

Listar las listas de precios de una sucursal

{info} Soporta: Paginación Filters Carga dinámica

Devuelve las BranchPriceList de la sucursal indicada, paginadas.

Método URI Cabeceras
GET /companies/{companyId}/branches/{branchId}/price-lists Authorization

Mostrar BranchPriceList

Ver una lista de precios

Devuelve la BranchPriceList indicada.

Método URI Cabeceras
GET /companies/{companyId}/price-lists/{priceListId} Authorization

Actualizar BranchPriceList

Actualizar una lista de precios

Modifica la BranchPriceList indicada. Marcarla como predeterminada desmarca las demás de la sucursal.

Método URI Cabeceras
PATCH /companies/{companyId}/price-lists/{priceListId} Authorization 
{
    "name": "string|max:64",
    "price_multiplier": "numeric|min:0.00001",
    "price_multiple_e2": "integer|min:1",
    "price_adjustment_e2": "integer"
}

Eliminar BranchPriceList

Eliminar una lista de precios

Borra la BranchPriceList indicada; si era la predeterminada se reasigna otra.

Método URI Cabeceras
DELETE /companies/{companyId}/price-lists/{priceListId} Authorization

Relaciones