Web service (API)
Naujausia API dokumentacija: https://documenter.getpostman.com/view/35957649/2sA3sAg7R9
Prisijungimas: e.monet.lt
Vartotojas: demo
Slaptažodis: demo321
Legacy web service: https://e.monet.lt/DesktopModules/MonetForms/MonetWSv3.asmx
Dėmesio! Kuriant ID tipo įrašus (pavyzdžiui kliento, prekės kodą), sistema neleis naudoti simbolių, kurie atitinka tokią sąlygą: Regex.IsMatch(ID, @"^[^\041-\042\044-\054\056-\056\072-\100]+$")
t. y. kode negali būti kablelių, šauktukų ir t.t. Visą sąrašą neleistinų simbolių galima pasitikrinti pagal lentelės
http://www.asciitable.com/ stulpelį „Oct“.
Pagrindinės funkcijos:
CreateCust – kliento sukūrimas
CreateItem – prekės sukūrimas
CreatePurchLine – pirkimo užsakymo eilutės sukūrimas
CreatePurchOrder – pirkimo užsakymo sukūrimas
CreateSalesLine – pardavimo eilutės sukūrimas
CreateSalesOrder – pardavimo užsakymo sukūrimas
CreateVend – tiekėjo sukūrimas
ExistCust – patikrinimas ar toks klientas jau sukurtas pagal kliento kodą (ID)
ExistCustByEnterpriseCode – patikrinimas ar toks klientas jau sukurtas pagal įmonės kodą
ExistItem – patikrinimas ar tokia prekė jau sukurta
ExistVend – patikrinimas ar toks tiekėjas jau sukurtas
IsValidUser – patikrinimas prie kokios įmonės vartotojas turi priėjimą
PostPurch – pirkimo registravimas
PostSales – pardavimo registravimas
GetInventOnHand – fiziškai turimų prekių kiekių informacija.
GetCustByEnterpriseCode – gražina kliento kodą (ID) pagal įmonės kodą.
CreateCust – gražina true/false
Parameter |
Value |
user: |
Vartotojo vardas |
password: |
Slaptažodis |
_cust: |
Kliento kodas sistemoje |
_name: |
Kliento pavadinimas |
_group: |
Kliento grupė (žr. monet.lt galimas vertes) |
_enterpriseCode: |
Kliento įmonės kodas |
_vatnum: |
PVM kodas |
_address: |
Adresas |
CreateItem – gražina true/false;
Parameter |
Value |
user: |
Vartotojo vardas |
password: |
Slaptažodis |
_itemId: |
Prekės kodas |
_name: |
Prekės pavadinimas |
_itemGroup: |
Prekės grupė (žr. monet.lt galimas vertes) |
_model: |
Prekės tipas (žr. monet.lt galimas vertes) |
_unitId: |
Prekės mato vienetas (žr. monet.lt galimas vertes) |
_pvmGroup: |
Prekės PVM grupė (žr. monet.lt galimas vertes) |
CreatePurchOrder – gražina tekstą „OK“ su užsakymo numeriu arba „NO“, jei nepavyko.
Parameter |
Value |
user: |
Vartotojo vardas |
password: |
Slaptažodis |
_vend: |
Tiekėjo kodas |
_paymMode: |
Mokėjimo būdas |
_incTax |
True - kainos užsakyme su PVM, ne – be PVM |
_currency |
'' - naudoja įmonės ar tiekėjo valiutą |
_discPercent |
Nuolaidos dydis % |
CreatePurchLine – gražina tekstą „OK“ arba „NO“ su klaidos pranešimu.
Parameter |
Value |
user: |
Vartotojo vardas |
password: |
Slaptažodis |
_purchId: |
Pirkimo numeris |
_itemId: |
Prekės kodas |
_qty: |
Kiekis |
_amount: |
Suma |
CreateSalesOrder – gražina tekstą „OK“ su užsakymo numeriu arba „NO“, jei nepavyko.
Parameter |
Value |
user: |
Vartotojo vardas |
password: |
Slaptažodis |
_cust: |
Kliento kodas |
_paymMode: |
Mokėjimo būdas |
_incTax |
True - kainos užsakyme su PVM, ne – be PVM |
_currency |
'' - naudoja įmonės ar kliento valiutą |
_discPercent |
Nuolaidos dydis % |
CreateSalesLine – gražina tekstą „OK“ arba „NO“ su klaidos pranešimu.
Parameter |
Value |
user: |
Vartotojo vardas |
password: |
Slaptažodis |
_salesId: |
Pardavimo numeris |
_itemId: |
Prekės kodas |
_qty: |
Kiekis |
_amount: |
Suma |
CreateVend – gražina true/false;
Parameter |
Value |
user: |
Vartotojo vardas |
password: |
Slaptažodis |
_vend: |
Tiekėjo kodas sistemoje |
_name: |
Tiekėjo pavadinimas |
_group: |
Tiekėjo grupė (žr. monet.lt galimas vertes) |
_enterpriseCode: |
Tiekėjo įmonės kodas |
_vatnum: |
PVM kodas |
_address: |
Adresas |
ExistCust – gražina true/false;
Parameter |
Value |
user: |
Vartotojo vardas |
password: |
Slaptažodis |
_cust: |
Kliento kodas |
ExistCustByEnterpriseCode – gražina true/false;
Parameter |
Value |
user: |
Vartotojo vardas |
password: |
Slaptažodis |
_code: |
Įmonės kodas |
ExistItem – gražina true/false;
Parameter |
Value |
user: |
Vartotojo vardas |
password: |
Slaptažodis |
_itemId: |
Prekės kodas |
ExistVend – gražina true/false;
Parameter |
Value |
user: |
Vartotojo vardas |
password: |
Slaptažodis |
_vend: |
Tiekėjo kodas |
IsValidUser - gražina tekstą „OK“ ir įmonės pavadinimą;
Parameter |
Value |
user: |
Vartotojo vardas |
password: |
Slaptažodis |
PostPurch – gražina tekstą „OK“ arba „NO“ su klaidos pranešimu.
Parameter |
Value |
user: |
Vartotojo vardas |
password: |
Slaptažodis |
_purchId: |
Pirkimo numeris |
_invoice: |
SF numeris |
_date: |
SF data |
_amountInclTax: |
SF suma su PVM |
_tax: |
PVM suma |
_checkTax |
True – tikrina ir derina perduodamas sumas, ne – PVM skaičiavimą atlieka Monet.lt ir registruoja neatsižvelgiant į perduodamas sumas |
PostSales – gražina tekstą „OK“ arba „NO“ su klaidos pranešimu.
Parameter |
Value |
user: |
Vartotojo vardas |
password: |
Slaptažodis |
_salesId: |
Pardavimo numeris |
_invoice: |
SF numeris |
_date: |
SF data |
_amountInclTax: |
SF suma su PVM |
_tax: |
PVM suma |
_checkTax |
True – tikrina ir derina perduodamas sumas, ne – PVM skaičiavimą atlieka Monet.lt ir registruoja neatsižvelgiant į perduodamas sumas |
GetInventOnHand – gražina InventOnHand objektų sąrašą. Ojektą sudaro šie laukai: ItemId – prekės kodas, Name – prekės pavadinimas, Group – prekės grupės kodas, Qty – turimas fizinis kiekis, Location – sandėlio kodas.
Parameter |
Value |
user: |
Vartotojo vardas |
password: |
Slaptažodis |
_itemId: |
Prekės kodas. Jei reikšmė tuščia, gražina visas prekes |
GetCustByEnterpriseCode – gražina kliento kodą (ID).
Parameter |
Value |
user: |
Vartotojo vardas |
password: |
Slaptažodis |
_code: |
Kliento įmonės (asmens) kodas |
Pavyzdys:
Pardavimo įkėlimas ir registravimas. Pirma, sukuriame pardavimo užsakymą su 10 % nuolaida:
CreateSalesOrder('demo' , 'demo321', 'Kliento ID' , '' , false, 'EUR' , 10 )
CreateSalesOrder gražina užsakymo nr. Antra, sukuriame eilutes 2 eilutes po 10 vnt. už 100 ir 200 valiutos vienetų:
CreateSalesLine('demo' , 'demo321', 'užsakymo nr.' , 'prekės ID' , 10, 100)
CreateSalesLine('demo' , 'demo321', 'užsakymo nr.' , 'prekės ID' , 10, 200)
Jei pavyko, CreateSalesLine gražina tekstą OK. Jei ne, NO
Trečiu, paskutiniu žingsniu, registruojame užsakymą:
PostSales('demo' , 'demo321', 'užsakymo nr.' , 'SF numeris' , SF data, 550.05, 56.70, true)