Utbetalningsavstämning kräver att Junipeer matchar varje inkommande utbetalningstransaktion från din betalningsleverantör mot rätt faktura i Fortnox. För att göra detta slår systemet upp ett referensvärde från utbetalningen och försöker hitta ett matchande fält på Fortnox-fakturan.
Det låter enkelt — men i praktiken är det en av de vanligaste källorna till konfigurationsförvirring, särskilt när integrationen involverar både en e-handelskoppling (Shopify, Centra, etc.) och en separat PSP-koppling (Qliro, Svea, Mollie, etc.).
Varför detta är förvirrande
Handlare som är nya i konfigurationen ställer ofta en befogad fråga: "Om det är Junipeer som skapar fakturorna i Fortnox, varför behöver vi berätta för Junipeer vilket fält referensen finns i? Borde inte systemet redan veta det?".
Svaret är att referensfältet ofta populeras på e-handelsnivå (t.ex. Shopify → Fortnox), inte i utbetalningskopplingen. Utbetalningskopplingen kan köra oberoende — den kan ta emot en batch av utbetalningstransaktioner från PSP:en, och för varje transaktion behöver den hitta den matchande fakturan i Fortnox. Det gör den genom att jämföra en referens från utbetalningen med ett fält på Fortnox-fakturan.
Utmaningen: det finns flera referensfält på en Fortnox-faktura, och vilket som innehåller butikens order-ID eller PSP:ens order-ID beror helt och hållet på hur din orderkoppling konfigurerades.
Det är därför du behöver synkronisera de två kopplingarna. Referensen som e-handelskopplingen skriver till Fortnox måste matcha det referensfält som utbetalningskopplingen är konfigurerad att söka i.
Fortnox referensfält
Fortnox-fakturor har flera fält som Junipeer kan använda som utbetalningsreferens:
| Fält | Vad det typiskt innehåller |
|---|---|
| ExternalInvoiceReference1 | Butikens ordernummer (t.ex. Shopify order-ID) — vanligast |
| ExternalInvoiceReference2 | Sekundär referens — ibland PSP order-ID eller token |
| DocumentNumber | Fortnox eget interna fakturanummer |
| OurReference | Intern referens, används sällan för matchning |
| YourOrderNumber | Tillgänglig endast på fakturor, kan inte användas för orderfiltrering |
I praktiken innehåller ExternalInvoiceReference1 butikens order-ID i den stora majoriteten av Shopify–Fortnox-integrationer, med ExternalInvoiceReference2 som reserv. Du kan verifiera vad som faktiskt lagras på dina fakturor genom att titta på en exempelfaktura på Junipeers Entiteter-sida eller i Loggarna.
Hur du konfigurerar utbetalningsreferensmatchning
Navigera till dina PSP-integrationsinställningar och öppna Fortnox Allmänna inställningar under utbetalningsflödet.
Steg 1 — Kontrollera vad som finns på din Fortnox-faktura
Verifiera vilka referensvärden som faktiskt lagras på dina Fortnox-fakturor innan du konfigurerar något. Det snabbaste sättet är att titta på en nylig faktura på Junipeers Loggar eller Entiteter-sida och kontrollera Fortnox-dokumentet. Leta efter:
Är
ExternalInvoiceReference1populerat? Vad innehåller det — ett Shopify order-ID, en PSP-referens eller något annat?Är
ExternalInvoiceReference2populerat? Vad innehåller det?
Om du kan se värdena, notera dem — det berättar vilket fält din orderkoppling skriver referenser till.
Steg 2 — Ange Utbetalningsreferensfält
Ange Utbetalningsreferensfält till det fält som innehåller referensen som PSP:en skickar i sin utbetalningsrapport. Detta är vanligtvis butikens order-ID — så om ditt Shopify order-ID lagras i ExternalInvoiceReference1, välj det.
Steg 2b — Ange reserv-Utbetalningsreferensfält (valfritt)
Om det primära fältet inte hittas eller inte matchar, kommer Junipeer att försöka med reserv-Utbetalningsreferensfältet. Ange detta till ExternalInvoiceReference2 som ett säkerhetsnät.
Inställningar → Allmänna inställningar
Steg 3 — Bestäm om du vill använda Checkout-ID som utbetalningsreferens
Den här kryssrutan är bara relevant om du skapar ordrar utanför betalningsleverantörskopplingen. Till exempel om ordrarna ursprungligen hamnar i Shopify. I sådana fall, se till att konfigurera detta:
Inställningar → Utbetalning
Diagnostisera "ingen faktura hittades"-fel
Det här felet betyder att Junipeer tog emot en utbetalningstransaktion från PSP:en men inte kunde hitta en matchande faktura i Fortnox. De vanligaste orsakerna:
Fel fält valt — Utbetalningsreferensfältet är inställt på ett fält som är tomt eller innehåller en annan referens än vad PSP:en skickar
Referensmismatch — PSP:en skickar sitt eget interna ID (t.ex. Qliro OrderID) men Junipeer söker efter ett butikens order-ID (eller vice versa)
Faktura inte skapad ännu — utbetalningen anlände innan ordern synkroniserades och fakturan skapades i Fortnox
Orderkopplingen skriver inte referensen — e-handelskopplingen populerar inte
ExternalInvoiceReference1alls, eller skriver till ett annat fält än förväntat
Hur du felsöker:
Öppna den misslyckade uppgiften i Junipeer Loggar och notera referensvärdet i felmeddelandet (t.ex.
ExternalInvoiceReference1=256576226)Gå till Junipeer Entiteter → Fakturor och sök efter det referensvärdet — finns fakturan?
Om fakturan finns är fältvalet fel. Om den inte finns kan ordern inte ha synkroniserats ännu eller referensen skrevs aldrig
Öppna en exempelfaktura i Fortnox i rådata-vyn och kontrollera vilka fält som är populerade och med vilka värden — detta berättar exakt vilket fält du ska konfigurera
Ytterligare inställningar
Använd Payment ID som utbetalningsreferens (Qliro-specifikt)
Vissa PSP:er (framför allt Qliro) identifierar transaktioner med ett PaymentId snarare än en handlarreferens. Om aktiverat kommer Junipeer att använda PaymentId (vanligtvis Qliro OrderID) som referensvärde när fakturan söks upp, istället för handlarreferensen.
När du ska aktivera detta: "Vissa PSP:er identifierar transaktioner med ett PaymentId snarare än en handlarorderreferens. Inställningsbeskrivningen i Junipeer anger Qliro OrderID som ett typiskt exempel, men detta beteende är inte exklusivt för Qliro."
Sök efter utbetalningsreferensen på ordern (vs. faktura)
Som standard söker Junipeer efter utbetalningsreferensen på fakturan. Om du aktiverar den här inställningen kommer den istället att söka på order-posten i Fortnox, och sedan hitta den länkade fakturan därifrån.
Detta är användbart om referenser lagras på ordern men inte förs vidare till fakturan i din Fortnox-konfiguration.
Bokför fakturabetalning
När aktiverat bokför Junipeer automatiskt fakturabetalningen i Fortnox när utbetalningen matchas. Detta krävs om du vill att fakturor ska markeras som betalda automatiskt. Lämna detta aktiverat i de flesta standardkonfigurationer.
För Qliro-specifik konfiguration, se Qliro ↔ Specter — konfigurationsguide. För allmän PSP-konfiguration, se Ansluta betaltjänster till Junipeer. För felsökning, kontakta support@junipeer.io.