fatture

.env.example

@@ -109,4 +109,9 @@ SKEBBY_PASSWORD=
 # SKEBBY_ACCESS_TOKEN=
 SKEBBY_SENDER=
 SKEBBY_MESSAGE_TYPE=GP
+
+# Fatture in Cloud API v2 (in alternativa: Configurazione > Fatture in Cloud)
+# Token manuale con scope entity.clients:r e entity.clients:a
+# FATTUREINCLOUD_COMPANY_ID=
+# FATTUREINCLOUD_ACCESS_TOKEN=
 # SKEBBY_BASE_URL=https://api.skebby.it/API/v1.0/REST

app/DataTables/AziendaDataTable.php

@@ -33,6 +33,14 @@ class AziendaDataTable extends DataTable
             ->addColumn('utenti_conta', function ($entity) {
                 return $entity->utenti()->soloUtenti()->count();
             })
+            ->addColumn('fic_label', function ($entity) {
+                if ($entity->ficCollegamento) {
+                    return '<span class="badge bg-label-success">Collegato</span>';
+                }
+
+                return '<span class="text-muted">—</span>';
+            })
+            ->rawColumns(['fic_label', 'action'])
             ->setRowId('id');
     }
 
@@ -41,7 +49,7 @@ class AziendaDataTable extends DataTable
      */
     public function query(Azienda $model): QueryBuilder
     {
-        return $model->newQuery();
+        return $model->newQuery()->with('ficCollegamento');
     }
 
     public function html(): HtmlBuilder
@@ -73,6 +81,7 @@ class AziendaDataTable extends DataTable
             Column::make('piva')->title('P. IVA')->responsivePriority(3),
             Column::make('email')->title('Email')->responsivePriority(2),
             Column::make('telefono')->title('Telefono'),
+            Column::computed('fic_label')->title('FiC')->searchable(false)->orderable(false),
             Column::make('utenti_conta')->title('Utenti')->attributes(['class' => 'text-center'])->searchable(false)->orderable(false),
             Column::computed('action')
                 ->exportable(false)

app/Http/Controllers/AziendaFicController.php

@@ -0,0 +1,256 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use App\Models\Azienda;
+use App\Models\Config;
+use App\Models\FicCollegamento;
+use App\Services\FattureInCloudClient;
+use Illuminate\Http\Request;
+use Illuminate\Routing\Controllers\HasMiddleware;
+use Illuminate\Routing\Controllers\Middleware;
+use Illuminate\Validation\ValidationException;
+use RuntimeException;
+
+class AziendaFicController extends Controller implements HasMiddleware
+{
+    public static function middleware(): array
+    {
+        return [
+            new Middleware('permission:edit-azienda'),
+        ];
+    }
+
+    public function show($id, FattureInCloudClient $fic)
+    {
+        $azienda = $this->azienda($id);
+        Config::syncDefinitions();
+
+        $payload = [
+            'configured' => $fic->configured(),
+            'azienda' => [
+                'id' => $azienda->id,
+                'label' => $azienda->full_name,
+            ],
+            'collegamento' => null,
+            'confronto' => null,
+            'message' => $fic->configured()
+                ? null
+                : 'Inserisci Company ID e access token in Configurazione → Fatture in Cloud. Il token deve avere gli scope entity.clients:r e entity.clients:a.',
+        ];
+
+        if ($fic->configured() && $azienda->ficCollegamento) {
+            try {
+                $client = $fic->getClient((int) $azienda->ficCollegamento->fic_client_id);
+                $payload['collegamento'] = [
+                    'id' => (int) $client['id'],
+                    'text' => $fic->clientLabel($client),
+                ];
+                $payload['confronto'] = $fic->confronto($azienda, $client);
+            } catch (RuntimeException $e) {
+                $payload['error'] = $e->getMessage();
+                $payload['collegamento'] = [
+                    'id' => (int) $azienda->ficCollegamento->fic_client_id,
+                    'text' => 'Cliente #'.$azienda->ficCollegamento->fic_client_id,
+                ];
+            }
+        }
+
+        return response()->json($payload);
+    }
+
+    public function clienti(Request $request, FattureInCloudClient $fic)
+    {
+        $request->validate([
+            'term' => 'nullable|string|max:100',
+            'q' => 'nullable|string|max:100',
+            'page' => 'nullable|integer|min:1',
+        ]);
+
+        try {
+            $term = (string) ($request->input('term') ?: $request->input('q') ?: '');
+            $found = $fic->searchClients($term, (int) $request->input('page', 1));
+        } catch (RuntimeException $e) {
+            return response()->json(['message' => $e->getMessage()], 422);
+        }
+
+        return response()->json([
+            'results' => $found['results'],
+            'pagination' => ['more' => $found['more']],
+        ]);
+    }
+
+    public function confronto($id, Request $request, FattureInCloudClient $fic)
+    {
+        $azienda = $this->azienda($id);
+        $validated = $request->validate([
+            'fic_client_id' => 'required|integer|min:1',
+        ]);
+
+        $this->assertClientFree((int) $validated['fic_client_id'], $azienda->id);
+
+        try {
+            $client = $fic->getClient((int) $validated['fic_client_id']);
+        } catch (RuntimeException $e) {
+            return response()->json(['message' => $e->getMessage()], 422);
+        }
+
+        return response()->json([
+            'fic_client_id' => (int) $client['id'],
+            'remote_label' => $fic->clientLabel($client),
+            'rows' => $fic->confronto($azienda, $client),
+        ]);
+    }
+
+    public function applica($id, Request $request, FattureInCloudClient $fic)
+    {
+        $azienda = $this->azienda($id);
+        $validated = $request->validate([
+            'crea' => 'nullable|boolean',
+            'fic_client_id' => 'required_without:crea|nullable|integer|min:1',
+            'scelte' => 'nullable|array',
+            'scelte.*' => 'in:local,remote',
+        ]);
+
+        try {
+            if ($request->boolean('crea')) {
+                $client = $this->creaRemoto($azienda, $fic);
+            } else {
+                $client = $this->allinea($azienda, $fic, (int) $validated['fic_client_id'], $validated['scelte'] ?? []);
+            }
+        } catch (ValidationException $e) {
+            throw $e;
+        } catch (RuntimeException $e) {
+            return response()->json(['message' => $e->getMessage()], 422);
+        }
+
+        return response()->json([
+            'success' => true,
+            'message' => $request->boolean('crea')
+                ? 'Cliente creato su Fatture in Cloud e collegato.'
+                : 'Anagrafica allineata.',
+            'fic_client_id' => (int) ($client['id'] ?? 0),
+            'remote_label' => $fic->clientLabel($client),
+        ]);
+    }
+
+    public function scollega($id)
+    {
+        $azienda = $this->azienda($id);
+        $azienda->ficCollegamento()?->delete();
+
+        return response()->json([
+            'success' => true,
+            'message' => 'Collegamento rimosso. Il cliente su Fatture in Cloud non è stato cancellato.',
+        ]);
+    }
+
+    /**
+     * @param  array<string, string>  $scelte
+     * @return array<string, mixed>
+     */
+    private function allinea(Azienda $azienda, FattureInCloudClient $fic, int $ficClientId, array $scelte): array
+    {
+        $this->assertClientFree($ficClientId, $azienda->id);
+        $client = $fic->getClient($ficClientId);
+        $rows = $fic->confronto($azienda, $client);
+        $remote = $fic->remoteValues($client);
+
+        $missing = [];
+        foreach ($rows as $row) {
+            if (! $row['equal'] && ! isset($scelte[$row['key']])) {
+                $missing[] = $row['label'];
+            }
+        }
+        if ($missing) {
+            throw ValidationException::withMessages([
+                'scelte' => 'Scegli quale valore tenere per: '.implode(', ', $missing).'.',
+            ]);
+        }
+
+        $pushLocal = [];
+        $errors = [];
+        foreach ($rows as $row) {
+            if ($row['equal']) {
+                continue;
+            }
+            if ($scelte[$row['key']] === 'local') {
+                $pushLocal[] = $row['key'];
+                continue;
+            }
+            $error = $fic->applyRemoteToAzienda($azienda, $row['key'], $remote[$row['key']]['raw']);
+            if ($error) {
+                $errors[$row['key']] = $error;
+            }
+        }
+        if ($errors) {
+            throw ValidationException::withMessages($errors);
+        }
+
+        $updated = $fic->updateClient($ficClientId, $fic->payloadFromLocal($azienda, $pushLocal));
+        $azienda->save();
+        $this->collega($azienda, (int) ($updated['id'] ?? $ficClientId));
+
+        return $updated;
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    private function creaRemoto(Azienda $azienda, FattureInCloudClient $fic): array
+    {
+        $local = $fic->localValues($azienda);
+        $name = trim((string) ($local['name']['raw']['value'] ?? ''));
+        if ($name === '') {
+            throw ValidationException::withMessages([
+                'name' => 'Serve una ragione sociale per creare il cliente su Fatture in Cloud.',
+            ]);
+        }
+
+        $data = array_filter(
+            $fic->payloadFromLocal($azienda),
+            static fn ($value) => $value !== null && $value !== ''
+        );
+        $data['type'] = 'company';
+        $data['name'] = $name;
+
+        $created = $fic->createClient($data);
+        $this->collega($azienda, (int) $created['id']);
+
+        return $created;
+    }
+
+    private function collega(Azienda $azienda, int $ficClientId): void
+    {
+        $this->assertClientFree($ficClientId, $azienda->id);
+        FicCollegamento::query()->updateOrCreate(
+            ['user_id' => $azienda->id],
+            ['fic_client_id' => $ficClientId]
+        );
+    }
+
+    private function assertClientFree(int $ficClientId, int $userId): void
+    {
+        $taken = FicCollegamento::query()
+            ->where('fic_client_id', $ficClientId)
+            ->where('user_id', '!=', $userId)
+            ->first();
+        if (! $taken) {
+            return;
+        }
+
+        $other = Azienda::query()->find($taken->user_id);
+        $label = $other?->full_name ?: ('#'.$taken->user_id);
+
+        throw ValidationException::withMessages([
+            'fic_client_id' => 'Questo cliente Fatture in Cloud è già collegato a '.$label.'.',
+        ]);
+    }
+
+    private function azienda($id): Azienda
+    {
+        return Azienda::query()
+            ->with(['comune.provincia', 'ficCollegamento'])
+            ->findOrFail($id);
+    }
+}

app/Http/Controllers/ConfigController.php

@@ -90,6 +90,10 @@ class ConfigController extends Controller implements HasMiddleware
           continue;
         }
 
+        if ($config->type === 'password' && trim((string) ($values[$key] ?? '')) === '') {
+          continue;
+        }
+
         $config->value = $this->normalizeValue($config->type, $values[$key] ?? null);
         $config->save();
       }

app/Http/Controllers/FatturazioneController.php

@@ -5,12 +5,15 @@ namespace App\Http\Controllers;
 use App\DataTables\FatturaDataTable;
 use App\Models\Config;
 use App\Models\Fattura;
+use App\Models\FatturaRiga;
 use App\Services\FatturazioneGeneraService;
 use Carbon\Carbon;
 use Illuminate\Http\Request;
 use Illuminate\Routing\Controllers\HasMiddleware;
 use Illuminate\Routing\Controllers\Middleware;
 use Illuminate\Support\Facades\Auth;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Validation\Rule;
 use RuntimeException;
 
 class FatturazioneController extends Controller implements HasMiddleware
@@ -31,7 +34,7 @@ class FatturazioneController extends Controller implements HasMiddleware
       new Middleware('permission:view-fatturazione', only: ['admin_index', 'admin_genera', 'admin_show']),
       new Middleware('permission:genera-fatturazione', only: ['admin_genera']),
       new Middleware('permission:create-fattura', only: ['admin_crea']),
-      new Middleware('permission:edit-fattura', only: ['admin_emetti', 'admin_annulla']),
+      new Middleware('permission:edit-fattura', only: ['admin_update', 'admin_emetti', 'admin_annulla']),
       new Middleware('permission:delete-fattura', only: ['admin_destroy']),
     ];
   }
@@ -90,11 +93,137 @@ class FatturazioneController extends Controller implements HasMiddleware
 
   public function admin_show($id)
   {
-    $fattura = Fattura::with(['user', 'createdBy', 'comune', 'righe'])->findOrFail($id);
+    $fattura = Fattura::with([
+      'user',
+      'createdBy',
+      'comune.provincia',
+      'righe' => fn ($q) => $q->orderBy('ordine')->orderBy('id'),
+    ])->findOrFail($id);
 
     return view('fatturazione.show', compact('fattura'));
   }
 
+  public function admin_update(Request $request, $id)
+  {
+    $fattura = Fattura::findOrFail($id);
+
+    $validated = $request->validate([
+      'numero' => 'nullable|integer|min:1',
+      'stato' => ['required', Rule::in(array_keys(Fattura::STATI))],
+      'data' => 'nullable|date',
+      'data_scadenza' => 'nullable|date',
+      'periodo_da' => 'nullable|date',
+      'periodo_a' => 'nullable|date',
+      'ragione_sociale' => 'nullable|string|max:255',
+      'piva' => 'nullable|string|max:255',
+      'cod_fiscale' => 'nullable|string|max:255',
+      'indirizzo' => 'nullable|string|max:255',
+      'email' => 'nullable|email|max:255',
+      'telefono' => 'nullable|string|max:255',
+      'comune_id' => 'nullable|exists:comune,id',
+      'note' => 'nullable|string',
+      'iva_percentuale' => 'nullable|numeric|min:0|max:100',
+      'imponibile' => 'nullable|numeric',
+      'iva' => 'nullable|numeric',
+      'totale' => 'nullable|numeric',
+      'righe' => 'nullable|array',
+      'righe.*.id' => 'nullable|integer',
+      'righe.*.tipo' => ['nullable', Rule::in(array_keys(FatturaRiga::TIPI))],
+      'righe.*.descrizione' => 'nullable|string|max:255',
+      'righe.*.quantita' => 'nullable|numeric',
+      'righe.*.unita_misura' => 'nullable|string|max:255',
+      'righe.*.prezzo_unitario' => 'nullable|numeric',
+      'righe.*.sconto' => 'nullable|numeric|min:0|max:100',
+      'righe.*.importo' => 'nullable|numeric',
+      'righe.*.minuti' => 'nullable|integer|min:0',
+      'righe.*.nota' => 'nullable|string',
+    ]);
+
+    DB::transaction(function () use ($fattura, $validated) {
+      $fattura->numero = $validated['numero'] ?? null;
+      $fattura->stato = $validated['stato'];
+      $fattura->data = $validated['data'] ?? null;
+      $fattura->data_scadenza = $validated['data_scadenza'] ?? null;
+      $fattura->periodo_da = $validated['periodo_da'] ?? null;
+      $fattura->periodo_a = $validated['periodo_a'] ?? null;
+      $fattura->ragione_sociale = $validated['ragione_sociale'] ?? null;
+      $fattura->piva = $validated['piva'] ?? null;
+      $fattura->cod_fiscale = $validated['cod_fiscale'] ?? null;
+      $fattura->indirizzo = $validated['indirizzo'] ?? null;
+      $fattura->email = $validated['email'] ?? null;
+      $fattura->telefono = $validated['telefono'] ?? null;
+      $fattura->comune_id = $validated['comune_id'] ?? null;
+      $fattura->note = $validated['note'] ?? null;
+      $fattura->iva_percentuale = $validated['iva_percentuale'] ?? null;
+      $fattura->imponibile = $validated['imponibile'] ?? null;
+      $fattura->iva = $validated['iva'] ?? null;
+      $fattura->totale = $validated['totale'] ?? null;
+      $fattura->save();
+
+      $keptIds = [];
+      $ordine = 0;
+      foreach ($validated['righe'] ?? [] as $row) {
+        $existing = null;
+        if (! empty($row['id'])) {
+          $existing = FatturaRiga::query()
+            ->where('fattura_id', $fattura->id)
+            ->where('id', $row['id'])
+            ->first();
+        }
+
+        $hasTesto = trim((string) ($row['descrizione'] ?? '')) !== ''
+          || trim((string) ($row['nota'] ?? '')) !== '';
+        $hasImporto = isset($row['importo']) && (float) $row['importo'] != 0.0;
+        $hasPrezzo = isset($row['prezzo_unitario']) && (float) $row['prezzo_unitario'] != 0.0;
+        $blank = ! $hasTesto && ! $hasImporto && ! $hasPrezzo;
+        if (! $existing && $blank) {
+          continue;
+        }
+
+        $qty = (float) ($row['quantita'] ?? 0);
+        $prezzo = (float) ($row['prezzo_unitario'] ?? 0);
+        $sconto = (float) ($row['sconto'] ?? 0);
+        $importo = $row['importo'] ?? null;
+        if ($importo === null || $importo === '') {
+          $importo = round($qty * $prezzo * (1 - min(100, max(0, $sconto)) / 100), 2);
+        }
+
+        $payload = [
+          'tipo' => $row['tipo'] ?: ($existing->tipo ?? FatturaRiga::TIPO_MANUALE),
+          'descrizione' => $row['descrizione'] ?? null,
+          'quantita' => $row['quantita'] ?? null,
+          'unita_misura' => $row['unita_misura'] ?? null,
+          'prezzo_unitario' => $row['prezzo_unitario'] ?? null,
+          'sconto' => $row['sconto'] ?? 0,
+          'iva_percentuale' => $fattura->iva_percentuale,
+          'importo' => $importo,
+          'minuti' => $row['minuti'] ?? null,
+          'nota' => $row['nota'] ?? null,
+          'ordine' => ++$ordine,
+        ];
+
+        if ($existing) {
+          $existing->fill($payload);
+          $existing->save();
+          $keptIds[] = $existing->id;
+        } else {
+          $created = FatturaRiga::create($payload + ['fattura_id' => $fattura->id]);
+          $keptIds[] = $created->id;
+        }
+      }
+
+      $delete = FatturaRiga::query()->where('fattura_id', $fattura->id);
+      if ($keptIds) {
+        $delete->whereNotIn('id', $keptIds);
+      }
+      $delete->delete();
+    });
+
+    return redirect()
+      ->route('admin.fatturazione.show', $fattura->id)
+      ->with('success', 'Fattura aggiornata.');
+  }
+
   public function admin_emetti($id)
   {
     $fattura = Fattura::findOrFail($id);

app/Models/Azienda.php

@@ -18,4 +18,9 @@ class Azienda extends User
             $model->is_gruppo = false;
         });
     }
+
+    public function ficCollegamento()
+    {
+        return $this->hasOne(FicCollegamento::class, 'user_id', 'id');
+    }
 }

app/Models/Config.php

@@ -30,6 +30,9 @@ class Config extends \App\Models\AbstractModels\AbstractConfig
   const FATTURAZIONE_COSTO_USCITA = 'FATTURAZIONE_COSTO_USCITA';
   const FATTURAZIONE_RINNOVI_DA = 'FATTURAZIONE_RINNOVI_DA';
 
+  const FIC_COMPANY_ID = 'FIC_COMPANY_ID';
+  const FIC_ACCESS_TOKEN = 'FIC_ACCESS_TOKEN';
+
   public static function getConfig(){
     $config = [];
 
@@ -72,6 +75,11 @@ class Config extends \App\Models\AbstractModels\AbstractConfig
       ['key' => self::FATTURAZIONE_RINNOVI_DA, 'value' => '2026-09-01', 'display_name' => 'Fattura i rinnovi a partire da', 'type' => 'date'],
     ];
 
+    $config['Fatture in Cloud'] = [
+      ['key' => self::FIC_COMPANY_ID, 'value' => null, 'display_name' => 'Company ID', 'type' => 'text'],
+      ['key' => self::FIC_ACCESS_TOKEN, 'value' => null, 'display_name' => 'Access token', 'type' => 'password'],
+    ];
+
     return $config;
   }
 

app/Models/FatturaRiga.php

@@ -6,6 +6,7 @@ class FatturaRiga extends \App\Models\AbstractModels\AbstractFatturaRiga
     public const TIPO_TEMPO = 'tempo';
     public const TIPO_EXTRA_CONTRATTO = 'extra_contratto';
     public const TIPO_EXTRA_ORDINE = 'extra_ordine';
+    public const TIPO_ORDINE = 'ordine';
     public const TIPO_SPESA = 'spesa';
     public const TIPO_USCITA = 'uscita';
     public const TIPO_CANONE = 'canone';
@@ -15,6 +16,7 @@ class FatturaRiga extends \App\Models\AbstractModels\AbstractFatturaRiga
         self::TIPO_TEMPO => 'Ore',
         self::TIPO_EXTRA_CONTRATTO => 'Ore extra contratto',
         self::TIPO_EXTRA_ORDINE => 'Ore extra ordine',
+        self::TIPO_ORDINE => 'Ordine',
         self::TIPO_SPESA => 'Spesa',
         self::TIPO_USCITA => 'Costo d\'uscita',
         self::TIPO_CANONE => 'Canone / rinnovo',

app/Models/FicCollegamento.php

@@ -0,0 +1,25 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Model;
+
+class FicCollegamento extends Model
+{
+    protected $table = 'fic_collegamento';
+
+    protected $fillable = [
+        'user_id',
+        'fic_client_id',
+    ];
+
+    protected $casts = [
+        'user_id' => 'integer',
+        'fic_client_id' => 'integer',
+    ];
+
+    public function user()
+    {
+        return $this->belongsTo(User::class, 'user_id', 'id');
+    }
+}

app/Services/FatturazioneGeneraService.php

@@ -30,6 +30,7 @@ class FatturazioneGeneraService
         $annotazioniGiaFatturate = $this->annotazioneIdsGiaFatturate();
 
         $clienti = [];
+        $ordiniCollegati = [];
         foreach ($annotazioni as $annotazione) {
             $segnalazione = $annotazione->segnalazione;
             if (! $segnalazione) {
@@ -46,6 +47,15 @@ class FatturazioneGeneraService
                 $clienti[$key] = $this->nuovoCliente($destinatario);
             }
 
+            $ordine = $segnalazione->ordineLavoro;
+            if ($ordine && $ordine->stato !== 'annullato' && ! isset($ordiniCollegati[$ordine->id])) {
+                $ordiniCollegati[$ordine->id] = [
+                    'key' => $key,
+                    'ordine' => $ordine,
+                    'segnalazione_id' => (int) $segnalazione->id,
+                ];
+            }
+
             $allocazione = $this->allocaAnnotazione($annotazione, $segnalazione, $pools, $tariffaDefault);
             if (in_array((int) $annotazione->id, $annotazioniGiaFatturate, true)) {
                 continue;
@@ -53,19 +63,26 @@ class FatturazioneGeneraService
             $this->accumulaTempo($clienti[$key], $segnalazione, $annotazione, $allocazione);
         }
 
+        $this->accumulaOrdini($clienti, $ordiniCollegati);
         $this->accumulaRinnovi($clienti, $from, $to, $privatiAziendaId);
 
         $clienti = collect($clienti)
-            ->filter(fn (array $c) => $c['totale'] > 0 || $c['minuti_totali'] > 0 || count($c['rinnovi']) > 0)
             ->map(function (array $c) {
                 $c['segnalazioni'] = collect($c['segnalazioni'])
+                    ->reject(fn (array $s) => $this->segnalazioneSoloCopertaDaContratto($s))
                     ->sortBy('numero')
                     ->values()
                     ->all();
+                $c['ordini'] = collect($c['ordini'])->values()->all();
                 $c['rinnovi'] = collect($c['rinnovi'])->values()->all();
 
                 return $c;
-            });
+            })
+            ->filter(fn (array $c) => $c['totale'] > 0
+                || $c['minuti_fatturare'] > 0
+                || count($c['segnalazioni']) > 0
+                || count($c['ordini']) > 0
+                || count($c['rinnovi']) > 0);
 
         $aziende = $clienti->filter(fn (array $c) => $c['tipo'] === 'azienda')
             ->sortBy('label', SORT_NATURAL | SORT_FLAG_CASE)
@@ -133,7 +150,7 @@ class FatturazioneGeneraService
                     'quantita' => $voce['quantita'],
                     'unita_misura' => $voce['unita_misura'],
                     'prezzo_unitario' => $voce['prezzo_unitario'],
-                    'sconto' => 0,
+                    'sconto' => $voce['sconto'] ?? 0,
                     'iva_percentuale' => $fattura->iva_percentuale,
                     'importo' => $voce['importo'],
                     'minuti' => $voce['minuti'],
@@ -303,12 +320,14 @@ class FatturazioneGeneraService
             'piva' => $destinatario['piva'],
             'cod_fiscale' => $destinatario['cod_fiscale'],
             'segnalazioni' => [],
+            'ordini' => [],
             'rinnovi' => [],
             'minuti_totali' => 0,
             'minuti_coperti' => 0,
             'minuti_fatturare' => 0,
             'importo_tempi' => 0.0,
             'importo_spese' => 0.0,
+            'importo_ordini' => 0.0,
             'importo_rinnovi' => 0.0,
             'totale' => 0.0,
             'ha_tariffa_mancante' => false,
@@ -603,7 +622,7 @@ class FatturazioneGeneraService
         $cliente['minuti_fatturare'] += $allocazione['minuti_fatturare'];
         $cliente['importo_tempi'] = round($cliente['importo_tempi'] + $allocazione['importo_tempo'], 2);
         $cliente['importo_spese'] = round($cliente['importo_spese'] + $allocazione['importo_spesa'] + $importoUscita, 2);
-        $cliente['totale'] = round($cliente['importo_tempi'] + $cliente['importo_spese'] + $cliente['importo_rinnovi'], 2);
+        $this->ricalcolaTotaleCliente($cliente);
         $cliente['ha_tariffa_mancante'] = $cliente['ha_tariffa_mancante'] || $allocazione['tariffa_mancante'];
     }
 
@@ -632,12 +651,12 @@ class FatturazioneGeneraService
             }
 
             foreach ($contratto->righe as $riga) {
+                $periodoKey = (string) ($riga->periodo ?: $contratto->periodo ?: 'una_tantum');
                 foreach ($this->dateOccorrenzeRigaNelPeriodo($contratto, $riga, $from, $to) as $occurrence) {
-                    if ($occurrence->copy()->startOfDay()->lt($rinnoviDa)) {
+                    [$pDa, $pA] = $this->finestraCiclo($periodoKey, $occurrence, $this->decorrenzaRiga($contratto, $riga));
+                    if ($this->cicloPrecedenteAllaSoglia($occurrence, $pDa, $rinnoviDa)) {
                         continue;
                     }
-                    $periodoKey = (string) ($riga->periodo ?: $contratto->periodo ?: 'una_tantum');
-                    [$pDa, $pA] = $this->finestraCiclo($periodoKey, $occurrence);
                     if ($this->canoneGiaFatturato($contratto->id, $riga->id, $pDa, $pA)) {
                         continue;
                     }
@@ -659,10 +678,10 @@ class FatturazioneGeneraService
                 ]);
                 $fake->setRelation('contrattoServizio', $contratto);
                 foreach ($this->dateOccorrenzeRigaNelPeriodo($contratto, $fake, $from, $to) as $occurrence) {
-                    if ($occurrence->copy()->startOfDay()->lt($rinnoviDa)) {
+                    [$pDa, $pA] = $this->finestraCiclo($periodo, $occurrence, $this->decorrenzaRiga($contratto, $fake));
+                    if ($this->cicloPrecedenteAllaSoglia($occurrence, $pDa, $rinnoviDa)) {
                         continue;
                     }
-                    [$pDa, $pA] = $this->finestraCiclo($periodo, $occurrence);
                     if ($this->canoneGiaFatturato($contratto->id, null, $pDa, $pA)) {
                         continue;
                     }
@@ -794,12 +813,51 @@ class FatturazioneGeneraService
         return $dates;
     }
 
+    protected function decorrenzaRiga(ContrattoServizio $contratto, ContrattoServizioRiga $riga): ?Carbon
+    {
+        if ($riga->data_inizio) {
+            return Carbon::parse($riga->data_inizio)->startOfDay();
+        }
+        if ($contratto->data_inizio) {
+            return Carbon::parse($contratto->data_inizio)->startOfDay();
+        }
+
+        return null;
+    }
+
+    /**
+     * Il ciclo non si fattura se è stato aperto prima della soglia
+     * (già gestito sulla piattaforma precedente).
+     */
+    protected function cicloPrecedenteAllaSoglia(Carbon $occurrence, Carbon $periodoDa, Carbon $soglia): bool
+    {
+        $soglia = $soglia->copy()->startOfDay();
+
+        return $occurrence->copy()->startOfDay()->lt($soglia)
+            || $periodoDa->copy()->startOfDay()->lt($soglia);
+    }
+
     /**
+     * Finestra del ciclo ancorata alla decorrenza del contratto.
+     * Un annuale partito il 01/01 resta 01/01–31/12 anche se la generazione cade dopo.
+     *
      * @return array{0: Carbon, 1: Carbon}
      */
-    protected function finestraCiclo(string $periodo, Carbon $occurrence): array
+    protected function finestraCiclo(string $periodo, Carbon $occurrence, ?Carbon $decorrenza = null): array
     {
         $d = $occurrence->copy()->startOfDay();
+        $step = match ($periodo) {
+            'mensile' => 1,
+            'trimestrale' => 3,
+            'semestrale' => 6,
+            'annuale' => 12,
+            default => 0,
+        };
+        if ($step > 0 && $decorrenza) {
+            $inizio = $this->inizioCiclo($decorrenza, $d, $step);
+
+            return [$inizio, $inizio->copy()->addMonthsNoOverflow($step)->subDay()->startOfDay()];
+        }
 
         return match ($periodo) {
             'mensile' => [$d->copy()->startOfMonth(), $d->copy()->endOfMonth()->startOfDay()],
@@ -812,6 +870,24 @@ class FatturazioneGeneraService
         };
     }
 
+    protected function inizioCiclo(Carbon $decorrenza, Carbon $data, int $stepMonths): Carbon
+    {
+        $inizio = $decorrenza->copy()->startOfDay();
+        $data = $data->copy()->startOfDay();
+        if ($inizio->gt($data) || $stepMonths < 1) {
+            return $inizio;
+        }
+
+        $mesi = (int) floor($inizio->floatDiffInMonths($data));
+        $steps = intdiv(max(0, $mesi), $stepMonths);
+        $inizio->addMonthsNoOverflow($steps * $stepMonths);
+        if ($inizio->gt($data)) {
+            $inizio->subMonthsNoOverflow($stepMonths);
+        }
+
+        return $inizio->startOfDay();
+    }
+
     protected function minutiContrattoPrima(int $contrattoId, ?Carbon $windowFrom, Carbon $billingFrom): int
     {
         $query = Annotazione::query()
@@ -937,6 +1013,7 @@ class FatturazioneGeneraService
     protected function totaliSezione(array $clienti): array
     {
         $importoRinnovi = 0.0;
+        $importoOrdini = 0.0;
         $importoTempi = 0.0;
         $importoSpese = 0.0;
         $minutiFatturare = 0;
@@ -945,6 +1022,7 @@ class FatturazioneGeneraService
 
         foreach ($clienti as $c) {
             $importoRinnovi += $c['importo_rinnovi'];
+            $importoOrdini += $c['importo_ordini'];
             $importoTempi += $c['importo_tempi'];
             $importoSpese += $c['importo_spese'];
             $minutiFatturare += $c['minuti_fatturare'];
@@ -960,8 +1038,9 @@ class FatturazioneGeneraService
             'clienti' => count($clienti),
             'importo_tempi' => round($importoTempi, 2),
             'importo_spese' => round($importoSpese, 2),
+            'importo_ordini' => round($importoOrdini, 2),
             'importo_rinnovi' => round($importoRinnovi, 2),
-            'totale' => round($importoTempi + $importoSpese + $importoRinnovi, 2),
+            'totale' => round($importoTempi + $importoSpese + $importoOrdini + $importoRinnovi, 2),
             'minuti_fatturare' => $minutiFatturare,
             'minuti_coperti' => $minutiCoperti,
             'scadenze' => $nScadenze,
@@ -1089,8 +1168,129 @@ class FatturazioneGeneraService
             'nota' => null,
         ];
         $cliente['importo_rinnovi'] = round($cliente['importo_rinnovi'] + $importo, 2);
+        $this->ricalcolaTotaleCliente($cliente);
+    }
+
+    /**
+     * Gli ordini collegati alle segnalazioni del periodo si fatturano una volta,
+     * con le righe commerciali dell'ordine (o delle offerte, se l'ordine non ne ha).
+     *
+     * @param  array<int, array{key: string, ordine: OrdineLavoro, segnalazione_id: int}>  $ordiniCollegati
+     */
+    protected function accumulaOrdini(array &$clienti, array $ordiniCollegati): void
+    {
+        foreach ($ordiniCollegati as $item) {
+            /** @var OrdineLavoro $ordine */
+            $ordine = $item['ordine'];
+            $key = $item['key'];
+            if (! isset($clienti[$key]) || $this->ordineGiaFatturato((int) $ordine->id)) {
+                continue;
+            }
+
+            $voci = [];
+            $righeVista = [];
+            foreach ($this->righeCommercialiOrdine($ordine) as $riga) {
+                $importo = $this->importoRigaCommerciale($riga);
+                if ($importo <= 0) {
+                    continue;
+                }
+                $desc = trim((string) ($riga->descrizione ?? ''));
+                $descrizione = $ordine->label.($desc !== '' ? ' — '.$desc : '');
+                if (mb_strlen($descrizione) > 255) {
+                    $descrizione = mb_substr($descrizione, 0, 252).'…';
+                }
+                $voci[] = [
+                    'tipo' => FatturaRiga::TIPO_ORDINE,
+                    'descrizione' => $descrizione,
+                    'quantita' => $riga->quantita ?? 1,
+                    'unita_misura' => $riga->unita_misura ?: 'forfait',
+                    'prezzo_unitario' => $riga->prezzo_unitario,
+                    'sconto' => $riga->sconto ?? 0,
+                    'importo' => $importo,
+                    'minuti' => null,
+                    'annotazione_id' => null,
+                    'segnalazione_id' => $item['segnalazione_id'],
+                    'contratto_servizio_id' => null,
+                    'contratto_servizio_riga_id' => null,
+                    'ordine_lavoro_id' => $ordine->id,
+                    'prodotto_id' => $riga->prodotto_id,
+                    'periodo_da' => null,
+                    'periodo_a' => null,
+                    'nota' => null,
+                ];
+                $righeVista[] = [
+                    'descrizione' => $desc !== '' ? $desc : $ordine->label,
+                    'importo' => $importo,
+                ];
+            }
+            if ($voci === []) {
+                continue;
+            }
+
+            $somma = 0.0;
+            foreach ($voci as $voce) {
+                $clienti[$key]['voci'][] = $voce;
+                $somma += (float) $voce['importo'];
+            }
+            $somma = round($somma, 2);
+            $clienti[$key]['ordini'][] = [
+                'id' => $ordine->id,
+                'label' => $ordine->label,
+                'segnalazione_id' => $item['segnalazione_id'],
+                'importo' => $somma,
+                'righe' => $righeVista,
+            ];
+            $clienti[$key]['importo_ordini'] = round($clienti[$key]['importo_ordini'] + $somma, 2);
+            $this->ricalcolaTotaleCliente($clienti[$key]);
+        }
+    }
+
+    protected function righeCommercialiOrdine(OrdineLavoro $ordine): Collection
+    {
+        $ordine->loadMissing(['righe', 'offerte.righe']);
+        $righe = $ordine->righe->isNotEmpty()
+            ? $ordine->righe
+            : $ordine->offerte->flatMap->righe;
+
+        return $righe->sortBy([['ordine', 'asc'], ['id', 'asc']])->values();
+    }
+
+    protected function importoRigaCommerciale(object $riga): float
+    {
+        $qty = (float) ($riga->quantita ?? 0);
+        $prezzo = (float) ($riga->prezzo_unitario ?? 0);
+        $sconto = (float) ($riga->sconto ?? 0);
+        $totale = $qty * $prezzo;
+        if ($sconto > 0) {
+            $totale -= $totale * $sconto / 100;
+        }
+
+        return round($totale, 2);
+    }
+
+    protected function ordineGiaFatturato(int $ordineId): bool
+    {
+        return FatturaRiga::query()
+            ->suFattureAttive()
+            ->where('tipo', FatturaRiga::TIPO_ORDINE)
+            ->where('ordine_lavoro_id', $ordineId)
+            ->exists();
+    }
+
+    /**
+     * Ticket interamente coperto dal contratto: nessuna ora, spesa o uscita da fatturare.
+     */
+    protected function segnalazioneSoloCopertaDaContratto(array $segnalazione): bool
+    {
+        return ($segnalazione['copertura'] ?? '') === 'contratto'
+            && (int) ($segnalazione['minuti_fatturare'] ?? 0) === 0
+            && (float) ($segnalazione['importo'] ?? 0) <= 0;
+    }
+
+    protected function ricalcolaTotaleCliente(array &$cliente): void
+    {
         $cliente['totale'] = round(
-            $cliente['importo_tempi'] + $cliente['importo_spese'] + $cliente['importo_rinnovi'],
+            $cliente['importo_tempi'] + $cliente['importo_spese'] + $cliente['importo_ordini'] + $cliente['importo_rinnovi'],
             2
         );
     }

app/Services/FattureInCloudClient.php

@@ -0,0 +1,411 @@
+<?php
+
+namespace App\Services;
+
+use App\Models\Azienda;
+use App\Models\Comune;
+use App\Models\Config;
+use Illuminate\Http\Client\Response;
+use Illuminate\Support\Facades\Http;
+use RuntimeException;
+
+class FattureInCloudClient
+{
+    public const FIELDS = [
+        'name' => 'Ragione sociale',
+        'vat_number' => 'P. IVA',
+        'tax_code' => 'Codice fiscale',
+        'email' => 'Email',
+        'phone' => 'Telefono',
+        'address_street' => 'Indirizzo',
+        'citta' => 'Città',
+        'notes' => 'Note',
+    ];
+
+    public function configured(): bool
+    {
+        return $this->companyId() !== null && $this->token() !== null;
+    }
+
+    public function companyId(): ?string
+    {
+        return $this->credential(Config::FIC_COMPANY_ID, 'services.fattureincloud.company_id');
+    }
+
+    public function token(): ?string
+    {
+        return $this->credential(Config::FIC_ACCESS_TOKEN, 'services.fattureincloud.access_token');
+    }
+
+    /**
+     * @return array{results: array<int, array{id: int, text: string}>, more: bool}
+     */
+    public function searchClients(string $term, int $page = 1): array
+    {
+        $params = [
+            'fieldset' => 'detailed',
+            'sort' => 'name',
+            'page' => max(1, $page),
+            'per_page' => 20,
+        ];
+        $term = trim(str_replace("'", '', $term));
+        if ($term !== '') {
+            $params['q'] = "(name like '%{$term}%' or vat_number like '%{$term}%' or tax_code like '%{$term}%')";
+        }
+
+        $json = $this->decode($this->http()->get($this->url('/entities/clients'), $params));
+        $results = [];
+        foreach ($json['data'] ?? [] as $client) {
+            if (! is_array($client) || empty($client['id'])) {
+                continue;
+            }
+            $results[] = [
+                'id' => (int) $client['id'],
+                'text' => $this->clientLabel($client),
+            ];
+        }
+
+        $current = (int) ($json['current_page'] ?? $page);
+        $last = (int) ($json['last_page'] ?? $current);
+
+        return [
+            'results' => $results,
+            'more' => $current < $last,
+        ];
+    }
+
+    public function getClient(int $id): array
+    {
+        $json = $this->decode($this->http()->get($this->url('/entities/clients/'.$id), [
+            'fieldset' => 'detailed',
+        ]));
+        $client = $json['data'] ?? null;
+        if (! is_array($client) || empty($client['id'])) {
+            throw new RuntimeException('Cliente Fatture in Cloud non trovato.');
+        }
+
+        return $client;
+    }
+
+    public function updateClient(int $id, array $data): array
+    {
+        if ($data === []) {
+            return $this->getClient($id);
+        }
+
+        $json = $this->decode($this->http()->put($this->url('/entities/clients/'.$id), [
+            'data' => $data,
+        ]));
+
+        return is_array($json['data'] ?? null) ? $json['data'] : $this->getClient($id);
+    }
+
+    public function createClient(array $data): array
+    {
+        $data['type'] = $data['type'] ?? 'company';
+        $json = $this->decode($this->http()->post($this->url('/entities/clients'), [
+            'data' => $data,
+        ]));
+        $client = $json['data'] ?? null;
+        if (! is_array($client) || empty($client['id'])) {
+            throw new RuntimeException('Fatture in Cloud non ha restituito il cliente creato.');
+        }
+
+        return $client;
+    }
+
+    public function clientLabel(array $client): string
+    {
+        $name = trim((string) ($client['name'] ?? ''));
+        $vat = trim((string) ($client['vat_number'] ?? ''));
+        if ($name === '') {
+            $name = 'Cliente #'.($client['id'] ?? '');
+        }
+
+        return $vat !== '' ? $name.' — P.IVA '.$vat : $name;
+    }
+
+    /**
+     * @return array<int, array{key: string, label: string, local: string, remote: string, equal: bool}>
+     */
+    public function confronto(Azienda $azienda, array $client): array
+    {
+        $local = $this->localValues($azienda);
+        $remote = $this->remoteValues($client);
+        $rows = [];
+        foreach (self::FIELDS as $key => $label) {
+            $rows[] = [
+                'key' => $key,
+                'label' => $label,
+                'local' => $local[$key]['display'],
+                'remote' => $remote[$key]['display'],
+                'equal' => $local[$key]['compare'] === $remote[$key]['compare'],
+            ];
+        }
+
+        return $rows;
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    public function payloadFromLocal(Azienda $azienda, ?array $onlyKeys = null): array
+    {
+        $local = $this->localValues($azienda);
+        $data = ['type' => 'company'];
+        foreach (array_keys(self::FIELDS) as $key) {
+            if ($onlyKeys !== null && ! in_array($key, $onlyKeys, true)) {
+                continue;
+            }
+            $data = array_merge($data, $this->remoteAttributes($key, $local[$key]['raw']));
+        }
+        unset($data['type']);
+
+        return $data;
+    }
+
+    /**
+     * @param  array<string, mixed>  $raw
+     * @return array<string, mixed>
+     */
+    public function remoteAttributes(string $key, array $raw): array
+    {
+        return match ($key) {
+            'citta' => [
+                'address_city' => $raw['city'] ?? '',
+                'address_province' => $raw['province'] ?? '',
+            ],
+            default => [$key => $raw['value'] ?? ''],
+        };
+    }
+
+    /**
+     * @return array<string, array{display: string, compare: string, raw: array<string, string>}>
+     */
+    public function localValues(Azienda $azienda): array
+    {
+        $azienda->loadMissing('comune.provincia');
+        $city = trim((string) ($azienda->comune?->nome ?? ''));
+        $province = strtoupper(trim((string) ($azienda->comune?->provincia?->sigla ?? '')));
+
+        return [
+            'name' => $this->pack(trim((string) ($azienda->ragione_sociale ?: $azienda->nome))),
+            'vat_number' => [
+                'display' => trim((string) $azienda->piva),
+                'compare' => $this->normalizeVat($azienda->piva),
+                'raw' => ['value' => $this->normalizeVat($azienda->piva)],
+            ],
+            'tax_code' => $this->pack(strtoupper(trim((string) $azienda->cod_fiscale))),
+            'email' => $this->pack(strtolower(trim((string) $azienda->email)), trim((string) $azienda->email)),
+            'phone' => $this->pack($this->normalizePhone($azienda->telefono), trim((string) $azienda->telefono)),
+            'address_street' => $this->pack(trim((string) $azienda->indirizzo)),
+            'citta' => [
+                'display' => $this->cittaLabel($city, $province),
+                'compare' => mb_strtolower($city).'|'.$province,
+                'raw' => ['city' => $city, 'province' => $province],
+            ],
+            'notes' => $this->pack(trim((string) $azienda->note)),
+        ];
+    }
+
+    /**
+     * @return array<string, array{display: string, compare: string, raw: array<string, string>}>
+     */
+    public function remoteValues(array $client): array
+    {
+        $city = trim((string) ($client['address_city'] ?? ''));
+        $province = strtoupper(trim((string) ($client['address_province'] ?? '')));
+
+        return [
+            'name' => $this->pack(trim((string) ($client['name'] ?? ''))),
+            'vat_number' => $this->pack($this->normalizeVat($client['vat_number'] ?? ''), trim((string) ($client['vat_number'] ?? ''))),
+            'tax_code' => $this->pack(strtoupper(trim((string) ($client['tax_code'] ?? '')))),
+            'email' => $this->pack(strtolower(trim((string) ($client['email'] ?? ''))), trim((string) ($client['email'] ?? ''))),
+            'phone' => $this->pack($this->normalizePhone($client['phone'] ?? ''), trim((string) ($client['phone'] ?? ''))),
+            'address_street' => $this->pack(trim((string) ($client['address_street'] ?? ''))),
+            'citta' => [
+                'display' => $this->cittaLabel($city, $province),
+                'compare' => mb_strtolower($city).'|'.$province,
+                'raw' => ['city' => $city, 'province' => $province],
+            ],
+            'notes' => $this->pack(trim((string) ($client['notes'] ?? ''))),
+        ];
+    }
+
+    public function applyRemoteToAzienda(Azienda $azienda, string $key, array $raw): ?string
+    {
+        $value = trim((string) ($raw['value'] ?? ''));
+
+        return match ($key) {
+            'name' => $this->applyName($azienda, $value),
+            'vat_number' => $this->applyString($azienda, 'piva', $value, 255),
+            'tax_code' => $this->applyString($azienda, 'cod_fiscale', strtoupper($value), 16),
+            'email' => $this->applyEmail($azienda, $value),
+            'phone' => $this->applyString($azienda, 'telefono', $value, 255),
+            'address_street' => $this->applyString($azienda, 'indirizzo', $value, 255),
+            'notes' => $this->applyNote($azienda, $value),
+            'citta' => $this->applyCitta($azienda, (string) ($raw['city'] ?? ''), (string) ($raw['province'] ?? '')),
+            default => null,
+        };
+    }
+
+    /**
+     * @param  array{display: string, compare: string, raw: array<string, string>}  $packed
+     */
+    private function pack(string $compare, ?string $display = null): array
+    {
+        return [
+            'display' => $display ?? $compare,
+            'compare' => $compare,
+            'raw' => ['value' => $display ?? $compare],
+        ];
+    }
+
+    private function applyName(Azienda $azienda, string $value): ?string
+    {
+        if ($value === '') {
+            return 'La ragione sociale remota è vuota.';
+        }
+        if (mb_strlen($value) > 255) {
+            return 'La ragione sociale supera i 255 caratteri.';
+        }
+        $previous = $azienda->ragione_sociale;
+        $azienda->ragione_sociale = $value;
+        if (! $azienda->nome || $azienda->nome === $previous) {
+            $azienda->nome = $value;
+        }
+
+        return null;
+    }
+
+    private function applyString(Azienda $azienda, string $attribute, string $value, int $max): ?string
+    {
+        if (mb_strlen($value) > $max) {
+            return 'Il valore supera i '.$max.' caratteri.';
+        }
+        $azienda->{$attribute} = $value !== '' ? $value : null;
+
+        return null;
+    }
+
+    private function applyEmail(Azienda $azienda, string $value): ?string
+    {
+        if ($value !== '' && ! filter_var($value, FILTER_VALIDATE_EMAIL)) {
+            return 'L\'email remota non è valida.';
+        }
+        $azienda->email = $value !== '' ? $value : null;
+
+        return null;
+    }
+
+    private function applyNote(Azienda $azienda, string $value): ?string
+    {
+        $azienda->note = $value !== '' ? $value : null;
+
+        return null;
+    }
+
+    private function applyCitta(Azienda $azienda, string $city, string $province): ?string
+    {
+        $city = trim($city);
+        $province = strtoupper(trim($province));
+        if ($city === '' && $province === '') {
+            $azienda->comune_id = null;
+
+            return null;
+        }
+        if ($city === '') {
+            return 'Fatture in Cloud non ha una città da copiare.';
+        }
+
+        $query = Comune::query()->whereRaw('LOWER(nome) = ?', [mb_strtolower($city)]);
+        if ($province !== '') {
+            $match = (clone $query)->whereHas('provincia', fn ($q) => $q->where('sigla', $province))->first();
+            if ($match) {
+                $azienda->comune_id = $match->id;
+
+                return null;
+            }
+        }
+        $match = $query->first();
+        if (! $match) {
+            $label = $this->cittaLabel($city, $province);
+
+            return 'Comune «'.$label.'» non trovato in anagrafica.';
+        }
+        $azienda->comune_id = $match->id;
+
+        return null;
+    }
+
+    private function cittaLabel(string $city, string $province): string
+    {
+        if ($city === '' && $province === '') {
+            return '';
+        }
+        if ($province === '') {
+            return $city;
+        }
+        if ($city === '') {
+            return $province;
+        }
+
+        return $city.' ('.$province.')';
+    }
+
+    private function normalizeVat(?string $value): string
+    {
+        $value = strtoupper(preg_replace('/\s+/', '', trim((string) $value)) ?? '');
+        if (str_starts_with($value, 'IT') && strlen($value) > 2) {
+            $value = substr($value, 2);
+        }
+
+        return $value;
+    }
+
+    private function normalizePhone(?string $value): string
+    {
+        return preg_replace('/\s+/', '', trim((string) $value)) ?? '';
+    }
+
+    private function credential(string $configKey, string $configPath): ?string
+    {
+        $fromConfig = trim((string) Config::valueOf($configKey, ''));
+        if ($fromConfig !== '') {
+            return $fromConfig;
+        }
+        $fromEnv = trim((string) config($configPath));
+
+        return $fromEnv !== '' ? $fromEnv : null;
+    }
+
+    private function url(string $path): string
+    {
+        return '/c/'.$this->companyId().$path;
+    }
+
+    private function http()
+    {
+        if (! $this->configured()) {
+            throw new RuntimeException('Collega Fatture in Cloud da Configurazione: servono Company ID e access token.');
+        }
+
+        return Http::baseUrl('https://api-v2.fattureincloud.it')
+            ->acceptJson()
+            ->withToken((string) $this->token())
+            ->timeout(25);
+    }
+
+    private function decode(Response $response): array
+    {
+        if ($response->successful()) {
+            return $response->json() ?? [];
+        }
+
+        $message = data_get($response->json(), 'error.message')
+            ?: data_get($response->json(), 'message')
+            ?: 'Fatture in Cloud ha risposto con errore '.$response->status().'.';
+
+        throw new RuntimeException((string) $message);
+    }
+}

config/services.php

@@ -73,6 +73,16 @@ return [
     | Auth: username/password (token) oppure user_key + access_token fissi
     | message_type: GP (alto), TI (medio), SI (basso)
     */
+    /*
+    | Fatture in Cloud API v2
+    | https://developers.fattureincloud.it/docs/getting-started/
+    | I valori salvati in Configurazione hanno la precedenza su queste variabili.
+    */
+    'fattureincloud' => [
+        'company_id' => env('FATTUREINCLOUD_COMPANY_ID'),
+        'access_token' => env('FATTUREINCLOUD_ACCESS_TOKEN'),
+    ],
+
     'skebby' => [
         'username' => env('SKEBBY_USERNAME'),
         'password' => env('SKEBBY_PASSWORD'),

database/migrations/2026_10_05_231800_create_fic_collegamento_table.php

@@ -0,0 +1,27 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    public function up(): void
+    {
+        Schema::create('fic_collegamento', function (Blueprint $table) {
+            $table->id();
+            $table->unsignedBigInteger('user_id');
+            $table->unsignedBigInteger('fic_client_id');
+            $table->timestamps();
+
+            $table->unique('user_id');
+            $table->unique('fic_client_id');
+            $table->foreign('user_id')->references('id')->on('users')->cascadeOnDelete();
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::dropIfExists('fic_collegamento');
+    }
+};

resources/views/azienda/fic-modal.blade.php

@@ -0,0 +1,49 @@
+<div class="modal fade" id="ficAziendaModal" tabindex="-1" aria-hidden="true">
+  <div class="modal-dialog modal-xl modal-dialog-centered modal-dialog-scrollable">
+    <div class="modal-content">
+      <div class="modal-header">
+        <div>
+          <h5 class="modal-title">Fatture in Cloud</h5>
+          <small class="text-muted" id="ficAziendaLabel"></small>
+        </div>
+        <button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Chiudi"></button>
+      </div>
+      <div class="modal-body">
+        <div class="alert alert-warning d-none" id="ficConfigAlert"></div>
+        <div class="alert alert-danger d-none" id="ficErrorAlert"></div>
+
+        <div id="ficSearchWrap">
+          <label class="form-label" for="ficClientSelect">Cliente su Fatture in Cloud</label>
+          <select id="ficClientSelect" class="form-select" data-placeholder="Cerca per nome, P. IVA o codice fiscale"></select>
+          <div class="form-text">Scegli il cliente remoto da confrontare con l'anagrafica locale.</div>
+        </div>
+
+        <div id="ficConfronto" class="d-none mt-4">
+          <div class="d-flex flex-wrap gap-2 mb-3">
+            <button type="button" class="btn btn-sm btn-label-secondary" id="ficKeepLocal">Tieni tutto il locale</button>
+            <button type="button" class="btn btn-sm btn-label-secondary" id="ficKeepRemote">Tieni tutto il remoto</button>
+          </div>
+          <div class="table-responsive">
+            <table class="table table-sm align-middle mb-0">
+              <thead>
+                <tr>
+                  <th>Campo</th>
+                  <th>Locale</th>
+                  <th>Fatture in Cloud</th>
+                  <th style="width: 220px;">Tieni</th>
+                </tr>
+              </thead>
+              <tbody id="ficConfrontoBody"></tbody>
+            </table>
+          </div>
+        </div>
+      </div>
+      <div class="modal-footer flex-wrap">
+        <button type="button" class="btn btn-label-danger d-none" id="ficUnlink">Scollega</button>
+        <button type="button" class="btn btn-label-secondary" data-bs-dismiss="modal">Chiudi</button>
+        <button type="button" class="btn btn-label-primary d-none" id="ficCreate">Crea su Fatture in Cloud</button>
+        <button type="button" class="btn btn-primary d-none" id="ficApply" disabled>Applica</button>
+      </div>
+    </div>
+  </div>
+</div>

resources/views/azienda/fic-scripts.blade.php

@@ -0,0 +1,312 @@
+<script type="module">
+$(function () {
+  const modalEl = document.getElementById('ficAziendaModal');
+  if (!modalEl || !window.bootstrap) {
+    return;
+  }
+
+  const modal = bootstrap.Modal.getOrCreateInstance(modalEl);
+  const $select = $('#ficClientSelect');
+  let aziendaId = null;
+  let linked = false;
+  let rows = [];
+
+  function showAlert(id, message) {
+    const el = document.getElementById(id);
+    if (!message) {
+      el.classList.add('d-none');
+      el.textContent = '';
+      return;
+    }
+    el.textContent = message;
+    el.classList.remove('d-none');
+  }
+
+  function escapeHtml(value) {
+    return String(value ?? '')
+      .replace(/&/g, '&amp;')
+      .replace(/</g, '&lt;')
+      .replace(/>/g, '&gt;')
+      .replace(/"/g, '&quot;');
+  }
+
+  function cell(value) {
+    const text = String(value ?? '').trim();
+    if (text === '') {
+      return '<span class="text-muted">—</span>';
+    }
+    return '<div style="white-space:pre-wrap">' + escapeHtml(text) + '</div>';
+  }
+
+  function selectedChoices() {
+    const scelte = {};
+    let pending = 0;
+    rows.forEach(function (row) {
+      if (row.equal) {
+        return;
+      }
+      const checked = document.querySelector('input[name="fic-scelta-' + row.key + '"]:checked');
+      if (!checked) {
+        pending++;
+        return;
+      }
+      scelte[row.key] = checked.value;
+    });
+    return { scelte, pending };
+  }
+
+  function refreshApply() {
+    const apply = document.getElementById('ficApply');
+    const hasClient = !!$select.val();
+    apply.classList.toggle('d-none', !hasClient);
+    document.getElementById('ficCreate').classList.toggle('d-none', hasClient || !aziendaId);
+    if (!hasClient) {
+      apply.disabled = true;
+      return;
+    }
+    apply.disabled = rows.length === 0 || selectedChoices().pending > 0;
+  }
+
+  function renderRows(nextRows) {
+    rows = nextRows || [];
+    const body = document.getElementById('ficConfrontoBody');
+    const wrap = document.getElementById('ficConfronto');
+    if (!rows.length) {
+      wrap.classList.add('d-none');
+      body.innerHTML = '';
+      refreshApply();
+      return;
+    }
+    body.innerHTML = rows.map(function (row) {
+      const choice = row.equal
+        ? '<span class="badge bg-label-success">Uguali</span>'
+        : '<div class="d-flex flex-column gap-1">'
+          + '<label class="form-check mb-0"><input class="form-check-input fic-choice" type="radio" name="fic-scelta-' + row.key + '" value="local"> <span class="form-check-label">Locale</span></label>'
+          + '<label class="form-check mb-0"><input class="form-check-input fic-choice" type="radio" name="fic-scelta-' + row.key + '" value="remote"> <span class="form-check-label">Remoto</span></label>'
+          + '</div>';
+      return '<tr class="' + (row.equal ? '' : 'table-warning') + '">'
+        + '<td class="fw-medium">' + escapeHtml(row.label) + '</td>'
+        + '<td>' + cell(row.local) + '</td>'
+        + '<td>' + cell(row.remote) + '</td>'
+        + '<td>' + choice + '</td>'
+        + '</tr>';
+    }).join('');
+    wrap.classList.remove('d-none');
+    refreshApply();
+  }
+
+  function setAll(side) {
+    document.querySelectorAll('#ficConfrontoBody input.fic-choice[value="' + side + '"]').forEach(function (input) {
+      input.checked = true;
+    });
+    refreshApply();
+  }
+
+  function loadConfronto(ficClientId) {
+    showAlert('ficErrorAlert', '');
+    renderRows([]);
+    $.get(@json(url('admin/azienda')) + '/' + aziendaId + '/fic/confronto', { fic_client_id: ficClientId })
+      .done(function (data) {
+        renderRows(data.rows || []);
+      })
+      .fail(function (xhr) {
+        showAlert('ficErrorAlert', (xhr.responseJSON && xhr.responseJSON.message) || 'Impossibile leggere il cliente remoto.');
+        refreshApply();
+      });
+  }
+
+  function initSelect() {
+    if ($select.hasClass('select2-hidden-accessible')) {
+      $select.select2('destroy');
+    }
+    $select.empty();
+    $select.select2({
+      dropdownParent: $('#ficAziendaModal'),
+      width: '100%',
+      allowClear: true,
+      placeholder: 'Cerca per nome, P. IVA o codice fiscale',
+      ajax: {
+        url: @json(route('admin.azienda.fic.clienti')),
+        dataType: 'json',
+        delay: 300,
+        data: function (params) {
+          return { term: params.term || '', page: params.page || 1 };
+        },
+        processResults: function (data) {
+          return {
+            results: data.results || [],
+            pagination: { more: !!(data.pagination && data.pagination.more) }
+          };
+        }
+      }
+    });
+  }
+
+  function openFor(id, label) {
+    aziendaId = id;
+    linked = false;
+    document.getElementById('ficAziendaLabel').textContent = label || '';
+    showAlert('ficConfigAlert', '');
+    showAlert('ficErrorAlert', '');
+    renderRows([]);
+    document.getElementById('ficUnlink').classList.add('d-none');
+    document.getElementById('ficSearchWrap').classList.remove('d-none');
+    initSelect();
+    modal.show();
+
+    $.get(@json(url('admin/azienda')) + '/' + id + '/fic')
+      .done(function (data) {
+        if (!data.configured) {
+          const el = document.getElementById('ficConfigAlert');
+          el.classList.remove('d-none');
+          el.innerHTML = 'Inserisci Company ID e access token nella <a href="' + @json(route('admin.config.index')) + '">configurazione</a>, scheda Fatture in Cloud. Il token va creato come da <a href="https://developers.fattureincloud.it/docs/getting-started/" target="_blank" rel="noopener">guida Fatture in Cloud</a> e deve avere gli scope <code>entity.clients:r</code> e <code>entity.clients:a</code>.';
+          document.getElementById('ficSearchWrap').classList.add('d-none');
+          document.getElementById('ficCreate').classList.add('d-none');
+          return;
+        }
+        document.getElementById('ficCreate').classList.remove('d-none');
+        if (data.error) {
+          showAlert('ficErrorAlert', data.error);
+        }
+        if (data.collegamento) {
+          linked = true;
+          document.getElementById('ficUnlink').classList.remove('d-none');
+          const option = new Option(data.collegamento.text, data.collegamento.id, true, true);
+          $select.append(option).trigger('change');
+        }
+        if (data.confronto) {
+          renderRows(data.confronto);
+        }
+      })
+      .fail(function () {
+        showAlert('ficErrorAlert', 'Impossibile aprire il confronto.');
+      });
+  }
+
+  $('#dataTable_azienda').on('click', '.js-fic-azienda', function (e) {
+    e.preventDefault();
+    openFor($(this).data('id'), $(this).data('label'));
+  });
+
+  $select.on('select2:select', function (e) {
+    loadConfronto(e.params.data.id);
+  });
+
+  $select.on('select2:clear', function () {
+    renderRows([]);
+    refreshApply();
+  });
+
+  document.getElementById('ficConfrontoBody').addEventListener('change', function (e) {
+    if (e.target.classList.contains('fic-choice')) {
+      refreshApply();
+    }
+  });
+  document.getElementById('ficKeepLocal').addEventListener('click', function () { setAll('local'); });
+  document.getElementById('ficKeepRemote').addEventListener('click', function () { setAll('remote'); });
+
+  document.getElementById('ficApply').addEventListener('click', function () {
+    const picked = selectedChoices();
+    if (picked.pending > 0 || !$select.val()) {
+      return;
+    }
+    const button = this;
+    button.disabled = true;
+    $.ajax({
+      url: @json(url('admin/azienda')) + '/' + aziendaId + '/fic',
+      method: 'POST',
+      data: {
+        _token: @json(csrf_token()),
+        fic_client_id: $select.val(),
+        scelte: picked.scelte
+      },
+      success: function (res) {
+        if (window.LaravelDataTables && window.LaravelDataTables['dataTable_azienda']) {
+          window.LaravelDataTables['dataTable_azienda'].ajax.reload(null, false);
+        }
+        if (typeof notyf !== 'undefined') {
+          notyf.success((res && res.message) || 'Anagrafica allineata.');
+        }
+        modal.hide();
+      },
+      error: function (xhr) {
+        const json = xhr.responseJSON || {};
+        const first = json.errors ? Object.values(json.errors).flat()[0] : null;
+        showAlert('ficErrorAlert', first || json.message || 'Impossibile applicare il confronto.');
+        button.disabled = false;
+      }
+    });
+  });
+
+  document.getElementById('ficCreate').addEventListener('click', function () {
+    Swal.fire({
+      title: 'Creare il cliente su Fatture in Cloud?',
+      text: 'Verrà creato un cliente azienda con i dati locali e collegato a questa anagrafica.',
+      icon: 'question',
+      showCancelButton: true,
+      confirmButtonText: 'Crea',
+      cancelButtonText: 'Annulla',
+      customClass: { confirmButton: 'btn btn-primary me-2', cancelButton: 'btn btn-label-secondary' },
+      buttonsStyling: false
+    }).then(function (result) {
+      if (!result.isConfirmed) {
+        return;
+      }
+      $.ajax({
+        url: @json(url('admin/azienda')) + '/' + aziendaId + '/fic',
+        method: 'POST',
+        data: { _token: @json(csrf_token()), crea: 1 },
+        success: function (res) {
+          if (window.LaravelDataTables && window.LaravelDataTables['dataTable_azienda']) {
+            window.LaravelDataTables['dataTable_azienda'].ajax.reload(null, false);
+          }
+          if (typeof notyf !== 'undefined') {
+            notyf.success((res && res.message) || 'Cliente creato.');
+          }
+          modal.hide();
+        },
+        error: function (xhr) {
+          const json = xhr.responseJSON || {};
+          const first = json.errors ? Object.values(json.errors).flat()[0] : null;
+          showAlert('ficErrorAlert', first || json.message || 'Impossibile creare il cliente.');
+        }
+      });
+    });
+  });
+
+  document.getElementById('ficUnlink').addEventListener('click', function () {
+    Swal.fire({
+      title: 'Scollegare il cliente?',
+      text: 'Il cliente su Fatture in Cloud resta dov\'è. Si toglie solo il collegamento.',
+      icon: 'warning',
+      showCancelButton: true,
+      confirmButtonText: 'Scollega',
+      cancelButtonText: 'Annulla',
+      customClass: { confirmButton: 'btn btn-danger me-2', cancelButton: 'btn btn-label-secondary' },
+      buttonsStyling: false
+    }).then(function (result) {
+      if (!result.isConfirmed) {
+        return;
+      }
+      $.ajax({
+        url: @json(url('admin/azienda')) + '/' + aziendaId + '/fic',
+        method: 'DELETE',
+        data: { _token: @json(csrf_token()) },
+        success: function (res) {
+          linked = false;
+          if (window.LaravelDataTables && window.LaravelDataTables['dataTable_azienda']) {
+            window.LaravelDataTables['dataTable_azienda'].ajax.reload(null, false);
+          }
+          if (typeof notyf !== 'undefined') {
+            notyf.success((res && res.message) || 'Collegamento rimosso.');
+          }
+          modal.hide();
+        },
+        error: function (xhr) {
+          showAlert('ficErrorAlert', (xhr.responseJSON && xhr.responseJSON.message) || 'Impossibile scollegare.');
+        }
+      });
+    });
+  });
+});
+</script>

resources/views/azienda/index.blade.php

@@ -49,6 +49,7 @@ $configData = Helper::appClasses();
 </div>
 
 @include('azienda.modal')
+@include('azienda.fic-modal')
 @endsection
 
 @section('page-script')
@@ -57,6 +58,7 @@ $configData = Helper::appClasses();
   window.aziendaModalReloadDataTable = 'dataTable_azienda';
 </script>
 @include('azienda.modal-scripts')
+@include('azienda.fic-scripts')
 <script type="module">
   $(document).ready(function () {
     const $table = $('#dataTable_azienda');

resources/views/azienda/menu.blade.php

@@ -15,6 +15,11 @@ use Illuminate\Support\Facades\Auth;
     </li>
     @endif
     @if(Auth::user()->can('edit-azienda'))
+    <li>
+      <a href="#" class="dropdown-item js-fic-azienda" data-id="{{ $entity->id }}" data-label="{{ $entity->full_name }}">
+        <i class="bx bx-cloud me-1"></i> Fatture in Cloud
+      </a>
+    </li>
     <li>
       <a href="#" class="dropdown-item js-edit-azienda" data-id="{{ $entity->id }}">
         <i class="bx bx-edit-alt me-1"></i> Modifica

resources/views/config/index.blade.php

@@ -5,6 +5,8 @@ $tabIcons = [
   'Segnalazioni' => 'bx-flag',
   'Documenti PDF' => 'bx-file',
   'Acquisto servizio' => 'bx-cart',
+  'Fatturazione' => 'bx-receipt',
+  'Fatture in Cloud' => 'bx-cloud',
 ];
 $groupKeys = array_keys($groups);
 @endphp
@@ -122,7 +124,7 @@ $groupKeys = array_keys($groups);
               @case('date')
               <input type="date" class="form-control" name="value[{{ $config->key }}]" id="{{ $fid }}-control" value="{{ $config->value }}" {{ $disabled }}>
               @if($config->key === Config::FATTURAZIONE_RINNOVI_DA)
-              <div class="form-text">I canoni con data di rinnovo precedente non vengono fatturati (già gestiti sulla piattaforma precedente).</div>
+              <div class="form-text">Non si fatturano i cicli aperti prima di questa data (già gestiti sulla piattaforma precedente). Un canone mensile partito prima entra dalla prima rata che inizia in questo giorno o dopo.</div>
               @endif
               @break
 
@@ -181,8 +183,18 @@ $groupKeys = array_keys($groups);
               </div>
               @break
 
+              @case('password')
+              <input type="password" class="form-control" name="value[{{ $config->key }}]" id="{{ $fid }}-control" value="" autocomplete="new-password" placeholder="{{ $config->value ? 'Token già salvato' : '' }}" {{ $disabled }}>
+              @if($config->key === Config::FIC_ACCESS_TOKEN)
+              <div class="form-text">Token manuale di <a href="https://developers.fattureincloud.it/docs/getting-started/" target="_blank" rel="noopener">Fatture in Cloud</a> con scope <code>entity.clients:r</code> e <code>entity.clients:a</code>. Lascia vuoto per non sostituirlo.</div>
+              @endif
+              @break
+
               @default
               <input type="text" class="form-control" name="value[{{ $config->key }}]" id="{{ $fid }}-control" value="{{ $config->value }}" {{ $disabled }}>
+              @if($config->key === Config::FIC_COMPANY_ID)
+              <div class="form-text">Identificativo azienda su Fatture in Cloud. Si legge anche da Impostazioni → API, oppure con il metodo List User Companies.</div>
+              @endif
             @endswitch
           </div>
           @empty

resources/views/fatturazione/genera.blade.php

@@ -66,7 +66,7 @@
       <div class="card-body">
         <span class="badge bg-label-primary mb-2">Totale da fatturare</span>
         <h4 class="mb-0">{{ Config::formatCosto($totali['totale']) }}</h4>
-        <p class="text-muted mb-0 small">Tempi, spese e canoni</p>
+        <p class="text-muted mb-0 small">Tempi, spese, ordini e canoni</p>
       </div>
     </div>
   </div>
@@ -102,8 +102,10 @@
 <p class="text-muted small mb-4">
   Tariffa default {{ number_format($esito['tariffa_default'], 2, ',', '.') }} €/ora.
   Le ore coperte da contratto o ordine non entrano nel totale; extra e ticket liberi sì.
+  Una segnalazione coperta dal contratto, senza ore né spese da fatturare, non compare in elenco.
+  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 dal {{ Config::rinnoviDa()->format('d/m/Y') }} in poi.
+  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.
   Il costo d'uscita ({{ Config::formatCosto(Config::costoUscitaDefault()) }}) si aggiunge se spuntato in registrazione tempo.
 </p>
 

resources/views/fatturazione/partials/cliente.blade.php

@@ -37,14 +37,14 @@
       @endif
       @endcan
       <div class="row g-3 mb-4">
-        <div class="col-sm-4">
+        <div class="col-sm-6 col-xl-3">
           <div class="border rounded p-3 h-100">
             <div class="text-muted small">Ore da fatturare</div>
             <div class="fw-semibold">{{ Config::formatTempo($cliente['minuti_fatturare']) }}</div>
             <div class="text-muted small">Coperte: {{ Config::formatTempo($cliente['minuti_coperti']) }}</div>
           </div>
         </div>
-        <div class="col-sm-4">
+        <div class="col-sm-6 col-xl-3">
           <div class="border rounded p-3 h-100">
             <div class="text-muted small">Tempi + spese</div>
             <div class="fw-semibold">{{ Config::formatCosto($cliente['importo_tempi'] + $cliente['importo_spese']) }}</div>
@@ -53,7 +53,13 @@
             @endif
           </div>
         </div>
-        <div class="col-sm-4">
+        <div class="col-sm-6 col-xl-3">
+          <div class="border rounded p-3 h-100">
+            <div class="text-muted small">Ordini</div>
+            <div class="fw-semibold">{{ Config::formatCosto($cliente['importo_ordini'] ?? 0) }}</div>
+          </div>
+        </div>
+        <div class="col-sm-6 col-xl-3">
           <div class="border rounded p-3 h-100">
             <div class="text-muted small">Canoni / rinnovi</div>
             <div class="fw-semibold">{{ Config::formatCosto($cliente['importo_rinnovi']) }}</div>
@@ -128,6 +134,33 @@
       </div>
       @endif
 
+      @if(count($cliente['ordini'] ?? []) > 0)
+      <h6 class="mb-2">Ordini collegati</h6>
+      <div class="table-responsive mb-4">
+        <table class="table table-sm align-middle mb-0">
+          <thead>
+            <tr>
+              <th>Ordine</th>
+              <th class="text-end">Importo</th>
+            </tr>
+          </thead>
+          <tbody>
+            @foreach($cliente['ordini'] as $ordine)
+            <tr>
+              <td>
+                <a href="{{ route('admin.ordine_lavoro.show', $ordine['id']) }}">{{ $ordine['label'] }}</a>
+                @foreach($ordine['righe'] as $rigaOrdine)
+                <div class="text-muted small">{{ $rigaOrdine['descrizione'] }} · {{ Config::formatCosto($rigaOrdine['importo']) }}</div>
+                @endforeach
+              </td>
+              <td class="text-end">{{ Config::formatCosto($ordine['importo']) }}</td>
+            </tr>
+            @endforeach
+          </tbody>
+        </table>
+      </div>
+      @endif
+
       @if(count($cliente['rinnovi']) > 0)
       <h6 class="mb-2">Rinnovi e scadenze</h6>
       <div class="table-responsive">
@@ -180,7 +213,7 @@
       </div>
       @endif
 
-      @if(count($cliente['segnalazioni'] ?? []) === 0 && count($cliente['rinnovi'] ?? []) === 0)
+      @if(count($cliente['segnalazioni'] ?? []) === 0 && count($cliente['ordini'] ?? []) === 0 && count($cliente['rinnovi'] ?? []) === 0)
       <p class="text-muted mb-0">Nessuna voce nel periodo.</p>
       @endif
     </div>

resources/views/fatturazione/show.blade.php

@@ -10,12 +10,27 @@
 @endsection
 
 @section('content')
+@php
+  $dataInput = function ($value) {
+    return $value ? \Carbon\Carbon::parse($value)->format('Y-m-d') : '';
+  };
+  $numInput = function ($value) {
+    if ($value === null || $value === '') {
+      return '';
+    }
+    return rtrim(rtrim(number_format((float) $value, 2, '.', ''), '0'), '.');
+  };
+@endphp
+
 <div class="d-flex flex-wrap align-items-center gap-2 mb-4 pb-3 border-bottom">
   @can('edit-fattura')
+  <button type="submit" class="btn btn-primary btn-sm" form="formFattura">
+    <i class="bx bx-save me-1"></i>Salva
+  </button>
   @if($fattura->isBozza())
   <form method="POST" action="{{ route('admin.fatturazione.emetti', $fattura->id) }}" class="d-inline">
     @csrf
-    <button type="submit" class="btn btn-primary btn-sm">
+    <button type="submit" class="btn btn-label-primary btn-sm">
       <i class="bx bx-check me-1"></i>Emetti
     </button>
   </form>
@@ -57,7 +72,253 @@
 @if(session('error'))
 <div class="alert alert-danger">{{ session('error') }}</div>
 @endif
+@if($errors->any())
+<div class="alert alert-danger">
+  <div class="fw-semibold mb-1">Controlla i dati inseriti.</div>
+  <ul class="mb-0">
+    @foreach($errors->all() as $error)
+    <li>{{ $error }}</li>
+    @endforeach
+  </ul>
+</div>
+@endif
+
+@can('edit-fattura')
+@php
+  $righeForm = old('righe');
+  if ($righeForm === null) {
+    $righeForm = $fattura->righe->map(fn ($r) => [
+      'id' => $r->id,
+      'tipo' => $r->tipo,
+      'descrizione' => $r->descrizione,
+      'quantita' => $r->quantita,
+      'unita_misura' => $r->unita_misura,
+      'prezzo_unitario' => $r->prezzo_unitario,
+      'sconto' => $r->sconto,
+      'importo' => $r->importo,
+      'minuti' => $r->minuti,
+      'nota' => $r->nota,
+      'segnalazione_id' => $r->segnalazione_id,
+      'contratto_servizio_id' => $r->contratto_servizio_id,
+      'ordine_lavoro_id' => $r->ordine_lavoro_id,
+    ])->all();
+  }
+  $comuneId = old('comune_id', $fattura->comune_id);
+  $comune = $fattura->comune;
+  if ($comuneId && (string) $comuneId !== (string) $fattura->comune_id) {
+    $comune = \App\Models\Comune::with('provincia')->find($comuneId);
+  }
+@endphp
+<form method="POST" action="{{ route('admin.fatturazione.update', $fattura->id) }}" id="formFattura">
+  @csrf
+  @method('PUT')
+
+  <div class="card mb-4">
+    <div class="card-header"><h5 class="mb-0">Dati fattura</h5></div>
+    <div class="card-body">
+      <div class="row g-3">
+        <div class="col-md-2">
+          <label class="form-label" for="numero">Numero</label>
+          <input type="number" min="1" step="1" name="numero" id="numero" class="form-control" value="{{ old('numero', $fattura->numero) }}">
+          <div class="form-text">In testata compare come numero/anno della data.</div>
+        </div>
+        <div class="col-md-2">
+          <label class="form-label" for="stato">Stato</label>
+          <select name="stato" id="stato" class="form-select">
+            @foreach(\App\Models\Fattura::STATI as $val => $label)
+            <option value="{{ $val }}" @selected(old('stato', $fattura->stato) === $val)>{{ $label }}</option>
+            @endforeach
+          </select>
+        </div>
+        <div class="col-md-2">
+          <label class="form-label" for="data">Data</label>
+          <input type="date" name="data" id="data" class="form-control" value="{{ old('data', $dataInput($fattura->data)) }}">
+        </div>
+        <div class="col-md-2">
+          <label class="form-label" for="data_scadenza">Scadenza</label>
+          <input type="date" name="data_scadenza" id="data_scadenza" class="form-control" value="{{ old('data_scadenza', $dataInput($fattura->data_scadenza)) }}">
+        </div>
+        <div class="col-md-2">
+          <label class="form-label" for="periodo_da">Periodo da</label>
+          <input type="date" name="periodo_da" id="periodo_da" class="form-control" value="{{ old('periodo_da', $dataInput($fattura->periodo_da)) }}">
+        </div>
+        <div class="col-md-2">
+          <label class="form-label" for="periodo_a">Periodo a</label>
+          <input type="date" name="periodo_a" id="periodo_a" class="form-control" value="{{ old('periodo_a', $dataInput($fattura->periodo_a)) }}">
+        </div>
+
+        <div class="col-md-6">
+          <label class="form-label" for="ragione_sociale">Ragione sociale / cliente</label>
+          <input type="text" name="ragione_sociale" id="ragione_sociale" class="form-control" value="{{ old('ragione_sociale', $fattura->ragione_sociale) }}">
+        </div>
+        <div class="col-md-3">
+          <label class="form-label" for="piva">P. IVA</label>
+          <input type="text" name="piva" id="piva" class="form-control" value="{{ old('piva', $fattura->piva) }}">
+        </div>
+        <div class="col-md-3">
+          <label class="form-label" for="cod_fiscale">Codice fiscale</label>
+          <input type="text" name="cod_fiscale" id="cod_fiscale" class="form-control" value="{{ old('cod_fiscale', $fattura->cod_fiscale) }}">
+        </div>
+        <div class="col-md-6">
+          <label class="form-label" for="indirizzo">Indirizzo</label>
+          <input type="text" name="indirizzo" id="indirizzo" class="form-control" value="{{ old('indirizzo', $fattura->indirizzo) }}">
+        </div>
+        <div class="col-md-6">
+          <label class="form-label" for="comune_id">Comune</label>
+          <select name="comune_id" id="comune_id" class="form-select select2-comune" data-placeholder="Cerca comune">
+            @if($comune)
+            <option value="{{ $comune->id }}" selected>{{ $comune->nome }}@if($comune->provincia) ({{ $comune->provincia->sigla }})@endif</option>
+            @endif
+          </select>
+        </div>
+        <div class="col-md-4">
+          <label class="form-label" for="email">Email</label>
+          <input type="email" name="email" id="email" class="form-control" value="{{ old('email', $fattura->email) }}">
+        </div>
+        <div class="col-md-4">
+          <label class="form-label" for="telefono">Telefono</label>
+          <input type="text" name="telefono" id="telefono" class="form-control" value="{{ old('telefono', $fattura->telefono) }}">
+        </div>
+        <div class="col-md-4">
+          <label class="form-label" for="iva_percentuale">IVA %</label>
+          <input type="number" step="0.01" min="0" max="100" name="iva_percentuale" id="iva_percentuale" class="form-control" value="{{ old('iva_percentuale', $numInput($fattura->iva_percentuale)) }}">
+        </div>
+        <div class="col-12">
+          <label class="form-label" for="note">Note</label>
+          <textarea name="note" id="note" class="form-control" rows="2">{{ old('note', $fattura->note) }}</textarea>
+        </div>
+      </div>
+    </div>
+  </div>
+
+  <div class="card mb-4">
+    <div class="card-header d-flex justify-content-between align-items-center">
+      <h5 class="mb-0">Voci</h5>
+      <button type="button" class="btn btn-sm btn-outline-primary" id="addRiga">
+        <i class="bx bx-plus me-1"></i>Voce
+      </button>
+    </div>
+    <div class="table-responsive">
+      <table class="table mb-0" id="righeTable">
+        <thead>
+          <tr>
+            <th style="width: 160px;">Tipo</th>
+            <th>Descrizione</th>
+            <th style="width: 90px;">Qty</th>
+            <th style="width: 120px;">U.M.</th>
+            <th style="width: 110px;">Prezzo</th>
+            <th style="width: 90px;">Sconto %</th>
+            <th style="width: 120px;" class="text-end">Importo</th>
+            <th style="width: 48px;"></th>
+          </tr>
+        </thead>
+        <tbody>
+          @foreach($righeForm as $i => $riga)
+          <tr class="riga-row">
+            <td>
+              <input type="hidden" name="righe[{{ $i }}][id]" value="{{ $riga['id'] ?? '' }}">
+              <select name="righe[{{ $i }}][tipo]" class="form-select form-select-sm">
+                @foreach(\App\Models\FatturaRiga::TIPI as $val => $label)
+                <option value="{{ $val }}" @selected(($riga['tipo'] ?? '') === $val)>{{ $label }}</option>
+                @endforeach
+              </select>
+              <input type="number" min="0" step="1" name="righe[{{ $i }}][minuti]" class="form-control form-control-sm mt-1" value="{{ $riga['minuti'] ?? '' }}" placeholder="Minuti">
+            </td>
+            <td>
+              <input type="text" name="righe[{{ $i }}][descrizione]" class="form-control form-control-sm" value="{{ $riga['descrizione'] ?? '' }}" placeholder="Descrizione">
+              <textarea name="righe[{{ $i }}][nota]" class="form-control form-control-sm mt-1" rows="1" placeholder="Nota">{{ $riga['nota'] ?? '' }}</textarea>
+              @if(!empty($riga['segnalazione_id']))
+              <div class="small mt-1"><a href="{{ route('admin.segnalazione.show', $riga['segnalazione_id']) }}">Apri ticket</a></div>
+              @endif
+              @if(!empty($riga['contratto_servizio_id']))
+              <div class="small"><a href="{{ route('admin.contratto_servizio.show', $riga['contratto_servizio_id']) }}">Apri contratto</a></div>
+              @endif
+              @if(!empty($riga['ordine_lavoro_id']))
+              <div class="small"><a href="{{ route('admin.ordine_lavoro.show', $riga['ordine_lavoro_id']) }}">Apri ordine</a></div>
+              @endif
+            </td>
+            <td><input type="number" step="0.01" name="righe[{{ $i }}][quantita]" class="form-control form-control-sm qty-input" value="{{ $numInput($riga['quantita'] ?? null) }}"></td>
+            <td>
+              <select name="righe[{{ $i }}][unita_misura]" class="form-select form-select-sm">
+                <option value="">—</option>
+                @foreach(\App\Models\Prodotto::UNITA_MISURA as $val => $label)
+                <option value="{{ $val }}" @selected((string) ($riga['unita_misura'] ?? '') === (string) $val)>{{ $label }}</option>
+                @endforeach
+                @if(!empty($riga['unita_misura']) && !isset(\App\Models\Prodotto::UNITA_MISURA[$riga['unita_misura']]))
+                <option value="{{ $riga['unita_misura'] }}" selected>{{ $riga['unita_misura'] }}</option>
+                @endif
+              </select>
+            </td>
+            <td><input type="number" step="0.01" name="righe[{{ $i }}][prezzo_unitario]" class="form-control form-control-sm prezzo-input" value="{{ $numInput($riga['prezzo_unitario'] ?? null) }}"></td>
+            <td><input type="number" step="0.01" min="0" max="100" name="righe[{{ $i }}][sconto]" class="form-control form-control-sm sconto-input" value="{{ $numInput($riga['sconto'] ?? null) }}"></td>
+            <td><input type="number" step="0.01" name="righe[{{ $i }}][importo]" class="form-control form-control-sm text-end importo-input" value="{{ $numInput($riga['importo'] ?? null) }}"></td>
+            <td class="text-end"><button type="button" class="btn btn-sm btn-icon text-danger remove-riga" title="Elimina voce"><i class="bx bx-trash"></i></button></td>
+          </tr>
+          @endforeach
+        </tbody>
+        <tfoot>
+          <tr>
+            <th colspan="6" class="text-end align-middle">Imponibile</th>
+            <th>
+              <input type="number" step="0.01" name="imponibile" id="imponibile" class="form-control form-control-sm text-end totale-input" value="{{ old('imponibile', $numInput($fattura->imponibile)) }}">
+            </th>
+            <th></th>
+          </tr>
+          <tr>
+            <th colspan="6" class="text-end align-middle">IVA</th>
+            <th>
+              <input type="number" step="0.01" name="iva" id="iva" class="form-control form-control-sm text-end totale-input" value="{{ old('iva', $numInput($fattura->iva)) }}">
+            </th>
+            <th></th>
+          </tr>
+          <tr>
+            <th colspan="6" class="text-end align-middle">Totale</th>
+            <th>
+              <input type="number" step="0.01" name="totale" id="totale" class="form-control form-control-sm text-end fw-semibold totale-input" value="{{ old('totale', $numInput($fattura->totale)) }}">
+            </th>
+            <th></th>
+          </tr>
+        </tfoot>
+      </table>
+    </div>
+    <div class="card-footer d-flex justify-content-between align-items-center flex-wrap gap-2">
+      <span class="text-muted small">Quantità, prezzo e sconto aggiornano l'importo della voce. Puoi comunque correggere importo, imponibile, IVA e totale prima di salvare.</span>
+      <button type="button" class="btn btn-sm btn-label-secondary" id="ricalcolaTotali">Ricalcola</button>
+    </div>
+  </div>
+</form>
 
+<template id="riga-template">
+  <tr class="riga-row">
+    <td>
+      <input type="hidden" name="righe[__IDX__][id]" value="">
+      <select name="righe[__IDX__][tipo]" class="form-select form-select-sm">
+        @foreach(\App\Models\FatturaRiga::TIPI as $val => $label)
+        <option value="{{ $val }}" @selected($val === \App\Models\FatturaRiga::TIPO_MANUALE)>{{ $label }}</option>
+        @endforeach
+      </select>
+      <input type="number" min="0" step="1" name="righe[__IDX__][minuti]" class="form-control form-control-sm mt-1" placeholder="Minuti">
+    </td>
+    <td>
+      <input type="text" name="righe[__IDX__][descrizione]" class="form-control form-control-sm" placeholder="Descrizione">
+      <textarea name="righe[__IDX__][nota]" class="form-control form-control-sm mt-1" rows="1" placeholder="Nota"></textarea>
+    </td>
+    <td><input type="number" step="0.01" name="righe[__IDX__][quantita]" class="form-control form-control-sm qty-input" value="1"></td>
+    <td>
+      <select name="righe[__IDX__][unita_misura]" class="form-select form-select-sm">
+        <option value="">—</option>
+        @foreach(\App\Models\Prodotto::UNITA_MISURA as $val => $label)
+        <option value="{{ $val }}">{{ $label }}</option>
+        @endforeach
+      </select>
+    </td>
+    <td><input type="number" step="0.01" name="righe[__IDX__][prezzo_unitario]" class="form-control form-control-sm prezzo-input" value="0"></td>
+    <td><input type="number" step="0.01" min="0" max="100" name="righe[__IDX__][sconto]" class="form-control form-control-sm sconto-input" value="0"></td>
+    <td><input type="number" step="0.01" name="righe[__IDX__][importo]" class="form-control form-control-sm text-end importo-input" value="0"></td>
+    <td class="text-end"><button type="button" class="btn btn-sm btn-icon text-danger remove-riga" title="Elimina voce"><i class="bx bx-trash"></i></button></td>
+  </tr>
+</template>
+@else
 <div class="row g-4">
   <div class="col-md-4">
     <div class="card h-100">
@@ -70,6 +331,7 @@
         @if($fattura->piva)<p class="mb-1">P.IVA {{ $fattura->piva }}</p>@endif
         @if($fattura->cod_fiscale)<p class="mb-1">CF {{ $fattura->cod_fiscale }}</p>@endif
         @if($fattura->indirizzo)<p class="mb-1">{{ $fattura->indirizzo }}</p>@endif
+        @if($fattura->comune)<p class="mb-1">{{ $fattura->comune->nome }}@if($fattura->comune->provincia) ({{ $fattura->comune->provincia->sigla }})@endif</p>@endif
         @if($fattura->email)<p class="mb-1">{{ $fattura->email }}</p>@endif
         @if($fattura->telefono)<p class="mb-1">{{ $fattura->telefono }}</p>@endif
         <hr>
@@ -80,6 +342,9 @@
           –
           {{ $fattura->periodo_a ? \Carbon\Carbon::parse($fattura->periodo_a)->format('d/m/Y') : '—' }}
         </p>
+        @if($fattura->note)
+        <p class="mb-0 mt-2">{{ $fattura->note }}</p>
+        @endif
         @if($fattura->createdBy)
         <p class="text-muted small mb-0 mt-2">Creata da {{ $fattura->createdBy->full_name }}</p>
         @endif
@@ -149,4 +414,107 @@
     </div>
   </div>
 </div>
+@endcan
+@endsection
+
+@can('edit-fattura')
+@section('page-script')
+<script type="module">
+$(function () {
+  const form = document.getElementById('formFattura');
+  const tbody = document.querySelector('#righeTable tbody');
+  const template = document.getElementById('riga-template');
+  let idx = tbody.querySelectorAll('.riga-row').length;
+
+  $('.select2-comune').select2({
+    ajax: {
+      url: @json(route('comune.list')),
+      dataType: 'json',
+      delay: 250,
+      data: params => ({ term: params.term || '', page: params.page || 1 }),
+      processResults: data => ({
+        results: (data.results || data).map(c => ({ id: c.id, text: c.nome || c.text })),
+        pagination: { more: data.pagination ? data.pagination.more : false }
+      })
+    },
+    allowClear: true,
+    width: '100%',
+    placeholder: 'Cerca comune'
+  });
+
+  function round2(n) {
+    return Math.round((Number(n) + Number.EPSILON) * 100) / 100;
+  }
+
+  function num(el) {
+    if (!el) return 0;
+    const v = parseFloat(String(el.value).replace(',', '.'));
+    return Number.isFinite(v) ? v : 0;
+  }
+
+  function importoRiga(row) {
+    const qty = num(row.querySelector('.qty-input'));
+    const price = num(row.querySelector('.prezzo-input'));
+    const sconto = Math.min(100, Math.max(0, num(row.querySelector('.sconto-input'))));
+    return round2(qty * price * (1 - sconto / 100));
+  }
+
+  function scriviTotali() {
+    let imponibile = 0;
+    tbody.querySelectorAll('.importo-input').forEach(el => { imponibile += num(el); });
+    imponibile = round2(imponibile);
+    const pct = num(document.getElementById('iva_percentuale'));
+    const iva = round2(imponibile * pct / 100);
+    document.getElementById('imponibile').value = imponibile.toFixed(2);
+    document.getElementById('iva').value = iva.toFixed(2);
+    document.getElementById('totale').value = round2(imponibile + iva).toFixed(2);
+    form.dataset.totaliManual = '0';
+  }
+
+  function aggiornaImporto(row) {
+    const imp = row.querySelector('.importo-input');
+    if (imp) imp.value = importoRiga(row).toFixed(2);
+    if (form.dataset.totaliManual !== '1') scriviTotali();
+  }
+
+  document.getElementById('addRiga').addEventListener('click', function () {
+    const html = template.innerHTML.replaceAll('__IDX__', String(idx++));
+    tbody.insertAdjacentHTML('beforeend', html);
+    if (form.dataset.totaliManual !== '1') scriviTotali();
+  });
+
+  tbody.addEventListener('click', function (e) {
+    const btn = e.target.closest('.remove-riga');
+    if (!btn) return;
+    btn.closest('.riga-row')?.remove();
+    if (form.dataset.totaliManual !== '1') scriviTotali();
+  });
+
+  tbody.addEventListener('input', function (e) {
+    const row = e.target.closest('.riga-row');
+    if (!row) return;
+    if (e.target.classList.contains('qty-input') || e.target.classList.contains('prezzo-input') || e.target.classList.contains('sconto-input')) {
+      aggiornaImporto(row);
+    } else if (e.target.classList.contains('importo-input') && form.dataset.totaliManual !== '1') {
+      scriviTotali();
+    }
+  });
+
+  document.getElementById('iva_percentuale').addEventListener('input', function () {
+    if (form.dataset.totaliManual !== '1') scriviTotali();
+  });
+
+  form.querySelectorAll('.totale-input').forEach(el => {
+    el.addEventListener('input', function () {
+      form.dataset.totaliManual = '1';
+    });
+  });
+
+  document.getElementById('ricalcolaTotali').addEventListener('click', function () {
+    tbody.querySelectorAll('.riga-row').forEach(aggiornaImporto);
+    scriviTotali();
+  });
+});
+</script>
 @endsection
+@endcan

routes/web.php

@@ -17,6 +17,7 @@ use App\Http\Controllers\SegnalazioneController;
 use App\Http\Controllers\TempoImpiegatoController;
 use App\Http\Controllers\UserController;
 use App\Http\Controllers\AziendaController;
+use App\Http\Controllers\AziendaFicController;
 use App\Http\Controllers\ProdottoController;
 use App\Http\Controllers\OffertaController;
 use App\Http\Controllers\FatturazioneController;
@@ -119,6 +120,7 @@ Route::middleware(['auth:sanctum', config('jetstream.auth_session')])->prefix('a
     Route::get('fatturazione/genera', [FatturazioneController::class, 'admin_genera'])->name('admin.fatturazione.genera');
     Route::post('fatturazione/crea', [FatturazioneController::class, 'admin_crea'])->name('admin.fatturazione.crea');
     Route::get('fatturazione/{id}', [FatturazioneController::class, 'admin_show'])->name('admin.fatturazione.show')->whereNumber('id');
+    Route::put('fatturazione/{id}', [FatturazioneController::class, 'admin_update'])->name('admin.fatturazione.update')->whereNumber('id');
     Route::post('fatturazione/{id}/emetti', [FatturazioneController::class, 'admin_emetti'])->name('admin.fatturazione.emetti')->whereNumber('id');
     Route::post('fatturazione/{id}/annulla', [FatturazioneController::class, 'admin_annulla'])->name('admin.fatturazione.annulla')->whereNumber('id');
     Route::delete('fatturazione/{id}', [FatturazioneController::class, 'admin_destroy'])->name('admin.fatturazione.destroy')->whereNumber('id');
@@ -173,6 +175,11 @@ Route::middleware(['auth:sanctum', config('jetstream.auth_session')])->prefix('a
     // Azienda
     Route::get('azienda', [AziendaController::class, 'admin_index'])->name('admin.azienda.index');
     Route::post('azienda/store', [AziendaController::class, 'admin_store'])->name('admin.azienda.store');
+    Route::get('azienda/fic/clienti', [AziendaFicController::class, 'clienti'])->name('admin.azienda.fic.clienti');
+    Route::get('azienda/{id}/fic', [AziendaFicController::class, 'show'])->name('admin.azienda.fic.show')->whereNumber('id');
+    Route::get('azienda/{id}/fic/confronto', [AziendaFicController::class, 'confronto'])->name('admin.azienda.fic.confronto')->whereNumber('id');
+    Route::post('azienda/{id}/fic', [AziendaFicController::class, 'applica'])->name('admin.azienda.fic.applica')->whereNumber('id');
+    Route::delete('azienda/{id}/fic', [AziendaFicController::class, 'scollega'])->name('admin.azienda.fic.scollega')->whereNumber('id');
     Route::get('azienda/{id}', [AziendaController::class, 'admin_show'])->name('admin.azienda.show');
     Route::delete('azienda/{id}', [AziendaController::class, 'admin_delete'])->name('admin.azienda.delete');