Condividi tramite

Introduzione alla fatturazione elettronica per l'Italia

Importante

La fatturazione elettronica per l'Italia potrebbe attualmente non supportare tutte le funzioni disponibili per le fatture elettroniche in Microsoft Dynamics 365 Finance e Dynamics 365 Supply Chain Management.

Questo articolo fornisce informazioni introduttive sulla fatturazione elettronica per l'Italia in Finance e Supply Chain Management. Ti guida attraverso i passaggi di configurazione che devi completare per abilitare la generazione di fatture elettroniche nel formato specifico per l'Italia, FatturaPA, e per scambiare fatture elettroniche con il sistema di scambio di fatturazione elettronica dell'Agenzia delle Entrate, SDI (Sistema di Interscambio).

Nota

La soluzione per l'integrazione diretta con SDI supporta la firma digitale dei documenti solo tramite file di certificato archiviati separatamente che possono essere caricati nel key vault. La soluzione non supporta l'uso di firme digitali qualificate, che richiedono il coinvolgimento di hardware aggiuntivo o una connessione online ai fornitori di servizi di certificazione.

Prerequisiti

Prima di completare i passaggi in questo articolo, è necessario soddisfare i seguenti requisiti:

  • Ottenere l'accreditamento del canale di servizio SDICoop nel portale governativo del sistema di Exchange (SDI).
  • Completare i passaggi in Configurazione dei servizi per la fatturazione elettronica.
  • Importare la funzionalità di fatturazione elettronica FatturaPA italiana (IT) (versione 5 o successiva) dall'archivio. Per ulteriori informazioni, vedi Importare funzionalità dal repository.
  • Configurare le risorse di Azure per archiviare I certificati richiesti, incluso il certificato dell'autorità di certificazione (CA) e il certificato dei client. Per ulteriori informazioni, vedi Creare un riferimento Key Vault.
  • Facoltativo: è possibile utilizzare il certificato di firma digitale solo per le firme non qualificate.

Configurazione specifica del paese/area geografica per la funzionalità di fatturazione elettronica FatturaPA italiana (IT)

Completare le seguenti procedure prima di distribuire la funzionalità in Finance.

Questa sezione integra la parte comune della configurazione del servizio di fatturazione elettronica descritta in Configurazione della fatturazione elettronica.

Creare una nuova sequenza numerica per ProgressivoInvio

Per creare un nuovo numero di sequenza per ProgressivoInvio, procedere come segue.

  1. Selezionare Amministrazione organizzazione>Impostazione>Parametri documento elettronico.
  2. Nella Scheda dettaglio Sequenze numeriche della scheda Fatturazione elettronica selezionare Nuovo per aggiungere un record.
  3. Immetti un nome per la nuova sequenza (ad esempio, ProgressivoInvio) e seleziona Salva.

Creare una nuova catena di certificati

Per creare una nuova catena di certificati, segui questi passaggi.

  1. Selezionare Amministrazione organizzazione>Impostazione>Parametri documento elettronico.

  2. Nella Scheda dettaglio Impostazioni Key Vault della scheda Fatturazione elettronica, seleziona Parametri Key Vault.

  3. Nella sezione Certificati seleziona Aggiungi per aggiungere i seguenti certificati:

    • CAentrate.cer (e CAEntratetest.cer nel caso di un ambiente di test)

    • CAActalisOV.cer (nel caso di un ambiente di produzione)

    • Certificato di entità client

      Nota

      • In genere, il certificato di identità client viene generato mentre l'utente registra il canale del servizio SDICoop. È denominato SDI-<VatNumber>, dove <VatNumber> è il numero di partita IVA di 11 cifre di una società.
      • Il certificato di identità client ha una data di scadenza. Verifica questa data e organizza un'attività per ottenere un nuovo certificato quando quello attuale sta per scadere. Scopri come stabilire la corretta rotazione dei certificati utilizzati per questa integrazione nella sezione Rotazione dei certificati di questo articolo.

    • Certificato per firma digitale (facoltativo)

  4. Nel riquadro azioni seleziona Catena di certificati.

  5. Selezionare Nuovo e immettere un nome (ad esempio SDIChainProd o SDIChainTest).

  6. Nella sezione Certificati aggiungere i seguenti certificati nell'ordine in cui sono elencati:

    1. CAentrate.cer (e CAEntratetest.cer nel caso di un ambiente di test)
    2. CAActalisOV.cer (nel caso di un ambiente di produzione)
    3. Certificato di entità client

  7. Salva le modifiche e chiudi la pagina.

Crea una nuova funzionalità

Per creare una nuova funzionalità, completare i passaggi seguenti.

  1. Nell'area di lavoro Globalization Studio, seleziona il riquadro Creazione di report elettronici.
  2. Nella sezione Provider di configurazione contrassegnare il provider di configurazione della società come attivo.
  3. Nell'area di lavoro Globalization Studio, seleziona il riquadro Fatturazione elettronica.
  4. Nella pagina Funzionalità di fatturazione elettronica seleziona Aggiungi>Basato su funzionalità esistente.
  5. Nel provider di configurazione Microsoft, seleziona FatturaPA italiana (IT) come funzionalità di base, inserisci un nome, quindi seleziona Crea funzionalità.

Allineare configurazioni di Creazione di report elettronici

Le seguenti procedure devono essere completate per entrambe le configurazioni del formato di creazione di report elettronici utilizzate nella funzionalità: Fattura di vendita (IT) e Fattura di progetto (IT).

Impostare la sostituzione del metodo di pagamento

Per impostare la sostituzione del metodo di pagamento, seguire questi passaggi.

  1. Nell'area di lavoro Globalization Studio seleziona Creazione di report elettronici e quindi il riquadro Configurazioni report.
  2. Nella pagina Configurazioni seleziona la configurazione del formato Fattura di vendita (IT).
  3. Nella sezione Versioni verificare che la versione Bozza sia selezionata.
  4. Nel riquadro azioni selezionare Progettazione.
  5. Nella scheda Mapping, seleziona $PaymentMethodSubstitution, quindi seleziona Modifica>Modifica formula.
  6. Allinea la formula ai metodi di pagamento configurati in Finance.
  7. Salva le modifiche, chiudi Progettazione formula, quindi seleziona OK.
  8. Salva l'intera configurazione del formato Fattura di vendita (IT), quindi chiudi la pagina Designer.
  9. Nella sezione Versioni seleziona Modifica stato> Completa per completare la configurazione del formato Fattura di vendita (IT).
  10. Ripetere i passaggi da 2 a 9 per la configurazione del formato Fattura di progetto (IT), come richiesto.

Configurare parametri specifici dell'applicazione

Per impostare parametri specifici per l'applicazione, effettua le seguenti operazioni.

  1. Nell'area di lavoro Globalization Studio seleziona Creazione di report elettronici e quindi il riquadro Configurazioni report.

  2. Nella pagina Configurazioni seleziona la configurazione del formato Fattura di vendita (IT).

  3. Nel menu, seleziona Configurazioni>Parametri specifici dell'applicazione>Impostazione.

  4. Nella sezione Ricerche assicurati che la ricerca Elenco delle sottocategorie reverse charge Natura sia selezionata.

  5. Nella sezione Condizioni, seleziona Aggiungi.

  6. Aggiungi condizioni specifiche per ogni sottocategoria definita nel sistema.

    Nota

    Nella colonna Nome puoi selezionare il segnaposto *Vuoto* o *Non vuoto* invece di un valore specifico.

  7. Modifica il valore Stato in Completato, salva le modifiche, quindi chiudi la pagina.

  8. Ripeti i passaggi da 2 a 7 per la configurazione del formato Fattura di progetto (IT), come richiesto.

Configurare una pipeline di elaborazione per l'esportazione

Per configurare una pipeline di elaborazione per l'esportazione, segui questi passaggi.

  1. Nell'area di lavoro Globalization Studio, seleziona il riquadro Fatturazione elettronica.

  2. Nella pagina Funzionalità di fatturazione elettronica seleziona la funzionalità creata in base alla funzionalità FatturaPA italiana (IT).

  3. Nella scheda Impostazioni, seleziona Fattura di vendita, quindi seleziona Modifica.

  4. Nella sezione Pipeline di elaborazione passa alle azioni e imposta i campi richiesti:

    • Ottieni valore successivo della sequenza numerica: nella sezione Parametri, seleziona il parametro Sequenza numerica. Quindi, nel campo Valore, seleziona la sequenza numerica definita in precedenza per ProgressivoInvio.
    • Inoltra: nella sezione Parametri, nel campo Indirizzo URL, immetti o seleziona un valore. Nel campo Certificati immetti o seleziona è una catena di certificati aggiunta in precedenza in questo articolo (SDIChainProd o SDIChainTest).
    • Firma documento: nel campo Nome certificato specifica il Certificato di firma digitale (facoltativo).

  5. Nella sezione Regole di applicabilità, esamina le singole clausole e rivedi o imposta i campi obbligatori. Nell'ambio di questo passaggio, esamina la clausola LegalEntityID e aggiornala con il valore corretto della persona giuridica.

  6. Seleziona Convalida per garantire che tutti i campi necessari siano impostati.

  7. Salva le modifiche e chiudi la pagina.

  8. Nella scheda Impostazioni, seleziona Fatture di progetto, quindi seleziona Modifica.

  9. Ripeti i passaggi da 3 a 7 per le impostazioni Fattura di progetto, Fattura di vendita PA e Fattura di progetto PA, se necessario.

Configurare una pipeline di elaborazione per l'importazione

Per configurare una pipeline di elaborazione per l'importazione, segui questi passaggi.

  1. Nell'area di lavoro Globalization Studio, seleziona il riquadro Fatturazione elettronica.

  2. Nella pagina Funzionalità di fatturazione elettronica seleziona la funzionalità creata in base alla funzionalità FatturaPA italiana (IT).

  3. Nella scheda Impostazioni, seleziona Fatture di importazione, quindi seleziona Modifica.

  4. Nel campo Canale dati della scheda Parametri della sezione Canale dati nella scheda Importa canale immetti un valore di stringa.

  5. Nella scheda Regole di applicabilità imposta i campi per l'impostazione. Per usare la clausola predefinita Canale passa il valore che hai impostato per il campo Canale dati nel passaggio precedente al campo Valore.

    Screenshot che mostra il campo Valore nell'impostazione delle regole di applicabilità.

  6. Seleziona Convalida per garantire che tutti i campi necessari siano impostati.

  7. Salva le modifiche e chiudi la pagina.

Distribuire la funzionalità

Completa e distribuisci la funzionalità come descritto in Completare e distribuire una funzionalità di globalizzazione.

Configurare Parametri documenti elettronici

Per configurare i parametri del documento elettronico, segui questi passaggi.

  1. Importa le configurazioni di creazione di report elettronici Modello contesto fattura cliente (versione 54 o successiva) e Importazione fatture fornitore (IT) dal repository. Per altre informazioni, vedi Importare le configurazioni di creazione di report elettronici da Dataverse.

  2. Selezionare Amministrazione organizzazione>Impostazione>Parametri documento elettronico.

  3. Nella scheda Funzionalità, trova e seleziona la funzionalità Fattura elettronica italiana, quindi seleziona Abilita.

  4. Nella scheda Documento elettronico assicurati che i campi per Giornale di registrazione fatture cliente e Fattura di progetto siano impostati in base alle informazioni in Impostare Parametri documenti elettronici.

    Screenshot dell'impostazione di Parametri documenti elettronici.

Configurare l'importazione di fatture fornitore

Per configurare l'importazione di fatture fornitore, procedi come segue.

  1. Nell'area di lavoro Globalization Studio seleziona Creazione di report elettronici e quindi il riquadro Configurazioni report.

  2. Seleziona Modello contesto fattura cliente, e quindi Crea configurazione.

  3. Seleziona Deriva da nome: Contesto fattura cliente, Microsoft per creare una configurazione derivata.

  4. Selezionare la configurazione derivata, quindi selezion Designer per aprirla e modificarla.

  5. Seleziona Mappa modello a origine dati.

  6. Nell'albero Definizioni, seleziona DataChannel e quindi seleziona Progettazione.

  7. Nell'albero Origine dati, espandere il contenitore $Context‑Channel.

  8. Nel campo Valore, seleziona Modifica.

  9. Immetti il nome del canale dati. Il nome deve contenere un massimo di 10 caratteri. Deve corrispondere al valore del parametro Canale dati del canale dati per la funzionalità di fatturazione elettronica.

  10. Salva le modifiche e chiudi il modulo.

  11. Nella sezione Versioni seleziona Modifica stato> Completa per completare la configurazione del contesto derivato.

  12. Selezionare Amministrazione organizzazione>Impostazione>Parametri documento elettronico.

  13. Nella scheda Canali di integrazione, nella sezione Canali, seleziona Aggiungi.

  14. Nel campo Canale immetti il valore $Context Channel.

  15. Immetti i valori nei campi Descrizione e Società.

  16. Nel campo Contesto documento, seleziona la nuova configurazione derivata da Modello contesto fattura cliente. Il nome del mapping dovrebbe essere Contesto canale dati.

  17. Nella scheda Importa origini, seleziona Aggiungi e quindi imposta i seguenti valori:

    • Nome: OutputFile
    • Nome entità dati: Intestazione fattura fornitore (Entità dati: VendorInvoiceHeaderEntity)
    • Mapping modello: Importazione fattura fornitore (IT)

    Screenshot dell'impostazione del canale di importazione.

Nota

Se si importano fatture fornitore da origini diverse, è possibile creare diversi canali e diverse configurazioni derivate che hanno differenti valori $Context Channel. Ad esempio, potresti voler importare fatture fornitore per diverse persone giuridiche.

Configurazione dei dati aziendali di Finance

Segui i passaggi di configurazione descritti in Fatture elettroniche dei clienti. Inizia dalla sezione sezione Valuta della fattura elettronica.

Configurazione del server proxy

Questa sezione fornisce informazioni per aiutarti a impostare e configurare il servizio proxy per la comunicazione tra il sistema Exchange (SDI) e il servizio di fatturazione elettronica.

Nota

Questa sezione è fornita esclusivamente a scopo illustrativo. Offre una panoramica di alto livello dei passaggi del processo di configurazione del server proxy. Non è una guida completa quanto a progettazione, configurazione, implementazione, manutenzione o supporto continuo del server proxy. Tutte le responsabilità relative a quest'area, incluse, a titolo esemplificativo ma non esaustivo, l'esecuzione tecnica dettagliata, la risoluzione dei problemi e la manutenzione del sistema, ricade sul team del cliente. Si consiglia agli utenti di consultare risorse tecniche appropriate o di rivolgersi a professionisti qualificati per le esigenze di implementazione e supporto complete.

Creare una registrazione app

Per creare una registrazione dell'app, completa i passaggi seguenti:

  1. Usa lo script di Windows PowerShell seguente per creare un certificato autofirmato per l'autenticazione da servizio a servizio (S2S).

    Nota

    La scadenza del certificato è prevista tra 12 mesi. È possibile estendere questo periodo modificando il valore del parametro NotAfter . Scopri come stabilire la corretta rotazione dei certificati utilizzati per questa integrazione nella sezione Rotazione dei certificati di questo articolo.

    $certOutputLocation = "C:\certs\proxytest"
$certName = "sdiProxyClientS2SCert"
$certPassword = "123"

$certCerFile = Join-Path $certOutputLocation "$certName.cer"
$certPfxFile = Join-Path $certOutputLocation "$certName.pfx"

$securePassword = ConvertTo-SecureString $certPassword -AsPlainText -Force

$cert = New-SelfSignedCertificate -KeyLength 2048 -KeyExportPolicy Exportable -FriendlyName "CN=$certName" -CertStoreLocation Cert:\CurrentUser\My -Subject $certName 
-Provider "Microsoft Enhanced RSA and AES Cryptographic Provider" -NotAfter (Get-Date).AddMonths(12)

Export-Certificate -Cert $cert -FilePath $certCerFile -type CERT | Out-Null
Export-PfxCertificate -Cert $cert -FilePath $certPfxFile -Password $securePassword | Out-Null

  2. Salvare il file del certificato con estensione pfx nel key vault. In seguito, questo certificato è denominato Certificato di registrazione dell'app.

  3. Accedi al portale di Azure come amministratore.

  4. Crea una registrazione dell'app per il servizio proxy SDI.

    1. Vai a Registrazioni app, crea una registrazione, quindi imposta i seguenti valori:

      • Nome: Client proxy SDI
      • Tipi di account supportati: Account solo in questa directory organizzativa (tenant singolo)

    2. Seleziona Registra, quindi seleziona la registrazione app appena creata.

    3. Vai ad Autorizzazioni API e seleziona Concedi il consenso dell'amministratore.

    4. Vai a Certificati e segreti, seleziona Carica certificato e carica il file .cer del Certificato di registrazione dell'app per l'autenticazione S2S.

    5. Vai ad Applicazioni aziendali e seleziona l'app che hai creato.

    6. Salva i valori ID applicazione (ID cliente) e ID oggetto per l'app.

    7. Il team del servizio di fatturazione deve concedere all'app l'accesso al servizio. Apri un ticket di supporto con il tema Integrazione del servizio di fatturazione elettronica con SDI. Elenco di applicazioni consentite. Immetti le seguenti informazioni:

      • ID tenant Microsoft Entra
      • ID ambiente di Microsoft Dynamics Lifecycle Services
      • ID domanda di lavoro
      • ID oggetto

      Nota

      L'ID oggetto per un'applicazione è diverso nelle pagine Registrazioni dell'app e Applicazioni aziendali. Utilizza il valore di ID oggetto nella pagina Applicazioni aziendali.

Creare una macchina virtuale di Azure

Per creare una macchina virtuale (VM) Azure, segui questi passaggi.

  1. Nel portale di Azure, passa a Macchine virtuali, quindi seleziona Crea nuovo.

  2. Nella scheda Nozioni di base seleziona l'abbonamento e il gruppo di risorse. I valori devono essere la sottoscrizione e il gruppo di risorse in cui si trovano il key vault e l'archivio BLOB.

  3. Seleziona l'area. Il valore deve essere l'area geografica in cui è distribuito l'ambiente Finance.

  4. Aggiungi il nome utente e la password dell'amministratore e salvali nel key vault.

  5. Nel campo Seleziona porte in entrata seleziona HTTPS (443) e RPD (3389).

    Nota

    Ti consigliamo di disabilitare la porta RDP (3389) quando il sistema va in produzione. Puoi riabilitarla se devi connetterti alla VM per la risoluzione dei problemi.

    Ti consigliamo anche di usare il sistema operativo (SO) Windows Server 2019 Datacenter. L'esempio di applicazione proxy potrebbe presentare problemi se viene eseguito su un altro tipo di sistema operativo.

    Screenshot dell'impostazione nella scheda Nozioni di base per creare una macchina virtuale di Azure.

  6. Nella scheda Dischi della scheda dettagli Avanzate seleziona la casella di controllo Usa dischi gestiti. Lascia la casella di controllo Disco del sistema operativo effimero deselezionata.

    Screenshot dell'impostazione nella scheda Dischi per creare una macchina virtuale di Azure.

  7. Nella scheda Rete sotto il campo IP pubblico seleziona Crea nuovo.

  8. Nella finestra di dialogo Crea indirizzo IP pubblico, nel gruppo di campi Unità di stockkeeping seleziona l'opzione Standard. Nel gruppo di campi Assegnazione, seleziona l'opzione Statico.

  9. Nella scheda Gestione deseleziona la casella di controllo Spegnimento automatico per disabilitare lo spegnimento automatico.

  10. Imposta il campo Aggiornamenti del sistema operativo guest su Manuale, quindi imposta eventuali altri criteri.

  11. Rivedi e crea la VM.

  12. Nella nuova VM, vai a Identità>Sistema assegnato, e imposta l'opzione Stato su Attivato.

  13. Concedi alla VM l'accesso all'insieme di credenziali delle chiavi:

    1. Nel key vault, vai a Controllo accessi (IAM)>Assegnazioni ruolo.

    2. Seleziona Aggiungi un'assegnazione di ruolo e quindi procedi come segue:

      1. Nel campo Ruolo specifica Segreti key vault utente.
      2. Nel campo Assegna accesso a specifica Macchina virtuale.
      3. Nel campo Sottoscrizione specifica la tua sottoscrizione.
      4. Nel campo Seleziona specifica la tua VM.

    3. Vai a Criteri di accesso.

    4. Seleziona Aggiungi criteri di accesso e procedi come segue:

      1. Nel campo Entità selezionata, seleziona la tua VM.
      2. Nella sezione Certificato seleziona le autorizzazioni Elenco e Ottieni.
      3. Nella sezione Segreto seleziona le autorizzazioni Elenco e Ottieni.

  14. Nel Portale di Azure, vai a Indirizzi IP pubblici e seleziona l'indirizzo IP che è stato creato nella macchina virtuale.

  15. Vai a Configurazione e imposta il nome DNS (Domain Name System).

Preparare l'ambiente del servizio proxy

Per preparare l'ambiente del servizio proxy, segui questi passaggi sulla macchina in cui è ospitato il servizio proxy.

  1. Connettiti alla macchina virtuale utilizzando Connessione desktop remoto.

  2. Apri lo snap-in Certificato computer locale. Per ulteriori informazioni, vedi Procedura: visualizzare i certificati con lo snap-in MMC.

  3. Importa il certificato caentrate.cer nello store Autorità di certificazione radice disponibile nell'elenco locale.

  4. Importa il certificato CAEntratetest.cer nello store Autorità di certificazione radice disponibile nell'elenco locale (solo per un ambiente di test).

  5. Importa il certificato SistemaInterscambioFatturaPA.cer per la produzione e il certificato SistemaInterscambioFatturaPATest.cer per il test nello store Trusted People.

  6. Nel Pannello di controllo, apri Attiva o disattiva le funzionalità di Windows, o vai a Gestione server>Aggiungi ruoli e funzionalità per il sistema operativo del server e attiva le seguenti funzionalità di Internet Information Services (IIS):

    • Strumenti di gestione web

      • Console di gestione IIS

    • Servizi World Wide Web

      • Funzionalità di sviluppo di applicazioni

        • Estensibilità .NET 4.7 (o 4.8)
        • ASP
        • ASP.NET 4.7 (o 4.8)
        • CGI
        • Estensioni ISAPI
        • Filtri ISAPI

      • Funzionalità HTTP comuni

        • Documento predefinito
        • Navigazione nella directory
        • Errori HTTP
        • Contenuto statico

      • Integrità e diagnostica

        • Registrazione HTTP
        • Tracciatura

      • Funzionalità delle prestazioni

        • Compressione del contenuto statico

      • Sicurezza

        • Filtro delle richieste

    • Funzionalità di .NET Framework 4.7

      • Servizi WCF

        • Attivazione HTTP

Configurare il servizio Proxy SDI in IIS

Segui questi passaggi per configurare il servizio Proxy SDI.

  1. In Lifecycle Services, vai alla raccolta Risorse condivise e seleziona il tipo di cespite Pacchetto dati.

  2. Trova Proxy SDI del servizio di fatturazione elettronica v1.1 e scaricalo nella VM.

  3. Configura il servizio:

    1. Decomprimi la cartella di archivio Proxy SDI del servizio di fatturazione elettronica che hai scaricato.

    2. Nella cartella src\FattureService apri il file appsettings.json e imposta i seguenti parametri:

      • KeyVaultUri – Specifica l'indirizzo del key vault che archivia il certificato client per il servizio di fatturazione.
      • TenantId – Specifica l'identificatore univoco globale (GUID) del tenant del cliente.
      • EnvironmentId – Specifica l'ID dell'ambiente Lifecycle Services.
      • ClientId – Specifica l'ID app della registrazione dell'app dei servizi intermedi nel tenant del cliente.
      • ClientCertificateName – Specifica il nome del Certificato di registrazione dell'app nell'insieme di credenziali delle chiavi.
      • SecurityServiceClientOptions.Endpoint – Specifica l'URL del servizio di sicurezza.
      • SecurityServiceClientOptions.Resource – Specifica l'ambito per cui ottenere il token.
      • InvoicingServiceClientOptions.Endpoint – Specifica l'endpoint del servizio di fatturazione (è possibile ottenere questo valore dal campo Endpoint URL nella sezione Parametri servizio della scheda Fatturazione elettronica della pagina Parametri documento elettronico in Finance.), dopo aver copiato Rimuovi / alla fine.
      • InvoicingServiceClientOptions.ServiceEnvironmentId – È possibile lasciare il valore predefinito ServiceEnvironment perché Microsoft prevede di deprecare questo campo nelle versioni future.
      • NotificationsFolder – Specifica la cartella in cui salvare i file di notifica in arrivo (ad esempio, C:\\Files\\).

      Suggerimento

      Puoi copiare i valori InvoicingServiceClientOptions.Endpoint e InvoicingServiceClientOptions.ServiceEnvironmentId dalla scheda Fatturazione elettronica della pagina Parametri documenti elettronici nelle app per la finanza e le operazioni (Amministrazione organizzazione>Configurazione>Parametri documenti elettronici).

    3. Nella cartella src\Clients apri il file Constants.cs e imposta i seguenti parametri:

      • ApiVersion – Aggiorna il valore a 2.0.
      • InvoicingServiceResumePath – Aggiorna il valore a /businessdocumentsubmission/resume.
      • InvoicingServiceCreateIncomingPath – Aggiorna il valore a /incomingdocuments/{0}.

    4. Nel file web.config trova la riga seguente e aggiungi l'identificazione personale del certificato server proxy.

      <serviceCertificate findValue="[certificate thumbprint]" storeLocation="LocalMachine" storeName="My" x509FindType="FindByThumbprint">

      Suggerimento

      Quando il sistema va in produzione, è possibile modificare alcuni valori nel file web.config per ridurre la quantità di informazioni di registro raccolte e risparmiare spazio su disco. Nel nodo <system.diagnostics><source> modifica il valore di switchValue in Critical,Error. Per altre informazioni, vedi Strumento Visualizzatore di tracce dei servizi (SvcTraceViewer.exe).

    5. Compilare la soluzione.

  4. Apri Gestione IIS. Nell'albero a sinistra, rimani nel nodo radice. A destra, seleziona Certificati server.

    Screenshot che mostra i certificati di servizio selezionati in Gestione IIS.

  5. Apri il menu e seleziona Importa.

  6. Nella finestra di dialogo Importa certificato, nel campo File di certificato (.pfx) specifica il percorso del file .pfx del certificato server proxy. In genere, questo file viene generato durante la registrazione del canale del servizio SDICoop. È denominato sdiproxy.com.pfx, dove sdiproxy.com è un DNS assegnato alla VM proxy.

    Screenshot del file del certificato del servizio proxy specificato nella finestra di dialogo Importa certificato.

    Nota

    Il certificato server ha una data di scadenza. Verifica questa data e organizza un'attività per ottenere un nuovo certificato quando quello attuale sta per scadere. Scopri come stabilire la corretta rotazione dei certificati utilizzati per questa integrazione nella sezione Rotazione dei certificati di questo articolo.

  7. Seleziona e tieni premuto (o fai clic con il tasto destro del mouse) Siti, quindi seleziona Aggiungi sito Web.

  8. Nella finestra di dialogo Aggiungi sito Web, nel campo Nome sito immetti un nome per il sito.

  9. Nel campo Percorso fisico indica la cartella src\FattureService.

  10. Nella sezione Associazione seleziona https nel campo Tipo.

  11. Nel campo Nome host , specifica il nome host.

  12. Lascia i campi Indirizzo IP e Porta impostati sui valori predefiniti.

  13. Assicurati che la casella di controllo Richiedi indicazione nome server sia deselezionata, poiché SDI non supporta tale tecnologia.

  14. Nel campo Certificato SSL seleziona il certificato server proxy che hai importato.

  15. Nel campo Pool di applicazioni specifica un pool per il sito e prendi nota del suo nome (ad esempio, SdiAppPool).

    Screenshot dell'impostazione nella finestra di dialogo Aggiunta di un sito Web.

  16. Dopo aver terminato la creazione del sito Web, apri il menu per Impostazioni SSL.

    Screenshot del menu per l'apertura di Impostazioni SSL.

  17. Seleziona la casella di controllo Richiedi SSL.

  18. Nel gruppo di campi Certificati client, seleziona l'opzione Richiedi.

  19. Apri Esplorazione directory e seleziona Abilita.

  20. Apri l'editor di configurazione e seleziona system.webServer>serverRuntime.

  21. Modifica i valori uploadReadAheadSize e maxRequestEntityAllowed ad almeno 10 megabit.

  22. In qualsiasi browser web, vai a serverDNS/TrasmissioneFatture.svc. Deve essere visualizzata una pagina standard sul servizio, altrimenti potresti ricevere un errore del server, come "403 - Accesso negato". Questo passaggio è necessario per garantire che serverDNS sia accessibile e non sia nascosto da un firewall o qualcos'altro.

    Screenshot del servizio controllato in un browser.

  23. Crea le seguenti cartelle per archiviare log e file:

  24. In Esplora file, concedi a SERVIZIO DI RETE e IIS AppPool\SdiAppPool (o IIS AppPool\DefaultAppPool se stai usando il pool predefinito) l'accesso alle cartelle Registri e File:

    1. Seleziona e tieni premuta (o fai clic con il tasto destro del mouse) una cartella, quindi seleziona Proprietà.
    2. Nella finestra di dialogo Proprietà nella scheda Sicurezza seleziona Modifica.
    3. Aggiungi gli utenti se non sono elencati.
    4. Ripeti i passaggi da 1 a 3 per l'altra cartella.

    Screenshot delle autorizzazioni aggiunte all'utente del servizio.

  25. Abilita la rinegoziazione del certificato client:

    1. Esegui Windows PowerShell come amministratore.

    2. Esegui il comando seguente per aprire Network Shell (netsh).

      netsh

    3. Eseguire il comando seguente per visualizzare i parametri di associazione correnti.

      http show sslcert ipport=0.0.0.0:443

    4. Copia il valore Hash del certificato dall'output e assicurati che corrisponda all'identificazione personale del certificato server.

      Screenshot del valore hash del certificato nei parametri di associazione correnti.

    5. Esegui il comando seguente per rimuovere l'associazione corrente.

      http delete sslcert ipport=0.0.0.0:443

    6. Esegui il comando seguente per aggiungere una nuova associazione con lo stesso certificato ma parametri diversi. Sostituisci il segnaposto CertificateThumbprint nel comando con il valore Hash del certificato dei comandi precedenti, ma rimuovi spazi o altri simboli.

      http add sslcert ipport=0.0.0.0:443 certhash=CertificateThumbprint appid={4dc3e181-e14b-4a21-b022-59fc669b0914} certstorename=My verifyclientcertrevocation=Disable VerifyRevocationWithCachedClientCertOnly=Disable clientcertnegotiation=Enable

      Screenshot di una nuova associazione aggiunta.

    7. Esegui il comando seguente per riavviare IIS.

      exit
iisreset

      Screenshot di una reimpostazione di IIS eseguita.

Rotazione certificati

Per eseguire la rotazione dei certificati, segui questi passaggi.

  1. Esegui la rotazione del certificato di autenticazione S2S di registrazione dell'app:

    1. Genera un nuovo certificato eseguendo lo script PowerShell dalla sezione Creare una registrazione app di questo articolo.
    2. Nel portale di Azure vai a Registrazioni app e trova l'app creata per S2S.
    3. Vai a Certificati e segreti, seleziona Carica certificato e carica il file .cer per l'autenticazione S2S.
    4. Vai a Azure Key Vault e seleziona il certificato caricato in precedenza e denominato Certificato di registrazione dell'app. Seleziona Nuova versione.
    5. Seleziona Metodo di creazione del certificato = Importa, specifica il percorso del file .pfx e la password, quindi seleziona Crea.

  2. Ruota il certificato server proxy:

    1. Richiedi un nuovo certificato server dal portale dell'ufficio tributario.

    2. Installa il file del certificato .pfx in Computer locale\Archiviazione personale.

    3. Apri Gestione IIS. Nell'albero a sinistra, seleziona il sito Web proxy. A destra, seleziona Associazioni.

    4. Seleziona l'associazione esistente e quindi Modifica.

    5. Nel campo Certificato SSL seleziona il certificato appena aggiunto. Selezionare OK.

    6. Nel file web.config trova la riga seguente e aggiungi l'identificazione personale del certificato server proxy.

      <serviceCertificate findValue="[certificate thumbprint]" storeLocation="LocalMachine" storeName="My" x509FindType="FindByThumbprint">

    7. Completa il passaggio Abilitare la rinegoziazione del certificato client nella sezione Configurare il servizio Proxy SDI in IIS di questo articolo.

  3. Ruota il certificato di entità client:

    1. Richiedi un nuovo certificato client dal portale dell'ufficio tributario.
    2. Nel portale di Azure vai a Key Vault e trova l'insieme di credenziali delle chiavi collegato al servizio.
    3. Nella sezione Certificati trova e seleziona il certificato di idendità client. Quindi seleziona Nuova versione.
    4. Seleziona Metodo di creazione del certificato = Importa, specifica il percorso del file .pfx e la password, quindi seleziona Crea.

Informativa sulla privacy

L'abilitazione della funzionalità Fattura elettronica italiana potrebbe richiedere l'invio di dati limitati. Questi dati includono l'ID di registrazione fiscale dell'organizzazione. Un amministratore può abilitare e disabilitare la funzionalità Fattura elettronica italiana. Per disabilitare la funzionalità segui la procedura seguente.

  1. Selezionare Amministrazione organizzazione>Impostazione>Parametri documento elettronico.
  2. Nella scheda Funzionalità seleziona le righe contenenti la funzionalità Fattura elettronica italiana, quindi seleziona Disabilita ora.

I dati importati da questi sistemi esterni in questo servizio online Dynamics 365 sono soggetti alla nostra informativa sulla Privacy. Per ulteriori informazioni consulta la sezione "Informativa sulla privacy" nella documentazione delle funzionalità specifiche del paese/area geografica.

Risorse aggiuntive