Sie nutzen noch die moveIT ISS+ CLASSIC Oberfläche? Kein Problem! Die Hilfe dazu finden Sie hier

Service CreatePurchase

Prev Next

ISS+

EASY

Vollständig

Nicht

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

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

 

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

{
    [...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.