Handleiding Magento - Yuki www.webwinkelfacturen.nl Samenvatting Dit is de handleiding voor de koppeling van Magento naar Yuki. De koppeling zorgt dat voor facturen in Magento automatisch een factuur of financi¨ele boeking gegenereerd wordt in Yuki. Omdat de facturen direct in het boekhoudsysteem van de webwinkelier komen bespaart de webwinkelier tijd op de financi¨ele administratie. Deze koppeling is ontwikkeld in juni 2015 door Sponiza IT. Sponiza IT heeft meerdere koppelingen van webwinkels naar online boekhoudpakketten en facturatiesystemen ontwikkeld en in beheer. De koppelingen worden dagelijks gemonitored. De koppeling kan aangeschaft worden in de webwinkel van www.webwinkelfacturen.nl. Voor de koppeling hoeft bij de start niet betaald te worden. De prijsinformatie voor het gebruik van de koppeling na deze 30 dagen kun je vinden op www.webwinkelfacturen.nl. Bij de aanschaf van de koppeling ontvangt de webwinkelier de koppeling per email, inclusief deze handleiding en een licentie code. Deze handleiding is ook te vinden op de website van webwinkelfacturen.nl.
Inhoudsopgave 1 2 2.1 2.2 2.3 3
Wat doet de koppeling? . . . . . . . . . . . . . . . . . . . . Hoe leg je de koppeling? . . . . . . . . . . . . . . . . . . . Installeren van de Magento extensie in je webwinkel . . . . . 2.1.1 Aanmaken Magento consumerkey en consumersecret Aanmaken Yuki credentials . . . . . . . . . . . . . . . . . . Meld je aan voor de koppeling . . . . . . . . . . . . . . . . FAQ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
2 3 3 4 5 6 8
c
webwinkelfacturen
1
Wat doet de koppeling?
De koppeling van Magento naar Yuki zorgt dat facturen worden doorgezet naar het boekhoudsysteem Yuki. De koppeling is een zgn. batch koppeling. Een aantal keer per dag worden de facturen opgehaald uit Magento. Deze facturen hoeven dus niet meer handmatig ingevoerd te worden.
De koppeling zet de factuurregels over van de Magento factuur naar de factuur in Yuki. Ook BTW percentages en kortingen worden netjes verwerkt. De facturen in Yuki krijgen de status Verwerkt als de factuur betaald is. Is de factuur nog niet betaald dan krijgt de factuur in Yuki de status Open. Als de klant voor de eerste keer met de koppeling aan Yuki wordt doorgegeven dan wordt er voor deze klant een nieuwe in Yuki aangemaakt. Het email van de klant wordt opgeslagen en doet de klant een tweede bestelling dan wordt de bestaande klant gebruikt. Verwijder dus geen klanten die door de koppeling zijn aangemaakt. De Magento factuur kan dan niet doorgevoerd worden.
Versie 1.1
30 juni 2015
2
c
webwinkelfacturen
2
Hoe leg je de koppeling?
Het instellen van de koppeling tussen Magento en Yuki bestaat uit 2 stappen. Eerst installeer en configureer je een extensie in je webwinkel. Deze extensie maakt het mogelijk dat de koppeling de facturen uit je webwinkel kan ophalen en daarna kan doorzetten naar Yuki. Tijdens deze stap maak je ook twee sleutels aan. Een consumerkey en een consumersecret. In de tweede stap meld je je aan voor de koppeling. Je vult de authenticatie gegevens van je webwinkel - de consumerkey en de consumersecret - en de authenticatie gegevens voor je Yuki account. We adviseren om hiervoor een aparte gebruikersnaam / wachtwoord combinatie voor aan te maken. De stappen staan hieronder in detail uitgelegd.
2.1
Installeren van de Magento extensie in je webwinkel
De Magento - Yuki koppeling gebruikt REST API calls om de nieuwe facturen uit de Magento webwinkel te halen. Om dit mogelijk te maken dient er een extensie geinstalleerd te worden in de Magento webwinkel. Deze extensie is als bijlage toegevoegd in de bevestingingsemail van webwinkelfacturen. De nieuwste versie van de extensie kun je altijd downloaden via http://webwinkelfacturen.nl/magentokoppeling.zip. Het installeren en configureren bestaat uit verschillende stappen die allemaal te maken hebben met het goedzetten van de rechten en de authenticaties. Zet de caching in je webwinkel uit. Dit kun je doen via System > Cache Management. Na de installatie van de extensie kun je de caching weer aanzetten. Pak de zipfile uit en installeer de bestanden onder je Magento root. Je kunt aan de structuur van de zipfile zien welke bestanden je waar moet plaatsen. Als het goed is worden er geen bestanden overschreven. De code is nu ge¨ınstalleerd. Nu moet je rechten gaan toevoegen zodat de koppeling de factuurgegevens uit je webwinkel kan lezen. Ga naar System > REST Roles. Als je nog geen administrator rol hebt, maak deze dan aan door op Add Admin Role te klikken. Als je wel al een administrator rol hebt dan open je deze rol. Aan de linkerkant van het scherm staat een scherm met als titel Role Information. Klik op de sub-menu-link Role API Resources. Je ziet de optie REST API Calls to read invoices verschijnen. Vink alle blokjes onder deze optie aan en sla de gegevens op, zie figuur 1. Je hebt nu ingesteld dat de koppeling recht heeft om facturen op te halen uit Magento, maar je hebt nog niet aangegeven welke gegevens per factuur hij op mag halen.
Fig. 1: Toewijzen welke functionaliteit de API mag gebruiken Ga naar System > Web Services > REST Attributes. Open de User Type Admin. Je ziet hier wederom de optie REST API Calls to read invoices verschijnen. Vink weer alle opties aan en sla de gegevens op, zie figuur 2. Tot slot dien je de administrator toe te wijzen aan de REST role. Ga naar System > Web Services > Permissies > Users. Klik de administrator aan van de webwinkel. Ga naar REST Role, de onderste optie
Versie 1.1
30 juni 2015
3
c
webwinkelfacturen
Fig. 2: Toewijzen gegevens die opgehaald mogen worden in het menu links. Wijs de administrator van de webwinkel toe aan de Administrator REST Role, zie figuur 3.
Fig. 3: Wijs de administator user toe aan de administrator REST Role Je bent nu klaar met het installeren en configureren van de Magento extensie. 2.1.1
Aanmaken Magento consumerkey en consumersecret
De stappen voor het aanmaken van een Magento consumerkey en consumersecret zijn als volgt: • Log in als admin bij je Magento webwinkel. • Ga naar System >Web Services >REST OAuth Consumers. Zie figuur 4. • Klik op Add new voor de Magento - Yuki koppeling. Zie figuur 5. • De key en de secret zijn al ingevuld. Vul zelf de naam voor de koppeling in en de callback url. De waarde van de callback url moet zijn: http://interface.cloudinvoice.company/api/v1/servlet/magento/callback.php • Vul je administrator wachtwoord in • Klik op Save / Opslaan De key en secret van die scherm vul je in bij de Consumerkey en Consumersecret van het instellingenscherm. Zie figuur 6.
Versie 1.1
30 juni 2015
4
c
webwinkelfacturen
Fig. 4: Menupad voor het aanmaken van een consumerkey en consumersecret
Fig. 5: Voeg een nieuwe OAuth consumer toe
Fig. 6: De Key en Secret vul je in in het instellingenscherm
2.2
Aanmaken Yuki credentials
Om de administratie- en toegangscode aan te maken log je in bij Yuki en selecteer je de administratie waarbinnen je werkt. Aan de linkerkant van het scherm zie je onderin het menu een link webservices staan. Daar klik je op. Zie de onderstaande plaatjes.
Versie 1.1
30 juni 2015
5
c
webwinkelfacturen
Fig. 7: Genereren Yuki toegang: Ga naar je administratie
Fig. 8: Genereren Yuki toegang: Genereer de codes bij Webservices
2.3
Meld je aan voor de koppeling
Fig. 9: Het aanmeldscherm voor de Magento - Yuki koppeling Ga naar https://interface.cloudinvoice.company/api/v1/view/magento-yuki/settings.php. Er opent een scherm waarin je je gegevens voor de Magento - Yuki koppeling kunt toevoegen. De velden op dit scherm dien je als volgt in te vullen: • Naam: Je naam. Dit veld is niet verplicht. • Emailadres: Het emailadres waaronder we je kunnen bereiken. Je emailadres valt voor ons onder de privacy regels. Het veld is niet verplicht.
Versie 1.1
30 juni 2015
6
c
webwinkelfacturen
• Licentiecode: Om van de koppeling gebruik te maken dien je hier je unieke licentie-code in te vullen. De licentie-code heb je ontvangen in de aanmeldingsemail. Neem contact op met
[email protected] als je hem kwijt bent. • URL webwinkel: De url van je webwinkel, bijvoorbeeld http://www.mijnmagentowebwinkel.nl • Magento consumerkey en Magento consumersecret. Deze waarden maak je aan in je Magento webwinkel. We hebben hier voor uitgelegd hoe je dat doet. • Gebruikersnaam en wachtwoord Yuki. We hebben in de voorgaande sectie uitgelegd hoe je dat doet. Op basis van de consumerkey, consumersecret en de webwinkelurl gaat de koppeling nu officieel toestemming vragen om facturen uit je webwinkel te lezen. Als je nog niet bent ingelogd in je webwinkel krijg je automatisch een inlogscherm te zien. Nadat je bent ingelogd krijg je automatisch een autorisatiescherm te zien. Klik op Authorize om de koppeling te autoriseren. Als alles goed verlopen is krijg je een succes melding. De facturen worden meegenomen en overgezet naar Yuki.
Fig. 10: Autoriseer de koppeling binnen je webwinkel
Versie 1.1
30 juni 2015
7
c
webwinkelfacturen
3
FAQ
Wie zit er achter deze koppeling? Deze koppeling wordt u aangeboden door Sponiza IT, www.sponiza.nl. Wij zijn gespecialiseerd in koppelingen voor webwinkels. Sponiza IT is al sinds 1999 bezig met het ontwikkelen van internet-applicaties. Hoe zit het met de veiligheid van de gegevens? De koppeling slaat zo min mogelijk gegevens op. Je moet de koppeling meer zien als een doorvoer-haven: Er komen gegevens binnen en wij zetten die gegevens in het juiste formaat door. Voor audit-redenen slaan we het bestelnummer van een bestelling en de datum van de bestelling op. De inhoud van de bestelling slaan we niet op. Het versturen en ontvangen van gegevens loopt via een beveiligde verbinding. Kunnen ook facturen met terugwerkende kracht naar Reeleezee gemigreerd worden? Ja, dat kan. Neem contact op met
[email protected] als je gebruik wilt maken van onze migratiedienst. Voor welke Magento versie is deze module ontwikkeld? We hebben deze module getest op Magento versie 1.9.0. Gebruik je een andere Magento versie neem dan contact met ons op. Dan kijken we of we hem over kunnen zetten. Wat als er iets mis gaat? Mocht je een probleem tegenkomen of een vraag hebben dan kun je die stellen via onze support-desk. Dat kun je ook doen als je een idee hebt voor een nieuw requirement.
Versie 1.1
30 juni 2015
8
