Zum Hauptinhalt wechseln
Dokumentation
Dokumentation
Administrator Guide
Zuletzt aktualisiert: 2025-09-19
Konzept: Webservices „Services CPQ Quote“.

Konzept: Webservices „Services CPQ Quote“.

Verwenden Sie die folgenden Webservicevorgänge, um ein voll funktionsfähiges Angebot über die SOAP-API zu erstellen:
  1. Angebotsservices und -positionen übermitteln
  2. Arbeitsaufgliederungsstruktur für Angebot übermitteln
  3. Angebotsallokationen übermitteln
Wir empfehlen, die neueste Version der Webservices zu verwenden.

Aufgabe für äquivalente Workday-Benutzeroberfläche

Angebot erstellen

Von diesem Webservice verwendeter Geschäftsprozess

Geschäftsprozess
Angebotsereignis
 .

Angebotsservices und -positionen abrufen und übermitteln

Mit diesen Vorgängen können Sie ein Angebot abrufen, erstellen, bearbeiten oder ändern. Beachten Sie Folgendes:
  • Wenn Sie ein genehmigtes Angebot bearbeiten, muss ein Grund für die Angebotsänderung angegeben werden.
  • Mit dem Webservicevorgang können Sie folgende Angebotsobjekte bearbeiten:
    • Angebots-Header
    • Services
    • Positionen für Rolle, Posten, Spesen, Rabatte und Drittkosten.
  • Sie müssen die
    Arbeitsaufwandschätzung
     für einen Service definieren.
  • Wenn der Service Phasen oder Phasen und Aufgaben enthält, können Sie Rollenpositionen hinzufügen oder aktualisieren, nachdem Sie die Arbeitsgliederungsstruktur von Phasen und Aufgaben über den Webservicevorgang
    Submit Quote Work Breakdown Structure
     hinzugefügt haben.
  • Während der erstmaligen Angebotserstellung ignoriert Workday alle Rollenallokationen. Verwenden Sie den Webservicevorgang
    Submit Quote Allocations,
     um Allokationen hinzuzufügen.
  • Wenn Sie ein Angebot bearbeiten und einige Angebotsservices und Angebotspositionen ausschließen, löscht Workday diese Services und Angebotspositionen.
  • Sie müssen die Werte für den Preis pro Einheit und die Kosten pro Einheit angeben, die mit den Werten in der Tabelle der Projektfakturierungssätze übereinstimmen.
  • Sie können kein Angebot erstellen, wenn die zugehörige Opportunity den
    Status "Fehler"
    hat.

Webservicevorgänge „Get and Submit Work Breakdown Structure“.

Mit diesem Webservicevorgang können Sie Phasen und Aufgaben nur hinzufügen oder bearbeiten. Beachten Sie Folgendes:
  • Mit diesem Webservicevorgang können Sie Folgendes nicht ausführen:
    • Erstellen Sie ein neues Angebot.
    • Ändern Sie alle Angebotsservices oder Angebots-Header-Daten.
    • Bearbeiten Sie einen Service
      auf hoher Ebene,
       da dieser keine Phasen und Aufgaben hat.
    • Fügen Sie Aufgabendaten hinzu, wenn der
      Wert für "Aufwandsschätzung
       für Service"
      "Mit Phasen"
      lautet.
  • Das Angebotsservice
    Startdatum
     wird basierend auf dem Startdatum der Phase oder Aufgabe angepasst.
  • Das
    Enddatum
     des Angebotsservice wird basierend auf dem Enddatum der Phase oder Aufgabe angepasst.
  • Das
    Startdatum
     der Phase muss mit dem
    Startdatum
    der frühesten Aufgabe übereinstimmen.

Webservicevorgänge „Get and Submit Quote Allocations“.

Mit diesem Webservicevorgang können Sie nur Rollenallokationen und Elementdatumsangaben für alle Servicearten hinzufügen oder bearbeiten. Beachten Sie Folgendes:
  • Mit diesem Webservicevorgang können Sie Folgendes nicht ausführen:
    • Erstellen Sie ein neues Angebot.
    • Ändern Sie alle Angebotsservices oder Angebots-Header-Daten.
    • Phasen und Aufgaben bearbeiten.
  • Sie können Mengen- oder Beschäftigungsgradwerte für Allokationen verwenden. Wenn Sie beide Werte hochladen, verwendet Workday Beschäftigungsgrad-Werte, um die Allokationen zu aktualisieren.
  • Wenn Sie Allokationen mit Start- und Enddaten übermitteln, die sich mit vorhandenen Allokationen mit unterschiedlichen Beschäftigungsgraden überschneiden, erstellt Workday neue Allokationen mit neuen Werten für Beschäftigungsgrad und die vorhandene Allokation wird aufgeteilt, behält aber ihren Beschäftigungsgrad bei.
  • Workday teilt die Rollenallokationen nicht automatisch gleichmäßig auf Phasen oder Aufgaben auf. Sie müssen die Rollenallokationen manuell angeben.

Sicherheit

Die GET-Webservicevorgänge werden über folgende Domänen im funktionalen Bereich „Services CPQ“ gesichert:
  • iLoad-Webservices
  • Prozess: Angebote
  • Spezielle OX-Webservices
Die Webservicevorgänge „Submit“ werden über folgende Sicherheitselemente gesichert:
  • iLoad-Webservices
  • Geschäftsprozess „Angebotsereignis“.
  • Spezielle OX-Webservices
  • Anzeigen: Angebotsprojekthierarchien

Tipps zum Ausfüllen Ihrer Anforderung

Verwenden Sie eine GET-Anforderung für ein vorhandenes Angebot, um eine Nutzlaststruktur abzurufen, und verwenden Sie dann die abgerufenen Informationen, um ein vorhandenes Angebot zu erstellen oder zu aktualisieren.

Einschränkungen

Bei Verwendung der Webservicevorgänge gilt Folgendes:
  • Sie können das Startdatum des Angebots eines vorhandenen Angebots nicht bearbeiten, aber das Datum kann sich ändern, wenn sich das Startdatum des Service ändert.
  • Sie können die Gesamtwerte für die Felder
    "Preis"
    ,
    "Marge"
    oder
    "Rabatt"
     auf den Service- und Angebotsebenen nicht ändern.
  • Sie können keinen Service erstellen, indem Sie einen Servicekatalogposten hinzufügen.

Richtlinien für das Wiederherstellen nach einer fehlerhaften Ladung

Wenn Sie falsche Eingaben hochladen, öffnen Sie eine der folgenden Aufgaben:
  • Massenabbruch von Geschäftsprozessen
     , wenn das Geschäftsprozessereignis noch in Bearbeitung ist.
  • Massenrückgängigmachen von Geschäftsprozessen,
     wenn das Geschäftsprozessereignis abgeschlossen ist.
  • Sicherheit: Domäne
    Business Process Administrator
     im funktionalen Bereich „System“.
Nachdem Sie die Ereignisse abgebrochen oder rückgängig gemacht haben, führen Sie die Webservice-Anforderungen erneut aus.

Beispiel:

XML-Beispieldateien anzeigen:
  • Angebotsservices und -positionen übermitteln v45.0
  • Arbeitsaufgliederungsstruktur für Angebot übermitteln v45.0
  • Angebotsallokationen übermitteln