Projektien tuonti - Visma L7/LTR

Palveluun voidaan tuoda projekteja Visma L7 -palvelusta. Tuonnissa käytetään Visman tarjoamaa REST rajapintaa.

Visma L7:ssä olevat projektit ovat kolmessa tasossa:

1. Yritysnumero
2. Ylänumero
3. Alanumero

Esimerkiksi

• 100001 - Yritys Oy
  
  • 5432 - Tuotekehitys
    
    • 110205 - Ohjelmointi

Yritysnumeron tuominen Neptoniin on valinnaista ja sen voi määrittää asetuksista. Tästä lisää alempana.

Huomioi että jos olet vaihtamassa tuontia vanhasta SFTP-tuonnista uuteen REST - rajapintaan, tulee SFTP -tuonti ajaa yhden kerran ennen rajapinnan vaihtoa, jotta projektien tunnisteet päivittyvät niin että ne tukevat REST - rajapintaa oikein.

Mikäli projekti on jo palvelussa, päivitetään sen tietoja. Mikäli projektin (alanumeron) tila (orderStatus -tieto) on arvoltaan jokin muu kuin 8 (valmis) tai 9 (lukittu), projektin päättymispäivä asetetaan tuotavilla projekteilla tyhjäksi, jotta tuodut projektit ovat käytettävissä tapahtumilla. Projektin alkupäivä asetetaan tyhjäksi tuonnin yhteydessä.

Määrittäminen

1. Perusasetusten määrittäminen

Tuonnin perusasetukset pystyy määrittämään työyhteisön asetuksista, Työaika > Hallinta > Työyhteisön asetukset > Liittymät > Projektit > Visma L7 projektien tuonti.

Vähintään seuraavat tiedot täytyy määrittää jotta projektit pystytään tuomaan Visma L7 rajapinnasta:

Jos et tiedä mitä seuraaviin tietoihin pitäisi antaa:

• Rajapinta-asetukset > Tuonnin web service -osoite
• Rajapinta-asetukset > Yrityksen hash (company hash)
• Rajapinta-asetukset > API token (user token)

Ole yhteydessä Visma-tukihenkilöösi.

Tämän lisäksi seuraavat tiedot on mahdollista määrittää:

Projektien tuonti on myös mahdollista useammasta lähteestä. Jokaiselle lähteelle asetetaan oma:

• Tuonnin web service -osoite
• Yrityksen hash
• API token
• Tuotujen projektien yliprojekti
• Henkilö, joka näytetään projektien luojana

Tätä käytettäessä tulee varmistaa, että yritysnumerot tai ylänumerot ovat uniikkeja. Muutoin toinen lähde voi ylikirjoittaa ensimmäisestä lähteestä tuotuja projekteja.

2. Henkilöiden tunnusten määrittäminen

Jos rajapinnan kautta halutaan myös asettaa projektipäälliköt, täytyy henkilöiden tunnisteet määrittää Työsuhde > Henkilön tiedot > Tunnisteet -näkymässä. Jos henkilön Visma -tunnusta ei ole asetettu, käytetään henkilön henkilönumeroa.

Liittymän tekninen toiminta

Rajaukset

• Jos yritysnumerot on asetettu tuotavaksi, yritysnumeroa tyhjällä numerolla ei tuoda. Jos yritysnumeroa ei tuoda, sen ylä- tai alanumeroakaan ei tuoda.
• Ylänumeroita tyhjällä numerolla ei tuoda. Jos ylänumeroa ei tuoda, sen alanumeroakaan ei tuoda.,
• Alanumeroita tyhjällä numerolla ei tuoda

Autentikaatio

Yrityksen hash ja API-token lähetetään HTTP-otsakkeessa. Yrityksen hash lähetetään HTTP-otsakkeena hash ja API token HTTP-otsakkeena token.

Rajapinta tuonnin ajastus

Ajastusasetukset löytyvät kohdasta Työaika > Hallinta > Työyhteisön asetukset > Liittymät > Ajastus.

Visma L7 liittymän ajastus on mahdollista tehdä joko minuuttiajastuksella (esim. 15 minuutin välein, joka tunti jne.) tai päivittäisajastuksella. Rajapinnasta tuontia varten valitse liittymävalikosta jokin 'Visma L7 projektien tuonti #{numero} valinnoista. Valikosta löytyy oma valintansa jokaiselle erikseen määritetylle rajapintariville. Joudut tällöin määrittämään ajastuksen jokaiselle rajapintariville, mutta tarvittaessa voit myös määrittää erillisen aikataulun jollekin näistä.

Ajastuksien määrittelystä lisää voit lukea täältä.

Odotettu vastaus rajapinnasta

/projects/ päätepiste

Vastauksen odotetaan olevan JSON-muodossa. Tätä varten myös lähetetään HTTP-otsake Accept: application/json.

Päätepistettä käytetään vain ylänumeroiden tuontiin. Alanumerot tuodaan /salesorder/ päätepisteestä.

Esimerkkisanoma

{
  "project": [
    {
      "rec": "1",
      "mainNumber": "000001",
      "mainNumberName": "Turku",
      "mainNumbercostCentre": "1000",
      "mainNumbercostCentreName": "MYYNTI",
      "mainNumbersalesMan": "5000",
      "mainNumbersalesManName": "Matti Myyjä",
      "mainNumberworkQuality": "",
      "mainNumberworkQualityName": "",
      "subNumber": "1",
      "subNumberName": "Projektin aloitustyö",
      "subNumberCostCentre": "1000",
      "subNumberCostCentreName": "MYYNTI",
      "subNumberType": "1001",
      "subNumberTypeName": "Myyntitilaus",
      "subNumberOrderDate": "",
      "partyByNumber": "100027",
      "partyByBusinessId": "1234567-7",
      "partyByName1": "Yritys Oy",
      "deleted": "0"
    }
  ]
}

/salesorders/ päätepiste

Vastauksen odotetaan olevan JSON-muodossa. Tätä varten myös lähetetään HTTP-otsake Accept: application/json.

Esimerkkisanoma

{
  "salesorder": [
    {
      "rec": "1",
      "orderNumber": "000001",
      "subNumber": "1",
      "orderType": "1",
      "orderTypeName": "Myyntitilaus",
      "orderName": "Projektin aloitustyö",
      "currency": "EUR",
      "costCentre": "1000",
      "orderDate": "",
      "deliveryDate": "2023-11-23",
      "paymentTerms": "30 pv netto",
      "deliveryTermsCode": "",
      "deliveryTerms": "",
      "deliveryMethodCode": "",
      "deliveryMethod": "",
      "orderStatus": "1",
      "mainOrderType": "1",
      "mainOrderTypeName": "Myyntitilaus",
      "mainOrderCostCentre": "1000",
      "mainOrderCostCentreName": "MYYNTI",
      "party1Rec": "1057",
      "party1Type": "BY",
      "party1BusinessId": "1234567-7",
      "party1CompanyNumber": "100027",
      "party1Name1": "Yritys Oy",
      "party1Name2": "",
      "party1visitAddress": "Osoite 1",
      "party1postalAddress": "",
      "party1postalZip": "00000",
      "party1postalCity": "PAIKKAKUNTA",
      "party1countryCode": "FI",
      "party1countryName": "Suomi",
      "party1PersonName": "Antti Asiakas",
      "party1ContactNumber1": "",
      "party1ContactNumber2": "",
      "party2Rec": "1058",
      "party2Type": "DP",
      "party2BusinessId": "1234567-7",
      "party2CompanyNumber": "100027",
      "party2Name1": "Yritys Oy",
      "party2Name2": "",
      "party2visitAddress": "Osoite 1",
      "party2postalAddress": "",
      "party2postalZip": "00000",
      "party2postalCity": "PAIKKAKUNTA",
      "party2countryCode": "FI",
      "party2countryName": "Suomi",
      "party2PersonName": "",
      "party2ContactNumber1": "",
      "party2ContactNumber2": "",
      "subNrStatus": "avoin",
      "projectWorkQuality": "",
      "orderNrCostcentre": "1000",
      "orderNrCCName": "MYYNTI",
      "orderNrName": "",
      "modifiedTs": "2023-05-26 12:57:02",
      "deleted": "0"
    }
  ]
}

Tuonti SFTP-palvelimelle muodostetuista tiedostoista

Huom! Projektien tuontiin suositellaan käyttämään rajapintaratkaisua, joka kuvataan ylempänä artikkelissa.

SFTP-palvelimelle tulee muodostaa tekstimuotoinen aineisto kyseisestä tiedosta. Projektien haku määritellään työyhteisön asetuksissa, liittymissä otsikon 'Visma' alta. SFTP-palvelimelta käsitellään kaikki tiedostot, joten aineisto voi olla jaettuna useampaan tiedostoon.

Tiedosto on tallennettava ISO-8859-1-merkistökoodauksella. Tietueet on erotettava pystyviivalla (|). Rivinvaihto voidaan koodata Windows- (CR+LF) tai UNIX-muodossa (LF).

Aineisto ei sisällä otsikkoriviä. Aineistossa kukin L7-päänumero tai L7-alanumero siirretään omalla rivillään. Aineisto voi sisältää sekä päänumeroita että alanumeroita. Päänumeron tulee olla aineistossa ennen alanumeroa.

Siirretyt projektit muodostuvat palveluun automaattisesti. Mikäli projekti on jo palvelussa, päivitetään sen tietoja. Mikäli projektin tila (project status -kenttä) on arvoltaan jokin muu kuin 8 tai 9 niin projektin päättymispäivä asetetaan tuotavilla projekteilla tyhjäksi, jotta tuodut projektit ovat käytettävissä tapahtumilla. Projektin alkupäivä asetetaan tyhjäksi tuonnin yhteydessä.

SFTP tuonnin ajastus

Ajastusasetukset löytyvät kohdasta Työaika > Hallinta > Työyhteisön asetukset > Liittymät > Ajastus. Ajastus on mahdollista tehdä joko minuuttiajastuksella (esim. 15 minuutin välein, joka tunti jne.) tai päivittäisajastuksella.

SFTP-tuontia varten ajastuksen liittymävalikosta tulee valita 'Visma L7 projektien tuonti (vanha)'

Ajastuksien määrittelystä lisää voit lukea täältä.

Rivityyppi päänumero

Rivityyppi alanumero