Kaip sukurti pardavimo poziciją kiekinėms prekėms per API?
Kuriant pardavimo poziciją kiekinėms prekėms per API tašką warehouse/sale-items/create, būtina nurodyti pirkimo pozicijos identifikatorių „purchaseItemId“ — nuorodą į pirkimo dokumento eilutę, iš kurios bus nurašytas prekės likutis. Jei kiekinei prekei šis laukas neperduodamas, sistema grąžina klaidą „Prekė nėra paslauga, todėl prekės pardavimo pozicija turi turėti nuorodą į prekės poziciją pirkimo dokumente“. Paslaugoms šis laukas nereikalingas — jis privalomas tik kiekinėms prekėms (kai „isQuantitative“ = true). Pastaba. Ši klaida aktuali tik kuriant pardavimo dokumentus per API. Kai pardavimo dokumentas kuriamas Site.pro sąsajoje, sistema reikiamą pirkimo poziciją parenka automatiškai. Pardavimo pozicijos laukai Laukų reikalavimai plačiau aprašyti API dokumentacijoje. Laukas Tipas AprašymassaleIdNumberPardavimo dokumento ID.itemIdNumberPrekės ID.warehouseIdNumberSandėlio ID.quantityNumberKiekis.priceWithoutVatNumberKaina be PVM.vatRateNumberPVM tarifas (pvz., 21).priceWithVatNumberKaina su PVM.vatClassificationIdNumberPVM klasifikacijos ID.purchaseItemIdNumberPirkimo pozicijos ID, gaunamas per warehouse/stock-list. Privalomas kiekinėms prekėms. Kaip gauti pirkimo pozicijos identifikatorių Pirkimo pozicijos ID nereikia ieškoti prekių žinyne (reference-book/items/list) — pardavimui galimos prekės ir jų likučiai pateikiami sandėlio likučių API taške warehouse/stock-list. Užklausoje nurodykite pardavimo dokumento ID ir prekę: {"saleId": 388,"filters": {"groupOp": "AND","rules": [{"field": "itemId", "op": "eq", "data": 4221}]}} Atsakyme raskite reikiamą likučio įrašą ir pasiimkite jo pirkimo pozicijos identifikatorių. Jei norite nurašyti seniausią pirkimą, likučius filtruokite pagal prekę, sandėlį ir pirkimo datą. Gautą reikšmę nurodykite lauke „purchaseItemId“ kuriant pardavimo poziciją: {"calculationMode": 6,"saleId": 388,"itemId": 4221,"warehouseId": 1,"quantity": 1,"priceWithoutVat": 100,"vatRate": 21,"priceWithVat": 121,"vatClassificationId": 1,"purchaseItemId": 595} Svarbu. Pardavimo dokumento data negali būti ankstesnė nei prekės pirkimo data — negalima parduoti prekės, kurios tuo metu dar nebuvo sandėlyje. Jei likučių užklausa grąžina tuščią rezultatą, pirmiausia patikrinkite pirkimo ir pardavimo datas. Pastaba. Laukui „purchaseItemId“ netinka nei pirkimo dokumento ID, nei prekės ID — turi būti nurodytas būtent pirkimo dokumento eilutės (pozicijos) identifikatorius. Jei reikšmė neteisinga, sistema grąžina klaidą „Išsiuntėte neegzistuojančią reikšmę“. Pastaba. Jei parduodamas kiekis didesnis nei vienos pirkimo pozicijos likutis, pardavimą skaidykite į kelias pardavimo pozicijas — kiekvienai nurodykite atitinkamą pirkimo poziciją ir kiekį. Pastaba. Pirkimo ir pardavimo dokumentuose prekėms ieškoti naudojami skirtingi API metodai: pirkimuose – „Prekių sąrašas“ https://site.pro/My-Accounting/doc/api#api-warehouse-stock-list,, pardavimuose – „Sandėlio prekių likučiai“ https://site.pro/My-Accounting/doc/api#api-reference-book-items-list. Susiję straipsniai: Kur programuotojas gali rasti sandėlio ID?Kaip naudoti komplektavimas iškomplektavimas API tašką?
› › ›
Apskaitos programa

Kaip sukurti pardavimo poziciją kiekinėms prekėms per API?

Kuriant pardavimo poziciją kiekinėms prekėms per API tašką warehouse/sale-items/create, būtina nurodyti pirkimo pozicijos identifikatorių „purchaseItemId“ — nuorodą į pirkimo dokumento eilutę, iš kurios bus nurašytas prekės likutis. Jei kiekinei prekei šis laukas neperduodamas, sistema grąžina klaidą „Prekė nėra paslauga, todėl prekės pardavimo pozicija turi turėti nuorodą į prekės poziciją pirkimo dokumente“. Paslaugoms šis laukas nereikalingas — jis privalomas tik kiekinėms prekėms (kai „isQuantitative“ = true).

Pastaba. Ši klaida aktuali tik kuriant pardavimo dokumentus per API. Kai pardavimo dokumentas kuriamas Site.pro sąsajoje, sistema reikiamą pirkimo poziciją parenka automatiškai.

Pardavimo pozicijos laukai

Laukų reikalavimai plačiau aprašyti API dokumentacijoje.

Laukas Tipas Aprašymas
saleIdNumberPardavimo dokumento ID.
itemIdNumberPrekės ID.
warehouseIdNumberSandėlio ID.
quantityNumberKiekis.
priceWithoutVatNumberKaina be PVM.
vatRateNumberPVM tarifas (pvz., 21).
priceWithVatNumberKaina su PVM.
vatClassificationIdNumberPVM klasifikacijos ID.
purchaseItemIdNumberPirkimo pozicijos ID, gaunamas per warehouse/stock-list. Privalomas kiekinėms prekėms.

Kaip gauti pirkimo pozicijos identifikatorių

Pirkimo pozicijos ID nereikia ieškoti prekių žinyne (reference-book/items/list) — pardavimui galimos prekės ir jų likučiai pateikiami sandėlio likučių API taške warehouse/stock-list. Užklausoje nurodykite pardavimo dokumento ID ir prekę:

{
"saleId": 388,
"filters": {
"groupOp": "AND",
"rules": [
{"field": "itemId", "op": "eq", "data": 4221}
]
}
}

Atsakyme raskite reikiamą likučio įrašą ir pasiimkite jo pirkimo pozicijos identifikatorių. Jei norite nurašyti seniausią pirkimą, likučius filtruokite pagal prekę, sandėlį ir pirkimo datą. Gautą reikšmę nurodykite lauke „purchaseItemId“ kuriant pardavimo poziciją:

{
"calculationMode": 6,
"saleId": 388,
"itemId": 4221,
"warehouseId": 1,
"quantity": 1,
"priceWithoutVat": 100,
"vatRate": 21,
"priceWithVat": 121,
"vatClassificationId": 1,
"purchaseItemId": 595
}

Svarbu. Pardavimo dokumento data negali būti ankstesnė nei prekės pirkimo data — negalima parduoti prekės, kurios tuo metu dar nebuvo sandėlyje. Jei likučių užklausa grąžina tuščią rezultatą, pirmiausia patikrinkite pirkimo ir pardavimo datas.

Pastaba. Laukui „purchaseItemId“ netinka nei pirkimo dokumento ID, nei prekės ID — turi būti nurodytas būtent pirkimo dokumento eilutės (pozicijos) identifikatorius. Jei reikšmė neteisinga, sistema grąžina klaidą „Išsiuntėte neegzistuojančią reikšmę“.

Pastaba. Jei parduodamas kiekis didesnis nei vienos pirkimo pozicijos likutis, pardavimą skaidykite į kelias pardavimo pozicijas — kiekvienai nurodykite atitinkamą pirkimo poziciją ir kiekį.

Pastaba. Pirkimo ir pardavimo dokumentuose prekėms ieškoti naudojami skirtingi API metodai: pirkimuose – „Prekių sąrašas“ https://site.pro/My-Accounting/doc/api#api-warehouse-stock-list,, pardavimuose – „Sandėlio prekių likučiai“ https://site.pro/My-Accounting/doc/api#api-reference-book-items-list.

Susiję straipsniai: