Przejdź do głównej zawartości

Podstawowy proces przekazywania dokumentów

Harald Krondorfer
  • Zaktualizowano

Tworzenie modułu fiskalnego

Aby przesyłać dokumenty fiskalne (dane fiskalne), należy najpierw utworzyć moduł fiskalny. Można to zrobić na kilka sposobów:

  • Jeśli korzystają Państwo z zaufanej usługi fiskalnej (usługa w systemie Windows lub Linux), moduł fiskalny zostanie automatycznie utworzony przez tę usługę.
  • Jeśli planują Państwo integrację modułu fiskalnego poprzez bezpośrednią integrację biblioteki DLL .NET, muszą Państwo samodzielnie zainicjować moduł fiskalny. Szczegółowy opis znajduje się poniżej:
    Utworzenie / zainicjowanie modułu fiskalnego
Uwaga: Moduł fiskalny inicjuje kilka podmodułów i nie należy go tworzyć od nowa dla każdego paragonu (np. autotest sprzętu TSS (Niemcy) trwa co najmniej 30 sekund). Ponadto przed przesłaniem dokumentów należy wywołać metodę CloudConnect, w przeciwnym razie archiwizacja w chmurze zakończy się niepowodzeniem (wymagane tylko wtedy, gdy archiwizacja w chmurze jest włączona).

Przesyłanie dokumentów

Aby przesłać dokumenty fiskalne do modułu fiskalnego, należy wykonać co najmniej 2 kroki:

  • createDocument
  • storeDocument

Niezależnie od kraju zalecamy wywołanie metody createDocument w każdym przypadku.

Uwaga: Metodę createDocument należy wywołać na początku tworzenia dokumentu (podczas rejestracji artykułu). Jest to absolutnie konieczne w celu zgodnego z prawem wdrożenia fiskalizacji (np. w Niemczech). Należy ustawić parametr fiscalResponse dokumentu, który ma zostać zapisany, na wartość otrzymaną podczas wywołania metody createDocument.

Przykładowy dokument paragonu w formacie 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
   }
]
}

Niniejszy dokument paragonowy zawiera:

  • jedną pozycję z pozycją „000714”, „Blume grün”, o cenie 4,3 EUR brutto (1 sztuka).
  • 2 płatności: pozycję o wartości 5 EUR w gotówce oraz resztę w wysokości 0,7 EUR
Uwaga: Aby zapoznać się ze sposobem tworzenia dokumentu, proszę przejrzeć przykładowy kod Fiscal Service Client Sample (w języku C#), który znajduje się w sekcji plików do pobrania (http://www.retailforce.cloud/downloads ). Pokazuje on również wynikowy format JSON po uruchomieniu przykładowej aplikacji. Proszę upewnić się, że usługa fiskalna jest zainstalowana i uruchomiona na tym samym komputerze.

Aby anulować wcześniej utworzony dokument, można wywołać metodę:

  • cancelDocument
Uwaga: Każdy utworzony dokument (za pomocą metody createDocument) musi zostać zamknięty za pomocą metody storeDocument lub anulowany za pomocą metody cancelDocument.

Aby zweryfikować dokument przed przekazaniem go do modułu fiskalnego, można wywołać metodę

  • ValidateDocument
Informacja: Sam dokument zostanie zawsze zweryfikowany przed zapisaniem (nawet jeśli zostanie anulowany). W przypadku wystąpienia błędu weryfikacji metoda storeDocument zakończy się niepowodzeniem i zgłosi wyjątek.

Szczegółowy opis procesów

Proces sprzedaży detalicznej

Sprzedaż towarów, na przykład w handlu detalicznym, przebiega następująco:

Operator System kasowy Usługa fiskalizacji RetailForce
1. Operator (użytkownik kasy fiskalnej) wprowadza pierwszą pozycję, którą klient zamierza nabyć.    
  2. System kasowy wysyła żądanie do serwisu fiskalnego (createDocument) w celu zarejestrowania rozpoczęcia danej transakcji.  
    3. Usługa fiskalna odbiera żądanie z systemu nadrzędnego i przetwarza je zgodnie z wymogami obowiązującymi w danym kraju (np. podpisanie itp.).
    4. Usługa fiskalna wysyła odpowiedź (fiscalResponse) do systemu nadrzędnego.
  5. System kasowy (system nadrzędny) odbiera odpowiedź i zapisuje jej fragmenty (lub cały obiekt odpowiedzi) do dalszego wykorzystania (jako odniesienie) po zakończeniu transakcji.  
6. Operator skanuje wszystkie produkty klienta i rozpoczyna proces płatności.    
 

7. Po ustaleniu wszystkich danych transakcji (pozycje, metoda płatności itp.) system kasowy generuje payload transakcji (JSON) i wysyła kolejne żądanie do serwisu fiskalnego (storeDocument), co finalizuje (zapisuje) transakcję.

W payload muszą znaleźć się określone informacje z odpowiedzi fiscalResponse otrzymanej podczas wywołania createDocument („fiscalDocumentNumber”, „fiscalDocumentStartTime” oraz, w stosownych przypadkach, elementy specyficzne dla danego kraju, takie jak „fiscalDocumentRevision” w Niemczech).

Uwaga: w payload można uwzględnić wyłącznie wymienione powyżej elementy, a NIE cały obiekt fiscalResponse!
  
    8. Usługa fiskalna odbiera żądania z systemu nadrzędnego i przetwarza je zgodnie z wymogami obowiązującymi w danym kraju (np. podpisywanie itp.).
    9. Usługa fiskalna wysyła odpowiedź (fiscalResponse) do systemu nadrzędnego.
  10. System kasowy odbiera fiscalResponse, wyodrębnia informacje niezbędne do utworzenia dokumentu (np. podpis dokumentu, kod QR itp.) i drukuje dokument.  
11. Operator wręcza wydrukowany paragon klientowi    

Proces sprzedaży w handlu detalicznym z anulowaniem transakcji

Jeśli, zgodnie z powyższym opisem, w kroku 6, tj. PO wysłaniu createDocument (krok 2) i PRZED wysłaniem storeDocument (krok 7), system kasowy wysyła cancelDocument ZAMIAST storeDocument.

Uwaga: polecenie `cancelDocument` służy do anulowania (przerwania) niekompletnej transakcji, a NIE (!) do odzwierciedlenia zwrotów.

Zwroty są przetwarzane w taki sam sposób jak zwykłe transakcje sprzedaży, przy użyciu poleceń createDocument i storeDocument.

 

Ten artykuł został przetłumaczony automatycznie.

Powiązane artykuły

Komentarze

Komentarze: 0

Zaloguj się, aby dodać komentarz.

Oparte na technologii Zendesk