Talenom: Myyntilaskuaineistosiirto
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™ | Talenom myyntilaskut |
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
Pakolliset tiedot merkitty tähdellä (*)
Laskun tiedot (INVOICE)
| Maxtech-JÄRJESTELMÄN kenttä | Kohdejärjestelmän kenttä |
|---|---|
| Client ID (organisaation integraatioasetuksista) | CLIENT_ID * |
| Kuluva päivä | INVOICE_DATE * |
| Eräpäivä, lasketaan ensisijaisesti asiakkaan laskutustiedoissa ja toissijaisesti organisaation asetuksissa olevan maksuehdon perusteella (kuluva päivä + maksuehto) | DUE_DATE * |
| Tilausnumero (työn tiedoista) | ORDER_NUMBER |
| Viitteemme (Laskulla) (asiakkaan tiedoista) | OUR_REFERENCE |
| Viitteenne (Laskulla) (asiakkaan tiedoista) | YOUR_REFERENCE |
| Maksuehto, ensisijaisesti asiakkaan laskutustiedoista ja toissijaisesti organisaation asetuksista | DNET * |
| Viivästyskorko, ensisijaisesti asiakkaan laskutustiedoista ja toissijaisesti organisaation asetuksista | OVERDUEINTEREST |
| Huomautusaika, ensisijaisesti asiakkaan laskutustiedoista ja toissijaisesti organisaation asetuksista | REMARKTIME * |
| Lähetystapa, päätellään asiakkaan laskutustiedoista / vientidialogissa annetuista asetuksista – Jos vientidialogissa on valittu Tallenna luonnoksena => 0 (manuaalinen hyväksyntä ja lähetys Talenomista, oletuksena valittuna) – Muutoin, jos asiakkaan Sähköisen laskutuksen ovt-tunnus -kenttään on syötetty sähköpostiosoite => 4 (lasku lähetetään automaattisesti ovt-tunnus -kenttään syötettyyn sähköpostiosoitteeseen) – Muutoin, jos asiakkaan Sähköisen laskutuksen ovt-tunnus ja välittäjätunnus on asetettu => 1 (lasku lähetetään automaattisesti ovt-tunnus -kenttään syötettyyn verkkolaskuosoitteeseen) – Muussa tapauksessa => 2 (lasku lähetetään automaattisesti paperilaskuna asiakkaan laskutusosoitteeseen) | SHIPMODE * 0 (= Tulostus) 1 (= Postituspalvelu verkkolasku) 2 (= Postituspalvelu paperilasku) 4 (= Sähköpostilähetys) |
| Päätellään asiakkaan Y-tunnuksen perusteella – Jos asiakkaalle asetettu validi Y-tunnus => 0 – Muutoin => 1 | CUSTOMER_TYPE 0 (= Yritysasiakas) 1 (= Yksityisasiakas) |
| Laskun siirto factoring-rahoitusyhtiölle Vientidialogissa voidaan valita käytetäänkö factoringia vai ei. Rahoitusyhtiökumppani täytyy olla valittuna organisaation integraatioasetuksissa jotta tätä voidaan käyttää. (Laskutusraportti -> hammasrataskuvake oikealla ylhäällä -> Integraatioasetukset -> Talenom rahoitusyhtiökumppani) | FACTORING 1 = Nordea 2 = Pohjola 3 = Danske 4 = Handelsbanken 5 = Ropo Finance 6 = Noja Rahoitus 7 = Aktia 8 = Svea 9 = Alisa Pankki |
Asiakkaan tiedot (INVOICE -> PAYER)
Jos asiakasta ei löydy välitettävillä tiedoilla, se perustetaan Talenomin järjestelmään. Jos tiedoissa on eroja, Talenomin järjestelmässä olevat tiedot ylikirjoitetaan.
| Maxtech-JÄRJESTELMÄN kenttä | Kohdejärjestelmän kenttä |
|---|---|
| Asiakasnumero (asiakkaan tiedoista) | NUMBER * |
| Nimi (asiakkaan tiedoista) | NAME * |
| Nimitarkenne (asiakkaan tiedoista) | NAME_EXT |
| Asiakkaan saatavatilinumero, oletuksena 1701. Voidaan muuttaa 5.9.2024 alkaen Integraatioasetuksissa (Laskutusraportti -> hammasrataskuvake oikealla ylhäällä -> Integraatioasetukset -> Talenom -> Asiakkaan saatavatilinumero) | ACCOUNTS_RECEIVABLE * |
| Ensisijaisesti laskutusosoitteen katuosoite asiakkaan laskutustiedoista, toissijaisesti asiakkaan yleisen osoitteen katuosoite | INVOICE_ADDRESS -> STREET_ADDRESS * |
| Ensisijaisesti laskutusosoitteen postinumero asiakkaan laskutustiedoista, toissijaisesti asiakkaan yleisen osoitteen postinumero | INVOICE_ADDRESS -> POSTAL_CODE * |
| Ensisijaisesti laskutusosoitteen postitoimipaikka asiakkaan laskutustiedoista, toissijaisesti asiakkaan yleisen osoitteen postitoimipaikka | INVOICE_ADDRESS -> POST_OFFICE * |
| Jos SHIPMODE (laskun tiedoissa) on 4 => 1 | INVOICE_ADDRESS -> USE_EMAILBILLING |
| Jos SHIPMODE (laskun tiedoissa) on 4 => Sähköisen laskutuksen ovt-tunnus (asiakkaan tiedoista) | INVOICE_ADDRESS -> EMAILBILLING_ADDRESS |
| Kiinteästi FI | INVOICE_ADDRESS -> COUNTRY * |
| ALV-tunnus, muodostetaan asiakkaan Y-tunnuksesta, mikäli se on validi Y-tunnus | VAT_ID |
| Y-tunnus (asiakkaan tiedoista) | BUSINESS_ID |
| Muu puhelin (asiakkaan tiedoista) | PHONE |
| Matkapuhelin (asiakkaan tiedoista) | MOBILE |
| Sähköposti (asiakkaan tiedoista) | |
| Jos SHIPMODE (laskun tiedoissa) on 1 => Sähköisen laskutuksen ovt-tunnus (asiakkaan tiedoista) | EINVOICEID |
| Jos SHIPMODE (laskun tiedoissa) on 1 => Sähköisen laskutuksen välittäjätunnus (asiakkaan tiedoista) | INTERMEDIATOR |
| Kiinteästi fi-FI | INVOICE_LANGUAGE * |
| Laskutuksen lisätiedot (asiakkaan tiedoista) | CUSTOMER_MESSAGE |
Laskurivin tiedot (ROWS)
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ä | Kohdejärjestelmän kenttä |
|---|---|
| Tuotenumero (tuotteen tiedoista) | PRODUCT_NUMBER * |
| Nimike (tuotteen tiedoista) | PRODUCT_NAME * |
| Kuvaus (tuotteen tiedoista) | PRODUCT_INFO * |
| Määrä (tapahtuman laskutusrivin tiedoista) | QUANTITY * |
| Yksikkö (tuotteen tiedoista, esim. kpl) | UNIT |
| Veroton yksikköhinta (tapahtuman laskurivin tiedoista) | PRICEPERUNIT * |
| Kiinteä arvo 0 | DISCOUNT_PERCENTAGE * |
| Alv% (tuotteen tiedoista) | VAT_RATE * |
| Laskuriveille kiinteä arvo 0. Kommenttiriveille (käytetään esim. koontilaskujen otsikkoriveissä) arvo 1. | ROW_TYPE * |
| Kirjanpidon veroton myyntitili (tuotteen tiedoista), jos tuotteen Alv% = 0. Muille tuotteille Kirjanpidon verollinen myyntitili (tuotteen tiedoista). | SALES_ACCOUNT_NUMBER * |
| Mikäli organisaation Talenom-integraatioasetuksissa on valittu Siirrä kustannuspaikka viennissä -> Tapahtumaan liitetyn Kustannuspaikan numero | COST_CENTER_CODE |
| Mikäli organisaation Talenom-integraatioasetuksissa on valittu Siirrä kustannuspaikka viennissä -> Tapahtumaan liitetyn Kustannuspaikan nimi | COST_CENTER_INFO |