Flujo de Venta Completo

// VentaForm.jsx línea 78-149
- Carga datos del cliente desde cotización
- Importa todos los productos con cantidades
- Mantiene moneda y configuración de IGV
- Pre-selecciona tipo de documento según cliente:
  * RUC → Factura (F001)
  * DNI/CE → Boleta (B001)

// VentasController.php línea 337-341
if (!empty($validated['cotizacion_id'])) {
    Cotizacion::where('id', $cotizacionId)
        ->update(['estado' => 'aprobada']);
}

// VentasController.php línea 136-148
if ($validated['id_tido'] == 2 && strlen($documento) !== 11) {
    return 'Para FACTURA se requiere RUC (11 dígitos)';
}
if ($validated['id_tido'] == 1 && strlen($documento) === 11) {
    return 'Para BOLETA use DNI. Para RUC emita Factura';
}

// VentasController.php línea 232-261
if (!$idProducto && $esProductoLibre) {
    // Busca o crea producto con código LIB-0001
    $productoLibre = Producto::where('nombre', $nombreLibre)
        ->where('id_empresa', $idEmpresa)
        ->first();
    
    if (!$productoLibre) {
        // Genera código automático LIB-XXXX
        $codigoAuto = 'LIB-' . str_pad($ultimoCodigo + 1, 4, '0', STR_PAD_LEFT);
        $productoLibre = Producto::create([...]);
    }
}

// VentaForm.jsx línea 218-235
if (formData.id_tido === '6') {
    // Nota de Venta → Almacén 2 (Kardex Real)
    nuevoAlmacen = '2';
} else if (formData.id_tido === '1' || formData.id_tido === '2') {
    // Factura/Boleta → Almacén 1 (SUNAT)
    nuevoAlmacen = '1';
}

// VentasController.php línea 316-334
if ($request->has('pago_id_tipo_pago')) {
    $voucherPath = null;
    if ($request->hasFile('pago_voucher')) {
        $filename = 'voucher_' . $venta->id_venta . '_' . time();
        $voucherPath = $file->storeAs('vouchers', $filename, 'public');
    }
    
    VentaPago::create([
        'id_venta' => $venta->id_venta,
        'id_tipo_pago' => $request->pago_id_tipo_pago,
        'monto' => $venta->total,
        'voucher' => $voucherPath,
    ]);
}

// VentasController.php línea 150-359
DB::transaction(function () use ($validated, $user) {
    // 1. Resolver o crear cliente
    $clienteModel = Cliente::where('documento', $docCliente)
        ->firstOrCreate([...]);
    
    // 2. Calcular próximo número
    $ultimaVenta = Venta::where('serie', $serie)->max('numero');
    $numeroBase = DB::table('documentos_empresas')
        ->where('serie', $serie)
        ->value('numero');
    $proximoNumero = max($ultimaVenta, $numeroBase) + 1;
    
    // 3. Crear venta
    $venta = Venta::create([
        'serie' => $serie,
        'numero' => $proximoNumero,
        'total' => $total,
        'afecta_stock' => $id_tido == 6 ? false : true,
        'estado' => '1', // Activo
        'estado_sunat' => '0', // Pendiente
    ]);
    
    // 4. Guardar productos y descontar stock
    foreach ($validated['productos'] as $producto) {
        ProductoVenta::create([...]);
        
        // Descontar stock si afecta
        if ($afectaStock && !$esProductoLibre) {
            $productoModel->decrement('cantidad', $cantidad);
            
            // Registrar movimiento
            MovimientoStock::create([
                'tipo_movimiento' => 'salida',
                'tipo_documento' => 'venta',
                'id_documento' => $venta->id_venta,
                'documento_referencia' => $venta->serie . '-' . $numero,
            ]);
        }
    }
    
    // 5. Actualizar estado de cotización origen
    if ($cotizacion_id) {
        Cotizacion::where('id', $cotizacion_id)
            ->update(['estado' => 'aprobada']);
    }
    
    // 6. Actualizar estado de nota de venta origen
    if ($nota_venta_id) {
        Venta::where('id_venta', $nota_venta_id)
            ->update(['estado' => '3']); // Vendida
    }
});

// Frontend llama:
POST /api/ventas/{id}/enviar-sunat

// SunatService.php
public function enviarVenta(Venta $venta)
{
    // 1. Generar XML con Greenter
    $invoice = new Invoice();
    $invoice->setTipoDoc($venta->tipoDocumento->cod_sunat);
    $invoice->setSerie($venta->serie);
    $invoice->setCorrelativo($venta->numero);
    
    // Cliente
    $client = new Client();
    $client->setTipoDoc($cliente->tipo_doc);
    $client->setNumDoc($cliente->documento);
    $client->setRznSocial($cliente->datos);
    
    // Productos
    foreach ($venta->productosVentas as $detalle) {
        $item = new SaleDetail();
        $item->setCodProducto($detalle->codigo_producto);
        $item->setDescripcion($detalle->descripcion);
        $item->setCantidad($detalle->cantidad);
        $item->setMtoValorUnitario($detalle->precio_unitario);
        $item->setTipAfeIgv($detalle->tipo_afectacion_igv);
        $invoice->addDetail($item);
    }
    
    // Forma de pago
    if ($venta->id_tipo_pago == 1) {
        $invoice->setFormaPago(new FormaPagoContado());
    } else {
        $credito = new FormaPagoCredito();
        $credito->setMonto($venta->total);
        
        foreach ($venta->cuotas as $cuota) {
            $cuotaGreenter = new Cuota();
            $cuotaGreenter->setMonto($cuota->monto);
            $cuotaGreenter->setFechaPago($cuota->fecha_vencimiento);
            $credito->addCuota($cuotaGreenter);
        }
        $invoice->setFormaPago($credito);
    }
    
    // 2. Firmar y enviar
    $see = $this->getSee($empresa);
    $result = $see->send($invoice);
    
    // 3. Procesar CDR
    if ($result->isSuccess()) {
        $cdr = $result->getCdrResponse();
        
        // Guardar CDR ZIP
        $cdrPath = "sunat/cdr/{$ruc}/R-{$nombreXml}.zip";
        Storage::put($cdrPath, $result->getCdrZip());
        
        // Actualizar venta
        $venta->update([
            'nombre_xml' => $nombreXml,
            'xml_url' => "sunat/xml/{$ruc}/{$nombreXml}.xml",
            'cdr_url' => $cdrPath,
            'estado_sunat' => '1', // Aceptado
            'codigo_sunat' => $cdr->getCode(),
            'mensaje_sunat' => $cdr->getDescription(),
        ]);
    }
}

// Ruta: /reporteNV/a4.php?id={venta_id}
// Genera PDF con mPDF usando plantilla A4

// VentasController.php línea 537-599
public function descontarStock($id)
{
    $venta = Venta::with('productosVentas')
        ->where('stock_real_descontado', false)
        ->findOrFail($id);
    
    foreach ($venta->productosVentas as $detalle) {
        // Buscar producto equivalente en almacén 2
        $productoAlmacen2 = Producto::where('almacen', '2')
            ->where('codigo', $detalle->producto->codigo)
            ->first();
        
        if ($productoAlmacen2) {
            $productoAlmacen2->decrement('cantidad', $detalle->cantidad);
            
            MovimientoStock::create([
                'tipo_movimiento' => 'salida',
                'tipo_documento' => 'descuento_almacen',
                'motivo' => 'Descuento de almacén real por venta',
                'id_almacen' => 2,
            ]);
        }
    }
    
    $venta->update(['stock_real_descontado' => true]);
}

// Actualiza tabla dias_ventas
UPDATE dias_ventas 
SET estado = 'C' // Cancelado
WHERE id = cuota_id;