Belegformat
Hier findest du ein vollständiges Beispiel eines Belegs.
JSON
Der Umfang ist vorläufig. Einige Felder sind nur für Testzugänge (v0) nötig.
Gesamter Beleg
{
"store": {
"legalName": "Königsbäck GmbH",
"displayName": "Bäckerei Königsbäck",
"address": {
"city": "Stuttgart",
"zipCode": "70188",
"streetAddress": "Gablenbergerstraße 71",
"geolocation": {
"latitude": 48.777571,
"longitude": 9.205963
}
},
"logo": "https://example.com/logo.png"
},
"legal": {
"serialNumber": "3583478923491",
"transactionNumber": "77792214719847153"
},
"serialNumber": "1142525617",
"startTimestamp": "2020-05-03T17:16:36.000Z",
"endTimestamp": "2020-05-03T17:16:37.000Z",
"total": 3.52,
"totalNet": 3.12,
"currencyCode": "EUR",
"languageCode": "de",
"internalReceiptId": "100244",
"items": [
{
"name": "Produkt 1",
"taxRate": 0.19,
"unitPrice": 1.2,
"totalPrice": 2.4,
"quantity": 2
},
{
"name": "Produkt 2",
"taxRate": 0.19,
"unitPrice": 1.2,
"totalPrice": 1.2,
"quantity": 1
}
],
"payments": [
{
"method": "credit",
"amount": 3.52,
"cardName": "VISA"
}
]
}
{
"$schema": "http://json-schema.org/draft-07/schema#",
"$id": "https://dev.billless.app/assets/receipt.schema.json",
"title": "Receipt",
"description": "bill.less Receipt schema",
"type": "object",
"required": ["store", "legal", "serialNumber", "startTimestamp", "endTimestamp", "total", "totalNet", "currencyCode", "items", "payments"],
"properties": {
"store": {
"type": "object",
"required": ["legalName", "address"],
"properties": {
"legalName": {
"description": "Offizieller Name des Geschäfts",
"type": "string"
},
"displayName": {
"description": "Abweichende Bezeichnung z.B. Eigenschreibweise",
"type": "string"
},
"companyName": {
"description": "",
"type": "string"
},
"address": {
"type": "object",
"required": ["city", "zipCode", "streetAddress"],
"properties": {
"city": {
"type": "string"
},
"zipCode": {
"type": "string"
},
"streetAddress": {
"type": "string"
},
"geolocation": {
"type": "object",
"required": ["latitude", "longitude"],
"properties": {
"latitude": {
"description": "",
"type": "number"
},
"longitude": {
"description": "",
"type": "number"
}
}
}
}
},
"logo": {
"description": "URL zu Logo des Geschäfts (.png)",
"type": "string"
}
}
},
"legal": {
"type": "object",
"required": ["serialNumber", "transactionNumber"],
"properties": {
"serialNumber": {
"description": "die Seriennummer des elektronischen Aufzeichnungssystems oder die Seriennummer des Sicherheitsmoduls",
"type": "string"
},
"transactionNumber": {
"description": "die Transaktionsnummer im Sinne des § 2 Satz 2 Nummer 2 KassenSichV",
"type": "string"
}
}
},
"serialNumber": {
"description": "Seriennummer der Kasse",
"type": "string"
},
"startTimestamp": {
"description": "Zeitpunkt der Vorgangbeginns im Sinne des § 2 Satz 2 Nummer 6 KassenSichV (ISO 8601 im Format YYYY-MM-DDThh:mm:ss.fffZ)",
"type": "string"
},
"endTimestamp": {
"description": "Zeitpunkt der Vorgangsbeendigung im Sinne des § 2 Satz 2 Nummer 6 KassenSichV (ISO 8601 im Format YYYY-MM-DDThh:mm:ss.fffZ)",
"type": "string"
},
"total": {
"description": "Gesamter Betrag",
"type": "number"
},
"totalNet": {
"description": "Gesamter Nettobetrag",
"type": "number"
},
"currencyCode": {
"description": "Währungscode (ISO 4217 z.B. EUR)",
"type": "string"
},
"languageCode": {
"description": "Sprachcode (ISO 639-1 z.B. de)",
"type": "string"
},
"localReceiptId": {
"description": "Interne Belegnummer",
"type": "string"
},
"cashpointId": {
"description": "Interne Kassennummer",
"type": "string"
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": ["name", "tax", "unitPrice", "totalPrice", "quantity"],
"properties": {
"name": {
"description": "Name des Produkts",
"type": "string"
},
"taxRate": {
"description": "Steuersatz für das Produkt",
"type": "number",
"enum": [0, 0.07, 0.19]
},
"unitPrice": {
"description": "Einzelpreis des Produkts",
"type": "number"
},
"totalPrice": {
"description": "Gesamtpreis",
"type": "number"
},
"quantity": {
"description": "Menge",
"type": "number"
},
"quantityMeasure": {
"description": "Maßeinheit (g, kg, l, stk)",
"type": "string"
},
"EANCode": {
"description": "",
"type": "string"
},
"discounts": {
"type": "array",
"items": {
"type": "object",
"required": ["name", "discount"],
"properties": {
"name": {
"description": "Beschreibung des Rabatts",
"type": "string"
},
"discount": {
"description": "Wert des Rabatts",
"type": "number"
},
"percentage": {
"description": "Prozentueller Wert des Rabatts",
"type": "number"
}
}
}
}
}
}
},
"payments": {
"type": "array",
"items": {
"type": "object",
"required": ["method", "amount"],
"properties": {
"method": {
"description": "Zahlungsmethode",
"type": "string",
"enum": ["credit", "cash", "ec"]
},
"amount": {
"description": "Betrag der jeweiligen Zahlungsmethode",
"type": "number"
},
"drawback": {
"description": "Rückgeld bei Barzahlung",
"type": "number"
},
"cardName": {
"description": "Name der Karte bei Kartenzahlung",
"type": "string"
}
}
}
},
"discounts": {
"type": "array",
"items": {
"type": "object",
"required": ["name", "discount"],
"properties": {
"name": {
"description": "Beschreibung des Rabatts",
"type": "string"
},
"discount": {
"description": "Wert des Rabatts",
"type": "number"
},
"percentage": {
"description": "Prozentueller Wert des Rabatts",
"type": "number"
}
}
}
},
"recipient": {
"description": "Rechnungsempfänger",
"type": "object",
"properties": {
"firstName": {
"type": "string"
},
"lastName": {
"type": "string"
},
"address": {
"type": "object",
"properties": {
"city": {
"type": "string"
},
"zipCode": {
"type": "string"
},
"streetAddress": {
"type": "string"
}
}
}
}
}
}
}
serialNumber- Seriennummer der Kassetotal- GesamtbetragtotalNet- NettogesamtbetragcurrencyCode- Währungscode nach ISO 4217 (alphabetic)startTimestamp- Zeitpunkt des Vorgangbeginns im Sinne des § 2 Satz 2 Nummer 1 KassenSichV nach ISO 8601 im Format YYYY-MM-DDThh:mm:ss.fffZendTimestamp- Zeitpunkt der Vorgangsbeendigung im Sinne des § 2 Satz 2 Nummer 6 KassenSichV nach ISO 8601 im Format YYYY-MM-DDThh:mm:ss.fffZlanguageCode- Sprachcode nach ISO 639-1recipient- RechnungsempfängercheckoutId- Interne Kassennummerdiscounts- RabattelocalReceiptId- Intern vergebene Belegnummer
Store (v0)
{
"type": "object",
"required": ["legalName", "address"],
"properties": {
"legalName": {
"description": "Offizieller Name des Geschäfts",
"type": "string"
},
"displayName": {
"description": "Abweichende Bezeichnung z.B. Eigenschreibweise",
"type": "string"
},
"companyName": {
"description": "",
"type": "string"
},
"address": {
"type": "object",
"required": ["city", "zipCode", "streetAddress"],
"properties": {
"city": {
"type": "string"
},
"zipCode": {
"type": "string"
},
"streetAddress": {
"type": "string"
},
"geolocation": {
"type": "object",
"required": ["latitude", "longitude"],
"properties": {
"latitude": {
"description": "",
"type": "number"
},
"longitude": {
"description": "",
"type": "number"
}
}
}
}
},
"logo": {
"description": "URL zu Logo des Geschäfts (.png)",
"type": "string"
}
}
}
legalName- Vollständiger Name des Geschäftsaddress- Adresse des GeschäftsdisplayName- Abweichende Bezeichnung des Geschäfts (wird auf PDF/in App mitausgegeben)companyName- Ggfs. Name der Kette ö.ä.logo- URL zu Logo als PNG. (min. 200x200px)
Produkte
{
"type": "array",
"items": {
"type": "object",
"required": ["name", "tax", "unitPrice", "totalPrice", "quantity"],
"properties": {
"name": {
"description": "Name des Produkts",
"type": "string"
},
"taxRate": {
"description": "Steuersatz für das Produkt",
"type": "number",
"enum": [0, 0.07, 0.19]
},
"unitPrice": {
"description": "Einzelpreis des Produkts",
"type": "number"
},
"totalPrice": {
"description": "Gesamtpreis",
"type": "number"
},
"quantity": {
"description": "Menge",
"type": "number"
},
"quantityMeasure": {
"description": "Maßeinheit (g, kg, l, stk)",
"type": "string"
},
"EANCode": {
"description": "",
"type": "string"
},
"discounts": {
"type": "array",
"items": {
"type": "object",
"required": ["name", "discount"],
"properties": {
"name": {
"description": "Beschreibung des Rabatts",
"type": "string"
},
"discount": {
"description": "Wert des Rabatts",
"type": "number"
},
"percentage": {
"description": "Prozentueller Wert des Rabatts",
"type": "number"
}
}
}
}
}
}
}
name- ProduktnametaxRate- SteuersatzunitPrice- StückpreistotalPrice- Gesamtpreisquantity- MengequantityMeasure- MaßeinheitEANCode- EAN Code des Produktsdiscounts- Rabatte
Zahlung
{
"type": "array",
"items": {
"type": "object",
"required": ["method", "amount"],
"properties": {
"method": {
"description": "Zahlungsmethode",
"type": "string",
"enum": ["credit", "cash", "ec"]
},
"amount": {
"description": "Betrag der jeweiligen Zahlungsmethode",
"type": "number"
},
"drawback": {
"description": "Rückgeld bei Barzahlung",
"type": "number"
},
"cardName": {
"description": "Name der Karte bei Kartenzahlung",
"type": "string"
}
}
}
}
method- Art der Zahlungamount- Betragdrawback- Rückgeld bei BarzahlungcardName- Name der Karte bei Kartenzahlung
Rechtliche Informationen
{
"type": "object",
"required": ["serialNumber", "transactionNumber"],
"properties": {
"serialNumber": {
"description": "die Seriennummer des elektronischen Aufzeichnungssystems oder die Seriennummer des Sicherheitsmoduls",
"type": "string"
},
"transactionNumber": {
"description": "die Transaktionsnummer im Sinne des § 2 Satz 2 Nummer 2 KassenSichV",
"type": "string"
}
}
}
serialNumber- die Seriennummer des elektronischen Aufzeichnungssystems oder die Seriennummer des SicherheitsmodulstransactionNumber- die Transaktionsnummer im Sinne des § 2 Satz 2 Nummer 2 KassenSichV