Gå til hovedindhold

PUT /api/v1/transactions/createDocument

Harald Krondorfer
  • Opdateret

Dette endpoint er det første trin i overførslen af transaktioner fra det elektroniske registreringssystem („kasseapparat“) til skattemyndighederne. Processen består altid af to trin. Denne to-trinsproces for transaktionsoverførsel er baseret på kravene i den tyske forordning om sikring mod manipulation af kasseapparater og skal gennemføres i alle lande med skattepligt i form af en standardiseret grænseflade. I Tyskland registreres en transaktion i den såkaldte tekniske sikkerhedsenhed (TSE/TSS), når PUT /api/v1/transactions/createDocument kaldes.

Registrering af transaktioner

En transaktion/et dokument registreres i den skattemæssige enhed:

Afbrydelse af transaktion

Dette registrerer afbrydelsen af en transaktion i den skattemæssige enhed:

Bemærk: Alle transaktioner, der er startet med PUT /api/v1/transactions/createDocument, skal afsluttes med enten POST /api/v1/transactions/storeDocument eller POST /api/v1/transactions/cancelDocument! Bemærk venligst listTransactions (DELETE).

Resultat

Et vellykket kald til endpointet (200)

  • registrerer starten på en transaktion i regnskabsenheden og
  • returnerer et »fiscalResponse« til det opstrøms system (det elektroniske registreringssystem).

Anvendelse

Forudsætninger

  • Fiskal Client skal være initialiseret

Formularfelter

Følgende oplysninger skal sendes:

Betegnelse Type Beskrivelse Eksempel
clientId

M

 Kasseapparatets uniqueClientId (fra RetailForce systemet). c1062c55-57c4-4ed2-9c53-aff1762326a4
documentType

M

Den type dokument, der skal registreres.

Enum:

  • [0] = Kvittering
  • [1] = Faktura
  • [2] = Leveringsseddel
  • [10] = Udbetaling
  • [11] = PayIn
  • [12] = Proformafaktura
  • [13] = Kundeordre
  • [14] = PreliminaryReceipt
  • [80] = LongTermOrder
  • [90] = OpeningBalance
  • [98] = CashCheck
  • [99] = EndOfDay
  • [100] = Lager
  • [101] = Indkøb
  • [1000] = NullKvittering
  • [1100] = Diverse ikke-fiskale
 -
DocumentGuid

R

Den GUID/UUID, som POS-systemet har tildelt transaktionen.

Adfærd for "DocumentGuid" inkluderet i anmodningen:

  • Angivelse af "DocumentGuid" gør opkaldet idempotent.
  • createDocument kan kaldes flere gange uden at starte en ny transaktion i TSE (Technical Security Device Germany).
  • "fiscalResponse": Der returneres altid det SAMME svar.

Adfærd UDEN "DocumentGuid" i anmodningen:

  • Hvis der ikke angives noget "DocumentGuid", startes der en ny transaktion i TSE (Tyskland) ved HVERT kald til createDocument!
  • "fiscalResponse": Der returneres et NYT svar hver gang.

Bemærk: Den samme "DocumentGuid" skal også bruges i det efterfølgende kald til POST /api/v1/transactions/storeDocument.

 b5744d8c-71ec-4ea0-a340-53070da8b5a1

Svar

Mulige svar:

Kode Beskrivelse Eksempel
200 Transaktionen er startet, og der returneres en fiscalResponse til det opstrøms system -

 

Denne artikel er oversat automatisk.

Relaterede artikler

Kommentarer

0 kommentarer

Log ind for at kommentere.

Drevet af Zendesk