Darstellung
Rechnungen (SAL18)
Transaktion: SAL18 Rechnungen
UI-Pfad: /salesInvoices
API: /api/salesHead/salesInvoices, referencingDocuments, createInvoicesFromDelNotes
Business-Zweck
Rechnungen sind der Umsatz- und Forderungsbeleg im O2C. Partner erzeugen sie aus Auftrag oder Lieferschein, führen Teilfakturierungen durch, übergeben an FiBu (SAL11) und stellen E-Rechnungen bereit (SAL13).
Kernbegriffe
| Begriff | Bedeutung |
|---|---|
| Invoice-DocType | isInvoice=true |
invoiceStatus | Positions-Fakturierungsstatus 0/1/2 |
invoicedQuantity | Bereits fakturierte Menge |
createInvoicesFromDelNotes | Sammelrechnung aus LS |
createCreditNotes | Gutschrift aus Rechnung |
transferInvoicesToFinance | FiBu-Übergabe |
Fachlicher Ablauf / Workflow
Partner-Szenarien
Szenario 1 – Rechnung aus Auftrag
json
POST /api/salesHead/referencingDocuments
{
"salesHeadIds": [1234567890123456],
"docType1": { "id": 300003 },
"isDocument1Created": true,
"isDocument2Created": false
}Szenario 2 – Rechnung aus Lieferschein
json
{
"salesHeadIds": [1111222233334444],
"docType1": { "id": 300003 },
"isDocument1Created": true,
"isDocument2Created": false
}Szenario 3 – Sammelrechnung mehrerer LS
bash
curl -G "$BASE_URL/api/salesHead/createInvoicesFromDelNotes" \
-H "Authorization: Bearer $TOKEN" \
--data-urlencode "salesHeadIds=1111222233334444,1111222233334445"Szenario 4 – Teilfakturierung
json
{
"salesHeadIds": [1234567890123456],
"docType1": { "id": 300003 },
"isDocument1Created": true,
"isDocument2Created": false,
"salesItemsToCopy": [
{ "salesItemId": 9876543210, "quantity": 1 }
]
}Szenario 5 – Gutschrift
json
POST /api/salesHead/createCreditNotes
{
"salesHeadIds": [2222333344445555],
"docType": { "id": 300004 }
}Voraussetzungen
- Invoice-DocType + Nummernkreis
- DocRule: Order→Invoice oder DelNote→Invoice
- Kunde mit Zahlungsbedingung, USt-Daten
- Bei E-Rechnung: SAL13-Konfiguration
Auswirkungen im ERP
| Aktion | Auswirkung |
|---|---|
| Rechnung | Forderung, invoiceStatus |
| FiBu-Übergabe | FinHead in FIN |
| Gutschrift | Negativumsatz, Bestand ggf. Zugang |
| E-Rechnung | XML-Archiv |
Typische Fehlerquellen
| Fehler | Ursache |
|---|---|
| Bereits fakturiert | invoiceStatus=2 |
| DocRule fehlt | Konfiguration SAL |
| FiBu doppelt | Rechnung bereits transferiert |
| E-Rechnung ungültig | Pflichtfelder Kunde/Leitweg-ID |
JSON-Beispiele
Rechnungen listen
bash
curl -G "$BASE_URL/api/salesHead/salesInvoices" \
-H "Authorization: Bearer $TOKEN"Rechnung lesen
json
GET /api/salesHead/2222333344445555Response (Auszug):
json
{
"id": 2222333344445555,
"docNumber": "RE-2026-00123",
"dueDate": "2026-10-10",
"totalAmount": 119.70,
"refSalesHead": { "id": 1234567890123456, "docNumber": "AU-2026-00456" }
}