> ## 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.

# Yhdistä Royal Mail

> Yhdistä Royal Mail kohdassa Kuljetusyhtiöt Click & Drop API -avaimellasi sekä valinnaisella Click & Drop carrier -kentällä ja API Portal client ID:llä ja salaisuudella seurantaa ja Local Collectia varten.

**Royal Mail** lähettää Zippendosta Ison-Britannian ja kansainvälisiä paketteja sekä Tracked Returns -palautuksia Click & Drop -tilisi kautta. Kaikille kuljetusyhtiöille yhteiset kentät on kuvattu sivulla [Kuljetusyhtiön tunnukset](/docs/fi/how-to/carrier-credentials).

<Info>
  Tässä lomakkeessa et valitse lähettäjän osoitetta. Lisää osoitteesi organisaatiovalikon kohdassa **Hallitse** → **Osoitteet**. Valitset lähettäjän osoitteen jokaiselle lähetykselle tai [toimitussäännössä](/docs/fi/how-to/shipping-rule-fields).
</Info>

<Warning>
  Royal Mail antaa osoitekortteja Click & Dropin kautta vain **Online Business Account (OBA)** -asiakkaille. Henkilökohtaisella Click & Drop -tilillä Royal Mail ei palauta osoitekorttia. Silloin Zippendo ei luo lähetystä ja poistaa tilauksen Click & Dropista uudelleen. Jos poisto epäonnistuu, virheilmoituksessa on Click & Drop -tilauksen numero, jotta voit poistaa tilauksen itse.
</Warning>

## Ennen kuin aloitat

Määritä nämä asiat ensin Click & Dropissa:

* Royal Mailin **Online Business Account**, joka on yhdistetty Click & Dropiin, ja käyttöön otetut palvelut, joita haluat käyttää.
* **Settings → Label format** asetettuna arvoon **6 x 4** (lämpö). Zippendo luo osoitekortit aina tässä koossa.
* Click & Dropin **trading name**, joka on kirjoitettu täsmälleen kuten lähettäjän osoitteesi (tai palautusosoitteesi) yrityksen nimi. Royal Mail tulostaa osoitekorttiin kyseisen trading namen palautusosoitteen.
* **Click & Drop API** -integraatio. Siirry Click & Dropissa kohtaan **Settings → Integrations → Click & Drop API**, valitse oletuksena käytettävä trading name ja valitse **Update**. Avaa integraation rivi nähdäksesi **authorisation key** -avaimen. Jokaisella Click & Drop -tilillä on vain yksi tällainen integraatio.

Valinnainen, seurantaa Zippendossa ja Local Collectia varten: sovellus [Royal Mail API Developer Portalissa](https://developer.royalmail.net/) (**My Apps → Create new app**). Pyydä Royal Mailin tilipäällikköäsi ottamaan tilillesi käyttöön **Tracking**- ja **Local Collect** -tuotteet. Tämä kestää yleensä alle viikon, ja molemmat tuotteet ovat ilmaisia.

Voit yhdistää Royal Mailin useammin kuin kerran. Anna jokaiselle yhteydelle oma **Kuljetusyhtiön nimi**. Kortin **Lue lisää** avaa Royal Mailin Click & Drop -sivun.

## Yhdistä Royal Mail

<Steps>
  <Step title="Avaa Kaikki kuljetusyhtiöt">
    Valitse sivupalkista **Kuljetusyhtiöt** ja avaa sitten **Kaikki kuljetusyhtiöt** -välilehti.
  </Step>

  <Step title="Etsi Royal Mail">
    Valitse **Royal Mail** -kortissa **Yhdistä**.
  </Step>

  <Step title="Täytä lomake">
    **Yhdistä kuljetusyhtiö** -ikkuna avautuu. Anna **Kuljetusyhtiön nimi** ja **API-avain**. **Click & Drop -kuljetusyhtiö**, **Client ID (API Portal)** ja **Client secret (API Portal)** ovat kohdassa **Valinnaiset kentät**.
  </Step>

  <Step title="Yhdistä kuljetusyhtiö">
    Valitse **Yhdistä**. Näet viestin "Kuljetusyhtiö yhdistetty", ja kuljetusyhtiö ilmestyy **Omat kuljetusyhtiöt** -välilehdelle.
  </Step>
</Steps>

## Lomakkeen kentät

| Kenttä | Pakollinen | Mitä syötetään |
| - | - | - |
| **Kuljetusyhtiön nimi** | Kyllä | Nimi, jonka näet kohdassa **Omat kuljetusyhtiöt** ja kun valitset kuljetusyhtiön lähetykselle. Oletuksena se on **Royal Mail**. |
| **Brändi** | Ei | Näkyy vain, jos organisaatiossasi on [brändejä](/docs/fi/how-to/create-a-brand). Lomakkeessa lukee: "Vain tämä brändi voi käyttää tätä kuljetusyhtiötä." Jätä tyhjäksi, jos haluat jokaisen brändin voivan käyttää sitä. |
| **API-avain** | Kyllä | Click & Dropin authorisation key. Lomakkeessa lukee: "Click & Drop -API-valtuutusavaimesi (Settings → Integrations → Click & Drop API). Osoitekortit API:n kautta edellyttävät Online Business Account (OBA) -tiliä." Jos poistat integraation Click & Dropissa ja luot sen uudelleen, saat uuden avaimen. Päivitä se tähän. |
| **Click & Drop -kuljetusyhtiö** | Ei | Lomakkeessa lukee: "Vain jos Click & Drop -tililläsi on useampi kuljetusyhtiö (OBA-numero + jättöpaikka): kuljetusyhtiön nimi kohdasta Settings → Shipping Carriers." Jätä tyhjäksi, jos tililläsi on vain yksi. |
| **Client ID (API Portal)** | Ei | Kehittäjäportaalissa olevasta sovelluksestasi (**My Apps** → sovelluksesi). Lomakkeessa lukee: "Sovelluksesi client ID palvelussa developer.royalmail.net (My Apps). Ottaa käyttöön Royal Mailin seurannan ja Local Collect -noutopistehaun. Pyydä ensin Royal Mailin asiakkuuspäällikköä ottamaan Tracking- ja Local Collect -tuotteet käyttöön tililläsi." Yksi sovellus kattaa molemmat tuotteet. |
| **Client secret (API Portal)** | Ei | Samasta sovelluksesta. Portaali näyttää sen kerran, kun luot sovelluksen. Jos hukkasit sen, nollaa se portaalissa. Lomakkeessa lukee: "Saman developer-portaalin sovelluksen client secret. Pakollinen seurantaa varten. Local Collect toimii pelkällä client ID:llä." |

**Yhdistä** ei tee mitään, ennen kuin **Kuljetusyhtiön nimi** ja **API-avain** on täytetty.

Royal Maililla ei ole **Testitila**-asetusta, koska Click & Dropilla ei ole testijärjestelmää. Jokainen luomasi osoitekortti on oikea osoitekortti tililläsi. Katso [Testitila](/docs/fi/how-to/sandbox-mode).

## Yhdistämisen jälkeen

Kuljetusyhtiö ilmestyy kohtaan **Omat kuljetusyhtiöt** **Yhdistetty**-merkinnällä. Valitset kuljetuspalvelun jokaiselle lähetykselle tai toimitussäännössä, et tässä lomakkeessa. Katso [Kuljetuspalvelut ja lisäpalvelut](/docs/fi/how-to/carrier-products-and-services).

| Aihe | Miten se toimii Royal Mailin kanssa |
| - | - |
| Kuljetuspalvelut | Royal Mail 24 ja 48, Tracked 24 ja 48 (myös High Volume-, Letterboxable- ja Age Verification -versiot), Special Delivery, 1st ja 2nd Class, Signed For, International Standard, Tracked, Signed ja Economy On Account sekä International Business Parcels and Mail. |
| Minne ne toimittavat | Ison-Britannian kuljetuspalvelut toimittavat Isoon-Britanniaan, Pohjois-Irlantiin, Jerseylle, Guernseylle ja Mansaarelle. Jerseylle, Guernseylle ja Mansaarelle menevillä lähetyksillä on tulli-ilmoitus. Kansainväliset kuljetuspalvelut toimittavat kaikkialle muualle. |
| Palautukset | **Royal Mail Tracked Returns 24** ja **Royal Mail Tracked Returns 48**. Royal Mail antaa PDF-osoitekortin ja QR-koodin. Asiakkaasi voi näyttää QR-koodin Post Officessa tai noutopisteessä osoitekortin tulostamisen sijaan. |
| Tulliasiakirjat | Royal Mail tulostaa CN22- tai CN23-lomakkeen osoitekortin mukana, kun lähetys sitä tarvitsee. Zippendo ei lisää omaa tulli-ilmoitusta tai kauppalaskua. |
| Paketin muoto | Zippendo päättelee Royal Mailin muodon (letter, large letter, small parcel, medium parcel tai parcel) paketin koosta ja painosta. Jos haluat valita sen itse, aseta **Lähetysmuoto** lähetykselle tai toimitussäännössä. |
| Noutopisteet | Royal Mail kutsuu niitä **Local Collect** -paikoiksi: Post Officeja, Royal Mailin Customer Service Pointteja, kauppoja ja pakettiautomaatteja toimituspostinumeron lähellä, vain Isossa-Britanniassa. Katso **Local Collect** alla. |
| Seuranta | Kun **Client ID (API Portal)** ja **Client secret (API Portal)** on täytetty ja Tracking on otettu käyttöön tililläsi, Zippendo hakee seurantapäivitykset Royal Maililta tunnin välein. Ilman niitä seuranta-aikajana pysyy tyhjänä, mutta jokaisella lähetyksellä on silti seurantakoodi ja royalmail.com-seurantalinkki. Katso [Kuljetusyhtiön seurannan webhookit](/docs/fi/how-to/tracking-webhooks). |
| Noutotilaukset | Ei käytettävissä kohdassa **Noutotilaukset**. Sovi noudoista Click & Dropissa tai suoraan Royal Mailin kanssa. |
| Manifestit | Zippendo ei tee tilauksistasi manifestia. Tee manifesti Click & Dropissa kuten tavallisesti. Royal Mail laskuttaa OBA-osoitekortit manifestin yhteydessä. |

### Local Collect

Jokaisesta seurattavasta Ison-Britannian kuljetuspalvelusta on myös **… — Local Collect** -kuljetuspalvelu, esimerkiksi **Royal Mail Tracked 24 — Local Collect**. Se toimittaa Local Collect -paikkaan oven sijaan. Kun valitset jonkin näistä kuljetuspalveluista, valitse paikka lähetykselle ennen lähettämistä. Toimitussääntö voi myös yhdistää verkkokaupastasi tulevan noutopistetoimitustavan johonkin näistä kuljetuspalveluista. Osoitekortin osoitteena on paikka, ja siinä on vastaanottajan nimi.

Local Collect vaatii **Client ID (API Portal)** -tunnuksen ja Local Collectin käyttöönoton tililläsi. Katso [Valitse noutopiste](/docs/fi/how-to/pick-a-service-point) ja [Noutopisteet](/docs/fi/how-to/drop-point-and-service-points).

### Lisäpalvelut ja lisävalinnat

Ota nämä lisäpalvelut käyttöön lähetykselle tai toimitussäännössä:

| Lisäpalvelu | Mitä se tekee |
| - | - |
| **Allekirjoitus vastaanotettaessa** | Royal Mail pyytää vastaanottajaa kuittaamaan allekirjoituksella. Ei tarjolla Special Deliveryssä tai Signed Forissa, joihin allekirjoitus kuuluu aina. |
| **Local Collect (nouto Post Office -toimipisteestä)** | Toimittaa Post Officeen, josta vastaanottaja hakee paketin. Vain Ison-Britannian kuljetuspalvelut. Käytä tätä, kun tilauksella on jo Post Office -osoite. Jos vastaanottajan pitää valita paikka, käytä sen sijaan **… — Local Collect** -kuljetuspalvelua. |
| **Sähköposti-ilmoitus**, **Tekstiviesti-ilmoitus** | Royal Mail lähettää vastaanottajalle sähköpostin tai tekstiviestin. |
| **Tulosta Tracked Returns -osoitekortti lähtevän osoitekortin kanssa** | Tulostaa Tracked Returns -osoitekortin lähtevän osoitekortin kanssa. Click & Dropissa lähtevälle palvelulle on määritettävä Tracked Returns -palvelu. |

Nämä lisävalinnat ovat lähetyksen kohdassa **Lisätiedot kuljetusyhtiölle**. Toimitussäännössä ne näkyvät kohdan **Lisäpalvelut** alla:

| Valinta | Mihin käytetään |
| - | - |
| **Lähetysmuoto** | Valitse Royal Mailin muoto itse automaattisen sijaan. |
| **Erityisohjeet** | Tallennetaan Click & Drop -tilaukseen. |
| **Turvallinen jättöpaikka** | Mihin lähetys jätetään. Vain Iso-Britannia. |
| **Välillisten vahinkojen turva** | Lisäkorvaus punnissa (GBP), 0-10000. Vain Iso-Britannia. |
| **Recipient is a business** | Tarvitaan, kun yritys lähettää Pohjois-Irlantiin. Asetetaan automaattisesti, kun vastaanottajalla on ALV- tai EORI-numero. |
| **Veloitetut toimituskulut**, **Tulli-ilmoituksen luokka**, **Vaatii vientiluvan** | Kansainvälisten lähetysten tullitiedot. |

### Tullitiedot

* Lähetyksillä, jotka tarvitsevat tulli-ilmoituksen, jokaisella tilausrivillä on oltava kuvaus, yksikköhinta ja valuutta. Jokaisella rivillä pitäisi myös olla HS-koodi ja alkuperämaa. Zippendo näyttää virheen, ennen kuin mitään lähetetään Royal Mailille.
* Organisaatiosi tai brändisi IOSS-numero lisätään automaattisesti EU:hun menevillä lähetyksillä. Omat ALV- ja EORI-numerosi tulevat Click & Drop -trading namestasi. Yritysvastaanottajan ALV- tai EORI-numero tulee tilauksen vastaanottajan tiedoista.

## Muuta tai poista yhteys

Muuttaaksesi sitä avaa **Kuljetusyhtiöt** → **Omat kuljetusyhtiöt** ja valitse kortissa **Muokkaa kuljetusyhtiötä**. **Muokkaa kuljetusyhtiötä** -sivulla on kaksi osaa:

* **Yleiset**: **Kuljetusyhtiön nimi** ja **Brändi**, jos organisaatiossasi on brändejä.
* **Kuljetusyhtiön asetukset**: **API-avain**, **Click & Drop -kuljetusyhtiö**, **Client ID (API Portal)** ja **Client secret (API Portal)**.

Valitse **Tallenna**. Näet viestin "Kuljetusyhtiö päivitetty".

Poistaaksesi sen valitse samalla sivulla **Poista**, kirjoita kuljetusyhtiön nimi isoilla kirjaimilla ja valitse **Poista**. Tätä kuljetusyhtiötä käyttävät toimitussäännöt poistetaan sen mukana. Jo lähettämäsi lähetykset säilyttävät osoitekorttinsa ja seurantakoodinsa, ja Click & Dropissa jo olevat tilaukset pysyvät siellä.

## Yleisiä ongelmia

| Mitä näet | Mitä tehdä |
| - | - |
| "Kuljetusyhtiön yhdistäminen epäonnistui. Yritä uudelleen." | Tarkista, että **Kuljetusyhtiön nimi** ja **API-avain** on täytetty, ja yritä uudelleen. |
| "Olet saavuttanut pakettisi rajan. Vaihda pakettia tai poista jotain, mitä et enää käytä." | Pakettisi kuljetusyhtiöiden enimmäismäärä on täynnä. Katso [Laskutus ja käyttö](/docs/fi/how-to/billing-and-usage). |
| "Kuljetusyhtiö hylkäsi kirjautumistietosi. Päivitä kuljetusyhtiön tunnukset Kuljetusyhtiöt-sivulla." | **API-avain** on väärä tai se on korvattu Click & Dropissa. Näet tämän myös, kun **Client ID (API Portal)** tai **Client secret (API Portal)** on väärä tai kun Tracking tai Local Collect ei ole käytössä Royal Mail -tililläsi. |
| "Kuljetusyhtiön asetukset ovat puutteelliset tai virheelliset. Tarkista ne Kuljetusyhtiöt-sivulla." kun haet Local Collect -paikkoja | Lisää **Client ID (API Portal)** kohdassa **Muokkaa kuljetusyhtiötä**. |
| Viesti, jonka mukaan Local Collect -kuljetuspalvelu tarvitsee valitun Post Officen tai Customer Service Pointin | Valitse paikka lähetykselle ennen lähettämistä. |
| Viesti, jonka mukaan Local Collect -paikkaa ei löytynyt 20 mailin säteeltä | Valitse paikka toimituspostinumeron läheltä. |
| "Kuljetusyhtiön asetukset ovat puutteelliset tai virheelliset. Tarkista ne Kuljetusyhtiöt-sivulla." ja sen perässä "Royal Mail returned no label…" | Tilisi ei ole Online Business Account tai palvelu ei ole siinä käytössä. Zippendo poisti tilauksen Click & Dropista. Jos poisto epäonnistui, viestissä on tilausnumero, jonka voit poistaa itse. Päivitä tili tai ota palvelu käyttöön Click & Dropissa ja lähetä sitten uudelleen. |
| "Valittu kuljetuspalvelu ei kulje näiden maiden välillä. Valitse toinen kuljetuspalvelu." | Valitsit Ison-Britannian kuljetuspalvelun osoitteelle Ison-Britannian ulkopuolella tai kansainvälisen kuljetuspalvelun brittiosoitteelle. Valitse toisen tyyppinen. |
| "Royal Mail ei pystynyt luomaan lähetystä." tai Royal Mailin oma virheteksti | Click & Drop hylkäsi tilauksen. Korjaa viestissä mainittu kenttä, kuten osoite, ja lähetä uudelleen. |
| "Kuljetusyhtiö loi osoitekortin, mutta yksi sen mukana tulevista asiakirjoista jäi luomatta. Tarkista lähetyksen asiakirjat ennen kuin luovutat paketin." | Lähetys luotiin, mutta tulli-lomake tai palautusosoitekortti puuttuu. Tarkista lähetyksen asiakirjat, ennen kuin luovutat paketin. |
| "Tulli-ilmoitus on puutteellinen. Jokaisella tuotteella on oltava kuvaus, määrä ja nollaa suurempi ilmoitettu arvo." | Täydennä tilausrivit ja lähetä sitten uudelleen. Royal Mailille ei lähetetty mitään. |

## Aiheeseen liittyvää

* [Yhdistä kuljetusyhtiö tai integraatio](/docs/fi/how-to/connect-index)
* [Kuljetusyhtiön tunnukset](/docs/fi/how-to/carrier-credentials)
* [Testitila](/docs/fi/how-to/sandbox-mode)
* [Kuljetuspalvelut ja lisäpalvelut](/docs/fi/how-to/carrier-products-and-services)
* [Kuljetusyhtiön seurannan webhookit](/docs/fi/how-to/tracking-webhooks)
* [Kuljetusyhtiöt](/docs/fi/tutorials/carriers)


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