Itt talál egy átfogó útmutatót arról, hogyan hozhat létre megrendelést a Skyplannerben az összes kapcsolódó adattal együtt. Ennek egy részét az integrációs útmutatóban már leírtuk, de itt részletesebben áttekintjük a Skyplanner adatszerkezetét és az integrációs folyamatot.
Adatszerkezet #
Először is áttekintjük, hogyan épül fel egy Skyplanner-megrendelés. Az itt említett adategységek API-pontjait így emeljük ki: /phaser-orders
A legfelső szinten van a megrendelés(/phaser-orders)
Minden megrendelésnek rendelkeznie kell egy ügyféllel(/vevőkkel).
Minden rendelésnek több rendelési tétele is lehet(/phaser-Order-items).
Minden rendelési tételhez tartozhat egy termék(/products), de ez nem kötelező. Minden termékhez egy készlet(/saldos) tartozik. Vegye figyelembe, hogy a készlet entitás automatikusan létrejön, amikor egy terméket az API segítségével hoz létre.
Minden megrendelési tételhez több feladat (más néven folyamatlépés) tartozhat(/phaser-jobs).
Minden munkának rendelkeznie kell egy munkafázissal(/workstages).
Integrációs munkafolyamat #
Itt egy lépésről lépésre bemutatott példa arra, hogyan strukturálhatja az ERP-rendszere és a Skyplanner közötti integrációt.
- Értékesítés/munkarend lekérése az ERP-ből
- Ügyfél létrehozása (ügyfél azonosítójának lekérése a válaszban)
- Megrendelés létrehozása az ügyfél azonosítójával (a válaszban megkapja a megrendelés azonosítóját)
- Értékesítési/munkarendelési tételek adatainak lekérdezése az ERP-ből
- Termék létrehozása (a termék azonosítójának megadása a válaszban)
- Megrendelési tétel létrehozása a rendelési azonosítóval és egyéb adatokkal (a válaszban megkapja a rendelési tétel azonosítóját)
- Folyamatlépés-adatok lekérése az ERP-ből
- Munkaszakasz létrehozása (a válaszban megkapja a munkaszakasz azonosítóját)
- Munkafeladat létrehozása a munkafázis azonosítójával és egyéb adatokkal
Extra tippek #
Törléskor #
A phaser-orderek, phaser-Order-items vagy phaser-jobs törlése az API-n keresztül (és a felhasználói felületről) soft delete módon történik. Ez azt jelenti, hogy az adatok valójában nem törlődnek az adatbázisból, hanem archiváltként kerülnek megjelölésre. A törléskor az entitás is_archive attribútuma valójában true értéket kap. Az archivált/törölt entitások továbbra is elérhetők az API segítségével az include_archived paraméter használatával. Ha az include_archived=true, a GET-kérés akkor is lekérdezi az entitást, ha az archiválva van.
Vegye figyelembe, hogy a lágy törlés nem minden API végponton érhető el! Tehát óvatosnak kell lennie, mivel például az ügyfelek, emberek stb. törlése végleges!
Alapértelmezett folyamatlépések használata a megrendelési tételhez #
Ha létrehozott néhány alapértelmezett folyamatlépést a megrendelési tétel által előállított termékhez, akkor a get_default_steps attribútummal megmondhatja a rendszernek, hogy az API segítségével hozza az alapértelmezett lépéseket a megrendelési tételhez.
Anyagok hozzáadása a rendelési tételhez #
Ha az előállított termékhez anyagokat csatolt, azok automatikusan a megrendelés sorához kapcsolódnak.
Ha azonban nem szeretné használni a termékhez csatolt anyagokat (például ha a termék egyedi megrendelés, és más anyagokat szeretne használni stb.), akkor használhatja a use_custom_materials attribútumot.
