Ressource: service-articles #

Serviceartikel sind die EULANDA-Geräteverwaltung: ein konkretes Gerät beim Kunden (z.B. eine Drehbank), verknüpft mit dem Stamm-Artikel, dem Kunden, der Standort-Adresse, Seriennummer, Prüf-/Wartungs-/ Garantie-Terminen, eigenem Merkmalbaum, Bild und DMS-Ordner. Über die ServiceArtikelId-Verweise in allen Belegtabellen liefert die API die komplette Gerätehistorie - die Basis für Field-Service-Szenarien (Geräteübersicht je Kunde, Reparaturhistorie, Serviceauftrag direkt am Gerät).

Das Modul existiert ab EULANDA-Schema 6.7. Fehlt die Tabelle in einer älteren Datenbank, liefern alle Endpunkte 501 SERVICE_ARTICLES_UNAVAILABLE.

Endpunkte #

Zusätzlich tragen die Beleg-Ressourcen das Feld serviceArticleId (bei Angeboten und Aufträgen schreibbar): GET /api/v1/sales-orders?serviceArticleId=4711 liefert alle Aufträge eines Geräts über den normalen Gleichheitsfilter.

Felder (Glossar Entwurf) #

Der Einkaufspreis (EkNetto) ist bewusst nicht im Feldkatalog - er folgt mit einem eigenen, restriktiveren Scope (wie bei den Artikeln). changedAt wird bei API-Updates explizit fortgeschrieben, damit der changedSince-Delta-Sync zuverlässig ist.

Historie #

GET /api/v1/service-articles/4711/history

{
  "quotes":         [ { "id": 12, "number": 20211869, "date": "2026-05-02T00:00:00" } ],
  "salesOrders":    [ { "id": 1893, "number": 20213037, "date": "2026-07-18T00:00:00" } ],
  "deliveryNotes":  [],
  "invoices":       [],
  "purchaseOrders": []
}

Die Historie kommt aus den EULANDA-Funktionen cnf_SrGoto* (Verweise in Kopf und Positionen) in einem Roundtrip und liefert bewusst nur Id, Nummer und Datum - Belegdetails über die Beleg-Endpunkte (Scope documents:read).

Beispiele #

$h = @{ Authorization = "Bearer $key" }

# Geräte eines Kunden mit fälliger Prüfung zuerst
Invoke-RestMethod 'http://localhost:8100/api/v1/addresses/17/service-articles?sort=inspectionDue1' -Headers $h

# Gerät anlegen: aus dem Stamm-Artikel, mit Seriennummer
$body = @{ articleId = 2; name = 'Drehbank DB-200'; serialNumber = 'SN-4711'; customerAddressId = 17 } | ConvertTo-Json
Invoke-RestMethod 'http://localhost:8100/api/v1/service-articles' -Method Post -Body $body -ContentType 'application/json' -Headers $h

# Wartung vom Tablet zurückschreiben
Invoke-RestMethod 'http://localhost:8100/api/v1/service-articles/4711' -Method Patch `
    -Body '{"lastMaintenance1":"2026-07-18T10:00:00","condition":"gewartet"}' -ContentType 'application/json' -Headers $h

# Serviceauftrag direkt am Gerät
Invoke-RestMethod 'http://localhost:8100/api/v1/service-articles/4711/actions/create-order' -Method Post -Headers $h

curl.exe -H "Authorization: Bearer %KEY%" "http://localhost:8100/api/v1/service-articles?changedSince=2026-07-18T00:00:00&fields=id,serviceArticleNumber,changedAt"

curl.exe -H "Authorization: Bearer %KEY%" "http://localhost:8100/api/v1/service-articles/by-number/SAR000001"

curl.exe -H "Authorization: Bearer %KEY%" "http://localhost:8100/api/v1/service-articles/4711/history"

curl.exe -X POST -H "Authorization: Bearer %KEY%" "http://localhost:8100/api/v1/service-articles/4711/actions/create-order"

Fehler #

Migration von der XML-Schnittstelle #

Für Integrationen, die bisher EULANDA-servicearticle.xml per Datei austauschen: SERVICEARTIKELNR entspricht serviceArticleNumber (by-number/{number}), ADRESSEMATCH wird zu customerAddressId + customerMatch. Neu gegenüber dem XML: articleId (Stamm-Artikel), Delta-Sync über changedSince + /ids statt Voll-Snapshots, die Gerätehistorie und das Rückschreiben von Wartungsdaten per PATCH.