Visma Export v För OpenCart 1.5.x (upp till 1.5.6)

Transkript

1 Visma Export v2.0.4 För OpenCart 1.5.x (upp till 1.5.6) Viktigt! Detta är den *ICKE OFFICIELLA* Visma Export tillägget till OpenCart. Denna produkt är inte resultatet av ett samarbete med företaget Visma och vi är heller inte certifierad Visma partner. Inga garantier finns att denna extension fungerar med just din konfiguration av OpenCart eller Visma Administration. Det ligger på dig (användaren) att testa importer på ett övningsbolag i Visma Administration, och att säkerställa så att importerade data är korrekta, innan den används i skarpt läge. Vi tar inte ansvar för någon ekonomisk eller annan skada i samband med användandet av Visma Export.

2 Installationsanvisningar utan vqmod 1. Packa upp mappen upload och ftp a upp undermapparna admin och catalog till rooten på din OpenCart installation (inga filer kommer att skrivas över). a. REDIGERA: admin/view/template/common/header.tpl b. HITTA: <li><a href="<?php echo $backup;?>"><?php echo $text_backup;?></a></li> c. EFTER, LÄGG TILL: <?php if (@$this->language->get('text_vismamenu')!= NULL) {?> <li><a href="<?php echo (((HTTPS_SERVER)? HTTPS_SERVER : HTTP_SERVER). 'index.php?route=tool/visma&token='. $this->session->data['token']);?>"><?php echo $this- >language->get('text_vismamenu');?></a></li> <?php }?> 2. Från backend: Gå till System->Användare->Användargrupper, Ändra Top Administrator. 3. Hitta tool/visma i båda listorna. a. Bocka i checkrutorna i båda listorna och tryck sedan på Spara. 4. KLART: Visma Export finns nu i System->Visma Export i menyn. Installationsanvisningar om vqmod är installerat 1. Packa upp mappen upload och ftp a upp hela innehållet till rooten på din OpenCart installation (inga filer kommer att skrivas över). 2. Från backend: Gå till System->Användare->Användargrupper, Ändra Top Administrators. 3. Hitta tool/visma i båda listorna. a. Bocka i checkrutorna i båda listorna och tryck sedan på Spara. 4. KLART: Visma Export finns nu i System->Visma Order Export i menyn. Vad är vqmod? vqmod (aka Virtual Quick Mod) är ett override system för att slippa ändra i core-filer när man lägger till funktionalitet i en redan befintlig lösning. Konceptet är ganska enkelt istället för att behöva ändra direkt i filerna så skapas ändringarna som xml sök/ersätt script-filer. Läs mer:

3 Inledning Detta är en *inofficiell* Visma Export extension till OpenCart 1.5.x som du kan använda för att exportera kunder och fakturor/ordrar från OpenCart till Visma Administration 500/1000/2000. Inget partnerskap med Visma eller liknande krävs utan importen sker via importfunktionen som ursprungligen är tänkt att användas för import av kunder, fakturor eller ordrar från Visma Tid. OBS: Ang. uppgradering till Visma Order Export till v2.0.0 Ska du uppgradera från en tidigare version av Visma Order Export så måste du göra en backup av dina inställningar eftersom inställningarna inte kommer att följa med till nya versionen pga. att inställningsformuläret numera är individuellt per butik i shoppen. Hur det fungerar Exporten skapar en XML-fil för varje faktura, order som exporteras från OpenCart. Kunden som är kopplad till fakturan, ordern följer automatiskt med och importeras även den (om den inte redan finns upplagd i Visma Administration). Från Visma Administration så importeras sedan kunder och fakturor, ordrar så här: (kör alltid importen mot ett övningsbolag första gången). 1. Väj Arkiv->Företagsunderhåll->Import av order- och fakturaunderlag från Visma Tid. 2. Ange sökvägen till mappen med dina importfiler. 3. Välj Arkiv->Import->Order och fakturaunderlag från Visma Tid i menyn. 4. Importfilerna kommer nu att listas, tryck på importera för att köra importen. 5. Om ett importfel uppstår, se nedan. 6. Gå in i orderläget för att hitta de importerade ordrarna. Ett fel uppstår när jag kör en import i Visma Administration Uppstår fel när du försöker importera i Visma Administration? kontrollera följande: 1. Kontrollera att artikelnummer på artiklar matchar varandra i Visma Administration och OpenCart. 2. Kontrollera så att det inte uppstår en krock på Kundnr i Visma Administration. 3. Kontrollera fältet: Utställarens signatur i Visma Exports inställningsformulär. 4. Kontrollera fältet: Enhet på exporterade orderrader i Visma Exports inställningsformulär. 5. Kontrollera att du har mappat rätt Opencart kundgrupper till rätt Visma kundkategori-koder. Ett fel uppstår i OpenCart när jag kör en export 1. Analysera ett eventuellt PHP-felmeddelande för ledtrådar. 2. Kontrollera att din version av OpenCart är (eller senare). 3. Kontrollera att skrivrättigheter finns på exportmappen (minst: 0755). 4. Kontrollera att MySQL-användaren har CREATE/DELETE/UPDATE/INSERT behörighet. a. CREATE måste finnas för att kunna skapa loggtabellen för exporterade ordrar.

4 Inställningar Status Är denna aktiverad så kommer ordrar att exporteras från denna butik. Exportläge Är testläget aktiverat så loggas inte en order som exporterad i systemet. Du kan då exportera samma ordrar hur många gånger som helst. Typ av export Exportera fakturor eller ordrar. Import av ordrar är endast möjligt i Visma Administration 1000/2000. Exportmapp Mappen där exporterade XML-filer hamnar (relativt till root-katalogen) Företagsnamn Kommer att anges som utställare i export-filerna. Organisationsnummer Ditt företags organisationsnummer (anges i formatet: xxxxxx-xxxx). Standard kundnr Ange ett kundnr som alla gästkonto-ordrar kommer att kopplas till (behöver ej finnas i Visma). Utställarens signatur Detta värde måste matcha en upplagd användares signatur i Visma Administration. Enhet på exporterade orderrader Den enhet som ska hamna på orderrader. Ofta används ST eller Frp (Styck eller Förpackning). Måste matcha en upplagd enhet i Visma Administration. Kundnr prefix Används för att förhindra krock med existerande kunder i Visma Administration. Alla importerade kunder i Visma kommer att få detta prefix före kundnumret. Expeditionsavgift Anges som ett tal, utan SEK eller kr eller liknande. Är en fast avgift på alla exporterade ordrar. Kreditgräns för nya kunder Anges som ett tal, utan SEK eller kr eller liknande. Är en fast kreditgräns på nya kunder. Postförskottshantering Vill du att en postförskottsavgift ska loggas som en orderrad på varje order så kan du ange ett Artikelnr som måste matcha en upplagd artikel i Visma Administration. Urval på orderstatus Om du bara vill exportera ordrar med t.ex. statusen Bearbetas så kan du sätta ett urval här. Ändra status på order Ändrar status på exporterade ordrar till valt alternativ. Även en orderhistorik skapas där det framgår att ordern är exporterad ett visst datum/klockslag, bra för att förtydliga i OpenCart vilka ordrar som är exporterade. Kommentar på order Välj själv vad du vill ha som orderkommentar här.

5 Skärmdump på Visma Administration Export (inställningar) Inställningsformulären för samtliga butiker.

6 Skärmdump på Visma Administration Export (exporterade ordrar) Här kan man bland annat återställa enskilda ordrar eller ladda ned redan exporterade ordrar.

7 Knapparnas funktioner Exportera Genomför en export och sparar de exporterade ordrarna till angiven exportmapp på webbservern. Exportera och ladda ned Kör en export, arkiverar sedan alla import-filer till ett ZIP-arkiv och skickar till webbläsaren så att du kan ladda ned och spara på t.ex. skrivbordet (en kopia av ZIP-arkivet finns kvar i exportmappen). Återställ Återställer senaste exporten genom att radera de loggade ordrarna i loggtabellen visma_export. Återställ valda Återställer endast ibockade exporterade ordrar. Knappen syns endast om minst en rad är ibockad i listan med exportade ordrar. Ladda ned Denna knapp genererar en ny orderfil och triggar en nedladdning i webbläsaren. Knappen hittas i exporterade ordrar-rapporten. Spara Sparar angivna inställningar för alla butiker. Måste göras minst en gång innan du genomför en export. Avbryt Gå tillbaka till OpenCarts kontrollpanel. Set and forget (automatiserade exporter) Stöd finns för automatisk generering av en exportfil direkt när en order skapas i butiken. Denna lösning använder vqmod men du kan även redigera core-filen direkt om du inte vill eller inte kan använda vqmod. Du kan även få den automatiskt exporterade filen att skickas till dig som en bifogad fil i ett mail. E-postadressen som mailet går till är standardbutikens angivna e-postadress. Alltså denna inställning: System->Inställningar->Förvald butik->e-postadress Hur man manuellt lägger in stöd för automatiserade exporter OBS: Detta behöver ej utföras om du har vqmod installerat. 1. REDIGERA: catalog/controller/checkout/success.php a. HITTA: $this->cart->clear(); b. FÖRE, LÄGG TILL: $this->load->model('tool/visma'); if ($this->model_tool_visma->isthereordertoexport($this->session->data['order_id'])) { $this->model_tool_visma->createfile($this->session->data['order_id']); }

8 Versionshistorik v2.04 Joakim Ljungh a. Ändrat så att vissa tecken i XML-filen omkodas till motsvarande XML-variant. Problemet kunde uppstå när det fanns & tecken i produktnamn bland annat. b. Lagt in stöd för Rabattkuponger, en ny inställning finns där man kan ange ett artikel nr som eventuella kundrabatter kommer att kopplas mot. c. Lagt in stöd för Presentkort, en ny inställning finns där man kan ange ett artikel nr som eventuella avdrag kommer att kopplas mot. v2.03 Joakim Ljungh a. Fixade en bugg som jag lyckades skapa fr.om. v2.0.2 där enbart sista orderraden kom med när man utförde en export av flera filer. v2.0.2 Joakim Ljungh a. Fixade en bugg som uppstod vid en export av flera ordrar. Betalmetod och fraktmetod ihop med föregående order. v2.0.1 Joakim Ljungh a. Fixade en bugg som resulterade i att ordrar inte flaggades som exporterad. b. Lagt till en ny vertikal flik Allmänt där alla generella inställningar ska finnas. c. Flyttat inställningen Exportmapp till den nya fliken Allmänt. d. Ny inställning: Exportera från vald butik som finns under fliken Allmänt. Är den aktiverad så exporteras enbart ordrar från den flik som råkar vara vald för tillfället (de vertikala flikarna med butiksnamn). e. Rensar fältet Kundens kommentar från HTML innan export. f. Ändrat så att kundnamn exporteras istället för Gästkonto på gästordrar. g. Lagt in stöd för sortering på alla kolumner i listan med exporterade ordrar. h. Lagt in stöd för urval på alla kolumner i listan med exporterade ordrar. i. Fixat så att när man befinner sig på fliken exporterade ordrar så stannar man kvar där vid en omläsning av sidan, t.ex. när man går till nästa sida osv.

9 v2.0.0 Joakim Ljungh a. Testad mot OpenCart b. Stödjer numera export till flera företag i Visma Administration. c. Tagit bort inställningen Urval på butik då den numera är överflödig. d. En ny statusinställning i varje formulär som styr om butiken ska exporteras ifrån. e. En ny inställning: Kundreferens, styr vad som ska sparas som referens (Namn/Epost). f. Lagt in stöd för valutaomvandling i både rapport och export. g. Lagt in stöd för paging i rapporten för exporterade ordrar. h. Ny funktion: Notifiering vid nya ordrar redo för export. i. Ny funktion för att återställa enskilda exporterade ordrar. j. Ny inställning: Möjlighet att varna vid en export om det finns ordrar utan eget kundnr angivet (endast om vqmod-filen: vqmod_extra_customer_no_field.xml används) k. Ny funktion för att ladda ned en exportfil för en enskild order. l. Exportfilens namn innehåller nu org. nr för att lättare identifiera från vilket företag den är exporterad ifrån bara genom att kolla på filnamnet. m. Exportfilens namn innehåller nu alltid ordernr istället för löpnummer. Använde man funktionen Exportera och ladda ned så var det löpnummer förut. n. Rensar strängen för betalmetod och fraktmetod från HTML innan export eftersom vissa betalmetoder använder HTML för att visa logotyp i kassan. Detta problem kunde skapa trasiga XML-filer om vissa betalmoduler användes. o. Lagt in hantering för långa orderkommentarer. Skulle en kommentar överstiga 60 tecken så blir den uppdelad på flera rader. p. Rättat felstavningar i language-filer. v1.7.1 Joakim Ljungh a. Modulen var inte längre kompatibel med OpenCart , fixat. v1.7.0 Joakim Ljungh a. Lade in stöd för export av org. nr på kunden (bara från v av opencart). b. Kundens kommentar på en order loggades inte längre, fixat. v1.6.9 Joakim Ljungh a. Postförskottartikel kom inte med om man körde ett annat språk i admin än i shoppen, fixat. b. Ersatte underscore i XML-filnamn med bindestreck (underscore orsakade en bugg i Visma 500). c. En ny av/på-inställning om man vill slippa inledande nollor på kundnummer i XML-filen. d. Mera jobb med moms på orderradsnivå, verkar som att moms loggas annorlunda mellan olika OpenCart versioner vilket gjorde att momsprocenten blev fel i det ena eller andra fallet. v Joakim Ljungh a. Fel moms kunde loggas i XML-filen på orderradsnivå om man använde flera olika momssatser, fixat. v Joakim Ljungh a. Uppdaterat validering på org. nr så att även enskild firma (personnummer) valideras. b. Lagt till en av/på inställning om tillval/options ska exporteras.

10 v Joakim Ljungh (intern version) a. Lagt till stöd för Tillval/Options. Valda alternativ läggs till efter produktbenämningen i XML-filen Tänk på att kombination benämning + tillval inte bör överskriva 60 tecken. b. Endast första produkten blev exporterad vid alternativet automatisk export, fixat. v Joakim Ljungh a. Fixat en bugg som kunde uppstå när man körde multishop, där det under vissa omständigheter visades Det finns inga ordrar att exportera när det bevisligen fanns ordrar att exportera. b. Lagt till en extra vqmod för de kunder som kör en B2B e-butik och vill att kunder ska mata in ett eget ordernr i OpenCart kassan. Detta värde kommer sedan att finnas med i exportfilen. I Visma Administration så hittas detta värde sedan i fältet Ert ordernr när man gå in på en order. v Joakim Ljungh c. Lagt till en inställning så man kan mappa kundgrupper i OpenCart till Visma kundkategori-koder. OBS: Detta innebär att kundgrupps-koder måste anges i inställningar och att formuläret måste sparas om efter att du har uppgraderat till denna version från en äldre. d. Lagt till en vqmod som lägger till fältet Extra kundnr: i OpenCart kundformuläret i admin. e. Ändrat så att Visma Order Export använder Extra kundnr om angivet (högre prioritet). f. Lagt till en inställning så man kan välja format på kundnamn/referens (Efternamn Förnamn). g. Lagt till en varningstext så att det blir tydligare när man inte fyllt i alla obligatoriska inställningar. h. Lagt till versionshistoriken i PDF-dokumentationen på Svenska v Joakim Ljungh a. Optimerade SQL-Uttrycket för exportade ordrar rapporten. b. Ändrade så att senaste ordern alltid ligger som senast exporterad i rapporten. c. Lade till databasindex på visma_export tabellen (när den skapas automatiskt). v Joakim Ljungh a. Fixade ett problem med inställningen valda butiker som inte blev korrekt sparad. b. Bytte ut JavaScript dialogrutor mot snyggare JQuery IU Dialogs. c. Man kan nu stänga varning/lyckades meddelanden. v Joakim Ljungh a. Lade till OpenCart -> ISO 3166 mappning på landskod (landskod fungerade bara i Sverige förut). v Joakim Ljungh a. Lade till stöd för automatiserade exporter (set and forget). b. Lade till möjlighet att få exportfilen mailad till butikens inställda e-postadress. c. Fixade ett möjligt fel med att läsa inställningarna. v Joakim Ljungh a. Första versionen.