Resurssi: purchaseorder.nv
HTTP-metodi: POST
Ostotilauksia voidaan tuoda Netvisoriin purchaseorder.nv rajapintaresurssilla. Tilauksen tuontiin vaaditaan:
- tilausnumero
- tilauksen päivämäärä
- toimittajan tiedot
Jos tuodaan tuoterivejä, niille vaaditaan tuotekoodi ja määrä, sekä kommenttirivi vaatii kommentin.
Huomioitavaa:
- Muokattaessa tilausta, sanomalla annetaan vain ne tiedot mitä halutaan muokata. Sanomalla ei tarvitse antaa tällöin kaikkia pakollisia tietoja.
- Maksuehtoa, toimitusehtoa ja toimitustapaa haetaan annetuilla tiedoilla, jos vastaavaa ei löydetä, luodaan uusi.
Kutsussa käytettävät parametrit:
| Parametri | Muoto | Ilmentymiä | Kuvaus |
| method | Merkkijono | 1 | Add Lisää uutena tilauksena Edit Muokkaa olemassa olevaa tilausta |
| id | Kokonaisluku | 0...1 | Muokattavan ostotilauksen Netvisor tunnus. Pakollinen jos method Edit |
Purchaseorderproductline metodeihin liittyviä huomioita:
| Metodi | Kuvaus |
| edit | Jos käytetään, ei saa sisältää ostotilausrivin osatoimistustietoja (purchaseorderproductlinepartialdelivery) ja voi sisältää vain sellaiset elementit joita halutaan muokata |
| delete | Jos käytetään, ostotilausrivin (purchaseorderproductline) on oltava tyhjä |
| partialdeliver | Käytetään osatoimitusrivien tuontiin. Jos käytetään, pitää sisältää vähintään kaksi osatoimitusriviä (purchaseorderproductlinepartialdeliverycontent). Osatoimituksen tiedoissa (purchaseorderproductlinepartialdeliverycontent) tilattujen tuotteiden määrän (orderedamount) arvojen pitää vastata kohteena olevan tuoterivin tilattujen tuotteiden määrää (orderedamount:ia) |
| addtopartialdeliverygroup | Käytetään osatoimitusrivin lisäämiseen. Jos käytetään, pitää sisältää vähintään yksi osatoimitusrivi (purchaseorderproductlinepartialdeliverycontent). Jos muokataan osatoimitettujen tuotteiden virheellistä määrää (orderedamount:ia), pitää lisätä jäljelle jäävä osatoimitusrivi sekä päivittää myös jotain osatoimistusriviä toimitettujen tuotteiden määrän (orderedamount) osalta. Osatoimitettujen tuotteiden määrän (orderedamount:ien) summan tulee vastata alkuperäistä ostotilausrivin tilattujen tuotteiden määrää. |
| Parametri | Kuvaus |
| netvisorkey | Pakollinen jos käytetään muita metodeja kuin add |
Tuotavan ostotilauksen tiedot lähetetään (POST) kutsun mukana oheisen kuvauksen mukaisena XML:nä:
Huomioitavaa kuvausta luettaessa:
| Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
| Root | root | Aggregaatti | 1 | ||
| 1 | purchaseorder | Aggregaatti | 1 | Tilauksen päätiedot | |
| 2 | ordernumber | Kokonaisluku | 0...1 | Tilauksen numero Pakollinen, kun luodaan uutta ostolaskua | 141128 |
| 2 | orderstatus | Merkkijono | 0...1 | Tilauksen tila, Pakollinen, kun luodaan uutta ostolaskua. Tilat: proposal - Hankintaehdotus approved - Hyväksytty senttovendor - Lähetetty toimittajalle archived - Arkistoitu | approved |
| 2 | orderdate | Päivämäärä | 0...1 | Tilauksen päivämäärä, Pakollinen, kun luodaan uutta ostolaskua | 2023-01-28 |
| Attr. | format | Merkkijono | 1 | Päivämäärän muoto, aina ansi | ansi |
| 2 | vendoridentifier | Merkkijono | 0...1 | Toimittajan tunnistetieto, Pakollinen, kun luodaan uutta ostolaskua | 123 |
| Attr. | type | Merkkijono | 1 | Tunnistetiedon tyyppi netvisor - Toimittajan Netvisor-avain code - Toimittajan koodi organisationidentifier - Toimittajan Y-tunnus | netvisor |
| 2 | purchaseordervendordetails | Aggregaatti | 0...1 | Toimittajan päätiedot | |
| 3 | address | Merkkijono | 1 | Toimittajan osoite, jos ei annettu | Pajukuja 5 |
| 3 | postnumber | Merkkijono | 1 | Toimittajan postinumero | 53921 |
| 3 | city | Merkkijono | 1 | Toimittajan postitoimipaikka | Lappeenranta |
| 3 | country | Merkkijono | 1 | Toimittajan maakoodi | FI |
| Attr. | type | Merkkijono | 1 | Maakoodin tyyppi, aina ISO-3166 | ISO-3166 |
| 2 | deliveryterm | Merkkijono | 0...1 | Toimitusehto | Vapaasti toimittajalla |
| 2 | deliverymethod | Merkkijono | 0...1 | Toimitustapa | Noudetaan |
| 2 | purchaseorderdeliverydetails | Aggregaatti | 0...1 | Toimituksen vastaanottajan päätiedot | |
| 3 | name | Merkkijono | 0...1 | Toimituksen vastaanottajan nimi | Yritys Oy |
| 3 | address | Merkkijono | 0...1 | Toimituksen vastaanottajan osoite | Koulukatu 51 |
| 3 | postnumber | Merkkijono | 0...1 | Toimituksen vastaanottajan postinumero | 53945 |
| 3 | deliverycity | Merkkijono | 0...1 | Toimituksen vastaanottajan postitoimipaikka | Lappeenranta |
| 3 | deliverycountry | Merkkijono | 0...1 | Toimituksen vastaanottajan maakoodi | FI |
| Attr. | type | Merkkijono | 1 | Maakoodin tyyppi, aina ISO-3166 | ISO-3166 |
| 2 | privatecomment | Merkkijono | 0...1 | Sisäinen vapaa kommenttiteksti, ei näy tulosteella | |
| 2 | comment | Merkkijono | 0...1 | Vapaa komenttiteksti, näkyy tulosteella | |
| 2 | ourreference | Merkkijono | 0...1 | Meidän viitteemme | 1411281 |
| 2 | currencycode | Merkkijono | 0...1 | Tilauksessa käytettävän valuutan lyhenne | USD |
| Attr. | type | Merkkijono | 1 | Valuutan lyhenteen tyyppi aina ISO-4217 muodossa | ISO-4217 |
| 2 | purchaseorderpaymentterm | Aggregaatti | 0...1 | Maksuehdon päätiedot | |
| 3 | netdays | Kokonaisluku | 1 | Maksuehdon nettopäivät | 14 |
| 3 | discountdays | Kokonaisluku | 1 | Maksuehdon kassa-alennuspäivät | 10 |
| 3 | discountpercent | Desimaaliluku | 1 | Maksuehdon alennusprosentti | 7,5 |
| 2 | purchaseorderlines | Aggregaatti | 0...1 | Tilauksen tuoterivit, Pakollinen, kun luodaan uutta ostolaskua | |
| 3 | purchaseorderproductline | Aggregaatti | 0...n | Tilauksen tuoterivi | |
| Attr. | method | Merkkijono | 0...1 | Tuoterivin metodi add - Lisää uusi tuoterivi (oletus arvo) edit - Editoi tuoteriviä delete - Poista tuoterivi partialdeliver - Osatoimitus tuoteriville addtopartialdeliverygroup - Lisää uusi rivi osatoimitusryhmään | add (lue metodin lisätiedot alusta) |
| Attr. | netvisorkey | Kokonaisluku | 0...1 | Tuoterivin ID, Pakollinen, kun muokataan ostotilauksen rivitietoja | |
| 4 | purchaseorderproductlinepartialdelivery | Aggregaatti | 0...1 | Osatoimituksen tiedot | |
| 5 | purchaseorderproductlinepartialdeliverycontent | Aggregaatti | 1...n | Osatoimituksen tieto | |
| 6 | orderedamount | Desimaaliluku | 1 | Tilattujen tuotteiden määrä | 10,00 |
| 6 | deliveredamount | Desimaaliluku | 1 | Toimitettujen tuotteiden määrä | 5,00 |
| 6 | deliveryreceiveddate | 1 | Tuotteiden toimitus päivämäärä | 2023-01-28 | |
| Attr. | format | Merkkijono | 1 | Päivämäärän muoto, aina ansi | ansi |
| 6 | deliverymanuallyconfirmed | Merkkijono | 0...1 | Toimitus käsin vahvistettu, vaikka toimitettu poikkeava määrä | true tai false |
| 6 | deliveredproductquality | Kokonaisluku | 0...1 | Toimitetun tuotteen laatu | 1 |
| 6 | inventorybatchnumber | Kokonaisluku | 0...1 | Toimitetun tuotteen eränumero. Max 20 merkkiä. | 1234 |
| 6 | inventorymanufacturedate | Päivämäärä | 0...1 | Toimitetun tuotteen valmistuspäivä | 2023-05-31 |
| Attr. | format | Merkkijono | 1 | Päivämäärän muoto, aina ansi | ansi |
| 6 | inventorypackagingdate | Päivämäärä | 0...1 | Toimitetun tuotteen pakkauspäivä | 2023-06-01 |
| Attr. | format | Merkkijono | 1 | Päivämäärän muoto, aina ansi | ansi |
| 6 | inventorybestbeforedate | Päivämäärä | 0...1 | Toimitetun tuotteen parasta ennen -päivä | 2023-10-25 |
| Attr. | format | Merkkijono | 1 | Päivämäärän muoto, aina ansi | ansi |
| 6 | inventoryexpirydate | Päivämäärä | 0...1 | Toimitetun tuotteen viimeinen käyttöpäivä | 2023-10-25 |
| Attr. | format | Merkkijono | 1 | Päivämäärän muoto, aina ansi | ansi |
| 4 | productcode | Merkkijono | 1 | Tuotteen tunnistetieto, Pakollinen, kun luodaan uusi tuoterivi. Jos type-attribuuttia ei anneta, riviä ei linkitetä Netvisorin tuoterekisterin tuotteeseen | 1017 |
| Attr. | type | Merkkijono | 0...1 | Tunnisteen tyyppi netvisor - Tuotteen NetvisorKey customer - Tuotteen tuotekoodi | customer |
| 4 | vendorproductcode | Merkkijono | 0...1 | Toimittajan koodi tuotteelle | TK100 |
| 4 | vendorproductname | Merkkijono | 0...1 | Toimittajan tuotenimi | Tuote100 |
| 4 | orderedamount | Desimaaliluku | 0...1 | Tilattujen tuotteiden määrä, Pakollinen, kun luodaan uusi tuoterivi. | 10,00 |
| 4 | unitprice | Desimaaliluku | 0...1 | Tuotteen veroton yksikköhinta valuutassa | 52,50 |
| 4 | vatpercent | Desimaaliluku | 0...1 | Tuotteen ALV-prosentti, Pakollinen, kun luodaan uusi tuoterivi. | 24 |
| 4 | freightrate | Desimaaliluku | 0...1 | Toimituskustannukset | 22,50 |
| 4 | linecomment | Merkkijono | 0...1 | Kommentti (max. 255 merkkiä) | |
| 4 | deliverydate | Päivämäärä | 0...1 | Rivin tuotteiden toimituspäivämäärä, Pakollinen, kun luodaan uusi tuoterivi. | 2023-01-28 |
| Attr. | format | Merkkijono | 1 | Päivämäärän muoto, aina ansi | ansi |
| 4 | purchaseorderproductlinedeliverydetails | Aggregaatti | 0...1 | Tuotteen toimitustiedot | |
| 5 | deliveredamount | Desimaaliluku | 1 | Vastaanotetun/toimitetun tuotteen määrä | 5,0 |
| 5 | deliveryreceiveddate | Päivämäärä | 1 | Vastaanotto/toimitus päivämäärä | |
| Attr. | format | Merkkijono | 1 | Päivämäärän muoto, aina ansi | ansi |
| 5 | deliverymanuallyconfirmed | Merkkijono | 0...1 | Toimitus käsin vahvistettu, vaikka toimitettu poikkeava määrä | "true" tai "false" |
| 5 | deliveredproductquality | Kokonaisluku | 0...1 | Toimitetun tuotteen laatu | |
| 5 | inventoryplace | Merkkijono | 0...1 | Käytettävän varaston tunnus | 12 |
| Attr. | type | Merkkijono | 1 | Varaston tunnuksen tyyppi netvisor - Varaston Netvisor-tunnus,täytyy löytyä Netvisorista customer - Varastopaikan nimi, täytyy löytyä Netvisorista | netvisor |
| 5 | accountingsuggestion | Kokonaisluku | 0...1 | Tiliöintiehdotus, kirjanpidon tilin tulee löytyä Netvisorista | 4020 |
| 4 | purchaseorderproductlinedimensions | Aggregaatti | 0...1 | Tuoterivien laskentakohteet | |
| 5 | dimension | Aggregaatti | 0...n | Tuoterivin laskentakohde | |
| 6 | dimensionname | Merkkijono | 1 | Laskentakohdeotsikko | Hankinta |
| 6 | dimensionitem | Merkkijono | 1 | Laskentakohde | Tarvikkeet |
| 3 | purchaseordercommentline | Merkkijono | 0...1 | Tilauksen kommenttirivit | |
| Attr. | method | Merkkijono | 0...1 | Kommenttirivin metodi add - Lisää uusi rivi (oletusarvo) edit - Muokkaa olemassa olevaa delete - Poista rivi | |
| Attr. | netvisorkey | Kokonaisluku | 0...1 | Kommenttirivin ID | Pakollinen, jos metodi edit tai delete |
| 4 | comment | Merkkijono | 0...1 | Komenttirivin teksti | Akkutilaus |
Huomaathan:
| Elementti | Metodi | Kuvaus |
| purchaseordercommentline | delete | Jos käytetään tätä metodia, elementin "purchaseordercommentline" sisältö(kommentti) on oltava tyhjä |
Oliko tästä vastauksesta apua? Kyllä Ei
Send feedbackPahoittelut, että emme voineet auttaa. Anna palautetta, jotta voimme parantaa tätä artikkelia.