Checkout för Miva

Inom 24 timmar efter registreringen kontaktar en dedikerad onboarding-representant er för att starta en skräddarsydd integrationsprocess.

Viktigt: Stegen nedan är för er referens och ni kommer att vägledas genom dem av er onboarding-representant.

1. Ladda ner modulen från Miva App Store, eller begär filen zonos.mvc direkt från Zonos.
2. I er Miva-admin går ni till Domain Settings -> Modules -> Add Module, laddar upp filen zonos.mvc och klickar på Add.

3. Gå till Settings -> Modules, hitta Zonos och klicka på Install. Bekräfta att det visas som Installed.

I Miva går ni till Users -> API Tokens och klickar på Add API Token. Konfigurera enligt följande:

• Name: Zonos Checkout
• Allowed IP Addresses: 0.0.0.0/0, ::/0
• Signature: Require Signature with Key -- klicka på Generate för att skapa en signeringsnyckel
• Timestamp: Require Timestamp Within 30 seconds

På nästa skärm aktiverar ni Customer Service & Sales för att tillåta token att skapa och ändra beställningar. Klicka på Save.

Navigera till Checkout-modulen i Miva genom att gå till Miva -> Utility Settings -> Zonos, och fyll sedan i följande fält:

1. Store ID: Kopiera ert Zonos-kontonummer från Dashboard -> Settings -> Account -> Integrations.
2. Zonos API Key: Er hemliga API-nyckel (dela aldrig denna).
3. Zonos Public Key: Er publika nyckel.
4. Store Currency: Er butiks basvaluta (t.ex. USD).
5. Environment: Välj Live för produktion eller Test för testning.
6. Checkout Button Selector: CSS-väljare för er checkout-knapp (exempel: a[href*="checkout.html"]).
7. Hidden Selectors: För att dölja inhemska betalningsalternativ och andra detaljer som kanske inte är relevanta för internationella kunder.
8. Import Orders: Markera för att automatiskt importera slutförda Zonos-beställningar till Miva-admin. Detta kräver att webhooks registreras i nästa steg.

Klicka på Update längst upp till höger för att spara innan ni fortsätter.

Beställningar importeras via webhook i modul 10.x. Tidigare modulversioner använde istället en URL/endpoint för orderbekräftelse.

Efter att ni sparat era inställningar klickar ni på Register Webhooks. Detta kopplar er butik till Zonos så att slutförda beställningar importeras automatiskt, avbokningar synkroniseras och fraktuppdateringar skickas tillbaka till Miva.

Webhooks måste registreras innan orderimport, synkronisering av avbokningar och fraktuppdateringar fungerar. Kryssrutan Import Orders kräver att webhooks är registrerade.

Skrolla ner för att fylla i de återstående fälten:

1. Miva API Token: Access Token från den API-token ni skapade i steget Skapa en API-token.
2. Miva API Signature: Signeringsnyckeln (Signing Key) från samma API-token.
3. Image Type: Väljer vilken produktbildstorlek som visas i Zonos checkout (Main fungerar för de flesta butiker).
4. Additional Field Mappings: Mappa valfritt Miva-anpassade fält till Zonos attribut/metadata (färg, material, storlek, etc.). Vi rekommenderar att ni mappar HS code om ni har ställt in produktspecifika HS-koder i era Miva-produktlistor. Detta krävs inte för att producera en tull- och skatteoffert eftersom vi kan använda produktspecifika HS-koder som ni har angett i Catalog eller använda er standard-HS-kod. Det rekommenderas dock; noggrannheten i landed cost-beräkningar ökar avsevärt med korrekt klassificerade produkter. För att mappa ett fält i Miva, skapa ett anpassat fält för HS-koden och mappa det sedan under Utility Settings -> Zonos.

Klicka på Update för att spara alla inställningar.

Nu när ni har konfigurerat ert konto och er modul är ni redo att testa genom att göra följande:

• Testa fraktofferter
• Lägg en testbeställning på er webbplats
• Testa orderflödet genom era system
• Testa er webbplats

Lär er hur ni kör dessa tester. Ni behöver ställa in modulens Environment-fält till Test under testningen.

När testningen är klar är ni redo att gå live! Ställ in Environment till Live, bekräfta att era Zonos-autentiseringsuppgifter är korrekta och säkerställ att webhooks är registrerade på er live-butik.

1. Gå till dashboard.zonos.com -> Hello -> Hello Settings.
2. Slå på Currency behavior.
3. Ange CSS-väljaren som riktar in sig på era produktpriselement (t.ex. .price).

Zonos Hello konverterar och visar automatiskt priser i kundens lokala valuta när detta är aktiverat.

Fraktdimensioner, ursprungsland och HS-kod som är inställda i Miva-katalogen mappas automatiskt till Zonos och används för landed cost-/fraktofferter om de är ifyllda. Ingen ytterligare mappning krävs för att konfigurera detta.

Om er butik säljer konfigurerbara produkter där alla varianter delar ett enda SKU, lagrar Mivas standardregler för produktfrakt en uppsättning dimensioner per produkt, så att varje konfiguration behandlas som samma storlek oavsett vad kunden valde.

Miva och Zonos stöder dimensioner på variantnivå, men det kräver att varje variant konfigureras individuellt. Detta kan vara opraktiskt för butiker med hundratals eller tusentals konfigurationer som inte motsvarar diskreta varianter.

Den här funktionen löser det genom att läsa dimensioner per konfiguration direkt från varukorgen vid utcheckning, med hjälp av vilken anpassad logik er butik redan har på plats för att beräkna dem -- till exempel genom att tolka dimensioner ur produktbeskrivningen.

Krav

• Er butik måste redan fylla i anpassade dimensionskolumner på varukorgsartiklar när artiklar läggs till i varukorgen (hanteras på Miva-sidan, utanför Zonos-modulens omfattning).
• Ni behöver känna till de exakta kolumnnamnen ni använder.

Konfiguration

Ange dessa kolumnnamn i de tre motsvarande fälten i Zonos-modulens admin. Lämna dem tomma för att falla tillbaka på standardreglerna för produktfrakt -- funktionen är helt valfri och påverkar inte butiker som inte använder den.

När en fraktetikett skapas eller ett spårningsnummer anges i Zonos Dashboard skickas spårningsnumret och leveransstatusen automatiskt till motsvarande beställning i Miva-admin. Detta kräver att webhooks är registrerade (se steget Registrera webhooks ovan).

Spårning kan också anges direkt i Miva. Använd inmatningsdialogen Enter Tracking Number på valfri Zonos-beställning -- spårningsnumret och leveransstatusen synkroniseras automatiskt tillbaka till Zonos Dashboard.

Felsökningsloggen är tillgänglig i Miva-admin, under Zonos-modulens inställningar. Den registrerar hela livscykeln för varje orderhändelse som modulen bearbetar -- importer, spårningssynkroniseringar, avbokningar och utgående avbokningsbegäranden till Zonos -- inklusive både lyckade och misslyckade händelser.

Varje post innehåller Zonos-order-ID, Miva-order-ID och, där relevant, kunduppgifter såsom felmeddelandet från Miva- eller Zonos-API:et. Detta gör den till den mest kompletta informationskällan för att felsöka problem.

Loggen behåller endast de senaste 500 raderna. Äldre poster arkiveras inte, så kontrollera den snarast efter att ett problem uppstått -- tidigare händelser kan redan ha skrivits över.

Publik felsökningslogg (inloggning krävs inte) 

En andra, publik logg är tillgänglig via direkt URL -- ingen inloggning i Miva-admin krävs. Den registrerar endast fel (inga lyckade händelser) och innehåller ingen kund-PII eller känslig data. Varje post inleds med modulversionen (t.ex. [v10.09]) för snabb identifiering.

URL-format:

https://[store-domain]/mm5/json.mvc?Store_Code=[miva_store_code]&Function=Module&Module_Code=igs&Session_Type=runtime&Module_Function=JSON_WebHook&publiclog=1

Exempel:

https://dts4509.mivamerchantdev.com/mm5/json.mvc?Store_Code=Test&Function=Module&Module_Code=igs&Session_Type=runtime&Module_Function=JSON_WebHook&publiclog=1

Store Code: miva_store_code returneras i metadataarrayen i API-svaret för alla Dashboard-beställningar.

Alla betalningsåterbetalningar måste behandlas direkt via Zonos Dashboard. Knapparna Refund, Capture och Void i Miva är inte tillgängliga för Zonos-importerade beställningar, och detta är avsiktligt. Eventuella återbetalningar som behandlas i Zonos uppdaterar inte automatiskt betalningsbeloppen på motsvarande Miva-beställning -- Miva-beställningen behåller de ursprungligt fångade beloppen och hålls inte synkroniserad med återbetalningsaktivitet i Zonos.

För orderavbokningar beror beteendet på beställningens aktuella status:

• Open (ej skickad ännu): Att avboka den i Miva avbokar den även i Zonos och upphäver betalningsauktoriseringen. Eftersom Zonos inte tar betalt förrän en beställning skickas debiteras kunden aldrig och ingen separat återbetalning krävs.
• Shipped eller Completed: Att avboka i Miva markerar Miva-beställningen som avbokad, men Zonos avvisar avbokningen eftersom beställningen redan har levererats och inte längre kvalificerar för automatisk avbokning. I detta fall läggs en anteckning till på Miva-beställningen som endast är synlig för butikspersonal och aldrig för kunden -- den förklarar att beställningen behöver hanteras i Zonos. Ett e-postmeddelande skickas också till butikskontots primära e-postadress för att uppmärksamma handlaren på att vidta åtgärder i Zonos Dashboard, där de manuellt kan behandla en eventuell återbetalning.

Symptom: Beställningar slutförs i Zonos Checkout och visas i Zonos Dashboard, men inget visas i Miva-admin.

Orsak: Zonos skickar en ORDER_CREATED-webhook (HTTP POST) till er butiks /mm5/json.mvc-endpoint. På dev-webbplatser blockerar serverns säkerhet ofta denna begäran innan den når Miva. Vanliga orsaker:

• HTTP Basic Auth -- Om dev-webbplatsen har en lösenordsprompt (Plesk, cPanel, .htaccess, etc.) avvisas webhooken med ett 401 Unauthorized-fel. Vitlista Zonos IP-adresser i er .htaccess- eller Plesk-konfiguration så att de kringgår autentiseringsprompten.
• Cloudflare WAF/IP-åtkomstregler -- Om webbplatsen är proxad genom Cloudflare kan dess säkerhetsregler blockera POST-begäran innan den når er server. Lägg till en WAF-regel som tillåter POST-begäranden där URL-sökvägen innehåller /mm5/json.mvc, eller vitlista Zonos IP-adresser direkt i Cloudflares IP-åtkomstregler.
• IP-vitlista på servernivå -- Om dev-webbplatsen begränsar trafik till specifika IP-adresser (vanligt på staging-miljöer som är låsta till kontors- eller plattforms-IP:er) avvisas Zonos webhook-begäranden tyst utan svar. Lägg till alla Zonos webhook-leverans-IP:er i serverns vitlista (Plesk IP Access Restriction Manager, cPanel IP Blocker eller era brandväggs-/hosting-panelens säkerhetsregler).

Zonos webhook-leverans-IP:er

195.85.106.100/32
67.207.37.24/29
18.118.243.230/32
18.191.115.116/32
18.216.243.49/32
18.218.198.53/32
18.221.118.18/32
18.223.39.35/32
3.128.123.176/32
3.132.179.92/32
3.138.165.252/32
3.19.11.176/32
3.22.153.63/32
52.15.215.38/32

Detta påverkar vanligtvis endast dev-/staging-webbplatser -- produktions-Miva-webbplatser är oftast publika och behöver ingen IP-vitlistning. Om ni är osäkra på hur ni konfigurerar detta, kontakta er webbhotellsleverantör eller Mivas support.

Produktinformation kan påverka beloppet för tullar och skatter samt fraktkostnaden. Ju mer produktinformation ni tillhandahåller till Zonos, desto mer precis blir den returnerade offerten. Zonos kan generera en offert även när denna information saknas, men rekommenderar att ni tillhandahåller följande viktiga produktdetaljer för att förbättra noggrannheten:

• Vikt: Vikten påverkar er fraktkostnad, vilket kan påverka tullar eller skatter. Vikter i era Miva-produktlistor används automatiskt av Zonos när de finns.
• Mått: Mått kan påverka er fraktkostnad, vilket kan påverka tullar eller skatter. Zonos kan använda produktmått (längd, bredd och höjd) som är inställda på varje produkt i Miva, men ni måste mappa dem i Zonos-appen för korrekt integration.
• HS-koder: HS-koder påverkar tullsatser och kan ibland påverka skatter. Zonos kan använda HS-koderna som är inställda i era produktlistor i Miva, men ni måste mappa HS-kodfältet i Zonos-appen.
• Ursprungsland: En produkts ursprungsland påverkar tullsatser och kan påverka skatter. Miva kan inte skicka ursprungslandet för era produkter till Zonos, så de måste läggas till med Zonos Catalog.

Produktdetaljer som skickas till Zonos av Miva 

Obs: Alternativt kan ni ange någon av ovanstående information i Catalog, vilket åsidosätter informationen som lagras och skickas från Miva.

Läs mer om produktinformation per plattform.