Preskočiť na hlavný obsah

Základný proces prenosu dokumentov

Harald Krondorfer
  • Aktualizované

Vytvorenie daňového modulu

Na odosielanie daňových dokladov (daňových údajov) je najprv potrebné vytvoriť daňový modul. To je možné urobiť viacerými spôsobmi:

  • Ak používate dôveryhodnú daňovú službu (službu pre Windows alebo Linux), daňový modul vám táto služba vytvorí automaticky.
  • Ak plánujete integráciu fiškálneho modulu prostredníctvom priamej integrácie .NET DLL, musíte fiškálny modul vytvoriť sami. Podrobný popis nájdete nižšie:
    Vytvorenie / inicializácia fiškálneho modulu
Upozornenie: Daňový modul inicializuje niekoľko podmodulov a nemal by sa vytvárať nanovo pre každý doklad (napr. autotest hardvéru TSS (Nemecko) trvá minimálne 30 sekúnd). Okrem toho je potrebné pred odoslaním dokladov zavolať metódu CloudConnect, inak zlyhá archivácia v cloude (potrebné len v prípade, ak je archivácia v cloude povolená).

Prenos dokumentov

Na odoslanie daňových dokumentov do daňového modulu potrebujete aspoň 2 kroky:

  • createDocument
  • storeDocument

Nezávisle od krajiny odporúčame vo všetkých prípadoch vyvolať metódu createDocument.

Upozornenie: Metóde createDocument je potrebné vyvolať na začiatku dokumentu (pri registrácii tovaru). Je to absolútne nevyhnutné na legálne zavedenie fiskalizácie (napr. v Nemecku). Pri ukladaní dokumentu je potrebné nastaviť vlastnosť fiscalResponse dokumentu na hodnotu fiscalResponse, ktorú ste získali pri volaní metódy createDocument.

Vzorový doklad o príjme vo formáte 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
   }
]
}

Tento doklad o príjme obsahuje:

  • jednu položku s názvem „000714“, „Blume grün“, s cenou 4,3 EUR brutto (1 kus).
  • 2 platby, položku s 5 EUR v hotovosti a vrátenie 0,7 EUR
Poznámka: Ak chcete zistiť, ako by mal byť dokument zostavený, môžete si pozrieť ukážku Fiscal Service Client Sample (C#), ktorú nájdete v sekcii na stiahnutie (http://www.retailforce.cloud/downloads ). Ukazuje tiež výsledný JSON, keď spustíte ukážkovú aplikáciu. Uistite sa, že máte daňovú službu nainštalovanú a spustenú na tom istom počítači.

Ak chcete zrušiť predtým vytvorený dokument, môžete zavolať metódu:

  • cancelDocument
Upozornenie: Každý vytvorený dokument (pomocou createDocument) musí byť uzavretý metódou storeDocument alebo zrušený metódou cancelDocument.

Na overenie dokumentu pred jeho odoslaním do daňového modulu môžete zavolať metódu

  • ValidateDocument
Informácia: Samotný dokument bude vždy overený pred jeho uložením (aj v prípade, že je zrušený). Ak dôjde k chybe pri overovaní, metóda storeDocument zlyhá a vyvolá výnimku.

Procesy v detaile

Proces predaja v maloobchode

Predaj tovaru, napríklad v maloobchode, prebieha nasledovne:

Operátor Pokladničný systém Služba RetailForce Fiscalisation
1. Obsluha (používateľ pokladnice) zadá prvú položku, ktorú si zákazník želá zakúpiť.    
  2. Pokladničný systém pošle žiadosť do fiskálnej služby (createDocument) o zaznamenanie začiatku príslušnej transakcie.  
    3. Fiskálna služba prijme žiadosť z nadradeného systému a spracuje ju v súlade s požiadavkami platnými v danej krajine (napr. podpisovanie atď.).
    4. Fiskálna služba odošle odpoveď (fiscalResponse) do nadradeného systému.
  5. Pokladničný systém (nadradený systém) prijme odpoveď a uloží jej časti (alebo celý objekt odpovede) na ďalšie použitie (referenciu) po dokončení transakcie.  
6. Obsluha naskenuje všetky položky zákazníka a spustí proces platby.    
 

7. Akonáhle sú určené všetky údaje o transakcii (položky, spôsob platby atď.), systém POS vygeneruje payload transakcie (JSON) a odošle ďalšiu žiadosť do daňovej služby (storeDocument), čím sa transakcia dokončí (uloží).

Určité informácie z odpovede fiscalResponse prijaté počas createDocument musia byť zahrnuté v payload („fiscalDocumentNumber“, „fiscalDocumentStartTime“ a, ak je to relevantné, prvky špecifické pre danú krajinu, ako napríklad „fiscalDocumentRevision“ v Nemecku).

Pozor: do payload sa smú zahrnúť iba vyššie uvedené prvky, NIE celý objekt fiscalResp!
  
    8. Daňová služba prijíma požiadavky z nadradeného systému a spracováva ich v súlade s požiadavkami špecifickými pre danú krajinu (napr. podpisovanie atď.).
    9. Daňová služba odošle odpoveď (fiscalResponse) do nadradeného systému.
  10. Pokladničný systém prijme fiscalResponse, extrahuje informácie potrebné na vytvorenie dokladu (napr. podpis dokladu, QR kód atď.) a vytlačí doklad.  
11. Obsluha odovzdá vytlačenú účtenku zákazníkovi    

Proces predaja v maloobchode so zrušením transakcie

Ak, ako je opísané vyššie, počas kroku 6, t. j. PO odoslaní createDocument (krok 2) a PRED odoslaním storeDocument (krok 7), POS systém odošle cancelDocument NAMIESTNE storeDocument.

Upozornenie: Príkaz cancelDocument sa používa na zrušenie (ukončenie) neúplnej transakcie a NIE (!) na zaznamenanie vrátenia tovaru.

Vrátenie tovaru sa spracováva rovnakým spôsobom ako bežné predajné transakcie, pomocou príkazov createDocument a storeDocument.

 

Tento článok bol preložený automaticky.

Podobné články

Príspevky

0 komentárov

Ak chcete napísať komentár, prihlásiť sa.

Využíva technológiu Zendesk