Magento koppelen
Magento koppelen
Floynk koppelt met Magento via een Magento-integratie (Integration): een API-gebruiker die u in Magento Admin aanmaakt. Er zijn twee manieren om te koppelen. Beide geven hetzelfde resultaat.
- Koppelen vanuit Magento Admin (standaard): Floynk geeft u twee URL's, u maakt daarmee de integratie aan en klikt op Allow. U hoeft geen sleutels te kopiëren.
- Gegevens invullen: u maakt de integratie zelf aan en plakt de vier waarden ervan in Floynk.
U begint beide in Floynk: kies in de installatiewizard Magento, of ga naar Instellingen › E-commerce. Controleer voor u begint de vereisten.
Koppelen vanuit Magento Admin
- Open in Floynk het tabblad Koppelen vanuit Magento Admin. Floynk toont een Callback URL en een Identity link URL, elk met een knop Kopieer.
- Open in Magento Admin System › Extensions › Integrations en klik op Add New Integration.
- Vul het formulier in:
- Name:
Floynk. - Callback URL en Identity link URL: plak de twee URL's uit Floynk.
- Your Password: uw Magento Admin-wachtwoord.
- Name:
- Open het tabblad API, kies Resource Access: All en klik op Save. Zie Rechten als u minder toegang wilt geven.
- Klik in de lijst met integraties naast Floynk op Activate en daarna op Allow.
- Floynk opent in een pop-up en maakt de koppeling af. Heeft uw winkel meerdere store views, of heeft de voorraad meerdere bronnen, dan vraagt de pop-up eerst om een keuze (zie Store view, website en voorraad). Daarna toont hij "Gekoppeld. Terug naar Magento…" en staat de integratie in Magento op Active.
- Terug in Floynk toont het controlepaneel wat Floynk met de koppeling kan (zie Na het koppelen).
Terwijl u dit doet, toont Floynk "Wachten op Magento…".
Pop-up gesloten? Klik in Magento Admin › System › Extensions › Integrations naast Floynk op Activate om hem opnieuw te openen (Reauthorize als hij al eerder geactiveerd was).
Gegevens invullen
- Open in Magento Admin System › Extensions › Integrations en klik op Add New Integration.
- Vul bij Name
Floynkin en uw wachtwoord bij Your Password. Laat Callback URL en Identity link URL leeg. - Open het tabblad API, kies Resource Access: All en klik op Save.
- Klik naast Floynk op Activate en daarna op Allow. Magento toont vier waarden: Consumer Key, Consumer Secret, Access Token en Access Token Secret. U ziet ze later terug door de integratie te bewerken (tabblad Integration Info).
- Open in Floynk het tabblad Gegevens invullen en vul in:
- Winkel-URL: het adres van uw winkel, bijvoorbeeld
https://shop.voorbeeld.nl. - Consumer key, Consumer secret, Access token en Access token secret.
- Winkel-URL: het adres van uw winkel, bijvoorbeeld
- Zodra alle vijf velden zijn ingevuld, laadt Floynk uw store views. Kies de Store view, en de Voorraadbron als Floynk erom vraagt.
- Klik op Koppelen.
Store view, website en voorraad
Een Floynk-project koppelt met één store view van uw Magento-winkel. Website, voorraad en bron volgen uit die store view:
- Store view: Floynk toont alle store views van uw winkel als Naam (code), met
defaultgeselecteerd. De admin-view staat er niet bij. - Website en voorraad: de website van die store view, en de voorraad (stock) die die website bedient.
- Voorraadbron: alleen gevraagd als die voorraad meer dan één bron heeft. Floynk gebruikt dan de bron die u kiest. Zo'n voorraad kan Floynk volgen maar niet beheren; zie Voorraad.
Bij Koppelen vanuit Magento Admin vraagt de pop-up alleen iets als er iets te kiezen is. Met één store view en één bron koppelt hij meteen.
Een winkel met meerdere websites koppelt één website per Floynk-project. Productwijzigingen vanuit Floynk gelden dan voor de gekozen store view, en Instellingen meldt dat: "Wijzigingen vanuit Floynk gelden voor store view {view}; wijzigingen die je in Magento op standaardniveau maakt, worden voor deze view overschreven voor de velden die Floynk beheert."
Rechten
Resource Access: All is het eenvoudigst. Kiest u Custom, vink dan minstens deze onderdelen aan. Zonder de eerste vier weigert Floynk de koppeling.
| In Floynk | Waarvoor Floynk het gebruikt | Magento-onderdeel (tabblad API) | Nodig |
|---|---|---|---|
| Winkelconfiguratie | Uw store views, websites en instellingen | Stores › Settings › All Stores | Ja |
| Catalogus (lezen en schrijven) | Producten importeren en productwijzigingen schrijven | Catalog › Inventory › Products | Ja |
| Attribuutgegevens | Attribuutsets en productattributen | Stores › Attributes › Attribute Set, en Stores › Attributes › Product | Ja |
| Voorraad lezen | Bronnen, voorraden en verkoopbare hoeveelheid | Stores › Inventory › Sources, Stocks en Sales Stock | Ja |
| Bestellingen lezen | De eigen bestellingen van Magento importeren | Sales › Operations › Orders › Actions › View | Optioneel: zonder dit worden Magento-bestellingen niet geïmporteerd |
| Voorraad schrijven | Voorraad naar uw bron schrijven | Stores › Inventory › Stocks › Source Item Assigning | Optioneel, gecontroleerd bij eerste gebruik |
| Bestellingen schrijven | Bestellingen verzenden, annuleren, crediteren en van een opmerking voorzien | Sales › Operations › Orders › Actions › Ship, Cancel, Credit Memos en Comment | Optioneel, gecontroleerd bij eerste gebruik |
| Floynk-module | Voorraadsynchronisatie, het versturen van orders naar Magento, events | Het onderdeel van de Floynk-module (komt mee met de module) | Zie De Floynk-module installeren |
Floynk test de schrijfrechten nooit met een proefschrijfactie. Ze staan op "Wordt gecontroleerd bij eerste gebruik" tot Floynk voor het eerst schrijft. Weigert Magento, dan wordt de regel een waarschuwing, wordt de actie die het recht nodig had overgeslagen, en meldt Floynk welk recht ontbreekt. Voeg het toe in Magento Admin › System › Extensions › Integrations › Floynk › API en klik daarna in Floynk op Opnieuw controleren.
Na het koppelen
Floynk toont een controlepaneel: "Gekoppeld aan {host} · {view} · bron: {source}", met één regel per recht uit de tabel hierboven:
- ✓ In orde: Floynk kan het gebruiken.
- ✗ Ontbreekt: alleen bij Bestellingen lezen. Magento-bestellingen worden niet geïmporteerd tot u het recht toevoegt en op Opnieuw controleren klikt.
- ◌ Wordt gecontroleerd bij eerste gebruik: de schrijfrechten, tot Floynk voor het eerst schrijft.
- ⚠ Let op: een schrijfactie die Magento weigerde, of de Floynk-module is nog niet geïnstalleerd.
Klik op Doorgaan. Daarna biedt Floynk de module aan (u kunt kiezen voor Later — ik doe dit via Instellingen) en vraagt wie uw voorraad beheert. Zie De Floynk-module installeren en Voorraad.
De koppeling wijzigen of verwijderen
Instellingen › E-commerce › Magento toont de koppeling (host, store view, website, voorraad, bron, hoe hij is geautoriseerd en wanneer hij is gekoppeld), de rechten, de module en deze opties:
| Optie | Wat het doet |
|---|---|
| Koppeling Actief | Staat deze uit, dan verwerkt Floynk deze koppeling niet meer. Wijzigingen uit die periode worden later niet ingehaald. |
| Product Statussen om te Importeren | Welke Magento-producten Floynk importeert: alleen ingeschakelde, ingeschakelde en uitgeschakelde, of alleen uitgeschakelde. |
| EAN-attribuutcode | Het Magento-productattribuut met de EAN, bijvoorbeeld ean. |
| Magento-adminpad | Het pad van uw Magento Admin, bijvoorbeeld admin in https://shop.voorbeeld.nl/admin. De links Openen in Magento in Floynk gebruiken het. |
| Doorgezette bestellingen automatisch factureren | Maakt de factuur aan in Magento wanneer Floynk een marktplaatsbestelling naar uw winkel doorzet. |
- Opnieuw koppelen › Met nieuwe gegevens… of Vanuit Magento Admin…: doorloopt dezelfde stappen als hierboven voor de bestaande koppeling. Mislukken de nieuwe gegevens, dan verandert er niets.
- Koppeling controleren: controleert de rechten en de module opnieuw.
- Magento ontkoppelen: verwijdert de koppeling en de webhooks. Producten en bestellingen blijven in Floynk.