Anwendungsfall · Preisinformation spezifisch

Kundenindividueller Preis – spezifisch zum Artikel

Den korrekten Nettopreis zu einem konkreten Artikel abrufen – je Bestellmengeneinheit, mit MwSt-Satz und Gültigkeit. Für Anlage, Pflege, Vergleich und Bestellung.

GET /api/Price

Initiative beitreten Zurück zu den Anwendungsfällen

api.host · REST

GET /api/Price?CustomerNumber=12345&ArticleNumber=…

[
  {
    "articleNumber": "08154711",
    "prices": [
      { "orderUnit": "PAK", "netPrice": 5.00, "currency": "EUR", "vatRate": 19 }
    ]
  }
]

User Story

„Ich möchte als Einkäufer/Stammdatenbeauftragter eine Preisinformation zu einem spezifischen Artikel abfragen, damit ich den Artikel mit dem korrekten Preis in der Materialwirtschaft anlegen, pflegen, vergleichen und ggf. bestellen kann."

Rahmen

Allgemeine Festlegungen

Zu unterscheiden sind Angebots- und Preisanfragen. Es werden keine Konditionen abgefragt. Dieser Fall liefert den spezifischen Preis zu einem konkreten Artikel.

Spezifischer Artikel

Preis zu einem konkreten Artikel – identifiziert über Kundennummer/GLN und Artikel.

Je Bestellmengeneinheit

Ohne Bestellmengeneinheit → alle bestellfähigen BME (1..n); mit OrderUnit → nur diese Einheit.

Keine Konditionen

Konditionen sind nicht Teil dieser Abfrage – nur Preisdaten.

Netto · MwSt · Gültigkeit

Nettopreis, Währung, MwSt-Satz und Gültigkeit bis; Listenpreis und Rabatt optional.

Weitere Preis-Fälle (eigene Anwendungsfälle)

Gesamtpreisliste – vollständiger Preisabzug.
Preisinformation unspezifisch („Schere") – Antwort mit Artikelbezeichnung & -preis.
Versorgungspreise (Sets) – ggf. unterschiedliche MwSt-Sätze, oft als PDF.
Rahmenvertrag.
Vergleichspreis – vergleichbarer Artikel zu einem Fremdpreis.

Aufruf

Parameter

Kundenidentifikation und Artikel sind Pflicht; die Bestellmengeneinheit ist optional. Parameter sind kombinierbar.

Parameter	Query	Bedeutung
Kundennummer	`?CustomerNumber=12345`	Kundenidentifikation (Pflicht – alternativ GLN).
GLN	`?Gln=4012345000009`	Alternativ zur Kundennummer.
Lieferantenartikelnummer	`?ArticleNumber=08154711`	Artikel (Pflicht – alternativ Barcode).
GTIN / PZN	`?BarcodeType=Gtin&Barcode=…`	Artikel per Barcode.
Bestellmengeneinheit	`?OrderUnit=PAK`	Nur diese Einheit (optional).

Zulässige Barcode-Typen: GTINHIBCPZN

Beispiele

Typische Abfragen

Als Konsument möchte ich … – und rufe dafür folgenden Endpunkt auf:

zu einem Artikel den Preis für alle Bestellmengeneinheiten abfragen

GET

https://host_url/api/Price?CustomerNumber=12345&ArticleNumber=08154711

zu einem Artikel den Preis für eine bestimmte Bestellmengeneinheit abfragen

GET

https://host_url/api/Price?CustomerNumber=12345&ArticleNumber=08154711&OrderUnit=PAK

zu einer GTIN den Preis abfragen

GET

https://host_url/api/Price?CustomerNumber=12345&BarcodeType=Gtin&Barcode=99999999999994

zu einer PZN den Preis abfragen

GET

https://host_url/api/Price?CustomerNumber=12345&BarcodeType=Pzn&Barcode=01234567

mit GLN statt Kundennummer den Preis abfragen

GET

https://host_url/api/Price?Gln=4012345000009&ArticleNumber=08154711

Antwort

Response (JSON)

Ein Array je Artikel. prices enthält je bestellfähiger Bestellmengeneinheit einen Eintrag mit Nettopreis, Währung, MwSt-Satz, Inhalt, Mindestbestellmenge/Schrittweite und Gültigkeit (Listenpreis & Rabatt optional).

Response · application/json

[
  {
    "articleNumber": "string",
    "shortDescription": "string",
    "manufacturerArticleNumber": "string",
    "manufacturerName": "string",
    "prices": [
      {
        "barcodes": [
          {
            "type": "Gtin",
            "code": "string",
            "validFrom": "2026-05-20T11:26:43.829Z",
            "validTo": "2026-05-20T11:26:43.829Z"
          }
        ],
        "orderUnit": "string",
        "contentQuantity": 0,
        "baseUnit": "string",
        "netPrice": 0,
        "currency": "string",
        "vatRate": 0,
        "minOrderQuantity": 0,
        "lotSize": 0,
        "listPrice": 0,
        "discountRate": 0,
        "validUntil": "2026-05-20T11:26:43.829Z"
      }
    ]
  }
]

Wichtige Felder

articleNumber

Lieferantenartikelnummer (Pflicht).

shortDescription

Artikelkurzbezeichnung (Pflicht).

manufacturerArticleNumber

Herstellerartikelnummer (Pflicht).

manufacturerName

Herstellername (optional).

prices[]

Je Bestellmengeneinheit ein Eintrag (1..n).

barcodes[]

Identifikation: type (Gtin/Hibc/Pzn), code, Gültigkeit.

orderUnit

Bestellmengeneinheit, z. B. „PAK".

contentQuantity / baseUnit

Inhaltsmenge und Basismengeneinheit, z. B. 50 „ST".

netPrice / currency

Nettopreis und Währung (z. B. 5,00 EUR).

vatRate

Mehrwertsteuersatz, z. B. 19.

minOrderQuantity / lotSize

Mindestbestellmenge und Schrittweite in BME.

listPrice / discountRate

Listen-/Bruttopreis und Rabattsatz (optional).

validUntil

Preisgültigkeit bis (Datum).

Selbsttest

Antwort prüfen

Fügen Sie die JSON-Antwort Ihres /api/Price-Endpunkts ein – die Struktur wird sofort im Browser gegen dieses Schema geprüft.

JSON-Antwort

Noch keine Prüfung – JSON einfügen und „Prüfen" klicken.

Diesen Anwendungsfall in Ihrem System nutzen?

Werden Sie Teil der API-Initiative – wir begleiten Sie beim Onboarding.