Ugrás a fő tartalomhoz

Az alapvető dokumentumátviteli folyamat

Harald Krondorfer
  • Frissítve

A fiskális modul létrehozása

A pénzügyi dokumentumok (pénzügyi adatok) továbbításához először létre kell hoznia egy pénzügyi modult. Ez többféle módon is elvégezhető:

  • Ha a megbízható adóügyi szolgáltatást (Windows vagy Linux szolgáltatás) használja, az adóügyi szolgáltatás automatikusan létrehozza az adóügyi modult.
  • Ha a fiskális modul integrációját közvetlen .NET DLL-integrációval tervezi, akkor a fiskális modult saját maga kell létrehoznia. A részletes leírás az alábbiakban található:
    A fiskális modul létrehozása / instantiálása
Figyelem: Az adóügyi modul néhány almodult inicializál, ezért nem szabad minden bizonylat esetében újra létrehozni (pl. a TSS hardver (Németország) öntesztje legalább 30 másodpercet igényel). Ezen felül a dokumentumok átvitelét megelőzően meg kell hívni a CloudConnect metódust, ellenkező esetben a felhőalapú archiválás sikertelen lesz (ez csak akkor szükséges, ha a felhőalapú archiválás engedélyezve van).

Dokumentumok átvitele

A pénzügyi dokumentumok átviteléhez a pénzügyi modulba legalább 2 lépés szükséges:

  • createDocument
  • storeDocument

Az országtól függetlenül minden esetben javasoljuk a createDocument metódus meghívását.

Figyelem: A createDocument metódust a dokumentum elején (az árucikk regisztrálásakor) kell meghívni. Ez elengedhetetlen a számviteli előírások törvényes betartásához (pl.: Németországban). A dokumentum fiscalResponse értékét a createDocument metódus meghívásakor kapott fiscalResponse értékre kell beállítani a mentéshez.

Példa egy nyugta-dokumentumra JSON formátumban:

{
"UniqueClientId": "c1062c55-57c4-4ed2-9c53-aff1762326a4",
"DocumentGuid": "5efa5306-fe53-452d-9c81-68329475eee0",
"DocumentId": "2021-02-02T05:31:08.9450964+01:00",
"CreateDate": "2021-02-02T05:31:08.9450964+01:00",
"BookDate": "2021-02-02T05:31:08.9450964+01:00",
"DocumentNumber": null,
"CancellationDocument": false,
"DocumentReference": null,
"IsTraining": false,
"DocumentType": 0,
"DocumentTypeCaption": null,
"User": {
   "Id": "1234",
   "Caption": "Testuser"
},
"AllocationGroups": [],
"Partner": null,
"FiscalResponse": null, 
"FiscalDocumentNumber": 0, // set fiscaldocument of create document here
"FiscalDocumentRevision": 0, // set fisacldocument revision of create document here
"Positions": [
   {
      "ItemCaption": "Blume grün", // the caption of the item
      "ItemShortCaption": null,
      "Discounts": [],
      "Type": 0,
      "UseSubItemVatCalculation": true,
      "SubItems": null,
      "Quantity": 1.0,
      "QuantityUnit": null,
      "ItemId": "000714", // the item id
      "BaseNetValue": 3.61, // base value (without discounts)
      "BaseGrossValue": 4.3,
      "BaseTaxValue": 0.69,
      "GTIN": null,
      "BusinessTransactionType": 0,
      "VatIdentification": 1, 
      "VatPercent": 19.0, 
      "NetValue": 3.61, // net value (quantity * price)
      "GrossValue": 4.3, // gross value of the position
      "TaxValue": 0.69,
      "AccountingIdentifier": null,
      "PositionNumber": 0,
      "PositionReference": null,
      "CancellationPosition": false
   }
],
"Payments": [
   {
      "Amount": 5.0, // payment with over payment
      "IsCash": false,
      "CurrencyIsoCode": "EUR",
      "Caption": null,
      "UniqueReadablePaymentIdentifier": null,
      "ForeignAmount": 0.0,
      "ForeignAmountExchangeRate": 0.0
   },
   {
      "Amount": -0.7, // cash return (second payment)
      "IsCash": false,
      "CurrencyIsoCode": "EUR",
      "Caption": null,
      "UniqueReadablePaymentIdentifier": null,
      "ForeignAmount": 0.0,
      "ForeignAmountExchangeRate": 0.0
   }
]
}

Ez a nyugta a következőket tartalmazza:

  • egy tételt „000714” tételszámmal, „Blume grün” névvel, 4,3 EUR bruttó áron (1 darab).
  • 2 fizetést, egy tételt 5 EUR készpénzzel és 0,7 EUR visszajárót
Megjegyzés: A dokumentum összeállításának módjáról a Fiskális Szolgáltatás Client Sample (C#) példájában tájékozódhat, amely a letöltési részben található (http://www.retailforce.cloud/downloads ). Ez a példaalkalmazás elindításakor a kapott JSON-t is megjeleníti. Kérjük, győződjön meg arról, hogy a Fiskális Szolgáltatás telepítve van és elindítva van ugyanazon a gépen.

Egy korábban létrehozott dokumentum törléséhez hívja meg a következő metódust:

  • cancelDocument
Figyelem: Minden létrehozott dokumentumot (a createDocument metódussal) le kell zárni a storeDocument metódussal, vagy törölni kell a cancelDocument metódussal.

A dokumentum érvényesítéséhez, mielőtt átadná azt a fiskális modulnak, hívhatja meg a

  • ValidateDocument
Tájékoztatás: Maga a dokumentum mindig érvényesítésre kerül, mielőtt el lenne mentve (akkor is, ha törlésre kerül). Ha érvényesítési hiba történik, a storeDocument metódus kivétellel bukik meg.

A folyamatok részletesen

Értékesítési folyamat – Kiskereskedelem

Az áruk értékesítése, például a kiskereskedelemben, a következőképpen zajlik:

Operátor Pénztárgép-rendszer RetailForce adóügyi szolgáltatás
1. Az üzemeltető (a pénztárgép-felhasználó) beírja az első tételt, amelyet a vásárló meg kíván vásárolni.    
  2. A pénztárgép-rendszer kérelmet küld a fiskális szolgáltatásnak (createDocument) a vonatkozó tranzakció kezdetének nyilvántartásba vételére.  
    3. A fiskális szolgáltatás fogadja a felettes rendszertől érkező kérést, és az országspecifikus követelményeknek (pl. aláírás stb.) megfelelően feldolgozza azt.
    4. A fiskális szolgáltatás választ (fiscalResponse) küld a felettes rendszernek.
  5. A pénztárgép-rendszer (felső szintű rendszer) fogadja a választ, és annak egy részét (vagy a teljes válaszobjektumot) tárolja további felhasználás céljából (hivatkozásként) a tranzakció befejezésekor.  
6. Az üzemeltető beolvassa az ügyfél összes termékét, és elindítja a fizetési folyamatot.    
 

7. Miután az összes tranzakciós adat (termékek, fizetési mód stb.) meghatározásra került, a POS-rendszer létrehozza a tranzakciós payload-t (JSON), és újabb kérést küld az adóügyi szolgáltatásnak (storeDocument), amely ezzel lezárja (menti) a tranzakciót.

A createDocument során kapott fiscalResponse-ból bizonyos információkat be kell építeni a payloadba („fiscalDocumentNumber”, „fiscalDocumentStartTime” és, ha alkalmazható, országspecifikus elemek, például Németországban a „fiscalDocumentRevision”).

Figyelem: a payloadba kizárólag a fent felsorolt elemek kerülhetnek be, a teljes fiscalResponse objektum pedig NEM !
  
    8. A fiskális szolgáltatás fogadja az upstream rendszertől érkező kéréseket, és azokat az országspecifikus követelményeknek megfelelően dolgozza fel (pl. aláírás stb.).
    9. A Fiscal Service válaszüzenetet (fiscalResponse) küld az upstream rendszernek.
  10. A pénztárgép-rendszer fogadja a fiscalResponse-t, kinyeri a dokumentum létrehozásához szükséges információkat (pl. dokumentum aláírás, QR-kód stb.), majd kinyomtatja a dokumentumot.  
11. Az ügyintéző átadja a kinyomtatott nyugtát az ügyfélnek    

Értékesítési folyamat a kiskereskedelemben tranzakció-törléssel

Ha a fent leírtak szerint a 6. lépés során, azaz a createDocument (2. lépés) elküldése UTÁN és a storeDocument (7. lépés) elküldése ELŐTT a POS-rendszer a storeDocument helyett egy cancelDocument-et küld.

Figyelem: a cancelDocument parancsot egy befejezetlen tranzakció törlésére (megszüntetésére) használják, és NEM (!) a visszavételek rögzítésére.

A visszavételeket ugyanúgy kell feldolgozni, mint a normál értékesítési tranzakciókat, a createDocument és a storeDocument parancsok használatával.

 

Ezt a cikket automatikusan lefordították.

Kapcsolódó cikkek

Hozzászólások

0 hozzászólás

Hozzászólások írásához jelentkezzen be.

Szolgáltató: Zendesk