Přístup k produktovým pohybům (Příjemka/Výdejka)
GET /api/motions
Získání záznamů skladových pohybů.
Požadavek
Query parametr | Typ | Popis | Výchozí |
---|---|---|---|
position | int | index prvního záznamu, který má být vrácen (0 - první záznam) | 0 |
size | int | počet záznamů (stránky), povolené maximum 1000 | 20 |
orderBy | string | údaj, podle kterého mají být záznamy řazené | - |
desc | boolean | řazení je sestupné (descending) | false |
Příklad: /api/motions?orderBy=entered&desc=true
Získá seznam skladových dokladů seřazených od nejnovějších, podle data vytvoření.
Odpověď (application/json
)
200 OK
Stránka se záznamy typu motions.
{
"items": [
{
"id": 123,
"store": 1,
"income": "out",
"symbol": "VYDEJ00123",
/* ... */
}
/* ... */
]
}
POST /api/motions
Vytvoření nového skladového dokladu.
Požadavek (application/json
)
Tělo požadavku musí být JSON objekt, reprezentující nový skladový doklad. Neměl by obsahovat parametr id
. ID bude nové objednávce přiděleno při úspěšném zápisu.
JSON může obsahovat pole položek items
, v tom případě se doklad vytvoří včetně položek a není nutné přidávat položky do skladového dokladu jednotlivě.
Příklad: POST /api/motions
{
"store": 1,
"income": "out",
"buscase": 123,
"serie": 1,
"category": 0,
"moveDate": "2022-12-22T00:00:00",
"items": [
{
"store": 1,
"product": 555,
"moved": 2.0,
"unit": 101,
"busCaseItem": 553273
},
/* ... */
]
}
Odpověď (application/json
)
201 OK CREATED
Tělo odpovědi bude obsahovat JSON objekt vytvořeného dokladu.
V http hlavičce Location
bude URL k získání příležitosti v pozdějších dotazech.
400 BAD REQUEST
Zaslaný objekt neprošel validací a nemůže být zapsán do databáze. Tělo obsahuje standardní chybový JSON s popisem nalezených chyb.
GET /api/motions/{id}
Získání jednoho dokladu s konkrétním ID. ID je v InTouch CRM celé číslo, takže požadavkem:
GET /api/motions/247
Získáte skladový doklad s kódem 247
(pokud takový existuje), včetně položek.
Odpověď (application/json
)
200 OK
Tělo odpovědi bude doklad s požadovaným ID.
404 NOT FOUND
Požadovaný doklad v databázi neexistuje.
Práce s položkami skladových dokladů /api/motions/{id}/motionitems
Popis volání API položky objednávky