Gå til hovedindhold

Grundlæggende proces for dokumentoverførsel

Harald Krondorfer
  • Opdateret

Oprettelse af det skattemæssige modul

For at overføre skattedokumenter (skattedata) skal du først oprette et skattemodul. Dette kan gøres på flere måder:

  • Hvis du bruger den pålidelige skattemæssige tjeneste (Windows- eller Linux-tjeneste), oprettes skattemodulet automatisk for dig af den skattemæssige tjeneste.
  • Hvis du planlægger at integrere det skattemæssige modul via direkte .NET DLL-integration, skal du selv instansiere det skattemæssige modul. En detaljeret beskrivelse findes nedenfor:
    Opret/instansier det skattemæssige modul
Bemærk: Det skattemæssige modul initialiserer et par undermoduler og bør ikke oprettes på ny for hver kvittering (f.eks. tager selvtesten af TSS-hardware (Tyskland) mindst 30 sekunder). Derudover skal du kalde CloudConnect, før du overfører dokumenter, ellers vil arkivering i skyen mislykkes (kun nødvendigt, hvis arkivering i skyen er aktiveret).

Overførsel af dokumenter

For at overføre skattedokumenter til skattemodulet skal du gennemføre mindst 2 trin:

  • createDocument
  • storeDocument

Uanset hvilket land der er tale om, anbefaler vi, at metoden createDocument altid kaldes.

OBS: createDocument skal kaldes i starten af et dokument (når du registrerer en vare). Dette er absolut nødvendigt for at implementere skattepligt på lovlig vis (f.eks. i Tyskland). Du skal indstille dokumentets fiscalResponse til den fiscalResponse, du fik, da du kaldte metoden createDocument.

Eksempel på kvitteringsdokument som 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
   }
]
}

Denne kvittering indeholder:

  • én vareposition med varen "000714", "Blume grün", til en pris på 4,3 EUR brutto (1 stk.).
  • 2 betalinger, en post med 5 EUR i kontanter og en tilbagebetaling på 0,7 EUR
Bemærk: For at se, hvordan et dokument skal sammensættes, kan du se eksemplet på Fiscal Service Client Sample (C#), som du finder i download-sektionen (http://www.retailforce.cloud/downloads ). Det viser også den resulterende JSON, når du starter eksempelapplikationen. Sørg for, at Fiscal Service er installeret og kører på samme maskine.

For at annullere et tidligere oprettet dokument kan du kalde metoden:

  • cancelDocument
OBS: Hvert oprettede dokument (med createDocument) skal lukkes med storeDocument eller annulleres med cancelDocument.

For at validere et dokument, inden det overføres til skattemodulet, kan du kalde

  • ValidateDocument
Oplysning: Selve dokumentet vil altid blive valideret, før det gemmes (også selvom det annulleres). Hvis der opstår en valideringsfejl, vil metoden storeDocument mislykkes med en undtagelse.

Processer i detaljer

Salgsproces i detailhandlen

Salget af varer, f.eks. i detailhandlen, foregår som følger:

Operatør Kassesystem RetailForce-fiskaliseringsservice
1. Operatøren (kassebrugeren) indtaster den første vare, som kunden ønsker at købe.    
  2. Kassesystemet sender en anmodning til Fiscalisation Service (createDocument) om at registrere starten på den pågældende transaktion.  
    3. Fiscal Service modtager anmodningen fra det opstrøms system og behandler den i overensstemmelse med landespecifikke krav (f.eks. signering osv.).
    4. Fiscal Service sender et svar (fiscalResponse) til det opstrøms system.
  5. Kassesystemet (det opstrøms system) modtager svaret og gemmer dele af det (eller hele svarobjektet) til senere brug (reference), når transaktionen er afsluttet.  
6. Operatøren scanner alle kundens varer og indleder betalingsprocessen.    
 

7. Når alle transaktionsdata er fastlagt (varer, betalingsmetode osv.), genererer POS-systemet transaktionspayloaden (JSON) og sender endnu en anmodning til skatteservicen (storeDocument), som derved afslutter (gemmer) transaktionen.

Visse oplysninger fra fiscalResponse, der modtages under createDocument, skal medtages i payload’en (‘fiscalDocumentNumber’, “fiscalDocumentStartTime” og, hvis relevant, landespecifikke elementer såsom ‘fiscalDocumentRevision’ i Tyskland).

OBS: Kun de ovenfor anførte elementer må medtages i payload, IKKE hele fiscalResponse-objektet!
  
    8. Den skattemæssige tjeneste modtager anmodninger fra det opstrøms system og behandler dem i overensstemmelse med landespecifikke krav (f.eks. signering osv.).
    9. Fiscal Service sender et svar (fiscalResponse) til det opstrøms system.
  10. Kassesystemet modtager fiscalResponse, udtrækker de oplysninger, der kræves til oprettelse af dokumentet (f.eks. dokumentsignatur, QR-kode osv.), og udskriver dokumentet.  
11. Operatøren udleverer den udskrevne kvittering til kunden    

Salgsproces i detailhandlen med annullering af transaktion

Hvis POS-systemet, som beskrevet ovenfor, i trin 6, dvs. EFTER afsendelse af createDocument (trin 2) og FØR afsendelse af storeDocument (trin 7), sender et cancelDocument I STEDET FOR et storeDocument.

Bemærk: cancelDocument bruges til at annullere (afbryde) en ufuldstændig transaktion og IKKE (!) til at registrere returvarer.

Returvarer behandles på samme måde som normale salgstransaktioner ved hjælp af createDocument og storeDocument.

 

Denne artikel er oversat automatisk.

Relaterede artikler

Kommentarer

0 kommentarer

Log ind for at kommentere.

Drevet af Zendesk