Hoe moet een integratie tussen RetailVista en Shopware ingericht worden?

Dit document beschrijft wat er nodig is om de integratie met een shopware webshop in te richten binnen RetailVista.

Aanmaken webshop in RetailVista

Eerst is het van belang om een webshop aan te maken met webshop type Shopware v6. Alleen versie 6 is op dit moment geïmplementeerd.
Voer bij tab 'integratie' de ApiUrl in. Dit is de URL van de website met /api er achter.
Voer bij gebruikersnaam de ClientId in en bij password het client secret.
In de tab export en orders kan worden opgegeven of artikelen naar Shopware toe gestuurd moeten worden en dat orders moeten worden opgehaald.
Er hoeven geen aparte taakplanningen aangemaakt te worden. De reguliere webshop-sync taakplanningen voor order en artikel sync zullen deze webshop ook verwerken.

Artikel export

De volgende velden die worden op dit moment aangeboden aan Shopware:

• Ean
• Name (artikel omschrijving)
• ProductNumber
• Note1, Note2, Note3 en note4. Deze worden aangeboden als CustomFields
• Free fields. Deze worden ook als customfields aangeboden. De naam van vrije veld wordt de naam van het customfield.
• Stock (vrije voorraad – drempelvoorraad)
• Tax
• Delivery time (aantal dagen, van leverancier of inkoop)
• Price (brutoprijs artikel)
• Listprice (adviesprijs)
• Category (webshop classification)
• Ordercode (als customfield)

Het bleek niet altijd gewenstdat de categorieën automatisch worden aangemaakt en overgenomen uit RV. Bijvoorbeeld wanneer de webshop een eigen indeling hanteert. Het syncen van categories uit uit te zetten middels een geavanceerde instelling op de webshop:
SyncCategories=0

Kortingen van-voor:

Wijzigingen in actieve artikelkortingen worden direct meegenomen in de artikelsync. Deze worden aangeboden als 'AdvancedPrice' binnen shopware.
Een van-voor prijs wordt aangeboden met een prijs met hetzelfde aantal van-tot als wat is opgegeven bij de van-voorprijs. Dus bij prijs van €4,00 per 4 krijg je een quantity from van 4 en een quantity to van 4.

Bij een staffel, bv vanaf 2 stuks 3 euro per stuk wordt alleen de quantity-from gevuld het het aantal veld:  

Elke nacht vindt er een complete kortingen synchronisatie plaats. Deze voert 2 bulk acties uit:

1. Kortingen die actief zijn geworden (maar niet gewijzigd), bv doordat de ingangsdatum ingegaan is opsturen
2. Kortingen die inactief zijn geworden (de actie is bijvoorbeeld verlopen, of de korting is verwijderd uit RV) verwijderen.

Elke nacht dus een volledige synchronisatie van actieve kortingen en overdag bij de artikelsync worden alle gewijzigde kortingen meegenomen.

Een voorwaarde voor het aanmaken van kortingen is dat er een rule aanwezig is binnen Shopware met de naam "RetailVista". Een rule is verplicht binnen shopware bij advancedprices, en deze rule wordt standaard gebruikt om de kortingen aan te koppelen. De rule kan heel simpel gehouden worden gewoon altijd van toepassing zonder enige restrictie:

Ophalen van orders

Elke order synchronisatie worden orders opgehaald van Shopware. Hier zit een overlap in van 10 minuten om gaten te voorkomen. Orders die al eerder zijn opgehaald en verwerkt worden ­­overgeslagen.
De belangrijkste data die wordt opgehaald van een order:

• Customer
• BillingAddress
• DeliveryAddress
• Transactions (betalingen)
• Regels

Als referentiecode wordt het ordernummer uit shopware overgenomen. Dit is een herkenbaar veld waarmee de order in shopware eenvoudig terug te vinden is.

Voor de betalingen en vervoerswijze is het van belang dat de namen uit shopware overeen komen met de codes van de betaalwijzes en transporttypes overeen komen.