Deze handleiding is er voor bedoeld om de basis instellingen van de E-commerce plugin uit te leggen.
Het tabblad Tax Mapping
We beginnen met 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".
We beginnen met de verzendmodule te definieren, na het klikken op de "insert" menukeuze worden de instellingen zichtbaar.
Kies nu als eerste het overeen komende BTW tarief voor deze module.
En klik hierna op de knop "From taxclass".
Hierdoor worden de overeenkomende grootboekrekeningen geselecteerd en in de juiste velden geplaatst.
Vervolgens dient u aan te geven wat voor een type artikel het betreft.
Voor de verzendmodule kiest u "PRODUCT" als type.
Indien de module een korting betreft kiest u als Type "DISCOUNT"
Vervolgens geeft u in het veld Order Total exact text de naam van de module op: "ot_shipping".
U kunt er zelf een naam aan toe kennen, wat als productnaam gebruikt wordt.
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 of de module een negatieve prijs bevat.
Voor het opslaan klikt u weer éénmaal op de tekst "Order Total".
Dit herhaalt u voor alle overige modules.
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 type 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.
Koppelen BTW tarieven voor de artikelen.
Klik 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.
Selecteer het juiste BTW tarief in het pulldown menu, en klik op de knop "From taxclass".
De overeenkomende grootboek rekeningen worden nu automatisch gevuld.
Klik op de menukeuze "Connection" en dan de menukeuze "Save" om de instellingen te bewaren.
Het tabblad Extra options
Invoive Number prefix:Hiermee stelt u (indien gewenst) de prefix in om onderscheidt te maken tussen facturen (documenten) en webshop orders
Customer Code prefix:Hiermee stelt u (indien gewenst) de prefix in om onderscheidt te maken tussen gewone debiteuren en webshop debiteuren
Stock Code prefix:Hiermee stelt u (indien gewenst) de prefix in om onderscheidt te maken tussen artikelen en webshop artikelen
Invoice long id:
Name in reference:
Do not edit debtor:
Product Language:Hiermee stelt u de standaard taal mee in
Product Currency:Hiermee stelt u de standaard munteenheid mee in
Update to status:Hiermee stelt u de orderstatus mee in waarop u de order in de webshop wilt hebben na importeren
Status:Hiermee stelt u de orderstatussen mee in welke u uit de webshop wilt importeren
If autorun then Run every xxx second:
Create events table:
Html decode data:
Default due days:Hiermee stelt u de standaard betaaltermijn mee in
Set new debtors to this debtor group:
Account:
Debtor default Sales Account for Country not in list:
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 (standaard minimaal "/").
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.
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.
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.
Het subtabbblad Reprocess in list onder de Tools tab.
Hierin kunt u de ID's van meerdere webshop orders opgeven, welke vervolgens geimporteerd kunnen worden.
Het subtabblad Process single order onder de Tools tab.
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.
Het tabblad Invoice sort
