---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Offene API für Produktbestellung

# Offene API für Produktbestellung {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 128 Minuten Lesedauer

Die Produktbestellung Offen Die API stellt Endpunkte bereit, die einen standardisierten Mechanismus für die Platzierung von Produktbestellungen ermöglichen.
Eine Produktbestellung wird basierend auf einem Produktangebot erstellt, das in einem Produktkatalog definiert und veröffentlicht ist. Das Produktangebot identifiziert das Produkt oder den Satz von Produkten, die einem Kunden zur Verfügung stehen, und enthält die relevanten Produktmerkmale, die die eindeutigen Optionen eines Produkts erfassen, sowie andere relevante Attribute wie Preise, Vertragsbedingungen und Verfügbarkeit.

Um auf diese API zuzugreifen, muss das Plugin „Auftragsmanagement für Telekommunikation" (sn_ind_tmt_orm) aktiviert sein.

Diese API wird in bereitgestellt `sn_ind_tmt_orm `Namespace.

Der aufrufende Anwender muss über die Rolle „sn_ind_tmt_orm.order_integrator" verfügen.

Diese API kann erweitert werden, um Anpassungen an erforderlichen Parametern, die Validierung des Anforderungstexts, zusätzliche REST-Vorgänge und Feldzuordnungen vorzunehmen. Weitere Informationen finden Sie unterDie [Produktbestellung -- API-Entwicklerleitfaden öffnen](https://servicenow-prod.fluidtopics.net/wLjiE4WDIQVxtJapEIxwTw#product-order_dev-guide "Verwenden Sie Offene API für Produktbestellung Dient zum Erstellen, Aktualisieren und Abrufen von Produktbestellungsinformationen.").

Die Produktbestellung Offen API ist ein ServiceNow®Implementierung der REST-Spezifikation der TM-Forum-API TMF622 für Produktbestellungsmanagement und ist vom TM-Forum zertifiziert.

## Offene API für Produktbestellung -- GET /sn_ind_tmt_orm/order/productOrder AB {#ariaid-title2}

Ruft alle Produktbestellungen ab.
Dieser Endpunkt ruft Bestellinformationen aus den folgenden Tabellen ab:

* Kundenauftrag \[sn_ind_tmt_orm_order\]
* Auftragspositionselement \[sn_ind_tmt_orm_order_line_item\]
* Bestellmerkmal \[sn_ind_tmt_orm_order_characteristic_value\]
* Auftragspositionselementkontakt \[sn_ind_tmt_orm_order_line_item_contact\]
* Auftragspositionselemente \[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. Pfad-Parameter]

{#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. Datentyp: Zeichenfolge Standard: Alle Felder zurückgegeben. |
| limit | Maximale Anzahl zurückzugebender Datensätze. Für Anforderungen, die diese Anzahl von Datensätzen überschreiten, verwenden Sie offsetParameter zum Paginieren des Datensatzabrufs. Datentyp: Zahl Standard: 20 Maximum: 100 |
| Offset | Startindex, bei dem mit dem Abrufen von Datensätzen begonnen werden soll. Verwenden Sie diesen Wert, um den Datensatzabruf zu paginieren. Diese Funktionalität ermöglicht den Abruf aller Datensätze, unabhängig von der Anzahl der Datensätze, in kleinen verwaltbaren Blöcken. Datentyp: Zahl Standard: 0 |
| Staat | Reihenfolge nach Status filtern. Nur Aufträge mit einem Status, der dem Wert dieses Parameters entspricht, werden in der Antwort zurückgegeben. Datentyp: Zeichenfolge Standard: Nicht nach Status sortieren. |
[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. Anforderungstext-Parameter (JSON)]

{#tmf_prod_order-GET-ord-productOrder__table_xcm_cvr_nsb}

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#tmf_prod_order-GET-ord-productOrder__table_kqy_wgy_fsb__entry__2}

| Header | 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}

| Header | Beschreibung |
|-|-|
| Inhaltsbereich | Inhaltsbereich, der in einem paginierten Aufruf zurückgegeben wird. Beispiel: Wenn `Offset=2 `Und `Grenzwert = 3 `, Der Wert von Content-RangeHeader ist `Elemente 3-5 `. |
| Inhaltstyp | Datenformat des Antworttexts. Nur unterstützt application/json. |
| Verknüpfen | 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. Antwort-Header]

{#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 [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#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 in Antwort zurückgegeben (keine Paginierung). |
| 206 | In Antwort zurückgegebene Teilressource (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}

### Antworttext-Parameter (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 |
|-|-|
| Kanal | Liste der Kanäle, die für den Verkauf der Produkte verwendet werden sollen. Datentyp: Array von Objekten "channel": [ { "id": "String", "name": "String" } ] |
| Kanal.ID | Eindeutiger Bezeichner des Kanals, der zum Verkauf der zugehörigen Produkte verwendet werden soll. Datentyp: Zeichenfolge |
| channel.name | Name des Kanals, der zum 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 oder nach dem übereinstimmen committedDueDateWerte für jedes Auftragspositionselement. Datentyp: Zeichenfolge |
| Erwartetes Abschlussdatum | Datum, an dem der Auftrag abgeschlossen wird. Datentyp: Zeichenfolge |
| href | Relativer Link zum Produktbestellungsdatensatz. Datentyp: Zeichenfolge |
| ID | SYS_ID der Produktbestellung. Datentyp: Zeichenfolge |
| note | Liste der zusätzlichen Notizen, die der Kunde bei der Bestellung gemacht hat. Datentyp: Array von Objekten "note": [ { "author": "String", "date": "String", "text": "String" } ] |
| note.author | Anwendername der Person, die die zugehörige Notiz erstellt hat. Datentyp: Zeichenfolge |
| Hinweis.Datum | Datum, an dem die Notiz erstellt wurde. Datentyp: Zeichenfolge |
| Hinweis.Text | Zusätzliche Notizen/Kommentare des Kunden während der Bestellung. Datentyp: Zeichenfolge |
| Auftragswährung | Währungscode für den Auftrag und die Auftragspositionen. Datentyp: Zeichenfolge |
| Ponr | Kennzeichnung, die angibt, ob der Punkt, an dem die Bestellung nicht zurückgegeben wurde, erreicht wurde. Mögliche Werte: * Wahr: Der Punkt, an dem keine Rückgabe für den Auftrag erfolgt ist, wurde erreicht. * Falsch: Der Punkt, an dem die Bestellung nicht zurückgegeben wurde, wurde nicht erreicht. {#tmf_prod_order-GET-ord-productOrder__ul_tdq_rw1_hqb} Datentyp: Boolescher Wert |
| ProductOrderItem | Liste, die Elemente beschreibt, die der Produktbestellung und der zugehörigen Aktion zugeordnet sind. Datentyp: Array von Objekten "productOrderItem:" [ { "action": "String", "committedDueDate": "String", "externalProductInventory": [Array], "id": "String", "itemPrice": [Array], "product": {Object}, "productOffering": {Object}, "productOrderItemReleationship": [Array], "quantity": Number, "state": "String", "@type": "String" } ] |
| ProductOrderElement.Aktion | Aktion, die für das Produkt ausgeführt werden soll. Mögliche Aktionen werden auf der Registerkarte „Auswahlliste" im Aktionswörterbucheintrag der sn_ind_tmt_orm_order_line_item-Tabelle definiert. Datentyp: Zeichenfolge |
| ProduktbestellungElement.actionReason | Grund für das Hinzufügen der Auftragsposition. Datentyp: Zeichenfolge Gespeichert in: Dem Feld „action_reason" der sn_ind_tmt_orm_order_line_item-Tabelle. |
| productOrderItem.committedDueDate | Datum und Uhrzeit, zu der die Aktion für die Auftragsposition ausgeführt werden muss. Datentyp: Zeichenfolge |
| ProduktbestellungElement.externalProduktbestand | Liste der externen IDs, die den für den Auftrag erstellten Produktbeständen zugeordnet sind. Datentyp: Array von Objekten "externalProductInventory": [ { "externalProductInventoryId": "String" } ] |
| ProduktbestellungElement.externalProduktbestand.externalProduktbestellungId | Externe ID, die dem Produktbestand zugeordnet ist. Datentyp: Zeichenfolge |
| productOrderItem.id | Eindeutiger Bezeichner der Position. Befindet sich im Feld sn_ind_tmt_orm_external_id der Auftragspositionstabelle \[sn_ind_tmt_orm_order_line_item\]. Datentyp: Zeichenfolge |
| productOrderItem.itemPrice | Liste, die den Preis beschreibt, der dem Produkt zugeordnet ist. Datentyp: Array von Objekten "itemPrice": [ { "price": {Object}, "priceType": "String", "recurringChargePeriod": "String" } ] |
| productOrderItem.itemPrice.price | Beschreibung des Preises des zugehörigen Produkts. Datentyp: Objekt "price": { "taxIncludedAmount": {Object} } |
| productOrderItem.itemPrice.price.taxIncludedAmount | Beschreibung des Preises des zugehörigen Produkts, einschließlich der Steuer. Datentyp: Objekt "taxIncludedAmount": { "unit": "String", "value": Number } |
| productOrderItem.itemPrice.price.taxIncludedAmount.unit | Währungscode, in dem der Preis dargestellt wird. Datentyp: Zeichenfolge |
| productOrderItem.itemPrice.price.taxIncludedAmount.value | 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 |
| ProduktbestellungElement.ponr | Kennzeichnung, die angibt, ob der Punkt, an dem die Bestellung nicht zurückgegeben wurde, erreicht wurde. Mögliche Werte: * Wahr: Der Punkt, an dem keine Rückgabe für den Auftrag erfolgt ist, wurde erreicht. * Falsch: Der Punkt, an dem die Bestellung nicht zurückgegeben wurde, wurde nicht erreicht. {#tmf_prod_order-GET-ord-productOrder__d3104e2579} Datentyp: Boolescher Wert |
| productOrderItem.product | Beschreibung der Instanzdetails des vom Kunden gekauften Produkts. Datentyp: Objekt "product:" { "place": {Object}, "productCharacteristic": [Array], "productRelationship": [Array], "productSpecification": {Object}, "relatedParty": {Object}, "@type": "String" } |
| productOrderItem.product.place | Karten der Standorte, 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 Tabelle „Standort" \[cmn_location\]. Datentyp: Zeichenfolge |
| productOrderItem.product.place.@type | Teil des TMF Open API-Standards. Anmerkung für Auftragspositionskontakt. Dieser Wert ist immer <kbd class="ph userinput">Ort </kbd>. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
| productOrderItem.product.productCharacteristic | Liste der Merkmale des zugeordneten Produkts. Nur Produktmerkmale, deren valueUnterscheiden sich von previousValueWerden zurückgegeben. Datentyp: Array von Objekten "productCharacteristic": [ { "name": "String", "previousValue": "String", "value": "String" } ] |
| productOrderItem.product.productCharacteristic.name | Name des Merkmalsdatensatzes, der dem Produkt zugeordnet werden soll. Befindet sich in der Merkmalstabelle \[sn_prd_pm_characteristic\]. Datentyp: Zeichenfolge |
| productOrderItem.product.productCharacteristic.previousValue | Vorherige Merkmalsoptionswerte, wenn die Aktualisierung für einen Change-Auftrag gilt. Die Anforderung ist ein Change-Auftrag, wenn productOrderItem.actionParameter ist anders als <kbd class="ph userinput">Hinzufügen </kbd>. 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=yokohama&pubname=yokohama-order-management&ft:locale=en-US). Datentyp: Zeichenfolge |
| productOrderItem.product.productCharacteristic.value | Merkmalsoptionswerte, 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=yokohama&pubname=yokohama-order-management&ft:locale=en-US). Datentyp: Zeichenfolge |
| productOrderItem.product.productRelationship | Liste der Produktbeziehungsdetails für eine Auftragsposition. Datentyp: Array von Objekten "productRelationship": [ { "id": "String", "relationshipType": "String" } ] |
| productOrderItem.product.productRelationship.id | SYS_ID oder sn_prd_invt_external_id des Produktbestands. Datentyp: Zeichenfolge Tabelle: Im Feld „sys_ID" oder „sn_prd_invt_external_id" der Tabelle „Produktbestand" \[sn_prd_invt_product_inventory\]. |
| productOrderItem.product.productRelationship.relationshipType | Typ der Beziehung zwischen der Auftragsposition und dem Produktbestand. Möglicher Wert: Erforderlich 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 |
| productOrderItem.product.productSpecification.internalId | Anfangsversion der Produktspezifikation. Die Anfangsversion ist die sys_ID der ersten Version der Spezifikation. Datentyp: Zeichenfolge Tabelle: Produktspezifikation \[sn_prd_pm_product_specification\] |
| productOrderItem.product.productSpecification.internalVersion | Version der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „Version" der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. |
| productOrderItem.product.productSpecification.name | Name der Produktspezifikation. Befindet sich in der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. Datentyp: Zeichenfolge |
| productOrderItem.product.productSpecification.version | Externe Version der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld external_Version der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. |
| productOrderItem.product.productSpecification.@type | Teil des Standards für offene TMF-API. Dieser Wert ist immer <kbd class="ph userinput">ProduktspezifikationRef </kbd>. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
| productOrderItem.product.relatedParty | Liste der Kontakte für Einzelposten. Datentyp: Array von Objekten "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 |
| productOrderItem.product.relatedParty.firstName | Vorname des Kontakts. Datentyp: Zeichenfolge |
| productOrderItem.product.relatedParty.id | SYS_ID des Positionskontakts, der der Auftragsposition zugeordnet ist. Befindet sich in der Tabelle „Auftragspositionskontakt" \[sn_ind_tmt_orm_order_line_item_contact\]. Datentyp: Zeichenfolge |
| productOrderItem.product.relatedParty.lastName | Nachname des Kontakts. Datentyp: Zeichenfolge Datentyp: Zeichenfolge |
| productOrderItem.product.relatedParty.phone | Geschäftliche Telefonnummer des Kontakts. Datentyp: Zeichenfolge |
| productOrderItem.product.relatedParty.@referredType | Typ des Kunden. Möglicher Wert: OrderLineItemContact Datentyp: Zeichenfolge |
| productOrderItem.product.relatedParty.@type | Teil des TMF Open API-Standards. Anmerkung für Auftragspositionskontakt. Dieser Wert ist immer <kbd class="ph userinput">Zugehörige Partei </kbd>. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
| productOrderItem.productOffering | 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. Befindet sich im Feld „sys_ID" oder „external_ID" der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge |
| productOrderItem.productOffering.internalId | Anfangsversion des Produktangebots. Die Anfangsversion ist die sys_ID der ersten Version des Angebots. Datentyp: Zeichenfolge Tabelle: Produktangebot \[sn_prd_pm_product_offering\] |
| productOrderItem.productOffering.internalVersion | Version des Produktangebots. Datentyp: Zeichenfolge Tabelle: Im Feld „Version" der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. |
| productOrderItem.productOffering.name | Name des Produktangebots. Befindet sich in der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge |
| productOrderItem.productOffering.version | Externe Version des Produktangebots. Datentyp: Zeichenfolge Tabelle: Im Feld external_Version der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. |
| ProduktbestellungElement.Menge | Anzahl der gekauften Produktartikel. Datentyp: Zahl |
| productOrderItem.productOrderItemRelationship | Liste der Beziehungen zwischen Auftragspositionen. Datentyp: Array von Objekten "productOrderItemRelationship": [ { "id": "String", "relationshipType": "String" } ] |
| productOrderItem.productOrderItemRelationship.id | Eindeutiger Bezeichner der zugehörigen Position. Befindet sich im Feld sn_ind_tmt_orm_external_id der Auftragspositionstabelle \[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 * Übergeordnetes Element * Erfordert {#tmf_prod_order-GET-ord-productOrder__ul_yqf_2ty_54b} `HasChild `Und `Übergeordnetes Element `Werden für übergeordnete/untergeordnete Beziehungen verwendet. `Erfordert `Wird für horizontale Beziehungen verwendet (ein Einzelposten erfordert eine andere Position). Datentyp: Zeichenfolge |
| ProduktbestellungElement.Status | Status der Bestellung des zugeordneten Produktelements. Datentyp: Zeichenfolge |
| ProduktbestellungElement.Version | Auftragsversion. Datentyp: Zeichenfolge |
| ProductOrderItem.@type | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer <kbd class="ph userinput">Produktbestellelement </kbd>. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
| ZugehörigPartei | Liste der Kontakte für den Auftrag. Jeder Kontakt ist ein Objekt im Array. Muss mindestens ein Element auflisten, das Kunden- oder Verbraucherkontoinformationen enthält. Datentyp: Array von Objekten "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. Befindet sich 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 |
| RelatedParty.@referredType | Typ des Kunden. Mögliche Werte: * Verbraucher * Kunde * Kundenkontakt {#tmf_prod_order-GET-ord-productOrder__ul_lcq_jwm_t4b} Datentyp: Zeichenfolge |
| RelatedParty.@type | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer <kbd class="ph userinput">Zugehörige Partei </kbd>. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
| AnfordertAbschlusdatum | Vom Kunden angefordertes Lieferdatum. Datentyp: Zeichenfolge |
| AnfordertStartdatum | Auftragsstartdatum vom Kunden angefordert. Datentyp: Zeichenfolge |
| Staat | Aktueller Status des Auftrags. Datentyp: Zeichenfolge |
| Version | Auftragsversion. Datentyp: Zeichenfolge |
| @Typ | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer <kbd class="ph userinput">Produktbestellung </kbd>. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
[ ]

{#tmf_prod_order-GET-ord-productOrder__table_inf_kxr_nsb}  

### Curl-Anforderung

Dieses Beispiel ruft alle Produktbestellungen ab.

    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} ab {#ariaid-title3}

Ruft die angegebene Produktbestellung ab.
Dieser Endpunkt ruft Bestellinformationen aus den folgenden Tabellen ab:

* Kundenauftrag \[sn_ind_tmt_orm_order\]
* Bestellmerkmal \[sn_ind_tmt_orm_order_characteristic_value\]
* Auftragspositionselement \[sn_ind_tmt_orm_order_line_item\]
* Auftragspositionselementkontakt \[sn_ind_tmt_orm_order_line_item_contact\]
* Auftragspositionselemente \[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. Datentyp: Zeichenfolge Tabelle: Kundenauftrag \[sn_ind_tmt_orm_order\] |
[Tabelle : 7. Pfad-Parameter]

{#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. Anforderungstext-Parameter (JSON)]

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#tmf_prod_order-GET-ord-productOrder-id__table_kqy_wgy_fsb__entry__2}

| Header | 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}

| Header | Beschreibung |
|-|-|
| Inhaltstyp | Datenformat des Antworttexts. Nur unterstützt application/json. |
[Tabelle : 11. Antwort-Header]

{#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 [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#tmf_prod_order-GET-ord-productOrder-id__tmf-get-list-status-codes__entry__2}

| Statuscode | Beschreibung |
|-|-|
| 200 | Anforderung erfolgreich verarbeitet. Vollständige Ressource in Antwort zurückgegeben (keine Paginierung). Die Antwort gibt erfolgreich mit einer Fehlermeldung zurück, wenn für den ausgewählten Auftrag Verarbeitungsprobleme auftreten. * Eine Antwort von 200 OK erfolgt, wenn sich der Auftrag in der Tabelle „eingehende Warteschlange" \[sn_tmt_core_inbound_queue\] befindet und darauf wartet, dass der Zeitplaner den zu verarbeitenden Datensatz auswählt. Das Fehlermeldungsfeld enthält Details für den Datensatz. Zum 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": "" } ] } * Eine 200 OK-Antwort erfolgt, wenn die Auftragserstellung fehlschlägt und sich der Datensatz in der Tabelle „eingehende Warteschlange" \[sn_tmt_core_inbound_queue\] in einem Fehlerstatus befindet. Das Fehlermeldungsfeld enthält Details in für den Datensatz der eingehenden Warteschlangentabelle. Zum 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 | In Antwort zurückgegebene Teilressource (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}

### Antworttext-Parameter (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 |
|-|-|
| Kanal | Liste der Kanäle, die für den Verkauf der Produkte verwendet werden sollen. Datentyp: Array von Objekten "channel": [ { "id": "String", "name": "String" } ] |
| Kanal.ID | Eindeutiger Bezeichner des Kanals, der zum Verkauf der zugehörigen Produkte verwendet werden soll. Datentyp: Zeichenfolge |
| channel.name | Name des Kanals, der zum 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 oder nach dem übereinstimmen committedDueDateWerte für jedes Auftragspositionselement. Datentyp: Zeichenfolge |
| Erwartetes Abschlussdatum | Datum, an dem der Auftrag abgeschlossen wird. Datentyp: Zeichenfolge |
| href | Relativer Link zum Produktbestellungsdatensatz. Datentyp: Zeichenfolge |
| ID | SYS_ID der Produktbestellung. Datentyp: Zeichenfolge |
| note | Liste der zusätzlichen Notizen, die der Kunde bei der Bestellung gemacht hat. Datentyp: Array von Objekten "note": [ { "author": "String", "date": "String", "text": "String" } ] |
| note.author | Anwendername der Person, die die zugehörige Notiz erstellt hat. Datentyp: Zeichenfolge |
| Hinweis.Datum | Datum, an dem die Notiz erstellt wurde. Datentyp: Zeichenfolge |
| Hinweis.Text | Zusätzliche Notizen/Kommentare des Kunden während der Bestellung. Datentyp: Zeichenfolge |
| Auftragswährung | Währungscode für den Auftrag und die Auftragspositionen. Datentyp: Zeichenfolge |
| Ponr | Kennzeichnung, die angibt, ob der Punkt, an dem die Bestellung nicht zurückgegeben wurde, erreicht wurde. Mögliche Werte: * Wahr: Der Punkt, an dem keine Rückgabe für den Auftrag erfolgt ist, wurde erreicht. * Falsch: Der Punkt, an dem die Bestellung nicht zurückgegeben wurde, wurde nicht erreicht. {#tmf_prod_order-GET-ord-productOrder-id__ul_tdq_rw1_hqb} Datentyp: Boolescher Wert |
| ProductOrderItem | Liste, die Elemente beschreibt, die der Produktbestellung und der zugehörigen Aktion zugeordnet sind. Datentyp: Array von Objekten "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" } ] |
| ProductOrderElement.Aktion | Aktion, die für das Produkt ausgeführt werden soll. Mögliche Aktionen werden auf der Registerkarte „Auswahlliste" im Aktionswörterbucheintrag der sn_ind_tmt_orm_order_line_item-Tabelle definiert. Datentyp: Zeichenfolge |
| ProduktbestellungElement.actionReason | Grund für das Hinzufügen der Auftragsposition. Datentyp: Zeichenfolge Gespeichert in: Dem Feld „action_reason" der sn_ind_tmt_orm_order_line_item-Tabelle. |
| productOrderItem.committedDueDate | Datum und Uhrzeit, zu der die Aktion für die Auftragsposition ausgeführt werden muss. Datentyp: Zeichenfolge |
| ProduktbestellungElement.externalProduktbestand | Liste der externen IDs, die den für den Auftrag erstellten Produktbeständen zugeordnet sind. Datentyp: Array von Objekten "externalProductInventory": [ { "externalProductInventoryId": "String" } ] |
| ProduktbestellungElement.externalProduktbestand.externalProduktbestellungId | Externe ID, die dem Produktbestand zugeordnet ist. Datentyp: Zeichenfolge |
| productOrderItem.id | Eindeutiger Bezeichner der Position. Befindet sich im Feld sn_ind_tmt_orm_external_id der Auftragspositionstabelle \[sn_ind_tmt_orm_order_line_item\]. Datentyp: Zeichenfolge |
| productOrderItem.itemPrice | Liste, die den Preis beschreibt, der dem Produkt zugeordnet ist. Datentyp: Array von Objekten "itemPrice": [ { "price": {Object}, "priceType": "String", "recurringChargePeriod": "String" } ] |
| productOrderItem.itemPrice.price | Beschreibung des Preises des zugehörigen Produkts. Datentyp: Objekt "price": { "taxIncludedAmount": {Object} } |
| productOrderItem.itemPrice.price.taxIncludedAmount | Beschreibung des Preises des zugehörigen Produkts, einschließlich der Steuer. Datentyp: Objekt "taxIncludedAmount": { "unit": "String", "value": Number } |
| productOrderItem.itemPrice.price.taxIncludedAmount.unit | Währungscode, in dem der Preis dargestellt wird. Datentyp: Zeichenfolge |
| productOrderItem.itemPrice.price.taxIncludedAmount.value | 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 |
| ProduktbestellungElement.ponr | Kennzeichnung, die angibt, ob der Punkt, an dem die Bestellung nicht zurückgegeben wurde, erreicht wurde. Mögliche Werte: * Wahr: Der Punkt, an dem keine Rückgabe für den Auftrag erfolgt ist, wurde erreicht. * Falsch: Der Punkt, an dem die Bestellung nicht zurückgegeben wurde, wurde nicht erreicht. {#tmf_prod_order-GET-ord-productOrder-id__d3104e2579} Datentyp: Boolescher Wert |
| productOrderItem.product | Beschreibung der Instanzdetails des vom Kunden gekauften Produkts. Datentyp: Objekt "product:" { "place": {Object}, "productCharacteristic": [Array], "productRelationship": [Array], "productSpecification": {Object}, "relatedParty": {Object}, "@type": "String" } |
| productOrderItem.product.place | Karten der Standorte, 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 Tabelle „Standort" \[cmn_location\]. Datentyp: Zeichenfolge |
| productOrderItem.product.place.@type | Teil des TMF Open API-Standards. Anmerkung für Auftragspositionskontakt. Dieser Wert ist immer <kbd class="ph userinput">Ort </kbd>. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
| productOrderItem.product.productCharacteristic | Liste der Merkmale des zugeordneten Produkts. Nur Produktmerkmale, deren valueUnterscheiden sich von previousValueWerden zurückgegeben. Datentyp: Array von Objekten "productCharacteristic": [ { "name": "String", "previousValue": "String", "value": "String" } ] |
| productOrderItem.product.productCharacteristic.name | Name des Merkmalsdatensatzes, der dem Produkt zugeordnet werden soll. Befindet sich in der Merkmalstabelle \[sn_prd_pm_characteristic\]. Datentyp: Zeichenfolge |
| productOrderItem.product.productCharacteristic.previousValue | Vorherige Merkmalsoptionswerte, wenn die Aktualisierung für einen Change-Auftrag gilt. Die Anforderung ist ein Change-Auftrag, wenn productOrderItem.actionParameter ist anders als <kbd class="ph userinput">Hinzufügen </kbd>. 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=yokohama&pubname=yokohama-order-management&ft:locale=en-US). Datentyp: Zeichenfolge |
| productOrderItem.product.productCharacteristic.value | Merkmalsoptionswerte, 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=yokohama&pubname=yokohama-order-management&ft:locale=en-US). Datentyp: Zeichenfolge |
| productOrderItem.product.productRelationship | Liste der Produktbeziehungsdetails für eine Auftragsposition. Datentyp: Array von Objekten "productRelationship": [ { "id": "String", "relationshipType": "String" } ] |
| productOrderItem.product.productRelationship.id | SYS_ID oder sn_prd_invt_external_id des Produktbestands. Datentyp: Zeichenfolge Tabelle: Im Feld „sys_ID" oder „sn_prd_invt_external_id" der Tabelle „Produktbestand" \[sn_prd_invt_product_inventory\]. |
| productOrderItem.product.productRelationship.relationshipType | Typ der Beziehung zwischen der Auftragsposition und dem Produktbestand. Möglicher Wert: Erforderlich 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 |
| productOrderItem.product.productSpecification.internalId | Anfangsversion der Produktspezifikation. Die Anfangsversion ist die sys_ID der ersten Version der Spezifikation. Datentyp: Zeichenfolge Tabelle: Produktspezifikation \[sn_prd_pm_product_specification\] |
| productOrderItem.product.productSpecification.internalVersion | Version der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „Version" der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. |
| productOrderItem.product.productSpecification.name | Name der Produktspezifikation. Befindet sich in der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. Datentyp: Zeichenfolge |
| productOrderItem.product.productSpecification.version | Externe Version der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld external_Version der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. |
| productOrderItem.product.productSpecification.@type | Teil des Standards für offene TMF-API. Dieser Wert ist immer <kbd class="ph userinput">ProduktspezifikationRef </kbd>. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
| productOrderItem.product.relatedParty | Liste der Kontakte für Einzelposten. Datentyp: Array von Objekten "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 |
| productOrderItem.product.relatedParty.firstName | Vorname des Kontakts. Datentyp: Zeichenfolge |
| productOrderItem.product.relatedParty.id | SYS_ID des Positionskontakts, der der Auftragsposition zugeordnet ist. Befindet sich in der Tabelle „Auftragspositionskontakt" \[sn_ind_tmt_orm_order_line_item_contact\]. Datentyp: Zeichenfolge |
| productOrderItem.product.relatedParty.lastName | Nachname des Kontakts. Datentyp: Zeichenfolge Datentyp: Zeichenfolge |
| productOrderItem.product.relatedParty.phone | Geschäftliche Telefonnummer des Kontakts. Datentyp: Zeichenfolge |
| productOrderItem.product.relatedParty.@referredType | Typ des Kunden. Möglicher Wert: OrderLineItemContact Datentyp: Zeichenfolge |
| productOrderItem.product.relatedParty.@type | Teil des TMF Open API-Standards. Anmerkung für Auftragspositionskontakt. Dieser Wert ist immer <kbd class="ph userinput">Zugehörige Partei </kbd>. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
| productOrderItem.productOffering | 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. Befindet sich im Feld „sys_ID" oder „external_ID" der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge |
| productOrderItem.productOffering.internalId | Anfangsversion des Produktangebots. Die Anfangsversion ist die sys_ID der ersten Version des Angebots. Datentyp: Zeichenfolge Tabelle: Produktangebot \[sn_prd_pm_product_offering\] |
| productOrderItem.productOffering.internalVersion | Version des Produktangebots. Datentyp: Zeichenfolge Tabelle: Im Feld „Version" der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. |
| productOrderItem.productOffering.name | Name des Produktangebots. Befindet sich in der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge |
| productOrderItem.productOffering.version | Externe Version des Produktangebots. Datentyp: Zeichenfolge Tabelle: Im Feld external_Version der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. |
| ProduktbestellungElement.Menge | Anzahl der gekauften Produktartikel. Datentyp: Zahl |
| productOrderItem.productOrderItemRelationship | Liste der Beziehungen zwischen Auftragspositionen. Datentyp: Array von Objekten "productOrderItemRelationship": [ { "id": "String", "relationshipType": "String" } ] |
| productOrderItem.productOrderItemRelationship.id | Eindeutiger Bezeichner der zugehörigen Position. Befindet sich im Feld sn_ind_tmt_orm_external_id der Auftragspositionstabelle \[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 * Übergeordnetes Element * Erfordert {#tmf_prod_order-GET-ord-productOrder-id__ul_yqf_2ty_54b} `HasChild `Und `Übergeordnetes Element `Werden für übergeordnete/untergeordnete Beziehungen verwendet. `Erfordert `Wird für horizontale Beziehungen verwendet (ein Einzelposten erfordert eine andere Position). Datentyp: Zeichenfolge |
| ProduktbestellungElement.Status | Status der Bestellung des zugeordneten Produktelements. Datentyp: Zeichenfolge |
| ProduktbestellungElement.Version | Auftragsversion. Datentyp: Zeichenfolge |
| ProductOrderItem.@type | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer <kbd class="ph userinput">Produktbestellelement </kbd>. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
| ZugehörigPartei | Liste der Kontakte für den Auftrag. Jeder Kontakt ist ein Objekt im Array. Muss mindestens ein Element auflisten, das Kunden- oder Verbraucherkontoinformationen enthält. Datentyp: Array von Objekten "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. Befindet sich 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 |
| RelatedParty.@referredType | Typ des Kunden. Mögliche Werte: * Verbraucher * Kunde * Kundenkontakt {#tmf_prod_order-GET-ord-productOrder-id__ul_lcq_jwm_t4b} Datentyp: Zeichenfolge |
| RelatedParty.@type | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer <kbd class="ph userinput">Zugehörige Partei </kbd>. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
| AnfordertAbschlusdatum | Vom Kunden angefordertes Lieferdatum. Datentyp: Zeichenfolge |
| AnfordertStartdatum | Auftragsstartdatum vom Kunden angefordert. Datentyp: Zeichenfolge |
| Staat | Aktueller Status des Auftrags. Datentyp: Zeichenfolge |
| Version | Auftragsversion. Datentyp: Zeichenfolge |
| @Typ | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer <kbd class="ph userinput">Produktbestellung </kbd>. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
[ ]

### Curl-Anforderung

Dieses Beispiel ruft eine angegebene Produktbestellung ab.

    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 ab {#ariaid-title4}

Ruft alle Produktbestellungen ab.
Wichtig:  
Beginnend mit TokyoRelease, dieser Endpunkt ist veraltet. Die neue Version dieses Endpunkts ist [Offene API für Produktbestellung -- GET /sn_ind_tmt_orm/order/productOrder AB](https://servicenow-prod.fluidtopics.net/sdD3L5blimu_FO2BexrA7Q#tmf_prod_order-GET-ord-productOrder "Ruft alle Produktbestellungen ab.").  
Dieser Endpunkt ruft Bestellinformationen aus den folgenden Tabellen ab:

* Kundenauftrag \[sn_ind_tmt_orm_order\]
* Bestellmerkmal \[sn_ind_tmt_orm_order_characteristic_value\]
* Auftragspositionselement \[sn_ind_tmt_orm_order_line_item\]
* Auftragspositionselementkontakt \[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. Pfad-Parameter]

{#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 Felder zurückgegeben. |
| limit | Maximale Anzahl zurückzugebender Datensätze. Für Anforderungen, die diese Anzahl von Datensätzen überschreiten, verwenden Sie offsetParameter zum Paginieren des Datensatzabrufs. Datentyp: Zahl Standard: 20 Maximum: 100 |
| Offset | Startindex, bei dem mit dem Abrufen von Datensätzen begonnen werden soll. Verwenden Sie diesen Wert, um den Datensatzabruf zu paginieren. Diese Funktionalität ermöglicht den Abruf aller Datensätze, unabhängig von der Anzahl der Datensätze, in kleinen verwaltbaren Blöcken. Datentyp: Zahl Standard: 0 |
| Staat | Reihenfolge nach Status filtern. Nur Aufträge mit einem Status, der dem Wert dieses Parameters entspricht, werden in der Antwort zurückgegeben. Datentyp: Zeichenfolge Standard: Alle status zurückgegeben. |
[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. Anforderungstext-Parameter (JSON)]

{#tmf_prod_order-GET-productorder__table_xcm_cvr_nsb}

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#tmf_prod_order-GET-productorder__table_kqy_wgy_fsb__entry__2}

| Header | 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}

| Header | Beschreibung |
|-|-|
| Inhaltsbereich | Inhaltsbereich, der in einem paginierten Aufruf zurückgegeben wird. Beispiel: Wenn `Offset=2 `Und `Grenzwert = 3 `, Der Wert von Content-RangeHeader ist `Elemente 3-5 `. |
| Inhaltstyp | Datenformat des Antworttexts. Nur unterstützt application/json. |
| Verknüpfen | 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. Antwort-Header]

{#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 [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#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 in Antwort zurückgegeben (keine Paginierung). |
| 206 | In Antwort zurückgegebene Teilressource (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}

### Antworttext-Parameter (JSON) {#tmf_prod_order-GET-productorder__section_hnf_kxr_nsb}

{#tmf_prod_order-GET-productorder__table_inf_kxr_nsb__entry__2}

| Name | Beschreibung |
|-|-|
| Kanal | Liste der Kanäle, die für den Verkauf der Produkte verwendet werden sollen. Datentyp: Array von Objekten "channel": [ { "id": "String", "name": "String" } ] |
| Kanal.ID | Eindeutiger Bezeichner des Kanals, der zum Verkauf der zugehörigen Produkte verwendet werden soll. Datentyp: Zeichenfolge |
| channel.name | Name des Kanals, der zum Verkauf der zugehörigen Produkte verwendet werden soll. Datentyp: Zeichenfolge |
| Erwartetes Abschlussdatum | Datum, an dem der Auftrag abgeschlossen wird. Datentyp: Zeichenfolge |
| note | Liste der zusätzlichen Notizen, die der Kunde bei der Bestellung gemacht hat. Datentyp: Array von Objekten "note": { "author": "String", "date": "String", "text": "String" } |
| note.author | Anwendername der Person, die die zugehörige Notiz erstellt hat. Datentyp: Zeichenfolge |
| Hinweis.Datum | Datum, an dem die Notiz erstellt wurde. Datentyp: Zeichenfolge |
| Hinweis.Text | Zusätzliche Notizen/Kommentare des Kunden während der Bestellung. Datentyp: Zeichenfolge |
| Ponr | Kennzeichnung, die angibt, ob der Punkt, an dem die Bestellung nicht zurückgegeben wurde, erreicht wurde. Mögliche Werte: * Wahr: Der Punkt, an dem keine Rückgabe für den Auftrag erfolgt ist, wurde erreicht. * Falsch: Der Punkt, an dem die Bestellung nicht zurückgegeben wurde, wurde nicht erreicht. {#tmf_prod_order-GET-productorder__ul_tdq_rw1_hqb} Datentyp: Boolescher Wert |
| ProductOrderItem | Liste, die Elemente beschreibt, die der Produktbestellung und der zugehörigen Aktion zugeordnet sind. Datentyp: Array von Objekten "productOrderItem:" [ { "action": "String", "actionReason": "String", "id": "String", "itemPrice": [Array], "product": {Object}, "productOffering": {Object}, "productOrderItemReleationship": [Array], "quantity": Number, "state": "String", "@type": "String" } ] |
| ProductOrderElement.Aktion | Aktion, die für das Produkt ausgeführt werden soll. Mögliche Aktionen werden auf der Registerkarte „Auswahlliste" im Aktionswörterbucheintrag der sn_ind_tmt_orm_order_line_item-Tabelle definiert. Datentyp: Zeichenfolge |
| ProduktbestellungElement.actionReason | Grund für das Hinzufügen der Auftragsposition. Datentyp: Zeichenfolge Gespeichert in: Dem Feld „action_reason" der sn_ind_tmt_orm_order_line_item-Tabelle. |
| productOrderItem.id | Eindeutiger Bezeichner der Position. Befindet sich im Feld sn_ind_tmt_orm_external_id der Auftragspositionstabelle \[sn_ind_tmt_orm_order_line_item\]. Datentyp: Zeichenfolge |
| productOrderItem.itemPrice | Liste, die den Preis beschreibt, der dem Produkt zugeordnet ist. Datentyp: Array von Objekten "itemPrice": [ { "price": {Object}, "priceType": "String", "recurringChargePeriod": "String" } ] |
| productOrderItem.itemPrice.price | Beschreibung des Preises des zugehörigen Produkts. Datentyp: Objekt "price": { "taxIncludedAmount": {Object} } |
| productOrderItem.itemPrice.price.taxIncludedAmount | Beschreibung des Preises des zugehörigen Produkts, einschließlich der Steuer. Datentyp: Objekt "taxIncludedAmount": { "unit": "String", "value": Number } |
| productOrderItem.itemPrice.price.taxIncludedAmount.unit | Währungscode, in dem der Preis dargestellt wird. Datentyp: Zeichenfolge |
| productOrderItem.itemPrice.price.taxIncludedAmount.value | 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 |
| ProduktbestellungElement.ponr | Kennzeichnung, die angibt, ob der Punkt, an dem die Bestellung nicht zurückgegeben wurde, erreicht wurde. Mögliche Werte: * Wahr: Der Punkt, an dem keine Rückgabe für den Auftrag erfolgt ist, wurde erreicht. * Falsch: Der Punkt, an dem die Bestellung nicht zurückgegeben wurde, wurde nicht erreicht. {#tmf_prod_order-GET-productorder__d3104e2579} Datentyp: Boolescher Wert |
| productOrderItem.product | Beschreibung der Instanzdetails des vom Kunden gekauften Produkts. Datentyp: Objekt "product:" { "place": {Object}, "productCharacteristic": [Array], "productSpecification": {Object}, "relatedParty": {Object}, "@type": "String" } |
| productOrderItem.product.place | Karten der Standorte, 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 Tabelle „Standort" \[cmn_location\]. Datentyp: Zeichenfolge |
| productOrderItem.product.place.@type | Teil des TMF Open API-Standards. Anmerkung für Auftragspositionskontakt. Dieser Wert ist immer <kbd class="ph userinput">Ort </kbd>. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
| productOrderItem.product.productCharacteristic | Liste der Merkmale des zugeordneten Produkts. Nur Produktmerkmale, deren valueUnterscheiden sich von previousValueWerden zurückgegeben. Datentyp: Array von Objekten "productCharacteristic": [ { "name": "String", "previousValue": "String", "value": "String" } ] |
| productOrderItem.product.productCharacteristic.name | Name des Merkmalsdatensatzes, der dem Produkt zugeordnet werden soll. Befindet sich in der Merkmalstabelle \[sn_prd_pm_characteristic\]. Datentyp: Zeichenfolge |
| productOrderItem.product.productCharacteristic.previousValue | Vorherige Merkmalsoptionswerte, wenn die Aktualisierung für einen Change-Auftrag gilt. Die Anforderung ist ein Change-Auftrag, wenn productOrderItem.actionParameter ist anders als <kbd class="ph userinput">Hinzufügen </kbd>. 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=yokohama&pubname=yokohama-order-management&ft:locale=en-US). Datentyp: Zeichenfolge |
| productOrderItem.product.productCharacteristic.value | Merkmalsoptionswerte, 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=yokohama&pubname=yokohama-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 Standards für offene TMF-API. Dieser Wert ist immer <kbd class="ph userinput">ProduktspezifikationRef </kbd>. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
| productOrderItem.product.relatedParty | Liste der Kontakte für Einzelposten. Datentyp: Array von Objekten "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 |
| productOrderItem.product.relatedParty.firstName | Vorname des Kontakts. Datentyp: Zeichenfolge |
| productOrderItem.product.relatedParty.id | SYS_ID des Positionskontakts, der der Auftragsposition zugeordnet ist. Befindet sich in der Tabelle „Auftragspositionskontakt" \[sn_ind_tmt_orm_order_line_item_contact\]. Datentyp: Zeichenfolge |
| productOrderItem.product.relatedParty.lastName | Nachname des Kontakts. Datentyp: Zeichenfolge Datentyp: Zeichenfolge |
| productOrderItem.product.relatedParty.phone | Geschäftliche Telefonnummer des Kontakts. Datentyp: Zeichenfolge |
| productOrderItem.product.relatedParty.@referredType | Typ des Kunden. Möglicher Wert: OrderLineItemContact Datentyp: Zeichenfolge |
| productOrderItem.product.relatedParty.@type | Teil des TMF Open API-Standards. Anmerkung für Auftragspositionskontakt. Dieser Wert ist immer <kbd class="ph userinput">Zugehörige Partei </kbd>. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
| productOrderItem.productOffering | 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. Befindet sich 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 |
| ProduktbestellungElement.Menge | Anzahl der gekauften Produktartikel. Datentyp: Zahl |
| productOrderItem.productOrderItemRelationship | Liste der Beziehungen zwischen Auftragspositionen. Datentyp: Array von Objekten "productOrderItemRelationship": [ { "id": "String", "relationshipType": "String" } ] |
| productOrderItem.productOrderItemRelationship.id | Eindeutiger Bezeichner der zugehörigen Position. Befindet sich im Feld sn_ind_tmt_orm_external_id der Auftragspositionstabelle \[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 * Übergeordnetes Element * Erfordert {#tmf_prod_order-GET-productorder__ul_yqf_2ty_54b} `HasChild `Und `Übergeordnetes Element `Werden für übergeordnete/untergeordnete Beziehungen verwendet. `Erfordert `Wird für horizontale Beziehungen verwendet (ein Einzelposten erfordert eine andere Position). Datentyp: Zeichenfolge |
| ProduktbestellungElement.Status | Status der Bestellung des zugeordneten Produktelements. Datentyp: Zeichenfolge |
| ProduktbestellungElement.Version | Auftragsversion. Datentyp: Zeichenfolge |
| ProductOrderItem.@type | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer <kbd class="ph userinput">Produktbestellelement </kbd>. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
| ZugehörigPartei | Liste der Kontakte für den Auftrag. Jeder Kontakt ist ein Objekt im Array. Muss mindestens ein Element auflisten, das Kunden- oder Verbraucherkontoinformationen enthält. Datentyp: Array von Objekten "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. Befindet sich 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 |
| RelatedParty.@referredType | Typ des Kunden. Mögliche Werte: * Verbraucher * Kunde * Kundenkontakt {#tmf_prod_order-GET-productorder__ul_lcq_jwm_t4b} Datentyp: Zeichenfolge |
| RelatedParty.@type | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer <kbd class="ph userinput">Zugehörige Partei </kbd>. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
| AnfordertAbschlusdatum | Vom Kunden angefordertes Lieferdatum. Datentyp: Zeichenfolge |
| AnfordertStartdatum | Auftragsstartdatum vom Kunden angefordert. Datentyp: Zeichenfolge |
| Staat | Aktueller Status des Auftrags. Datentyp: Zeichenfolge |
| Version | Auftragsversion. Datentyp: Zeichenfolge |
| @Typ | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer <kbd class="ph userinput">Produktbestellung </kbd>. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
[ ]

{#tmf_prod_order-GET-productorder__table_inf_kxr_nsb}  

### Curl-Anforderung

Dieses Beispiel ruft alle Produktbestellungen ab.

    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} AB {#ariaid-title5}

Ruft die angegebene Produktbestellung ab.
Wichtig:  
Beginnend mit TokyoRelease, dieser Endpunkt ist veraltet. Die neue Version dieses Endpunkts ist [Offene API für Produktbestellung -- GET /sn_ind_tmt_orm/order/productOrder/{ID} ab](https://servicenow-prod.fluidtopics.net/sdD3L5blimu_FO2BexrA7Q#tmf_prod_order-GET-ord-productOrder-id "Ruft die angegebene Produktbestellung ab.").  
Dieser Endpunkt ruft Bestellinformationen aus den folgenden Tabellen ab:

* Kundenauftrag \[sn_ind_tmt_orm_order\]
* Bestellmerkmal \[sn_ind_tmt_orm_order_characteristic_value\]
* Auftragspositionselement \[sn_ind_tmt_orm_order_line_item\]
* Auftragspositionselementkontakt \[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. Datentyp: Zeichenfolge Tabelle: Kundenauftrag \[sn_ind_tmt_orm_order\] |
[Tabelle : 19. Pfad-Parameter]

{#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. Anforderungstext-Parameter (JSON)]

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#tmf_prod_order-GET-productOrder-id__table_kqy_wgy_fsb__entry__2}

| Header | 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}

| Header | Beschreibung |
|-|-|
| Inhaltstyp | Datenformat des Antworttexts. Nur unterstützt application/json. |
[Tabelle : 23. Antwort-Header]

{#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 [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#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 aus einem der folgenden Gründe sein: * Fehlender Abfrageparameter * Ungültiger URI |
| 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. |
[Tabelle : 24. Statuscodes]

### Antworttext-Parameter (JSON)

{#tmf_prod_order-GET-productOrder-id__entry__30}

| Name | Beschreibung |
|-|-|
| Kanal | Liste der Kanäle, die für den Verkauf der Produkte verwendet werden sollen. Datentyp: Array von Objekten "channel": [ { "id": "String", "name": "String" } ] |
| Kanal.ID | Eindeutiger Bezeichner des Kanals, der zum Verkauf der zugehörigen Produkte verwendet werden soll. Datentyp: Zeichenfolge |
| channel.name | Name des Kanals, der zum Verkauf der zugehörigen Produkte verwendet werden soll. Datentyp: Zeichenfolge |
| Erwartetes Abschlussdatum | Datum, an dem der Auftrag abgeschlossen wird. Datentyp: Zeichenfolge |
| note | Liste der zusätzlichen Notizen, die der Kunde bei der Bestellung gemacht hat. Datentyp: Objekt "note": { "author": "String", "date": "String", "text": "String" } |
| note.author | Anwendername der Person, die die zugehörige Notiz erstellt hat. Datentyp: Zeichenfolge |
| Hinweis.Datum | Datum, an dem die Notiz erstellt wurde. Datentyp: Zeichenfolge |
| Hinweis.Text | Zusätzliche Notizen/Kommentare des Kunden während der Bestellung. Datentyp: Zeichenfolge |
| Ponr | Kennzeichnung, die angibt, ob der Punkt, an dem die Bestellung nicht zurückgegeben wurde, erreicht wurde. Mögliche Werte: * Wahr: Der Punkt, an dem keine Rückgabe für den Auftrag erfolgt ist, wurde erreicht. * Falsch: Der Punkt, an dem die Bestellung nicht zurückgegeben wurde, wurde nicht erreicht. {#tmf_prod_order-GET-productOrder-id__ul_tdq_rw1_hqb} Datentyp: Boolescher Wert |
| ProductOrderItem | Liste, die Elemente beschreibt, die der Produktbestellung und der zugehörigen Aktion zugeordnet sind. Datentyp: Array von Objekten "productOrderItem:" [ { "action": "String", "actionReason": "String", "id": "String", "itemPrice": [Array], "product": {Object}, "productOffering": {Object}, "productOrderItemReleationship": [Array], "quantity": Number, "state": "String", "@type": "String" } ] |
| ProductOrderElement.Aktion | Aktion, die für das Produkt ausgeführt werden soll. Mögliche Aktionen werden auf der Registerkarte „Auswahlliste" im Aktionswörterbucheintrag der sn_ind_tmt_orm_order_line_item-Tabelle definiert. Datentyp: Zeichenfolge |
| ProduktbestellungElement.actionReason | Grund für das Hinzufügen der Auftragsposition. Datentyp: Zeichenfolge Gespeichert in: Dem Feld „action_reason" der sn_ind_tmt_orm_order_line_item-Tabelle. |
| productOrderItem.id | Eindeutiger Bezeichner der Position. Befindet sich im Feld sn_ind_tmt_orm_external_id der Auftragspositionstabelle \[sn_ind_tmt_orm_order_line_item\]. Datentyp: Zeichenfolge |
| productOrderItem.itemPrice | Liste, die den Preis beschreibt, der dem Produkt zugeordnet ist. Datentyp: Array von Objekten "itemPrice": [ { "price": {Object}, "priceType": "String", "recurringChargePeriod": "String" } ] |
| productOrderItem.itemPrice.price | Beschreibung des Preises des zugehörigen Produkts. Datentyp: Objekt "price": { "taxIncludedAmount": {Object} } |
| productOrderItem.itemPrice.price.taxIncludedAmount | Beschreibung des Preises des zugehörigen Produkts, einschließlich der Steuer. Datentyp: Objekt "taxIncludedAmount": { "unit": "String", "value": Number } |
| productOrderItem.itemPrice.price.taxIncludedAmount.unit | Währungscode, in dem der Preis dargestellt wird. Datentyp: Zeichenfolge |
| productOrderItem.itemPrice.price.taxIncludedAmount.value | 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 |
| ProduktbestellungElement.ponr | Kennzeichnung, die angibt, ob der Punkt, an dem die Bestellung nicht zurückgegeben wurde, erreicht wurde. Mögliche Werte: * Wahr: Der Punkt, an dem keine Rückgabe für den Auftrag erfolgt ist, wurde erreicht. * Falsch: Der Punkt, an dem die Bestellung nicht zurückgegeben wurde, wurde nicht erreicht. {#tmf_prod_order-GET-productOrder-id__d3104e2579} Datentyp: Boolescher Wert |
| productOrderItem.product | Beschreibung der Instanzdetails des vom Kunden gekauften Produkts. Datentyp: Objekt "product:" { "place": {Object}, "productCharacteristic": [Array], "productSpecification": {Object}, "relatedParty": {Object}, "@type": "String" } |
| productOrderItem.product.place | Karten der Standorte, 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 Tabelle „Standort" \[cmn_location\]. Datentyp: Zeichenfolge |
| productOrderItem.product.place.@type | Teil des TMF Open API-Standards. Anmerkung für Auftragspositionskontakt. Dieser Wert ist immer <kbd class="ph userinput">Ort </kbd>. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
| productOrderItem.product.productCharacteristic | Liste der Merkmale des zugeordneten Produkts. Nur Produktmerkmale, deren valueUnterscheiden sich von previousValueWerden zurückgegeben. Datentyp: Array von Objekten "productCharacteristic": [ { "name": "String", "previousValue": "String", "value": "String" } ] |
| productOrderItem.product.productCharacteristic.name | Name des Merkmalsdatensatzes, der dem Produkt zugeordnet werden soll. Befindet sich in der Merkmalstabelle \[sn_prd_pm_characteristic\]. Datentyp: Zeichenfolge |
| productOrderItem.product.productCharacteristic.previousValue | Vorherige Merkmalsoptionswerte, wenn die Aktualisierung für einen Change-Auftrag gilt. Die Anforderung ist ein Change-Auftrag, wenn productOrderItem.actionParameter ist anders als <kbd class="ph userinput">Hinzufügen </kbd>. 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=yokohama&pubname=yokohama-order-management&ft:locale=en-US). Datentyp: Zeichenfolge |
| productOrderItem.product.productCharacteristic.value | Merkmalsoptionswerte, 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=yokohama&pubname=yokohama-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 Standards für offene TMF-API. Dieser Wert ist immer <kbd class="ph userinput">ProduktspezifikationRef </kbd>. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
| productOrderItem.product.relatedParty | Liste der Kontakte für Einzelposten. Datentyp: Objekt "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 |
| productOrderItem.product.relatedParty.firstName | Vorname des Kontakts. Datentyp: Zeichenfolge |
| productOrderItem.product.relatedParty.id | SYS_ID des Positionskontakts, der der Auftragsposition zugeordnet ist. Befindet sich in der Tabelle „Auftragspositionskontakt" \[sn_ind_tmt_orm_order_line_item_contact\]. Datentyp: Zeichenfolge |
| productOrderItem.product.relatedParty.lastName | Nachname des Kontakts. Datentyp: Zeichenfolge |
| productOrderItem.product.relatedParty.phone | Geschäftliche Telefonnummer des Kontakts. Datentyp: Zeichenfolge |
| productOrderItem.product.relatedParty.@referredType | Typ des Kunden. Möglicher Wert: OrderLineItemContact Datentyp: Zeichenfolge |
| productOrderItem.product.relatedParty.@type | Teil des TMF Open API-Standards. Anmerkung für Auftragspositionskontakt. Dieser Wert ist immer <kbd class="ph userinput">Zugehörige Partei </kbd>. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
| productOrderItem.productOffering | 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. Befindet sich 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 |
| ProduktbestellungElement.Menge | Anzahl der gekauften Produktartikel. Datentyp: Zahl |
| productOrderItem.productOrderItemRelationship | Liste der Beziehungen zwischen Auftragspositionen. Datentyp: Array von Objekten "productOrderItemRelationship": [ { "id": "String", "relationshipType": "String" } ] |
| productOrderItem.productOrderItemRelationship.id | Eindeutiger Bezeichner der zugehörigen Position. Befindet sich im Feld sn_ind_tmt_orm_external_id der Auftragspositionstabelle \[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 * Übergeordnetes Element * Erfordert {#tmf_prod_order-GET-productOrder-id__ul_yqf_2ty_54b} `HasChild `Und `Übergeordnetes Element `Werden für übergeordnete/untergeordnete Beziehungen verwendet. `Erfordert `Wird für horizontale Beziehungen verwendet (ein Einzelposten erfordert eine andere Position). Datentyp: Zeichenfolge |
| ProduktbestellungElement.Status | Status der Bestellung des zugeordneten Produktelements. Datentyp: Zeichenfolge |
| ProduktbestellungElement.Version | Auftragsversion. Datentyp: Zeichenfolge |
| ProductOrderItem.@type | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer <kbd class="ph userinput">Produktbestellelement </kbd>. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
| ZugehörigPartei | Liste der Kontakte für den Auftrag. Jeder Kontakt ist ein Objekt im Array. Muss mindestens ein Element auflisten, das Kunden- oder Verbraucherkontoinformationen enthält. Datentyp: Array von Objekten "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. Befindet sich 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 |
| RelatedParty.@referredType | Typ des Kunden. Mögliche Werte: * Verbraucher * Kunde * Kundenkontakt {#tmf_prod_order-GET-productOrder-id__ul_lcq_jwm_t4b} Datentyp: Zeichenfolge |
| RelatedParty.@type | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer <kbd class="ph userinput">Zugehörige Partei </kbd>. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
| AnfordertAbschlusdatum | Vom Kunden angefordertes Lieferdatum. Datentyp: Zeichenfolge |
| AnfordertStartdatum | Auftragsstartdatum vom Kunden angefordert. Datentyp: Zeichenfolge |
| Staat | Aktueller Status des Auftrags. Datentyp: Zeichenfolge |
| Version | Auftragsversion. Datentyp: Zeichenfolge |
| @Typ | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer <kbd class="ph userinput">Produktbestellung </kbd>. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
[ ]

### Curl-Anforderung

Das folgende Codebeispiel fordert einen vorhandenen Kundenauftrag an.

    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"
    }

## Offene 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. Datentyp: Zeichenfolge Tabelle: Kundenauftrag \[sn_ind_tmt_orm_order\] |
[Tabelle : 25. Pfad-Parameter]

{#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 |
|-|-|
| Kanal | Liste der Kanäle, die für den Verkauf der Produkte verwendet werden sollen. Datentyp: Array von Objekten{#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} Gespeichert in: sn_ind_tmt_orm_order |
| Kanal.ID | Erforderlich, wenn channelParameter wird verwendet. Eindeutiger Bezeichner des Kanals, der zum Verkauf der zugehörigen Produkte verwendet werden soll. Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-ord-productOrder-id__channel_id_data_type-p-tmf622} Tabelle: Im Feld external_ID der Tabelle „Verteilungskanal" \[sn_prd_pm_distribution_channel\]. Gespeichert in: Das Kanalfeld der sn_ind_tmt_orm_order-Tabelle. Standard: Leere Zeichenfolge |
| channel.name | Name des Kanals, der zum Verkauf der zugehörigen Produkte verwendet werden soll. Mögliche Kanalnamen werden auf der Registerkarte „Auswahlliste" im Kanalwörterbucheintrag der sn_ind_tmt_orm_order-Tabelle 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 oder nach dem übereinstimmen committedDueDateWerte für jedes Auftragspositionselement. Wenn die Aktion für Auftragspositionen lautet <kbd class="ph userinput">Anhalten </kbd>Oder <kbd class="ph userinput">Fortsetzen </kbd>, Dieser Parameter kann nicht aktualisiert werden. Datentyp: Zeichenfolge Gespeichert in: Dem Feld „commit_due_date" der Tabelle „sn_ind_tmt_orm_order". |
| 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} Gespeichert in: Das Feld external_ID der sn_ind_tmt_orm_order-Tabelle. Standard: Leere Zeichenfolge |
| note | Liste der zusätzlichen Notizen, die der Kunde bei der Bestellung gemacht hat. Datentyp: Array von Objekten{#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} Gespeichert in: sn_ind_tmt_orm_order |
| Hinweis.Text | Zusätzliche Notizen/Kommentare des Kunden während der Bestellung. Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-ord-productOrder-id__note_text_data_type-p-tmf622} Gespeichert in: Das Kommentarfeld der sn_ind_tmt_orm_order-Tabelle. Standard: Leere Zeichenfolge |
| Auftragswährung | Währungscode für den Auftrag und die Auftragspositionen. 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 Elemente beschreibt, die der Produktbestellung und der zugehörigen Aktion zugeordnet sind. Datentyp: Array von Objekten{#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} Gespeichert in: sn_ind_tmt_orm_order_line_item |
| ProductOrderElement.Aktion | Erforderlich, wenn productOrderItemParameter wird verwendet. Aktion, die für das Produkt ausgeführt werden soll. Mögliche Aktionen werden auf der Registerkarte „Auswahlliste" im Aktionswörterbucheintrag der sn_ind_tmt_orm_order_line_item-Tabelle definiert. Mögliche Werte: * Hinzufügen * Change * löschen * Keine Änderung * Fortsetzen * 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} Gespeichert in: Das Aktionsfeld der sn_ind_tmt_orm_order_line_item-Tabelle. Standard: Hinzufügen |
| ProduktbestellungElement.actionReason | Grund für das Hinzufügen der Auftragsposition. Datentyp: Zeichenfolge Gespeichert in: Dem Feld „action_reason" der sn_ind_tmt_orm_order_line_item-Tabelle. |
| productOrderItem.committedDueDate | Datum und Uhrzeit, zu der die Aktion für die Auftragsposition ausgeführt werden muss. Wenn die Aktion für das Element lautet <kbd class="ph userinput">Anhalten </kbd>Oder <kbd class="ph userinput">Fortsetzen </kbd>, Dieser Parameter kann nicht aktualisiert werden. Datentyp: Zeichenfolge Gespeichert in: Dem Feld „commit_due_date" der Tabelle „sn_ind_tmt_orm_order_line_item". |
| ProduktbestellungElement.externalProduktbestand | Liste der externen IDs, die den für den Auftrag erstellten Produktbeständen zugeordnet werden sollen. Datentyp: Array von Objekten "externalProductInventory": [ { "externalProductInventoryId": "String" } ] Hinweis: Beim Erstellen eines PATCH-Auftrags mit einer bereits vorhandenen externen Produktbestands-ID wurde der Vorgang zuvor abgebrochen und ein Fehler zurückgegeben. Mit XanaduRelease: Dieser Parameter wird einfach ignoriert, wenn eine vorhandene externe Produktbestands-ID bereitgestellt wird und kein Fehler ausgelöst wird. |
| ProduktbestellungElement.externalProduktbestand.externalProduktbestellungId | Externe ID, die dem Produktbestand zugeordnet werden soll. Datentyp: Zeichenfolge Gespeichert in: Das Feld external_Inventory_ID der Tabelle sn_ind_tmt_orm_order_line_item und das Feld sn_prd_invt_external_id der Tabelle sn_prd_invt_product_inventory. |
| Produktauftragselement.ID | Erforderlich, wenn productOrderItemParameter wird verwendet. Eindeutiger Bezeichner der Position. Befindet sich im Feld sn_ind_tmt_orm_external_id der Auftragspositionstabelle \[sn_ind_tmt_orm_order_line_item\]. Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-ord-productOrder-id__prodOrdItem_id_data_type-p-tmf622} Gespeichert in: Das Feld external_ID der sn_ind_tmt_orm_order_line_item-Tabelle. Maximale Länge: 40 Standard: Leere Zeichenfolge |
| productOrderItem.itemPrice | Liste, die den Preis beschreibt, der dem Produkt zugeordnet ist. Datentyp: Array von Objekten{#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} Gespeichert in: sn_ind_tmt_orm_order Standard: Leere Zeichenfolge |
| productOrderItem.itemPrice.price | Beschreibung des Preises des zugehörigen 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} Gespeichert in: sn_ind_tmt_orm_order_line_item Standard: Leere Zeichenfolge |
| productOrderItem.itemPrice.price.taxIncludedAmount | Beschreibung des Preises des zugehörigen Produkts, einschließlich der 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} Gespeichert in: sn_ind_tmt_orm_order_line_item |
| productOrderItem.itemPrice.price.taxIncludedAmount.unit | 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} Gespeichert in: Das mrc- oder nrc-Feld in der sn_ind_tmt_orm_order_line_item-Tabelle. |
| productOrderItem.itemPrice.price.taxIncludedAmount.value | Preis des Produkts, einschließlich Steuern. Datentyp: Zahl{#tmf_prod_order-PATCH-ord-productOrder-id__itemPrice_price_taxIncludedAmt_value_data_type-p-tmf622} Gespeichert in: Das mrc- oder nrc-Feld in der sn_ind_tmt_orm_order_line_item-Tabelle. |
| 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.product | Erforderlich, wenn productOrderItem.actionIst „Change" oder „Delete". Beschreibung der Instanzdetails des vom Kunden gekauften 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} Gespeichert in: sn_ind_tmt_orm_order_line_item |
| productOrderItem.product.id | Erforderlich, wenn productOrderItem.actionIst „Change" oder „Delete". 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 Standorte, 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} Gespeichert in: sn_ind_tmt_orm_order_line_item |
| productOrderItem.product.place.id | Erforderlich, wenn productOrderItem.product.placeParameter wird verwendet. SYS_ID des zugeordneten Standortdatensatzes in der Tabelle „Standort" \[cmn_location\]. Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-ord-productOrder-id__product_place_id_data_type-p-tmf622} Gespeichert in: Das Standortfeld der sn_ind_tmt_orm_order_line_item-Tabelle. Standard: Leere Zeichenfolge |
| productOrderItem.product.place.@type | Teil des TMF Open API-Standards. Anmerkung für Auftragspositionskontakt. Dieser Wert ist immer <kbd class="ph userinput">Ort </kbd>. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
| productOrderItem.product.productCharacteristic | Liste der Merkmale des zugeordneten Produkts. Datentyp: Array von Objekten{#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} Gespeichert in: sn_ind_tmt_orm_order_characteristic_value |
| productOrderItem.product.productCharacteristic.name | Name des Merkmalsdatensatzes, der dem Produkt zugeordnet werden soll. Befindet sich in der Merkmalstabelle \[sn_prd_pm_characteristic\]. Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-ord-productOrder-id__prod_prodChar_name_data_type-p-tmf622} Gespeichert in: Das Merkmalsfeld der sn_ind_tmt_orm_order_characteristic_value-Tabelle. Standard: Leere Zeichenfolge |
| productOrderItem.product.productCharacteristic.previousValue | Vorherige Merkmalsoptionswerte, wenn die Aktualisierung für einen Change-Auftrag gilt. Die Anforderung ist ein Change-Auftrag, wenn productOrderItem.actionParameter ist anders als <kbd class="ph userinput">Hinzufügen </kbd>. 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=yokohama&pubname=yokohama-order-management&ft:locale=en-US). Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-ord-productOrder-id__prod_prodChar_previousValue_data_type-p-tmf622} Gespeichert in: Die previous_characteristic_option_value der sn_ind_tmt_orm_order_characteristic_value-Tabelle. Standard: Leere Zeichenfolge |
| productOrderItem.product.productCharacteristic.value | Merkmalsoptionswerte, 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=yokohama&pubname=yokohama-order-management&ft:locale=en-US). Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-ord-productOrder-id__prod_prodChar_value_data_type-p-tmf622} Gespeichert in: Das Feld „Merkmal_Option_value" der sn_ind_tmt_orm_order_characteristic_value-Tabelle. Standard: Leere Zeichenfolge |
| productOrderItem.product.productSpecification | Beschreibung der Produktspezifikation, die dem Produkt zugeordnet ist. Hinweis: Änderungsreihenfolgen ( productOrderItem.actionIst `Ändern `) Werden basierend auf dem Wert von unterschiedlich verarbeitet sn_ind_tmt_orm.allowSpecVersionUpdateInChangeOrderSystemeigenschaft. Der Wert dieser Systemeigenschaft bestimmt, wie der Auftrag verarbeitet wird, wenn der Produktbestand eine andere Version als in der Bestellung angegeben ist. * Wenn diese Systemeigenschaft auf „wahr" festgelegt ist (Standard), wird der Produktbestand automatisch auf die Version in der Reihenfolge aktualisiert, indem die referenzierte Produktspezifikation geändert wird. Dadurch kann der Auftrag erfolgreich verarbeitet werden. * Wenn diese Systemeigenschaft auf „falsch" festgelegt ist und der Produktbestand eine andere Version als in der Bestellung angegeben hat, 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} Gespeichert in: sn_ind_tmt_orm_order_line_item |
| productOrderItem.product.productSpecification.id | Erforderlich, wenn productOrderItem.product.productSpecificationParameter wird verwendet. 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.internalVersion | Version der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Produktspezifikation \[sn_prd_pm_product_specification\] |
| productOrderItem.product.productSpecification.name | Name der Produktspezifikation. Befindet sich in der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. Datentyp: Zeichenfolge |
| productOrderItem.product.productSpecification.version | External_Version der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Produktspezifikation \[sn_prd_pm_product_specification\] |
| productOrderItem.product.productSpecification.@type | Teil des Standards für offene TMF-API. Dieser Wert ist immer <kbd class="ph userinput">ProduktspezifikationRef </kbd>. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
| productOrderItem.product.relatedParty | Liste der Kontakte für Einzelposten. Datentyp: Array von Objekten{#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} Gespeichert in: sn_ind_tmt_orm_order_line_item_contact |
| productOrderItem.product.relatedParty.email | E-Mail-Adresse des Kontakts. Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-ord-productOrder-id__prod_relParty_email_data_type-p-tmf622} Gespeichert in: Das E-Mail-Feld der sn_ind_tmt_orm_order_line_item_contact-Tabelle. Standard: Leere Zeichenfolge |
| productOrderItem.product.relatedParty.firstName | Vorname des Kontakts. Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-ord-productOrder-id__prod_relParty_firstName_data_type-p-tmf622} Gespeichert in: Das Feld „first_Name" der sn_ind_tmt_orm_order_line_item_contact-Tabelle. Standard: Leere Zeichenfolge |
| productOrderItem.product.relatedParty.id | SYS_ID des Positionskontakts, der der Auftragsposition zugeordnet ist. Befindet sich in der Tabelle „Auftragspositionskontakt" \[sn_ind_tmt_orm_order_line_item_contact\]. Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-ord-productOrder-id__prod_relParty_id_data_type-p-tmf622} Gespeichert in: Das Feld „sys_ID" der sn_ind_tmt_orm_order_line_item_contact-Tabelle. Standard: Leere Zeichenfolge |
| productOrderItem.product.relatedParty.lastName | Nachname des Kontakts. Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-ord-productOrder-id__prod_relParty_lastName_data_type-p-tmf622} Gespeichert in: Dem Feld „lastName" der sn_ind_tmt_orm_order_line_item_contact-Tabelle. Standard: Leere Zeichenfolge |
| productOrderItem.product.relatedParty.phone | Geschäftliche Telefonnummer des Kontakts. Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-ord-productOrder-id__prod_relParty_phone_data_type-p-tmf622} Gespeichert in: Das Feld „Business_Phone" der Tabelle „sn_ind_tmt_orm_order_line_item_contact". Standard: Leere Zeichenfolge |
| productOrderItem.product.relatedParty.@referredType | Typ des Kunden. Möglicher Wert: OrderLineItemContact{#tmf_prod_order-PATCH-ord-productOrder-id__prod_relParty_refType-p-tmf622} Datentyp: Zeichenfolge |
| productOrderItem.product.relatedParty.@type | Teil des TMF Open API-Standards. Anmerkung für Auftragspositionskontakt. Dieser Wert ist immer <kbd class="ph userinput">Zugehörige Partei </kbd>. 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 <kbd class="ph userinput">Produkt </kbd>. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
| productOrderItem.productOffering | 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} Gespeichert in: sn_ind_tmt_orm_order_line_item |
| productOrderItem.productOffering.id | Erforderlich, wenn productOrderItem.productOfferingParameter wird verwendet. Initial_Version oder external_ID des Produktangebots. „Initial_Version" ist die sys_ID der ersten Version des Angebots. Befindet sich im Feld „sys_ID" oder „external_ID" der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge |
| productOrderItem.productOffering.internalVersion | Version des Produktangebots. Datentyp: Zeichenfolge Tabelle: Produktangebot \[sn_prd_pm_product_offering\] |
| productOrderItem.productOffering.name | Name des Produktangebots. Befindet sich in der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge |
| productOrderItem.productOffering.version | External_Version des Produktangebots. Datentyp: Zeichenfolge Tabelle: Produktangebot \[sn_prd_pm_product_offering\] |
| productOrderItem.productOrderItem.quantity | Anzahl der zugeordneten Artikel, die bestellt werden sollen. Datentyp: Zahl{#tmf_prod_order-PATCH-ord-productOrder-id__prodOrdItem_quantity_data_type-p-tmf622} Gespeichert in: Das Mengenfeld der sn_ind_tmt_orm_order. Standard: Null |
| productOrderItem.productOrderItemRelationship | Liste der Beziehungen zwischen Auftragspositionen. Datentyp: Array von Objekten{#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} Gespeichert in: sn_ind_tmt_orm_order_line_item |
| productOrderItem.productOrderItemRelationship.id | Erforderlich, wenn productOrderItem.productOrderItemRelationshipParameter wird verwendet. Eindeutiger Bezeichner der zugehörigen Position. Befindet sich im Feld sn_ind_tmt_orm_external_id der Auftragspositionstabelle \[sn_ind_tmt_orm_order_line_item\]. Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-ord-productOrder-id__prodOrderItemRel_id_data_type-p-tmf622} Gespeichert in: Das Feld parent_line_item der thebsn_ind_tmt_orm_order_line_item-Tabelle. 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 * Übergeordnetes Element * Erfordert {#tmf_prod_order-PATCH-ord-productOrder-id__ul_yqf_2ty_54b} `HasChild `Und `Übergeordnetes Element `Werden für übergeordnete/untergeordnete Beziehungen verwendet. `Erfordert `Wird für horizontale Beziehungen verwendet (ein Einzelposten erfordert eine andere Position). Datentyp: Zeichenfolge |
| ProduktbestellungElement.Menge | Anzahl der bestellten Artikel. Datentyp: Zahl Gespeichert in: Das Mengenfeld der sn_ind_tmt_orm_order-Tabelle. Standard: Leere Zeichenfolge |
| ProductOrderElement.revisionVorgang | Typ der Aktualisierung, die für die Position ausgeführt werden soll. Wenn dieser Wert leer ist, wird die vorhandene Position aktualisiert, oder eine neue Position wird hinzugefügt, wenn sie noch nicht vorhanden ist. Wenn dieser Wert ist <kbd class="ph userinput">Abbrechen </kbd>, Die Position wurde storniert. Datentyp: Zeichenfolge Standard: Leere Zeichenfolge |
| ProductOrderItem.@type | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer <kbd class="ph userinput">Produktbestellelement </kbd>. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
| ZugehörigPartei | Liste der Kontakte für den Auftrag. Jeder Kontakt ist ein Objekt im Array. Muss mindestens ein Element auflisten, das Kunden- oder Verbraucherkontoinformationen enthält. Datentyp: Array von Objekten{#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} |
| RelatedParty.ID | SYS_ID oder external_ID des Accounts, Kundenkontakts oder Verbrauchers, der dem Auftrag zugeordnet ist. Befindet sich 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 |
| RelatedParty.@referredType | Typ des Kunden. Mögliche Werte: * Verbraucher * Kunde * Kundenkontakt {#tmf_prod_order-PATCH-ord-productOrder-id__ul_lcq_jwm_t4b} Datentyp: Zeichenfolge |
| RelatedParty.@type | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer <kbd class="ph userinput">Zugehörige Partei </kbd>. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
| AnfordertAbschlusdatum | Vom Kunden angefordertes Lieferdatum. Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-ord-productOrder-id__reqCompDate_data_type-p-tmf622} Gespeichert in: Das Feld expected_end_date der sn_ind_tmt_orm_order-Tabelle. Standard: Leere Zeichenfolge |
| AnfordertStartdatum | Auftragsstartdatum vom Kunden angefordert. Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-ord-productOrder-id__reqStartDate_data_type-p-tmf622} Gespeichert in: Das Feld expected_Start_date der sn_ind_tmt_orm_order-Tabelle. Standard: Leere Zeichenfolge |
| @Typ | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer <kbd class="ph userinput">Produktbestellung </kbd>. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
[Tabelle : 27. Anforderungstext-Parameter (JSON)]

{#tmf_prod_order-PATCH-ord-productOrder-id__id_vk2_p5n_t4b}

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch 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}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Nur unterstützt application/json. |
| Inhaltstyp | Datenformat des Anforderungstexts. Nur unterstützt 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}

| Header | Beschreibung |
|-|-|
| Inhaltstyp | Datenformat des Antworttexts. Nur unterstützt application/json. |
[Tabelle : 29. Antwort-Header]

{#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 [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#tmf_prod_order-PATCH-ord-productOrder-id__table_xfv_2vk_5rb__entry__2}

| Statuscode | Beschreibung |
|-|-|
| 201 | Erfolgreich. Wenn Probleme mit den Informationen zu Merkmalen oder Merkmalen auftreten, speichert der Endpunkt die folgenden Kommentare in den Arbeitsnotizfeldern des zugehörigen Kundenauftragspositionselementdatensatzes: * Die folgenden Merkmale des Bestellelements sind nicht vorhanden: Spezifikation überprüfen \< characteristic.name\> und korrigieren Sie das Merkmal und die Merkmalsoption in der Auftragsposition, bevor Sie den Auftrag genehmigen. * Bestellelementmerkmal: \< characteristic.name\> mit Merkmalswert: \< characteristic.value\>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 oder JSON des Produktauftragspositionselements fehlt. * Ungültige Nutzlast: ProductOrderItem-ID fehlt -- Die idParameter fehlt in der Produktauftragsposition der Nutzlast. * Ungültige Nutzlast: Aktion „productOrderItem" fehlt -- Die actionParameter fehlt in der Produktauftragsposition der Nutzlast. * Ungültige Nutzlast: ProductOrderItem productOffering fehlt -- Das Produktangebotsobjekt oder JSON fehlt in der Produktauftragsposition in der Nutzlast. * Ungültige Nutzlast: ProductOffering-ID fehlt -- Die idParameter fehlt in der Produktauftragsposition des Produktangebotsobjekts in der Nutzlast. * Ungültige Nutzlast: Produktangebot ist nicht vorhanden -- Das Produktangebot in der Produktauftragsposition ist ungültig. * Ungültige Nutzlast: Produkt „productOrderItem" fehlt -- Das Produktobjekt oder JSON in der Produktauftragsposition fehlt in der Nutzlast. * Ungültige Nutzlast: Produktspezifikation fehlt -- Das Produktspezifikationsobjekt oder JSON in der Produktauftragsposition fehlt in der Nutzlast. * Ungültige Nutzlast: Produktspezifizierungs-ID fehlt -- Die idParameter in der Produktauftragsposition 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 ist nicht vorhanden -- In einem Change-Auftrag (Aktion = Change) ist die Menge eines Artikels größer als die Menge auf Lager. * Ungültige Nutzlast: Produktbestand-ID fehlt -- In einem Change-Auftrag product.idFehlt 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. * Kundenaccount oder Verbraucher fehlt -- Der Kunde oder das Verbraucherobjekt der zugehörigen Partei fehlt in der Nutzlast. * Ungültige Nutzlast: Verbraucher ist nicht vorhanden -- Der angegebene Verbraucher der zugehörigen Partei ist in nicht vorhanden ServiceNowInstanz. * Ungültige Nutzlast: Kundenaccount ist nicht vorhanden -- Der angegebene Kunde der zugehörigen Partei ist in nicht vorhanden ServiceNowInstanz. * Ungültige Nutzlast: Auftragserstellung fehlgeschlagen -- Der angeforderte Auftrag kann nicht erstellt werden. * Laufende Überarbeitung der Auftragswährung wird nicht unterstützt -- Die orderCurrencyParameter kann nicht aktualisiert werden, nachdem der Auftrag erstellt wurde. * Dieser Auftrag 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. * 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 „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}

### Antworttext-Parameter (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__d3104e1577}{#tmf_prod_order-PATCH-ord-productOrder-id__externalProdInvId-resp-descr}

| Name | Beschreibung |
|-|-|
| Kanal | Liste der Kanäle, die für den Verkauf der Produkte verwendet werden sollen. Datentyp: Array von Objekten "channel": [ { "id": "String", "name": "String" } ] |
| Kanal.ID | Eindeutiger Bezeichner des Kanals, der zum Verkauf der zugehörigen Produkte verwendet werden soll. Datentyp: Zeichenfolge |
| channel.name | Name des Kanals, der zum 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 oder nach dem übereinstimmen committedDueDateWerte für jedes Auftragspositionselement. Datentyp: Zeichenfolge |
| externalId | Externer Bezeichner für den Kundenauftrag, z. B. eine Bestellnummer. Datentyp: Zeichenfolge |
| href | Relativer Link zum Produktbestellungsdatensatz. Datentyp: Zeichenfolge |
| ID | SYS_ID des Kundenauftrags, der für diese Anforderung aktualisiert wurde. Datentyp: Zeichenfolge |
| note | Liste der zusätzlichen Notizen, die der Kunde bei der Bestellung gemacht hat. Datentyp: Array von Objekten "note": [ { "text": "String" } ] |
| Hinweis.Text | Zusätzliche Notizen/Kommentare des Kunden während der Bestellung. Datentyp: Zeichenfolge |
| Auftragswährung | Währungscode für den Auftrag und die Auftragspositionen. Datentyp: Zeichenfolge |
| ProductOrderItem | Liste, die Elemente beschreibt, die der Produktbestellung und der zugehörigen Aktion zugeordnet sind. Datentyp: Array von Objekten "productOrderItem:" [ { "action": "String", "committedDueDate": "String", "externalProductInventory": [Array], "id": "String", "itemPrice": [Array], "product": {Object}, "productOffering": {Object}, "productOrderItemReleationship": [Array], "quantity": Number, "state": "String", "@type": "String" } ] |
| ProductOrderElement.Aktion | Aktion, die für das Produkt ausgeführt werden soll. Mögliche Aktionen werden auf der Registerkarte „Auswahlliste" im Aktionswörterbucheintrag der sn_ind_tmt_orm_order_line_item-Tabelle definiert. Datentyp: Zeichenfolge |
| ProduktbestellungElement.actionReason | Grund für das Hinzufügen der Auftragsposition. Datentyp: Zeichenfolge Gespeichert in: Dem Feld „action_reason" der sn_ind_tmt_orm_order_line_item-Tabelle. |
| productOrderItem.committedDueDate | Datum und Uhrzeit, zu der die Aktion für die Auftragsposition ausgeführt werden muss. Datentyp: Zeichenfolge |
| ProduktbestellungElement.externalProduktbestand | Liste der externen IDs, die den für den Auftrag erstellten Produktbeständen zugeordnet werden sollen. Datentyp: Array von Objekten "externalProductInventory": [ { "externalProductInventoryId": "String" } ] Hinweis: Beim Erstellen eines PATCH-Auftrags mit einer bereits vorhandenen externen Produktbestands-ID wurde der Vorgang zuvor abgebrochen und ein Fehler zurückgegeben. Mit XanaduRelease: Dieser Parameter wird einfach ignoriert, wenn eine vorhandene externe Produktbestands-ID bereitgestellt wird und kein Fehler ausgelöst wird. |
| ProduktbestellungElement.externalProduktbestand.externalProduktbestellungId | Externe ID, die dem Produktbestand zugeordnet ist. Datentyp: Zeichenfolge |
| productOrderItem.id | Eindeutiger Bezeichner der Position. Befindet sich im Feld sn_ind_tmt_orm_external_id der Auftragspositionstabelle \[sn_ind_tmt_orm_order_line_item\]. Datentyp: Zeichenfolge |
| productOrderItem.itemPrice | Liste, die den Preis beschreibt, der dem Produkt zugeordnet ist. Datentyp: Array von Objekten "itemPrice": [ { "price": {Object}, "priceType": "String", "recurringChargePeriod": "String" } ] |
| productOrderItem.itemPrice.price | Beschreibung des Preises des zugehörigen Produkts. Datentyp: Objekt "price": { "taxIncludedAmount": {Object} } |
| productOrderItem.itemPrice.price.taxIncludeAmount | Beschreibung des Preises des zugehörigen Produkts, einschließlich der Steuer. Datentyp: Objekt "taxIncludedAmount": { "unit": "String", "value": Number } |
| productOrderItem.itemPrice.price.taxIncludeAmount.unit | Währungscode, in dem der Preis dargestellt wird. Datentyp: Zeichenfolge |
| productOrderItem.itemPrice.price.taxIncludeAmount.value | 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.product | Beschreibung der Instanzdetails des vom Kunden gekauften 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 Standorte, 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 Tabelle „Standort" \[cmn_location\]. Datentyp: Zeichenfolge |
| productOrderItem.product.productCharacteristic | Liste der Merkmale des zugeordneten Produkts. Datentyp: Array von Objekten "productCharacteristic": [ { "name": "String", "previousValue": "String", "value": "String" } ] |
| productOrderItem.product.productCharacteristic.name | Name des Merkmalsdatensatzes, der dem Produkt zugeordnet werden soll. Befindet sich in der Merkmalstabelle \[sn_prd_pm_characteristic\]. Datentyp: Zeichenfolge |
| productOrderItem.product.productCharacteristic.previousValue | Vorherige Merkmalsoptionswerte, wenn die Aktualisierung für einen Change-Auftrag gilt. Die Anforderung ist ein Change-Auftrag, wenn productOrderItem.actionParameter ist anders als <kbd class="ph userinput">Hinzufügen </kbd>. 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=yokohama&pubname=yokohama-order-management&ft:locale=en-US). Datentyp: Zeichenfolge |
| productOrderItem.product.productCharacteristic.value | Merkmalsoptionswerte, 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=yokohama&pubname=yokohama-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 |
| productOrderItem.product.productSpecification.internalId | Anfangsversion der Produktspezifikation. Die Anfangsversion ist die sys_ID der ersten Version der Spezifikation. Datentyp: Zeichenfolge Tabelle: Produktspezifikation \[sn_prd_pm_product_specification\] |
| productOrderItem.product.productSpecification.internalVersion | Version der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „Version" der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. |
| productOrderItem.product.productSpecification.name | Name der Produktspezifikation. Befindet sich in der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. Datentyp: Zeichenfolge |
| productOrderItem.product.productSpecification.version | Externe Version der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld external_Version der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. |
| productOrderItem.product.productSpecification.@type | Teil des Standards für offene TMF-API. Dieser Wert ist immer <kbd class="ph userinput">ProduktspezifikationRef </kbd>. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
| productOrderItem.product.relatedParty | Liste der Kontakte für Einzelposten. Datentyp: Array von Objekten "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 |
| productOrderItem.product.relatedParty.firstName | Vorname des Kontakts. Datentyp: Zeichenfolge |
| productOrderItem.product.relatedParty.id | SYS_ID des Positionskontakts, der der Auftragsposition zugeordnet ist. Befindet sich in der Tabelle „Auftragspositionskontakt" \[sn_ind_tmt_orm_order_line_item_contact\]. Datentyp: Zeichenfolge |
| productOrderItem.product.relatedParty.lastName | Nachname des Kontakts. Datentyp: Zeichenfolge |
| productOrderItem.product.relatedParty.phone | Geschäftliche Telefonnummer des Kontakts. Datentyp: Zeichenfolge |
| productOrderItem.product.relatedParty.@referredType | Typ des Kunden. Möglicher Wert: OrderLineItemContact Datentyp: Zeichenfolge |
| productOrderItem.product.relatedParty.@type | Teil des TMF Open API-Standards. Anmerkung für Auftragspositionskontakt. Dieser Wert ist immer <kbd class="ph userinput">Zugehörige Partei </kbd>. 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 <kbd class="ph userinput">Produkt </kbd>. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
| productOrderItem.productOffering | 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. Befindet sich im Feld „sys_ID" oder „external_ID" der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge |
| productOrderItem.productOffering.internalId | Anfangsversion des Produktangebots. Die Anfangsversion ist die sys_ID der ersten Version des Angebots. Datentyp: Zeichenfolge Tabelle: Produktangebot \[sn_prd_pm_product_offering\] |
| productOrderItem.productOffering.internalVersion | Version des Produktangebots. Datentyp: Zeichenfolge Tabelle: Im Feld „Version" der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. |
| productOrderItem.productOffering.name | Name des Produktangebots. Befindet sich in der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge |
| productOrderItem.productOffering.version | Externe Version des Produktangebots. Datentyp: Zeichenfolge Tabelle: Im Feld external_Version der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. |
| productOrderItem.productOrderItemRelationship | Liste der Beziehungen zwischen Auftragspositionen. Datentyp: Array von Objekten "productOrderItemRelationship": [ { "id": "String", "relationshipType": "String" } ] |
| productOrderItem.productOrderItemRelationship.id | Eindeutiger Bezeichner der zugehörigen Position. Befindet sich im Feld sn_ind_tmt_orm_external_id der Auftragspositionstabelle \[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 |
| ProduktbestellungElement.Menge | Anzahl der zugeordneten Artikel, die bestellt werden sollen. Datentyp: Zahl |
| ProduktbestellungElement.Status | Aktueller Status des Produktbestellelements. Datentyp: Zeichenfolge |
| ProductOrderItem.@type | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer <kbd class="ph userinput">Produktbestellelement </kbd>. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
| ZugehörigPartei | Liste der Kontakte für den Auftrag. Jeder Kontakt ist ein Objekt im Array. Muss mindestens ein Element auflisten, das Kunden- oder Verbraucherkontoinformationen enthält. Datentyp: Array von Objekten "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. Befindet sich 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 |
| RelatedParty.type | Typ des Kunden. Mögliche Werte: * Verbraucher * Kunde * Kundenkontakt {#tmf_prod_order-PATCH-ord-productOrder-id__d3104e2442} Datentyp: Zeichenfolge |
| AnfordertAbschlusdatum | Vom Kunden angefordertes Lieferdatum. Datentyp: Zeichenfolge |
| AnfordertStartdatum | Auftragsstartdatum vom Kunden angefordert. Datentyp: Zeichenfolge |
| Staat | Aktueller Status des Auftrags. Datentyp: Zeichenfolge |
| @Typ | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer Produktbestellung . 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}

Dieses Beispiel aktualisiert den Kanal für eine Produktbestellung.

    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"
    }

## Offene API für Produktbestellung -- PATCH /sn_ind_tmt_orm/productorder/{ID} {#ariaid-title7}

Aktualisiert den angegebenen Kundenauftrag.
Wichtig:  
Beginnend mit TokyoRelease, dieser Endpunkt ist veraltet. Die neue Version dieses Endpunkts ist [Offene API für Produktbestellung -- PATCH /sn_ind_tmt_orm/order/productOrder/{ID}](https://servicenow-prod.fluidtopics.net/sdD3L5blimu_FO2BexrA7Q#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. Datentyp: Zeichenfolge Tabelle: Kundenauftrag \[sn_ind_tmt_orm_order\] |
[Tabelle : 31. Pfad-Parameter]

{#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 |
|-|-|
| Kanal | Liste der Kanäle, die für den Verkauf der Produkte verwendet werden sollen. Datentyp: Array von Objekten{#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} Gespeichert in: sn_ind_tmt_orm_order |
| Kanal.ID | Erforderlich, wenn channelParameter wird verwendet. Eindeutiger Bezeichner des Kanals, der zum Verkauf der zugehörigen Produkte verwendet werden soll. Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-productorder-id__channel_id_data_type-p-tmf622} Tabelle: Im Feld external_ID der Tabelle „Verteilungskanal" \[sn_prd_pm_distribution_channel\]. Gespeichert in: Das Kanalfeld der sn_ind_tmt_orm_order-Tabelle. Standard: Leere Zeichenfolge |
| channel.name | Name des Kanals, der zum Verkauf der zugehörigen Produkte verwendet werden soll. Mögliche Kanalnamen werden auf der Registerkarte „Auswahlliste" im Kanalwörterbucheintrag der sn_ind_tmt_orm_order-Tabelle 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 oder nach dem übereinstimmen committedDueDateWerte für jedes Auftragspositionselement. Wenn die Aktion für Auftragspositionen lautet <kbd class="ph userinput">Anhalten </kbd>Oder <kbd class="ph userinput">Fortsetzen </kbd>, Dieser Parameter kann nicht aktualisiert werden. Datentyp: Zeichenfolge Gespeichert in: Dem Feld „commit_due_date" der Tabelle „sn_ind_tmt_orm_order". |
| 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} Gespeichert in: Das Feld external_ID der sn_ind_tmt_orm_order-Tabelle. Standard: Leere Zeichenfolge |
| note | Liste der zusätzlichen Notizen, die der Kunde bei der Bestellung gemacht hat. Datentyp: Array von Objekten{#tmf_prod_order-PATCH-productorder-id__note_data_type-p-tmf622} "note": [ { "text": "String" } ] {#tmf_prod_order-PATCH-productorder-id__note-codeblock-tmf622} Gespeichert in: sn_ind_tmt_orm_order |
| Hinweis.Text | Zusätzliche Notizen/Kommentare des Kunden während der Bestellung. Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-productorder-id__note_text_data_type-p-tmf622} Gespeichert in: Das Kommentarfeld der sn_ind_tmt_orm_order-Tabelle. Standard: Leere Zeichenfolge |
| Auftragswährung | Währungscode für den Auftrag und die Auftragspositionen. 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 Elemente beschreibt, die der Produktbestellung und der zugehörigen Aktion zugeordnet sind. Datentyp: Array von Objekten{#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} Gespeichert in: sn_ind_tmt_orm_order_line_item |
| ProductOrderElement.Aktion | Erforderlich, wenn productOrderItemParameter wird verwendet. Aktion, die für das Produkt ausgeführt werden soll. Mögliche Aktionen werden auf der Registerkarte „Auswahlliste" im Aktionswörterbucheintrag der sn_ind_tmt_orm_order_line_item-Tabelle definiert. Mögliche Werte: * Hinzufügen * Change * löschen * Keine Änderung * Fortsetzen * 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} Gespeichert in: Das Aktionsfeld der sn_ind_tmt_orm_order_line_item-Tabelle. Standard: Hinzufügen |
| ProduktbestellungElement.actionReason | Grund für das Hinzufügen der Auftragsposition. Datentyp: Zeichenfolge Gespeichert in: Dem Feld „action_reason" der sn_ind_tmt_orm_order_line_item-Tabelle. |
| productOrderItem.committedDueDate | Datum und Uhrzeit, zu der die Aktion für die Auftragsposition ausgeführt werden muss. Wenn die Aktion für das Element lautet <kbd class="ph userinput">Anhalten </kbd>Oder <kbd class="ph userinput">Fortsetzen </kbd>, Dieser Parameter kann nicht aktualisiert werden. Datentyp: Zeichenfolge Gespeichert in: Dem Feld „commit_due_date" der Tabelle „sn_ind_tmt_orm_order_line_item". |
| ProduktbestellungElement.externalProduktbestand | Liste der externen IDs, die den für den Auftrag erstellten Produktbeständen zugeordnet werden sollen. Datentyp: Array von Objekten "externalProductInventory": [ { "externalProductInventoryId": "String" } ] Hinweis: Beim Erstellen eines PATCH-Auftrags mit einer bereits vorhandenen externen Produktbestands-ID wurde der Vorgang zuvor abgebrochen und ein Fehler zurückgegeben. Mit XanaduRelease: Dieser Parameter wird einfach ignoriert, wenn eine vorhandene externe Produktbestands-ID bereitgestellt wird und kein Fehler ausgelöst wird. |
| ProduktbestellungElement.externalProduktbestand.externalProduktbestellungId | Externe ID, die dem Produktbestand zugeordnet werden soll. Datentyp: Zeichenfolge Gespeichert in: Das Feld external_Inventory_ID der Tabelle sn_ind_tmt_orm_order_line_item und das Feld sn_prd_invt_external_id der Tabelle sn_prd_invt_product_inventory. |
| Produktauftragselement.ID | Erforderlich, wenn productOrderItemParameter wird verwendet. Eindeutiger Bezeichner der Position. Befindet sich im Feld sn_ind_tmt_orm_external_id der Auftragspositionstabelle \[sn_ind_tmt_orm_order_line_item\]. Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-productorder-id__prodOrdItem_id_data_type-p-tmf622} Gespeichert in: Das Feld external_ID der sn_ind_tmt_orm_order_line_item-Tabelle. Maximale Länge: 40 Standard: Leere Zeichenfolge |
| productOrderItem.itemPrice | Liste, die den Preis beschreibt, der dem Produkt zugeordnet ist. Datentyp: Array von Objekten{#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} Gespeichert in: sn_ind_tmt_orm_order Standard: Leere Zeichenfolge |
| productOrderItem.itemPrice.price | Beschreibung des Preises des zugehörigen 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} Gespeichert in: sn_ind_tmt_orm_order_line_item Standard: Leere Zeichenfolge |
| productOrderItem.itemPrice.price.taxIncludedAmount | Beschreibung des Preises des zugehörigen Produkts, einschließlich der 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} Gespeichert in: sn_ind_tmt_orm_order_line_item |
| productOrderItem.itemPrice.price.taxIncludedAmount.unit | Währungscode, in dem der Preis dargestellt wird. Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-productorder-id__itemPrice_price_taxIncludedAmt_unit_data_type-p-tmf622} Gespeichert in: Das mrc- oder nrc-Feld in der sn_ind_tmt_orm_order_line_item-Tabelle. |
| productOrderItem.itemPrice.price.taxIncludedAmount.value | Preis des Produkts, einschließlich Steuern. Datentyp: Zahl{#tmf_prod_order-PATCH-productorder-id__itemPrice_price_taxIncludedAmt_value_data_type-p-tmf622} Gespeichert in: Das mrc- oder nrc-Feld in der sn_ind_tmt_orm_order_line_item-Tabelle. |
| 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.product | Erforderlich, wenn productOrderItem.actionIst „Change" oder „Delete". Beschreibung der Instanzdetails des vom Kunden gekauften 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} Gespeichert in: sn_ind_tmt_orm_order_line_item |
| productOrderItem.product.id | Erforderlich, wenn productOrderItem.actionIst „Change" oder „Delete". 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 Standorte, 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} Gespeichert in: sn_ind_tmt_orm_order_line_item |
| productOrderItem.product.place.id | Erforderlich, wenn productOrderItem.product.placeParameter wird verwendet. SYS_ID des zugeordneten Standortdatensatzes in der Tabelle „Standort" \[cmn_location\]. Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-productorder-id__product_place_id_data_type-p-tmf622} Gespeichert in: Das Standortfeld der sn_ind_tmt_orm_order_line_item-Tabelle. Standard: Leere Zeichenfolge |
| productOrderItem.product.place.@type | Teil des TMF Open API-Standards. Anmerkung für Auftragspositionskontakt. Dieser Wert ist immer <kbd class="ph userinput">Ort </kbd>. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
| productOrderItem.product.productCharacteristic | Liste der Merkmale des zugeordneten Produkts. Datentyp: Array von Objekten{#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} Gespeichert in: sn_ind_tmt_orm_order_characteristic_value |
| productOrderItem.product.productCharacteristic.name | Name des Merkmalsdatensatzes, der dem Produkt zugeordnet werden soll. Befindet sich in der Merkmalstabelle \[sn_prd_pm_characteristic\]. Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-productorder-id__prod_prodChar_name_data_type-p-tmf622} Gespeichert in: Das Merkmalsfeld der sn_ind_tmt_orm_order_characteristic_value-Tabelle. Standard: Leere Zeichenfolge |
| productOrderItem.product.productCharacteristic.previousValue | Vorherige Merkmalsoptionswerte, wenn die Aktualisierung für einen Change-Auftrag gilt. Die Anforderung ist ein Change-Auftrag, wenn productOrderItem.actionParameter ist anders als <kbd class="ph userinput">Hinzufügen </kbd>. 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=yokohama&pubname=yokohama-order-management&ft:locale=en-US). Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-productorder-id__prod_prodChar_previousValue_data_type-p-tmf622} Gespeichert in: Die previous_characteristic_option_value der sn_ind_tmt_orm_order_characteristic_value-Tabelle. Standard: Leere Zeichenfolge |
| productOrderItem.product.productCharacteristic.value | Merkmalsoptionswerte, 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=yokohama&pubname=yokohama-order-management&ft:locale=en-US). Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-productorder-id__prod_prodChar_value_data_type-p-tmf622} Gespeichert in: Das Feld „Merkmal_Option_value" der sn_ind_tmt_orm_order_characteristic_value-Tabelle. Standard: Leere Zeichenfolge |
| productOrderItem.product.productSpecification | Beschreibung der Produktspezifikation, die dem Produkt zugeordnet ist. Hinweis: Änderungsreihenfolgen ( productOrderItem.actionIst `Ändern `) Werden basierend auf dem Wert von unterschiedlich verarbeitet sn_ind_tmt_orm.allowSpecVersionUpdateInChangeOrderSystemeigenschaft. Der Wert dieser Systemeigenschaft bestimmt, wie der Auftrag verarbeitet wird, wenn der Produktbestand eine andere Version als in der Bestellung angegeben ist. * Wenn diese Systemeigenschaft auf „wahr" festgelegt ist (Standard), wird der Produktbestand automatisch auf die Version in der Reihenfolge aktualisiert, indem die referenzierte Produktspezifikation geändert wird. Dadurch kann der Auftrag erfolgreich verarbeitet werden. * Wenn diese Systemeigenschaft auf „falsch" festgelegt ist und der Produktbestand eine andere Version als in der Bestellung angegeben hat, 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} Gespeichert in: sn_ind_tmt_orm_order_line_item |
| productOrderItem.product.productSpecification.id | Erforderlich, wenn productOrderItem.product.productSpecificationParameter wird verwendet. 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.internalVersion | Version der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Produktspezifikation \[sn_prd_pm_product_specification\] |
| productOrderItem.product.productSpecification.name | Name der Produktspezifikation. Befindet sich in der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. Datentyp: Zeichenfolge |
| productOrderItem.product.productSpecification.version | External_Version der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Produktspezifikation \[sn_prd_pm_product_specification\] |
| productOrderItem.product.productSpecification.@type | Teil des Standards für offene TMF-API. Dieser Wert ist immer <kbd class="ph userinput">ProduktspezifikationRef </kbd>. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
| productOrderItem.product.relatedParty | Liste der Kontakte für Einzelposten. Datentyp: Array von Objekten{#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} Gespeichert in: sn_ind_tmt_orm_order_line_item_contact |
| productOrderItem.product.relatedParty.email | E-Mail-Adresse des Kontakts. Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-productorder-id__prod_relParty_email_data_type-p-tmf622} Gespeichert in: Das E-Mail-Feld der sn_ind_tmt_orm_order_line_item_contact-Tabelle. Standard: Leere Zeichenfolge |
| productOrderItem.product.relatedParty.firstName | Vorname des Kontakts. Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-productorder-id__prod_relParty_firstName_data_type-p-tmf622} Gespeichert in: Das Feld „first_Name" der sn_ind_tmt_orm_order_line_item_contact-Tabelle. Standard: Leere Zeichenfolge |
| productOrderItem.product.relatedParty.id | SYS_ID des Positionskontakts, der der Auftragsposition zugeordnet ist. Befindet sich in der Tabelle „Auftragspositionskontakt" \[sn_ind_tmt_orm_order_line_item_contact\]. Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-productorder-id__prod_relParty_id_data_type-p-tmf622} Gespeichert in: Das Feld „sys_ID" der sn_ind_tmt_orm_order_line_item_contact-Tabelle. Standard: Leere Zeichenfolge |
| productOrderItem.product.relatedParty.lastName | Nachname des Kontakts. Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-productorder-id__prod_relParty_lastName_data_type-p-tmf622} Gespeichert in: Dem Feld „lastName" der sn_ind_tmt_orm_order_line_item_contact-Tabelle. Standard: Leere Zeichenfolge |
| productOrderItem.product.relatedParty.phone | Geschäftliche Telefonnummer des Kontakts. Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-productorder-id__prod_relParty_phone_data_type-p-tmf622} Gespeichert in: Das Feld „Business_Phone" der Tabelle „sn_ind_tmt_orm_order_line_item_contact". Standard: Leere Zeichenfolge |
| productOrderItem.product.relatedParty.@referredType | Typ des Kunden. Möglicher Wert: OrderLineItemContact{#tmf_prod_order-PATCH-productorder-id__prod_relParty_refType-p-tmf622} Datentyp: Zeichenfolge |
| productOrderItem.product.relatedParty.@type | Teil des TMF Open API-Standards. Anmerkung für Auftragspositionskontakt. Dieser Wert ist immer <kbd class="ph userinput">Zugehörige Partei </kbd>. 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 <kbd class="ph userinput">Produkt </kbd>. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
| productOrderItem.productOffering | 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} Gespeichert in: sn_ind_tmt_orm_order_line_item |
| productOrderItem.productOffering.id | Erforderlich, wenn productOrderItem.productOfferingParameter wird verwendet. Initial_Version oder external_ID des Produktangebots. „Initial_Version" ist die sys_ID der ersten Version des Angebots. Befindet sich im Feld „sys_ID" oder „external_ID" der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge |
| productOrderItem.productOffering.internalVersion | Version des Produktangebots. Datentyp: Zeichenfolge Tabelle: Produktangebot \[sn_prd_pm_product_offering\] |
| productOrderItem.productOffering.name | Name des Produktangebots. Befindet sich in der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge |
| productOrderItem.productOffering.version | External_Version des Produktangebots. Datentyp: Zeichenfolge Tabelle: Produktangebot \[sn_prd_pm_product_offering\] |
| productOrderItem.productOrderItem.quantity | Anzahl der zugeordneten Artikel, die bestellt werden sollen. Datentyp: Zahl{#tmf_prod_order-PATCH-productorder-id__prodOrdItem_quantity_data_type-p-tmf622} Gespeichert in: Das Mengenfeld der sn_ind_tmt_orm_order. Standard: Null |
| productOrderItem.productOrderItemRelationship | Liste der Beziehungen zwischen Auftragspositionen. Datentyp: Array von Objekten{#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} Gespeichert in: sn_ind_tmt_orm_order_line_item |
| productOrderItem.productOrderItemRelationship.id | Erforderlich, wenn productOrderItem.productOrderItemRelationshipParameter wird verwendet. Eindeutiger Bezeichner der zugehörigen Position. Befindet sich im Feld sn_ind_tmt_orm_external_id der Auftragspositionstabelle \[sn_ind_tmt_orm_order_line_item\]. Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-productorder-id__prodOrderItemRel_id_data_type-p-tmf622} Gespeichert in: Das Feld parent_line_item der thebsn_ind_tmt_orm_order_line_item-Tabelle. 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 * Übergeordnetes Element * Erfordert {#tmf_prod_order-PATCH-productorder-id__ul_yqf_2ty_54b} `HasChild `Und `Übergeordnetes Element `Werden für übergeordnete/untergeordnete Beziehungen verwendet. `Erfordert `Wird für horizontale Beziehungen verwendet (ein Einzelposten erfordert eine andere Position). Datentyp: Zeichenfolge |
| ProduktbestellungElement.Menge | Anzahl der bestellten Artikel. Datentyp: Zahl Gespeichert in: Das Mengenfeld der sn_ind_tmt_orm_order-Tabelle. Standard: Leere Zeichenfolge |
| ProductOrderElement.revisionVorgang | Typ der Aktualisierung, die für die Position ausgeführt werden soll. Wenn dieser Wert leer ist, wird die vorhandene Position aktualisiert, oder eine neue Position wird hinzugefügt, wenn sie noch nicht vorhanden ist. Wenn dieser Wert ist <kbd class="ph userinput">Abbrechen </kbd>, Die Position wurde storniert. Datentyp: Zeichenfolge Standard: Leere Zeichenfolge |
| ProductOrderItem.@type | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer <kbd class="ph userinput">Produktbestellelement </kbd>. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
| ZugehörigPartei | Liste der Kontakte für den Auftrag. Jeder Kontakt ist ein Objekt im Array. Muss mindestens ein Element auflisten, das Kunden- oder Verbraucherkontoinformationen enthält. Datentyp: Array von Objekten{#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} |
| RelatedParty.ID | SYS_ID oder external_ID des Accounts, Kundenkontakts oder Verbrauchers, der dem Auftrag zugeordnet ist. Befindet sich 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 |
| RelatedParty.@referredType | Typ des Kunden. Mögliche Werte: * Verbraucher * Kunde * Kundenkontakt {#tmf_prod_order-PATCH-productorder-id__ul_lcq_jwm_t4b} Datentyp: Zeichenfolge |
| RelatedParty.@type | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer <kbd class="ph userinput">Zugehörige Partei </kbd>. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
| AnfordertAbschlusdatum | Vom Kunden angefordertes Lieferdatum. Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-productorder-id__reqCompDate_data_type-p-tmf622} Gespeichert in: Das Feld expected_end_date der sn_ind_tmt_orm_order-Tabelle. Standard: Leere Zeichenfolge |
| AnfordertStartdatum | Auftragsstartdatum vom Kunden angefordert. Datentyp: Zeichenfolge{#tmf_prod_order-PATCH-productorder-id__reqStartDate_data_type-p-tmf622} Gespeichert in: Das Feld expected_Start_date der sn_ind_tmt_orm_order-Tabelle. Standard: Leere Zeichenfolge |
| @Typ | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer <kbd class="ph userinput">Produktbestellung </kbd>. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
[Tabelle : 33. Anforderungstext-Parameter (JSON)]

{#tmf_prod_order-PATCH-productorder-id__id_vk2_p5n_t4b}

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch 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}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Nur unterstützt application/json. |
| Inhaltstyp | Datenformat des Anforderungstexts. Nur unterstützt 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}

| Header | Beschreibung |
|-|-|
| Inhaltstyp | Datenformat des Antworttexts. Nur unterstützt application/json. |
[Tabelle : 35. Antwort-Header]

{#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 [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#tmf_prod_order-PATCH-productorder-id__table_xfv_2vk_5rb__entry__2}

| Statuscode | Beschreibung |
|-|-|
| 201 | Erfolgreich. Wenn Probleme mit den Informationen zu Merkmalen oder Merkmalen auftreten, speichert der Endpunkt die folgenden Kommentare in den Arbeitsnotizfeldern des zugehörigen Kundenauftragspositionselementdatensatzes: * Die folgenden Merkmale des Bestellelements sind nicht vorhanden: Spezifikation überprüfen \< characteristic.name\> und korrigieren Sie das Merkmal und die Merkmalsoption in der Auftragsposition, bevor Sie den Auftrag genehmigen. * Bestellelementmerkmal: \< characteristic.name\> mit Merkmalswert: \< characteristic.value\>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 oder JSON des Produktauftragspositionselements fehlt. * Ungültige Nutzlast: ProductOrderItem-ID fehlt -- Die idParameter fehlt in der Produktauftragsposition der Nutzlast. * Ungültige Nutzlast: Aktion „productOrderItem" fehlt -- Die actionParameter fehlt in der Produktauftragsposition der Nutzlast. * Ungültige Nutzlast: ProductOrderItem productOffering fehlt -- Das Produktangebotsobjekt oder JSON fehlt in der Produktauftragsposition in der Nutzlast. * Ungültige Nutzlast: ProductOffering-ID fehlt -- Die idParameter fehlt in der Produktauftragsposition des Produktangebotsobjekts in der Nutzlast. * Ungültige Nutzlast: Produktangebot ist nicht vorhanden -- Das Produktangebot in der Produktauftragsposition ist ungültig. * Ungültige Nutzlast: Produkt „productOrderItem" fehlt -- Das Produktobjekt oder JSON in der Produktauftragsposition fehlt in der Nutzlast. * Ungültige Nutzlast: Produktspezifikation fehlt -- Das Produktspezifikationsobjekt oder JSON in der Produktauftragsposition fehlt in der Nutzlast. * Ungültige Nutzlast: Produktspezifizierungs-ID fehlt -- Die idParameter in der Produktauftragsposition 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 ist nicht vorhanden -- In einem Change-Auftrag (Aktion = Change) ist die Menge eines Artikels größer als die Menge auf Lager. * Ungültige Nutzlast: Produktbestand-ID fehlt -- In einem Change-Auftrag product.idFehlt 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: Kundenaccount oder Verbraucher fehlt -- Der Kunde oder das Verbraucherobjekt der zugehörigen Partei fehlt in der Nutzlast. * Ungültige Nutzlast: Verbraucher ist nicht vorhanden -- Der angegebene Verbraucher der zugehörigen Partei ist in nicht vorhanden ServiceNowInstanz. * Ungültige Nutzlast: Kundenaccount ist nicht vorhanden -- Der angegebene Kunde der zugehörigen Partei ist in nicht vorhanden ServiceNowInstanz. * 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 Zeitplaner den zu verarbeitenden Datensatz auswählt. * Ungültige Nutzlast: Patch-Anforderung kann nicht gestellt werden, da der Erfüllungstyp des Auftrags nicht „liefern" ist. -- Die Patch-Anforderung wurde für einen Auftrag mit einem anderen Erfüllungstyp als gestellt deliver. {#tmf_prod_order-PATCH-productorder-id__ul_g2v_rzm_t4b} |
[Tabelle : 36. Statuscodes]

{#tmf_prod_order-PATCH-productorder-id__table_xfv_2vk_5rb}

### Antworttext-Parameter (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 |
|-|-|
| Kanal | Liste der Kanäle, die für den Verkauf der Produkte verwendet werden sollen. Datentyp: Array von Objekten "channel": [ { "id": "String", "name": "String" } ] |
| Kanal.ID | Eindeutiger Bezeichner des Kanals, der zum Verkauf der zugehörigen Produkte verwendet werden soll. Datentyp: Zeichenfolge |
| channel.name | Name des Kanals, der zum Verkauf der zugehörigen Produkte verwendet werden soll. Datentyp: Zeichenfolge |
| ID | SYS_ID des Kundenauftrags, der für diese Anforderung aktualisiert wurde. Datentyp: Zeichenfolge |
| externalId | Externer Bezeichner für den Kundenauftrag, z. B. eine Bestellnummer. Datentyp: Zeichenfolge |
| note | Liste der zusätzlichen Notizen, die der Kunde bei der Bestellung gemacht hat. Datentyp: Array von Objekten "note": [ { "text": "String" } ] |
| Hinweis.Text | Zusätzliche Notizen/Kommentare des Kunden während der Bestellung. Datentyp: Zeichenfolge |
| ProductOrderItem | Liste, die Elemente beschreibt, die der Produktbestellung und der zugehörigen Aktion zugeordnet sind. Datentyp: Array von Objekten "productOrderItem:" [ { "action": "String", "actionReason": "String", "id": "String", "itemPrice": [Array], "product": {Object}, "productOffering": {Object}, "productOrderItemReleationship": [Array], "quantity": Number, "state": "String", "@type": "String" } ] |
| ProductOrderElement.Aktion | Aktion, die für das Produkt ausgeführt werden soll. Mögliche Aktionen werden auf der Registerkarte „Auswahlliste" im Aktionswörterbucheintrag der sn_ind_tmt_orm_order_line_item-Tabelle definiert. Datentyp: Zeichenfolge |
| ProduktbestellungElement.actionReason | Grund für das Hinzufügen der Auftragsposition. Datentyp: Zeichenfolge Gespeichert in: Dem Feld „action_reason" der sn_ind_tmt_orm_order_line_item-Tabelle. |
| productOrderItem.id | Eindeutiger Bezeichner der Position. Befindet sich im Feld sn_ind_tmt_orm_external_id der Auftragspositionstabelle \[sn_ind_tmt_orm_order_line_item\]. Datentyp: Zeichenfolge |
| productOrderItem.itemPrice | Liste, die den Preis beschreibt, der dem Produkt zugeordnet ist. Datentyp: Array von Objekten "itemPrice": [ { "price": {Object}, "priceType": "String", "recurringChargePeriod": "String" } ] |
| productOrderItem.itemPrice.price | Beschreibung des Preises des zugehörigen Produkts. Datentyp: Objekt "price": { "taxIncludedAmount": {Object} } |
| productOrderItem.itemPrice.price.taxIncludeAmount | Beschreibung des Preises des zugehörigen Produkts, einschließlich der Steuer. Datentyp: Objekt "taxIncludedAmount": { "unit": "String", "value": Number } |
| productOrderItem.itemPrice.price.taxIncludeAmount.unit | Währungscode, in dem der Preis dargestellt wird. Datentyp: Zeichenfolge |
| productOrderItem.itemPrice.price.taxIncludeAmount.value | 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.product | Beschreibung der Instanzdetails des vom Kunden gekauften 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 Standorte, 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 Tabelle „Standort" \[cmn_location\]. Datentyp: Zeichenfolge |
| productOrderItem.product.productCharacteristic | Liste der Merkmale des zugeordneten Produkts. Datentyp: Array von Objekten "productCharacteristic": [ { "name": "String", "previousValue": "String", "value": "String" } ] |
| productOrderItem.product.productCharacteristic.name | Name des Merkmalsdatensatzes, der dem Produkt zugeordnet werden soll. Befindet sich in der Merkmalstabelle \[sn_prd_pm_characteristic\]. Datentyp: Zeichenfolge |
| productOrderItem.product.productCharacteristic.previousValue | Vorherige Merkmalsoptionswerte, wenn die Aktualisierung für einen Change-Auftrag gilt. Die Anforderung ist ein Change-Auftrag, wenn productOrderItem.actionParameter ist anders als <kbd class="ph userinput">Hinzufügen </kbd>. 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=yokohama&pubname=yokohama-order-management&ft:locale=en-US). Datentyp: Zeichenfolge |
| productOrderItem.product.productCharacteristic.value | Merkmalsoptionswerte, 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=yokohama&pubname=yokohama-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 Standards für offene TMF-API. Dieser Wert ist immer <kbd class="ph userinput">ProduktspezifikationRef </kbd>. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
| productOrderItem.product.relatedParty | Liste der Kontakte für Einzelposten. Datentyp: Array von Objekten "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 |
| productOrderItem.product.relatedParty.firstName | Vorname des Kontakts. Datentyp: Zeichenfolge |
| productOrderItem.product.relatedParty.id | SYS_ID des Positionskontakts, der der Auftragsposition zugeordnet ist. Befindet sich in der Tabelle „Auftragspositionskontakt" \[sn_ind_tmt_orm_order_line_item_contact\]. Datentyp: Zeichenfolge |
| productOrderItem.product.relatedParty.lastName | Nachname des Kontakts. Datentyp: Zeichenfolge Datentyp: Zeichenfolge |
| productOrderItem.product.relatedParty.phone | Geschäftliche Telefonnummer des Kontakts. Datentyp: Zeichenfolge |
| productOrderItem.product.relatedParty.@referredType | Typ des Kunden. Möglicher Wert: OrderLineItemContact Datentyp: Zeichenfolge |
| productOrderItem.product.relatedParty.@type | Teil des TMF Open API-Standards. Anmerkung für Auftragspositionskontakt. Dieser Wert ist immer <kbd class="ph userinput">Zugehörige Partei </kbd>. 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 <kbd class="ph userinput">Produkt </kbd>. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
| productOrderItem.productOffering | 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. Befindet sich 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 |
| productOrderItem.productOrderItemRelationship | Liste der Beziehungen zwischen Auftragspositionen. Datentyp: Array von Objekten "productOrderItemRelationship": [ { "id": "String", "relationshipType": "String" } ] |
| productOrderItem.productOrderItemRelationship.id | Eindeutiger Bezeichner der zugehörigen Position. Befindet sich im Feld sn_ind_tmt_orm_external_id der Auftragspositionstabelle \[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 |
| ProduktbestellungElement.Menge | Anzahl der zugeordneten Artikel, die bestellt werden sollen. Datentyp: Zahl |
| ProduktbestellungElement.Status | Aktueller Status des Produktbestellelements. Datentyp: Zeichenfolge |
| ProductOrderItem.@type | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer <kbd class="ph userinput">Produktbestellelement </kbd>. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
| ZugehörigPartei | Liste der Kontakte für den Auftrag. Jeder Kontakt ist ein Objekt im Array. Muss mindestens ein Element auflisten, das Kunden- oder Verbraucherkontoinformationen enthält. Datentyp: Array von Objekten "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. Befindet sich 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 |
| RelatedParty.type | Typ des Kunden. Mögliche Werte: * Verbraucher * Kunde * Kundenkontakt {#tmf_prod_order-PATCH-productorder-id__d3104e2442} Datentyp: Zeichenfolge |
| AnfordertAbschlusdatum | Vom Kunden angefordertes Lieferdatum. Datentyp: Zeichenfolge |
| AnfordertStartdatum | Auftragsstartdatum vom Kunden angefordert. Datentyp: Zeichenfolge |
| Staat | Aktueller Status des Auftrags. Datentyp: Zeichenfolge |
| @Typ | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer Produktbestellung . 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}

Das folgende Codebeispiel aktualisiert den Kanal für einen Kundenauftrag.

    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"
    }

## Offene 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. Pfad-Parameter]

{#tmf_prod_order-POST-cancelproductorder__entry__6}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 38. Abfrageparameter]

{#tmf_prod_order-POST-cancelproductorder__entry__10}

| Name | Beschreibung |
|-|-|
| AbbruchReason | Grund für Stornierung. 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. Datentyp: Zeichenfolge Tabelle: Kundenauftrag \[sn_ind_tmt_orm_order\] |
| Produktbestellung.href | URL des zu stornierenden Kundenauftrags. Datentyp: Zeichenfolge Standard: Leere Zeichenfolge |
| ProductOrder.@referredType | Der Wert für diesen Parameter muss sein `Produktbestellung `. Datentyp: Zeichenfolge Standard: Leere Zeichenfolge |
| AngefordertAbbruchdatum | Datum zum Stornieren des Auftrags. Datentyp: Zeichenfolge Standard: Leere Zeichenfolge |
| @Typ | Der Wert für diesen Parameter muss sein `Produktauftrag abbrechen `. Datentyp: Zeichenfolge Standard: Leere Zeichenfolge |
[Tabelle : 39. Anforderungstext-Parameter (JSON)]

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch 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}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Nur unterstützt application/json. |
| Inhaltstyp | Datenformat des Anforderungstexts. Nur unterstützt 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}

| Header | Beschreibung |
|-|-|
| Inhaltstyp | Datenformat des Antworttexts. Nur unterstützt application/json. |
[Tabelle : 41. Antwort-Header]

{#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 [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#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: \<field name\>. * Ungültige Auftrags-ID. * Ungültige Auftrags-ID: Dieser Auftrag muss noch in der Kundenauftragstabelle erstellt werden . Die Abbruchanforderung 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 Zeitplaner den Datensatz abholt. {#tmf_prod_order-POST-cancelproductorder__ul_lg1_5vt_5rb} |
[Tabelle : 42. Statuscodes]

### Antworttext-Parameter (JSON)

{#tmf_prod_order-POST-cancelproductorder__entry__42}

| Name | Beschreibung |
|-|-|
| AbbruchReason | Grund für Stornierung. Datentyp: Zeichenfolge |
| href | URL des stornierten Auftrags. Datentyp: Zeichenfolge |
| ID | SYS_ID des stornierten Auftrags. Datentyp: Zeichenfolge |
| Produktbestellung | Daten zur Produktbestellung. Datentyp: Objekt "productOrder": { "id": "String", "href": "String", "@referredType": "String" } |
| Produktbestellungs-ID | SYS_ID des stornierten Auftrags. Datentyp: Zeichenfolge |
| Produktbestellung.href | URL des stornierten Auftrags. Datentyp: Zeichenfolge |
| ProductOrder.@referredType | Der Wert für diesen Parameter ist `Produktbestellung `. Datentyp: Zeichenfolge |
| AngefordertAbbruchdatum | Datum zum Stornieren des Auftrags. Datentyp: Zeichenfolge |
| Staat | Status der Stornierung. Wenn die Stornierungsanforderung erfolgreich verarbeitet wurde (Statuscode 201), ist der Wert für diesen Parameter `Fertig `. Datentyp: Zeichenfolge |
| @Typ | Der Wert für diesen Parameter ist `Produktauftrag abbrechen `. 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"
    }

## Offene 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:

* Kundenauftrag \[sn_ind_tmt_orm_order\]
* Bestellmerkmal \[sn_ind_tmt_orm_order_characteristic_value\]
* Auftragspositionselement \[sn_ind_tmt_orm_order_line_item\]
* Auftragspositionselementkontakt \[sn_ind_tmt_orm_order_line_item_contact\]
* Auftragspositionselemente \[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. Pfad-Parameter]

{#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 der eingehenden Warteschlange \[sn_tmt_core_inbound_queue\] hinzugefügt. Wenn nicht enthalten, wird der Auftrag synchron verarbeitet. Gültiger 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 |
|-|-|
| Kanal | Liste der Kanäle, die für den Verkauf der Produkte verwendet werden sollen. Datentyp: Array von Objekten "channel": [ { "id": "String", "name": "String" } ] Gespeichert in: sn_ind_tmt_orm_order |
| Kanal.ID | Erforderlich. Eindeutiger Bezeichner des Kanals, der zum 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 Gespeichert in: Das Kanalfeld der sn_ind_tmt_orm_order-Tabelle. Standard: Leere Zeichenfolge |
| channel.name | Name des Kanals, der zum Verkauf der zugehörigen Produkte verwendet werden soll. Mögliche Kanalnamen werden auf der Registerkarte „Auswahlliste" im Kanalwörterbucheintrag der sn_ind_tmt_orm_order-Tabelle 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 oder nach dem übereinstimmen committedDueDateWerte für jedes Auftragspositionselement. Datentyp: Zeichenfolge Gespeichert in: Dem Feld „commit_due_date" der Tabelle „sn_ind_tmt_orm_order". |
| externalId | Eindeutiger Bezeichner für den Kundenauftrag. Dieser Wert wird von einem externen System bestimmt. Datentyp: Zeichenfolge Gespeichert in: Das Feld external_ID der sn_ind_tmt_orm_order-Tabelle. Standard: Leere Zeichenfolge |
| href | Relativer Link zum Ressourcendatensatz. Datentyp: Zeichenfolge Standard: Leere Zeichenfolge |
| note | Zusätzliche Hinweise des Kunden bei der Bestellung. Datentyp: Array von Objekten "note": [ { "text": "String" } ] Gespeichert in: sn_ind_tmt_orm_order |
| Hinweis.Text | Erforderlich. Zusätzliche Notizen/Kommentare des Kunden während der Bestellung. Datentyp: Zeichenfolge Gespeichert in: Das Kommentarfeld der sn_ind_tmt_orm_order-Tabelle. Standard: Leere Zeichenfolge |
| Auftragswährung | Erforderlich. Währungscode für den Auftrag und die Auftragspositionen. Die Währung muss für alle Elemente des Auftrags und der Auftragspositionen identisch sein, andernfalls wird ein Fehler zurückgegeben und der Auftrag nicht erstellt. Sobald ein Auftrag erstellt wurde, kann sein Währungscode nicht geändert werden. Datentyp: Zeichenfolge |
| ProductOrderItem | Erforderlich. Artikel, die der Produktbestellung und der zugehörigen Aktion zugeordnet sind. Datentyp: Array von Objekten "productOrderItem": [ { "action": "String", "actionReason": "String", "committedDueDate": "String", "externalProductInventory": [Array], "id": "String", "itemPrice": [Array], "product": {Object}, "productOffering": {Object}, "productOrderItemRelationship": [Array], "quantity": Number, "@type": "String" } ] Gespeichert in: Auftragsposition \[sn_ind_tmt_orm_order_line_item\] |
| ProductOrderElement.Aktion | Erforderlich. Aktion, die für das Produkt ausgeführt werden soll. Mögliche Aktionen werden auf der Registerkarte „Auswahlliste" im Aktionswörterbucheintrag der sn_ind_tmt_orm_order_line_item-Tabelle definiert. Mögliche Werte: * Hinzufügen * Change * löschen * Keine Änderung * Fortsetzen * Anhalten {#tmf_prod_order-POST-ord-productOrder__ul_qbd_dyp_ysb} Datentyp: Zeichenfolge Gespeichert in: Aktionsfeld der Auftragspositionstabelle \[sn_ind_tmt_orm_order_line_item\]. |
| ProduktbestellungElement.actionReason | Optional. Beschreibung des Grunds für die Auftragsposition. Datentyp: Zeichenfolge Gespeichert in: Dem Feld action_reason der Auftragspositionstabelle \[sn_ind_tmt_orm_order_line_item\]. |
| productOrderItem.committedDueDate | Datum und Uhrzeit, zu der die Aktion für die Auftragsposition ausgeführt werden muss. Datentyp: Zeichenfolge Gespeichert in: Dem Feld „commit_due_date" der Tabelle „Auftragspositionen" \[sn_ind_tmt_orm_order_line_item\]. |
| ProduktbestellungElement.externalProduktbestand | Externe IDs, die den für den Auftrag erstellten Produktbeständen zugeordnet werden sollen. Datentyp: Array von Objekten "externalProductInventory": [ { "externalProductInventoryId": "String" } ] |
| ProduktbestellungElement.externalProduktbestand.externalProduktbestellungId | Externe ID, die dem Produktbestand zugeordnet werden soll. Datentyp: Zeichenfolge Gespeichert in: Dem Feld „external_Inventory_ID" der Tabelle „Auftragspositionselement" \[sn_ind_tmt_orm_order_line_item\] und dem Feld „sn_prd_invt_external_id" der Tabelle „sn_prd_invt_product_inventory". |
| productOrderItem.id | Erforderlich. Eindeutiger Bezeichner der Position. Datentyp: Zeichenfolge Gespeichert in: Das Feld external_ID der Auftragspositionstabelle \[sn_ind_tmt_orm_order_line_item\]. Maximale Länge: 40 Standard: Leere Zeichenfolge |
| productOrderItem.itemPrice | Preis, der dem Produkt zugeordnet ist. Datentyp: Array von Objekten "itemPrice": [ { "price": {Object}, "priceType": "String", "recurringChargePeriod": "String" } ] Gespeichert in: sn_ind_tmt_orm_order Standard: Leere Zeichenfolge |
| productOrderItem.itemPrice.price | Beschreibung des Preises des zugehörigen Produkts. Datentyp: Objekt "price": { "taxIncludedAmount": {Object} } Gespeichert in: Auftragsposition \[sn_ind_tmt_orm_order_line_item\] Standard: Leere Zeichenfolge |
| productOrderItem.itemPrice.price.taxIncludedAmount | Beschreibung des Preises des zugehörigen Produkts, einschließlich der Steuer. Datentyp: Objekt "taxIncludedAmount": { "unit": "String", "value": Number } Gespeichert in: Auftragsposition \[sn_ind_tmt_orm_order_line_item\] |
| productOrderItem.itemPrice.price.taxIncludedAmount.unit | Währungscode, in dem der Preis ausgedrückt wird. Datentyp: Zeichenfolge Gespeichert in: Das mrc- oder nrc-Feld der Auftragspositionstabelle \[sn_ind_tmt_orm_order_line_item\] |
| productOrderItem.itemPrice.price.taxIncludedAmount.value | Preis des Produkts, einschließlich Steuern. Datentyp: Zahl Gespeichert in: Das mrc- oder nrc-Feld der Auftragspositionstabelle \[sn_ind_tmt_orm_order_line_item\] |
| productOrderItem.itemPrice.priceType | Gibt an, ob der Preis des Artikels wiederkehrend oder nicht wiederkehrend ist. Datentyp: Zeichenfolge |
| productOrderItem.itemPrice.recurringChargePeriod | Wenn der Preis wiederkehrend ist, der wiederkehrende Zeitraum, z. B. Monat . Datentyp: Zeichenfolge |
| productOrderItem.product | Erforderlich, wenn productOrderItem.actionIst „Change" oder „Delete". Instanzdetails des vom Kunden gekauften Produkts. Datentyp: Objekt "product": { "id": "String", "place": {Object}, "productCharacteristic": [Array], "productSpecification": {Object}, "relatedParty": {Object}, "@type": "String" } Gespeichert in: Auftragsposition \[sn_ind_tmt_orm_order_line_item\] |
| productOrderItem.product.id | Erforderlich, wenn productOrderItem.actionIst „Change" oder „Delete". Eindeutiger Bezeichner des verkauften Produkts. Datentyp: Zeichenfolge Standard: Leere Zeichenfolge Tabelle: Im Feld „sys_ID" oder „sn_ind_tmt_orm_external_id" der Tabelle „Produktbestand" \[sn_ind_tmt_orm_product_inventory\]. |
| productOrderItem.product.place | Karten der Standorte, an denen das Produkt installiert werden soll. Datentyp: Objekt "place": { "id": "String", "@type": "String" } Gespeichert in: Auftragsposition \[sn_ind_tmt_orm_order_line_item\] |
| productOrderItem.product.place.id | Erforderlich. SYS_ID des zugeordneten Standortdatensatzes. Datentyp: Zeichenfolge Tabelle: Standort \[cmn_location\] Gespeichert in: Das Standortfeld der Auftragspositionstabelle \[sn_ind_tmt_orm_order_line_item\]. |
| productOrderItem.product.place.@type | Teil des TMF Open API-Standards. Anmerkung für Auftragspositionskontakt. Dieser Wert ist immer <kbd class="ph userinput">Ort </kbd>. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
| productOrderItem.product.productCharacteristic | Merkmale des zugeordneten Produkts. Datentyp: Array von Objekten "productCharacteristic": [ { "name": "String", "previousValue": "String", "value": "String" } ] Gespeichert in: sn_ind_tmt_orm_order_characteristic_value |
| productOrderItem.product.productCharacteristic.name | Name des Merkmalsdatensatzes, der dem Produkt zugeordnet werden soll. Datentyp: Zeichenfolge Tabelle: Merkmal \[sn_prd_pm_characteristic\] Gespeichert in: Das Merkmalsfeld der sn_ind_tmt_orm_order_characteristic_value-Tabelle. Standard: Leere Zeichenfolge |
| productOrderItem.product.productCharacteristic.previousValue | Vorherige Merkmalsoptionswerte, wenn die Aktualisierung für einen Änderungsauftrag gilt. Die Anforderung ist ein Change-Auftrag, wenn productOrderItem.actionParameter ist anders als <kbd class="ph userinput">Hinzufügen </kbd>. 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=yokohama&pubname=yokohama-order-management&ft:locale=en-US). Datentyp: Zeichenfolge Gespeichert in: Das Feld „previous_characteristic_option_value" der sn_ind_tmt_orm_order_characteristic_value-Tabelle. Standard: Leere Zeichenfolge |
| productOrderItem.product.productCharacteristic.value | Merkmalsoptionswerte, 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=yokohama&pubname=yokohama-order-management&ft:locale=en-US). Datentyp: Zeichenfolge Gespeichert in: Das Feld „Merkmal_Option_value" der sn_ind_tmt_orm_order_characteristic_value-Tabelle. Standard: Leere Zeichenfolge |
| productOrderItem.product.productSpecification | Erforderlich. Beschreibung der Produktspezifikation, die dem Produkt zugeordnet ist. Hinweis: Änderungsreihenfolgen ( productOrderItem.actionIst `Ändern `) Werden basierend auf dem Wert von unterschiedlich verarbeitet sn_ind_tmt_orm.allowSpecVersionUpdateInChangeOrderSystemeigenschaft. Der Wert dieser Systemeigenschaft bestimmt, wie der Auftrag verarbeitet wird, wenn der Produktbestand eine andere Version als in der Bestellung angegeben ist. * Wenn diese Systemeigenschaft auf „wahr" festgelegt ist (Standard), wird der Produktbestand automatisch auf die Version in der Reihenfolge aktualisiert, indem die referenzierte Produktspezifikation geändert wird. Dadurch kann der Auftrag erfolgreich verarbeitet werden. * Wenn diese Systemeigenschaft auf „falsch" festgelegt ist und der Produktbestand eine andere Version als in der Bestellung angegeben hat, 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" } Gespeichert in: sn_ind_tmt_orm_order_line_item |
| productOrderItem.product.productSpecification.id | Erforderlich. Anfangsversion oder externe ID der Produktspezifikation. Die Anfangsversion ist die sys_ID der ersten Version der Spezifikation. Datentyp: Zeichenfolge Tabelle: Produktspezifikation \[sn_prd_pm_product_specification\] |
| productOrderItem.product.productSpecification.internalVersion | Version der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „Version" der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. |
| productOrderItem.product.productSpecification.name | Name der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Produktspezifikation \[sn_prd_pm_product_specification\] |
| productOrderItem.product.productSpecification.version | Externe Version der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld external_Version der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. |
| productOrderItem.product.productSpecification.@type | Teil des Standards für offene TMF-API. Dieser Wert ist immer <kbd class="ph userinput">ProduktspezifikationRef </kbd>. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
| productOrderItem.product.relatedParty | Liste der Parteirollen, die mit einem OrderLineItemContact verknüpft sind. Datentyp: Array von Objekten "relatedParty": [ { "email": "String", "firstName": "String", "lastName": "String", "phone": "String", "@referredType": "String", "@type": "String" } ] Gespeichert in: sn_ind_tmt_orm_order_line_item_contact |
| productOrderItem.product.relatedParty.email | E-Mail-Adresse des Kontakts. Datentyp: Zeichenfolge Gespeichert in: Das E-Mail-Feld der sn_ind_tmt_orm_order_line_item_contact-Tabelle. Standard: Leere Zeichenfolge |
| productOrderItem.product.relatedParty.firstName | Vorname des Kontakts. Datentyp: Zeichenfolge Gespeichert in: Das Feld „first_Name" der sn_ind_tmt_orm_order_line_item_contact-Tabelle. Standard: Leere Zeichenfolge |
| productOrderItem.product.relatedParty.lastName | Nachname des Kontakts. Datentyp: Zeichenfolge Gespeichert in: Dem Feld „lastName" der sn_ind_tmt_orm_order_line_item_contact-Tabelle. Standard: Leere Zeichenfolge |
| productOrderItem.product.relatedParty.phone | Geschäftliche Telefonnummer des Kontakts. Datentyp: Zeichenfolge Gespeichert in: Das Feld „Business_Phone" der Tabelle „sn_ind_tmt_orm_order_line_item_contact". Standard: Leere Zeichenfolge |
| productOrderItem.product.relatedParty.@referredType | Erforderlich. Typ des Kunden. Möglicher Wert: OrderLineItemContact Datentyp: Zeichenfolge |
| productOrderItem.product.relatedParty.@type | Teil des TMF Open API-Standards. Anmerkung für Auftragspositionskontakt. Dieser Wert ist immer <kbd class="ph userinput">Zugehörige Partei </kbd>. 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 <kbd class="ph userinput">Produkt </kbd>. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
| productOrderItem.productOffering | Erforderlich. Beschreibung des Produktangebots, das dem Produkt zugeordnet ist. Datentyp: Objekt "productOffering": { "id": "String", "internalVersion": "String", "name": "String", "version": "String" } Gespeichert in: sn_ind_tmt_orm_order_line_item |
| productOrderItem.productOffering.id | Erforderlich. Anfangsversion oder externe ID des Produktangebots. Die Anfangsversion ist die sys_ID der ersten Version des Angebots. Datentyp: Zeichenfolge Tabelle: Produktangebot \[sn_prd_pm_product_offering\] |
| productOrderItem.productOffering.internalVersion | Version des Produktangebots. Datentyp: Zeichenfolge Tabelle: Im Feld „Version" der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. |
| productOrderItem.productOffering.name | Name des Produktangebots. Datentyp: Zeichenfolge Tabelle: Produktangebot \[sn_prd_pm_product_offering\] |
| productOrderItem.productOffering.version | Externe Version des Produktangebots. Datentyp: Zeichenfolge Tabelle: Im Feld external_Version der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. |
| productOrderItem.productOrderItem.quantity | Anzahl der zugeordneten Artikel, die bestellt werden sollen. Datentyp: Zahl Gespeichert in: Das Mengenfeld der sn_ind_tmt_orm_order-Tabelle. Standard: Null |
| productOrderItem.productOrderItemRelationship | Erforderlich. Liste, die die übergeordnete/untergeordnete Beziehung zwischen Auftragselementen beschreibt. Datentyp: Array von Objekten "productOrderItemRelationship": [ { "id": "String", "relationshipType": "String" } ] Gespeichert in: sn_ind_tmt_orm_order_line_item |
| productOrderItem.productOrderItemRelationship.id | Erforderlich. Identisch mit productOrderItem.idWert. Wird für die übergeordnete/untergeordnete Beziehung verwendet Datentyp: Zeichenfolge Gespeichert in: Das Feld parent_line_item der sn_ind_tmt_orm_order_line_item-Tabelle. 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 * Übergeordnetes Element {#tmf_prod_order-POST-ord-productOrder__ul_rmq_vrk_5rb} Datentyp: Zeichenfolge |
| ProduktbestellungElement.Menge | Anzahl der bestellten Artikel. Datentyp: Zahl Gespeichert in: Das Mengenfeld der sn_ind_tmt_orm_order-Tabelle. Standard: Leere Zeichenfolge |
| ProductOrderItem.@type | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer <kbd class="ph userinput">Produktbestellelement </kbd>. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
| ZugehörigPartei | Liste der Kontakte für den Auftrag. Jeder Kontakt ist ein Objekt im Array. Muss mindestens ein Element auflisten, das Kunden- oder Verbraucherkontoinformationen enthält. Datentyp: Array von Objekten "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. Datentyp: Zeichenfolge Tabelle: Account \[Customer_Account\], Kontakt \[Customer_contact\]-Tabelle oder Verbraucher \[csm_Consumer\] |
| relatedParty.name | Name des Accounts, Kunden oder Verbrauchers. Datentyp: Zeichenfolge |
| RelatedParty.@referredType | Erforderlich. Typ des Kunden. Mögliche Werte: * Verbraucher * Kunde * Kundenkontakt {#tmf_prod_order-POST-ord-productOrder__ul_smq_vrk_5rb} Datentyp: Zeichenfolge |
| RelatedParty.@type | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer <kbd class="ph userinput">Zugehörige Partei </kbd>. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
| AnfordertAbschlusdatum | Vom Kunden angefordertes Lieferdatum. Datentyp: Zeichenfolge Gespeichert in: Das Feld expected_end_date der sn_ind_tmt_orm_order-Tabelle. Standard: Leere Zeichenfolge |
| AnfordertStartdatum | Auftragsstartdatum vom Kunden angefordert. Datentyp: Zeichenfolge Gespeichert in: Das Feld expected_Start_date der sn_ind_tmt_orm_order-Tabelle. Standard: Leere Zeichenfolge |
| @Typ | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer <kbd class="ph userinput">Produktbestellung </kbd>. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
[Tabelle : 45. Anforderungstext-Parameter (JSON)]

{#tmf_prod_order-POST-ord-productOrder__id_vk2_p5n_t4b}

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch 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}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Nur unterstützt application/json. |
| Inhaltstyp | Datenformat des Anforderungstexts. Nur unterstützt 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}

| Header | Beschreibung |
|-|-|
| Inhaltstyp | Datenformat des Antworttexts. Nur unterstützt application/json. |
[Tabelle : 47. Antwort-Header]

{#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 [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#tmf_prod_order-POST-ord-productOrder__entry__152}

| Statuscode | Beschreibung |
|-|-|
| 201 | Erfolgreich. Wenn Probleme mit den Informationen zu Merkmalen oder Merkmalen auftreten, speichert der Endpunkt die folgenden Kommentare in den Arbeitsnotizfeldern des zugehörigen Kundenauftragspositionselementdatensatzes: * Die folgenden Merkmale des Bestellelements sind nicht vorhanden: Spezifikation überprüfen \< characteristic.name\> und korrigieren Sie das Merkmal und die Merkmalsoption in der Auftragsposition, bevor Sie den Auftrag genehmigen. * Bestellelementmerkmal: \< characteristic.name\> mit Merkmalswert: \< characteristic.value\>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 einen Auftrag im asynchronen Modus. Das heißt, die Anforderung wurde mit gestellt modeParameter auf festgelegt `Asynchron `Und die Verarbeitung des Datensatzes in der Tabelle „eingehende Warteschlange" \[sn_tmt_core_inbound_queue\] ist 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 oder JSON des Produktauftragspositionselements fehlt. * Ungültige Nutzlast: ProductOrderItem-ID fehlt -- Die idParameter fehlt in der Produktauftragsposition der Nutzlast. * Ungültige Nutzlast: Aktion „productOrderItem" fehlt -- Die actionParameter fehlt in der Produktauftragsposition der Nutzlast. * Ungültige Nutzlast: ProductOrderItem productOffering fehlt -- Das Produktangebotsobjekt oder JSON fehlt in der Produktauftragsposition in der Nutzlast. * Ungültige Nutzlast: ProductOffering-ID fehlt -- Die idParameter fehlt in der Produktauftragsposition des Produktangebotsobjekts in der Nutzlast. * Ungültige Nutzlast: Produktangebot ist nicht vorhanden -- Das Produktangebot in der Produktauftragsposition ist ungültig. * Ungültige Nutzlast: Produkt „productOrderItem" fehlt -- Das Produktobjekt oder JSON in der Produktauftragsposition fehlt in der Nutzlast. * Ungültige Nutzlast: Produktspezifikation fehlt -- Das Produktspezifikationsobjekt oder JSON in der Produktauftragsposition fehlt in der Nutzlast. * Ungültige Nutzlast: Produktspezifizierungs-ID fehlt -- Die idParameter in der Produktauftragsposition 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 ist nicht vorhanden -- In einem Change-Auftrag (Aktion = Change) ist die Menge eines Artikels größer als die Menge auf Lager. * Ungültige Nutzlast: Produktbestand-ID fehlt -- In Änderungsreihenfolge product.idFehlt 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: Kundenaccount oder Verbraucher fehlt -- Der Kunde oder das Verbraucherobjekt der zugehörigen Partei fehlt in der Nutzlast. * Ungültige Nutzlast: Verbraucher ist nicht vorhanden -- Der angegebene Verbraucher der zugehörigen Partei ist in nicht vorhanden ServiceNowInstanz. * Ungültige Nutzlast: Kundenaccount ist nicht vorhanden -- Der angegebene Kunde der zugehörigen Partei ist in nicht vorhanden ServiceNowInstanz. * Ungültige Nutzlast: Auftragserstellung fehlgeschlagen -- Der angeforderte Auftrag kann nicht erstellt werden. * Ungültige Nutzlast: OrderCurrency ist erforderlich -- Die orderCurrencyParameter fehlt in der Nutzlast. * Inaktiver Währungscode: \<currency\> -- Die angegebene Währung ist in inaktiv ServiceNowInstanz. * Mindestens eine Position hat einen anderen Währungscode als die Auftragswährung -- Alle Einzelposten haben nicht denselben Währungscode wie die Auftragswährung. * Laufende Überarbeitung der Auftragswährung wird nicht unterstützt -- Die orderCurrencyParameter kann nicht aktualisiert werden, nachdem der Auftrag erstellt wurde. {#tmf_prod_order-POST-ord-productOrder__ul_g2v_rzm_t4b} |
[Tabelle : 48. Statuscodes]

### Antworttext-Parameter (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 |
|-|-|
| Kanal | Liste der Kanäle, die für den Verkauf der Produkte verwendet werden sollen. Datentyp: Array von Objekten "channel": [ { "id": "String", "name": "String" } ] |
| Kanal.ID | Eindeutiger Bezeichner des Kanals, der zum Verkauf der zugehörigen Produkte verwendet werden soll. Datentyp: Zeichenfolge |
| channel.name | Name des Kanals, der zum 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 oder nach dem übereinstimmen committedDueDateWerte für jedes Auftragspositionselement. Datentyp: Zeichenfolge |
| externalId | Externer Bezeichner für den Kundenauftrag, z. B. eine Bestellnummer. Datentyp: Zeichenfolge |
| href | Relativer Link zum Produktbestellungsdatensatz. Datentyp: Zeichenfolge |
| ID | SYS_ID des Kundenauftrags, der für diese Anforderung erstellt wurde. Datentyp: Zeichenfolge |
| note | Liste der zusätzlichen Notizen, die der Kunde bei der Bestellung gemacht hat. Datentyp: Array von Objekten "note": [ { "text": "String" } ] |
| Hinweis.Text | Zusätzliche Notizen/Kommentare des Kunden während der Bestellung. Datentyp: Zeichenfolge |
| Auftragswährung | Währungscode für den Auftrag und die Auftragspositionen. 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 zu verarbeitenden Zeitplan hinzugefügt. Hinweis: Dieser Wert ist das einzige Ergebnis, wenn der Auftrag asynchron mit erstellt wird modeAbfrageparameter. { "orderId": "b0fc877ac3ab5110856d73ce3640dde0" } Datentyp: Zeichenfolge |
| ProductOrderItem | Liste, die Elemente beschreibt, die der Produktbestellung und der zugehörigen Aktion zugeordnet sind. Datentyp: Array von Objekten "productOrderItem:" [ { "action": "String", "committedDueDate": "String", "externalProductInventory": [Array], "id": "String", "itemPrice": [Array], "product": {Object}, "productOffering": {Object}, "productOrderItemReleationship": [Array], "quantity": Number, "state": "String", "@type": "String" } ] |
| ProductOrderElement.Aktion | Aktion, die für das Produkt ausgeführt werden soll. Mögliche Aktionen werden auf der Registerkarte „Auswahlliste" im Aktionswörterbucheintrag der sn_ind_tmt_orm_order_line_item-Tabelle definiert. Datentyp: Zeichenfolge |
| ProduktbestellungElement.actionReason | Grund für das Hinzufügen der Auftragsposition. Datentyp: Zeichenfolge Gespeichert in: Dem Feld „action_reason" der sn_ind_tmt_orm_order_line_item-Tabelle. |
| productOrderItem.committedDueDate | Datum und Uhrzeit, zu der die Aktion für die Auftragsposition ausgeführt werden muss. Datentyp: Zeichenfolge |
| ProduktbestellungElement.externalProduktbestand | Liste der externen IDs, die den für den Auftrag erstellten Produktbeständen zugeordnet sind. Datentyp: Array von Objekten "externalProductInventory": [ { "externalProductInventoryId": "String" } ] |
| ProduktbestellungElement.externalProduktbestand.externalProduktbestellungId | Externe ID, die dem Produktbestand zugeordnet ist. Datentyp: Zeichenfolge |
| productOrderItem.id | Eindeutiger Bezeichner der Position. Befindet sich im Feld sn_ind_tmt_orm_external_id der Auftragspositionstabelle \[sn_ind_tmt_orm_order_line_item\]. Datentyp: Zeichenfolge |
| productOrderItem.itemPrice | Liste, die den Preis beschreibt, der dem Produkt zugeordnet ist. Datentyp: Array von Objekten "itemPrice": [ { "price": {Object}, "priceType": "String", "recurringChargePeriod": "String" } ] |
| productOrderItem.itemPrice.price | Beschreibung des Preises des zugehörigen Produkts. Datentyp: Objekt "price": { "taxIncludedAmount": {Object} } |
| productOrderItem.itemPrice.price.taxIncludeAmount | Beschreibung des Preises des zugehörigen Produkts, einschließlich der Steuer. Datentyp: Objekt "taxIncludedAmount": { "unit": "String", "value": Number } |
| productOrderItem.itemPrice.price.taxIncludeAmount.unit | Währungscode, in dem der Preis dargestellt wird. Datentyp: Zeichenfolge |
| productOrderItem.itemPrice.price.taxIncludeAmount.value | 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.product | Beschreibung der Instanzdetails des vom Kunden gekauften 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.actionIst <kbd class="ph userinput">Ändern </kbd>Oder <kbd class="ph userinput">Löschen </kbd>. Wenn sowohl sys_ID als auch external_ID vorhanden sind, wird die external_ID zurückgegeben. Datentyp: Zeichenfolge |
| productOrderItem.product.place | Karten der Standorte, 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 Tabelle „Standort" \[cmn_location\]. Datentyp: Zeichenfolge |
| productOrderItem.product.productCharacteristic | Liste der Merkmale des zugeordneten Produkts. Datentyp: Array von Objekten "productCharacteristic": [ { "name": "String", "previousValue": "String", "value": "String" } ] |
| productOrderItem.product.productCharacteristic.name | Name des Merkmalsdatensatzes, der dem Produkt zugeordnet werden soll. Befindet sich in der Merkmalstabelle \[sn_prd_pm_characteristic\]. Datentyp: Zeichenfolge |
| productOrderItem.product.productCharacteristic.previousValue | Vorherige Merkmalsoptionswerte, wenn die Aktualisierung für einen Change-Auftrag gilt. Die Anforderung ist ein Change-Auftrag, wenn productOrderItem.actionParameter ist anders als <kbd class="ph userinput">Hinzufügen </kbd>. 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=yokohama&pubname=yokohama-order-management&ft:locale=en-US). Datentyp: Zeichenfolge |
| productOrderItem.product.productCharacteristic.value | Merkmalsoptionswerte, 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=yokohama&pubname=yokohama-order-management&ft:locale=en-US). Datentyp: Zeichenfolge |
| productOrderItem.product.productRelationship | Liste der Produktbeziehungsdetails für eine Auftragsposition. Datentyp: Array "productRelationship": [ { "id": "String", "relationshipType": "String" } ] |
| productOrderItem.product.productRelationship.id | SYS_ID oder sn_prd_invt_external_id des Produktbestands. Datentyp: Zeichenfolge Tabelle: Feld „SYS_ID" oder „sn_prd_invt_external_id" der Tabelle „Produktbestand" \[sn_prd_invt_product_inventory\]. |
| productOrderItem.product.productRelationship.relationshipType | Typ der Beziehung zwischen der Auftragsposition und dem Produktbestand. Möglicher Wert: Erforderlich 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 die external_ID zurückgegeben. Datentyp: Zeichenfolge |
| productOrderItem.product.productSpecification.internalId | Anfangsversion der Produktspezifikation. Die Anfangsversion ist die sys_ID der ersten Version der Spezifikation. Datentyp: Zeichenfolge Tabelle: Produktspezifikation \[sn_prd_pm_product_specification\] |
| productOrderItem.product.productSpecification.internalVersion | Version der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „Version" der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. |
| productOrderItem.product.productSpecification.name | Name der Produktspezifikation. Befindet sich in der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. Datentyp: Zeichenfolge |
| productOrderItem.product.productSpecification.version | Externe Version der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld external_Version der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. |
| productOrderItem.product.productSpecification.@type | Teil des Standards für offene TMF-API. Dieser Wert ist immer <kbd class="ph userinput">ProduktspezifikationRef </kbd>. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
| productOrderItem.product.relatedParty | Liste der Kontakte für Einzelposten. Datentyp: Array von Objekten "relatedParty:" [ { "email": "String", "firstName": "String", "lastName": "String", "phone": "String", "@referredType": "String", "@type": "String" } ] |
| productOrderItem.product.relatedParty.email | E-Mail-Adresse des Kontakts. Datentyp: Zeichenfolge |
| productOrderItem.product.relatedParty.firstName | Vorname des Kontakts. Datentyp: Zeichenfolge |
| productOrderItem.product.relatedParty.lastName | Nachname des Kontakts. Datentyp: Zeichenfolge Datentyp: Zeichenfolge |
| productOrderItem.product.relatedParty.phone | Geschäftliche Telefonnummer des Kontakts. Datentyp: Zeichenfolge |
| productOrderItem.product.relatedParty.@referredType | Typ des Kunden. Möglicher Wert: OrderLineItemContact Datentyp: Zeichenfolge |
| productOrderItem.product.relatedParty.@type | Teil des TMF Open API-Standards. Anmerkung für Auftragspositionskontakt. Dieser Wert ist immer <kbd class="ph userinput">Zugehörige Partei </kbd>. 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 <kbd class="ph userinput">Produkt </kbd>. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
| productOrderItem.productOffering | 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. Befindet sich 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 die external_ID zurückgegeben. Datentyp: Zeichenfolge |
| productOrderItem.productOffering.internalId | Anfangsversion des Produktangebots. Die Anfangsversion ist die sys_ID der ersten Version des Angebots. Datentyp: Zeichenfolge Tabelle: Produktangebot \[sn_prd_pm_product_offering\] |
| productOrderItem.productOffering.internalVersion | Version des Produktangebots. Datentyp: Zeichenfolge Tabelle: Im Feld „Version" der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. |
| productOrderItem.productOffering.name | Name des Produktangebots. Befindet sich in der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge |
| productOrderItem.productOffering.version | Externe Version des Produktangebots. Datentyp: Zeichenfolge Tabelle: Im Feld external_Version der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. |
| productOrderItem.productOrderItemRelationship | Liste der Beziehungen zwischen Auftragspositionen. Datentyp: Array von Objekten "productOrderItemRelationship": [ { "id": "String", "relationshipType": "String" } ] |
| productOrderItem.productOrderItemRelationship.id | Eindeutiger Bezeichner der zugehörigen Position. Befindet sich im Feld sn_ind_tmt_orm_external_id der Auftragspositionstabelle \[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 * Übergeordnetes Element * Erfordert {#tmf_prod_order-POST-ord-productOrder__ul_yqf_2ty_54b} `HasChild `Und `Übergeordnetes Element `Werden für übergeordnete/untergeordnete Beziehungen verwendet. `Erfordert `Wird für horizontale Beziehungen verwendet (ein Einzelposten erfordert eine andere Position). Datentyp: Zeichenfolge |
| ProduktbestellungElement.Menge | Anzahl der zugeordneten Artikel, die bestellt werden sollen. Datentyp: Zahl |
| ProduktbestellungElement.Status | Aktueller Status des Produktbestellelements. Dieser Wert ist immer Neu . Datentyp: Zeichenfolge |
| ProductOrderItem.@type | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer <kbd class="ph userinput">Produktbestellelement </kbd>. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
| ZugehörigPartei | Liste der Kontakte für den Auftrag. Jeder Kontakt ist ein Objekt im Array. Muss mindestens ein Element auflisten, das Kunden- oder Verbraucherkontoinformationen enthält. Datentyp: Array von Objekten "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. Befindet sich 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 |
| RelatedParty.type | Typ des Kunden. Mögliche Werte: * Verbraucher * Kunde * Kundenkontakt {#tmf_prod_order-POST-ord-productOrder__ul_lcq_jwm_t4b} Datentyp: Zeichenfolge |
| AnfordertAbschlusdatum | Vom Kunden angefordertes Lieferdatum. Datentyp: Zeichenfolge |
| AnfordertStartdatum | Auftragsstartdatum vom Kunden angefordert. Datentyp: Zeichenfolge |
| Staat | Aktueller Status des Auftrags. Für diesen Endpunkt ist dieser Wert immer Neu . Datentyp: Zeichenfolge |
| @Typ | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer Produktbestellung . Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
[ ]

### Wird asynchron verarbeitet {#tmf_prod_order-POST-ord-productOrder__example_ynv_vhx_fwb}

Dieses Beispiel zeigt, wie verwendet wird modeAbfrageparameter zum asynchronen Erstellen einer Bestellung. 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",
              "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"
    }

### Wird synchron verarbeitet (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"
    }

## Offene API für Produktbestellung -- POST /sn_ind_tmt_orm/productorder {#ariaid-title10}

Erstellt den angegebenen Kundenauftrag und die Kundenauftragspositionen.
Wichtig:  
Beginnend mit TokyoRelease, dieser Endpunkt ist veraltet. Die neue Version dieses Endpunkts ist [Offene API für Produktbestellung -- POST /sn_ind_tmt_orm/order/productOrder](https://servicenow-prod.fluidtopics.net/sdD3L5blimu_FO2BexrA7Q#tmf_prod_order-POST-ord-productOrder "Erstellt den angegebenen Kundenauftrag und die Kundenauftragspositionen.").  
Nach der Verarbeitung werden neue Datensätze in den folgenden Tabellen erstellt:

* Kundenauftrag \[sn_ind_tmt_orm_order\]
* Bestellmerkmal \[sn_ind_tmt_orm_order_characteristic_value\]
* Auftragspositionselement \[sn_ind_tmt_orm_order_line_item\]
* Auftragspositionselementkontakt \[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. Pfad-Parameter]

{#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 |
|-|-|
| Kanal | Liste der Kanäle, die für den Verkauf der Produkte verwendet werden sollen. Datentyp: Array von Objekten "channel": [ { "id": "String", "name": "String" } ] Gespeichert in: sn_ind_tmt_orm_order |
| Kanal.ID | Erforderlich. Eindeutiger Bezeichner des Kanals, der zum 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 Gespeichert in: Das Kanalfeld der sn_ind_tmt_orm_order-Tabelle. Standard: Leere Zeichenfolge |
| channel.name | Name des Kanals, der zum Verkauf der zugehörigen Produkte verwendet werden soll. Mögliche Kanalnamen werden auf der Registerkarte „Auswahlliste" im Kanalwörterbucheintrag der sn_ind_tmt_orm_order-Tabelle 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 oder nach dem übereinstimmen committedDueDateWerte für jedes Auftragspositionselement. Datentyp: Zeichenfolge Gespeichert in: Dem Feld „commit_due_date" der Tabelle „sn_ind_tmt_orm_order". |
| externalId | Eindeutiger Bezeichner für den Kundenauftrag. Dieser Wert wird von einem externen System bestimmt. Datentyp: Zeichenfolge Gespeichert in: Das Feld external_ID der sn_ind_tmt_orm_order-Tabelle. Standard: Leere Zeichenfolge |
| href | Relativer Link zum Ressourcendatensatz. Datentyp: Zeichenfolge Standard: Leere Zeichenfolge |
| note | Zusätzliche Hinweise des Kunden bei der Bestellung. Datentyp: Array von Objekten "note": [ { "text": "String" } ] Gespeichert in: sn_ind_tmt_orm_order |
| Hinweis.Text | Erforderlich. Zusätzliche Notizen/Kommentare des Kunden während der Bestellung. Datentyp: Zeichenfolge Gespeichert in: Das Kommentarfeld der sn_ind_tmt_orm_order-Tabelle. Standard: Leere Zeichenfolge |
| Auftragswährung | Erforderlich. Währungscode für den Auftrag und die Auftragspositionen. Die Währung muss für alle Elemente des Auftrags und der Auftragspositionen identisch sein, andernfalls wird ein Fehler zurückgegeben und der Auftrag nicht erstellt. Sobald ein Auftrag erstellt wurde, kann sein Währungscode nicht geändert werden. Datentyp: Zeichenfolge |
| ProductOrderItem | Erforderlich. Artikel, die der Produktbestellung und der zugehörigen Aktion zugeordnet sind. Datentyp: Array von Objekten "productOrderItem": [ { "action": "String", "actionReason": "String", "committedDueDate": "String", "externalProductInventory": [Array], "id": "String", "itemPrice": [Array], "product": {Object}, "productOffering": {Object}, "productOrderItemRelationship": [Array], "quantity": Number, "@type": "String" } ] Gespeichert in: Auftragsposition \[sn_ind_tmt_orm_order_line_item\] |
| ProductOrderElement.Aktion | Erforderlich. Aktion, die für das Produkt ausgeführt werden soll. Mögliche Aktionen werden auf der Registerkarte „Auswahlliste" im Aktionswörterbucheintrag der sn_ind_tmt_orm_order_line_item-Tabelle definiert. Mögliche Werte: * Hinzufügen * Change * löschen * Keine Änderung * Fortsetzen * Anhalten {#tmf_prod_order-POST-productOrder__ul_qbd_dyp_ysb} Datentyp: Zeichenfolge Gespeichert in: Aktionsfeld der Auftragspositionstabelle \[sn_ind_tmt_orm_order_line_item\]. |
| ProduktbestellungElement.actionReason | Optional. Beschreibung des Grunds für die Auftragsposition. Datentyp: Zeichenfolge Gespeichert in: Dem Feld action_reason der Auftragspositionstabelle \[sn_ind_tmt_orm_order_line_item\]. |
| productOrderItem.committedDueDate | Datum und Uhrzeit, zu der die Aktion für die Auftragsposition ausgeführt werden muss. Datentyp: Zeichenfolge Gespeichert in: Dem Feld „commit_due_date" der Tabelle „Auftragspositionen" \[sn_ind_tmt_orm_order_line_item\]. |
| ProduktbestellungElement.externalProduktbestand | Externe IDs, die den für den Auftrag erstellten Produktbeständen zugeordnet werden sollen. Datentyp: Array von Objekten "externalProductInventory": [ { "externalProductInventoryId": "String" } ] |
| ProduktbestellungElement.externalProduktbestand.externalProduktbestellungId | Externe ID, die dem Produktbestand zugeordnet werden soll. Datentyp: Zeichenfolge Gespeichert in: Dem Feld „external_Inventory_ID" der Tabelle „Auftragspositionselement" \[sn_ind_tmt_orm_order_line_item\] und dem Feld „sn_prd_invt_external_id" der Tabelle „sn_prd_invt_product_inventory". |
| productOrderItem.id | Erforderlich. Eindeutiger Bezeichner der Position. Datentyp: Zeichenfolge Gespeichert in: Das Feld external_ID der Auftragspositionstabelle \[sn_ind_tmt_orm_order_line_item\]. Maximale Länge: 40 Standard: Leere Zeichenfolge |
| productOrderItem.itemPrice | Preis, der dem Produkt zugeordnet ist. Datentyp: Array von Objekten "itemPrice": [ { "price": {Object}, "priceType": "String", "recurringChargePeriod": "String" } ] Gespeichert in: sn_ind_tmt_orm_order Standard: Leere Zeichenfolge |
| productOrderItem.itemPrice.price | Beschreibung des Preises des zugehörigen Produkts. Datentyp: Objekt "price": { "taxIncludedAmount": {Object} } Gespeichert in: Auftragsposition \[sn_ind_tmt_orm_order_line_item\] Standard: Leere Zeichenfolge |
| productOrderItem.itemPrice.price.taxIncludedAmount | Beschreibung des Preises des zugehörigen Produkts, einschließlich der Steuer. Datentyp: Objekt "taxIncludedAmount": { "unit": "String", "value": Number } Gespeichert in: Auftragsposition \[sn_ind_tmt_orm_order_line_item\] |
| productOrderItem.itemPrice.price.taxIncludedAmount.unit | Währungscode, in dem der Preis ausgedrückt wird. Datentyp: Zeichenfolge Gespeichert in: Das mrc- oder nrc-Feld der Auftragspositionstabelle \[sn_ind_tmt_orm_order_line_item\] |
| productOrderItem.itemPrice.price.taxIncludedAmount.value | Preis des Produkts, einschließlich Steuern. Datentyp: Zahl Gespeichert in: Das mrc- oder nrc-Feld der Auftragspositionstabelle \[sn_ind_tmt_orm_order_line_item\] |
| productOrderItem.itemPrice.priceType | Gibt an, ob der Preis des Artikels wiederkehrend oder nicht wiederkehrend ist. Datentyp: Zeichenfolge |
| productOrderItem.itemPrice.recurringChargePeriod | Wenn der Preis wiederkehrend ist, der wiederkehrende Zeitraum, z. B. Monat . Datentyp: Zeichenfolge |
| productOrderItem.product | Erforderlich, wenn productOrderItem.actionIst „Change" oder „Delete". Instanzdetails des vom Kunden gekauften Produkts. Datentyp: Objekt "product": { "id": "String", "place": {Object}, "productCharacteristic": [Array], "productSpecification": {Object}, "relatedParty": {Object}, "@type": "String" } Gespeichert in: Auftragsposition \[sn_ind_tmt_orm_order_line_item\] |
| productOrderItem.product.id | Erforderlich, wenn productOrderItem.actionIst „Change" oder „Delete". Eindeutiger Bezeichner des verkauften Produkts. Datentyp: Zeichenfolge Standard: Leere Zeichenfolge Tabelle: Im Feld „sys_ID" oder „sn_ind_tmt_orm_external_id" der Tabelle „Produktbestand" \[sn_ind_tmt_orm_product_inventory\]. |
| productOrderItem.product.place | Karten der Standorte, an denen das Produkt installiert werden soll. Datentyp: Objekt "place": { "id": "String", "@type": "String" } Gespeichert in: Auftragsposition \[sn_ind_tmt_orm_order_line_item\] |
| productOrderItem.product.place.id | Erforderlich. SYS_ID des zugeordneten Standortdatensatzes. Datentyp: Zeichenfolge Tabelle: Standort \[cmn_location\] Gespeichert in: Das Standortfeld der Auftragspositionstabelle \[sn_ind_tmt_orm_order_line_item\]. |
| productOrderItem.product.place.@type | Teil des TMF Open API-Standards. Anmerkung für Auftragspositionskontakt. Dieser Wert ist immer <kbd class="ph userinput">Ort </kbd>. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
| productOrderItem.product.productCharacteristic | Merkmale des zugeordneten Produkts. Datentyp: Array von Objekten "productCharacteristic": [ { "name": "String", "previousValue": "String", "value": "String" } ] Gespeichert in: sn_ind_tmt_orm_order_characteristic_value |
| productOrderItem.product.productCharacteristic.name | Name des Merkmalsdatensatzes, der dem Produkt zugeordnet werden soll. Datentyp: Zeichenfolge Tabelle: Merkmal \[sn_prd_pm_characteristic\] Gespeichert in: Das Merkmalsfeld der sn_ind_tmt_orm_order_characteristic_value-Tabelle. Standard: Leere Zeichenfolge |
| productOrderItem.product.productCharacteristic.previousValue | Vorherige Merkmalsoptionswerte, wenn die Aktualisierung für einen Änderungsauftrag gilt. Die Anforderung ist ein Change-Auftrag, wenn productOrderItem.actionParameter ist anders als <kbd class="ph userinput">Hinzufügen </kbd>. 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=yokohama&pubname=yokohama-order-management&ft:locale=en-US). Datentyp: Zeichenfolge Gespeichert in: Das Feld „previous_characteristic_option_value" der sn_ind_tmt_orm_order_characteristic_value-Tabelle. Standard: Leere Zeichenfolge |
| productOrderItem.product.productCharacteristic.value | Merkmalsoptionswerte, 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=yokohama&pubname=yokohama-order-management&ft:locale=en-US). Datentyp: Zeichenfolge Gespeichert in: Das Feld „Merkmal_Option_value" der sn_ind_tmt_orm_order_characteristic_value-Tabelle. Standard: Leere Zeichenfolge |
| productOrderItem.product.productSpecification | Erforderlich. Beschreibung der Produktspezifikation, die dem Produkt zugeordnet ist. Hinweis: Änderungsreihenfolgen ( productOrderItem.actionIst `Ändern `) Werden basierend auf dem Wert von unterschiedlich verarbeitet sn_ind_tmt_orm.allowSpecVersionUpdateInChangeOrderSystemeigenschaft. Der Wert dieser Systemeigenschaft bestimmt, wie der Auftrag verarbeitet wird, wenn der Produktbestand eine andere Version als in der Bestellung angegeben ist. * Wenn diese Systemeigenschaft auf „wahr" festgelegt ist (Standard), wird der Produktbestand automatisch auf die Version in der Reihenfolge aktualisiert, indem die referenzierte Produktspezifikation geändert wird. Dadurch kann der Auftrag erfolgreich verarbeitet werden. * Wenn diese Systemeigenschaft auf „falsch" festgelegt ist und der Produktbestand eine andere Version als in der Bestellung angegeben hat, 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" } Gespeichert in: sn_ind_tmt_orm_order_line_item |
| productOrderItem.product.productSpecification.id | Erforderlich. Anfangsversion oder externe ID der Produktspezifikation. Die Anfangsversion ist die sys_ID der ersten Version der Spezifikation. Datentyp: Zeichenfolge Tabelle: Produktspezifikation \[sn_prd_pm_product_specification\] |
| productOrderItem.product.productSpecification.internalVersion | Version der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „Version" der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. |
| productOrderItem.product.productSpecification.name | Name der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Produktspezifikation \[sn_prd_pm_product_specification\] |
| productOrderItem.product.productSpecification.version | Externe Version der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld external_Version der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. |
| productOrderItem.product.productSpecification.@type | Teil des Standards für offene TMF-API. Dieser Wert ist immer <kbd class="ph userinput">ProduktspezifikationRef </kbd>. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
| productOrderItem.product.relatedParty | Liste der Parteirollen, die mit einem OrderLineItemContact verknüpft sind. Datentyp: Array von Objekten "relatedParty": [ { "email": "String", "firstName": "String", "lastName": "String", "phone": "String", "@referredType": "String", "@type": "String" } ] Gespeichert in: sn_ind_tmt_orm_order_line_item_contact |
| productOrderItem.product.relatedParty.email | E-Mail-Adresse des Kontakts. Datentyp: Zeichenfolge Gespeichert in: Das E-Mail-Feld der sn_ind_tmt_orm_order_line_item_contact-Tabelle. Standard: Leere Zeichenfolge |
| productOrderItem.product.relatedParty.firstName | Vorname des Kontakts. Datentyp: Zeichenfolge Gespeichert in: Das Feld „first_Name" der sn_ind_tmt_orm_order_line_item_contact-Tabelle. Standard: Leere Zeichenfolge |
| productOrderItem.product.relatedParty.lastName | Nachname des Kontakts. Datentyp: Zeichenfolge Gespeichert in: Dem Feld „lastName" der sn_ind_tmt_orm_order_line_item_contact-Tabelle. Standard: Leere Zeichenfolge |
| productOrderItem.product.relatedParty.phone | Geschäftliche Telefonnummer des Kontakts. Datentyp: Zeichenfolge Gespeichert in: Das Feld „Business_Phone" der Tabelle „sn_ind_tmt_orm_order_line_item_contact". Standard: Leere Zeichenfolge |
| productOrderItem.product.relatedParty.@referredType | Erforderlich. Typ des Kunden. Möglicher Wert: OrderLineItemContact Datentyp: Zeichenfolge |
| productOrderItem.product.relatedParty.@type | Teil des TMF Open API-Standards. Anmerkung für Auftragspositionskontakt. Dieser Wert ist immer <kbd class="ph userinput">Zugehörige Partei </kbd>. 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 <kbd class="ph userinput">Produkt </kbd>. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
| productOrderItem.productOffering | Erforderlich. Beschreibung des Produktangebots, das dem Produkt zugeordnet ist. Datentyp: Objekt "productOffering": { "id": "String", "internalVersion": "String", "name": "String", "version": "String" } Gespeichert in: sn_ind_tmt_orm_order_line_item |
| productOrderItem.productOffering.id | Erforderlich. Anfangsversion oder externe ID des Produktangebots. Die Anfangsversion ist die sys_ID der ersten Version des Angebots. Datentyp: Zeichenfolge Tabelle: Produktangebot \[sn_prd_pm_product_offering\] |
| productOrderItem.productOffering.internalVersion | Version des Produktangebots. Datentyp: Zeichenfolge Tabelle: Im Feld „Version" der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. |
| productOrderItem.productOffering.name | Name des Produktangebots. Datentyp: Zeichenfolge Tabelle: Produktangebot \[sn_prd_pm_product_offering\] |
| productOrderItem.productOffering.version | Externe Version des Produktangebots. Datentyp: Zeichenfolge Tabelle: Im Feld external_Version der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. |
| productOrderItem.productOrderItem.quantity | Anzahl der zugeordneten Artikel, die bestellt werden sollen. Datentyp: Zahl Gespeichert in: Das Mengenfeld der sn_ind_tmt_orm_order-Tabelle. Standard: Null |
| productOrderItem.productOrderItemRelationship | Erforderlich. Liste, die die übergeordnete/untergeordnete Beziehung zwischen Auftragselementen beschreibt. Datentyp: Array von Objekten "productOrderItemRelationship": [ { "id": "String", "relationshipType": "String" } ] Gespeichert in: sn_ind_tmt_orm_order_line_item |
| productOrderItem.productOrderItemRelationship.id | Erforderlich. Identisch mit productOrderItem.idWert. Wird für die übergeordnete/untergeordnete Beziehung verwendet Datentyp: Zeichenfolge Gespeichert in: Das Feld parent_line_item der sn_ind_tmt_orm_order_line_item-Tabelle. 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 * Übergeordnetes Element {#tmf_prod_order-POST-productOrder__ul_rmq_vrk_5rb} Datentyp: Zeichenfolge |
| ProduktbestellungElement.Menge | Anzahl der bestellten Artikel. Datentyp: Zahl Gespeichert in: Das Mengenfeld der sn_ind_tmt_orm_order-Tabelle. Standard: Leere Zeichenfolge |
| ProductOrderItem.@type | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer <kbd class="ph userinput">Produktbestellelement </kbd>. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
| ZugehörigPartei | Liste der Kontakte für den Auftrag. Jeder Kontakt ist ein Objekt im Array. Muss mindestens ein Element auflisten, das Kunden- oder Verbraucherkontoinformationen enthält. Datentyp: Array von Objekten "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. Datentyp: Zeichenfolge Tabelle: Account \[Customer_Account\], Kontakt \[Customer_contact\]-Tabelle oder Verbraucher \[csm_Consumer\] |
| relatedParty.name | Name des Accounts, Kunden oder Verbrauchers. Datentyp: Zeichenfolge |
| RelatedParty.@referredType | Erforderlich. Typ des Kunden. Mögliche Werte: * Verbraucher * Kunde * Kundenkontakt {#tmf_prod_order-POST-productOrder__ul_smq_vrk_5rb} Datentyp: Zeichenfolge |
| RelatedParty.@type | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer <kbd class="ph userinput">Zugehörige Partei </kbd>. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
| AnfordertAbschlusdatum | Vom Kunden angefordertes Lieferdatum. Datentyp: Zeichenfolge Gespeichert in: Das Feld expected_end_date der sn_ind_tmt_orm_order-Tabelle. Standard: Leere Zeichenfolge |
| AnfordertStartdatum | Auftragsstartdatum vom Kunden angefordert. Datentyp: Zeichenfolge Gespeichert in: Das Feld expected_Start_date der sn_ind_tmt_orm_order-Tabelle. Standard: Leere Zeichenfolge |
| @Typ | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer <kbd class="ph userinput">Produktbestellung </kbd>. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
[Tabelle : 51. Anforderungstext-Parameter (JSON)]

{#tmf_prod_order-POST-productOrder__id_vk2_p5n_t4b}

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch 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}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Nur unterstützt application/json. |
| Inhaltstyp | Datenformat des Anforderungstexts. Nur unterstützt 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}

| Header | Beschreibung |
|-|-|
| Inhaltstyp | Datenformat des Antworttexts. Nur unterstützt application/json. |
[Tabelle : 53. Antwort-Header]

{#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 [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#tmf_prod_order-POST-productOrder__entry__152}

| Statuscode | Beschreibung |
|-|-|
| 201 | Erfolgreich. Wenn Probleme mit den Informationen zu Merkmalen oder Merkmalen auftreten, speichert der Endpunkt die folgenden Kommentare in den Arbeitsnotizfeldern des zugehörigen Kundenauftragspositionselementdatensatzes: * Die folgenden Merkmale des Bestellelements sind nicht vorhanden: Spezifikation überprüfen \< characteristic.name\> und korrigieren Sie das Merkmal und die Merkmalsoption in der Auftragsposition, bevor Sie den Auftrag genehmigen. * Bestellelementmerkmal: \< characteristic.name\> mit Merkmalswert: \< characteristic.value\>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 oder JSON des Produktauftragspositionselements fehlt. * Ungültige Nutzlast: ProductOrderItem-ID fehlt -- Die idParameter fehlt in der Produktauftragsposition der Nutzlast. * Ungültige Nutzlast: Aktion „productOrderItem" fehlt -- Die actionParameter fehlt in der Produktauftragsposition der Nutzlast. * Ungültige Nutzlast: ProductOrderItem productOffering fehlt -- Das Produktangebotsobjekt oder JSON fehlt in der Produktauftragsposition in der Nutzlast. * Ungültige Nutzlast: ProductOffering-ID fehlt -- Die idParameter fehlt in der Produktauftragsposition des Produktangebotsobjekts in der Nutzlast. * Ungültige Nutzlast: Produktangebot ist nicht vorhanden -- Das Produktangebot in der Produktauftragsposition ist ungültig. * Ungültige Nutzlast: Produkt „productOrderItem" fehlt -- Das Produktobjekt oder JSON in der Produktauftragsposition fehlt in der Nutzlast. * Ungültige Nutzlast: Produktspezifikation fehlt -- Das Produktspezifikationsobjekt oder JSON in der Produktauftragsposition fehlt in der Nutzlast. * Ungültige Nutzlast: Produktspezifizierungs-ID fehlt -- Die idParameter in der Produktauftragsposition 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 ist nicht vorhanden -- In einem Change-Auftrag (Aktion = Change) ist die Menge eines Artikels größer als die Menge auf Lager. * Ungültige Nutzlast: Produktbestand-ID fehlt -- In Änderungsreihenfolge product.idFehlt 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: Kundenaccount oder Verbraucher fehlt -- Der Kunde oder das Verbraucherobjekt der zugehörigen Partei fehlt in der Nutzlast. * Ungültige Nutzlast: Verbraucher ist nicht vorhanden -- Der angegebene Verbraucher der zugehörigen Partei ist in nicht vorhanden ServiceNowInstanz. * Ungültige Nutzlast: Kundenaccount ist nicht vorhanden -- Der angegebene Kunde der zugehörigen Partei ist in nicht vorhanden ServiceNowInstanz. * Ungültige Nutzlast: Auftragserstellung fehlgeschlagen -- Der angeforderte Auftrag kann nicht erstellt werden. {#tmf_prod_order-POST-productOrder__ul_g2v_rzm_t4b} |
[Tabelle : 54. Statuscodes]

### Antworttext-Parameter (JSON)

{#tmf_prod_order-POST-productOrder__entry__158}

| Name | Beschreibung |
|-|-|
| Kanal | Liste der Kanäle, die für den Verkauf der Produkte verwendet werden sollen. Datentyp: Array von Objekten "channel": [ { "id": "String", "name": "String" } ] |
| Kanal.ID | Eindeutiger Bezeichner des Kanals, der zum Verkauf der zugehörigen Produkte verwendet werden soll. Datentyp: Zeichenfolge |
| channel.name | Name des Kanals, der zum 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 |
| note | Liste der zusätzlichen Notizen, die der Kunde bei der Bestellung gemacht hat. Datentyp: Array von Objekten "note": [ { "text": "String" } ] |
| Hinweis.Text | Zusätzliche Notizen/Kommentare des Kunden während der Bestellung. Datentyp: Zeichenfolge |
| ProductOrderItem | Liste, die Elemente beschreibt, die der Produktbestellung und der zugehörigen Aktion zugeordnet sind. Datentyp: Array von Objekten "productOrderItem:" [ { "action": "String", "id": "String", "itemPrice": [Array], "product": {Object}, "productOffering": {Object}, "productOrderItemReleationship": [Array], "quantity": Number, "state": "String", "@type": "String" } ] |
| ProductOrderElement.Aktion | Aktion, die für das Produkt ausgeführt werden soll. Mögliche Aktionen werden auf der Registerkarte „Auswahlliste" im Aktionswörterbucheintrag der sn_ind_tmt_orm_order_line_item-Tabelle definiert. Datentyp: Zeichenfolge |
| ProductOderItem.actionReason | Grund für das Hinzufügen der Auftragsposition. Datentyp: Zeichenfolge Gespeichert in: Dem Feld „action_reason" der sn_ind_tmt_orm_order_line_item-Tabelle. |
| productOrderItem.id | Eindeutiger Bezeichner der Position. Befindet sich im Feld sn_ind_tmt_orm_external_id der Auftragspositionstabelle \[sn_ind_tmt_orm_order_line_item\]. Datentyp: Zeichenfolge |
| productOrderItem.itemPrice | Liste, die den Preis beschreibt, der dem Produkt zugeordnet ist. Datentyp: Array von Objekten "itemPrice": [ { "price": {Object}, "priceType": "String", "recurringChargePeriod": "String" } ] |
| productOrderItem.itemPrice.price | Beschreibung des Preises des zugehörigen Produkts. Datentyp: Objekt "price": { "taxIncludedAmount": {Object} } |
| productOrderItem.itemPrice.price.taxIncludeAmount | Beschreibung des Preises des zugehörigen Produkts, einschließlich der Steuer. Datentyp: Objekt "taxIncludedAmount": { "unit": "String", "value": Number } |
| productOrderItem.itemPrice.price.taxIncludeAmount.unit | Währungscode, in dem der Preis dargestellt wird. Datentyp: Zeichenfolge |
| productOrderItem.itemPrice.price.taxIncludeAmount.value | 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.product | Beschreibung der Instanzdetails des vom Kunden gekauften 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.actionIst <kbd class="ph userinput">Ändern </kbd>Oder <kbd class="ph userinput">Löschen </kbd>. Wenn sowohl sys_ID als auch external_ID vorhanden sind, wird die external_ID zurückgegeben. Datentyp: Zeichenfolge |
| productOrderItem.product.place | Karten der Standorte, 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 Tabelle „Standort" \[cmn_location\]. Datentyp: Zeichenfolge |
| productOrderItem.product.productCharacteristic | Liste der Merkmale des zugeordneten Produkts. Datentyp: Array von Objekten "productCharacteristic": [ { "name": "String", "previousValue": "String", "value": "String" } ] |
| productOrderItem.product.productCharacteristic.name | Name des Merkmalsdatensatzes, der dem Produkt zugeordnet werden soll. Befindet sich in der Merkmalstabelle \[sn_prd_pm_characteristic\]. Datentyp: Zeichenfolge |
| productOrderItem.product.productCharacteristic.previousValue | Vorherige Merkmalsoptionswerte, wenn die Aktualisierung für einen Change-Auftrag gilt. Die Anforderung ist ein Change-Auftrag, wenn productOrderItem.actionParameter ist anders als <kbd class="ph userinput">Hinzufügen </kbd>. 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=yokohama&pubname=yokohama-order-management&ft:locale=en-US). Datentyp: Zeichenfolge |
| productOrderItem.product.productCharacteristic.value | Merkmalsoptionswerte, 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=yokohama&pubname=yokohama-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 die 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 Standards für offene TMF-API. Dieser Wert ist immer <kbd class="ph userinput">ProduktspezifikationRef </kbd>. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
| productOrderItem.product.relatedParty | Liste der Kontakte für Einzelposten. Datentyp: Array von Objekten "relatedParty:" [ { "email": "String", "firstName": "String", "lastName": "String", "phone": "String", "@referredType": "String", "@type": "String" } ] |
| productOrderItem.product.relatedParty.email | E-Mail-Adresse des Kontakts. Datentyp: Zeichenfolge |
| productOrderItem.product.relatedParty.firstName | Vorname des Kontakts. Datentyp: Zeichenfolge |
| productOrderItem.product.relatedParty.lastName | Nachname des Kontakts. Datentyp: Zeichenfolge Datentyp: Zeichenfolge |
| productOrderItem.product.relatedParty.phone | Geschäftliche Telefonnummer des Kontakts. Datentyp: Zeichenfolge |
| productOrderItem.product.relatedParty.@referredType | Typ des Kunden. Möglicher Wert: OrderLineItemContact Datentyp: Zeichenfolge |
| productOrderItem.product.relatedParty.@type | Teil des TMF Open API-Standards. Anmerkung für Auftragspositionskontakt. Dieser Wert ist immer <kbd class="ph userinput">Zugehörige Partei </kbd>. 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 <kbd class="ph userinput">Produkt </kbd>. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
| productOrderItem.productOffering | 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. Befindet sich 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 die 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 |
| productOrderItem.productOrderItemRelationship | Liste der Beziehungen zwischen Auftragspositionen. Datentyp: Array von Objekten "productOrderItemRelationship": [ { "id": "String", "relationshipType": "String" } ] |
| productOrderItem.productOrderItemRelationship.id | Eindeutiger Bezeichner der zugehörigen Position. Befindet sich im Feld sn_ind_tmt_orm_external_id der Auftragspositionstabelle \[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 |
| ProduktbestellungElement.Menge | Anzahl der zugeordneten Artikel, die bestellt werden sollen. Datentyp: Zahl |
| ProduktbestellungElement.Status | Aktueller Status des Produktbestellelements. Dieser Wert ist immer Neu . Datentyp: Zeichenfolge |
| ProductOrderItem.@type | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer <kbd class="ph userinput">Produktbestellelement </kbd>. Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
| ZugehörigPartei | Liste der Kontakte für den Auftrag. Jeder Kontakt ist ein Objekt im Array. Muss mindestens ein Element auflisten, das Kunden- oder Verbraucherkontoinformationen enthält. Datentyp: Array von Objekten "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. Befindet sich 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 |
| RelatedParty.type | Typ des Kunden. Mögliche Werte: * Verbraucher * Kunde * Kundenkontakt {#tmf_prod_order-POST-productOrder__ul_lcq_jwm_t4b} Datentyp: Zeichenfolge |
| AnfordertAbschlusdatum | Vom Kunden angefordertes Lieferdatum. Datentyp: Zeichenfolge |
| AnfordertStartdatum | Auftragsstartdatum vom Kunden angefordert. Datentyp: Zeichenfolge |
| Staat | Aktueller Status des Auftrags. Für diesen Endpunkt ist dieser Wert immer Neu . Datentyp: Zeichenfolge |
| @Typ | Teil des TMF Open API-Standards. Anmerkung für das Produkt. Dieser Wert ist immer Produktbestellung . Diese Informationen werden nicht gespeichert. Datentyp: Zeichenfolge |
[ ]

### Curl-Anforderung

Das folgende Codebeispiel erstellt einen Kundenauftrag.

    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"
    }


