fatture in cloud

app/Http/Controllers/AziendaFicController.php

             '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.',
+                : 'Inserisci Company ID e access token in Configurazione → Fatture in Cloud. Il token deve avere gli scope entity.clients:r, entity.clients:a, settings:r e issued_documents.invoices:a.',
         ];
 
         if ($fic->configured() && $azienda->ficCollegamento) {

app/Http/Controllers/FatturazioneController.php

 use App\Models\Config;
 use App\Models\Fattura;
 use App\Models\FatturaRiga;
+use App\Services\FatturaFicService;
 use App\Services\FatturazioneGeneraService;
 use Carbon\Carbon;
 use Illuminate\Http\Request;
       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_update', 'admin_emetti', 'admin_annulla']),
+      new Middleware('permission:edit-fattura', only: ['admin_update', 'admin_emetti', 'admin_annulla', 'admin_invia_fic']),
       new Middleware('permission:delete-fattura', only: ['admin_destroy']),
     ];
   }
     return redirect()->back()->with('success', 'Fattura emessa.');
   }
 
+  public function admin_invia_fic($id, FatturaFicService $fic)
+  {
+    try {
+      $message = $fic->invia(Fattura::findOrFail($id));
+    } catch (RuntimeException $e) {
+      return redirect()->back()->with('error', $e->getMessage());
+    }
+
+    return redirect()->back()->with('success', $message);
+  }
+
   public function admin_annulla($id)
   {
     $fattura = Fattura::findOrFail($id);

app/Models/Fattura.php

     public function getNumeroDocumentoAttribute(): string
     {
         $n = $this->numero ?: $this->id;
+        $numeration = trim((string) data_get($this->meta, 'fic.numeration'));
+        if ($this->ficDocumentId() && $numeration !== '') {
+            return $n.(str_starts_with($numeration, '/') ? '' : '/').$numeration;
+        }
+
         $year = $this->data
             ? Carbon::parse($this->data)->format('y')
             : now()->format('y');
         return $this->stato !== self::STATO_ANNULLATA;
     }
 
+    public function ficDocumentId(): ?int
+    {
+        $id = data_get($this->meta, 'fic.document_id');
+
+        return $id ? (int) $id : null;
+    }
+
     public function scopeNonAnnullate($query)
     {
         return $query->where('stato', '!=', self::STATO_ANNULLATA);

app/Services/FatturaFicService.php

+<?php
+
+namespace App\Services;
+
+use App\Models\Config;
+use App\Models\Fattura;
+use App\Models\FatturaRiga;
+use App\Models\FicCollegamento;
+use App\Models\Prodotto;
+use Carbon\Carbon;
+use RuntimeException;
+
+class FatturaFicService
+{
+    public function __construct(protected FattureInCloudClient $fic) {}
+
+    public function invia(Fattura $fattura): string
+    {
+        $fattura->loadMissing(['righe', 'user']);
+        if ($fattura->isAnnullata()) {
+            throw new RuntimeException('Una fattura annullata non si invia.');
+        }
+        if ($fattura->ficDocumentId()) {
+            throw new RuntimeException('Questa fattura è già su Fatture in Cloud.');
+        }
+        if ($fattura->righe->isEmpty()) {
+            throw new RuntimeException('La fattura non ha righe.');
+        }
+
+        $collegamento = $this->collegamento($fattura);
+        if (! $collegamento) {
+            throw new RuntimeException('Collega il cliente a Fatture in Cloud dalla scheda azienda, poi riprova.');
+        }
+
+        try {
+            $client = $this->fic->getClient((int) $collegamento->fic_client_id);
+            $vatId = $this->vatId((float) ($fattura->iva_percentuale ?? Config::ivaPercentualeDefault()));
+            $document = $this->fic->createIssuedDocument($this->payload($fattura, $client, $vatId));
+            if (! isset($document['number']) || $document['number'] === '' || $document['number'] === null) {
+                $document = $this->fic->getIssuedDocument((int) $document['id']);
+            }
+        } catch (RuntimeException $e) {
+            throw new RuntimeException($this->conScope($e->getMessage()));
+        }
+
+        $numeroFic = (int) $document['number'];
+        if ($numeroFic < 1) {
+            throw new RuntimeException('Fatture in Cloud ha creato il documento ma non ha assegnato un numero.');
+        }
+
+        $meta = is_array($fattura->meta) ? $fattura->meta : [];
+        $meta['fic'] = [
+            'document_id' => (int) $document['id'],
+            'number' => $numeroFic,
+            'numeration' => $document['numeration'] ?? null,
+            'date' => isset($document['date']) ? (string) $document['date'] : null,
+            'sent_at' => now()->toIso8601String(),
+        ];
+        $fattura->meta = $meta;
+        $fattura->numero = $numeroFic;
+        if (! empty($document['date'])) {
+            $fattura->data = Carbon::parse($document['date'])->toDateString();
+        }
+        if ($fattura->isBozza()) {
+            $fattura->stato = Fattura::STATO_EMESSA;
+            if (! $fattura->data) {
+                $fattura->data = now()->toDateString();
+            }
+        }
+        $fattura->save();
+
+        return 'Fattura '.$fattura->numero_documento.' allineata a Fatture in Cloud. L\'invio allo SDI lo fai da lì.';
+    }
+
+    protected function collegamento(Fattura $fattura): ?FicCollegamento
+    {
+        $ids = array_values(array_filter([
+            (int) $fattura->user_id,
+            (int) ($fattura->user->azienda_id ?? 0),
+        ]));
+
+        return FicCollegamento::query()->whereIn('user_id', $ids)->first();
+    }
+
+    /**
+     * @param  array<string, mixed>  $client
+     * @return array<string, mixed>
+     */
+    protected function payload(Fattura $fattura, array $client, int $vatId): array
+    {
+        $data = $fattura->data ? Carbon::parse($fattura->data)->toDateString() : now()->toDateString();
+        $entity = ['id' => (int) $client['id']];
+        foreach ([
+            'name',
+            'vat_number',
+            'tax_code',
+            'address_street',
+            'address_postal_code',
+            'address_city',
+            'address_province',
+            'country',
+            'email',
+        ] as $field) {
+            $value = trim((string) ($client[$field] ?? ''));
+            if ($value !== '') {
+                $entity[$field] = $value;
+            }
+        }
+        if (empty($entity['name'])) {
+            $entity['name'] = $fattura->ragione_sociale ?: 'Cliente';
+        }
+
+        $items = [];
+        foreach ($fattura->righe as $riga) {
+            $items[] = $this->item($riga, $vatId);
+        }
+
+        $payload = [
+            'type' => 'invoice',
+            'entity' => $entity,
+            'date' => $data,
+            'items_list' => $items,
+            'e_invoice' => false,
+        ];
+
+        if ($fattura->periodo_da && $fattura->periodo_a) {
+            $payload['visible_subject'] = 'Periodo '
+                .Carbon::parse($fattura->periodo_da)->format('d/m/Y')
+                .' – '
+                .Carbon::parse($fattura->periodo_a)->format('d/m/Y');
+        }
+
+        return $payload;
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    protected function item(FatturaRiga $riga, int $vatId): array
+    {
+        $qty = (float) ($riga->quantita ?? 1);
+        if ($qty <= 0) {
+            $qty = 1;
+        }
+        $name = trim((string) $riga->descrizione);
+        if ($name === '') {
+            $name = $riga->tipo_label;
+        }
+        if (mb_strlen($name) > 255) {
+            $name = mb_substr($name, 0, 252).'…';
+        }
+
+        $item = [
+            'name' => $name,
+            'qty' => $qty,
+            'net_price' => round((float) ($riga->importo ?? 0) / $qty, 5),
+            'vat' => ['id' => $vatId],
+        ];
+        $measure = Prodotto::UNITA_MISURA[$riga->unita_misura] ?? $riga->unita_misura;
+        if (filled($measure)) {
+            $item['measure'] = mb_substr((string) $measure, 0, 20);
+        }
+
+        return $item;
+    }
+
+    protected function vatId(float $percent): int
+    {
+        foreach ($this->fic->vatTypes() as $type) {
+            if (! is_array($type) || ! empty($type['is_disabled'])) {
+                continue;
+            }
+            if (abs((float) ($type['value'] ?? -1) - $percent) < 0.001 && isset($type['id'])) {
+                return (int) $type['id'];
+            }
+        }
+
+        $label = rtrim(rtrim(number_format($percent, 2, ',', ''), '0'), ',');
+
+        throw new RuntimeException('Su Fatture in Cloud non c\'è un\'aliquota IVA del '.$label.'%.');
+    }
+
+    protected function conScope(string $message): string
+    {
+        if (preg_match('/403|permission|permess|scope/i', $message)) {
+            return $message.' Ricrea il token con anche gli scope settings:r e issued_documents.invoices:a.';
+        }
+
+        return $message;
+    }
+}

app/Services/FatturazioneGeneraService.php

             'importo_tempo' => round(($minuti / 60) * $tariffaDefault, 2),
             'importo_spesa' => $fatturaSpesa,
             'tariffa_mancante' => $mancante,
-            'note' => 'Senza contratto né ordine',
+            'note' => null,
         ], $annotazione, $segnalazione);
     }
 

app/Services/FattureInCloudClient.php

         return $fromEnv !== '' ? $fromEnv : null;
     }
 
+    /**
+     * @return array<int, array<string, mixed>>
+     */
+    public function vatTypes(): array
+    {
+        $json = $this->decode($this->http()->get($this->url('/info/vat_types')));
+
+        return is_array($json['data'] ?? null) ? $json['data'] : [];
+    }
+
+    /**
+     * @param  array<string, mixed>  $data
+     * @return array<string, mixed>
+     */
+    public function createIssuedDocument(array $data): array
+    {
+        $json = $this->decode($this->http()->post($this->url('/issued_documents'), [
+            'data' => $data,
+        ]));
+
+        return $this->documentOrFail($json['data'] ?? null);
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    public function getIssuedDocument(int $id): array
+    {
+        $json = $this->decode($this->http()->get($this->url('/issued_documents/'.$id)));
+
+        return $this->documentOrFail($json['data'] ?? null);
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    private function documentOrFail(mixed $document): array
+    {
+        if (! is_array($document) || empty($document['id'])) {
+            throw new RuntimeException('Fatture in Cloud non ha restituito la fattura creata.');
+        }
+
+        return $document;
+    }
+
     private function url(string $path): string
     {
         return '/c/'.$this->companyId().$path;

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

         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>.';
+          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>, <code>entity.clients:a</code>, <code>settings:r</code> e <code>issued_documents.invoices:a</code>.';
           document.getElementById('ficSearchWrap').classList.add('d-none');
           document.getElementById('ficCreate').classList.add('d-none');
           return;

resources/views/config/index.blade.php

               @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>
+              <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>, <code>entity.clients:a</code>, <code>settings:r</code> e <code>issued_documents.invoices:a</code>. Lascia vuoto per non sostituirlo.</div>
               @endif
               @break
 

resources/views/fatturazione/show.blade.php

     </button>
   </form>
   @endif
+  @if($fattura->ficDocumentId())
+  <span class="badge bg-label-success">Su Fatture in Cloud n. {{ data_get($fattura->meta, 'fic.number') }}{{ data_get($fattura->meta, 'fic.numeration') }}</span>
+  @elseif(! $fattura->isAnnullata())
+  <form method="POST" action="{{ route('admin.fatturazione.fic', $fattura->id) }}" class="d-inline"
+    onsubmit="return confirm('Creare questa fattura su Fatture in Cloud?');">
+    @csrf
+    <button type="submit" class="btn btn-label-info btn-sm">
+      <i class="bx bx-cloud-upload me-1"></i>Invia a Fatture in Cloud
+    </button>
+  </form>
+  @endif
   @if(! $fattura->isAnnullata())
   <form method="POST" action="{{ route('admin.fatturazione.annulla', $fattura->id) }}" class="d-inline"
     onsubmit="return confirm('Annullare questa fattura? Le voci torneranno disponibili al genera.');">
       <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>
           <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="hidden" name="righe[{{ $i }}][tipo]" value="{{ $riga['tipo'] ?? \App\Models\FatturaRiga::TIPO_MANUALE }}">
+              <input type="hidden" name="righe[{{ $i }}][minuti]" value="{{ $riga['minuti'] ?? '' }}">
               <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>
+              <textarea name="righe[{{ $i }}][nota]" class="form-control form-control-sm mt-1" rows="1" placeholder="Nota">{{ ($riga['nota'] ?? '') === 'Senza contratto né ordine' ? '' : ($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
         </tbody>
         <tfoot>
           <tr>
-            <th colspan="6" class="text-end align-middle">Imponibile</th>
+            <th colspan="5" 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 colspan="5" 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 colspan="5" 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>
   <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="hidden" name="righe[__IDX__][tipo]" value="{{ \App\Models\FatturaRiga::TIPO_MANUALE }}">
+      <input type="hidden" name="righe[__IDX__][minuti]" value="">
       <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>
         <table class="table mb-0">
           <thead>
             <tr>
-              <th>Tipo</th>
               <th>Descrizione</th>
               <th>Qty</th>
               <th>Prezzo</th>
           <tbody>
             @forelse($fattura->righe as $riga)
             <tr>
-              <td><span class="badge bg-label-secondary">{{ $riga->tipo_label }}</span></td>
               <td>
                 {{ $riga->descrizione }}
                 @if($riga->segnalazione_id)
                 @if($riga->ordine_lavoro_id)
                 <div class="small"><a href="{{ route('admin.ordine_lavoro.show', $riga->ordine_lavoro_id) }}">Apri ordine</a></div>
                 @endif
-                @if($riga->nota)
+                @if($riga->nota && $riga->nota !== 'Senza contratto né ordine')
                 <div class="text-muted small">{{ $riga->nota }}</div>
                 @endif
               </td>
               <td class="text-end">{{ \App\Models\Config::formatCosto($riga->importo ?? 0) }}</td>
             </tr>
             @empty
-            <tr><td colspan="5" class="text-muted">Nessuna voce</td></tr>
+            <tr><td colspan="4" class="text-muted">Nessuna voce</td></tr>
             @endforelse
           </tbody>
           <tfoot>
             <tr>
-              <th colspan="4" class="text-end">Imponibile</th>
+              <th colspan="3" class="text-end">Imponibile</th>
               <th class="text-end">{{ \App\Models\Config::formatCosto($fattura->imponibile ?? 0) }}</th>
             </tr>
             <tr>
-              <th colspan="4" class="text-end">IVA {{ rtrim(rtrim(number_format((float) $fattura->iva_percentuale, 2, ',', ''), '0'), ',') }}%</th>
+              <th colspan="3" class="text-end">IVA {{ rtrim(rtrim(number_format((float) $fattura->iva_percentuale, 2, ',', ''), '0'), ',') }}%</th>
               <th class="text-end">{{ \App\Models\Config::formatCosto($fattura->iva ?? 0) }}</th>
             </tr>
             <tr>
-              <th colspan="4" class="text-end">Totale</th>
+              <th colspan="3" class="text-end">Totale</th>
               <th class="text-end">{{ \App\Models\Config::formatCosto($fattura->totale ?? 0) }}</th>
             </tr>
           </tfoot>

routes/web.php

     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}/fic', [FatturazioneController::class, 'admin_invia_fic'])->name('admin.fatturazione.fic')->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');