fatture

app/Models/ContrattoServizioRiga.php

         return $periodo !== '' ? $periodo : 'una_tantum';
     }
 
+    /**
+     * Cadenza della fattura. Sulle ore il periodo della riga è solo il monte
+     * (1 ora al mese): se il contratto è più lungo, si fattura il suo ciclo
+     * (un annuale = 12 ore all'apertura dell'anno).
+     */
+    public function periodoFatturazione(?string $periodoContratto = null): string
+    {
+        $ciclo = $this->periodoCiclo($periodoContratto);
+        if (! $this->isUnitaOra()) {
+            return $ciclo;
+        }
+
+        $mesiRiga = self::mesiPeriodo((string) $this->periodo);
+        $mesiContratto = self::mesiPeriodo((string) $periodoContratto);
+        if ($mesiRiga > 0 && $mesiContratto > $mesiRiga) {
+            return (string) $periodoContratto;
+        }
+
+        return $ciclo;
+    }
+
+    /**
+     * Ore comprese in un ciclo di fattura. 1 ora mensile in un annuale = 12.
+     */
+    public function quantitaFatturata(?string $periodoContratto = null): float
+    {
+        $qty = (float) ($this->quantita ?? 1);
+        if (! $this->isUnitaOra()) {
+            return $qty;
+        }
+
+        $mesiRiga = self::mesiPeriodo((string) $this->periodo);
+        $mesiFattura = self::mesiPeriodo($this->periodoFatturazione($periodoContratto));
+        if ($mesiRiga < 1 || $mesiFattura < 1) {
+            return $qty;
+        }
+
+        $volte = intdiv($mesiFattura, $mesiRiga);
+
+        return $volte > 1 ? round($qty * $volte, 2) : $qty;
+    }
+
+    public function importoFatturazione(?string $periodoContratto = null): float
+    {
+        if ($this->isAConsumo() || $this->prezzo_netto === null) {
+            return 0.0;
+        }
+
+        return round($this->quantitaFatturata($periodoContratto) * (float) $this->prezzo_netto, 2);
+    }
+
+    public function labelQuantita(float $quantita): string
+    {
+        $nome = optional($this->prodotto)->nome ?: 'Servizio';
+        $qty = rtrim(rtrim(number_format($quantita, 2, ',', ''), '0'), ',');
+        $um = $this->unita_misura ?: optional($this->prodotto)->unita_misura;
+
+        return trim($nome.' ('.$qty.($um ? ' '.$um : '').')');
+    }
+
+    public static function mesiPeriodo(?string $periodo): int
+    {
+        return match ($periodo) {
+            'mensile' => 1,
+            'trimestrale' => 3,
+            'semestrale' => 6,
+            'annuale' => 12,
+            default => 0,
+        };
+    }
+
     /**
      * Mese, anno e forfait non hanno un periodo separato: non va persistito.
      */

app/Services/FatturazioneGeneraService.php

             }
 
             foreach ($contratto->righe as $riga) {
-                $periodoKey = $riga->periodoCiclo($contratto->periodo);
+                $periodoKey = $riga->periodoFatturazione($contratto->periodo);
                 foreach ($this->dateOccorrenzeRigaNelPeriodo($contratto, $riga, $from, $to) as $occurrence) {
                     [$pDa, $pA] = $this->finestraCiclo($periodoKey, $occurrence, $this->decorrenzaRiga($contratto, $riga));
                     if ($this->cicloPrecedenteAllaSoglia($occurrence, $pDa, $rinnoviDa)) {
                     if ($this->canoneGiaFatturato($contratto->id, $riga->id, $pDa, $pA)) {
                         continue;
                     }
-                    $importo = $riga->importo_ciclo;
+                    $importo = $riga->importoFatturazione($contratto->periodo);
                     if ($importo <= 0) {
                         continue;
                     }
-                    $this->aggiungiCanoneCliente($clienti[$key], $contratto, $riga, $importo, $pDa, $pA);
+                    $quantita = $riga->isUnitaOra() ? $riga->quantitaFatturata($contratto->periodo) : 1.0;
+                    $prezzo = $riga->isUnitaOra() ? (float) $riga->prezzo_netto : $importo;
+                    $label = ($riga->isUnitaOra() && $quantita > (float) ($riga->quantita ?? 1))
+                        ? $riga->labelQuantita($quantita)
+                        : null;
+                    $this->aggiungiCanoneCliente($clienti[$key], $contratto, $riga, $importo, $pDa, $pA, $quantita, $prezzo, $label);
                 }
             }
 
             return [];
         }
 
-        $periodo = $riga->periodoCiclo($contratto->periodo);
+        $periodo = $riga->periodoFatturazione($contratto->periodo);
         if ($periodo === 'a_consumo') {
             return [];
         }
         ?ContrattoServizioRiga $riga,
         float $importo,
         Carbon $pDa,
-        Carbon $pA
+        Carbon $pA,
+        float $quantita = 1,
+        ?float $prezzoUnitario = null,
+        ?string $labelRiga = null
     ): void {
         $importo = round($importo, 2);
-        $labelRiga = $riga ? $riga->label : 'Canone contratto';
-        $periodoLabel = $riga ? $riga->periodo_label : $contratto->periodo_label;
+        $quantita = $quantita > 0 ? $quantita : 1;
+        $prezzoUnitario = round($prezzoUnitario ?? $importo, 2);
+        $labelRiga = $labelRiga ?: ($riga ? $riga->label : 'Canone contratto');
+        $periodoFattura = $riga?->periodoFatturazione($contratto->periodo);
+        $periodoLabel = $riga && $periodoFattura && $periodoFattura !== (string) $riga->periodo
+            ? (\App\Models\Prodotto::PERIODI[$periodoFattura] ?? $contratto->periodo_label)
+            : ($riga ? $riga->periodo_label : $contratto->periodo_label);
         $descrizione = $contratto->label.' — '.$labelRiga.' ('.$pDa->format('d/m/Y').' – '.$pA->format('d/m/Y').')';
         $cliente['rinnovi'][] = [
             'tipo' => 'canone',
         $cliente['voci'][] = [
             'tipo' => FatturaRiga::TIPO_CANONE,
             'descrizione' => $descrizione,
-            'quantita' => 1,
+            'quantita' => $quantita,
             'unita_misura' => $riga?->unita_misura ?: 'forfait',
-            'prezzo_unitario' => $importo,
+            'prezzo_unitario' => $prezzoUnitario,
             'importo' => $importo,
             'minuti' => null,
             'annotazione_id' => null,

resources/views/fatturazione/genera.blade.php

   L'ordine collegato a una segnalazione del periodo si fattura una volta, con le sue righe.
   Le scadenze sono segnalate ma non sommate (importo suggerito a parte).
   I rinnovi si fatturano solo se il ciclo si apre dal {{ Config::rinnoviDa()->format('d/m/Y') }} in poi: un annuale partito il 01/01/2026 non entra nel 2026, un mensile sì dalla rata di quel giorno.
+  Le ore seguono il periodo del contratto: 1 ora al mese dentro un annuale è una sola riga da 12 ore all'apertura dell'anno. Il monte di 1 ora al mese resta sulle segnalazioni.
   Il costo d'uscita ({{ Config::formatCosto(Config::costoUscitaDefault()) }}) si aggiunge se spuntato in registrazione tempo.
 </p>