Hoppa till huvudinnehållet

PUT /api/v1/transactions/createDocument

Harald Krondorfer
  • Uppdaterad

Denna slutpunkt är det första steget i överföringen av transaktioner från det elektroniska registreringssystemet (”kassaregistret”) till skattemyndigheten. Processen består alltid av två steg. Denna tvåstegsprocess för överföring av transaktioner baseras på kraven i den tyska förordningen om manipuleringsskydd för kassaregister och måste genomföras i alla skatteländer i form av ett standardiserat gränssnitt. I Tyskland registreras en transaktion i den så kallade tekniska säkerhetsenheten (TSE/TSS) när PUT /api/v1/transactions/createDocument anropas.

Registrering av transaktioner

En transaktion/ett dokument registreras i den skattemässiga enheten:

Avbrytande av transaktion

Detta registrerar avbrytandet av en transaktion i den finansiella enheten:

Observera: alla transaktioner som påbörjats med PUT /api/v1/transactions/createDocument måste avslutas med antingen POST /api/v1/transactions/storeDocument eller POST /api/v1/transactions/cancelDocument! Observera listTransactions (DELETE).

Resultat

Ett lyckat anrop till slutpunkten (200)

  • registrerar starten på en transaktion i den skattemässiga enheten och
  • returnerar en fiscalResponse till uppströmsystemet (det elektroniska registreringssystemet).

Användning

Förutsättningar

  • Fiskal Client måste vara initialiserad

Formulärfält

Följande information måste skickas:

Beteckning Typ Beskrivning Exempel
clientId

M

 Kassasystemets uniqueClientId (från RetailForce systemet). c1062c55-57c4-4ed2-9c53-aff1762326a4
documentType

M

Typen av dokument som ska registreras.

Enum:

  • [0] = Kvitto
  • [1] = Faktura
  • [2] = Leveranssedel
  • [10] = Utbetalning
  • [11] = PayIn
  • [12] = Proformafaktura
  • [13] = Kundorder
  • [14] = PreliminaryReceipt
  • [80] = LongTermOrder
  • [90] = OpeningBalance
  • [98] = CashCheck
  • [99] = EndOfDay
  • [100] = Lager
  • [101] = Inköp
  • [1000] = Ogiltigt kvitto
  • [1100] = Övrigt icke-skattepliktigt
 -
DocumentGuid

R

Det GUID/UUID som tilldelats transaktionen av kassasystemet.

Beteende för "DocumentGuid" som ingår i begäran:

  • Om "DocumentGuid" anges blir anropet idempotent.
  • createDocument kan anropas flera gånger utan att en ny transaktion startas i TSE (Technical Security Device Germany).
  • "fiscalResponse": alltid SAMMA svar returneras.

Beteende UTAN "DocumentGuid" i begäran:

  • Om inget "DocumentGuid" anges startas en ny transaktion i TSE (Tyskland) vid VARJE anrop till createDocument!
  • "fiscalResponse": varje gång returneras ett NYTT svar.

Obs! Samma "DocumentGuid" måste även användas vid det efterföljande anropet till POST /api/v1/transactions/storeDocument.

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

Svar

Möjliga svar:

Kod Beskrivning Exempel
200 Transaktionen har påbörjats och en fiscalResponse returneras till uppströmsystemet -

 

Den här artikeln har översatts automatiskt.

Relaterade artiklar

Kommentarer

0 kommentarer

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

Powered by Zendesk