Hoppa till huvudinnehållet

Grundläggande process för dokumentöverföring

Harald Krondorfer
  • Uppdaterad

Skapande av skattemodulen

För att överföra skattedokument (skattedata) måste du först skapa en skattemodul. Detta kan göras på flera sätt:

  • Om du använder den betrodda skattetjänsten (Windows- eller Linux-tjänst) skapas skattemodulen automatiskt åt dig av skattetjänsten.
  • Om du planerar att integrera den skattemässiga modulen med direkt .NET DLL-integration måste du själv instansiera den skattemässiga modulen. En detaljerad beskrivning finns nedan:
    Skapa/instansiera den skattemässiga modulen
Observera: Skattemodulen initialiserar några undermoduler och bör inte skapas på nytt för varje kvitto (t.ex. kräver självtestet av TSS-hårdvaran (Tyskland) minst 30 sekunder). Dessutom måste du anropa CloudConnect innan du överför dokument, annars misslyckas molnarkiveringen (krävs endast om molnarkivering är aktiverad).

Överföring av dokument

För att överföra skattedokument till skattemodulen krävs minst två steg:

  • createDocument
  • storeDocument

Oavsett land rekommenderar vi att metoden createDocument anropas i alla fall.

Observera: createDocument måste anropas i början av ett dokument (när du registrerar en artikel). Detta är absolut nödvändigt för att implementera skattehanteringen på ett lagligt sätt (t.ex. i Tyskland). Du måste ställa in dokumentets fiscalResponse till den fiscalResponse du fick när du anropade metoden createDocument.

Exempel på kvittodokument i JSON-format:

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

Detta kvittodokument innehåller:

  • en artikelpost med artikeln ”000714”, ”Blume grün”, till ett pris på 4,3 EUR brutto (1 styck).
  • 2 betalningar, en post med 5 EUR i kontanter och en återbetalning på 0,7 EUR
Obs! För att se hur ett dokument ska sammanställas kan du titta på exemplet på en client för skattetjänsten (C#) som du hittar i nedladdningsavsnittet (http://www.retailforce.cloud/downloads ). Det visar också den resulterande JSON-koden när du startar exempelapplikationen. Se till att skattetjänsten är installerad och igång på samma dator.

För att annullera ett tidigare skapat dokument kan du anropa metoden:

  • cancelDocument
Observera: Varje dokument som skapas (med createDocument) måste stängas med storeDocument eller annulleras med cancelDocument.

För att validera ett dokument innan det överförs till skattemodulen kan du anropa

  • ValidateDocument
Information: Dokumentet i sig valideras alltid innan det sparas (även om det annulleras). Om ett valideringsfel uppstår kommer metoden storeDocument att misslyckas och generera ett undantag.

Processer i detalj

Försäljningsprocess inom detaljhandeln

Försäljningen av varor, till exempel inom detaljhandeln, går till på följande sätt:

Operatör Kassasystem RetailForce Fiscalisation Service
1. Operatören (kassanvändaren) matar in den första varan som kunden vill köpa.    
  2. Kassasystemet skickar en begäran till fiscalisationstjänsten (createDocument) för att registrera starten på den aktuella transaktionen.  
    3. Fiscal Service tar emot begäran från det uppströms liggande systemet och behandlar den i enlighet med landspecifika krav (t.ex. signering m.m.).
    4. Fiscal Service skickar ett svar (fiscalResponse) till det uppströms liggande systemet.
  5. Kassasystemet (det uppströms liggande systemet) tar emot svaret och lagrar delar av det (eller hela svarsobjektet) för vidare användning (referens) när transaktionen är slutförd.  
6. Operatören skannar alla kundens varor och inleder betalningsprocessen.    
 

7. När alla transaktionsuppgifter har fastställts (varor, betalningssätt m.m.) genererar kassasystemet transaktionsdata (JSON) och skickar en ny begäran till skattetjänsten (storeDocument), vilket slutför (sparar) transaktionen.

Viss information från fiscalResponse som mottagits under createDocument måste ingå i payload (”fiscalDocumentNumber”, ”fiscalDocumentStartTime” och, i förekommande fall, landsspecifika element såsom ”fiscalDocumentRevision” i Tyskland).

Observera: endast de element som anges ovan får inkluderas i payload och INTE hela fiscalResponse-objektet!
  
    8. Skattetjänsten tar emot förfrågningar från det uppströms liggande systemet och bearbetar dem i enlighet med landspecifika krav (t.ex. signering m.m.).
    9. Fiscal Service skickar ett svar (fiscalResponse) till det uppströms liggande systemet.
  10. Kassasystemet tar emot fiscalResponse, extraherar den information som krävs för att skapa dokumentet (t.ex. dokumentsignatur, QR-kod osv.) och skriver ut dokumentet.  
11. Operatören överlämnar det utskrivna kvittot till kunden    

Försäljningsprocess inom detaljhandeln med transaktionsavbrytning

Om, såsom beskrivs ovan, under steg 6, dvs. EFTER att createDocument har skickats (steg 2) och INNAN storeDocument skickas (steg 7), skickar kassasystemet ett cancelDocument ISTÄLLET FÖR ett storeDocument.

Observera: cancelDocument används för att avbryta (avbryta) en ofullständig transaktion och INTE (!) för att hantera returer.

Returer hanteras på samma sätt som vanliga försäljningstransaktioner, med hjälp av createDocument och storeDocument.

 

Den här artikeln har översatts automatiskt.

Relaterade artiklar

Kommentarer

0 kommentarer

logga in för att lämna en kommentar.

Powered by Zendesk