Salt la conținutul principal

Procesul de bază al transferului de documente

Harald Krondorfer
  • Actualizat

Crearea modulului fiscal

Pentru a transfera documente fiscale (date fiscale), trebuie mai întâi să creați un modul fiscal. Acest lucru se poate face în mai multe moduri:

  • Dacă utilizați serviciul fiscal de încredere (serviciu Windows sau Linux), modulul fiscal va fi creat automat pentru dvs. de către serviciul fiscal.
  • Dacă intenționați să realizați integrarea modulului fiscal prin integrare directă cu DLL-ul .NET, trebuie să inițializați modulul fiscal pe cont propriu. O descriere detaliată poate fi găsită mai jos:
    Crearea / inițializarea modulului fiscal
Atenție: Modulul fiscal inițializează câteva submodule și nu trebuie creat de la zero pentru fiecare chitanță (de exemplu, autotestarea hardware-ului TSS (Germania) durează cel puțin 30 de secunde). În plus, este necesar să apelați CloudConnect înainte de a transfera documentele; în caz contrar, arhivarea în cloud va eșua (necesar doar dacă arhivarea în cloud este activată).

Transferul documentelor

Pentru a transfera documente fiscale către modulul fiscal, sunt necesari cel puțin 2 pași:

  • createDocument
  • storeDocument

Indiferent de țară, recomandăm apelarea metodei createDocument în toate cazurile.

Atenție: Metoda createDocument trebuie apelată la începutul unui document (atunci când înregistrați un articol). Acest lucru este absolut necesar pentru a implementa fiscalizarea în conformitate cu legea (de exemplu: în Germania). Trebuie să setați fiscalResponse-ul documentului pe care doriți să îl stocați cu fiscalResponse-ul obținut la apelarea metodei createDocument.

Exemplu de document de chitanță în format 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
   }
]
}

Această chitanță conține:

  • o poziție de articol cu articolul „000714”, „Blume grün”, cu un preț brut de 4,3 EUR (1 bucată).
  • 2 plăți, o poziție cu 5 EUR în numerar și restul de 0,7 EUR
Notă: Pentru a vedea cum trebuie alcătuit un document, puteți consulta exemplul de client al serviciului fiscal (C#), pe care îl găsiți în secțiunea de descărcări (http://www.RetailForce.cloud/downloads ). Acesta afișează, de asemenea, JSON-ul rezultat atunci când porniți aplicația de exemplu. Asigurați-vă că aveți serviciul fiscal instalat și pornit pe același computer.

Pentru a anula un document creat anterior, puteți apela metoda:

  • cancelDocument
Atenție: Fiecare document creat (cu createDocument) trebuie închis cu storeDocument sau anulat cu cancelDocument.

Pentru a valida un document înainte de a-l transfera către modulul fiscal, puteți apela

  • ValidateDocument
Informație: Documentul în sine va fi întotdeauna validat înainte de a fi stocat (chiar și dacă este anulat). Dacă apare o eroare de validare, metoda storeDocument va eșua, generând o excepție.

Procesele în detaliu

Procesul de vânzare cu amănuntul

Vânzarea de bunuri, de exemplu în comerțul cu amănuntul, se desfășoară după cum urmează:

Operator Sistemul de casă Serviciul de fiscalizare RetailForce
1. Operatorul (utilizatorul casei de marcat) introduce primul articol pe care clientul dorește să îl achiziționeze.    
  2. Sistemul de casă de marcat trimite o solicitare către serviciul fiscal (createDocument) pentru a înregistra începutul tranzacției corespunzătoare.  
    3. Serviciul fiscal primește solicitarea de la sistemul din amonte și o procesează în conformitate cu cerințele specifice fiecărei țări (de exemplu, semnarea etc.).
    4. Serviciul fiscal trimite un răspuns (fiscalResponse) către sistemul din amonte.
  5. Sistemul de casă de marcat (sistemul din amonte) primește răspunsul și stochează părți din acesta (sau întregul obiect de răspuns) pentru utilizare ulterioară (referință) la finalizarea tranzacției.  
6. Operatorul scanează toate articolele clientului și inițiază procesul de plată.    
 

7. Odată ce toate datele tranzacției au fost stabilite (articole, metoda de plată etc.), sistemul POS generează payload-ul tranzacției (JSON) și trimite o altă solicitare către serviciul fiscal (storeDocument), care finalizează (salvează) tranzacția.

Anumite informații din fiscalResponse primite în timpul createDocument trebuie incluse în payload („fiscalDocumentNumber”, „fiscalDocumentStartTime” și, dacă este cazul, elemente specifice fiecărei țări, cum ar fi „fiscalDocumentRevision” în Germania).

Atenție: în payload pot fi incluse numai elementele enumerate mai sus și NU întregul obiect fiscalResponse!
  
    8. Serviciul fiscal primește cererile de la sistemul din amonte și le prelucrează în conformitate cu cerințele specifice fiecărei țări (de exemplu, semnarea etc.).
    9. Serviciul fiscal trimite un răspuns (fiscalResponse) către sistemul din amonte.
  10. Sistemul de casă de marcat primește răspunsul fiscalResponse, extrage informațiile necesare pentru crearea documentului (de exemplu, semnătura documentului, codul QR etc.) și imprimă documentul.  
11. Operatorul înmânează chitanța tipărită clientului    

Procesul de vânzare în comerțul cu amănuntul cu anularea tranzacției

Dacă, așa cum s-a descris mai sus, în timpul etapei 6, adică DUPĂ trimiterea comenzii createDocument (etapa 2) și ÎNAINTE de trimiterea comenzii storeDocument (etapa 7), sistemul POS trimite o comandă cancelDocument ÎN LOC DE o comandă storeDocument.

Atenție: comanda „cancelDocument” este utilizată pentru a anula (abandon) o tranzacție incompletă și NU (!) pentru a reflecta returnările.

Retururile sunt procesate în același mod ca și tranzacțiile normale de vânzare, folosind createDocument și storeDocument.

 

Acest articol a fost tradus automat.

Articole conexe

Comentarii

0 comentarii

Vă rugăm să vă autentificați pentru a lăsa un comentariu.

Susținut de Zendesk