Preskoči na glavno vsebino

Osnovni postopek prenosa dokumentov

Harald Krondorfer
  • Posodobljen

Ustvarjanje fiskalnega modula

Za prenos fiskalnih dokumentov (fiskalnih podatkov) morate najprej ustvariti fiskalni modul. To lahko storite na več načinov:

  • Če uporabljate zaupanja vredno fiskalno storitev (storitev za Windows ali Linux), bo fiskalni modul samodejno ustvarila fiskalna storitev.
  • Če nameravate fiskalni modul integrirati z neposredno integracijo .NET DLL, morate fiskalni modul ustvariti sami. Podroben opis najdete spodaj:
    Ustvarjanje / inicializacija fiskalnega modula
Pozor: Fiskalni modul inicializira nekaj podmodulov in ga ne smete ustvarjati na novo za vsak račun (npr. samopreverjanje strojne opreme TSS (Nemčija) traja vsaj 30 sekund). Poleg tega morate pred prenosom dokumentov poklicati CloudConnect, sicer arhiviranje v oblaku ne bo uspelo (potrebno le, če je arhiviranje v oblaku omogočeno).

Prenos dokumentov

Za prenos fiskalnih dokumentov v fiskalni modul potrebujete vsaj 2 koraka:

  • createDocument
  • storeDocument

Ne glede na državo priporočamo, da v vsakem primeru pokličete metodo createDocument.

Pozor: Metoda createDocument je treba poklicati na začetku dokumenta (ob registraciji artikla). To je nujno potrebno za zakonito izvajanje fiskalizacije (npr. v Nemčiji). Pri shranjevanju dokumenta morate nastaviti fiscalResponse dokumenta na vrednost fiscalResponse, ki ste jo prejeli ob klicu metode createDocument.

Vzorec dokumenta potrdila v formatu JSON:

{
"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
   }
]
}

Ta račun vsebuje:

  • eno postavko z artiklom »000714«, »Blume grün«, s ceno 4,3 EUR bruto (1 kos).
  • 2 plačila, postavko z 5 EUR v gotovini in vračilo v višini 0,7 EUR
Opomba: Da bi videli, kako naj bi bil dokument sestavljen, si lahko ogledate vzorec Fiskalnega odjemalca (C#), ki ga najdete v razdelku za prenos (http://www.RetailForce.cloud/downloads ). Prikaže tudi končni JSON, ko zaženete vzorčno aplikacijo. Prepričajte se, da imate fiskalno storitev nameščeno in zagnano na istem računalniku.

Za preklic prej ustvarjenega dokumenta lahko pokličete metodo:

  • cancelDocument
Pozor: Vsak ustvarjen dokument (z metodo createDocument) je treba zapreti z metodo storeDocument ali preklicati z metodo cancelDocument.

Za preverjanje veljavnosti dokumenta pred njegovim prenosom v fiskalni modul lahko pokličete metodo

  • ValidateDocument
Informacija: Dokument bo vedno potrjen, preden bo shranjen (tudi če je preklican). Če pride do napake pri potrjevanju, bo metoda storeDocument spodletela z izjemo.

Podrobnosti o procesih

Prodajni proces v maloprodaji

Prodaja blaga, na primer v maloprodaji, poteka na naslednji način:

Operater Blagajniški sistem Storitev fiskalizacije RetailForce
1. Operater (uporabnik blagajne) vnese prvi izdelek, ki ga želi kupec kupiti.    
  2. Blagajniški sistem pošlje zahtevo fiskalni službi (createDocument), da registrira začetek zadevne transakcije.  
    3. Fiskalna storitev prejme zahtevo iz nadrejenega sistema in jo obdela v skladu z zahtevami posamezne države (npr. podpisovanje itd.).
    4. Fiskalna storitev pošlje odgovor (fiscalResponse) nadrejenemu sistemu.
  5. Blagajniški sistem (nadrejeni sistem) prejme odgovor in shrani dele odgovora (ali celoten odgovorni objekt) za nadaljnjo uporabo (referenco), ko je transakcija zaključena.  
6. Operater skenira vse artikle stranke in sproži postopek plačila.    
 

7. Ko so vsi podatki o transakciji določeni (artikli, način plačila itd.), sistem POS ustvari payload transakcije (JSON) in pošlje novo zahtevo davčni službi (storeDocument), ki s tem zaključi (shrani) transakcijo.

V vsebino morajo biti vključene določene informacije iz odgovora fiscalResponse, prejetega med postopkom createDocument („fiscalDocumentNumber“, „fiscalDocumentStartTime“ in, če je to primerno, elementi, specifični za posamezno državo, kot je na primer „fiscalDocumentRevision“ v Nemčiji).

Pozor: v payload se smejo vključiti le zgoraj navedeni elementi, NE pa celoten objekt fiscalResponse!
  
    8. Davčna služba prejme zahtevke iz zgornjega sistema in jih obdela v skladu z zahtevami, specifičnimi za posamezno državo (npr. podpisovanje itd.).
    9. Davčna služba pošlje odgovor (fiscalResponse) sistemu na višji ravni.
  10. Blagajniški sistem prejme »fiscalResponse«, iz njega izloči podatke, potrebne za izdelavo dokumenta (npr. podpis dokumenta, QR-kodo itd.), in dokument natisne.  
11. Operater izroči natisnjen račun stranki    

Prodajni proces v maloprodaji z razveljavitvijo transakcije

Če, kot je opisano zgoraj, v koraku 6, tj. PO pošiljanju createDocument (korak 2) in PRED pošiljanjem storeDocument (korak 7), sistem blagajne namesto storeDocument pošlje cancelDocument.

Pozor: ukaz »cancelDocument« se uporablja za preklic (opustitev) nedokončane transakcije in NE (!) za upoštevanje vračil.

Vračila se obdelujejo na enak način kot običajne prodajne transakcije, z uporabo ukazov createDocument in storeDocument.

 

Ta članek je bil samodejno preveden.

Sorodni sklopi

Komentar

0 komentarjev

Za dodajanje komentarja prosimo kliknite Vpis.

Založba Zendesk