Den här guiden är till för butiks- och ekonomipersonal som förväntar sig en order i Fortnox men inte hittar den. Gå igenom kontrollerna i tur och ordning: de flesta saknade ordrar förklaras av de tre första, och ofta gör integrationen precis det som dess inställningar säger åt den att göra.
Kontrollerna gäller alla webbutiker som är kopplade till Fortnox (Shopify, WooCommerce, Centra, Magento med flera). Inställningarnas namn skiljer sig något mellan webbutikerna; där de gör det anger exemplen nedan den exakta titel som appen visar.
Innan du börjar
Ha ordern till hands: ordernumret, datumet då den lades och dess status i webbutiken. Leta först i Fortnox – Junipeer skapar ordern med det ursprungliga orderdatumet, så en order som lades för några dagar sedan kanske helt enkelt inte ligger överst i listan.
1. Är integrationen aktiv och ansluten?
Om inga ordrar kommer fram, börja här.
Öppna integrationen och kontrollera att den är aktiv.
På sidan Connectors, kontrollera att både webbutiken och Fortnox visas som Connected. En anslutning som har gått ut eller återkallats stoppar all synkronisering på en gång. I loggarna visas detta ofta som "Invalid grant". Anslut systemet på nytt för att åtgärda det.
Fortnox använder behörigheterna för den användare som anslöt det. Om den användarens licenser eller behörigheter har ändrats eller tagits bort slutar ordrarna att komma fram. Se Förbered Fortnox för integration för vad användaren behöver.
Om allt slutade fungera vid samma tidpunkt är en utgången anslutning den mest sannolika orsaken. Om bara vissa ordrar saknas, gå vidare till nästa kontroller.
2. Är orderflödet påslaget, och finns det något som startar det?
Ordrar skickas av flödet Export Orders to Fortnox. Ett flöde körs bara när något startar det: ett schema, en trigger efter ett annat flöde eller en webhook från webbutiken.
På sidan Flows, kontrollera att Export Orders to Fortnox är aktiverat. Ett schema på ett inaktiverat flöde gör ingenting.
Kontrollera att flödet har en aktiverad schemaläggningsregel, eller att det styrs av webhooks. Shopify-ordrar hämtas till exempel normalt via webhook när de skapas eller uppdateras. Om varken ett schema eller en webhook finns på plats är det inget fel på ordern – flödet körs helt enkelt aldrig.
Tänk på tidpunkten. En order som lades efter den senaste körningen kommer fram vid nästa körning. Det kortaste schemat är var 5:e minut.
3. Hoppar ett filter eller en inställning över ordern med avsikt?
Det här är den vanligaste orsaken till att "vissa ordrar saknas". Ett filter som utesluter en status, ett land eller ett datumintervall gör det utan att säga något: ordern är inget fel, den hämtas bara inte. Öppna inställningarna för Export Orders to Fortnox och kontrollera var och en av dessa.
Vad du ska kontrollera | Inställningens titel i appen | Vad den gör |
|---|---|---|
Orderstatus | Shopify Order Statuses, Woocommerce Order Statuses, Magento Order Statuses | Endast ordrar med någon av de valda statusarna skickas. En order som ännu inte har nått den statusen skickas inte. |
Länder | Countries to Ignore | Ordrar från de valda länderna skickas inte till Fortnox. Tomt innebär att ordrar från alla länder skickas. |
Ordertyp | Orders types to Ignore | Ordrar av den valda typen (B2B eller B2C) skickas inte. Tomt innebär att alla ordrar skickas. |
Gamla ordrar | Exclude Orders created before this date (till exempel WooCommerce och Magento) eller Order exclusion date | Ordrar som skapats före datumet synkroniseras aldrig. |
Alla webbutiker har inte alla dessa inställningar – du ser bara de som din integration har. Klicka på ? bredvid en inställning för mer information.
Flödesfilter. Många orderflöden har också filter på själva flödet (kugghjulsikonen på flödet, sedan Source → Filters). Dessa kan begränsa ordrar efter till exempel Order Status, Country, Delivery Country, Currency Code eller Order Date. För Centra kan filter även begränsa efter Store och Market, och filtren ersätter de äldre Centra-inställningarna Order Statuses to import och Only load orders newer than. Ett statusfilter som utelämnar den status dina ordrar faktiskt har är den vanligaste orsaken till att "det plötsligt slutade fungera".
Saker att se upp med:
Exakt stavning. Statusvärden måste stämma exakt överens med webbutiken, inklusive versaler och gemener. För Magento är till exempel processing inte samma sak som Processing.
Ändrade statusar. Om din butik har ändrat hur den använder statusar – eller lagt till en ny – kanske filtret inte längre matchar.
Uteslutningsdatumet är en absolut gräns. Att flytta tillbaka startdatumet för synkroniseringen hämtar inte in ordrar från före uteslutningsdatumet.
Ordern finns i Fortnox, men det finns ingen faktura
Om Transform new orders to Invoice in Fortnox är aktiverad kan två inställningar göra att en order förblir en order:
Transform Only Paid Orders – obetalda order förblir order. Order som betalas senare kan omvandlas till fakturor av flödet Transform Fortnox orders to Invoices.
Transform Only B2B orders – endast företagsorder blir fakturor.
4. Se vad som hände i appen
Om integrationen är ansluten, flödet körs och inget filter förklarar saken, titta på själva posten.
Entities – välj Orders och sök efter ordern. Om den finns där ser du dess synkstatus och när den behandlades. Om den misslyckades visas felet i listan.
Logs – filtrera på status Error och ett nyligen inträffat tidsintervall, eller sök på orderns referens. En felpost visar vilket steg som misslyckades och varför.
Tasks – visar varje körning av flödet och dess resultat. En körning som är Completed men har behandlat 0 order betyder oftast att ett filter uteslöt allt, eller att startdatumet för synkroniseringen har flyttats förbi orderna.
Om det inte finns någon loggpost och ingen entitet alls för ordern har Junipeer aldrig hämtat den. Gå tillbaka till steg 3 och kontrollera att ordern skapades efter exkluderingsdatumet.
Vanliga fel som stoppar en order i Fortnox:
Meddelande i loggen | Vad det oftast betyder |
|---|---|
"Kunde inte hämta/hitta valuta" | Orderns valuta är inte upplagd i Fortnox. |
"Kunde inte hämta/hitta moms" | Momssatsen på ordern finns inte i Fortnox. |
"Invalid grant" | Anslutningen har gått ut. Anslut den igen. |
"Order with ID X not found" | Ordern kunde inte hittas i webbutiken — den kan ha raderats, eller så saknar anslutningen åtkomst till den. |
Om en orderrad innehåller en artikel som inte finns i Fortnox avgör inställningen Create missing articles in Fortnox om integrationen skapar den. Se Referens för felkoder för fler meddelanden och hur du åtgärdar dem.
5. Skicka en order igen
När du har hittat och åtgärdat orsaken skickar du ordern igen med Export One på sidan Flows, med flödet Export one Order to Fortnox.
Kontrollera i Fortnox och på sidan References att ordern verkligen saknas. Om du skickar en order som redan finns där kan en dubblett skapas.
Ange ordern. Varje webbutik efterfrågar sin egen identifierare — till exempel efterfrågar Shopify Order ID, och WooCommerce accepterar Order ID or Number.
Kör den och kontrollera sedan sidorna Tasks och Logs samt ordern i Fortnox.
Bra att veta:
En ändrad inställning påverkar bara order som behandlas från och med då. Order som redan har hoppats över eller misslyckats förblir så tills du skickar dem igen.
Om en rättelse har gjorts i webbutiken men ordern fortfarande misslyckas med gamla uppgifter, använd Clear Cache på sidan Configure > Settings och försök sedan igen.
För att hämta in flera order från en period kan startdatumet för synkroniseringen på sidan Time History flyttas bakåt. Börja med en kort period och kontrollera resultatet först.
6. När du ska kontakta support
Kontakta support@junipeer.io om ordern fortfarande inte kommer fram, samma fel återkommer eller om ett filter ser rätt ut men order ändå hoppas över. Bifoga:
Ordernummer och, om du har det, uppgifts-ID:t från sidan Logs eller Tasks
Vad du förväntade dig och vad som hände i stället
De kontroller du redan har gjort och eventuella nyligen gjorda ändringar av inställningar