Die Bestellung von Positionen aus dem empfangenen Auftrag durch den ausgegebenen Auftrag ist als virtueller Datensatz /Auftrag realisiert. Sie hat zwei Unterressourcen:
/item
erstellt ein OBV eines bestimmten Typs aus ausgewählten OBP-Positionen, bestellt alle Positionen bei einem bestimmten Lieferanten
es wird durch POST- oder PUT-Methoden aufgerufen und erfordert die Eingabe:
typeDokl - Objekt-ID oder Code aus dem Register /type-orders-issued
supplierCompany - ID oder Code des Objekts aus dem Register /Adresse
PositionenObp
id des Objekts aus den Datensätzen /order-accepted-item
zu bestellendeMenge
/Bulk
erzeugt eine OBV aus allen OBP-Positionen, die den eingestellten Lieferanten haben
wird durch POST-, PUT- oder GET-Methoden aufgerufen und erfordert nur typeDocument (entweder im Abfragekörper oder per Abfrageparameter).
Es handelt sich also um Endpunkte:
/order/item - zum Erstellen von Bestellungen, die für die angegebenen Lieferanten und OBP-Positionen mit der bestellten Menge ausgegeben werden
/objednani/bulk - für die automatische Erstellung von OBV aus allen OBP-Positionen, wenn diese einen festgelegten Hauptlieferanten haben
Beispiele:
1. ressourcenabfrage/auftrag/position
curl -k -X POST 'https://localhost:5434/v2/c/fcn_obv/objednani/polozek' -H 'Content-Type: application/json' -H 'Accept: application/json' --data-binary '{"winstrom":{"@version": "1."0', "orderPositions":{"typeDoc": "code:OBV", "supplierCompany": "code:AAA", "positionsObp":[{"id":3704, "quantity":2},{"id":3706, "quantity":3}]}}}' -u admin:adminadmin | jqsendet Daten im Format
null
und erhält eine 200 OK-Antwort mit der ID der OBV, die erstellt wurde
{
"winstrom": {
"@version": "1.0",
"success": true,
"stats": {
"created": 1,
"updated": 0,
"deleted": 0,
"skipped": 0,
"failed": 0
},
"results": [
{
"id": 1638
}
]
}
}oder 400 Schlechte Anfrage
{
"winstrom": {
"@version": 1,
"success": false,
"message": "Es wurden keine zur Bestellung geeigneten Artikel gefunden."
}
}wenn keiner der eingereichten Artikel bestellt werden kann.
2. Weitere Bestellungen unter Ressource /order/items
curl -k -X POST 'https://localhost:5434/v2/c/fcn_obv/objednani/polozek' -H 'Content-Type: application/json' -H 'Accept: application/json' --data-binary '{"winstrom":{"@version": "1."0", "orderPositions":[{"doctype": "code:OBV", "vendorFirm": "code:AAA", "positionsObp":[{"id":3709, "quantity":2},{"id":3711, "quantity":3}]},{"typDokl": "code:OBV", "dodavatelFirma": "code:ABC", "polozkyObp":[{"id":3715, "mnozstvi":4},{"id":3717, "mnozstvi":5}]}]}}' -u admin:adminadmin | jqsendet Daten im Format
null
null
3. Ressource abfragen /Bestellung/Bulk
curl -k -X POST 'https://localhost:5434/v2/c/fcn_obv/objednani/hromadne' -H 'Content-Type: application/json' -H 'Accept: application/json' --data-binary '{"winstrom":{"@version": "1.0", "objednaniHromadne":{"typeDoc": "code:OBV"}}}' -u admin:adminadmin | jq
sendet Daten im Format
{
"winstrom": {
"@version": "1.0",
"objednaniHromadne": {
"typDoc": "code:OBV"
}
}
}oder in ähnlicher Weise GET
curl -k -X GET 'https://localhost:5434/v2/c/fcn_obv/objednani/hromadne?typDokl=code%3AOBV' -H 'Accept: application/json' -u admin:adminadmin
mit Abfrageparameter typeDocl=code:OBV erhält als Antwort 200 OK eine Liste der OBV-Kennungen, die erstellt wurden
{
"winstrom": {
"@version": "1.0",
"success": true,
"stats": {
"created": 2,
"updated": 0,
"deleted": 0,
"skipped": 0,
"failed": 0
},
"results": [
{
"id": 1639
},
{
"id": 1640
}
]
}
}oder 400 Schlechte Anfrage
{
"winstrom": {
"@version": 1,
"success": false,
"message": "Es wurden keine zur Bestellung geeigneten Artikel gefunden."
}
}