Generera och skicka förenklade elektroniska fakturor för Saudiarabien
Notering
Funktionen som beskrivs i den här artikeln är avsedd att stödja fas 2-kraven för implementeringen av e-fakturering i Saudiarabien. Information om äldre funktioner som är avsedda att stödja fas 1-kraven för implementeringen av e-fakturering i Saudiarabien finns i Generera QR-koder och skriv ut dem på kvitton för Saudiarabien.
Den här artikeln ger en översikt över funktionerna för förenklade elektroniska fakturor (e-fakturor) som är tillgängliga för Saudiarabien i Microsoft Dynamics 365 Commerce. Den här artikeln innehåller också riktlinjer för hur du konfigurerar funktionen.
Funktionen för elektronisk fakturering som är tillgänglig för Saudiarabien i Commerce innehåller följande funktioner:
- Generera en XML-fil med en förenklad e-faktura när en försäljningstransaktion slutförs i Commerce-kassan.
- Generera en kryptografisk stämpel, eller en digital signatur, för den förenklade e-fakturan.
- Generera och skriv ut en QR-kod för den förenklade e-fakturan som innehåller den kryptografiska stämpeln.
- Skicka den förenklade e-fakturan från Commerce headquarters till saudiarabiska skattemyndigheter (Zakat, skatte- och tullmyndighet [ZATCA]) för rapporteringsändamål.
Mer information om kraven på elektronisk fakturering för Saudiarabien finns i ZATCA:s portal för e-fakturering.
Det övergripande processflödet från slutpunkt till slutpunkt i Commerce för Saudiarabien är följande:
När kassan är klar för en försäljningstransaktion i kassan använder kassan Commerce Scale Unit (CSU) för att skicka en begäran till Commerce Runtime (CRT) om att generera och signera en förenklad e-faktura digitalt. Ramverket för räkenskapsregistrering och ett internt anslutningsprogram används för att implementera generering och digital signering av förenklade e-fakturor.
Notering
Om kassan är i offlineläge sker genereringen och den digitala signeringen av en e-faktura i den lokala kopian av CRT på kassadatorn.
CRT genererar en förenklad e-faktura i XML-format. Elektronisk rapportering (ER) används för att implementera XML-formatet för e-fakturor för Saudiarabien. Ett vanligt format används för förenklade e-fakturor i Commerce och vanliga e-fakturor i Dynamics 365 Finance.
CRT Skickar Commerce headquarters en begäran om att tillhandahålla ett digitalt certifikat.
Commerce headquarters extraherar det digitala certifikatet från Azure Key Vault och skickar tillbaka det till CRT. Mer information om hur Commerce hanterar digitala certifikat finns i avsnittet Konfigurera parametrar för digitala signaturer i den här artikeln.
Notering
Om kassan är i offlineläge använder den lokala kopian ett CRT digitalt certifikat som är lokalt installerat på kassadatorn.
CRT beräknar fakturahashen, signerar e-fakturadata digitalt och genererar en QR-kod som innehåller fakturahash och digitala signaturdata. CRT uppdaterar även XML-fakturan med fakturans hash och digitala signaturdata. E-fakturan, fakturahashen, QR-koden och annan information sparas i kanaldatabasen i en räkenskapstransaktion som är kopplad till försäljningstransaktionen.
Kassan begär ett försäljningskvitto från CRT. CRT bygger kvittot, inklusive QR-koden, och skickar tillbaka det till kassan. Kassan skickar kvittot till kvittoskrivaren.
Commerce headquarters använder(CDX) för att ladda ned försäljningstransaktionsdata tillsammans med räkenskapstransaktioner Commerce Data Exchange från CSU. Data lagras i huvudkontorets databas under hela produktionsmiljöns livslängd.
Commerce headquarters extraherar den förenklade e-fakturan i XML-format från den räkenskapstransaktion som är kopplad till försäljningstransaktionen. Därefter skickar den e-fakturan till ZATCA. Inlämningen görs genom att integrera med den elektroniska faktureringen. Mer information om de vanliga funktionerna för elektronisk fakturering som är tillgängliga för Saudiarabien finns i Elektroniska kundfakturor i Saudiarabien.
Konfigurera Commerce för Saudiarabien
I det här avsnittet beskrivs de Commerce-inställningar som är specifika för och rekommenderas för Saudiarabien. Mer information om vanliga Commerce-funktioner och inställningar finns på startsidan för Commerce.
Som en förutsättning bör du slutföra konfigurationen av funktionen för elektronisk fakturering för Saudiarabien, inklusive konfigurationen av tjänsten för elektronisk fakturering. Mer information finns i Elektroniska kundfakturor i Saudiarabien.
Om du vill använda Commerce-funktionen som är specifik för Saudiarabien måste du utföra följande uppgifter:
- Ange fältet Land/region till SAU (Saudiarabien) i den juridiska personens primära adress.
- Ställ in fältet ISO-kod på SA (Saudiarabien) i kassafunktionsprofilen för varje butik som finns i Saudiarabien.
Du måste också ange följande inställningar för Saudiarabien. Observera att du måste köra lämpliga distributionsjobb när du har slutfört inställningarna.
- Aktivera Commerce-funktioner för Saudiarabien i arbetsytan Funktionshantering .
- Ställ in mervärdesskatt (moms) enligt de saudiarabiska momsreglerna.
- Konfigurera anpassade fält och kvittoformat för att skriva ut QR-koder på kvitton och följa lokala myndighetskrav.
- Konfigurera skatteregistreringsfunktionen för Saudiarabien för att möjliggöra generering och digital signering av förenklade e-fakturor.
- Konfigurera digitala certifikat och andra parametrar för digital signering för Commerce-kanalsidan.
- Ange de ER-konfigurationer som ska användas för att generera förenklade e-fakturor i kassan och skicka dem från Commerce headquarters.
- Konfigurera sändning av e-fakturor för förenklade e-fakturor som genereras i kassan.
- Aktivera den digitala signaturen i offlineläge.
Aktivera funktioner för Saudiarabien
Aktivera följande funktioner i arbetsytan Funktionshantering :
- KSA:s funktion för elektronisk fakturering för ramverket för räkenskapsintegration
- (Saudiarabien) Integrering av elektronisk fakturering
Ställ in moms per Saudiarabiens krav
Du måste skapa momskoder, momsgrupper och artikelmomsgrupper. Du måste även konfigurera momsinformation för produkter och tjänster. Mer information om hur du ställer in och använder moms finns i Momsöversikt och Konfigurera momskoder.
Du måste också ange momsgrupper och aktivera alternativet Priser inklusive moms för butiker som finns i Saudiarabien.
Konfigurera anpassade fält som ska användas i kvittoformat för försäljningskvitton
Du kan konfigurera språktext och anpassade fält som används i kassakvittoformat. Standardföretaget för den användare som skapar kvittoinställningen bör vara samma juridiska person där språktextinställningarna skapas. Du kan också skapa samma språktexter i både användarens standardföretag och den juridiska personen i butiken som installationen har skapats för.
På sidan Språktext på fliken Kassa lägger du till följande poster för etiketterna för de anpassade fälten för kvittolayouter. Observera att värdena Språk-ID, Text-ID och Text som visas i tabellen bara är exempel. Du kan ändra dem för att uppfylla dina krav. De text-ID-värden som du använder måste dock vara unika och de måste vara lika med eller högre än 900001.
| Språk-ID | Text-ID | Text |
|---|---|---|
| sv | 900001 | QR-kod |
På sidan Anpassade fält kan du lägga till följande poster för anpassade fält för kvittolayouter. Observera att värdena Text-ID för rubrik måste motsvara de värden för Text-ID som du angav på sidan språktext.
| Namn | Typ | Text-ID för rubrik |
|---|---|---|
| INVOICEQRCODE_SA | Inleverans | 900001 |
På sidan Commerce-parametrar , på fliken Konfigurationsparametrar , lägger du till följande poster.
| Namn | Value |
|---|---|
| RetailEInvoiceFeature_SA. QrCodeHeight | 200 |
| RetailEInvoiceFeature_SA. QrCodeWidth | 200 |
Konfigurera kvittoformat
För varje kvittoformat som krävs, ändra värdet för fältet Utskriftssätt till Skriv alltid ut. Du måste även konfigurera maskinvaruprofiler så att de stöder kvittoskrivare och aktivera Hardware Station. Mer information om hur du arbetar med kringutrustning för kassa finns i Kringutrustning.
I Layoutdesigner för kvitto, lägg till följande anpassade fält i lämpliga kvittoavdelningar. Fältnamnen motsvarar de språktexter som du definierade i föregående avsnitt.
Sidfot: Lägg till följande fält:
- QR-kod – Detta fält skriver ut QR-koden för kvittot.
Mer information om hur du arbetar med kvittoformat finns i Ställa in och utforma kvittoformat.
Ställ in räkenskapsregistrering
Slutför inställningsstegen för räkenskapsregistrering som beskrivs i Ställ in räkenskapsintegration för Commerce-kanaler:
- Ställ in en skatteregistreringsprocess. Var noga med att notera inställningarna för skatteregistreringsprocessen som är specifika för Saudiarabien.
- Ange inställningar för felhantering.
- Aktivera manuell körning av uppskjuten räkenskapsregistrering.
Konfigurera räkenskapsregistreringsprocessen
Följ dessa steg om du vill aktivera skatteregistreringsprocessen för Saudiarabien i Commerce headquarters.
Hämta konfigurationsfiler för leverantören av skattedokument och anslutningsprogrammet för räkenskapsår från Software Development Kit (SDK) för Commerce:
- Öppna Dynamics 365 Commerce Solutions databasen.
- Öppna den senast tillgängliga frisläppningsgrenen.
- Öppna src>FiscalIntegration>ElectronicInvoiceSaudiArabia.
- Hämta konfigurationsfilen för räkenskapskopplingen ConnectorSample.xml .
- Hämta konfigurationsfilen för leverantören av skattedokument DocumentProviderSample.xml .
Gå till Retail och Commerce>Administrationsinställningar>Parametrar>Delade parametrar. På fliken allmänt anger du alternativet Aktivera räkenskapsintegrering till Ja.
Gå till Inställningar för Retail och Commerce>Channel Räkenskapsintegration>>Räkenskapskopplingar och läs in konfigurationsfilen för räkenskaps anslutningsprogram som du hämtade tidigare.
Gå till Inställningar för >butiks- och handelskanal>Räkenskapsintegration>Leverantörer av skattedokument och läs in konfigurationsfilen för skattedokumentleverantör som du hämtade tidigare.
Gå till Butiks- och handelskanalinställningar Funktionsprofiler för anslutningsprogram för räkenskapsintegration>>.> Skapa en ny funktionsprofil för koppling och välj dokumentleverantören och kopplingen som du laddade tidigare. Uppdatera sedan inställningarna för mappning av data efter behov.
Gå till Konfiguration av butiks- och handelskanal , Tekniska profiler för>anslutningsprogram för räkenskapsintegration>>. Skapa en ny teknisk profil för koppling och välj kopplingen som du laddade tidigare. Ange typen anslutningsprogram till Intern och uppdatera de andra anslutningsinställningarna efter behov.
Gå till Inställningar för >butiks- och handelskanal>Räkenskapsintegration>Grupper för anslutningsprogram för räkenskapsåret och skapa en ny grupp för anslutningsprogram för funktionsprofilen för anslutningsprogrammet som du skapade tidigare.
Gå till Inställningar för Retail och Commerce>Channel>Räkenskapsintegration Räkenskapsregistreringsprocesser>. Skapa en ny räkenskapsregistreringsprocess, skapa ett steg för räkenskapsregistreringsprocessen och Välj sedan gruppen för anslutningsprogram för räkenskapsåret som du skapade tidigare.
Gå till Inställningar för >butiks- och handelskanal>, kassainställningar>, kassaprofiler>, funktionsprofiler och Välj en funktionsprofil som är kopplad till den butik där registreringsprocessen ska aktiveras. På snabbfliken Process för räkenskapsregistrering, välj räkenskapsregistreringsprocessen som du skapade tidigare. På snabbfliken Skattetjänster, välj teknisk profil för koppling som du skapade tidigare.
Gå till Butik och handel>Butik och handel-IT>Distributionsschema. Öppna distributionsschema och välj jobb 1070 och 1090 för att överföra data till kanaldatabasen.
Konfigurera parametrarna för digital signatur
För att digitalt signera och skicka förenklade e-fakturor måste du skaffa så kallade Cryptographic Stamp Identifiers (CSID) från ZATCA. CSID:n är i form av digitala certifikat. Mer information om hur du skaffar CSID:n finns i Registrering av elektronisk fakturering i Saudiarabien. Du måste skaffa ett CSID för varje kassaregister som du ska använda, eftersom sekventiell numrering och digital signering av förenklade e-fakturor görs per kassaregister.
De digitala certifikat som ska användas för att signera förenklade e-fakturor digitalt lagras i Key Vault. I offlineläget för appen Store Commerce kan signering också göras med hjälp av ett digitalt certifikat som lagras i den lokala lagringen på den dator som appen Store Commerce är installerad på. Funktionen Användardefinierade certifikatprofiler för butiker möjliggör konfiguration av certifikat som lagras i 密钥保管库. Den stöder också redundans till offlineläge när Key Vault eller Commerce headquarters inte är tillgängligt. Den här funktionen utökar funktionen Hantera hemligheter för butikskanaler .
Om du vill konfigurera certifikat och certifikatprofiler som kan användas för digital signering följer du stegen i Konfigurera certifikatprofiler. Du måste konfigurera en separat certifikatprofil för varje CSID som du får från ZATCA.
Följ dessa steg när du har konfigurerat certifikatprofiler.
- Gå till Inställningar för butiks- och handelskanal>,>Teknisk profil för anslutningsprogram för räkenskapsintegration> och Välj den tekniska profil för anslutningsprogram som du skapade tidigare.
- Om du vill konfigurera certifikatprofiler per kassaregister VäljOverride och skapar poster för alla register som du måste ange CSID för.
- I varje post, på snabbfliken Enhet , i fältet Certifikatprofil anger du en motsvarande certifikatprofil. Mer information om hur du åsidosätter inställningarna för den tekniska profilen för anslutningsprogrammet finns i Skapa tekniska profiler för anslutningsprogrammet.
Ange ER-konfigurationer
Du måste hämta de senaste versionerna av följande konfigurationer från databasen Dataverse . Mer information finns i Importera konfigurationer för Elektronisk rapportering (ER) från Dataverse.
Konfigurationer för generering av e-fakturor:
- Datamodell för fakturamodell
- Mappning av fakturamodell för Commerce (SA) mappning
- Format för e-faktura för försäljning (SA)
Konfigurationer för överföring av e-fakturor:
- Datamodell för kontextmodell för kundfaktura
- Datamodell för butikskanal
- Skattedokument för butik mappning datamodell mappning
- Format för skattedokument för butik
Du måste också konfigurera parametrar för en juridisk person i e-fakturaformatet.
På arbetsytan Elektronisk rapportering väljer du Rapporteringskonfiguration.
På sidan Konfigurationer Välj du det format för e-faktura för försäljning (SA) som du importerade tidigare och Välj sedan Programspecifika parametrar>för konfigurationer>.
På sidan Programspecifika parametrar Välj du den version av formatkonfigurationen som du vill konfigurera parametrarna för.
På snabbfliken Sökningar Välj posten för sökningen PaymentMethodSubstitutionLookup .
På snabbfliken Villkor skapar du poster för att koppla betalningsmetoder som har konfigurerats för kunder i modulen Kundreskontra till betalningsmedel som ZATCA definierar för e-fakturor.
Välj en kod för betalningsmedel i fältet Uppslagsresultat .
Välj en kundbetalningsmetod som måste motsvara koden för betalningsmedel i fältet Namn. Om du vill att koden för betalningsmedel ska väljas när kundens betalningsmetod inte har angetts kan du Välj* Tom*. Om du vill att betalningsmedelskoden ska väljas för en kundbetalningsmetod kan du Välj* Inte tom*.
Fältet Rad ställs in automatiskt. Den definierar i vilken ordning koder för betalningsmedel söks efter en kundbetalningsmetod. Du kan ändra ordningen med hjälp av knapparna Flytta upp och Flytta ned .
Slutför konfigurationen genom att ange fältet Tillstånd till Slutförd.
Konfigurera sändning av e-fakturor
Innan du konfigurerar parametrar för sändning av e-fakturor för Commerce måste du konfigurera tjänsten för elektronisk fakturering så att den kan användas för Saudiarabien. Mer information finns i Kom igång med elektronisk fakturering för Saudiarabien. Om du vill ha stöd för konfigurationen av CSID:n per kassaregister följer du dessa steg för varje kassaregister i din miljö för elektronisk fakturering.
Lägg till ett motsvarande CSID-certifikat i Key Vault parametrarna för miljön.
Skapa en funktionsinställning av typen Bearbetningspipeline för funktionen elektronisk fakturering. Slutför det här steget genom att konfigurera den första funktionskonfigurationen och sedan skapa nya funktionsinställningar genom att kopiera dem från den första och ändra parametrarna.
Följ dessa steg i funktionsinställningarna:
- I integreringsåtgärden för bearbetningspipelinen anger du namnet på det CSID-certifikat som du lade till tidigare.
- I tillämplighetsregeln anger du motsvarande Store- och RegisterNumber-värden .
I Commerce headquarters följer du de här stegen för att ställa in parametrar för sändning av e-fakturor som är specifika för Commerce för Saudiarabien.
På sidan Parametrar för elektroniskt dokument på fliken Elektroniskt dokument skapar du en ny post och anger följande parametrar:
- Välj Räkenskapstransaktionsdokument i fältet Registernamn .
- I fältet Dokumentkontext Välj Kontext för skattedokument för butik.
- I fältet Mappning av elektronisk dokumentmodell Välj mappning av skattedokument för butik.
- Välj nummerserier för skickade filnamn och batchöverförings-ID:n.
På fliken Funktioner markerar du funktionen Elektronisk faktura för Saudiarabien som Aktiverad.
Aktivera den digitala signaturen i offlineläge
Om du vill aktivera den digitala signaturen i offlineläge måste du följa dessa steg när du har aktiverat kassan på en ny enhet.
- Logga in på kassa.
- På sidan Status för databasanslutning kontrollerar du att offlinedatabasen är helt synkroniserad. När värdet i fältet Pågående hämtningar är 0 (noll) synkroniseras databasen helt.
- Logga ut från POS.
- Vänta tills offlinedatabasen är helt synkroniserad.
- Logga in på kassa.
- På sidan Status för databasanslutning kontrollerar du att offlinedatabasen är helt synkroniserad. När värdet i fältet Väntande transaktioner i offlinedatabas är 0 (noll) synkroniseras databasen helt.
- Starta om POS.
Skicka e-faktura
Om du vill initiera sändning av förenklade e-fakturor till ZATCA kör du den periodiska åtgärden Skicka elektroniska dokument i Commerce headquarters.
Du kan granska överföringsloggen på sidan Logg för överföring av elektroniska dokument.