Handleiding OpenCart - Reeleezee www.webwinkelfacturen.nl Samenvatting Dit is de handleiding voor de koppeling van OpenCart naar Reeleezee. De koppeling zorgt dat voor bestellingen in OpenCart automatisch een factuur gegenereerd wordt in Reeleezee. 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 december 2014 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. Het gebruik van de koppeling is de eerste 30 gratis. Prijsinformatie voor het gebruik na deze 30 dagen staat op de website 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 3
Wat doet de koppeling? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Hoe leg je de koppeling? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . FAQ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1
2 3 6
c
webwinkelfacturen
1
Wat doet de koppeling?
De koppeling van OpenCart naar Reeleezee zorgt dat voor bestellingen met de status Verwerkt / Complete automatisch een factuur wordt aangemaakt in Reeleezee. Deze facturen hoeven dus niet meer handmatig ingevoerd te worden. De webwinkelier wijzigt de status van een bestelling in het administratiedeel van de webwinkel. De facturen in Reeleezee krijgen status Open. De facturen worden niet direct naar de klant gestuurd. Bestellingen van bekende klanten worden in Reeleezee onder hetzelfde klantnummer geboekt. Is een klant onbekend dan wordt deze klant aangemaakt in Reeleezee. De extensie is ontwikkeld voor OpenCart versie 1.5.6. Neem contact met ons op als je een andere OpenCart versie gebruikt. We passen de extensie graag voor je aan, mits je OpenCart versie op 1.5.3 of hoger draait.
Versie 1.1
29 december 2014
2
c
webwinkelfacturen
2
Hoe leg je de koppeling?
Bij de aanvraag van de extensie ontvang je een zip-file. Deze zip-file bestaat uit een vqmod-file en extra bestanden om de koppeling soepel te laten draaien. Een van de bestanden is het system/library/cloudinvoice.php bestand. In dit bestand zit de functionaliteit voor de klant en de administratie kant. Om gebruik te maken van de extensie dien je een aantal regels toe te voegen aan de index.php en admin/index.php bestanden. Dit zijn de regels: //Add library cloudinvoice $cloudinvoice = new Cloudinvoice($registry); $registry->set(’cloudinvoice’, $cloudinvoice); en je voegt ze toe voor: // Front Controller $controller = new Front($registry); Daarnaast dien je een regel toe te voegen in het bestand system/startup.php. Dit doe je na de regel require once(DIR SYSTEM . ’library/amazonus.php’); require_once(DIR_SYSTEM . ’library/cloudinvoice.php’); Door deze regels toe te voegen kun je cloudinvoice aanroepen in je hele OpenCart webwinkel. Als je de extensie geinstalleerd hebt, zie je onder menu-optie Extensions >Modules de module Settings cloudinvoice platform. Klik op Install om deze extensie te installeren en daarna op Edit settings om de gegevens van je factuursysteem in te voeren.
Fig. 1: Invulscherm OpenCart - Reeleezee De url van het platform is https://interface.cloudinvoice.company/api/v1/servlet/opencart/orderprocessor.php. De Cloudinvoiceapikey is de sleutel die meegestuurd met je bestelling. Deze key zorgt dat je gebruik kunt maken van de koppeling.
Versie 1.1
29 december 2014
3
c
webwinkelfacturen
Fig. 2: Aanvragen gebruikersnaam in Reeleezee voor webservice koppeling Voor toegang naar je Reeleezee account heeft de koppeling een gebruikernaam en wachtwoord van Reeleezee nodig. Vul hier niet de gebruikersnaam en het wachtwoord in waarmee je normaal gesproken inlogt. Voor dit soort koppelingen kun je binnen Reeleezee een aparte gebruikersnaam aanmaken, waarmee wel de koppeling gelegd kan worden maar niemand kan inloggen. Om de gebruikersnaam / wachtwoord aan te maken ga je naar Instellingen >Algemene instellingen >Web-services. Klik op Nieuw in de rechterbovenhoek. Je ziet nu een scherm met twee tabbladen, nl Naam en Toegang. Vul een naam in voor de webservice koppeling en klik op Opslaan en daarna op Toegang. Pas nu kun je dit tabblad bezoeken. Vul een gebruikersnaam en wachtwoord in. Bevestig het wachtwoord. Schrijf de nieuwe gebruikersnaam en het wachtwoord op. Dit moet je namelijk gebruiken voor de koppeling. Klik op Opslaan.
Fig. 3: Invullen gebruikersnaam in Reeleezee voor webservice koppeling De gebruikersnaam en het wachtwoord die je zojuist hebt aangemaakt vul je in op het instellingenscherm. De koppeling controleert of met de ingevulde gegevens een connectie gelegd kan worden met je Reeleezee account. De koppeling meldt het resultaat met een fout- of succesboodschap. In geval van een foutboodschap wordt de oorzaak van de foutmelding gegeven.
Versie 1.1
29 december 2014
4
c
webwinkelfacturen
Fig. 4: Melding geeft aan dat de gegevens goed zijn ingevuld Klik vervolgens op Opslaan. De koppeling is gelegd. Vanaf nu wordt er automatisch voor een bestelling die op Voltooid of Complete wordt gezet in OpenCart een factuur aangemaakt in Reeleezee. Je zet deze status via Bestellingen >Edit >Totalen.
Fig. 5: Status van de bestelling naar Complete genereert factuur in Reeleezee Wil je de koppeling stopzetten dan de-installeer je hem. Net zoals dat bij andere extensies gebeurt.
Versie 1.1
29 december 2014
5
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 de connectie met factuursturen.nl slaan we de gebruikersnaam en de API sleutel op. 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. Meer informatie over het opslaan van gegevens kun je vinden in de FAQ-sectie op www.webwinkelfacturen.nl. Voor welke OpenCart versie werkt de koppeling? De koppeling is getest op OpenCart versie 1.5.6. Wij zijn bezig met het ontwikkelen van de extensie voor OpenCart versie 2.0.0. Mocht je een andere versie hebben neem dan contact met ons op. We kunnen kijken of we de koppeling dan naar een eerdere versie omzetten of dat hij direct werkt op die versie. 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
29 december 2014
6