Pular para o conteúdo principal

Obtener configuración de precios

GET 
/settings/pricing

Devuelve la configuración actual de precios, comisiones e impuestos de la plataforma.

Propósito:

  • Proporcionar la estructura de precios actualizada
  • Permitir cálculos consistentes en toda la plataforma
  • Facilitar la transparencia en costos y tarifas

Casos de uso:

  • Cálculo de tarifas en el proceso de cotización
  • Mostrar desglose de costos al usuario final
  • Sincronización entre diferentes servicios de la plataforma
  • Actualización centralizada de estructura de precios

Flujo típico:

  1. El cliente (web/app) llama a este endpoint al necesitar información de precios
  2. El servidor obtiene la última configuración de precios
  3. Retorna un objeto con:
    • Precio base
    • Porcentaje de comisión
    • Porcentaje de impuestos
  4. El cliente utiliza estos valores para cálculos y visualizaciones

Consideraciones:

  • Los valores se expresan en euros (€)
  • Los porcentajes se representan como decimales (ej. 0.20 = 20%)
  • Los cambios se propagan inmediatamente a todos los clientes
  • No requiere autenticación (datos públicos)

Ejemplo de implementación:

// Ejemplo de consumo desde frontend
async function calculateTotalPrice(baseAmount) {
  try {
    const response = await fetch('/company/settings/pricing');
    const pricing = await response.json();
    
    const commission = baseAmount * pricing.commission;
    const tax = baseAmount * pricing.tax;
    const total = baseAmount + commission + tax;
    
    return {
      base: baseAmount,
      commission,
      tax, 
      total
    };
  } catch (error) {
    console.error('Error calculating price:', error);
    throw error;
  }
}

Responses​

Configuración de precios obtenida