Problemen oplossen
Problemen met Magento oplossen
Koppelen
| Floynk meldt | Wat u doet |
|---|---|
| Je Magento-winkel is niet bereikbaar. Controleer de winkel-URL en of je winkel online is. | Controleer de Winkel-URL (het adres van uw winkel, niet van Magento Admin) en open die in een browser. Floynk heeft de REST API van Magento op dat adres nodig, bereikbaar vanaf internet. |
| Dit is geen geldige URL van een Magento-winkel. Gebruik het adres van je winkel, bijvoorbeeld https://shop.voorbeeld.nl. | Vul alleen het adres in, beginnend met https:// of http://, zonder ?…, #… of gebruikersnaam. |
| Magento accepteert deze sleutels niet. Kopieer de vier waarden opnieuw uit Magento Admin › System › Integrations › Floynk. | Kopieer de vier waarden opnieuw (bewerk de integratie, tabblad Integration Info). Controleer of de integratie Active is. |
| Vul de winkel-URL en alle vier de waarden van de Magento-integratie in. | Bij gegevens invullen zijn alle vijf velden verplicht. |
| De Floynk-integratie in Magento heeft geen toegang tot {resource}. Geef die toegang in Magento Admin › System › Integrations › Floynk › API en probeer het opnieuw. | Vink het genoemde onderdeel aan, of kies Resource Access: All, en sla op. Zie Rechten. |
| Floynk heeft de Inventory Management-modules (MSI) van Magento nodig. Zet ze aan in je Magento-winkel en probeer het opnieuw. | Uw winkel draait zonder Inventory Management. Floynk ondersteunt de oude voorraadmodule niet; zet eerst de Magento_Inventory*-modules aan. |
| Die store view bestaat niet in je Magento-winkel. Kies er een uit de lijst. | Kies een store view uit de lijst die Floynk toont. |
| Je Magento-voorraad heeft meerdere voorraadbronnen. Kies de bron die Floynk moet gebruiken. / Kies de store view en voorraadbron die Floynk moet gebruiken. | Kies de bron (en store view). Zie Store view, website en voorraad. |
| De voorraad van deze Magento-website heeft geen voorraadbron. Koppel een bron aan de voorraad in Magento Admin › Stores › Inventory › Stocks. | Koppel in Magento een bron aan de voorraad en koppel daarna opnieuw. |
| Deze Magento-winkel is al aan een project gekoppeld. | Een Floynk-project heeft één Magento-koppeling. Gebruik Instellingen › E-commerce › Magento › Opnieuw koppelen, of ontkoppel eerst. |
| Deze koppellink is verlopen of al gebruikt. Begin opnieuw met nieuwe links. | De twee URL's werken één keer, 15 minuten lang. Klik op Nieuwe links maken en maak of bewerk de integratie met de nieuwe URL's. |
| De koppellinks konden nu niet worden gemaakt. Probeer het over een minuut opnieuw. | Een tijdelijk probleem bij Floynk. Probeer het over een minuut opnieuw. |
| Vanaf dit Floynk-adres kan geen Magento-koppeling worden gestart. Open Floynk op het gewone adres en probeer het opnieuw. | Open Floynk op het gewone adres (geen bladwijzer van een ander domein) en begin opnieuw. |
| Dit project heeft (niet langer) een Magento-koppeling. | De koppeling is verwijderd. Koppel opnieuw. |
De pop-up ging niet open, of u heeft hem gesloten. Klik in Magento Admin › System › Extensions › Integrations naast Floynk op Activate (Reauthorize als hij al eerder geactiveerd was). Zijn de links inmiddels verlopen, klik dan in Floynk op Nieuwe links maken, plak de nieuwe URL's in de integratie, sla op en klik op Reauthorize.
Er ontbreekt een recht
Floynk toont de rechten in het controlepaneel en op Instellingen › E-commerce › Magento.
- Bestellingen lezen: Ontbreekt. Magento-bestellingen worden niet geïmporteerd. Voeg Sales › Operations › Orders › Actions › View toe aan de integratie en klik op Opnieuw controleren (of Koppeling controleren in Instellingen).
- Een schrijfregel toont een waarschuwing ("Magento weigerde dit bij het eerste gebruik"). De actie die het recht nodig had wordt overgeslagen tot u het recht toevoegt in Magento Admin › System › Extensions › Integrations › Floynk › API en opnieuw controleert.
Zie Rechten voor de volledige lijst.
De module heeft nog geen toegang
De modulekaart op Instellingen › E-commerce › Magento zegt "Voorraad wordt niet bijgewerkt" en vraagt om het recht Floynk_Connector::api (daarboven toont hij de moduleversie, of nog geen versie). De regel Floynk-module op de pagina Systeem Status zegt "Module geïnstalleerd, nog geen toegang"; tijdens de onboarding zegt de stap "Module gevonden, maar de Floynk-integratie heeft nog geen toegang…". Magento antwoordt, maar de Floynk-integratie heeft geen toegang tot Floynk_Connector::api, dus Floynk kan via de module geen voorraad schrijven of bestellingen doorzetten.
- Open Magento Admin › System › Extensions › Integrations › Floynk › API.
- Vink Floynk Connector API aan en klik op Save.
- Klik op Reauthorize.
- Klik in Floynk op de modulekaart op Opnieuw controleren.
De module wordt niet gevonden
De modulekaart op Instellingen › E-commerce › Magento zegt Niet geïnstalleerd, of de onboardingstap zegt Nog niet gevonden. (Zegt de kaart "Voorraad wordt niet bijgewerkt" en noemt hij Floynk_Connector::api, zie dan De module heeft nog geen toegang.)
- Controleer of Magento de module kent:
bin/magento module:status Floynk_Connectormoet melden dat hij aan staat. - Voer
bin/magento setup:upgrade,bin/magento setup:di:compileenbin/magento cache:flushopnieuw uit. In developer mode kunt u in plaats daarvan de gegenereerde code wissen, zoals beschreven in De Floynk-module installeren. - Klik in Floynk op Opnieuw controleren.
Een nieuwe moduleversie heeft geen effect
Magento geeft bijvoorbeeld nog steeds verzendkorting op een bestelling die Floynk heeft doorgestuurd. Een verouderde generated/metadata/staticcache blijft na cache:flush staan en kan een nieuwe plugin verbergen, zodat Magento de oude lijst met plugins blijft gebruiken. Voer bin/magento setup:upgrade en bin/magento setup:di:compile uit, en daarna bin/magento cache:flush. In developer mode kan ook generated/ wissen; zie Bijwerken.
Events komen niet binnen
Met de module toont de modulekaart "events geabonneerd · laatste event …". Staat er events niet geabonneerd, of is het laatste event oud terwijl uw winkel druk is:
- Controleer of de cron van Magento draait. De module verstuurt elke update direct; een cronjob die elke minuut draait verstuurt wat niet is aangekomen.
- Controleer of Send events to Floynk op Yes staat in Magento Admin › Stores › Configuration › Floynk › Floynk Connector.
- Kijk in
var/log/floynk.login uw Magento-installatie. - Zegt de kaart events niet geabonneerd, klik dan op Opnieuw abonneren op de pagina Systeem Status: Floynk abonneert zich dan direct op de events van de module. Floynk doet dit ook zelf elk uur, zolang de module antwoordt. Opnieuw controleren op de modulekaart abonneert alleen als het de module voor het eerst vindt.
Is het abonnement actief maar blijven de events toch weg, dan zijn stappen 1 tot en met 3 de gebruikelijke oorzaken. De pagina Systeem Status toont ook hoeveel events Floynk heeft ontvangen maar nog niet verwerkt; die probeert Floynk zelf opnieuw.
Vertraagde events gaan niet verloren: de module blijft het proberen met steeds langere pauzes. Zolang Floynk niet geabonneerd is, of Send events to Floynk op No staat, verstuurt de module geen events en legt ze ook niet vast; Floynks eigen controles halen die wijzigingen in: Magento-bestellingen elke 10 minuten, gewijzigde producten en voorraad elk uur. Een product dat in Magento is verwijderd terwijl er geen events binnenkwamen, blijft in Floynk staan tot Floynk het opnieuw uit Magento leest.
Voorraad
De voorraad van een product wordt niet meer bijgewerkt in Magento
Met Floynk beheert mijn voorraad meldt Floynk Voorraad niet bijgewerkt in Magento één keer per dag onder Meldingen, met de SKU van het product en het commando dat het oplost. Elke voorraadupdate heeft een nummer dat met de tijd oploopt, en Magento negeert een update met een lager nummer dan het laatste dat het heeft verwerkt (zie Voorraad). Hier heeft Magento een nummer dat meer dan een uur vóór de klok van Floynk ligt, bijvoorbeeld geschreven door een ander systeem of met de hand, of terwijl een serverklok verkeerd stond. Tot dat is gewist, negeert Magento elke voorraadupdate van Floynk voor dat product.
Wie uw Magento-server beheert, wist het met het commando van de Floynk-module:
bin/magento floynk:stock-sequence:reset <sku>
bin/magento floynk:stock-sequence:reset --all wist het voor alle producten. Het commando verwijdert alleen de nummers die de module bewaart; het verandert geen voorraad. De volgende voorraadupdate van Floynk voor het product zet de voorraad in Magento weer goed: bij de volgende voorraadwijziging, of wanneer de controle van elk uur het product bereikt.
Bestellingen
Hoe Floynk Magento-bestellingen afhandelt, staat onder Bestellingen. Een bestelling die niet gesynchroniseerd kon worden, toont een waarschuwing in de bestellijst en bij de bestelling:
| Floynk meldt | Wat u doet |
|---|---|
| Niet naar Magento gestuurd: Floynk-module niet geïnstalleerd | Installeer de Floynk-module. Bestellingen worden verstuurd zodra hij gevonden is. |
| Niet naar Magento gestuurd: de Floynk-integratie heeft geen toegang tot "Floynk Connector API" | Vink Floynk Connector API aan in Magento Admin › System › Extensions › Integrations › Floynk › API, sla op, klik op Reauthorize en klik daarna in Floynk op Opnieuw controleren. |
| Niet naar Magento gestuurd: de Floynk-integratie heeft geen toegang tot Floynk_Connector::api (of een ander onderdeel dat Magento noemt) | Dezelfde oplossing voor het getoonde onderdeel: vink het aan in Magento Admin › System › Extensions › Integrations › Floynk › API (Floynk_Connector::api is Floynk Connector API), sla op, klik op Reauthorize en klik daarna in Floynk op Opnieuw controleren. |
| Na verzending geannuleerd op de marketplace: handel dit handmatig af in Magento | De bestelling was in Magento al verzonden, dus Floynk kan hem daar niet annuleren. Handel het retour of de terugbetaling af in Magento; de waarschuwing linkt naar de bestelling. |
| Niet geïmporteerd: Floynk kan de regels van deze bestelling niet boeken | De waarschuwing zegt waarom. Bevat producttypes die Floynk niet ondersteunt (bundle, …): de Magento-bestelling bevat een bundle-, grouped-, downloadable- of gift card-product, zie hieronder. Geen regel waarvoor Floynk voorraad kan boeken: een configureerbaar product kwam zonder de bestelde variant binnen (de waarschuwing noemt de SKU), of de bestelling heeft geen regel met voorraad. Handel de bestelling af in Magento. |
| In Magento, maar het Magento-totaal wijkt af van wat de marketplace rekende: controleer de bedragen in Magento | De bestelling staat in Magento, maar het eindtotaal wijkt af van wat de marketplace rekende. De waarschuwing toont beide totalen. Een andere btw-verdeling terwijl de totalen kloppen is geen waarschuwing: zie Bestelling naar Magento verstuurd hieronder. Controleer de bestelling in Magento; de twee punten hieronder leggen de gewone oorzaken uit. |
| In Magento zonder btw: voeg in Magento een btw-tarief toe voor het land van de klant | Magento heeft geen btw geboekt op de bestelling. De waarschuwing noemt het land. Voeg er een btw-tarief voor toe, zie hieronder. |
| Niet naar Magento gestuurd: Magento kent geen combinatieproducten | De bestelling bevat een Floynk-combinatieproduct. Handel de bestelling handmatig af in Magento. |
| Niet naar Magento gestuurd: Magento gaf een fout; zie de meldingen van de bestelling | De module weigerde de bestelling. Weet Floynk waarom, dan zegt de waarschuwing dat: een product op de bestelling bestaat niet in Magento (maak het daar aan, of controleer de SKU), Magento was niet bereikbaar, Magento is de bestelling nog aan het aanmaken, of geen enkele bestelregel kan naar Magento. |
| Verzonden in Magento, maar de marktplaats weigert de verzendbevestiging: bevestig de verzending zelf bij de marktplaats | Magento heeft een marktplaatsbestelling verzonden en Floynk gaf de zending door aan de marktplaats, maar de marktplaats weigerde die drie keer, om een reden die opnieuw proberen niet oplost. De waarschuwing noemt de marktplaats en haar antwoord. Floynk probeert het niet meer: bevestig de zending in het verkopersportaal van de marktplaats. |
| Verzonden in Magento zonder vervoerder, dus Floynk kent geen Bol.com-vervoerder: bevestig de verzending zelf bij Bol.com en stel "Verzendmethode bestellingen" in bij Instellingen › Marktplaatsen › Bol.com › Verzending | Magento heeft een Bol.com-bestelling verzonden, maar Floynk kan de vervoerder uit Magento (de titel bij het trackingnummer van de zending) niet omzetten naar een Bol.com-vervoerder, en het Bol.com-account heeft geen standaard. Heeft Magento een vervoerder, dan noemt de waarschuwing die: Verzonden in Magento, maar Floynk kent geen Bol.com-vervoerder voor "…". Floynk probeert het niet opnieuw. Bevestig de verzending zelf bij Bol.com. Stel voor volgende bestellingen Verzendmethode bestellingen in bij Instellingen › Marktplaatsen › Bol.com › Verzending, of voeg daar een Verzendmethode-mapping toe voor die vervoerder. Staat Verzendmethode bestellingen op Uit Bestelling, dan levert dat geen vervoerder op voor zendingen uit Magento: voeg een Verzendmethode-mapping toe voor elke vervoerder die u in Magento gebruikt. |
Ordertotalen in Magento wijken een cent af. Als de catalogusprijzen in Magento exclusief btw zijn, rekent Magento de btw per regel uit en kan het anders afronden dan de marketplace. Bij 21% btw heeft ongeveer 17% van de prijzen inclusief btw geen exacte prijs exclusief btw, en bij 9% btw ongeveer 8%; voor die prijzen kan elke regel met btw en de verzending 1 cent afwijken. Floynk meldt dat op Instellingen › E-commerce › Magento tot u de melding sluit: "De catalogusprijzen in Magento zijn exclusief btw, dus ordertotalen in Magento kunnen per regel 1 cent afwijken van wat de marketplace rekende. Voor exacte totalen: zet de catalogusprijzen op incl. btw in Magento Admin › Stores › Configuration › Sales › Tax › Calculation Settings."
Magento heeft een btw-tarief nodig voor elk land waaraan u verkoopt. Floynk zet marketplace-bestellingen in Magento met de btw die de klant betaalde. Magento boekt die btw alleen als er een btw-tarief bestaat voor het land van de klant (Stores › Taxes › Tax Zones and Rates) en een btw-regel dat tarief gebruikt (Stores › Taxes › Tax Rules). Zonder tarief boekt Magento geen btw op de bestelling, en markeert Floynk de bestelling als aandacht nodig, met het land dat u moet toevoegen.
Een bestelling die in Magento in de wacht staat. Een Magento-bestelling die u in Magento in de wacht zet (on hold), toont In de wacht in Magento in de bestellijst en bij de bestelling. Floynk neemt haar niet op in picklijsten en maakt er geen verzendlabel of factuur voor. Geef haar in Magento vrij (Unhold), dan wordt ze gewoon gepickt.
Magento-bestellingen die op producten wachten. Een Magento-bestelling met een SKU die niet precies één product in Floynk is (ontbreekt, of staat op meer dan één product), wordt nog niet geïmporteerd. Instellingen › E-commerce › Magento toont deze bestellingen onder Bestellingen die op producten wachten, met de ontbrekende SKU's. Floynk importeert elke bestelling zodra haar producten in Floynk staan (importeer ze of maak ze aan, of maak een dubbele SKU uniek), en probeert het ook elke 30 minuten opnieuw. Na 30 dagen stopt Floynk ermee en meldt Magento-bestelling niet geïmporteerd.
Oudere Magento-bestellingen importeren. Instellingen › E-commerce › Opties › Importeer bestellingen uit winkel opent de importpagina, waar dezelfde knop Magento-bestellingen opnieuw importeert. Vul bij Aantal dagen terug in hoeveel dagen (1 tot en met 90), of laat het leeg om de bestellingen sinds het koppelen te importeren, hoogstens 90 dagen terug. Bestellingen die al in Floynk staan, worden niet dubbel geïmporteerd.
Bestellingsmeldingen
Floynk meldt wat er met Magento-bestellingen gebeurt onder Meldingen in het menu:
| Melding | Wat er gebeurde | Wat u doet |
|---|---|---|
| Bestelling aangemaakt vanuit Magento | Een nieuwe bestelling uit uw Magento-winkel is in Floynk binnengekomen. | Niets. |
| Bestelling naar Magento verstuurd | Een marketplacebestelling staat in Magento. Floynk meldt het ook als Magento te weinig voorraad had (Magento verzendt zodra de voorraad er is) of de btw anders afrondde. Btw anders verdeeld dan de marketplace: alleen ter info, de totalen kloppen; Floynk zet ook één opmerking met beide btw-bedragen bij de bestelling in Magento. | Niets, tenzij de melding over voorraad gaat. |
| Bestelling niet naar Magento verstuurd | De Floynk-module is niet geïnstalleerd of weigert de toegang (Floynk zet de bestelling in Magento zodra de module antwoordt), of Magento heeft de bestelling na 5 pogingen niet bevestigd. Floynk probeert het dan automatisch opnieuw zodra Magento weer bereikbaar is, en daarna elk uur. | Installeer de Floynk-module of geef haar toegang. Na 5 pogingen: zet de bestelling niet handmatig in Magento, want dan staat ze er twee keer in. Blijft deze melding terugkomen, neem dan contact op met support. |
| Bestelling in Magento heeft aandacht nodig | De totalen wijken af, Magento heeft geen btw geboekt, Floynk kon de btw en totalen van de verstuurde bestelling niet controleren, de marketplace annuleerde de bestelling na verzending, of de marketplace annuleerde een deel van de bestelling. Floynk past bestelregels in Magento niet aan. | Open de bestelling in Magento en pas haar daar aan, annuleer of crediteer haar. |
| Magento-bestelling niet verwerkt | Floynk kon een Magento-bestelling niet importeren. Meestal is een SKU op de bestelling niet precies één product in Floynk: het ontbreekt, of meer dan één product heeft die SKU. De bestelling wacht dan; deze melding komt één keer, als het wachten begint. Andere fouten worden hoogstens één keer per dag gemeld. | Ontbrekend product: importeer het of maak het aan, of maak de SKU uniek. Floynk importeert de bestelling dan meteen, en probeert het ook elke 30 minuten opnieuw; zie Bestellingen die op producten wachten hierboven. Andere fouten: handel de bestelling af in Magento. |
| Magento-bestelling niet geïmporteerd | Floynk probeerde een Magento-bestelling die niet geïmporteerd kon worden (bijvoorbeeld omdat een product ontbrak) steeds opnieuw en stopte na 30 dagen. De melding noemt de ontbrekende producten, als die er zijn. | Handel de bestelling af in Magento. |
| Zending niet naar Magento verstuurd | U heeft de bestelling verzonden, maar Magento bevestigde de zending niet. | Controleer eerst in Magento of de zending er al staat. Staat ze er niet, maak de zending dan handmatig aan in Magento. |
| Marktplaats bevestigt de verzending niet | Magento heeft een marktplaatsbestelling verzonden, maar na drie pogingen accepteert de marktplaats de verzendbevestiging nog niet. Floynk blijft het proberen. | Controleer de bestelling bij de marktplaats. |
| Marktplaats weigert de verzendbevestiging | Magento heeft een marktplaatsbestelling verzonden, maar de marktplaats weigert de verzendbevestiging definitief. Floynk probeert het niet meer; de bestelling toont een waarschuwing. | Bevestig de verzending zelf bij de marktplaats. |
| Magento-synchronisatie gepauzeerd | De Floynk-module is uit uw Magento-winkel verdwenen, of de controle van elk uur kon uw winkel niet bereiken, en een nieuwe controle een minuut later ook niet. Voorraadsynchronisatie en het versturen van orders naar Magento zijn gepauzeerd tot de module antwoordt; Floynk blijft elke 10 minuten naar nieuwe Magento-bestellingen kijken. De modulekaart op Instellingen › E-commerce › Magento zegt welke van de twee: Magento niet bereikbaar, of de melding om de module te installeren. | Magento niet bereikbaar: controleer of uw winkel online is en klik op Opnieuw controleren. Module verdwenen: installeer de Floynk-module opnieuw. |
| Magento-synchronisatie hervat | De module antwoordt weer. Voorraadsynchronisatie en het versturen van orders naar Magento lopen weer. | Niets. |
Producten
- "Magento kent geen combinatieproduct, dus Floynk kan deze combinatie niet in je Magento-winkel aanmaken." Floynk kan geen combinatieproducten in Magento aanmaken; de optie staat uit voor Magento-winkels.
- Producten met varianten kunnen niet vanuit Floynk in Magento worden aangemaakt. Floynk maakt simple-producten aan in Magento. Maak configurable-producten aan in Magento; Floynk importeert ze.
- Een onderliggend product dat bij twee configurable-producten hoort, wordt alleen aan het eerste gekoppeld. Floynk meldt dit onder Meldingen in het menu.
- Een product verschijnt opnieuw in Magento nadat u het heeft verwijderd of hernoemd: gebeurt dat in dezelfde seconden waarin Floynk het bijwerkt, dan maakt Magento het opnieuw aan. Floynk merkt dat bij zijn volgende update van dat product: het werkt het dan niet meer bij en toont "Product niet bijgewerkt in Magento". Dit is een beperking van de REST API van Magento: een update op SKU maakt het product aan als het ontbreekt, en Magento kan een product niet alleen bijwerken als het onveranderd is. Floynk controleert het product daarom vlak voor elke update, maar een wijziging daartussen kan er nog steeds doorheen glippen. Verwijder het product opnieuw in Magento als u het niet wilt, en importeer de producten opnieuw in Floynk om de koppeling te herstellen.
Sale-prijzen
Een sale-prijs (Sale Prijs in Floynk, Special Price in Magento) hoort bij de plek waar hij het laatst is ingesteld:
- Een sale die u in Floynk aanmaakt of het laatst in Floynk wijzigt, is van Floynk: Floynk stuurt hem met zijn productupdates naar Magento.
- Een sale die met een productimport uit Magento binnenkwam, is van Magento: Floynk stuurt hem nooit terug, dus een sale die u in Magento beëindigt, blijft beëindigd.
- Beëindigt u een Floynk-sale in Floynk, dan wist Floynk de Special Price in Magento één keer en laat het veld daarna aan Magento. Wijkt de sale in Magento af van wat Floynk het laatst stuurde (u heeft de prijs of de datums daar gewijzigd), dan wist Floynk hem niet: de sale is van Magento.
- Wijzigt u een Floynk-sale in Magento (de prijs of de datums) of beëindigt u hem daar, dan is hij weer van Magento zodra Floynk het product importeert, en daarna laat Floynk hem met rust.
Niet-ondersteunde producttypes
Floynk importeert simple-, virtual- en configurable-producten. Deze Magento-producttypes worden niet geïmporteerd:
- Bundle
- Grouped
- Downloadable
- Gift card (Adobe Commerce)
Na een import toont Floynk onder Meldingen in het menu wat het heeft overgeslagen: Magento-import met "{aantal} producten niet geïmporteerd, omdat Floynk dit type niet ondersteunt ({types}): {SKU's}". Een Magento-bestelling met een van deze producten wordt niet geïmporteerd, en Floynk boekt er niets voor.