Service CreatePurchase

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 bietet die Funktion, dass ein Beleg, der bereits in moveIT ISS+ auf Fertig gesetzt wurde, aus einem Fremdsystem (z.B.: ERP-System) des Händlers bestellt werden kann.

Dies kann für den ganzen Beleg, aber auch für bestimmte Positionen geschehen. Dabei wird eine JSON-Datei erstellt.

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

Header

OrgCde (Organisation/Marktnummer) und Language sind optional.

Service muss den Fixwert "CreatePurchase" enthalten.

Document

Type

- 1 .. Angebot, daraus werden Anfragen

- 2 .. Auftrag, daraus werden Bestellungen

SearchType

- 1 .. Suche per DocNum (sichtbare Belegenummer); Nur möglich, wenn die Nummerkreise der Geschäftsperioden keine doppelten Belegnummern zulassen!

- 2 .. Suche per DocNbr (interne Belegnummer)

- 3 .. Suche per GUID des Belegs

Empfehlung ist 2 oder 3, da diese 100% eindeutig sind. 

SearchValue

Suchwert entsprechend dem SearchType 

ERPNumber

optional, wird beim Beleg als externe Angebots-/Auftragsnummer hinterlegt

PurchaseERPNumber (NOCH NICHT REASLISIERT!):

Bestellnummer, optional, wird bei den lt. Positionen erzeugten

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

Es können hier mehrere Positionen eines Auftrags übergeben/bestellt werden.

Die hier übergebenen Positionen müssen zum Beleg lt. "Document" gehören. 

SearchType

- 1 .. Suche per PosSNr (interner Positionsnummer/Sequenznummer)

- 2 .. Suche per Guid der Position

SearchValue

Suchwert entsprechend dem SearchType

PurchasePositionERPNumber

externe (ERP) Bestellnummer der Position, optional, wird bei der erstellten Bestellposition hinterlegt

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

Enthält nochmals alle Informationen zum Beleg für den die Anfragen/Bestellungen erzeugt wurden, welche schon teilweise beim Call geschickt wurden. 

Type

- 1 .. Angebot, daraus wurden Anfragen

- 2 .. Auftrag, daraus wurden Bestellungen

DocNum

sichtbare Belegenummer

DocNbr

interne Belegnummer

Guid

GUID des Belegs

Purchase

Aus einem Angebot oder Auftrag können mehrere Anfragen/Bestellungen erstellt worden sein; je Lieferant eine Bestellung. 

PchNum

sichtbare Anfrage-/Bestellnummer

PchNbr

interne Anfrage-/Bestellnummer

Guid

Guid der Anfrage/Bestellung

SupplierAdrNbr

allg./interne Adressnummer des Lieferanten

NumOfPositions

Anzahl der bestellten Positionen