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 feedbackPahoittelut, että emme voineet auttaa. Anna palautetta, jotta voimme parantaa tätä artikkelia.