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.
  • Tilauksen valuutan asettamista ei ole vielä tuettu, currency-attribuutteihin syötetyt arvot jätetään toistaiseksi käsittelemättä.
  • Maksuehtoa, toimitusehtoa ja toimitustapaa haetaan annetuilla tiedoilla, jos vastaavaa ei löydetä, luodaan uusi.

Kutsussa käytettävät parametrit:

ParametriMuotoIlmentymiäKuvaus
methodMerkkijono1Add Lisää uutena tilauksena
Edit Muokkaa olemassa olevaa tilausta
idKokonaisluku0...1Muokattavan ostotilauksen Netvisor tunnus. Pakollinen jos method Edit

Purchaseorderproductline metodeihin liittyviä huomioita:

MetodiKuvaus
editJos käytetään, ei saa sisältää ostotilausrivin osatoimistustietoja (purchaseorderproductlinepartialdelivery) ja voi sisältää vain sellaiset elementit joita halutaan muokata
deleteJos käytetään, ostotilausrivin (purchaseorderproductline) on oltava tyhjä
partialdeliverKä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)
addtopartialdeliverygroupKä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ää.
ParametriKuvaus
netvisorkeyPakollinen 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:

TasoElementtiMuotoIlmentymiäKuvausEsimerkki
RootrootAggregaatti1  
1purchaseorderAggregaatti1Tilauksen päätiedot 
2ordernumberKokonaisluku0...1Tilauksen numero
Pakollinen, kun luodaan uutta ostolaskua
141128
2orderstatusMerkkijono0...1Tilauksen tila, 
Pakollinenkun luodaan uutta ostolaskua.
Tilat:
proposal - Hankintaehdotus
approved - Hyväksytty
senttovendor - Lähetetty toimittajalle
archived - Arkistoitu
approved
2orderdatePäivämäärä0...1Tilauksen päivämäärä, 
Pakollinenkun luodaan uutta ostolaskua
2023-01-28
Attr.formatMerkkijono1Päivämäärän muoto, aina ansiansi
2vendoridentifierMerkkijono0...1Toimittajan tunnistetieto,
Pakollinenkun luodaan uutta ostolaskua
123
Attr.typeMerkkijono1Tunnistetiedon tyyppi
netvisor 
- Toimittajan Netvisor-avain
code
- Toimittajan koodi
organisationidentifier 
- Toimittajan Y-tunnus
netvisor
2purchaseordervendordetailsAggregaatti0...1Toimittajan päätiedot
 
3addressMerkkijono1Toimittajan osoite, jos ei annettuPajukuja 5
3postnumberMerkkijono1Toimittajan postinumero53921
3cityMerkkijono1Toimittajan postitoimipaikkaLappeenranta
3countryMerkkijono1Toimittajan maakoodiFI
Attr.typeMerkkijono1Maakoodin tyyppi, aina ISO-3166ISO-3166
2deliverytermMerkkijono0...1ToimitusehtoVapaasti toimittajalla
2deliverymethodMerkkijono0...1ToimitustapaNoudetaan
2purchaseorderdeliverydetailsAggregaatti0...1Toimituksen vastaanottajan päätiedot
 
3nameMerkkijono0...1Toimituksen vastaanottajan nimiYritys Oy
3addressMerkkijono0...1Toimituksen vastaanottajan osoiteKoulukatu 51
3postnumberMerkkijono0...1Toimituksen vastaanottajan postinumero53945
3deliverycityMerkkijono0...1Toimituksen vastaanottajan postitoimipaikkaLappeenranta
3deliverycountryMerkkijono0...1Toimituksen vastaanottajan maakoodiFI
Attr.typeMerkkijono1Maakoodin tyyppi, aina ISO-3166ISO-3166
2privatecommentMerkkijono0...1Sisäinen vapaa kommenttiteksti, ei näy tulosteella 
2commentMerkkijono0...1Vapaa komenttiteksti, näkyy tulosteella 
2ourreferenceMerkkijono0...1Meidän viitteemme1411281
2currencycodeMerkkijono0...1Tilauksessa käytettävän valuutan lyhenne
USD
Attr.typeMerkkijono1Valuutan lyhenteen tyyppi aina ISO-4217 muodossa
ISO-4217
2purchaseorderpaymenttermAggregaatti0...1Maksuehdon päätiedot 
3netdaysKokonaisluku1Maksuehdon nettopäivät14
3discountdaysKokonaisluku1Maksuehdon kassa-alennuspäivät10
3discountpercentDesimaaliluku1Maksuehdon alennusprosentti7,5
2purchaseorderlinesAggregaatti0...1Tilauksen tuoterivit,
Pakollinenkun luodaan uutta ostolaskua
 
3purchaseorderproductlineAggregaatti0...nTilauksen tuoterivi 
Attr.methodMerkkijono0...1Tuoterivin 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.netvisorkeyKokonaisluku0...1Tuoterivin ID, Pakollinen, kun muokataan ostotilauksen rivitietoja
 
4purchaseorderproductlinepartialdeliveryAggregaatti0...1Osatoimituksen tiedot
 
5purchaseorderproductlinepartialdeliverycontentAggregaatti1...nOsatoimituksen tieto
 
6orderedamountDesimaaliluku1Tilattujen tuotteiden määrä10,00
6deliveredamountDesimaaliluku1Toimitettujen tuotteiden määrä
5,00
6deliveryreceiveddate
1Tuotteiden toimitus päivämäärä
2023-01-28
Attr.formatMerkkijono1Päivämäärän muoto, aina ansiansi
6deliverymanuallyconfirmedMerkkijono0...1Toimitus käsin vahvistettu, vaikka toimitettu poikkeava määrätrue
tai
false
6deliveredproductqualityKokonaisluku0...1Toimitetun tuotteen laatu 1
6inventorybatchnumber
Kokonaisluku0...1Toimitetun tuotteen eränumero. Max 20 merkkiä.1234
6inventorymanufacturedate
Päivämäärä0...1Toimitetun tuotteen valmistuspäivä2023-05-31
Attr.formatMerkkijono1Päivämäärän muoto, aina ansi
ansi
6inventorypackagingdate
Päivämäärä0...1Toimitetun tuotteen pakkauspäivä2023-06-01
Attr.formatMerkkijono1Päivämäärän muoto, aina ansi
ansi
6inventorybestbeforedate
Päivämäärä0...1Toimitetun tuotteen parasta ennen -päivä2023-10-25
Attr.formatMerkkijono1Päivämäärän muoto, aina ansiansi
6inventoryexpirydate
Päivämäärä0...1Toimitetun tuotteen viimeinen käyttöpäivä2023-10-25
Attr.formatMerkkijono1Päivämäärän muoto, aina ansi
ansi
4productcodeMerkkijono1Tuotteen tunnistetieto, 
Pakollinen, kun luodaan uusi tuoterivi. 
Jos type-attribuuttia ei anneta, riviä ei linkitetä Netvisorin tuoterekisterin tuotteeseen
1017
Attr.typeMerkkijono0...1Tunnisteen tyyppi
netvisor - Tuotteen NetvisorKey
customer - Tuotteen tuotekoodi
customer
4vendorproductcodeMerkkijono0...1Toimittajan koodi tuotteelleTK100
4vendorproductnameMerkkijono0...1Toimittajan tuotenimiTuote100
4orderedamountDesimaaliluku0...1Tilattujen tuotteiden määrä, Pakollinen, kun luodaan uusi tuoterivi.10,00
4unitpriceDesimaaliluku0...1Tuotteen veroton yksikköhinta valuutassa52,50
4vatpercentDesimaaliluku0...1Tuotteen ALV-prosentti,
Pakollinen, kun luodaan uusi tuoterivi.
24
4freightrateDesimaaliluku0...1Toimituskustannukset22,50
4linecommentMerkkijono0...1Kommentti (max. 255 merkkiä) 
4deliverydatePäivämäärä0...1Rivin tuotteiden toimituspäivämäärä,
Pakollinen, kun luodaan uusi tuoterivi.
2023-01-28
Attr.formatMerkkijono1Päivämäärän muoto, aina ansiansi
4purchaseorderproductlinedeliverydetailsAggregaatti0...1Tuotteen toimitustiedot 
5deliveredamountDesimaaliluku1Vastaanotetun/toimitetun tuotteen määrä5,0
5deliveryreceiveddatePäivämäärä
1Vastaanotto/toimitus päivämäärä 
Attr.formatMerkkijono1Päivämäärän muoto, aina ansiansi
5deliverymanuallyconfirmedMerkkijono0...1Toimitus käsin vahvistettu, vaikka toimitettu poikkeava määrä"true"
tai
"false"
5deliveredproductqualityKokonaisluku0...1Toimitetun tuotteen laatu 
5
inventoryplaceMerkkijono0...1Käytettävän varaston tunnus12
Attr.typeMerkkijono1Varaston tunnuksen tyyppi
netvisor - Varaston Netvisor-tunnus,täytyy löytyä Netvisorista
customer - Varastopaikan nimi, täytyy löytyä Netvisorista
netvisor
5accountingsuggestionKokonaisluku0...1Tiliöintiehdotus, kirjanpidon tilin tulee löytyä Netvisorista4020
4purchaseorderproductlinedimensionsAggregaatti0...1Tuoterivien laskentakohteet 
5dimensionAggregaatti0...nTuoterivin laskentakohde 
6dimensionnameMerkkijono1LaskentakohdeotsikkoHankinta
6dimensionitemMerkkijono1LaskentakohdeTarvikkeet
3purchaseordercommentlineMerkkijono0...1Tilauksen kommenttirivit 
Attr.methodMerkkijono0...1Kommenttirivin metodi
add - Lisää uusi rivi (oletusarvo)
edit - Muokkaa olemassa olevaa
delete - Poista rivi
 
Attr.netvisorkeyKokonaisluku0...1Kommenttirivin ID
Pakollinen,
jos metodi
edit
tai
delete
4commentMerkkijono0...1Komenttirivin tekstiAkkutilaus

Huomaathan:

ElementtiMetodiKuvaus
purchaseordercommentlinedeleteJos käytetään tätä metodia, elementin "purchaseordercommentline" sisältö(kommentti) on oltava tyhjä


Oliko tästä vastauksesta apua? Kyllä Ei

Send feedback
Pahoittelut, että emme voineet auttaa. Anna palautetta, jotta voimme parantaa tätä artikkelia.