BundlePreisauszeichnung via REST-API Version: 1.0 Datum: 30.11.2015 Status: Freigegeben Das Bundesfinanzministerium (BMF) hat festgelegt, dass die Entgelte für Teilprodukte sogenannter Bundles ab dem 1. Januar 2016 getrennt ausgewiesen und besteuert werden müssen. Für ein Bundle-Produkt ist es dadurch nicht möglich, einen eindeutigen MwSt-Satz anzugeben, da sich der Steuersatz nach den enthaltenen Steuersätzen der Teilprodukte richtet. Diese Herangehensweise wird als MwSt-Splitting bezeichnet. Folglich muss bei einem Bundle mit MwSt-Splitting für jedes Teilprodukt der Teilpreis innerhalb des Bundles sowie der zugehörige MwStSatz dieses Teilproduktes angegeben werden. Ein Bundle-Produkt besitzt somit gemäß der neuen Gesetzgebung in Deutschland immer ausschließlich einen BruttoGesamtpreis ohne explizite MwSt-Angabe. Bundle-Preisauszeichnung via REST-API 1/5 1. Bundle-Zusammensetzung und Identifikation von BundleTeilprodukten Ein Bundle besteht aus Teilprodukten, die entweder einzeln vertrieben werden oder nur als Bestandteil dieses Bundles erhältlich sind. Teilprodukte, die einzeln vertrieben werden, sind anhand ihrer GTIN zu identifizieren. Teilprodukte, die nur als Bestandteil eines Bundles erhältlich sind, erhalten einen Pseudoidentifier auf Basis der Bundle-GTIN, Bsp.: 9783131464712-1. 2. Ausweisung von Bundle-Preisen Abhängig vom Austauschformat können der Bundle-Preis und die zugehörigen Bundle-Teilpreise über verschiedenen Datensätzen verteilt abgelegt sein. Beispielsweise ist dies im prominentesten Austauschformat des Buchhandels der Fall: ONIX 2.1. Um ein Aggregieren mehrerer Produkte bei Verwendung der REST-API zu vermeiden, werden alle relevanten Informationen zum Bundle-Preis sowie allen Teilpreisen direkt im Bundle-Datensatz aufgeführt. Diese Informationen werden nur in den Produktdetails der APIs angezeigt, nicht jedoch in den Trefferlisten. Enthaltene Informationen: Brutto-Gesamtpreis des Bundles für jedes Teilprodukt o Identifier (GTIN für einzeln erhältlich bzw. proprietärer Identifier für nicht einzeln erhältliche Produkte) o aktuell gültiger Brutto-Preis, inkl. MwSt-Satz, Land und Währung o Produktform In der REST-API werden die Informationen zu Teilprodukten inkl. der Preisangabe innerhalb des Bundles in einem ContainedItem-Composite pro Teilprodukt ausgewiesen. Dies gilt für zwei- und mehrteilige Bundles, um eine identische Verarbeitung der Teilpreise des Bundles zu ermöglichen. Bundle-Preisauszeichnung via REST-API 2/5 2.1. Bundle-Preise in der REST-API 2.1.1. Brutto-Gesamtpreis des Bundles Die Preisauszeichnung eines Bundles wird analog zu ONIX 2.1 für zweiteilige und mehrteilige Bundles unterschiedlicher Form sein. Für ein zweiteiliges Bundle werden im Price-Composite neben dem BruttoGesamtpreis des Bundles (value) auch die Preisinformationen zu den beiden enthaltenen Einzelprodukten aufgeführt. Unabhängig davon werden die aktuellen Preise der Teilprodukte, wie auch für mehrteilige Bundles, redundant in ContainedItem-Composites hinterlegt. Im mehrteiligen Bundle wird im Price-Composite lediglich der Brutto-Gesamtpreis des Bundles angegeben. Die einzelnen Teilpreise und MwSt-Sätze der Teilprodukte sind ausschließlich in den ContainedItem-Composites zu finden. Nachfolgend finden Sie eine Übersicht über relevante Elemente im Price-Composite. Feld prices Bezeichnung / Inhalt Composite Price in der JSON-Ausgabe der REST-API taxRatePercent MwSt.-Satz in Prozent type value country currency validFrom validUntil State Preistyp Brutto-Gesamtpreis (für das Bundle) Land Währung gültig ab gültig bis Preisstatus MwSt-Satz - Teilprodukt 1 Achtung: dieser wird in Nicht-Bundle-Produkten taxRate für das Produkt selbst verwendet taxRatePercent MwSt-Satz in Prozent - Teilprodukt 1* taxableAmount Netto-Betrag – Teilprodukt 1* taxAmount Steuerbetrag – Teilprodukt 1* taxRate2 MwSt-Satz - Teilprodukt 2* taxRatePercent2 MwSt-Satz in Prozent - Teilprodukt 2* taxableAmount2 Netto-Betrag – Teilprodukt 2* taxAmount2 Steuerbetrag – Teilprodukt 2* fixedRetailPrice Unterliegt Ladenpreisbindung provisional Vorläufiger Preis referencePrice Teil der Preisreferenz * neu hinzugefügte Inhalte Bundle-Preisauszeichnung via REST-API 3/5 Beispiel: zweiteiliges Bundle "prices": [ { "type": "04", "value": 22.99, "country": "DE", "currency": "EUR", "validFrom": null, "validUntil": null, "state": "02", "taxRate": "R", "taxRatePercent": 7, "taxableAmount": 17.19, "taxAmount": 1.2, "taxRate2": "S", "taxRatePercent2": 19, "taxableAmount2": 3.87, "taxAmount2": 0.73, "fixedRetailPrice": true, "provisional": false, "referencePrice": true } ] Beispiel: mehrteiliges Bundle "prices": [ { "type": "04", "value": 22.99, "country": "DE", "currency": "EUR", "validFrom": null, "validUntil": null, "state": "02", "taxRate": null, "taxRatePercent": null, "taxableAmount": null, "taxAmount": null, "taxRate2": null, "taxRatePercent2": null, "taxableAmount2": null, "taxAmount2": null, "fixedRetailPrice": true, "provisional": false, "referencePrice": true } ] 2.1.2. Informationen zu Teilprodukten des Bundles In einem Bundle-Produkt findet sich die Information zu enthaltenen Teilprodukten in den ContainedItem-Composites. Neben den üblichen Feldern des ContainedItemComposites wird zusätzlich der Identifier des Teilproduktes sowie der Brutto-Preis des Teilproduktes im Bundle mit zugehörigem MwSt-Satz, Land und Währung angegeben. Detaillierte Informationen zu den Teilprodukten (sofern das ContainedItem einen Identifier vom Type GTIN-13 enthält) können über die bereits zur Verfügung stehenden Schnittstellen der REST-API im Produkt mit dieser GTIN selbst Bundle-Preisauszeichnung via REST-API 4/5 entnommen werden. Hierzu gehören z. B. zukünftige Preise des Teilproduktes innerhalb des Bundles. Feld Bezeichnung / Inhalt containedItem productIdentifi erType Composite ContainedItem in der JSON-Ausgabe der REST-API Typ des ProduktIdentifiers* 01 = Proprietär 03 = GTIN-13 Identifier (proprietär oder GTIN-13)* productIdentifi erValue type value country currency taxRate Produktform (Onix Feld b012) akutell gültiger Brutto-Preis des Teilproduktes innerhalb des Bundles* Land* Währung* MwSt.* Z = keine R = reduzierter Satz S = voller Satz * neu hinzugefügte Inhalte Das ContainedItem-Component sieht für zwei- wie auch für mehrteilige Bundles wie folgt aus: "containedItems": [ { "type": "DG", "productFormDetail": null, "numberOfPieces": 1, "productIdentifierType": "01", "productIdentifierTypeName": null, "productIdentifierValue": "9783131464712-1", "value": 18.39, "country": "DE", "currency": "EUR", "taxRate": "R" } ] Bundle-Preisauszeichnung via REST-API 5/5
© Copyright 2025 ExpyDoc