Skip to main content

Osnovni postupak prijenosa dokumenta

Harald Krondorfer
  • Ažurirano

Izrada fiskalnog modula

Za prijenos fiskalnih dokumenata (fiskalnih podataka) prvo morate stvoriti fiskalni modul. To se može učiniti na nekoliko načina:

  • Ako koristite pouzdanu fiskalnu uslugu (Windows ili Linux uslugu), fiskalni modul će za vas automatski stvoriti fiskalna usluga.
  • Ako planirate integraciju fiskalnog modula izravnom .NET DLL integracijom, morate sami instancirati fiskalni modul. Detaljan opis možete pronaći u nastavku:
    Kreiranje / instanciranje fiskalnog modula
Napomena: Fiskalni modul inicijalizira nekoliko podmodula i ne bi se smio iznova stvarati za svaki račun (npr. samoprovjera TSS hardvera (Njemačka) zahtijeva najmanje 30 sekundi). Osim toga, metoda je pozvati CloudConnect prije prijenosa dokumenata, inače će arhiviranje u oblaku neuspjeti (potrebno samo ako je omogućeno arhiviranje u oblaku).

Prijenos dokumenata

Za prijenos fiskalnih dokumenata u fiskalni modul potrebno vam je najmanje 2 koraka:

  • CreateDocument
  • PohraniDokument

Neovisno o zemlji, preporučujemo pozivanje metode CreateDocument u svakom slučaju.

Pažnja: metodu CreateDocument potrebno je pozvati na početku dokumenta (prilikom registracije artikla). To je apsolutno nužno za zakonitu implementaciju fiskalizacije (npr. u Njemačkoj). Morate postaviti polje FiscalResponse dokumenta za pohranu na vrijednost FiscalResponse koju ste dobili pozivom metode CreateDocument.

Primjer dokumenta računa kao 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
   }
]
}

Ovaj račun sadrži:

  • jednu stavku pozicije s artiklom "000714", "Blume grün", s cijenom od 4,3 EUR bruto (1 komad).
  • 2 uplate, jedna stavka od 5 EUR u gotovini i povrat od 0,7 EUR
Napomena: Kako biste vidjeli kako dokument treba biti sastavljen, možete pogledati primjer klijentske aplikacije fiskalne usluge (C#) koji se nalazi u odjeljku za preuzimanje (http://www.retailforce.cloud/downloads ). Također prikazuje rezultirajući JSON kada pokrenete primjernu aplikaciju. Molimo provjerite da je fiskalna usluga instalirana i pokrenuta na istoj računalu.

Za poništavanje prethodno stvorenog dokumenta možete pozvati metodu:

  • CancelDocument
Napomena: Svaki stvoreni dokument (metodom CreateDocument) mora se zatvoriti metodom StoreDocument ili otkazati metodom CancelDocument.

Da biste validirali dokument prije njegova prijenosa u fiskalni modul, možete pozvati

  • ValidateDocument
Informacija: Sam dokument uvijek će biti provjeren prije pohrane (čak i ako je otkazan). Ako dođe do pogreške pri provjeri, metoda StoreDocument će završiti iznimkom.

Procesi detaljno

Proces prodaje na malo

Prodaja robe, na primjer u maloprodaji, odvija se na sljedeći način:

Operator Sustav blagajne RetailForce usluga fiskalizacije
1. Operater (korisnik blagajne) unosi prvi artikl koji kupac želi kupiti.    
  2. Sustav blagajne šalje zahtjev fiskalnoj službi (createDocument) za registraciju početka odgovarajuće transakcije.  
    3. Fiskalna služba prima zahtjev od nadređenog sustava i obrađuje ga u skladu sa zahtjevima specifičnim za pojedinu državu (npr. potpisivanje itd.).
    4. Fiskalna služba šalje odgovor (fiscalResponse) nadređenom sustavu.
  5. Sustav blagajne (gornji sustav) prima odgovor i pohranjuje njegove dijelove (ili cijeli objekt odgovora) za daljnju upotrebu (pozivanje) kada se transakcija dovrši.  
6. Operater skenira sve artikle kupca i pokreće postupak plaćanja.    
 

7. Nakon što su svi podaci o transakciji utvrđeni (artikli, način plaćanja itd.), POS sustav generira payload transakcije (JSON) i šalje još jedan zahtjev fiskalnoj službi (saveDocument), koja dovršava (pohranjuje) transakciju.

Određene informacije iz odgovora fiscalResponse primljenog tijekom postupka createDocument moraju biti uključene u payload ("fiscalDocumentNumber", "fiscalDocumentStartTime" i, ako je primjenjivo, elementi specifični za pojedinu državu kao što je "fiscalDocumentRevision" u Njemačkoj).

Napomena: u payload se mogu uključiti samo gore navedeni elementi, a NE cijeli objekt fiscalRespons!
  
    8. Fiskalna služba prima zahtjeve od nadređenog sustava i obrađuje ih u skladu sa zahtjevima specifičnim za pojedinu zemlju (npr. potpisivanje itd.).
    9. Porezna služba šalje odgovor (fiscalResponse) nadređenom sustavu.
  10. Sustav blagajne prima fiscalResponse, izdvaja informacije potrebne za izradu dokumenta (npr. potpis dokumenta, QR kod itd.) i ispisuje dokument.  
11. Operater predaje ispisani račun kupcu    

Prodajni proces u maloprodaji s otkazivanjem transakcije

Ako, kao što je gore opisano, tijekom 6. koraka, tj. NAKON slanja createDocument (2. korak) i PRIJE slanja storeDocument (7. korak), POS sustav pošalje cancelDocument UMJESTO storeDocument.

Napomena: cancelDocument se koristi za otkazivanje (napuštanje) nepotpune transakcije i NE (!) za evidentiranje povrata.

Vraćanje robe obrađuje se na isti način kao i normalne prodajne transakcije, koristeći createDocument i storeDocument.

 

Ovaj je članak automatski preveden.

Povezani članci

Komentari

0 komentara

Molimo Prijavite se kako bi ostavili komentar.

Powered by Zendesk