Pardco Group Oy Magento Trustpoint integraatio/maksutapa - moduuli Asennus- ja asetusohjeet Pardco Group Oy 9/6/2013
Sisältö Yleistä moduulista... 2 Moduulin asennus... 2 Asetukset... 2 Trustpoint Invoice ja Trustpoint Evoice maksutapojen asetukset... 2 Integraatiota ja maksutavan esitystä koskevat asetukset... 3 Trustpoint laskutusasetuksien määrittäminen asiakaskohtaisesti... 6 Trustpoint maksutapojen salliminen yksittäiselle henkilölle... 6 Trustpoint laskujen automaattinen rahoitus yksittäiselle henkilölle... 6 Trustpoint API käyttöliittymä... 7 Trustpoint-laskujen vienti Trustpoint-järjestelmään manuaalisesti... 8 Maksettujen Trustpoint-laskujen päivitys manuaalisesti... 8 Virhelista... 8 Trustpoint-integraation automatisointi ajastetulla Cron-ajolla... 9
Yleistä moduulista Moduuli mahdollistaa integraation Magento-verkkokaupan ja Trustpoint-järjestelmän välillä. Moduuli lisää verkkokauppaan Trustpoint Invoice- ja Trustpoint Evoice maksutavat, joilla tehtyjen tilausten laskut integroidaan Trustpoint-järjestelmään. Trustpoint Invoice maksutavalla tehty lasku voidaan lähettää asiakkaalle kauppiaan haluamalla tavalla ja Trustpoint Evoice lähetetään sähköisenä E-laskuna. Trustpoint laskut voidaan myös rahoittaa, mikäli käyttäjällä on Trustpoint Kapital Group Oy:n kanssa voimassa oleva rahoituksen mahdollistava sopimus. Moduulin asennus 1. Varmuuskopioi Magento-kauppasi 2. Pura pakattu moduuli jonka latasit verkkokaupasta 3. Kopioi kaikki puretut moduulitiedostot Magento-kauppasi juuripolkuun 4. Kirjaudu Magenton hallinnointipaneeliin ja päivitä välimuistit 5. Mikäli käytät Compiler-työkalua, ota se pois päältä tai aja Compilation-prosessi uudestaan 6. Kirjaudu ulos Magenton hallintapaneelista Asetukset Magento Trustpoint -moduulin asetukset on jaettu kahteen osaan, koska moduuli sisältää sekä Trustpoint Invoice ja Trustpoint Evoice maksutavat että integraation Trustpoint-järjestelmään. Maksutavan asetukset löytyvät kohdasta Järjestelmä->Asetukset->Maksutavat. Muut integraatiota ja maksutavan esitystä koskevat asetukset löytyvät kohdasta Järjestelmä->Asetukset->Trustpoint Asetukset. Trustpoint Invoice ja Trustpoint Evoice maksutapojen asetukset Käytössä o Maksutavan aktiivisuus. Ei = Maksutapaa ei näytetä missään. Uuden tilauksen tila o Tilauksen tila, joka asetettaan kyseisellä maksutavalla luodulle uudelle tilaukselle. Otsikko o Asiakasnäkymässä kassalla näytettävä nimi maksutavalle. Piilota asiakasnäkymästä o Piiloitetaanko maksutapa asiakkailta. Maksutapa pysyy kuitenkin näkyvissä admin-puolella. Rahoitus o Merkitsee Trustpoint laskut automaattisesti rahoitettaviksi
Integraatiota ja maksutavan esitystä koskevat asetukset Käyttäjätunnus (CID) o Trust Kapital Group Oy:n toimittama Truspoint-tilikohtainen CID-tunnus. Salasana (Api Code) o Trust Kapital Group Oy:n toimittama Truspoint-tilikohtainen salasana. Eräpäivä o Kuinka monta päivää laskun luomisesta eteenpäin merkitään eräpäiväksi. Oletus laskutustapa o Mikäli asiakas on oikeutettu valitsemaan laskutustapa tilaukselleen, on tämä valittuna oletuksena asiakasnäkymässä. Jos ei, käytetään tätä laskutustapaa aina maksettaessa Trustpoint Invoice - maksutavalla Asiakas on oikeutettu valitsemaan itse laskun toimitustavan o Asiakkaalle annetaan mahdollisuus valita itse Trustpoint Invoice laskun toimitustapa Salli sähköpostitse lähetettävän laskutus erilliseen sähköpostiosoitteeseen o Asiakkaalle annetaan mahdollisuus tilata sähköpostitse lähetettävä Trustpoint Invoice lasku vapaasti valittavaan sähköpostiosoitteeseen. Mikäli tätä ei sallita, käytetään asiakkaan asiakastilin sähköpostiosoitetta Asiakkaalle sallitut laskutustavat o Mikäli asiakkaalle on sallittu laskun toimitustavan valinta, voidaan tässä kentässä määrittää mitä laskun toimitustapoja asiakas voi valita
Kauppiaan oman laskun toimitustavan kuvaus o Tämän kentän teksti näytetään asiakasnäkymässä asiakkaille em. kentässä olevan Oma toimitus tiedon paikalla Viivästyskorko o Viivästyskorkoprosentti Lähetä automaattinen maksumuistutus o Lähetetäänkö tilauksen asiakkaalle maksumuistutus automaattisesti, mikäli tilausta ei ole maksettu eräpäivään mennessä. Maksutavan näkyvyys o Määritys, kenelle Trustpoint Invoice ja Trustpoint Evoice maksutavat ovat näkyvissä. Pelkät maksutapakohtaiset asetukset (Näkyvyys riippuu pelkästään maksutapojen asetuksista) Valitut asiakkaat (Näkyvyys riippuu maksutapojen asetuksista JA siitä, onko yksittäiselle asiakkaalle annettu oikeus käyttää Trustpoint-maksutapoja (ks. kohta 4)) Valitut asiakasryhmät (Näkyvyys riippuu maksutapojen asetuksista JA siitä, kuuluuko asiakas asiakasryhmään, jolle on annettu oikeus käyttää Trustpointmaksutapoja (ks.alla))) Valitut asiakkaat ja asiakasryhmät (Näkyvyys riippuu maksutapojen asetuksista JA siitä, onko yksittäiselle asiakkaalle annettu oikeus käyttää Trustpoint-maksutapoja (ks. kohta 4) TAI kuuluuko asiakas asiakasryhmään, jolle on annettu oikeus käyttää Trustpoint-maksutapoja (ks.alla)) Asiakasryhmä jolle Trustpoint maksutavat ovat käytössä o Asiakasryhmä jonka jäsenille Trustpoint maksutavat ovat näkyvissä. Tämä vaihtoehto toimii vain tapauksissa, joissa maksutavan näkyvyydeksi on valittu Valitut asiakasryhmät tai Valitut asiakkaat ja asiakasryhmät Tallenna asiakkaan kassalla antamat tiedot koskien Trustpoint maksutapoja o Jotta asiakkaan tulevat tilausprosessit helpottuisivat, voidaan asiakkaan Trustpoint laskuissa käyttämät tiedot tallentaa asiakastiliin, jolloin tietoja käytetään automaattisesti seuraavan kerran kun asiakkaan käyttäessä Trustpoint maksutapoja
Trustpoint laskutusasetuksien määrittäminen asiakaskohtaisesti Trustpoint maksutapojen asetuksia voidaan myös määrittää asiakaskohtaisesti. Trustpoint maksutapojen salliminen yksittäiselle henkilölle Trustpoint maksutapojen käyttäminen voidaan myös sallia vain yksittäisille henkilöille. Tämä vaihtoehto toimii vain tapauksissa, jossa maksutavan näkyvyydeksi (ks.kohta 3) on määritelty Valitut asiakkaat tai Valitut asiakkaat ja asiakasryhmät. Maksutapaoikeus voidaan asettaa yksittäiselle asiakkaalle valitsemalla asiakas asiakasvalikosta (Valikossa Asiakkaat->Hallinnoi asiakkaita) ja asettamalla tälle Trustpoint maksutavat näkyvissä kentän arvoksi Kyllä. Trustpoint laskujen automaattinen rahoitus yksittäiselle henkilölle Haluttaessa voidaan merkitä kaikki asiakkaan Trustpoint laskut automaattisesti rahoitettavaksi. Automaattinen rahoitus voidaan asettaa yksittäiselle asiakkaalle valitsemalla asiakas asiakasvalikosta (Valikossa Asiakkaat->Hallinnoi asiakkaita) ja asettamalla tälle Trustpoint maksutavat näkyvissä kentän arvoksi Kyllä.
Trustpoint API käyttöliittymä Trustpoint API käyttöliittymän avulla voidaan hallita Trustpoint Magento integraatiota käsin. Käyttöliittymä mahdollistaa laskujen viennin Trustpointiin sekä maksettujen laskujen päivityksen Magentoon.
Trustpoint-laskujen vienti Trustpoint-järjestelmään manuaalisesti Avoimet Trustpoint-laskut voidaan viedä käsin Trustpoint-järjestelmään Magenton hallinnasta kohdasta Trustpoint-> Trustpoint API. Valitse ensiksi avoimena olevat laskut jotka haluat viedä Trustpointiin. Valitse myös laskut jotka haluavat rahoitettavan. Mikäli yleisissä asetuksissa tai asiakaskohtaisissa asetuksissa on määritetty lasku automaattisesti rahoitettavaksi, asetetaan rahoitusvalinta valituksi. Tämä ei kuitenkaan estä poistamasta rahoitusta laskulta. Kun vietävät ja rahoitettavat laskut on valittu, voit aloittaa laskujen siirron Trustpointiin klikkaamalla Vie maksutapahtumat - painiketta. Maksettujen Trustpoint-laskujen päivitys manuaalisesti Maksettujen Trustpoint laskujen tilan voi päivittää käsin Magentoon Magenton hallinnasta kohdasta Trustpoint-> Trustpoint API. Klikkaamalla Tarkista ja päivitä laskut painiketta integraatio hakee Trustpoint järjestelmästä maksetut laskut ja vertaa niitä Magentossa oleviin Trustpoint laskuihin. Mikäli maksettu lasku löytyy Magentosta, merkitään se automaattisesti maksetuksi. Virhelista Trustpoint Api käyttöliittymä sisältää myös virhelistan, johon kirjataan integraation aikana tapahtuneet virheet. Virheet näytetään vain avoinna olevista Trustpoint maksutavoilla tilatuista tilauksista.
Trustpoint-integraation automatisointi ajastetulla Cron-ajolla Trustpoint integraatio voidaan ajastaa toimimaan automaattisesti Magenton sisäisen Cron-järjestelmän mukaisesti. Lisää tietoa tästä löydät osoitteesta http://www.magentocommerce.com/wiki/1_- _installation_and_configuration/how_to_setup_a_cron_job. Trustpoint-integraatio voidaan myös automatisoida suoraan palvelimelta Cron-ajolla asettamalla seuraavien esimerkkien mukaiset Cron-ajot Crontab-ohjelmaan: Trustpoint-laskujen vienti Trustpoint-järjestelmään (tunnin välein): 0 * * * * /usr/bin/php -f /polku/magento/kansioon/shell/trustpoint.php export_invoices Trustpoint-laskujen päivitys Magentoon (tunnin välein): 0 * * * * /usr/bin/php -f /var/www/magento1_7_0_2/shell/trustpoint.php update_statuses