Darstellung
Retouren-Abwicklung (SAL20)
Transaktion: SAL20 Retouren Abwicklung
UI-Pfad: Return Management
API: /api/returnHead, POST /api/salesHead/return
Business-Zweck
Retouren (RMA) kehren Warenfluss und Belegkette um: Kunde sendet Ware zurück → Retoure erfasst → Gutschrift oder Ersatzauftrag. Partner integrieren Shop-RMA oder ERP-Retouren über Return Head API.
Kernbegriffe
| Begriff | Bedeutung |
|---|---|
| ReturnHead | Retourenkopf (SAL20) |
createSalesHead | Retoure → Gutschrift/Ersatz |
returnPack | Retouren-Packstück / Tracking |
createCreditNotes | Gutschrift aus Rechnung |
getReturnHeadByOrderId | Retoure zu Auftrag finden |
Fachlicher Ablauf
- Retoure anlegen mit Bezug zu Auftrag/Rechnung
- Retourenlabel / Tracking (
returnPack) - Wareneingang buchen (INV)
- Gutschrift oder Ersatzlieferung
Partner-Szenarien
Szenario 1 – Retoure anlegen
json
POST /api/returnHead/
{
"salesHead": { "id": 1234567890123456 },
"reason": { "id": 1 },
"items": [
{
"salesItem": { "id": 9876543210 },
"quantity": 1,
"reasonText": "Defekt"
}
]
}Response: { "id": 3333444455556666 }
Szenario 2 – Retoure zu Auftrag finden
bash
curl -G "$BASE_URL/api/returnHead/getReturnHeadByOrderId/1234567890123456" \
-H "Authorization: Bearer $TOKEN"Szenario 3 – Gutschrift aus Rechnung
json
POST /api/salesHead/createCreditNotes
{
"salesHeadIds": [2222333344445555],
"docType": { "id": 300004 }
}Szenario 4 – Retouren-Tracking
json
POST /api/returnHead/returnPack
{
"returnHeadId": 3333444455556666,
"trackingNumber": "RET-TRACK-998877",
"carrierName": "DHL Retoure"
}bash
curl -G "$BASE_URL/api/returnHead/getReturnTrackingData/3333444455556666" \
-H "Authorization: Bearer $TOKEN"Szenario 5 – SalesHead-Return Shortcut
json
POST /api/salesHead/return
{
"salesHeadId": 2222333344445555,
"items": [
{ "salesItemId": 9876543210, "quantity": 1 }
]
}Voraussetzungen
- Ursprungsbeleg (Auftrag/Rechnung) existiert
- Return-DocTypes / Gründe konfiguriert
- Lager für Retourenware (INV)
- Berechtigung SAL20
Auswirkungen im ERP
| Aktion | Auswirkung |
|---|---|
| Retoure | RMA-Dokument, ggf. WE |
| Gutschrift | Negativ-Umsatz, FiBu |
| Bestand | Zugang INV02 |
| Connector | Shop-RMA-Status |
Typische Fehlerquellen
| Fehler | Ursache |
|---|---|
| Menge zu hoch | > gelieferte Menge |
| Keine RE | Gutschrift ohne Rechnungsbasis |
| Tracking doppelt | returnPack idempotent prüfen |