Handleiding OpenCart - factuursturen.nl www.webwinkelfacturen.nl Samenvatting Dit is de handleiding voor de koppeling van OpenCart naar Factuursturen.nl. De koppeling zorgt dat voor bestellingen in OpenCart automatisch een factuur gegenereerd wordt in Factuursturen.nl. Omdat de facturen direct in het boekhoudsysteem van de webwinkelier komen bespaart de webwinkelier tijd op de financiële 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. Voor de koppeling hoeft bij de start niet betaald te worden. Prijsinformatie 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 Wat doet de koppeling?................................... 2 2 Hoe leg je de koppeling?.................................. 3 3 FAQ............................................. 5 1
1 Wat doet de koppeling? De koppeling van OpenCart naar factuursturen.nl zorgt dat voor bestellingen met de status voltooid automatisch een factuur wordt aangemaakt in factuursturen.nl. 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 factuursturen.nl krijgen status Betaald. De facturen worden niet direct verstuurd naar de klant. Bestellingen van bekende klanten worden in factuursturen.nl onder hetzelfde klantnummer geboekt. Is een klant onbekend dan wordt deze klant aangemaakt in factuursturen.nl. 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
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: //Sponiza change, add library cloudinvoice $cloudinvoice = new Cloudinvoice($registry); $registry->set( cloudinvoice, $cloudinvoice); //End Sponiza change, add library 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 in 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. Het scherm laat na de keuze van het factuursysteem alleen de velden zien die je voor die koppeling moet invullen. Fig. 1: Invulscherm OpenCart - Factuursturen 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. De API key maak je aan binnen factuursturen.nl. Dat doe je door naar Instellingen >Verbindingen te gaan. Je ziet daar een knop waarmee je de API key kunt aanmaken. Versie 1.1 29 december 2014 3
Het grote voordeel van de API key is dat je de koppeling kunt maken zonder de inlogggegevens (gebruikersnaam en wachtwoord) van je factuursturen account in te vullen. Fig. 2: Aanvragen API sleutel voor je Factuursturen account De koppeling controleert of met de ingevulde gegevens een connectie gelegd kan worden met je factuursturen account. De koppeling meldt het resultaat met een fout- of succesboodschap. In geval van een foutboodschap wordt de oorzaak van de foutmelding gegeven. Klik vervolgens op Opslaan. De koppeling is gelegd. Vanaf nu wordt er automatisch voor een bestelling Fig. 3: Melding geeft aan dat de gegevens goed zijn ingevuld die op Voltooid of Complete wordt gezet in OpenCart een factuur aangemaakt in factuursturen. Je kunt de status van OpenCart bestellingen wijzigen via Bestellingen >Edit >Totalen. Fig. 4: Status van de bestelling naar Complete genereert factuur in factuursturen.nl Wil je de koppeling stopzetten dan de-installeer je hem. Net zoals dat bij andere extensies gebeurt. Versie 1.1 29 december 2014 4
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 5