Visszajelzés

Adóügyi nyomtató integrációját bemutató minta Lengyelországra vonatkozóan

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

A Dynamics 365 Commerce Lengyelországra vonatkozó funkciók közé tartozik a pénztár és egy pénzügyi nyomtató közötti mintaintegráció. A minta kiterjeszti a pénzügyi integrációs funkciókat, és támogatja a POSNET 2.02 PROTOCOL 2.02 protokollt a Posnet Polkiszolgáló S.A pénzügyi nyomtatóihoz. A minta lehetővé teszi a kommunikációt olyan pénzügyi nyomtatóval, amely COM-porton keresztül csatlakozik egy natív szoftverillesztő segítségével. A rendszer egy szoftveremulátor segítségével megvalósította és tesztelték, amelyet a Posnet FV FV pénzügyi nyomtatóhoz megadott Posnet. 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 Posnet rendszerből. A pénzügyi nyomtató be- és működésával kapcsolatos tudnivalókat a Posnet Polrin S.A.A-hez kell forduljon.

Forgatókönyvek

A lengyelországi pénzügyi nyomtató integrációs mintája a következő helyzeteket tartalmazza:

  • Értékesítési esetek:

    • Pénzügyi nyugta nyomtatása a készpénz- és az áthozott értékesítések és visszaküldések számára.

    • A pénzügyi nyomtató válaszának rögzítése és tárolása a csatorna-adatbázisban.

    • Adók:

      • Leképezés a pénzügyi nyomtató adókódjaira (részlegek).
      • A megfeleltetett adóadatok átvitele a pénzügyi nyomtatóra.

    • Kifizetések:

      • Leképezés a pénzügyi nyomtató fizetési módjaira.
      • Kifizetések nyomtatása pénzügyi nyugtára.
      • Módosítási adatok nyomtatása.

    • Sorengedmények nyomtatása.

    • Ajándékutalványok:

      • Kiadott/újra felszámított ajándékutalvány-sor kizárása az értékesítés pénzügyi nyugtáiból
      • Ajándékutalványt rendszeres fizetési módként használó fizetés nyomtatása.

    • Pénzügyi nyugták nyomtatása a vevői rendelési műveletekhez:

      • Nem nyomtat pénzügyi nyugtát a rendszer vevői rendelés letétje számára.
      • Pénzügyi nyugta nyomtatása egy vevői rendelés áthozott sorairól.
      • Pénzügyi nyugta nyomtatása a vevői rendelés felvételi művelete számára.
      • Pénzügyi nyugta nyomtatása visszárurendeléshez.

    • Annak a vevőnek az adatai, amely meg van adva egy pénzügyi nyugtán található értékesítési tranzakcióhoz. Ilyen például a vevő áfaszáma.

  • Nap végi kivonatok (pénzügyi X- és pénzügyi Z-jelentések)

  • 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ás lehetséges, például ha a pénzügyi nyomtató nincs csatlakoztatva, nem áll készen vagy nem válaszol, a nyomtató ki van nyomtatva, vagy papírelakadás van.
    • 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 nyomtató 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 nyomtató 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áadva kapcsolódó értékesítési sorok kihagyása a pénzügyi nyugtából
  • Ne nyomtass pénzügyi nyugtát, ha az csak ajándékutalvány-sorokból áll.
  • A tranzakcióban kiadott vagy újra felszámított ajándékutalványok teljes összegének levonása a pénzügyi nyugta fizetési soraibó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 nyomtató 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:

  • Ne nyomtass pénzügyi nyugtát, ha a tranzakció vevői letét.
  • Ne nyomtass pénzügyi nyugtát, 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 korábban kifizetett letét összegének nyomtatása egy vevői rendelés felvételi műveletének pénzügyi nyugtára.
  • 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 nyomtató csak olyan eseteket támogat, 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 napi jelentések (pénzügyi X és pénzügyi Z) a beágyazott Műszakjelentés-formátum használatával vannak kinyomtatva.
  • A vonalkód pénzügyi nyugtákra történő nyomtatása potenciális testreszabásnak tekinthető, mivel ez a funkció nem támogatott a beágyazott formátumokban, és csak a testreszabható Super-format jelentéssel valósítható meg.
  • A pénzügyi nyomtató nem támogatja a vegyes tranzakciókat. A POS funkcióprofilok esetében a Kombinációs értékesítések és visszaküldések tiltása egy nyugta beállításban igen értéket kell beállítani.

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

A lengyelországi pénzügyi nyomtató-integrációs minta a pénzügyi integrációs funkciókon alapul, és része a Retail SDK csomagnak. A minta a FiscalIntegration\ Posnet\Dynamics 365 Commerce tárház src mappájában található (például a release/9.33 mintája). 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 lengyelországi pénzügyi nyomtató 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á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 nyomtató integrációs mintáját jellemző pénzügyi regisztrációs folyamat beállításait.
  2. Hibakezelési beállítások megadása.
  3. Pénzügyi X-/Z-jelentések beállítása a POS-ból.
  4. Halasztott pénzügyi regisztráció kézi végrehajtásának engedélyezése
  5. 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. PénzügyiIntegration posnet > megnyitása >
    4. Töltse le a pénzügyi bizonylat szolgáltatójának konfigurációs fájlját a CommerceRuntime > DocumentProvider.PosnetSample > Configuration > DocumentProviderPosnetSample.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 HardwareStation > XmlDeviceSample > Configuration ConnectorPosnetThermalFVEJ.xml > fájlból (például a kiadás fájlja/9.33).

    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\ Extension.DocumentProvider.PosnetSample\ Configuration\ DocumentProviderPosnetSample.xml
    • Pénzügyi csatlakoztató konfigurációs fájlja: RetailSdk\ SampleExtensions\ HardwareStation\ Extension.Posnet.TerjesztésDeviceSample\ Configuration\ ConnectorPosnetThermalFVEJ.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 nyomtatóspecifikus áfamértékek között. Az alapértelmezett hozzárendelés:

    0 : 23.00 ; 1 : 8.00 ; 2 : 5.00 ; 3 : 0.00

    Minden párban az első összetevő a pénzügyi nyomtatón beállított áfakulcsszámot képviseli. A második összetevő a megfelelő áfakulcsot képviseli. A pénzügyi nyomtató áfakulcs-konfigurációjával kapcsolatos további tudnivalókat lásd a POSNET illesztőprogram-dokumentációjában.

  • Fizetőeszköz-típus hozzárendelés – az üzlethez beállított fizetési módok megfeleltetése a pénzügyi nyomtató által támogatott fizetési képernyőknek. Az alapértelmezett hozzárendelés:

    0 : 0 ; 1 : 0 ; 2 : 2 ; 3 : 2 ; 4 : 0 ; 5 : 0 ; 6 : 0 ; 7 : 2 ; 8 : 0

    Az egyes párok első komponense egy, az üzlethez beállított fizetési módot jelent. A második összetevő a pénzügyi nyomtató által támogatott megfelelő fizetési képernyőt jelöli. A pénzügyi nyomtató által támogatott fizetési képernyőkről a POSNET illesztőprogram dokumentációja tartalmaz további tudnivalókat. A minta-hozzárendelést az alkalmazásban beállított fizetési módoknak megfelelően kell módosítani.

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 – karakterlánc, amely az illesztő által támogatott formátumban írja le az eszközzel való kapcsolat részleteit. A további tudnivalókat lásd a POSNET illesztőprogram dokumentációjában.
  • Dátum- és időszinkronizálás – ez az érték határozza meg, hogy szinkronizálni kell-e a nyomtató dátumát és időpontját a csatlakoztatott hardverállomással.
  • Eszköz időkorlátja – az az idő ezredmásodpercben, ahányszor a vezető választ vár az eszközről. A további tudnivalókat lásd a POSNET illesztőprogram dokumentációjában.

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 lengyelországi pénzügyi nyomtató 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 a pénzügyi nyomtató integrációs megoldását a Dynamics365Commerce.Solutions\ FiscalIntegration\ Posnet.sln\ webhelyen, é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 Posnet\ ScaleUnit.Posnet.Installer\\ bin\ debug\ net461 mappájában keresse meg a ScaleUnit.Posnet.Installer telepítőt.
      • Helyi CRT a Modern POS terminálon: A Posnet\ ModernPOS ModernPOS.Posnet.Installer\\ bin\ debug\ net461 mappájában keresse meg a ModernPOS.Posnet.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.Posnet.Installer.exe install --verbosity 0

      • Helyi CRT a Modern POS terminálon:

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

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

    1. A Posnet HardwareStation\ HardwareStation.PosnetThermalFVFiscalPrinter.Installer\ bin\ debug\ net461\ mappában keresse meg a HardwareStation.PosnetThermalFVFiscalPrinter.Installer telepítőjét.

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

      HardwareStation.PosnetThermalFVFiscalPrinter.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 Posnet build-pipeline.yml sablonFÁJL a MEGOLDÁStárház YAML_Files \ csővezetékében található.Dynamics 365 Commerce

Bővítmények tervezése

A lengyelországi pénzügyi nyomtató-integrációs minta a pénzügyi integrációs funkciókon alapul, és része a Retail SDK csomagnak. A minta a FiscalIntegration\ Posnet\Dynamics 365 Commerce tárház src mappájában található (például a release/9.33 mintája). 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 lengyelországi pénzügyi nyomtató 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 bizonylatot szolgáltató, az a cél, hogy nyomtatóspecifikus dokumentumokat generáljon, és kezelni tudja a pénzügyi nyomtató válaszait. Ez a kiterjesztés a POSNET 19-3678-as meghatározása által meghatározott JavaScript object Notation (JSON) formátumú nyomtatóspecifikus parancsokat generál.

Kérelemkezelő

A DocumentProviderPosnetProtocol kérelemkezelő a pénzügyi nyomtatón történő dokumentum-generálás igénylé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 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 nyomtatóspecifikus bizonylatot ad vissza, amely regisztrálva kell lennie a pénzügyi nyomtatón.
  • 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ás és Z-jelentés nyomtatás.

Konfiguráció

A pénzügyi bizonylat szolgáltatójának konfigurációs fájlja a megoldástárház\ FiscalIntegration\ Posnet\ CommerceRuntime\ DocumentProvider.PosnetSample\ Configuration\ DocumentProviderPosnetSample.xmlDynamics 365 Commerce fájljában 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 nyomtatóval való kommunikáció. Ez a kiterjesztés hívja meg a POSNET illesztőprogram funkcióit, és elküldi CRT a kiterjesztés által a pénzügyi nyomtatón generált parancsokat. Az eszközhibákat is kezeli.

Kérelemkezelő

A FiscalPrinterHandler kérelemkezelő a kérésnek a pénzügyi perifériás eszközzel való kezelés 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 a nyomtatóknak, és visszaküldi a választ a pénzügyi nyomtatóról.
  • IsReadyFiscalDeviceRequest – ez a kérés az eszköz állapotának ellenőrzésére használható.
  • InitializeFiscalDeviceRequest – ez a kérés a nyomtató inicializálásához használatos.

Konfiguráció

A pénzügyi csatlakoztató konfigurációs fájlja a megoldástárház\ FiscalIntegration\ Posnet HardwareStation\ AeviceSample\\ Configuration\ ConnectorPosnetThermalFVEJ.xmlDynamics 365 Commerce fájljában 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.

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