Hent en fraktprisforespørsel

Med en fraktprisforespørsel kan nettbutikken din vise kundene live fraktpriser i kassen, basert på fraktreglene dine. Zippendo har ingen egen kasse: prisene vises i nettbutikken din, gjennom Shopifys Zippendo Shipping, programtillegget Zippendo for WooCommerce, eller et kall til API-et for fraktprisforespørsler fra din egen butikkfront. Hver pris kunden ser, kommer fra en av fraktreglene dine. Uten en fraktregel for utgående sendinger til kundens land viser kassen ingen Zippendo-priser. Trinn-for-trinn-gjennomgang (koble til nettbutikken, velg reglene, test i butikken): Kasse. Ingen priser vises: Fraktprisforespørsel gir ingen priser.

Knappen Test på en fraktregel sjekker om regelen ville passet til en handlekurv. Den spør ikke transportøren om en pris. Zippendo har ingen forhåndsvisning av kassen din.

Hva du trenger først

Koble til nettbutikken din, eller opprett et API-token

Koble til Shopify eller WooCommerce under Ordrekanaler. For din egen butikkfront oppretter du et API-token med Se fraktregler.

Koble til transportørene dine

Se Legitimasjon for transportører. Hver fraktregel bruker et fraktprodukt fra en tilkoblet transportør.

Legg til fraktregler for utgående sendinger

Gi hver regel navnet kundene dine skal lese i kassen. Angi landene den sender til og eventuelle grenser for pris eller vekt. Se Felter i fraktregler.

Listen over fraktregler med utgående regler for GLS og PostNord — Fraktreglene dine er leveringsvalgene kassen viser

Shopify: Fraktpriser i kassen

Åpne Shopify-ordrekanalen din under Ordrekanaler. I fanen Ordrer og kasse blar du ned til Fraktpriser i kassen. Alle Shopify-innstillinger: Shopify-innstillinger. Installere appen: Koble til Shopify. Kortet sier: Velg hvilke fraktregler kundene kan velge i Shopify-kassen. Velger du ingen, brukes alle fraktregler som passer til mottakerens land. En fraktregel som leverer til hentesteder, viser hvert hentested som en egen pris.

Felt	Hva du gjør
Fraktregler	Merk av for reglene Shopify skal tilby. Hver rad viser navnet på regelen, transportøren og landene, og beskrivelsen. Når du ikke har noen regler ennå, sier kortet Ingen fraktregler ennå. Opprett en under Fraktregler i menyen.
Hentesteder i kassen	Hvor mange hentesteder som skal vises i kassen totalt. De fordeles likt mellom fraktreglene som leverer til et hentested. Et tall fra 1 til 20. Standard er 6.
Lagre endringer	Lagrer valgene dine. Den er grået ut til du endrer noe.

Mer om hentesteder i kassen: Hentesteder.

Fraktpriser i kassen med avmerkingsbokser for fraktregler og Hentesteder i kassen satt til 6 — Fraktpriser i kassen: merk av for reglene Shopify skal tilby og angi Hentesteder i kassen

Registrer Zippendo Shipping hos Shopify

Åpne fanen Tilkobling og integrasjon. På kortet Transportørtjeneste:

Kontroll	Hva den gjør
Sjekk transportørtjenesten → Sjekk status	Sjekker om Zippendo er registrert hos Shopify for live fraktpriser. Du ser «1 transportørtjeneste funnet», eller Ingen transportørtjeneste er registrert. Fraktpriser vises ikke i kassen..
Registrer transportørtjeneste	Registrerer Zippendo hos Shopify, eller registrerer den på nytt. Trengs for live fraktpriser i kassen.

Kortet minner deg også om: etter registreringen går du til Shopify admin → Settings → Shipping and delivery og legger til «Zippendo Shipping» som leverandør av fraktpriser i fraktsonene dine.

Før Zippendo Shipping er lagt til i fraktsonene dine i Shopify, ser ikke kundene dine Zippendo-priser, selv om Sjekk status finner transportørtjenesten og reglene dine er avmerket.

Fanen Tilkobling og integrasjon i Shopify med kortet Transportørtjeneste, Sjekk status og Registrer transportørtjeneste — Transportørtjeneste: Sjekk status og Registrer transportørtjeneste

Shopify-butikker uten beregnede fraktpriser kan i stedet koble sine egne Shopify-navn på leveringsmåter til fraktregler. Det viser ikke live priser; det legger bare den riktige regelen på hver ordre når den importeres. Se koblingen av leveringsmåter under Shopify-innstillinger.

WooCommerce: Kassetoken

WooCommerce viser live priser gjennom programtillegget Zippendo for WooCommerce og et Kassetoken (det starter med zck_). Koble til nettbutikken først: Koble til WooCommerce. Åpne WooCommerce-ordrekanalen din. I fanen Ordrer og kasse finner du kortet Kassetoken: Programtillegget Zippendo for WooCommerce viser fraktpriser og hentesteder i sanntid i kassen din. Installer programtillegget, og lim deretter inn dette tokenet i innstillingene for programtillegget.

Kontroll	Hva den gjør
Last ned programtillegget	Laster ned det nyeste programtillegget som en `.zip`-fil du kan installere i WordPress.
Generer token	Oppretter ditt første token og viser det én gang.
Kopier	Kopierer tokenet. Du ser Tokenet er kopiert til utklippstavlen.
Erstatt token	Erstatter tokenet. Zippendo spør: Erstatte kassetokenet? Det nåværende tokenet slutter å virke med en gang, og du må lime inn det nye i programtillegget.
Trekk tilbake	Slår av tokenet. Zippendo spør: Tilbakekalle kassetokenet? Programtillegget slutter å virke til du genererer et nytt. Du ser deretter Kassetokenet er tilbakekalt.

Rett etter at du har generert eller erstattet tokenet, advarer kortet: Kopier dette tokenet nå. Du får ikke se det igjen, fordi Zippendo ikke lagrer en lesbar kopi. Lim det inn i innstillingene for programtillegget i WordPress. Når et token finnes, viser kortet når det ble opprettet. Hvis noe mislykkes, ser du Kunne ikke generere kassetokenet eller Kunne ikke tilbakekalle kassetokenet. Programtillegget ber Zippendo om priser med dette tokenet, både for leveringsvalg og for hentesteder i nærheten når kunden endrer postnummer. Det bruker ikke et API-token. Test tilkoblingen i fanen Tilkobling sjekker bare WooCommerce-nøklene som brukes til å importere ordrer.

Kortet Kassetoken med engangsadvarselen, zck_-tokenet, Kopier, Tilbakekall og Erstatt token — Kassetoken: kopier zck_-tokenet én gang, og lim det deretter inn i programtillegget

Din egen butikkfront: API-et for fraktprisforespørsler

En egendefinert ordrekanal sender ordrer inn i Zippendo, men viser ikke priser i kassen din. For å vise live priser i en butikkfront du bygger selv, kaller du:

POST /orgs/{orgId}/shipping-quote
Authorization: Bearer zipp_YOUR_TOKEN

{orgId} er ID-en til organisasjonen din, ikke navnet i adressefeltet i appen. Tokenet trenger Se fraktregler: Opprett et API-token. Ferdige klienter: SDK-er. Prøv det i API-referansen.

Innhold i forespørselen

Felt	Påkrevd	Merknader
`destination.country`	Ja	Landkode med to bokstaver (ISO 3166-1 alpha-2), for eksempel `DK`
`destination.postalCode`	Nei	For eksempel `1620`
`destination.province`	Nei	Kode for delstat eller provins
`destination.city`	Nei	For eksempel `København`
`destination.address1` / `address2`	Nei	Gatelinjer
`items`	Ja, minst én	Linjene i handlekurven
`items[].name`	Ja	For eksempel `Uld trøje`
`items[].quantity`	Ja	Heltall, 1 eller mer
`items[].grams`	Ja	Vekt i gram, 0 eller mer
`items[].price`	Ja	Stykkpris i øre (cent), 0 eller mer
`items[].sku` / `productId` / `variantId`	Nei
`currency`	Ja	Valutakode med tre bokstaver (ISO 4217), for eksempel `DKK`
`totalPriceCents`	Nei	Totalen for handlekurven etter rabatter, i øre (cent). Lar regler med en grense for ordreverdi bruke totalen etter rabatt.

{
  "destination": {
    "country": "DK",
    "postalCode": "2100",
    "city": "Copenhagen"
  },
  "items": [
    {
      "name": "T-shirt",
      "quantity": 1,
      "grams": 250,
      "price": 29900
    }
  ],
  "currency": "DKK"
}

Zippendo summerer grams × quantity og price × quantity over linjene, og sjekker deretter hver fraktregel som sender til destination.country. Hver regel som passer, blir en pris. Hvis ingen regel passer, får du { "rates": [] } med status 200, ikke en feil.

Prisobjekt

Felt	Hva det er
`serviceName`	Navnet på regelen, slik kunden din skal se det
`serviceCode`	`{carrierSlug}:{productId}:{shippingRuleId}`
`totalPrice`	Fraktpris i øre (cent), som en streng
`currency`	Valutakode med tre bokstaver
`description`	Beskrivelsen av regelen, hvis den har en
`carrierName` / `carrierSlug` / `productId`	Transportøren og fraktproduktet til regelen
`shippingRuleId`	Regelen som ga prisen
`minDeliveryDate` / `maxDeliveryDate`	Forventede leveringsdatoer, hvis regelen har dem

Et ugyldig land eller innhold gir 400 med { error, message }, for eksempel Invalid destination country. En ukjent organisasjon gir 404. Eksempelkode: Hurtigstart for fraktprisforespørsler.

Slik tester du

Zippendo har ingen forhåndsvisning av kassen din. Test i nettbutikken din:

Nettbutikk	I Zippendo	I nettbutikken din
Shopify	Merk av for reglene, angi antall hentesteder, klikk Sjekk status	Gå gjennom kassen når Zippendo Shipping er i fraktsonen din
WooCommerce	Generer token	Lim tokenet inn i innstillingene for programtillegget og fyll en handlekurv
Din egen butikkfront	Test på en fraktregel (sjekker bare regelen)	Kall API-et for fraktprisforespørsler med en eksempelhandlekurv

Hvis en pris mangler, sjekker du Mottakerland for regelen, grensene for vekt og ordreverdi og de andre innstillingene før du mistenker transportøren.

Du er ferdig når Shopify-delen Fraktpriser i kassen har reglene du vil ha (og Zippendo Shipping er i fraktsonen din), eller WooCommerce har et aktivt Kassetoken limt inn i programtillegget, eller API-et for fraktprisforespørsler returnerer rates for en eksempelhandlekurv.

Relatert

Kasse: gjennomgang
Shopify-innstillinger / Koble til WooCommerce
Felter i fraktregler
Opprett et API-token
Velg et hentested
Fraktprisforespørsel gir ingen priser

Oversikt

Sendinger

Ordrer og kanaler

Transportører

Koble til en transportør

Koble til en integrasjon

Utskrift

Automatisering

Konto

Søk og dashboard

API og hendelser

Hent en fraktprisforespørsel

Hva du trenger først