SAP CS APIs

SAP CS APIs bzgl. Customer Service

SAP CS (Customer Service) ist ein Modul innerhalb von SAP ERP, das darauf abzielt, Serviceprozesse wie die Verwaltung von Serviceaufträgen, Servicebenachrichtigungen und Servicematerialien zu unterstützen. SAP bietet APIs an, die eine Integration in andere Systeme ermöglichen und die Automatisierung von Prozessen fördern. Diese APIs sind in SAP S/4HANA und der SAP Business Technology Platform (BTP) verfügbar und umfassen sowohl REST- als auch SOAP-basierte Schnittstellen

SAP CS Service Order API


Diese API ermöglicht das Verwalten von Serviceaufträgen.

  • Endpunkt: /sap/opu/odata/sap/API_SERVICE_ORDER
  • Methoden:
    • GET /A_ServiceOrder: Abrufen von Serviceaufträgen
    • POST /A_ServiceOrder: Erstellung eines neuen Serviceauftrags
    • PATCH /A_ServiceOrder('{ServiceOrder}'): Aktualisierung eines Serviceauftrags
    • DELETE /A_ServiceOrder('{ServiceOrder}'): Löschen eines Serviceauftrags
  • JSON-Schema: Beispiel für einen Serviceauftrag: { "ServiceOrder": "50000001", "OrderType": "SRV1", "Priority": "1", "Customer": "0001000001", "Description": "Repair air conditioning system", "StartDate": "2023-12-01", "EndDate": "2023-12-05", "PlannedCost": "300.00", "Currency": "USD" }

SAP CS Service Notification API


Diese API unterstützt die Verwaltung von Servicemeldungen.

  • Endpunkt: /sap/opu/odata/sap/API_SERVICE_NOTIFICATION
  • Methoden:
    • GET /A_ServiceNotification: Abrufen von Servicemeldungen
    • POST /A_ServiceNotification: Erstellung einer neuen Meldung
    • PATCH /A_ServiceNotification('{ServiceNotification}'): Aktualisierung einer Servicemeldung
  • JSON-Schema: Beispiel für eine Servicemeldung: { "ServiceNotification": "20000001", "NotificationType": "SRVN", "Priority": "2", "Description": "Faulty elevator in building A", "Equipment": "E2000", "FunctionalLocation": "FL2000", "StartDate": "2023-12-01", "EndDate": "2023-12-02" }

SAP CS Installed Base (IBase) API


Diese API ermöglicht das Verwalten von installierten Basisobjekten, die bei Serviceprozessen verwendet werden.

  • Endpunkt: /sap/opu/odata/sap/API_INSTALLED_BASE
  • Methoden:
    • GET /A_InstalledBase: Abrufen von installierten Basisobjekten
    • POST /A_InstalledBase: Hinzufügen eines neuen Objekts
    • PATCH /A_InstalledBase('{InstalledBase}'): Bearbeiten eines Objekts
  • JSON-Schema: Beispiel für ein Basisobjekt: { "InstalledBase": "IB0001", "Description": "HVAC System", "Customer": "0001000001", "Location": "Plant 100", "Status": "Active", "Equipment": "E2000" }

SAP CS Equipment API


Mit dieser API können Geräte und Maschinen verwaltet werden, die im Kundenservice zum Einsatz kommen.

  • Endpunkt: /sap/opu/odata/sap/API_EQUIPMENT
  • Methoden:
    • GET /A_Equipment: Abrufen von Geräten
    • POST /A_Equipment: Hinzufügen eines neuen Geräts
    • PATCH /A_Equipment('{Equipment}'): Bearbeiten eines Geräts
  • JSON-Schema: Beispiel für ein Gerät: { "Equipment": "E2000", "Description": "Elevator Model X200", "Manufacturer": "ElevateCo", "Model": "X200", "SerialNumber": "SN54321", "FunctionalLocation": "FL2000", "Status": "In Service" }

SAP CS Service Contract API


Diese API ermöglicht das Verwalten von Serviceverträgen.

  • Endpunkt: /sap/opu/odata/sap/API_SERVICE_CONTRACT
  • Methoden:
    • GET /A_ServiceContract: Abrufen von Serviceverträgen
    • POST /A_ServiceContract: Erstellung eines neuen Vertrags
    • PATCH /A_ServiceContract('{ServiceContract}'): Aktualisierung eines Vertrags
  • JSON-Schema: Beispiel für einen Servicevertrag: { "ServiceContract": "SC0001", "Customer": "0001000001", "StartDate": "2023-01-01", "EndDate": "2023-12-31", "Description": "Maintenance Contract for HVAC System", "TotalValue": "1200.00", "Currency": "USD" }

SAP CS Customer API


Diese API unterstützt das Verwalten von Kundendaten, die für Serviceprozesse erforderlich sind.

  • Endpunkt: /sap/opu/odata/sap/API_BUSINESS_PARTNER
  • Methoden:
    • GET /A_BusinessPartner: Abrufen von Kundendaten
    • POST /A_BusinessPartner: Erstellen eines neuen Kunden
    • PATCH /A_BusinessPartner('{BusinessPartner}'): Aktualisieren eines Kunden
  • JSON-Schema: Beispiel für einen Kunden: { "BusinessPartner": "0001000001", "BusinessPartnerFullName": "ACME Corp.", "Address": { "Street": "Main Street 1", "City": "Metropolis", "Country": "US" }, "Phone": "+1234567890", "Email": "info@acme.com" }

Hier sind weitere SAP CS APIs, die Sie in Ihren Integrationsszenarien in Betracht ziehen können:

SAP CS Service Order Item API

Diese API ermöglicht die Verwaltung von Positionen innerhalb von Serviceaufträgen.

  • Endpunkt: /sap/opu/odata/sap/API_SERVICE_ORDER_ITEM
  • Methoden:
  • GET /A_ServiceOrderItem: Abrufen von Serviceauftrag-Positionen
  • POST /A_ServiceOrderItem: Hinzufügen einer neuen Position zu einem Serviceauftrag
  • PATCH /A_ServiceOrderItem(‚{ServiceOrderItem}‘): Aktualisierung einer Serviceauftrag-Position
  • JSON-Schema: Beispiel für eine Serviceauftrag-Position:
  {
    "ServiceOrderItem": "50000001-001",
    "ServiceOrder": "50000001",
    "Description": "Technical support",
    "Quantity": "2",
    "Unit": "Hours",
    "PlannedCost": "150.00"
  }

SAP CS Service Confirmation API

Diese API ermöglicht die Verwaltung von Bestätigungen für durchgeführte Servicearbeiten.

  • Endpunkt: /sap/opu/odata/sap/API_SERVICE_CONFIRMATION
  • Methoden:
  • GET /A_ServiceConfirmation: Abrufen von Servicebestätigungen
  • POST /A_ServiceConfirmation: Erstellung einer neuen Servicebestätigung
  • PATCH /A_ServiceConfirmation(‚{ServiceConfirmation}‘): Aktualisierung einer Bestätigung
  • JSON-Schema: Beispiel für eine Servicebestätigung:
  {
    "ServiceConfirmation": "CONF0001",
    "ServiceOrder": "50000001",
    "ConfirmationStatus": "Completed",
    "Technician": "Tech001",
    "ActualStartDate": "2023-12-02T08:00:00Z",
    "ActualEndDate": "2023-12-02T11:00:00Z"
  }

SAP CS Service Pricing API

Diese API ermöglicht die Verwaltung von Preisen für Dienstleistungen.

  • Endpunkt: /sap/opu/odata/sap/API_SERVICE_PRICING
  • Methoden:
  • GET /A_ServicePricing: Abrufen von Preislisten für Serviceleistungen
  • POST /A_ServicePricing: Hinzufügen eines neuen Preises für eine Dienstleistung
  • PATCH /A_ServicePricing(‚{ServicePricing}‘): Aktualisierung von Preisen
  • JSON-Schema: Beispiel für eine Dienstleistungspreisgestaltung:
  {
    "ServicePricing": "PRC001",
    "ServiceType": "Technical Support",
    "Price": "75.00",
    "Currency": "USD"
  }

SAP CS Warranty Claim API

Diese API ermöglicht das Management von Garantieansprüchen.

  • Endpunkt: /sap/opu/odata/sap/API_WARRANTY_CLAIM
  • Methoden:
  • GET /A_WarrantyClaim: Abrufen von Garantieansprüchen
  • POST /A_WarrantyClaim: Erstellung eines neuen Garantieanspruchs
  • PATCH /A_WarrantyClaim(‚{WarrantyClaim}‘): Aktualisierung eines Garantieanspruchs
  • JSON-Schema: Beispiel für einen Garantieanspruch:
  {
    "WarrantyClaim": "WC0001",
    "Customer": "0001000001",
    "Product": "HVAC System",
    "ClaimReason": "Defect",
    "ClaimStatus": "Pending",
    "ClaimAmount": "500.00"
  }

SAP CS Complaint Management API

Diese API unterstützt das Management von Beschwerden und Reklamationen.

  • Endpunkt: /sap/opu/odata/sap/API_COMPLAINT
  • Methoden:
  • GET /A_Complaint: Abrufen von Reklamationen
  • POST /A_Complaint: Erstellung einer neuen Reklamation
  • PATCH /A_Complaint(‚{Complaint}‘): Aktualisierung einer Reklamation
  • JSON-Schema: Beispiel für eine Reklamation:
  {
    "Complaint": "CPL0001",
    "Customer": "0001000001",
    "Description": "Delay in service",
    "ResolutionStatus": "Open",
    "ExpectedResolutionDate": "2023-12-10"
  }