Cotizaciones

Descripción General

El módulo de cotizaciones permite crear presupuestos que posteriormente pueden convertirse en ventas (facturas o boletas). Soporta múltiples monedas, cuotas de pago y descuentos.

Funcionalidades Principales

Listar Cotizaciones

Utiliza una vista de base de datos optimizada para el listado.

public function index(Request $request)
{
    try {
        $user = $request->user();
        $idEmpresa = $user->id_empresa;
        
        $cotizaciones = DB::table('view_cotizaciones')
            ->where('id_empresa', $idEmpresa)
            ->orderBy('id', 'desc')
            ->get();
        
        return response()->json([
            'success' => true,
            'data' => $cotizaciones
        ]);
    } catch (\Exception $e) {
        return response()->json([
            'success' => false,
            'message' => 'Error al obtener cotizaciones: ' . $e->getMessage()
        ], 500);
    }
}

Mostrar Cotización

Obtiene una cotización con todas sus relaciones.

public function show(Request $request, $id)
{
    try {
        $user = $request->user();
        $cotizacion = Cotizacion::with(['cliente', 'usuario', 'detalles.producto', 'cuotas'])
            ->where('id_empresa', $user->id_empresa)
            ->findOrFail($id);

        return response()->json([
            'success' => true,
            'data' => $cotizacion
        ]);
    } catch (\Exception $e) {
        return response()->json([
            'success' => false,
            'message' => 'Cotización no encontrada'
        ], 404);
    }
}

Crear Cotización

Soporta tres formas de identificar al cliente:

Por id_cliente existente
Por cliente_documento (busca o crea)
Por cliente_nombre libre (sin documento)

public function store(Request $request)
{
    $validator = Validator::make($request->all(), [
        'fecha' => 'required|date',
        'id_cliente' => 'nullable|exists:clientes,id_cliente',
        'cliente_documento' => 'nullable|string|max:11',
        'cliente_datos' => 'nullable|string|max:245',
        'cliente_nombre' => 'nullable|string|max:255',
        'moneda' => 'required|in:PEN,USD',
        'tipo_cambio' => 'nullable|numeric',
        'aplicar_igv' => 'required|boolean',
        'descuento' => 'nullable|numeric|min:0',
        'productos' => 'required|array|min:1',
        'productos.*.producto_id' => 'required|exists:productos,id_producto',
        'productos.*.cantidad' => 'required|numeric|min:0.01',
        'productos.*.precio_unitario' => 'required|numeric|min:0',
        'productos.*.precio_especial' => 'nullable|numeric|min:0',
        'cuotas' => 'nullable|array',
        'cuotas.*.monto' => 'required_with:cuotas|numeric|min:0',
        'cuotas.*.fecha_vencimiento' => 'required_with:cuotas|date',
    ]);

    DB::beginTransaction();

    // Resolver cliente
    $idCliente = $request->id_cliente;
    $clienteNombre = null;

    if (!$idCliente && $request->cliente_documento) {
        // Buscar o crear cliente por documento
        $clienteModel = Cliente::where('documento', $request->cliente_documento)
            ->where('id_empresa', $idEmpresa)
            ->first();

        if (!$clienteModel) {
            $clienteModel = Cliente::create([
                'documento' => $request->cliente_documento,
                'datos' => $request->cliente_datos,
                'direccion' => $request->cliente_direccion ?? '',
                'id_empresa' => $idEmpresa,
            ]);
        }
        $idCliente = $clienteModel->id_cliente;
    } elseif (!$idCliente) {
        // Cliente libre sin documento
        $clienteNombre = $request->cliente_nombre ?: $request->cliente_datos;
    }

    // Generar número correlativo
    $ultimaCotizacion = Cotizacion::where('id_empresa', $idEmpresa)
        ->orderBy('numero', 'desc')
        ->first();
    $numero = $ultimaCotizacion ? $ultimaCotizacion->numero + 1 : 1;

    // Calcular totales
    $montoBruto = 0;
    foreach ($request->productos as $prod) {
        $precio = $prod['precio_especial'] ?? $prod['precio_unitario'];
        $montoBruto += $precio * $prod['cantidad'];
    }

    $descuento = $request->descuento ?? 0;
    $total = $montoBruto - $descuento;
    
    $igv = 0;
    $subtotal = $total;

    if ($request->aplicar_igv) {
        $subtotal = $total / 1.18;
        $igv = $total - $subtotal;
    }

    // Crear cotización
    $cotizacion = Cotizacion::create([
        'numero' => $numero,
        'fecha' => $request->fecha,
        'id_cliente' => $idCliente,
        'cliente_nombre' => $clienteNombre,
        'subtotal' => $subtotal,
        'igv' => $igv,
        'total' => $total,
        'descuento' => $descuento,
        'aplicar_igv' => $request->aplicar_igv,
        'moneda' => $request->moneda,
        'id_empresa' => $idEmpresa,
        'id_usuario' => $user->id,
    ]);

    // Crear detalles
    foreach ($request->productos as $prod) {
        $precio = $prod['precio_especial'] ?? $prod['precio_unitario'];
        $subtotalDetalle = $precio * $prod['cantidad'];

        CotizacionDetalle::create([
            'cotizacion_id' => $cotizacion->id,
            'producto_id' => $prod['producto_id'],
            'cantidad' => $prod['cantidad'],
            'precio_unitario' => $prod['precio_unitario'],
            'precio_especial' => $prod['precio_especial'] ?? null,
            'subtotal' => $subtotalDetalle,
        ]);
    }

    // Crear cuotas si existen
    if ($request->has('cuotas') && is_array($request->cuotas)) {
        foreach ($request->cuotas as $index => $cuota) {
            CotizacionCuota::create([
                'cotizacion_id' => $cotizacion->id,
                'numero_cuota' => $index + 1,
                'monto' => $cuota['monto'],
                'fecha_vencimiento' => $cuota['fecha_vencimiento'],
                'tipo' => $cuota['tipo'] ?? 'cuota',
            ]);
        }
    }

    DB::commit();

    return response()->json([
        'success' => true,
        'message' => 'Cotización creada exitosamente',
        'data' => $cotizacion->load(['cliente', 'detalles', 'cuotas'])
    ], 201);
}

Cálculo de Totales

Importante sobre PreciosLos precios ingresados en precio_unitario y precio_especial ya incluyen IGV. El sistema calcula:

montoBruto = suma de (precio × cantidad) de todos los productos
total = montoBruto - descuento
Si aplicar_igv = true:
- subtotal = total / 1.18 (base imponible)
- igv = total - subtotal
Si aplicar_igv = false:
- subtotal = total
- igv = 0

Precio Especial

Cada producto puede tener un precio_especial que sobrescribe el precio_unitario:

foreach ($request->productos as $prod) {
    $precio = $prod['precio_especial'] ?? $prod['precio_unitario'];
    $montoBruto += $precio * $prod['cantidad'];
}

Actualizar Cotización

Permite modificar una cotización existente, eliminando y recreando detalles y cuotas.

public function update(Request $request, $id)
{
    $cotizacion = Cotizacion::where('id_empresa', $user->id_empresa)
        ->findOrFail($id);

    // Validación similar a store...

    DB::beginTransaction();

    // Calcular nuevos totales...

    $cotizacion->update([
        'fecha' => $request->fecha,
        'id_cliente' => $idCliente,
        'cliente_nombre' => $clienteNombre,
        'subtotal' => $subtotal,
        'igv' => $igv,
        'total' => $total,
        'descuento' => $descuento,
        'aplicar_igv' => $request->aplicar_igv,
        'estado' => $request->estado ?? $cotizacion->estado,
    ]);

    // Eliminar detalles y cuotas anteriores
    $cotizacion->detalles()->delete();
    $cotizacion->cuotas()->delete();

    // Crear nuevos detalles y cuotas...

    DB::commit();

    return response()->json([
        'success' => true,
        'message' => 'Cotización actualizada exitosamente',
        'data' => $cotizacion->load(['cliente', 'detalles', 'cuotas'])
    ]);
}

Gestión de Estado

Cambiar Estado

public function cambiarEstado(Request $request, $id)
{
    $validator = Validator::make($request->all(), [
        'estado' => 'required|in:pendiente,aprobada,rechazada,vencida',
    ]);

    $cotizacion = Cotizacion::where('id_empresa', $user->id_empresa)
        ->findOrFail($id);
    $cotizacion->update(['estado' => $request->estado]);

    return response()->json([
        'success' => true,
        'message' => 'Estado actualizado exitosamente',
        'data' => $cotizacion
    ]);
}

Estados Disponibles

Pendiente

Cotización creada, esperando aprobación del cliente

Aprobada

Cliente aprobó la cotización (se convirtió en venta)

Rechazada

Cliente rechazó o se eliminó la cotización

Vencida

Cotización expiró sin respuesta

Cuotas de Pago

Las cotizaciones pueden incluir un plan de pagos en cuotas.

if ($request->has('cuotas') && is_array($request->cuotas)) {
    foreach ($request->cuotas as $index => $cuota) {
        CotizacionCuota::create([
            'cotizacion_id' => $cotizacion->id,
            'numero_cuota' => $index + 1,
            'monto' => $cuota['monto'],
            'fecha_vencimiento' => $cuota['fecha_vencimiento'],
            'tipo' => $cuota['tipo'] ?? 'cuota',
        ]);
    }
}

Tipos de Cuota

inicial: Pago inicial o adelanto
cuota: Cuota regular del plan de pagos

Eliminar Cotización

Realiza un soft delete cambiando el estado a “rechazada”.

public function destroy(Request $request, $id)
{
    try {
        $user = $request->user();
        $cotizacion = Cotizacion::where('id_empresa', $user->id_empresa)
            ->findOrFail($id);
        $cotizacion->update(['estado' => 'rechazada']);
        
        return response()->json([
            'success' => true,
            'message' => 'Cotización eliminada exitosamente'
        ]);
    } catch (\Exception $e) {
        return response()->json([
            'success' => false,
            'message' => 'Error al eliminar cotización: ' . $e->getMessage()
        ], 500);
    }
}

Próximo Número

public function proximoNumero(Request $request)
{
    try {
        $user = $request->user();

        $ultimaCotizacion = Cotizacion::where('id_empresa', $user->id_empresa)
            ->orderBy('numero', 'desc')
            ->first();

        $proximoNumero = $ultimaCotizacion ? $ultimaCotizacion->numero + 1 : 1;

        return response()->json([
            'success' => true,
            'numero' => 'COT-' . str_pad($proximoNumero, 6, '0', STR_PAD_LEFT)
        ]);
    } catch (\Exception $e) {
        return response()->json([
            'success' => false,
            'message' => 'Error al obtener próximo número: ' . $e->getMessage()
        ], 500);
    }
}

El formato de número es COT-000001, con 6 dígitos con ceros a la izquierda.

Modelo de Datos

Cotizacion Model

protected $table = 'cotizaciones';

protected $fillable = [
    'numero',
    'fecha',
    'id_cliente',
    'cliente_nombre',
    'direccion',
    'subtotal',
    'igv',
    'total',
    'descuento',
    'aplicar_igv',
    'moneda',
    'tipo_cambio',
    'dias_pago',
    'asunto',
    'observaciones',
    'estado',
    'id_empresa',
    'id_usuario',
];

protected $casts = [
    'fecha' => 'date',
    'subtotal' => 'decimal:2',
    'igv' => 'decimal:2',
    'total' => 'decimal:2',
    'descuento' => 'decimal:2',
    'tipo_cambio' => 'decimal:4',
    'aplicar_igv' => 'boolean',
];

Relaciones

public function cliente()
{
    return $this->belongsTo(Cliente::class, 'id_cliente', 'id_cliente');
}

public function usuario()
{
    return $this->belongsTo(User::class, 'id_usuario');
}

public function ventas()
{
    return $this->hasMany(Venta::class, 'cotizacion_id', 'id');
}

public function detalles()
{
    return $this->hasMany(CotizacionDetalle::class, 'cotizacion_id');
}

public function cuotas()
{
    return $this->hasMany(CotizacionCuota::class, 'cotizacion_id');
}

// Scopes
public function scopePorEmpresa($query, $idEmpresa)
{
    return $query->where('id_empresa', $idEmpresa);
}

public function scopePendientes($query)
{
    return $query->where('estado', 'pendiente');
}

public function scopeAprobadas($query)
{
    return $query->where('estado', 'aprobada');
}

Conversión a Venta

Cuando se crea una venta desde una cotización, esta se marca como aprobada:

if (!empty($validated['cotizacion_id'])) {
    Cotizacion::where('id', $validated['cotizacion_id'])
        ->where('id_empresa', $user->id_empresa)
        ->update(['estado' => 'aprobada']);
}

Ver la documentación de Facturación Electrónica para más detalles sobre la creación de ventas desde cotizaciones.

Soporte Multi-Moneda

Soles (PEN)
Dólares (USD)

Moneda nacional peruana. No requiere tipo de cambio.

Moneda extranjera. Se puede especificar un tipo_cambio para referencia.

El campo tipo_cambio es informativo y no afecta los cálculos. Todas las operaciones se realizan en la moneda seleccionada.

Inicio

Primeros Pasos

Características Principales

Gestión de Empresas

Reportes y Exportación

Descripción General

Funcionalidades Principales

Listar Cotizaciones

Mostrar Cotización

Crear Cotización

Cálculo de Totales

Precio Especial

Actualizar Cotización

Gestión de Estado

Cambiar Estado

Estados Disponibles

Pendiente

Aprobada

Rechazada

Vencida

Cuotas de Pago

Tipos de Cuota

Eliminar Cotización

Próximo Número

Modelo de Datos

Cotizacion Model

Relaciones

Conversión a Venta

Soporte Multi-Moneda

Build docs developers (and LLMs) love

Inicio

Primeros Pasos

Características Principales

Gestión de Empresas

Reportes y Exportación

​Descripción General

​Funcionalidades Principales

​Listar Cotizaciones

​Mostrar Cotización

​Crear Cotización

​Cálculo de Totales

​Precio Especial

​Actualizar Cotización

​Gestión de Estado

​Cambiar Estado

​Estados Disponibles

Pendiente

Aprobada

Rechazada

Vencida

​Cuotas de Pago

​Tipos de Cuota

​Eliminar Cotización

​Próximo Número

​Modelo de Datos

​Cotizacion Model

​Relaciones

​Conversión a Venta

​Soporte Multi-Moneda

Build docs developers (and LLMs) love

Descripción General

Funcionalidades Principales

Listar Cotizaciones

Mostrar Cotización

Crear Cotización

Cálculo de Totales

Precio Especial

Actualizar Cotización

Gestión de Estado

Cambiar Estado

Estados Disponibles

Cuotas de Pago

Tipos de Cuota

Eliminar Cotización

Próximo Número

Modelo de Datos

Cotizacion Model

Relaciones

Conversión a Venta

Soporte Multi-Moneda