Mahdollistaa massakäsittelyn myynti- ja ostolaskujen tuontiin rajapinnan yli. Voidaan tuoda isompi erä myynti- tai ostolaskuaineistoja. Suosittelemme, että yhdessä laskuerässä tuodaan maksimissaan 500 laskua. Voidaan kysellä erien tilatietoja tai yksittäisen erän ja sen laskujen tilatietoja.
Myynti- ja ostolaskuerän käsittely jakautuu seuraaviin toimintoihin:
Integraatio | HTTP-metodi | Resurssi | DTD | Skeema | Esimerkki |
Laskuerälistan nouto | GET | getbatchlist.nv | Lataa | ||
Laskuerän tilan nouto | GET | getbatchstatus.nv | Lataa | ||
Myyntilaskuerän tuonti | POST | salesinvoicebatch.nv | Lataa | Lataa | |
Ostolaskuerän tuonti | POST | purchaseinvoicebatch.nv | Lataa |
Laskuerälistan nouto
Resurssi: getbatchlist.nv
Kaikkien erien tilojen nouto.
Kutsussa käytettävät parametrit:
Parametri | Ilmentymiä | Kuvaus |
status | 0...1 | Sallitut arvot: pending, processing, finished. Palautettavaa listaa voidaan rajata erän tilalla. Esim. pending palauttaa vain ne erät joiden käsittely ei ole vielä alkanut. |
batchtype | 0...1 | Sallitut arvot: salesinvoice, purchaseinvoice Palautetaan joko myyntilaskuerät tai ostolaskuerät. Jos ei anneta niin palautetaan myyntilaskuerät |
Vastaus:
Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
Root | root | Aggregaatti | 1 | ||
1 | Batches | Aggregaatti | 1 | ||
2 | Batch | Aggregaatti | 1...n | ||
3 | ID | Kokonaisluku | 1 | ||
3 | Status | Merkkijono | 1 | Kuvaus erän tilasta, Ei ota millään tavalla kantaa onko myyntilaskut esim. lähetetty Netvisorista eteenpäin, vaan pelkästään mikä on erän käsittelyn tila Netvisorissa. Arvot: pending, processing, finished | pending |
3 | Statuscode | Kokonaisluku | 1 | Tilakoodi erän tilasta, linkittyy Status-tietoon. Ei ota millään tavalla kantaa onko myyntilaskut esim. lähetetty Netvisorista eteenpäin, vaan pelkästään mikä on erän käsittelyn tila Netvisorissa. 1 = pending, 2 = processing, 3 = finished | 1 |
3 | ImportTimestamp | Päivämäärä | 1 |
Laskuerän tilan nouto
Resurssi: getbatchstatus.nv
Yksittäisen erän ja sen laskujen tilan nouto.
Kutsussa käytettävät parametrit:
Parametri | Ilmentymiä | Kuvaus |
id | 1 | Haettavan erän Netvisor tunnus |
addsalesinvoicelinkinformation | 0...1 | Lisää palautettavaan sanomaan linkitystiedon mitä myyntilaskuja tuodusta erästä on luotu. Lisää sanomaan SalesInvoiceLinkInformation-elementin |
batchtype | 0...1 | Sallitut arvot: salesinvoice, purchaseinvoice Palautetaan joko myyntilaskuerät tai ostolaskuerät. Jos ei anneta niin palautetaan myyntilaskuerät |
addpurchaseinvoicelinkinformation | 0...1 | Lisää palautettavaan sanomaan linkitystiedon mitä myyntilaskuja tuodusta erästä on luotu. Lisää sanomaan PurchaseInvoiceLinkInformation-elementin |
Vastaus:
Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
Root | root | Aggregaatti | 1 | ||
1 | Batch | Aggregaatti | 1 | ||
2 | Summary | Aggregaatti | 1 | ||
3 | Status | Merkkijono | 1 | Kuvaus erän tilasta, EI ota millään tavalla kantaa onko myyntilaskut esim. lähetetty Netvisorista eteenpäin, vaan pelkästään mikä on erän käsittelyn tila Netvisorissa Arvot: pending, processing, finished | pending |
3 | StatusCode | Kokonaisluku | 1 | Tilakoodi erän tilasta, linkittyy Status-tietoon. EI ota millään tavalla kantaa onko myyntilaskut esim. lähetetty Netvisorista eteenpäin, vaan pelkästään mikä on erän käsittelyn tila Netvisorissa 1 = pending, 2 = processing, 3 = finished | 1 |
3 | ProcessingEndTime | Päivämäärä | 1 | ||
3 | BatchSize | Kokonaisluku | 1 | ||
3 | ItemsPendingCount | Kokonaisluku | 1 | ||
3 | ItemsSuccessCount | Kokonaisluku | 1 | ||
3 | ItemsErrorCount | Kokonaisluku | 1 | ||
2 | SalesInvoiceLinkInformation | Aggregaatti | 0...1 | Jos käytetty parameteria: addpurchaseinvoicelinkinformation Elementin nimi: PurchaseInvoiceLinkInformation | |
3 | Link | Aggregaatti | 1...n | ||
4 | ItemIdentifier | Merkkijono | 1 | Erän tuonnissa annettu tunnistetieto myyntilaskusanomalle | |
4 | NetvisorKey | Kokonaisluku | 1 | ||
2 | ItemErrorDescriptions | Aggregaatti | 0...1 | ||
3 | ItemError | Aggregaatti | 1...n | ||
4 | Identifier | Merkkijono | 1 | Erän tuonnissa annettu tunnistetieto myyntilaskusanomalle | |
4 | Errors | Aggregaatti | 1 | ||
5 | Error | Merkkijono | 1...n | ||
Attr. | Type | Merkkijono | Netvisorin APIn palauttama virhetyyppi, esim. INVALID_DATA, PERIOD_LOCK, TECHNICAL_ERROR… Tätä voidaan käyttää päättelemään minkälaisesta virheestä on kysymys | ||
Attr. | Value | Merkkijono | Virheen kuvaus |
Myyntilaskuerän tuonti
Resurssi: salesinvoicebatch.nv
Taso | Elementti | Muoto ja pituus | Ilmentymiä | Kuvaus | Esimerkki |
Root | root | Aggregaatti | 1 | ||
1 | salesinvoicebatch | Aggregaatti | 1 | ||
2 | sharedattachments | Aggregaatti | 0...1 | ||
3 | attachment | Aggregaatti | 1...n | ||
4 | mimetype | Merkkijono, max. 50 | 1 | Liitteen MIME-tyyppi | application/pdf |
4 | data | Merkkijono | 1 | Liitetiedosto Base64-enkoodattuna | |
Attr. | type | Merkkijono | 1 | finvoice tai pdf | finvoice |
4 | filename | Merkkijono, max.255 | 1 | Liitteen tiedostonimi | attachment.pdf |
4 | description | Merkkijono, max.100 | 1 | Liitteen kuvaus | Kuvaus |
4 | printbydefault | Kokonaisluku | 0...1 | HUOM! Ei saa antaa, jos annettu liitteen datan tyyppi on finvoice. Tällöin pyyntö hylätään 1 = true, 0 = false | 1 |
4 | itemlink | Aggregaatti | 1 | ||
5 | itemidentifier | Merkkijono, max. 50 | 1 | ||
2 | items | Aggregaatti | 1 | ||
3 | item | Aggregaatti | 1...n | ||
4 | identifier | Merkkijono, max. 50 | 1 | Laskuerän yhden laskun tunnistetieto Määritetään itse | |
4 | itemdata | XML | 1 | Validi SalesInvoice XML | Katso myyntilaskun tuonnin resurssikuvaus |
Ostolaskuerän tuonti
Resurssi: purchaseinvoicebatch.nv
Taso | Elementti | Muoto ja pituus | Ilmentymiä | Kuvaus | Esimerkki |
Root | root | Aggregaatti | 1 | ||
1 | purchaseinvoicebatch | Aggregaatti | 1 | ||
2 | sharedattachments | Aggregaatti | 0...1 | ||
3 | attachment | Aggregaatti | 1...n | ||
4 | mimetype | Merkkijono, max. 50 | 1 | ||
4 | data | Merkkijono | 1 | Liitetiedosto Base64-enkoodattuna | |
Attr. | documenttype | Merkkijono | 1 | otherattachment | otherattachment |
4 | filename | Merkkijono, max.255 | 1 | ||
4 | description | Merkkijono, max.100 | 1 | ||
4 | itemlink | Aggregaatti | 1 | ||
5 | itemidentifier | Merkkijono, max. 50 | 1...n | ||
2 | items | Aggregaatti | 1 | ||
3 | item | Aggregaatti | 1...n | ||
4 | identifier | Merkkijono, max. 50 | 1 | Laskuerän yhden laskun tunnistetieto Määritetään itse | |
4 | itemdata | XML | 1 | Validi PurchaseInvoice XML | Katso ostolaskun tuonnin resurssikuvaus |
Oliko tästä vastauksesta apua? Kyllä Ei
Send feedback