--- sourceDocument: Xanadu-API-Referenz sourceDocumentLink: https://www.servicenow.com/docs/r/de-DE/xanadu/api-reference Release : - xanadu ft:locale : - de-DE ft:publication_title : - Xanadu-API-Referenz ft:clusterId : - crapiref bundleId : - crapiref workflow : - Creator --- # Product Order Open API # Product Order Open API {#ariaid-title1} * Freigeben Version: Xanadu * * Aktualisiert 1. August 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 128 Minuten Lesedauer Die Product Order Open API bietet Endpunkte, die einen standardisierten Mechanismus für die Bestellung von Produkten ermöglichen. Eine Produktbestellung wird basierend auf einem Produktangebot erstellt, das in einem Produktkatalog definiert und veröffentlicht wird. Das Produktangebot identifiziert das Produkt oder die Produktgruppe, die einem Kunden zur Verfügung steht, und enthält die relevanten Produktmerkmale, die die eindeutigen Optionen eines Produkts erfassen, und andere relevante Attribute wie Preisgestaltung, Vertragsbedingungen und Verfügbarkeit. Für den Zugriff auf diese API muss das Plugin „Order Management for Telecommunications" (sn_ind_tmt_orm) aktiviert sein. Diese API wird im Namespace `sn_ind_tmt_orm` bereitgestellt. Der anrufende Benutzer muss über die Rolle sn_ind_tmt_orm.order_integrator verfügen. Diese API kann erweitert werden, um Anpassungen für erforderliche Parameter, die Validierung des Anforderungstexts, zusätzliche REST-Vorgänge und Feldzuordnungen vorzunehmen. Weitere Informationen finden Sie unter[Product Order Open API Developer Guide](https://www.servicenow.com/docs/88LuU~8HkmOnnse3MwWBrg#product-order_dev-guide "Verwenden Sie die Product Order Open API, um Produktbestellinformationen zu erstellen, zu aktualisieren und abzurufen."). Die Product Order Open API ist eine ServiceNow® -Implementierung der REST-Spezifikation TM Forum TMF622 Product Ordering Management API und wurde vom TM Forum für ihre Konformität zertifiziert. ## Offene API für Produktbestellung -- GET /sn_ind_tmt_orm/order/productOrder {#ariaid-title2} Ruft alle Produktbestellungen ab. Dieser Endpunkt ruft Bestellinformationen aus den folgenden Tabellen ab: * Kundenbestellung \[sn_ind_tmt_orm_order\] * Bestellposition \[sn_ind_tmt_orm_order_line_item\] * Bestellmerkmal \[sn_ind_tmt_orm_order_characterist_value\] * Auftragspositionselement -- Kontakt \[sn_ind_tmt_orm_order_line_item_contact\] * Zugehörige Elemente der Bestellposition \[sn_ind_tmt_orm_order_line_related_items\] {#tmf_prod_order-GET-ord-productOrder__ul_lxc_kxm_t4b} ### URL-Format {#tmf_prod_order-GET-ord-productOrder__section_mbm_2ct_t4b} Standard-URL: /api/sn_ind_tmt_orm/order/productOrder ### Unterstützte Anforderungsparameter {#tmf_prod_order-GET-ord-productOrder__table_ofr_vgy_fsb__entry__2} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 1. Pfadparameter] {#tmf_prod_order-GET-ord-productOrder__table_ofr_vgy_fsb} {#tmf_prod_order-GET-ord-productOrder__table_pfr_vgy_fsb__entry__2} | Name | Beschreibung | |-|-| | Felder | Liste der Felder, die in der Antwort zurückgegeben werden sollen. Ungültige Felder werden ignoriert. Wenn dieser Parameter nicht verwendet wird, werden alle Felder zurückgegeben. Datentyp: Zeichenfolge | | limit | Maximale Anzahl der zurückzugebenden Datensätze. Verwenden Sie für Anforderungen, die diese Anzahl von Datensätzen überschreiten, den Parameter offset, um den Datensatzabruf zu paginieren. Standard: 20 Maximum: 100 Datentyp: Zahl | | Offset | Startindex, ab dem mit dem Abrufen von Datensätzen begonnen werden soll. Verwenden Sie diesen Wert, um den Datensatzabruf zu paginieren. Diese Funktion ermöglicht das Abrufen aller Datensätze in kleinen, verwaltbaren Abschnitten, unabhängig von der Anzahl der Datensätze. Standard: 0 Datentyp: Zahl | | Staat | Filtern Sie Bestellungen nach Status. In der Antwort werden nur Aufträge zurückgegeben, deren Status dem Wert dieses Parameters entspricht. Datentyp: Zeichenfolge | [Tabelle : 2. Abfrageparameter] {#tmf_prod_order-GET-ord-productOrder__table_pfr_vgy_fsb} {#tmf_prod_order-GET-ord-productOrder__table_xcm_cvr_nsb__entry__2} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 3. Parameter des Anforderungstexts (JSON)] {#tmf_prod_order-GET-ord-productOrder__table_xcm_cvr_nsb} ### Kopfzeilen Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST API verwendet werden, finden Sie unter [Unterstützte REST API-Header](https://www.servicenow.com/docs/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können."). {#tmf_prod_order-GET-ord-productOrder__table_kqy_wgy_fsb__entry__2} | Kopfzeile | Beschreibung | |-|-| | Keine | | [Tabelle : 4. Anforderungskopfzeilen] {#tmf_prod_order-GET-ord-productOrder__table_kqy_wgy_fsb} {#tmf_prod_order-GET-ord-productOrder__table_h4r_fxr_nsb__entry__2}{#tmf_prod_order-GET-ord-productOrder__content-range-row}{#tmf_prod_order-GET-ord-productOrder__content-type-row}{#tmf_prod_order-GET-ord-productOrder__links-pagination-row}{#tmf_prod_order-GET-ord-productOrder__x-total-count-descr} | Kopfzeile | Beschreibung | |-|-| | Inhaltsbereich | Gibt den Inhaltsbereich an, der in einem paginierten Aufruf zurückgegeben wird. Beispiel: Wenn `Offset=2` und `Limit=3`, ist der Wert des Content-Range -Headers `Elemente 3-5`. | | Inhaltstyp | Datenformat des Antworttexts. Unterstützt nur application/json. | | Verknüpfung | Enthält die folgenden Links zum Navigieren durch Abfrageergebnisse. * zuerst * letzte * Weiter * previous {#tmf_prod_order-GET-ord-productOrder__ul_zzk_sdm_lsb} | | X-Gesamtzahl | Für paginierte Abfragen gibt dieser Header die Gesamtzahl der auf dem Server verfügbaren Datensätze an. | [Tabelle : 5. Antwortkopfzeilen] {#tmf_prod_order-GET-ord-productOrder__table_h4r_fxr_nsb} ### Statuscodes Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST API verwendet werden, finden Sie unter [HTTP-Antwortcodes](https://www.servicenow.com/docs/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API. {#tmf_prod_order-GET-ord-productOrder__table_wdl_3xr_nsb__entry__2}{#tmf_prod_order-GET-ord-productOrder__tmf-get-status-200-p}{#tmf_prod_order-GET-ord-productOrder__tmf-get-status-206-entry}{#tmf_prod_order-GET-ord-productOrder__tmf-get-status-400-entry}{#tmf_prod_order-GET-ord-productOrder__tmf-get-status-404-entry} | Statuscode | Beschreibung | |-|-| | 200 | Anforderung erfolgreich verarbeitet. Vollständige Ressource, die als Antwort zurückgegeben wird (keine Paginierung). | | 206 | Teilressource, die als Antwort zurückgegeben wird (mit Paginierung). | | 400 | Ungültige Anforderung. Mögliche Gründe: * Ungültiger Pfadparameter * Ungültiger URI {#tmf_prod_order-GET-ord-productOrder__ul_rys_1gy_fsb} | | 404 | Datensatz nicht gefunden In der Tabelle wurden keine Datensätze gefunden, die den Abfrageparametern entsprechen. | [Tabelle : 6. Statuscodes] {#tmf_prod_order-GET-ord-productOrder__table_wdl_3xr_nsb} ### Parameter des Antwort-Haupttexts (JSON) {#tmf_prod_order-GET-ord-productOrder__section_hnf_kxr_nsb} {#tmf_prod_order-GET-ord-productOrder__table_inf_kxr_nsb__entry__2}{#tmf_prod_order-GET-ord-productOrder__externalProdInv-resp-descr}{#tmf_prod_order-GET-ord-productOrder__externalProdInvId-resp-descr} | Name | Beschreibung | |-|-| | channel | Array von Objekten, die die Kanäle beschreiben, die für den Verkauf der Produkte verwendet werden sollen Datentyp: Array "channel": [ { "id": "String", "name": "String" } ] | | channel.id | Eindeutiger Bezeichner des Kanals, der für den Verkauf der zugehörigen Produkte verwendet werden soll. Kanal-ID-Werte befinden sich im Feld „external_id" der Tabelle „Verteilungskanal" \[sn_prd_pm_distribution_channel\]. Datentyp: Zeichenfolge | | Kanalname | Name des Kanals, der für den Verkauf der zugehörigen Produkte verwendet werden soll. Datentyp: Zeichenfolge | | committedDueDate | Datum und Uhrzeit, zu der die Aktion für den Auftrag ausgeführt werden muss. Dieser Wert muss mit den committedDueDate -Werten für jede Bestellposition übereinstimmen oder später als diese sein. Datentyp: Zeichenfolge | | erwartetesAbschlussdatum | Datum, an dem der Auftrag abgeschlossen wird. Datentyp: Zeichenfolge | | href | Relativer Link zum Produktbestelldatensatz. Datentyp: Zeichenfolge | | id | Sys_id der Produktbestellung. Datentyp: Zeichenfolge | | Hinweis | Array von Objekten, die zusätzliche Notizen beschreiben, die der Kunde bei der Bestellung gemacht hat. Datentyp: Array "note": [ { "author": "String", "date": "String", "text": "String" } ] | | Anmerkung.Autor | Anwendername der Person, die den zugehörigen Hinweis verfasst hat. Datentyp: Zeichenfolge | | Notiz.Datum | Datum, an dem die Notiz erstellt wurde. Datentyp: Zeichenfolge | | Anmerkung.Text | Zusätzliche Hinweise/Kommentare vom Kunden während der Bestellung. Datentyp: Zeichenfolge | | orderCurrency | Währungscode für den Auftrag und die Bestellpositionen. Datentyp: Zeichenfolge | | ponr | Kennzeichnung, die angibt, ob der Punkt ohne Rückkehr für den Auftrag erreicht wurde. Gültige Werte: * wahr: Der Punkt ohne Rückkehr für den Auftrag wurde erreicht. * „falsch": Der Punkt ohne Rückkehr für den Auftrag wurde nicht erreicht. {#tmf_prod_order-GET-ord-productOrder__ul_tdq_rw1_hqb} Datentyp: Boolesch | | productOrderItem | Liste, die die der Produktbestellung zugeordneten Elemente und die zugehörige Aktion beschreibt. Datentyp: Array "productOrderItem:" [ { "action": "String", "committedDueDate": "String", "externalProductInventory": [Array], "id": "String", "itemPrice": [Array], "product": {Object}, "productOffering": {Object}, "productOrderItemReleationship": [Array], "quantity": Number, "state": "String", "@type": "String" } ] | | productOrderItem.action | Aktion, die für das Produkt ausgeführt werden soll. Mögliche Aktionen sind auf der Registerkarte „Auswahlliste" im Aktionswörterbucheintrag der Tabelle sn_ind_tmt_orm_order_line_item definiert. Datentyp: Zeichenfolge | | „productOrderItem.actionReason" | Der Grund für das Hinzufügen der Auftragsposition. Datentyp: Zeichenfolge Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item/action_reason | | produktbestellelement.committedFälligkeitsdatum | Datum und Uhrzeit, zu der die Aktion für die Auftragsposition ausgeführt werden muss. Datentyp: Zeichenfolge | | Bestellelement.externerProduktbestand | Array von Objekten mit externen IDs, die den für den Auftrag erstellten Produktbeständen zugeordnet sind. Datentyp: Array "externalProductInventory": [ { "externalProductInventoryId": "String" } ] | | Bestellelement.externalProductInventory.externalProductInventoryId | Externe ID, die dem Produktbestand zugeordnet ist. Datentyp: Zeichenfolge | | productOrderItem.id | Eindeutiger Bezeichner der Position. Zu finden im Feld sn_ind_tmt_orm_external_id der Tabelle „Auftragspositionselement" \[sn_ind_tmt_orm_order_line_item\]. Datentyp: Zeichenfolge | | Produktbestellungselement.Artikelpreis | Array von Objekten, die den dem Produkt zugeordneten Preis beschreiben Datentyp: Array "itemPrice": [ { "price": {Object}, "priceType": "String", "recurringChargePeriod": "String" } ] | | Produktbestellungselement.Artikelpreis.Preis | Beschreibung des Preises des zugeordneten Produkts. Datentyp: Objekt "price": { "taxIncludedAmount": {Object} } | | „productOrderItem.itemPrice.Preis.SteuerEnthalteneBetrag" | Beschreibung des Preises des zugehörigen Produkts, einschließlich Steuer. Datentyp: Objekt "taxIncludedAmount": { "unit": "String", "value": Number } | | ProduktAuftragselement.Elementpreis.Preis.SteuerEnthaltenerBetrag.Einheit | Währungscode, in dem der Preis dargestellt wird. Datentyp: Zeichenfolge | | ProduktAuftragselement.Elementpreis.Preis.SteuerEnthaltenerBetrag.Wert | Preis des Produkts, einschließlich Steuern. Datentyp: Zahl | | „productOrderItem.itemPrice.PriceType" | Typ des Artikelpreises, wiederkehrend oder nicht wiederkehrend. Datentyp: Zeichenfolge | | „productOrderItem.itemPrice.recurringChargePeriod" | Wenn der Preis wiederkehrend ist, der wiederkehrende Zeitraum, z. B. Monat. Datentyp: Zeichenfolge | | productOrderItem.ponr | Kennzeichnung, die angibt, ob der Punkt ohne Rückkehr für den Auftrag erreicht wurde. Gültige Werte: * wahr: Der Punkt ohne Rückkehr für den Auftrag wurde erreicht. * „falsch": Der Punkt ohne Rückkehr für den Auftrag wurde nicht erreicht. {#tmf_prod_order-GET-ord-productOrder__d2876e2599} Datentyp: Boolesch | | ProduktBestellelement.Produkt | Beschreibung der Instanzdetails des vom Kunden erworbenen Produkts. Datentyp: Objekt "product:" { "place": {Object}, "productCharacteristic": [Array], "productRelationship": [Array], "productSpecification": {Object}, "relatedParty": {Object}, "@type": "String" } | | productOrderItem.product.place | Karten der Speicherorte, an denen das Produkt installiert werden soll. Datentyp: Objekt "place": { "id": "String", "@type": "String" } | | productOrderItem.product.place.id | Sys_id des zugeordneten Standortdatensatzes in der Standorttabelle \[cmn_location\]. Datentyp: Zeichenfolge | | productOrderItem.product.place.@type | Teil des TMF Open API-Standards. Anmerkung für den Kontakt des Bestellpositionselements. Dieser Wert ist immer Place. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | | productOrderItem.product.productMerkmal | Array von Objekten, die die Eigenschaften des zugeordneten Produkts beschreiben. Es werden nur Produktmerkmale zurückgegeben, deren value sich von den previousValue unterscheiden. Datentyp: Array "productCharacteristic": [ { "name": "String", "previousValue": "String", "value": "String" } ] | | productOrderItem.product.productCharacteristic.name | Name des Merkmaldatensatzes, der dem Produkt zugeordnet werden soll. Befindet sich in der Tabelle „Merkmal" \[sn_prd_pm_charakteristik\]. Datentyp: Zeichenfolge | | „productOrderItem.product.productFeature. previousValue" | Vorherige Merkmalsoptionswerte, wenn die Aktualisierung für einen Change-Auftrag erfolgt. Die Anforderung ist ein Change, wenn der Parameter productOrderItem.action etwas anderes als addist. Weitere Informationen zu Merkmalsoptionswerten finden Sie unter [Create product characteristics and characteristic options](https://www.servicenow.com/docs/access?context=som-product-config-add-characteristics&version=xanadu&pubname=xanadu-order-management&ft:locale=en-US). Datentyp: Zeichenfolge | | productOrderItem.product.productMerkmal.Wert | Merkmaloptionswerte, die dem Produkt zugeordnet sind. Weitere Informationen zu Merkmalsoptionswerten finden Sie unter [Create product characteristics and characteristic options](https://www.servicenow.com/docs/access?context=som-product-config-add-characteristics&version=xanadu&pubname=xanadu-order-management&ft:locale=en-US). Datentyp: Zeichenfolge | | productOrderItem.product.productRelationship | Liste der Produktbeziehungsdetails für eine Bestellposition. Datentyp: Array "productRelationship": [ { "id": "String", "relationshipType": "String" } ] | | productOrderItem.product.productRelationship.id | Sys_id oder sn_prd_invt_external_id des Produktbestands. Befindet sich im Feld „sys_id" oder „sn_prd_invt_external_id" der Tabelle „Produktbestand" \[sn_prd_invt_product_inventory\]. Datentyp: Zeichenfolge | | „productOrderItem.product.productRelationship.relationshipType" | Typ der Beziehung zwischen dem Auftragspositionselement und dem Produktbestand. Möglicher Wert: Erfordert Datentyp: Zeichenfolge | | productOrderItem.product.productSpecification | Beschreibung der Produktspezifikation, die dem Produkt zugeordnet ist. Datentyp: Objekt "productSpecification:" { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String", "@type": "String" } | | productOrderItem.product.productSpecification.id | Initial_version oder external_id der Produktspezifikation. initial_version ist die sys_id der ersten Version der Spezifikation. Befindet sich im Feld „sys_id" oder „external_id" der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. Datentyp: Zeichenfolge | | Bestellelement.Produkt.Produktspezifikation.interneID | Initiale_version der Produktspezifikation. initial_version ist die sys_id der ersten Version der Spezifikation. Befindet sich in der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. Datentyp: Zeichenfolge | | productOrderItem.product.productSpecification.interneVersion | Version der Produktspezifikation. Befindet sich in der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. Datentyp: Zeichenfolge | | productOrderItem.product.productSpecification.name | Name der Produktspezifikation. Befindet sich in der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. Datentyp: Zeichenfolge | | Produktbestellelement.Produkt.Produktspezifikation.Version | Externe_Version der Produktspezifikation. Befindet sich in der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. Datentyp: Zeichenfolge | | productOrderItem.product.productSpecification.@type | Teil des TMF Open API-Standards. Dieser Wert ist immer ProductSpecificationRef. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | | Bestellelement.Produkt.zugehörigePartei | Liste der Kontakte für Positionen. Datentyp: Array "relatedParty:" [ { "email": "String", "firstName": "String", "id": "String", "lastName": "String", "phone": "String", "@referredType": "String", "@type": "String" } ] | | productOrderItem.product.relatedParty.email | E-Mail-Adresse des Kontakts Datentyp: Zeichenfolge | | Bestellelement.Produkt.zugehörigePartei.ersterName | Vorname des Kontakts Datentyp: Zeichenfolge | | productOrderItem.product.relatedParty.id | Sys_id des Einzelpostenkontakts, der der Auftragsposition zugeordnet ist. Befindet sich in der Tabelle „Auftragspositionselement -- Kontakt" \[sn_ind_tmt_orm_order_line_item_contact\]. Datentyp: Zeichenfolge | | productOrderItem.product.relatedPartei.lastName | Nachname des Kontakts Datentyp: Zeichenfolge Datentyp: Zeichenfolge | | productOrderItem.product.relatedParty.phone | Geschäftliche Telefonnummer des Kontakts Datentyp: Zeichenfolge | | „productOrderItem.product.relatedPartei.@referredType" | Typ des Kunden Möglicher Wert: OrderLineItemContact Datentyp: Zeichenfolge | | productOrderItem.product.relatedPartei.@type | Teil des TMF Open API-Standards. Anmerkung für den Kontakt des Bestellpositionselements. Dieser Wert ist immer RelatedParty. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | | ProduktBestellelement.Produktangebot | Beschreibung des Produktangebots, das dem Produkt zugeordnet ist. Datentyp: Objekt "productOffering:" { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } | | productOrderItem.productOffering.id | Initial_version oder external_id des Produktangebots. initial_version ist die sys_id der ersten Version des Angebots. Zu finden im Feld „sys_id" oder „external_id" der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge | | „productOrderItem.productOffering.internalId" | Initial_version des Produktangebots. initial_version ist die sys_id der ersten Version des Angebots. Befindet sich in der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge | | ProduktBestellelement.Produktangebot.interneVersion | Version des Produktangebots. Befindet sich in der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge | | productOrderItem.productOffering.name | Name des Produktangebots Befindet sich in der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge | | ProduktBestellelement.Produktangebot.Version | Externe_Version des Produktangebots Befindet sich in der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge | | Produktbestellungselement.Menge | Anzahl der gekauften Produktartikel. Datentyp: Zahl | | Produktbestellungselement.ProduktbestellungselementBeziehung | Array von Objekten, die die Beziehungen zwischen Bestellpositionen beschreiben. Datentyp: Array "productOrderItemRelationship": [ { "id": "String", "relationshipType": "String" } ] | | productOrderItem.productOrderItemRelationship.id | Eindeutiger Bezeichner des zugehörigen Einzelpostens. Zu finden im Feld sn_ind_tmt_orm_external_id der Tabelle „Auftragspositionselement" \[sn_ind_tmt_orm_order_line_item\]. Datentyp: Zeichenfolge | | „productOrderItem.productOrderItemRelationship.relationshipType" | Typ der Beziehung zwischen den beiden Einzelposten. Diese Informationen werden verwendet, um die Beziehungshierarchie zu identifizieren. Mögliche Werte: * HasChild * Hat übergeordnet * Erfordert {#tmf_prod_order-GET-ord-productOrder__ul_yqf_2ty_54b} `„HasChild"` und `„HasParent"` werden für Beziehungen zwischen über- und untergeordneten Elementen verwendet. „`Erfordert` " wird für horizontale Beziehungen verwendet (ein Einzelposten erfordert einen anderen Einzelposten). Datentyp: Zeichenfolge | | „productOrderItem.state" | Status der Reihenfolge des zugeordneten Produktelements. Datentyp: Zeichenfolge | | ProduktBestellelement.Version | Bestellversion. Datentyp: Zeichenfolge | | produktBestellelement.@type | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer ProductOrderItem. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | | Zugehörige Partei | Liste der Kontakte für den Auftrag. Jeder Kontakt ist ein Objekt im Array. Muss mindestens ein Element aufführen, das Informationen zu Kunden- oder Verbraucherkonten enthält. Datentyp: Array "relatedParty:" [ { "id": "String", "name": "String", "@referredType": "String", "@type": "String" } ] | | relatedParty.id | Sys_id oder external_id des Accounts, Kundenkontakts oder Verbrauchers, der dem Auftrag zugeordnet ist. Zu finden in der Tabelle „Account" \[customer_account\], „Kontakt" \[customer_contact\] oder „Verbraucher" \[csm_consumer\]. Datentyp: Zeichenfolge | | relatedParty.name | Name des Accounts, Kunden oder Verbrauchers. Datentyp: Zeichenfolge | | zugehörigepartei.@referenztyp | Typ des Kunden Mögliche Werte: * Verbraucher * Kunde * Kundenkontakt {#tmf_prod_order-GET-ord-productOrder__ul_lcq_jwm_t4b} Datentyp: Zeichenfolge | | zugehörigepartei.@typ | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer RelatedParty. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | | RequestedCompletionDate | Vom Kunden angefordertes Lieferdatum Datentyp: Zeichenfolge | | Angefordertes Startdatum | Vom Kunden angefordertes Auftragsstartdatum. Datentyp: Zeichenfolge | | Staat | Aktueller Status des Auftrags. Datentyp: Zeichenfolge | | Version | Bestellversion. Datentyp: Zeichenfolge | | @type | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer ProductOrder. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | [ ] {#tmf_prod_order-GET-ord-productOrder__table_inf_kxr_nsb} ### cURL-Anforderung In diesem Beispiel werden alle Produktbestellungen abgerufen. curl --location --request GET 'https://instance.service-now.com/api/sn_ind_tmt_orm/order/productOrder' \ --user 'username':'password' Antworttext. [ { "id": "8d75939453126010a795ddeeff7b126a", "href": "/api/sn_ind_tmt_orm/order/productOrder/8d75939453126010a795ddeeff7b126a", "ponr": "false", "orderCurrency": "USD", "expectedCompletionDate": "2021-05-02T08:13:59.000Z", "requestedCompletionDate": "2021-05-02T08:13:59.000Z", "requestedStartDate": "2020-05-03T08:13:59.000Z", "channel": [ { "id": "1", "name": "Agent Assist" } ], "note": [ { "author": "System Administrator", "date": "2021-02-25T14:22:07.000Z", "text": "This is a TMF product order illustration no 2" }, { "author": "System Administrator", "date": "2021-02-25T14:22:06.000Z", "text": "This is a TMF product order illustration" } ], "productOrderItem": [ { "id": "POI130", "ponr": "false", "quantity": 1, "action": "add", "actionReason": "adding service package OLI", "itemPrice": [ { "priceType": "recurring", "price": { "taxIncludedAmount": { "unit": "USD", "value": 20 } } }, { "priceType": "nonRecurring", "price": { "taxIncludedAmount": { "unit": "INR", "value": 0 } } } ], "product": { "@type": "Product", "productCharacteristic": [ { "name": "Security Type", "valueType": "Choice", "value": "Base", "previousValue": "" } ], "productSpecification": { "id": "a6514bd3534560102f18ddeeff7b1247", "name": "SD-WAN Security", "version": "v1", "internalVersion": "1", "internalId": "a6514bd3534560102f18ddeeff7b1247", "@type": "ProductSpecificationRef" }, "relatedParty": [ { "id": "4175939453126010a795ddeeff7b127d", "name": "John Smith", "email": "abc2@example.com", "phone": "32456768", "@type": "RelatedParty", "@referredType": "OrderLineItemContact" }, { "id": "c175939453126010a795ddeeff7b127c", "name": "Joe Doe", "email": "abc@example.com", "phone": "1234567890", "@type": "RelatedParty", "@referredType": "OrderLineItemContact" } ] }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering", "version": "v1", "internalId": "69017a0f536520103b6bddeeff7b127d", "internalVersion": "1" }, "productOrderItemRelationship": [ { "id": "POI100", "relationshipType": "HasParent" } ], "state": "in_progress", "version": "1", "@type": "ProductOrderItem" }, { "id": "POI100", "ponr": "false", "quantity": 1, "action": "add", "itemPrice": [ { "priceType": "recurring", "price": { "taxIncludedAmount": { "unit": "INR", "value": 0 } } }, { "priceType": "nonRecurring", "price": { "taxIncludedAmount": { "unit": "INR", "value": 0 } } } ], "product": { "@type": "Product", "productSpecification": { "id": "cfe5ef6a53702010cd6dddeeff7b12f6", "name": "SD-WAN Service Package", "version": "v1", "internalVersion": "1", "internalId": "cfe5ef6a53702010cd6dddeeff7b12f6", "@type": "ProductSpecificationRef" } }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering", "version": "v1", "internalId": "69017a0f536520103b6bddeeff7b127d", "internalVersion": "1" }, "productOrderItemRelationship": [ { "id": "POI130", "relationshipType": "HasChild" }, { "id": "POI120", "relationshipType": "HasChild" }, { "id": "POI110", "relationshipType": "HasChild" } ], "state": "in_progress", "version": "1", "@type": "ProductOrderItem" }, { "id": "POI120", "ponr": "false", "quantity": 1, "action": "add", "itemPrice": [ { "priceType": "recurring", "price": { "taxIncludedAmount": { "unit": "USD", "value": 20 } } }, { "priceType": "nonRecurring", "price": { "taxIncludedAmount": { "unit": "INR", "value": 0 } } } ], "product": { "@type": "Product", "productCharacteristic": [ { "name": "CPE Type", "valueType": "Choice", "value": "Physical", "previousValue": "" }, { "name": "WAN Optimization", "valueType": "Choice", "value": "Advance", "previousValue": "" }, { "name": "Routing", "valueType": "Choice", "value": "Premium", "previousValue": "" }, { "name": "CPE Model", "valueType": "Choice", "value": "ASR", "previousValue": "" } ], "productSpecification": { "id": "39b627aa53702010cd6dddeeff7b1202", "name": "SD-WAN Edge Device", "version": "v1", "internalVersion": "1", "internalId": "39b627aa53702010cd6dddeeff7b1202", "@type": "ProductSpecificationRef" }, "productRelationship": [ { "id": "326d13f45b5620102dff5e92dc81c785", "relationshipType": "Requires" } ] }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering", "version": "v1", "internalVersion": "1", "internalId": "69017a0f536520103b6bddeeff7b127d" }, "productOrderItemRelationship": [ { "id": "POI100", "relationshipType": "HasParent" }, { "id": "POI110", "relationshipType": "Requires" } ], "state": "in_progress", "version": "1", "@type": "ProductOrderItem" }, { "id": "POI110", "ponr": "false", "quantity": 1, "action": "add", "itemPrice": [ { "priceType": "recurring", "price": { "taxIncludedAmount": { "unit": "INR", "value": 0 } } }, { "priceType": "nonRecurring", "price": { "taxIncludedAmount": { "unit": "USD", "value": 5 } } } ], "product": { "@type": "Product", "productCharacteristic": [ { "name": "Tenancy", "valueType": "Choice", "value": "Base (10 site)", "previousValue": "" } ], "productSpecification": { "id": "216663aa53702010cd6dddeeff7b12b5", "name": "SD-WAN Controller", "version": "v1", "internalVersion": "1", "internalId": "216663aa53702010cd6dddeeff7b12b5", "@type": "ProductSpecificationRef" }, "place": { "id": "25ab9c4d0a0a0bb300f7dabdc0ca7c1c", "@type": "Place" } }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering", "version": "v1", "internalId": "69017a0f536520103b6bddeeff7b127d", "internalVersion": "1" }, "productOrderItemRelationship": [ { "id": "POI100", "relationshipType": "HasParent" } ], "state": "in_progress", "version": "1", "@type": "ProductOrderItem" } ], "relatedParty": [ { "id": "eaf68911c35420105252716b7d40ddde", "name": "Sally Thomas", "@type": "RelatedParty", "@referredType": "CustomerContact" }, { "id": "ffc68911c35420105252716b7d40dd55", "name": "Funco Intl", "@type": "RelatedParty", "@referredType": "Customer" }, { "id": "59f16de1c3b67110ff00ed23a140dd9e", "name": "Funco External", "@type": "RelatedParty", "@referredType": "Consumer" } ], "state": "in_progress", "version": "1", "@type": "ProductOrder" } ] ## Offene API für Produktbestellung -- GET /sn_ind_tmt_orm/order/productOrder/{id} {#ariaid-title3} Ruft die angegebene Produktbestellung ab. Dieser Endpunkt ruft Bestellinformationen aus den folgenden Tabellen ab: * Kundenbestellung \[sn_ind_tmt_orm_order\] * Bestellmerkmal \[sn_ind_tmt_orm_order_characterist_value\] * Bestellposition \[sn_ind_tmt_orm_order_line_item\] * Auftragspositionselement -- Kontakt \[sn_ind_tmt_orm_order_line_item_contact\] * Zugehörige Elemente der Bestellposition \[sn_ind_tmt_orm_order_line_related_items\] {#tmf_prod_order-GET-ord-productOrder-id__ul_lxc_kxm_t4b} ### URL-Format {#tmf_prod_order-GET-ord-productOrder-id__section_mbm_2ct_t4b} Standard-URL: /api/sn_ind_tmt_orm/order/productOrder/{id} ### Unterstützte Anforderungsparameter {#tmf_prod_order-GET-ord-productOrder-id__entry__2} | Name | Beschreibung | |-|-| | id | Sys_id oder external_id des abzurufenden Kundenauftrags. Befindet sich in der Tabelle „Kundenauftrag" \[sn_ind_tmt_orm_order\]. Datentyp: Zeichenfolge | [Tabelle : 7. Pfadparameter] {#tmf_prod_order-GET-ord-productOrder-id__entry__6} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 8. Abfrageparameter] {#tmf_prod_order-GET-ord-productOrder-id__entry__10} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 9. Parameter des Anforderungstexts (JSON)] ### Kopfzeilen Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST API verwendet werden, finden Sie unter [Unterstützte REST API-Header](https://www.servicenow.com/docs/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können."). {#tmf_prod_order-GET-ord-productOrder-id__table_kqy_wgy_fsb__entry__2} | Kopfzeile | Beschreibung | |-|-| | Keine | | [Tabelle : 10. Anforderungskopfzeilen] {#tmf_prod_order-GET-ord-productOrder-id__table_kqy_wgy_fsb} {#tmf_prod_order-GET-ord-productOrder-id__table_tzy_thy_ksb__entry__2} | Kopfzeile | Beschreibung | |-|-| | Inhaltstyp | Datenformat des Antworttexts. Unterstützt nur application/json. | [Tabelle : 11. Antwortkopfzeilen] {#tmf_prod_order-GET-ord-productOrder-id__table_tzy_thy_ksb} ### Statuscodes Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST API verwendet werden, finden Sie unter [HTTP-Antwortcodes](https://www.servicenow.com/docs/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API. {#tmf_prod_order-GET-ord-productOrder-id__tmf-get-list-status-codes__entry__2} | Statuscode | Beschreibung | |-|-| | 200 | Anforderung erfolgreich verarbeitet. Vollständige Ressource, die als Antwort zurückgegeben wird (keine Paginierung). Die Antwort gibt erfolgreich mit einer Fehlermeldung zurück, wenn der ausgewählte Auftrag Verarbeitungsprobleme hat. * Die Antwort „200 OK" erfolgt, wenn sich der Auftrag in der Tabelle „Eingehende Warteschlange" \[sn_tmt_core_inbound_queue\] befindet und darauf wartet, dass der Planer den zu verarbeitenden Datensatz auswählt. Das Feld „Fehlermeldung" enthält Details für den Datensatz. Beispiel: { "code": 102, "reason": "Request in queue", "message": "Request in queue", "details": [ { "message": "This Order is still in the inbound queue table waiting to be processed.", "datapath": "" } ] } * Die Antwort 200 OK erfolgt, wenn die Auftragserstellung fehlschlägt und der Datensatz in der Tabelle „Eingehende Warteschlange" \[sn_tmt_core_inbound_queue\] einen Fehlerstatus aufweist. Das Feld „Fehlermeldung" enthält Details in für den Datensatz der eingehenden Warteschlangentabelle. Beispiel: { "code": 23, "reason": "Missing body field", "message": "Missing body field", "details": [ { "message": "Invalid payload: orderCurrency is missing", "datapath": "/" } ] } {#tmf_prod_order-GET-ord-productOrder-id__ul_kdw_y4w_fwb} | | 206 | Teilressource, die als Antwort zurückgegeben wird (mit Paginierung). | | 400 | Ungültige Anforderung. Mögliche Gründe: * Ungültiger Pfadparameter * Ungültiger URI {#tmf_prod_order-GET-ord-productOrder-id__ul_rys_1gy_fsb} | | 404 | Datensatz nicht gefunden In der Tabelle wurden keine Datensätze gefunden, die den Abfrageparametern entsprechen. | [Tabelle : 12. Statuscodes] {#tmf_prod_order-GET-ord-productOrder-id__tmf-get-list-status-codes} ### Parameter des Antwort-Haupttexts (JSON) {#tmf_prod_order-GET-ord-productOrder-id__entry__32}{#tmf_prod_order-GET-ord-productOrder-id__externalProdInv-resp-descr}{#tmf_prod_order-GET-ord-productOrder-id__externalProdInvId-resp-descr} | Name | Beschreibung | |-|-| | channel | Array von Objekten, die die Kanäle beschreiben, die für den Verkauf der Produkte verwendet werden sollen Datentyp: Array "channel": [ { "id": "String", "name": "String" } ] | | channel.id | Eindeutiger Bezeichner des Kanals, der für den Verkauf der zugehörigen Produkte verwendet werden soll. Kanal-ID-Werte befinden sich im Feld „external_id" der Tabelle „Verteilungskanal" \[sn_prd_pm_distribution_channel\]. Datentyp: Zeichenfolge | | Kanalname | Name des Kanals, der für den Verkauf der zugehörigen Produkte verwendet werden soll. Datentyp: Zeichenfolge | | committedDueDate | Datum und Uhrzeit, zu der die Aktion für den Auftrag ausgeführt werden muss. Dieser Wert muss mit den committedDueDate -Werten für jede Bestellposition übereinstimmen oder später als diese sein. Datentyp: Zeichenfolge | | erwartetesAbschlussdatum | Datum, an dem der Auftrag abgeschlossen wird. Datentyp: Zeichenfolge | | href | Relativer Link zum Produktbestelldatensatz. Datentyp: Zeichenfolge | | id | Sys_id der Produktbestellung. Datentyp: Zeichenfolge | | Hinweis | Array von Objekten, die zusätzliche Notizen beschreiben, die der Kunde bei der Bestellung gemacht hat. Datentyp: Array "note": [ { "author": "String", "date": "String", "text": "String" } ] | | Anmerkung.Autor | Anwendername der Person, die den zugehörigen Hinweis verfasst hat. Datentyp: Zeichenfolge | | Notiz.Datum | Datum, an dem die Notiz erstellt wurde. Datentyp: Zeichenfolge | | Anmerkung.Text | Zusätzliche Hinweise/Kommentare vom Kunden während der Bestellung. Datentyp: Zeichenfolge | | orderCurrency | Währungscode für den Auftrag und die Bestellpositionen. Datentyp: Zeichenfolge | | ponr | Kennzeichnung, die angibt, ob der Punkt ohne Rückkehr für den Auftrag erreicht wurde. Gültige Werte: * wahr: Der Punkt ohne Rückkehr für den Auftrag wurde erreicht. * „falsch": Der Punkt ohne Rückkehr für den Auftrag wurde nicht erreicht. {#tmf_prod_order-GET-ord-productOrder-id__ul_tdq_rw1_hqb} Datentyp: Boolesch | | productOrderItem | Liste, die die der Produktbestellung zugeordneten Elemente und die zugehörige Aktion beschreibt. Datentyp: Array "productOrderItem:" [ { "action": "String", "actionReason": "String", "committedDueDate": "String", "externalProductInventory": [Array], "id": "String", "itemPrice": [Array], "product": {Object}, "productOffering": {Object}, "productOrderItemReleationship": [Array], "quantity": Number, "state": "String", "@type": "String" } ] | | productOrderItem.action | Aktion, die für das Produkt ausgeführt werden soll. Mögliche Aktionen sind auf der Registerkarte „Auswahlliste" im Aktionswörterbucheintrag der Tabelle sn_ind_tmt_orm_order_line_item definiert. Datentyp: Zeichenfolge | | „productOrderItem.actionReason" | Der Grund für das Hinzufügen der Auftragsposition. Datentyp: Zeichenfolge Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item/action_reason | | produktbestellelement.committedFälligkeitsdatum | Datum und Uhrzeit, zu der die Aktion für die Auftragsposition ausgeführt werden muss. Datentyp: Zeichenfolge | | Bestellelement.externerProduktbestand | Array von Objekten mit externen IDs, die den für den Auftrag erstellten Produktbeständen zugeordnet sind. Datentyp: Array "externalProductInventory": [ { "externalProductInventoryId": "String" } ] | | Bestellelement.externalProductInventory.externalProductInventoryId | Externe ID, die dem Produktbestand zugeordnet ist. Datentyp: Zeichenfolge | | productOrderItem.id | Eindeutiger Bezeichner der Position. Zu finden im Feld sn_ind_tmt_orm_external_id der Tabelle „Auftragspositionselement" \[sn_ind_tmt_orm_order_line_item\]. Datentyp: Zeichenfolge | | Produktbestellungselement.Artikelpreis | Array von Objekten, die den dem Produkt zugeordneten Preis beschreiben Datentyp: Array "itemPrice": [ { "price": {Object}, "priceType": "String", "recurringChargePeriod": "String" } ] | | Produktbestellungselement.Artikelpreis.Preis | Beschreibung des Preises des zugeordneten Produkts. Datentyp: Objekt "price": { "taxIncludedAmount": {Object} } | | „productOrderItem.itemPrice.Preis.SteuerEnthalteneBetrag" | Beschreibung des Preises des zugehörigen Produkts, einschließlich Steuer. Datentyp: Objekt "taxIncludedAmount": { "unit": "String", "value": Number } | | ProduktAuftragselement.Elementpreis.Preis.SteuerEnthaltenerBetrag.Einheit | Währungscode, in dem der Preis dargestellt wird. Datentyp: Zeichenfolge | | ProduktAuftragselement.Elementpreis.Preis.SteuerEnthaltenerBetrag.Wert | Preis des Produkts, einschließlich Steuern. Datentyp: Zahl | | „productOrderItem.itemPrice.PriceType" | Typ des Artikelpreises, wiederkehrend oder nicht wiederkehrend. Datentyp: Zeichenfolge | | „productOrderItem.itemPrice.recurringChargePeriod" | Wenn der Preis wiederkehrend ist, der wiederkehrende Zeitraum, z. B. Monat. Datentyp: Zeichenfolge | | productOrderItem.ponr | Kennzeichnung, die angibt, ob der Punkt ohne Rückkehr für den Auftrag erreicht wurde. Gültige Werte: * wahr: Der Punkt ohne Rückkehr für den Auftrag wurde erreicht. * „falsch": Der Punkt ohne Rückkehr für den Auftrag wurde nicht erreicht. {#tmf_prod_order-GET-ord-productOrder-id__d2876e2599} Datentyp: Boolesch | | ProduktBestellelement.Produkt | Beschreibung der Instanzdetails des vom Kunden erworbenen Produkts. Datentyp: Objekt "product:" { "place": {Object}, "productCharacteristic": [Array], "productRelationship": [Array], "productSpecification": {Object}, "relatedParty": {Object}, "@type": "String" } | | productOrderItem.product.place | Karten der Speicherorte, an denen das Produkt installiert werden soll. Datentyp: Objekt "place": { "id": "String", "@type": "String" } | | productOrderItem.product.place.id | Sys_id des zugeordneten Standortdatensatzes in der Standorttabelle \[cmn_location\]. Datentyp: Zeichenfolge | | productOrderItem.product.place.@type | Teil des TMF Open API-Standards. Anmerkung für den Kontakt des Bestellpositionselements. Dieser Wert ist immer Place. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | | productOrderItem.product.productMerkmal | Array von Objekten, die die Eigenschaften des zugeordneten Produkts beschreiben. Es werden nur Produktmerkmale zurückgegeben, deren value sich von den previousValue unterscheiden. Datentyp: Array "productCharacteristic": [ { "name": "String", "previousValue": "String", "value": "String" } ] | | productOrderItem.product.productCharacteristic.name | Name des Merkmaldatensatzes, der dem Produkt zugeordnet werden soll. Befindet sich in der Tabelle „Merkmal" \[sn_prd_pm_charakteristik\]. Datentyp: Zeichenfolge | | „productOrderItem.product.productFeature. previousValue" | Vorherige Merkmalsoptionswerte, wenn die Aktualisierung für einen Change-Auftrag erfolgt. Die Anforderung ist ein Change, wenn der Parameter productOrderItem.action etwas anderes als addist. Weitere Informationen zu Merkmalsoptionswerten finden Sie unter [Create product characteristics and characteristic options](https://www.servicenow.com/docs/access?context=som-product-config-add-characteristics&version=xanadu&pubname=xanadu-order-management&ft:locale=en-US). Datentyp: Zeichenfolge | | productOrderItem.product.productMerkmal.Wert | Merkmaloptionswerte, die dem Produkt zugeordnet sind. Weitere Informationen zu Merkmalsoptionswerten finden Sie unter [Create product characteristics and characteristic options](https://www.servicenow.com/docs/access?context=som-product-config-add-characteristics&version=xanadu&pubname=xanadu-order-management&ft:locale=en-US). Datentyp: Zeichenfolge | | productOrderItem.product.productRelationship | Liste der Produktbeziehungsdetails für eine Bestellposition. Datentyp: Array "productRelationship": [ { "id": "String", "relationshipType": "String" } ] | | productOrderItem.product.productRelationship.id | Sys_id oder sn_prd_invt_external_id des Produktbestands. Befindet sich im Feld „sys_id" oder „sn_prd_invt_external_id" der Tabelle „Produktbestand" \[sn_prd_invt_product_inventory\]. Datentyp: Zeichenfolge | | „productOrderItem.product.productRelationship.relationshipType" | Typ der Beziehung zwischen dem Auftragspositionselement und dem Produktbestand. Möglicher Wert: Erfordert Datentyp: Zeichenfolge | | productOrderItem.product.productSpecification | Beschreibung der Produktspezifikation, die dem Produkt zugeordnet ist. Datentyp: Objekt "productSpecification:" { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String", "@type": "String" } | | productOrderItem.product.productSpecification.id | Initial_version oder external_id der Produktspezifikation. initial_version ist die sys_id der ersten Version der Spezifikation. Befindet sich im Feld „sys_id" oder „external_id" der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. Datentyp: Zeichenfolge | | Bestellelement.Produkt.Produktspezifikation.interneID | Initiale_version der Produktspezifikation. initial_version ist die sys_id der ersten Version der Spezifikation. Befindet sich in der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. Datentyp: Zeichenfolge | | productOrderItem.product.productSpecification.interneVersion | Version der Produktspezifikation. Befindet sich in der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. Datentyp: Zeichenfolge | | productOrderItem.product.productSpecification.name | Name der Produktspezifikation. Befindet sich in der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. Datentyp: Zeichenfolge | | Produktbestellelement.Produkt.Produktspezifikation.Version | Externe_Version der Produktspezifikation. Befindet sich in der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. Datentyp: Zeichenfolge | | productOrderItem.product.productSpecification.@type | Teil des TMF Open API-Standards. Dieser Wert ist immer ProductSpecificationRef. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | | Bestellelement.Produkt.zugehörigePartei | Liste der Kontakte für Positionen. Datentyp: Array "relatedParty:" { "email": "String", "firstName": "String", "id": "String", "lastName": "String", "phone": "String", "@referredType": "String", "@type": "String" } | | productOrderItem.product.relatedParty.email | E-Mail-Adresse des Kontakts Datentyp: Zeichenfolge | | Bestellelement.Produkt.zugehörigePartei.ersterName | Vorname des Kontakts Datentyp: Zeichenfolge | | productOrderItem.product.relatedParty.id | Sys_id des Einzelpostenkontakts, der der Auftragsposition zugeordnet ist. Befindet sich in der Tabelle „Auftragspositionselement -- Kontakt" \[sn_ind_tmt_orm_order_line_item_contact\]. Datentyp: Zeichenfolge | | productOrderItem.product.relatedPartei.lastName | Nachname des Kontakts Datentyp: Zeichenfolge Datentyp: Zeichenfolge | | productOrderItem.product.relatedParty.phone | Geschäftliche Telefonnummer des Kontakts Datentyp: Zeichenfolge | | „productOrderItem.product.relatedPartei.@referredType" | Typ des Kunden Möglicher Wert: OrderLineItemContact Datentyp: Zeichenfolge | | productOrderItem.product.relatedPartei.@type | Teil des TMF Open API-Standards. Anmerkung für den Kontakt des Bestellpositionselements. Dieser Wert ist immer RelatedParty. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | | ProduktBestellelement.Produktangebot | Beschreibung des Produktangebots, das dem Produkt zugeordnet ist. Datentyp: Objekt "productOffering:" { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } | | productOrderItem.productOffering.id | Initial_version oder external_id des Produktangebots. initial_version ist die sys_id der ersten Version des Angebots. Zu finden im Feld „sys_id" oder „external_id" der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge | | „productOrderItem.productOffering.internalId" | Initial_version des Produktangebots. initial_version ist die sys_id der ersten Version des Angebots. Befindet sich in der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge | | ProduktBestellelement.Produktangebot.interneVersion | Version des Produktangebots. Befindet sich in der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge | | productOrderItem.productOffering.name | Name des Produktangebots Befindet sich in der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge | | ProduktBestellelement.Produktangebot.Version | Externe_Version des Produktangebots Befindet sich in der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge | | Produktbestellungselement.Menge | Anzahl der gekauften Produktartikel. Datentyp: Zahl | | Produktbestellungselement.ProduktbestellungselementBeziehung | Array von Objekten, die die Beziehungen zwischen Bestellpositionen beschreiben. Datentyp: Array "productOrderItemRelationship": [ { "id": "String", "relationshipType": "String" } ] | | productOrderItem.productOrderItemRelationship.id | Eindeutiger Bezeichner des zugehörigen Einzelpostens. Zu finden im Feld sn_ind_tmt_orm_external_id der Tabelle „Auftragspositionselement" \[sn_ind_tmt_orm_order_line_item\]. Datentyp: Zeichenfolge | | „productOrderItem.productOrderItemRelationship.relationshipType" | Typ der Beziehung zwischen den beiden Einzelposten. Diese Informationen werden verwendet, um die Beziehungshierarchie zu identifizieren. Mögliche Werte: * HasChild * Hat übergeordnet * Erfordert {#tmf_prod_order-GET-ord-productOrder-id__ul_yqf_2ty_54b} `„HasChild"` und `„HasParent"` werden für Beziehungen zwischen über- und untergeordneten Elementen verwendet. „`Erfordert` " wird für horizontale Beziehungen verwendet (ein Einzelposten erfordert einen anderen Einzelposten). Datentyp: Zeichenfolge | | „productOrderItem.state" | Status der Reihenfolge des zugeordneten Produktelements. Datentyp: Zeichenfolge | | ProduktBestellelement.Version | Bestellversion. Datentyp: Zeichenfolge | | produktBestellelement.@type | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer ProductOrderItem. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | | Zugehörige Partei | Liste der Kontakte für den Auftrag. Jeder Kontakt ist ein Objekt im Array. Muss mindestens ein Element aufführen, das Informationen zu Kunden- oder Verbraucherkonten enthält. Datentyp: Array "relatedParty:" [ { "id": "String", "name": "String", "@referredType": "String", "@type": "String" } ] | | relatedParty.id | Sys_id oder external_id des Accounts, Kundenkontakts oder Verbrauchers, der dem Auftrag zugeordnet ist. Zu finden in der Tabelle „Account" \[customer_account\], „Kontakt" \[customer_contact\] oder „Verbraucher" \[csm_consumer\]. Datentyp: Zeichenfolge | | relatedParty.name | Name des Accounts, Kunden oder Verbrauchers. Datentyp: Zeichenfolge | | zugehörigepartei.@referenztyp | Typ des Kunden Mögliche Werte: * Verbraucher * Kunde * Kundenkontakt {#tmf_prod_order-GET-ord-productOrder-id__ul_lcq_jwm_t4b} Datentyp: Zeichenfolge | | zugehörigepartei.@typ | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer RelatedParty. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | | RequestedCompletionDate | Vom Kunden angefordertes Lieferdatum Datentyp: Zeichenfolge | | Angefordertes Startdatum | Vom Kunden angefordertes Auftragsstartdatum. Datentyp: Zeichenfolge | | Staat | Aktueller Status des Auftrags. Datentyp: Zeichenfolge | | Version | Bestellversion. Datentyp: Zeichenfolge | | @type | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer ProductOrder. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | [ ] ### cURL-Anforderung In diesem Beispiel wird eine angegebene Produktbestellung abgerufen. curl -X GET "https://instance.service-now.com/api/sn_ind_tmt_orm/order/productOrder/8d75939453126010a795ddeeff7b126a" \ -u "username":"password" Antworttext. { "id": "8d75939453126010a795ddeeff7b126a", "href": "/api/sn_ind_tmt_orm/order/productOrder/8d75939453126010a795ddeeff7b126a", "ponr": "false", "orderCurrency": "USD", "expectedCompletionDate": "2021-05-02T08:13:59.000Z", "requestedCompletionDate": "2021-05-02T08:13:59.000Z", "requestedStartDate": "2020-05-03T08:13:59.000Z", "channel": [ { "id": "1", "name": "Agent Assist" } ], "note": [ { "author": "System Administrator", "date": "2021-02-25T14:22:07.000Z", "text": "This is a TMF product order illustration no 2" }, { "author": "System Administrator", "date": "2021-02-25T14:22:06.000Z", "text": "This is a TMF product order illustration" } ], "productOrderItem": [ { "id": "POI130", "ponr": "false", "quantity": 1, "action": "add", "actionReason": "adding service package OLI", "itemPrice": [ { "priceType": "recurring", "price": { "taxIncludedAmount": { "unit": "USD", "value": 20 } } }, { "priceType": "nonRecurring", "price": { "taxIncludedAmount": { "unit": "INR", "value": 0 } } } ], "product": { "@type": "Product", "productCharacteristic": [ { "name": "Security Type", "valueType": "Choice", "value": "Base", "previousValue": "" } ], "productSpecification": { "id": "a6514bd3534560102f18ddeeff7b1247", "name": "SD-WAN Security", "version": "v1", "internalVersion": "1", "internalId": "a6514bd3534560102f18ddeeff7b1247", "@type": "ProductSpecificationRef" }, "relatedParty": [ { "id": "4175939453126010a795ddeeff7b127d", "name": "John Smith", "email": "abc2@example.com", "phone": "32456768", "@type": "RelatedParty", "@referredType": "OrderLineItemContact" }, { "id": "c175939453126010a795ddeeff7b127c", "name": "Joe Doe", "email": "abc@example.com", "phone": "1234567890", "@type": "RelatedParty", "@referredType": "OrderLineItemContact" } ] }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering", "version": "v1", "internalId": "69017a0f536520103b6bddeeff7b127d", "internalVersion": "1" }, "productOrderItemRelationship": [ { "id": "POI100", "relationshipType": "HasParent" } ], "state": "in_progress", "version": "1", "@type": "ProductOrderItem" }, { "id": "POI100", "ponr": "false", "quantity": 1, "action": "add", "actionReason":"adding service package OLI", "itemPrice": [ { "priceType": "recurring", "price": { "taxIncludedAmount": { "unit": "INR", "value": 0 } } }, { "priceType": "nonRecurring", "price": { "taxIncludedAmount": { "unit": "INR", "value": 0 } } } ], "product": { "@type": "Product", "productSpecification": { "id": "cfe5ef6a53702010cd6dddeeff7b12f6", "name": "SD-WAN Service Package", "version": "v1", "internalVersion": "1", "internalId": "cfe5ef6a53702010cd6dddeeff7b12f6", "@type": "ProductSpecificationRef" } }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering", "version": "v1", "internalId": "69017a0f536520103b6bddeeff7b127d", "internalVersion": "1" }, "productOrderItemRelationship": [ { "id": "POI130", "relationshipType": "HasChild" }, { "id": "POI120", "relationshipType": "HasChild" }, { "id": "POI110", "relationshipType": "HasChild" } ], "state": "in_progress", "version": "1", "@type": "ProductOrderItem" }, { "id": "POI120", "ponr": "false", "quantity": 1, "action": "add", "actionReason": "adding service package OLI", "itemPrice": [ { "priceType": "recurring", "price": { "taxIncludedAmount": { "unit": "USD", "value": 20 } } }, { "priceType": "nonRecurring", "price": { "taxIncludedAmount": { "unit": "INR", "value": 0 } } } ], "product": { "@type": "Product", "productCharacteristic": [ { "name": "CPE Type", "valueType": "Choice", "value": "Physical", "previousValue": "" }, { "name": "WAN Optimization", "valueType": "Choice", "value": "Advance", "previousValue": "" }, { "name": "Routing", "valueType": "Choice", "value": "Premium", "previousValue": "" }, { "name": "CPE Model", "valueType": "Choice", "value": "ASR", "previousValue": "" } ], "productSpecification": { "id": "39b627aa53702010cd6dddeeff7b1202", "name": "SD-WAN Edge Device", "version": "v1", "internalVersion": "1", "internalId": "39b627aa53702010cd6dddeeff7b1202", "@type": "ProductSpecificationRef" }, "productRelationship": [ { "id": "326d13f45b5620102dff5e92dc81c785", "relationshipType": "Requires" } ] }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering", "version": "v1", "internalVersion": "1", "internalId": "69017a0f536520103b6bddeeff7b127d" }, "productOrderItemRelationship": [ { "id": "POI100", "relationshipType": "HasParent" }, { "id": "POI110", "relationshipType": "Requires" } ], "state": "in_progress", "version": "1", "@type": "ProductOrderItem" }, { "id": "POI110", "ponr": "false", "quantity": 1, "action": "add", "actionReason": "adding service package OLI", "itemPrice": [ { "priceType": "recurring", "price": { "taxIncludedAmount": { "unit": "INR", "value": 0 } } }, { "priceType": "nonRecurring", "price": { "taxIncludedAmount": { "unit": "USD", "value": 5 } } } ], "product": { "@type": "Product", "productCharacteristic": [ { "name": "Tenancy", "valueType": "Choice", "value": "Base (10 site)", "previousValue": "" } ], "productSpecification": { "id": "216663aa53702010cd6dddeeff7b12b5", "name": "SD-WAN Controller", "version": "v1", "internalVersion": "1", "internalId": "216663aa53702010cd6dddeeff7b12b5", "@type": "ProductSpecificationRef" }, "place": { "id": "25ab9c4d0a0a0bb300f7dabdc0ca7c1c", "@type": "Place" } }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering", "version": "v1", "internalId": "69017a0f536520103b6bddeeff7b127d", "internalVersion": "1" }, "productOrderItemRelationship": [ { "id": "POI100", "relationshipType": "HasParent" } ], "state": "in_progress", "version": "1", "@type": "ProductOrderItem" } ], "relatedParty": [ { "id": "eaf68911c35420105252716b7d40ddde", "name": "Sally Thomas", "@type": "RelatedParty", "@referredType": "CustomerContact" }, { "id": "ffc68911c35420105252716b7d40dd55", "name": "Funco Intl", "@type": "RelatedParty", "@referredType": "Customer" }, { "id": "59f16de1c3b67110ff00ed23a140dd9e", "name": "Funco External", "@type": "RelatedParty", "@referredType": "Consumer" } ], "state": "in_progress", "version": "1", "@type": "ProductOrder" } ## Offene API für Produktbestellung -- GET /sn_ind_tmt_orm/productorder {#ariaid-title4} Ruft alle Produktbestellungen ab. Wichtig: Ab Release Tokyo ist dieser Endpunkt veraltet. Die neue Version dieses Endpunkts ist [Offene API für Produktbestellung -- GET /sn_ind_tmt_orm/order/productOrder](https://www.servicenow.com/docs/Ae5XqErKGgN46FHZcSkOdg#tmf_prod_order-GET-ord-productOrder "Ruft alle Produktbestellungen ab."). Dieser Endpunkt ruft Bestellinformationen aus den folgenden Tabellen ab: * Kundenbestellung \[sn_ind_tmt_orm_order\] * Bestellmerkmal \[sn_ind_tmt_orm_order_characterist_value\] * Bestellposition \[sn_ind_tmt_orm_order_line_item\] * Auftragspositionselement -- Kontakt \[sn_ind_tmt_orm_order_line_item_contact\] {#tmf_prod_order-GET-productorder__ul_lxc_kxm_t4b} ### URL-Format {#tmf_prod_order-GET-productorder__section_mbm_2ct_t4b} Standard-URL: /api/sn_ind_tmt_orm/productorder ### Unterstützte Anforderungsparameter {#tmf_prod_order-GET-productorder__table_ofr_vgy_fsb__entry__2} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 13. Pfadparameter] {#tmf_prod_order-GET-productorder__table_ofr_vgy_fsb} {#tmf_prod_order-GET-productorder__table_pfr_vgy_fsb__entry__2} | Name | Beschreibung | |-|-| | Felder | Liste der Felder, die in der Antwort zurückgegeben werden sollen. Ungültige Felder werden ignoriert. Datentyp: Zeichenfolge Standard: Alle zurückgegebenen Felder. | | limit | Maximale Anzahl der zurückzugebenden Datensätze. Verwenden Sie für Anforderungen, die diese Anzahl von Datensätzen überschreiten, den Parameter offset, um den Datensatzabruf zu paginieren. Standard: 20 Maximum: 100 Datentyp: Zahl | | Offset | Startindex, ab dem mit dem Abrufen von Datensätzen begonnen werden soll. Verwenden Sie diesen Wert, um den Datensatzabruf zu paginieren. Diese Funktion ermöglicht das Abrufen aller Datensätze in kleinen, verwaltbaren Abschnitten, unabhängig von der Anzahl der Datensätze. Standard: 0 Datentyp: Zahl | | Staat | Filtern Sie Bestellungen nach Status. In der Antwort werden nur Aufträge zurückgegeben, deren Status dem Wert dieses Parameters entspricht. Datentyp: Zeichenfolge Standard: Alle zurückgegebenen Status. | [Tabelle : 14. Abfrageparameter] {#tmf_prod_order-GET-productorder__table_pfr_vgy_fsb} {#tmf_prod_order-GET-productorder__table_xcm_cvr_nsb__entry__2} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 15. Parameter des Anforderungstexts (JSON)] {#tmf_prod_order-GET-productorder__table_xcm_cvr_nsb} ### Kopfzeilen Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST API verwendet werden, finden Sie unter [Unterstützte REST API-Header](https://www.servicenow.com/docs/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können."). {#tmf_prod_order-GET-productorder__table_kqy_wgy_fsb__entry__2} | Kopfzeile | Beschreibung | |-|-| | Keine | | [Tabelle : 16. Anforderungskopfzeilen] {#tmf_prod_order-GET-productorder__table_kqy_wgy_fsb} {#tmf_prod_order-GET-productorder__table_h4r_fxr_nsb__entry__2}{#tmf_prod_order-GET-productorder__content-range-row}{#tmf_prod_order-GET-productorder__content-type-row}{#tmf_prod_order-GET-productorder__links-pagination-row}{#tmf_prod_order-GET-productorder__x-total-count-descr} | Kopfzeile | Beschreibung | |-|-| | Inhaltsbereich | Gibt den Inhaltsbereich an, der in einem paginierten Aufruf zurückgegeben wird. Beispiel: Wenn `Offset=2` und `Limit=3`, ist der Wert des Content-Range -Headers `Elemente 3-5`. | | Inhaltstyp | Datenformat des Antworttexts. Unterstützt nur application/json. | | Verknüpfung | Enthält die folgenden Links zum Navigieren durch Abfrageergebnisse. * zuerst * letzte * Weiter * previous {#tmf_prod_order-GET-productorder__ul_zzk_sdm_lsb} | | X-Gesamtzahl | Für paginierte Abfragen gibt dieser Header die Gesamtzahl der auf dem Server verfügbaren Datensätze an. | [Tabelle : 17. Antwortkopfzeilen] {#tmf_prod_order-GET-productorder__table_h4r_fxr_nsb} ### Statuscodes Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST API verwendet werden, finden Sie unter [HTTP-Antwortcodes](https://www.servicenow.com/docs/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API. {#tmf_prod_order-GET-productorder__table_wdl_3xr_nsb__entry__2}{#tmf_prod_order-GET-productorder__tmf-get-status-200-p}{#tmf_prod_order-GET-productorder__tmf-get-status-206-entry}{#tmf_prod_order-GET-productorder__tmf-get-status-400-entry}{#tmf_prod_order-GET-productorder__tmf-get-status-404-entry} | Statuscode | Beschreibung | |-|-| | 200 | Anforderung erfolgreich verarbeitet. Vollständige Ressource, die als Antwort zurückgegeben wird (keine Paginierung). | | 206 | Teilressource, die als Antwort zurückgegeben wird (mit Paginierung). | | 400 | Ungültige Anforderung. Mögliche Gründe: * Ungültiger Pfadparameter * Ungültiger URI {#tmf_prod_order-GET-productorder__ul_rys_1gy_fsb} | | 404 | Datensatz nicht gefunden In der Tabelle wurden keine Datensätze gefunden, die den Abfrageparametern entsprechen. | [Tabelle : 18. Statuscodes] {#tmf_prod_order-GET-productorder__table_wdl_3xr_nsb} ### Parameter des Antwort-Haupttexts (JSON) {#tmf_prod_order-GET-productorder__section_hnf_kxr_nsb} {#tmf_prod_order-GET-productorder__table_inf_kxr_nsb__entry__2} | Name | Beschreibung | |-|-| | channel | Array von Objekten, die die Kanäle beschreiben, die für den Verkauf der Produkte verwendet werden sollen Datentyp: Array "channel": [ { "id": "String", "name": "String" } ] | | channel.id | Eindeutiger Bezeichner des Kanals, der für den Verkauf der zugehörigen Produkte verwendet werden soll. Kanal-ID-Werte befinden sich im Feld „external_id" der Tabelle „Verteilungskanal" \[sn_prd_pm_distribution_channel\]. Datentyp: Zeichenfolge | | Kanalname | Name des Kanals, der für den Verkauf der zugehörigen Produkte verwendet werden soll. Datentyp: Zeichenfolge | | erwartetesAbschlussdatum | Datum, an dem der Auftrag abgeschlossen wird. Datentyp: Zeichenfolge | | Hinweis | Array von Objekten, die zusätzliche Notizen beschreiben, die der Kunde bei der Bestellung gemacht hat. Datentyp: Array "note": { "author": "String", "date": "String", "text": "String" } | | Anmerkung.Autor | Anwendername der Person, die den zugehörigen Hinweis verfasst hat. Datentyp: Zeichenfolge | | Notiz.Datum | Datum, an dem die Notiz erstellt wurde. Datentyp: Zeichenfolge | | Anmerkung.Text | Zusätzliche Hinweise/Kommentare vom Kunden während der Bestellung. Datentyp: Zeichenfolge | | ponr | Kennzeichnung, die angibt, ob der Punkt ohne Rückkehr für den Auftrag erreicht wurde. Gültige Werte: * wahr: Der Punkt ohne Rückkehr für den Auftrag wurde erreicht. * „falsch": Der Punkt ohne Rückkehr für den Auftrag wurde nicht erreicht. {#tmf_prod_order-GET-productorder__ul_tdq_rw1_hqb} Datentyp: Boolesch | | productOrderItem | Liste, die die der Produktbestellung zugeordneten Elemente und die zugehörige Aktion beschreibt. Datentyp: Array "productOrderItem:" [ { "action": "String", "actionReason": "String", "id": "String", "itemPrice": [Array], "product": {Object}, "productOffering": {Object}, "productOrderItemReleationship": [Array], "quantity": Number, "state": "String", "@type": "String" } ] | | productOrderItem.action | Aktion, die für das Produkt ausgeführt werden soll. Mögliche Aktionen sind auf der Registerkarte „Auswahlliste" im Aktionswörterbucheintrag der Tabelle sn_ind_tmt_orm_order_line_item definiert. Datentyp: Zeichenfolge | | „productOrderItem.actionReason" | Der Grund für das Hinzufügen der Auftragsposition. Datentyp: Zeichenfolge Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item/action_reason | | productOrderItem.id | Eindeutiger Bezeichner der Position. Zu finden im Feld sn_ind_tmt_orm_external_id der Tabelle „Auftragspositionselement" \[sn_ind_tmt_orm_order_line_item\]. Datentyp: Zeichenfolge | | Produktbestellungselement.Artikelpreis | Array von Objekten, die den dem Produkt zugeordneten Preis beschreiben Datentyp: Array "itemPrice": [ { "price": {Object}, "priceType": "String", "recurringChargePeriod": "String" } ] | | Produktbestellungselement.Artikelpreis.Preis | Beschreibung des Preises des zugeordneten Produkts. Datentyp: Objekt "price": { "taxIncludedAmount": {Object} } | | „productOrderItem.itemPrice.Preis.SteuerEnthalteneBetrag" | Beschreibung des Preises des zugehörigen Produkts, einschließlich Steuer. Datentyp: Objekt "taxIncludedAmount": { "unit": "String", "value": Number } | | ProduktAuftragselement.Elementpreis.Preis.SteuerEnthaltenerBetrag.Einheit | Währungscode, in dem der Preis dargestellt wird. Datentyp: Zeichenfolge | | ProduktAuftragselement.Elementpreis.Preis.SteuerEnthaltenerBetrag.Wert | Preis des Produkts, einschließlich Steuern. Datentyp: Zahl | | „productOrderItem.itemPrice.PriceType" | Typ des Artikelpreises, wiederkehrend oder nicht wiederkehrend. Datentyp: Zeichenfolge | | „productOrderItem.itemPrice.recurringChargePeriod" | Wenn der Preis wiederkehrend ist, der wiederkehrende Zeitraum, z. B. Monat. Datentyp: Zeichenfolge | | productOrderItem.ponr | Kennzeichnung, die angibt, ob der Punkt ohne Rückkehr für den Auftrag erreicht wurde. Gültige Werte: * wahr: Der Punkt ohne Rückkehr für den Auftrag wurde erreicht. * „falsch": Der Punkt ohne Rückkehr für den Auftrag wurde nicht erreicht. {#tmf_prod_order-GET-productorder__d2876e2599} Datentyp: Boolesch | | ProduktBestellelement.Produkt | Beschreibung der Instanzdetails des vom Kunden erworbenen Produkts. Datentyp: Objekt "product:" { "place": {Object}, "productCharacteristic": [Array], "productSpecification": {Object}, "relatedParty": {Object}, "@type": "String" } | | productOrderItem.product.place | Karten der Speicherorte, an denen das Produkt installiert werden soll. Datentyp: Objekt "place": { "id": "String", "@type": "String" } | | productOrderItem.product.place.id | Sys_id des zugeordneten Standortdatensatzes in der Standorttabelle \[cmn_location\]. Datentyp: Zeichenfolge | | productOrderItem.product.place.@type | Teil des TMF Open API-Standards. Anmerkung für den Kontakt des Bestellpositionselements. Dieser Wert ist immer Place. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | | productOrderItem.product.productMerkmal | Array von Objekten, die die Eigenschaften des zugeordneten Produkts beschreiben. Es werden nur Produktmerkmale zurückgegeben, deren value sich von den previousValue unterscheiden. Datentyp: Array "productCharacteristic": [ { "name": "String", "previousValue": "String", "value": "String" } ] | | productOrderItem.product.productCharacteristic.name | Name des Merkmaldatensatzes, der dem Produkt zugeordnet werden soll. Befindet sich in der Tabelle „Merkmal" \[sn_prd_pm_charakteristik\]. Datentyp: Zeichenfolge | | „productOrderItem.product.productFeature. previousValue" | Vorherige Merkmalsoptionswerte, wenn die Aktualisierung für einen Change-Auftrag erfolgt. Die Anforderung ist ein Change, wenn der Parameter productOrderItem.action etwas anderes als addist. Weitere Informationen zu Merkmalsoptionswerten finden Sie unter [Create product characteristics and characteristic options](https://www.servicenow.com/docs/access?context=som-product-config-add-characteristics&version=xanadu&pubname=xanadu-order-management&ft:locale=en-US). Datentyp: Zeichenfolge | | productOrderItem.product.productMerkmal.Wert | Merkmaloptionswerte, die dem Produkt zugeordnet sind. Weitere Informationen zu Merkmalsoptionswerten finden Sie unter [Create product characteristics and characteristic options](https://www.servicenow.com/docs/access?context=som-product-config-add-characteristics&version=xanadu&pubname=xanadu-order-management&ft:locale=en-US). Datentyp: Zeichenfolge | | productOrderItem.product.productSpecification | Beschreibung der Produktspezifikation, die dem Produkt zugeordnet ist. Datentyp: Objekt "productSpecification:" { "id": "String", "name": "String", "@type": "String" } | | productOrderItem.product.productSpecification.id | Initial_version oder external_id der Produktspezifikation. initial_version ist die sys_id der ersten Version der Spezifikation. Befindet sich im Feld „sys_id" oder „external_id" der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. Datentyp: Zeichenfolge | | productOrderItem.product.productSpecification.name | Name der Produktspezifikation. Befindet sich in der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. Datentyp: Zeichenfolge | | productOrderItem.product.productSpecification.@type | Teil des TMF Open API-Standards. Dieser Wert ist immer ProductSpecificationRef. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | | Bestellelement.Produkt.zugehörigePartei | Liste der Kontakte für Positionen. Datentyp: Array "relatedParty:" { "email": "String", "firstName": "String", "id": "String", "lastName": "String", "phone": "String", "@referredType": "String", "@type": "String" } | | productOrderItem.product.relatedParty.email | E-Mail-Adresse des Kontakts Datentyp: Zeichenfolge | | Bestellelement.Produkt.zugehörigePartei.ersterName | Vorname des Kontakts Datentyp: Zeichenfolge | | productOrderItem.product.relatedParty.id | Sys_id des Einzelpostenkontakts, der der Auftragsposition zugeordnet ist. Befindet sich in der Tabelle „Auftragspositionselement -- Kontakt" \[sn_ind_tmt_orm_order_line_item_contact\]. Datentyp: Zeichenfolge | | productOrderItem.product.relatedPartei.lastName | Nachname des Kontakts Datentyp: Zeichenfolge Datentyp: Zeichenfolge | | productOrderItem.product.relatedParty.phone | Geschäftliche Telefonnummer des Kontakts Datentyp: Zeichenfolge | | „productOrderItem.product.relatedPartei.@referredType" | Typ des Kunden Möglicher Wert: OrderLineItemContact Datentyp: Zeichenfolge | | productOrderItem.product.relatedPartei.@type | Teil des TMF Open API-Standards. Anmerkung für den Kontakt des Bestellpositionselements. Dieser Wert ist immer RelatedParty. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | | ProduktBestellelement.Produktangebot | Beschreibung des Produktangebots, das dem Produkt zugeordnet ist. Datentyp: Objekt "productOffering": { "id": "String", "internalVersion": "String", "name": "String", "version": "String" } | | productOrderItem.productOffering.id | Initial_version oder external_id des Produktangebots. initial_version ist die sys_id der ersten Version des Angebots. Zu finden im Feld „sys_id" oder „external_id" der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge | | productOrderItem.productOffering.name | Name des Produktangebots Befindet sich in der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge | | Produktbestellungselement.Menge | Anzahl der gekauften Produktartikel. Datentyp: Zahl | | Produktbestellungselement.ProduktbestellungselementBeziehung | Array von Objekten, die die Beziehungen zwischen Bestellpositionen beschreiben. Datentyp: Array "productOrderItemRelationship": [ { "id": "String", "relationshipType": "String" } ] | | productOrderItem.productOrderItemRelationship.id | Eindeutiger Bezeichner des zugehörigen Einzelpostens. Zu finden im Feld sn_ind_tmt_orm_external_id der Tabelle „Auftragspositionselement" \[sn_ind_tmt_orm_order_line_item\]. Datentyp: Zeichenfolge | | „productOrderItem.productOrderItemRelationship.relationshipType" | Typ der Beziehung zwischen den beiden Einzelposten. Diese Informationen werden verwendet, um die Beziehungshierarchie zu identifizieren. Mögliche Werte: * HasChild * Hat übergeordnet * Erfordert {#tmf_prod_order-GET-productorder__ul_yqf_2ty_54b} `„HasChild"` und `„HasParent"` werden für Beziehungen zwischen über- und untergeordneten Elementen verwendet. „`Erfordert` " wird für horizontale Beziehungen verwendet (ein Einzelposten erfordert einen anderen Einzelposten). Datentyp: Zeichenfolge | | „productOrderItem.state" | Status der Reihenfolge des zugeordneten Produktelements. Datentyp: Zeichenfolge | | ProduktBestellelement.Version | Bestellversion. Datentyp: Zeichenfolge | | produktBestellelement.@type | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer ProductOrderItem. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | | Zugehörige Partei | Liste der Kontakte für den Auftrag. Jeder Kontakt ist ein Objekt im Array. Muss mindestens ein Element aufführen, das Informationen zu Kunden- oder Verbraucherkonten enthält. Datentyp: Array "relatedParty:" [ { "id": "String", "name": "String", "@referredType": "String", "@type": "String" } ] | | relatedParty.id | Sys_id oder external_id des Accounts, Kundenkontakts oder Verbrauchers, der dem Auftrag zugeordnet ist. Zu finden in der Tabelle „Account" \[customer_account\], „Kontakt" \[customer_contact\] oder „Verbraucher" \[csm_consumer\]. Datentyp: Zeichenfolge | | relatedParty.name | Name des Accounts, Kunden oder Verbrauchers. Datentyp: Zeichenfolge | | zugehörigepartei.@referenztyp | Typ des Kunden Mögliche Werte: * Verbraucher * Kunde * Kundenkontakt {#tmf_prod_order-GET-productorder__ul_lcq_jwm_t4b} Datentyp: Zeichenfolge | | zugehörigepartei.@typ | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer RelatedParty. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | | RequestedCompletionDate | Vom Kunden angefordertes Lieferdatum Datentyp: Zeichenfolge | | Angefordertes Startdatum | Vom Kunden angefordertes Auftragsstartdatum. Datentyp: Zeichenfolge | | Staat | Aktueller Status des Auftrags. Datentyp: Zeichenfolge | | Version | Bestellversion. Datentyp: Zeichenfolge | | @type | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer ProductOrder. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | [ ] {#tmf_prod_order-GET-productorder__table_inf_kxr_nsb} ### cURL-Anforderung In diesem Beispiel werden alle Produktbestellungen abgerufen. curl --location --request GET 'https://instance.servicenow.com/api/sn_ind_tmt_orm/productorder' \ --user 'username':'password' Antworttext. [ { "id": "8d75939453126010a795ddeeff7b126a", "ponr": "false", "expectedCompletionDate": "2021-05-02T08:13:59.000Z", "requestedCompletionDate": "2021-05-02T08:13:59.000Z", "requestedStartDate": "2020-05-03T08:13:59.000Z", "channel": [ { "id": "1", "name": "Agent Assist" } ], "note": [ { "author": "System Administrator", "date": "2021-02-25T14:22:07.000Z", "text": "This is a TMF product order illustration no 2" }, { "author": "System Administrator", "date": "2021-02-25T14:22:06.000Z", "text": "This is a TMF product order illustration" } ], "productOrderItem": [ { "id": "POI130", "ponr": "false", "quantity": 1, "action": "add", "actionReason": "adding service package OLI", "itemPrice": [ { "priceType": "recurring", "price": { "taxIncludedAmount": { "unit": "USD", "value": 20 } } }, { "priceType": "nonRecurring", "price": { "taxIncludedAmount": { "unit": "INR", "value": 0 } } } ], "product": { "@type": "Product", "productCharacteristic": [ { "name": "Security Type", "valueType": "Choice", "value": "Base", "previousValue": "" } ], "productSpecification": { "id": "a6514bd3534560102f18ddeeff7b1247", "name": "SD-WAN Security", "@type": "ProductSpecificationRef" }, "relatedParty": [ { "id": "4175939453126010a795ddeeff7b127d", "name": "John Smith", "email": "abc2@example.com", "phone": "32456768", "@type": "RelatedParty", "@referredType": "OrderLineItemContact" }, { "id": "c175939453126010a795ddeeff7b127c", "name": "Joe Doe", "email": "abc@example.com", "phone": "1234567890", "@type": "RelatedParty", "@referredType": "OrderLineItemContact" } ] }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering" }, "productOrderItemRelationship": [ { "id": "POI100", "relationshipType": "HasParent" } ], "state": "in_progress", "version": "1", "@type": "ProductOrderItem" }, { "id": "POI100", "ponr": "false", "quantity": 1, "action": "add", "itemPrice": [ { "priceType": "recurring", "price": { "taxIncludedAmount": { "unit": "INR", "value": 0 } } }, { "priceType": "nonRecurring", "price": { "taxIncludedAmount": { "unit": "INR", "value": 0 } } } ], "product": { "@type": "Product", "productSpecification": { "id": "cfe5ef6a53702010cd6dddeeff7b12f6", "name": "SD-WAN Service Package", "@type": "ProductSpecificationRef" } }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering" }, "productOrderItemRelationship": [ { "id": "POI130", "relationshipType": "HasChild" }, { "id": "POI120", "relationshipType": "HasChild" }, { "id": "POI110", "relationshipType": "HasChild" } ], "state": "in_progress", "version": "1", "@type": "ProductOrderItem" }, { "id": "POI120", "ponr": "false", "quantity": 1, "action": "add", "actionReason":"adding service package OLI", "itemPrice": [ { "priceType": "recurring", "price": { "taxIncludedAmount": { "unit": "USD", "value": 20 } } }, { "priceType": "nonRecurring", "price": { "taxIncludedAmount": { "unit": "INR", "value": 0 } } } ], "product": { "@type": "Product", "productCharacteristic": [ { "name": "CPE Type", "valueType": "Choice", "value": "Physical", "previousValue": "" }, { "name": "WAN Optimization", "valueType": "Choice", "value": "Advance", "previousValue": "" }, { "name": "Routing", "valueType": "Choice", "value": "Premium", "previousValue": "" }, { "name": "CPE Model", "valueType": "Choice", "value": "ASR", "previousValue": "" } ], "productSpecification": { "id": "39b627aa53702010cd6dddeeff7b1202", "name": "SD-WAN Edge Device", "@type": "ProductSpecificationRef" } }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering" }, "productOrderItemRelationship": [ { "id": "POI100", "relationshipType": "HasParent" } ], "state": "in_progress", "version": "1", "@type": "ProductOrderItem" }, { "id": "POI110", "ponr": "false", "quantity": 1, "action": "add", "actionReason": "adding service package OLI", "itemPrice": [ { "priceType": "recurring", "price": { "taxIncludedAmount": { "unit": "INR", "value": 0 } } }, { "priceType": "nonRecurring", "price": { "taxIncludedAmount": { "unit": "USD", "value": 5 } } } ], "product": { "@type": "Product", "productCharacteristic": [ { "name": "Tenancy", "valueType": "Choice", "value": "Base (10 site)", "previousValue": "" } ], "productSpecification": { "id": "216663aa53702010cd6dddeeff7b12b5", "name": "SD-WAN Controller", "@type": "ProductSpecificationRef" }, "place": { "id": "25ab9c4d0a0a0bb300f7dabdc0ca7c1c", "@type": "Place" } }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering" }, "productOrderItemRelationship": [ { "id": "POI100", "relationshipType": "HasParent" } ], "state": "in_progress", "version": "1", "@type": "ProductOrderItem" } ], "relatedParty": [ { "id": "eaf68911c35420105252716b7d40ddde", "name": "Sally Thomas", "@type": "RelatedParty", "@referredType": "CustomerContact" }, { "id": "ffc68911c35420105252716b7d40dd55", "name": "Funco Intl", "@type": "RelatedParty", "@referredType": "Customer" }, { "id": "59f16de1c3b67110ff00ed23a140dd9e", "name": "Funco External", "@type": "RelatedParty", "@referredType": "Consumer" } ], "state": "in_progress", "version": "1", "@type": "ProductOrder" } ] ## Offene API für Produktbestellung -- GET /sn_ind_tmt_orm/productorder/{id} {#ariaid-title5} Ruft die angegebene Produktbestellung ab. Wichtig: Ab Release Tokyo ist dieser Endpunkt veraltet. Die neue Version dieses Endpunkts ist [Offene API für Produktbestellung -- GET /sn_ind_tmt_orm/order/productOrder/{id}](https://www.servicenow.com/docs/Ae5XqErKGgN46FHZcSkOdg#tmf_prod_order-GET-ord-productOrder-id "Ruft die angegebene Produktbestellung ab."). Dieser Endpunkt ruft Bestellinformationen aus den folgenden Tabellen ab: * Kundenbestellung \[sn_ind_tmt_orm_order\] * Bestellmerkmal \[sn_ind_tmt_orm_order_characterist_value\] * Bestellposition \[sn_ind_tmt_orm_order_line_item\] * Auftragspositionselement -- Kontakt \[sn_ind_tmt_orm_order_line_item_contact\] {#tmf_prod_order-GET-productOrder-id__ul_lxc_kxm_t4b} ### URL-Format {#tmf_prod_order-GET-productOrder-id__section_mbm_2ct_t4b} Standard-URL: /api/sn_ind_tmt_orm/productorder/{id} ### Unterstützte Anforderungsparameter {#tmf_prod_order-GET-productOrder-id__entry__2} | Name | Beschreibung | |-|-| | id | Sys_id oder external_id des abzurufenden Kundenauftrags. Befindet sich in der Tabelle „Kundenauftrag" \[sn_ind_tmt_orm_order\]. Datentyp: Zeichenfolge | [Tabelle : 19. Pfadparameter] {#tmf_prod_order-GET-productOrder-id__entry__6} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 20. Abfrageparameter] {#tmf_prod_order-GET-productOrder-id__entry__10} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 21. Parameter des Anforderungstexts (JSON)] ### Kopfzeilen Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST API verwendet werden, finden Sie unter [Unterstützte REST API-Header](https://www.servicenow.com/docs/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können."). {#tmf_prod_order-GET-productOrder-id__table_kqy_wgy_fsb__entry__2} | Kopfzeile | Beschreibung | |-|-| | Keine | | [Tabelle : 22. Anforderungskopfzeilen] {#tmf_prod_order-GET-productOrder-id__table_kqy_wgy_fsb} {#tmf_prod_order-GET-productOrder-id__table_tzy_thy_ksb__entry__2} | Kopfzeile | Beschreibung | |-|-| | Inhaltstyp | Datenformat des Antworttexts. Unterstützt nur application/json. | [Tabelle : 23. Antwortkopfzeilen] {#tmf_prod_order-GET-productOrder-id__table_tzy_thy_ksb} ### Statuscodes Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST API verwendet werden, finden Sie unter [HTTP-Antwortcodes](https://www.servicenow.com/docs/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API. {#tmf_prod_order-GET-productOrder-id__entry__22}{#tmf_prod_order-GET-productOrder-id__entry-404-status-code} | Statuscode | Beschreibung | |-|-| | 201 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. | | 400 | Ungültige Anforderung. Kann einen der folgenden Gründe haben: * Fehlender Abfrageparameter * Ungültiger URI | | 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. | [Tabelle : 24. Statuscodes] ### Parameter des Antwort-Haupttexts (JSON) {#tmf_prod_order-GET-productOrder-id__entry__30} | Name | Beschreibung | |-|-| | channel | Array von Objekten, die die Kanäle beschreiben, die für den Verkauf der Produkte verwendet werden sollen Datentyp: Array "channel": [ { "id": "String", "name": "String" } ] | | channel.id | Eindeutiger Bezeichner des Kanals, der für den Verkauf der zugehörigen Produkte verwendet werden soll. Kanal-ID-Werte befinden sich im Feld „external_id" der Tabelle „Verteilungskanal" \[sn_prd_pm_distribution_channel\]. Datentyp: Zeichenfolge | | Kanalname | Name des Kanals, der für den Verkauf der zugehörigen Produkte verwendet werden soll. Datentyp: Zeichenfolge | | erwartetesAbschlussdatum | Datum, an dem der Auftrag abgeschlossen wird. Datentyp: Zeichenfolge | | Hinweis | Array von Objekten, die zusätzliche Notizen beschreiben, die der Kunde bei der Bestellung gemacht hat. Datentyp: Array "note": { "author": "String", "date": "String", "text": "String" } | | Anmerkung.Autor | Anwendername der Person, die den zugehörigen Hinweis verfasst hat. Datentyp: Zeichenfolge | | Notiz.Datum | Datum, an dem die Notiz erstellt wurde. Datentyp: Zeichenfolge | | Anmerkung.Text | Zusätzliche Hinweise/Kommentare vom Kunden während der Bestellung. Datentyp: Zeichenfolge | | ponr | Kennzeichnung, die angibt, ob der Punkt ohne Rückkehr für den Auftrag erreicht wurde. Gültige Werte: * wahr: Der Punkt ohne Rückkehr für den Auftrag wurde erreicht. * „falsch": Der Punkt ohne Rückkehr für den Auftrag wurde nicht erreicht. {#tmf_prod_order-GET-productOrder-id__ul_tdq_rw1_hqb} Datentyp: Boolesch | | productOrderItem | Liste, die die der Produktbestellung zugeordneten Elemente und die zugehörige Aktion beschreibt. Datentyp: Array "productOrderItem:" [ { "action": "String", "actionReason": "String", "id": "String", "itemPrice": [Array], "product": {Object}, "productOffering": {Object}, "productOrderItemReleationship": [Array], "quantity": Number, "state": "String", "@type": "String" } ] | | productOrderItem.action | Aktion, die für das Produkt ausgeführt werden soll. Mögliche Aktionen sind auf der Registerkarte „Auswahlliste" im Aktionswörterbucheintrag der Tabelle sn_ind_tmt_orm_order_line_item definiert. Datentyp: Zeichenfolge | | „productOrderItem.actionReason" | Der Grund für das Hinzufügen der Auftragsposition. Datentyp: Zeichenfolge Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item/action_reason | | productOrderItem.id | Eindeutiger Bezeichner der Position. Zu finden im Feld sn_ind_tmt_orm_external_id der Tabelle „Auftragspositionselement" \[sn_ind_tmt_orm_order_line_item\]. Datentyp: Zeichenfolge | | Produktbestellungselement.Artikelpreis | Array von Objekten, die den dem Produkt zugeordneten Preis beschreiben Datentyp: Array "itemPrice": [ { "price": {Object}, "priceType": "String", "recurringChargePeriod": "String" } ] | | Produktbestellungselement.Artikelpreis.Preis | Beschreibung des Preises des zugeordneten Produkts. Datentyp: Objekt "price": { "taxIncludedAmount": {Object} } | | „productOrderItem.itemPrice.Preis.SteuerEnthalteneBetrag" | Beschreibung des Preises des zugehörigen Produkts, einschließlich Steuer. Datentyp: Objekt "taxIncludedAmount": { "unit": "String", "value": Number } | | ProduktAuftragselement.Elementpreis.Preis.SteuerEnthaltenerBetrag.Einheit | Währungscode, in dem der Preis dargestellt wird. Datentyp: Zeichenfolge | | ProduktAuftragselement.Elementpreis.Preis.SteuerEnthaltenerBetrag.Wert | Preis des Produkts, einschließlich Steuern. Datentyp: Zahl | | „productOrderItem.itemPrice.PriceType" | Typ des Artikelpreises, wiederkehrend oder nicht wiederkehrend. Datentyp: Zeichenfolge | | „productOrderItem.itemPrice.recurringChargePeriod" | Wenn der Preis wiederkehrend ist, der wiederkehrende Zeitraum, z. B. Monat. Datentyp: Zeichenfolge | | productOrderItem.ponr | Kennzeichnung, die angibt, ob der Punkt ohne Rückkehr für den Auftrag erreicht wurde. Gültige Werte: * wahr: Der Punkt ohne Rückkehr für den Auftrag wurde erreicht. * „falsch": Der Punkt ohne Rückkehr für den Auftrag wurde nicht erreicht. {#tmf_prod_order-GET-productOrder-id__d2876e2599} Datentyp: Boolesch | | ProduktBestellelement.Produkt | Beschreibung der Instanzdetails des vom Kunden erworbenen Produkts. Datentyp: Objekt "product:" { "place": {Object}, "productCharacteristic": [Array], "productSpecification": {Object}, "relatedParty": {Object}, "@type": "String" } | | productOrderItem.product.place | Karten der Speicherorte, an denen das Produkt installiert werden soll. Datentyp: Objekt "place": { "id": "String", "@type": "String" } | | productOrderItem.product.place.id | Sys_id des zugeordneten Standortdatensatzes in der Standorttabelle \[cmn_location\]. Datentyp: Zeichenfolge | | productOrderItem.product.place.@type | Teil des TMF Open API-Standards. Anmerkung für den Kontakt des Bestellpositionselements. Dieser Wert ist immer Place. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | | productOrderItem.product.productMerkmal | Array von Objekten, die die Eigenschaften des zugeordneten Produkts beschreiben. Es werden nur Produktmerkmale zurückgegeben, deren value sich von den previousValue unterscheiden. Datentyp: Array "productCharacteristic": [ { "name": "String", "previousValue": "String", "value": "String" } ] | | productOrderItem.product.productCharacteristic.name | Name des Merkmaldatensatzes, der dem Produkt zugeordnet werden soll. Befindet sich in der Tabelle „Merkmal" \[sn_prd_pm_charakteristik\]. Datentyp: Zeichenfolge | | „productOrderItem.product.productFeature. previousValue" | Vorherige Merkmalsoptionswerte, wenn die Aktualisierung für einen Change-Auftrag erfolgt. Die Anforderung ist ein Change, wenn der Parameter productOrderItem.action etwas anderes als addist. Weitere Informationen zu Merkmalsoptionswerten finden Sie unter [Create product characteristics and characteristic options](https://www.servicenow.com/docs/access?context=som-product-config-add-characteristics&version=xanadu&pubname=xanadu-order-management&ft:locale=en-US). Datentyp: Zeichenfolge | | productOrderItem.product.productMerkmal.Wert | Merkmaloptionswerte, die dem Produkt zugeordnet sind. Weitere Informationen zu Merkmalsoptionswerten finden Sie unter [Create product characteristics and characteristic options](https://www.servicenow.com/docs/access?context=som-product-config-add-characteristics&version=xanadu&pubname=xanadu-order-management&ft:locale=en-US). Datentyp: Zeichenfolge | | productOrderItem.product.productSpecification | Beschreibung der Produktspezifikation, die dem Produkt zugeordnet ist. Datentyp: Objekt "productSpecification:" { "id": "String", "name": "String", "@type": "String" } | | productOrderItem.product.productSpecification.id | Initial_version oder external_id der Produktspezifikation. initial_version ist die sys_id der ersten Version der Spezifikation. Befindet sich im Feld „sys_id" oder „external_id" der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. Datentyp: Zeichenfolge | | productOrderItem.product.productSpecification.name | Name der Produktspezifikation. Befindet sich in der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. Datentyp: Zeichenfolge | | productOrderItem.product.productSpecification.@type | Teil des TMF Open API-Standards. Dieser Wert ist immer ProductSpecificationRef. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | | Bestellelement.Produkt.zugehörigePartei | Liste der Kontakte für Positionen. Datentyp: Array "relatedParty:" { "email": "String", "firstName": "String", "id": "String", "lastName": "String", "phone": "String", "@referredType": "String", "@type": "String" } | | productOrderItem.product.relatedParty.email | E-Mail-Adresse des Kontakts Datentyp: Zeichenfolge | | Bestellelement.Produkt.zugehörigePartei.ersterName | Vorname des Kontakts Datentyp: Zeichenfolge | | productOrderItem.product.relatedParty.id | Sys_id des Einzelpostenkontakts, der der Auftragsposition zugeordnet ist. Befindet sich in der Tabelle „Auftragspositionselement -- Kontakt" \[sn_ind_tmt_orm_order_line_item_contact\]. Datentyp: Zeichenfolge | | productOrderItem.product.relatedPartei.lastName | Nachname des Kontakts Datentyp: Zeichenfolge | | productOrderItem.product.relatedParty.phone | Geschäftliche Telefonnummer des Kontakts Datentyp: Zeichenfolge | | „productOrderItem.product.relatedPartei.@referredType" | Typ des Kunden Möglicher Wert: OrderLineItemContact Datentyp: Zeichenfolge | | productOrderItem.product.relatedPartei.@type | Teil des TMF Open API-Standards. Anmerkung für den Kontakt des Bestellpositionselements. Dieser Wert ist immer RelatedParty. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | | ProduktBestellelement.Produktangebot | Beschreibung des Produktangebots, das dem Produkt zugeordnet ist. Datentyp: Objekt "productOffering": { "id": "String", "internalVersion": "String", "name": "String", "version": "String" } | | productOrderItem.productOffering.id | Initial_version oder external_id des Produktangebots. initial_version ist die sys_id der ersten Version des Angebots. Zu finden im Feld „sys_id" oder „external_id" der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge | | productOrderItem.productOffering.name | Name des Produktangebots Befindet sich in der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge | | Produktbestellungselement.Menge | Anzahl der gekauften Produktartikel. Datentyp: Zahl | | Produktbestellungselement.ProduktbestellungselementBeziehung | Array von Objekten, die die Beziehungen zwischen Bestellpositionen beschreiben. Datentyp: Array "productOrderItemRelationship": [ { "id": "String", "relationshipType": "String" } ] | | productOrderItem.productOrderItemRelationship.id | Eindeutiger Bezeichner des zugehörigen Einzelpostens. Zu finden im Feld sn_ind_tmt_orm_external_id der Tabelle „Auftragspositionselement" \[sn_ind_tmt_orm_order_line_item\]. Datentyp: Zeichenfolge | | „productOrderItem.productOrderItemRelationship.relationshipType" | Typ der Beziehung zwischen den beiden Einzelposten. Diese Informationen werden verwendet, um die Beziehungshierarchie zu identifizieren. Mögliche Werte: * HasChild * Hat übergeordnet * Erfordert {#tmf_prod_order-GET-productOrder-id__ul_yqf_2ty_54b} `„HasChild"` und `„HasParent"` werden für Beziehungen zwischen über- und untergeordneten Elementen verwendet. „`Erfordert` " wird für horizontale Beziehungen verwendet (ein Einzelposten erfordert einen anderen Einzelposten). Datentyp: Zeichenfolge | | „productOrderItem.state" | Status der Reihenfolge des zugeordneten Produktelements. Datentyp: Zeichenfolge | | ProduktBestellelement.Version | Bestellversion. Datentyp: Zeichenfolge | | produktBestellelement.@type | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer ProductOrderItem. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | | Zugehörige Partei | Liste der Kontakte für den Auftrag. Jeder Kontakt ist ein Objekt im Array. Muss mindestens ein Element aufführen, das Informationen zu Kunden- oder Verbraucherkonten enthält. Datentyp: Array "relatedParty:" [ { "id": "String", "name": "String", "@referredType": "String", "@type": "String" } ] | | relatedParty.id | Sys_id oder external_id des Accounts, Kundenkontakts oder Verbrauchers, der dem Auftrag zugeordnet ist. Zu finden in der Tabelle „Account" \[customer_account\], „Kontakt" \[customer_contact\] oder „Verbraucher" \[csm_consumer\]. Datentyp: Zeichenfolge | | relatedParty.name | Name des Accounts, Kunden oder Verbrauchers. Datentyp: Zeichenfolge | | zugehörigepartei.@referenztyp | Typ des Kunden Mögliche Werte: * Verbraucher * Kunde * Kundenkontakt {#tmf_prod_order-GET-productOrder-id__ul_lcq_jwm_t4b} Datentyp: Zeichenfolge | | zugehörigepartei.@typ | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer RelatedParty. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | | RequestedCompletionDate | Vom Kunden angefordertes Lieferdatum Datentyp: Zeichenfolge | | Angefordertes Startdatum | Vom Kunden angefordertes Auftragsstartdatum. Datentyp: Zeichenfolge | | Staat | Aktueller Status des Auftrags. Datentyp: Zeichenfolge | | Version | Bestellversion. Datentyp: Zeichenfolge | | @type | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer ProductOrder. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | [ ] ### cURL-Anforderung Im folgenden Codebeispiel wird ein vorhandener Kundenauftrag angefordert. curl -X GET "https://servicenow-instance/api/sn_ind_tmt_orm/productorder/8d75939453126010a795ddeeff7b126a" \ -u "username":"password" Antworttext. { "id": "8d75939453126010a795ddeeff7b126a", "ponr": "false", "expectedCompletionDate": "2021-05-02T08:13:59.000Z", "requestedCompletionDate": "2021-05-02T08:13:59.000Z", "requestedStartDate": "2020-05-03T08:13:59.000Z", "channel": [ { "id": "1", "name": "Agent Assist" } ], "note": [ { "author": "System Administrator", "date": "2021-02-25T14:22:07.000Z", "text": "This is a TMF product order illustration no 2" }, { "author": "System Administrator", "date": "2021-02-25T14:22:06.000Z", "text": "This is a TMF product order illustration" } ], "productOrderItem": [ { "id": "POI130", "ponr": "false", "quantity": 1, "action": "add", "actionReason":"adding service package OLI", "itemPrice": [ { "priceType": "recurring", "price": { "taxIncludedAmount": { "unit": "USD", "value": 20 } } }, { "priceType": "nonRecurring", "price": { "taxIncludedAmount": { "unit": "INR", "value": 0 } } } ], "product": { "@type": "Product", "productCharacteristic": [ { "name": "Security Type", "valueType": "Choice", "value": "Base", "previousValue": "" } ], "productSpecification": { "id": "a6514bd3534560102f18ddeeff7b1247", "name": "SD-WAN Security", "@type": "ProductSpecificationRef" }, "relatedParty": [ { "id": "4175939453126010a795ddeeff7b127d", "name": "John Smith", "email": "abc2@example.com", "phone": "32456768", "@type": "RelatedParty", "@referredType": "OrderLineItemContact" }, { "id": "c175939453126010a795ddeeff7b127c", "name": "Joe Doe", "email": "abc@example.com", "phone": "1234567890", "@type": "RelatedParty", "@referredType": "OrderLineItemContact" } ] }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering" }, "productOrderItemRelationship": [ { "id": "POI100", "relationshipType": "HasParent" } ], "state": "in_progress", "version": "1", "@type": "ProductOrderItem" }, { "id": "POI100", "ponr": "false", "quantity": 1, "action": "add", "itemPrice": [ { "priceType": "recurring", "price": { "taxIncludedAmount": { "unit": "INR", "value": 0 } } }, { "priceType": "nonRecurring", "price": { "taxIncludedAmount": { "unit": "INR", "value": 0 } } } ], "product": { "@type": "Product", "productSpecification": { "id": "cfe5ef6a53702010cd6dddeeff7b12f6", "name": "SD-WAN Service Package", "@type": "ProductSpecificationRef" } }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering" }, "productOrderItemRelationship": [ { "id": "POI130", "relationshipType": "HasChild" }, { "id": "POI120", "relationshipType": "HasChild" }, { "id": "POI110", "relationshipType": "HasChild" } ], "state": "in_progress", "version": "1", "@type": "ProductOrderItem" }, { "id": "POI120", "ponr": "false", "quantity": 1, "action": "add", "itemPrice": [ { "priceType": "recurring", "price": { "taxIncludedAmount": { "unit": "USD", "value": 20 } } }, { "priceType": "nonRecurring", "price": { "taxIncludedAmount": { "unit": "INR", "value": 0 } } } ], "product": { "@type": "Product", "productCharacteristic": [ { "name": "CPE Type", "valueType": "Choice", "value": "Physical", "previousValue": "" }, { "name": "WAN Optimization", "valueType": "Choice", "value": "Advance", "previousValue": "" }, { "name": "Routing", "valueType": "Choice", "value": "Premium", "previousValue": "" }, { "name": "CPE Model", "valueType": "Choice", "value": "ASR", "previousValue": "" } ], "productSpecification": { "id": "39b627aa53702010cd6dddeeff7b1202", "name": "SD-WAN Edge Device", "@type": "ProductSpecificationRef" } }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering" }, "productOrderItemRelationship": [ { "id": "POI100", "relationshipType": "HasParent" } ], "state": "in_progress", "version": "1", "@type": "ProductOrderItem" }, { "id": "POI110", "ponr": "false", "quantity": 1, "action": "add", "actionReason":"adding service package OLI", "itemPrice": [ { "priceType": "recurring", "price": { "taxIncludedAmount": { "unit": "INR", "value": 0 } } }, { "priceType": "nonRecurring", "price": { "taxIncludedAmount": { "unit": "USD", "value": 5 } } } ], "product": { "@type": "Product", "productCharacteristic": [ { "name": "Tenancy", "valueType": "Choice", "value": "Base (10 site)", "previousValue": "" } ], "productSpecification": { "id": "216663aa53702010cd6dddeeff7b12b5", "name": "SD-WAN Controller", "@type": "ProductSpecificationRef" }, "place": { "id": "25ab9c4d0a0a0bb300f7dabdc0ca7c1c", "@type": "Place" } }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering" }, "productOrderItemRelationship": [ { "id": "POI100", "relationshipType": "HasParent" } ], "state": "in_progress", "version": "1", "@type": "ProductOrderItem" } ], "relatedParty": [ { "id": "eaf68911c35420105252716b7d40ddde", "name": "Sally Thomas", "@type": "RelatedParty", "@referredType": "CustomerContact" }, { "id": "ffc68911c35420105252716b7d40dd55", "name": "Funco Intl", "@type": "RelatedParty", "@referredType": "Customer" }, { "id": "59f16de1c3b67110ff00ed23a140dd9e", "name": "Funco External", "@type": "RelatedParty", "@referredType": "Consumer" } ], "state": "in_progress", "version": "1", "@type": "ProductOrder" } ## Open API für Produktbestellung -- PATCH /sn_ind_tmt_orm/order/productOrder/{id} {#ariaid-title6} Aktualisiert den angegebenen Kundenauftrag. ### URL-Format Standard-URL: /api/sn_ind_tmt_orm/order/productOrder/{id} ### Unterstützte Anforderungsparameter {#tmf_prod_order-PATCH-ord-productOrder-id__entry__2} | Name | Beschreibung | |-|-| | id | Sys_id des zu aktualisierenden Kundenauftrags. Befindet sich in der Tabelle „Kundenauftrag" \[sn_ind_tmt_orm_order\]. Datentyp: Zeichenfolge | [Tabelle : 25. Pfadparameter] {#tmf_prod_order-PATCH-ord-productOrder-id__entry__6} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 26. Abfrageparameter] {#tmf_prod_order-PATCH-ord-productOrder-id__id_vk2_p5n_t4b__entry__2}{#tmf_prod_order-PATCH-ord-productOrder-id__channel-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__channel_id-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__channel_name-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__due-date-PATCH}{#tmf_prod_order-PATCH-ord-productOrder-id__externalId-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__note-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__note_text-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__prodOrdItem-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__prodOrdItem_action-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__prodOrdItem_actionReason-response-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__due-date-item-PATCH}{#tmf_prod_order-PATCH-ord-productOrder-id__externalProdInv-descr-PATCH}{#tmf_prod_order-PATCH-ord-productOrder-id__externalProdInvId-decsr}{#tmf_prod_order-PATCH-ord-productOrder-id__prodOrdItem_id-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__itemPrice-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__itemPrice_price-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__itemPrice_price_taxIncludedAmt-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__itemPrice_price_taxIncludedAmt_unit-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__itemPrice_price_taxIncludedAmt_value-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__itemPrice_priceType_data_type-p-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__itemPrice_recurringChargePeriod_data_type-p-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__product-p-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__product_id-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__product_place-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__product_place_id-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__product_place_type_data_type-p-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__prod_prodChar-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__prod_prodChar_name-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__prod_prodChar_previousValue-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__prod_prodChar_value-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__prod_prodSpec-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__prod_prodSpec_id_data_type-p-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__prod_prodSpec_name_data_type-p-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__prod_prodSpec_type_data_type-p-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__prod_relParty-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__prod_relParty_email-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__prod_relParty_firstName-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__prod_relParty_id-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__prod_relParty_lastName-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__prod_relParty_phone-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__prod_relParty_refType_data_type-p-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__product_relatedParty_type_data_type-row-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__product_type_data_type-p-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__productOffer-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__prodOffer_id_data_type-p-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__prodOffer_name_data_type-p-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__prodOrdItem_quantity-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__prodOrderItemRel-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__prodOrderItemRel_id-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__prodOrderItemRel_relType_data_type-p-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__prodOrdItem_type-entry-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__relatedParty-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__relatedParty_id_data_type-p-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__relatedParty_name_data_type-p-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__relatedParty_refType_data_type-p-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__relatedParty_type_data_type-p-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__requestedCompletionDate-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__reqStartDate-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__type-entry-tmf622} | Name | Beschreibung | |-|-| | channel | Array von Objekten, die die Kanäle beschreiben, die für den Verkauf der Produkte verwendet werden sollen Datentyp: Array{#tmf_prod_order-PATCH-ord-productOrder-id__channel_data_type-p-tmf622} "channel": [ { "id": "String", "name": "String" } ] {#tmf_prod_order-PATCH-ord-productOrder-id__channel_obj_def-codeblock-tmf622} Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order | | channel.id | Erforderlich, wenn der Parameter channel verwendet wird. Eindeutiger Bezeichner des Kanals, der für den Verkauf der zugehörigen Produkte verwendet werden soll. Kanal-ID-Werte befinden sich im Feld „external_id" der Tabelle „Verteilungskanal" \[sn_prd_pm_distribution_channel\]. Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-ord-productOrder-id__channel_id_data_type-p-tmf622} Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order/channel Standard: Leere Zeichenfolge | | Kanalname | Name des Kanals, der für den Verkauf der zugehörigen Produkte verwendet werden soll. Mögliche Kanalnamen sind auf der Registerkarte „Auswahlliste" im Wörterbucheintrag „Kanal" der Tabelle „sn_ind_tmt_orm_order" definiert. Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-ord-productOrder-id__channel_name_data_type-p-tmf622} Standard: Leere Zeichenfolge | | committedDueDate | Datum und Uhrzeit, zu der die Aktion für den Auftrag ausgeführt werden muss. Dieser Wert muss mit den committedDueDate -Werten für jede Bestellposition übereinstimmen oder später als diese sein. Wenn die Aktion für Auftragspositionen „ aussetzen " oder „ fortsetzen" ist, kann dieser Parameter nicht aktualisiert werden. Datentyp: Zeichenfolge Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order/committed_due_date | | externalId | Eindeutiger Bezeichner für den Kundenauftrag. Dieser Wert wird von einem externen System bestimmt. Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-ord-productOrder-id__externalId_data_type-p-tmf622} Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order/external_id Standard: Leere Zeichenfolge | | Hinweis | Array von Objekten, die zusätzliche Notizen beschreiben, die der Kunde bei der Bestellung gemacht hat. Datentyp: Array{#tmf_prod_order-PATCH-ord-productOrder-id__note_data_type-p-tmf622} "note": [ { "text": "String" } ] {#tmf_prod_order-PATCH-ord-productOrder-id__note-codeblock-tmf622} Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order | | Anmerkung.Text | Zusätzliche Hinweise/Kommentare vom Kunden während der Bestellung. Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-ord-productOrder-id__note_text_data_type-p-tmf622} Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order/comments Standard: Leere Zeichenfolge | | orderCurrency | Währungscode für den Auftrag und die Bestellpositionen. Das Aktualisieren des Währungscodes eines vorhandenen Auftrags wird nicht unterstützt. Wenn Sie einen anderen Wert als den Währungscode angeben, der dem Auftrag bereits zugeordnet ist, wird die Aktualisierung abgelehnt. Datentyp: Zeichenfolge | | productOrderItem | Liste, die die der Produktbestellung zugeordneten Elemente und die zugehörige Aktion beschreibt. Datentyp: Array{#tmf_prod_order-PATCH-ord-productOrder-id__prodOrdItem_data_type-p-tmf622} "productOrderItem": [ { "action": "String", "actionReason": "String", "committedDueDate": "String", "externalProductInventory": [Array], "id": "String", "itemPrice": [Array], "product": {Object}, "productOffering": {Object}, "productOrderItemRelationship": [Array], "quantity": Number, "revisionOperation": "String", "@type": "String" } ] {#tmf_prod_order-PATCH-ord-productOrder-id__prodOrdItem-codeblock-tmf622} Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item | | productOrderItem.action | Erforderlich, wenn der Parameter productOrderItem verwendet wird. Aktion, die für das Produkt ausgeführt werden soll. Mögliche Aktionen sind auf der Registerkarte „Auswahlliste" im Aktionswörterbucheintrag der Tabelle sn_ind_tmt_orm_order_line_item definiert. Mögliche Werte: * Hinzufügen * Change * delete * kein Change * resume * anhalten {#tmf_prod_order-PATCH-ord-productOrder-id__ul_zwn_nxp_ysb} Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-ord-productOrder-id__prodOrdItem_action_data_type-p-tmf622} Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item/action Standard: add | | „productOrderItem.actionReason" | Der Grund für das Hinzufügen der Auftragsposition. Datentyp: Zeichenfolge Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item/action_reason | | produktbestellelement.committedFälligkeitsdatum | Datum und Uhrzeit, zu der die Aktion für die Auftragsposition ausgeführt werden muss. Wenn die Aktion für das Element „ unterbrechen " oder „ fortsetzen" lautet, kann dieser Parameter nicht aktualisiert werden. Datentyp: Zeichenfolge Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item/committed_due_date | | Bestellelement.externerProduktbestand | Array von Objekten mit externen IDs für die Zuordnung zu den für den Auftrag erstellten Produktbeständen. Datentyp: Array "externalProductInventory": [ { "externalProductInventoryId": "String" } ] Hinweis: Zuvor wurde beim Erstellen eines PATCH-Auftrags mit einer bereits vorhandenen externen Produktbestands-ID der Vorgang abgebrochen und ein Fehler zurückgegeben. Mit dem Release Xanadu wird dieser Parameter einfach ignoriert, wenn eine vorhandene externe Produktbestands-ID angegeben und kein Fehler ausgegeben wird. | | Bestellelement.externalProductInventory.externalProductInventoryId | Externe ID, die dem Produktbestand zugeordnet werden soll. Datentyp: Zeichenfolge Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item/external_inventory_id und sn_prd_invt_product_inventory/sn_prd_invt_external_id | | productOrderItem.id | Erforderlich, wenn der Parameter productOrderItem verwendet wird. Eindeutiger Bezeichner der Position. Zu finden im Feld sn_ind_tmt_orm_external_id der Tabelle „Auftragspositionselement" \[sn_ind_tmt_orm_order_line_item\]. Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-ord-productOrder-id__prodOrdItem_id_data_type-p-tmf622} Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item/external_id Maximale Länge: 40 Standard: Leere Zeichenfolge | | Produktbestellungselement.Artikelpreis | Array von Objekten, die den dem Produkt zugeordneten Preis beschreiben Datentyp: Array{#tmf_prod_order-PATCH-ord-productOrder-id__itemPrice_data_type-p-tmf622} "itemPrice": [ { "price": {Object}, "priceType": "String", "recurringChargePeriod": "String" } ] {#tmf_prod_order-PATCH-ord-productOrder-id__itemPrice-codeblock-tmf622} Tabelle aktualisiert: sn_ind_tmt_orm_order Standard: Leere Zeichenfolge | | Produktbestellungselement.Artikelpreis.Preis | Beschreibung des Preises des zugeordneten Produkts. Datentyp: Objekt{#tmf_prod_order-PATCH-ord-productOrder-id__itemPrice_price_data_type-p-tmf622} "price": { "taxIncludedAmount": {Object} } {#tmf_prod_order-PATCH-ord-productOrder-id__itemPrice_price-codeblock-tmf622} Tabelle aktualisiert: sn_ind_tmt_orm_order_line_item Standard: Leere Zeichenfolge | | „productOrderItem.itemPrice.Preis.SteuerEnthalteneBetrag" | Beschreibung des Preises des zugehörigen Produkts, einschließlich Steuer. Datentyp: Objekt{#tmf_prod_order-PATCH-ord-productOrder-id__itemPrice_price_taxIncludedAmt_data_type-p-tmf622} "taxIncludedAmount": { "unit": "String", "value": Number } {#tmf_prod_order-PATCH-ord-productOrder-id__itemPrice_price_taxIncludedAmt-codeblock-tmf622} Tabelle aktualisiert: sn_ind_tmt_orm_order_line_item | | ProduktAuftragselement.Elementpreis.Preis.SteuerEnthaltenerBetrag.Einheit | Währungscode, in dem der Preis dargestellt wird. Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-ord-productOrder-id__itemPrice_price_taxIncludedAmt_unit_data_type-p-tmf622} Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item/mrc oder nrc | | ProduktAuftragselement.Elementpreis.Preis.SteuerEnthaltenerBetrag.Wert | Preis des Produkts, einschließlich Steuern. Datentyp: Zahl{#tmf_prod_order-PATCH-ord-productOrder-id__itemPrice_price_taxIncludedAmt_value_data_type-p-tmf622} Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item/mrc oder nrc | | „productOrderItem.itemPrice.PriceType" | Typ des Artikelpreises, wiederkehrend oder nicht wiederkehrend. Datentyp: Zeichenfolge | | „productOrderItem.itemPrice.recurringChargePeriod" | Wenn der Preis wiederkehrend ist, der wiederkehrende Zeitraum, z. B. Monat. Datentyp: Zeichenfolge | | ProduktBestellelement.Produkt | Erforderlich, wenn productOrderItem.action „ ändern" oder „löschen" ist. Beschreibung der Instanzdetails des vom Kunden erworbenen Produkts. Datentyp: Objekt{#tmf_prod_order-PATCH-ord-productOrder-id__product_data_type-p-tmf622} "product": { "id": "String", "place": {Object}, "productCharacteristic": [Array], "productSpecification": {Object}, "relatedParty": {Object}, "@type": "String" } {#tmf_prod_order-PATCH-ord-productOrder-id__product-codeblock-tmf622} Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item | | productOrderItem.product.id | Erforderlich, wenn productOrderItem.action „ ändern" oder „löschen" ist. Eindeutiger Bezeichner des verkauften Produkts. Befindet sich im Feld „sys_id" oder „sn_ind_tmt_orm_external_id" der Tabelle „Produktbestand" \[sn_ind_tmt_orm_product_inventory\]. Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-ord-productOrder-id__product_id_data_type-p-tmf622} Standard: Leere Zeichenfolge | | productOrderItem.product.place | Karten der Speicherorte, an denen das Produkt installiert werden soll. Datentyp: Objekt{#tmf_prod_order-PATCH-ord-productOrder-id__product_place_data_type-p-tmf622} "place": { "id": "String", "@type": "String" } {#tmf_prod_order-PATCH-ord-productOrder-id__product_place-codeblock-tmf622} Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item | | productOrderItem.product.place.id | Erforderlich, wenn der Parameter productOrderItem.product.place verwendet wird. Sys_id des zugeordneten Standortdatensatzes in der Standorttabelle \[cmn_location\]. Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-ord-productOrder-id__product_place_id_data_type-p-tmf622} Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item/location Standard: Leere Zeichenfolge | | productOrderItem.product.place.@type | Teil des TMF Open API-Standards. Anmerkung für den Kontakt des Bestellpositionselements. Dieser Wert ist immer Place. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | | productOrderItem.product.productMerkmal | Array von Objekten, die die Eigenschaften des zugeordneten Produkts beschreiben. Datentyp: Array{#tmf_prod_order-PATCH-ord-productOrder-id__prod_prodChar_data_type-p-tmf622} "productCharacteristic": [ { "name": "String", "previousValue": "String", "value": "String" } ] {#tmf_prod_order-PATCH-ord-productOrder-id__prod_prodChar-codeblock-tmf622} Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_characterist_value | | productOrderItem.product.productMerkmal.name | Name des Merkmaldatensatzes, der dem Produkt zugeordnet werden soll. Befindet sich in der Tabelle „Merkmal" \[sn_prd_pm_charakteristik\]. Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-ord-productOrder-id__prod_prodChar_name_data_type-p-tmf622} Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_charakterist_wert/merkmale Standard: Leere Zeichenfolge | | „productOrderItem.product.productFeature. previousValue" | Vorherige Merkmalsoptionswerte, wenn die Aktualisierung für einen Change-Auftrag erfolgt. Die Anforderung ist ein Change, wenn der Parameter productOrderItem.action etwas anderes als addist. Weitere Informationen zu Merkmalsoptionswerten finden Sie unter [Create product characteristics and characteristic options](https://www.servicenow.com/docs/access?context=som-product-config-add-characteristics&version=xanadu&pubname=xanadu-order-management&ft:locale=en-US). Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-ord-productOrder-id__prod_prodChar_previousValue_data_type-p-tmf622} Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_charakterist_wert/vorherige_charakterist_option_wert Standard: Leere Zeichenfolge | | productOrderItem.product.productMerkmal.Wert | Merkmaloptionswerte, die dem Produkt zugeordnet sind. Weitere Informationen zu Merkmalsoptionswerten finden Sie unter [Create product characteristics and characteristic options](https://www.servicenow.com/docs/access?context=som-product-config-add-characteristics&version=xanadu&pubname=xanadu-order-management&ft:locale=en-US). Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-ord-productOrder-id__prod_prodChar_value_data_type-p-tmf622} Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_charakterist_wert/charakterist_option_wert Standard: Leere Zeichenfolge | | productOrderItem.product.productSpecification | Beschreibung der Produktspezifikation, die dem Produkt zugeordnet ist. Hinweis: Change-Aufträge (productOrderItem.action ist `change`) werden je nach Wert der Systemeigenschaft sn_ind_tmt_orm.allowSpecVersionUpdateInChangeOrder unterschiedlich verarbeitet. Der Wert dieser Systemeigenschaft bestimmt, wie die Bestellung verarbeitet wird, wenn der Produktbestand eine andere Version aufweist als die im Auftrag angegebene. * Wenn diese Systemeigenschaft auf „true" (Standard) festgelegt ist, wird der Produktbestand automatisch auf die Version im Auftrag aktualisiert, indem die referenzierte Produktspezifikation geändert wird. Dadurch kann der Auftrag erfolgreich verarbeitet werden. * Wenn diese Systemeigenschaft auf „false" festgelegt ist und der Produktbestand eine andere Version als die in der Bestellung angegebene aufweist, schlägt die Bestellung aufgrund der Versionsabweichung fehl. {#tmf_prod_order-PATCH-ord-productOrder-id__ul_sgb_q5y_hbc} Datentyp: Objekt{#tmf_prod_order-PATCH-ord-productOrder-id__prod_prodSpec_data_type-p-tmf622} "productSpecification": { "id": "String", "internalVersion": "String", "name": "String", "version": "String", "@type": "String" } {#tmf_prod_order-PATCH-ord-productOrder-id__prod_prodSpec-codeblock-tmf622} Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item | | productOrderItem.product.productSpecification.id | Erforderlich, wenn der Parameter productOrderItem.product.productSpecification verwendet wird. Initial_version oder external_id der Produktspezifikation. initial_version ist die sys_id der ersten Version der Spezifikation. Befindet sich im Feld „sys_id" oder „external_id" der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. Datentyp: Zeichenfolge | | productOrderItem.product.productSpecification.interneVersion | Version der Produktspezifikation. Befindet sich in der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. Datentyp: Zeichenfolge | | productOrderItem.product.productSpecification.name | Name der Produktspezifikation. Befindet sich in der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. Datentyp: Zeichenfolge | | Produktbestellelement.Produkt.Produktspezifikation.Version | Externe_Version der Produktspezifikation. Befindet sich in der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. Datentyp: Zeichenfolge | | productOrderItem.product.productSpecification.@type | Teil des TMF Open API-Standards. Dieser Wert ist immer ProductSpecificationRef. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | | Bestellelement.Produkt.zugehörigePartei | Liste der Kontakte für Positionen. Datentyp: Array{#tmf_prod_order-PATCH-ord-productOrder-id__prod_relParty_data_type-p-tmf622} "relatedParty": [ { "email": "String", "firstName": "String", "id": "String", "lastName": "String", "phone": "String", "@referredType": "String", "@type": "String" } ] {#tmf_prod_order-PATCH-ord-productOrder-id__prod_relParty-codeblock-tmf622} Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item_contact | | ProduktBestellelement.Produkt.zugehörigePartei.E-Mail | E-Mail-Adresse des Kontakts Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-ord-productOrder-id__prod_relParty_email_data_type-p-tmf622} Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item_contact/email Standard: Leere Zeichenfolge | | Bestellelement.Produkt.zugehörigePartei.ersterName | Vorname des Kontakts Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-ord-productOrder-id__prod_relParty_firstName_data_type-p-tmf622} Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item_contact/first_name Standard: Leere Zeichenfolge | | productOrderItem.product.relatedParty.id | Sys_id des Einzelpostenkontakts, der der Auftragsposition zugeordnet ist. Befindet sich in der Tabelle „Auftragspositionselement -- Kontakt" \[sn_ind_tmt_orm_order_line_item_contact\]. Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-ord-productOrder-id__prod_relParty_id_data_type-p-tmf622} Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item_contact/sys_id Standard: Leere Zeichenfolge | | productOrderItem.product.relatedPartei.lastName | Nachname des Kontakts Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-ord-productOrder-id__prod_relParty_lastName_data_type-p-tmf622} Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item_contact/lastName Standard: Leere Zeichenfolge | | ProduktBestellelement.Produkt.zugehörigePartei.Telefon | Geschäftliche Telefonnummer des Kontakts Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-ord-productOrder-id__prod_relParty_phone_data_type-p-tmf622} Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item_contact/business_phone Standard: Leere Zeichenfolge | | „productOrderItem.product.relatedPartei.@referredType" | Typ des Kunden Möglicher Wert: OrderLineItemContact{#tmf_prod_order-PATCH-ord-productOrder-id__prod_relParty_refType-p-tmf622} Datentyp: Zeichenfolge | | productOrderItem.product.relatedPartei.@type | Teil des TMF Open API-Standards. Anmerkung für den Kontakt des Bestellpositionselements. Dieser Wert ist immer RelatedParty. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | | productOrderItem.product.@type | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer Produkt. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | | ProduktBestellelement.Produktangebot | Beschreibung des Produktangebots, das dem Produkt zugeordnet ist. Datentyp: Objekt{#tmf_prod_order-PATCH-ord-productOrder-id__prodOffer_data_type-p-tmf622} "productOffering": { "id": "String", "internalVersion": "String", "name": "String", "version": "String" } {#tmf_prod_order-PATCH-ord-productOrder-id__prodOffer-codeblock-tmf622} Tabelle aktualisiert: sn_ind_tmt_orm_order_line_item | | ProduktBestellelement.Produktangebot.ID | Erforderlich, wenn der Parameter productOrderItem.productOffering verwendet wird. Initial_version oder external_id des Produktangebots. initial_version ist die sys_id der ersten Version des Angebots. Zu finden im Feld „sys_id" oder „external_id" der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge | | ProduktBestellelement.Produktangebot.interneVersion | Version des Produktangebots. Befindet sich in der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge | | ProduktBestellelement.Produktangebot.Name | Name des Produktangebots Befindet sich in der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge | | ProduktBestellelement.Produktangebot.Version | Externe_Version des Produktangebots Befindet sich in der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge | | Produktbestellungselement.Produktbestellungselement.Menge | Anzahl der Artikel, die der Bestellung zugeordnet sind. Datentyp: Zahl{#tmf_prod_order-PATCH-ord-productOrder-id__prodOrdItem_quantity_data_type-p-tmf622} Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order/quantity Standard: null | | Produktbestellungselement.ProduktbestellungselementBeziehung | Array von Objekten, die die Beziehungen zwischen Bestellpositionen beschreiben. Datentyp: Array{#tmf_prod_order-PATCH-ord-productOrder-id__prodOrderItemRel_data_type-p-tmf622} "productOrderItemRelationship": [ { "id": "String", "relationshipType": "String" } ] {#tmf_prod_order-PATCH-ord-productOrder-id__prodOrderItemRel-codeblock-tmf622} Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item | | „productOrderItem.productOrderItemRelationship.id" | Erforderlich, wenn der Parameter productOrderItem.productOrderItemRelationship verwendet wird. Eindeutiger Bezeichner des zugehörigen Einzelpostens. Zu finden im Feld sn_ind_tmt_orm_external_id der Tabelle „Auftragspositionselement" \[sn_ind_tmt_orm_order_line_item\]. Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-ord-productOrder-id__prodOrderItemRel_id_data_type-p-tmf622} Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item/parent_line_item Standard: Leere Zeichenfolge | | „productOrderItem.productOrderItemRelationship.relationshipType" | Typ der Beziehung zwischen den beiden Einzelposten. Diese Informationen werden verwendet, um die Beziehungshierarchie zu identifizieren. Mögliche Werte: * HasChild * Hat übergeordnet * Erfordert {#tmf_prod_order-PATCH-ord-productOrder-id__ul_yqf_2ty_54b} `„HasChild"` und `„HasParent"` werden für Beziehungen zwischen über- und untergeordneten Elementen verwendet. „`Erfordert` " wird für horizontale Beziehungen verwendet (ein Einzelposten erfordert einen anderen Einzelposten). Datentyp: Zeichenfolge | | Produktbestellungselement.Menge | Anzahl der bestellten Artikel. Datentyp: Zahl Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order/quantity Standard: Leere Zeichenfolge | | productOrderItem.revisionOperation | Typ der Aktualisierung, die für die Position durchgeführt werden soll. Wenn dieser Wert leer ist, wird die vorhandene Position aktualisiert, oder es wird eine neue Position hinzugefügt, wenn sie noch nicht vorhanden ist. Wenn dieser Wert gleich „stornieren" ist, wird die Position storniert. Datentyp: Zeichenfolge Standard: Leere Zeichenfolge | | produktBestellelement.@type | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer ProductOrderItem. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | | Zugehörige Partei | Liste der Kontakte für den Auftrag. Jeder Kontakt ist ein Objekt im Array. Muss mindestens ein Element aufführen, das Informationen zu Kunden- oder Verbraucherkonten enthält. Datentyp: Array{#tmf_prod_order-PATCH-ord-productOrder-id__relatedParty_data_type-p-tmf622} "relatedParty": [ { "id": "String", "name": "String", "@referredType": "String", "@type": "String" } ] {#tmf_prod_order-PATCH-ord-productOrder-id__relatedParty-codeblock-tmf622} | | Zugehörigepartei.id | Sys_id oder external_id des Accounts, Kundenkontakts oder Verbrauchers, der dem Auftrag zugeordnet ist. Zu finden in der Tabelle „Account" \[customer_account\], „Kontakt" \[customer_contact\] oder „Verbraucher" \[csm_consumer\]. Datentyp: Zeichenfolge | | Zugehörigepartei.name | Name des Accounts, Kunden oder Verbrauchers. Datentyp: Zeichenfolge | | zugehörigepartei.@referenztyp | Typ des Kunden Mögliche Werte: * Verbraucher * Kunde * Kundenkontakt {#tmf_prod_order-PATCH-ord-productOrder-id__ul_lcq_jwm_t4b} Datentyp: Zeichenfolge | | zugehörigepartei.@typ | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer RelatedParty. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | | RequestedCompletionDate | Vom Kunden angefordertes Lieferdatum Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-ord-productOrder-id__reqCompDate_data_type-p-tmf622} Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order/expected_end_date Standard: Leere Zeichenfolge | | Angefordertes Startdatum | Vom Kunden angefordertes Auftragsstartdatum. Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-ord-productOrder-id__reqStartDate_data_type-p-tmf622} Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order/expected_start_date Standard: Leere Zeichenfolge | | @type | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer ProductOrder. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | [Tabelle : 27. Parameter des Anforderungstexts (JSON)] {#tmf_prod_order-PATCH-ord-productOrder-id__id_vk2_p5n_t4b} ### Kopfzeilen Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST API verwendet werden, finden Sie unter [Unterstützte REST API-Header](https://www.servicenow.com/docs/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können."). {#tmf_prod_order-PATCH-ord-productOrder-id__table_omb_dvk_5rb__entry__2}{#tmf_prod_order-PATCH-ord-productOrder-id__accept-JSON-only-entry-RESTAPI}{#tmf_prod_order-PATCH-ord-productOrder-id__content_type-JSON-only-entry-RESTAPI} | Kopfzeile | Beschreibung | |-|-| | Akzeptieren | Datenformat des Antworttexts. Unterstützt nur application/json. | | Content-Type | Datenformat des Anforderungstexts. Unterstützt nur application/json. | [Tabelle : 28. Anforderungskopfzeilen] {#tmf_prod_order-PATCH-ord-productOrder-id__table_omb_dvk_5rb} {#tmf_prod_order-PATCH-ord-productOrder-id__table_tzy_thy_ksb__entry__2} | Kopfzeile | Beschreibung | |-|-| | Inhaltstyp | Datenformat des Antworttexts. Unterstützt nur application/json. | [Tabelle : 29. Antwortkopfzeilen] {#tmf_prod_order-PATCH-ord-productOrder-id__table_tzy_thy_ksb} ### Statuscodes Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST API verwendet werden, finden Sie unter [HTTP-Antwortcodes](https://www.servicenow.com/docs/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API. {#tmf_prod_order-PATCH-ord-productOrder-id__table_xfv_2vk_5rb__entry__2} | Statuscode | Beschreibung | |-|-| | 201 | Erfolgreich. Wenn Probleme mit den Merkmalen oder Merkmalsoptionsinformationen auftreten, speichert der Endpunkt die folgenden Kommentare in den Arbeitsnotizen-Feldern des zugehörigen Kundenauftragspositionselement-Datensatzes: * Die folgenden Merkmale für Bestellelemente sind nicht vorhanden: Überprüfen Sie die Spezifikation \, und korrigieren Sie das Merkmal und die Merkmalsoption in der Auftragsposition, bevor Sie den Auftrag genehmigen. * Merkmal des Bestellelements: \ mit Merkmalswert: \ist ungültig. Korrigieren Sie die Merkmalswerte, bevor Sie den Auftrag genehmigen. {#tmf_prod_order-PATCH-ord-productOrder-id__ul_xtx_xym_t4b} | | 400 | Ungültige Anforderung. Kann einer der folgenden Gründe sein: * Ungültige Nutzlast: Anforderungstext fehlt -- Nutzlast wurde im Anforderungstext nicht übergeben. * Ungültige Nutzlast: productOrderItem fehlt -- Objekt für Produktauftragsposition oder JSON fehlt. * Ungültige Nutzlast: productOrderItem-ID fehlt -- Der Parameter id fehlt in der Produktbestellposition der Nutzlast. * Ungültige Nutzlast: Aktion „productOrderItem" fehlt -- Der Parameter action fehlt in der Produktbestellposition der Nutzlast. * Ungültige Nutzlast: productOrderItem Produktangebot fehlt -- Das Produktangebotsobjekt oder JSON fehlt in der Produktbestellposition in der Nutzlast. * Ungültige Nutzlast: Produktangebots-ID fehlt -- Der Parameter id fehlt in der Produktbestellposition des Produktangebotsobjekts in der Nutzlast. * Ungültige Nutzlast: Produktangebot ist nicht vorhanden -- Das Produktangebot in der Produktauftragsposition ist nicht gültig. * Ungültige Nutzlast: Produkt „productOrderItem" fehlt : Das Produktobjekt oder JSON in der Produktauftragsposition fehlt in der Nutzlast. * Ungültige Nutzlast: Produkt, Produktspezifikation fehlt -- Das Produktspezifikationsobjekt oder JSON in der Produktbestellposition fehlt in der Nutzlast. * Ungültige Nutzlast: Produktspezifikations-ID fehlt -- Der Parameter id in der Produktbestellposition des Produktspezifikationsobjekts fehlt in der Nutzlast. * Ungültige Nutzlast: Produktspezifikation ist nicht vorhanden -- Die Produktspezifikation in der Produktauftragsposition ist ungültig. * Ungültige Nutzlast: Produktbestand nicht vorhanden -- In einem Change-Auftrag (Aktion = Change) ist die Menge eines Artikels größer als der Bestand. * Ungültige Nutzlast: Produktbestands-ID fehlt -- in einem Change-Auftrag fehlt product.id in der Nutzlast. * Ungültige Nutzlast: Verkauftes Produkt ist inaktiv -- In einem Change-Auftrag ist ein in der Nutzlast angegebenes Produkt inaktiv. * Ungültige Nutzlast: „relatedParty" fehlt : Das Objekt der zugehörigen Partei fehlt in der Nutzlast. * Kunden-Account oder Verbraucher fehlt : Das Kunden- oder Verbraucherobjekt der zugehörigen Partei fehlt in der Nutzlast. * Ungültige Nutzlast: Verbraucher nicht vorhanden -- Der angegebene Verbraucher der zugehörigen Partei ist in der Instanz ServiceNow nicht vorhanden. * Ungültige Nutzlast: Kunden-Account nicht vorhanden -- Der angegebene zugehörige Vertragspartei-Kunde ist in der Instanz ServiceNow nicht vorhanden. * Ungültige Nutzlast: Auftragserstellung fehlgeschlagen -- Der angeforderte Auftrag kann nicht erstellt werden. * In-Ausführungs-Überarbeitung von Auftragswährung nicht unterstützt : Der Parameter orderCurrency kann nicht aktualisiert werden, nachdem der Auftrag erstellt wurde. * Diese Bestellung muss noch in der Kundenauftragstabelle erstellt werden. Weitere Details finden Sie in der eingehenden Warteschlange. : Die angegebene Auftrags-ID befindet sich nicht in der Kundenauftragstabelle. * Patch-Anforderung kann nicht gestellt werden, da der Erfüllungstyp des Auftrags nicht „liefern" ist. -- Die Patch-Anforderung wurde für einen Auftrag gestellt, der einen anderen Erfüllungstyp als „Liefern" hat. {#tmf_prod_order-PATCH-ord-productOrder-id__ul_g2v_rzm_t4b} | [Tabelle : 30. Statuscodes] {#tmf_prod_order-PATCH-ord-productOrder-id__table_xfv_2vk_5rb} ### Parameter des Antwort-Haupttexts (JSON) {#tmf_prod_order-PATCH-ord-productOrder-id__section_b1v_xpk_5rb} {#tmf_prod_order-PATCH-ord-productOrder-id__table_c1v_xpk_5rb__entry__2}{#tmf_prod_order-PATCH-ord-productOrder-id__d2876e1605}{#tmf_prod_order-PATCH-ord-productOrder-id__externalProdInvId-resp-descr} | Name | Beschreibung | |-|-| | channel | Array von Objekten, die die Kanäle beschreiben, die für den Verkauf der Produkte verwendet werden sollen Datentyp: Array "channel": [ { "id": "String", "name": "String" } ] | | channel.id | Eindeutiger Bezeichner des Kanals, der für den Verkauf der zugehörigen Produkte verwendet werden soll. Kanal-ID-Werte befinden sich im Feld „external_id" der Tabelle „Verteilungskanal" \[sn_prd_pm_distribution_channel\]. Datentyp: Zeichenfolge | | Kanalname | Name des Kanals, der für den Verkauf der zugehörigen Produkte verwendet werden soll. Datentyp: Zeichenfolge | | committedDueDate | Datum und Uhrzeit, zu der die Aktion für den Auftrag ausgeführt werden muss. Dieser Wert muss mit den committedDueDate -Werten für jede Bestellposition übereinstimmen oder später als diese sein. Datentyp: Zeichenfolge | | externalId | Externer Bezeichner für den Kundenauftrag, z. B. eine Bestellnummer. Datentyp: Zeichenfolge | | href | Relativer Link zum Produktbestelldatensatz. Datentyp: Zeichenfolge | | id | Sys_id des Kundenauftrags für diese Anforderung aktualisiert. Datentyp: Zeichenfolge | | Hinweis | Array von Objekten, die zusätzliche Notizen beschreiben, die der Kunde bei der Bestellung gemacht hat. Datentyp: Array "note": [ { "text": "String" } ] | | Anmerkung.Text | Zusätzliche Hinweise/Kommentare vom Kunden während der Bestellung. Datentyp: Zeichenfolge | | orderCurrency | Währungscode für den Auftrag und die Bestellpositionen. Datentyp: Zeichenfolge | | productOrderItem | Liste, die die der Produktbestellung zugeordneten Elemente und die zugehörige Aktion beschreibt. Datentyp: Array "productOrderItem:" [ { "action": "String", "committedDueDate": "String", "externalProductInventory": [Array], "id": "String", "itemPrice": [Array], "product": {Object}, "productOffering": {Object}, "productOrderItemReleationship": [Array], "quantity": Number, "state": "String", "@type": "String" } ] | | productOrderItem.action | Aktion, die für das Produkt ausgeführt werden soll. Mögliche Aktionen sind auf der Registerkarte „Auswahlliste" im Aktionswörterbucheintrag der Tabelle sn_ind_tmt_orm_order_line_item definiert. Datentyp: Zeichenfolge | | „productOrderItem.actionReason" | Der Grund für das Hinzufügen der Auftragsposition. Datentyp: Zeichenfolge Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item/action_reason | | produktbestellelement.committedFälligkeitsdatum | Datum und Uhrzeit, zu der die Aktion für die Auftragsposition ausgeführt werden muss. Datentyp: Zeichenfolge | | Bestellelement.externerProduktbestand | Array von Objekten mit externen IDs für die Zuordnung zu den für den Auftrag erstellten Produktbeständen. Datentyp: Array "externalProductInventory": [ { "externalProductInventoryId": "String" } ] Hinweis: Zuvor wurde beim Erstellen eines PATCH-Auftrags mit einer bereits vorhandenen externen Produktbestands-ID der Vorgang abgebrochen und ein Fehler zurückgegeben. Mit dem Release Xanadu wird dieser Parameter einfach ignoriert, wenn eine vorhandene externe Produktbestands-ID angegeben und kein Fehler ausgegeben wird. | | Bestellelement.externalProductInventory.externalProductInventoryId | Externe ID, die dem Produktbestand zugeordnet ist. Datentyp: Zeichenfolge | | productOrderItem.id | Eindeutiger Bezeichner der Position. Zu finden im Feld sn_ind_tmt_orm_external_id der Tabelle „Auftragspositionselement" \[sn_ind_tmt_orm_order_line_item\]. Datentyp: Zeichenfolge | | Produktbestellungselement.Artikelpreis | Array von Objekten, die den dem Produkt zugeordneten Preis beschreiben Datentyp: Array "itemPrice": [ { "price": {Object}, "priceType": "String", "recurringChargePeriod": "String" } ] | | Produktbestellungselement.Artikelpreis.Preis | Beschreibung des Preises des zugeordneten Produkts. Datentyp: Objekt "price": { "taxIncludedAmount": {Object} } | | „productOrderItem.itemPrice.Preis.SteuerEinschlussBetrag" | Beschreibung des Preises des zugehörigen Produkts, einschließlich Steuer. Datentyp: Objekt "taxIncludedAmount": { "unit": "String", "value": Number } | | ProduktAuftragselement.Elementpreis.Preis.SteuerEinschlussBetrag.Einheit | Währungscode, in dem der Preis dargestellt wird. Datentyp: Zeichenfolge | | ProduktAuftragselement.Elementpreis.Preis.SteuerEinschlussBetrag.Wert | Preis des Produkts, einschließlich Steuern. Datentyp: Zahl | | „productOrderItem.itemPrice.PriceType" | Typ des Artikelpreises, wiederkehrend oder nicht wiederkehrend. Datentyp: Zeichenfolge | | „productOrderItem.itemPrice.recurringChargePeriod" | Wenn der Preis wiederkehrend ist, der wiederkehrende Zeitraum, z. B. Monat. Datentyp: Zeichenfolge | | ProduktBestellelement.Produkt | Beschreibung der Instanzdetails des vom Kunden erworbenen Produkts. Datentyp: Objekt "product": { "id": "String", "place": {Object}, "productCharacteristic": [Array], "productSpecification": {Object}, "relatedParty": {Object}, "@type": "String" } | | productOrderItem.product.id | Eindeutiger Bezeichner des verkauften Produkts. Befindet sich im Feld „sys_id" oder „sn_ind_tmt_orm_external_id" der Tabelle „Produktbestand" \[sn_ind_tmt_orm_product_inventory\]. Datentyp: Zeichenfolge | | productOrderItem.product.place | Karten der Speicherorte, an denen das Produkt installiert werden soll. Datentyp: Objekt "place": { "id": "String", "@type": "String" } | | productOrderItem.product.place.id | Sys_id des zugeordneten Standortdatensatzes in der Standorttabelle \[cmn_location\]. Datentyp: Zeichenfolge | | productOrderItem.product.productMerkmal | Array von Objekten, die die Eigenschaften des zugeordneten Produkts beschreiben. Datentyp: Array "productCharacteristic": [ { "name": "String", "previousValue": "String", "value": "String" } ] | | productOrderItem.product.productCharacteristic.name | Name des Merkmaldatensatzes, der dem Produkt zugeordnet werden soll. Befindet sich in der Tabelle „Merkmal" \[sn_prd_pm_charakteristik\]. Datentyp: Zeichenfolge | | „productOrderItem.product.productFeature. previousValue" | Vorherige Merkmalsoptionswerte, wenn die Aktualisierung für einen Change-Auftrag erfolgt. Die Anforderung ist ein Change, wenn der Parameter productOrderItem.action etwas anderes als addist. Weitere Informationen zu Merkmalsoptionswerten finden Sie unter [Create product characteristics and characteristic options](https://www.servicenow.com/docs/access?context=som-product-config-add-characteristics&version=xanadu&pubname=xanadu-order-management&ft:locale=en-US). Datentyp: Zeichenfolge | | productOrderItem.product.productMerkmal.Wert | Merkmaloptionswerte, die dem Produkt zugeordnet sind. Weitere Informationen zu Merkmalsoptionswerten finden Sie unter [Create product characteristics and characteristic options](https://www.servicenow.com/docs/access?context=som-product-config-add-characteristics&version=xanadu&pubname=xanadu-order-management&ft:locale=en-US). Datentyp: Zeichenfolge | | productOrderItem.product.productSpecification | Beschreibung der Produktspezifikation, die dem Produkt zugeordnet ist. Datentyp: Objekt "productSpecification:" { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String", "@type": "String" } | | productOrderItem.product.productSpecification.id | Initial_version oder external_id der Produktspezifikation. initial_version ist die sys_id der ersten Version der Spezifikation. Befindet sich im Feld „sys_id" oder „external_id" der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. Datentyp: Zeichenfolge | | Bestellelement.Produkt.Produktspezifikation.interneID | Initiale_version der Produktspezifikation. initial_version ist die sys_id der ersten Version der Spezifikation. Befindet sich in der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. Datentyp: Zeichenfolge | | productOrderItem.product.productSpecification.interneVersion | Version der Produktspezifikation. Befindet sich in der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. Datentyp: Zeichenfolge | | productOrderItem.product.productSpecification.name | Name der Produktspezifikation. Befindet sich in der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. Datentyp: Zeichenfolge | | Produktbestellelement.Produkt.Produktspezifikation.Version | Externe_Version der Produktspezifikation. Befindet sich in der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. Datentyp: Zeichenfolge | | productOrderItem.product.productSpecification.@type | Teil des TMF Open API-Standards. Dieser Wert ist immer ProductSpecificationRef. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | | Bestellelement.Produkt.zugehörigePartei | Liste der Kontakte für Positionen. Datentyp: Array "relatedParty": [ { "email": "String", "firstName": "String", "id": "String", "lastName": "String", "phone": "String", "@referredType": "String", "@type": "String" } ] | | productOrderItem.product.relatedParty.email | E-Mail-Adresse des Kontakts Datentyp: Zeichenfolge | | Bestellelement.Produkt.zugehörigePartei.ersterName | Vorname des Kontakts Datentyp: Zeichenfolge | | productOrderItem.product.relatedParty.id | Sys_id des Einzelpostenkontakts, der der Auftragsposition zugeordnet ist. Befindet sich in der Tabelle „Auftragspositionselement -- Kontakt" \[sn_ind_tmt_orm_order_line_item_contact\]. Datentyp: Zeichenfolge | | productOrderItem.product.relatedPartei.lastName | Nachname des Kontakts Datentyp: Zeichenfolge | | productOrderItem.product.relatedParty.phone | Geschäftliche Telefonnummer des Kontakts Datentyp: Zeichenfolge | | „productOrderItem.product.relatedPartei.@referredType" | Typ des Kunden Möglicher Wert: OrderLineItemContact Datentyp: Zeichenfolge | | productOrderItem.product.relatedPartei.@type | Teil des TMF Open API-Standards. Anmerkung für den Kontakt des Bestellpositionselements. Dieser Wert ist immer RelatedParty. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | | productOrderItem.product.@type | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer Produkt. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | | ProduktBestellelement.Produktangebot | Beschreibung des Produktangebots, das dem Produkt zugeordnet ist. Datentyp: Objekt "productOffering:" { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } | | productOrderItem.productOffering.id | Initial_version oder external_id des Produktangebots. initial_version ist die sys_id der ersten Version des Angebots. Zu finden im Feld „sys_id" oder „external_id" der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge | | „productOrderItem.productOffering.internalId" | Initial_version des Produktangebots. initial_version ist die sys_id der ersten Version des Angebots. Befindet sich in der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge | | ProduktBestellelement.Produktangebot.interneVersion | Version des Produktangebots. Befindet sich in der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge | | productOrderItem.productOffering.name | Name des Produktangebots Befindet sich in der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge | | ProduktBestellelement.Produktangebot.Version | Externe_Version des Produktangebots Befindet sich in der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge | | Produktbestellungselement.ProduktbestellungselementBeziehung | Array von Objekten, die die Beziehungen zwischen Bestellpositionen beschreiben. Datentyp: Array "productOrderItemRelationship": [ { "id": "String", "relationshipType": "String" } ] | | productOrderItem.productOrderItemRelationship.id | Eindeutiger Bezeichner des zugehörigen Einzelpostens. Zu finden im Feld sn_ind_tmt_orm_external_id der Tabelle „Auftragspositionselement" \[sn_ind_tmt_orm_order_line_item\]. Datentyp: Zeichenfolge | | „productOrderItem.productOrderItemRelationship.relationshipType" | Typ der Beziehung zwischen den beiden Einzelposten. Diese Informationen werden verwendet, um die Beziehungshierarchie zu identifizieren. Datentyp: Zeichenfolge | | Produktbestellungselement.Menge | Anzahl der Artikel, die der Bestellung zugeordnet sind. Datentyp: Zahl | | „productOrderItem.state" | Aktueller Status des Produktbestellartikels. Datentyp: Zeichenfolge | | produktBestellelement.@type | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer ProductOrderItem. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | | Zugehörige Partei | Liste der Kontakte für den Auftrag. Jeder Kontakt ist ein Objekt im Array. Muss mindestens ein Element aufführen, das Informationen zu Kunden- oder Verbraucherkonten enthält. Datentyp: Array "relatedParty": [ { "id": "String", "name": "String", "@referredType": "String", "@type": "String" } ] | | relatedParty.id | Sys_id oder external_id des Accounts, Kundenkontakts oder Verbrauchers, der dem Auftrag zugeordnet ist. Zu finden in der Tabelle „Account" \[customer_account\], „Kontakt" \[customer_contact\] oder „Verbraucher" \[csm_consumer\]. Datentyp: Zeichenfolge | | relatedParty.name | Name des Accounts, Kunden oder Verbrauchers. Datentyp: Zeichenfolge | | ZugehörigePartei.Typ | Typ des Kunden Mögliche Werte: * Verbraucher * Kunde * Kundenkontakt {#tmf_prod_order-PATCH-ord-productOrder-id__d2876e2462} Datentyp: Zeichenfolge | | RequestedCompletionDate | Vom Kunden angefordertes Lieferdatum Datentyp: Zeichenfolge | | Angefordertes Startdatum | Vom Kunden angefordertes Auftragsstartdatum. Datentyp: Zeichenfolge | | Staat | Aktueller Status des Auftrags. Datentyp: Zeichenfolge | | @type | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer ProductOrder. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | [ ] {#tmf_prod_order-PATCH-ord-productOrder-id__table_c1v_xpk_5rb} ### cURL-Anforderung {#tmf_prod_order-PATCH-ord-productOrder-id__example_jsc_1dc_vrb} In diesem Beispiel wird der Kanal für eine Produktbestellung aktualisiert. curl -X PATCH "https://instance.service-now.com/api/sn_ind_tmt_orm/order/productOrder/8d75939453126010a795ddeeff7b126a" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -u "username":"password" \ -d { "channel": [ { "id": "1", "name": "Agent Assist" } ] } Antworttext. { "id": "8d75939453126010a795ddeeff7b126a", "href": "/api/sn_ind_tmt_orm/order/productOrder/8d75939453126010a795ddeeff7b126a", "expectedCompletionDate": "2021-05-02T08:13:59.000Z", "requestedCompletionDate": "2021-05-02T08:13:59.000Z", "requestedStartDate": "2020-05-03T08:13:59.000Z", "externalId": "PO-456", "orderCurrency": "USD", "channel": [ { "id": "1", "name": "Agent Assist" } ], "note": [ { "author": "System Administrator", "date": "2021-02-25T14:22:07.000Z", "text": "This is a TMF product order illustration no 2" }, { "author": "System Administrator", "date": "2021-02-25T14:22:06.000Z", "text": "This is a TMF product order illustration" } ], "productOrderItem": [ { "id": "POI130", "ponr": "false", "quantity": 1, "action": "add", "actionReason": "adding service package OLI", "itemPrice": [ { "priceType": "recurring", "price": { "taxIncludedAmount": { "unit": "USD", "value": 20 } } }, { "priceType": "nonRecurring", "price": { "taxIncludedAmount": { "unit": "INR", "value": 0 } } } ], "product": { "@type": "Product", "productCharacteristic": [ { "name": "Security Type", "valueType": "Choice", "value": "Base", "previousValue": "" } ], "productSpecification": { "id": "a6514bd3534560102f18ddeeff7b1247", "name": "SD-WAN Security", "version": "v1", "internalVersion": "1", "internalId": "a6514bd3534560102f18ddeeff7b1247", "@type": "ProductSpecificationRef" }, "relatedParty": [ { "id": "4175939453126010a795ddeeff7b127d", "name": "John Smith", "email": "abc2@example.com", "phone": "32456768", "@type": "RelatedParty", "@referredType": "OrderLineItemContact" }, { "id": "c175939453126010a795ddeeff7b127c", "name": "Joe Doe", "email": "abc@example.com", "phone": "1234567890", "@type": "RelatedParty", "@referredType": "OrderLineItemContact" } ] }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering", "version": "v1", "internalId": "69017a0f536520103b6bddeeff7b127d", "internalVersion": "1" }, "productOrderItemRelationship": [ { "id": "POI100", "relationshipType": "HasParent" } ], "state": "in_progress", "version": "1", "@type": "ProductOrderItem" }, { "id": "POI100", "ponr": "false", "quantity": 1, "action": "add", "itemPrice": [ { "priceType": "recurring", "price": { "taxIncludedAmount": { "unit": "INR", "value": 0 } } }, { "priceType": "nonRecurring", "price": { "taxIncludedAmount": { "unit": "INR", "value": 0 } } } ], "product": { "@type": "Product", "productSpecification": { "id": "cfe5ef6a53702010cd6dddeeff7b12f6", "name": "SD-WAN Service Package", "version": "v1", "internalVersion": "1", "internalId": "cfe5ef6a53702010cd6dddeeff7b12f6", "@type": "ProductSpecificationRef" } }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering", "version": "v1", "internalId": "69017a0f536520103b6bddeeff7b127d", "internalVersion": "1" }, "productOrderItemRelationship": [ { "id": "POI130", "relationshipType": "HasChild" }, { "id": "POI120", "relationshipType": "HasChild" }, { "id": "POI110", "relationshipType": "HasChild" } ], "state": "in_progress", "version": "1", "@type": "ProductOrderItem" }, { "id": "POI120", "ponr": "false", "quantity": 1, "action": "add", "actionReason": "adding service package OLI", "itemPrice": [ { "priceType": "recurring", "price": { "taxIncludedAmount": { "unit": "USD", "value": 20 } } }, { "priceType": "nonRecurring", "price": { "taxIncludedAmount": { "unit": "INR", "value": 0 } } } ], "product": { "@type": "Product", "productCharacteristic": [ { "name": "CPE Type", "valueType": "Choice", "value": "Physical", "previousValue": "" }, { "name": "WAN Optimization", "valueType": "Choice", "value": "Advance", "previousValue": "" }, { "name": "Routing", "valueType": "Choice", "value": "Premium", "previousValue": "" }, { "name": "CPE Model", "valueType": "Choice", "value": "ASR", "previousValue": "" } ], "productSpecification": { "id": "39b627aa53702010cd6dddeeff7b1202", "name": "SD-WAN Edge Device", "version": "v1", "internalVersion": "1", "internalId": "39b627aa53702010cd6dddeeff7b1202", "@type": "ProductSpecificationRef" } }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering", "version": "v1", "internalVersion": "1", "internalId": "69017a0f536520103b6bddeeff7b127d" }, "productOrderItemRelationship": [ { "id": "POI100", "relationshipType": "HasParent" } ], "state": "in_progress", "version": "1", "@type": "ProductOrderItem" }, { "id": "POI110", "ponr": "false", "quantity": 1, "action": "add", "actionReason":"adding service package OLI", "itemPrice": [ { "priceType": "recurring", "price": { "taxIncludedAmount": { "unit": "INR", "value": 0 } } }, { "priceType": "nonRecurring", "price": { "taxIncludedAmount": { "unit": "USD", "value": 5 } } } ], "product": { "@type": "Product", "productCharacteristic": [ { "name": "Tenancy", "valueType": "Choice", "value": "Base (10 site)", "previousValue": "" } ], "productSpecification": { "id": "216663aa53702010cd6dddeeff7b12b5", "name": "SD-WAN Controller", "version": "v1", "internalVersion": "1", "internalId": "216663aa53702010cd6dddeeff7b12b5", "@type": "ProductSpecificationRef" }, "place": { "id": "25ab9c4d0a0a0bb300f7dabdc0ca7c1c", "@type": "Place" } }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering", "version": "v1", "internalId": "69017a0f536520103b6bddeeff7b127d", "internalVersion": "1" }, "productOrderItemRelationship": [ { "id": "POI100", "relationshipType": "HasParent" } ], "state": "in_progress", "version": "1", "@type": "ProductOrderItem" } ], "relatedParty": [ { "id": "eaf68911c35420105252716b7d40ddde", "name": "Sally Thomas", "@type": "RelatedParty", "@referredType": "CustomerContact" }, { "id": "ffc68911c35420105252716b7d40dd55", "name": "Funco Intl", "@type": "RelatedParty", "@referredType": "Customer" }, { "id": "59f16de1c3b67110ff00ed23a140dd9e", "name": "Funco External", "@type": "RelatedParty", "@referredType": "Consumer" } ], "state": "in_progress", "@type": "ProductOrder" } ## Open API für Produktbestellung -- PATCH /sn_ind_tmt_orm/productorder/{id} {#ariaid-title7} Aktualisiert den angegebenen Kundenauftrag. Wichtig: Ab Release Tokyo ist dieser Endpunkt veraltet. Die neue Version dieses Endpunkts ist [Open API für Produktbestellung -- PATCH /sn_ind_tmt_orm/order/productOrder/{id}](https://www.servicenow.com/docs/Ae5XqErKGgN46FHZcSkOdg#tmf_prod_order-PATCH-ord-productOrder-id "Aktualisiert den angegebenen Kundenauftrag."). ### URL-Format Standard-URL: /api/sn_ind_tmt_orm/productorder/{id} ### Unterstützte Anforderungsparameter {#tmf_prod_order-PATCH-productorder-id__entry__2} | Name | Beschreibung | |-|-| | id | Sys_id des zu aktualisierenden Kundenauftrags. Befindet sich in der Tabelle „Kundenauftrag" \[sn_ind_tmt_orm_order\]. Datentyp: Zeichenfolge | [Tabelle : 31. Pfadparameter] {#tmf_prod_order-PATCH-productorder-id__entry__6} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 32. Abfrageparameter] {#tmf_prod_order-PATCH-productorder-id__id_vk2_p5n_t4b__entry__2}{#tmf_prod_order-PATCH-productorder-id__channel-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__channel_id-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__channel_name-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__due-date-PATCH}{#tmf_prod_order-PATCH-productorder-id__externalId-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__note-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__note_text-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__prodOrdItem-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__prodOrdItem_action-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__prodOrdItem_actionReason-response-tmf622}{#tmf_prod_order-PATCH-productorder-id__due-date-item-PATCH}{#tmf_prod_order-PATCH-productorder-id__externalProdInv-descr-PATCH}{#tmf_prod_order-PATCH-productorder-id__externalProdInvId-decsr}{#tmf_prod_order-PATCH-productorder-id__prodOrdItem_id-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__itemPrice-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__itemPrice_price-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__itemPrice_price_taxIncludedAmt-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__itemPrice_price_taxIncludedAmt_unit-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__itemPrice_price_taxIncludedAmt_value-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__itemPrice_priceType_data_type-p-tmf622}{#tmf_prod_order-PATCH-productorder-id__itemPrice_recurringChargePeriod_data_type-p-tmf622}{#tmf_prod_order-PATCH-productorder-id__product-p-tmf622}{#tmf_prod_order-PATCH-productorder-id__product_id-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__product_place-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__product_place_id-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__product_place_type_data_type-p-tmf622}{#tmf_prod_order-PATCH-productorder-id__prod_prodChar-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__prod_prodChar_name-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__prod_prodChar_previousValue-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__prod_prodChar_value-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__prod_prodSpec-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__prod_prodSpec_id_data_type-p-tmf622}{#tmf_prod_order-PATCH-productorder-id__prod_prodSpec_name_data_type-p-tmf622}{#tmf_prod_order-PATCH-productorder-id__prod_prodSpec_type_data_type-p-tmf622}{#tmf_prod_order-PATCH-productorder-id__prod_relParty-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__prod_relParty_email-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__prod_relParty_firstName-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__prod_relParty_id-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__prod_relParty_lastName-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__prod_relParty_phone-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__prod_relParty_refType_data_type-p-tmf622}{#tmf_prod_order-PATCH-productorder-id__product_relatedParty_type_data_type-row-tmf622}{#tmf_prod_order-PATCH-productorder-id__product_type_data_type-p-tmf622}{#tmf_prod_order-PATCH-productorder-id__productOffer-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__prodOffer_id_data_type-p-tmf622}{#tmf_prod_order-PATCH-productorder-id__prodOffer_name_data_type-p-tmf622}{#tmf_prod_order-PATCH-productorder-id__prodOrdItem_quantity-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__prodOrderItemRel-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__prodOrderItemRel_id-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__prodOrderItemRel_relType_data_type-p-tmf622}{#tmf_prod_order-PATCH-productorder-id__prodOrdItem_type-entry-tmf622}{#tmf_prod_order-PATCH-productorder-id__relatedParty-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__relatedParty_id_data_type-p-tmf622}{#tmf_prod_order-PATCH-productorder-id__relatedParty_name_data_type-p-tmf622}{#tmf_prod_order-PATCH-productorder-id__relatedParty_refType_data_type-p-tmf622}{#tmf_prod_order-PATCH-productorder-id__relatedParty_type_data_type-p-tmf622}{#tmf_prod_order-PATCH-productorder-id__requestedCompletionDate-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__reqStartDate-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__type-entry-tmf622} | Name | Beschreibung | |-|-| | channel | Array von Objekten, die die Kanäle beschreiben, die für den Verkauf der Produkte verwendet werden sollen Datentyp: Array{#tmf_prod_order-PATCH-productorder-id__channel_data_type-p-tmf622} "channel": [ { "id": "String", "name": "String" } ] {#tmf_prod_order-PATCH-productorder-id__channel_obj_def-codeblock-tmf622} Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order | | channel.id | Erforderlich, wenn der Parameter channel verwendet wird. Eindeutiger Bezeichner des Kanals, der für den Verkauf der zugehörigen Produkte verwendet werden soll. Kanal-ID-Werte befinden sich im Feld „external_id" der Tabelle „Verteilungskanal" \[sn_prd_pm_distribution_channel\]. Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-productorder-id__channel_id_data_type-p-tmf622} Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order/channel Standard: Leere Zeichenfolge | | Kanalname | Name des Kanals, der für den Verkauf der zugehörigen Produkte verwendet werden soll. Mögliche Kanalnamen sind auf der Registerkarte „Auswahlliste" im Wörterbucheintrag „Kanal" der Tabelle „sn_ind_tmt_orm_order" definiert. Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-productorder-id__channel_name_data_type-p-tmf622} Standard: Leere Zeichenfolge | | committedDueDate | Datum und Uhrzeit, zu der die Aktion für den Auftrag ausgeführt werden muss. Dieser Wert muss mit den committedDueDate -Werten für jede Bestellposition übereinstimmen oder später als diese sein. Wenn die Aktion für Auftragspositionen „ aussetzen " oder „ fortsetzen" ist, kann dieser Parameter nicht aktualisiert werden. Datentyp: Zeichenfolge Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order/committed_due_date | | externalId | Eindeutiger Bezeichner für den Kundenauftrag. Dieser Wert wird von einem externen System bestimmt. Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-productorder-id__externalId_data_type-p-tmf622} Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order/external_id Standard: Leere Zeichenfolge | | Hinweis | Array von Objekten, die zusätzliche Notizen beschreiben, die der Kunde bei der Bestellung gemacht hat. Datentyp: Array{#tmf_prod_order-PATCH-productorder-id__note_data_type-p-tmf622} "note": [ { "text": "String" } ] {#tmf_prod_order-PATCH-productorder-id__note-codeblock-tmf622} Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order | | Anmerkung.Text | Zusätzliche Hinweise/Kommentare vom Kunden während der Bestellung. Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-productorder-id__note_text_data_type-p-tmf622} Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order/comments Standard: Leere Zeichenfolge | | orderCurrency | Währungscode für den Auftrag und die Bestellpositionen. Das Aktualisieren des Währungscodes eines vorhandenen Auftrags wird nicht unterstützt. Wenn Sie einen anderen Wert als den Währungscode angeben, der dem Auftrag bereits zugeordnet ist, wird die Aktualisierung abgelehnt. Datentyp: Zeichenfolge | | productOrderItem | Liste, die die der Produktbestellung zugeordneten Elemente und die zugehörige Aktion beschreibt. Datentyp: Array{#tmf_prod_order-PATCH-productorder-id__prodOrdItem_data_type-p-tmf622} "productOrderItem": [ { "action": "String", "actionReason": "String", "committedDueDate": "String", "externalProductInventory": [Array], "id": "String", "itemPrice": [Array], "product": {Object}, "productOffering": {Object}, "productOrderItemRelationship": [Array], "quantity": Number, "revisionOperation": "String", "@type": "String" } ] {#tmf_prod_order-PATCH-productorder-id__prodOrdItem-codeblock-tmf622} Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item | | productOrderItem.action | Erforderlich, wenn der Parameter productOrderItem verwendet wird. Aktion, die für das Produkt ausgeführt werden soll. Mögliche Aktionen sind auf der Registerkarte „Auswahlliste" im Aktionswörterbucheintrag der Tabelle sn_ind_tmt_orm_order_line_item definiert. Mögliche Werte: * Hinzufügen * Change * delete * kein Change * resume * anhalten {#tmf_prod_order-PATCH-productorder-id__ul_zwn_nxp_ysb} Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-productorder-id__prodOrdItem_action_data_type-p-tmf622} Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item/action Standard: add | | „productOrderItem.actionReason" | Der Grund für das Hinzufügen der Auftragsposition. Datentyp: Zeichenfolge Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item/action_reason | | produktbestellelement.committedFälligkeitsdatum | Datum und Uhrzeit, zu der die Aktion für die Auftragsposition ausgeführt werden muss. Wenn die Aktion für das Element „ unterbrechen " oder „ fortsetzen" lautet, kann dieser Parameter nicht aktualisiert werden. Datentyp: Zeichenfolge Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item/committed_due_date | | Bestellelement.externerProduktbestand | Array von Objekten mit externen IDs für die Zuordnung zu den für den Auftrag erstellten Produktbeständen. Datentyp: Array "externalProductInventory": [ { "externalProductInventoryId": "String" } ] Hinweis: Zuvor wurde beim Erstellen eines PATCH-Auftrags mit einer bereits vorhandenen externen Produktbestands-ID der Vorgang abgebrochen und ein Fehler zurückgegeben. Mit dem Release Xanadu wird dieser Parameter einfach ignoriert, wenn eine vorhandene externe Produktbestands-ID angegeben und kein Fehler ausgegeben wird. | | Bestellelement.externalProductInventory.externalProductInventoryId | Externe ID, die dem Produktbestand zugeordnet werden soll. Datentyp: Zeichenfolge Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item/external_inventory_id und sn_prd_invt_product_inventory/sn_prd_invt_external_id | | productOrderItem.id | Erforderlich, wenn der Parameter productOrderItem verwendet wird. Eindeutiger Bezeichner der Position. Zu finden im Feld sn_ind_tmt_orm_external_id der Tabelle „Auftragspositionselement" \[sn_ind_tmt_orm_order_line_item\]. Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-productorder-id__prodOrdItem_id_data_type-p-tmf622} Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item/external_id Maximale Länge: 40 Standard: Leere Zeichenfolge | | Produktbestellungselement.Artikelpreis | Array von Objekten, die den dem Produkt zugeordneten Preis beschreiben Datentyp: Array{#tmf_prod_order-PATCH-productorder-id__itemPrice_data_type-p-tmf622} "itemPrice": [ { "price": {Object}, "priceType": "String", "recurringChargePeriod": "String" } ] {#tmf_prod_order-PATCH-productorder-id__itemPrice-codeblock-tmf622} Tabelle aktualisiert: sn_ind_tmt_orm_order Standard: Leere Zeichenfolge | | Produktbestellungselement.Artikelpreis.Preis | Beschreibung des Preises des zugeordneten Produkts. Datentyp: Objekt{#tmf_prod_order-PATCH-productorder-id__itemPrice_price_data_type-p-tmf622} "price": { "taxIncludedAmount": {Object} } {#tmf_prod_order-PATCH-productorder-id__itemPrice_price-codeblock-tmf622} Tabelle aktualisiert: sn_ind_tmt_orm_order_line_item Standard: Leere Zeichenfolge | | „productOrderItem.itemPrice.Preis.SteuerEnthalteneBetrag" | Beschreibung des Preises des zugehörigen Produkts, einschließlich Steuer. Datentyp: Objekt{#tmf_prod_order-PATCH-productorder-id__itemPrice_price_taxIncludedAmt_data_type-p-tmf622} "taxIncludedAmount": { "unit": "String", "value": Number } {#tmf_prod_order-PATCH-productorder-id__itemPrice_price_taxIncludedAmt-codeblock-tmf622} Tabelle aktualisiert: sn_ind_tmt_orm_order_line_item | | ProduktAuftragselement.Elementpreis.Preis.SteuerEnthaltenerBetrag.Einheit | Währungscode, in dem der Preis dargestellt wird. Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-productorder-id__itemPrice_price_taxIncludedAmt_unit_data_type-p-tmf622} Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item/mrc oder nrc | | ProduktAuftragselement.Elementpreis.Preis.SteuerEnthaltenerBetrag.Wert | Preis des Produkts, einschließlich Steuern. Datentyp: Zahl{#tmf_prod_order-PATCH-productorder-id__itemPrice_price_taxIncludedAmt_value_data_type-p-tmf622} Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item/mrc oder nrc | | „productOrderItem.itemPrice.PriceType" | Typ des Artikelpreises, wiederkehrend oder nicht wiederkehrend. Datentyp: Zeichenfolge | | „productOrderItem.itemPrice.recurringChargePeriod" | Wenn der Preis wiederkehrend ist, der wiederkehrende Zeitraum, z. B. Monat. Datentyp: Zeichenfolge | | ProduktBestellelement.Produkt | Erforderlich, wenn productOrderItem.action „ ändern" oder „löschen" ist. Beschreibung der Instanzdetails des vom Kunden erworbenen Produkts. Datentyp: Objekt{#tmf_prod_order-PATCH-productorder-id__product_data_type-p-tmf622} "product": { "id": "String", "place": {Object}, "productCharacteristic": [Array], "productSpecification": {Object}, "relatedParty": {Object}, "@type": "String" } {#tmf_prod_order-PATCH-productorder-id__product-codeblock-tmf622} Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item | | productOrderItem.product.id | Erforderlich, wenn productOrderItem.action „ ändern" oder „löschen" ist. Eindeutiger Bezeichner des verkauften Produkts. Befindet sich im Feld „sys_id" oder „sn_ind_tmt_orm_external_id" der Tabelle „Produktbestand" \[sn_ind_tmt_orm_product_inventory\]. Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-productorder-id__product_id_data_type-p-tmf622} Standard: Leere Zeichenfolge | | productOrderItem.product.place | Karten der Speicherorte, an denen das Produkt installiert werden soll. Datentyp: Objekt{#tmf_prod_order-PATCH-productorder-id__product_place_data_type-p-tmf622} "place": { "id": "String", "@type": "String" } {#tmf_prod_order-PATCH-productorder-id__product_place-codeblock-tmf622} Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item | | productOrderItem.product.place.id | Erforderlich, wenn der Parameter productOrderItem.product.place verwendet wird. Sys_id des zugeordneten Standortdatensatzes in der Standorttabelle \[cmn_location\]. Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-productorder-id__product_place_id_data_type-p-tmf622} Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item/location Standard: Leere Zeichenfolge | | productOrderItem.product.place.@type | Teil des TMF Open API-Standards. Anmerkung für den Kontakt des Bestellpositionselements. Dieser Wert ist immer Place. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | | productOrderItem.product.productMerkmal | Array von Objekten, die die Eigenschaften des zugeordneten Produkts beschreiben. Datentyp: Array{#tmf_prod_order-PATCH-productorder-id__prod_prodChar_data_type-p-tmf622} "productCharacteristic": [ { "name": "String", "previousValue": "String", "value": "String" } ] {#tmf_prod_order-PATCH-productorder-id__prod_prodChar-codeblock-tmf622} Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_characterist_value | | productOrderItem.product.productMerkmal.name | Name des Merkmaldatensatzes, der dem Produkt zugeordnet werden soll. Befindet sich in der Tabelle „Merkmal" \[sn_prd_pm_charakteristik\]. Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-productorder-id__prod_prodChar_name_data_type-p-tmf622} Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_charakterist_wert/merkmale Standard: Leere Zeichenfolge | | „productOrderItem.product.productFeature. previousValue" | Vorherige Merkmalsoptionswerte, wenn die Aktualisierung für einen Change-Auftrag erfolgt. Die Anforderung ist ein Change, wenn der Parameter productOrderItem.action etwas anderes als addist. Weitere Informationen zu Merkmalsoptionswerten finden Sie unter [Create product characteristics and characteristic options](https://www.servicenow.com/docs/access?context=som-product-config-add-characteristics&version=xanadu&pubname=xanadu-order-management&ft:locale=en-US). Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-productorder-id__prod_prodChar_previousValue_data_type-p-tmf622} Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_charakterist_wert/vorherige_charakterist_option_wert Standard: Leere Zeichenfolge | | productOrderItem.product.productMerkmal.Wert | Merkmaloptionswerte, die dem Produkt zugeordnet sind. Weitere Informationen zu Merkmalsoptionswerten finden Sie unter [Create product characteristics and characteristic options](https://www.servicenow.com/docs/access?context=som-product-config-add-characteristics&version=xanadu&pubname=xanadu-order-management&ft:locale=en-US). Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-productorder-id__prod_prodChar_value_data_type-p-tmf622} Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_charakterist_wert/charakterist_option_wert Standard: Leere Zeichenfolge | | productOrderItem.product.productSpecification | Beschreibung der Produktspezifikation, die dem Produkt zugeordnet ist. Hinweis: Change-Aufträge (productOrderItem.action ist `change`) werden je nach Wert der Systemeigenschaft sn_ind_tmt_orm.allowSpecVersionUpdateInChangeOrder unterschiedlich verarbeitet. Der Wert dieser Systemeigenschaft bestimmt, wie die Bestellung verarbeitet wird, wenn der Produktbestand eine andere Version aufweist als die im Auftrag angegebene. * Wenn diese Systemeigenschaft auf „true" (Standard) festgelegt ist, wird der Produktbestand automatisch auf die Version im Auftrag aktualisiert, indem die referenzierte Produktspezifikation geändert wird. Dadurch kann der Auftrag erfolgreich verarbeitet werden. * Wenn diese Systemeigenschaft auf „false" festgelegt ist und der Produktbestand eine andere Version als die in der Bestellung angegebene aufweist, schlägt die Bestellung aufgrund der Versionsabweichung fehl. {#tmf_prod_order-PATCH-productorder-id__ul_sgb_q5y_hbc} Datentyp: Objekt{#tmf_prod_order-PATCH-productorder-id__prod_prodSpec_data_type-p-tmf622} "productSpecification": { "id": "String", "internalVersion": "String", "name": "String", "version": "String", "@type": "String" } {#tmf_prod_order-PATCH-productorder-id__prod_prodSpec-codeblock-tmf622} Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item | | productOrderItem.product.productSpecification.id | Erforderlich, wenn der Parameter productOrderItem.product.productSpecification verwendet wird. Initial_version oder external_id der Produktspezifikation. initial_version ist die sys_id der ersten Version der Spezifikation. Befindet sich im Feld „sys_id" oder „external_id" der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. Datentyp: Zeichenfolge | | productOrderItem.product.productSpecification.interneVersion | Version der Produktspezifikation. Befindet sich in der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. Datentyp: Zeichenfolge | | productOrderItem.product.productSpecification.name | Name der Produktspezifikation. Befindet sich in der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. Datentyp: Zeichenfolge | | Produktbestellelement.Produkt.Produktspezifikation.Version | Externe_Version der Produktspezifikation. Befindet sich in der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. Datentyp: Zeichenfolge | | productOrderItem.product.productSpecification.@type | Teil des TMF Open API-Standards. Dieser Wert ist immer ProductSpecificationRef. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | | Bestellelement.Produkt.zugehörigePartei | Liste der Kontakte für Positionen. Datentyp: Array{#tmf_prod_order-PATCH-productorder-id__prod_relParty_data_type-p-tmf622} "relatedParty": [ { "email": "String", "firstName": "String", "id": "String", "lastName": "String", "phone": "String", "@referredType": "String", "@type": "String" } ] {#tmf_prod_order-PATCH-productorder-id__prod_relParty-codeblock-tmf622} Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item_contact | | ProduktBestellelement.Produkt.zugehörigePartei.E-Mail | E-Mail-Adresse des Kontakts Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-productorder-id__prod_relParty_email_data_type-p-tmf622} Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item_contact/email Standard: Leere Zeichenfolge | | Bestellelement.Produkt.zugehörigePartei.ersterName | Vorname des Kontakts Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-productorder-id__prod_relParty_firstName_data_type-p-tmf622} Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item_contact/first_name Standard: Leere Zeichenfolge | | productOrderItem.product.relatedParty.id | Sys_id des Einzelpostenkontakts, der der Auftragsposition zugeordnet ist. Befindet sich in der Tabelle „Auftragspositionselement -- Kontakt" \[sn_ind_tmt_orm_order_line_item_contact\]. Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-productorder-id__prod_relParty_id_data_type-p-tmf622} Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item_contact/sys_id Standard: Leere Zeichenfolge | | productOrderItem.product.relatedPartei.lastName | Nachname des Kontakts Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-productorder-id__prod_relParty_lastName_data_type-p-tmf622} Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item_contact/lastName Standard: Leere Zeichenfolge | | ProduktBestellelement.Produkt.zugehörigePartei.Telefon | Geschäftliche Telefonnummer des Kontakts Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-productorder-id__prod_relParty_phone_data_type-p-tmf622} Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item_contact/business_phone Standard: Leere Zeichenfolge | | „productOrderItem.product.relatedPartei.@referredType" | Typ des Kunden Möglicher Wert: OrderLineItemContact{#tmf_prod_order-PATCH-productorder-id__prod_relParty_refType-p-tmf622} Datentyp: Zeichenfolge | | productOrderItem.product.relatedPartei.@type | Teil des TMF Open API-Standards. Anmerkung für den Kontakt des Bestellpositionselements. Dieser Wert ist immer RelatedParty. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | | productOrderItem.product.@type | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer Produkt. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | | ProduktBestellelement.Produktangebot | Beschreibung des Produktangebots, das dem Produkt zugeordnet ist. Datentyp: Objekt{#tmf_prod_order-PATCH-productorder-id__prodOffer_data_type-p-tmf622} "productOffering": { "id": "String", "internalVersion": "String", "name": "String", "version": "String" } {#tmf_prod_order-PATCH-productorder-id__prodOffer-codeblock-tmf622} Tabelle aktualisiert: sn_ind_tmt_orm_order_line_item | | ProduktBestellelement.Produktangebot.ID | Erforderlich, wenn der Parameter productOrderItem.productOffering verwendet wird. Initial_version oder external_id des Produktangebots. initial_version ist die sys_id der ersten Version des Angebots. Zu finden im Feld „sys_id" oder „external_id" der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge | | ProduktBestellelement.Produktangebot.interneVersion | Version des Produktangebots. Befindet sich in der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge | | ProduktBestellelement.Produktangebot.Name | Name des Produktangebots Befindet sich in der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge | | ProduktBestellelement.Produktangebot.Version | Externe_Version des Produktangebots Befindet sich in der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge | | Produktbestellungselement.Produktbestellungselement.Menge | Anzahl der Artikel, die der Bestellung zugeordnet sind. Datentyp: Zahl{#tmf_prod_order-PATCH-productorder-id__prodOrdItem_quantity_data_type-p-tmf622} Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order/quantity Standard: null | | Produktbestellungselement.ProduktbestellungselementBeziehung | Array von Objekten, die die Beziehungen zwischen Bestellpositionen beschreiben. Datentyp: Array{#tmf_prod_order-PATCH-productorder-id__prodOrderItemRel_data_type-p-tmf622} "productOrderItemRelationship": [ { "id": "String", "relationshipType": "String" } ] {#tmf_prod_order-PATCH-productorder-id__prodOrderItemRel-codeblock-tmf622} Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item | | „productOrderItem.productOrderItemRelationship.id" | Erforderlich, wenn der Parameter productOrderItem.productOrderItemRelationship verwendet wird. Eindeutiger Bezeichner des zugehörigen Einzelpostens. Zu finden im Feld sn_ind_tmt_orm_external_id der Tabelle „Auftragspositionselement" \[sn_ind_tmt_orm_order_line_item\]. Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-productorder-id__prodOrderItemRel_id_data_type-p-tmf622} Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item/parent_line_item Standard: Leere Zeichenfolge | | „productOrderItem.productOrderItemRelationship.relationshipType" | Typ der Beziehung zwischen den beiden Einzelposten. Diese Informationen werden verwendet, um die Beziehungshierarchie zu identifizieren. Mögliche Werte: * HasChild * Hat übergeordnet * Erfordert {#tmf_prod_order-PATCH-productorder-id__ul_yqf_2ty_54b} `„HasChild"` und `„HasParent"` werden für Beziehungen zwischen über- und untergeordneten Elementen verwendet. „`Erfordert` " wird für horizontale Beziehungen verwendet (ein Einzelposten erfordert einen anderen Einzelposten). Datentyp: Zeichenfolge | | Produktbestellungselement.Menge | Anzahl der bestellten Artikel. Datentyp: Zahl Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order/quantity Standard: Leere Zeichenfolge | | productOrderItem.revisionOperation | Typ der Aktualisierung, die für die Position durchgeführt werden soll. Wenn dieser Wert leer ist, wird die vorhandene Position aktualisiert, oder es wird eine neue Position hinzugefügt, wenn sie noch nicht vorhanden ist. Wenn dieser Wert gleich „stornieren" ist, wird die Position storniert. Datentyp: Zeichenfolge Standard: Leere Zeichenfolge | | produktBestellelement.@type | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer ProductOrderItem. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | | Zugehörige Partei | Liste der Kontakte für den Auftrag. Jeder Kontakt ist ein Objekt im Array. Muss mindestens ein Element aufführen, das Informationen zu Kunden- oder Verbraucherkonten enthält. Datentyp: Array{#tmf_prod_order-PATCH-productorder-id__relatedParty_data_type-p-tmf622} "relatedParty": [ { "id": "String", "name": "String", "@referredType": "String", "@type": "String" } ] {#tmf_prod_order-PATCH-productorder-id__relatedParty-codeblock-tmf622} | | Zugehörigepartei.id | Sys_id oder external_id des Accounts, Kundenkontakts oder Verbrauchers, der dem Auftrag zugeordnet ist. Zu finden in der Tabelle „Account" \[customer_account\], „Kontakt" \[customer_contact\] oder „Verbraucher" \[csm_consumer\]. Datentyp: Zeichenfolge | | Zugehörigepartei.name | Name des Accounts, Kunden oder Verbrauchers. Datentyp: Zeichenfolge | | zugehörigepartei.@referenztyp | Typ des Kunden Mögliche Werte: * Verbraucher * Kunde * Kundenkontakt {#tmf_prod_order-PATCH-productorder-id__ul_lcq_jwm_t4b} Datentyp: Zeichenfolge | | zugehörigepartei.@typ | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer RelatedParty. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | | RequestedCompletionDate | Vom Kunden angefordertes Lieferdatum Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-productorder-id__reqCompDate_data_type-p-tmf622} Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order/expected_end_date Standard: Leere Zeichenfolge | | Angefordertes Startdatum | Vom Kunden angefordertes Auftragsstartdatum. Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-productorder-id__reqStartDate_data_type-p-tmf622} Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order/expected_start_date Standard: Leere Zeichenfolge | | @type | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer ProductOrder. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | [Tabelle : 33. Parameter des Anforderungstexts (JSON)] {#tmf_prod_order-PATCH-productorder-id__id_vk2_p5n_t4b} ### Kopfzeilen Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST API verwendet werden, finden Sie unter [Unterstützte REST API-Header](https://www.servicenow.com/docs/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können."). {#tmf_prod_order-PATCH-productorder-id__table_omb_dvk_5rb__entry__2}{#tmf_prod_order-PATCH-productorder-id__accept-JSON-only-entry-RESTAPI}{#tmf_prod_order-PATCH-productorder-id__content_type-JSON-only-entry-RESTAPI} | Kopfzeile | Beschreibung | |-|-| | Akzeptieren | Datenformat des Antworttexts. Unterstützt nur application/json. | | Content-Type | Datenformat des Anforderungstexts. Unterstützt nur application/json. | [Tabelle : 34. Anforderungskopfzeilen] {#tmf_prod_order-PATCH-productorder-id__table_omb_dvk_5rb} {#tmf_prod_order-PATCH-productorder-id__table_tzy_thy_ksb__entry__2} | Kopfzeile | Beschreibung | |-|-| | Inhaltstyp | Datenformat des Antworttexts. Unterstützt nur application/json. | [Tabelle : 35. Antwortkopfzeilen] {#tmf_prod_order-PATCH-productorder-id__table_tzy_thy_ksb} ### Statuscodes Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST API verwendet werden, finden Sie unter [HTTP-Antwortcodes](https://www.servicenow.com/docs/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API. {#tmf_prod_order-PATCH-productorder-id__table_xfv_2vk_5rb__entry__2} | Statuscode | Beschreibung | |-|-| | 201 | Erfolgreich. Wenn Probleme mit den Merkmalen oder Merkmalsoptionsinformationen auftreten, speichert der Endpunkt die folgenden Kommentare in den Arbeitsnotizen-Feldern des zugehörigen Kundenauftragspositionselement-Datensatzes: * Die folgenden Merkmale für Bestellelemente sind nicht vorhanden: Überprüfen Sie die Spezifikation \, und korrigieren Sie das Merkmal und die Merkmalsoption in der Auftragsposition, bevor Sie den Auftrag genehmigen. * Merkmal des Bestellelements: \ mit Merkmalswert: \ist ungültig. Korrigieren Sie die Merkmalswerte, bevor Sie den Auftrag genehmigen. {#tmf_prod_order-PATCH-productorder-id__ul_xtx_xym_t4b} | | 400 | Ungültige Anforderung. Kann einer der folgenden Gründe sein: * Ungültige Nutzlast: Anforderungstext fehlt -- Nutzlast wurde im Anforderungstext nicht übergeben. * Ungültige Nutzlast: productOrderItem fehlt -- Objekt für Produktauftragsposition oder JSON fehlt. * Ungültige Nutzlast: productOrderItem-ID fehlt -- Der Parameter id fehlt in der Produktbestellposition der Nutzlast. * Ungültige Nutzlast: Aktion „productOrderItem" fehlt -- Der Parameter action fehlt in der Produktbestellposition der Nutzlast. * Ungültige Nutzlast: productOrderItem Produktangebot fehlt -- Das Produktangebotsobjekt oder JSON fehlt in der Produktbestellposition in der Nutzlast. * Ungültige Nutzlast: Produktangebots-ID fehlt -- Der Parameter id fehlt in der Produktbestellposition des Produktangebotsobjekts in der Nutzlast. * Ungültige Nutzlast: Produktangebot ist nicht vorhanden -- Das Produktangebot in der Produktauftragsposition ist nicht gültig. * Ungültige Nutzlast: Produkt „productOrderItem" fehlt : Das Produktobjekt oder JSON in der Produktauftragsposition fehlt in der Nutzlast. * Ungültige Nutzlast: Produkt, Produktspezifikation fehlt -- Das Produktspezifikationsobjekt oder JSON in der Produktbestellposition fehlt in der Nutzlast. * Ungültige Nutzlast: Produktspezifikations-ID fehlt -- Der Parameter id in der Produktbestellposition des Produktspezifikationsobjekts fehlt in der Nutzlast. * Ungültige Nutzlast: Produktspezifikation ist nicht vorhanden -- Die Produktspezifikation in der Produktauftragsposition ist ungültig. * Ungültige Nutzlast: Produktbestand nicht vorhanden -- In einem Change-Auftrag (Aktion = Change) ist die Menge eines Artikels größer als der Bestand. * Ungültige Nutzlast: Produktbestands-ID fehlt -- in einem Change-Auftrag fehlt product.id in der Nutzlast. * Ungültige Nutzlast: Verkauftes Produkt ist inaktiv -- In einem Change-Auftrag ist ein in der Nutzlast angegebenes Produkt inaktiv. * Ungültige Nutzlast: „relatedParty" fehlt : Das Objekt der zugehörigen Partei fehlt in der Nutzlast. * Ungültige Nutzlast: Kunden-Account oder Verbraucher fehlt -- Das Kunden- oder Verbraucherobjekt der zugehörigen Partei fehlt in der Nutzlast. * Ungültige Nutzlast: Verbraucher nicht vorhanden -- Der angegebene Verbraucher der zugehörigen Partei ist in der Instanz ServiceNow nicht vorhanden. * Ungültige Nutzlast: Kunden-Account nicht vorhanden -- Der angegebene zugehörige Vertragspartei-Kunde ist in der Instanz ServiceNow nicht vorhanden. * Ungültige Nutzlast: Auftragserstellung fehlgeschlagen -- Der angeforderte Auftrag kann nicht erstellt werden. * Ungültige Nutzlast: Dieser Auftrag muss noch in der Kundenauftragstabelle erstellt werden. Weitere Details finden Sie in der eingehenden Warteschlange. Die Patch-Anforderung wurde für einen Auftrag gestellt, der sich noch nicht in der Kundenauftragstabelle befindet. Der Auftrag befindet sich in der Tabelle „Eingehende Warteschlange" \[sn_tmt_core_inbound_queue\] und wartet darauf, dass der Planer den zu verarbeitenden Datensatz auswählt. * Ungültige Nutzlast: Die Patch-Anforderung kann nicht gestellt werden, da der Erfüllungstyp des Auftrags nicht „liefern" ist. Die Patch-Anforderung wurde für einen Auftrag gestellt, der einen anderen Erfüllungstyp als deliverhat. {#tmf_prod_order-PATCH-productorder-id__ul_g2v_rzm_t4b} | [Tabelle : 36. Statuscodes] {#tmf_prod_order-PATCH-productorder-id__table_xfv_2vk_5rb} ### Parameter des Antwort-Haupttexts (JSON) {#tmf_prod_order-PATCH-productorder-id__section_b1v_xpk_5rb} {#tmf_prod_order-PATCH-productorder-id__table_c1v_xpk_5rb__entry__2} | Name | Beschreibung | |-|-| | channel | Array von Objekten, die die Kanäle beschreiben, die für den Verkauf der Produkte verwendet werden sollen Datentyp: Array "channel": [ { "id": "String", "name": "String" } ] | | channel.id | Eindeutiger Bezeichner des Kanals, der für den Verkauf der zugehörigen Produkte verwendet werden soll. Kanal-ID-Werte befinden sich im Feld „external_id" der Tabelle „Verteilungskanal" \[sn_prd_pm_distribution_channel\]. Datentyp: Zeichenfolge | | Kanalname | Name des Kanals, der für den Verkauf der zugehörigen Produkte verwendet werden soll. Datentyp: Zeichenfolge | | id | Sys_id des Kundenauftrags für diese Anforderung aktualisiert. Datentyp: Zeichenfolge | | externalId | Externer Bezeichner für den Kundenauftrag, z. B. eine Bestellnummer. Datentyp: Zeichenfolge | | Hinweis | Array von Objekten, die zusätzliche Notizen beschreiben, die der Kunde bei der Bestellung gemacht hat. Datentyp: Array "note": [ { "text": "String" } ] | | Anmerkung.Text | Zusätzliche Hinweise/Kommentare vom Kunden während der Bestellung. Datentyp: Zeichenfolge | | productOrderItem | Liste, die die der Produktbestellung zugeordneten Elemente und die zugehörige Aktion beschreibt. Datentyp: Array "productOrderItem:" [ { "action": "String", "actionReason": "String", "id": "String", "itemPrice": [Array], "product": {Object}, "productOffering": {Object}, "productOrderItemReleationship": [Array], "quantity": Number, "state": "String", "@type": "String" } ] | | productOrderItem.action | Aktion, die für das Produkt ausgeführt werden soll. Mögliche Aktionen sind auf der Registerkarte „Auswahlliste" im Aktionswörterbucheintrag der Tabelle sn_ind_tmt_orm_order_line_item definiert. Datentyp: Zeichenfolge | | „productOrderItem.actionReason" | Der Grund für das Hinzufügen der Auftragsposition. Datentyp: Zeichenfolge Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item/action_reason | | productOrderItem.id | Eindeutiger Bezeichner der Position. Zu finden im Feld sn_ind_tmt_orm_external_id der Tabelle „Auftragspositionselement" \[sn_ind_tmt_orm_order_line_item\]. Datentyp: Zeichenfolge | | Produktbestellungselement.Artikelpreis | Array von Objekten, die den dem Produkt zugeordneten Preis beschreiben Datentyp: Array "itemPrice": [ { "price": {Object}, "priceType": "String", "recurringChargePeriod": "String" } ] | | Produktbestellungselement.Artikelpreis.Preis | Beschreibung des Preises des zugeordneten Produkts. Datentyp: Objekt "price": { "taxIncludedAmount": {Object} } | | „productOrderItem.itemPrice.Preis.SteuerEinschlussBetrag" | Beschreibung des Preises des zugehörigen Produkts, einschließlich Steuer. Datentyp: Objekt "taxIncludedAmount": { "unit": "String", "value": Number } | | ProduktAuftragselement.Elementpreis.Preis.SteuerEinschlussBetrag.Einheit | Währungscode, in dem der Preis dargestellt wird. Datentyp: Zeichenfolge | | ProduktAuftragselement.Elementpreis.Preis.SteuerEinschlussBetrag.Wert | Preis des Produkts, einschließlich Steuern. Datentyp: Zahl | | „productOrderItem.itemPrice.PriceType" | Typ des Artikelpreises, wiederkehrend oder nicht wiederkehrend. Datentyp: Zeichenfolge | | „productOrderItem.itemPrice.recurringChargePeriod" | Wenn der Preis wiederkehrend ist, der wiederkehrende Zeitraum, z. B. Monat. Datentyp: Zeichenfolge | | ProduktBestellelement.Produkt | Beschreibung der Instanzdetails des vom Kunden erworbenen Produkts. Datentyp: Objekt "product": { "id": "String", "place": {Object}, "productCharacteristic": [Array], "productSpecification": {Object}, "relatedParty": {Object}, "@type": "String" } | | productOrderItem.product.id | Eindeutiger Bezeichner des verkauften Produkts. Befindet sich im Feld „sys_id" oder „sn_ind_tmt_orm_external_id" der Tabelle „Produktbestand" \[sn_ind_tmt_orm_product_inventory\]. Datentyp: Zeichenfolge | | productOrderItem.product.place | Karten der Speicherorte, an denen das Produkt installiert werden soll. Datentyp: Objekt "place": { "id": "String", "@type": "String" } | | productOrderItem.product.place.id | Sys_id des zugeordneten Standortdatensatzes in der Standorttabelle \[cmn_location\]. Datentyp: Zeichenfolge | | productOrderItem.product.productMerkmal | Array von Objekten, die die Eigenschaften des zugeordneten Produkts beschreiben. Datentyp: Array "productCharacteristic": [ { "name": "String", "previousValue": "String", "value": "String" } ] | | productOrderItem.product.productCharacteristic.name | Name des Merkmaldatensatzes, der dem Produkt zugeordnet werden soll. Befindet sich in der Tabelle „Merkmal" \[sn_prd_pm_charakteristik\]. Datentyp: Zeichenfolge | | „productOrderItem.product.productFeature. previousValue" | Vorherige Merkmalsoptionswerte, wenn die Aktualisierung für einen Change-Auftrag erfolgt. Die Anforderung ist ein Change, wenn der Parameter productOrderItem.action etwas anderes als addist. Weitere Informationen zu Merkmalsoptionswerten finden Sie unter [Create product characteristics and characteristic options](https://www.servicenow.com/docs/access?context=som-product-config-add-characteristics&version=xanadu&pubname=xanadu-order-management&ft:locale=en-US). Datentyp: Zeichenfolge | | productOrderItem.product.productMerkmal.Wert | Merkmaloptionswerte, die dem Produkt zugeordnet sind. Weitere Informationen zu Merkmalsoptionswerten finden Sie unter [Create product characteristics and characteristic options](https://www.servicenow.com/docs/access?context=som-product-config-add-characteristics&version=xanadu&pubname=xanadu-order-management&ft:locale=en-US). Datentyp: Zeichenfolge | | productOrderItem.product.productSpecification | Beschreibung der Produktspezifikation, die dem Produkt zugeordnet ist. Datentyp: Objekt "productSpecification": { "id": "String", "internalVersion": "String", "name": "String", "version": "String", "@type": "String" } | | productOrderItem.product.productSpecification.id | Initial_version oder external_id der Produktspezifikation. initial_version ist die sys_id der ersten Version der Spezifikation. Befindet sich im Feld „sys_id" oder „external_id" der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. Datentyp: Zeichenfolge | | productOrderItem.product.productSpecification.name | Name der Produktspezifikation. Befindet sich in der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. Datentyp: Zeichenfolge | | productOrderItem.product.productSpecification.@type | Teil des TMF Open API-Standards. Dieser Wert ist immer ProductSpecificationRef. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | | Bestellelement.Produkt.zugehörigePartei | Liste der Kontakte für Positionen. Datentyp: Array "relatedParty": [ { "email": "String", "firstName": "String", "id": "String", "lastName": "String", "phone": "String", "@referredType": "String", "@type": "String" } ] | | productOrderItem.product.relatedParty.email | E-Mail-Adresse des Kontakts Datentyp: Zeichenfolge | | Bestellelement.Produkt.zugehörigePartei.ersterName | Vorname des Kontakts Datentyp: Zeichenfolge | | productOrderItem.product.relatedParty.id | Sys_id des Einzelpostenkontakts, der der Auftragsposition zugeordnet ist. Befindet sich in der Tabelle „Auftragspositionselement -- Kontakt" \[sn_ind_tmt_orm_order_line_item_contact\]. Datentyp: Zeichenfolge | | productOrderItem.product.relatedPartei.lastName | Nachname des Kontakts Datentyp: Zeichenfolge Datentyp: Zeichenfolge | | productOrderItem.product.relatedParty.phone | Geschäftliche Telefonnummer des Kontakts Datentyp: Zeichenfolge | | „productOrderItem.product.relatedPartei.@referredType" | Typ des Kunden Möglicher Wert: OrderLineItemContact Datentyp: Zeichenfolge | | productOrderItem.product.relatedPartei.@type | Teil des TMF Open API-Standards. Anmerkung für den Kontakt des Bestellpositionselements. Dieser Wert ist immer RelatedParty. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | | productOrderItem.product.@type | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer Produkt. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | | ProduktBestellelement.Produktangebot | Beschreibung des Produktangebots, das dem Produkt zugeordnet ist. Datentyp: Objekt "productOffering": { "id": "String", "internalVersion": "String", "name": "String", "version": "String" } | | productOrderItem.productOffering.id | Initial_version oder external_id des Produktangebots. initial_version ist die sys_id der ersten Version des Angebots. Zu finden im Feld „sys_id" oder „external_id" der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge | | productOrderItem.productOffering.name | Name des Produktangebots Befindet sich in der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge | | Produktbestellungselement.ProduktbestellungselementBeziehung | Array von Objekten, die die Beziehungen zwischen Bestellpositionen beschreiben. Datentyp: Array "productOrderItemRelationship": [ { "id": "String", "relationshipType": "String" } ] | | productOrderItem.productOrderItemRelationship.id | Eindeutiger Bezeichner des zugehörigen Einzelpostens. Zu finden im Feld sn_ind_tmt_orm_external_id der Tabelle „Auftragspositionselement" \[sn_ind_tmt_orm_order_line_item\]. Datentyp: Zeichenfolge | | „productOrderItem.productOrderItemRelationship.relationshipType" | Typ der Beziehung zwischen den beiden Einzelposten. Diese Informationen werden verwendet, um die Beziehungshierarchie zu identifizieren. Datentyp: Zeichenfolge | | Produktbestellungselement.Menge | Anzahl der Artikel, die der Bestellung zugeordnet sind. Datentyp: Zahl | | „productOrderItem.state" | Aktueller Status des Produktbestellartikels. Datentyp: Zeichenfolge | | produktBestellelement.@type | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer ProductOrderItem. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | | Zugehörige Partei | Liste der Kontakte für den Auftrag. Jeder Kontakt ist ein Objekt im Array. Muss mindestens ein Element aufführen, das Informationen zu Kunden- oder Verbraucherkonten enthält. Datentyp: Array "relatedParty": [ { "id": "String", "name": "String", "@referredType": "String", "@type": "String" } ] | | relatedParty.id | Sys_id oder external_id des Accounts, Kundenkontakts oder Verbrauchers, der dem Auftrag zugeordnet ist. Zu finden in der Tabelle „Account" \[customer_account\], „Kontakt" \[customer_contact\] oder „Verbraucher" \[csm_consumer\]. Datentyp: Zeichenfolge | | relatedParty.name | Name des Accounts, Kunden oder Verbrauchers. Datentyp: Zeichenfolge | | ZugehörigePartei.Typ | Typ des Kunden Mögliche Werte: * Verbraucher * Kunde * Kundenkontakt {#tmf_prod_order-PATCH-productorder-id__d2876e2462} Datentyp: Zeichenfolge | | RequestedCompletionDate | Vom Kunden angefordertes Lieferdatum Datentyp: Zeichenfolge | | Angefordertes Startdatum | Vom Kunden angefordertes Auftragsstartdatum. Datentyp: Zeichenfolge | | Staat | Aktueller Status des Auftrags. Datentyp: Zeichenfolge | | @type | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer ProductOrder. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | [ ] {#tmf_prod_order-PATCH-productorder-id__table_c1v_xpk_5rb} ### cURL-Anforderung {#tmf_prod_order-PATCH-productorder-id__example_jsc_1dc_vrb} Im folgenden Codebeispiel wird der Kanal für einen Kundenauftrag aktualisiert. curl -X PATCH "https://instance.servicenow.com/api/sn_ind_tmt_orm/productorder/6be0a925c3a220103e2e73ce3640ddfe" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -u "username":"password" \ -d { "channel": [ { "id": "1", "name": "Agent Assist" } ] } Antworttext. { "requestedCompletionDate": "2021-05-02T08:13:59.506Z", "requestedStartDate": "2020-05-03T08:13:59.506Z", "externalId": "PO-456", "channel": [ { "id": "1", "name": "Agent Assist" } ], "note": [ { "text": "This is a TMF product order illustration" }, { "text": "This is a TMF product order illustration no 2" } ], "productOrderItem": [ { "id": "POI100", "quantity": 1, "action": "change", "actionReason":"adding service package OLI", "product": { "id": "fa6d13f45b5620102dff5e92dc81c77f", "@type": "Product", "productSpecification": { "id": "cfe5ef6a53702010cd6dddeeff7b12f6", "name": "SD-WAN Service Package", "@type": "ProductSpecificationRef" }, "place": { "id": "25ab9c4d0a0a0bb300f7dabdc0ca7c1c", "@type": "Place" } }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering" }, "productOrderItemRelationship": [ { "id": "POI120", "relationshipType": "HasChild" }, { "id": "POI130", "relationshipType": "HasChild" } ], "@type": "ProductOrderItem", "state": "new" }, { "id": "POI120", "quantity": 1, "action": "change", "actionReason":"adding service package OLI", "itemPrice": [ { "priceType": "recurring", "recurringChargePeriod": "month", "price": { "taxIncludedAmount": { "unit": "USD", "value": 20 } } } ], "product": { "id": "766d13f45b5620102dff5e92dc81c78a", "@type": "Product", "productCharacteristic": [ { "name": "WAN Optimization", "value": "Base", "previousValue": "Advance" } ], "productSpecification": { "id": "39b627aa53702010cd6dddeeff7b1202", "name": "SD-WAN Edge Device", "@type": "ProductSpecificationRef" }, "relatedParty": [ { "id": "51670151c35420105252716b7d40ddfe", "firstName": "Joe", "lastName": "Doe", "email": "abc@example.com", "phone": "1234567890", "@type": "RelatedParty", "@referredType": "OrderLineItemContact" } ], "place": { "id": "25ab9c4d0a0a0bb300f7dabdc0ca7c1c", "@type": "Place" } }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering" }, "productOrderItemRelationship": [ { "id": "POI100", "relationshipType": "HasParent" } ], "@type": "ProductOrderItem", "state": "new" }, { "id": "POI130", "quantity": 1, "action": "add", "actionReason":"adding service package OLI", "itemPrice": [ { "priceType": "recurring", "recurringChargePeriod": "month", "price": { "taxIncludedAmount": { "unit": "USD", "value": 20 } } } ], "product": { "@type": "Product", "productCharacteristic": [ { "name": "Security Type", "value": "Base", "previousValue": "Advance" } ], "productSpecification": { "id": "a6514bd3534560102f18ddeeff7b1247", "name": "SD-WAN Security", "@type": "ProductSpecificationRef" }, "relatedParty": [ { "id": "51670151c35420105252716b7d40ddfe", "firstName": "Joe", "lastName": "Doe", "email": "abc@example.com", "phone": "1234567890", "@type": "RelatedParty", "@referredType": "OrderLineItemContact" } ], "place": { "id": "25ab9c4d0a0a0bb300f7dabdc0ca7c1c", "@type": "Place" } }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering" }, "productOrderItemRelationship": [ { "id": "POI100", "relationshipType": "HasParent" } ], "@type": "ProductOrderItem", "state": "new" } ], "relatedParty": [ { "id": "eaf68911c35420105252716b7d40ddde", "name": "Sally Thomas", "@type": "RelatedParty", "@referredType": "CustomerContact" }, { "id": "ffc68911c35420105252716b7d40dd55", "name": "Funco Intl", "@type": "RelatedParty", "@referredType": "Customer" }, { "id": "59f16de1c3b67110ff00ed23a140dd9e", "name": "Funco External", "@type": "RelatedParty", "@referredType": "Consumer" } ], "@type": "ProductOrder", "id": "6be0a925c3a220103e2e73ce3640ddfe", "state": "in_progress" } ## Open API für Produktbestellung -- POST /sn_ind_tmt_orm/cancelproductorder {#ariaid-title8} Storniert den angegebenen Kundenauftrag. ### URL-Format Standard-URL: /api/sn_ind_tmt_orm/cancelproductorder ### Unterstützte Anforderungsparameter {#tmf_prod_order-POST-cancelproductorder__entry__2} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 37. Pfadparameter] {#tmf_prod_order-POST-cancelproductorder__entry__6} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 38. Abfrageparameter] {#tmf_prod_order-POST-cancelproductorder__entry__10} | Name | Beschreibung | |-|-| | Stornierungsgrund | Grund für Abbruch. Datentyp: Zeichenfolge Standard: Leere Zeichenfolge | | Produktbestellung | Enthält Daten zur Produktbestellung. Datentyp: Objekt "productOrder": { "id": "String", "href": "String", "@referredType": "String" } | | productOrder.id | Erforderlich. Sys_id des zu stornierenden Kundenauftrags. Befindet sich in der Tabelle „Kundenauftrag" \[sn_ind_tmt_orm_order\]. Datentyp: Zeichenfolge | | „productOrder.href" | URL des zu stornierenden Kundenauftrags. Datentyp: Zeichenfolge Standard: Leere Zeichenfolge | | productOrder.@referredType | Der Wert für diesen Parameter muss `ProductOrder`sein. Datentyp: Zeichenfolge Standard: Leere Zeichenfolge | | RequestCancelationDate | Datum, bis zu dem der Auftrag storniert werden soll. Datentyp: Zeichenfolge Standard: Leere Zeichenfolge | | @type | Der Wert für diesen Parameter muss `CancelProductOrder`sein. Datentyp: Zeichenfolge Standard: Leere Zeichenfolge | [Tabelle : 39. Parameter des Anforderungstexts (JSON)] ### Header Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST API verwendet werden, finden Sie unter [Unterstützte REST API-Header](https://www.servicenow.com/docs/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können."). {#tmf_prod_order-POST-cancelproductorder__table_omb_dvk_5rb__entry__2}{#tmf_prod_order-POST-cancelproductorder__accept-JSON-only-entry-RESTAPI}{#tmf_prod_order-POST-cancelproductorder__content_type-JSON-only-entry-RESTAPI} | Kopfzeile | Beschreibung | |-|-| | Akzeptieren | Datenformat des Antworttexts. Unterstützt nur application/json. | | Content-Type | Datenformat des Anforderungstexts. Unterstützt nur application/json. | [Tabelle : 40. Anforderungskopfzeilen] {#tmf_prod_order-POST-cancelproductorder__table_omb_dvk_5rb} {#tmf_prod_order-POST-cancelproductorder__table_tzy_thy_ksb__entry__2} | Kopfzeile | Beschreibung | |-|-| | Inhaltstyp | Datenformat des Antworttexts. Unterstützt nur application/json. | [Tabelle : 41. Antwortkopfzeilen] {#tmf_prod_order-POST-cancelproductorder__table_tzy_thy_ksb} ### Statuscodes Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST API verwendet werden, finden Sie unter [HTTP-Antwortcodes](https://www.servicenow.com/docs/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API. {#tmf_prod_order-POST-cancelproductorder__entry__36} | Statuscode | Beschreibung | |-|-| | 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. | | 400 | Ungültige Anforderung. Kann einer der folgenden Gründe sein: * Leere Nutzlast. * Ungültige Nutzlast. Pflichtfeld fehlt:\ . * Ungültige Auftrags-ID. * Ungültige Auftrags-ID: Dieser Auftrag muss noch in der Kundenauftragstabelle erstellt werden. Die Stornierungsanforderung wurde für einen Auftrag gestellt, der noch nicht erstellt wurde. Der Auftrag befindet sich in der Tabelle „Eingehende Warteschlange" \[sn_tmt_core_inbound_queue\] und wartet darauf, dass der Planer den Datensatz abruft. {#tmf_prod_order-POST-cancelproductorder__ul_lg1_5vt_5rb} | [Tabelle : 42. Statuscodes] ### Parameter des Antwort-Haupttexts (JSON) {#tmf_prod_order-POST-cancelproductorder__entry__42} | Name | Beschreibung | |-|-| | Stornierungsgrund | Grund für Abbruch. Datentyp: Zeichenfolge | | href | URL des stornierten Auftrags. Datentyp: Zeichenfolge | | id | Sys_id des stornierten Auftrags. Datentyp: Zeichenfolge | | Produktbestellung | Enthält Daten zur Produktbestellung. Datentyp: Objekt "productOrder": { "id": "String", "href": "String", "@referredType": "String" } | | Produktbestell.ID | Sys_id des stornierten Auftrags. Datentyp: Zeichenfolge | | „productOrder.href" | URL des stornierten Auftrags. Datentyp: Zeichenfolge | | productOrder.@referredType | Der Wert für diesen Parameter ist `ProductOrder`. Datentyp: Zeichenfolge | | RequestCancelationDate | Datum, bis zu dem der Auftrag storniert werden soll. Datentyp: Zeichenfolge | | Staat | Status des Abbruchs. Wenn die Abbruchanforderung erfolgreich verarbeitet wurde (Statuscode 201), ist der Wert für diesen Parameter `fertig`. Datentyp: Zeichenfolge | | @type | Der Wert für diesen Parameter ist `CancelProductOrder`. Datentyp: Zeichenfolge | [ ] ### cURL-Anforderung Das folgende Codebeispiel storniert einen Kundenauftrag. curl -X POST "https://instance.servicenow.com/api/sn_ind_tmt_orm/cancelproductorder" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -u "username":"password" \ -d { "cancellationReason": "Duplicate order", "requestedCancellationDate": "2019-04-30T12:56:21.931Z", "productOrder": { "id": "163ee2805358811032a4ddeeff7b122d", "href": "https://instance.servicenow.com/productOrderingManagement/v4/productOrder/64a9607feb45301032a442871352285b", "@referredType": "ProductOrder" }, "@type": "CancelProductorder" } { "id": "163ee2805358811032a4ddeeff7b122d", "href": "https://instance.servicenow.com/productOrderingManagement/v4/productOrder/64a9607feb45301032a442871352285b", "cancellationReason": "Duplicate order", "requestedCancellationDate": "2019-04-30T12:56:21.931Z", "@type": "CancelProductorder", "productOrder": { "id": "163ee2805358811032a4ddeeff7b122d", "href": "https://instance.servicenow.com/productOrderingManagement/v4/productOrder/64a9607feb45301032a442871352285b", "@referredType": "ProductOrder" }, "state": "done" } ## Open API für Produktbestellung -- POST /sn_ind_tmt_orm/order/productOrder {#ariaid-title9} Erstellt den angegebenen Kundenauftrag und die Kundenauftragspositionen. Nach der Verarbeitung werden Datensätze in den folgenden Tabellen erstellt: * Kundenbestellung \[sn_ind_tmt_orm_order\] * Bestellmerkmal \[sn_ind_tmt_orm_order_characterist_value\] * Bestellposition \[sn_ind_tmt_orm_order_line_item\] * Auftragspositionselement -- Kontakt \[sn_ind_tmt_orm_order_line_item_contact\] * Zugehörige Elemente der Bestellposition \[sn_ind_tmt_orm_order_line_related_items\] {#tmf_prod_order-POST-ord-productOrder__ul_hxq_vdb_hqb} ### URL-Format Standard-URL: /api/sn_ind_tmt_orm/order/productOrder ### Unterstützte Anforderungsparameter {#tmf_prod_order-POST-ord-productOrder__entry__2} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 43. Pfadparameter] {#tmf_prod_order-POST-ord-productOrder__entry__6} | Name | Beschreibung | |-|-| | Modus | Aktiviert die asynchrone Auftragsverarbeitung.​ Das heißt, der Auftrag wird der zu erstellenden Tabelle „Eingehende Warteschlange" \[sn_tmt_core_inbound_queue\] hinzugefügt. Wenn nicht enthalten, wird der Auftrag synchron verarbeitet. Möglicher Wert: asynchron Datentyp: Zeichenfolge | [Tabelle : 44. Abfrageparameter] {#tmf_prod_order-POST-ord-productOrder__id_vk2_p5n_t4b__entry__2}{#tmf_prod_order-POST-ord-productOrder__due-date-entry}{#tmf_prod_order-POST-ord-productOrder__productOrder-href-request}{#tmf_prod_order-POST-ord-productOrder__productOrder-addReason-request}{#tmf_prod_order-POST-ord-productOrder__due-date-item-entry}{#tmf_prod_order-POST-ord-productOrder__externalProductInventory-GET-desc-request}{#tmf_prod_order-POST-ord-productOrder__externalProductInventoryId-desc} | Name | Beschreibung | |-|-| | channel | Array von Objekten, die die Kanäle beschreiben, die für den Verkauf der Produkte verwendet werden sollen Datentyp: Array "channel": [ { "id": "String", "name": "String" } ] Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order | | channel.id | Erforderlich. Eindeutiger Bezeichner des Kanals, der für den Verkauf der zugehörigen Produkte verwendet werden soll. Kanal-ID-Werte befinden sich im Feld „ external_id " der Tabelle „Verteilungskanal" \[sn_prd_pm_distribution_channel\]. Datentyp: Zeichenfolge Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order/channel Standard: Leere Zeichenfolge | | Kanalname | Name des Kanals, der für den Verkauf der zugehörigen Produkte verwendet werden soll. Mögliche Kanalnamen sind auf der Registerkarte „Auswahlliste" im Wörterbucheintrag „Kanal " der Tabelle „ sn_ind_tmt_orm_order " definiert. Datentyp: Zeichenfolge Standard: Leere Zeichenfolge | | committedDueDate | Datum und Uhrzeit, zu der die Aktion für den Auftrag ausgeführt werden muss. Dieser Wert muss mit den committedDueDate -Werten für jede Bestellposition übereinstimmen oder später als diese sein. Datentyp: Zeichenfolge Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order/committed_due_date | | externalId | Eindeutiger Bezeichner für den Kundenauftrag. Dieser Wert wird von einem externen System bestimmt. Datentyp: Zeichenfolge Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order/external_id Standard: Leere Zeichenfolge | | href | Ein relativer Link zum Ressourcendatensatz. Datentyp: Zeichenfolge Standard: Leere Zeichenfolge | | Hinweis | Array von Objekten, die zusätzliche Notizen enthalten, die der Kunde bei der Bestellung gemacht hat. Datentyp: Array "note": [ { "text": "String" } ] Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order | | Anmerkung.Text | Erforderlich. Zusätzliche Hinweise/Kommentare vom Kunden während der Bestellung. Datentyp: Zeichenfolge Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order/comments Standard: Leere Zeichenfolge | | orderCurrency | Erforderlich. Währungscode für den Auftrag und die Bestellpositionen. Die Währung muss für alle Elemente des Auftrags und der Bestellpositionen identisch sein. Andernfalls wird ein Fehler zurückgegeben, und der Auftrag wird nicht erstellt. Sobald ein Auftrag erstellt wurde, kann sein Währungscode nicht mehr geändert werden. Datentyp: Zeichenfolge | | productOrderItem | Erforderlich. Array von Objekten, die die der Produktbestellung zugeordneten Elemente und die zugehörige Aktion beschreiben. Datentyp: Array "productOrderItem": [ { "action": "String", "actionReason": "String", "committedDueDate": "String", "externalProductInventory": [Array], "id": "String", "itemPrice": [Array], "product": {Object}, "productOffering": {Object}, "productOrderItemRelationship": [Array], "quantity": Number, "@type": "String" } ] Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item | | productOrderItem.action | Erforderlich. Aktion, die für das Produkt ausgeführt werden soll. Mögliche Aktionen sind auf der Registerkarte „Auswahlliste" im Aktionswörterbucheintrag der Tabelle sn_ind_tmt_orm_order_line_item definiert. Mögliche Werte: * Hinzufügen * Change * delete * kein Change * resume * anhalten {#tmf_prod_order-POST-ord-productOrder__ul_qbd_dyp_ysb} Datentyp: Zeichenfolge Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item/action | | „productOrderItem.actionReason" | Optional. Beschreibung des Grunds für die Auftragsposition. Datentyp: Zeichenfolge Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item/action_reason | | produktbestellelement.committedFälligkeitsdatum | Datum und Uhrzeit, zu der die Aktion für die Auftragsposition ausgeführt werden muss. Datentyp: Zeichenfolge Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item/committed_due_date | | Bestellelement.externerProduktbestand | Array von Objekten mit externen IDs für die Zuordnung zu den für den Auftrag erstellten Produktbeständen. Datentyp: Array von Objekten "externalProductInventory": [ { "externalProductInventoryId": "String" } ] | | Bestellelement.externalProductInventory.externalProductInventoryId | Externe ID, die dem Produktbestand zugeordnet werden soll. Datentyp: Zeichenfolge Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item/external_inventory_id und sn_prd_invt_product_inventory/sn_prd_invt_external_id | | productOrderItem.id | Erforderlich. Eindeutiger Bezeichner der Position. Datentyp: Zeichenfolge Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item/external_id Maximale Länge: 40 Standard: Leere Zeichenfolge | | Produktbestellungselement.Artikelpreis | Array von Objekten, die den dem Produkt zugeordneten Preis beschreiben Datentyp: Array "itemPrice": [ { "price": {Object}, "priceType": "String", "recurringChargePeriod": "String" } ] Tabelle aktualisiert: sn_ind_tmt_orm_order Standard: Leere Zeichenfolge | | Produktbestellungselement.Artikelpreis.Preis | Beschreibung des Preises des zugeordneten Produkts. Datentyp: Objekt "price": { "taxIncludedAmount": {Object} } Tabelle aktualisiert: sn_ind_tmt_orm_order_line_item Standard: Leere Zeichenfolge | | „productOrderItem.itemPrice.Preis.SteuerEnthalteneBetrag" | Beschreibung des Preises des zugehörigen Produkts, einschließlich Steuer. Datentyp: Objekt "taxIncludedAmount": { "unit": "String", "value": Number } Tabelle aktualisiert: sn_ind_tmt_orm_order_line_item | | ProduktAuftragselement.Elementpreis.Preis.SteuerEnthaltenerBetrag.Einheit | Währungscode, in dem der Preis dargestellt wird. Datentyp: Zeichenfolge Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item/mrc oder nrc | | ProduktAuftragselement.Elementpreis.Preis.SteuerEnthaltenerBetrag.Wert | Preis des Produkts, einschließlich Steuern. Datentyp: Zahl Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item/mrc oder nrc | | „productOrderItem.itemPrice.PriceType" | Gibt an, ob der Preis des Artikels wiederkehrend oder nicht wiederkehrend ist. Datentyp: Zeichenfolge | | „productOrderItem.itemPrice.recurringChargePeriod" | Wenn sich der Preis wiederkehrt, gibt den wiederkehrenden Zeitraum an, z. B. Monat. Datentyp: Zeichenfolge | | ProduktBestellelement.Produkt | Erforderlich, wenn productOrderItem.action „ ändern" oder „löschen" ist. Beschreibung der Instanzdetails des vom Kunden erworbenen Produkts. Datentyp: Objekt "product": { "id": "String", "place": {Object}, "productCharacteristic": [Array], "productSpecification": {Object}, "relatedParty": {Object}, "@type": "String" } Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item | | productOrderItem.product.id | Erforderlich, wenn productOrderItem.action „ ändern" oder „löschen" ist. Eindeutiger Bezeichner des verkauften Produkts. Befindet sich im Feld „sys_id" oder „sn_ind_tmt_orm_external_id" der Tabelle „Produktbestand" \[sn_ind_tmt_orm_product_inventory\]. Datentyp: Zeichenfolge Standard: Leere Zeichenfolge | | productOrderItem.product.place | Karten der Speicherorte, an denen das Produkt installiert werden soll. Datentyp: Objekt "place": { "id": "String", "@type": "String" } Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item | | productOrderItem.product.place.id | Erforderlich. Sys_id des zugeordneten Standortdatensatzes in der Standorttabelle \[cmn_location\]. Datentyp: Zeichenfolge Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item/location | | productOrderItem.product.place.@type | Teil des TMF Open API-Standards. Anmerkung für den Kontakt des Bestellpositionselements. Dieser Wert ist immer Place. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | | productOrderItem.product.productMerkmal | Array von Objekten, die die Eigenschaften des zugeordneten Produkts beschreiben. Datentyp: Array "productCharacteristic": [ { "name": "String", "previousValue": "String", "value": "String" } ] Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_characterist_value | | productOrderItem.product.productCharacteristic.name | Name des Merkmaldatensatzes, der dem Produkt zugeordnet werden soll. Befindet sich in der Tabelle „Merkmal" \[sn_prd_pm_charakteristik\]. Datentyp: Zeichenfolge Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_charakterist_wert/merkmale Standard: Leere Zeichenfolge | | „productOrderItem.product.productFeature. previousValue" | Vorherige Merkmaloptionswerte, wenn die Aktualisierung für den Change-Auftrag gilt. Die Anforderung ist ein Change, wenn der Parameter productOrderItem.action etwas anderes als addist. Weitere Informationen zu Merkmalsoptionswerten finden Sie unter [Create product characteristics and characteristic options](https://www.servicenow.com/docs/access?context=som-product-config-add-characteristics&version=xanadu&pubname=xanadu-order-management&ft:locale=en-US). Datentyp: Zeichenfolge Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_charakterist_wert/vorherige_charakterist_option_wert Standard: Leere Zeichenfolge | | productOrderItem.product.productMerkmal.Wert | Merkmaloptionswerte, die dem Produkt zugeordnet sind. Weitere Informationen zu Merkmalsoptionswerten finden Sie unter [Create product characteristics and characteristic options](https://www.servicenow.com/docs/access?context=som-product-config-add-characteristics&version=xanadu&pubname=xanadu-order-management&ft:locale=en-US). Datentyp: Zeichenfolge Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_charakterist_wert/charakterist_option_wert Standard: Leere Zeichenfolge | | productOrderItem.product.productSpecification | Erforderlich. Beschreibung der Produktspezifikation, die dem Produkt zugeordnet ist. Hinweis: Change-Aufträge (productOrderItem.action ist `change`) werden je nach Wert der Systemeigenschaft sn_ind_tmt_orm.allowSpecVersionUpdateInChangeOrder unterschiedlich verarbeitet. Der Wert dieser Systemeigenschaft bestimmt, wie die Bestellung verarbeitet wird, wenn der Produktbestand eine andere Version aufweist als die im Auftrag angegebene. * Wenn diese Systemeigenschaft auf „true" (Standard) festgelegt ist, wird der Produktbestand automatisch auf die Version im Auftrag aktualisiert, indem die referenzierte Produktspezifikation geändert wird. Dadurch kann der Auftrag erfolgreich verarbeitet werden. * Wenn diese Systemeigenschaft auf „false" festgelegt ist und der Produktbestand eine andere Version als die in der Bestellung angegebene aufweist, schlägt die Bestellung aufgrund der Versionsabweichung fehl. {#tmf_prod_order-POST-ord-productOrder__ul_zbw_sdz_dbc} Datentyp: Objekt "productSpecification": { "id": "String", "internalVersion": "String", "name": "String", "version": "String", "@type": "String" } Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item | | productOrderItem.product.productSpecification.id | Erforderlich. Initial_version oder external_id der Produktspezifikation. initial_version ist die sys_id der ersten Version der Spezifikation. Befindet sich im Feld „sys_id" oder „external_id" der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. Datentyp: Zeichenfolge | | productOrderItem.product.productSpecification.interneVersion | Version der Produktspezifikation. Befindet sich in der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. Datentyp: Zeichenfolge | | productOrderItem.product.productSpecification.name | Name der Produktspezifikation. Befindet sich in der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. Datentyp: Zeichenfolge | | Produktbestellelement.Produkt.Produktspezifikation.Version | Externe_Version der Produktspezifikation. Befindet sich in der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. Datentyp: Zeichenfolge | | productOrderItem.product.productSpecification.@type | Teil des TMF Open API-Standards. Dieser Wert ist immer ProductSpecificationRef. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | | Bestellelement.Produkt.zugehörigePartei | Array von Objekten, die die mit einem OrderLineItemContact verknüpfte Parteirolle beschreiben Datentyp: Array "relatedParty": [ { "email": "String", "firstName": "String", "lastName": "String", "phone": "String", "@referredType": "String", "@type": "String" } ] Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item_contact | | productOrderItem.product.relatedParty.email | E-Mail-Adresse des Kontakts Datentyp: Zeichenfolge Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item_contact/email Standard: Leere Zeichenfolge | | Bestellelement.Produkt.zugehörigePartei.ersterName | Vorname des Kontakts Datentyp: Zeichenfolge Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item_contact/first_name Standard: Leere Zeichenfolge | | productOrderItem.product.relatedPartei.lastName | Nachname des Kontakts Datentyp: Zeichenfolge Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item_contact/lastName Standard: Leere Zeichenfolge | | productOrderItem.product.relatedParty.phone | Geschäftliche Telefonnummer des Kontakts Datentyp: Zeichenfolge Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item_contact/business_phone Standard: Leere Zeichenfolge | | „productOrderItem.product.relatedPartei.@referredType" | Erforderlich. Typ des Kunden Möglicher Wert: OrderLineItemContact Datentyp: Zeichenfolge | | productOrderItem.product.relatedPartei.@type | Teil des TMF Open API-Standards. Anmerkung für den Kontakt des Bestellpositionselements. Dieser Wert ist immer RelatedParty. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | | productOrderItem.product.@type | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer Produkt. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | | ProduktBestellelement.Produktangebot | Erforderlich. Beschreibung des Produktangebots, das dem Produkt zugeordnet ist. Datentyp: Objekt "productOffering": { "id": "String", "internalVersion": "String", "name": "String", "version": "String" } Tabelle aktualisiert: sn_ind_tmt_orm_order_line_item | | productOrderItem.productOffering.id | Erforderlich. Initial_version oder external_id des Produktangebots. initial_version ist die sys_id der ersten Version des Angebots. Zu finden im Feld „sys_id" oder „external_id" der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge | | ProduktBestellelement.Produktangebot.interneVersion | Version des Produktangebots. Befindet sich in der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge | | productOrderItem.productOffering.name | Name des Produktangebots Befindet sich in der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge | | ProduktBestellelement.Produktangebot.Version | Externe_Version des Produktangebots Befindet sich in der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge | | Produktbestellungselement.Produktbestellungselement.Menge | Anzahl der Artikel, die der Bestellung zugeordnet sind. Datentyp: Zahl Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order/quantity Standard: null | | Produktbestellungselement.ProduktbestellungselementBeziehung | Erforderlich. Array von Objekten, die die über- und untergeordnete Beziehung zwischen Bestellpositionen beschreiben. Datentyp: Array "productOrderItemRelationship": [ { "id": "String", "relationshipType": "String" } ] Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item | | productOrderItem.productOrderItemRelationship.id | Erforderlich. Identifiziert sich mit dem Wert productOrderItem.id. Wird für die Beziehung zwischen über- und untergeordneten Elementen verwendet Datentyp: Zeichenfolge Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item/parent_line_item Standard: Leere Zeichenfolge | | „productOrderItem.productOrderItemRelationship.relationshipType" | Erforderlich. Typ der Beziehung zwischen den beiden Einzelposten. Diese Informationen werden verwendet, um die Beziehungshierarchie zu identifizieren. Mögliche Werte: * HasChild * Hat übergeordnet {#tmf_prod_order-POST-ord-productOrder__ul_rmq_vrk_5rb} Datentyp: Zeichenfolge | | Produktbestellungselement.Menge | Anzahl der bestellten Artikel. Datentyp: Zahl Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order/quantity Standard: Leere Zeichenfolge | | produktBestellelement.@type | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer ProductOrderItem. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | | Zugehörige Partei | Liste der Kontakte für den Auftrag. Jeder Kontakt ist ein Objekt im Array. Muss mindestens ein Element aufführen, das Informationen zu Kunden- oder Verbraucherkonten enthält. Datentyp: Array "relatedParty": [ { "id": "String", "name": "String", "@referredType": "String", "@type": "String" } ] | | relatedParty.id | Sys_id oder external_id des Accounts oder Kundenkontakts, der dem Auftrag zugeordnet ist. Entweder in der Tabelle „Account" \[customer_account\], „Kontakt" \[customer_contact\] oder „Verbraucher" \[csm_consumer\]. Datentyp: Zeichenfolge | | relatedParty.name | Name des Accounts, Kunden oder Verbrauchers. Datentyp: Zeichenfolge | | zugehörigepartei.@referenztyp | Erforderlich. Typ des Kunden Mögliche Werte: * Verbraucher * Kunde * Kundenkontakt {#tmf_prod_order-POST-ord-productOrder__ul_smq_vrk_5rb} Datentyp: Zeichenfolge | | zugehörigepartei.@typ | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer RelatedParty. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | | RequestedCompletionDate | Vom Kunden angefordertes Lieferdatum Datentyp: Zeichenfolge Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order/expected_end_date Standard: Leere Zeichenfolge | | Angefordertes Startdatum | Vom Kunden angefordertes Auftragsstartdatum. Datentyp: Zeichenfolge Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order/expected_start_date Standard: Leere Zeichenfolge | | @type | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer ProductOrder. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | [Tabelle : 45. Parameter des Anforderungstexts (JSON)] {#tmf_prod_order-POST-ord-productOrder__id_vk2_p5n_t4b} ### Header Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST API verwendet werden, finden Sie unter [Unterstützte REST API-Header](https://www.servicenow.com/docs/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können."). {#tmf_prod_order-POST-ord-productOrder__table_omb_dvk_5rb__entry__2}{#tmf_prod_order-POST-ord-productOrder__accept-JSON-only-entry-RESTAPI}{#tmf_prod_order-POST-ord-productOrder__content_type-JSON-only-entry-RESTAPI} | Kopfzeile | Beschreibung | |-|-| | Akzeptieren | Datenformat des Antworttexts. Unterstützt nur application/json. | | Content-Type | Datenformat des Anforderungstexts. Unterstützt nur application/json. | [Tabelle : 46. Anforderungskopfzeilen] {#tmf_prod_order-POST-ord-productOrder__table_omb_dvk_5rb} {#tmf_prod_order-POST-ord-productOrder__table_tzy_thy_ksb__entry__2} | Kopfzeile | Beschreibung | |-|-| | Inhaltstyp | Datenformat des Antworttexts. Unterstützt nur application/json. | [Tabelle : 47. Antwortkopfzeilen] {#tmf_prod_order-POST-ord-productOrder__table_tzy_thy_ksb} ### Statuscodes Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST API verwendet werden, finden Sie unter [HTTP-Antwortcodes](https://www.servicenow.com/docs/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API. {#tmf_prod_order-POST-ord-productOrder__entry__152} | Statuscode | Beschreibung | |-|-| | 201 | Erfolgreich. Wenn Probleme mit den Merkmalen oder Merkmalsoptionsinformationen auftreten, speichert der Endpunkt die folgenden Kommentare in den Arbeitsnotizen-Feldern des zugehörigen Kundenauftragspositionselement-Datensatzes: * Die folgenden Merkmale für Bestellelemente sind nicht vorhanden: Überprüfen Sie die Spezifikation \, und korrigieren Sie das Merkmal und die Merkmalsoption in der Auftragsposition, bevor Sie den Auftrag genehmigen. * Merkmal des Bestellelements: \ mit Merkmalswert: \ist ungültig. Korrigieren Sie die Merkmalswerte, bevor Sie den Auftrag genehmigen. {#tmf_prod_order-POST-ord-productOrder__ul_xtx_xym_t4b} | | 202 | Akzeptiert. Erfolgreiche Anforderung für eine Bestellung im asynchronen Modus. Das heißt, bei der Anforderung wurde der Parameter mode auf `async` festgelegt, und der Datensatz ist zur Verarbeitung in der Tabelle „Eingehende Warteschlange" \[sn_tmt_core_inbound_queue\] geplant. | | 400 | Ungültige Anforderung. Kann einer der folgenden Gründe sein: * Ungültige Nutzlast: Anforderungstext fehlt -- Nutzlast wurde im Anforderungstext nicht übergeben. * Ungültige Nutzlast: productOrderItem fehlt -- Objekt für Produktauftragsposition oder JSON fehlt. * Ungültige Nutzlast: productOrderItem-ID fehlt -- Der Parameter id fehlt in der Produktbestellposition der Nutzlast. * Ungültige Nutzlast: Aktion „productOrderItem" fehlt -- Der Parameter action fehlt in der Produktbestellposition der Nutzlast. * Ungültige Nutzlast: productOrderItem Produktangebot fehlt -- Das Produktangebotsobjekt oder JSON fehlt in der Produktbestellposition in der Nutzlast. * Ungültige Nutzlast: Produktangebots-ID fehlt -- Der Parameter id fehlt in der Produktbestellposition des Produktangebotsobjekts in der Nutzlast. * Ungültige Nutzlast: Produktangebot ist nicht vorhanden -- Das Produktangebot in der Produktauftragsposition ist nicht gültig. * Ungültige Nutzlast: Produkt „productOrderItem" fehlt : Das Produktobjekt oder JSON in der Produktauftragsposition fehlt in der Nutzlast. * Ungültige Nutzlast: Produkt, Produktspezifikation fehlt -- Das Produktspezifikationsobjekt oder JSON in der Produktbestellposition fehlt in der Nutzlast. * Ungültige Nutzlast: Produktspezifikations-ID fehlt -- Der Parameter id in der Produktbestellposition des Produktspezifikationsobjekts fehlt in der Nutzlast. * Ungültige Nutzlast: Produktspezifikation ist nicht vorhanden -- Die Produktspezifikation in der Produktauftragsposition ist ungültig. * Ungültige Nutzlast: Produktbestand nicht vorhanden -- In einem Change-Auftrag (Aktion = Change) ist die Menge eines Artikels größer als der Bestand. * Ungültige Nutzlast: Produktbestands-ID fehlt -- im Change-Auftrag fehlt product.id in der Nutzlast. * Ungültige Nutzlast: Verkauftes Produkt ist inaktiv -- In einem Change-Auftrag ist ein in der Nutzlast angegebenes Produkt inaktiv. * Ungültige Nutzlast: „relatedParty" fehlt : Das Objekt der zugehörigen Partei fehlt in der Nutzlast. * Ungültige Nutzlast: Kunden-Account oder Verbraucher fehlt -- Das Kunden- oder Verbraucherobjekt der zugehörigen Partei fehlt in der Nutzlast. * Ungültige Nutzlast: Verbraucher nicht vorhanden -- Der angegebene Verbraucher der zugehörigen Partei ist in der Instanz ServiceNow nicht vorhanden. * Ungültige Nutzlast: Kunden-Account nicht vorhanden -- Der angegebene zugehörige Vertragspartei-Kunde ist in der Instanz ServiceNow nicht vorhanden. * Ungültige Nutzlast: Auftragserstellung fehlgeschlagen -- Der angeforderte Auftrag kann nicht erstellt werden. * Ungültige Nutzlast: orderCurrency ist erforderlich -- Der Parameter orderCurrency fehlt in der Nutzlast. * Inaktiver Währungscode: \ Die angegebene Währung ist in der Instanz ServiceNow inaktiv. * Mindestens ein Einzelposten hat einen anderen Währungscode als die Auftragswährung -- Nicht alle Einzelposten haben denselben Währungscode wie die Auftragswährung. * In-Ausführungs-Überarbeitung von Auftragswährung nicht unterstützt : Der Parameter orderCurrency kann nicht aktualisiert werden, nachdem der Auftrag erstellt wurde. {#tmf_prod_order-POST-ord-productOrder__ul_g2v_rzm_t4b} | [Tabelle : 48. Statuscodes] ### Parameter des Antwort-Haupttexts (JSON) {#tmf_prod_order-POST-ord-productOrder__entry__160}{#tmf_prod_order-POST-ord-productOrder__externalProdInv-resp-descr}{#tmf_prod_order-POST-ord-productOrder__externalProdInvId-resp-descr} | Name | Beschreibung | |-|-| | channel | Array von Objekten, die die Kanäle beschreiben, die für den Verkauf der Produkte verwendet werden sollen Datentyp: Array "channel": [ { "id": "String", "name": "String" } ] | | channel.id | Eindeutiger Bezeichner des Kanals, der für den Verkauf der zugehörigen Produkte verwendet werden soll. Kanal-ID-Werte befinden sich im Feld „external_id" der Tabelle „Verteilungskanal" \[sn_prd_pm_distribution_channel\]. Datentyp: Zeichenfolge | | Kanalname | Name des Kanals, der für den Verkauf der zugehörigen Produkte verwendet werden soll. Datentyp: Zeichenfolge | | committedDueDate | Datum und Uhrzeit, zu der die Aktion für den Auftrag ausgeführt werden muss. Dieser Wert muss mit den committedDueDate -Werten für jede Bestellposition übereinstimmen oder später als diese sein. Datentyp: Zeichenfolge | | externalId | Externer Bezeichner für den Kundenauftrag, z. B. eine Bestellnummer. Datentyp: Zeichenfolge | | href | Relativer Link zum Produktbestelldatensatz. Datentyp: Zeichenfolge | | id | Sys_id des Kundenauftrags, der für diese Anforderung erstellt wurde. Datentyp: Zeichenfolge | | Hinweis | Array von Objekten, die zusätzliche Notizen beschreiben, die der Kunde bei der Bestellung gemacht hat. Datentyp: Array "note": [ { "text": "String" } ] | | Anmerkung.Text | Zusätzliche Hinweise/Kommentare vom Kunden während der Bestellung. Datentyp: Zeichenfolge | | orderCurrency | Währungscode für den Auftrag und die Bestellpositionen. Datentyp: Zeichenfolge | | orderId | Sys_id des zu erstellenden Auftrags. Bei erfolgreicher Anforderung wird der Auftrag der Tabelle „Eingehende Warteschlange" \[sn_tmt_core_inbound_queue\] in einem Zeitplan zur Verarbeitung hinzugefügt. Hinweis: Dieser Wert ist das einzige Ergebnis, wenn der Auftrag asynchron mit dem Abfrageparameter mode erstellt wird. { "orderId": "b0fc877ac3ab5110856d73ce3640dde0" } Datentyp: Zeichenfolge | | productOrderItem | Liste, die die der Produktbestellung zugeordneten Elemente und die zugehörige Aktion beschreibt. Datentyp: Array "productOrderItem:" [ { "action": "String", "committedDueDate": "String", "externalProductInventory": [Array], "id": "String", "itemPrice": [Array], "product": {Object}, "productOffering": {Object}, "productOrderItemReleationship": [Array], "quantity": Number, "state": "String", "@type": "String" } ] | | productOrderItem.action | Aktion, die für das Produkt ausgeführt werden soll. Mögliche Aktionen sind auf der Registerkarte „Auswahlliste" im Aktionswörterbucheintrag der Tabelle sn_ind_tmt_orm_order_line_item definiert. Datentyp: Zeichenfolge | | „productOrderItem.actionReason" | Der Grund für das Hinzufügen der Auftragsposition. Datentyp: Zeichenfolge Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item/action_reason | | produktbestellelement.committedFälligkeitsdatum | Datum und Uhrzeit, zu der die Aktion für die Auftragsposition ausgeführt werden muss. Datentyp: Zeichenfolge | | Bestellelement.externerProduktbestand | Array von Objekten mit externen IDs, die den für den Auftrag erstellten Produktbeständen zugeordnet sind. Datentyp: Array "externalProductInventory": [ { "externalProductInventoryId": "String" } ] | | Bestellelement.externalProductInventory.externalProductInventoryId | Externe ID, die dem Produktbestand zugeordnet ist. Datentyp: Zeichenfolge | | productOrderItem.id | Eindeutiger Bezeichner der Position. Zu finden im Feld sn_ind_tmt_orm_external_id der Tabelle „Auftragspositionselement" \[sn_ind_tmt_orm_order_line_item\]. Datentyp: Zeichenfolge | | Produktbestellungselement.Artikelpreis | Array von Objekten, die den dem Produkt zugeordneten Preis beschreiben Datentyp: Array "itemPrice": [ { "price": {Object}, "priceType": "String", "recurringChargePeriod": "String" } ] | | Produktbestellungselement.Artikelpreis.Preis | Beschreibung des Preises des zugeordneten Produkts. Datentyp: Objekt "price": { "taxIncludedAmount": {Object} } | | „productOrderItem.itemPrice.Preis.SteuerEinschlussBetrag" | Beschreibung des Preises des zugehörigen Produkts, einschließlich Steuer. Datentyp: Objekt "taxIncludedAmount": { "unit": "String", "value": Number } | | ProduktAuftragselement.Elementpreis.Preis.SteuerEinschlussBetrag.Einheit | Währungscode, in dem der Preis dargestellt wird. Datentyp: Zeichenfolge | | ProduktAuftragselement.Elementpreis.Preis.SteuerEinschlussBetrag.Wert | Preis des Produkts, einschließlich Steuern. Datentyp: Zahl | | „productOrderItem.itemPrice.PriceType" | Typ des Artikelpreises, wiederkehrend oder nicht wiederkehrend. Datentyp: Zeichenfolge | | „productOrderItem.itemPrice.recurringChargePeriod" | Wenn der Preis wiederkehrend ist, der wiederkehrende Zeitraum, z. B. Monat. Datentyp: Zeichenfolge | | ProduktBestellelement.Produkt | Beschreibung der Instanzdetails des vom Kunden erworbenen Produkts. Datentyp: Objekt "product": { "id": "String", "place": {Object}, "productCharacteristic": [Array], "productSpecification": {Object}, "relatedParty": {Object}, "@type": "String" } | | productOrderItem.product.id | Eindeutiger Bezeichner des verkauften Produkts. Befindet sich im Feld „sys_id" oder „sn_ind_tmt_orm_external_id" der Tabelle „Produktbestand" \[sn_ind_tmt_orm_product_inventory\]. Dieser Parameter wird nur zurückgegeben, wenn productOrderItem.actionchange oder deleteist. Wenn sowohl „sys_id" als auch „external_id" vorhanden sind, wird „external_id" zurückgegeben. Datentyp: Zeichenfolge | | productOrderItem.product.place | Karten der Speicherorte, an denen das Produkt installiert werden soll. Datentyp: Objekt "place": { "id": "String", "@type": "String" } | | productOrderItem.product.place.id | Sys_id des zugeordneten Standortdatensatzes in der Standorttabelle \[cmn_location\]. Datentyp: Zeichenfolge | | productOrderItem.product.productMerkmal | Array von Objekten, die die Eigenschaften des zugeordneten Produkts beschreiben. Datentyp: Array "productCharacteristic": [ { "name": "String", "previousValue": "String", "value": "String" } ] | | productOrderItem.product.productCharacteristic.name | Name des Merkmaldatensatzes, der dem Produkt zugeordnet werden soll. Befindet sich in der Tabelle „Merkmal" \[sn_prd_pm_charakteristik\]. Datentyp: Zeichenfolge | | „productOrderItem.product.productFeature. previousValue" | Vorherige Merkmalsoptionswerte, wenn die Aktualisierung für einen Change-Auftrag erfolgt. Die Anforderung ist ein Change, wenn der Parameter productOrderItem.action etwas anderes als addist. Weitere Informationen zu Merkmalsoptionswerten finden Sie unter [Create product characteristics and characteristic options](https://www.servicenow.com/docs/access?context=som-product-config-add-characteristics&version=xanadu&pubname=xanadu-order-management&ft:locale=en-US). Datentyp: Zeichenfolge | | productOrderItem.product.productMerkmal.Wert | Merkmaloptionswerte, die dem Produkt zugeordnet sind. Weitere Informationen zu Merkmalsoptionswerten finden Sie unter [Create product characteristics and characteristic options](https://www.servicenow.com/docs/access?context=som-product-config-add-characteristics&version=xanadu&pubname=xanadu-order-management&ft:locale=en-US). Datentyp: Zeichenfolge | | productOrderItem.product.productRelationship | Liste der Produktbeziehungsdetails für eine Bestellposition. Datentyp: Array "productRelationship": [ { "id": "String", "relationshipType": "String" } ] | | productOrderItem.product.productRelationship.id | Sys_id oder sn_prd_invt_external_id des Produktbestands. Befindet sich im Feld „sys_id" oder „sn_prd_invt_external_id" der Tabelle „Produktbestand" \[sn_prd_invt_product_inventory\]. Datentyp: Zeichenfolge | | „productOrderItem.product.productRelationship.relationshipType" | Typ der Beziehung zwischen dem Auftragspositionselement und dem Produktbestand. Möglicher Wert: Erfordert Datentyp: Zeichenfolge | | productOrderItem.product.productSpecification | Beschreibung der Produktspezifikation, die dem Produkt zugeordnet ist. Datentyp: Objekt "productSpecification:" { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String", "@type": "String" } | | productOrderItem.product.productSpecification.id | Initial_version oder external_id der Produktspezifikation. initial_version ist die sys_id der ersten Version der Spezifikation. Befindet sich im Feld „sys_id" oder „external_id" der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. Wenn sowohl „sys_id" als auch „external_id" vorhanden sind, wird „external_id" zurückgegeben. Datentyp: Zeichenfolge | | Bestellelement.Produkt.Produktspezifikation.interneID | Initiale_version der Produktspezifikation. initial_version ist die sys_id der ersten Version der Spezifikation. Befindet sich in der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. Datentyp: Zeichenfolge | | productOrderItem.product.productSpecification.interneVersion | Version der Produktspezifikation. Befindet sich in der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. Datentyp: Zeichenfolge | | productOrderItem.product.productSpecification.name | Name der Produktspezifikation. Befindet sich in der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. Datentyp: Zeichenfolge | | Produktbestellelement.Produkt.Produktspezifikation.Version | Externe_Version der Produktspezifikation. Befindet sich in der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. Datentyp: Zeichenfolge | | productOrderItem.product.productSpecification.@type | Teil des TMF Open API-Standards. Dieser Wert ist immer ProductSpecificationRef. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | | Bestellelement.Produkt.zugehörigePartei | Liste der Kontakte für Positionen. Datentyp: Array "relatedParty:" [ { "email": "String", "firstName": "String", "lastName": "String", "phone": "String", "@referredType": "String", "@type": "String" } ] | | productOrderItem.product.relatedParty.email | E-Mail-Adresse des Kontakts Datentyp: Zeichenfolge | | Bestellelement.Produkt.zugehörigePartei.ersterName | Vorname des Kontakts Datentyp: Zeichenfolge | | productOrderItem.product.relatedPartei.lastName | Nachname des Kontakts Datentyp: Zeichenfolge Datentyp: Zeichenfolge | | productOrderItem.product.relatedParty.phone | Geschäftliche Telefonnummer des Kontakts Datentyp: Zeichenfolge | | „productOrderItem.product.relatedPartei.@referredType" | Typ des Kunden Möglicher Wert: OrderLineItemContact Datentyp: Zeichenfolge | | productOrderItem.product.relatedPartei.@type | Teil des TMF Open API-Standards. Anmerkung für den Kontakt des Bestellpositionselements. Dieser Wert ist immer RelatedParty. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | | productOrderItem.product.@type | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer Produkt. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | | ProduktBestellelement.Produktangebot | Beschreibung des Produktangebots, das dem Produkt zugeordnet ist. Datentyp: Objekt "productOffering:" { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } | | productOrderItem.productOffering.id | Initial_version oder external_id des Produktangebots. initial_version ist die sys_id der ersten Version des Angebots. Zu finden im Feld „sys_id" oder „external_id" der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Wenn sowohl „sys_id" als auch „external_id" vorhanden sind, wird „external_id" zurückgegeben. Datentyp: Zeichenfolge | | „productOrderItem.productOffering.internalId" | Initial_version des Produktangebots. initial_version ist die sys_id der ersten Version des Angebots. Befindet sich in der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge | | ProduktBestellelement.Produktangebot.interneVersion | Version des Produktangebots. Befindet sich in der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge | | productOrderItem.productOffering.name | Name des Produktangebots Befindet sich in der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge | | ProduktBestellelement.Produktangebot.Version | Externe_Version des Produktangebots Befindet sich in der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge | | Produktbestellungselement.ProduktbestellungselementBeziehung | Array von Objekten, die die Beziehungen zwischen Bestellpositionen beschreiben. Datentyp: Array "productOrderItemRelationship": [ { "id": "String", "relationshipType": "String" } ] | | productOrderItem.productOrderItemRelationship.id | Eindeutiger Bezeichner des zugehörigen Einzelpostens. Zu finden im Feld sn_ind_tmt_orm_external_id der Tabelle „Auftragspositionselement" \[sn_ind_tmt_orm_order_line_item\]. Datentyp: Zeichenfolge | | „productOrderItem.productOrderItemRelationship.relationshipType" | Typ der Beziehung zwischen den beiden Einzelposten. Diese Informationen werden verwendet, um die Beziehungshierarchie zu identifizieren. Mögliche Werte: * HasChild * Hat übergeordnet * Erfordert {#tmf_prod_order-POST-ord-productOrder__ul_yqf_2ty_54b} `„HasChild"` und `„HasParent"` werden für Beziehungen zwischen über- und untergeordneten Elementen verwendet. „`Erfordert` " wird für horizontale Beziehungen verwendet (ein Einzelposten erfordert einen anderen Einzelposten). Datentyp: Zeichenfolge | | Produktbestellungselement.Menge | Anzahl der Artikel, die der Bestellung zugeordnet sind. Datentyp: Zahl | | „productOrderItem.state" | Aktueller Status des Produktbestellartikels. Dieser Wert ist immer neu. Datentyp: Zeichenfolge | | produktBestellelement.@type | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer ProductOrderItem. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | | Zugehörige Partei | Liste der Kontakte für den Auftrag. Jeder Kontakt ist ein Objekt im Array. Muss mindestens ein Element aufführen, das Informationen zu Kunden- oder Verbraucherkonten enthält. Datentyp: Array "relatedParty": [ { "id": "String", "name": "String", "@referredType": "String", "@type": "String" } ] | | relatedParty.id | Sys_id oder external_id des Accounts, Kundenkontakts oder Verbrauchers, der dem Auftrag zugeordnet ist. Zu finden in der Tabelle „Account" \[customer_account\], „Kontakt" \[customer_contact\] oder „Verbraucher" \[csm_consumer\]. Datentyp: Zeichenfolge | | relatedParty.name | Name des Accounts, Kunden oder Verbrauchers. Datentyp: Zeichenfolge | | ZugehörigePartei.Typ | Typ des Kunden Mögliche Werte: * Verbraucher * Kunde * Kundenkontakt {#tmf_prod_order-POST-ord-productOrder__ul_lcq_jwm_t4b} Datentyp: Zeichenfolge | | RequestedCompletionDate | Vom Kunden angefordertes Lieferdatum Datentyp: Zeichenfolge | | Angefordertes Startdatum | Vom Kunden angefordertes Auftragsstartdatum. Datentyp: Zeichenfolge | | Staat | Aktueller Status des Auftrags. Für diesen Endpunkt ist dieser Wert immer neu. Datentyp: Zeichenfolge | | @type | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer ProductOrder. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | [ ] ### Wird asynchron verarbeitet {#tmf_prod_order-POST-ord-productOrder__example_ynv_vhx_fwb} In diesem Beispiel wird gezeigt, wie der Abfrageparameter mode verwendet wird, um einen Auftrag asynchron zu erstellen. Der Auftrag wird der Tabelle „Eingehende Warteschlange" \[sn_tmt_core_inbound_queue\] in einem zu erstellenden Zeitplan hinzugefügt. curl -X POST 'https://instance.service-now.com/api/sn_ind_tmt_orm/order/productOrder?mode=async' \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -u "username":"password" \ -d '{ "requestedCompletionDate": "2021-05-02T08:13:59.506Z", "requestedStartDate": "2020-05-03T08:13:59.506Z", "orderDate": "2020-05-03T08:13:59.506Z", "externalId": "PO-4ddd56", "orderCurrency": "USD", "note": [ { "id": "1", "author": "Jean Pontus", "date": "2019-04-30T08:13:59.509Z", "text": "This is a TMF product order illustration" }, { "id": "2", "author": "Jean Pontus1", "date": "2019-04-30T08:13:59.509Z", "text": "This is a TMF product order illustration no 2" } ], "productOrderItem": [ { "id": "100", "quantity": 1, "action": "add", "actionReason":"adding service package OLI", "product": { "isBundle": false, "@type": "Product", "productSpecification": { "id": "cfe5ef6a53702010cd6dddeeff7b12f6", "name": "SD-WAN Service Package", "@type": "ProductSpecificationRef" }, "relatedParty": [ { "firstName": "John", "lastName": "Smith", "email": "abc2@example.com", "phone": "32456768", "@type": "RelatedParty", "@referredType": "OrderLineItemContact" } ], "productRelationship": [ { "id": "be6d13f45b5620102dff5e92dc81c781", "relationshipType": "Requires" } ] }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering" }, "productOrderItemRelationship": [ { "id": "110", "relationshipType": "HasChild" }, { "id": "120", "relationshipType": "HasChild" }, { "id": "130", "relationshipType": "HasChild" } ], "@type": "ProductOrderItem" }, { "id": "110", "quantity": 1, "action": "add", "itemPrice": [ { "description": "Access Fee", "name": "Access Fee", "priceType": "nonRecurring", "price": { "taxRate": 0, "dutyFreeAmount": { "unit": "USD", "value": 100 }, "taxIncludedAmount": { "unit": "USD", "value": 220 } } } ], "product": { "isBundle": false, "@type": "Product", "productCharacteristic": [ { "name": "Tenancy", "valueType": "string", "value": "Premium (>50 sites)" } ], "productSpecification": { "id": "216663aa53702010cd6dddeeff7b12b5", "name": "SD-WAN Controller", "@type": "ProductSpecificationRef" }, "place": { "@type": "Place", "id": "5671dd2ec3a53010188473ce3640dd81" }, "relatedParty": [ { "firstName": "John", "lastName": "Smith", "email": "abc2@example.com", "phone": "32456768", "@type": "RelatedParty", "@referredType": "OrderLineItemContact" } ], "productRelationship": [ { "id": "be6d13f45b5620102dff5e92dc81c781", "relationshipType": "Requires" } ] }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering" }, "productOrderItemRelationship": [ { "id": "100", "relationshipType": "HasParent" } ], "@type": "ProductOrderItem" }, { "id": "120", "action": "add", "actionReason":"adding service package OLI", "quantity": 1, "itemPrice": [ { "description": "Tariff plan monthly fee", "name": "MonthlyFee", "priceType": "recurring", "recurringChargePeriod": "month", "price": { "taxRate": 0, "dutyFreeAmount": { "unit": "USD", "value": 300 }, "taxIncludedAmount": { "unit": "USD", "value": 349 } } } ], "product": { "isBundle": false, "@type": "Product", "productCharacteristic": [ { "name": "CPE Model", "valueType": "string", "value": "ASR" }, { "name": "WAN Optimization", "valueType": "string", "value": "Advance" }, { "name": "CPE Type", "valueType": "string", "value": "Physical" }, { "name": "Routing", "valueType": "string", "value": "Premium" } ], "productSpecification": { "id": "39b627aa53702010cd6dddeeff7b1202", "name": "SD-WAN Edge Device", "@type": "ProductSpecificationRef" }, "place": { "@type": "Place", "id": "5671dd2ec3a53010188473ce3640dd81" }, "relatedParty": [ { "firstName": "John", "lastName": "Smith", "email": "abc2@example.com", "phone": "32456768", "@type": "RelatedParty", "@referredType": "OrderLineItemContact" } ], "productRelationship": [ { "id": "be6d13f45b5620102dff5e92dc81c781", "relationshipType": "Requires" } ] }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering" }, "productOrderItemRelationship": [ { "id": "100", "relationshipType": "HasParent" } ], "@type": "ProductOrderItem" }, { "id": "130", "quantity": 1, "action": "add", "actionReason":"adding service package OLI", "itemPrice": [ { "description": "Tariff plan monthly security", "name": "MonthlySecurity", "priceType": "nonRecurring", "recurringChargePeriod": "month", "price": { "taxRate": 0, "dutyFreeAmount": { "unit": "USD", "value": 30 }, "taxIncludedAmount": { "unit": "USD", "value": 30 } } } ], "product": { "isBundle": false, "@type": "Product", "productCharacteristic": [ { "name": "Security Type", "valueType": "string", "value": "Premium" } ], "productSpecification": { "id": "a6514bd3534560102f18ddeeff7b1247", "name": "SD-WAN Security", "@type": "ProductSpecificationRef" }, "place": { "@type": "Place", "id": "5671dd2ec3a53010188473ce3640dd81" }, "relatedParty": [ { "firstName": "John", "lastName": "Smith", "email": "abc2@example.com", "phone": "32456768", "@type": "RelatedParty", "@referredType": "OrderLineItemContact" } ], "productRelationship": [ { "id": "be6d13f45b5620102dff5e92dc81c781", "relationshipType": "Requires" } ] }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering" }, "productOrderItemRelationship": [ { "id": "100", "relationshipType": "HasParent" } ], "@type": "ProductOrderItem" } ], "relatedParty": [ { "id": "eaf68911c35420105252716b7d40ddde", "name": "Sally Thomas", "@type": "RelatedParty", "@referredType": "CustomerContact" }, { "id": "ffc68911c35420105252716b7d40dd55", "name": "Funco Intl", "@type": "RelatedParty", "@referredType": "Customer" }, { "id": "59f16de1c3b67110ff00ed23a140dd9e", "name": "Funco External", "@type": "RelatedParty", "@referredType": "Consumer" } ], "@type": "ProductOrder" }' Antworttext. { "orderId": "304e877ac3ab5110856d73ce3640dde5" } ### Synchrone Verarbeitung (Standard) Das folgende Beispiel zeigt, wie eine Produktbestellung erstellt wird. curl -X POST "https://instance.service-now.com/api/sn_ind_tmt_orm/order/productOrder" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -u "username":"password" \ -d { "requestedCompletionDate": "2021-05-02T08:13:59.506Z", "requestedStartDate": "2020-05-03T08:13:59.506Z", "externalId": "PO-456", "currencyCode": "USD", "channel": [ { "id": "2", "name": "Online channel" } ], "note": [ { "text": "This is a TMF product order illustration" }, { "text": "This is a TMF product order illustration no 2" } ], "productOrderItem": [ { "id": "POI100", "quantity": 1, "action": "change", "product": { "id": "fa6d13f45b5620102dff5e92dc81c77f", "@type": "Product", "productSpecification": { "id": "cfe5ef6a53702010cd6dddeeff7b12f6", "name": "SD-WAN Service Package", "@type": "ProductSpecificationRef" }, "place": { "id": "25ab9c4d0a0a0bb300f7dabdc0ca7c1c", "@type": "Place" } }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering" }, "productOrderItemRelationship": [ { "id": "POI120", "relationshipType": "HasChild" }, { "id": "POI130", "relationshipType": "HasChild" } ], "@type": "ProductOrderItem" }, { "id": "POI120", "quantity": 1, "action": "change", "actionReason":"adding service package OLI", "itemPrice": [ { "priceType": "recurring", "recurringChargePeriod": "month", "price": { "taxIncludedAmount": { "unit": "USD", "value": 20 } } } ], "product": { "id": "766d13f45b5620102dff5e92dc81c78a", "@type": "Product", "productCharacteristic": [ { "name": "WAN Optimization", "value": "Base", "previousValue": "Advance" } ], "productSpecification": { "id": "39b627aa53702010cd6dddeeff7b1202", "name": "SD-WAN Edge Device", "@type": "ProductSpecificationRef" }, "productRelationship": [ { "id": "326d13f45b5620102dff5e92dc81c785", "relationshipType": "Requires" } ], "relatedParty": [ { "id": "51670151c35420105252716b7d40ddfe", "firstName": "Joe", "lastName": "Doe", "email": "abc@example.com", "phone": "1234567890", "@type": "RelatedParty", "@referredType": "OrderLineItemContact" } ], "place": { "id": "25ab9c4d0a0a0bb300f7dabdc0ca7c1c", "@type": "Place" } }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering" }, "productOrderItemRelationship": [ { "id": "POI100", "relationshipType": "HasParent" }, { "id": "POI130", "relationshipType": "Requires" } ], "@type": "ProductOrderItem" }, { "id": "POI130", "quantity": 1, "action": "add", "actionReason":"adding service package OLI", "itemPrice": [ { "priceType": "recurring", "recurringChargePeriod": "month", "price": { "taxIncludedAmount": { "unit": "USD", "value": 20 } } } ], "product": { "@type": "Product", "productCharacteristic": [ { "name": "Security Type", "value": "Base", "previousValue": "Advance" } ], "productSpecification": { "id": "a6514bd3534560102f18ddeeff7b1247", "name": "SD-WAN Security", "@type": "ProductSpecificationRef" }, "relatedParty": [ { "id": "51670151c35420105252716b7d40ddfe", "firstName": "Joe", "lastName": "Doe", "email": "abc@example.com", "phone": "1234567890", "@type": "RelatedParty", "@referredType": "OrderLineItemContact" } ], "place": { "id": "25ab9c4d0a0a0bb300f7dabdc0ca7c1c", "@type": "Place" } }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering" }, "productOrderItemRelationship": [ { "id": "POI100", "relationshipType": "HasParent" } ], "@type": "ProductOrderItem" } ], "relatedParty": [ { "id": "eaf68911c35420105252716b7d40ddde", "name": "Sally Thomas", "@type": "RelatedParty", "@referredType": "CustomerContact" }, { "id": "ffc68911c35420105252716b7d40dd55", "name": "Funco Intl", "@type": "RelatedParty", "@referredType": "Customer" }, { "id": "59f16de1c3b67110ff00ed23a140dd9e", "name": "Funco External", "@type": "RelatedParty", "@referredType": "Consumer" } ], "@type": "ProductOrder" } Antworttext. { "requestedCompletionDate": "2021-05-02T08:13:59.506Z", "requestedStartDate": "2020-05-03T08:13:59.506Z", "externalId": "PO-456", "currencyCode": "USD", "channel": [ { "id": "2", "name": "Online chanel" } ], "note": [ { "text": "This is a TMF product order illustration" }, { "text": "This is a TMF product order illustration no 2" } ], "productOrderItem": [ { "id": "POI100", "quantity": 1, "action": "change", "actionReason":"adding service package OLI", "product": { "id": "fa6d13f45b5620102dff5e92dc81c77f", "@type": "Product", "productSpecification": { "id": "cfe5ef6a53702010cd6dddeeff7b12f6", "name": "SD-WAN Service Package", "internalVersion": "1", "version": "v1", "internalId": "cfe5ef6a53702010cd6dddeeff7b12f6", "@type": "ProductSpecificationRef" }, "place": { "id": "25ab9c4d0a0a0bb300f7dabdc0ca7c1c", "@type": "Place" } }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering", "internalVersion": "1", "version": "v1", "internalId": "69017a0f536520103b6bddeeff7b127d" }, "productOrderItemRelationship": [ { "id": "POI120", "relationshipType": "HasChild" }, { "id": "POI130", "relationshipType": "HasChild" } ], "@type": "ProductOrderItem", "state": "new" }, { "id": "POI120", "quantity": 1, "action": "change", "actionReason":"adding service package OLI", "itemPrice": [ { "priceType": "recurring", "recurringChargePeriod": "month", "price": { "taxIncludedAmount": { "unit": "USD", "value": 20 } } } ], "product": { "id": "766d13f45b5620102dff5e92dc81c78a", "@type": "Product", "productCharacteristic": [ { "name": "WAN Optimization", "value": "Base", "previousValue": "Advance" } ], "productSpecification": { "id": "39b627aa53702010cd6dddeeff7b1202", "name": "SD-WAN Edge Device", "internalVersion": "1", "version": "v1", "internalId": "39b627aa53702010cd6dddeeff7b1202", "@type": "ProductSpecificationRef" }, "productRelationship": [ { "id": "326d13f45b5620102dff5e92dc81c785", "relationshipType": "Requires" } ], "relatedParty": [ { "id": "51670151c35420105252716b7d40ddfe", "firstName": "Joe", "lastName": "Doe", "email": "abc@example.com", "phone": "1234567890", "@type": "RelatedParty", "@referredType": "OrderLineItemContact" } ], "place": { "id": "25ab9c4d0a0a0bb300f7dabdc0ca7c1c", "@type": "Place" } }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering", "internalVersion": "1", "version": "v1", "internalId": "69017a0f536520103b6bddeeff7b127d" }, "productOrderItemRelationship": [ { "id": "POI100", "relationshipType": "HasParent" }, { "id": "POI130", "relationshipType": "Requires" } ], "@type": "ProductOrderItem", "state": "new" }, { "id": "POI130", "quantity": 1, "action": "add", "actionReason":"adding service package OLI", "itemPrice": [ { "priceType": "recurring", "recurringChargePeriod": "month", "price": { "taxIncludedAmount": { "unit": "USD", "value": 20 } } } ], "product": { "@type": "Product", "productCharacteristic": [ { "name": "Security Type", "value": "Base", "previousValue": "Advance" } ], "productSpecification": { "id": "a6514bd3534560102f18ddeeff7b1247", "name": "SD-WAN Security", "internalVersion": "1", "version": "v1", "internalId": "a6514bd3534560102f18ddeeff7b1247", "@type": "ProductSpecificationRef" }, "relatedParty": [ { "id": "51670151c35420105252716b7d40ddfe", "firstName": "Joe", "lastName": "Doe", "email": "abc@example.com", "phone": "1234567890", "@type": "RelatedParty", "@referredType": "OrderLineItemContact" } ], "place": { "id": "25ab9c4d0a0a0bb300f7dabdc0ca7c1c", "@type": "Place" } }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering", "internalVersion": "1", "version": "v1", "internalId": "69017a0f536520103b6bddeeff7b127d" }, "productOrderItemRelationship": [ { "id": "POI100", "relationshipType": "HasParent" } ], "@type": "ProductOrderItem", "state": "new" } ], "relatedParty": [ { "id": "eaf68911c35420105252716b7d40ddde", "name": "Sally Thomas", "@type": "RelatedParty", "@referredType": "CustomerContact" }, { "id": "ffc68911c35420105252716b7d40dd55", "name": "Funco Intl", "@type": "RelatedParty", "@referredType": "Customer" }, { "id": "59f16de1c3b67110ff00ed23a140dd9e", "name": "Funco External", "@type": "RelatedParty", "@referredType": "Consumer" } ], "@type": "ProductOrder", "id": "8d75939453126010a795ddeeff7b126a", "href": "/api/sn_ind_tmt_orm/order/productOrder/8d75939453126010a795ddeeff7b126a", "state": "new" } ## Open API für Produktbestellung -- POST /sn_ind_tmt_orm/productorder {#ariaid-title10} Erstellt den angegebenen Kundenauftrag und die Kundenauftragspositionen. Wichtig: Ab Release Tokyo ist dieser Endpunkt veraltet. Die neue Version dieses Endpunkts ist [Open API für Produktbestellung -- POST /sn_ind_tmt_orm/order/productOrder](https://www.servicenow.com/docs/Ae5XqErKGgN46FHZcSkOdg#tmf_prod_order-POST-ord-productOrder "Erstellt den angegebenen Kundenauftrag und die Kundenauftragspositionen."). Nach der Verarbeitung werden in den folgenden Tabellen neue Datensätze erstellt: * Kundenbestellung \[sn_ind_tmt_orm_order\] * Bestellmerkmal \[sn_ind_tmt_orm_order_characterist_value\] * Bestellposition \[sn_ind_tmt_orm_order_line_item\] * Auftragspositionselement -- Kontakt \[sn_ind_tmt_orm_order_line_item_contact\] {#tmf_prod_order-POST-productOrder__ul_hxq_vdb_hqb} ### URL-Format Standard-URL: /api/sn_ind_tmt_orm/productorder ### Unterstützte Anforderungsparameter {#tmf_prod_order-POST-productOrder__entry__2} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 49. Pfadparameter] {#tmf_prod_order-POST-productOrder__entry__6} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 50. Abfrageparameter] {#tmf_prod_order-POST-productOrder__id_vk2_p5n_t4b__entry__2}{#tmf_prod_order-POST-productOrder__due-date-entry}{#tmf_prod_order-POST-productOrder__productOrder-href-request}{#tmf_prod_order-POST-productOrder__productOrder-addReason-request}{#tmf_prod_order-POST-productOrder__due-date-item-entry}{#tmf_prod_order-POST-productOrder__externalProductInventory-GET-desc-request}{#tmf_prod_order-POST-productOrder__externalProductInventoryId-desc} | Name | Beschreibung | |-|-| | channel | Array von Objekten, die die Kanäle beschreiben, die für den Verkauf der Produkte verwendet werden sollen Datentyp: Array "channel": [ { "id": "String", "name": "String" } ] Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order | | channel.id | Erforderlich. Eindeutiger Bezeichner des Kanals, der für den Verkauf der zugehörigen Produkte verwendet werden soll. Kanal-ID-Werte befinden sich im Feld „ external_id " der Tabelle „Verteilungskanal" \[sn_prd_pm_distribution_channel\]. Datentyp: Zeichenfolge Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order/channel Standard: Leere Zeichenfolge | | Kanalname | Name des Kanals, der für den Verkauf der zugehörigen Produkte verwendet werden soll. Mögliche Kanalnamen sind auf der Registerkarte „Auswahlliste" im Wörterbucheintrag „Kanal " der Tabelle „ sn_ind_tmt_orm_order " definiert. Datentyp: Zeichenfolge Standard: Leere Zeichenfolge | | committedDueDate | Datum und Uhrzeit, zu der die Aktion für den Auftrag ausgeführt werden muss. Dieser Wert muss mit den committedDueDate -Werten für jede Bestellposition übereinstimmen oder später als diese sein. Datentyp: Zeichenfolge Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order/committed_due_date | | externalId | Eindeutiger Bezeichner für den Kundenauftrag. Dieser Wert wird von einem externen System bestimmt. Datentyp: Zeichenfolge Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order/external_id Standard: Leere Zeichenfolge | | href | Ein relativer Link zum Ressourcendatensatz. Datentyp: Zeichenfolge Standard: Leere Zeichenfolge | | Hinweis | Array von Objekten, die zusätzliche Notizen enthalten, die der Kunde bei der Bestellung gemacht hat. Datentyp: Array "note": [ { "text": "String" } ] Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order | | Anmerkung.Text | Erforderlich. Zusätzliche Hinweise/Kommentare vom Kunden während der Bestellung. Datentyp: Zeichenfolge Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order/comments Standard: Leere Zeichenfolge | | orderCurrency | Erforderlich. Währungscode für den Auftrag und die Bestellpositionen. Die Währung muss für alle Elemente des Auftrags und der Bestellpositionen identisch sein. Andernfalls wird ein Fehler zurückgegeben, und der Auftrag wird nicht erstellt. Sobald ein Auftrag erstellt wurde, kann sein Währungscode nicht mehr geändert werden. Datentyp: Zeichenfolge | | productOrderItem | Erforderlich. Array von Objekten, die die der Produktbestellung zugeordneten Elemente und die zugehörige Aktion beschreiben. Datentyp: Array "productOrderItem": [ { "action": "String", "actionReason": "String", "committedDueDate": "String", "externalProductInventory": [Array], "id": "String", "itemPrice": [Array], "product": {Object}, "productOffering": {Object}, "productOrderItemRelationship": [Array], "quantity": Number, "@type": "String" } ] Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item | | productOrderItem.action | Erforderlich. Aktion, die für das Produkt ausgeführt werden soll. Mögliche Aktionen sind auf der Registerkarte „Auswahlliste" im Aktionswörterbucheintrag der Tabelle sn_ind_tmt_orm_order_line_item definiert. Mögliche Werte: * Hinzufügen * Change * delete * kein Change * resume * anhalten {#tmf_prod_order-POST-productOrder__ul_qbd_dyp_ysb} Datentyp: Zeichenfolge Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item/action | | „productOrderItem.actionReason" | Optional. Beschreibung des Grunds für die Auftragsposition. Datentyp: Zeichenfolge Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item/action_reason | | produktbestellelement.committedFälligkeitsdatum | Datum und Uhrzeit, zu der die Aktion für die Auftragsposition ausgeführt werden muss. Datentyp: Zeichenfolge Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item/committed_due_date | | Bestellelement.externerProduktbestand | Array von Objekten mit externen IDs für die Zuordnung zu den für den Auftrag erstellten Produktbeständen. Datentyp: Array von Objekten "externalProductInventory": [ { "externalProductInventoryId": "String" } ] | | Bestellelement.externalProductInventory.externalProductInventoryId | Externe ID, die dem Produktbestand zugeordnet werden soll. Datentyp: Zeichenfolge Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item/external_inventory_id und sn_prd_invt_product_inventory/sn_prd_invt_external_id | | productOrderItem.id | Erforderlich. Eindeutiger Bezeichner der Position. Datentyp: Zeichenfolge Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item/external_id Maximale Länge: 40 Standard: Leere Zeichenfolge | | Produktbestellungselement.Artikelpreis | Array von Objekten, die den dem Produkt zugeordneten Preis beschreiben Datentyp: Array "itemPrice": [ { "price": {Object}, "priceType": "String", "recurringChargePeriod": "String" } ] Tabelle aktualisiert: sn_ind_tmt_orm_order Standard: Leere Zeichenfolge | | Produktbestellungselement.Artikelpreis.Preis | Beschreibung des Preises des zugeordneten Produkts. Datentyp: Objekt "price": { "taxIncludedAmount": {Object} } Tabelle aktualisiert: sn_ind_tmt_orm_order_line_item Standard: Leere Zeichenfolge | | „productOrderItem.itemPrice.Preis.SteuerEnthalteneBetrag" | Beschreibung des Preises des zugehörigen Produkts, einschließlich Steuer. Datentyp: Objekt "taxIncludedAmount": { "unit": "String", "value": Number } Tabelle aktualisiert: sn_ind_tmt_orm_order_line_item | | ProduktAuftragselement.Elementpreis.Preis.SteuerEnthaltenerBetrag.Einheit | Währungscode, in dem der Preis dargestellt wird. Datentyp: Zeichenfolge Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item/mrc oder nrc | | ProduktAuftragselement.Elementpreis.Preis.SteuerEnthaltenerBetrag.Wert | Preis des Produkts, einschließlich Steuern. Datentyp: Zahl Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item/mrc oder nrc | | „productOrderItem.itemPrice.PriceType" | Gibt an, ob der Preis des Artikels wiederkehrend oder nicht wiederkehrend ist. Datentyp: Zeichenfolge | | „productOrderItem.itemPrice.recurringChargePeriod" | Wenn sich der Preis wiederkehrt, gibt den wiederkehrenden Zeitraum an, z. B. Monat. Datentyp: Zeichenfolge | | ProduktBestellelement.Produkt | Erforderlich, wenn productOrderItem.action „ ändern" oder „löschen" ist. Beschreibung der Instanzdetails des vom Kunden erworbenen Produkts. Datentyp: Objekt "product": { "id": "String", "place": {Object}, "productCharacteristic": [Array], "productSpecification": {Object}, "relatedParty": {Object}, "@type": "String" } Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item | | productOrderItem.product.id | Erforderlich, wenn productOrderItem.action „ ändern" oder „löschen" ist. Eindeutiger Bezeichner des verkauften Produkts. Befindet sich im Feld „sys_id" oder „sn_ind_tmt_orm_external_id" der Tabelle „Produktbestand" \[sn_ind_tmt_orm_product_inventory\]. Datentyp: Zeichenfolge Standard: Leere Zeichenfolge | | productOrderItem.product.place | Karten der Speicherorte, an denen das Produkt installiert werden soll. Datentyp: Objekt "place": { "id": "String", "@type": "String" } Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item | | productOrderItem.product.place.id | Erforderlich. Sys_id des zugeordneten Standortdatensatzes in der Standorttabelle \[cmn_location\]. Datentyp: Zeichenfolge Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item/location | | productOrderItem.product.place.@type | Teil des TMF Open API-Standards. Anmerkung für den Kontakt des Bestellpositionselements. Dieser Wert ist immer Place. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | | productOrderItem.product.productMerkmal | Array von Objekten, die die Eigenschaften des zugeordneten Produkts beschreiben. Datentyp: Array "productCharacteristic": [ { "name": "String", "previousValue": "String", "value": "String" } ] Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_characterist_value | | productOrderItem.product.productCharacteristic.name | Name des Merkmaldatensatzes, der dem Produkt zugeordnet werden soll. Befindet sich in der Tabelle „Merkmal" \[sn_prd_pm_charakteristik\]. Datentyp: Zeichenfolge Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_charakterist_wert/merkmale Standard: Leere Zeichenfolge | | „productOrderItem.product.productFeature. previousValue" | Vorherige Merkmaloptionswerte, wenn die Aktualisierung für den Change-Auftrag gilt. Die Anforderung ist ein Change, wenn der Parameter productOrderItem.action etwas anderes als addist. Weitere Informationen zu Merkmalsoptionswerten finden Sie unter [Create product characteristics and characteristic options](https://www.servicenow.com/docs/access?context=som-product-config-add-characteristics&version=xanadu&pubname=xanadu-order-management&ft:locale=en-US). Datentyp: Zeichenfolge Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_charakterist_wert/vorherige_charakterist_option_wert Standard: Leere Zeichenfolge | | productOrderItem.product.productMerkmal.Wert | Merkmaloptionswerte, die dem Produkt zugeordnet sind. Weitere Informationen zu Merkmalsoptionswerten finden Sie unter [Create product characteristics and characteristic options](https://www.servicenow.com/docs/access?context=som-product-config-add-characteristics&version=xanadu&pubname=xanadu-order-management&ft:locale=en-US). Datentyp: Zeichenfolge Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_charakterist_wert/charakterist_option_wert Standard: Leere Zeichenfolge | | productOrderItem.product.productSpecification | Erforderlich. Beschreibung der Produktspezifikation, die dem Produkt zugeordnet ist. Hinweis: Change-Aufträge (productOrderItem.action ist `change`) werden je nach Wert der Systemeigenschaft sn_ind_tmt_orm.allowSpecVersionUpdateInChangeOrder unterschiedlich verarbeitet. Der Wert dieser Systemeigenschaft bestimmt, wie die Bestellung verarbeitet wird, wenn der Produktbestand eine andere Version aufweist als die im Auftrag angegebene. * Wenn diese Systemeigenschaft auf „true" (Standard) festgelegt ist, wird der Produktbestand automatisch auf die Version im Auftrag aktualisiert, indem die referenzierte Produktspezifikation geändert wird. Dadurch kann der Auftrag erfolgreich verarbeitet werden. * Wenn diese Systemeigenschaft auf „false" festgelegt ist und der Produktbestand eine andere Version als die in der Bestellung angegebene aufweist, schlägt die Bestellung aufgrund der Versionsabweichung fehl. {#tmf_prod_order-POST-productOrder__ul_zbw_sdz_dbc} Datentyp: Objekt "productSpecification": { "id": "String", "internalVersion": "String", "name": "String", "version": "String", "@type": "String" } Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item | | productOrderItem.product.productSpecification.id | Erforderlich. Initial_version oder external_id der Produktspezifikation. initial_version ist die sys_id der ersten Version der Spezifikation. Befindet sich im Feld „sys_id" oder „external_id" der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. Datentyp: Zeichenfolge | | productOrderItem.product.productSpecification.interneVersion | Version der Produktspezifikation. Befindet sich in der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. Datentyp: Zeichenfolge | | productOrderItem.product.productSpecification.name | Name der Produktspezifikation. Befindet sich in der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. Datentyp: Zeichenfolge | | Produktbestellelement.Produkt.Produktspezifikation.Version | Externe_Version der Produktspezifikation. Befindet sich in der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. Datentyp: Zeichenfolge | | productOrderItem.product.productSpecification.@type | Teil des TMF Open API-Standards. Dieser Wert ist immer ProductSpecificationRef. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | | Bestellelement.Produkt.zugehörigePartei | Array von Objekten, die die mit einem OrderLineItemContact verknüpfte Parteirolle beschreiben Datentyp: Array "relatedParty": [ { "email": "String", "firstName": "String", "lastName": "String", "phone": "String", "@referredType": "String", "@type": "String" } ] Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item_contact | | productOrderItem.product.relatedParty.email | E-Mail-Adresse des Kontakts Datentyp: Zeichenfolge Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item_contact/email Standard: Leere Zeichenfolge | | Bestellelement.Produkt.zugehörigePartei.ersterName | Vorname des Kontakts Datentyp: Zeichenfolge Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item_contact/first_name Standard: Leere Zeichenfolge | | productOrderItem.product.relatedPartei.lastName | Nachname des Kontakts Datentyp: Zeichenfolge Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item_contact/lastName Standard: Leere Zeichenfolge | | productOrderItem.product.relatedParty.phone | Geschäftliche Telefonnummer des Kontakts Datentyp: Zeichenfolge Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item_contact/business_phone Standard: Leere Zeichenfolge | | „productOrderItem.product.relatedPartei.@referredType" | Erforderlich. Typ des Kunden Möglicher Wert: OrderLineItemContact Datentyp: Zeichenfolge | | productOrderItem.product.relatedPartei.@type | Teil des TMF Open API-Standards. Anmerkung für den Kontakt des Bestellpositionselements. Dieser Wert ist immer RelatedParty. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | | productOrderItem.product.@type | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer Produkt. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | | ProduktBestellelement.Produktangebot | Erforderlich. Beschreibung des Produktangebots, das dem Produkt zugeordnet ist. Datentyp: Objekt "productOffering": { "id": "String", "internalVersion": "String", "name": "String", "version": "String" } Tabelle aktualisiert: sn_ind_tmt_orm_order_line_item | | productOrderItem.productOffering.id | Erforderlich. Initial_version oder external_id des Produktangebots. initial_version ist die sys_id der ersten Version des Angebots. Zu finden im Feld „sys_id" oder „external_id" der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge | | ProduktBestellelement.Produktangebot.interneVersion | Version des Produktangebots. Befindet sich in der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge | | productOrderItem.productOffering.name | Name des Produktangebots Befindet sich in der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge | | ProduktBestellelement.Produktangebot.Version | Externe_Version des Produktangebots Befindet sich in der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge | | Produktbestellungselement.Produktbestellungselement.Menge | Anzahl der Artikel, die der Bestellung zugeordnet sind. Datentyp: Zahl Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order/quantity Standard: null | | Produktbestellungselement.ProduktbestellungselementBeziehung | Erforderlich. Array von Objekten, die die über- und untergeordnete Beziehung zwischen Bestellpositionen beschreiben. Datentyp: Array "productOrderItemRelationship": [ { "id": "String", "relationshipType": "String" } ] Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item | | productOrderItem.productOrderItemRelationship.id | Erforderlich. Identifiziert sich mit dem Wert productOrderItem.id. Wird für die Beziehung zwischen über- und untergeordneten Elementen verwendet Datentyp: Zeichenfolge Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item/parent_line_item Standard: Leere Zeichenfolge | | „productOrderItem.productOrderItemRelationship.relationshipType" | Erforderlich. Typ der Beziehung zwischen den beiden Einzelposten. Diese Informationen werden verwendet, um die Beziehungshierarchie zu identifizieren. Mögliche Werte: * HasChild * Hat übergeordnet {#tmf_prod_order-POST-productOrder__ul_rmq_vrk_5rb} Datentyp: Zeichenfolge | | Produktbestellungselement.Menge | Anzahl der bestellten Artikel. Datentyp: Zahl Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order/quantity Standard: Leere Zeichenfolge | | produktBestellelement.@type | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer ProductOrderItem. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | | Zugehörige Partei | Liste der Kontakte für den Auftrag. Jeder Kontakt ist ein Objekt im Array. Muss mindestens ein Element aufführen, das Informationen zu Kunden- oder Verbraucherkonten enthält. Datentyp: Array "relatedParty": [ { "id": "String", "name": "String", "@referredType": "String", "@type": "String" } ] | | relatedParty.id | Sys_id oder external_id des Accounts oder Kundenkontakts, der dem Auftrag zugeordnet ist. Entweder in der Tabelle „Account" \[customer_account\], „Kontakt" \[customer_contact\] oder „Verbraucher" \[csm_consumer\]. Datentyp: Zeichenfolge | | relatedParty.name | Name des Accounts, Kunden oder Verbrauchers. Datentyp: Zeichenfolge | | zugehörigepartei.@referenztyp | Erforderlich. Typ des Kunden Mögliche Werte: * Verbraucher * Kunde * Kundenkontakt {#tmf_prod_order-POST-productOrder__ul_smq_vrk_5rb} Datentyp: Zeichenfolge | | zugehörigepartei.@typ | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer RelatedParty. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | | RequestedCompletionDate | Vom Kunden angefordertes Lieferdatum Datentyp: Zeichenfolge Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order/expected_end_date Standard: Leere Zeichenfolge | | Angefordertes Startdatum | Vom Kunden angefordertes Auftragsstartdatum. Datentyp: Zeichenfolge Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order/expected_start_date Standard: Leere Zeichenfolge | | @type | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer ProductOrder. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | [Tabelle : 51. Parameter des Anforderungstexts (JSON)] {#tmf_prod_order-POST-productOrder__id_vk2_p5n_t4b} ### Kopfzeilen Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST API verwendet werden, finden Sie unter [Unterstützte REST API-Header](https://www.servicenow.com/docs/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können."). {#tmf_prod_order-POST-productOrder__table_omb_dvk_5rb__entry__2}{#tmf_prod_order-POST-productOrder__accept-JSON-only-entry-RESTAPI}{#tmf_prod_order-POST-productOrder__content_type-JSON-only-entry-RESTAPI} | Kopfzeile | Beschreibung | |-|-| | Akzeptieren | Datenformat des Antworttexts. Unterstützt nur application/json. | | Content-Type | Datenformat des Anforderungstexts. Unterstützt nur application/json. | [Tabelle : 52. Anforderungskopfzeilen] {#tmf_prod_order-POST-productOrder__table_omb_dvk_5rb} {#tmf_prod_order-POST-productOrder__table_tzy_thy_ksb__entry__2} | Kopfzeile | Beschreibung | |-|-| | Inhaltstyp | Datenformat des Antworttexts. Unterstützt nur application/json. | [Tabelle : 53. Antwortkopfzeilen] {#tmf_prod_order-POST-productOrder__table_tzy_thy_ksb} ### Statuscodes Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST API verwendet werden, finden Sie unter [HTTP-Antwortcodes](https://www.servicenow.com/docs/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API. {#tmf_prod_order-POST-productOrder__entry__152} | Statuscode | Beschreibung | |-|-| | 201 | Erfolgreich. Wenn Probleme mit den Merkmalen oder Merkmalsoptionsinformationen auftreten, speichert der Endpunkt die folgenden Kommentare in den Arbeitsnotizen-Feldern des zugehörigen Kundenauftragspositionselement-Datensatzes: * Die folgenden Merkmale für Bestellelemente sind nicht vorhanden: Überprüfen Sie die Spezifikation \, und korrigieren Sie das Merkmal und die Merkmalsoption in der Auftragsposition, bevor Sie den Auftrag genehmigen. * Merkmal des Bestellelements: \ mit Merkmalswert: \ist ungültig. Korrigieren Sie die Merkmalswerte, bevor Sie den Auftrag genehmigen. {#tmf_prod_order-POST-productOrder__ul_xtx_xym_t4b} | | 400 | Ungültige Anforderung. Kann einer der folgenden Gründe sein: * Ungültige Nutzlast: Anforderungstext fehlt -- Nutzlast wurde im Anforderungstext nicht übergeben. * Ungültige Nutzlast: productOrderItem fehlt -- Objekt für Produktauftragsposition oder JSON fehlt. * Ungültige Nutzlast: productOrderItem-ID fehlt -- Der Parameter id fehlt in der Produktbestellposition der Nutzlast. * Ungültige Nutzlast: Aktion „productOrderItem" fehlt -- Der Parameter action fehlt in der Produktbestellposition der Nutzlast. * Ungültige Nutzlast: productOrderItem Produktangebot fehlt -- Das Produktangebotsobjekt oder JSON fehlt in der Produktbestellposition in der Nutzlast. * Ungültige Nutzlast: Produktangebots-ID fehlt -- Der Parameter id fehlt in der Produktbestellposition des Produktangebotsobjekts in der Nutzlast. * Ungültige Nutzlast: Produktangebot ist nicht vorhanden -- Das Produktangebot in der Produktauftragsposition ist nicht gültig. * Ungültige Nutzlast: Produkt „productOrderItem" fehlt : Das Produktobjekt oder JSON in der Produktauftragsposition fehlt in der Nutzlast. * Ungültige Nutzlast: Produkt, Produktspezifikation fehlt -- Das Produktspezifikationsobjekt oder JSON in der Produktbestellposition fehlt in der Nutzlast. * Ungültige Nutzlast: Produktspezifikations-ID fehlt -- Der Parameter id in der Produktbestellposition des Produktspezifikationsobjekts fehlt in der Nutzlast. * Ungültige Nutzlast: Produktspezifikation ist nicht vorhanden -- Die Produktspezifikation in der Produktauftragsposition ist ungültig. * Ungültige Nutzlast: Produktbestand nicht vorhanden -- In einem Change-Auftrag (Aktion = Change) ist die Menge eines Artikels größer als der Bestand. * Ungültige Nutzlast: Produktbestands-ID fehlt -- im Change-Auftrag fehlt product.id in der Nutzlast. * Ungültige Nutzlast: Verkauftes Produkt ist inaktiv -- In einem Change-Auftrag ist ein in der Nutzlast angegebenes Produkt inaktiv. * Ungültige Nutzlast: „relatedParty" fehlt : Das Objekt der zugehörigen Partei fehlt in der Nutzlast. * Ungültige Nutzlast: Kunden-Account oder Verbraucher fehlt -- Das Kunden- oder Verbraucherobjekt der zugehörigen Partei fehlt in der Nutzlast. * Ungültige Nutzlast: Verbraucher nicht vorhanden -- Der angegebene Verbraucher der zugehörigen Partei ist in der Instanz ServiceNow nicht vorhanden. * Ungültige Nutzlast: Kunden-Account nicht vorhanden -- Der angegebene zugehörige Vertragspartei-Kunde ist in der Instanz ServiceNow nicht vorhanden. * Ungültige Nutzlast: Auftragserstellung fehlgeschlagen -- Der angeforderte Auftrag kann nicht erstellt werden. {#tmf_prod_order-POST-productOrder__ul_g2v_rzm_t4b} | [Tabelle : 54. Statuscodes] ### Parameter des Antwort-Haupttexts (JSON) {#tmf_prod_order-POST-productOrder__entry__158} | Name | Beschreibung | |-|-| | channel | Array von Objekten, die die Kanäle beschreiben, die für den Verkauf der Produkte verwendet werden sollen Datentyp: Array "channel": [ { "id": "String", "name": "String" } ] | | channel.id | Eindeutiger Bezeichner des Kanals, der für den Verkauf der zugehörigen Produkte verwendet werden soll. Kanal-ID-Werte befinden sich im Feld „external_id" der Tabelle „Verteilungskanal" \[sn_prd_pm_distribution_channel\]. Datentyp: Zeichenfolge | | Kanalname | Name des Kanals, der für den Verkauf der zugehörigen Produkte verwendet werden soll. Datentyp: Zeichenfolge | | id | Sys_id des Kundenauftrags, der für diese Anforderung erstellt wurde. Datentyp: Zeichenfolge | | externalId | Externer Bezeichner für den Kundenauftrag, z. B. eine Bestellnummer. Datentyp: Zeichenfolge | | Hinweis | Array von Objekten, die zusätzliche Notizen beschreiben, die der Kunde bei der Bestellung gemacht hat. Datentyp: Array "note": [ { "text": "String" } ] | | Anmerkung.Text | Zusätzliche Hinweise/Kommentare vom Kunden während der Bestellung. Datentyp: Zeichenfolge | | productOrderItem | Liste, die die der Produktbestellung zugeordneten Elemente und die zugehörige Aktion beschreibt. Datentyp: Array "productOrderItem:" [ { "action": "String", "id": "String", "itemPrice": [Array], "product": {Object}, "productOffering": {Object}, "productOrderItemReleationship": [Array], "quantity": Number, "state": "String", "@type": "String" } ] | | productOrderItem.action | Aktion, die für das Produkt ausgeführt werden soll. Mögliche Aktionen sind auf der Registerkarte „Auswahlliste" im Aktionswörterbucheintrag der Tabelle sn_ind_tmt_orm_order_line_item definiert. Datentyp: Zeichenfolge | | productOderItem.actionReason | Der Grund für das Hinzufügen der Auftragsposition. Datentyp: Zeichenfolge Tabelle/Feld aktualisiert: sn_ind_tmt_orm_order_line_item/action_reason | | productOrderItem.id | Eindeutiger Bezeichner der Position. Zu finden im Feld sn_ind_tmt_orm_external_id der Tabelle „Auftragspositionselement" \[sn_ind_tmt_orm_order_line_item\]. Datentyp: Zeichenfolge | | Produktbestellungselement.Artikelpreis | Array von Objekten, die den dem Produkt zugeordneten Preis beschreiben Datentyp: Array "itemPrice": [ { "price": {Object}, "priceType": "String", "recurringChargePeriod": "String" } ] | | Produktbestellungselement.Artikelpreis.Preis | Beschreibung des Preises des zugeordneten Produkts. Datentyp: Objekt "price": { "taxIncludedAmount": {Object} } | | „productOrderItem.itemPrice.Preis.SteuerEinschlussBetrag" | Beschreibung des Preises des zugehörigen Produkts, einschließlich Steuer. Datentyp: Objekt "taxIncludedAmount": { "unit": "String", "value": Number } | | ProduktAuftragselement.Elementpreis.Preis.SteuerEinschlussBetrag.Einheit | Währungscode, in dem der Preis dargestellt wird. Datentyp: Zeichenfolge | | ProduktAuftragselement.Elementpreis.Preis.SteuerEinschlussBetrag.Wert | Preis des Produkts, einschließlich Steuern. Datentyp: Zahl | | „productOrderItem.itemPrice.PriceType" | Typ des Artikelpreises, wiederkehrend oder nicht wiederkehrend. Datentyp: Zeichenfolge | | „productOrderItem.itemPrice.recurringChargePeriod" | Wenn der Preis wiederkehrend ist, der wiederkehrende Zeitraum, z. B. Monat. Datentyp: Zeichenfolge | | ProduktBestellelement.Produkt | Beschreibung der Instanzdetails des vom Kunden erworbenen Produkts. Datentyp: Objekt "product": { "id": "String", "place": {Object}, "productCharacteristic": [Array], "productSpecification": {Object}, "relatedParty": {Object}, "@type": "String" } | | productOrderItem.product.id | Eindeutiger Bezeichner des verkauften Produkts. Befindet sich im Feld „sys_id" oder „sn_ind_tmt_orm_external_id" der Tabelle „Produktbestand" \[sn_ind_tmt_orm_product_inventory\]. Dieser Parameter wird nur zurückgegeben, wenn productOrderItem.actionchange oder deleteist. Wenn sowohl „sys_id" als auch „external_id" vorhanden sind, wird „external_id" zurückgegeben. Datentyp: Zeichenfolge | | productOrderItem.product.place | Karten der Speicherorte, an denen das Produkt installiert werden soll. Datentyp: Objekt "place": { "id": "String", "@type": "String" } | | productOrderItem.product.place.id | Sys_id des zugeordneten Standortdatensatzes in der Standorttabelle \[cmn_location\]. Datentyp: Zeichenfolge | | productOrderItem.product.productMerkmal | Array von Objekten, die die Eigenschaften des zugeordneten Produkts beschreiben. Datentyp: Array "productCharacteristic": [ { "name": "String", "previousValue": "String", "value": "String" } ] | | productOrderItem.product.productCharacteristic.name | Name des Merkmaldatensatzes, der dem Produkt zugeordnet werden soll. Befindet sich in der Tabelle „Merkmal" \[sn_prd_pm_charakteristik\]. Datentyp: Zeichenfolge | | „productOrderItem.product.productFeature. previousValue" | Vorherige Merkmalsoptionswerte, wenn die Aktualisierung für einen Change-Auftrag erfolgt. Die Anforderung ist ein Change, wenn der Parameter productOrderItem.action etwas anderes als addist. Weitere Informationen zu Merkmalsoptionswerten finden Sie unter [Create product characteristics and characteristic options](https://www.servicenow.com/docs/access?context=som-product-config-add-characteristics&version=xanadu&pubname=xanadu-order-management&ft:locale=en-US). Datentyp: Zeichenfolge | | productOrderItem.product.productMerkmal.Wert | Merkmaloptionswerte, die dem Produkt zugeordnet sind. Weitere Informationen zu Merkmalsoptionswerten finden Sie unter [Create product characteristics and characteristic options](https://www.servicenow.com/docs/access?context=som-product-config-add-characteristics&version=xanadu&pubname=xanadu-order-management&ft:locale=en-US). Datentyp: Zeichenfolge | | productOrderItem.product.productSpecification | Beschreibung der Produktspezifikation, die dem Produkt zugeordnet ist. Datentyp: Objekt "productSpecification": { "id": "String", "internalVersion": "String", "name": "String", "version": "String", "@type": "String" } | | productOrderItem.product.productSpecification.id | Initial_version oder external_id der Produktspezifikation. initial_version ist die sys_id der ersten Version der Spezifikation. Befindet sich im Feld „sys_id" oder „external_id" der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. Wenn sowohl „sys_id" als auch „external_id" vorhanden sind, wird „external_id" zurückgegeben. Datentyp: Zeichenfolge | | productOrderItem.product.productSpecification.name | Name der Produktspezifikation. Befindet sich in der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. Datentyp: Zeichenfolge | | productOrderItem.product.productSpecification.@type | Teil des TMF Open API-Standards. Dieser Wert ist immer ProductSpecificationRef. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | | Bestellelement.Produkt.zugehörigePartei | Liste der Kontakte für Positionen. Datentyp: Array "relatedParty:" [ { "email": "String", "firstName": "String", "lastName": "String", "phone": "String", "@referredType": "String", "@type": "String" } ] | | productOrderItem.product.relatedParty.email | E-Mail-Adresse des Kontakts Datentyp: Zeichenfolge | | Bestellelement.Produkt.zugehörigePartei.ersterName | Vorname des Kontakts Datentyp: Zeichenfolge | | productOrderItem.product.relatedPartei.lastName | Nachname des Kontakts Datentyp: Zeichenfolge Datentyp: Zeichenfolge | | productOrderItem.product.relatedParty.phone | Geschäftliche Telefonnummer des Kontakts Datentyp: Zeichenfolge | | „productOrderItem.product.relatedPartei.@referredType" | Typ des Kunden Möglicher Wert: OrderLineItemContact Datentyp: Zeichenfolge | | productOrderItem.product.relatedPartei.@type | Teil des TMF Open API-Standards. Anmerkung für den Kontakt des Bestellpositionselements. Dieser Wert ist immer RelatedParty. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | | productOrderItem.product.@type | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer Produkt. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | | ProduktBestellelement.Produktangebot | Beschreibung des Produktangebots, das dem Produkt zugeordnet ist. Datentyp: Objekt "productOffering": { "id": "String", "internalVersion": "String", "name": "String", "version": "String" } | | productOrderItem.productOffering.id | Initial_version oder external_id des Produktangebots. initial_version ist die sys_id der ersten Version des Angebots. Zu finden im Feld „sys_id" oder „external_id" der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Wenn sowohl „sys_id" als auch „external_id" vorhanden sind, wird „external_id" zurückgegeben. Datentyp: Zeichenfolge | | productOrderItem.productOffering.name | Name des Produktangebots Befindet sich in der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge | | Produktbestellungselement.ProduktbestellungselementBeziehung | Array von Objekten, die die Beziehungen zwischen Bestellpositionen beschreiben. Datentyp: Array "productOrderItemRelationship": [ { "id": "String", "relationshipType": "String" } ] | | productOrderItem.productOrderItemRelationship.id | Eindeutiger Bezeichner des zugehörigen Einzelpostens. Zu finden im Feld sn_ind_tmt_orm_external_id der Tabelle „Auftragspositionselement" \[sn_ind_tmt_orm_order_line_item\]. Datentyp: Zeichenfolge | | „productOrderItem.productOrderItemRelationship.relationshipType" | Typ der Beziehung zwischen den beiden Einzelposten. Diese Informationen werden verwendet, um die Beziehungshierarchie zu identifizieren. Datentyp: Zeichenfolge | | Produktbestellungselement.Menge | Anzahl der Artikel, die der Bestellung zugeordnet sind. Datentyp: Zahl | | „productOrderItem.state" | Aktueller Status des Produktbestellartikels. Dieser Wert ist immer neu. Datentyp: Zeichenfolge | | produktBestellelement.@type | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer ProductOrderItem. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | | Zugehörige Partei | Liste der Kontakte für den Auftrag. Jeder Kontakt ist ein Objekt im Array. Muss mindestens ein Element aufführen, das Informationen zu Kunden- oder Verbraucherkonten enthält. Datentyp: Array "relatedParty": [ { "id": "String", "name": "String", "@referredType": "String", "@type": "String" } ] | | relatedParty.id | Sys_id oder external_id des Accounts, Kundenkontakts oder Verbrauchers, der dem Auftrag zugeordnet ist. Zu finden in der Tabelle „Account" \[customer_account\], „Kontakt" \[customer_contact\] oder „Verbraucher" \[csm_consumer\]. Datentyp: Zeichenfolge | | relatedParty.name | Name des Accounts, Kunden oder Verbrauchers. Datentyp: Zeichenfolge | | ZugehörigePartei.Typ | Typ des Kunden Mögliche Werte: * Verbraucher * Kunde * Kundenkontakt {#tmf_prod_order-POST-productOrder__ul_lcq_jwm_t4b} Datentyp: Zeichenfolge | | RequestedCompletionDate | Vom Kunden angefordertes Lieferdatum Datentyp: Zeichenfolge | | Angefordertes Startdatum | Vom Kunden angefordertes Auftragsstartdatum. Datentyp: Zeichenfolge | | Staat | Aktueller Status des Auftrags. Für diesen Endpunkt ist dieser Wert immer neu. Datentyp: Zeichenfolge | | @type | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer ProductOrder. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge | [ ] ### cURL-Anforderung Im folgenden Codebeispiel wird ein Kundenauftrag erstellt. curl -X POST "https://servicenow-instance/api/sn_ind_tmt_orm/productorder" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -u "username":"password" \ -d { "requestedCompletionDate": "2021-05-02T08:13:59.506Z", "requestedStartDate": "2020-05-03T08:13:59.506Z", "externalId": "PO-456", "channel": [ { "id": "2", "name": "Online channel" } ], "note": [ { "text": "This is a TMF product order illustration" }, { "text": "This is a TMF product order illustration no 2" } ], "productOrderItem": [ { "id": "POI100", "quantity": 1, "action": "change", "product": { "id": "fa6d13f45b5620102dff5e92dc81c77f", "@type": "Product", "productSpecification": { "id": "cfe5ef6a53702010cd6dddeeff7b12f6", "name": "SD-WAN Service Package", "@type": "ProductSpecificationRef" }, "place": { "id": "25ab9c4d0a0a0bb300f7dabdc0ca7c1c", "@type": "Place" } }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering" }, "productOrderItemRelationship": [ { "id": "POI120", "relationshipType": "HasChild" }, { "id": "POI130", "relationshipType": "HasChild" } ], "@type": "ProductOrderItem" }, { "id": "POI120", "quantity": 1, "action": "change", "itemPrice": [ { "priceType": "recurring", "recurringChargePeriod": "month", "price": { "taxIncludedAmount": { "unit": "USD", "value": 20 } } } ], "product": { "id": "766d13f45b5620102dff5e92dc81c78a", "@type": "Product", "productCharacteristic": [ { "name": "WAN Optimization", "value": "Base", "previousValue": "Advance" } ], "productSpecification": { "id": "39b627aa53702010cd6dddeeff7b1202", "name": "SD-WAN Edge Device", "@type": "ProductSpecificationRef" }, "relatedParty": [ { "id": "51670151c35420105252716b7d40ddfe", "firstName": "Joe", "lastName": "Doe", "email": "abc@example.com", "phone": "1234567890", "@type": "RelatedParty", "@referredType": "OrderLineItemContact" } ], "place": { "id": "25ab9c4d0a0a0bb300f7dabdc0ca7c1c", "@type": "Place" } }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering" }, "productOrderItemRelationship": [ { "id": "POI100", "relationshipType": "HasParent" } ], "@type": "ProductOrderItem" }, { "id": "POI130", "quantity": 1, "action": "add", "itemPrice": [ { "priceType": "recurring", "recurringChargePeriod": "month", "price": { "taxIncludedAmount": { "unit": "USD", "value": 20 } } } ], "product": { "@type": "Product", "productCharacteristic": [ { "name": "Security Type", "value": "Base", "previousValue": "Advance" } ], "productSpecification": { "id": "a6514bd3534560102f18ddeeff7b1247", "name": "SD-WAN Security", "@type": "ProductSpecificationRef" }, "relatedParty": [ { "id": "51670151c35420105252716b7d40ddfe", "firstName": "Joe", "lastName": "Doe", "email": "abc@example.com", "phone": "1234567890", "@type": "RelatedParty", "@referredType": "OrderLineItemContact" } ], "place": { "id": "25ab9c4d0a0a0bb300f7dabdc0ca7c1c", "@type": "Place" } }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering" }, "productOrderItemRelationship": [ { "id": "POI100", "relationshipType": "HasParent" } ], "@type": "ProductOrderItem" } ], "relatedParty": [ { "id": "eaf68911c35420105252716b7d40ddde", "name": "Sally Thomas", "@type": "RelatedParty", "@referredType": "CustomerContact" }, { "id": "ffc68911c35420105252716b7d40dd55", "name": "Funco Intl", "@type": "RelatedParty", "@referredType": "Customer" }, { "id": "59f16de1c3b67110ff00ed23a140dd9e", "name": "Funco External", "@type": "RelatedParty", "@referredType": "Consumer" } ], "@type": "ProductOrder" } Antworttext. { "requestedCompletionDate": "2021-05-02T08:13:59.506Z", "requestedStartDate": "2020-05-03T08:13:59.506Z", "externalId": "PO-456", "channel": [ { "id": "2", "name": "Online chanel" } ], "note": [ { "text": "This is a TMF product order illustration" }, { "text": "This is a TMF product order illustration no 2" } ], "productOrderItem": [ { "id": "POI100", "quantity": 1, "action": "change", "product": { "id": "fa6d13f45b5620102dff5e92dc81c77f", "@type": "Product", "productSpecification": { "id": "cfe5ef6a53702010cd6dddeeff7b12f6", "name": "SD-WAN Service Package", "@type": "ProductSpecificationRef" }, "place": { "id": "25ab9c4d0a0a0bb300f7dabdc0ca7c1c", "@type": "Place" } }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering" }, "productOrderItemRelationship": [ { "id": "POI120", "relationshipType": "HasChild" }, { "id": "POI130", "relationshipType": "HasChild" } ], "@type": "ProductOrderItem", "state": "new" }, { "id": "POI120", "quantity": 1, "action": "change", "itemPrice": [ { "priceType": "recurring", "recurringChargePeriod": "month", "price": { "taxIncludedAmount": { "unit": "USD", "value": 20 } } } ], "product": { "id": "766d13f45b5620102dff5e92dc81c78a", "@type": "Product", "productCharacteristic": [ { "name": "WAN Optimization", "value": "Base", "previousValue": "Advance" } ], "productSpecification": { "id": "39b627aa53702010cd6dddeeff7b1202", "name": "SD-WAN Edge Device", "@type": "ProductSpecificationRef" }, "relatedParty": [ { "id": "51670151c35420105252716b7d40ddfe", "firstName": "Joe", "lastName": "Doe", "email": "abc@example.com", "phone": "1234567890", "@type": "RelatedParty", "@referredType": "OrderLineItemContact" } ], "place": { "id": "25ab9c4d0a0a0bb300f7dabdc0ca7c1c", "@type": "Place" } }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering" }, "productOrderItemRelationship": [ { "id": "POI100", "relationshipType": "HasParent" } ], "@type": "ProductOrderItem", "state": "new" }, { "id": "POI130", "quantity": 1, "action": "add", "itemPrice": [ { "priceType": "recurring", "recurringChargePeriod": "month", "price": { "taxIncludedAmount": { "unit": "USD", "value": 20 } } } ], "product": { "@type": "Product", "productCharacteristic": [ { "name": "Security Type", "value": "Base", "previousValue": "Advance" } ], "productSpecification": { "id": "a6514bd3534560102f18ddeeff7b1247", "name": "SD-WAN Security", "@type": "ProductSpecificationRef" }, "relatedParty": [ { "id": "51670151c35420105252716b7d40ddfe", "firstName": "Joe", "lastName": "Doe", "email": "abc@example.com", "phone": "1234567890", "@type": "RelatedParty", "@referredType": "OrderLineItemContact" } ], "place": { "id": "25ab9c4d0a0a0bb300f7dabdc0ca7c1c", "@type": "Place" } }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering" }, "productOrderItemRelationship": [ { "id": "POI100", "relationshipType": "HasParent" } ], "@type": "ProductOrderItem", "state": "new" } ], "relatedParty": [ { "id": "eaf68911c35420105252716b7d40ddde", "name": "Sally Thomas", "@type": "RelatedParty", "@referredType": "CustomerContact" }, { "id": "ffc68911c35420105252716b7d40dd55", "name": "Funco Intl", "@type": "RelatedParty", "@referredType": "Customer" }, { "id": "59f16de1c3b67110ff00ed23a140dd9e", "name": "Funco External", "@type": "RelatedParty", "@referredType": "Consumer" } ], "@type": "ProductOrder", "id": "6be0a925c3a220103e2e73ce3640ddfe", "state": "new" }