Partager via


Générer et soumettre des factures électroniques simplifiées pour l’Arabie saoudite

Note

La fonctionnalité décrite dans cet article est destinée à prendre en charge les exigences de la phase 2 de l’implémentation de la facturation électronique au Royaume d’Arabie saoudite. Pour plus d’informations sur les fonctionnalités héritées destinées à prendre en charge les exigences de la phase 1 de l’implémentation de la facturation électronique dans le Royaume d’Arabie saoudite, consultez Générer des codes QR et les imprimer sur les reçus pour l’Arabie saoudite.

Cet article fournit une vue d’ensemble de la fonctionnalité de gestion des factures électroniques simplifiées (factures électroniques) disponibles pour l’Arabie saoudite en Microsoft Dynamics 365 Commerce. Cet article fournit également des instructions pour configurer la fonctionnalité.

La fonctionnalité de facturation électronique disponible pour l’Arabie saoudite dans Commerce offre les fonctionnalités suivantes :

  • Générer un fichier XML d’une facture électronique simplifiée lorsqu’une transaction commerciale est conclue dans le pointer de vente (PDV) Commerce.
  • Générez un cachet cryptographique, ou une signature numérique, pour la facture électronique simplifiée.
  • Générez et imprimez un code QR pour la facture électronique simplifiée qui comprend le tampon cryptographique.
  • Soumettez la facture électronique simplifiée de Commerce headquarters aux autorités fiscales saoudiennes (Zakat, Autorité fiscale et douanière [ZATCA]) à des fins de déclaration.

Pour plus d’informations sur les exigences de facturation électronique pour l’Arabie saoudite, consultez le portail E-Invoicing de ZATCA.

Le flux de processus général de bout en bout dans Commerce pour l’Arabie saoudite se présente comme suit :

  1. Lorsque le processus de paiement est terminé pour une transaction de vente dans le PDV, le PDV utilise Commerce Scale Unit (CSU) pour envoyer au moteur Commerce Runtime (CRT) une demande de génération et de signature numérique d’une facture électronique simplifiée. L’infrastructure d’enregistrement fiscal et un connecteur interne permettent d’implémenter la génération et la signature numérique de factures électroniques simplifiées.

    Note

    Si le PDV est en mode hors connexion, la génération et la signature numérique d’une facture électronique se produisent dans la copie locale ou CRT sur la machine de PDV.

  2. CRT génère une facture électronique simplifiée au format XML. Gestion des états électroniques (ER) permet d’implémenter le format XML des factures électroniques pour l’Arabie saoudite. Un format commun est utilisé pour les factures électroniques simplifiées dans Commerce et les factures électroniques fiscales ordinaires dans Dynamics 365 Finance.

  3. CRT envoie Commerce headquarters une demande de fourniture d’un certificat numérique.

  4. Commerce headquarters extrait le certificat numérique d’Azure Key Vault et le renvoie à CRT. Pour en savoir plus sur la manière dont Commerce gère les certificats numériques, consultez la section Configurer les paramètres de signature numérique de cet article.

    Note

    Si POS est en mode hors connexion, la copie locale utilise CRT un certificat numérique installé localement sur la machine POS.

  5. CRT calcule le hachage de la facture, signe numériquement les données de la facture électronique et génère un code QR qui inclut les données de hachage de la facture et de signature numérique. CRT met également à jour la facture XML avec le hachage de la facture et les données de signature numérique. La facture électronique, le hachage de la facture, le code QR et d’autres informations sont enregistrés dans la base de données de canal dans une transaction fiscale liée à la transaction de vente.

  6. Le point de vente demande un reçu de vente à CRT. CRT crée le ticket de caisse, y compris le code QR, puis le renvoie au PDV. Le PDV envoie le reçu à l’imprimante de reçus.

  7. Commerce headquarters utilise Commerce Data Exchange (CDX) pour télécharger les données des transactions de vente ainsi que les transactions fiscales à partir de CSU. Les données sont stockées dans la base de données du siège tout au long de la vie de votre environnement de production.

  8. Commerce headquarters extrait la facture électronique simplifiée au format XML de la transaction fiscale liée à la transaction de vente. Il soumet ensuite la facture électronique à ZATCA. La soumission se Terminé en l’intégrant au service de facturation électronique. Pour en savoir plus sur les fonctionnalités courantes de facturation électronique dont dispose l’Arabie saoudite, consultez Factures électroniques client en Arabie saoudite.

Configurer Commerce pour l’Arabie saoudite

Cette section décrit les paramètres Commerce spécifiques et recommandés pour l’Arabie saoudite. Pour plus d’informations sur les fonctionnalités et les paramètres courants de Commerce, consultez Page d’accueil Commerce.

Comme condition préalable, vous devez terminer la configuration de la fonctionnalité de facturation électronique pour l’Arabie saoudite, y compris la configuration du service de facturation électronique. Pour en savoir plus, consultez Factures électroniques client en Arabie saoudite.

Pour utiliser la fonctionnalité Commerce spécifique à l’Arabie saoudite, vous devez effectuer les tâches suivantes :

  • Définissez le champ Pays/région sur SAU (Arabie saoudite) dans l’adresse principale de l’entité juridique.
  • Définissez le champ Code ISO sur SA (Arabie saoudite) dans le profil de fonctionnalité PDV de chaque magasin situé en Arabie saoudite.

Vous devez également spécifier les paramètres suivants pour l’Arabie saoudite. Notez que vous devez exécuter des tâches de distribution appropriées après que vous avez terminé le paramétrage.

  1. Activez les fonctionnalités Commerce pour l’Arabie saoudite dans l’espace de travail Gestion des fonctionnalités.
  2. Configurer la taxe sur la valeur ajoutée (TVA) conformément à la réglementation saoudienne en matière de TVA.
  3. Configurez des champs personnalisés et des formats de ticket de caisse pour imprimer des codes QR sur les tickets de caisse et vous conformer aux exigences réglementaires locales.
  4. Configurez la fonctionnalité d’enregistrement fiscal pour l’Arabie saoudite afin de permettre la génération et la signature numérique de factures électroniques simplifiées.
  5. configurer des certificats numériques et d’autres paramètres de signature numérique côté canal Commerce ;
  6. Spécifiez les configurations ER qui doivent être utilisées pour générer des factures électroniques simplifiées dans le PDV et soumettez-les à partir de Commerce headquarters.
  7. Configurer l’envoi de factures électroniques pour les factures électroniques simplifiées générées dans le PDV.
  8. Activez la signature numérique en mode hors connexion.

Activer les fonctionnalités pour l’Arabie saoudite

Activez les fonctionnalités suivantes dans l’espace de travail Gestion des fonctionnalités :

  • Capacité de facturation électronique de l’Arabie saoudite pour le cadre d’intégration fiscale
  • (Arabie saoudite) Intégration de la facturation électronique

Paramétrer la TVA selon les exigences de l’Arabie saoudite

Vous devez créer des codes de taxe, des groupes de taxe et des groupes de taxe d’article. Vous devez également paramétrer les informations de taxe pour les produits et services. Pour plus d’informations sur la configuration et l’utilisation des taxes, consultez Vue d’ensemble des taxes etConfigurer les codes taxe.

Vous devez également spécifier des groupes de taxes et activer l’option Les prix incluent la taxe pour les magasins situés en Arabie saoudite.

Configurer les champs personnalisés à utiliser dans les formats de ticket de caisse pour les tickets de caisse vente

Vous pouvez configurer les champs de texte en langue étrangère et personnalisés utilisés dans les formats de ticket de caisse du PDV. La société par défaut de l’utilisateur qui crée le paramétrage de ticket de caisse doit être la même entité juridique que celle dans laquelle le paramétrage du texte en langue étrangère est créé. Sinon, les mêmes textes en langue étrangère doivent être créés dans la société par défaut et l’entité juridique de l’utilisateur du magasin pour lequel le paramétrage est créé.

Sur la page de texte Langue , dans l’onglet PDV, ajoutez les enregistrements suivants pour les libellés des champs personnalisés pour les dispositions de ticket de caisse. Notez que les valeurs ID langue, ID texte et Texte qui sont affichées dans la table sont uniquement des exemples. Vous pouvez les modifier pour répondre à vos besoins. Toutefois, les valeurs ID texte que vous utilisez doivent être uniques, elles doivent être égales ou supérieures à 900001.

ID langue ID texte Texte
fr-FR 900001 Code QR

Dans la page Champs personnalisés, ajoutez les enregistrements suivants pour les champs personnalisés des mises en page de ticket de caisse. Notez que les valeurs ID texte de la légende doivent correspondre aux valeurs ID texte que vous avez spécifiées dans la page Texte en langue étrangère.

Name Type ID texte de la légende
INVOICEQRCODE_SA Récépissé 900001

Dans l’onglet Paramètres de configuration de la page Paramètres de commerce, ajoutez les enregistrements suivants :

Name Valeur 
RetailEInvoiceFeature_SA. QrCodeHeight 200
RetailEInvoiceFeature_SA. QrCodeWidth 200

Configurer les formats de tickets de caisse

Pour chaque format de ticket de caisse nécessaire, modifiez la valeur du champ Comportement d’impression sur Toujours imprimer. Vous devez également configurer des profils matériels pour prendre en charge les imprimantes de ticket de caisse et pour activer la station matérielle. Pour plus d’informations sur l’utilisation des périphériques de PDV, voir Périphériques.

Dans le Concepteur de format de ticket de caisse, ajoutez des champs personnalisés suivants dans les sections du ticket de caisse approprié. Les noms de champs correspondent aux textes linguistiques que vous avez définis dans la section précédente.

  • Pied de page : Ajoutez le champ suivant :

    • Code QR– Ce champ imprime le code QR du reçu.

Pour plus d’informations sur l’utilisation des formats de tickets de caisse, voir Configurer et concevoir les formats de tickets de caisse.

Paramétrer l’enregistrement fiscal

Suivez les étapes de configuration de l’enregistrement fiscal décrites dans Configurer l’intégration fiscale pour les canaux Commerce :

  1. Configurez un processus d’enregistrement fiscal. N’oubliez pas de noter les paramètres du processus d’enregistrement fiscal spécifiques à l’Arabie saoudite.
  2. Définissez les paramètres de gestion des erreurs.
  3. Activer l’exécution manuelle de l’enregistrement fiscal différé.

Configurer le processus d’enregistrement fiscal

Pour activer le processus d’enregistrement fiscal pour l’Arabie saoudite dans Commerce headquarters, procédez comme suit suivre :

  1. Téléchargez les fichiers de configuration pour le fournisseur de documents fiscaux et le connecteur fiscal à partir du kit de développement logiciel (SDK) Commerce :

    1. Ouvrez le référentiel Dynamics 365 Commerce Solutions.
    2. Ouvrez la dernière branche de version disponible.
    3. Ouvrez src>FiscalIntegration>ElectronicInvoiceSaudiArabia.
    4. Téléchargez le fichier de configuration du connecteur fiscal ConnectorSample.xml.
    5. Téléchargez le fichier de configuration du fournisseur de documents fiscaux, DocumentProviderSample.xml.
  2. Accédez à Configuration de Retail and Commerce>Headquarters>Paramètres Paramètres>partagés. Dans l’onglet Général, définissez l’option Activer l’intégration fiscale sur Oui.

  3. Accédez à Configuration du canal>de vente au détail et de commerce>Intégration>fiscale Connecteurs fiscaux et chargez le fichier de configuration du connecteur fiscal que vous avez téléchargé précédemment.

  4. Accédez à Configuration du canal>de vente au détail et de commerce>Intégration>fiscale Fournisseurs de documents fiscaux et chargez le fichier de configuration du fournisseur de documents fiscaux que vous avez téléchargé précédemment.

  5. Accédez à Retail et Commerce>Paramétrage>du canal Intégration>fiscale Profils fonctionnels du connecteur. Créez un profil fonctionnel de connecteur et sélectionnez le fournisseur de documents et le connecteur chargé précédemment. Ensuite, mettez à jour les paramètres de mappage des données comme requis.

  6. Accédez à Vente au détail et commerce>Paramétrage>du canal Intégration>fiscale Profils techniques du connecteur. Créez un profil technique de connecteur et sélectionnez le connecteur chargé précédemment. Définissez le type de connecteur sur Interne et mettez à jour les autres paramètres de connexion selon vos besoins.

  7. Accédez à Configuration du canal de vente au détail et de commerce>Intégration>fiscale Groupes> de connecteurs fiscaux et créez un groupe de connecteurs fiscaux pour le profil fonctionnel de connecteur que vous avez crééprécédemment.

  8. Accédez à Vente au détail et commerce>Paramétrage>du canal Intégration>fiscale Processus d’enregistrement fiscal. Créez un processus d’enregistrement fiscal, créez une étape du processus d’enregistrement fiscal, puis Sélectionnez le groupe de connecteurs fiscaux que vous avez créé précédemment.

  9. Accédez à Configuration du canal>de vente au détail et de commerce>, Paramétrage>PDV, Profils>PDV, Profils de fonctionnalité, puis Sélectionnez un profil de fonctionnalité associé au magasin sur lequel le processus d’inscription doit être activé. Sur le raccourci Processus d’enregistrement fiscal, sélectionnez le processus d’enregistrement fiscal que vous avez créé précédemment. Sur le raccourci Services fiscaux, sélectionnez le profil technique du connecteur que vous avez créé précédemment.

  10. Accédez à Retail et Commerce>Retail et Commerce IT>Programme de distribution. Ouvrez le planning de distribution et sélectionnez les tâches 1070 et 1090 pour transférer des données vers la base de données des canaux.

Configurer les paramètres de signature numérique

Pour signer et soumettre numériquement des factures électroniques simplifiées, vous devez obtenir ce que l’on appelle des identifiants cryptographiques (CSID) auprès de ZATCA. Les CSID se présentent sous la forme de certificats numériques. Pour plus d’informations sur la façon d’obtenir des CSID, consultez Intégration de la facturation électronique en Arabie saoudite. Vous devez obtenir un CSID pour chaque caisse enregistreuse de PDV que vous allez utiliser, car la numérotation séquentielle et la signature numérique des factures électroniques simplifiées sont Terminé par caisse enregistreuse de PDV.

Les certificats numériques permettant de signer numériquement les factures électroniques simplifiées sont stockés dans Key Vault. Pour le mode hors connexion de l’application Store Commerce, la signature peut également être Terminé à l’aide d’un certificat numérique stocké dans le stockage local de la machine sur laquelle l’application Store Commerce est installée. La fonction Profils de certificats définis par l’utilisateur pour les magasins de détail permet de configurer les certificats stockés dans Key Vault. Elle prend également en charge le basculement en mode hors ligne lorsque Key Vault ou Commerce Headquarters n’est pas disponible. Cette fonctionnalité étend la fonction Gérer les clés secrètes pour les canaux de vente au détail.

Pour configurer des certificats et des profils de certificat pouvant être utilisés pour la signature numérique, suivez les étapes dans Configurer des profils de certificat. Vous devez configurer un profil de certificat distinct pour chaque CSID que vous obtenez auprès de ZATCA.

Après avoir configuré les profils de certificat, suivez ces étapes.

  1. Accédez à Configuration du canal>de vente au détail et de commerce>Intégration>fiscale Profils techniques du connecteur, puis Sélectionnez le profil technique du connecteur que vous avez créé précédemment.
  2. Pour configurer les profils de certificat par caisse POS, SélectionnezRemplacer , et créez des enregistrements pour toutes les caisses pour lesquelles vous devez spécifier des CSID.
  3. Dans chaque enregistrement, dans le champ Profil de certificat du raccourci Périphérique , spécifiez un profil de certificat correspondant. Pour plus d’informations sur le remplacement des paramètres de profil technique de connecteur, consultez Créer des profils techniques de connecteur.

Spécifier des configurations ER

Vous devez télécharger les dernières versions des configurations suivantes à partir du Dataverse référentiel. Pour en savoir plus, consultez Importer des configurations de Gestion des états électroniques à partir de Dataverse.

  • Configurations de génération de facture électronique :

    • Modèle de données du modèle de facture
    • Mappage du modèle de facture pour Commerce (SA) mappage du modèle de données
    • Format facture électronique vente (SA)
  • Configurations d’envoi de factures électroniques :

    • Modèle de données du modèle de contexte de facture client
    • Modèle de données de canal de vente au détail
    • mappage de documents fiscaux de vente au détailmappage de modèle de données
    • Format de document fiscal de vente au détail

Vous devez également configurer les paramètres du format de facture électronique propres à chaque entité juridique.

  1. Dans l’espace de travail Génération des états électronique, sélectionnez Configurations des états.

  2. Sur la page Configurations , Sélectionnez le format de facture électronique vente (SA) que vous avez importé précédemment, puis SélectionnezConfigurations > Paramètres>spécifiques à l’application Configuration.

  3. Sur la page Paramètres spécifiques à l’application , Sélectionnez la version de la configuration de format pour laquelle vous souhaitez configurer les paramètres.

  4. Dans le raccourci Recherches , Sélectionnez l’enregistrement pour la recherche PaymentMethodSubstitutionLookup .

  5. Dans le raccourci Conditions , créez des enregistrements pour associer les modes de paiement configurés pour les clients dans le module Comptabilité client aux moyens de paiement définis par ZATCA pour les factures électroniques.

  6. Dans le champ Résultat de la recherche, Sélectionnez un code de moyen de paiement.

  7. Dans le champ Nom , Sélectionnez un moyen de paiement client qui doit correspondre au code du moyen de paiement. Si vous souhaitez que le code moyen de paiement soit sélectionné lorsque le mode de paiement client n’est pas spécifié, vous pouvez Sélectionner *Vide*. Si vous souhaitez que le code moyen de paiement soit sélectionné pour n’importe quel mode de paiement client, vous pouvez Sélectionner *Non vide*.

    Le champ Ligne est automatiquement défini. Il définit l’ordre dans lequel les codes moyen de paiement sont recherchés pour un mode de paiement client. Vous pouvez modifier l’ordre à l’aide des boutons Déplacer vers le haut et Déplacer vers le bas .

  8. Terminez la configuration en définissant le champ État sur Terminé.

Configurer l’envoi de factures électroniques

Avant de configurer les paramètres d’envoi de factures électroniques pour Commerce, configurez le service de facturation électronique afin qu’il puisse être utilisé pour l’Arabie saoudite. Pour en savoir plus, consultez Prise en main de la facturation électronique pour l’Arabie saoudite. Pour prendre en charge la configuration des CSID par caisse POS, suivre ces étapes pour chaque caisse POS de votre facturation électronique environnement.

  1. Ajoutez un certificat CSID correspondant aux paramètres Key Vault de l’environnement.

  2. Créez une configuration de fonctionnalité du type de pipeline de traitement pour la fonctionnalité de facturation électronique. Pour terminer cette étape, configurez la première configuration de fonctionnalité, puis créez de nouvelles configurations de fonctionnalité en les copiant à partir de la première et en modifiant les paramètres.

  3. Dans le paramétrage de la fonctionnalité, suivez les étapes suivantes :

    1. Dans l’action d’intégration du pipeline de traitement, spécifiez le nom du certificat CSID que vous avez ajouté précédemment.
    2. Dans la règle d’applicabilité, spécifiez les valeurs Store et RegisterNumber correspondantes .

Dans Commerce headquarters, suivre ces étapes pour configurer les paramètres d’envoi de factures électroniques spécifiques à Commerce pour l’Arabie saoudite.

  1. Dans la page Paramètres du document électronique, dans l’onglet Document électronique, créez un enregistrement et spécifiez les paramètres suivants :

    1. Dans le champ Nom de table , SélectionnezDocument de transaction fiscale.
    2. Dans le champ Contexte du document, Sélectionnez Contexte du document fiscal de vente au détail.
    3. Dans le champ Mappage de modèle de document électronique, SélectionnezMappage de documents fiscaux de détail.
    4. Sélectionnez des souches de numéros pour les noms de fichiers soumis et les ID de soumission de lot.
  2. Dans l’onglet Fonctionnalités , marquez la fonctionnalité de facturation électronique de l’Arabie saoudite comme activée.

Activer la signature numérique en mode hors connexion

Pour activer la signature numérique en mode hors connexion, vous devez suivre ces étapes après avoir activé le PDV sur un nouvel appareil.

  1. Connectez-vous à POS.
  2. Sur la page Statut de la connexion à la base de données, assurez-vous que la base de données hors connexion est entièrement synchronisée. Lorsque la valeur du champ Téléchargements en attente est 0 (zéro), la base de données est entièrement synchronisée.
  3. Déconnectez-vous du PDV.
  4. Attendez que la base de données hors connexion soit entièrement synchronisée.
  5. Connectez-vous à POS.
  6. Sur la page Statut de la connexion à la base de données, assurez-vous que la base de données hors connexion est entièrement synchronisée. Lorsque la valeur du champ Transactions en attente dans la base de données hors connexion est 0 (zéro), la base de données est entièrement synchronisée.
  7. Redémarrer le PDV.

Envoi d’une facture électronique

Pour initier la soumission de factures électroniques simplifiées à ZATCA, exécutez l’opération périodique Soumettre des documents électroniques dans Commerce headquarters.

Vous pouvez consulter le journal des soumissions sur la page Journal de soumission des documents électroniques.