Itt részletesen bemutatjuk a rendelési tételek lekérdezését, létrehozását, frissítését és törlését.
A rendelési tételek a /phaser-order-rows végponton keresztül érhetők el.
Rendelési tételek lekérése #
A rendelési tételeket a /phaser-order-rows végpontra küldött GET-kérelemmel lehet lekérni:
A rendelési tételeket számos különböző paraméter alapján keresheti:
- phaser_order_id
- a Skyplanner belső rendelési azonosítóját a /phaser-orders-endpoint-on keresztül találja meg.
- external_id
- A rendelési tétel külső azonosítója
- Például a külső rendszer (ERP stb.) egyedi azonosítója.
- production_planning_product_id
- Belső Skyplanner termék azonosító
- Megtalálható a /products-endponton keresztül
- parent_id
- Ha egy rendelési tételnek vannak altételei (pl. altermékek), akkor az altételek a parent_id mezőben a szülői rendelési tétel azonosítójával rendelkeznek.
- row_index
- A rendelési tétel indexszáma
- worknumber
- A rendelési tétel munkaszámának értéke
- státusz
- A rendelési tétel státusza
- Megengedett értékek: új, megkezdett vagy befejezett
- pozíció
- A rendelési tétel pozíciójának értéke
- delivery_date
- A rendelési tétel szállítási dátuma
- Formátum: 2025-06-05T22:00:00+00:00
- delivery_date_condition
- A szállítási dátum keresésének választható feltétele
- Lehetőségek: >, =, <=, =, !=
- Ha nincs érték megadva, a >= feltétel lesz használva .
- is_prospect
- Vissza csak rendelési tételek, amelyek kilátások
- include_archived
- Archivált (lágy törölt) rendelési tételek bevonása a lekérdezésbe
- Az is_archive értékkel jelölve
- módosított
- Adott dátum után módosított rendelési tételek visszaküldése
- Formátum: 2025-06-05T22:00:00+00:00
- modifiedCondition
- A módosított értékek keresésének választható feltétele
- Lehetőségek: >, =, <=, =, !=
- Ha nincs érték megadva, a >= feltétel lesz használva .
A keresési paramétereket keverheti és összeválogathatja a következők szerint:
Egy adott rendelési tétel lekérdezéséhez a Skyplanner belső azonosítójával egy ilyen kérést végezhet:
Megrendelési tételek létrehozása #
Ne feledje, hogy a rendelési tétel létrehozása előtt létre kell hoznia egy megrendelést!
Egy rendelési tétel létrehozásához küldjön egy POST-kérést a /phaser-order-rows végpontra:
Az alábbiakban áttekintjük a megrendelési tételek létrehozásakor használható mezőket:
- phaser_order_id
- A megrendelés belső Skyplanner azonosítója a megrendeléshez, amelyhez a megrendelési tétel kapcsolódik.
- Kötelező mező
- production_planning_order_row_id
- Miután a megrendelés exportálásra került a Skyplanner gyártásütemezési moduljába, egy különálló egység, a gyártástervezési megrendelés sora jön létre, és az azonosítóját ebbe a mezőbe kell beállítani
- Nem ajánlott használni (hagyja nullaként, vagy egyáltalán ne küldje el ezt a mezőt a kérelem mezőben).
- production_planning_product_id
- Skyplanner termék azonosítója a termékhez, amelyet a rendelési tétel előállít.
- Szükséges, ha alapértelmezett folyamatlépéseket szeretne átvenni egy termékből.
- external_id
- A rendelési tétel egyedi azonosítója
- Használja ezt a Skyplanner rendelési tétel összekapcsolására a külső rendszerből (ERP stb.) származó rendelési tételével.
- Egyedülállónak kell lennie
- parent_id
- Ha a rendelési tétel egy másik rendelési tétel altétele, itt adja meg a szülői azonosító értékét.
- row_index
- A rendelési tételek listáján belül hol található ez a tétel a rendelésen belül.
- worknumber
- Kizárólag tájékoztató jellegű munkaszám értékként használatos a rendelési tételhez.
- Nem látható a Skyplanner felhasználói felületén
- státusz
- A rendelési tétel állapota
- Megengedett értékek: új, megkezdett, kész, szakaszos
- is_archive
- A rendelési tétel archiválva van (lágy törlés)?
- pozíció
- A rendelési tétel azonosító értéke (lásd a 3. ábrát).
- összeg
- A termék teljes gyártott mennyisége
- ordered_amount
- A termék megrendelt mennyisége
- ár
- A termék egységára
- use_custom_materials
- Ha nem szeretné használni a termékadatokból származó alapértelmezett anyagbeállítást, állítsa ezt az értéket true-ra.
- Alapértelmezett: false
- use_custom_materials_calculated (egyéni_anyagok_számítása)
- Az egyedi anyagmennyiségek kiszámítása a gyártott termékmennyiség alapján történik.
- Ha false-ra van állítva, az anyagmennyiségek fixek
- Alapértelmezett: false
- get_default_steps
- A termék alapértelmezett folyamatlépései alapján folyamatlépéseket hozhat létre a termék megrendeléséhez.
- Alapértelmezett: false
- use_calculated_job_durations
- A folyamatlépés időtartamának kiszámítása a múltbeli időnapló-adatok alapján
- Ha nem áll rendelkezésre elegendő adat a számításhoz, akkor alapértelmezett időtartamokat használnak.
- Alapértelmezett: false
- sub_items
- Létrehozza a termék alelemeit is, ha rendelkezésre állnak
- Alapértelmezett: false
- delivery_date
- Formátum: 2022-01-01 10:30:11
- start_eligibility_date
- Formátum: 2022-01-01 10:30:11
- drawing_identifier
- Rajz/tervrajz/utasítások azonosítója
- leírás
- Megrendelési tétel leírása
- additional_description
- További leírás a rendelési tételhez
- is_prospect
- A rendelési tétel egy prospektus
- Alapértelmezett: false
Megrendelési tételek frissítése #
A rendelési tételek adatainak frissítéséhez PUT-kérést küldhet a /phaser-order-rows végpontra:
Megrendelési tételek törlése #
A rendelési tételek törlése “lágy törlés” módszerrel történik. A rendelési tétel törlése az
Egy rendelési tétel törlésekor a rendszer törli a hozzá tartozó folyamatlépéseket is.
A rendelési tételek törlése a /phaser-order-rows végpontra küldött DELETE-kérelemmel történik:
A rendelési tételek törlése a Skyplanner belső azonosítóinak megadásával az “ids” tömbben vagy a külső_id-ek megadásával az “external_ids” tömbben lehetséges.