Lieferscheine (SAL17)

Transaktion: SAL17 Lieferscheine
UI-Pfad: /salesDeliveryNotes
API: /api/salesHead/salesDeliveryNotes, referencingDocuments

Business-Zweck

Lieferscheine dokumentieren den Warenausgang und sind in B2B oft Pflicht vor Rechnung. Sie reduzieren offene Liefermengen auf Auftragspositionen (deliveryStatus, deliveredQuantity) und lösen Bestandsabgänge in INV aus.

Partner erzeugen LS per Folgedokument-API nach Kommissionierung oder im Connector-Kombi-Call.

→ Order-to-Cash Phase 6

Kernbegriffe

Begriff	Bedeutung
DelNote-DocType	isDelnote=true
referencingDocuments	API zur LS-Erzeugung aus Auftrag
salesItemsToCopy	Teillieferung – subset Positionen
isSend / sendStatus	Versand abgeschlossen
validateShipment	Prüfung vor LS-Erzeugung
SendPacks	Packstücke mit Tracking (SMP)

Fachlicher Ablauf / Workflow

1. Auftrag kommissioniert (INV06)
2. validateShipment – optional vor LS
3. referencingDocuments mit DelNote-DocType
4. Tracking an Packstück (Connector oder UI)
5. Rechnung aus LS oder Auftrag

Partner-Szenarien

Szenario 1 – Vollständige Lieferung

POST /api/salesHead/referencingDocuments
{
  "salesHeadIds": [1234567890123456],
  "docType1": { "id": 300002 },
  "isDocument1Created": true,
  "isDocument2Created": false
}

Szenario 2 – Teillieferung

{
  "salesHeadIds": [1234567890123456],
  "docType1": { "id": 300002 },
  "isDocument1Created": true,
  "isDocument2Created": false,
  "salesItemsToCopy": [
    { "salesItemId": 9876543210, "quantity": 2 }
  ]
}

Szenario 3 – Versand validieren

curl -G "$BASE_URL/api/salesHead/validateShipment" \
  -H "Authorization: Bearer $TOKEN" \
  --data-urlencode "salesHeadId=1234567890123456"

Szenario 4 – Versandstatus prüfen

curl -G "$BASE_URL/api/salesHead/isSend/1111222233334444" \
  -H "Authorization: Bearer $TOKEN"

Response: { "isSend": true } wenn sendStatus=2, isSend und aktive Packs.

Szenario 5 – Connector LS+RE+Tracking

Siehe Shop-Import – referencingDocuments

Voraussetzungen

• SalesHeadDocRule Order → DelNote
• Kommissionierung abgeschlossen (INV06)
• Keine Liefersperre auf Auftrag
• DelNote-DocType-ID bekannt

Auswirkungen im ERP

Aktion	Auswirkung
LS erzeugen	Bestandsabgang INV
Position	deliveryStatus 1 oder 2
SendPacks	Tracking, isSend
extract	Versand rückgängig (Sonderfall)

Typische Fehlerquellen

Fehler	Ursache
blockedSalesHeads	Liefersperre
validateShipment	Pick offen
DocRule fehlt	Order→DelNote nicht konfiguriert
Menge zu hoch	salesItemsToCopy.quantity > offen

JSON-Beispiel – LS lesen

curl -G "$BASE_URL/api/salesHead/1111222233334444" \
  -H "Authorization: Bearer $TOKEN"

Weiterlesen

• Rechnungen

• Auftrag → Rechnung

• INV Kommissionierung

• Order-to-Cash