PUT /api/v1/transactions/createDocument – RetailForce

Tento koncový bod predstavuje prvý krok pri prenose transakcií z elektronického záznamového systému („pokladne“) do daňového úradu. Proces sa vždy skladá z dvoch krokov. Tento dvojkrokový proces prenosu transakcií vychádza z požiadaviek nemeckého nariadenia o ochrane pokladníc proti manipulácii a musí sa vykonávať vo všetkých krajinách s daňovou povinnosťou v zmysle štandardizovaného rozhrania. V Nemecku sa pri volaní PUT /api/v1/transactions/createDocument transakcia zaregistruje v takzvanom technickom bezpečnostnom zariadení (TSE/TSS).

Registrácia transakcie

Transakcia/dokument sa zaregistruje vo fiskálnej jednotke:

PUT /api/v1/transactions/createDocument a
POST /api/v1/transactions/storeDocument

Ukončenie transakcie

Týmto sa zaregistruje ukončenie transakcie vo fiškálnej jednotke:

PUT /api/v1/transactions/createDocument a
POST /api/v1/transactions/cancelDocument

Poznámka: všetky transakcie začaté pomocou PUT /api/v1/transactions/createDocument musia byť uzavreté buď pomocou POST /api/v1/transactions/storeDocument, alebo pomocou POST /api/v1/transactions/cancelDocument! Vezmite prosím na vedomie listTransactions (DELETE).

Výsledok

Úspešné volanie koncového bodu (200)

zaznamená začiatok transakcie vo fiškálnej jednotke a
vráti odpoveď fiscalResponse do nadradeného systému (systém elektronických záznamov).

Použitie

zakaždým, keď sa má odoslať nová transakcia do daňovej jednotky, pred volaním POST /api/v1/transactions/storeDocument alebo POST /api/v1/transactions/cancelDocument.

Predpoklady

Inicializovaný client Fiskal

Pole formulára

Je potrebné odoslať nasledujúce informácie:

Označenie	Typ	Popis	Príklad
clientId	M	UniqueClientId pokladne (z RetailForce system).	c1062c55-57c4-4ed2-9c53-aff1762326a4
documentType	M	Typ dokumentu, ktorý sa má zaregistrovať. Enum: [0] = Potvrdenka [1] = Faktúra [2] = Dodací list [10] = Výplata [11] = PayIn [12] = Proforma faktúra [13] = Objednávka zákazníka [14] = PreliminaryReceipt [80] = LongTermOrder [90] = OpeningBalance [98] = CashCheck [99] = EndOfDay [100] = Zásoby [101] = Nákup [1000] = Neplatný doklad [1100] = Rôzne nefiskálne	-
DocumentGuid	R	GUID/UUID pridelené transakcii systémom POS. Správanie sa „DocumentGuid“ zahrnutého v požiadavke: Špecifikácia „DocumentGuid“ spôsobuje, že volanie je idempotentné. Funkciu createDocument je možné volať viackrát bez spustenia novej transakcie v TSE (Technical Security Device Germany). „fiscalResponse“: vždy sa vráti ROVNAKÁ odpoveď. Správanie BEZ „DocumentGuid“ v požiadavke: Ak nie je špecifikovaný „DocumentGuid“, pri KAŽDOM volaní createDocument sa v TSE (Nemecko) spustí nová transakcia! „fiscalResponse“: zakaždým sa vráti NOVÁ odpoveď. Poznámka: Rovnaký „DocumentGuid“ sa musí použiť aj v nasledujúcom volaní POST /api/v1/transactions/storeDocument.	b5744d8c-71ec-4ea0-a340-53070da8b5a1

Odpoveď

Možné odpovede:

Kód	Popis	Príklad
200	Transakcia bola spustená a do nadradeného systému bola vrátená odpoveď typu fiscalResponse	-

Tento článok bol preložený automaticky.

Výsledok

Použitie

Predpoklady

Pole formulára

Odpoveď

Podobné články