Ostotilauksen tuonti purchaseorder.nv

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 feedback