Hoe migreer ik van de Shopware 6 plugin naar de Shopware 6 app?

We hebben onze eigen Shopware 6 app ontwikkeld, die de Shopware 6 plugin van Response GmbH zal vervangen. Deze plugin wordt niet langer actief onderhouden en geüpdatet, daarom vragen we je om in plaats daarvan de app te installeren en je bestaande projecten te migreren. 

Installeer de app

Raadpleeg deze handleiding voor instructies over het downloaden en installeren van de Channable app voor Shopware 6.

Migreer je bestaande projecten

Als je je producten met de app in plaats van de plugin importeert, kun je kleine verschillen in sommige velden verwachten (zie "Welke verschillen kun je verwachten" hieronder). Het is mogelijk dat deze verschillen geen invloed op je projecten hebben; in dat geval kun je van koppeling wisselen via de stappen onder "Import koppeling wijzigen" en "Orderkoppeling wijzigen". Als de verschillen mogelijk wel van invloed op je projecten zijn, raden we je aan om een aantal extra stappen uit te voeren die aan het einde van dit artikel worden getoond, om er zeker van te zijn dat er geen problemen ontstaan. 

Import koppeling wijzigen

• Ga naar "Setup > Import Setup"
• Zoek je Shopware 6 import en klik op "Instellen"
• Klik op "Wijzig"
• Selecteer de nieuwe app koppeling uit de import opties
• Zorg ervoor dat je de juiste taal selecteert in het vervolgkeuzemenu (dezelfde die je eerder voor deze import hebt gebruikt) en klik op "Opslaan".
• Je wordt nu doorgestuurd naar de import mapping. Klik op "Opslaan & importeren". 

Veldnamen kunnen verschillen, dus contoleer voordat je verder gaat of je nieuwe importvelden correct aan je bestaande projectvelden zijn gemapt. Volg de onderstaande stappen om de nieuwe velden correct toe te wijzen. Bekijk "Welke verschillen kun je verwachten" hieronder voor meer informatie. 

• Ga naar "Setup > Wijzig mapping" van je nieuwe koppeling
• Controleer of alle velden correct zijn gemapt door de nieuwe mapping te vergelijken met de mapping in het oorspronkelijke project. Velden die niet meer in de import zitten, kun je veilig verwijderen. 
• Klik op "Opslaan & importeren" als je klaar bent.

Orderkoppeling wijzigen

We kunnen de platform koppeling in een orderkoppeling niet wijzigen, dus in plaats daarvan moet je de oude orderkoppeling voor de plugin deactiveren en een nieuwe voor de app maken.

• Ga naar "Setup > Orders setup".
• Voor elke actieve orderkoppeling die de Shopware 6 plugin gebruikt, klik op "Instellen". 
• Klik op "Deactiveer order connectie" en klik vervolgens op "Opslaan". 
• Zorg ervoor dat je dit voor alle actieve orderkoppelingen doet! 
• Nu moet je nieuwe orderkoppelingen toevoegen. Je kunt dit doen door op de knop "Order setup" te klikken. 
• Zorg ervoor dat je voor de platform koppeling de nieuwe Shopware app koppeling selecteert. Voor alle andere instellingen kies je gewoon wat je in de oude orderkoppeling had die je zojuist hebt gedeactiveerd. 
• Zorg ervoor dat je de orderkoppeling activeert en klik op "Opslaan". 

Welke verschillen kun je verwachten?

• Als een veldnaam een speciaal teken bevat, kunnen je veldnamen iets veranderen. Als je bijvoorbeeld een veld met de naamproperties_grössehebt, zou de plugin dit importeren als properties_groesse, maar de nieuwe app importeert dit veld als properties_grosse. Je kunt dit oplossen in de importer mapping. Bijvoorbeeld:

  1. Het veld properties_groesse werd via de plugin geïmporteerd en gemapt aan het projectveld properties_groesse
  2. De app importeert het veld als properties_grosse. Door het naar properties_groessete mappen, zorg je ervoor dat er geen veldnamen worden gewijzigd.
  3. Het oudeproperties_groesse veld van de plugin kan dan veilig worden verwijderd.

  

• De plugin rondde sommige prijzen niet af. De nieuwe app importer rondt alle prijzen af op twee decimalen.
  
  
• Als je een custom veld met een True/False waarde, zullen we deze importeren als 1 voor (True) en 0 voor (False). Indien nodig kun je deze terugzetten naar True/False met behulp van een (master) regel.
  
• Met de plugin kon je een eigen verkoopkanaal domein in de plugin instellingen instellen. Dit domein zou worden gebruikt om delink en shopware_url voor elk product op te bouwen. De app heeft deze optie niet, deze gebruikt het verkoopkanaal domein uit de verkoopkanaal instellingen:
  
• Als price_net 0 is in je backend, zal het ook 0 in Channable zijn. De plugin berekent price_net zelf, maar de app doet dit niet meer. Je kunt dit oplossen door ervoor te zorgen dat price_net altijd een waarde heeft in je backend, of door price_net te berekenen met behulp van een regel, met behulp van de price_gross en detax_rate.
  
  
• Als je aangepaste velden hebt met het veldtype Media field, halen we niet langer automatisch de URL van de media op. Dit zou je server extra belasten omdat we een extra verzoek per product doen, dus we willen dit alleen doen als het nodig is. Als je merkt dat sommige aangepaste velden een ID in Channable bevatten waar je een URL verwacht, kun je contact met ons opnemen om de functie te activeren die in plaats daarvan de URL's ophaalt.