> ## 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.
# Hae toimitushintatarjous
> Näytä reaaliaikaiset toimitushinnat kassallasi toimitussäännöistäsi - Shopifyn Kassan toimitushinnat, WooCommercen kassatoken ja toimitushintatarjous-API omalle verkkokaupallesi.
Toimitushintatarjouksen avulla verkkokauppasi voi näyttää asiakkaillesi reaaliaikaiset toimitushinnat kassalla toimitussääntöjesi perusteella. Zippendolla ei ole omaa kassaa: hinnat näkyvät verkkokaupassasi Shopifyn **Zippendo Shipping** -palvelun, **Zippendo for WooCommerce** -lisäosan tai oman verkkokauppasi toimitushintatarjous-API-kutsun kautta.
Jokainen asiakkaasi näkemä hinta tulee yhdestä [toimitussäännöstäsi](/docs/fi/how-to/shipping-rule-fields). Ilman toimitussääntöä lähteville lähetyksille asiakkaan maahan kassa ei näytä Zippendon hintoja.
Vaiheittainen opas (yhdistä verkkokauppa, valitse säännöt, testaa kaupassa): [Kassa](/docs/fi/tutorials/checkout). Hintoja ei näy: [Toimitushinnasto ei palauta hintoja](/docs/fi/knowledge-base/shipping-quote-no-rates).
Toimitussäännön **Testaa**-painike tarkistaa, täsmäisikö kyseinen sääntö ostoskoriin. Se ei kysy kuljetusyhtiöltä hintaa. Zippendossa ei ole kassasi esikatselua.
## Mitä tarvitset ensin
Yhdistä Shopify tai WooCommerce kohdassa **Myyntikanavat**. Omaa verkkokauppaasi varten luo [API-token](/docs/fi/how-to/create-an-api-token), jolla on **Toimitussääntöjen katselu**.
Katso [Kuljetusyhtiön tunnukset](/docs/fi/how-to/carrier-credentials). Jokainen toimitussääntö käyttää yhdistetyn kuljetusyhtiön kuljetuspalvelua.
Nimeä jokainen sääntö niin, kuin asiakkaidesi pitää sen kassalla lukea. Määritä maat, joihin se toimittaa, sekä mahdolliset hinta- tai painorajat. Katso [Toimitussäännön kentät](/docs/fi/how-to/shipping-rule-fields).
## Shopify: Kassan toimitushinnat
Avaa Shopify-myyntikanavasi kohdassa **Myyntikanavat**. Vieritä **Tilaukset ja kassa** -välilehdellä kohtaan **Kassan toimitushinnat**. Kaikki Shopify-asetukset: [Shopify-asetukset](/docs/fi/how-to/shopify-settings). Sovelluksen asentaminen: [Yhdistä Shopify](/docs/fi/tutorials/connect-shopify).
Kortissa lukee: **Valitse, mitä toimitussääntöjä asiakkaasi voivat valita Shopifyn kassalla. Jos et valitse yhtään, käytetään jokaista toimitussääntöä, joka sopii vastaanottajan maahan. Noutopisteisiin toimittava toimitussääntö näyttää jokaisen noutopisteen omana hintanaan.**
| Kenttä | Mitä tehdä |
| - | - |
| **Toimitussäännöt** | Rastita säännöt, joita Shopifyn pitää tarjota. Jokaisella rivillä näkyvät säännön nimi, sen kuljetusyhtiö ja maat sekä kuvaus. Kun sääntöjä ei vielä ole, kortissa lukee **Ei vielä toimitussääntöjä. Luo sääntö valikon kohdassa Toimitussäännöt.** |
| **Noutopisteet kassalla** | **Kuinka monta noutopistettä kassalla näytetään yhteensä. Ne jaetaan tasan noutopisteisiin toimittavien toimitussääntöjen kesken.** Luku väliltä 1-20. Oletus on 6. |
| **Tallenna muutokset** | Tallentaa valintasi. Harmaana, kunnes muutat jotain. |
Lisää noutopisteistä kassalla: [Noutopisteet](/docs/fi/how-to/drop-point-and-service-points).
### Rekisteröi Zippendo Shipping Shopifyyn
Avaa **Yhteys ja integraatio** -välilehti. **Hintapalvelu (carrier service)** -kortissa:
| Hallinta | Mitä se tekee |
| - | - |
| **Tarkista hintapalvelu** → **Tarkista tila** | Tarkistaa, onko Zippendo rekisteröity Shopifyyn reaaliaikaisia toimitushintoja varten. Näet viestin "1 hintapalvelu löytyi" tai **Hintapalvelua ei ole rekisteröity. Toimitushinnat eivät näy kassalla.**. |
| **Rekisteröi hintapalvelu** | Rekisteröi Zippendon Shopifyyn tai rekisteröi sen uudelleen. Tarvitaan reaaliaikaisia toimitushintoja varten kassalla. |
Kortti muistuttaa myös: rekisteröinnin jälkeen siirry kohtaan **Shopify admin → Settings → Shipping and delivery** ja lisää "Zippendo Shipping" hintojen tarjoajaksi toimitusalueillesi.
Ennen kuin **Zippendo Shipping** on lisätty toimitusalueillesi Shopifyssa, asiakkaasi eivät näe Zippendon hintoja, vaikka **Tarkista tila** löytäisi hintapalvelun ja säännöt olisi rastitettu.
Shopify-kaupat, joilla ei ole lasketuja toimitushintoja, voivat sen sijaan linkittää omien Shopify-toimitustapojensa nimet toimitussääntöihin. Se ei näytä reaaliaikaisia hintoja, vaan asettaa oikean säännön jokaiselle tilaukselle vain tilauksen tuonnin yhteydessä. Katso toimitustapojen yhdistäminen sivulla [Shopify-asetukset](/docs/fi/how-to/shopify-settings).
## WooCommerce: Kassatoken
WooCommerce näyttää reaaliaikaiset hinnat **Zippendo for WooCommerce** -lisäosan ja **Kassatokenin** avulla (se alkaa merkeillä `zck_`). Yhdistä ensin verkkokauppa: [Yhdistä WooCommerce](/docs/fi/how-to/connect-woocommerce).
Avaa WooCommerce-myyntikanavasi. Etsi **Tilaukset ja kassa** -välilehdeltä **Kassatoken**-kortti: **Zippendo for WooCommerce -lisäosa näyttää kassallasi reaaliaikaiset toimitushinnat ja noutopisteet. Asenna lisäosa ja liitä tämä token sen asetuksiin.**
| Hallinta | Mitä se tekee |
| - | - |
| **Lataa lisäosa** | Lataa uusimman lisäosan `.zip`-tiedostona asennettavaksi WordPressiin. |
| **Luo token** | Luo ensimmäisen tokenisi ja näyttää sen kerran. |
| **Kopioi** | Kopioi tokenin. Näet viestin **Token kopioitu leikepöydälle**. |
| **Vaihda token** | Vaihtaa tokenin. Zippendo kysyy: **Vaihdetaanko kassatoken? Nykyinen token lakkaa toimimasta heti, ja sinun on liitettävä uusi token lisäosaan.** |
| **Mitätöi** | Poistaa tokenin käytöstä. Zippendo kysyy: **Mitätöidäänkö kassatoken? Lisäosa lakkaa toimimasta, kunnes luot uuden tokenin.** Näet sitten viestin **Kassatoken mitätöity**. |
Heti kun olet luonut tai vaihtanut tokenin, kortti varoittaa: **Kopioi tämä token nyt. Et näe sitä enää myöhemmin, koska Zippendo ei säilytä siitä luettavaa kopiota.** Liitä se lisäosan asetuksiin WordPressissä. Kun token on olemassa, kortti näyttää, milloin se luotiin.
Jos jokin epäonnistuu, näet viestin **Kassatokenin luominen epäonnistui** tai **Kassatokenin mitätöinti epäonnistui**.
Lisäosa pyytää Zippendolta hintoja tällä tokenilla sekä toimitusvaihtoehdoille että lähellä oleville noutopisteille, kun asiakas vaihtaa postinumeroa. Se ei käytä API-tokenia. **Testaa yhteys** **Yhteys**-välilehdellä tarkistaa vain WooCommerce-avaimet, joilla tilaukset tuodaan.
## Oma verkkokauppasi: toimitushintatarjous-API
Mukautettu myyntikanava lähettää tilauksia Zippendoon, mutta ei näytä hintoja kassallasi. Jos haluat näyttää reaaliaikaiset hinnat itse rakentamassasi verkkokaupassa, kutsu:
```
POST /orgs/{orgId}/shipping-quote
Authorization: Bearer zipp_YOUR_TOKEN
```
`{orgId}` on organisaatiosi tunnus, ei sovelluksen osoiterivillä näkyvä nimi. Token tarvitsee **Toimitussääntöjen katselun**: [Luo API-token](/docs/fi/how-to/create-an-api-token). Valmiit asiakkaat: [SDK:t](/docs/fi/sdks/overview). Kokeile sitä [API-viitteessä](/docs/api-reference/overview).
### Pyynnön runko
| Kenttä | Pakollinen | Huomautukset |
| - | - | - |
| `destination.country` | Kyllä | Kaksikirjaiminen maakoodi (ISO 3166-1 alpha-2), esimerkiksi `DK` |
| `destination.postalCode` | Ei | Esimerkiksi `1620` |
| `destination.province` | Ei | Osavaltion tai läänin koodi |
| `destination.city` | Ei | Esimerkiksi `København` |
| `destination.address1` / `address2` | Ei | Katuosoiterivit |
| `items` | Kyllä, vähintään yksi | Ostoskorin rivit |
| `items[].name` | Kyllä | Esimerkiksi `Uld trøje` |
| `items[].quantity` | Kyllä | Kokonaisluku, vähintään 1 |
| `items[].grams` | Kyllä | Paino grammoina, vähintään 0 |
| `items[].price` | Kyllä | Yksikköhinta senteissä (øre), vähintään 0 |
| `items[].sku` / `productId` / `variantId` | Ei | |
| `currency` | Kyllä | Kolmikirjaiminen valuuttakoodi (ISO 4217), esimerkiksi `DKK` |
| `totalPriceCents` | Ei | Ostoskorin loppusumma alennusten jälkeen senteissä. Antaa tilauksen arvorajan sisältävien sääntöjen käyttää alennettua loppusummaa. |
```json theme={null}
{
"destination": {
"country": "DK",
"postalCode": "2100",
"city": "Copenhagen"
},
"items": [
{
"name": "T-shirt",
"quantity": 1,
"grams": 250,
"price": 29900
}
],
"currency": "DKK"
}
```
Zippendo laskee yhteen `grams × quantity` ja `price × quantity` kaikilta riveiltä ja tarkistaa sitten jokaisen toimitussäännön, joka toimittaa maahan `destination.country`. Jokaisesta täsmäävästä säännöstä tulee hinta. Jos mikään sääntö ei täsmää, saat vastauksen `{ "rates": [] }` tilakoodilla 200, ei virhettä.
### Hintaobjekti
| Kenttä | Mikä se on |
| - | - |
| `serviceName` | Säännön nimi sellaisena kuin asiakkaasi sen näkee |
| `serviceCode` | `{carrierSlug}:{productId}:{shippingRuleId}` |
| `totalPrice` | Toimitushinta senteissä merkkijonona |
| `currency` | Kolmikirjaiminen valuuttakoodi |
| `description` | Säännön kuvaus, jos sellainen on |
| `carrierName` / `carrierSlug` / `productId` | Säännön kuljetusyhtiö ja kuljetuspalvelu |
| `shippingRuleId` | Sääntö, joka tuotti hinnan |
| `minDeliveryDate` / `maxDeliveryDate` | Odotetut toimituspäivät, jos säännöllä on ne |
Virheellinen maa tai runko palauttaa `400` ja `{ error, message }`, esimerkiksi `Invalid destination country`. Tuntematon organisaatio palauttaa `404`.
Esimerkkikoodi: [Toimitushintatarjousten pikaopas](/docs/fi/quickstarts/shipping-quotes).
## Miten testaat
Zippendossa ei ole kassasi esikatselua. Testaa verkkokaupassasi:
| Verkkokauppa | Zippendossa | Verkkokaupassasi |
| - | - | - |
| **Shopify** | Rastita säännöt, aseta noutopisteiden määrä, napsauta **Tarkista tila** | Käy kassa läpi, kun **Zippendo Shipping** on toimitusalueellasi |
| **WooCommerce** | **Luo token** | Liitä token lisäosan asetuksiin ja täytä ostoskori |
| Oma verkkokauppasi | **Testaa** toimitussäännöllä (tarkistaa vain säännön) | Kutsu toimitushintatarjous-API:a esimerkkiostoskorilla |
Jos hinta puuttuu, tarkista säännön **Vastaanottajamaat**, paino- ja tilausarvorajat ja muut asetukset, ennen kuin epäilet kuljetusyhtiötä.
Olet valmis, kun Shopifyn **Kassan toimitushinnat** sisältää haluamasi säännöt (ja **Zippendo Shipping** on toimitusalueellasi), tai WooCommercessa on aktiivinen **Kassatoken** liitettynä lisäosaan, tai toimitushintatarjous-API palauttaa `rates`-arvon esimerkkiostoskorille.
## Liittyvää
* [Kassa](/docs/fi/tutorials/checkout): opas
* [Shopify-asetukset](/docs/fi/how-to/shopify-settings) / [Yhdistä WooCommerce](/docs/fi/how-to/connect-woocommerce)
* [Toimitussäännön kentät](/docs/fi/how-to/shipping-rule-fields)
* [Luo API-token](/docs/fi/how-to/create-an-api-token)
* [Valitse noutopiste](/docs/fi/how-to/pick-a-service-point)
* [Toimitushinnasto ei palauta hintoja](/docs/fi/knowledge-base/shipping-quote-no-rates)
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.