Get a shipping quote

A shipping quote lets your webshop show your customers live shipping prices at checkout, based on your shipping rules. Zippendo does not host a checkout of its own: the prices appear in your webshop, through Shopify’s Zippendo Shipping, the Zippendo for WooCommerce plugin, or a call to the shipping quote API from your own storefront. Every price your customer sees comes from one of your shipping rules. Without a shipping rule for outbound shipments to the customer’s country, checkout shows no Zippendo prices. Step-by-step walkthrough (connect the webshop, pick the rules, test in the shop): Checkout. No prices showing: Shipping quote returns no rates.

The Test button on a shipping rule checks whether that rule would match a cart. It does not ask the carrier for a price. Zippendo has no preview of your checkout.

What you need first

Connect your webshop, or create an API token

Connect Shopify or WooCommerce under Order channels. For your own storefront, create an API token with View shipping rules.

Connect your carriers

See Carrier credentials. Each shipping rule uses a product from a connected carrier.

Add shipping rules for outbound shipments

Name each rule the way your customers should read it at checkout. Set the countries it ships to and any price or weight limits. See Shipping rule fields.

Shipping rules list with outbound GLS and PostNord rules — Your shipping rules are the shipping options checkout shows

Shopify: Checkout shipping rates

Open your Shopify order channel under Order channels. On the Orders & checkout tab, scroll to Checkout shipping rates. All Shopify settings: Shopify settings. Installing the app: Connect Shopify. The card says: Choose which shipping rules your customers can pick at Shopify checkout. If you choose none, every shipping rule that matches the receiver’s country is used. A shipping rule that delivers to service points shows each service point as its own rate.

Field	What to do
Shipping rules	Tick the rules Shopify should offer. Each row shows the rule’s name, its carrier and countries, and its description. With no rules yet, the card says No shipping rules yet. Create one under Shipping rules in the menu.
Service points at checkout	How many service points to show at checkout in total. They are split evenly between the shipping rules that deliver to a service point. A number from 1 to 20. The default is 6.
Save changes	Saves your choices. It is grayed out until you change something.

More about service points at checkout: Service points.

Checkout shipping rates with shipping rule checkboxes and Service points at checkout set to 6 — Checkout shipping rates: tick the rules Shopify should offer and set Service points at checkout

Register Zippendo Shipping with Shopify

Open the Connection & integration tab. On the Carrier service card:

Control	What it does
Check carrier service → Check status	Checks whether Zippendo is registered with Shopify for live shipping prices. You see “1 carrier service found”, or No carrier service registered. Shipping rates will not show at checkout..
Register carrier service	Registers Zippendo with Shopify, or registers it again. Needed for live shipping prices at checkout.

The card also reminds you: after registering, go to Shopify admin → Settings → Shipping and delivery and add “Zippendo Shipping” as a rate provider in your shipping zones.

Until Zippendo Shipping is added to your shipping zones in Shopify, your customers won’t see Zippendo prices, even if Check status finds the carrier service and your rules are ticked.

Shopify Connection & integration tab with the Carrier service card, Check status and Register carrier service — Carrier service: Check status and Register carrier service

Shopify stores without calculated shipping prices can instead link their own Shopify shipping method names to shipping rules. That doesn’t show live prices; it only puts the right rule on each order when it is imported. See the shipping method mapping on Shopify settings.

WooCommerce: Checkout token

WooCommerce shows live prices through the Zippendo for WooCommerce plugin and a Checkout token (it starts with zck_). Connect the webshop first: Connect WooCommerce. Open your WooCommerce order channel. On the Orders & checkout tab, find the Checkout token card: The Zippendo for WooCommerce plugin shows live shipping rates and service points at your checkout. Install the plugin, then paste this token into its settings.

Control	What it does
Download plugin	Downloads the latest plugin as a `.zip` file to install in WordPress.
Generate token	Creates your first token and shows it once.
Copy	Copies the token. You see Token copied to clipboard.
Replace token	Replaces the token. Zippendo asks: Replace the checkout token? Your current token stops working at once, and you need to paste the new one into the plugin.
Revoke	Turns the token off. Zippendo asks: Revoke the checkout token? The plugin will stop working until you generate a new one. You then see Checkout token revoked.

Right after you generate or replace the token, the card warns: Copy this token now. You won’t be able to see it again, because Zippendo does not keep a readable copy. Paste it into the plugin’s settings in WordPress. Once a token exists, the card shows when it was created. If something fails you see Couldn’t generate the checkout token or Couldn’t revoke the checkout token. The plugin asks Zippendo for prices with this token, both for shipping options and for nearby service points when the customer changes postcode. It does not use an API token. Test connection on the Connection tab only checks the WooCommerce keys used to import orders.

Checkout token card with the one-time warning, the zck_ token, Copy, Revoke and Replace token — Checkout token: copy the zck_ token once, then paste it into the plugin

Your own storefront: the shipping quote API

A custom order channel sends orders into Zippendo, but does not show prices at your checkout. To show live prices in a storefront you build yourself, call:

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

{orgId} is your organization’s ID, not the name in the app’s address bar. The token needs View shipping rules: Create an API token. Ready-made clients: SDKs. Try it in the API reference.

Request body

Field	Required	Notes
`destination.country`	Yes	Two-letter country code (ISO 3166-1 alpha-2), for example `DK`
`destination.postalCode`	No	For example `1620`
`destination.province`	No	State or province code
`destination.city`	No	For example `København`
`destination.address1` / `address2`	No	Street lines
`items`	Yes, at least one	The cart lines
`items[].name`	Yes	For example `Uld trøje`
`items[].quantity`	Yes	Whole number, 1 or more
`items[].grams`	Yes	Weight in grams, 0 or more
`items[].price`	Yes	Unit price in cents (øre), 0 or more
`items[].sku` / `productId` / `variantId`	No
`currency`	Yes	Three-letter currency code (ISO 4217), for example `DKK`
`totalPriceCents`	No	The cart total after discounts, in cents. Lets rules with an order value limit use the discounted total.

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

Zippendo adds up grams × quantity and price × quantity over the lines, then checks each shipping rule that ships to destination.country. Every matching rule becomes a rate. If no rule matches, you get { "rates": [] } with status 200, not an error.

Rate object

Field	What it is
`serviceName`	The rule’s name, as your customer should see it
`serviceCode`	`{carrierSlug}:{productId}:{shippingRuleId}`
`totalPrice`	Shipping price in cents, as a string
`currency`	Three-letter currency code
`description`	The rule’s description, if it has one
`carrierName` / `carrierSlug` / `productId`	The carrier and product of the rule
`shippingRuleId`	The rule that produced the rate
`minDeliveryDate` / `maxDeliveryDate`	Expected delivery dates, if the rule has them

An invalid country or body returns 400 with { error, message }, for example Invalid destination country. An unknown organization returns 404. Sample code: Shipping quotes quickstart.

How to test

Zippendo has no preview of your checkout. Test in your webshop:

Webshop	In Zippendo	In your webshop
Shopify	Tick the rules, set the number of service points, click Check status	Go through checkout once Zippendo Shipping is in your shipping zone
WooCommerce	Generate token	Paste the token into the plugin’s settings and fill a cart
Your own storefront	Test on a shipping rule (checks the rule only)	Call the shipping quote API with a sample cart

If a price is missing, check the rule’s Receiving countries, its weight and order value limits and its other settings before you suspect the carrier.

You are done when Shopify Checkout shipping rates has the rules you want (and Zippendo Shipping is in your shipping zone), or WooCommerce has an active Checkout token pasted into the plugin, or the shipping quote API returns rates for a sample cart.

Overview

Shipments

Orders & channels

Carriers

Connect a carrier

Connect an integration

Printing

Automation

Account

Search & dashboard

API & events

Get a shipping quote

What you need first