Etukäteisvalmistelut, manuaalinen siirto selaimesta

  • Ympäristön pääkäyttäjä tilaa XML-rajapinnan integraatiotuesta: fivaldi.integrations@visma.com.
  • Visma avaa XML-rajapintaa varten tarvittavat sovellukset.
  • XML-rajapinnasta veloitetaan voimassaolevan hinnaston mukaisesti.

Etukäteisvalmistelut, automatisoitu siirto

  • Ympäristön pääkäyttäjä tilaa XML-rajapinnan integraatiotuesta: fivaldi.integrations@visma.com.
  • Visma avaa XML-rajapintaa varten tarvittavat sovellukset.
  • XML-rajapinnasta veloitetaan voimassaolevan hinnaston mukaisesti.
  • Tämän jälkeen ympäristön pääkäyttäjä luo Palvelunhallinnassa uuden käyttäjän XML-siirtoa varten tämän ohjeen mukaan. Käyttäjätunnusta ei tule käyttää muuhun tarkoitukseen.
  • Tunnuksen tiedot ilmoitetaan integraatiotukeen. Tuotekehitys tekee tunnukselle Connect-migraation purkamisen.
  • Tämän jälkeen tunnukselle asetetaan Palvelunhallinnassa salasana ja lisätään alla olevan ohjeen mukaiset käyttöoikeudet.
  • Aineiston lähettävän ohjelmiston tulee toimittaa lähettävän sovelluksen kiinteä IP-osoite fivaldi.integrations@visma.com yhteyden avaamista varten, jos ohjelmistosta ei ole tätä yhteyttä jo avattu. 
  • Siirrossa tarvittava skeemanumero: Siirry Fivaldin web-puolelle ja napsauta sivun yläreunan yrityshakuvalikko auki. Hae kyseinen yritys kirjoittamalla sen Fivaldi-numero tai nimi kenttään kokonaan tai osittain. Kantaryhmän numero näkyy tekstin Fivaldi ASP jälkeen, skeemanumeroon sen eteen tulee lisätä kirjaimet fv - eli oheisen esimerkin mukainen skeemanumero on siis fv003. Poikkeuksena on kantaryhmä 002, jonka skeemanumero on aina fv005.


  • Lopuksi tunnuksen tiedot sekä skeemanumero ilmoitetaan integraatiokumppanille yhteyden avausta varten.

Käyttöoikeuksien avaaminen

Ympäristön pääkäyttäjä asettaa XML-siirtoja varten avatulle käyttäjätunnukselle seuraavat käyttöoikeudet Palvelunhallinnassa. Kaikkiin siirrettäviin aineistoihin liittyviin sovelluksiin annetaan käyttö-, muutos- ja lisäysoikeudet.

Web-sovellukset:

  • XML-aineiston muodostus
  • XML-aineiston sisäänluku
  • XML-siirtojen listaus
  • XML-siirtojen perustiedot

Rekisterit:

  • Yritysrekisteri
  • Tuoterekisteri
  • Yrityksen perustiedot

Sovellukset:

  • Tilaustenkäsittely
  • Palkanlaskenta
  • Varastonhallinta (mikäli päivitetään varastosaldoja)

XML-siirtojen perustietojen määritys

XML-rajapintaa varten täytyy tehdä myös XML-siirtojen perustietojen määritys Fivaldin Web-puolella - Muut - XML-siirtojen perustiedot.


Huom! Valinta tulee tehdä jokaiseen neljään kohtaan (Yritysrekisteri, Tuoterekisteri, Myyntitilaukset, Palkkatapahtumat) tallentaa muutokset, vaikka siirtäisit tietoja vain tuoterekisteriin. Tällöin asetukset tallentuvat oikein. 

Yritysrekisteri-kohdan määritykset:

  • Lisää uudet tietueet (ei päivitystä)
    • Käyttötapa: Uudet asiakkaat tuodaan aina aineiston kautta Fivaldiin
    • Kaikki aineiston sisältämät arvot tuodaan uuden asiakkaan luonnissa yritysrekisteriin.
    • Ylläpito voi tapahtua ensimmäisen aineistotuonnin jälkeen suoraan Fivaldissa tai uusien tietojen osalta aineistosta
    • HUOM.Tämä vaihtoehto aiheuttaa ongelman jos asiakkaita luodaan Fivaldiin manuaalisesti ja jos aineistot eivät kata kaikkia tarpeellisia tietoja (esim. asiakkaan verkkolaskuosoitteita). Silloin käy niin, että manuaalisesti perustetun asiakkaan osalta, ensimmäisellä tuontikerralla tyhjentyy ne kaikki tiedot joita ei ollut aineistossa. Seuraavan tuonnin yhteydessä tätä ongelmaa ei enää ole.  
    • Mikäli asiakkaita perustetaan myös manuaalisesti, valitse silloin vaihtoehto ”Päivitä kaikki tietueet, säilytä kentät joita ei aineistossa”
  • Päivitä kaikki tietueet
    • Käyttötapa: Uudet asiakkaat tuodaan aina aineiston kautta Fivaldiin
    • Ylläpito tapahtuu vain aineiston tietojen perusteella
    • Valitaan silloin kun asiakkaiden tiedot ylläpidetään toisessa järjestelmässä.
    • Viimeisin tilanne tuodaan aina aineiston perusteella Fivaldiin = Tämä valinta tyhjentää olemassa olevat tiedot, jos tietoa ei tuoda aineistossa.
  • Päivitä kaikki tietueet, säilytä kentät joita ei aineistossa
    • Käyttötapa: Uudet asiakkaat tuodaan aineiston kautta tai perustetaan manuaalisesti Fivaldiin
    • Ylläpito voi tapahtua suoraan Fivaldiin tai aineiston tietojen perusteella
    • Valitse tämä vaihtoehto jos uusia asiakkaita perustetaan suoraan Fivaldiin sekä aineiston kautta ja jos aineistot eivät sisällä aina kaikkia tarvittavia tietoja
    • Tämä vaihtoehto säilyttää aina asiakkaan sellaisetkin tiedot joita aineisto ei sisältänyt

Tuoterekisteri-kohdan määritykset:

  • Lisää uudet tietueet (ei päivitystä) – Tuo vain uudet yritystunnukset, ei koske olemassa oleviin yritystunnuksiin.
  • Päivitä kaikki tietueet – Tuo uudet tuotteet ja päivittää olemassa olevien tuotteiden kentät siirtotiedoston tiedoilla. Päivittää myös kentät, joita ei ole siirtotiedostossa. Huom! Tämä valinta tyhjentää olemassa olevat tiedot, jos tietoa ei tuoda aineistossa.
  • Päivitä kaikki tietueet, säilytä kentät joita ei ole aineistossa – Tuo uudet tuotteet ja päivittää olemassa olevien tuotteiden kentät siirtotiedoston tiedoilla. Ei koske kenttiin, joita ei ole siirtotiedostossa.

Myyntitilaukset-kohdan määritykset:

  • Lisää uudet tietueet (ei päivitystä) – Tuo vain myyntitilaukset joiden SalesOrderNumber on uusi.  
  • Päivitä kaikki tietueet – Päivittää myyntitilausten tiedot siirtoaineiston tiedoilla. Huom! Tämä valinta tyhjentää olemassa olevat tiedot, jos tietoa ei tuoda aineistossa. Myyntitilauksia tuotaessa ohjelma poistaa myös manuaalisesti lisätyt tuoterivit, eli jäljelle jää vain siirtoaineiston tiedot.
  • Käytä tuonnissa alennusrekisteriä – Mahdolliset alennusprosentit haetaan Alennukset/hinnoittelu-rekisteristä.
  • Perusta puuttuvat tuotteet ja päivitä toimittajan tiedot – Perustaa tuoterekisteriin puuttuvan tuotteen koodin ja nimen. Ei lisää muita tietoja.
  • Hae puuttuva seurantakohteen 1 arvo Fivaldin perustiedoista – asetusten mukaan.
  • Hae puuttuva seurantakohteen 2 arvo Fivaldin perustiedoista – asetusten mukaan.
  • Hae puuttuva seurantakohteen 3 arvo Fivaldin perustiedoista – asetusten mukaan.
  • Hae puuttuva seurantakohteen 4 arvo Fivaldin perustiedoista – asetusten mukaan.

Palkkatapahtumat-kohdan määritykset:

  • Seurantakohteet luetaan aineistosta – Palkkarivin seurantakohteen arvot luetaan siirtoaineistosta
  • Seurantakohteet luetaan henkilön oletustiedostosta – Palkkarivin seurantakohteen arvot haetaan palkansaajan tiedoista
  • Ensisijaisesti aineiston kohteet, toiseksi henkilön oletuskohteet – Palkkarivin seurantakohteen arvot luetaan siirtoaineistosta. Jos aineistossa ei ole arvoa seurantakohteelle, luetaan mahdollinen arvo palkansaajan tiedoista.

Aineiston muodostuksen perustiedot

  • Tiedoston oletusnimi – Fivaldista ulosluettavan tiedon tallennustiedoston nimi. Ulosluettavalle tiedostolle voi antaa oletusnimen, mutta oletusnimen tallentaminen ei ole pakollista. Nimen puuttuessa järjestelmä käyttää oletusnimeä ”ulosluettu.xml”.
  • Seurantakohteen tapahtumat, seurantakohdetaso – Ulosluettaessa seurantakohdetasoja, määritetään luettava seurantakohdetaso tähän. Tällä valinnalla vaikutetaan siihen, minkä seurantakohdetason tietoja haetaan IP-rajapinnan yli.




Oliko tästä vastauksesta apua? Kyllä Ei

Send feedback
Pahoittelut, että emme voineet auttaa. Anna palautetta, jotta voimme parantaa tätä artikkelia.