Visszajelzés

Pénzügyi regisztrációs szolgáltatás integrációját bemutató minta Ausztriára vonatkozóan

  • Cikk
  • 17 perc alatt elolvasható

Fontos

Dynamics 365 Retail jelenleg Dynamics 365 Commerce – az e-Commerce, az üzlet és a Call Center között átfogó többcsatornás kereskedelmet kínál. Ezekről a változásokról további tájékoztatást itt talál: Microsoft Dynamics 365 Commerce.

Ez a cikk áttekintést nyújt az Ausztriában található pénzügyi integrációs mintavételről Microsoft Dynamics 365 Commerce.

Az Ausztriában használt Dynamics 365 Retail pénztárgépekkel kapcsolatos helyi pénzügyi követelmények követelményeinek megfelelően az Ausztriában használt funkciók közé tartozik a pénztárgép és a külső pénzügyi regisztrációs szolgáltatás mintaintegrációja. A minta kiterjeszti a pénzügyi integrációs funkciókat. Az EFSTA EFR (Electronic Fiscal Register) megoldásán alapul, és HTTPS protokollon keresztül engedélyezi a kommunikációt az EFR szolgáltatással. Az EFR szolgáltatásnak vagy a Retail hardverállomáson, vagy egy hardverállomásról csatlakoztatott külön számítógépen kell lennie. A minta forráskód formájában kapható, és része a Retail szoftverfejlesztői csomagnak (SDK).

A Microsoft nem ad ki hardvert, szoftvert vagy dokumentációt az EFSTA rendszerből. Az EFR-megoldás bejle- és működésről az EFSTA-hoz forduljon.

Forgatókönyvek

A pénzügyi nyilvántartási szolgáltatás integrációs mintája az alábbi esetekről nyújt fedezetet Ausztriában:

  • Készpénztranzakciók regisztrálása a pénzügyi regisztrációs szolgáltatásban:

    • Részletes tranzakcióadatok küldése a pénzügyi regisztrációs szolgáltatásnak Ezek az adatok tartalmazzák az értékesítési sorok adatait, valamint az engedményekkel, kifizetésekkel és adókkal kapcsolatos adatokat.
    • Válasz rögzítése a pénzügyi regisztrációs szolgáltatástól. Ez a válasz digitális aláírást és a regisztrált tranzakcióra mutató hivatkozást tartalmaz.
    • Adók regisztrálása és hozzárendelése a pénzügyi nyilvántartási szolgáltatás adókódjaihoz.
    • A regisztrált tranzakció QR-kódának nyomtatása a nyugtára.

  • Ajándékutalvány-műveletek és vevői betétek regisztrálása nem készpénzes tranzakcióként az pénzügyi regisztrációs szolgáltatásban:

    • Ajándékutalvány kiadása vagy pénz hozzáadása
    • Vevői számla letétének regisztrálása.
    • Vevői rendelés letétének regisztrálása.

  • Nem értékesítési tranzakciók és események regisztrálása nem készpénzes tranzakcióként a pénzügyi regisztrációs szolgáltatásban:

    • Műszak megnyitása és Műszakzárás
    • Kezdő összeg, lebegőszós bejegyzés és fizetőeszköz kivétele
    • Ár felülbírálása
    • Adó felülírása
    • Nyugtamásolat kinyomtatása
    • Fiók kinyitása
    • X-jelentés nyomtatása
    • Z-jelentés nyomtatása

  • A napvégi kivonatok (X/Z-jelentések) nyomtatása, amelyek Ausztria-specifikus mezőket tartalmaznak:

    • A vevőknek nyújtott termékek vagy szolgáltatások teljes száma
    • Értékesítés részletezése adómkulcs szerint
    • Kifizetések lebontása pénztáros/pénztárgép kezelője szerint
    • Árengedmények és visszatérítések, amelyek csökkentik a napi értékesítéseket
    • Nulla értékesítés (give egyed)

  • Hibakezelés, például a következő lehetőségek:

    • Próbálja meg újra a pénzügyi regisztrációt, ha egy újrapróbálkozási művelet lehetséges, például ha a pénzügyi regisztrációs szolgáltatás nem érhető el, nem áll készen vagy nem válaszol.
    • Pénzügyi regisztráció elhalasztása.
    • Pénzügyi regisztráció kihagyása, vagy a tranzakció megjelölése regisztráltként, és infókódok beírása a hiba okának és a további információknak a rögzítéséhez.
    • Ellenőrizze a pénzügyi regisztrációs szolgáltatás elérhetőségét, mielőtt új értékesítési tranzakciót nyit meg vagy egy értékesítési tranzakciót véglegesítettek.

Ajándékutalványok

A pénzügyi regisztrációs szolgáltatás integrációs mintája az ajándékutalványokkal kapcsolatos következő szabályokat valósítja meg:

  • Az ajándékutalvány-kiadáshoz · és az ajándékutalvány-műveletekhez hozzáadás készpénztranzakcióból származó értékesítési sorok kihagyása Ahelyett, hogy ezeket a sorokat egy készpénztranzakció részeként regisztrálja, külön, nem készpénzes tranzakcióként regisztrálja őket a pénzügyi regisztrációs szolgáltatásban.
  • Ne nyomtass adócsoport-részletezést és QR-kódot a nyugtára, ha a nyugta csak ajándékutalvány-sorokból áll.
  • A tranzakcióban kiadott vagy újra felszámított ajándékutalványok teljes összegének nyomtatása a nyugtán található készpénztranzakció összegtől függetlenül.
  • A kifizetési sorok számított módosításainak mentése a csatorna-adatbázisban a megfelelő pénzügyi tranzakcióra való hivatkozással.
  • Az ajándékutalványos fizetés rendszeres fizetésnek számít.

Vevői betétek és vevői rendelési betétek

A pénzügyi nyilvántartási szolgáltatás integrációs mintája a vevői betétekre és a vevői rendelési betétekre vonatkozó következő szabályokat valósítja meg:

  • Nem készpénzes tranzakció regisztrálása, ha a tranzakció vevői letét.
  • Nem készpénzes tranzakció regisztrálása, ha a tranzakció csak vevői rendelés letétét vagy a vevői rendelés letéti visszatérítését tartalmazza.
  • A vevői rendelés letéti összegének levonása a kifizetési sorokból a vevői rendelés létrehozásakor.
  • A csatorna-adatbázis fizetési sorai kiszámított korrekcióinak mentése egy vevői rendelés pénzügyi tranzakciójára való hivatkozással.

A minta korlátai

A pénzügyi nyilvántartási szolgáltatás csak azokat a helyzeteket támogatja, amelyekben az ár tartalmazza az adót. Emiatt az üzletek és a vevők esetében az Ár tartalmazza az áfa beállítását Igen beállítást kell beállítani.

A Commerce for Austria beállítása

Ez a szakasz az Ausztriához specifikus és ajánlott Kereskedelmi beállításokat írja le. A további tudnivalókat lásd a Commerce honlapon.

Az Ausztria-specifikus funkciók használatához a következő beállításokat kell megadni:

  • A jogi személy elsődleges címében állítsa az Ország/terület mezőt AUT (Ausztria) beállításra.
  • Minden, Ausztriában található üzlet PÉNZTÁRi funkcióprofiljában állítsa az ISO-kód mezőt AZ AUSZTRIA (Ausztria) kódra.

A következő beállításokat kell megadni Ausztriához is. Ne feledje, hogy a beállítások befejezése után futtatnia kell a megfelelő elosztási feladatokat.

Áfa beállítása osztrák követelmények szerint

Létre kell hoznia áfakódokat, áfacsoportokat és cikkadócsoportokat. A termékekre és szolgáltatásokra vonatkozó áfaadatokat is be kell állítani. Az áfa funkció beállítási és használatával kapcsolatos további tudnivalókat lásd: Áfa áttekintése.

Az értékesítési nyugtákra rövidített kódot nyomtathat az áfakódhoz (például "A" vagy "B"). A funkció elérhetővé tenni az Áfakódok nyomtatása lapon található Kód nyomtatása mezőt.

Üzletek beállítása

Az Üzletek lapon frissítse az üzlet adatait. Konkrétabban:

  • Adja meg az Áfacsoport mezőben azt az áfacsoportot, amely az alapértelmezett vevőnek való értékesítéshez használatos.
  • Az Árak tartalmazzák az áfa beállítást Igen beállításra.
  • Állítsa be a Név mezőt a vállalat nevére. Ezzel a módosítással garantálható, hogy a vállalat neve megjelenik az értékesítési nyugtán. Másik lehetőségként a vállalat nevét felveheti az értékesítési nyugtaelrendezésbe szabadszövegként.
  • Állítsa be az Adóazonosító szám (TIN) mezőt a vállalat azonosítószáma mezőre. Ezzel a módosítással garantálható, hogy a vállalat azonosítószáma megjelenik az értékesítési nyugtán. Másik lehetőségként a vállalat azonosítóját hozzáadhatja az értékesítési nyugta elrendezéséhez szabadszövegként.

Funkcióprofilok beállítása

POS-funkcióprofilok beállítása:

  • Állítsa be a nyugtaszámozást a Nyugtaszámozás gyorsábra az értékesítés, · értékesítési rendelés és visszáru-bevételezési tranzakciótípusok rekordjainak létrehozásával vagy frissítésével.

Egyéni mezők konfigurálása az értékesítési nyugták nyugtaformátumában való használhatóra

A POS nyugtaformátumokban használt nyelvi szövegeket és egyéni mezőket beállíthatja. A nyugtabeállítást létrehozó felhasználó alapértelmezett vállalatának ugyanaznak kell lennie, mint ahol a nyelvi szöveg beállítása létre van hozva. Másik lehetőségként ugyanazt az idegen nyelvű szöveget kell létrehozni a felhasználó alapértelmezett vállalatában, valamint annak az üzletnek a jogi személyében, amely számára a beállítást létrehozták.

Adja hozzá a Nyelv szöveglapon a következő rekordokat a nyugtaelrendezések egyéni mezőinek címkéihez. Ne feledje, hogy a táblázatban látható nyelvazonosító, szövegazonosító és szöveg értékek példák. A beállításokat az igényeknek megfelelően módosíthatja. A használt szövegazonosító értékeknek azonban egyedinek kell lennie, és nem lehet kisebbek a 900001.

Adja hozzá a következő POS-címkéket a tábla Nyelvi szövegének POS szakaszához:

Nyelvazonosító Szövegazonosító Szöveg
hu 900001 QR-kód
hu 900002 Folytonos szám
hu 900003 Kiskereskedelmi adó nyomtatási kódja
hu 900004 Összesen (értékesítés)
hu 900005 Adó összesen (értékesítés)
hu 900006 Adóval (értékesítéssel) összesen
hu 900007 Adó összege (értékesítés)
hu 900008 Adóalap (értékesítés)

Adja hozzá a következő rekordokat az Egyéni mezők lapon a nyugtaelrendezések egyéni mezőihez. A felirat szövegazonosító értékeinek meg · kell felelniük a Nyelv szövegoldalán megadott szövegazonosító értékeknek:

Név Típus Képaláírás-szöveg azonosítója
QRCODE Fogadás 900001
FOLYTONOS SZÁM Fogadás 900002
RETAILPRINTCODE Fogadás 900003
BEVÉTELI Fogadás 900004
SALESTOTALTAX Fogadás 900005
SALESTOTALLUDETAX Fogadás 900006
SALESTAMOUNT ÖSSZEG Fogadás 900007
SALESTAXBASIS Fogadás 900008

Megjegyzés

Fontos, hogy a megfelelő egyéni mezőneveket adja meg az előző táblázatban felsoroltak szerint. Helytelen egyéni mezőnév esetén hiányoznak az adatok a nyugtákból.

Nyugtaformátumok konfigurálása

Minden szükséges bevételezési formátumnál módosítsa a Nyomtatás viselkedése mező értékét "Mindig nyomtatás" értékre.

A Nyugtaformátum-tervezőben adja hozzá a következő egyéni mezőket a megfelelő nyugtaszakaszokhoz. A mezőnevek megfelelnek az előző szakaszban meghatározott nyelvszövegnek.

  • Fejléc: Adja hozzá a következő mezőket:

    • Az üzlet neve és adóazonosító szám mezői, amelyek a vállalat nevének és azonosító számának a nyugtákra való nyomtatására használhatók. Másik lehetőségként a vállalat nevét és azonosító számát is hozzáadhatja az elrendezéshez szabadszövegként.
    • Üzlet címe, Dátum, Idő 24h, Nyugta száma és Jegyzék száma mezők
    • Folytonos szám mezők, amelyek azonosítják a készpénztranzakciók számát a pénzügyi regisztrációs szolgáltatásban.

  • Sorok: Adja hozzá a következő mezőket:

    • Cikknév.
    • Mennyiség
    • Teljes ár adóval.
    • Kiskereskedelmi adó – nyomtatási kód, amely a cikkre vonatkozó áfakódnak megfelelő rövidített kód nyomtatására használható.

  • Lábléc: Adja hozzá a következő mezőket:

    • Fizetési mezők, amelyek segítségével kinyomtathatók az egyes fizetési módok kifizetési összegei. Hozzáadhatja például a Fizetőeszköz neve és a Fizetőeszköz összege mezőket az elrendezés egy sorában.

    • Értékesítés összesen mezőcsoportja:

      • Összesen (értékesítés) mező, amely a nyugta teljes készpénzes értékesítésének nyomtatására használatos. Az összeg nem tartalmazza az adót. Az előlegek és ajándékutalvány-műveletek nem tartoznak ide.
      • Az Értékesítés adóval együtt mező összege, amely a bevételezés teljes készpénzes értékesítésének nyomtatására használatos. Az összeg tartalmaz adót. Az előlegek és ajándékutalvány-műveletek nem tartoznak ide.
      • Összes adó (értékesítés) mező, amely a bevételezés készpénzes értékesítések teljes adóösszegének nyomtatására használatos. Az előlegek és ajándékutalvány-műveletek nem tartoznak ide.

    • Adóeltérés mezőcsoportja. Ennek a mezőcsoportnak az összes mezőjét egy külön sorba kell nyomtatni.

      • Adóazonosító mező, amely egy szabványos mező, amely lehetővé teszi az egyes áfakódok áfaösszegzésének nyomtatását. A mezőt hozzá kell adni egy új sorhoz.
      • Adókulcs mező, amely az áfakód tényleges adómértékének nyomtatására használt szokásos mező.
      • Az Adóalap (értékesítés) mező, amely a bevételezés teljes készpénzes értékesítésének nyomtatására használható az áfakódhoz. Az előlegek és ajándékutalvány-műveletek nem tartoznak ide.
      • Adó összege (értékesítés) mező, amely a bevételezés adóösszegének nyomtatására használható az áfakódhoz készpénzes értékesítéshez.
      • Kiskereskedelmi adó – nyomtatási kód mező, amely az áfakódnak megfelelő rövidített kód nyomtatására használható.

    • QR-kód mező, amely a regisztrált készpénztranzakcióra való hivatkozás QR-kód formájában való nyomtatására szolgál.

      Megjegyzés

      A QR-kód értékét a pénzügyi jegyzék válaszából olvassa be a program. Az EFR válaszában csak akkor aD vissza egy QR-kódot, ha az EFR konfiguráció Attribútumok mezőjének értékét az EFSTA dokumentáció írja le. Az EFR konfiguráció Attribútumok mezőjében a QR-kódformátumot BMP-kódra kell állítani.

A nyugtaformátumok beállításával és tervezésával kapcsolatos további tudnivalókat lásd a Nyugtaformátumok beállításával és tervezésával kapcsolatban.

Pénzügyi integráció beállítása Ausztriához

Az adóregisztrációs szolgáltatás integrációs mintája az adóügyi integrációs funkciókon alapul, és része a Retail SDK csomagnak. A minta a FiscalIntegration Efr src \\ mappában található a megoldások tárházában (Dynamics 365 Commerce például a release/9.33 mintában).... A minta egy pénzügyi dokumentumszolgáltatóból áll, amely a Commerce runtime () futási idő kiterjesztése CRT, és egy pénzügyi csatlakoztató, amely a Commerce Hardware Station kiterjesztése. A Retail SDK használatával kapcsolatos további tudnivalókat lásd a Retail SDK architektúrája és a független csomagolásos SDKfelépítési csővezetékének beállítása.

Figyelmeztetés

Az új független csomagolási és bővítési modell korlátai miatt jelenleg nem használható ehhez a pénzügyi integrációs mintához. A Retail SDK korábbi verzióját egy fejlesztő virtuális gépen (VM) kell használnia a Lifecycle Services (LCS) Microsoft Dynamics szolgáltatásban. A további tudnivalókat lásd az Ausztriához (legacy) vonatkozó pénzügyi integrációs minta telepítési irányelveinél. Az új független csomagolási és kiterjesztésmodell támogatása a pénzügyi integrációs mintákkal a későbbi verziókban tervezve lesz.

A pénzügyi integráció beállítási lépéseit a Commerce-csatornákhoz való pénzügyi integráció beállítása lépései szerint lehet végrehajtani:

  1. Pénzügyi regisztrációs folyamat beállítása. Ezenkívül jegyezze fel a pénzügyi nyilvántartási folyamatnak az ehhez a pénzügyi regisztrációs szolgáltatásintegrációs mintához specifikus beállításait.
  2. Hibakezelési beállítások megadása.
  3. Halasztott pénzügyi regisztráció kézi végrehajtásának engedélyezése
  4. Csatornaösszetevők konfigurálása

A regisztrációs folyamat beállítása

A regisztráció engedélyezéséhez kövesse az alábbi lépéseket a Commerce Headquarters beállításához. A további tudnivalókat lásd A Commerce-csatornák pénzügyi integrációjának beállítása.

  1. A pénzügyi bizonylat szolgáltatójának és a pénzügyi csatlakoztatónak megfelelő konfigurációs fájlok letöltése:

    1. Nyissa meg Dynamics 365 Commerce a megoldástárházat.
    2. Az SDK/alkalmazás verziójának (például kiadás/9.33) megfelelő kiadási ágverzió kiválasztása.
    3. A pénzügyiintegration-efr.rc >> megnyitása
    4. Nyissa meg a Configurations > DocumentProviders fájlt, és töltse le a pénzügyi dokumentumszolgáltató konfigurációs fájljait: DocumentProviderFiscalEFRSampleAustria.xml és DocumentProviderNonFiscalEFRSampleAustria.xml (például a fájlok helye a kiadáshoz/9.33).
    5. Töltse le a pénzügyi csatlakoztató konfigurációs fájlját a Configurations Connectors >> ConnectorEFRSample.xml fájlban (például a release/9.33 fájlban).

    Figyelmeztetés

    Az új független csomagolási és bővítési modell korlátai miatt jelenleg nem használható ehhez a pénzügyi integrációs mintához. A Retail SDK előző verzióját kell használnia egy fejlesztői VM-n az LCS-en. A pénzügyi integrációs minta konfigurációs fájljai a Retail SDK készlet alábbi mappáiban találhatók az LCS egy fejlesztői VIRTUÁLIS eszközében:

    • Pénzügyi bizonylat szolgáltatójának konfigurációs fájljai: RetailSdk\ SampleExtensions\ CommerceRuntime\ Extensions.DocumentProvider.EFRSample\ konfiguráció
    • Pénzügyi csatlakoztató konfigurációs fájlja: RetailSdk\ SampleExtensions\ HardwareStation\ Extension.EFRSample\ konfiguráció

    Az új független csomagolási és kiterjesztésmodell támogatása a pénzügyi integrációs mintákkal a későbbi verziókban tervezve lesz.

  2. Lépjen a Retail és Commerce > Központ beállítása > Paraméterek > Commerce megosztott paraméterek menüpontra. Az Általános lapon állítsa a Pénzügyi integráció engedélyezése lehetőséget Igen beállításra.

  3. Menjen a Retail and Commerce > Csatorna beállítása > pénzügyi integráció > pénzügyi dokumentumszolgáltatóihoz, és töltse be a korábban letöltött pénzügyi bizonylatszolgáltató konfigurációs fájljait.

  4. Menjen a Retail és Commerce > csatorna beállítása > Pénzügyi integráció > pénzügyi csatlakoztatóihoz, és töltse be a korábban letöltött pénzügyi csatlakoztató konfigurációs fájlját.

  5. Ugrás a Retail és Commerce > csatorna beállítása > Fiscal integration > Connector funkcionális profiljaihoz. Hozzon létre két új funkcionális profilt a csatlakoztatóhoz, egyet minden korábban betöltött pénzügyi dokumentumszolgáltatóhoz, és válassza ki a korábban betöltött pénzügyi csatlakoztatóját. Szükség szerint frissítse az adatleképezés beállításait.

  6. Ugrás a Retail és Commerce > csatorna beállítása > Fiscal integration > Connector műszaki profilokhoz. Hozzon létre egy új technikai csatlakoztatóprofilt, és válassza ki a korábban betöltött pénzügyi csatlakoztatóját. Szükség szerint frissítse a csatlakoztató beállításait.

  7. Ugrás a Retail és Commerce > csatorna beállítása Pénzügyi > integráció > Pénzügyi csatlakoztatócsoportjához Hozzon létre két új pénzügyi csatlakoztatócsoportot, és egyet minden korábban létrehozott funkcionális profilhoz.

  8. Ugrás a Kiskereskedelmi és Commerce csatorna > beállítása pénzügyi > integráció > pénzügyi regisztrációs folyamatainak lépéseihez. Hozzon létre egy új pénzügyi regisztrációs folyamatot és két pénzügyi regisztrálási folyamatot, és válassza ki a korábban létrehozott pénzügyi csatlakoztatócsoportokat.

  9. Ugorjon a következő elemre: Retail és Commerce > Csatorna beállítása > Pénztárbeállítás > Pénztárprofilok > Funkcióprofilok. Válasszon ki egy funkcióprofilt, amely ahhoz az üzlethez kapcsolódik, ahol aktiválni kell a regisztrációs folyamatot. A Pénzügyi regisztráció folyamata gyors oldalon válassza ki a korábban létrehozott pénzügyi regisztrációs folyamatot. Ha engedélyezni szeretné a nem pénzügyi események regisztrációját a POS terminálon, · a Funkciók gyorsgombon, a POS alatt állítsa a Vizsgálat lehetőséget Igen beállításra.

  10. Lépjen a Kiskereskedelem és kereskedelem > Csatorna beállítás > POS beállítás > POS profilok > Hardverprofilok pontra. Válassza ki azt a hardverprofilt, amely ahhoz a hardverállomáshoz van kapcsolva, amelyhez a pénzügyi nyomtató csatlakozik. Válassza ki a korábban létrehozott csatlakoztató-technikai profilt a Pénzügyi perifériák gyorstára.

  11. Nyissa meg az elosztási ütemezést (Retail and Commerce > Retail és Commerce IT > Distribution schedule), majd válassza ki a 1070-es és 1090-es feladatokat az adatoknak a csatorna-adatbázisba történő átviteléhez.

Alapértelmezett adatleképezés

A pénzügyiintegrációs minta részeként megadott pénzügyi bizonylatszolgáltató konfigurációja a következő alapértelmezett adatleképezést tartalmazza:

  • Áfakulcsok megfeleltetése – az áfakódok százalékértékének megfeleltetése a pénzügyi szolgáltatásnak elküldött kérések TaxG (adócsoport) attribútumának értékeihez. Az alapértelmezett hozzárendelés:

    A: 20.00; B: 10.00; C: 13.00; D: 0.00; E: 19.00; F: 7.00

    Minden pár első összetevője egy áfacsoportot képvisel, amelyet az EFR pénzügyi regisztrációs szolgáltatás támogat. A második összetevő a megfelelő áfakulcsot képviseli. Az EFR által Ausztriában támogatott áfacsoportokkal kapcsolatos további tudnivalókat lásd az EFR hivatkozásban.

Pénzügyi csatlakoztató beállításai

A pénzügyi integrációs minta részeként biztosított pénzügyi csatlakoztató konfigurációja a következő beállításokat tartalmazza:

  • Végpont címe – a pénzügyi regisztrációs szolgáltatás URL-címe.
  • Eszköz időtúllépése – az az idő ezredmásodpercben, ahányszor a pénzügyi csatlakoztató választ vár a pénzügyi regisztrációs szolgáltatástól.
  • Pénzügyi regisztrációs értesítések megjelenítése – ez a jelző határozza meg, hogy a pénzügyi regisztrációs szolgáltatás által visszaadott értesítéseket meg kell-e mutatni a kezelőnek.

Csatornaösszetevők konfigurálása

Figyelmeztetés

Az új független csomagolási és bővítési modell korlátai miatt jelenleg nem használható ehhez a pénzügyi integrációs mintához. A Retail SDK előző verzióját kell használnia egy fejlesztői VM-n az LCS-en. A további tudnivalókat lásd az Ausztriához (legacy) vonatkozó pénzügyi integrációs minta telepítési irányelveinél.

Az új független csomagolási és kiterjesztésmodell támogatása a pénzügyi integrációs mintákkal a későbbi verziókban tervezve lesz.

A fejlesztői környezet beállítása

A minta tesztelésére és kiterjesztésére fejlesztői környezet beállításához kövesse az alábbi lépéseket.

  1. Le kell tölteni vagy le kell Dynamics 365 Commerce tölteni a megoldástárházat. Válassza ki a kiadási ág megfelelő verzióját az SDK-nak vagy az alkalmazásverziónak megfelelően. A további tudnivalókat lásd a Retail SDK-minta- és hivatkozáscsomagok letöltése aHub és NuGet a.

  2. Nyissa meg az EFR-megoldást a Dynamics365Commerce.Solutions\ FiscalIntegration\ Efr\ EFR.sln fájlban, és építse fel.

  3. A következő CRT bővítmények telepítése:

    1. A bővítmény telepítője CRT:

      • Commerce Scale Unit: Az Efr ScaleUnit.EFR.Installer\\ bin\ debug\ net461 \ mappában keresse meg a ScaleUnit.EFR.Installer telepítőjét.
      • Helyi CRT a Modern POS terminálon: Az Efr\ ModernPOS\ ModernPOS.EFR.Installer\ bin\ hibakeresési\ net461 mappában keresse meg a ModernPOS.EFR.Installer telepítőjét.

    2. A kiterjesztés telepítőjét CRT a következő parancssorból indítja el:

      • Commerce Scale Unit:

        ScaleUnit.EFR.Installer.exe install --verbosity 0

      • Helyi CRT a Modern POS terminálon:

        ModernPOS.EFR.Installer.exe install --verbosity 0

  4. Pénzügyi csatlakoztató-bővítmények telepítése:

    A pénzügyi csatlakoztató bővítményei a hardverállomásra vagy a PÉNZTÁRi pénztárgépre telepíthetők.

    1. Hardverállomás-bővítmények telepítése:

      1. Az Efr HardwareStation\ HardwareStation.EFR.Installer\ bin\ hibakeresési\ net461\ mappában keresse meg a HardwareStation.EFR.Installer telepítőjét .

      2. A kiterjesztés telepítőjét a parancssorból a következő parancs futtatásával indítja el.

        HardwareStation.EFR.Installer.exe install --verbosity 0

    2. Pos-bővítmények telepítése:

      1. Nyissa meg a POS pénzügyi csatlakoztató minta megoldását a Dynamics365Commerce.Solutions\ FiscalIntegration\ PosFiscalConnectorSample\ Contoso.PosFiscalConnectorSample.sln fájlban, és építse ki.

      2. A PosFiscalConnectorSample StoreCommerce.Installer\ bin\\ net461 \ mappában keresse meg a Contoso.PosFiscalConnectorSample.StoreCommerce.Installer telepítőjét.

      3. A kiterjesztés telepítőjét a következő parancsot futtató parancssorból indítja el.

        Contoso.PosFiscalConnectorSample.StoreCommerce.Installer.exe install --verbosity 0

Működési környezet

Hajtsa végre a pénzügyi integrációs minta felépítési folyamatának beállításához szükséges lépéseket a felhőskálaegység és az önkiszolgáló rendszer telepíthető csomagjainak előállításához és kiadásához a pénzügyi integrációs mintához. Az EFR build-pipeline.yml sablonFÁJL a megoldástárház csővezeték-YAML_Files · \ található.Dynamics 365 Commerce

Bővítmények tervezése

Az adóregisztrációs szolgáltatás integrációs mintája az adóügyi integrációs funkciókon alapul, és része a Retail SDK csomagnak. A minta a FiscalIntegration Efr src \\ mappában található a megoldások tárházában (Dynamics 365 Commerce például a release/9.33 mintában).... A minta egy pénzügyi dokumentumszolgáltatóból áll, CRT amely a Commerce Hardverállomás kiterjesztése, és egy pénzügyi csatlakoztató. A Retail SDK használatával kapcsolatos további tudnivalókat lásd a Retail SDK architektúrája és a független csomagolásos SDKfelépítési csővezetékének beállítása.

Figyelmeztetés

Az új független csomagolási és bővítési modell korlátai miatt jelenleg nem használható ehhez a pénzügyi integrációs mintához. A Retail SDK előző verzióját kell használnia egy fejlesztői VM-n az LCS-en. A további tudnivalókat lásd az Ausztriához (legacy) vonatkozó pénzügyi integrációs minta telepítési irányelveinél. Az új független csomagolási és kiterjesztésmodell támogatása a pénzügyi integrációs mintákkal a későbbi verziókban tervezve lesz.

Commerce runtime bővítmény tervezése

A kiterjesztés célja, amely egy pénzügyi bizonylat szolgáltatója, a szolgáltatásspecifikus dokumentumok generálása és a pénzügyi nyilvántartási szolgáltatás válaszának kezelnie kell.

Kérelemkezelő

A dokumentumszolgáltatókhoz két kérelemkezelő van:

  • DocumentProviderEFRFiscalAUT – ezzel a kezelővel pénzügyi bizonylatokat lehet létrehozni a pénzügyi nyilvántartási szolgáltatás számára.
  • DocumentProviderEFRNonFiscalAUT – ezzel a kezelővel nem pénzügyi bizonylatokat lehet létrehozni a pénzügyi nyilvántartási szolgáltatás számára.

Ezek a kezelők az INamedRequestHandler felületről öröklődik. A HandlerName metódus felelős a kezelő nevének visszaküldéséért. A kezelő nevének meg kell egyeznie a Commerce Headquarters szolgáltatásban megadott csatlakoztató dokumentumszolgáltató nevével.

Az csatlakoztató a következő kéréseket támogatja:

  • GetFiscalDocumentDocumentProviderRequest – ez a kérés tartalmazza a létrehozandó dokumentum adatait. Olyan szolgáltatásspecifikus dokumentumot ad vissza, amely regisztrálva kell lennie a pénzügyi regisztrációs szolgáltatásban.
  • GetNonFiscalDocumentDocumentProviderRequest – ez a kérés tartalmazza azokat az információkat, amelyek nem pénzügyi bizonylatokat kell generálni. Olyan szolgáltatásspecifikus dokumentumot ad vissza, amely regisztrálva kell lennie a pénzügyi regisztrációs szolgáltatásban.
  • GetSupportedRegistrableEventsDocumentProviderRequest – ez a kérés a regisztrált események listáját adja eredményül. Jelenleg a következő események támogatottak: értékesítés, X-jelentés nyomtatása, Z-jelentés nyomtatása, vevői számla betétek, vevői rendelési betétek, könyvvizsgálati események és nem értékesítési tranzakciók.
  • GetFiscalRegisterResponseToSaveDocumentProviderRequest – ez a kérés a pénzügyi regisztrációs szolgáltatás válaszát adja eredményül. A válasz egy karakterlánc formájában van szerializálva, hogy készen legyen a mentésre.

Konfiguráció

A pénzügyi bizonylat szolgáltatójának konfigurációs fájljai a következő megoldások tárház src\ FiscalIntegration\ Efr\ Configurations\ DocumentProvidersDynamics 365 Commerce mappájában találhatók:

  • DocumentProviderFiscalEFRSampleAustria – a pénzügyi bizonylatok szolgáltatójának konfigurációs fájlja.
  • DocumentProviderNonFiscalEFRSampleAustria – a nem pénzügyi bizonylatok pénzügyi bizonylatokat szolgáltató konfigurációs fájlja.

Ezeknek a fájloknak a célja a pénzügyi dokumentumszolgáltató beállításainak beállítása a Commerce Headquarters alkalmazásból. A fájlformátum igazodik a pénzügyi integráció konfigurációjának követelményeihez.

Hardverállomás bővítményének tervezése

A pénzügyi csatlakoztató bővítményének célja, hogy kommunikáljon a pénzügyi regisztrációs szolgáltatással. A hardverállomás bővítmény a HTTP és HTTPS protokollokkal CRT küldheti el a kiterjesztés által a pénzügyi regisztrációs szolgáltatásnak generált dokumentumokat. Kezeli a pénzügyi regisztrációs szolgáltatástól kapott válaszokat is.

Kérelemkezelő

Az EFRHandler kérelemkezelő a pénzügyi regisztrációs szolgáltatás kérésének kezelésére használt belépési pont.

A kezelő az INamedRequestHandler felületről öröklődik. A HandlerName metódus felelős a kezelő nevének visszaküldéséért. A kezelő nevének meg kell egyeznie a Commerce Headquartersban megadott pénzügyi csatlakoztató nevével.

A pénzügyi csatlakoztató a következő kéréseket támogatja:

  • SubmitDocumentFiscalDeviceRequest – ez a kérés dokumentumokat küld a pénzügyi regisztrációs szolgáltatásnak, és visszaküldi a választ.
  • IsReadyFiscalDeviceRequest – ez a kérés az adóügyi regisztrációs szolgáltatás állapotellenőrzésére használható.
  • InitializeFiscalDeviceRequest – ez a kérés a pénzügyi regisztrációs szolgáltatás inicializálására használatos.

Konfiguráció

A pénzügyi csatlakoztató konfigurációs fájlja a megoldástárházban\ található FiscalIntegration\ Efr\ Configurations Connectors\ Connectors ConnectorS\ ConnectorEFRSample.xmlDynamics 365 Commerce fájlban található. A fájl célja, hogy engedélyezze a pénzügyi csatlakoztató beállításait a Commerce Headquarters alkalmazásból való konfigurálásban. A fájlformátum igazodik a pénzügyi integráció konfigurációjának követelményeihez.

POS pénzügyi csatlakoztató bővítményének tervezése

A POS pénzügyi csatlakoztató bővítményének célja, hogy kommunikáljon a POS pénzügyi regisztrációs szolgáltatásával. A HTTPS-protokollt használja kommunikációra.

Pénzügyi csatlakoztató gyára

A pénzügyi csatlakoztató gyári leképezi a csatlakoztató nevét a pénzügyi csatlakoztató megvalósításra, és a Pos.Extension\ Connectors\ FiscalConnectorFactory.ts fájlban található. A csatlakoztató nevének meg kell egyeznie a Commerce Headquarters által megadott pénzügyi csatlakoztató nevével.

EFR pénzügyi csatlakoztató

Az EFR pénzügyi csatlakoztató a Pos.Extension\ Connectors\ EfrFiscalConnector.ts\ fájlban található. Az IFiscalConnector felületet valósítja meg, amely a következő kéréseket támogatja:

  • FiscalRegisterSubmitDocumentClientRequest – ez a kérés dokumentumokat küld a pénzügyi regisztrációs szolgáltatásnak, és visszaküldi a választ.
  • FiscalRegisterIsReadyClientRequest – ez a kérés a pénzügyi nyilvántartási szolgáltatás állapotellenőrzésére használható.
  • FiscalRegisterInitializeClientRequest – ez a kérés a pénzügyi regisztrációs szolgáltatás inicializálására használható.

Konfiguráció

A konfigurációs fájl a \ megoldástárház FiscalIntegration\ Efr\ Configurations\ ConnectorsDynamics 365 Commerce mappájában található. A fájl célja, hogy engedélyezze a Commerce Headquarters alkalmazásból konfigurálható pénzügyi csatlakoztató beállításait. A fájlformátum igazodik a pénzügyi integráció konfigurációjának követelményeihez. A következő beállításokat lehet hozzáadni:

  • Végpont címe – a pénzügyi regisztrációs szolgáltatás URL-címe.
  • Időtúllépés – az az idő ezredmásodpercben, ahányszor a csatlakoztató választ vár a pénzügyi regisztrációs szolgáltatástól.

Megjegyzés

Megosztja velünk a dokumentációja nyelvi preferenciáit? Rövid felmérés elvégzése. (ne feledje, hogy ez a felmérés angol nyelvű)

A felmérés elvégzése körülbelül hét percet vesz igénybe. Semmilyen személyes adatot nem gyűjtünk (adatvédelmi nyilatkozat).