object (Item)

Belege > Objects & Enumerations > object (Item)

Ein Posten Objekt eines Belegs.

JSON Representation

{
"amount": number, \\ required
"amountBeforeTaxes": number,
"bestBefore": string,
"category": enum (Category),
"description": string,
"factor": number,
"gtin": string,
"name": string, \\ required
"pricing": [
object (Pricing)
],
"quantity": number,
"taxPercentage": number,
"type": enum (ItemType), \\ required
"unit": enum (Unit),
"unitPrice": number,
"unitPriceBeforeTaxes": number,
"warrantyUntil": string
}

Felder

Feldname

Beschreibung

amount

required number

Betrag des Postens (Brutto). Dieser Betrag entspricht dem Gesamtbetrag des Postens, d.h. mögliche Rabatte bereits enthaltend.

amountBeforeTaxes

optional number

Betrag des Postens (Netto). Dieser Betrag entspricht dem Gesamtbetrag der Postens, d.h. mögliche Rabatte bereits enthaltend.

bestBefore

optional string (Timestamp format)

Mindestens haltbar bis.

Mindesthaltbarkeitsdatum in ISO 8601 Format.

Beispiele:

"2020-07-30T17:15:40.500Z" "2020-07-30T19:15:40.500+02:00"

category

optional enum (Category)

Kategorie des Postens. Diese Kategorie wird verwendet, um dem App Nutzer eine Auswertung auf Postenebene zu ermöglichen. Falls keine Kategorien für einzelne Posten gesendet werden, fließt der Beleg lediglich zusammengefasst unter der Belegkategorie in die Auswertung ein.

description

optional string

Zusätzliche Beschreibung des Postens.

factor

optional number

Mengenfaktor bei Angabe der Mengeneinheit und des Betrags pro Einheit.

gtin

optional string

Global Trade Item Number (GTIN). Aus dem GS1-System (ehemals EAN-System) stammende Identifikationsnummer.

name

required string

Name des Postens.

pricing[]

optional object (Pricing)

Für das erste und ausschließlich für das erste Element des Arrays muss gelten: type == "BASE_PRICE"

quantity

optional number

Anzahl des entsprechenden Postens.

taxPercentage

optional 0 ≤ number ≤ 1

Steuersatz des Postens.

type

required enum (ItemType)

unit

optional enum (Unit)

unitPrice

optional number

Stückpreis des Postens (Brutto).

unitPriceBeforeTaxes

optional number

Stückpreis des Postens (Netto).

warrantyUntil

optional string (Timestamp format)

Garantieanspruch bis.

Garantieverfallsdatum in ISO 8601 Format.

Beispiele:

"2020-07-30T17:15:40.500Z" "2020-07-30T19:15:40.500+02:00"