Slim en goed online verkopen met Magento en VMSII Document: Magento shopconnector VMSII plugin Auteur(s): Thomas van Rooijen Datum: 15 oktober 2014 Versie: 0.2 1
Magento shopconnector VMSII plugin 1.1 Inleiding Dit document beschrijft de data die uitgewisseld wordt tussen de Magento shopconnector VMSII plugin van FRMWRK, hierna te noemen als Shopconnector en de winkelmanagementsysteem VMSII van Vendit, hierna te noemen als VMSII. De data spitst zich toe op de onderstaande onderdelen: 1. Groepen; 2. Productinformatie; 3. Voorraadinformatie; 4. Orderinformatie; 5. Afbeeldingen; Onderdelen 1,2,3 en 5 bevatten data die uitsluitend wordt geëxporteerd vanuit VMSII naar shopconnector. Onderdeel 4 betreft de data die vanuit shopconnector wordt geëxporteerd naar VMSII. De data uitwisseling vindt plaats middels het FTP protocol en is gebaseerd op XML documenten conform de door VMSII systeemdocumentatie. Opmerking: Indien er gesproken wordt over Magento, dan wordt hiermee de Magento Community Edition bedoeld. 2
1.2 Groepen De onderstaande data wordt verwerkt binnen het onderdeel Categorieën binnen Magento. Data Naam Omschrijving Meta titel Meta kernwoorden Meta omschrijving Afbeelding (1 afbeelding) 1.3 Productinformatie De onderstaande data wordt verwerkt binnen het onderdeel Producten binnen Magento. Productdata Productnummer Beschrijving Beknopte beschrijving Type Soort Merk Marker tweedehands product Marker product dient op de homepage te worden getoond Meta titel Meta kernwoorden Meta omschrijving Marker product zichtbaar op website 3
Datum zichtbaar vanaf Datum zichtbaar tot Datum bestelbaar vanaf Datum bestelbaar tot Opmerking t.b.v. bestelbaarheid Verzendkosten Video url YouTube code Data product variatie Standaard kenmerken (maat en kleur) (Magento Super Attributen) BTW percentage Verkoopprijs Adviesverkoopprijs Actieprijs Leverstatus Barcode Afbeeldingen (1 of meerdere afbeeldingen) Specificaties Opmerking: Binnen VMSII bestaat ieder product uit een hoofdproduct en minimaal één variatie. Indien een hoofdproduct slechts één variatie bevat en geen kenmerken, dan converteert shopconnector het product naar een simpel product binnen Magento. In alle andere gevallen betreft het een configureerbaar product. Binnen de configuratie van de Shopconnector kan door de gebruiker bepaald worden of de prijzen inclusief of exclusief BTW dienen te worden geïmporteerd. 4
Via shopconnector kunnen de onderstaande productvormen worden aangemaakt: 1. Simpel product 2. Configureerbaar product Daarnaast bestaat de mogelijkheid om een product als een gerelateerd en/of Upsell product aan te maken. 1.4 Voorraadinformatie De onderstaande data wordt verwerkt binnen het onderdeel Voorraad binnen Magento. Voorraad aantal Opmerking: Standaard wordt de nabestellingen optie van Magento geconfigureerd op Geen backorders. 1.5 Orderinformatie De onderstaande data wordt verwerkt binnen het onderdeel Orders binnen VMSII. Orderdata Ordernummer Orderdatum Totaal orderbedrag inclusief verzendkosten en betalingskosten Betaalmethode Betaalkosten 5
Bedrag betaald Verzendmethode Verzendkosten Naam van de korting Kortingsbedrag Opmerking van de klant Factuurdata Bedrijfsnaam Voornaam Achternaam E-mail adres Telefoonnummer Mobiele telefoonnummer Straat inclusief huisnummer Postcode Woonplaats Land Afleverdata Voornaam Achternaam Straat inclusief huisnummer Postcode Woonplaats Land Productdata 6
Productnummer (VMSII ProductId) Barcode Verkoopprijs exclusief BTW Verkoopprijs inclusief BTW Aantal 1.6 Afbeeldingen Binnen VMSII bestaat de mogelijkheid om afbeeldingen toe te voegen aan producten en groepen. Opmerking: Binnen de productsectie van VMSII bestaat de mogelijkheid om per productvariatie meerdere afbeeldingen te koppelen. Deze afbeeldingen worden via shopconnector, in het geval van een configureerbaar product, aan het hoofdproduct gekoppeld. 1.7 Data verwerking Shopconnector bevat 2 manieren om de geëxporteerde data vanuit VMSII te importeren. De eerste methode is een Importeer -knop binnen Magento. Deze actie start direct een import op het moment dat er op de Importeer -knop is gedrukt. De tweede optie is gebaseerd op zogenaamde cronjobs. Op vooraf bepaalde tijdstippen (bijvoorbeeld ieder uur) worden shopconnector geactiveerd en wordt de import gestart. Iedere 15 minuten worden alle orders via shopconnector geëxporteerd naar VMSII. 7
1.8 Applicatie landschap Onderstaand wordt een schematische weergave (vereenvoudigd) getoond van de applicatie landschap. Deze weergave is gebaseerd op de werkwijze binnen FRMWRK en kan hiermee afwijken per ontwikkelpartij. 8