Visszajelzés

Ellenőrzőegység integrációs mintája Svédország esetén

  • Cikk
  • 11 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 Svédország pénzügyi integrációs mintája ről Microsoft Dynamics 365 Commerce.

Megjegyzés

Ez a minta pénzügyi integrációs funkció a korábbi, Svédországra vonatkozó ellenőrző egységekkel való POS-integrációt helyettesíti. A korábbi minta nem használja ki a pénzügyi integrációs keretrendszert, és a későbbi frissítések során elavulttá válik. A korábbi minta Dynamics 365 Commerce 10.0.22-esvagy korábbi verziónak megfelelő mintába való áttelepítésével kapcsolatban lásd: Áttelepítés a korábbi integrációs mintából.

A Svédországra vonatkozó Commerce funkció egy mintaintegrációt tartalmaz a pénztár és Svédországspecifikus pénzügyi eszközök, más néven vezérlőegységek között. Ez a minta kiterjeszti a pénzügyi integrációs funkciókat. A feltételezés az, hogy a vezérlőegység fizikailag kapcsolódik egy olyan hardverállomáshoz, amelyhez a POS párosítva van. Ez a minta például a Retail HTT AB CleanCash Type A vezérlőegységének alkalmazásprogramozási felületét (API) használja. A CleanCash API 1.1.4-es verziója használatos.

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 a Retail Retail HTT AB rendszerből. Az ellenőrző egység be- és működésről a Retail Retail HTT AB-hez forduljon.

Forgatókönyvek

A Svédországra vonatkozó vezérlőegység-integrációs minta a következő lehetőségeket tartalmazza:

  • A rendszer automatikusan regisztrálja az értékesítési, a visszaadott és a bevételezési példányokat egy olyan vezérlőegységben, amely a PÉNZTÁRhoz csatlakoztatott hardverállomáshoz kapcsolódik.

  • A regisztrált tranzakció vezérlőkódját és gyártási számát a rendszer az ellenőrző egységből rögzíti, és a tranzakcióba menti. Ezt az adatot pénzügyi válasznak is nevezik. A pénzügyi válasz megtekinthető az Üzlet tranzakciós lapján.

  • Az ellenőrző kód egyéni mezői és az ellenőrző egység gyártási száma hozzáadható egy bevételezési elrendezéshez. Ily módon kinyomtathatja egy tranzakció pénzügyi válaszát egy nyugtára.

  • A tranzakció pénzügyi válasza megjelenik az Elektronikus napló (Svédország) csatornajelentésen.

  • Számos hibakezelési beállítás áll rendelkezésre. Íme néhány példa:

    • Próbálja meg újra a pénzügyi regisztrációt, ha újrapróbálkozás lehetséges. A pénzügyi regisztrációt újrapróbálhatja, ha például a vezérlőegység nincs csatlakoztatva, 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 az ellenőrző egység rendelkezésre állását, mielőtt új értékesítési tranzakciót nyit meg vagy egy értékesítési tranzakciót véglegesítettek.

A minta korlátai

A Svédországra vonatkozó vezérlőegység-integrációs minta jelenleg nem támogatja a vevői rendelési helyzeteket.

A vezérlőegységekkel való integráció beállítása

A Svédországra vonatkozó beállításokkal kapcsolatos további tudnivalókat lásd a Commerce for Sweden beállításával kapcsolatban.

Svédország-specifikus bevételezések konfigurálása

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, mint 900001.

Adja hozzá a következő POS-címkéket a Nyelv szövegoldalának POS szakaszában.

Nyelvazonosító Szövegazonosító Szöveg
hu 900001 Jegyzék ellenőrző kódja
hu 900002 Eszköz regisztrálása

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
SE_FISCALREGISTERCONTROLCODE Fogadás 900001
SE_FISCALREGISTERID Fogadás 900002

Megjegyzés

Fontos, hogy a megfelelő egyéni mezőneveket adja meg a fenti 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 Lábléc szakaszhoz. A mezőnevek megfelelnek a cikk előző részében meghatározott nyelvi szövegeknek.

  • Jegyzék vezérlőkódja – ez a mező nyomtatja ki az ellenőrző kódot.
  • Regisztráló eszköz – ez a mező az ellenőrzési egység gyártási számát nyomtatja ki.

A nyugtaformátumok használatával kapcsolatos további tudnivalókat lásd a Nyugtasablonokban és a nyomtatásban.

Pénzügyi integráció beállítása Svédországhoz

A Svédországra vonatkozó vezérlőegység-integrációs minta a pénzügyi integrációs funkciókon alapul, és a Retail SDK része. A minta a Solutions-tárház (például a 9.33. kiadásban található minta) src\ FiscalIntegration\ CleanCashDynamics 365 Commercemappájában található. 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 vezérlőegység-integrációs minta Svédországra vonatkozó telepítési irányelvei (legacy) szempontjábó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ák pénzügyi integrációjának beállítása leírtak 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 az ellenőrzőegység-integrá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 következő src > FiscalIntegration > CleanCash megnyitása:
    4. Töltse le a pénzügyi bizonylat szolgáltatójának konfigurációs fájlját a CommerceRuntime DocumentProvider.CleanCashSample Configuration DocumentProviderFiscalCleanCashSample.xml > fájlból (> például a kiadás fájlja/ 9.33 >)....
    5. Töltse le a pénzügyi csatlakoztató konfigurációs fájlját a HardwareStation > Connector.CleanCashSample > Configuration ConnectorCleanCashSample.xml > fájlból (például a release/9.33 fájlba).

    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.CleanCashSample\ Configuration\ DocumentProviderFiscalCleanCashSample.xml
    • Pénzügyi csatlakoztató konfigurációs fájlja: RetailSdk\ SampleExtensions\ HardwareStation extension.CleanCashSample\\ Configuration\ ConnectorCleanCashSample.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:

  • Áfakód-hozzárendelés – ez a hozzárendelés beállítja az eszközspecifikus áfakódokat a megfelelő áfakódhoz. Az áfakódok leképezésének a következő formátumúnak kell lennie:

    1 : code1 ; 2 : code2

    Itt találja a formátum magyarázatát:

    • Az 1 és a 2 eszközspecifikus áfakód.
    • Pontosvessző (;) elválasztóként használható.
    • az 1 . és a 2 . kód a Commerce Headquarters szolgáltatásban konfigurált áfakódok. A minta-hozzárendelést az alkalmazásban beállított adókódok szerint kell módosítani.

    Az ellenőrző egységek legfeljebb négy különböző áfakódot támogatnak. Ezért az áfakódok leképezése a következő módon lehet beállítva:

    1 : code1 ; 2 : code2 ; 3 : code3 ; 4 : code4

    Megjegyzés

    Több áfakód is megfeleltetható ugyanannak az eszközspecifikus áfakódnak.

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:

  • Kapcsolati karakterlánc – a vezérlőegység kapcsolati beállításai.
  • Időtúllépés – az az idő ezredmásodpercben, ahányszor a vezető az ellenőrző egység válaszát várja.

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 vezérlőegység-integrációs minta Svédországra vonatkozó telepítési irányelvei (legacy) szempontjábó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 ellenőrzési egység integrációs megoldását a Dynamics365Commerce.Solutions\ FiscalIntegration\ CleanCash\ CleanCash.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: A CleanCash\ ScaleUnit.CleanCash.Installer\\ bin\ debug\ net461 mappában keresse meg a ScaleUnit.CleanCash.Installer telepítőt.
      • Helyi CRT a Modern POS terminálon: A CleanCash\ ModernPOS\ ModernPOS.CleanCash.Installer\ bin\ debug\ net461 mappában keresse meg a ModernPOS.CleanCash.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.CleanCash.Installer.exe install --verbosity 0

      • Helyi CRT a Modern POS terminálon:

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

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

    1. A CleanCash\ HardwareStation HardwareStation.CleanCash.Installer\\ bin\\ hibakeresési net461 mappában keresse meg a HardwareStation.CleanCash.Installer telepítőt.

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

      HardwareStation.CleanCash.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. A CleanCash build-pipeline.yml sablon FILEML \ sablon a megoldástárház YAML_Files csővezetékében található.Dynamics 365 Commerce

A bővítmények tervezése

A Svédországra vonatkozó vezérlőegység-integrációs minta a pénzügyi integrációs funkciókon alapul, és a Retail SDK része. A minta a Solutions-tárház (például a 9.33. kiadásban található minta) src\ FiscalIntegration\ CleanCashDynamics 365 Commercemappájában található. 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 vezérlőegység-integrációs minta Svédországra vonatkozó telepítési irányelvei (legacy) szempontjábó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.

CRT kiterjesztésterv

A kiterjesztés célja, amely egy pénzügyi bizonylat szolgáltatója, a szolgáltatásspecifikus dokumentumok generálása és az ellenőrző egység válaszának kezelnie.

Kérelemkezelő

A dokumentumszolgáltatóhoz egyetlen DocumentProviderCleanCash kérelemkezelő van. Ezzel a kezelővel lehet pénzügyi bizonylatokat létrehozni az ellenőrzési egységhez.

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 az ellenőrzési egységben.
  • GetSupportedRegistrableEventsDocumentProviderRequest – ez a kérés a regisztrált események listáját adja eredményül. Jelenleg az értékesítési és a könyvvizsgálati események támogatottak.

Konfiguráció

A pénzügyi bizonylat szolgáltatójának konfigurációs fájlja a következő helyen található: src FiscalIntegration\ CleanCash\ CommerceRuntime\ DocumentProvider.CleanCashSample Configuration DocumentProviderFiscalCleanCashSample.xml\\\, a megoldások tárházában.Dynamics 365 Commerce A fájl célja, hogy lehetővé tegye a dokumentumszolgáltató Commerce Headquarters rendszerből származó konfigurálásának beállításait. 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 kiterjesztés célja, amely pénzügyi csatlakoztató, az a cél, hogy kommunikáljon az ellenőrző egységgel. A HTTP protokollal küldheti el a CRT kiterjesztés által az ellenőrzési egységnek generált dokumentumokat. Kezeli az ellenőrzési egységtől kapott válaszokat is.

Kérelemkezelő

A CleanCashHandler kérelemkezelő a vezérlőegységhez történő kérések kezelésének belépési pontja.

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 az ellenőrzési egységnek, és választ ad vissza.
  • IsReadyFiscalDeviceRequest – ez a kérés az ellenőrzési egység állapotellenőrzésére használható.
  • InitializeFiscalDeviceRequest – ez a kérés a vezérlőegység inicializálására használatos.

Konfiguráció

A pénzügyi csatlakoztató konfigurációs fájlja a megoldástárház\ FiscalIntegration\ CleanCash\ HardwareStation\ Connector.CleanCashSample\ Configuration ConnectorCleanCashSample.xml \Dynamics 365 Commerce fájljá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.

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