Pereiti prie pagrindinio turinio

Pagrindinis dokumentų perkėlimo procesas

Harald Krondorfer
  • Atnaujintas

Fiskalinio modulio sukūrimas

Fiskalinių duomenų (kvito) siuntimui reikia sukurti fiskalinį modulį. 

  • Jei naudojama „Trusted Fiscal Service“, fiskalinis modulis atitinkamam sukonfigūruotam klientui automatiškai instancijuojamas ir sukurtas.
  • Jei siekiama integracijos tiesiogiai prijungiant .net DLL, fiskalinį modulį reikia instancijuoti pačiam. Išsamesnį aprašymą galite rasti čia:
    Fiskalinio modulio kūrimas / instancijavimas
Dėmesio: Fiskalinis modulis inicijuoja keletą submodulių ir neturėtų būti instancijuojamas iš naujo kiekvienam dokumentui (pvz., aparatinės įrangos TSE savikontrolė trunka apie 30 sekundžių). Be to, prieš perduodant dokumentus reikia iškviesti metodą „CloudConnect“, kitaip debesų archyvavimas nepavyks (būtina tik tada, kai įjungtas debesų archyvavimas).

Dokumentų perdavimas

Norint perduoti dokumentus, reikia atlikti šiuos 2 veiksmus:

  • CreateDocument
  • StoreDocument

Nepriklausomai nuo šalies, kurioje įdiegta sistema, rekomenduojame iškviesti metodą „CreateDocument“.

Dėmesio: CreateDocument turi būti iškviesta dokumento pradžioje (įvedant prekę). Tai yra būtina, norint teisiškai saugiai įgyvendinti fiskalizaciją (pvz., Vokietijoje).

Pavyzdinis dokumentas json formatu:

"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
}
]
}

Dokumentas apima:

  • vieną prekės poziciją su preke „000714“, „Žalia gėlė“, kurios kaina yra 4,3 EUR su PVM (kiekis 1).
  • 2 mokėjimus, 1x 5 EUR ir 0,7 EUR grąžą.
Pastaba: Norėdami pamatyti, kaip sudaromas fiskalinis dokumentas (document), peržiūrėkite pavyzdį „Fiscal Service Client Sample“ skyriuje „Downloads“ (http://www.retailforce.cloud/downloads ). Šiame pavyzdyje taip pat galima išvesti galutinį JSON, kad būtų lengviau suprasti. Įsitikinkite, kad fiskalinė paslauga yra įdiegta ir veikia toje pačioje mašinoje.

Norint atšaukti sukurtą dokumentą, galima iškviesti šį metodą:

  • CancelDocument
Dėmesio: kiekvienas dokumentas, pradėtas kurti naudojant CreateDocument, turi būti užbaigtas arba atšauktas.

Norint patikrinti dokumentą prieš perdavimą, galima naudoti šį metodą

  • ValidateDocument
Informacija: Dokumentas tikrinamas kiekvieno perdavimo proceso metu (StoreDocument, CancelDocument). Jei atsiranda tikrinimo klaida, sukeliamas išimtinis atvejis.

Procesai išsamiai

Prekybos procesas

Prekių pardavimas, pavyzdžiui, prekyboje, vyksta taip:

Operatorius Kasinės sistemos „RetailForce“ fiskalinės paslaugos
1. Operatorius (kasos vartotojas) įveda pirmąjį prekę, kurią klientas nori įsigyti.    
  2. Kasos sistema perduoda užklausą „Fiscal Service“ (createDocument), kad užregistruotų atitinkamos operacijos pradžią.  
    3. Fiscal Service priima užklausą iš išorinės sistemos ir ją apdoroja pagal konkrečios šalies reikalavimus (pvz., pasirašymas ir pan.).
    4. Fiscal Service atsako į pirminę sistemą atsakymu (fiscalResponse).
  5. Kasos sistema (pirminė sistema) priima atsakymą ir išsaugo jo dalį (arba visą atsakymo objektą) tolesniam naudojimui (nuoroda) užbaigiant sandorį.  
6. Operatorius įveda visus kliento prekių kodus ir pradeda mokėjimo procesą.    
 

7. Kai visi sandorio duomenys yra nustatyti (prekės, mokėjimo būdas ir pan.), kasos sistema sukuria sandorio duomenų paketą (JSON) ir nusiunčia dar vieną užklausą į Fiscal Service (storeDocument), kuria sandoris užbaigiamas (išsaugomas).

Tam tikra informacija iš „fiscalResponse“, gauto vykdant „createDocument“, turi būti įtraukta į duomenų paketą („fiscalDocumentNumber“, „fiscalDocumentStartTime“ ir, jei taikoma, šalies specifinius elementus, pvz., „fiscalDocumentRevision“ Vokietijoje).

Dėmesio: į duomenų paketą NEGALIMA įtraukti viso „fiscalResponse“ objekto, o tik aukščiau nurodytus elementus!
  
    8. Fiscal Service priima prašymą iš išorinės sistemos ir jį apdoroja pagal konkrečiai šaliai taikomus reikalavimus (pvz., pasirašymą ar pan.).
    9. Fiscal Service atsako į išankstinę sistemą atsakymu (fiscalResponse).
  10. Kasos sistema gauna „fiscalResponse“, išskiria informaciją, reikalingą kvito sukūrimui (pvz., kvito parašą, QR kodą ir pan.), ir atspausdina kvitą.  
11. Operatorius perduoda išspausdintą kvitą klientui    

Pardavimo procesas prekyboje su sandorio nutraukimu

Jei pardavimo procesas, kaip parodyta aukščiau, nutraukiamas 6 žingsnio metu, t. y. PO createDocument perdavimo (2 žingsnis) ir PRIEŠ storeDocument perdavimą (7 žingsnis), kasos sistema perduoda cancelDocument, o NE storeDocument.

Dėmesio: „cancelDocument“ naudojamas nebaigtos transakcijos nutraukimui, o NE (!) grąžinamų prekių apdorojimui.

Grąžinimai, kaip ir įprastos pardavimo transakcijos, tvarkomi naudojant „createDocument“ ir „storeDocument“.

 

Susiję straipsniai

Komentarai

0 komentarų

Tam, kad paliktumėte komentarus prisijunkite

Powered by Zendesk