add
Belege > REST Resource: receipts.v2 > add
Es ist möglich, über diese Methode zwei Szenarien zum Hinzufügen von Belegen in die Datenbank zu verwenden.

Direkte Zuordnung des Belegs zu einem App Nutzer

In diesem Fall steht die interne ID des App Nutzers zur Verfügung, zum Beispiel durch das Scannen des individuellen QR-Codes des App Nutzers (in der App > Übersicht > Neuer epap). Diese ID wird als userId im Request JSON Body gesendet und der Nutzer wird umgehend über einen neuen epap in der App informiert.

Indirekte Zuordnung des Belegs über einen QR-Code

In diesem Fall wird die interne ID des App Nutzers nicht benötigt, sodass auch die epap App für den Erhalt eines Belegs nicht erforderlich ist. Das Feld userId im Request JSON Body wird nicht gesendet und als Antwort wird ein QR-Code generiert, wobei sowohl eine Download-URL für den QR-Code als auch der dynamische Link, d.h. der Inhalt des QR-Codes, verfügbar sind. Im Hintergrund wird die Erstellung eines PDF Belegs begonnen. Scannt ein Kunde den QR-Code und hat die epap App auf dem Smartphone installiert, öffnet sich diese und der epap ist umgehend verfügbar. Ist die epap App nicht vorhanden, wird der Kunde auf eine Webseite geleitet, auf der der PDF Beleg zum Download zur Verfügung steht und optional auch in einem späteren Schritt in die epap App hinzugefügt werden kann.
post
https://europe-west1-epap-fg44.cloudfunctions.net/receipts
/v2/add
add

Musterbody

1
{
2
"userId": "[USER_ID]",
3
"category": "FOOD",
4
"currencyISOCode": "EUR",
5
"amount": 157.31,
6
"amountBeforeTaxes": 135.83,
7
"timestamp": "2020-07-30T19:15:40.500+02:00",
8
"receiptNumber": "9988776655",
9
"additionalInformation": "Es bediente Sie Frau/Herr Müller.",
10
"advertisement": "<h1>Hier könnte Ihre Werbung stehen</h1>",
11
"loyaltyProgram": {
12
"awardUnit": "POINTS",
13
"description": "Das neue Bonusprogramm der epap GmbH",
14
"memberEmail": "[email protected]",
15
"memberId": "100200300",
16
"memberName": "epap Contact",
17
"memberStatus": "Gold",
18
"name": "BonusProgram 1",
19
"newUnits": 25,
20
"totalUnits": 1234
21
},
22
"securityInformation": {
23
"endTimestamp": "2020-07-30T19:15:40.500+02:00",
24
"hardwareId": "955002-00",
25
"qrCodeString": "V0;955002-00;Kassenbeleg-V1;Beleg^0.00_2.55_0.00_0.00_0.00^2.55:Bar; 18;112;2019-07-10T18:41:04.000Z;2019-07-10T18:41:04.000Z;ecdsa-plain- SHA256;unixTime;MEQCIAy4P9k+7x9saDO0uRZ4El8QwN+qTgYiv1DIaJIMWRiuAiAt+saFDGjK2Yi5Cxgy7PprXQ5O0seRgx4ltdpW9REvwA==;BHhWOeisRpPBTGQ1W4VUH95TXx2 GARf8e2NYZXJoInjtGqnxJ8sZ3CQpYgjI+LYEmW5A37sLWHsyU7nSJUBemyU=",
26
"startTimestamp": "2020-07-30T19:15:35.500+02:00",
27
"signature": "MEQCIAy4P9k+7x9saDO0uRZ4El8QwN+qTgYiv1DIaJIM- WRiuAiAt+saFDGjK2Yi5Cxgy7PprXQ5O0seRgx4ltdpW9REvwA==",
28
"signatureCounter": "112",
29
"transactionNumber": "18",
30
"type": "TSE"
31
},
32
"store": {
33
"address": "Walderseestr. 7, 30419 Hannover, Deutschland",
34
"chain": "epap GmbH",
35
"chainId": "r1U8Rg33HRajPfUzZvu3",
36
"description": "Hannover",
37
"email": "[email protected]",
38
"name": "epap",
39
"openingTimes": [
40
"MO - SA: 08:00 - 21:00 Uhr"
41
],
42
"phone": "+49 123 45678910",
43
"placeId": "ChIJvzgjKnVzsEcRv2a-KizpyGI",
44
"storeId": "12345",
45
"ustId": "DE999999999",
46
"website": "www.epap.app"
47
},
48
"items": [
49
{
50
"amount": 0.85,
51
"amountBeforeTaxes": 0.79,
52
"bestBefore": "2020-08-05T00:00:00+02:00",
53
54
55
"category": "FOOD",
56
"description": "Any additional description",
57
"factor": 0.314,
58
"gtin": "1020304050",
59
"name": "Paprika Rot",
60
"pricing": [
61
{
62
"amount": 0.94,
63
"amountBeforeTaxes": 0.88,
64
"type": "BASE_PRICE"
65
},
66
{
67
"amount": 0.09,
68
"amountBeforeTaxes": 0.08,
69
"percentage": 0.1,
70
"taxPercentage": 0.0935,
71
"type": "DISCOUNT"
72
}
73
],
74
"taxPercentage": 0.07,
75
"type": "PRODUCT",
76
"unit": "KILOGRAM",
77
"unitPrice": 2.99,
78
"unitPriceBeforeTaxes": 2.79
79
},
80
{
81
"amount": 2.22,
82
"amountBeforeTaxes": 2.07,
83
"bestBefore": "2020-08-05T00:00:00+02:00",
84
"category": "FOOD",
85
"description": "Any additional description",
86
"gtin": "0123456789",
87
"name": "Avocados",
88
"quantity": 2,
89
"taxPercentage": 0.07,
90
"type": "PRODUCT",
91
"unitPrice": 1.11,
92
"unitPriceBeforeTaxes": 1.04
93
},
94
{
95
"amount": 154.24,
96
"amountBeforeTaxes": 132.97,
97
"category": "TECH",
98
"description": "Mehr Informationen finden Sie unter www.kafeemaschine.de!",
99
"gtin": "1122334455",
100
"name": "Kaffeemaschine",
101
"pricing": [
102
{
103
"type": "BASE_PRICE",
104
"amount": 184.24,
105
"amountBeforeTaxes": 158.83
106
},
107
{
108
"type": "DISCOUNT",
109
"amount": 30,
110
"amountBeforeTaxes": 25.86,
111
"description": "30€ geschenkt"
112
}
113
],
114
"taxPercentage": 0.16,
115
"type": "PRODUCT",
116
"warrantyUntil": "2025-07-30T24:00:00+02:00"
117
}
118
],
119
"payments": [
120
{
121
"amount": 87.31,
122
"cardNumber": "###############1019 0000",
123
"cardTerminalhardwareId": "03403439",
124
"cardType": "Mastercard",
125
"contactless": true,
126
"description": "Any additional description",
127
"timestamp": "2020-07-30T19:15:40.500+02:00",
128
"transactionNumber": "12345678",
129
"type": "CARD"
130
},
131
{
132
"amount": 30,
133
"amountChange": 0,
134
"description": "Any additional description",
135
"timestamp": "2020-07-30T19:15:40.500+02:00",
136
"transactionNumber": "12345678",
137
"type": "CASH"
138
},
139
{
140
"amount": 5,
141
"description": "Any additional description",
142
"timestamp": "2020-07-30T19:15:40.500+02:00",
143
"transactionNumber": "12345678",
144
"type": "MISC"
145
},
146
{
147
"amount": 10,
148
"description": "Any additional description",
149
"provider": "Paypal",
150
"timestamp": "2020-07-30T19:15:40.500+02:00",
151
"transactionNumber": "12345678",
152
"type": "ONLINE"
153
},
154
{
155
"amount": 25,
156
"description": "Any additional description",
157
"timestamp": "2020-07-30T19:15:40.500+02:00",
158
"transactionNumber": "12345678",
159
"type": "VOUCHER"
160
}
161
]
162
}
Copied!
Last modified 2mo ago
Copy link