Skip to main content

Osnovni proces prijenosa dokumenta

Harald Krondorfer
  • Updated

Kreiranje fiskalnog modula

Da biste prenijeli fiskalne dokumente (fiskalne podatke), prvo morate kreirati fiskalni modul. To se može uraditi na nekoliko načina:

  • Ako koristite pouzdanu fiskalnu uslugu (Windows ili Linux servis), fiskalni modul će za vas automatski kreirati fiskalna usluga.
  • Ako planirate integraciju fiskalnog modula direktnom .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 ga trebalo ponovo kreirati za svaki račun (npr. samoprovjera TSS hardvera (Njemačka) zahtijeva najmanje 30 sekundi). Pored 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

Da biste prenijeli fiskalne dokumente 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: metoda CreateDocument se mora pozvati na početku dokumenta (kada registrujete artikl). To je apsolutno neophodno kako bi se fiskalizacija legalno implementirala (npr. u Njemačkoj). Morate postaviti FiscalResponse dokumenta za pohranu na FiscalResponse koji ste dobili kada ste pozvali metodu 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: Da biste vidjeli kako dokument treba biti sastavljen, možete pogledati primjer klijenta 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 vas da osigurate da je fiskalna usluga instalirana i pokrenuta na istoj mašini.

Da biste otkazali prethodno kreirani dokument, možete pozvati metodu:

  • CancelDocument
Napomena: Svaki kreirani dokument (metodom CreateDocument) mora biti zatvoren metodom StoreDocument ili otkazan metodom CancelDocument.

Da biste validirali dokument prije nego što ga prenesete u fiskalni modul, možete pozvati

  • ValidateDocument
Informacija: Sam dokument će uvijek biti validiran prije nego što bude pohranjen (čak i ako je otkazan). Ako dođe do greške u validaciji, metoda StoreDocument će završiti greškom (izuzetak).

Procesi detaljno

Proces prodaje na malo

Prodaja robe, na primjer u maloprodaji, je sljedeća:

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

7. Kada su svi podaci o transakciji utvrđeni (artikli, način plaćanja itd.), POS sistem generiše payload transakcije (JSON) i šalje još jedan zahtjev fiskalnoj službi (storeDocument), koja završava (sačuvava) transakciju.

Određene informacije iz odgovora (fiscalResponse) primljenog tokom kreiranja dokumenta (createDocument) moraju biti uključene u korisni teret ('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 elementi navedeni iznad, a NE cijeli objekt fiscalRespons!
  
    8. Fiskalna služba prima zahtjeve od nadređenog sistema i obrađuje ih u skladu sa zahtjevima specifičnim za državu (npr. potpisivanje, itd.).
    9. Fiskalna služba šalje odgovor (fiscalResponse) nadređenom sistemu.
  10. Sistem kase prima fiscalResponse, izdvaja informacije potrebne za izradu dokumenta (npr. potpis dokumenta, QR kod itd.) i štampa dokument.  
11. Operater predaje isprintani račun kupcu    

Proces prodaje u maloprodaji sa otkazivanjem transakcije

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

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

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

 

Ovaj članak je automatski preveden.

Related articles

Comments

0 comments

Please sign in to leave a comment.

Powered by Zendesk