---
title: Produktai ir medžiagos
description: "Č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…"
url: "https://skyplanner.ai/lt/docs/produktai-ir-medziagos/"
updated: "2025-10-07"
category: Integracijos
tags:
  - API
  - Integracija
---

# Produktai ir medžiagos

Č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".

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-14.png)
**1 pav.** Produkto kūrimas

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-11.png)
**2 pav.** Medžiagos kūrimas

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ą:

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-16.png)
**3 pav.** Numatytojo proceso žingsnio pridėjimas

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:

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-19.png)
**4 pav.** Numatytojo proceso žingsnio atnaujinimas

#### Numatytojo proceso žingsnių šalinimas

Numatytuosius proceso etapus taip pat galima ištrinti naudojant **order_number** reikšmes.

Užsakymo_numeriai pateikiami masyve taip:

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-21.png)
**5 pav.** Numatytojo proceso žingsnių šalinimas

##### 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.

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-22.png)
**6 pav.** Medžiagos tvirtinimas prie gaminio

##### 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**.

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-24.png)
**7 pav.** Medžiagos pridėjimas prie užsakymo elemento

#### Atsargų lygio atnaujinimas

Produkto arba medžiagos atsargų lygį galite atnaujinti siųsdami PUT užklausą su atributu **free_amount**.

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-40.png)
**8 pav.** Atsargų lygio atnaujinimas