Condividi tramite

Generare e inviare fatture elettroniche semplificate per l'Arabia Saudita

  • Articolo

Nota

La funzionalità descritta in questo articolo è pensata per supportare i requisiti della Fase 2 dell'implementazione della fatturazione elettronica nel Regno dell'Arabia Saudita. Per informazioni sulle funzionalità legacy destinate a supportare i requisiti della Fase 1 dell'implementazione della fatturazione elettronica nel Regno dell'Arabia Saudita, vedere Generare codici QR e stamparli sulle ricevute per l'Arabia Saudita.

Questo articolo fornisce una panoramica delle funzionalità delle fatture elettroniche semplificate (e-fatture) disponibili per l'Arabia Saudita Microsoft Dynamics 365 Commerce. Questo articolo fornisce anche linee guida per l'impostazione della funzionalità.

La funzionalità fatturazione elettronica disponibile per l'Arabia Saudita in Commerce offre le seguenti capacità:

  • Genera un file XML di una fattura elettronica semplificata quando viene conclusa una transazione di vendita nel Commerce puntare di vendita (POS).
  • Genera un timbro crittografico, o una firma digitale, per la fattura elettronica semplificata.
  • Genera e stampa un codice QR per la fattura elettronica semplificata che include il timbro crittografico.
  • Inviare la fattura elettronica semplificata da Commerce headquarters alle autorità fiscali dell'Arabia Saudita (Zakat, Tax and Customs Authority [ZATCA]) a fini di rendicontazione.

Per maggiori informazioni sui requisiti fatturazione elettronica per l'Arabia Saudita, consultare il portale di fatturazione elettronica di ZATCA .

Il flusso di processo end-to-end di alto livello nel settore del commercio per l'Arabia Saudita è il seguente:

  1. Una volta completata la procedura di pagamento per una transazione di vendita nel POS, il POS utilizza Commerce Scale Unit (CSU) per inviare al runtime Commerce (CRT) una richiesta per generare e firmare digitalmente una fattura elettronica semplificata. Il quadro di registrazione fiscale e un connettore interno vengono utilizzati per implementare la generazione e la firma digitale delle fatture elettroniche semplificate.

    Nota

    Se il POS è in modalità offline, la generazione e la firma digitale di una fattura elettronica avvengono nella copia locale del POS. CRT

  2. CRT genera una fattura elettronica semplificata in formato XML. Creazione di report elettronici (ER) viene utilizzato per implementare il formato XML delle fatture elettroniche per l'Arabia Saudita. Per le fatture elettroniche semplificate nel settore del commercio e per le fatture elettroniche fiscali ordinarie in Dynamics 365 Finance viene utilizzato un formato comune.

  3. CRT invia a Commerce headquarters una richiesta per fornire un certificato digitale.

  4. Commerce headquarters estrae il certificato digitale da Azure Key Vault e lo invia a CRT. Per ulteriori informazioni su come Commerce gestisce i certificati digitali, consultare la sezione Configurare i parametri della firma digitale di questo articolo.

    Nota

    Se il POS è in modalità offline, la copia locale di CRT utilizza un certificato digitale installato localmente sul dispositivo POS.

  5. CRT calcola l'hash della fattura, firma digitalmente i dati della fattura elettronica e genera un codice QR che include l'hash della fattura e i dati della firma digitale. CRT aggiorna anche la fattura XML con l'hash della fattura e i dati della firma digitale. La fattura elettronica, l'hash della fattura, il codice QR e altre informazioni vengono salvati nel database del canale in una transazione fiscale collegata alla transazione di vendita.

  6. Il POS richiede una ricevuta di vendita da CRT. CRT crea la ricevuta, incluso il codice QR, e la invia al POS. Il POS invia la ricevuta alla stampante per ricevute.

  7. Commerce headquarters utilizza Commerce Data Exchange (CDX) per scaricare i dati delle transazioni di vendita insieme alle transazioni fiscali da CSU. I dati vengono archiviati nel database della sede centrale per tutta la durata della produzione ambiente.

  8. Commerce headquarters estrae la fattura elettronica semplificata in formato XML dalla transazione fiscale collegata alla transazione di vendita. Invia quindi la fattura elettronica alla ZATCA. L'invio è Fatto tramite l'integrazione con il servizio fatturazione elettronica. Per maggiori informazioni sulle funzionalità comuni di fatturazione elettronica disponibili in Arabia Saudita, vedere Fatture elettroniche dei clienti in Arabia Saudita.

Istituire il commercio per l'Arabia Saudita

Questa sezione descrive le impostazioni di Commercio specifiche e consigliate per l'Arabia Saudita. Per maggiori informazioni sulle funzionalità e le impostazioni comuni di Commerce, consulta la home page di Commerce.

Come prerequisito, è necessario completare la configurazione della funzionalità fatturazione elettronica per l'Arabia Saudita, inclusa la configurazione del servizio fatturazione elettronica. Per ulteriori informazioni, vedere Fatture elettroniche dei clienti in Arabia Saudita.

Per utilizzare la funzionalità Commercio specifica dell'Arabia Saudita, è necessario completare le seguenti attività:

  • Impostare il campo Paese/regione su SAU (Arabia Saudita) nell'indirizzo principale della persona giuridica.
  • Impostare il campo codice ISO su SA (Arabia Saudita) nel profilo di funzionalità POS di ogni negozio situato in Arabia Saudita.

È inoltre necessario specificare le seguenti impostazioni per l'Arabia Saudita. Tieni presente che è necessario eseguire i processi di distribuzione appropriati dopo aver completato l'impostazione.

  1. Abilitare le funzionalità di Commerce per l'Arabia Saudita nell'area di lavoro Gestione funzionalità .
  2. Impostare l'imposta sul valore aggiunto (IVA) secondo le normative IVA dell'Arabia Saudita.
  3. Configurare campi personalizzati e formati di ricevuta per stampare codici QR sulle ricevute e rispettare i requisiti normativi locali.
  4. Configurare la funzionalità di registrazione fiscale per l'Arabia Saudita per consentire la generazione e la firma digitale di fatture elettroniche semplificate.
  5. Configurare i certificati digitali e altri parametri della firma digitale per il lato canale Commerce.
  6. Specificare le configurazioni ER da utilizzare per generare fatture elettroniche semplificate nel POS e inviarle da Commerce headquarters.
  7. Configura l'invio della fattura elettronica per le fatture elettroniche semplificate generate nel POS.
  8. Abilita la firma digitale in modalità offline.

Abilita le funzionalità per l'Arabia Saudita

Abilita le seguenti funzionalità nell'area di lavoro Gestione funzionalità :

  • Capacità di fatturazione elettronica KSA per il quadro di integrazione fiscale
  • (Arabia Saudita) Integrazione di fatturazione elettronica

Imposta l'IVA secondo i requisiti dell'Arabia Saudita

È necessario creare codici IVA, fasce IVA e fasce IVA articoli. È inoltre necessario impostare le informazioni sull'IVA per prodotti e servizi. Per ulteriori informazioni su come impostare e utilizzare l'imposta sulle vendite, vedere Panoramica dell'imposta sulle vendite e Configurazione dei codici dell'imposta sulle vendite.

È inoltre necessario specificare i gruppi di imposta sulle vendite e abilitare l'opzione I prezzi includono l'imposta sulle vendite per i negozi che si trovano in Arabia Saudita.

Configurare i campi personalizzati da utilizzare nei formati di ricevuta per le ricevute di vendita

È possibile configurare il testo della lingua e i campi personalizzati utilizzati nei formati di ricevuta POS. La società predefinita dell'utente che crea l'impostazione della ricevuta deve essere la stessa persona giuridica in cui viene creata l'impostazione del testo della lingua. In alternativa, i testi nella stessa lingua devono essere creati sia nella società predefinita dell'utente sia nella persona giuridica del negozio per cui è stata creata l'impostazione.

Nella pagina Testo in lingua , nella scheda POS , aggiungere i seguenti record per le etichette dei campi personalizzati per i layout delle ricevute. Tieni presente che i valori ID lingua, ID testo e Testo visualizzati nella seguente tabella sono solo esempi. È possibile modificarli in base alle esigenze. Tuttavia, i valori ID testo utilizzati devono essere univoci e devono essere uguali o superiori a 900001.

ID lingua ID testo Testo
it-IT 900001 Codice QR

Nella pagina Campi personalizzati, aggiungi i record seguenti per i campi personalizzati per i layout di ricevuta. Tieni presente che i valori ID testo didascalia devono corrispondere ai valori ID testo specificati nella pagina Testo lingua.

Name Tipo ID testo didascalia
CODICEQR FATTURA_SA Ricevimento 900001

Nella pagina Parametri di commercio , nella scheda Parametri di configurazione , aggiungere i seguenti record.

Name Value
RetailEInvoiceFeature_SA.QrCodeHeight 200
RetailEInvoiceFeature_SA.QrCodeWidth 200

Configurare i formati di ricevuta

Per tutti i formati di ricevuta richiesti, modifica il valore del campo Comportamento stampa su Stampa sempre. È inoltre necessario configurare i profili hardware per supportare le stampanti per ricevute e abilitare la stazione hardware. Per ulteriori informazioni su come utilizzare le periferiche POS, vedere Periferiche.

Nella progettazione formato ricevuta, aggiungi i seguenti campi personalizzati alle sezioni ricevuta appropriate. I nomi dei campi corrispondono ai testi delle lingue definiti nella sezione precedente.

  • Piè di pagina: Aggiungere il seguente campo:

    • Codice QR – Questo campo stampa il codice QR per la ricevuta.

Per ulteriori informazioni su come lavorare con i formati delle ricevute, vedere Impostare e progettare i formati delle ricevute.

Impostare la registrazione fiscale

Completare i passaggi di configurazione della registrazione fiscale descritti in Configurare l'integrazione fiscale per i canali commerciali:

  1. Impostare un processo di registrazione fiscale. Assicuratevi di prendere nota delle impostazioni del processo di registrazione fiscale che sono specifiche per l'Arabia Saudita.
  2. Imposta le impostazioni di gestione degli errori.
  3. Abilitare l'esecuzione manuale della registrazione fiscale differita.

Configurare il processo di registrazione fiscale

Per abilitare il processo di registrazione fiscale per l'Arabia Saudita in Commerce headquarters, seguire, seguire questi passaggi.

  1. Scarica i file di configurazione per il fornitore di documenti fiscali e il connettore fiscale dal kit di sviluppo software (SDK) di Commerce:

    1. Apri il repository Soluzioni Dynamics 365 Commerce.
    2. Apri l'ultimo ramo di rilascio disponibile.
    3. Apri src>FiscalIntegration>ElectronicInvoiceSaudiArabia.
    4. Scarica il file di configurazione per il connettore fiscale, ConnectorSample.xml.
    5. Scarica il file di configurazione per il fornitore di documenti fiscali, DocumentProviderSample.xml.

  2. Vai a Vendita al dettaglio e commercio>Configurazione sede centrale>Parametri>Parametri condivisi. Nella Scheda Generale, imposta l'opzione Abilita integrazione fiscale su Sì.

  3. Vai a Vendita al dettaglio e commercio>Configurazione canale>Integrazione fiscale>Connettori fiscali e carica il file di configurazione del connettore fiscale scaricato in precedenza.

  4. Vai a Vendita al dettaglio e commercio>Configurazione canale>Integrazione fiscale>Fornitori di documenti fiscali e carica il file di configurazione del fornitore di documenti fiscali scaricato in precedenza.

  5. Vai a Vendita al dettaglio e commercio>Impostazione canale>Integrazione fiscale>Profili funzionali del connettore. Crea un nuovo profilo funzionale del connettore, quindi seleziona il provider di documenti e il connettore caricati in precedenza. Quindi aggiornare le impostazioni dei dati mapping come richiesto.

  6. Vai a Vendita al dettaglio e commercio>Impostazione canale>Integrazione fiscale>Profili tecnici del connettore. Crea un nuovo profilo tecnico del connettore, quindi seleziona il connettore caricato in precedenza. Impostare il tipo di connettore su Interno e aggiornare le altre impostazioni di connessione come richiesto.

  7. Vai a Vendita al dettaglio e commercio>Impostazione canale>Integrazione fiscale>Gruppi di connettori fiscali e crea un nuovo gruppo di connettori fiscali per il profilo funzionale del connettore creato in precedenza.

  8. Vai a Vendita al dettaglio e commercio>Impostazione canale>Integrazione fiscale>Processi di registrazione fiscale. Crea un nuovo processo di registrazione fiscale, crea un processo di registrazione fiscale passaggio, quindi Seleziona il gruppo di connettori fiscali creato in precedenza.

  9. Vai a Vendita al dettaglio e commercio>Configurazione canale>Configurazione POS>Profili POS>Profili funzionalità e Seleziona un profilo funzionalità collegato al negozio in cui deve essere attivato il processo di registrazione. Nella scheda Dettaglio Processo di registrazione fiscale, seleziona il processo di registrazione fiscale creato precedentemente. Nella scheda Dettaglio Servizi fiscali, seleziona il profilo tecnico del connettore creato in precedenza.

  10. Selezionare Retail e Commerce>Vendita al dettaglio e commercio IT>Programmazione della distribuzione. Apri la programmazione della distribuzione e seleziona i processi 1070 e 1090 per trasferire i dati ai database del canale.

Configurare i parametri della firma digitale

Per firmare digitalmente e inviare fatture elettroniche semplificate, è necessario ottenere i cosiddetti Cryptographic Stamp Identifiers (CSID) da ZATCA. I CSID sono sotto forma di certificati digitali. Per maggiori informazioni su come ottenere i CSID, vedere fatturazione elettronica onboarding in Arabia Saudita. È necessario ottenere un CSID per ogni registratore POS che si intende utilizzare, poiché la numerazione sequenziale e la firma digitale delle fatture elettroniche semplificate sono Fatto per ogni registratore POS.

I certificati digitali che verranno utilizzati per firmare digitalmente le fatture elettroniche semplificate sono archiviati in Key Vault. Per la modalità offline dell'app Store Commerce, la firma può essere anche Fatto utilizzando un certificato digitale archiviato nella memoria locale del computer su cui è installata l'app Store Commerce. La funzionalità Profili di certificato definiti dall'utente per negozi al dettaglio consente la configurazione dei certificati archiviati in Key Vault. Supporta anche il failover in modalità offline quando Key Vault o Commerce headquarters non sono disponibili. Questa funzionalità estende la funzionalità Gestisci segreti per i canali di vendita al dettaglio .

Per configurare i certificati e i profili dei certificati che possono essere utilizzati per la firma digitale, seguire seguire i passaggi descritti in Impostazione dei profili dei certificati. È necessario configurare un profilo di certificato separato per ogni CSID ottenuto da ZATCA.

Dopo aver configurato i profili dei certificati, seguire seguire questi passaggi.

  1. Vai a Vendita al dettaglio e commercio>Configurazione canale>Integrazione fiscale>Profili tecnici del connettore e Seleziona il profilo tecnico del connettore creato in precedenza.
  2. Per configurare i profili dei certificati per ogni registro POS, Seleziona Ignora e crea record per tutti i registri per i quali devi specificare i CSID.
  3. In ogni record, nella scheda rapida Dispositivo , nel campo Profilo certificato , specificare un profilo certificato corrispondente. Per ulteriori informazioni su come sovrascrivere le impostazioni del profilo tecnico del connettore, vedere Creare profili tecnici del connettore.

Specificare le configurazioni ER

È necessario scaricare le versioni più recenti delle seguenti configurazioni dal repository. Dataverse Per ulteriori informazioni, vedere Importa configurazioni Creazione di report elettronici (ER) da Dataverse.

  • Configurazioni per la generazione di fatture elettroniche:

    • Modello di fattura modello di dati
    • Modello di fattura mapping per il commercio (SA) modello di dati mapping
    • Formato fattura elettronica di vendita (SA)

  • Configurazioni per l'invio della fattura elettronica:

    • Modello di contesto della fattura del cliente modello di dati
    • Modello di dati dei canali di vendita al dettaglio
    • Documento fiscale al dettaglio mapping modello di dati mapping
    • Formato documento fiscale al dettaglio formato

È inoltre necessario configurare i parametri specifici della persona giuridica del formato della fattura elettronica.

  1. Nell'area di lavoro Creazione di report elettronici, selezionare Configurazioni report.

  2. Nella pagina Configurazioni , Seleziona il formato fattura elettronica di vendita (SA) importato in precedenza, quindi Seleziona Configurazioni>Parametri specifici dell'applicazione>Impostazione.

  3. Nella pagina Parametri specifici dell'applicazione , Seleziona la versione della configurazione del formato per cui si desidera configurare i parametri.

  4. Nella scheda rapida Ricerche , Seleziona il record per la ricerca PaymentMethodSubstitutionLookup .

  5. Nella scheda rapida Condizioni , crea record per collegare i metodi di pagamento configurati per i clienti nel modulo Crediti commerciali per i mezzi di pagamento definiti da ZATCA per le fatture elettroniche.

  6. Nel campo Risultato della ricerca , Seleziona un codice di mezzo di pagamento.

  7. Nel campo Nome , Seleziona un metodo di pagamento del cliente che deve corrispondere al codice del mezzo di pagamento. Se si desidera che il codice del metodo di pagamento venga selezionato quando il metodo di pagamento del cliente non è specificato, è possibile Seleziona *Vuoto*. Se desideri che il codice del mezzo di pagamento venga selezionato per qualsiasi metodo di pagamento del cliente, puoi Seleziona *Non vuoto*.

    Il campo Linea viene impostato automaticamente. Definisce l'ordine in cui vengono ricercati i codici dei mezzi di pagamento per un metodo di pagamento del cliente. È possibile modificare l'ordine utilizzando i pulsanti Sposta su e Sposta giù .

  8. Completare la configurazione impostando il campo Stato su Completato.

Configurare l'invio della fattura elettronica

Prima di impostare i parametri di invio della fattura elettronica per Commerce, configurare il servizio fatturazione elettronica in modo che possa essere utilizzato per l'Arabia Saudita. Per ulteriori informazioni, vedere Introduzione a fatturazione elettronica per l'Arabia Saudita. Per supportare la configurazione dei CSID per registro POS, seguire questi passaggi per ogni registro POS nel tuo fatturazione elettronica ambiente.

  1. Aggiungere un certificato CSID corrispondente ai parametri Key Vault di ambiente.

  2. Creare una configurazione di funzionalità di tipo pipeline di elaborazione per la funzionalità fatturazione elettronica. Per completare questo passaggio, configura la prima impostazione delle funzionalità, quindi crea nuove impostazioni delle funzionalità copiandole dalla prima e modificando i parametri.

  3. Nella configurazione delle funzionalità, seguire questi passaggi:

    1. Nell'azione di integrazione della pipeline di elaborazione, specifica il nome del certificato CSID aggiunto in precedenza.
    2. In regola di applicabilità, specificare i valori corrispondenti Store e RegisterNumber .

In Commerce headquarters, seguire vengono illustrati i passaggi per impostare i parametri di invio delle fatture elettroniche specifici per Commerce per l'Arabia Saudita.

  1. Nella pagina Parametri documento elettronico , nella scheda Documento elettronico , crea un nuovo record e specifica i seguenti parametri:

    1. Nel campo Nome tabella , Seleziona Documento di transazione fiscale.
    2. Nel campo Contesto documento , Seleziona Contesto documento fiscale al dettaglio.
    3. Nel Modello di documento elettronico mapping field, Seleziona Documento fiscale al dettaglio mapping.
    4. Seleziona sequenze numeriche per i nomi dei file inviati e gli ID di invio batch.

  2. Nella scheda Funzionalità , contrassegna la funzionalità fattura elettronica Arabia Saudita come Abilitata.

Abilita la firma digitale in modalità offline

Per abilitare la firma digitale in modalità offline, è necessario seguire seguire questi passaggi dopo aver attivato il POS su un nuovo dispositivo.

  1. Accedi a POS.
  2. Nella pagina Stato connessione database , assicurati che il database offline sia completamente sincronizzato. Quando il valore del campo Download sospesi è 0 (zero), il database è completamente sincronizzato.
  3. Esci da POS.
  4. Attendi che il database offline sia completamente sincronizzato.
  5. Accedi a POS.
  6. Nella pagina Stato connessione database , assicurati che il database offline sia completamente sincronizzato. Quando il valore del campo Transazioni in sospeso nel database offline è 0 (zero), il database è completamente sincronizzato.
  7. Riavviare POS.

Invio fattura elettronica

Per avviare l'invio di fatture elettroniche semplificate a ZATCA, eseguire l'operazione periodica Invia documenti elettronici in Commerce headquarters.

È possibile consultare il registro degli invii nella pagina Registro degli invii dei documenti elettronici .