--- title: "Service CreatePurchase" slug: "service-createpurchase" updated: 2026-07-01T14:36:52Z published: 2026-07-01T14:36:52Z canonical: "kb.moveit.at/service-createpurchase" --- > ## Documentation Index > Fetch the complete documentation index at: https://kb.moveit.at/llms.txt > Use this file to discover all available pages before exploring further. # Service CreatePurchase | ISS+ | EASY | | --- | --- | | **Vollständig** | **Nicht** | > [!CAUTION] > **Wichtiger Hinweis** Diese Schnittstelle ist standardisiert und kann jederzeit um zusätzliche Felder erweitert werden. Neue Felder werden stets am Ende der bestehenden Struktur hinzugefügt, um die Kompatibilität zu gewährleisten. Der Service **CreatePurchase** ermöglicht es, einen in **moveIT ISS+** bereits auf **Fertig** gesetzten Beleg aus einem angebundenen **Fremdsystem** (z. B. einem ERP-System) zu bestellen. Die Bestellung kann entweder für den **gesamten Beleg** oder nur für **einzelne Positionen** erfolgen. Die für die Bestellung erforderlichen Daten werden dabei im **JSON-Format** übergeben. ## Typ HTTP POST ## ServiceData ```json {    "Service": "CreatePurchase",    "OrgCde": "H01",    "Language": "DE",    "ServiceData": {        "Document": {            "Type": 2,            "SearchType": 1,            "SearchValue": 20190003,            "ERPNumber": "ERPNumber",            "PurchaseERPNumber": "PurchaseERPNumber"        },        "Supplier": [            {                "SearchType": 1,                "SearchValue": "4711",                "PurchaseERPNumber": "PurchaseERPNumber"            }        ],        "Position": [            {                "SearchType": 1,                "SearchValue": "3",                "PurchasePositionERPNumber": "PurchasePositionERPNumber1"            },            {                "SearchType": 1,                "SearchValue": "5",                "PurchasePositionERPNumber": "PurchasePositionERPNumber2"            }        ]    } } ``` ## Header Der Header enthält die allgemeinen Informationen für den Aufruf des Services. - **Service** – Muss den festen Wert **CreatePurchase** enthalten. - **OrgCde** (Organisation/Marktnummer) – Optional. - **Language** – Optional. ## Document Der Abschnitt **Document** enthält die Informationen zur Identifizierung des Belegs sowie zur Erstellung der Anfrage bzw. Bestellung. ### Type Legt fest, für welchen Belegtyp der Service ausgeführt wird: - **1** – Angebot. Aus dem Angebot werden **Anfragen** erstellt. - **2** – Auftrag. Aus dem Auftrag werden **Bestellungen** erstellt. ### SearchType Legt fest, anhand welcher Information der Beleg gesucht wird: - **1** – Suche über **DocNum** (sichtbare Belegnummer). Diese Variante ist nur geeignet, wenn die Nummernkreise der Geschäftsperioden keine doppelten Belegnummern zulassen. - **2** – Suche über **DocNbr** (interne Belegnummer). - **3** – Suche über die **GUID** des Belegs. Es wird empfohlen, **SearchType 2 oder 3** zu verwenden, da diese Belegkennungen eindeutig sind. ### SearchValue Enthält den Suchwert entsprechend dem gewählten **SearchType**. Beispielsweise die **Belegnummer (DocNum)**, die **interne Belegnummer (DocNbr)** oder die **GUID** des Belegs. ### ERPNumber Optional. Die angegebene Nummer wird im Beleg als **externe Angebots- bzw. Auftragsnummer** gespeichert. **PurchaseERPNumber** Optional. Dieses Feld ist **derzeit noch nicht implementiert**. Es ist für die Übergabe einer **externen Bestellnummer** der aus den angegebenen Positionen erzeugten Bestellungen vorgesehen. ## Supplier Es können hier mehrere Liefearnten eines Auftrages übergeben werden. ### SearchType - 1 .. Suche per ILN/GLN - 2 .. Guid des Lieferanten - 3 .. interne Adressnummer des Lieferanten - 4 .. Adressnummer des Lieferanten ### SearchValue Suchwert entsprechend dem SearchType ### PurchaseERPNumber Bestellnummer, optional, wird bei der erzeugten Bestellung für den Lieferanten als externe Bestellnummer hinterlegt ## Position Im Abschnitt **Position** können **eine oder mehrere Positionen** eines Angebots oder Auftrags zur Bestellung übergeben werden. Alle angegebenen Positionen müssen dem im Abschnitt **Document** referenzierten Beleg zugeordnet sein. Nur diese Positionen werden bei der Erstellung der Anfrage bzw. Bestellung berücksichtigt. ### SearchType Legt fest, anhand welcher Information die Position gesucht wird: - **1** – Suche über **PosSNr** (interne Positions- bzw. Sequenznummer). - **2** – Suche über die **GUID** der Position. ### SearchValue Enthält den Suchwert entsprechend dem gewählten **SearchType**. ### PurchasePositionERPNumber Optional. Die angegebene **externe ERP-Bestellnummer der Position** wird bei der erzeugten Bestellposition gespeichert. ServiceReturnData ## ServiceReturnData ```json {    [...Default Service-Response-Header...],    "ServiceReturnData": {        "Document": {            "Type": 2,            "DocNum": 20211234,            "DocNbr": 517,            "Guid": "a316a3b7-9670-dd85-8814-8e2358dd6dc8"        },        "Purchase": [            {                "PchNum": 20210001,                "PchNbr": 3,                "Guid": "e08ea97c-d470-ca8d-8814-6a23800d49aa",                "SupplierAdrNbr": 4711,                "NumOfPositions": 2            },            {                "PchNum": 20210002,                "PchNbr": 4,                "Guid": "feda0d29-56c6-d6b6-8814-6f23e0b15369",                "SupplierAdrNbr": 3245,                "NumOfPositions": 1            }        ]    } } ``` ## Document Der Abschnitt **Document** enthält die Informationen zum Beleg, für den die **Anfragen bzw. Bestellungen** erstellt wurden. Ein Teil dieser Daten entspricht den bereits beim Serviceaufruf im Abschnitt **Document** übergebenen Werten und wird zur Bestätigung in den Rückgabedaten erneut ausgegeben. ### Type Gibt den Belegtyp an, für den Anfragen bzw. Bestellungen erstellt wurden: - **1** – Angebot, aus dem **Anfragen** erzeugt wurden. - **2** – Auftrag, aus dem **Bestellungen** erzeugt wurden. #### DocNum Enthält die **sichtbare Belegnummer**. #### DocNbr Enthält die **interne Belegnummer**. #### Guid Enthält die **GUID des Belegs**. ## Purchase Der Abschnitt **Purchase** enthält die Informationen zu den erzeugten **Anfragen bzw. Bestellungen**. Aus einem **Angebot** oder **Auftrag** können mehrere Anfragen bzw. Bestellungen entstehen, beispielsweise **eine Bestellung je Lieferant**. #### PchNum Enthält die **sichtbare Anfrage- bzw. Bestellnummer**. #### PchNbr Enthält die **interne Anfrage- bzw. Bestellnummer**. #### Guid Enthält die **GUID der Anfrage bzw. Bestellung**. #### SupplierAdrNbr Enthält die **interne Adressnummer des Lieferanten**. #### NumOfPositions Enthält die **Anzahl der in der Anfrage bzw. Bestellung enthaltenen Positionen**.