Прескачане към основното съдържание

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

Harald Krondorfer
  • Обновено

Създаване на фискалния модул

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

  • Ако използвате доверен фискален сервиз (Windows или Linux), фискалният модул ще бъде създаден автоматично от него.
  • Ако планирате да интегрирате фискалния модул чрез директна .NET DLL интеграция, трябва сами да инициализирате фискалния модул. Подробно описание можете да намерите по-долу:
    Създаване / инициализиране на фискалния модул
Внимание: Фискалният модул инициализира няколко подмодула и не трябва да се създава наново за всяка разписка (например, самотестът на 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
Забележка: За да видите как трябва да бъде съставен документът, можете да разгледате примера за клиент на Fiscal Service Client Sample (C#), който ще намерите в раздела за изтегляне (http://www.retailforce.cloud/downloads ). Той показва и получения JSON файл, когато стартирате приложението за пример. Моля, уверете се, че фискалната услуга е инсталирана и стартирана на същия компютър.

За да отмените предишно създаден документ, можете да извикате метода:

  • cancelDocument
Внимание: Всеки създаден документ (с createDocument) трябва да бъде затворен с storeDocument или отменен с cancelDocument.

За да валидирате документ, преди да го прехвърлите към фискалния модул, можете да извикате

  • ValidateDocument
Информация: Самият документ винаги ще бъде валидиран, преди да бъде съхранен (дори и ако бъде отменен). Ако възникне грешка при валидирането, методът storeDocument ще се провали с изключение.

Процеси в подробности

Процес на продажбите на дребно

Продажбата на стоки, например в търговията на дребно, протича както следва:

Оператор Касова система Услуга за фискализация RetailForce
1. Операторът (потребителят на касовия апарат) въвежда първия артикул, който клиентът желае да закупи.    
  2. Касовата система изпраща заявка към фискалната услуга (createDocument) за регистриране на началото на съответната транзакция.  
    3. Фискалната услуга получава заявката от системата нагоре по веригата и я обработва в съответствие с изискванията, специфични за съответната държава (например подписване и др.).
    4. Фискалната услуга изпраща отговор (fiscalResponse) към системата нагоре по веригата.
  5. Касовата система (горестоящата система) получава отговора и съхранява части от него (или целия обект на отговора) за по-нататъшна употреба (препратка), когато транзакцията бъде завършена.  
6. Операторът сканира всички артикули на клиента и започва процеса на плащане.    
 

7. След като всички данни за транзакцията бъдат определени (артикули, начин на плащане и др.), POS системата генерира полезния payload на транзакцията (JSON) и изпраща още едно заявка към фискалната служба (storeDocument), което завършва (записва) транзакцията.

Определена информация от fiscalResponse, получена по време на createDocument, трябва да бъде включена в payload („fiscalDocumentNumber“, „fiscalDocumentStartTime“ и, ако е приложимо, специфични за страната елементи като „fiscalDocumentRevision“ в Германия).

Внимание: в payload могат да бъдат включени само изброените по-горе елементи, а НЕ целият обект fiscalResponse!
  
    8. Фискалната служба получава заявки от системата нагоре по веригата и ги обработва в съответствие с изискванията, специфични за съответната държава (например подписване и др.).
    9. Фискалната служба изпраща отговор (fiscalResponse) към системата нагоре по веригата.
  10. Касовата система получава „fiscalResponse“, извлича информацията, необходима за създаване на документа (например подпис на документа, QR код и др.) и отпечатва документа.  
11. Операторът връчва отпечатаната разписка на клиента    

Процес на продажба в търговията на дребно с анулиране на транзакция

Ако, както е описано по-горе, по време на стъпка 6, т.е. СЛЕД изпращането на createDocument (стъпка 2) и ПРЕДИ изпращането на storeDocument (стъпка 7), POS системата изпрати cancelDocument ВМЕСТО storeDocument.

Внимание: cancelDocument се използва за отмяна (прекратяване) на незавършена транзакция, а НЕ (!) за отразяване на връщания.

Връщанията се обработват по същия начин като обичайните продажбени транзакции, като се използват createDocument и storeDocument.

 

Тази статия е преведена автоматично.

Подобни статии

Коментари

0 коментара

Влезте в услугата, за да оставите коментар.

Powered by Zendesk