Přeskočit do hlavního obsahu

Základní proces přenosu dokumentů

Harald Krondorfer
  • Aktualizováno

Vytvoření fiskálního modulu

Pro přenos fiskálních dokladů (fiskálních dat) je nejprve nutné vytvořit fiskální modul. To lze provést několika způsoby:

  • Pokud používáte důvěryhodnou fiskální službu (službu pro Windows nebo Linux), fiskální modul vám bude automaticky vytvořen touto službou.
  • Pokud plánujete integraci fiskálního modulu pomocí přímé integrace .NET DLL, musíte fiskální modul instanciovat sami. Podrobný popis naleznete níže:
    Vytvoření / instanciování fiskálního modulu
Upozornění: Daňový modul inicializuje několik podmodulů a neměl by být nově vytvářen pro každou účtenku (např. autotest hardwaru TSS (Německo) trvá minimálně 30 sekund). Kromě toho je nutné před přenosem dokladů zavolat metodu CloudConnect, jinak dojde k selhání archivace v cloudu (nutné pouze v případě, že je archivace v cloudu povolena).

Přenos dokumentů

K přenosu fiskálních dokumentů do fiskálního modulu jsou zapotřebí alespoň 2 kroky:

  • CreateDocument
  • StoreDocument

Nezávisle na zemi doporučujeme v každém případě volat metodu CreateDocument.

Upozornění: Metodu CreateDocument je nutné zavolat na začátku dokumentu (při registraci položky). To je naprosto nezbytné pro legální implementaci fiskalizace (např. v Německu). Musíte nastavit FiscalResponse dokumentu, který chcete uložit, na hodnotu FiscalResponse získanou při volání metody CreateDocument.

Ukázkový doklad o přijetí v formátu 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 přijetí obsahuje:

  • jednu položku s názvem „000714“, „Blume grün“, s cenou 4,3 EUR brutto (1 kus).
  • 2 platby, položku s částkou 5 EUR v hotovosti a vrácenou částku 0,7 EUR
Poznámka: Chcete-li zjistit, jak by měl být dokument sestaven, můžete se podívat na ukázku klienta fiskální služby (C#), kterou najdete v sekci ke stažení (http://www.retailforce.cloud/downloads ). Ukazuje také výsledný JSON, když spustíte ukázkovou aplikaci. Ujistěte se, že máte fiskální službu nainstalovanou a spuštěnou na stejném počítači.

Chcete-li zrušit dříve vytvořený dokument, můžete zavolat metodu:

  • CancelDocument
Upozornění: Každý vytvořený dokument (pomocí CreateDocument) musí být uzavřen metodou StoreDocument nebo zrušen metodou CancelDocument.

Chcete-li ověřit dokument před jeho předáním do fiskálního modulu, můžete zavolat metodu

  • ValidateDocument
Informace: Samotný dokument bude vždy ověřen před uložením (i v případě, že je zrušen). Pokud dojde k chybě při ověřování, metoda StoreDocument selže s výjimkou.

Procesy podrobně

Proces prodeje v maloobchodě

Prodej zboží, například v maloobchodě, probíhá následovně:

Operátor Pokladní systém Služba RetailForce Fiscalisation
1. Obsluha (uživatel pokladny) zadá první položku, kterou si zákazník přeje zakoupit.    
  2. Pokladní systém odešle žádost do fiskální služby (createDocument) o zaznamenání zahájení příslušné transakce.  
    3. Fiskální služba přijme požadavek z nadřazeného systému a zpracuje jej v souladu s požadavky dané země (např. podepsání atd.).
    4. Fiskální služba odešle odpověď (fiscalResponse) do nadřazeného systému.
  5. Pokladní systém (nadvazující systém) přijme odpověď a uloží její části (nebo celý objekt odpovědi) pro další použití (odkaz) po dokončení transakce.  
6. Obsluha naskenuje všechny položky zákazníka a zahájí platební proces.    
 

7. Jakmile jsou určena všechna data transakce (položky, způsob platby atd.), systém pokladny vygeneruje užitečná data transakce (JSON) a odešle další požadavek na fiskální službu (storeDocument), čímž se transakce dokončí (uloží).

Určité informace z objektu fiscalResponse obdrženého během volání createDocument musí být zahrnuty do datové náplně („fiscalDocumentNumber“, „fiscalDocumentStartTime“ a případně prvky specifické pro danou zemi, jako je například „fiscalDocumentRevision“ v Německu).

Upozornění: do datové náplně smí být zahrnuty pouze výše uvedené prvky, nikoli celý objekt fiscalResponse!
  
    8. Fiskální služba přijímá požadavky od nadřazeného systému a zpracovává je v souladu s požadavky specifickými pro danou zemi (např. podepisování atd.).
    9. Daňová služba odešle odpověď (fiscalResponse) do nadřazeného systému.
  10. Pokladní systém přijme fiskální odpověď (fiscalResponse), extrahuje informace potřebné pro vytvoření dokladu (např. podpis dokladu, QR kód atd.) a doklad vytiskne.  
11. Obsluha předá vytištěnou účtenku zákazníkovi    

Proces prodeje v maloobchodě se zrušením transakce

Pokud, jak je popsáno výše, během kroku 6, tj. PO odeslání createDocument (krok 2) a PŘED odesláním storeDocument (krok 7), pokladní systém odešle cancelDocument MÍSTO storeDocument.

Upozornění: příkaz cancelDocument se používá ke zrušení (ukončení) nedokončené transakce, a NE (!) k zaznamenání vráceného zboží.

Vrácení zboží se zpracovává stejným způsobem jako běžné prodejní transakce, a to pomocí příkazů createDocument a storeDocument.

 

Tento článek byl přeložen automaticky.

Související články

Komentáře

0 komentářů

Prosím přihlaste se, abyste mohli napsat komentář.

Používá technologie Zendesk