Felsökning

Tillägget skriver vad som gått fel till WooCommerce-loggen, under WooCommerce -> Status -> Loggar i filen som heter fraktjakt. Loggningen är på som standard, och nycklar maskeras alltid. Börja alltid där, meddelandena säger oftast både vad och varför.

Vanliga situationer

Kassan visar reservfrakten i stället för livepriser

Loggen säger: Offertanrop till Fraktjakt misslyckades, reservläge visas i kassan, med felet från Fraktjakt. Vanligast är en tillfällig driftstörning eller fel kontouppgifter. Kassan väntar högst åtta sekunder på svar, sedan tar reserven över, och ett misslyckat anrop upprepas inte på 45 sekunder.

Ingen ombudslista i kassan

Loggen säger: Ombudssökning misslyckades, ombudsvalet visas tomt i kassan. Kunden kan fortfarande handla, och Fraktjakt väljer då närmaste ombud vid bokningen. Visas listan aldrig, kontrollera då att tjänsten faktiskt lämnar ut hos ombud, och för kopplade metoder att en Fraktjakt-tjänst är vald.

En frakttjänst syns inte i kassan

Kontrollera i den här ordningen: metodens egna gränser för vikt, värde och fraktklass i zonen, sektionen Gränser per Fraktjakt-tjänst, och att tjänsten är aktiv i ditt Fraktjakt-konto. Värdegränserna räknas efter rabattkoder, så en rabattkod kan ändra vilka tjänster som visas.

En tjänst går inte att välja fast den är aktiv i Fraktjakt

Listan över tjänster hämtas från Fraktjakt och sparas i sex timmar. Har tjänsten nyss slagits på, klicka Uppdatera tjänstelistan på sidan Fraktjakt i adminmenyn. Saknas tjänsten även efter det lämnar Fraktjakt inte ut den för kontot, kontakta då Fraktjakt.

Bokningen stoppas med en ordernotering

Ordernoteringen säger varför: adressen kan sakna uppgifter, tjänsten kan ha underkänts för adressen vid butiksstyrd bokning, eller så flaggade Fraktjakt sändningen för kontroll. En order hoppas aldrig över i tysthet, det står alltid en notering.

Automatisk bokning blir aldrig klar

Ordern står utan fraktsedel och loggen har raden Bokning skickas till Fraktjakt men ingen rad Fraktjakt svarade på bokningen. Då avbröts jobbet medan bokningen pågick. Automatiska bokningar körs i bakgrunden av WooCommerces Action Scheduler, och på vissa webbservrar, till exempel LiteSpeed, avbryts PHP när anropet som startade kön kopplar ner. Fraktrutan varnar då för en möjlig dubbelsändning. Kontrollera i Fraktjakt om sändningen skapades innan du bokar om. Samma varning visas när Fraktjakts svar på en bokning kom avklippt, oläsligt eller utan Fraktjakts statuskod.

Låt serverns cron köra kön i stället. Stäng av att WordPress startar kön vid sidvisningar med add_filter( 'action_scheduler_allow_async_request_runner', '__return_false' ); och kör wp action-scheduler run från serverns cron varje minut. WordPress egen cron startar också kön med ett anrop till sig själv. Den kan stängas av med define( 'DISABLE_WP_CRON', true ); i wp-config.php, men bara om serverns cron också kör WordPress schemalagda händelser, till exempel med wp cron event run --due-now. Kommandot wp action-scheduler run kör bara Action Schedulers kö, och utan det andra slutar till exempel schemalagda inlägg och uppdateringskoll att fungera. Webbhotellet kan hjälpa till med cron-jobben.

Ordern har flera fraktrader

Loggen säger: Ordern har flera Fraktjakt-fraktrader. Bara den första sändningen bokas. Ett tillägg som delar varukorgen i flera paket har skapat flera rader. Tillägget bokar en sändning per order.

Kustom-kassan

Inga fraktalternativ i Kustom-kassan

Tre möjliga loggrader:

• KSA svarade utan fraktalternativ. Fyll i tabellen: tabellen är tom eller raderna saknar namn.
• Alla rader ligger utanför sina gränser för vikt eller värde: varukorgens vikt och värde står i samma loggrad, jämför mot raderna.
• Ingen alternativrad gäller kassans valuta: kunden handlar i en valuta utan rader. Lägg en rad per valuta med rätt belopp.

I alla tre fallen visar Kustom att leveransalternativ saknas, och kunden kan inte slutföra köpet.

Köpet avbryts med "The shipping methods have been changed"

Metoden Fraktjakt i Kustom-kassan saknas i kundens fraktzon, eller så saknas en vanlig metod som reserv i zonen. Loggen säger: fraktmetoden Fraktjakt i Kustom-kassan saknas i kundens fraktzon. En påminnelse visas också i admin på fraktinställningssidorna.

Kommer felet bara när fri frakt gäller, till exempel med en rabattkod i varukorgen, är det WooCommerces inställning under Inställningar -> Frakt som döljer fraktavgifter när fri frakt finns, eller ett tema med samma regel. Tillägget sätter tillbaka metoden Fraktjakt i Kustom-kassan, och loggen säger då: fraktmetoden Fraktjakt i Kustom-kassan hade tagits bort ur kassans rater.

Samma fel kommer när Tillåtna kundtyper i Kustom Checkouts inställningar ändrats till B2B utan att Kustom aktiverat företagsköp på butikens konto. Kassan visar då företagsväljaren, men varje köp faller vid betalningen. Ställ tillbaka till B2C tills Kustom bekräftat aktiveringen.

"Kustom Checkout är inte tillgängligt"

Temat ritar kassan med egen layout i stället för WooCommerces standardmall, eller så saknas villkorssidan under WooCommerce -> Inställningar -> Avancerat. Prova med ett standardtema, kommer iframen då upp ligger orsaken i temats kassalayout.

Ordern pausas hos Kustom

Beloppet på ordern skiljer sig från det kunden betalade. Ordernoteringen jämför summorna, och loggen säger: fraktbeloppet i kassan och på ordern skiljer sig. Kontrollera att momssatsen på raden i alternativtabellen stämmer med butikens momsinställning för frakt.

Har ordern två fraktrader hos Kustom och skiljer summan sig med precis fraktpriset, är kryssrutan Shipping methods in iframe av i Kustom Checkouts inställningar. WooCommerce skickar då sin egen fraktrad och Kustom lägger på sitt alternativ ovanpå. Slå på kryssrutan, en påminnelse visas i admin så länge den är av.

Ombudslistan saknas i iframen

Loggen säger: ombudssökningarna hann inte inom tidsbudgeten, alternativ serverades utan ombudslista. Hämtningen från Fraktjakt var för långsam, så alternativen skickades utan lista i stället för att hela svaret skulle bli för sent och Kustoms reserv ta över. Raden visas då som Kustoms typ för ombud utan känd plats, kunden kan handla, och Fraktjakt väljer närmaste ombud vid bokningen. Händer det ofta är butikens server eller nätverk långsamt, loggens rad KSA: servering klar visar tiden per svar.

Alternativen heter inte som raderna i tabellen

Kustom benämner alternativen efter radens typ, till exempel Utlämningsställe eller Hemleverans, tills reglaget Naming controlled by TMS slås på i portalens shipping-profil. Slå på det så visas radernas egna namn. Orderns fraktrad får alltid namnet från tabellen, oavsett reglaget.

Tabellraden syns i butikens vanliga kassa

Kundens val ur Kustom-kassan låg kvar som fraktrad, ofta förvald, när kunden bytte till ett annat betalsätt. Raterna räknas nu om när valet slutar gälla. Ser du det efter uppdateringen, kontrollera i ett privat fönster, en pågående session kan bära gamla rater tills den förnyas.

En order kom in utan kundens fraktval

Loggen säger: en order från Kustom-kassan saknar kundens fraktval, och en adminnotis visas. Två orsaker finns. Antingen svarade butiken inte i tid, då visade Kustom sina reservalternativ, alltså zonens vanliga metoder, och loggen har en rad om tomt eller långsamt svar strax före ordern. Eller så saknas leveranssättet Fraktjakt i Kustom-kassan i kundens fraktzon. Kontrollera också att Kustom Checkout-tillägget är uppdaterat. Ordern behöver få sin frakt satt för hand.

Walley-kassan

Inga fraktalternativ i Walley-kassan

Tre möjliga loggrader, samma som i Kustom-läget men med Walley i början:

• Walley svarade utan fraktalternativ. Fyll i tabellen: tabellen är tom eller raderna saknar namn.
• Alla rader ligger utanför sina gränser för vikt eller värde: varukorgens vikt och värde står i samma loggrad, jämför mot raderna.
• Ingen alternativrad gäller kassans valuta: kunden handlar i en valuta utan rader.

Vad kassan visar då styrs av reservinställningen på butikens profil hos Walley. Saknas loggrader helt har Walley inte nått adressen: kontrollera att profilen har adaptern, att adressen svarar över https och att inloggningen stämmer. Fel inloggning ger raden Walley: anrop avvisat på felsökningsnivå, som bara skrivs med WP_DEBUG på.

Svarar adressen 401 trots rätt uppgifter, till exempel i curl-provet, släpper servern inte igenom Authorization-headern till PHP. Det är samma serverinställning som WordPress egna applikationslösenord kräver, be webbhotellet aktivera den.

Visas ingen text i kassan när svaret är tomt saknar profilen hos Walley en reservinställning. Den sätts av Walley Merchant Services.

Ordern fick zonens vanliga frakt

Kundens val i iframen blev inte en fraktrad. Loggen säger: en order från Walley-kassan saknar kundens fraktval från adaptern, och en adminnotis visas. Tre orsaker finns: leveranssättet Fraktjakt i Walley-kassan saknas i kundens fraktzon, profilnamnet under Custom profile i Walley Checkouts inställningar saknar ordet shipping, eller så svarade butiken utan alternativ och Walley använde sitt reservläge. Ordern behöver få sin frakt satt för hand. Råkar reservmetoden heta och kosta som en rad i tabellen bokas ordern på den raden, kontrollera fraktraden innan bokningen.

Ordern har fel fraktbelopp

Skiljer sig orderns fraktrad från vad kunden betalade hos Walley jämför ordernoteringen summorna, och loggen säger: fraktbeloppet i kassan och på ordern skiljer sig. Kontrollera att momssatsen på raden i alternativtabellen stämmer med butikens momsinställning för frakt. Har Walley lagt på frakten ovanpå WooCommerces egen fraktrad saknar profilnamnet ordet shipping, se ovan.

PHP-varning om pendingShipment

Walley Checkout för WooCommerce förväntar sig ett fält från nShifts leveransmodul när ordern bekräftas och när ordern visas i admin, och skriver en varning i PHP-loggen när fältet saknas. På ordersidan syns också en tom rad Shipment ID under Shipment information. Adaptrar som tilläggets har inte fältet. Varningen är ofarlig och ordern påverkas inte.

Webhooken

Rader som Webhook avvisad betyder att ett anrop mot statusuppdateringen inte kunde verifieras och kastades. Enstaka rader är brus från internet. Kommer de i mängd samtidigt som orderstatusar slutar uppdateras, kontrollera att butikens klocka går rätt och att Consignor-uppgifterna stämmer.

När loggen inte räcker

Felsökningsraderna på debug-nivå skrivs bara när WordPress kör med WP_DEBUG. De behövs sällan, men ger varje steg i pris- och bokningsflödet när något behöver följas i detalj.