BjornTechKunskapsbank

KASSASYSTEM

Felsökning av vanliga fel i PayPal POS-integrationen

Svenska8 min läsningUppdaterad

Read this guide in English →

På den här sidan

Fel 1 – PayPal POS kan inte nå din webbplats#

Felmeddelande:

The PayPal POS service was not able to reach your site (needed for updates from PayPal POS). Remove any ‘coming soon’ plugins, enable https and try to refresh the connection.

Lösning:

Felet innebär att PayPal POS-tjänsten inte kan kommunicera med din webbplats. Anslutningen behövs för att webbplatsen ska kunna ta emot uppdateringar från PayPal POS.

Kortsiktig lösning:

  1. Uppdatera anslutningen:

    • Gå till avsnittet Advanced settings i tillägget.

    • Klicka på Refresh.

  2. Godkänn anslutningen på nytt:

    • Om det inte hjälper att uppdatera anslutningen går du till General settings i tillägget.

    • Klicka på Authorize för att ansluta tillägget till PayPal POS på nytt.

Långsiktig lösning:

  1. Kontrollera om något tillägg blockerar anslutningen:

    • Om det inte går att godkänna anslutningen på nytt kan något blockera kommunikationen mellan PayPal POS och din webbplats.

    • Kontrollera att du inte har några tillägg som kan blockera anrop från PayPal POS, till exempel ”coming soon”-tillägg eller säkerhetstillägg med restriktiva brandväggsinställningar.

  2. Tillåt webhook-adressen:

    • Om du använder en brandvägg eller ett CDN framför webbplatsen behöver du tillåta anrop till /wp-json/izettle/webhook i inställningarna.

  3. Kontakta supporten:

Fel 2 – Samma PayPal POS-UUID finns på fler produkter än förväntat#

Felmeddelande:

[paypalpos-product-uuid] found on more posts than expected ([product_id]). when creating PayPal POS product from WooCommerce product [product_id]

Lösning:

Felet uppstår vanligtvis när en produkt i WooCommerce har duplicerats med ett tillägg, till exempel Duplicate Post, i stället för med WooCommerce inbyggda funktion.

Kortsiktig lösning:

  1. Identifiera berörda produkter:

    • Leta upp produkterna i WooCommerce. Produkternas ID anges i felmeddelandet.

  2. Flytta till papperskorgen och återställ:

    • Flytta produkterna till papperskorgen utan att radera dem permanent. Detta bryter kopplingen mellan WooCommerce-produkterna och PayPal POS.

    • Återställ produkterna från papperskorgen.

  3. Synkronisera på nytt:

    • Kör en ny synkronisering från WooCommerce till PayPal POS.

Långsiktig lösning:

  • Använd alltid WooCommerce inbyggda funktion för att duplicera produkter för att undvika felet. Det är den enda metod som fungerar korrekt med PayPal POS-integrationen.

Fel 3 – Kommunikationsfel när en produkt skapas eller uppdateras i PayPal POS#

Felmeddelande:

Communication error with PayPal POS when creating/updating PayPal POS product from WooCommerce product [product_id]. Please try to sync the product to PayPal POS again by clicking Update in the WooCommerce product view.

Lösning:

Felet uppstår vanligtvis om du först har exporterat en enkel produkt från WooCommerce till PayPal POS och sedan lagt till varianter direkt i PayPal POS. Produkten har då i praktiken ändrats till en variabel produkt.

Aktivera inställningen Allow conversion from simple to variable products under Advanced settings i tillägget.

Det gör att tillägget kan hantera ändringen från enkel till variabel produkt korrekt och bör lösa kommunikationsfelet.

Fel 4 – Lagerändringar i PayPal POS/Zettle uppdateras inte i WooCommerce#

I felloggen visas ”Zettle UUID [xxx] not found in WooCommerce”.

Lösning:

Felet uppstår när tillägget inte kan koppla en produkt i PayPal POS/Zettle till motsvarande produkt i WooCommerce. Tillägget använder i första hand det UUID som Zettle har tilldelat produkten och i andra hand produktens artikelnummer (SKU). Om UUID-matchningen är felaktigt inställd kan lageruppdateringar från kassaterminalen utebli utan något synligt felmeddelande.

Gör så här:

  • Gå till Advanced settings i tillägget.

  • Kontrollera att Do not match products using UUID INTE är markerat.

  • Spara inställningarna.

Kontrollera också att alla dina WooCommerce-produkter har ett artikelnummer (SKU). Produkter utan SKU kan inte matchas med reservmetoden, vilket kan leda till att lagersynkroniseringen misslyckas.

Om felet kvarstår efter ändringarna kontaktar du BjornTechs support på hello@bjorntech.com.

Fel 5 – Integrationen har slutat fungera och det hjälper inte att uppdatera anslutningen#

Lösning:

Efter en driftstörning hos PayPal POS/Zettle, en flytt av webbplatsen eller ett temabyte kan tillägget helt förlora sin anslutningstoken. Då räcker det inte att klicka på Refresh under Advanced settings för att återställa anslutningen.

Så här godkänner du anslutningen på nytt:

  • Gå till General settings i tilläggets inställningar.

  • Klicka på Authorize.

  • Du skickas vidare till inloggningssidan för PayPal POS/Zettle. Logga in med uppgifterna för ditt PayPal POS/Zettle-konto.

  • När du har loggat in skickas du tillbaka till din webbplats och anslutningen återställs helt.

Om felmeddelandet ”The PayPal POS service was not able to reach your site” kvarstår går du till Advanced settings, aktiverar Use Zettle access token lock och klickar sedan på Refresh igen.

Observera att BjornTechs support inte kan återställa anslutningen åt dig. Du måste själv godkänna anslutningen eftersom det kräver inloggning på ditt eget PayPal POS/Zettle-konto.

Fel 6 – Synkronisering av ett stort produktsortiment går mycket långsamt eller stannar halvvägs#

Lösning:

Med stora produktsortiment, på flera tusen produkter, kan en fullständig synkronisering ta mycket lång tid och göra webbplatsen långsammare. Synkroniseringen körs som ett bakgrundsjobb av WooCommerce Action Scheduler, som som standard bearbetar 10 produkter per minut.

Så här kan du förbättra prestandan:

  • Gå till Advanced settings i tillägget.

  • Öka värdet för Scheduler batch size. Det styr hur många produkter som bearbetas per minut. Prova att höja värdet stegvis, till exempel från 10 till 25, och följ resultatet. Det lämpliga värdet beror på din webbhotellsmiljö.

  • Om en större batchstorlek leder till att tidsgränsen överskrids ökar du även Scheduler time limit, så att varje omgång får mer tid att slutföras. Vissa webbhotell begränsar detta värde. I så fall behöver du kontakta ditt webbhotell.

För att minska belastningen på webbplatsen under synkronisering kan du byta från WP Cron till ett cron-jobb på servernivå. WP Cron körs i samband med sidförfrågningar och kan göra webbplatsens besökarsidor långsammare när tunga bakgrundsuppgifter bearbetas. En guide för att inaktivera WP Cron och ställa in ett cron-jobb finns på https://kinsta.com/knowledgebase/disable-wp-cron/.

Om synkroniseringen stannar helt och inga produkter bearbetas går du till WooCommerce -> Status -> Scheduled actions och kontrollerar om antalet väntande åtgärder minskar. Om antalet inte minskar alls kan Action Scheduler vara blockerad i din webbhotellsmiljö. Kontakta i så fall ditt webbhotell.

Fel 7 – Streckkoder eller inköpspriser synkroniseras inte till PayPal POS/Zettle#

Lösning:

Streckkod och inköpspris är inte standardfält för produkter i WooCommerce. PayPal POS-integrationen har egna fält för dessa värden. Fälten måste aktiveras och ställas in innan värdena kan synkroniseras.

Så här ställer du in synkronisering av streckkoder:

  • Gå till Products to PayPal POS/Zettle i tilläggets inställningar.

  • Ställ in Barcode på Copy the barcode field from WooCommerce to Zettle.

  • Ange streckkoden för varje produkt i WooCommerce i streckkodsfältet på fliken PayPal POS/Zettle på produktens redigeringssida. Fältets underliggande metadatanyckel i WooCommerce är _izettle_barcode.

  • Spara och synkronisera produkterna.

Du kan också generera streckkoder automatiskt från produkternas artikelnummer (SKU). Aktivera alternativet för streckkodsgenerering under Products to PayPal POS/Zettle och kör en synkronisering för att generera streckkoder för alla produkter.

Så här ställer du in synkronisering av inköpspriser:

  • Aktivera Cost price under Products to PayPal POS/Zettle.

  • Ange inköpspriset i fältet för inköpspris på varje produkt, på fliken PayPal POS/Zettle. Den underliggande metadatanyckeln är _izettle_cost_price. Viktigt: ange priset som ett vanligt tal utan valutasymbol.

Om du vill importera streckkoder och inköpspriser för många produkter samtidigt använder du WooCommerce inbyggda CSV-import för produkter. Ta med metadatakolumnerna _izettle_barcode och _izettle_cost_price i CSV-filen.

Fel 8 – Produkter visas som dubbletter i PayPal POS/Zettle efter synkronisering#

Lösning:

Dubbletter i PayPal POS/Zettle beror oftast på att ett tredjepartstillägg har använts för att duplicera produkter i stället för WooCommerce inbyggda funktion. Sådana tillägg kopierar alla produktmetadata, inklusive PayPal POS-UUID. Det gör att integrationen skapar en ny produkt i PayPal POS i stället för att uppdatera den befintliga.

Så här förhindrar du dubbletter:

  • Gå till Advanced settings i tillägget.

  • Aktivera Delete product meta data on new product. Inställningen tar bort PayPal POS-UUID från en produkt första gången den bearbetas. Då behandlar tillägget produkten som en helt ny produkt i stället för som en kopia av en befintlig.

  • Spara inställningarna.

  • Använd framöver alltid WooCommerce inbyggda funktion för att duplicera produkter, inte tredjepartstillägg.

Om dubbletter fortfarande skapas efter att du har aktiverat inställningen kontaktar du BjornTechs support på hello@bjorntech.com för vidare felsökning.

Fel 9 – Produktbilder visas inte i PayPal POS/Zettle efter synkronisering#

Lösning:

Den vanligaste orsaken till att bilder inte synkroniseras är att bildformatet inte stöds av PayPal POS API.

Så här felsöker du:

  • Aktivera loggning under General settings i tillägget.

  • Öppna en av de berörda produkterna i WooCommerce, byt till en annan bild och spara.

  • Vänta ett par minuter och kontrollera om bilden nu visas i PayPal POS/Zettle.

  • Om bilden fortfarande saknas hämtar du dagens logg: gå till WooCommerce -> Status -> Logging och öppna filen med namnet woo-izettle-integration följt av dagens datum.

  • Leta efter felmeddelanden som gäller bilduppladdningen.

Om bilderna fortfarande inte synkroniseras kontaktar du BjornTechs support på hello@bjorntech.com och bifogar loggen från felsökningen ovan.

Fel 10 – Ordrar från PayPal POS/Zettle-terminalen visas inte i WooCommerce#

Lösning:

Ordrar som läggs på den fysiska PayPal POS/Zettle-terminalen synkroniseras till WooCommerce via tilläggets avsnitt för Zettle-köp. Om ordrarna inte visas i WooCommerce gör du så här:

  • Gå till PayPal POS purchases i tilläggets inställningar och kontrollera att synkronisering av ordrar är aktiverad.

  • Om du vill starta en synkronisering manuellt för att hämta en saknad order klickar du på Start under PayPal POS purchases. Det startar en omedelbar synkronisering av de senaste köpen.

  • Aktivera loggning under General settings i tillägget.

  • Försök synkronisera manuellt och kontrollera sedan loggen under WooCommerce -> Status -> Logging. Leta efter filen med namnet woo-izettle-integration följt av dagens datum och kontrollera om den innehåller några fel.

Om loggen visar att köpet har tagits emot men ordern ändå inte visas i WooCommerce kan det finnas en konflikt med ett annat tillägg eller ett tema som hindrar ordern från att sparas korrekt. Kontakta i så fall BjornTechs support på hello@bjorntech.com och bifoga loggfilen.

Observera att synkroniseringen är beroende av att WooCommerce Action Scheduler fungerar korrekt. Om bakgrundsuppgifter inte bearbetas på webbplatsen kan ordrar från kassaterminalen också försenas eller utebli. Se Fel 6 ovan för hjälp med att kontrollera och åtgärda problem med Action Scheduler.

Fel 11 – En produkt har för många variantattribut#

Felmeddelande:

Size must be between 1 and 3 when creating/updating Zettle product from WooCommerce product [product_id]

Lösning:

Felet uppstår eftersom PayPal POS/Zettle stöder högst 3 variantattribut per produkt, till exempel storlek, färg och material. Om den berörda WooCommerce-produkten har fler än 3 attribut som används för varianter avvisar PayPal POS/Zettle produkten vid synkronisering.

Öppna produkten i WooCommerce och minska antalet variantattribut till 3 eller färre. Spara och synkronisera sedan produkten igen.

Behöver du mer hjälp?

Kontakta oss ↗

Relaterade artiklar