Floynk Documentation
Magento

Magento koppelen

Koppel uw Magento-winkel aan Floynk vanuit Magento Admin of met de vier gegevens van de integratie, en kies store view, website en voorraad.

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.

U heeft een Magento Admin-gebruiker nodig die integraties mag aanmaken, en uw Magento Admin-wachtwoord: Magento vraagt erom bij het opslaan van een integratie.

Koppelen vanuit Magento Admin

  1. Open in Floynk het tabblad Koppelen vanuit Magento Admin. Floynk toont een Callback URL en een Identity link URL, elk met een knop Kopieer.
  2. Open in Magento Admin System › Extensions › Integrations en klik op Add New Integration.
  3. 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.
  4. Open het tabblad API, kies Resource Access: All en klik op Save. Zie Rechten als u minder toegang wilt geven.
  5. Klik in de lijst met integraties naast Floynk op Activate en daarna op Allow.
  6. 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.
  7. 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…".

De twee URL's werken één keer en 15 minuten lang. Zijn ze verlopen, dan toont Floynk "De link is verlopen."; klik op Nieuwe links maken en begin opnieuw bij stap 1 met de nieuwe URL's. Na het klikken op Activate geeft Magento de pop-up ongeveer 5 minuten om af te ronden.

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

  1. Open in Magento Admin System › Extensions › Integrations en klik op Add New Integration.
  2. Vul bij Name Floynk in en uw wachtwoord bij Your Password. Laat Callback URL en Identity link URL leeg.
  3. Open het tabblad API, kies Resource Access: All en klik op Save.
  4. 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).
  5. 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.
  6. Zodra alle vijf velden zijn ingevuld, laadt Floynk uw store views. Kies de Store view, en de Voorraadbron als Floynk erom vraagt.
  7. 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 default geselecteerd. 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 FloynkWaarvoor Floynk het gebruiktMagento-onderdeel (tabblad API)Nodig
WinkelconfiguratieUw store views, websites en instellingenStores › Settings › All StoresJa
Catalogus (lezen en schrijven)Producten importeren en productwijzigingen schrijvenCatalog › Inventory › ProductsJa
AttribuutgegevensAttribuutsets en productattributenStores › Attributes › Attribute Set, en Stores › Attributes › ProductJa
Voorraad lezenBronnen, voorraden en verkoopbare hoeveelheidStores › Inventory › Sources, Stocks en Sales StockJa
Bestellingen lezenDe eigen bestellingen van Magento importerenSales › Operations › Orders › Actions › ViewOptioneel: zonder dit worden Magento-bestellingen niet geïmporteerd
Voorraad schrijvenVoorraad naar uw bron schrijvenStores › Inventory › Stocks › Source Item AssigningOptioneel, gecontroleerd bij eerste gebruik
Bestellingen schrijvenBestellingen verzenden, annuleren, crediteren en van een opmerking voorzienSales › Operations › Orders › Actions › Ship, Cancel, Credit Memos en CommentOptioneel, gecontroleerd bij eerste gebruik
Floynk-moduleVoorraadsynchronisatie, het versturen van orders naar Magento, eventsHet 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:

OptieWat het doet
Koppeling ActiefStaat deze uit, dan verwerkt Floynk deze koppeling niet meer. Wijzigingen uit die periode worden later niet ingehaald.
Product Statussen om te ImporterenWelke Magento-producten Floynk importeert: alleen ingeschakelde, ingeschakelde en uitgeschakelde, of alleen uitgeschakelde.
EAN-attribuutcodeHet Magento-productattribuut met de EAN, bijvoorbeeld ean.
Magento-adminpadHet 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 facturerenMaakt 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.