Visszajelzés

Pénzügyi nyilvántartási szolgáltatás integrációs mintája a Cseh Köztársaság számára

  • 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 a Cseh Köztársaság pénzügyi integrációs mintája ről Microsoft Dynamics 365 Commerce.

A Cseh Dynamics 365 Commerce Köztársaság készpénzjegyzékekkel kapcsolatos helyi pénzügyi követelményeinek megfelelően a Cseh Köztársaság funkciói között szerepel a pénztári terminál és egy 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ás biztosítja az értékesítések elektronikus regisztrációját (EET - Elektronická evidence treb), azaz az értékesítési adatok online átvitele az adóhatóságok pénzügyi webszolgáltatásának.

Az EFR-szolgáltatásnak a Commerce 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 Cseh Köztársaságra vonatkozó pénzügyi nyilvántartási szolgáltatási integrációs minta a következő helyzeteket tartalmazza.

  • Készpénztranzakciók regisztrálása a pénzügyi nyilvántartási 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. Az adóügyi regisztrációs szolgáltatás továbbküldi az adatokat az adóhatóságok webszolgáltatásának, és visszaigazolást kap arról, hogy tartalmazza a tranzakció pénzügyi azonosító kódját.
    • Válasz rögzítése a pénzügyi regisztrációs szolgáltatástól. Ez a válasz olyan pénzügyi adatokat is tartalmaz, mint például a pénzügyi azonosító kód, a tranzakció biztonsági kódja stb.
    • A regisztrált tranzakció pénzügyi adatainak nyomtatása a nyugtára.

  • Ajándékutalvány-műveletek és vevői betétek regisztrálása a 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 létrehozása és letét regisztrálása a rendeléshez.
    • Vevői rendelés szerkesztése és a rendelés letétje felülbírálása
    • Vevői rendelés érvénytelenítése és a rendelés letétje visszatérítése

  • 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 nyilvántartási szolgáltatás integrációs mintája az ajándékutalványokkal kapcsolatos következő szabályokat valósítja meg.

  • Az értékesítési tranzakcióban az Ajándékutalvány kiadásához vagy az Ajándékutalványhoz hozzáadás művelethez kapcsolódó értékesítési sorok egy speciális attribútummal vannak megjelölve, amikor a tranzakciót regisztrálják a pénzügyi regisztrációs szolgáltatásban.
  • Az ajándékutalványos fizetés rendszeres fizetésnek számít, és speciális attribútummal van megjelölve, amikor a tranzakciót regisztrálják a pénzügyi regisztrációs szolgáltatásban.

Vevői számlabeté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 számlára való betétekre és a vevői rendelési betétekre vonatkozó következő szabályokat valósítja meg.

  • A pénzügyi nyilvántartási szolgáltatásban egy tranzakciósorként regisztrálják a vevői számla letéthez vagy vevői rendelés letéthez kapcsolódó tranzakciót, és egy speciális attribútummal jelölik meg. Ebben a sorban van megadva a letéti áfacsoport.
  • Amikor létrejön egy vevői rendelés, vagyis egy olyan vevői rendelés, amely a vevő által az üzletben szállítható termékeket, valamint a később fel- vagy leszállított termékeket tartalmazza, a pénzügyi nyilvántartási szolgáltatásban regisztrált tranzakció tartalmazza az elvégzett termékek sorait, valamint a rendelési letét sorait.
  • A vevői számláról történő fizetés rendszeres kifizetésnek számít, és speciális attribútummal van megjelölve, amikor a tranzakció regisztrálva van a pénzügyi nyilvántartási szolgáltatásban.
  • A vevői rendelés felvételi műveletére alkalmazott letéti összeg rendszeres kifizetésnek számít, és speciális attribútummal van megjelölve, amikor a tranzakciót regisztrálják a pénzügyi nyilvántartási szolgáltatásban.

Offline regisztráció

Ha a pénzügyi regisztrációs szolgáltatás nem tud tranzakcióadatokat továbbítani az adóhatóságok pénzügyi webszolgáltatásának (például a válasz időtúllépése miatt), és nem kap visszaigazolást a webszolgáltatástól (azaz a tranzakció pénzügyi azonosító kódját), akkor helyi aláírást generál a tranzakcióhoz, és tartalmazza azt, valamint egy speciális hibakódot a válaszban. A pénzügyi regisztrációs szolgáltatás a hálózati kapcsolat visszaállítása után ismét eredeti sorrendben újraküldi a tranzakciókat a háttérben.

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 The Csehország beállítása

Ez a szakasz a Cseh Köztársaságra jellemző és ajánlott Kereskedelmi beállításokat ismerteti. A további tudnivalókat lásd a Commerce honlapon.

A cseh 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/régió mezőt CZE (Csehország) beállításra.
  • Minden Cseh Köztársaságban található üzlet POS funkcióprofiljában állítsa CZ (Csehország) iso-kód mezőt.

A Cseh Köztársaság esetében a következő beállításokat is meg kell adnia. Ne feledje, hogy a beállítások befejezése után futtatnia kell a megfelelő elosztási feladatokat.

Cseh Köztársaságonkénti áfakövetelmények beállítása

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.

Üzletek beállítása

Az Üzletek lapon frissítse az üzlet adatait. Konkrétabban, állítsa be a következő paramétereket.

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

Regisztrációs számok beállítása

  1. Ugrás a Szervezetfelügyelet globális > címjegyzék regisztrálási > típusainak > regisztrálási típusaihoz. Új regisztrációtípus létrehozása. Adja meg az Ország/terület mezőt a CZE (Csehország) számára, és csak a szervezetre korlátozza.

  2. Ugrás a Szervezetfelügyelet globális > címjegyzék regisztrálási > típusainak regisztrálási > kategóriáihoz Új regisztrációs kategória létrehozása. Válassza ki a regisztráció típusát az előző lépésből, és állítsa a Regisztrációs kategóriát Üzleti előzetes azonosítóra.

  3. Nyissa meg a következőt: Szervezeti adminisztráció > Szervezetek > Üzemi egységek. A Cseh Köztársaságban található valamennyi üzletnél válassza ki az üzlethez kapcsolódó egységet. Bontsa ki a Cím gyorslistában a További beállítások legördülő listát, és válassza a Speciális lehetőséget .

  4. A megnyitott Címek kezelése lapon meg kell adnia a következő beállítást.

    • A Cím gyors területen állítsa az Ország/terület mezőt CZE beállításra.·
    • Hozzon létre egy új rekordot a Regisztrációs azonosító gyors oldalon. Válassza ki a korábban létrehozott regisztrációtípust, és állítsa be a regisztrációs számot.

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 Azonosító: provoz proxy/pokladny
hu 900002 BKP
hu 900003 KKP
hu 900004 FIK
hu 900005 Információ
hu 900006 Sorszám

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
TLT Fogadás 900001
SEC Fogadás 900002
JEL Fogadás 900003
PÉNZÜGYI Fogadás 900004
INFO Fogadás 900005
FOLYTONOS SZÁM Fogadás 900006

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.

    • Üzlet neve és adóazonosító száma: ezekkel a mezőkkel nyomtatható ki a vállalat neve és azonosítószáma a nyugtákra. 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átuma, ideje 24 órás, nyugtaszám és pénztárgép száma.
    • Sorszám: ez a mező azonosítja a készpénztranzakció 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

  • 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.
    • Provoz proxy/pokladny azonosító: ez a mező kinyomtatja az üzleti létesítmény és a pénztárgép azonosítóit.
    • BKP: ez a mező kinyomtatja az adófizető biztonsági kódját, amelyet a pénzügyi regisztrációs szolgáltatás rendel hozzá.
    • FIK: sikeres online regisztráció esetén az adóhatóság webszolgáltatása által hozzárendelt tranzakció pénzügyi azonosító kódját nyomtatja ki ez a mező.
    • PKP: ez a mező kinyomtatja az adófizető aláírási kódját, amelyet a pénzügyi regisztrációs szolgáltatás generál offline regisztráció esetén.
    • Információ: ez a mező a pénzügyi regisztrációs szolgáltatás további adatait nyomtatja ki.

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 a Cseh Köztársaság számára

A Cseh Köztársaság pénzügyi nyilvántartási szolgáltatásintegrációs mintája a pénzü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 a Cseh Köztársaság pénzügyi integrációs mintája (legacy) 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. Töltse le a pénzügyi bizonylat szolgáltatójának konfigurációs fájlját a Configurations > DocumentProviders > DocumentProviderFiscalEFRSample Xml.xml fájlban (például a release/9.33 fájlban).
    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ájlja: RetailSdk\ SampleExtensions\ CommerceRuntime\ Extensions.DocumentProvider.EFRSample\ Configuration\ DocumentProviderFiscalEFRSample Az xml
    • Pénzügyi csatlakoztató konfigurációs fájlja: RetailSdk\ SampleExtensions\ HardwareStation\ Extension.EFRSample\ Configuration\ ConnectorEFRSample.xml

    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 és 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ügyidokumentum-szolgáltató konfigurációs fájlját.

  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. Új funkcionális csatlakoztatóprofil létrehozása. Válassza ki a korábban betöltött dokumentumszolgáltatót és csatlakoztató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 egy új pénzügyi csatlakoztatócsoportot a korábban létrehozott csatlakoztató funkcionális profil számára.

  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 egy pénzügyi nyilvántartási folyamat lépését, és válassza ki a korábban létrehozott pénzügyi csatlakoztatócsoportot.

  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.

  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: 21.00; B: 15.00; C: 10.00; Z: 0.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 a Cseh Köztársaság számára támogatott áfacsoportokkal kapcsolatban lásd az EFR-hivatkozást.

  • Alapértelmezett áfacsoport-hozzárendelés – minden olyan áfaösszeget, amely nem leképezhető egy előre meghatározott áfacsoportra, az alapértelmezett (alapvető) áfacsoporthoz lesz hozzárendelve. Az alapértelmezett hozzárendelés:

    A

  • Letéti áfacsoport hozzárendelése – a vevő letéti összegei és a vevői rendelés letéti összegei a letéti áfacsoporthoz lesznek rendelve. Az alapértelmezett hozzárendelés:

    Z

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.
  • Időtúllépés – 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.

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 a Cseh Köztársaság pénzügyi integrációs mintája (legacy) 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 parancssorból a következő parancs futtatásával 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

A Cseh Köztársaság pénzügyi nyilvántartási szolgáltatásintegrációs mintája a pénzü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 a Cseh Köztársaság pénzügyi integrációs mintája (legacy) 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óhoz egyetlen DocumentProviderEFRFiscalIUSE kérelemkezelő van, amely a pénzügyi nyilvántartási szolgáltatás pénzügyi bizonylatok előállítására használható.

Ez 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 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.
  • 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, vevői számlabetétek és vevői rendelési betétek.
  • 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ájlja a megoldások\ tárházában található FiscalIntegration\ Efr\ configurations\ DocumentProviders\ DocumentProviderFiscalEFRSamplePle.xmlDynamics 365 Commerce fájlban található. A fájl célja, hogy lehetővé tegye a pénzügyi bizonylat szolgáltatójának 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.

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

A pénzügyi csatlakoztatóként használt bővítmény célja a pénzügyi regisztrációs szolgáltatással való kommunikáció. A hardverállomás bővítménye a HTTP CRT protokollal 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.

Az 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).