Del via

Generer og send forenklede elektroniske fakturaer for Saudi-Arabia

  • Artikkel

Notat

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 Microsoft Dynamics 365 Commerce. Denne artikkelen inneholder også retningslinjer for hvordan du konfigurerer funksjonaliteten.

Den elektronisk fakturering funksjonaliteten 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 de elektronisk fakturering kravene for Saudi-Arabia, se e-fakturaportalen av ZATCA.

Prosessflyten på høyt nivå fra ende til ende i Commerce for Saudi-Arabia er som følger:

  1. Når betalingsprosessen er fullført for en salgstransaksjon i salgsstedet, bruker salgsstedet 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.

    Notat

    Hvis salgsstedet er i frakoblet modus, genereres og signeres en e-faktura digitalt i den lokale kopien av CRT POS-maskinen.

  2. 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 avgiftsfakturaer i Dynamics 365 Finance.

  3. CRT Sender Commerce headquarters en forespørsel om å sende et digitalt sertifikat.

  4. 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 parametere for digital signatur i denne artikkelen.

    Notat

    Hvis salgsstedet er i frakoblet modus, bruker den lokale kopien av CRT et digitalt sertifikat som er lokalt installert på POS-maskinen.

  5. 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.

  6. POS ber om en salgskvittering fra CRT. CRT bygger kvitteringen, inkludert QR-koden, og sender den tilbake til salgsstedet. POS sender kvitteringen til kvitteringsskriveren.

  7. Commerce headquarters bruker (CDX) til å laste ned salgstransaksjonsdata Commerce Data Exchange sammen med regnskapstransaksjoner fra CSU. Dataene lagres i hovedkvarterdatabasen gjennom hele levetiden til produksjonsmiljøet.

  8. 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 elektronisk fakturering tjenesten. Hvis du vil ha mer informasjon om de vanlige elektronisk fakturering funksjonene som er tilgjengelige for Saudi-Arabia, kan du se Elektroniske fakturaer for kunder i Saudi-Arabia.

Konfigurer Commerce for Saudi-Arabia

Denne delen beskriver Commerce-innstillingene som er spesifikke for og anbefalt for Saudi-Arabia. Hvis du vil ha mer informasjon om vanlige Commerce-funksjoner og -innstillinger, kan du se startsiden 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 for kunder i Saudi-Arabia.

Hvis du vil bruke Commerce-funksjonaliteten som er spesifikk for Saudi-Arabia, må du utføre følgende oppgaver:

  • Sett feltet Land/region til SAU (Saudi-Arabia) i den primære adressen for den juridiske enheten.
  • Sett ISO-kodefeltet til SA (Saudi-Arabia) i POS-funksjonalitetsprofilen for hver butikk som ligger 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.

  1. Aktiver Commerce-funksjoner for Saudi-Arabia i arbeidsområdet Funksjonsbehandling .
  2. Definer merverdiavgift (mva) i henhold til de saudiarabiske mva.-forskriftene.
  3. Konfigurer egendefinerte felt og kvitteringsformater for å skrive ut QR-koder på kvitteringer og overholde lokale forskriftskrav.
  4. Konfigurer funksjonaliteten for økonomisk registrering for Saudi-Arabia for å muliggjøre generering og digital signering av forenklede e-fakturaer.
  5. Konfigurer digitale sertifikater og andre parametere for digital signering for Commerce-kanalsiden.
  6. Angi ER-konfigurasjonene som skal brukes til å generere forenklede e-fakturaer i salgsstedet, og send dem fra Commerce headquarters.
  7. Konfigurer innsending av eFaktura for forenklede e-fakturaer som genereres i salgsstedet.
  8. Aktiver den digitale signaturen i frakoblet modus.

Aktiver funksjoner for Saudi-Arabia

Aktiver følgende funksjoner i arbeidsområdet Funksjonsbehandling :

  • Funksjonalitet for elektronisk fakturering for KSA for rammeverket for økonomisk integrering
  • (Saudi-Arabia) Integrering av elektronisk fakturering

Definere MVA 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 merverdiavgift, kan du se Mva-oversikt og Konfigurere mva-koder.

Du må også angi mva-grupper og aktivere alternativet Priser inkluderer merverdiavgift for butikker som befinner seg i Saudi-Arabia.

Konfigurere egendefinerte felt som skal brukes i kvitteringsformater for salgsmottak

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 kategorien POS legger du til følgende poster for etikettene til 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. Tekst-ID-verdiene du bruker, må imidlertid være unike, og de må være lik eller høyere enn 900001.

Språk-ID Tekst-ID Text
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 Tilgang 900001

Legg til følgende poster i kategorien Konfigurasjonsparametere på siden Handelsparametere .

Navn Value
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. Hvis du vil ha mer informasjon om hvordan du arbeider med eksterne enheter for salgssted, kan du se Eksterne enheter.

I Utforming av kvitteringsformat legger du til de egendefinerte feltene nedenfor i de aktuelle kvitteringsdelene. Feltnavn tilsvarer språktekstene du definerte i forrige del.

  • Bunntekst: Legg til følgende felt:

    • QR-kode – Dette feltet skriver ut QR-koden for kvitteringen.

Hvis du vil ha mer informasjon om hvordan du arbeider med kvitteringsformater, kan du se Definere og utforme kvitteringsformater.

Definere regnskapsregistrering

Fullfør trinnene for oppsett av regnskapsregistrering som er beskrevet i Definere økonomisk integrering for Commerce-kanaler:

  1. Definere en regnskapsregistreringsprosess. Husk å merke deg innstillingene for den økonomiske registreringsprosessen som er spesifikke for Saudi-Arabia.
  2. Angi innstillinger for feilbehandling.
  3. Aktiver manuell utførelse av utsatt regnskapsregistrering.

Konfigurer regnskapsregistreringsprosessen

Følg disse trinnene for å aktivere den økonomiske registreringsprosessen for Saudi-Arabia i Commerce headquarters.

  1. Last ned konfigurasjonsfiler for leverandøren av regnskapsdokumentet og regnskapskoblingen fra Commerce Software Development Kit (SDK):

    1. Open respositoriet for Dynamics 365 Commerce-løsninger.
    2. Åpne den siste tilgjengelige frigivelsesgrenen.
    3. Åpne src>FiscalIntegration>ElectronicInvoiceSaudiArabia.
    4. Last ned konfigurasjonsfilen for regnskapskoblingen ConnectorSample.xml.
    5. Last ned konfigurasjonsfilen for leverandøren av regnskapsdokumentet DocumentProviderSample.xml.

  2. Gå til Retail og Commerce>Headquarters-oppsett>Parametere>Delte parametere. På Generelt-fanen angir du Aktiver regnskapsintegrering-alternativet til Ja.

  3. Gå til Retail og Commerce>Kanaloppsett>Regnskapsintegrering>Regnskapskoblinger, og last inn konfigurasjonsfilen for regnskapskobling som du lastet ned tidligere.

  4. Gå til Retail og Commerce>Kanaloppsett>Regnskapsintegrering>Leverandører av regnskapsdokument, og last inn konfigurasjonsfilen for regnskapsdokumentleverandør som du lastet ned tidligere.

  5. Gå til Funksjonsprofiler for Retail og Commerce-kanaloppsett>>>Funksjonsprofiler for regnskapsintegreringskobling. Opprett en ny funksjonsprofil for kobling, og velg dokumentleverandøren og koblingen du lastet inn tidligere. Oppdater deretter dataene tildeling innstillingene etter behov.

  6. Gå til Tekniske profiler for Retail og Commerce-kanaloppsett>>Tekniske profiler> forregnskapsintegreringskobling. 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.

  7. Gå til Retail og Commerce>Kanaloppsett>Regnskapsintegrering>Regnskapskoblingsgrupper, og opprett en ny regnskapskoblingsgruppe for koblingsfunksjonsprofilen du opprettet tidligere.

  8. Gå til Retail og Commerce-kanaloppsett>>Økonomisk integrering>Regnskapsregistreringsprosesser. Opprett en ny regnskapsregistreringsprosess, opprett en regnskapsregistreringsprosess trinn, og Velg deretter regnskapskoblingsgruppen du opprettet tidligere.

  9. Gå til Retail og Commerce>Kanaloppsett>POS-oppsett>POS-profiler, funksjonalitetsprofiler>, og Velg en funksjonalitetsprofil som er koblet til butikken der registreringsprosessen skal aktiveres. I hurtigfanen Regnskapsregistreringsprosess velger du regnskapsregistreringsprosessen du opprettet tidligere. I hurtigganen Regnskapstjenester velger du den tekniske profilen for koblingen som du opprettet tidligere.

  10. 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 om hvordan du får tak i CSID-er, kan du se elektronisk fakturering onboarding 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. For frakoblet modus for Store Commerce appen kan signering også gjøres ved hjelp av et digitalt sertifikat som er lagret i det lokale lageret på 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 hemmeligheter for detaljhandelskanaler .

Hvis du vil konfigurere sertifikater og sertifikatprofiler som kan brukes til digital signering, følger du fremgangsmåten i Definere 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.

  1. Gå til Tekniske profiler for Retail og Commerce>Channel Configuration>Fiscal Connector>, og Velg den tekniske profilen for koblingen du opprettet tidligere.
  2. Hvis du vil konfigurere sertifikatprofiler per kasse på salgsstedet, Velg Overstyr og opprett poster for alle registre som du må angi CSID-er for.
  3. I hver oppføring angir du en tilsvarende sertifikatprofil i feltet Sertifikatprofil i hurtigfanen Enhet . 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 repositoriet Dataverse . Hvis du vil ha mer informasjon, kan du se Importere elektronisk rapportering konfigurasjoner (ER) fra Dataverse.

  • Konfigurasjoner for generering av e-faktura:

    • Datamodell for fakturamodell
    • Fakturamodell tildeling for handel (SA) datamodell tildeling
    • Format for e-faktura (SA) for salg

  • Konfigurasjoner for innsending av e-faktura:

    • Datamodell for kontekstmodell for kundefaktura
    • Datamodell for detaljhandelskanal
    • Regnskapsdokument for detaljhandel tildeling datamodell tildeling
    • Format for regnskapsdokument for detaljhandel

Du må også konfigurere parametere for juridisk enhet i eFaktura-formatet.

  1. I arbeidsområdet Elektronisk rapportering velger du Rapporteringskonfigurasjoner.

  2. På siden Konfigurasjoner Velg du formatet for e-faktura (SA) for salg som du importerte tidligere, og deretter Velg Konfigurasjoner > Oppsett for programspesifikke parametere>.

  3. På siden Programspesifikke parametere Velg du versjonen av formatkonfigurasjonen du vil konfigurere parameterne for.

  4. I hurtigfanen Oppslag Velg du posten for oppslaget PaymentMethodSubstitutionLookup .

  5. I hurtigfanen Betingelser oppretter du poster for å opprette en kobling betalingsmåter som er konfigurert for kunder i Kunder-modulen til betalingsmidler som ZATCA definerer for e-fakturaer.

  6. I feltet Oppslagsresultat Velg du en betalingsmiddelkode.

  7. I Navn-feltet Velg 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 Velg *Tom*. Hvis du vil at koden for betalingsmidler skal velges for en hvilken som helst kundebetalingsmåte, kan du Velg *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 hjelp av knappene Flytt opp og Flytt ned .

  8. Fullfør konfigurasjonen ved å sette Tilstand-feltet 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 Komme 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.

  1. Legg til et tilsvarende CSID-sertifikat i Key Vault-parameterne for miljøet.

  2. Opprett et funksjonsoppsett av typen Behandlingspipeline for elektronisk fakturering funksjonen. Du fullfører denne trinn ved å konfigurere det første funksjonsoppsettet, og deretter opprette nye funksjonsoppsett ved å kopiere dem fra det første og endre parameterne.

  3. Følg disse trinnene i funksjonsoppsettet:

    1. I integreringshandlingen for behandlingspipelinen angir du navnet på CSID-sertifikatet du la til tidligere.
    2. I relevansregelen angir du de tilsvarende verdiene for butikk og registernummer .

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.

  1. Opprett en ny post i kategorien Elektronisk dokument på siden Parametere for elektronisk dokument , og angi følgende parametere:

    1. I feltet Tabellnavn Velg Regnskapstransaksjonsdokument.
    2. I feltet Dokumentkontekst Velg Kontekst for regnskapsdokument for detaljhandel.
    3. I feltet Elektronisk dokumentmodell tildeling tildeling Velg regnskapsdokument for detaljhandel.
    4. Velg nummerserier for innsendte filnavn og partiinnsendings-IDer.

  2. I kategorien Funksjoner merker du funksjonen for elektronisk faktura i Saudi-Arabia som Aktivert.

Aktivere den digitale signaturen i frakoblet modus

Hvis du vil aktivere den digitale signaturen i frakoblet modus, må du følge disse trinnene når du har aktivert salgssted på en ny enhet.

  1. Logg deg på POS.
  2. På siden Status for databasetilkobling kontrollerer du at den frakoblede databasen er fullstendig synkronisert. Når verdien i feltet Ventende nedlastinger er 0 (null), synkroniseres databasen fullstendig.
  3. Logg av salgsstedet.
  4. Vent til den frakoblede databasen er fullstendig synkronisert.
  5. Logg deg på POS.
  6. På siden Status for databasetilkobling kontrollerer du at den frakoblede databasen er fullstendig synkronisert. Når verdien i feltet Ventende transaksjoner i frakoblet database er 0 (null), synkroniseres databasen fullstendig.
  7. Start POS 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 Innsendingslogg for elektronisk dokument.