Checkout til Miva

Inden for 24 timer efter tilmelding kontakter en dedikeret onboarding-repræsentant dig for at starte en skræddersyet integrationsproces.

Vigtigt: Trinene nedenfor er til reference, og du guides gennem dem af din onboarding-repræsentant.

1. Download modulet fra Miva App Store, eller anmod om filen zonos.mvc direkte fra Zonos.
2. Gå i din Miva-administration til Domain Settings -> Modules -> Add Module, upload filen zonos.mvc, og klik Add.

3. Gå til Settings -> Modules, find Zonos, og klik Install. Bekræft, at den vises som Installed.

Gå i Miva til Users -> API Tokens, og klik Add API Token. Konfigurer det som følger:

• Name: Zonos Checkout
• Allowed IP Addresses: 0.0.0.0/0, ::/0
• Signature: Require Signature with Key -- klik Generate for at oprette en signeringsnøgle
• Timestamp: Require Timestamp Within 30 seconds

På den næste skærm skal du aktivere Customer Service & Sales for at give tokenet mulighed for at oprette og ændre ordrer. Klik Save.

Gå til Checkout-modulet i Miva via Miva -> Utility Settings -> Zonos, og udfyld derefter følgende felter:

1. Store ID: Kopiér dit Zonos-kontonummer fra Dashboard -> Settings -> Account -> Integrations.
2. Zonos API Key: Din hemmelige API-nøgle (del aldrig denne).
3. Zonos Public Key: Din offentlige nøgle.
4. Store Currency: Din butiks basisvaluta (f.eks. USD).
5. Environment: Vælg Live til produktion eller Test til test.
6. Checkout Button Selector: CSS-selector for din checkout-knap (eksempel: a[href*="checkout.html"]).
7. Hidden Selectors: Til at skjule indenlandske betalingsmuligheder og andre detaljer, der ikke er relevante for internationale kunder.
8. Import Orders: Markér for automatisk at importere gennemførte Zonos-ordrer til Miva-administrationen. Dette kræver, at webhooks registreres i næste trin.

Klik Update oppe til højre for at gemme, før du fortsætter.

Ordrer importeres via webhook i 10.x-modulet. Tidligere moduludgaver brugte i stedet en order success URL/endpoint.

Når du har gemt dine indstillinger, skal du klikke på Register Webhooks. Dette forbinder din butik med Zonos, så gennemførte ordrer automatisk importeres, annulleringer synkroniseres, og forsendelsesopdateringer skubbes tilbage til Miva.

Webhooks skal registreres, før ordreimport, annulleringssynkronisering og forsendelsesopdateringer fungerer. Afkrydsningsfeltet Import Orders kræver, at webhooks er registreret.

Rul ned for at udfylde de resterende felter:

1. Miva API Token: Access Token fra det API-token, du oprettede i trinnet Opret et API-token.
2. Miva API Signature: Signing Key fra samme API-token.
3. Image Type: Vælger, hvilken produktbilledstørrelse der vises i Zonos-checkouten (Main fungerer for de fleste butikker).
4. Additional Field Mappings: Map eventuelt Miva-brugerdefinerede felter til Zonos-attributter/metadata (farve, materiale, størrelse osv.). Vi anbefaler at mappe HS code, hvis du har angivet produktspecifikke HS-koder i dine Miva-produktlister. Dette er ikke nødvendigt for at generere et told- og skattequote, da vi kan bruge produktspecifikke HS-koder, du har angivet i Catalog, eller din standard HS-kode. Det anbefales dog; nøjagtigheden af landed cost-beregninger stiger markant med korrekt klassificerede produkter. For at mappe et felt i Miva skal du oprette et brugerdefineret felt til HS-koden og derefter mappe det under Utility Settings -> Zonos.

Klik Update for at gemme alle indstillinger.

Nu hvor du har sat din konto og dit modul op, er du klar til at teste ved at:

• Teste forsendelsestilbud
• Afgive en testordre på dit site
• Teste ordreflow gennem dine systemer
• Teste dit website

Lær, hvordan du kører disse tests. Du skal indstille modulets Environment-felt til Test, mens du tester.

Når testen er gennemført, er du klar til at gå live! Indstil Environment til Live, bekræft, at dine Zonos-credentials er korrekte, og sørg for, at webhooks er registreret på din live-butik.

1. Gå til dashboard.zonos.com -> Hello -> Hello Settings.
2. Aktivér Currency behavior.
3. Indtast den CSS-selector, der målretter dine produktpriselementer (f.eks. .price).

Zonos Hello konverterer og viser automatisk priser i kundens lokale valuta, når dette er aktiveret.

Forsendelsesdimensioner, oprindelsesland og HS-kode angivet i Miva-kataloget mappes automatisk over til Zonos og bruges til landed cost-/forsendelsesquotes, hvis de er udfyldt. Der er ikke behov for yderligere konfiguration af mapping.

Hvis din butik sælger konfigurerbare produkter, hvor alle varianter deler et enkelt SKU, gemmer Mivas standard Product Shipping Rules ét sæt dimensioner pr. produkt, så alle konfigurationer behandles som samme størrelse, uanset hvad kunden valgte.

Miva og Zonos understøtter dimensioner på variantniveau, men det kræver, at hver variant sættes op individuelt. Det kan være upraktisk for butikker med hundreder eller tusinder af konfigurationer, der ikke mappes til diskrete varianter.

Denne funktion løser det ved at læse dimensioner pr. konfiguration direkte fra kurven ved checkout og bruge den brugerdefinerede logik, din butik allerede har på plads, til at beregne dem -- for eksempel ved at udtrække dimensioner fra produktbeskrivelsen.

Krav

• Din butik skal allerede udfylde brugerdefinerede dimensionskolonner på kurvevarer, når varer tilføjes til kurven (håndteres på Miva-siden, uden for Zonos-modulets omfang).
• Du skal kende de nøjagtige kolonnenavne, du bruger.

Konfiguration

Indtast disse kolonnenavne i de tre tilsvarende felter i Zonos-modulets administration. Lad dem stå blanke for at falde tilbage på standard Product Shipping Rules -- funktionen er fuldt opt-in og påvirker ikke butikker, der ikke bruger den.

Når en forsendelsesetiket oprettes, eller et trackingnummer indtastes i Zonos Dashboard, skubbes trackingnummeret og forsendelsesstatussen automatisk til den tilsvarende ordre i Miva-administrationen. Dette kræver, at webhooks er registreret (se trinnet Registrer webhooks ovenfor).

Tracking kan også indtastes direkte i Miva. Brug dialogen Enter Tracking Number på en Zonos-ordre -- trackingnummeret og forsendelsesstatussen synkroniseres automatisk tilbage til Zonos Dashboard.

Fejlfindingsloggen er tilgængelig i Miva-administrationen under indstillingerne for Zonos-modulet. Den registrerer hele livscyklussen for hver ordrehændelse, modulet behandler -- importer, trackingsynkroniseringer, annulleringer og udgående annulleringsanmodninger til Zonos -- inklusive både succeser og fejl.

Hver post indeholder Zonos-ordre-ID'et, Miva-ordre-ID'et og, hvor relevant, kundespecifikke detaljer såsom fejlsvaret fra Miva- eller Zonos-API'et. Det gør den til den mest komplette informationskilde til at diagnosticere problemer.

Loggen gemmer kun de seneste 500 linjer. Ældre poster arkiveres ikke, så tjek den hurtigt efter et problem opstår -- tidligere hændelser kan allerede være overskrevet.

Offentlig fejllog (login ikke nødvendigt) 

En anden, offentligt tilgængelig log er tilgængelig via en direkte URL -- login til Miva-administrationen er ikke nødvendigt. Den registrerer kun fejl (ingen succeser) og indeholder ingen kunde-PII eller følsomme data. Hver post er præfikset med modulversionen (f.eks. [v10.09]) til hurtig identifikation.

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

Eksempel:

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 returneres i metadata-arrayet i API-svaret for alle dashboard-ordrer.

Alle betalingsrefusioner skal behandles direkte via Zonos-dashboardet. Knapperne Refund, Capture og Void i Miva er med vilje ikke tilgængelige for Zonos-importerede ordrer. Refusioner behandlet i Zonos opdaterer ikke automatisk betalingsbeløbene på den tilsvarende Miva-ordre -- Miva-ordren bevarer de oprindelige opkrævede beløb og holdes ikke synkroniseret med refusionsaktivitet i Zonos.

Ved ordreannullering afhænger adfærden af ordrens aktuelle status:

• Open (endnu ikke afsendt): Annullering i Miva annullerer også ordren i Zonos og ophæver betalingsautorisationen. Fordi Zonos ikke opkræver betaling, før en ordre afsendes, opkræves kunden aldrig, og der kræves ingen separat refusion.
• Shipped eller Completed: Annullering i Miva markerer Miva-ordren som annulleret, men Zonos afviser annulleringen, fordi ordren allerede er blevet leveret og ikke længere kvalificerer til automatisk annullering. I dette tilfælde tilføjes en note, der kun er synlig for administratorer, til Miva-ordren -- kun synlig for butikkens medarbejdere og aldrig for kunden -- som forklarer, at ordren skal håndteres i Zonos. Der sendes også en e-mailnotifikation til butikskontoens primære e-mailadresse for at gøre forhandleren opmærksom på at handle i Zonos-dashboardet, hvor de manuelt kan behandle en eventuel refusion.

Symptom: Ordrer gennemføres i Zonos Checkout og vises i Zonos-dashboardet, men der sker ikke noget i Miva-administrationen.

Årsag: Zonos sender en ORDER_CREATED-webhook (HTTP POST) til din butiks /mm5/json.mvc-endpoint. På dev-sites blokerer sikkerhed på serverniveau ofte denne anmodning, før den når Miva. Almindelige årsager:

• HTTP Basic Auth -- Hvis dev-sitet har en adgangskodeprompt (Plesk, cPanel, .htaccess osv.), afvises webhooken med en 401 Unauthorized. Whitelist Zonos' IP-adresser i din .htaccess- eller Plesk-konfiguration, så de omgår adgangskodeprompten.
• Cloudflare WAF / IP Access Rules -- Hvis sitet proxyes gennem Cloudflare, kan dets sikkerhedsregler blokere POST-anmodningen, før den når din server. Tilføj en WAF-regel, der tillader POST-anmodninger, hvor URL-stien indeholder /mm5/json.mvc, eller whitelist Zonos' IP-adresser direkte i Cloudflares IP Access Rules.
• Serverniveau-IP-allowlist -- Hvis dev-sitet kun tillader trafik fra specifikke IP-adresser (almindeligt på staging-miljøer, der er låst til kontor- eller platform-IP'er), afvises Zonos' webhook-anmodninger stille uden svar. Tilføj alle Zonos' webhook-leverings-IP'er til din servers allowlist (Plesk IP Access Restriction Manager, cPanel IP Blocker eller dine firewall-/hostingpanel-sikkerhedsregler).

Zonos' webhook-leverings-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

Dette påvirker typisk kun dev-/staging-sites -- produktions-Miva-sites er normalt offentlige og kræver ikke IP-whitelisting. Kontakt din hostingudbyder eller Miva-support, hvis du er i tvivl om, hvordan du konfigurerer dette.

Produktoplysninger kan påvirke told- og skattebeløb og forsendelsesomkostninger. Jo flere produktoplysninger du giver Zonos, jo mere præcist bliver det returnerede quote. Zonos kan generere et quote, selv når disse oplysninger ikke er tilgængelige, men anbefaler at angive følgende nøgleproduktdetaljer for at forbedre nøjagtigheden:

• Vægt: Vægt påvirker dine forsendelsesomkostninger, hvilket kan påvirke told eller skat. Vægte i dine Miva-produktlister bruges automatisk af Zonos, når de findes.
• Dimensioner: Dimensioner kan påvirke dine forsendelsesomkostninger, hvilket kan påvirke told eller skat. Zonos kan bruge produktdimensioner (længde, bredde og højde) sat på hvert produkt i Miva, men du skal mappe dem i Zonos-appen for korrekt integration.
• HS-koder: HS-koder påvirker toldsatser og kan nogle gange påvirke skatter. Zonos kan bruge HS-koderne sat i dine produktlister i Miva, men du skal mappe HS-kodefeltet i Zonos-appen.
• Oprindelsesland: Et produkts oprindelsesland påvirker toldsatser og kan påvirke skatter. Miva kan ikke sende oprindelseslandet for dine produkter til Zonos, så de skal tilføjes via Zonos Catalog.

Produktdetaljer sendt til Zonos af Miva 

Bemærk: Alternativt kan du indtaste nogen af ovenstående oplysninger i Catalog og tilsidesætte oplysningerne gemt og sendt fra Miva.

Læs mere om produktoplysninger pr. platform.