> ## Documentation Index
> Fetch the complete documentation index at: https://www.zippendo.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Toimituslaskennan pikaopas

> Näytä Zippendon toimitussääntöjesi toimitushinnat kassalla omassa verkkokaupassasi toimituslaskennan API:n avulla.

Toimituslaskennan API:n avulla oman verkkokauppasi kassa voi näyttää asiakkaillesi Zippendossa määrittämäsi toimitusvaihtoehdot ja hinnat. Lähetät ostoskorin ja toimitusosoitteen, ja Zippendo vastaa yhdellä hinnalla jokaisesta [toimitussäännöstäsi](/docs/fi/settings/shipping-rules), joka sopii kyseiseen ostoskoriin.

## Milloin sitä käytetään

* Mukautettu tai headless-verkkokauppa, jolla on oma kassa
* Sovellus, joka tarvitsee toimitushinnat ennen lähetyksen luomista
* Kassa, jossa yksi kiinteä hinta ei riitä

Shopify ja WooCommerce eivät tarvitse tätä API:a: Zippendo tarjoaa niiden kassahinnat puolestasi. Katso [Toimitushinnat](/docs/fi/how-to/shipping-quotes). Käytä API:a, kun **oma** kassasi tarvitsee hinnat.

## Pyyntö

Lähetä ostoskori ja määränpää osoitteeseen `POST /orgs/{orgId}/shipping-quote`:

```bash theme={null}
curl -X POST https://api.zippendo.com/orgs/{orgId}/shipping-quote \
  -H "Authorization: Bearer zipp_YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "destination": {
      "country": "DK",
      "postalCode": "2100",
      "city": "Copenhagen"
    },
    "items": [
      {
        "name": "T-shirt",
        "quantity": 1,
        "grams": 250,
        "price": 29900
      }
    ],
    "currency": "DKK"
  }'
```

`price` on yksikköhinta pienimmässä valuuttayksikössä (øre DKK:lle, sentti EUR:lle), ja `grams` on yksikön paino. Lisää `totalPriceCents` ostoskorin alennusten jälkeisellä loppusummalla, jos toimitussääntösi katsovat tilauksen arvoa.

## Vastaus

```json theme={null}
{
  "rates": [
    {
      "serviceName": "Standard DK",
      "serviceCode": "postnord:PNL13:rule_01HZX9K2QF",
      "totalPrice": "3900",
      "currency": "DKK",
      "carrierName": "PostNord",
      "carrierSlug": "postnord",
      "productId": "PNL13",
      "shippingRuleId": "rule_01HZX9K2QF"
    }
  ]
}
```

Zippendo tarkistaa jokaisen toimitussäännön, jonka **Vastaanottajamaat** sisältävät `destination.country`-arvon. Jokaisesta säännöstä, jonka **Säännön ehdot** sopivat ostoskoriin, tulee yksi hinta, joka nimetään säännön mukaan ja hinnoitellaan sopivan ehdon mukaan (alhaisin hinta, jos useampi sopii). `totalPrice` on pienimmässä valuuttayksikössä merkkijonona. Kun mikään sääntö ei sovi, saat `{ "rates": [] }`, joten näytä kassalla tällöin varavaihtoehto.

Täydellinen kenttäluettelo on sivulla [Toimitushinnat](/docs/fi/how-to/shipping-quotes) ja [API-viitteessä](/docs/api-reference/overview).

## Vaatimukset

* Vähintään yksi **yhdistetty kuljetusyhtiö**
* Vähintään yksi **toimitussääntö** maille, joihin lähetät. Säännöt päättävät, mitkä hinnat näkyvät ja mitä ne maksavat.
* **API-token**, jolla on oikeus `read:shipping_rules`. Katso [REST API -pikaopas](/docs/fi/quickstarts/rest-api).

## Seuraavat vaiheet

<CardGroup cols={2}>
  <Card title="Toimitussäännöt" icon="route" href="/docs/fi/settings/shipping-rules">
    Valitse, mitkä kuljetuspalvelut tarjotaan painon, arvon ja maan mukaan.
  </Card>

  <Card title="API-viite" icon="code" href="/docs/api-reference/overview">
    Täydelliset pyynnön ja vastauksen tiedot, leikkikentän kanssa.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.