Resurssi: salesinvoicelist.nv
HTTP-metodi: GET
Tällä resurssilla voidaan hakea parametrin ListType arvoa vaihtamalla joko myyntilaskulista tai tilauslista.
Kutsussa käytettävät parametrit:
| Parametri | Ilmentymiä | Kuvaus | Esimerkki |
| listtype | 0...1 | Ei arvoa kun haetaan myyntilaskulistaa ja preinvoice kun haetaan tilauslistaa | |
| invoicesabovenetvisorkey | 0...1 | Rajaa kaikki laskut/tilaukset jälkeen annetun tietokannan id:n | 165 |
| begininvoicedate | 0...1 | Laskut/tilaukset, joissa päivämäärä suurempi tai yhtäsuuri | 2012-01-01 |
| endinvoicedate | 0...1 | Laskut/tilaukset, joissa päivämäärä pienempi tai yhtäsuuri | 2012-12-31 |
| invoicenumber | 0...1 | Rajaa listan lasku-/tilausnumerolla | |
| invoicestatus | 0...1 | Rajaa listan laskun tai myyntitilauksen tilalla, ks. taulukko. Hakee sekä InvoiceStatus kentästä että SubStatus attribuutista. | open undelivered |
| lastmodifiedstart | 0...1 | Hakee myyntilaskut, joita on muutettu annetun päivämäärän jälkeen | 2012-10-23 |
| lastmodifiedend | 0...1 | Hakee myyntilaskut, joita on muutettu ennen annettua päivämäärää | 2012-10-24 |
| salesinvoicebatchid | 0...1 | Rajaa myyntilaskuerässä tuodut myyntilaskut annetun erä ID:n mukaisesti. Katso myyntilaskuerän käsittelyn kuvaukset. | |
| customercode | 0...1 | Rajaa listan asiakaskoodilla | 1234567 |
| customernetvisorkey | 0...1 | Rajaa listan asiakkaan Netvisor ID :llä | 11 |
| secondname | 0...1 | Rajaa listaan myyntilaskut aputoiminimen nimellä | Aputoiminimi Oy |
| secondnamenetvisorkey | 0...1 | Rajaa listaan myyntilaskut aputoiminimen Netvisor ID:llä | 2 |
| invoicingcustomercontrycode | 0...1 | Rajaa listaan myyntilaskut asiakkaan laskutusmaan mukaan | DE |
| replyoption | 0...1 | Arvolla 1 palautetaan laskun sisäinen kommentti. Arvolla 2 palautetaan laskun valuuttasumma ja avoin valuuttasumma. Arvolla 3 palautetaan kaikki edellämainitut. Arvolla 16 palautetaan palvelukorin ID ja nimi. | 1 |
| includemodifiedpayments | 0...1 | Parametria käytettäessä tulee käyttää myös parametreja lastmodifiedstart ja lastmodifiedend. Arvolla 1 pyyntö palauttaa myyntilaskut, joilla on muuttuneita (muokattuja tai uusia) suorituksia aikavälillä. | 1 |
InvoiceStatus -parametrillä voi olla seuraavat arvot:
| InvoiceStatus | Listaa laskut, joiden tila on | Vastaavuudet suomeksi Netvisorin käyttöliittymässä |
| open | OPEN, OVERDUE, REMINDED, REQUESTED, COLLECTED | Avoin, Erääntynyt, Muistutettu, Huomautettu, Perinnässä |
| overdue | OVERDUE, REMINDED, REQUESTED, COLLECTED | |
| paid | PAID | Maksettu |
| unsent | UNSENT | Lähettämätön |
| creditloss | CREDITLOSS | Luottotappio |
| rejected | REJECTED | Hylätty |
| InvoiceStatus | Listaa tilaukset, joiden tila on | Vastaavuudet suomeksi Netvisorin käyttöliittymässä |
| undelivered | UNDELIVERED | Toimittamaton, Osatoimitettu |
| delivered | DELIVERED | Laskuttamaton |
| billed | BILLED | Laskutettu |
| archived | ARCHIVED | Arkistoitu |
Vastaus:
| Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
| Root | Root | Aggregaatti | 1 | ||
| 1 | SalesInvoiceList | Aggregaatti | 1 | ||
| 2 | SalesInvoice | Aggregaatti | 0...n | ||
| 3 | NetvisorKey | Numeerinen | 1 | Laskun tunniste Netvisorissa | 165 |
| 3 | InvoiceNumber | Merkkijono | 1 | Laskun numero | 54122 |
| 3 | Invoicedate | Päivämäärä | 1 | Laskun päiväys | 2013-11-09 |
| Attr. | format | Merkkijono | 1 | Laskun päiväyksen muoto, aina ansi | ansi |
| 3 | InvoiceStatus | Merkkijono | 1 | Laskun tai tilauksen tila, palauttaa myyntilaskun maksutilan. | ks. taulukko |
| Attr. | substatus | Merkkijono | 0...1 | Laskun alistatus, palauttaa myyntilaskun saatavien tilan: open, overdue, reminded, requested tai collected. Ei käytetä tilaukselle | open |
| Attr. | isincollection | Numeerinen | 1 | Kertoo onko lasku ulkopuolisessa perinnässä vai ei (Intrum/Duetto). Ei käytetä tilaukselle | 0 tai 1 |
| 3 | CustomerNetvisorKey | Numeerinen | 1 | Laskun asiakkaan Netvisorkey | |
| 3 | CustomerCode | Merkkijono | 1 | Laskutusasiakkaan asiakaskoodi | |
| 3 | CustomerName | Merkkijono | 1 | Laskutusasiakkaan nimi | |
| 3 | ReferenceNumber | Viitenumero | 1 | Viitenumero | |
| 3 | InvoiceSum | Numeerinen | 1 | Laskun summa kahdella desimaalilla | 123,45 |
| 3 | OpenSum | Numeerinen | 1 | Laskun avoin summa kahdella desimaalilla, verollinen hinta | 45,67 |
| 3 | Uri | Merkkijono | 1 | Laskun tai tilauksen täydelliset tiedot | ks. taulukko |
| 3 | AdditionalInformation | Aggregaatti | 0...1 | Lisätään vastaukseen, jos kutsuun on lisätty parametri replyoption. | |
| 4 | PrivateComment | Merkkijono | 0...1 | Laskun sisäinen kommentti | private comment |
| 4 | InvoiceCurrencySum | Numeerinen | 0...1 | Laskun valuuttasumma | 1240 |
| Attr. | currencycode | Merkkijono | 1 | Valuuttakoodi | USD |
| Attr. | type | Merkkijono | 1 | Tyyppi, aina ISO-4217 | ISO-4217 |
| 4 | OpenCurrencySum | Numeerinen | 0...1 | Laskun avoin valuuttasumma | 0 |
| Attr. | currencycode | Merkkijono | 1 | Valuuttakoodi | USD |
| Attr. | type | Merkkijono | 1 | Tyyppi, aina ISO-4217 | ISO-4217 |
| 4 | ServiceCollection | Merkkijono | 1 | Palvelukorin nimi | Talvikausi |
| Attr. | Netvisorkey | Numeerinen | 1 | Palvelukorin ID | 2 |
Paluuarvojen erot laskujen ja tilausten listausten välillä:
| InvoiceStatus | URI | |
| Lasku | open, creditloss, paid, unsent, rejected | /getsalesinvoice.nv?netvisorkey=165 |
| Tilaus | archived, undelivered, delivered, billed | /getorder.nv?netvisorkey=165 |
Muutoshistoria
| Päivämäärä | Muutos | Kuvaus |
| 12.12.2024 | Uusi elementti CustomerNetvisorKey | Vastaussanomassa palautetaan nyt laskun asiakkaan netvisorkey |
Oliko tästä vastauksesta apua? Kyllä Ei
Send feedbackPahoittelut, että emme voineet auttaa. Anna palautetta, jotta voimme parantaa tätä artikkelia.