ValueFrame-NetBarn laskutus liittymä Päiväys: 25.6.2015 Laatinut: Janne Fredman Tarkastanut: Versi: 1.0
ValueFrame-NetBarn laskutus liittymä Sisällysluettel 1 Liittymän yleiskuvaus... 3 1.1 NetBarn... 3 1.2 Yleistä liittymistä... 3 2 Liittymän vaatimat asetukset ValueFramessa... 4 2.1 Liittymän aktivinti käyttöön ja käyttöikeudet... 4 2.2 Yhtiö- ja liittymäkhtaiset tunnukset ja salasanat... 4 2.3 Crn-ajn tilaus... 4 2.4 Laskentakhteiden humiiminen... 4 3 Liittymän käyttö... 5 3.1 Siirt laskuluettellta... 5 3.2 Asiakastiedn mudstaminen NetBarnissa... 5 3.3 Laskunumern käsittely NetBarnissa... 5 3.4 Siirrn lkitiedt... 5 4 Siirttiedstn tietsisältö... 6 4.1 Tiedstkuvaus... 6 Cpyright ValueFrame Oy 2
ValueFrame-NetBarn laskutus liittymä 1 Liittymän yleiskuvaus 1.1 NetBarn NetBarn n selainphjainen talushjausjärjestelmä, jta käyttävät sekä tilitimistt että yksittäiset yritykset. 1.2 Yleistä liittymistä Liittymä n WebServices phjainen eli se n ajastettu ja autmaattinen. Tiedstn sisältö n pieniä pikkeamia lukuunttamatta Finvice 1.3 versin mukainen. Siirrettävät laskut valitaan ValueFramen laskuluettellta ja tiedstn lunti nappi lu siirttiedstn ja laskut siirretään NetBarniin ajastetusti 10 minuutin välein. Laskut viedään ValueFramesta NetBarniin Invice-mdulilla Laskutettavaksi NetBarnissa tai Reskntraan ja kirjanpitn ValueFramen asiantuntija määrittää liittymien asetuksista käyttöön NetBarn laskutusliittymän. Siirt tehdään, jk Laskuluetteln L-sarakkeelta, js laskut halutaan laskuttaa NetBarnista Laskuluetteln R-sarakkeelta, js laskut laskutetaan ValueFramesta ja siirretään reskntraa ja kirjanpita Liittymässä tudaan vain laskurivikhtaiset myyntilit. Asiakasyritys määrittää NetBarnissa kullekin myyntilille alv-tilin ja myyntisaamistilin. NetBarn lu myyntisaamis- ja alvkirjaukset autmaattisesti. Siirttiedstssa vidaan viedä erikseen laskun maksaja-asiakkaan (Buyer) ja vastaanttaja-asiakkaan (InviceRecipient) tiedt. 3 Cpyright ValueFrame Oy
ValueFrame-NetBarn laskutus liittymä 2 Liittymän vaatimat asetukset ValueFramessa 2.1 Liittymän aktivinti käyttöön ja käyttöikeudet ValueFramen asiantuntija määrittää liittymän käyttöön valitsemalla käyttöön : NetBarn-laskutussiirt NetBarn-reskntrasiirt Lisäksi khdassa Ylläpit Käyttöikeudet määritetään NetBarn-siirt käyttöön halutulle käyttäjäryhmälle. 2.2 Yhtiö- ja liittymäkhtaiset tunnukset ja salasanat Valikn khdassa Ylläpit Yleiset asetukset Yhtiöt välilehdellä Integraatitiedt määritetään NetBarnilta saatu NetBarn-käyttäjätunnus sekä salasana. Käyttäjätunnus ja salasana vat siis yhtiökhtaiset eli ne pitää määrittää kaikille yhtiöille, js samassa ValueFrame-kannassa n useampi yhtiö. Salasana n mdulikhtainen eli salasanja NetBarnilta pyydettäessä tulee siis mainita että kyse n Invice-mdulista. 2.3 Crn-ajn tilaus ValueFramen asiantuntija tilaa tuesta Crn-ajn, jka siirtää ludut laskutiedstt ajastetusti Sapilla NetBarniin 10 minuutin välein. 2.4 Laskentakhteiden humiiminen NetBarniin vidaan tuda laskuriviltä tudun kirjanpidn myyntitilin hella seuraavat laskentakhteet: Kustannuspaikka pimitaan laskurivin perusteella elementtiin RwAccuntDimensinText Prjektiksi vidaan valita elementtiin RwPrjectReferenceIdentifier : Ei prjektitieta, js NetBarnissa ei hyödynnetä prjektiseurantaa Prjektin autmaattisesti lutu kanta-id Prjektin jukseva numer Osaprjektin autmaattisesti lutu kanta-id Prjektin kirjanpitkdi Osaprjektin kirjanpitkdi Prjektipäällikön tunnus (prjektin prjektipäällikön HENKILO.VAIHTOEHTOINEN_HENKILONUMERO) ValueFramen asiantuntija määrittää valinnan khdassa Prjektitiedn mudstaminen Tikn-laskutussiirrssa. NetBarn saa perustaa kustannuspaikan ja prjektin mutta ne täytyy nimetä manuaalisesti NetBarnissa. Cpyright ValueFrame Oy 4
ValueFrame-NetBarn laskutus liittymä 3 Liittymän käyttö 3.1 Siirt laskuluettellta Käyttäjälle näytetään laskuluettellla linkki NetBarn laskutussiirt tai NetBarn reskntrasiirt. Laskutussiirrssa vidaan eräpäivä laskettaa uudelleen laskun päivästä tai arvpäivästä. Laskutussiirtn valitaan laskut ruksimalla halutut laskut laskuluetteln L-sarakkeelta. Siirtämättömät laskut n ruksittu letuksena valmiiksi. Reskntrasiirtn valitaan laskut ruksimalla halutut laskut laskuluetteln R-sarakkeelta. Siirtämättömät laskut n ruksittu letuksena valmiiksi. Siirtlinkin klikkaaminen lu laskuista siirttiedstn, jka siirretään autmaattisesti NetBarniin 10 välein. J siirrettyjä laskuja ei vi siirtää uudelleen ilman, että laskuilta pistetaan lukitus laskuluetteln kautta. Näin estetään saman laskun siirtäminen vahingssa kahteen kertaan. 3.2 Asiakastiedn mudstaminen NetBarnissa ValueFramessa asiakkaalle määritetty asiakasnumer siirtyy NetBarniin elementissä BuyerExternalIdIdentiefier ja NetBarn saa tarvittaessa perustaa uuden asiakkaan asiakasnumern perusteella. 3.3 Laskunumern käsittely NetBarnissa Laskutussiirrssa NetBarn uudelleennumeri laskut. ValueFramen laskunumer siirtyy NetBarniin elementissä InviceFreeText ja se tallentuu NetBarnin kenttään tiednant. ValueFramen laskunumer n mahdllista tulstaa perintäkirjeille ja maksukehtuksiin. 3.4 Siirrn lkitiedt Jkaisesta tiedstn siirrsta tallennetaan tiet ValueFrameen tauluun TAPAHTUMALOGI_SOAP. Js lasku n mennyt nnistuneesti NetBarniin tallennataan kyseiseen tauluun Message-kenttään (muiden tietjen hella) respnse status = 1. Vastaavasti respnse status = 0 kert, että siirt n epännistunut. 5 Cpyright ValueFrame Oy
ValueFrame-NetBarn laskutus liittymä 4 Siirttiedstn tietsisältö 4.1 Tiedstkuvaus Siirt nudattaa Finvice-kuvausta lukuunttamatta seuraavia pikkeuksia: Elementteihin BuyerExternalIdIdentifier ja InviceRecipientExternalIdIdentier tudaan ValueFramen asiakasnumer. Sen perusteella NetBarn saa khdistaa laskut ikealle asiakkaalle tai luda uuden asiakkaan. Js laskun asiakkaalle n ValueFramessa annettu verkklaskusite ja peraattritunnus ja nämä n tallennettu laskulle, ludaan tiediltaan vajaa MessageTransmissinDetails elementti, jssa MessageSenderDetailsin alla n FrmIdentifier FrmIntermediatr Näiden avulla vidaan tuda NetBarn laskutussiirrssa asiakkaan verkklaskusite ja peraattritunnus. Elementtiin BuyerOrganisatinName2 tudaan laskun asiakkaan c-kenttä Siirttiedstssa vidaan tuda ValueFramen laskulle annetut seliterivit, mutta mahdllisia välisummarivejä ei tuda siirttiedstn. Siirt tukee myös rahitusyhtiölaskua Finvvicen FactringAgreementDetails-elementin avulla. Cpyright ValueFrame Oy 6