Darstellung
Preise & Konditionen
Transaktionen: SAL06 Kundensonderpreise, SAL07 Gruppenzuschläge, SAL09 VK Preisliste
API: /api/salesHead/getSalesPrice, Customer Price API, Sales Price API
Business-Zweck
Korrekte Verkaufspreise sind essentiell für Shop-Importe und Belegerstellung. reybex löst Preise hierarchisch auf – Partner müssen diese Reihenfolge verstehen und vor Auftragsimport getSalesPrice nutzen.
Kernbegriffe
| Begriff | Bedeutung |
|---|---|
| SalesPriceListHead | VK-Preisliste (SAL09) |
| CustomerPrice | Kundensonderpreis (SAL06) |
| CustomerGroupSurcharge | Gruppenzuschlag (SAL07) |
priceUnit | Preis bezogen auf Mengeneinheit |
getSalesPrice | API-Preisfindung |
| Material-VK | Fallback aus BAS02 |
Preisauflösung (Reihenfolge)
Fachlicher Ablauf
- Preisliste dem Kunden zuweisen (
salesPriceListHead) - Optional Sonderpreise / Zuschläge pflegen
- Vor Import:
getSalesPricepro Position - Preis in
SalesItem.priceoder Brutto ingrossPrice
Partner-Szenarien
Szenario 1 – Einzelpreis abfragen
json
POST /api/salesHead/getSalesPrice
{
"customerId": 1000001,
"materialId": 2000001,
"quantity": 5,
"docDate": "2026-09-10",
"warehouseId": 500001
}Response (Beispiel):
json
{
"price": 49.90,
"grossPrice": 59.38,
"priceUnit": 1,
"vatKey": { "id": 1, "rate": 19 },
"priceListSource": "customerPriceList"
}Szenario 2 – GET-Variante
bash
curl -G "$BASE_URL/api/salesHead/getSalesItemPrice" \
-H "Authorization: Bearer $TOKEN" \
--data-urlencode "customerId=1000001" \
--data-urlencode "materialId=2000001" \
--data-urlencode "quantity=5"Szenario 3 – Shop-Import mit Shop-Preis
Wenn Shop-Preis verbindlich (Aktion):
json
{
"items": [
{
"material": { "matCode": "SKU-001" },
"quantity": 1,
"price": 29.99,
"grossPrice": 35.69,
"isManualPrice": true
}
]
}WARNING
Manuelle Preise nur wenn Geschäftsregel erlaubt – sonst Abweichung zur Preisliste.
Szenario 4 – Kundensonderpreis pflegen
→ Customer Price API
json
POST /api/customerPrice/
{
"customer": { "id": 1000001 },
"material": { "id": 2000001 },
"price": 44.90,
"validFrom": "2026-01-01",
"validUntil": "2026-12-31"
}Voraussetzungen
- VK-Preisliste mit gültigen Preisen (SAL09)
- Material verkaufbar mit ME und USt
- Kunde mit
salesPriceListHeadoder Sonderpreisen
Auswirkungen im ERP
| Element | Wirkung |
|---|---|
| Preisliste | Standard-VK aller Kunden ohne Sonderpreis |
| Sonderpreis | Überschreibt Liste für Material+Kunde |
| Gruppenzuschlag | Prozent/absolut auf Gruppe |
| falscher Preis | Umsatz-/Margin-Fehler, Reklamationen |
Typische Fehlerquellen
| Symptom | Ursache |
|---|---|
| Preis 0 | Keine Liste, Material ohne VK |
| Abweichung Shop | Währung, priceUnit, MwSt inkl./exkl. |
| Alte Preise | Gültigkeit validFrom/Until |
| Mengenstaffel | Falsche quantity in getSalesPrice |