Yleistä liittymistä

Liittymien tietuekuvaukset vaihtelevat jonkin verran eri kohdejärjestelmien mukaan. Liittymään kerättävän / muodostettavan aineiston osalta prosessi kulkee karkeasti seuraavasti:

• Kassalla myydään käteinen, kortit, henkilökunnan tilimyynti, pikalaskutus, muu tilimyynti. Henkilökunta voi suorittaa tilejään kassaan.
• Kirjanpitoon siirretään käteis-, kortti- ja tilimyynnit. Laskutus voidaan jättää siirtämättä kirjapitoon, koska se siirtyy sinne laskujen siirron yhteydessä.
• Kun SKJ-ohjelmistossa tehdään tilien saldonsiirto, muodostaa ohjelma tilimyynnin kumoavat tiliöinnit, jotta muodostuneet laskut voidaan siirtää kohdejärjestelmään.
• Tiliöinnit tulevat myynnistä tuoteryhmien / tuotteiden takaa, kustannuspaikka aina tuotteilta. Verokoodit tulevat tuotteilta. Maksutavoilta tulee omat tilit, jotka voivat olla osastokohtaisia (esim. eri käteistili eri osastolla).
• Erikoisempia toimintoja voidaan kirjata tiliöidyn ulosmaksun kautta tai tuotemyynniltä myyntierottelun kautta.
• Lisäksi on huomioitava sisäinen laskutus, jossa maksutavan tiliöinti korvautuu asiakkaan tiedoista saatavalla tiliöinnillä.

:SKJData

Lasku/reskontraliittymät

Laskutusliittymät on tarkoitettu ulkoiseen laskutukseen/reskontraan.

Reskontratapauksessa laskutukset kirjataan ja laskutetaan asiakkaalta SKJ:n kautta, mutta reskontra hoidetaan ulkoisessa järjestelmässä.

Yleismallinen liittymä on XML-muotoinen Finvoice.

SKJ / Laskujen tuonti

Laskuja voidaan tuoda järjestelmään Laskutus -> Liittymät -> Tuo laskuja -toiminnon avulla.

Tiedostomuoto:

<nowiki>
<?xml version="1.0" encoding="ISO-8859-1"?>
<laskut xmlns:dt="urn:schemas-microsoft-com:datatypes">
 <lasku>
  <numero dt:dt="int">0</numero> <!-- 0=muodostaa laskunumeron automaattisesti -->
  <asiakas dt:dt="int">1234</asiakas> <!-- SKJ-järjestelmässä oleva asiakas -->
  <arvopaiva dt:dt="datetime">2.1.2012</arvopaiva> <!-- Eräpäivä lasketaan tästä päivästä -->
  <maksuehto dt:dt="int">2</maksuehto> <!-- SKJ-järjestelmässä oleva maksuehtonumero -->
  <myyntiin dt:dt="int">1</myyntiin> <!-- 0=ei kirjata myyntiin, 1=kirjataan myyntiin -->
   <rows>
     <row>
      <type dt:dt="int">1</type> <!-- 1=tekstirivi 0=tuoterivi -->
      <rivi dt:dt="string">TEKSTIRIVI 1<rivi>
     </row>
     <row>
      <type dt:dt="int">0</type>
      <tuote dt:dt="string">1312012</tuote>
      <nimi dt:dt="string">TUOTENIMI</nimi>
      <maara dt:dt="int">1</maara>
      <ahinta dt:dt="float">575,640014648438</ahinta>
      <ahintaalv0 dt:dt="float">468</ahintaalv0>
      <yhteensa dt:dt="float">575,640014648438</yhteensa>
      <yksikko dt:dt="string">KPL</yksikko>
     </row>
   </rows>
</lasku>
</nowiki>

Tikon

Tikon reskontraliittymät on tehty ASW ja RLW -kuvauksien perusteella. Kuvaukset löytyvät täältä (vaatii kirjautumisen).

iPost / EPL

Katso lisää: IPost

Hansa

Sonet

Liittymä on tehty Tilaukset-kuvauksen mukaisesti.

ProEconomica

Wintime

Intime Plus

Toteutettu kuvauksella Tiedosto_Intime-Laskukuvaus.pdf. Toimintona MRLAKO.

Yleisohje:

Tiedosto_Intime-Yleisohje.pdf

Econet

Fina

Kirjanpitoliittymät

Kirjanpitoliittymällä siirretään SKJ-myymäläjärjestelmässä muodostunut myyntidata vastaanottavaan kirjanpito-ohjelmistoon.

Jeemly vakio kirjanpitoliittymä löytyy /wiki/spaces/API/pages/1753284704

Määritykset

Kirjanpitoliittymässä(Raportit -> Kirjanpitoliittymä) määritellään kiinteästi muutama tieto:

• Siirtotapa. Kiinteä (intime). Käytetään vain intime/wintime kanssa. Sisäisen laskentatunnisteen rakenne seuraavalla välilehdellä. Omamäärittely, käytetään muulloin. Tällöin tiedosto muodostuu reportbuilderin export-toiminnon kautta.
• Toiminto (Vakio)
• Vastapuoli (=tositteiden, joissa ei ole asiakasta, vastapuoli)
• Yritystunnus (kirjanpidon päässä oleva käsiteltävän yrityksen tunnus)
• Sentinpyöristyksen KP-tili (Kirjanpitotili, jolle senttipyöristykset kirjataan)
• Siirtymättömät maksutavat. Tällä ilmoitetaan ne maksutavat, jotka eivät siirry kirjanpitoon. Esim. jos laskutusliittymä on käytössä, voi olla että se vie laskutusmyynnit kirjanpitoon, jolloin niitä ei kuulu siirtää.
• Järj/Tieto/Vertailu. Tällä taulukolla ilmoitetaan miten liittymäaineisto lajitellaan. Vedä asiat haluttuun järjestykseen ja ruksaa vertailu jos haluat ko. asian olevan mukana vertailussa. Esimerkiksi jos vertailussa on vain tilinumero ja kp-liittymä tehdään viikon ajalta, tulevat kaikkien päivien myyntitapahtumat / tili yhdelle riville. Jos siellä on tositepvm, tulee jokaisesta päivästä ja tilistä oma rivi.

Myynnit

Myynnin puolelta kirjanpitotiliksi määräytyy ensisijaisesti Tuoteryhmillä olevat kirjanpitotilit (Ylläpito -> Ryhmät -> Tuoteryhmät) mutta tuotekohtaisesti voidaan määritellä Projekti / Toiminto / Kustannuspaikka jne. Tuotekohtaisesti tiedot löytyvät Lisätiedot -välilehdeltä tuoteylläpidosta (Ylläpito -> Tuotteet).

Maksutavat

Maksutavoilla on omat KP-tilinsä maksutapojen ylläpidossa: Ylläpito -> Muut rekisterit -> Maksutavat. Maksutavoille pitää ilmoittaa tositelaji. Jos kirjanpitoliittymässä ei sellaista ole arvoksi voi laittaa yksi.

Ulosmaksut

Ulosmaksujen / kassaanmaksujen kirjanpitotilit määritellään Tiedosto -> Asetukset -> Kirjanpitotilit. Mikäli käytetään k.o asetuksien kirjanpitotilejä, tulee ulosmaksujen kustannuspaikaksi Myymälälle määritelty kustannuspaikka.
Muutoin käytetään ulosmaksun kirjaushetkellä (kassalla) tiliöityjä tietoja.

Asiakkaat

Tapahtumille, joissa on asiakas valittu (esim laskutus / kanta-asiakastapahtumat) kirjautuu vastapuoleksi asiakasylläpidossa oleva Kustannuspaikka (asiakkaan kustannuspaikka on myymälän vastapuoli).

Sisäinen laskutus

Sisäinen laskutus on kirjanpidon tapahtuma, ei laskutuksen tai laskutusliittymän alainen tapahtuma.
Sen komponentit ovat

• maksutapa, jonka tili on SISLASKUT (tällä ohjelma ei tee maksutapa tiliöntiä)
• asiakas, jolla on sisäisen laskutuksen tili ja kustannuspaikka
• mahdollisesti erilliset tuotteet (verokannan vuoksi).

Tilimyynnin käsittely

Mikäli laskutusta ei saa siirtää kirjanpitoon ja tilimyynti on käytössä saldonsiirron kanssa tulee saldonsiirrossa valita Tee kp-/reskontraliittymä vienti. Tämä kumoaa myyntiä (tili, kustannuspaikka, projekti) ja tilimyynnin maksutapaa.

Yleinen SKJ Kirjanpitoliittymä / vakioliittymä

SKJ tuottaa myyntiaineistosta kirjanpitoaineistoa seuraavan kuvauksen mukaisesti:

• SKJ Vakiokirjanpitoliittymä

SAP

Intime Plus

Toteutettu kuvauksella Tiedosto_Intime-KPkuvaus.pdf. Toiminto KPTKON.

Yleisohje: Intime-Yleisohje.pdf

Sonet

Kirjanpitoliittymä totetutettu allaolevalla kuvauksella. Liittymässä eroteltu kirjanpitotili / kustannupaikka / projekti. Sonetin päässä tosin liittymä on parametrisoitavissa eli se voi muuttua tarpeen mukaan.

AdeEko

Tikon

Fina

ProEconomica

DAFO

Toiminnassa olevat liittymät

• Tuotteiden siirto dafosta
• Varastosaldojen siirto dafosta
• Ostotilauksen välittäminen dafoon

Tuotteiden siirto dafosta

Tuotteet siirretään eräajossa ketjunohjausohjelmalla.

• Uudet värit perustetaan, kokolajitelmia ei.
• Kokolajitelmat pitää lisätä käsin SKJ:n jos niitä lisätään dafoon.
• Uutta tuotetta lisättäessä asetetaan toimittaja.
• Kun tuotetta päivitetään toimittajaan ei kosketa.

Siirtosuunta:

• DAFO -> SKJ

Siirretään tuotteet, joille on perustettu myymälähinnasto.

Tuotteet siirretään kaikille myymälöille, jolloin myymälän numero tiedostossa tyhjänä.

Kooditietue

Kooditietueella on tuotteen viivakoodi, väri koko ja hinta. Skj ei tue kuin samaa hintaa kaikille kooille ja väreille. Ohjelma ottaa sen hinnan, jota on esiintynyt eniten. Viivakoodit perustetaan ja tarkastetaan samalla onko se ”kierrätyskoodi” joltain vanhemmalta tuotteelta.

Siirtosuunta:

• DAFO -> SKJ

Varastosaldojen siirto dafosta

Varastosaldo tiedostossa voi tulla nolla varasto (dafon tilaukset ja varaukset) tai dafon varastopaikka. SKJ:n varastopaikkarekisterissä on ulkoinen tunnus, johon ilmoitetaan DAFOn varastopaikka. Tuonnin asetuksissa määrätään mihin varastoon 0-varasto kohdistetaan.

Dafon alkuperäinen kuvaus:

Varastosaldot siirretään tietuetyypillä 14. SKJ-siirrossa käytetään oheista formaattia. Dafo tuottaa aineiston viikkokohtaisesti siten, että:

• Varastosaldo toimitetaan vain ensimmäisessä rivissä (kuluva viikko); muissa se on nolla.
• Sekä myynnille (m) että tulossaolevalle (t) saldolle määritellään Dafoon yleisparametrit, joilla määrätään, montako viikkoa eteenpäin Dafo saldoja tuottaa. Saldorivejä tulee siis aineistossa 1 + Max(m, t) kappaletta yhdelle koolle. SKJ summaa riveistä vain yhden saldon varastolle, myynnille ja tulossamäärälle (purkaa viikottaisuuden).

Saldot haetaan kerran päivässä.

Kuvauksen alkuun on laitettu myöhemmän laajennuksen varalta sekä

• toimintotunnus (tulee aluksi aina nelonen) ja
• yritysnumero (tulee Dafon yritysnumero), joille ei tällä hetkellä ole liittymässä käyttöä.

Numeeriset kentät tulevat etunollilla täytettyinä.

Ostotilausten siirto SKJ->Dafo

Siirto tapahtuu painamalla muodosta siirtotiedosto ostotilauksen kirjaukseta. Tiedosto välitetään tarvittaessa ketjussa pääpaikalle. Siirtosuunta on vain SKJ->dafo.

Dafon alkuperäinen kuvaus

Ostotilaukset

Ostotilaustietue

Siirtosuunta:

• MYYMÄLÄJÄRJESTELMÄ → DAFO
• DAFO → MYYMÄLÄJÄRJESTELMÄ

Ostotilausrivitietue 1

Siirtosuunta:

• MYYMÄLÄJÄRJESTELMÄ→DAFO
• DAFO->MYYMÄLÄJÄRJESTELMÄ

Ostotilausrivitietue 2

Siirtosuunta:

• MYYMÄLÄJÄRJESTELMÄ→DAFO
• DAFO->MYYMÄLÄJÄRJESTELMÄ

Tietue siirretään vain silloin, kun joku kentistä 7-10 sisältää tietoa.

Ostotilausrivitietue 3

Siirtosuunta:

• MYYMÄLÄJÄRJESTELMÄ→DAFO
• DAFO->MYYMÄLÄJÄRJESTELMÄ

Tietue siirretään vain silloin, kun tilausrivillä on erihintaisia kokoja.

Ostotilausrivitietue 4

Siirtosuunta:

• MYYMÄLÄJÄRJESTELMÄ→ DAFO
• DAFO → MYYMÄLÄJÄRJESTELMÄ 

Tietue toistuu niin monta kertaa, että kaikki tilatut koot saadaan siirretyksi.

Kirjanpitoliittymä

Reskontraliittymä

ALSO

Tuotetietoliittymä

SKJ:sta on mahdollista hakea suoraan tuotetietoja ALSOn XML-WebServicen kautta.

Palvelu on ALSOn puolelta maksullinen ja siihen pitää tilata erikseen rajapintatunnukset.

Määritykset

ALSOsta saatavat tunnukset syötetään WinSKJ -> Tiedosto -> Asetukset -> GlobalBlue/ALSO -välilehdelle.

• Palvelimen osoite:
  Älä muuta oletusarvosta (http://www.gnt.fi/scripts/MultiWeb.dll?GetXMLDomainName)
• Alson käyttäjätunnus:
  ALSOsta saamasi käyttäjätunnus
• Alson salasana:
  ALSOsta saamasi käyttäjätunnus
• Alson avain:
  ALSOsta saamasi avain
• Alson lähettäjän ID:
  ALSOsta saamasi YritysID
• Alson varastosaldot päivitetään varastoihin:
  Syötä tähän varaston numero johon haluat ALSOn varastosaldot päivitettävän

Käyttö

Tuote tulee olla perustettuna ensin. Tämän jälkeen syötä tuotteelle ALSOn tuotekoodi joko tuotteen Tilauskoodi -kenttään tai Toimittajat -välilehdelle Tilauskoodi -kenttään.

ALSOn tuotekoodi on sama tuotekoodi joka näkyy ALSOn web-palvelussa Koodi -kentässä.

Tämän jälkeen Tilauskoodi -kenttää klikattaessa hiiren oikealla painikkeella hakee ohjelma tiedot ALSOlta.

Haettavat tiedot:

• Varastosaldo ALSOn asetuksissa määriteltyyn varastopaikkaan
• Tuotteen ostohinta viim. ostohinta -kenttään
• Tuotteen nimi Tuotteen nimi -kenttään
• Tuotteen kuvaus Tuotteen teksteihin verkkokauppa-asetuksissa määriteltyyn kuvaus -otsikon alle
• Takuu tuotteen Takuu -kenttään
• Tuotekuvan URL:n tuotteen kuviin

Kirjavälitys

Saapumisalusta

Muodostetaan hallinnossa sijaitsevasta ostotilauksesta siten että lähetetään Kirjavälitykselle aineisto Kirjavälitykseen varastoon tilatuista tavaroista.

Mallitiedosto: Saapumisalusta_malli.xml.txt

Toimitusmääräys

Muodostetaan myymälässä sijaitsevasta ostotilauksesta siten että lähetetään Kirjavälitykselle toimitusmääräys myymälään toimitettavista tavaroista.

Mallitiedosto: Toimitusmaarays_malli.xml.txt

Varastosaldot

Vastaanottaa tuotteiden varastosaldot Kirjavälityksen varastosta.

Mallitiedosto: Varastosaldot_malli.xml.txt

Tuotetuonti

Tuo Kirjavälityksen tuotetietoja järjestelmään. Ylläpito -> KV tuotetuonti (XML)

Wihuri

Ostotilaustuonti

.

GlobalBlue

Tax Free -sekki

Lisädokumentaatio: Global_Blue_Tax_Free_sekki .

Tuotetuonnit

IKH

TUOTENRO;NIMIKE;OVH;NETTO;ALE;RYHMA;PERHE;PAKK;EAN;YKS

Vakioitu Excel-formaatti

Tuotteet tuodaan vakioidulla Excel-formaatilla.

• Sabluuna: SKJTuoteImport.xls

Rajoitteet:

• Tuoteimport tuo ainoastaan kappaletavaratuotteet (ei värikokolajitelmia).
• Jokaisessa kentässä tulee olla joku tieto (esim HR Kpl tulee olla 0 mikäli hyllynreunalappuja ei haluta tuotteelle).

Ostotilaustuonti

Ostotilauksia voidaan tuoda csv tiedostosta tai winskj:n muodostosta waybill sanomasta. Nykyinen Csv pohjainen tuonti on tarkoitettu lajitelmatuotteille.

Myyntien tuonti

katso myyntien tuominen

Myyntien vienti

Myynnit voidaan viedä kahdella liittymällä

1. SkjScript perusteinen myynti-script.
2. nrf-arts:n retail transaction. Nykyisellä versiolla tämä soveltuu hyvin lajitelmatuotteita myyvään ympäristöön, jossa EAN on yksilöivä.

Myynti vienti / skjscript

Myyntivienti skjscript vie tuotemyynnit csv tiedostoon seuraavasti:

• Erotin on sarkain.
• Tiedostoon viedään yksi päivä kerrallaan.
• Tiedoston nimi voidaan määrätä, siinä voi olla aja ajankohdan aikaleima.
• Komentoriviparametrit
• Desimaalieroitin on muodostavan järjestelmän erotin.
  • esim skjscript /run /f:myyntivienti.pas /kanta:SKJ /F:myyntiyymmdd.txt /PVM:20110405
  • /run /f:myyntivienti.pas ovat pakollisia.
  • /kanta määrää mistä skj kannasta luetaan tiedot, oletus SKJ.
  • /F:määrä kohde tiedoston hahasulkeiden välissä oleva merkkijono korvataan siirtohetken aikaleimalla, voi olla myös tunnit, minuutit ja sekunnit (hh,nn,ss).
  • /PVM: määrää miltä päivältä myynti ajetaan. Jos ei anneta, olettaa ennen 11.00 ajettuna eilistä, muutoin tämä päivä.

Lajitelmien tms tuonti / skjscript

Lajitelmat voidaan tuoda WinSKJ:n seuraavassa muodossa. Erotin merkki voi olla pilkku, puolipiste tai sarkain, ohjelma haistaa sen ensimmäisen rivin perusteella. Lopputiedostossa erotinmerkin pitää olla sama. Merkkijonot, joissa voi sisällä olla erotinmerkki, on hyvä suojata lainausmerkeillä esim. "TUOTE, PITKÄ". Jos nimessä on lainausmerkki sen voi suojata kenoviivalla esim. "VARARENGAS 28\"".

1;100;"KIRJANKOOT";"SIZE"
2;10010;"XXS";1
2;10011;"XS";2
2;10012;"S";3
2;10013;"M";4
2;10014;"L";5
2;10015;"XL";6
2;10016;"XXL";7
1;200;"VÄRIT";"COLOR"
2;1;"WHITE";1
2;2;"RED";2
2;3;"BLACK";3
2;4;"YELLOW";4
2;5;"GREEN";5

3;100100;6498765432107;10012;2
3;100100;6498765432114;10012;3
3;100100;6498765432121;10014;1

7;100200;0020188050185
7;100200;018176787007
7;100201;99112111211

Ryhmien tuonti / skjscript

Ryhmät voidaan tuoda seuraavassa muodossa:

Esimerkki aineisto

4;1;PAIDAT;3000
4;2;HOUSUT;3000
4;3;KAHVILA;3000
4;4;MUUMYYNTI;3001
5;10;MIESTEN PAIDAT;3000;1;1;1
5;11;NAISTEN PAIDAT;3000;1;1;1
5;12;MUIDEN PAIDAT;3001;1;1;1
5;31;KAHVI;3002;3;2;2
6;100;MIESTEN PITKÄHIHAISET PAIDAT;10
6;101;MIESTEN LYHYTHIHAISET PAIDAT;10

Luokka__Asennus ja määrittely
Luokka__Käyttöohjeet ja tukimateriaali
Luokka__Tekninen palvelu

Myyntitilaustuonti Excel-taulukosta

Myyntitilaus voidaan tuoda seuraavanlaisesta excelistä
Rivillä 1 sarakeotsikot, ne ohitetaan.

Tuonti löytyy myyntitilauksen käyttöliittymästä valikosta liittymät. Mikäli myyntitilauksen asetuksissa on valittuna "Ubl1 sanomassa hinnoittelu käytössä", hinnoitellaan tämäkin tuonti asiakashintojen mukaan.

Jos tuotavan Excel-tiedoston AhintaAlv0-sarake on tyhjä (ei nolla), pitää kyseinen arvo hakea tuotteelta määritellsytä hintatasosta.
Alennus% joka luetaan myyntitilaukselle, tyhjä sarake on 0%.
Myyntierät toimii samalla periaattella kuin hinta-sarake, eli jos se on tyhjä, haetaan tieto tuotteelta.

Ostotilaustuonti / Waybill

Waybill-malli:

MT (Lähettävä pää):

1. Luo C:\WINSKJ\WAYBILL -hakemisto
2. Määritä MT asetukset https://www.dropbox.com/s/3bggxag7vqly583/Screenshot%202014-06-04%2012.15.49.png
3. Tee jollekin tilaukselle toimitus
4. Tarkista, että waybill muodostui hakemistoon

Siirrä XML jollain tavalla (btsync?) vastaanottajalle

OT (Vastaanottava pää):

1. Luo C:\WINSKJ\WAYBILLPALAUTE -hakemisto
2. Määritä OT asetukset https://www.dropbox.com/s/n399edb5qh7al7g/Screenshot%202014-06-04%2012.19.13.png
3. Lue WB sisään:
4. skjot /wb KANTA /usea /toim=1000 /TP=C:\WINSKJ\WAYBILL\WB.XML /VA=2
   • Toim = tilauksen luontiin käytettävä otimittaja
   • TP = Tiedostopolku, mistä tilaukset luetaan
   • VA = Varasto, johon tilaus luodaan

Ostotilaus luo palautteen palautehakemistoon XML-muodossa.

Ostotilaustuotetuonti / Waybill

OT (Vastaanottava pää):

Luetaan Waybill sanomasta tuotteet ja perustetaan ne kantaan jos tuotetta ei ole. Huom ostotilauksia ei tällöin perusteta.

1. Luo C:\WINSKJ\WAYBILLTUOTE -hakemisto
2. Määritä OT asetukset sivulle "Lisäasetukset -> Waybill/Logmaster " kohtaan "WayBill tuotelisäys kansio ja tiedostot " polku esim. C:\winskj\WayBillTuote*.xml
   • SKJOT /WBTU /kt:käyttäjätunnus /eraajo alias (käynnistys komentojonosta parametreilla)
3. Voidaan ajaa myös suoraan ostotilaukselta valikolta "Liittymät -> Tee uusia tuotteita Waybill -sanomista"
4. Ajo tekee logia toiminnasta yrityshakemistoon tiedostoon WayBillProduct.log

UBl Order sanoman luonti vastaanotetusta sanomat

Mikäli sanomassa on tagi <tt><skj:createsalesorder>True<skj:createsalesorder></tt>, luodaan sanoman sisäänluvun jälkeen normaalin säännöin UBL order. Tagi sijaitsee samassa tasosa kuin ID tai IssueDate. Lisäksi tarvitaan nimiavaruusmäärittlely <tt>xmlns:skj="skj"</tt> jonnekin nimiavaruuksien sekaan.

Ostotilaustuloutus / Waybill

Kirjaa määrät ostotilaukselle ja mahdolliset hinnat ja suorittaa saavutuksen.

Ajetaan komennolla (tämä vaihtoehto käyttää asetuksissa määrättyä polkua)

1. SKJOT /WBT /kt:käyttäjätunnus /eraajo alias
   tai jos polku halutaan antaa komentorivillä
   #SKJOT /WBT:c:\polku\tiedosto*.xml /kt:käyttäjätunnus /eraajo alias