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/support/solutions/articles/77000554491-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 |
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ä.
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: Ei eräkäsittelyä = 1 Manuaalinen erävalinta = 2 Toimituspäivän mukaan nuorimmat ensin = 3 Toimituspäivän mukaan vanhimmat ensin = 4 (FIFO) Viimeisen käyttöpäivän mukaan uusimmat ensin = 5 Viimeisen käyttöpäivän mukaan vanhimmat ensin = 6 Valmistuspäiväyksen mukaan uusimmat ensin = 7 Valmistuspäiväyksen mukaan vanhimmat ensin = 8 | 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. any, ean8, ean13, code128. | ean13 |
| 3 | secondaryeancode | Merkkijono | 0...1 | Tuotteen toissijainen EAN-koodi | 12345689012 |
| Attr | type | Merkkijono | EAN-koodin tyyppi. Rajapinta tarkistaa EAN-koodin muodon tyypin mukaan. any, ean8, ean13, code128. | 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 |
| 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 |
Oliko tästä vastauksesta apua? Kyllä Ei
Send feedbackPahoittelut, että emme voineet auttaa. Anna palautetta, jotta voimme parantaa tätä artikkelia.