Motor de Precios y Tarifas

El endpoint /prices es el motor de cálculo de precios de BaseGes ERP. Permite obtener los precios netos finales de venta para un cliente específico, aplicando de forma automática todas las reglas de tarifas, descuentos por familia, promociones y condiciones pactadas.

Seguridad

Requiere autorización mediante cabecera HTTP:

• X-Api-Key: {tu_clave_api} o Authorization: Bearer {tu_token_jwt}

---

Consulta de Precios por Cliente (GET)

GET /prices

Parámetros de Consulta (Query String)

Parámetro	Tipo	Obligatorio	Descripción
customerId	string	Sí	Código del cliente sobre el que se calculan las tarifas y descuentos.
productRef	string	No	Referencia del artículo específico a consultar.
familyCode	string	No	Filtrar precios de todos los artículos de una familia.
subfamilyCode	string	No	Filtrar precios por subfamilia.
groupCode	string	No	Filtrar precios por grupo.
page	integer	No	Número de página (predeterminado: 1).
pageSize	integer	No	Elementos por página (predeterminado: 50, máx: 100).

Uso Recomendado para E-commerce y CRMs

En lugar de replicar las fórmulas complejas de tarifas, descuentos escalonados y promociones de BaseGes en una tienda online o CRM, llame a este endpoint pasando el customerId del usuario autenticado para obtener el precio exacto que se le facturará.

Ejemplo de Petición

GET /prices?customerId=CLI00120&productRef=CAB-FLEX-3G25 HTTP/1.1
Host: localhost:5000
X-Api-Key: tu-api-key-secreta

Respuesta Exitosa (200 OK)

{
  "items": [
    {
      "productReference": "CAB-FLEX-3G25",
      "productDescription": "Cable Manguera Flexible 3G 2.5 mm² Libre de Halógenos",
      "customerId": "CLI00120",
      "basePrice": 1.55,
      "discountPercent": 10.0,
      "finalPrice": 1.395,
      "taxPercent": 21.0,
      "finalPriceWithTax": 1.688,
      "appliedTariff": "Tarifa Especial Instaladores"
    }
  ],
  "page": 1,
  "pageSize": 50,
  "totalCount": 1,
  "totalPages": 1,
  "hasPreviousPage": false,
  "hasNextPage": false
}