Resurssi: product.nv
HTTP-metodi: POST
Huom! Mikäli Netvisorissa käytetään Rackbeat varastonhallintaa, löytyvät rajapintakuvaukset täältä: https://support.netvisor.fi/fi/articles/766869-rackbeat-stoplight-rajapinta
Laajennetun tuotehallinnan osalta voi rajapinnan yli tuoda uuden tuotteen alla olevan kuvauksen mukaisesti, mutta rajapinnan yli ei ole tuettu tuotteiden päivittäminen laajennetun tuotehallinnan kanssa.
Kutsussa käytettävät parametrit (QueryString):
Parametri | Ilmentymiä | Kuvaus | Esimerkki |
method | 1 | add tai edit | add |
id | 0..1 | Jos method on edit, tarvitaan muokattavan tuotteen id | 123 |
useonlyexistingdimensions | 0...1 | Estää uusien laskentakohdeotsikkojen ja laskentakohteiden automaattisen luonnin. Palauttaa virheen, jos annettua laskentakohdetta ei ole olemassa. | 1 |
Mikäli metodia ei ole annettu tai päivitettävää tuotetta ei löydy järjestelmästä, palautetaan INVALID_DATA –virhe selitteineen. Päivitettävän tuotteen id:n saa tietoon kysymällä ensin tuotelistaa.
Tuotteen tiedot voidaan esittää tarkasti uusien paino-kenttien avulla (productnetweight, productgrossweigh ja productweightunit), suositellaan ettei vanhaa tuotteen paino-kenttää enää käytettäisi (unitweight). Kenttää on mahdollista käyttää edelleen taaksepäin yhteensopivuuden takaamiseksi, mutta käyttöliittymässä kaikki olemassa olevien tuotteiden painoyksiköt muuttuvat kiloiksi (kg) ja ilmaistaan nettopaino-kentässä.
Huomioittehan tuotetietojen tuonnissa ja muokkauksessa, että Netvisoriin pystyy perustamaan samalla tuotekoodilla useita tuotteita.
Tuotavat tiedot lähetetään kutsun mukana oheisen kuvauksen mukaisena xml:nä (POST-data):
Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
Root | root | Aggregaatti | 1 |
|
|
1 | product | Aggregaatti | 1 |
|
|
2 | productbaseinformation | Aggregaatti | 1 |
|
|
3 | productcode | Merkkijono, max 50 merkkiä | 0...1 | Tuotekoodi | CC |
3 | productgroup | Merkkijono | 1 | Tuoteryhmän nimi, tuote lisätään ryhmään mikäli tuoteryhmä löytyy järjestelmästä. Jos ei löydy, se perustetaan | Kirjat |
3 | name | Merkkijono, max 200 merkkiä | 1 | Tuotteen nimi | Code Complete |
3 | description | Merkkijono | 0...1 | Kuvaus | Toinen painos |
3 | unitprice | Numeerinen | 1 | Tuotteen yksikköhinta | 42,5 |
Attr. | type | Merkkijono | 1 | Kertoo onko annettu hinta verollinen (gross) vai veroton (net). | net |
3 | unit | Merkkijono, max 50 merkkiä | 0...1 | Tuotteen yksikkö, jos annettua yksikkö ei löydy järjestelmästä se perustetaan. Jos löytyy, käytetään olemassa olevaa. | kpl |
3 | unitweight | Merkkijono | 0...1 | Tuotteen yksikköpaino kahdella desimaalilla. Suositellaan ettei tätä painokenttää (unitweight) enää käytettäisi, vaan käytettäisiin uusia painokenttiä (productnetweight, productgrossweigh ja productweightunit) | 1,00 |
3 | purchaseprice | Numeerinen | 0...1 | Hankintahinta | 25 |
3 | tariffheading | Merkkijono | 0...1 | Tullinimike | Code complete |
3 | comissionpercentage | Numeerinen | 0...1 | Provisioprosentti | 11 |
3 | isactive | Numeerinen | 1 | Onko tuote aktiivinen, 0 = ei-aktiivinen / 1 = aktiivinen | 1 |
3 | issalesproduct | Numeerinen | 1 | Onko tuote myyntituote, 0 = ei / 1 = kyllä | 0 |
3 | inventoryenabled | Numeerinen | 0...1 | Onko tuote varastoitava, 0 = ei / 1 = kyllä | 1 |
3 | inventorybatchlinkingmode | Numeerinen | 0...1 | Eräkäsittelytyyppi. Sallitut arvot: | 4 |
3 | countryoforigin | Merkkijono | 0...1 | Alkuperämaa | FI |
Attr. | type | Merkkijono | 0...1 | Aina ISO-3166 | ISO-3166 |
3 | primaryeancode | Merkkijono | 0...1 | Tuotteen ensisijainen EAN-koodi | 123456789012 |
Attr. | type | Merkkijono | 0...1 | EAN-koodin tyyppi. Rajapinta tarkistaa EAN-koodin muodon tyypin mukaan. | ean13 |
3 | secondaryeancode | Merkkijono | 0...1 | Tuotteen toissijainen EAN-koodi | 12345689012 |
Attr | type | Merkkijono | EAN-koodin tyyppi. Rajapinta tarkistaa EAN-koodin muodon tyypin mukaan. | ean13 | |
3 | inventoryalertlimit | Numeerinen | 0...1 | Hälytysraja | 20,50 |
2 | productbookkeepingdetails | Aggregaatti | 0...1 |
|
|
3 | defaultvatpercentage | Numeerinen | 1 | Alv-kanta, jos annettua verokantaa ei löydy järjestelmästä palautetaan virhe | 24 |
3 | defaultdomesticaccountnumber | Numeerinen | 0...1 | Kotimaan myyntitili | 3000 |
3 | defaulteuaccountnumber | Numeerinen | 0...1 | EU-myyntitili | 3360 |
3 | defaultoutsideeuaccountnumber | Numeerinen | 0...1 | Yhteisön ulkopuolisen myynnnin tili | 3380 |
2 | productadditionalinformation | Aggregaatti | 0...1 |
|
|
3 | productnetweight | Numeerinen | 0...1 | Nettopaino | 11,2 |
3 | productgrossweight | Numeerinen | 0...1 | Bruttopaino | 12,6 |
3 | productweightunit | Merkkijono | 0...1 | Netto- ja bruttopainon yksikkö: g, kg tai tn | kg |
3 | dimension | Aggregaatti | 0...1 | ||
4 | dimensionname | Merkkijono | 1 | Laskentakohdeotsikon nimi. Luodaan tarvittaessa. | Project |
4 | dimensionitem | Merkkijono | 1 | Laskentakohde. Luodaan tarvittaessa. | Project 1 |
4 | dimensionitemcode | Merkkijono | 0...1 | Laskentakohteen koodi | DIMC-001 |
4 | dimensionitemname | Merkkijono | 0...1 | Laskentakohteen nimi | Item Name 1 |
3 | productpackageinformation | Aggregaatti | 0...1 |
|
|
4 | packagewidth | Numeerinen | 1 | Pakkauksen leveys senttimetreinä | 7,3 |
4 | packageheight | Numeerinen | 1 | Pakkauksen korkeus senttimetreinä | 15,0 |
4 | packagelength | Numeerinen | 1 | Pakkauksen pituus senttimetreinä | 36,1 |
2 | productcustomtags | Aggregaatti | 0..1 | ||
3 | productcustomtag | Aggregaatti | 1...n | ||
4 | tagname | Merkkijono | 1 | Lisätietokentän nimi. | Pvm kenttä |
4 | tagvalue | Merkkijono | 1 | Lisätietokentän arvo. | 2022-01-01 |
Attr. | datatype | Merkkijono | 1 | Lisätietokentän tyyppi. date, text, decimal tai enum | date |