Fraktjakts oscommerce Fraktmodul Instruktionsmanual Välkommen Fraktjakt erbjuder en fraktmodul till e-handelssystem byggt på oscommerce som kommer att förenkla din vardag som webbutiksadministratör. Den här manualen beskriver hur du installerar och konfigurera Fraktjakt som en Add-on fraktmodul till din oscommerce webbutik. Den handlar också om hur man skapa ett nytt användarkonto i Fraktjakt.se för att kunna ställa in och börja använda din nya fraktmodul. Testa fraktmodulen idag! I instruktionerna här nedanför finns länkar till både Fraktjakt demo server och Fraktjakt live server. Vi rekommendera starkt att du först använder dig av demo servern för att kunna testa integrationen med din webbutik, helst en demo/test version av din webbutik. Då kan du bli bekant med hur systemet fungerar utan att riktiga fraktordrar genereras. OBS! När du välja live konfigurationen innebär det att riktiga fraktordrar skapas i Fraktjakts live server. Om du vill bara kolla på hur fraktmodulen fungerar och ser ut i en annan webbutik, då kan du titta på våran egen demo-butik som heter Wratchet Gear. Surfa till adressen http://www.fraktjakt.se:3333/webshop/ för att testa själv som en webbutikskund. Du kan logga in med E-postadressen demo@fraktjakt.se och lösenordet fraktjakt. Testa att välja någon produkt, lägg den i varukorgen och gå till kassan. Då kommer du att se fraktalternativ på nästkommande sida i butiken. Wratchet Gear är inget riktigt företag/webbshop så du kan köpa grejer utan att det bli riktiga köp. E-handelssystem som stöds oscommerce Online Merchant v2.2 RC 2a (med svenskt och/eller engelskt språk och svensk valuta) 1
Innan installationen Denna instruktionsmanual förutsätter att du har en befintlig oscommerce-baserade webbshop av den version som nämns ovan. Du ska även kunna hantera och administrera din webbshop med oscommerce administrationsgränssnittet. 1. Se till att ditt oscommerce system använder den rätta versionen av PHP och att vissa server extensions är med innan du försöker installera och använda Fraktjakt fraktmodulen: PHP version 5+ curl (server extension för PHP) SimpleXML (server extension för PHP) 2. Kör en backup av webbutikens databas och alla andra filer i ditt oscommerce system innan installation av fraktmodulen. 3. Hämta senaste versionen av Fraktjakt fraktmodul för oscommerce från http://www.fraktjakt.se/services/download/. Filen är komprimerad i zip format. Installera fraktmodulen 1. Unzip nedladdad fil för Fraktjakt fraktmodul till en ny katalog på din dator. 2. Använd din FTP klient och för över filerna till fraktmodulen från din dator till oscommerce systemets dator. Utgå från rotkatalogen av fraktmodulen och se till att du kopiera alla underkataloger och filer till de motsvarande kataloger i oscommerce systemet. 3. Hitta instruktionsfilen Modifieringar.txt i fraktmodulens rotkatalog och modifiera alla nämnde filer enligt instruktionerna som finns i Modifieringar.txt filen. Du bör kunna klipp och klistra direkt från Modifieringar.txt filen till oscommerce filerna. OBS! Var försiktigt och noggrann. Gör exakt som det står i instruktionerna. Följande modifieringar finns med i Modifieringar.txt filen: Kapitel 1. Fraktjakts API använder vikt och dimensioner för att beräkna så exakt fraktkostnad som möjligt. En egen sida tillägnas data för frakt, däribland även Taric koder som är obligatoriskt vid leverans till utland. Denna sida möjliggör att uppdatera flera produkter samtidigt. 2
Kapitel 2. Dimensioner och Taric kod saknas i order class objektet vid utcheckning i kassan. Detta lägger vi till. Kapitel 3. Shipping class objektet i oscommerce saknar möjlighet att utföra kommandon efter att order registrerats. Detta skapar vi. (Kapitel 4.) *** Endast om du använder TiM's osc Solutions - Safer Database Input Method Bidraget "TiM's osc Solutions - Safer Database Input Method" gör så att html/xml kod inte kan lagras i databasen. Här krävs en ändring för att cachade sökningar mot Fraktjakt skall kunna lagras korrekt. 4. Logga in i din oscommerce administrations konsol. 5. Klicka på Moduler och sedan på Frakt. 6. Notera att det nu finns en fraktmodul som heter någonting likt [TiM's osc Modules] Version 2009-05-01 :: Fraktjakt. Klicka på den raden och sedan klicka på [ + install ] för att installera modulen. 7. Nu är fraktmodulen installerat men ej klar för bruk ännu. Först måste du registrera ditt Fraktjakt.se användarkonto och konfigurera fraktmodulen innan det ska gå att använda. Fortsätt med nästa avsnittet. 3
Registrera ditt Fraktjakt.se användarkonto 1. Gå till sidan Registrera en användare i Fraktjakt : Demo: http://www.fraktjakt.se:3001/account/register (Rekommenderas för första tester!) Live: http://www.fraktjakt.se/account/register 2. Fyll i hela formuläret och tryck sedan på [registrera] knappen längst ner på sidan. 3. Ange aktiveringskoden i inmatningsfältet som presenterades. Koden ska du ha fått skickat till den emailadress som du angav vid registreringen. 4. Gå till sidan Webshopsinställningar : Demo: http://www.fraktjakt.se:3001/account/change_webshop (Rekommenderas för första tester!) Live: http://www.fraktjakt.se/account/change_webshop 5. Där kan du hitta din nya Fraktjakt Consignor id och Consignor nyckel. Dessa uppgifter behöver du när du håller på med följande avsnitt om hur man konfigurerar fraktmodulen.! För mer detaljer om konfigurations möjligheter för ditt Fraktjakt.se användarkonto se avsnittet här nedanför om Konfiguration av ditt Fraktjakt.se användarkonto. Konfigurera fraktmodulen 1. Logga in i din oscommerce administrations konsol. 2. Klicka på Moduler och sedan på Frakt. 3. Klicka på raden för Fraktjakt modulen och titta på adminpanelen till höger. Efter installationen av fraktmodulen bör du fått fram flera nya inställnings möjligheter i fraktmodulens adminpanel, i den nedre delen av panelen. 4. Klicka på [edit] knappen längst upp i adminpanelen för att kunna få fram de redigerbara fälten. 5. Ställa in din Fraktjakt modul enligt följande: Tjänsten aktiverad? Vill du hämta priser för frakt från Fraktjakt.se? (Klicka på radioknappen framför ordet ja ) 4
Fraktjakt användarnamn Ange användarnamn till adminpanelen hos Fraktjakt. (Fylla i rutan med ditt användarnamn för Fraktjakt som du angav vid registrering i Fraktjakt.se) Fraktjakt lösenord Ange lösenord till adminpanelen hos Fraktjakt. (Fylla i rutan med ditt Fraktjakt lösenord som du angav vid registrering i Fraktjakt.se) Fraktjakt Consignor ID Ange ditt id för Fraktjakt API. (Fyll i rutan med din Consignor id som hittas i dina Webshopsinställningar i Fraktjakt.se ) Demo: http://www.fraktjakt.se:3001/account/change_webshop Live: http://www.fraktjakt.se/account/change_webshop Fraktjakt Consignor Key Ange ditt lösenord för API. (Fyll i rutan med din Consignor nyckel som hittas i dina Webshopsinställningar i Fraktjakt.se ) Demo: http://www.fraktjakt.se:3001/account/change_webshop Live: http://www.fraktjakt.se/account/change_webshop Felsökningsläge? Vill du köra i felsökningsläge? Rapporter kommer att skickas till dig via e-post vid varje API anslutning. Om du inte kör felsökningsläge kommer endast felrapporteringar skickas via e-post. (Klicka på radioknappen framför antingen ja eller nej, beroende på hur du vill ha det) E-postadress för rapporter Ange en mottagaradress för tekniska rapporteringar. (Fylla i rutan med en e-postadress. Mailet som skickas till denna adress kommer från Fraktjakt modulen i din oscommerce dator) 6. Det finns några flera inställningar men dessa behöver du inte ändra på just nu. 7. Klicka nu på [update] knappen för att spara dina nya inställningar i oscommerce. 5
Testa fraktmodulen Nu är allting installerat och konfigurerat tillräckligt mycket för att kunna testa i din oscommerce webbutik. 1. Logga in och kör som en användare i din webbutik. Välj en produkt att köpa, lägg den i varukorgen och gå till kassan.! Så snart du trycker på knappen för att gå till kassan börjar fraktmodulen att kommunicera med Fraktjakt servern som svarar med fraktalternativen inom några sekunder. 2. Nu kommer webbutikens Leveransinformations sida visas och här ska du kunna se under Fraktsätt de olika fraktalternativen som togs emot från Fraktjakt. Om du har fått fram fraktalternativen då fungera denna delen som det ska. Grattis och fortsätt med nästa testpunkt! Annars läs vidare i manualens avsnitt om Felsökning eller ta kontakt med Fraktjakt support. 3. Välj en frakttjänst och fortsätt tills ordern är färdigbehandlad och klar.! Så snart du trycker på knappen för att konfirmera ordern börjar fraktmodulen att kommunicera med Fraktjakt servern för att registrera ordern i Fraktjakt. 4. Logga in på ditt Fraktjakt.se användarkonto. 5. Navigera dig fram till Mina sidor : Ordrar för att se om din test av fraktorder har registrerades i Fraktjakt. Om du hittar ordern då fungerar även denna delen av din fraktmoduls integration. Grattis, testet är klart! Annars läs vidare i manualens avsnitt om Felsökning eller ta kontakt med Fraktjakt support. Konfiguration av ditt Fraktjakt.se användarkonto För att använda sig av Fraktjakts oscommerce fraktmodul måste man har ett användarkonto (login) i Fraktjakt. Se avsnittet Registrera ditt Fraktjakt.se användarkonto för instruktioner om hur man skapa ett sådant konto. När du har loggat in i Fraktjakt.se kan du hitta allting som är knutit till ditt eget användarkonto under fliken "Mina sidor". Där finns det flera menyval för olika saker såsom kontoinställningar, ordrar, bokningar och 6
mycket mera. Resten av detta avsnitt beskriver dessa olika menyvals funktioner och hur man ställer in Fraktjakt för användning tillsammans med Fraktjakts oscommerce fraktmodul. Kontoinställningar Inställningarna för ditt Fraktjakt användarkonto. Vissa av kontoinställningarna påverkar Fraktjakt oscommerce fraktmodulens funktion medan andra påverkar bara när man använda Fraktjakt i din webbläsare. Följande inställnings möjligheter finns: Inställningens namn Påverkar fraktmodulen Beskrivning För och efternamn Nej Namn på webbshopens kontaktperson. Sökresultat per sida Nej Inställningen styr över antalet rader som visas i Fraktjakts sök-resultat, däremot är det ingen påverkan på resultat som visas i en webbshop som använder fraktmodulen. Nyhetsbrevet Nej Ingen funktion när man har en webbshop. Sökningssätt i Fraktjakt Nej Välj default inställning för sökningssättet som används under Jämför fliken i Fraktjakt: Land & område Postnummer Du skall oftast söka som Ja Ange om du driver din webbshop som privatperson eller som ett företag. Välj antingen: Privatperson Företag Inställningen påverkar vilka frakttjänster som kommer att visas i din webbshop och i webbläsarens sökresultat under Jämför fliken i Fraktjakt. Detta beror på om frakttjänsten är avsedd för privatpersoner och/eller företag. Man kan själv styra över vilka tjänster som kan visas överhuvudtaget under inställningen Fraktleverantörer (hittas under menyvalet Webbshopsinställningar ). OBS! Inställningen går även att ändra under menyvalet Webbshopsinställningar. Resultatet skall sorteras på Ja Välj default inställning för sortordningen som används vid presentationen av de olika frakttjänsterna i din webbshop och i webbläsarens sökresultat under Jämför fliken i Fraktjakt: Tid sorteras efter uppskattad leveranstid. Pris sorteras efter priset. OBS! Inställningen går även att ändra under menyvalet 7
Webbshopsinställningar. Frakttiden visas som Ja Välj default inställning för hur frakttiden presenteras i både webbshopen och webbläsarens sökresultat under Jämför fliken i Fraktjakt: Antal dagar (ex. 1-3 dagar ) Ankomsttid (ex. 17:00 Onsdagen 24/6 ) Fraktjakt kommer att skicka uppgifter till din webbshop om när frakten beräknas komma fram, i det formatet som du angett här. OBS! Inställningen går även att ändra under menyvalet Webbshopsinställningar. Har du webbshop? Ja Här måste man väljer Ja om man tänker använda Fraktjakts oscommerce fraktmodul, annars kommer det inte att fungera. Vid eventuell ändring av någon av ovanstående inställningar ska du avsluta med att trycka på [spara] knappen. Webbshopsinställningar Här kan du ändra dina inställningar för webbshoppens anrop och svar i Fraktjakt. Inställningarna är knutna även till ditt användarkonto i viss mån (framgår nedan), så tänk på att om du ändrar för webbshoppen, ändrar du också för din användare. Följande inställningsmöjligheter finns: Inställningens namn Du skall oftast söka som Beskrivning Ange om du driver din webbshop som privatperson eller som ett företag. Välj antingen: Privatperson Företag Inställningen påverkar vilka frakttjänster som kommer att visas i din webbshop och i webbläsarens sökresultat under Jämför fliken i Fraktjakt. Detta beror på om frakttjänsten är avsedd för privatpersoner och/eller företag. Man kan själv styra över vilka tjänster som kan visas överhuvudtaget under inställningen Fraktleverantörer (hittas längre ner i denna tabell). OBS! Inställningen går även att ändra under menyvalet Webbshopsinställningar. 8
Resultatet skall sorteras på Välj default inställning för sortordningen som används vid presentationen av de olika frakttjänsterna i din webbshop och i webbläsarens sökresultat under Jämför fliken i Fraktjakt: Tid sorteras efter uppskattad leveranstid. Pris sorteras efter priset. OBS! Inställningen går även att ändra under menyvalet Webbshopsinställningar. Frakttiden visas som Välj default inställning för hur frakttiden presenteras i både webbshopen och webbläsarens sökresultat under Jämför fliken i Fraktjakt: Antal dagar (ex. 1-3 dagar ) Ankomsttid (ex. 17:00 Onsdagen 24/6 ) Fraktjakt kommer att skicka uppgifter till din webbshop om när frakten beräknas komma fram, i det formatet som du angett här. OBS! Inställningen går även att ändra under menyvalet Webbshopsinställningar. Webbshopsdata Consignor id Consignor nyckel (key) Webbshoppens namn Dessa siffror identifiera just din webbshop vid kommunikation mellan Fraktjakt oscommerce fraktmodulen (i din webbshop) och Fraktjakt servern. Du skall fylla i siffrorna i fraktmodulens inställningssida i din oscommerce system i fältet som heter Fraktjakt Consignor id. Denna lång sträng av text är som en lösenord som används i samband med Consignor id vid kommunikation mellan fraktmodulen och Fraktjakt servern. Du skall fylla i textsträngen i fraktmodulens inställningssida i din oscommerce system i fältet som heter Fraktjakt Consignor key. Namn på webbshopen (ex. Puttes Prylar) Url Internet adress till webbshopen (ex. http://www.puttesprylar.se ) Företagsnamn Organisationsnummer Standardpaket Använd standardmåttet nedan på mina paket, om jag inte anger något annat Om företaget som driver webbshopen har ett annat namn än själva webbshopen ska företagets namn anges här (ex Puttes Prylar AB) Ange organisationsnummret som tillhör det företaget som driver webbshopen (ex. 123456-7890 ). Här anger du om du vill att Fraktjakt ska använda måttet av ett standardpaket när priserna beräknas fram. Om du använda en viss kartong för att skicka paket som köps i webbshopen kan det vara lämpligt att utnyttja denna inställning. Standardpaketets mått som du angett (se inställningarna Längd, Bredd och Höjd) kommer att användas när Fraktjakt beräknar fram fraktpriser i samtliga fall där fraktmodulen inte har skickat med en varas dimensioner. 9
Standardpaketet är också minimi-paketet Längd Om fraktmodulen skickar med dimensionerna eller inte styrs av hur man har konfigurerat fraktmodulen. Se under avsnittet Konfigurera fraktmodulen för mer information om hur man matar in dimensionerna för webbshopens varor. Standardpaketen kan också användas som minimi-mått på de paket du skickar. Det kommer då att bli det minsta paket som du söker pris för, dvs standarpaketet är det minsta paketet som du någonsin använder. Det betyder att oavsett hur stora saker du säljer, kommer du att alltid minst skicka så stora paket som dimensionerna du angett för standardpaketet. Ange längden av standardpaketet i centimetrar. (Paketens längst mått). Bredd Ange bredden av standardpaketet i centimetrar. (Paketens näst längst mått ). Höjd Ange höjden av standardpaketet i centimetrar. (Paketens kortaste mått). Upphämtning Tidigaste Senaste Dagar i veckan De flesta frakttjänster som finns på marknaden innebär att någon kommer och hämtar paketen hos dig. Först måste du dock boka upphämtningen. Denna gruppering av inställningar är till för att snabba upp dom bokningarna och förenkla dina framtida frakter. Här anger du helt enkelt dom uppgifter som olika fraktare behöver för att veta när de skall komma till dig och hur dom hittar till dig. När du i framtiden bokar frakt kommer Fraktjakt att fylla i fälten för dina bokningar med de här uppgifterna. Det är ju till exemepel väldigt sällan du behöver ändra vägbeskrivningen till webbutikens lager. Den tidigaste tiden då fraktaren kan komma och hämta paket som ska skickas från webbshopen. Den senaste tiden då fraktaren kan komma och hämta paket som ska skickas från webbshopen. Vilka dagar i veckan upphämtning/inlämning kan ske. Markera en eller flera veckodagar. Tiderna och dagarna du kryssar i används också av Fraktjakt för att beräkna ankomsttiderna i fraktsöknings-resultaten. Om du bara skickar några paket i veckan kan det vara bra att bara skicka dom på ett fåtal bestämda dagar i veckan. Då vet Fraktjakt också vilken dag dina kunders beställningar skickas och du kan ange en någorlunda korrekt leveranstid till dina kunder. Vägbeskrivning vid upphämtning Fyll i en vägbeskrivning och speciella instruktioner som kan underlätta för transportören när denna ska komma och hämta webbshopens paket. Inställningar för egen frakttjänst Visa en egen frakttjänst som Denna gruppering av inställningar är till för att du skall kunna ha ett fraktval där dina kunder kommer till ditt lager och hämtar prylarna, eller något annat alternativ som du kan bättre än Fraktjakt. Välj Ja här om du vill att Fraktjakt ska presentera din egen frakttjänst bland 10
sökresultat. Namn de övriga fraktalternativ som visas i webbshopen. Namnet på din egen frakttjänst (ex. Hämta i butiken, Självhämtning, Lokala utkörning ) Pris på egen tjänst Ange priset på din egen frakttjänst i kronor (ex. 0 kr eller 59 kr ) Fri frakt Butiken erbjuder fri frakt? Inköpsgräns för fri frakt Om en webbshopskund köper för ett visst värde (se nästa inställning, Inköpsgräns för fri frakt ) i butiken kan frakten sättas till 0 kronor för alla tillgängliga tjänster som visas upp för kunden. OBS! Webbshopen måste dock fortfarande betala Fraktjakt för frakten. Ange inköpsgränsen i kronor. Vid eventuell ändring av någon av ovanstående inställningar ska du avsluta med att trycka på [spara] knappen. Webbshopsinställningar - Fraktleverantörer Sista delen av Webbshopsinställningar är till för att du skall kunna välja vilka frakttjänster som skall visas i webbutiken. Även om Fraktjakt kan visa priser för tjänster från flera olika leverantörer, behöver inte allt visas i din webbutik. Du kan mycket väl välja att bara använda en tjänst. Det kan vara för att dess ombud ligger närmast till dig, eller att du helt enkelt gillar ett företag bättre än alla andra. Du kan också välja att bara visa tjänster med någon form av miljömärkning eller tjänster som är lite extra snabba, så att dina kunder skall få sina saker snabbare än från dina konkurenter. Inställningens namn Fraktleverantörer Beskrivning Välj vilka frakttjänster som du vill visa som sökresultat i din webbshop. OBS! Fraktleverantörerna och frakttjänsterna som visas här är beroende på inställningen Du skall oftast söka för där man ställer in antingen Privatperson eller Företag. Om du väljer att ändra vilka tjänster som skall visas i din webbutik skall du trycka på [spara] knappen längst ned. Adresser Adresserna knutna till ditt användarkontot skapas och hittas under menyvalet "Adresser". När det gäller webbshop är det obligatorisk att ha både en Fakturerings-adress och en Gods-adress. 11
Faktorerings-adressen måste finnas så att Fraktjakt kan fakturera websshoppen för köpte frakttjänster. Godsadressen måste finnas så att Fraktjakt ska veta var webbshopens gods skickas ifrån. Bara en Faktoreringsadress och en Gods-adress går att skapas. Andra adresstyper såsom Besöks-adress, Post-adress och Hemadress är valfria och inte begränsat i antal som får skapas. Ordrar En webbshop som använder sig av Fraktjakts oscommerce fraktmodul genererar ordrar i Fraktjakt. Du som driver webbshoppen måste betala för frakttjänsterna. Först då skapas frakthandlingarna som du ska behöva för att skicka dina paket. Logga in i Fraktjakt med din användarkonto och navigera fram till menyvalet Ordrar under fliken Mina sidor. Där ska du se en tabell där varje rad motsvarar en order. Kolla på en orders detaljer genom att klicka på ordernummret i kolumnet Ordernr. Betala för ordern genom att klicka på [köp] knappen längst ut till höger på raden. Bokningar Upphämtning av paket ingår i en del av frakttjänsterna som förmedlas via Fraktjakt. Du som driver webbshop har möjlighet att på Fraktjakt.se boka upphämtning för frakter som beställts via din webbshops bruk av Fraktjakts oscommerce fraktmodul. Logga in i Fraktjakt med din användarkonto och navigera fram till menyvalet Bokningar under fliken Mina sidor. Där ska du se en tabell där varje rad motsvarar en bokning. Kolla på en boknings detaljer genom att klicka på bokningsnummret i kolumnet Nummer. Ändra en bokning genom att klicka på [ändra] knappen längst ut till höger på raden. Det går även att ta bort en bokning som inte behövs genom att klicka på [radera] knappen längst ut till höger på raden. Om du anser att det är något fel med en bokning eller om det inte går att ta bort en bokning som du vill bli av med, kontakta Fraktjakt Support teamet. För ordrar av frakttjänster där upphämtning ingår men som saknar en bokning kan man boka genom att klicka på ordernummret som visas längst ner på sidan under rubriken Boka upphämtning av dina ordrar. 12
Support Kontakta oss Fraktjakt AB Gjuterigatan 9, 55318 Jönköping Org.nr: 556751-9011 E-post: Webb: www.fraktjakt.se Telefon: 076-589 65 68 Öppettider kundtjänst: Måndag Fredag: 8.00 17.00 Lördag & Söndag: Stängt 13