Netvisor: Laskutusaineistosiirto
Tämä ohje koskee Maxtech Pro™ -palvelua. Maxtech Easy™ käyttäjille on olemassa erilliset ohjeet.
Tämä toiminnallisuus kuuluu seuraaviin tuotteisiin ja vaatii toimiakseen seuraavat moduulit:
| TUOTTEET | moduulit |
|---|---|
| Laskutusrivit, -aineistot ja kateraportti™ | |
Perustiedot
| Tiedoston nimi | N/A (palvelujen välinen tiedonsiirto) |
| Järjestelmien välinen tiedonsiirtotapa | Palvelujen välinen tiedonsiirto |
| Tiedostoformaatti | xml |
| Merkistö | UTF-8 |
| Päivämääräformaatti | YYYY-MM-DD (esimerkiksi: 2022-06-22) |
| Desimaalierotin | piste (.) |
| Tuhaterotin | Ei käytössä |
Rajapinnassa siirrettävät tiedot
Laskun tiedot (SalesInvoice)
| Maxtech-JÄRJESTELMÄN kenttä | XML-ELEMENTTI |
|---|---|
| Kuluva päivä | SalesInvoiceDate |
| Laskun summa (brutto) | SalesInvoiceAmount |
| Vaihtoehtoinen myyjän nimi, asetettavana laskutusdialogissa, ei siirretä jos tyhjä | SellerName |
| Viennin tyyppi, valittavana laskutusdialogissa, myyntilasku (invoice) / myyntitilaus (order) | InvoiceType |
| Jos viennin tyypiksi on valittu myyntilasku, ’unsent’, muuten ’undelivered’ | SalesInvoiceStatus |
| Laskua koskevat Työnumerot pilkulla eroteltuina. Mikäli dialogissa on valittuna Lisää tapahtumien ajankohta laskulle lisätiedoksi, myös työskentelyn ajankohta (ensimmäisen ja viimeisen tapahtuman pvm:t). Mikäli tapahtumaan liitetylle Työlle on asetettu Yhteyshenkilö (laskulla) (Työ -> Laskutus-välilehti), lisätään myös se omalle rivilleen | SalesInvoiceFreeTextBeforeLines |
| Viitteemme (kaikki arvot Asiakkaan ja Töiden takaa), pilkulla eroteltuina | SalesInvoiceOurReference |
| Viitteenne (kaikki arvot Asiakkaan ja Töiden takaa), pilkulla eroteltuina | SalesInvoiceYourReference |
| Asiakkaan asiakasnro | InvoicingCustomerIdentifier |
| Toimitusasiakkaan tiedot, lisätään mikäli tapahtumaan liitetyn Työn takana on asetettu Käytä erillisiä toimitusasiakkaan tietoja (Työ -> Seurantatasot-välilehti). Toimitusosoitetiedot voidaan syöttää käsin suoraan Työn taakse tai käyttää valitun toimitusasiakkaan osoitetietoja. | DeliveryAddressName DeliveryAddressLine DeliveryAddressPostNumber DeliveryAddressTown |
| Kiinteästi 14 | PaymentTermNetDays |
| Ulkoinen tilausnumero, lisätään mikäli tapahtumaan liitetyn Työn takana on asetettu Ulkoinen tilausnumero (laskulla) (Työ -> Laskutus-välilehti) | OrderNumber |
Laskurivin tiedot (InvoiceLines -> InvoiceLine)
Mikäli asiakkaan asetuksissa on määritelty Laskutuslisä (tuote), lisätään jokaiselle laskulle laskurivi, jolla 1kpl määriteltyä tuotetta.
| Maxtech-JÄRJESTELMÄN kenttä | XML-ELEMENTTI |
|---|---|
| Tuotenumero (tuotteen tiedoista) | ProductIdentifier |
| Nimike (tuotteen tiedoista) | ProductName |
| Veroton yksikköhinta (tuotteen tiedoista) | ProductUnitPrice |
| Alv% (tuotteen tiedoista) | ProductVatPercentage |
| Määrä (tapahtuman laskutusrivin tiedoista) | SalesInvoiceProductLineQuantity |
| Kommentti (tuotteen tiedoista) | SalesInvoiceProductLineFreeText |
| Kirjanpidon verollinen myyntitili (tuotteen tiedoista, ei viedä jos tyhjä) | accountingaccountsuggestion |
| Seurantatasot laskutusdialogin valintojen mukaan (DimensionName ja DimensionItem per dimensio) | Dimension -> DimensionName ja DimensionItem |
| Kuvaus (tuotteen tiedoista), sekä valinnaiset, vientidialogissa valittavat tiedot, ks. kuva alla | InvoiceLine -> SalesInvoiceCommentLine -> Comment |
Tietojen synkronointi
Viennin yhteydessä on mahdollista synkronoida asiakkaiden ja tuotteiden tietoja Maxtechistä Netvisoriin vientidialogin valinnalla:
Asiakkailta synkronoidaan seuraavat tiedot:
| Synkronoitava tietue | MAXTECH-JÄRJESTELMÄN KENTTÄ |
|---|---|
| customerbaseinformation: | |
| internalidentifier | Asiakasnumero (tämän perusteella tarkistetaan, päivitetäänkö olemassaolevan asiakkaan tiedot vai perustetaanko uusi) |
| externalidentifier | Y-tunnus |
| name | Asiakkaan nimi (tai laskutusasiakkaan, mikäli käytetään erillisiä laskutusasiakkaan tietoja) |
| nameextension | Asiakkaan / laskutusasiakkaan nimitarkenne |
| streetaddress | Asiakkaan / laskutusasiakkaan katuosoite |
| city | Asiakkaan / laskutusasiakkaan postitoimipaikka |
| postnumber | Asiakkaan / laskutusasiakkaan postinumero |
| phonenumber | Matkapuhelin |
| Sähköpostiosoite | |
| homepageuri | Www-sivu |
| customerfinvoicedetails: | (mikäli Sähköisen laskutuksen ovt-tunnus / välittäjätunnus asetettu) |
| finvoiceaddress | Sähköisen laskutuksen ovt-tunnus |
| finvoiceroutercode | Sähköisen laskutuksen välittäjätunnus |
| customerdeliverydetails: | (mikäli Käytä erillisiä toimitusasiakkaan tietoja on valittu) |
| deliveryname | Toimitusasiakas + Toimitusasiakkaan tarkenne |
| deliverystreetaddress | Toimitusosoitteen katuosoite |
| deliverycity | Toimitusosoitteen postitoimipaikka |
| deliverypostnumber | Toimitusosoitteen postinumero |
| customercontactdetails: | |
| contactperson | Yhteyshenkilö |
| contactpersonemail | Yhteyshenkilön email-osoite |
| contactpersonphone | Yhteyshenkilön puhelin |
Tuotteilta synkronoidaan seuraavat tiedot:
| Synkronoitava tietue | MAXTECH-JÄRJESTELMÄN KENTTÄ |
|---|---|
| productbaseinformation: | |
| productcode | Tuotenumero (tämän perusteella tarkistetaan, päivitetäänkö olemassaolevan tuotteen tiedot vai perustetaanko uusi) |
| productgroup | Tuoteryhmän numero |
| name | Nimike |
| unitprice | Á-hinta |
| unit | Yksikkö |
| purchaseprice | Hankintahinta |
| isactive | Kiinteästi ’1’ |
| issalesproduct | Kiinteästi ’0’ |
| productbookkeepingdetails: | |
| defaultvatpercentage | Alv% |
Netvisorin hintakertoimien ja asiakashintojen huomioiminen
Viennissä on mahdollista käyttää myös Netvisor-hinnoittelua valitsemalla vientidialogissa ”Käytä Netvisorin tuotehinnoittelua nollahintaisille tuotteille”. Mikäli valinta on valittuna, kaikille nollahintaisille laskutusriveille käytetään Netvisorin hintakertoimia ja asiakashinnoittelua.
