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