Siirry pääsisältöön

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

useonlyexistingdimensions

Kokonaisluku

0...1

Estää uusien laskentakohdeotsikkojen ja laskentakohteiden automaattisen luonnin. Palauttaa virheen, jos annettua laskentakohdetta ei ole olemassa.

1=esto käytössä

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ä
Esimerkki: <purchaseorderproductline method="delete" netvisorkey="1 "></purchaseorderproductline>

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 ostotilausta

141128

2

orderstatus

Merkkijono

0...1

Tilauksen tila,
Pakollinen, kun luodaan uutta ostotilausta.
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 ostotilausta

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 ostotilausta

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

city

Merkkijono

0...1

Toimituksen vastaanottajan postitoimipaikka

Lappeenranta

3

country

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 ostotilausta

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

4

dimensionitemcode

Merkkijono

0...1

Laskentakohteen koodi

(kun tämä on annettu, ohitetaan dimensionitem -elementti)

DIMC-001

4

dimensionitemname

Merkkijono

0...1

Laskentakohteen nimi

(kun tämä on annettu, ohitetaan dimensionitem -elementti)

Item Name 1

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ä

Vastasiko tämä kysymykseesi?