Generer og send forenklede elektroniske fakturaer for Saudi-Arabia
Obs!
Funksjonaliteten som er beskrevet i denne artikkelen, er ment å støtte fase 2-kravene i implementeringen av e-fakturering i Saudi-Arabia. Hvis du vil ha informasjon om de eldre funksjonene som er ment å støtte fase 1-kravene i implementeringen av e-fakturering i Saudi-Arabia, kan du se Generere QR-koder og skrive dem ut på kvitteringer for Saudi-Arabia.
Denne artikkelen gir en oversikt over funksjonaliteten for forenklede elektroniske fakturaer (e-fakturaer) som er tilgjengelige for Saudi-Arabia i Microsoft Dynamics 365 Commerce. Denne artikkelen inneholder også retningslinjer for hvordan du konfigurerer funksjonen.
Funksjonaliteten for elektronisk fakturering som er tilgjengelig for Saudi-Arabia i Commerce, gir følgende funksjoner:
- Generer en XML-fil av en forenklet e-faktura når en salgstransaksjon avsluttes på Commerce-salgsstedet.
- Generer et kryptografisk stempel, eller en digital signatur, for den forenklede e-fakturaen.
- Generer og skriv ut en QR-kode for den forenklede e-fakturaen som inneholder det kryptografiske stempelet.
- Send den forenklede e-fakturaen fra Commerce headquarters til saudiarabiske skattemyndigheter (Zakat, Tax and Customs Authority [ZATCA]) for rapporteringsformål.
For mer informasjon om kravene til elektronisk fakturering for Saudi-Arabia, se ZATCA e-fakturaportal.
Prosessflyten på høyt nivå fra ende til ende i Commerce for Saudi-Arabia er som følger:
Når betalingsprosessen er fullført for en salgstransaksjon i POS, bruker POS Commerce Scale Unit (CSU) til å sende Commerce Runtime (CRT) en forespørsel om å generere og signere en forenklet e-faktura digitalt. Rammeverket for regnskapsregistrering og en intern kobling brukes til å implementere generering og digital signering av forenklede e-fakturaer.
Obs!
Hvis salgsstedet er i frakoblet modus, genereres og signeres en e-faktura digitalt i den lokale kopien av CRT på POS-maskinen.
CRT genererer en forenklet eFaktura i et XML-format. Elektronisk rapportering (ER) brukes til å implementere XML-formatet for e-fakturaer for Saudi-Arabia. Et vanlig format brukes for forenklede e-fakturaer i Commerce og vanlige skattefakturaer i Dynamics 365 Finance.
CRT sender Commerce headquarters en forespørsel om å levere et digitalt sertifikat.
Commerce headquarters trekker ut det digitale sertifikatet fra Azure Key Vault og sender det tilbake til CRT. Hvis du vil ha mer informasjon om hvordan Commerce håndterer digitale sertifikater, kan du se delen Konfigurere parametrene for digital signatur i denne artikkelen.
Obs!
Hvis salgsstedet er i frakoblet modus, bruker den lokale kopien av CRT et digitalt sertifikat som er lokalt installert på POS-maskinen.
CRT beregner fakturahashen, signerer e-fakturadataene digitalt og genererer en QR-kode som inneholder fakturahash og digitale signaturdata. CRT oppdaterer også XML-fakturaen med fakturahash og digitale signaturdata. E-fakturaen, fakturahashen, QR-koden og annen informasjon lagres i kanaldatabasen i en regnskapstransaksjon som er koblet til salgstransaksjonen.
POS ber om en salgskvittering fra CRT. CRT bygger kvitteringen, inkludert QR-koden, og sender den tilbake til salgsstedet. POS sender kvitteringen til kvitteringsskriveren.
Commerce headquarters bruker Commerce Data Exchange (CDX) til å laste ned salgstransaksjonsdata sammen med regnskapstransaksjoner fra CSU. Dataene lagres i hovedkontordatabasen gjennom hele levetiden til produksjonsmiljøet.
Commerce headquarters trekker ut den forenklede e-fakturaen i XML-format fra regnskapstransaksjonen som er koblet til salgstransaksjonen. Deretter sender den e-fakturaen til ZATCA. Innleveringen gjøres ved å integrere med tjenesten for elektronisk fakturering. Hvis du vil ha mer informasjon om de vanlige funksjonene for elektronisk fakturering som er tilgjengelige for Saudi-Arabia, kan du se Elektroniske fakturaer for kunder i Saudi-Arabia.
Konfigurer Commerce for Saudi-Arabia
Denne delen beskriver innstillingene for Commerce som er spesifikke og anbefalte for Saudi-Arabia. Hvis du vil ha mer informasjon om vanlige Commerce-funksjoner og -innstillinger, kan du se Startside for Commerce.
Som en forutsetning bør du fullføre oppsettet av elektronisk fakturering-funksjonaliteten for Saudi-Arabia, inkludert konfigurasjonen av elektronisk fakturering-tjenesten. Hvis du vil ha mer informasjon, kan du se Elektroniske fakturaer i Saudi-Arabia.
Hvis du vil bruke Commerce-funksjonaliteten som er spesifikk for Saudi-Arabia, må du utføre følgende oppgaver:
- I primæradressen for den juridiske enheten setter du feltet Land/område til SAU.
- Sett feltet ISO-kode til SA (Saudi-Arabia) i POS-funksjonalitetsprofilen for hver butikk som finnes i Saudi-Arabia.
Du må også angi følgende innstillinger for Saudi-Arabia. Merk at du må kjøre riktige distribusjonsjobber når du har fullført oppsettet.
- Aktiver Commerce-funksjoner for Saudi-Arabia i arbeidsområdet Funksjonsbehandling .
- Definer merverdiavgift (mva) i henhold til de saudiarabiske mva-forskriftene.
- Konfigurer egendefinerte felter og kvitteringsformater for å skrive ut QR-koder på kvitteringer og samsvare med de lokale forskriftskravene.
- Konfigurer funksjonaliteten for økonomisk registrering for Saudi-Arabia for å muliggjøre generering og digital signering av forenklede e-fakturaer.
- Konfigurer digitale sertifikater og andre parametere for digital signering for Commerce-kanalsiden.
- Angi ER-konfigurasjonene som skal brukes til å generere forenklede e-fakturaer på salgsstedet, og send dem fra Commerce headquarters.
- Konfigurer innsending av eFaktura for forenklede e-fakturaer som genereres på salgsstedet.
- Aktiver den digitale signaturen i frakoblet modus.
Aktiver funksjoner for Saudi-Arabia
Aktiver følgende funksjoner på arbeidsområdet Funksjonsstyring:
- Funksjon for elektronisk fakturering i Kongeriket Saudi-Arabia for rammeverket for regnskapsintegrering
- (Saudi-Arabia) Integrering av elektronisk fakturering
Definere merverdiavgift i henhold til saudiarabiske krav
Du må opprette mva-koder, mva-grupper og mva-grupper for varer. Du må også definere mva-informasjon for produkter og tjenester. Hvis du vil ha mer informasjon om hvordan du definerer og bruker mva, se Oversikt over merverdiavgift og Konfigurer mva-koder.
Du må også angi mva-grupper og aktiverer alternativet Priser inkluderer merverdiavgift for butikker som finnes i Saudi-Arabia.
Konfigurere egendefinerte felt til å brukes i kvitteringsformater for salgskvitteringer
Du kan konfigurere språkteksten og de egendefinerte feltene som skal brukes i salgsstedskvitteringsformatene. Standardfirmaet til brukeren som oppretter kvitteringsoppsettet, må være den samme juridiske enheten der språktekstoppsettet opprettes. Du kan også opprette de samme språktekstene i både brukerens standardfirma og den juridiske enheten i butikken som oppsettet er opprettet for.
På siden Språktekst, i fanen Salgssted, legger du til følgende poster for etikettene for de egendefinerte feltene for kvitteringsoppsett. Vær oppmerksom på at verdiene Språk-ID, Tekst-ID og Tekst som vises i tabellen, bare er eksempler. Du kan endre dem slik at de oppfyller dine krav. Verdiene for Tekst-ID som du bruker, må imidlertid være unike, og de må være lik eller høyere enn 900001.
| Språk-ID | Tekst-ID | Tekst |
|---|---|---|
| nb-NO | 900001 | QR-kode |
På siden Egendefinerte felt legger du til følgende poster for de egendefinerte feltene for oppsett av mottaket. Vær oppmerksom på at verdiene Tekst-ID for overskrift må samsvare med verdiene Tekst-ID som du har angitt på siden Språktekst.
| Navn | Type | Tekst-ID for overskrift |
|---|---|---|
| INVOICEQRCODE_SA | Mottak | 900001 |
På siden Handelsparametere, på fanen Konfigurasjonsparametere, legg til følgende poster.
| Navn | Verdi |
|---|---|
| RetailEInvoiceFeature_SA.QrCodeHeight | 200 |
| RetailEInvoiceFeature_SA.QrCodeWidth | 200 |
Konfigurere mottaksformater
For hvert nødvendig kvitteringsformat endrer du verdien for feltet Utskriftsatferd til Skriv alltid ut. Du må også konfigurere maskinvareprofiler for å støtte kvitteringsskrivere og aktivere Hardware Station. Du finner mer informasjon om hvordan du arbeider med POS-enheter, ved å se Eksterne enheter.
I Utforming av kvitteringsformat legger du til de egendefinerte feltene nedenfor i de aktuelle kvitteringsdelene. Feltnavnene samsvarer med språktekstene som du definerte i forrige del.
Bunntekst: Legg til følgende felter:
- QR-kode – Dette feltet skriver ut QR-kode for kvitteringen.
Hvis du vil ha mer informasjon om hvordan du arbeider med kvitteringsformater, kan du se Definere og utforme kvitteringsformater.
Konfigurere bilagsregistrering
Fullfør fremgangsmåten for registreringsoppsett slik det beskrives i Oppsett av regnskapsintegrering for Commerce-kanaler:
- Definer en regnskapsregistreringsprosess. Pass på at du noterer innstillingene for regnskapsregistreringsprosessen som er spesifikke for Saudi-Arabia.
- Angi innstillinger for feilbehandling.
- Aktiver manuell kjøring av utsatt bilagsregistrering.
Konfigurer regnskapsregistreringsprosessen
Følg disse trinnene for å aktivere regnskapsregistreringsprosessen for Saudi-Arabia i Commerce Headquarters.
Last ned konfigurasjonsfiler for regnskapsdokumentleverandøren og regnskapskoblingen fra Commerce SDK:
- Open respositoriet for Dynamics 365 Commerce-løsninger.
- Åpne den siste tilgjengelige frigivelsesgrenen.
- Åpne src>FiscalIntegration>ElectronicInvoiceSaudiArabia.
- Last ned konfigurasjonsfilen for regnskapskoblingen, ConnectorSample.xml.
- Last ned konfigurasjonsfilen for regnskapsdokumentleverandøren, DocumentProviderSample.xml.
Gå til Retail og Commerce>Hovedkvarteroppsett>Parametere>Delte parametere. På Generelt-fanen angir du Aktiver regnskapsintegrering-alternativet til Ja.
Gå til Retail og Commerce>Kanaloppsett>Regnskapsintegrering>Regnskapskoblinger, og last inn konfigurasjonsfilen for regnskapskobling som du lastet ned tidligere.
Gå til Retail og Commerce>Kanaloppsett>Regnskapsintegrering>Leverandører for regnskapsdokument, og last inn konfigurasjonsfil for regnskapsdokumentleverandør som du lastet ned tidligere.
Gå til Detaljhandel og handel>Kanaloppsett>Regnskapsintegrering>Funksjonsprofiler for kobling. Opprett en ny funksjonsprofil for kobling, og velg dokumentleverandøren og koblingen du lastet inn tidligere. Oppdater deretter innstillingene for datatilordning etter behov.
Gå til Detaljhandel og handel>Kanaloppsett>Regnskapsintegrering>Tekniske profiler for kobling. Opprett en ny teknisk profil for kobling, og velg koblingen du lastet inn tidligere. Sett koblingstypen til Intern, og oppdater de andre tilkoblingsinnstillingene etter behov.
Gå til Detaljhandel og handel>Kanaloppsett>Regnskapsintegrering>Grupper for regnskapskobling, og opprett en ny gruppe for regnskapskobling for funksjonsprofilen for koblingen som du opprettet tidligere.
Gå til Detaljhandel og handel>Kanaloppsett>Regnskapsintegrering>Regnskapsregistreringsprosesser. Opprett en ny regnskapsregistreringsprosess, opprett et trinn i regnskapsregistreringsprosessen, og velg deretter regnskapskoblingsgruppen du opprettet tidligere.
Gå til Detaljhandel og handel>Kanaloppsett>Salgsstedsoppsett>Salgsstedsprofiler>Funksjonsprofiler, og velg en funksjonalitetsprofil som er knyttet til butikkene der du vil gjøre endringene for kassastyring tilgjengelig. I hurtigfanen Regnskapsregistreringsprosess velger du regnskapsregistreringsprosessen du opprettet tidligere. I hurtigganen Regnskapstjenester velger du den tekniske profilen for koblingen som du opprettet tidligere.
Gå til Detaljhandel og handel>IT for detaljhandel og handel>Distribusjonsplan. Åpne distribusjonsplanen, og velg jobbene 1070 og 1090 for å overføre data til kanaldatabasen.
Konfigurer parametere for digital signatur
For å signere og sende inn forenklede e-fakturaer digitalt, må du skaffe såkalte kryptografiske stempelidentifikatorer (CSID-er) fra ZATCA. CSID er i form av digitale sertifikater. Hvis du vil ha mer informasjon hvordan du får CSIDer, kan du se Innføring av elektronisk fakturering i Saudi-Arabia. Du må skaffe en CSID for hver kasse på salgsstedet du vil bruke, fordi sekvensiell nummerering og digital signering av forenklede e-fakturaer gjøres per kasse på salgsstedet.
De digitale sertifikatene som skal brukes til å signere forenklede e-fakturaer digitalt, lagres i Key Vault. Når det gjelder frakoblet modus i Store Commerce-app, kan signeringen også utføres ved hjelp av et digitalt sertifikat som er lagret i den lokale lagringen av maskinen som Store Commerce-appen er installert på. Funksjonen Brukerdefinerte sertifikatprofiler for detaljhandelsbutikker aktiverer konfigurasjon av sertifikater som er lagret i Key Vault. Den støtter også failover til frakoblet modus når Key Vault eller Commerce headquarters ikke er tilgjengelig. Denne funksjonen utvider funksjonen Administrer utvidelser for detaljhandelskanaler.
Hvis du vil konfigurere sertifikater og sertifikatprofiler som kan brukes til digital signering, følger du fremgangsmåten i Konfigurere sertifikatprofiler. Du må konfigurere en egen sertifikatprofil for hver CSID du får fra ZATCA.
Når du har konfigurert sertifikatprofiler, følger du denne fremgangsmåten.
- Gå til Detaljhandel og handel>Kanaloppsett>Regnskapsintegrering>Tekniske profiler for kobling, og velg den tekniske profilen for koblingen du opprettet tidligere.
- Hvis du vil konfigurere sertifikatprofiler per kasse på salgsstedet, velger du Overstyr, og opprett poster for alle registre som du må angi CSID-er for.
- I hver oppføring, på Enhet-hurtigfanen, i Sertifikatprofil-feltet, angir du en tilsvarende sertifikatprofil. Hvis du vil ha mer informasjon om hvordan du overstyrer tekniske profilinnstillinger for kobling, kan du se Opprette tekniske profiler for kobling.
Angi ER-konfigurasjoner
Du må laste ned de nyeste versjonene av følgende konfigurasjoner fra Dataverse-repositoriet. Hvis du vil ha mer informasjon, kan du se Importere konfigurasjoner for elektronisk rapportering (ER) fra Dataverse.
Konfigurasjoner for generering av e-faktura:
- Datamodell for Fakturamodell
- Kartlegging av fakturamodell for handel (SA)-datamodellkartlegging
- Salgs-e-faktura (SA)-format
Konfigurasjoner for innsending av e-faktura:
- Kontekstmodell for kundefaktura-datamodell
- Datamodell for Data for detaljhandelskanal
- Tilordning av regnskapsdokumenter for detaljhandel-datamodelltilordning
- Regnskapsdokumentformat for detaljhandel-format
Du må også konfigurere parametere for juridisk enhet i e-fakturaformatet.
I arbeidsområdet Elektronisk rapportering velger du Rapporteringskonfigurasjoner.
På siden Konfigurasjoner velger du formatet Salgs-e-faktura (SA) som du importerte tidligere, og deretter velg Konfigurasjoner>Programspesifikke parametere>Oppsett.
På siden Programspesifikke parametere velger du versjonen av formatkonfigurasjonen du vil konfigurere parametere for.
På hurtigfanen Oppslag velger du posten for oppslaget PaymentMethodSubstitutionLookup.
På hurtigfanen Betingelser oppretter du poster for å koble betalingsmåter som er konfigurert for kunder i modulen Kundereskontro til betalingsmidler som ZATCA definerer for e-fakturaer.
I feltet Oppslagsresultat velger du en betalingsmåtekode.
I Navn-feltet velger du en kundebetalingsmåte som må tilsvare koden for betalingsmidler. Hvis du vil at koden for betalingsmidler skal velges når kundebetalingsmåten ikke er angitt, kan du velge *Tom*. Hvis du vil at koden for betalingsmidler skal velges for hvilken som helst kundebetalingsmåte, kan du velge *Ikke tom*.
Linje-feltet angis automatisk. Den definerer rekkefølgen det søkes etter koder for betalingsmåter for en kundebetalingsmåte. Du kan endre rekkefølgen ved å bruke Flytt opp- og Flytt ned-knappene.
Fullfør konfigurasjonen ved å sette feltet Tilstand til Fullført.
Konfigurere innsending av eFaktura
Før du definerer parametere for innsending av e-faktura for Commerce, må du konfigurere tjenesten elektronisk fakturering slik at den kan brukes for Saudi-Arabia. Hvis du vil ha mer informasjon, kan du se Kom i gang med elektronisk fakturering for Saudi-Arabia. Hvis du vil støtte konfigurasjonen av CSID-er per kasse på salgsstedet, følger du denne fremgangsmåten for hver kasse på salgsstedet i det elektronisk fakturering miljøet.
Legg til et tilsvarende CSID-sertifikat i Key Vault-parameterne for miljøet.
Opprett et funksjonsoppsett av typen Behandlingsforløp for funksjonen for elektronisk fakturering. Du fullfører dette trinnet ved å konfigurere det første funksjonsoppsettet, og deretter opprette nye funksjonsoppsett ved å kopiere dem fra det første og endre parameterne.
Følg disse trinnene i funksjonsoppsettet:
- I integreringshandlingen for behandlingspipelinen angir du navnet på CSID-sertifikatet du la til tidligere.
- I relevansregelen angir du de tilsvarende verdiene for Butikk og Registreringsnummer.
I Commerce headquarters følger du denne fremgangsmåten for å definere parametere for innsending av e-faktura som er spesifikke for Commerce for Saudi-Arabia.
På siden for Parametere for elektronisk dokument, i kategorien Elektronisk dokument, opprett en ny post og angi følgende parametere:
- I feltet Tabellnavn velger du Regnskapstransaksjonsdokument.
- I feltet Dokumentkontekst, velg Kontekst for regnskapsdokumenter for detaljhandel.
- I feltet Tilordning av elektronisk dokumentmodell velger du Tilordning av regnskapsdokumenter for detaljhandel.
- Velg nummerserier for innsendte filnavn og partiinnsendings-IDer.
I kategorien Funksjoner, merk funksjonen for Saudi-Arabisk elektronisk faktura som Aktivert.
Aktiver den digitale signaturen i frakoblet modus
Hvis du vil aktivere den digitale signaturen i frakoblet modus, må du følge disse trinnene etter at du har aktivert POS på en ny enhet.
- Logg deg på POS.
- På siden Status for databasetilkobling må du kontrollere at den frakoblede databasen er fullstendig synkronisert. Når verdien i feltet Ventende nedlastinger er 0 (null), synkroniseres databasen fullstendig.
- Logg av salgsstedet.
- Vent til den frakoblede databasen er fullstendig synkronisert.
- Logg deg på POS.
- På siden Status for databasetilkobling må du kontrollere at den frakoblede databasen er fullstendig synkronisert. Når verdien i feltet Ventende transaksjoner i frakoblet database er 0 (null), synkroniseres databasen fullstendig.
- Start salgssted på nytt.
Innsending av eFaktura
Hvis du vil starte sending av forenklede e-fakturaer til ZATCA, kjører du den periodiske operasjonen Send elektroniske dokumenter i Commerce headquarters.
Du kan se gjennom innsendingsloggen på siden Logg for innsending av elektronisk dokument.