Čia aprašysime, kaip galite kurti produktus ir medžiagas ir kaip juos pridėti prie užsakymų naudodami “Skyplanner-API”. Taip pat parodysime, kaip sukurti numatytuosius produktų proceso etapus ir kaip sukurti užsakymo elementus naudojant šiuos numatytuosius etapus.
Gaminio ir (arba) medžiagos kūrimas #
Produktai ir medžiagos kuriami ir atnaujinami per tą patį API galinį tašką: /products. Produkto tipas nustatomas pagal atributą type-attribute: “Product” arba “Material”.
Kurdami produktus ir medžiagas įsitikinkite, kad nustatėte is_active reikšmę true, jei norite, kad produktas ir (arba) medžiaga būtų rodomi kaip aktyvūs produktų sąraše. Taip pat atkreipkite dėmesį, kad galite nustatyti turimą atsargų kiekį naudodami požymį free_amount.
Numatytųjų gaminio proceso žingsnių kūrimas #
Prieš pridėdami gaminio numatytuosius proceso etapus, turite turėti atitinkamus darbo etapus. Darbo etapus galima sukurti per “Skyplanner” vartotojo sąsają arba per /workstages-endpoint.
Numatytieji proceso etapai pridedami iš /products/jobs/{productId}-galutinio taško.
Pavyzdžiui, jei norite pridėti numatytąjį žingsnį prie produkto, kurio ID 22220, turėtumėte atlikti tokią POST užklausą:
Kelios svarbios sritys:
- order_number
- Tai indeksinis numeris, nurodantis, kokia tvarka turi būti atliekami proceso etapai.
- Pavyzdžiui: pirmame žingsnyje gaunama 1 reikšmė, antrame žingsnyje – 3 reikšmė, trečiame žingsnyje – 3 reikšmė ir t. t.
- darbo vietos
- Tai darbo vietų, kuriose galima suplanuoti šį proceso žingsnį, sąrašas
- Pateikite čia darbo stoties ID kaip kableliais atskirtą sąrašą, pvz., taip: “61,62,63”
- time_variation
- Galimos reikšmės: time_per_pcs, pcs_per_time, fixed_time
- trukmė, settingtime, settletime
- Nurodykite šias vertes sekundėmis
Numatytojo proceso žingsnio atnaujinimas #
Atnaujindami numatytąjį proceso žingsnį turite naudoti atributą order_number, kad nurodytumėte, kurį žingsnį atnaujinti.
Pavyzdžiui, pirmas šio produkto proceso žingsnis(order_number 1) atliekamas su tokia PUT užklausa:
Numatytojo proceso žingsnių šalinimas #
Numatytuosius proceso etapus taip pat galima ištrinti naudojant order_number reikšmes.
Užsakymo_numeriai pateikiami masyve taip:
Medžiagos ir (arba) subprodukto pridėjimas prie produkto #
Norėdami pridėti medžiagą arba subproduktą, turime naudoti /sub-products galinį tašką.
Procesas gana paprastas: į atributą production_planning_product_id įrašome medžiagos arba subprodukto ID, o į atributą production_planning_product_parent_id įrašome produkto, prie kurio norime, kad medžiaga arba subproduktas būtų prijungtas, ID.
Medžiagos pridėjimas prie užsakymo elemento #
Taip pat galite tiesiogiai pridėti medžiagas prie užsakymo elemento naudodami /row-materials galinį tašką. Tokiu būdu užsakymo elemente galite pridėti papildomų medžiagų arba naudoti visiškai kitokį medžiagų sąrašą nei numatytosios medžiagos, nustatytos produktams. Atkreipkite dėmesį, kad užsakymo elemente galite turėti tik vieną eilutės-materal esybę, skirtą kiekvienai medžiagai. Taigi iš esmės negalite sukurti dviejų esybių su tuo pačiu production_planning_product_id tam pačiam phaser_order_row_id.
Atsargų lygio atnaujinimas #
Produkto arba medžiagos atsargų lygį galite atnaujinti siųsdami PUT užklausą su atributu free_amount.