Inloggen Registreren

Login to your account

Username *
Password *
Remember Me

Create an account

Fields marked with an asterisk (*) are required.
Name *
Username *
Password *
Verify password *
Email *
Verify email *
Captcha *

E-commerce plugin met directe database connectie

Hoofdstuk 1: Het instellen van de connectie van de Ecommerce plugin.
1.1) Aanmaken van een nieuwe verbinding met een webshop
1.2) Instellen van de verbinding met de webshop
1.3) Gebruik maken van verschillende sql mappen voor verschillende webshops

Hoofdstuk 2: Het instellen van de basis settings van de Ecommerce plugin
2.1) Het instellen van de Ecommerce plugin als standaard
2.2) Het tabblad Tax Mapping
2.3) Het tabblad Extra options
2.4) Het tabblad Extra options2
2.5) Het tabblad Debug SQL
2.6) Het tabblad Exec SQL
2.7) Het tabblad Tools
2.7.1) Het subtabbblad Reprocess in list
2.7.2) Het subtabblad Process single order
2.8) Het tabblad Invoice sort

Hoofdstuk 3: Het instellen van de upload settings van de Ecommerce plugin
3.1) Het tabblad Upload
3.1.1) Het subtabblad Stock upload
3.1.2) Het subtabblad Upload groups/options
3.1.3) Het subtabblad Setup General
3.1.4) Het subtabblad Languages download
3.1.5) Het subtabblad Tax upload setup
3.1.6) Het subtabblad Groups download
3.1.7) Het subtabblad Freefields setup

Hoofdstuk 4: Het wijzigen van standaard functies
4.1) Het selectief uploaden van het artikelen aantal.
4.2) Het selectief downloaden van het artikel aantal.

Hoofdstuk 1: Het instellen van de connectie van de Ecommerce plugin.
1.1) Het aanmaken van een nieuwe verbinding in de Ecommerce plugin.
De eerste keer dat u met de E-commerce plugin gaat werken zult u deze vanuit de plugin menu structuur moeten starten.
Dit doet u zoals hier onder is aangegeven:

Als de verbinding éénmaal ingesteld is functioneel is, kunt u de E-commerce plugin starten door op onderstaand icoon te klikken.

Het scherm welke nu verschijnt is het "Ecommercial shoplist" scherm.

Klik nu op de knop "nieuw" om de de verbinding met uw webshop te starten.
En geef een herkenbare naam op bv. de url van de webshop.

Klik op ok, en de basis van de verbinding wordt aangemaakt.


1.2) Het instellen van de connectie van de Ecommerce plugin.
Klik nu op de knop "edit" om de rest van de verbinding in te stellen.

De velden waar de rode * voor de veldnaam staat, zijn essentieel voor de verbinding.
De velden waar de rode * na de veldnaam staat, zijn belangrijke velden voor de import, maar niet voor de verbinding.
Het veld type staat ook voor MySQL 5.x op mysql-4.1 verander deze setting uitsluitend als u weet wat de impact zal zijn.
Het veld Http link Stock wordt gevuld met: http:\\www.mijnshop.nl\product_info.php?products_id=<@ID@>.
Uiteraard de domeinnaam vervangen door uw eigen domeinnaam.
Voor de veiligheid kunt u naar het goed functioneren van de verbinding en de import een backup maken van de settings.
Dit doet u door in het "Ecommercial shoplist" scherm op de knop "Save to file" te klikken, uiteraard voor het importeren gebruikt u "load from file".
Heeft u meerdere shops kunt u de 2e verbinding aanmaken door op nieuw te klikken vanuit het "Ecommercial shoplist" scherm.
De settings van de eerste verbinding zullen dan overgenomen worden.
U hoeft dan alleen de specifieke settings van deze shop aan te passen.

1.3) Gebruik maken van verschillende sql mappen voor verschillende webshops
U zou er voor kunnen kiezen om voor alle webshops (van dezelfde software maker en met dezelfde functies) dezelfde SQL folder te gebruiken.
Echter zou ik adviseren om per webshop een eigen mapje te gebruiken.
Hiermee heeft u in ieder geval altijd een backup van het origineel.
Maar kunt u ook kleine of grote verschillen in functies tussen de diverse shops hebben.
Voor shops van verschillende software leveranciers heeft u ten alle tijden verschillende mapjes nodig.
Indien u van ons per email een mapje ontvangt kunt u deze er gewoon bij plaatsen.
Persoonlijk vind ik het prettig om eerst even wat "op te ruimen" in de osFinancials map.
Hiermee zet ik alle mapjes met SQL files en de php files welke betrekking hebben op E-commerce bij elkaar in een sub mapje, en daarmee ruim ik de hoofdmap van osFinancials meteen op.
We doen dit door een nieuwe map aan te maken in de hoofdmap van osFinancials en we noemen die "osc2go" (let op allemaal kleine letters! voor alle versies van osFinancials) of "Ecommerce" (bij osFinancials versie 3-0-6-293 en hoger).
Naar deze map verplaatsen we de volgende mappen uit de hoofdmap van osFinancials: "DopiOSFOSCsql", "EcommerceOSCsql", "oscommercephp", "oscommercialsql", "osCOsfJoomla1_0", "OSFOSCsql" en "Xcartsql".
Elk van deze mapjes hebben hun eigen karakteristieke functies en is het zaak bij om te kijken welke functies passen bij uw webshop.
DopiOSFOSCsql: Dit is een oscommerce versie met wat meer mogelijkheden dan de basis.
EcommerceOSCsql: Deze oscommerce files hebben weer meer functies dan DopiOSFOSCsql.
oscommercephp: Dit zijn de php files voor osCommerce, maar ook te gebruiken bij andere webshop software leveranciers indien uw webhoster u geen directe database koppeling toestaat.
oscommercialsql: Dit is de basis voor osCommerce webshops, en heeft de minste mogelijkheden.
osCOsfJoomla1_0: Dit zijn de files voor een Joomla/Virtuemart installatie.
OSFOSCsql: Dit zijn de oscommerce files waarbij u met producten met product opties kunt gaan werken.
Xcartsql: Dit zijn de files voor een Xcart webshop.
Al deze mapjes zijn bedoeld voor het importeren van gegevens.
Er zijn ook versies voor het uploaden van gegevens, maar deze zijn op aanvraag te verkrijgen, evenals de files voor magento.
Deze files zijn een basis voor het gebruik in combinatie met uw webshop(s), en kunnen dus door uzelf aangepast worden voor meer functionaliteiten.

 

Hoofdstuk 2: Het instellen van de basis settings van de Ecommerce plugin
2.1) Het instellen van de basis settings van de Ecommerce plugin
Na dat de verbing tot stand is gebracht kunt u in het "Ecommercial shoplist" scherm op de knop "ok" klikken.
U komt dan in het geavanceerde gebruikers/settings scherm.
Deze schermen hoeft u niet te gebruiken als de settings eenmaal gedaan zijn, uiteraard mag het wel.
U kunt dan van uit het "Ecommercial shoplist" scherm op de knop "Sync download orders" klikken om de orders op te halen uit de geselecteerde webshops.

Het eerste wat we gaan doen is er voor zorgen dat de Ecommerce plugin geactiveerd kan worden dmv. het icoon in de standaard knoppen balk.
We gaan daarvoor naar het tabblad "Tools" en het sub tabblad "Setup General" en klikken op de button "Make default plugin".


2.2) Het tabblad Tax Mapping
Hierna gaan we naar het tabblad "Tax Mapping" en klikken we op het plus teken voor "Default Tax" om deze open te klappen.
We zien hier nu de BTW tarieven welke in de webshop gebruikt worden.
Deze moeten we koppelen aan de settings welke we in osF hebben ingesteld.

De hier getoonde settings zijn slechts ter illustratie, zorg er voor dat u de settings gebruikt zoals deze in uw administratie voorkomen.
Doet u dit bij alle getoonde BTW tarieven.
Hierna gaan we de "Order Total" settings instellen, u heeft hier bij een overzicht nodig welke order total modules er in uw webshop actief zijn.
In osCommerce vind u deze module via de menu keuze "Modules" en de submenu keuze "order totaal".
U vind de juiste benaming door op een regel te klikken en in de adres balk te kijken.
admin/modules.php?set=ordertotal&module=ot_subtotal staat voor het subtotaal.
De waarde die u dient over te nemen is dan "ot_subtotal".
De modules "ot_subtotal", "ot_tax" en "ot_total" hoeft u echter niet over te nemen, deze zijn intern in de plugin al gedefinieerd.
U maakt de menu's aan door met rechts te klikken op "Order Total" en te kiezen voor de menu keuze "Insert".

U neemt alle overige (actieve) modules over.
Tip: als u de eerste heeft ingesteld, kunt u in de linker kolom op de naam met rechts klikken en kiezen voor "copy".
Hiermee wordt de volgende module met het aanpassen van slechts de "Order total Exact text" en de "Order Total description" aanmaken.
Let er wel op dat u aangeeft of het om een product of een korting gaat.
De module "ot_customer_discount is bv. een korting, u geeft dit aan in het veld "Type".
De order regels van deze module zorgen dus voor een korting in de offerte of factuur.
Met het vinkje "Is exclusive price" kunt u aangeven of deze module incl. of excl. BTW is.
Met het vinkje "Negative price" kunt u aangeven.

2.3) Het tabblad Extra options


2.4) Het tabblad Extra options2

Stock
Re-update stocklevel in osC from Stock Level in osF:
Hiermee geeft u aan dat u na de download van de orders de aantallen van uw producten terug wilt uploaden naar de webshop om zo een actuele voorraad ook online te hebben
Import Item Attributes as comment:
Hiermee geeft u aan dat u de product attributen (kleur, maat etc) als opmerking bij het artikel in de order geplaatst wilt hebben (geen voorraad beheer op opties!)
Create item attributes as item:
Hiermee geeft u aan dat de product opties, artikelen zijn in osF (wel voorraad beheer op optie artikelen)
Download images:
Hiermee geeft u aan dat u bij een download van artikelen ook de afbeelding(en) mee wilt downloaden naar osF
Options are items:
Hiermee wordt binnen osF een optie artikel omgezet worden naar een fysiek artikel bij het binnen halen
Force upload items:
Alle voorraad welke gelinked is tussen osF en de webshop daarvan wordt de voorraad gesynct van osF naar de webshop ipv alle verkochte artikelen
Match on StockCode:
Hiermee geeft u aan dat u de producten uit de webshop wilt matchen met de producten in osF op het modelnummer van het product
Use Stock ID:
Hiermee geeft u aan dat u de producten uit de webshop wilt matchen met de producten in osF op het interne productnummer uit de database
Import osC Categories into Stockgroup 1:
Hiermee importeerd u de Product categorien (groepen) uit uw webshop naar de productrapportgroep 1, waarmee u dezelfde groepenstructuur in osF krijgt als in uw webshop
Edit existing items:
Hiermee geeft u aan dat de artikel gegevens in osF overschreven mogen worden door de gegevens welke uit de webshop komen (webshop is leading)
Just update price:
Bij het binnen halen wordt alleen de prijs aangepast van het artikel in osF
Force update descriptions:
Hiermee wordt de omschrijving van het artikel overschreven
Limit stock SQL:
Bij shops met heel veel artikelen worden de artikel gegevens per 500 artikelen bijgewerkt, bij importeren orders wordt niet eerst de artikelen gesynct, om de snelheid er in te houden.
Deduct minimum from stock upload:
Hiermee kunt u aangeven dat het voorraad aantal online de actuele voorraad minus de grijpvoorraad is
Keep standard price and calc discount:
Hiermee kunt u aangeven dat in de factuur/offerte de originele stuks prijs vermeld wordt en de eventuele korting apart vermeld wordt ipv. het kortingsbedrag als zijnde de productprijs
Uploaddirmask:
hiermee kunt u een mappenstructuur (bucketting) gaan gebruiken voor de afbeeldingen van uw producten in de webshop.
Dit komt de snelheid van het ophalen van de productafbeeldingen in de webshop ten goede.
Dubbel klik in het veld om een standaard te laden.

Documents
Resync Date-time on Pull:
Hiermee wordt na het downloaden de datum/tijd van de volgende download gezet op de datum tijd van de laatste download.
Import as quote:
Hiermee kunt u aangeven dat geïmporteerde orders aangemaakt worden als offerte in osF, indien niet aangevinkt wordt de import een factuur.
Import as new invoice:
Hiermee kunt u aangeven dat geïmporteerde orders aangemaakt worden als factuur in osF maar een osF factuur nummer, staat het vinkje uit dan wordt het order nr. vanuit de webshop gebruikt.
upload invoice:
Hiermee kunt u aangeven of facturen geupload dienen te worden naar de webshop.
Import payment to doc:
Hiermee kun je specifieke betaalmethoden laten boeken op grootboek rekeningen (bv. paypal = B1100-001 welke de paypal grootboekrekening is)
Use Tax Rates from Order Products:
Hiermee bepaald het artikel de tax rate ipv de klant/order, dit wordt voornamleijk in andere landen dan Nederland gebruikt.
Remark as comment:
Hiermee geeft u aan dat de opmerkingen uit de webshop order geimporteerd worden als opmerking regel in de offerte/factuur in osF
Download ideal payment info:
Indien u gebruik maakt van iDeal kunt u hier de status ID neerzetten van de "iDeal betaald" zodat u dmv de bankimport plugin uw ideal order kunt laten automatchen
SaveChangeFieldToDataBase:
Hiermee wordt de laatste verwerkingsdatum opgeslagen in de database (inmiddels overbodig, daar alles nu in de database wordt opgeslagen ipv de ini file)
Doc Reportinggroep 1 as status:
Hiermee kunt u de order statussen uit de webshop importeren in osF in de document reportinggroup 1 zodat u dezelfde order statussen ook in osF kunt gebruiken
Do not edit status:
Hiermee geeft u aan dat de status van het document juist niet moet worden aangepast
Default costcenter:
Hier kunt u de standaard kostengroep aangeven voor geïmporteerde orders

Links
FTP site:
het ftp adres van uw webshop (bv. ftp.mijnwebshop.nl) deze eerste 4 velden zijn voor het uploaden van met name de afbeelding(en) van uw producten.
Username:
De gebruikersnaam van de ftp client (bv. Dit e-mailadres wordt beveiligd tegen spambots. JavaScript dient ingeschakeld te zijn om het te bekijken.)
Password:
Het wachtwoord welke hoort bij uw FTP account.
Base url image:
hier mee kunt u eventueel naar een hoger gelegen map op de ftp server gaan om uw afbeeldingen op te slaan.
Base invoice:
hier mee kunt u eventueel naar een hoger gelegen map op de ftp server gaan om uw facturen (pdf files) en op te slaan.
Passive transfare:
Indien u problemen ervaart met/tijdens het uploaden, kun u proberen om deze setting aantezetten.
FTP read timeout:
hier kunt u de FTP timeout tijd opgeven
Prefix based ORDERS URL link:
door hier het juiste path op te geven kunt u vanuit een factuur in osF naar de order in de webshop klikken.
Prefix based CUSTOMERS URL link:
door hier het juiste path op te geven kunt u vanuit een debiteur in osF naar de debiteur in de webshop klikken.

2.5) Het tabblad Debug SQL
Dit tabblad kunt u gebruiken bij troubleshooting.
Als u fout meldingen krijgt bij het gebruik van de E-commerce plugin gaat u naar dit tabblad.
Druk eerst op de knop "clear" om alle voorgaande info te verwijderen.
Zet nu het vinkje bij "Use debug" en herhaal de stap waarbij de foutmelding optrad.
Nadat u de foutmelding weer krijgt gaat u terug naar debug SQL en klikt daar nu op de knop "Refresh".
In het scherm wordt nu de uitgevoerde SQL getoond, en kunt u deze gebruiken om uw fout op te lossen.
Desgewenst kunt u ook gebruik maken van de functie "Step debug".
Hiermee krijgt u na elke stap de SQL te zien welke verwerkt is.
U kunt dan dus specifiek van de fout of de geslaagde SQLs de output zien.

2.6) Het tabblad Exec SQL
Onder dit tabblad zitten wat test mogelijkheden.
Met de knop "Exec/open"kunt u de sql welke in het bovenste scherm helft geplaatst is uitvoeren.
Met de knop "Check Double items" kunt u controleren of alle artikelen wel een uniek modelnummer hebben.
Dan kan het modelnummer gebruikt worden als artikel nummer in osFinancials.
De knop "Check Double items 2" is voor toekomstig gebruik.

2.7) Het tabblad Tools
2.7.1) Het subtabbblad Reprocess in list
Hierin kunt u de ID's van meerdere webshop orders opgeven, welke vervolgens geimporteerd kunnen worden.

2.7.2) Het subtabblad Process single order

In dit tabblad kunt u handmatig specifieke gegegvens uit de webshop halen.
Ordernumber:
Hier vult u het order ID in van de order in de webshop.
Met de button Show order, bekijkt u de details van deze order.
Met de button Process Order, bekijkt u de details van deze order.
Customers id:
Hier vult u het ID van de klant in, met de knop Process customerhaalt u deze klant op, en maakt er een debiteur in osF van.
Alternate deb nr prefix: Hiermee kunt u een andere prefix gebruiken dan de standaard welke u opgeeft in het tabblad Extra options en het veld Customer Code prefix.
Group id : Hier vult u het id in van de categroie in de webshop.
Met de button Process Group, importeerd u de categorie naam in osF.
Products id :
Hier vult u het id in van het artikel in de webshop.
Met de button Process Stock, importeerd u het artikel in osF.
Continue stock full pull at:
Hiermee kunt u een afgebroken import van alle artikelen verder gaan van het aangegeven ID.

2.8) Het tabblad Invoice sort


Hoofdstuk 3: Het instellen van de upload settings van de Ecommerce plugin

3.1) Het tabblad Upload
Dit tabblad en de subtabbladen zijn de instellingen en functies voor het uploaden van gegevens naar de webshop.

3.1.1) Het subtabblad Stock upload
Instructie volgt.

3.1.2) Het subtabblad Upload groups/options
Instructie volgt.

3.1.3) Het subtabblad Setup General
In dit tabblad geeft u aan of het tabblad E-commerce getoond wordt in de artikel details.
En of de huidige gebruiker mag uploaden.
Door op de knop "Make default plugin" te klikken, start u de E-commerce plugin door na opnieuw opstarten van osF op de osC-plugin knop te klikken op de knoppen balk.

3.1.4) Het subtabblad Languages download
Door het openen van dit tabblad worden de gebruikte talen uit de webshop opgehaald.
En kunt u ze koppelen aan de talen in osFinancials.

3.1.5) Het subtabblad Tax upload setup
Door het openen van dit tabblad worden de gebruikte BTW tarieven uit de webshop opgehaald.
En kunt u ze koppelen aan de tarieven in osFinancials.

3.1.6) Het subtabblad Groups download
Door het openen van dit tabblad worden de gebruikte product categorieën uit de webshop opgehaald.
Let u er wel op dat bij veel categorien het even kan duren voordat het beeld getoond wordt.
Onderin het scherm kunt u de voortgang zien.

3.1.7) Het subtabblad Freefields setup
Instructie volgt.

Hoofdstuk 4: Het wijzigen van standaard functies
4.1.) Het selectief uploaden van product aantallen
U heeft hier de file "ZQUpdateStockSel.txt" voor nodig.
Hiermee kunt u een aangepaste select maken waarmee dus alleen de aantallen van gewenste artikelen aangepast worden in de webshop.
4.2.) Het selectief downloaden van product aantallen
U heeft hier de map "downloadstock" voor nodig.
Hiermee kunt u een aangepaste select maken waarmee dus alleen de aantallen van gewenste artikelen aangepast worden in de webshop.