MAXX-integraatio: tuotepäivitykset

ApteekitTarkistettu 18.11.2026

MAXX-integraatio päivittää verkkoapteekin tuotteille varastosaldot, hinnat ja varastopaikan MAXX-järjestelmästä. Integraatio voi myös asettaa tuotteen näkyville ja laittaa tuotteita myyntiin tai pois myynnistä varastosaldon perusteella.

Kaikkien tuotteiden saldot ja hinnat päivittyvät kerran vuorokaudessa. Lisäksi kauppa päivittää useita kertoja vuorokaudessa niiden tuotteiden varastosaldot, jotka ovat muuttuneet MAXXissa. Katso Ajastukset.

Ota varastosaldojen ja hintojen päivitys käyttöön

  1. Avaa Asetukset > MAXX-integraation asetukset. Tarkistettava: reseptimyynnin asetuksissa sivun nimi on MAXX-integraation asetukset (v2); ovatko tuotepäivitykset samalla sivulla
  2. Valitse asetukseen MAXX-integraatio käytössä arvo Kyllä.
  3. Täytä kentät Integraatiopalvelimen osoite, Käyttäjätunnus ja Salasana. Ne ovat sen palvelimen tunnukset, jolle kauppa siirtää tiedot ja josta MAXX hakee ne.
  4. Määritä myyntien asetukset, jos siirrät tilaukset MAXXiin.
  5. Määritä MAXXTAXA-tiedoston asetukset, jos tuot sekä saldot että hinnat. Jos tuot vain varastosaldot, määritä saldotiedostojen asetukset.
  6. Määritä maksutapa-asetukset: jokaiselle kaupan maksutavalle, miten sillä maksetut tilaukset käsitellään MAXXissa. Vaihtoehdot ovat maksettu tilaus, kortilla ja laskulla.
  7. Valitse Tallenna.

Myynnit

Voit siirtää kaupan tilaukset MAXX-järjestelmään. Tarkistettava: onko tämä tilaussiirto yhä käytössä vai korvaako sen MAXX-integraation (v2) reseptimyynti

Asetus Mitä se tekee
Geneerinen asiakasnumero Asiakasnumero, jonka alle verkkokaupan tilaukset siirretään MAXXissa.
Viive tilauksen toimitusaikaan Kauppa laskee toivotun toimitusajan lisäämällä tämän viiveen aikaan, jolloin tilaus siirrettiin MAXXiin.
Tilaustiedostojen kansio Kansio MAXXin palvelimella, johon tilaustiedostot siirretään.
Lähetä tilaus automaattisesti Lähettää tilauksen MAXXiin automaattisesti.
Lähetä tilaus tapahtumassa Lähettää tilauksen MAXXiin, kun tilaus on luotu, tai vasta kun se merkitään maksetuksi.

Varastosaldot ja hinnat MAXXTAXA-tiedostosta

Asetus Mitä se tekee
Ota käyttöön varastosaldojen ja hintojen päivitys (korvaa öisen varastosaldojen päivityksen) Ottaa tietojen tuonnin käyttöön.
MAXXTAXA.dat-tiedoston polku Polku tiedostoon, jossa MAXXin tiedot ovat.
Alias-kenttä MAXXTAXAssa, yleensä 0 (id), 1 (ean) tai 2 (vnr) MAXXin tuotekoodi, jota kauppa käyttää tuotenumerona.
Hinnan kenttä MAXXTAXAssa, yleensä 9 (verollinen hinta) MAXXin hintakenttä, joka tallennetaan tuotteen listahinnaksi.
Alkuperäisen hinnan kenttä MAXXTAXAssa, yleensä 28 (verollinen hinta) MAXXin hintakenttä, joka tallennetaan tuotteen alkuperäiseksi hinnaksi. Kauppa tallentaa sen vain, jos se eroaa listahinnasta.
Varastosaldo MAXXTAXAssa, yleensä 26 (varastosaldo) MAXXin kenttä, josta varastosaldo tuodaan.
Varastopaikan kenttä MAXXTAXAssa, yleensä 27 MAXXin kenttä, josta varastopaikka tuodaan.
Varastopaikan attribuutti verkkokaupassa Tuotekenttä, johon varastopaikka tallennetaan kaupassa.
Näkyvissä verkkokaupassa -kenttä MAXXTAXAssa, yleensä 29 MAXXin kenttä, jossa on tieto tuotteen näkyvyydestä.
Tuo tuotteiden näkyvyydet MAXXTAXAsta Asettaa tuotteen näkyville tai pois näkyvistä tiedoston perusteella. Reseptilääkkeitä ei piiloteta tämän tiedon perusteella.
Jätä rivi kokonaan käsittelemättä, jos näkyvyyskentässä on nolla Jättää saldon ja hinnan tallentamatta, jos riviä ei ole merkitty näkyväksi.
Alennusprosentti vapaan kaupan tuotteille Prosentti, jolla kauppa laskee vapaan kaupan tuotteille alennetun hinnan MAXXin hinnasta.
Pyöristyssääntö alennuksen laskennan jälkeen ja Pyöristystarkkuus Miten laskettu alennushinta pyöristetään.
Hae tuotteita myös MAXXin tuotenumerolla Ota käyttöön, jos MAXXissa on eri tuotenumerot kuin kaupassa. Integraatio hakee silloin tuotteita myös kentän Tuotenumero MAXXissa perusteella.

Pelkät varastosaldot

Jos et halua tuoda hintoja MAXXista, voit tuoda pelkät varastosaldot.

Asetus Mitä se tekee
Varastosaldotiedoston kansio (kaikki tuotteet) Polku tiedostoon, jossa ovat kaikkien tuotteiden tiedot.
Varastosaldotiedoston kansio (muuttuneet saldot) Polku tiedostoon, jossa ovat niiden tuotteiden tiedot, joiden saldo on muuttunut MAXXissa.
Alias-kenttä saldot.csv ja saldotkaikki.csv-tiedostoissa, yleensä 2 (id), 3 (vnr) tai 4 (ean) MAXXin tuotekoodi, jota kauppa käyttää tuotenumerona.
Varastosaldon kenttä saldot.csv ja saldotkaikki.csv-tiedostoissa, yleensä 5 (varastosaldo) Kenttä, josta varastosaldo tuodaan.
Laita tuotteet pois myynnistä Laittaa tuotteen pois myynnistä, kun varastosaldo on nolla. Ei koske reseptilääkkeitä.
Laita tuotteet takaisin myyntiin Laittaa tuotteen takaisin myyntiin, kun varastosaldo on suurempi kuin nolla.
Estä reseptilääkkeiden varastosaldopäivitykset Reseptilääkkeiden saldoja ei päivitetä MAXXista. Katso Varastosaldopäivitysten estäminen.
Estä huumetuotteiden varastosaldopäivitykset Huumeeksi luokiteltujen tuotteiden saldoja ei päivitetä MAXXista.
Estä kylmätuotteiden varastosaldopäivitykset Kylmätuotteiden saldoja ei päivitetä MAXXista.
Jos reseptilääkkeen varastosaldo on 0 Mitä tehdään, kun reseptilääkkeen saldo on MAXXin tiedostossa 0: tallennetaan saldo 0 tai tyhjennetään kenttä.
Päivitä tiedot kaikille tuotteille, joilla sama tuotenumero Jos kaupassa on päätuotteita ja variaatiotuotteita samalla tuotenumerolla, päivittää tiedot kaikille löytyneille tuotteille.

Tuotteen MAXX-välilehti

Tuotteen MAXX-välilehdellä on tuotekohtaiset asetukset.

Asetus Mitä se tekee
Kustannuspaikka Tuotteen kustannuspaikka. Tarkistettava: lähteessä ei ole kuvausta kentälle
Tuo varastosaldo Kun asetus on valittu, tuote saa varastosaldon MAXXin tiedostosta, jos saldo löytyy. Voit estää saldon päivityksen tuotekohtaisesti.
Tuo hinta Voit estää hinnan päivityksen tuotekohtaisesti.
Käytä MAXXin hintaa ilman alennusta Estää tuotteelta alennuksen laskennan, jos olet ottanut sen käyttöön vapaan kaupan tuotteille yleisissä asetuksissa.
Alennusprosentti vapaan kaupan tuotteelle Tuotteen oma alennusprosentti. Käytä, jos haluat eri prosentin kuin yleisissä asetuksissa tai alennuksen vain joillekin tuotteille.
Tuotenumero MAXXissa Tuotenumero, jolla tuote on MAXXin tiedostossa, jos se eroaa kaupan tuotenumerosta. Numeron pitää olla sama kuin asetuksessa Alias-kenttä MAXXTAXAssa määritetyssä kentässä.

MAXXTAXAn tuonti

Verkkoapteekki lukee MAXXTAXA-tiedoston kerran vuorokaudessa. Oletuksena kauppa tuo vain ne tuotteet, joiden tiedot ovat muuttuneet edellisen päivän tiedostoon verrattuna. Näin päivitys on nopeampi.

Voit pakottaa seuraavan ajon tuomaan kaikki tiedoston tuotteet. Valitse MAXX-integraation asetuksissa Tee seuraavasta ajosta täysi ajo.

SAL- vai YA-taksa

Jos apteekissa on käytössä SAL-taksa, tuotenumerot ovat yleensä samat verkkokaupassa ja MAXXissa. Jos apteekissa on käytössä YA-taksa, vapaan kaupan tuotteilla voi olla MAXXissa eri tuotenumerot kuin verkkoapteekissa. Näin voi käydä esimerkiksi, kun vapaan kaupan tuotteet on tuotu verkkoapteekkiin SAL-integraatiolla.

Jos tuotenumerot eroavat, kirjoita tuotteille MAXXin tuotenumero kenttään Tuotenumero MAXXissa. Muuten hinnat ja varastosaldot eivät päivity näille tuotteille.

Voit tuoda tuotenumerot esimerkiksi Tuo/vie-toiminnolla. Tuonti lukee tuotenumeron sarakkeesta MaxxProductNumber.

Varastosaldopäivitysten estäminen

Voit estää varastosaldon päivityksen tuotekohtaisesti tuotteen MAXX-välilehdellä asetuksella Tuo varastosaldo.

Kun otat MAXX-integraation asetuksissa käyttöön asetuksen Estä reseptilääkkeiden varastosaldopäivitykset, kauppa poistaa tallennuksessa kaikilta reseptilääkkeiltä asetuksen Tuo varastosaldo. Sama koskee huumetuotteita ja kylmätuotteita, kun otat käyttöön niiden estoasetuksen.

Kun olet poistanut eston käytöstä ja tallentanut asetukset, sivulla näkyy, monelta reseptilääkkeeltä saldopäivitykset on estetty tuotteen MAXX-välilehden asetuksella. Valitse Salli varastosaldojen päivitykset näille tuotteille, niin päivitykset sallitaan kaikille reseptilääkkeille. Samoin toimit kylmätuotteille ja huumetuotteille.

MAXX-integraation Yleinen-välilehti. Ilmoituksessa kerrotaan, monelta kylmätuotteelta ja reseptilääkkeeltä saldopäivitykset on estetty, ja kummankin rivin perässä on linkki Salli varastosaldojen päivitykset näille tuotteille.

Ajastukset

Tapahtuma Aika
MAXX luo tiedoston klo 8.00
Kaikki saldot ja hinnat päivittyvät päivittäin klo 8.05 jälkeen
Muuttuneet saldot päivittyvät 30 minuutin välein

MAXXilta saatu tuotedata

Tuotteen MAXX-välilehdellä näet MAXXilta saadut tiedot, joilla tuotteen hinta ja saldo on päivitetty. Valitse Näytä lisätiedot.

Tieto Mitä se kertoo
Hinta tuotu Aika, jolloin hinta tallennettiin MAXXin tiedostosta, ja tiedoston rivi, josta tiedot tuotiin. Hintasarake on korostettu.
Varastosaldo tuotu Aika, jolloin saldo tuotiin tiedostosta, jossa on kaikkien MAXXista päivittyvien tuotteiden saldot, ja tiedoston rivi, josta saldo luettiin.
Pelkkä varastosaldo tuotu Aika, jolloin saldo tuotiin tiedostosta, jonka MAXX luo päivän aikana muuttuneista saldoista, ja tiedoston rivi, josta saldo luettiin.

Sivulla Asetukset > MAXX-integraation asetukset > Yleinen näet, milloin integraatio on ajettu. Sivulla näkyy luettu tiedosto, lukuaika ja tiedoston viimeinen muokkausaika MAXXissa, jos se saadaan luettua. Muokkausajasta huomaat, jos tiedosto on jäänyt MAXXissa päivittämättä ja on hyvin vanha.

Osio Tiedot tuotu kauppaan, jossa tiedostoille saldot.csv ja MAXXTAXA.DAT näkyvät tuontipäivämäärä ja tiedoston muokkauspäivämäärä.

Tuotetiedot, jotka tulevat MAXXTAXA-tiedostosta

Tuoteintegraatiot tuovat verkkokauppaan nämä tuotetiedot: Tarkistettava: lähteessä lista on otsikolla Tuoteintegraatioista verkkokauppaan tulevat tuotetiedot; kenttien järjestys vastaa MAXXTAXA-tiedostoa (esim. verollinen hinta 10. kenttä = indeksi 9), mutta indeksien 22–25 kentät puuttuvat listasta

  • varastokoodi
  • viivakoodi
  • tuotenumero (vnr)
  • tuoteryhmä
  • rekisterimerkintä
  • erikoisehto
  • poistomerkinnät tai muu luokittelukentän tieto
  • veroton tukkuhinta (sentteinä)
  • veroton myyntihinta (sentteinä)
  • verollinen myyntihinta sentteinä, myös kampanjahinta tai tarjoushinta
  • valmisteen nimi
  • lääkkeen vahvuus
  • lääkemuotolyhenne
  • markkinoija, myyntiluvan haltija tai valmistaja
  • pakkauskoko
  • korvattavat sairaudet pisteellä eroteltuna
  • tukkuliike
  • tukkupakkauksen koko
  • ATC-koodi
  • ALV-koodi (1 = 24 %, 2 = 10 %, 3 = 18 %) Tarkistettava: ALV-prosentit ovat vanhentuneita; tarkista nykyiset koodit
  • vaikuttavat aineet
  • substituutioryhmä
  • saldo (vapaa saldo)
  • varastopaikka
  • normaalihinta
  • verkkokauppatuote (0 = ei, 1 = kyllä)

Liittyvät ohjeet

Etkö löytänyt vastausta?

Tuki auttaa arkisin klo 9–16.

Ota yhteyttä tukeen