Skip to main content

Основни процес преноса докумената

Harald Krondorfer
  • Updated

Креирање фискалног модула

Да бисте пренели фискалне документе (фискалне податке), прво морате да креирате фискални модул. То се може урадити на неколико начина:

  • Ако користите поуздану фискалну услугу (Windows или Linux сервис), фискални модул ће за вас бити аутоматски креиран од стране фискалне услуге.
  • Ако планирате интеграцију фискалног модула директном .NET DLL интеграцијом, морате сами иницирати фискални модул. Детаљан опис можете пронаћи у наставку:
    Креирање / иницирање фискалног модула
Пажња: Фискални модул иницира неколико подмодула и не би требало да се креира поново за сваки пријем (нпр. самопроверa TSS хардвера (Немачка) траје најмање 30 секунди). Поред тога, метода је да се позове CloudConnect пре преноса докумената, у супротном ће архивирање у облаку пропасти (потребно само ако је омогућено архивирање у облаку).

Пренос докумената

Да бисте пренели фискалне документе у фискални модул, потребно је најмање 2 корака:

  • CreateDocument
  • StoreDocument

Без обзира на земљу, препоручујемо да у сваком случају позовете методу CreateDocument.

Пажња: CreateDocument мора бити позвана на почетку документа (када региструјете артикал). Ово је апсолутно неопходно за легалну имплементацију фискализације (нпр. у Немачкој). Морате да подесите FiscalResponse документа за чување са FiscalResponse који сте добили када позовете методу CreateDocument.

Пример документа потврде као 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
   }
]
}

Овај рачун садржи:

  • једну ставку позиције са артиклом "000714", "Blume grün", по цени од 4,3 EUR бруто (1 комад).
  • 2 уплате, једна ставка од 5 EUR у готовини и повраћај од 0,7 EUR
Напомена: Да бисте видели како документ треба да буде састављен, можете погледати пример клијента фискалне услуге (C#) који се налази у одељку за преузимање (http://www.retailforce.cloud/downloads ). Такође се приказује резултујући JSON када покренете пример апликације. Уверите се да је фискална услуга инсталирана и покренута на истом рачунару.

Да бисте поништили претходно креирани документ, можете позвати методу:

  • CancelDocument
Пажња: Сваки креирани документ (позивom CreateDocument) мора бити затворен помоћу StoreDocument или отказан помоћу CancelDocument.

Да бисте валидавали документ пре него што га пренесете у фискални модул, можете позвати

  • ValidateDocument
Информације: Сам документ ће увек бити проверен пре него што се сачува (чак и ако је отказан). Ако дође до грешке при провери, метод StoreDocument ће избацити изузетак.

Процеси у детаљима

Процес продаје у малопродаји

Продаја робе, на пример у малопродаји, је следећа:

Оператор Систем касе RetailForce услуга фискализације
1. Оператор (корисник касе) уноси прву ставку коју купац жели да купи.    
  2. Систем касе шаље захтев фискалној служби (createDocument) за регистрацију почетка одговарајуће трансакције.  
    3. Фискална служба прима захтев од надређеног система и обрађује га у складу са специфичним захтевима земље (нпр. потписивање итд.).
    4. Фискална служба шаље одговор (fiscalResponse) горењем систему.
  5. Систем касе (горепоточни систем) прима одговор и чува његове делове (или цео објекат одговора) за даљу употребу (референцу) када је трансакција завршена.  
6. Оператор скенира све артикле купца и покреће процес плаћања.    
 

7. Када су сви подаци о трансакцији утврђени (артикли, начин плаћања итд.), ПОС систем генерише ЈСОН објекат трансакције и шаље још један захтев фискалној служби (storeDocument), која завршава (сачувала) трансакцију.

Одређене информације из `fiscalResponse` примљеног током `createDocument` морају бити укључене у `payload` ("fiscalDocumentNumber", "fiscalDocumentStartTime" и, ако је применљиво, елементи специфични за поједине земље, као што је `fiscalDocumentRevision` у Немачкој).

Пажња: у payload могу бити укључени само горе наведени елементи, А НЕ цео објекат fiscalRespons!
  
    8. Фискална служба прима захтеве од надређеног система и обрађује их у складу са захтевима специфичним за земљу (нпр. потписивање итд.).
    9. Фискална служба шаље одговор (fiscalResponse) горењем систему.
  10. Систем касе прима fiscalResponse, издваја информације потребне за креирање документа (нпр. потпис документа, QR код итд.) и штампа документ.  
11. Оператер предаје штампани рачун купцу    

Процес продаје у малопродаји са отказом трансакције

Ако, као што је горе описано, током корака 6, односно НАКОН слања createDocument (корак 2) и ПРЕ слања storeDocument (корак 7), ПОС систем пошаље cancelDocument УМЕСТО storeDocument.

Пажња: cancelDocument се користи за отказивање (напуштање) непотпуне трансакције и НЕ (!) за евидентирање поврата.

Враћање робе се обрађује на исти начин као и нормалне продајне трансакције, користећи createDocument и storeDocument.

 

Овај чланак је аутоматски преведен.

Povezani članci

Komentari

Komentara: 0

Molimo prijavi se da biste komentarisali.

Powered by Zendesk