Fraktjakts oscommerce Fraktmodul

Fraktjakts oscommerce Fraktmodul Instruktionsmanual Välkommen Fraktjakt erbjuder en fraktmodul till e-handelssystem byggt på oscommerce som kommer att förenkla vardagen som webbutiksadministratör. Den här manualen beskriver hur man installerar och konfigurerar Fraktjakt som en Add-on fraktmodul till en oscommerce webbutik. Den handlar också om hur man skapar ett nytt användarkonto i Fraktjakt.se för att kunna ställa in och börja använda sin nya fraktmodul. Testa fraktmodulen idag! I instruktionerna här nedan finns länkar till både Fraktjakt demoserver och Fraktjakt liveserver. Vi rekommendera starkt att du först använder dig av Fraktjakts demoservern för att kunna testa integrationen med din webbutik, (Rekommendation: testa gärna genom att skapa en demo/test version av din webbutik först). Då kan du bli bekant med hur systemet fungerar utan att riktiga fraktordrar genereras. OBS! När du väljer live konfigurationen innebär det att riktiga fraktordrar skapas i Fraktjakts live server. Se hur fraktmodulen ser ut i våra test webbutik! Om du bara vill se hur fraktmodulen ser ut och fungerar i en webbutik, finns vår egen demobutik som heter Wratchet Gear. Surfa till adressen http://www.fraktjakt.se:3333/webshop/ för att testa själv som en webbutikskund. 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 saker utan att riktiga köp genomförs. 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-baserad webbshop av den version som nämns ovan. Du ska även kunna hantera och administrera din webbshop med oscommerce administrationsgränssnitt. 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 Fraktjakts fraktmodul. Följande server extensions ska vara med. PHP, version 5+ curl (server extension för PHP) SimpleXML (server extension för PHP) 1.Kör en backup av webbutikens databas och alla andra filer i ditt oscommerce system innan installation av fraktmodulen görs. 2.Hämta senaste versionen av Fraktjakts fraktmodul för oscommerce från http://www.fraktjakt.se/services/download/. Filen är komprimerad i zip format. 2

Installera fraktmodulen 1.Unzip nedladdad fil för Fraktjakts 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 kopiera alla underkataloger och filer till de motsvarande kataloger i oscommerce systemet. 3.Hitta instruktionsfilen Modifieringar.txt i fraktmodulens rotkatalog och modifiera alla nämnda filer enligt instruktionerna som finns i Modifieringar.txt filen. Du bör kunna klippa och klistra direkt från Modifieringar.txt filen till oscommerce filerna. OBS! Var försiktig och noggrann. Gör exakt som instruktionerna visar. Följande modifieringar finns med i Modifieringar.txt filen: Kapitel 1. Fraktjakts API använder vikt och dimensioner för att beräkna en 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. 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. 3

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 installerad men ännu ej klar för bruk. Först måste du registrera ditt Fraktjakt.se användarkonto och konfigurera fraktmodulen innan den går att använda. Fortsätt till nästa avsnitt. 4

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 är skickad till den emailadress som angavs 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 hittar du din nya Fraktjakt Consignor id och Consignor nyckel. Dessa uppgifter behövs 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. 5

Konfigurera fraktmodulen 1.Logga in på din oscommerce adminsida. 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 har du fått fram flera nya inställningsmöjligheter, 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 ) 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) 6

Fraktjakt Consignor ID Ange ditt id för Fraktjakt API. (Fyll i rutan med din Consignor id som hittas under fliken webbutik och installera i menyfältet 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 under fliken Webbutik och installera i menyfältet 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 på [update] knappen för att spara dina nya inställningar i oscommerce. 7

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 Leveransinformationssida visas och här ser du 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 nu 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. 8

Konfiguration av ditt Fraktjakt.se användarkonto För att använda sig av Fraktjakts oscommerce fraktmodul måste man ha ett användarkonto (login) i Fraktjakt. Se avsnittet Registrera ditt Fraktjakt.se användarkonto för instruktioner om hur man skapar ett sådant konto. När du har loggat in i Fraktjakt.se kan du hitta allting som är knutet till ditt eget användarkonto under huvudfliken "Mina sidor". Där finns det flera underflikar för olika saker såsom kontoinställningar, ordrar, webbutiksinställningar, bokningar osv. 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. Under flik: Konto 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änder Fraktjakt i 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 9

Fortsättning.. 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 under inställningen Fraktleverantörer (hittas under menyvalet Webbshopsinställningar ). OBS! Inställningen går även att ändra under menyvalet Webbutik. 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 Webbutik. 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 Webbutik. 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. 10

Vid eventuell ändring av någon av ovanstående inställningar ska du avsluta med att trycka på [spara] knappen. Underflik: Webbutik Här kan du ändra dina inställningar för webbshoppens anrop och svar i Fraktjakt. Inställningarna är även knutna till ditt användarkonto i viss mån (framgår nedan), så tänk på att när 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 under inställningen Fraktleverantörer (hittas längre ner i denna tabell). OBS! Inställningen går även att ändra under menyvalet Webbshopsinställningar. 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 Dessa siffror identifiera just din webbshop vid kommunikation mellan Fraktjakt oscommerce fraktmodulen (i din webbshop) och Fraktjakt servern. 11

Consignor nyckel (key) Webbshoppens namn Du skall fylla i siffrorna i fraktmodulens inställningssida i din oscommerce system i fältet som heter Fraktjakt Consignor id. Denna långa sträng av text är som ett 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 ditt 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 Standardpaketet är också minimi-paketet Längd 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 organisationsnumret 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änder 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. 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ängsta mått). Bredd Ange bredden av standardpaketet i centimetrar. (Paketens näst längsta mått ). Höjd Ange höjden av standardpaketet i centimetrar. (Paketens kortaste mått). 12

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 de olika fraktare behöver veta, när de skall komma 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 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 med 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 Denna gruppering av inställningar är till för att du ska kunna ha ett fraktval där dina kunder kommer till ditt lager och hämtar prylarna, eller något annat alternativ. Visa en egen frakttjänst som sökresultat. Namn Välj Ja här om du vill att Fraktjakt ska presentera din egen frakttjänst bland de övriga fraktalternativ som visas i webbshopen. Namnet på din egen frakttjänst (ex. Hämta i butiken, Självhämtning, Lokal 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. 13

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. 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 konkurrenter. 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 tjänster som skall visas i din webbutik ska du trycka på [spara] knappen längst ned. Underflik: Adresser Adresserna knutna till ditt användarkonto skapas och hittas under menyvalet "Adresser". När det gäller webbshop är det obligatoriskt att ha både en Fakturerings-adress och en Gods-adress. Fakturerings-adressen måste finnas så att Fraktjakt kan fakturera websshoppen för köpta frakttjänster. Godsadressen måste finnas så att Fraktjakt ska veta var webbshopens gods skickas från. Bara en Faktureringsadress och en Gods-adress går att skapa. Andra adresstyper såsom Besöks-adress, Post-adress och Hem-adress är valfria och inte begränsat i antal. 14

Underflik: 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 till paketen. Logga in på Fraktjakt med ditt användarkonto och navigera fram till menyvalet Ordrar under fliken Mina sidor. Där ska du se en tabell och varje rad motsvarar en order. För att titta på en orders detaljer, klickar man på ordernumret i kolumnen Ordernr. Betalar för ordern görs genom att klicka på [köp] knappen längst ut till höger på raden. Underflik: 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 ditt användarkonto och navigera fram till menyvalet Bokningar under fliken Mina sidor. Där ser du en tabell, som varje rad motsvarar en bokning. För att titta på bokningsdetaljer, klickar man på bokningsnumret i kolumnen 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. Vid problem med bokning eller radering, 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. 15

Support Kontakta oss Fraktjakt AB Gjuterigatan 9, 55318 Jönköping Org.nr: 556751-9011 E-post: info@fraktjakt.se 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 16