Rajapinnan käyttöönotto
Asetukset→ Rajapinnat→Lisää rajapinta→ Laskutus→ Maventa
- Easoft:ssa luodaan uusi Maventa laskurajapinta ja avataan se muokattavaksi:
- Yrityksen tunniste: Maventassa Asetukset/Yrityksen UUID-kenttä.
- Käyttäjän API-avain: Maventassa Asetukset/API-avain-kenttä.
- Huom! Maventassa API-avain kentässä on Maventaan kirjautuneen henkilön API-avain, jos halutaan että laskut siirtyy Easoftista Maventaan, jollain muulla Maventan käyttäjätunnuksella (esim. on luotu joku yleinen käyttäjätunnus siirtoa varten, niin kirjaudu sillä maventaan, jotta saat oikean API-avaimen).
- Nykyään Maventa näyttää myös samassa yhteydessä Company billing UUID:n, mutta tätä ei tarvita Easoftiin
Asetukset→ Alv-statukset
- Varmista että kaikissa statuksissa on oikeat Finvoice verokohtelukoodit. Käänteisen alv:n Finvoice verokohtelukoodiksi tulee valita AE. Jos on kyse verottomasta myynnistä niin verokohtelukoodiksi tulee laittaa E.
Näytöt→ Asiakkaat-->country
- Jos laskuja lähetetään ulkomaille, pitää asiakaskortilla olla oikea maa valittuna. Muuten laskun lähetys epäonnistuu Maventassa, vaikka se Easoftista lähteekin
Laskun lähetystapa-valinnan toiminta Maventassa:
- Kun valittu e-lasku, niin lähtee kirjeenä, jos e-laskua ei voida lähettää.
- Kun valittu sähköposti, niin lähtee kirjeenä, jos sähköpostia ei voida lähettää.
- Kun valittu kirje, niin lähtee kirjeenä.
Rajapinnasssa siirtyvät kentät:
- BankAccount.id
BankAccount.iban
BankAccount.bic - Company.name
Company.businessid
Company.address
Company.postcode
Company.locality
Company.country
Company.phone
Company.www
Company.email - Customer.number
Customer.businessid
Customer.country - Invoice.number
Invoice.invoice_date
Invoice.due_date
Invoice.reference_number
Invoice.price
Invoice.your_ref
Invoice.our_ref
Invoice.customer_job_number
Invoice.customer_order_number
Invoice.cover_note
Invoice.delivery_address
Invoice.delivery_name
Invoice.delivery_date
Invoice.delivery_postcode
Invoice.customer_name
Invoice.customer_address
Invoice.customer_postcode
Invoice.customer_locality - InvoiceRow.item
InvoiceRow.description
InvoiceRow.qty
InvoiceRow.unit
InvoiceRow.price
InvoiceRow.vat_rate
InvoiceRow.discount_round - PaymentTerm.name
- Settings.penalty_interest
- User.name
- VatStatus.invoice_text
VatStatus.code
Rajapinnasssa ei siirry seuraavat maventan tukemat mutta vapaehtoiset tiedot:
- Toimituksen Maa
- Toimitusehtolause
- Ostajan Lisäosoite
- Ostajan yhteyshenkilö
- Laskurivin tarkenne
- Laskurivin tilausnumero
- Laskurivin toimituspäivämäärä
Easoft-Maventa rajapinnan laskun siirto toimii seuraavasti:
- Easoftissa luodaan laskusta ensin finvoice 3.0 lasku
- Finvoice lasku validoidaan Finvoice 3.0 skeemalla, mahdolliset validoinnin virheet näkyvät siirtologissa.
- Finvoice lasku ja laskun liitteet pakataan zip-tiedostoksi (tiedosto poistetaan lopuksi)
- finvoice.zip (sisältää laskun ja liitteet) lähetetään rajapintaan, mahdolliset rajapinnasta tulevat virheet näkyvät siirtologissa.
- Lasku siirretään siirretyt osioon, jos rajapinnasta tuli ilmoitus että laskun siirto onnistui.
Tekninen dokumentaatio:
Maventa Api:n dokumentaatio: https://maventa.com/verkkolaskutus/api/api-v1-1-documentation/
Mahdolliset virheilmoitukset myyntilaskun siirrossa Easoftista Maventaan:
"ERROR: USER HAS NO RIGHTS TO COMPANY"
= Virhe johtuu todennäköisesti siitä, että rajapinta-asetuksissa on annettu oikeudet sellaisen käyttäjän tunnuksilla, jolla ei ole oikeutta laskutukseen.
Tuon voi määritellä uudestaan oikean yläkulman rattaan kautta -> Lisää asetuksia -> Rajapinnat -> Maventa myyntilaskut -> Käyttäjän API-avain. Tämä pitää tehdä sellaisilla tunnuksilla joilla on oikeudet laskujen lähetykseen.
Käyttäjän API-avain: Maventassa Asetukset/API-avain-kenttä.
- Huom! Maventassa API-avain kentässä on Maventaan kirjautuneen henkilön API-avain, jos halutaan että laskut siirtyy Easoftista Maventaan, jollain muulla Maventan käyttäjätunnuksella (esim. on luotu joku yleinen käyttäjätunnus siirtoa varten, niin kirjaudu sillä maventaan, jotta saat oikean API-avaimen).