Zippendo

Kehittäjille

Lähetys-API, josta tiimisi oikeasti pitää

REST API osoitekortteihin, seurantaan ja noutopisteisiin kaikilla kuljetusyhtiöilläsi. Käytä sitä Zippendo-sovelluksen rinnalla tai yksinään, kun järjestelmäsi tarvitsee vain kuljetusyhtiöyhteydet. SDK:t seitsemälle kielelle, allekirjoitettu webhook jokaisesta tapahtumasta ja MCP-palvelin, jotta myös tekoälyagentti voi varata paketin.

Lue dokumentaatio
Hanki API-token

Tokenista osoitekorttiin neljässä vaiheessa.

Luo token, asenna SDK tai käytä cURLia ja lähetä lähetys POST-pyynnöllä. Nimeämäsi toimitussääntö valitsee kuljetusyhtiön ja kuljetuspalvelun. Lähetä lähetys, niin osoitekortti palautuu asiakirjana, jonka voit tulostaa tai lähettää Zippendo Printer -sovellukseen.

Avaa API-viite

  1. Luo API-token

    Avaa API-asetukset hallintapaneelissa. Tokenit alkavat merkkijonolla zipp_, ne näytetään vain kerran, ja ne voi rajata yhteen brändiin.

    API-asetukset

  2. Asenna SDK, tai älä

    npm, pip, Composer, go get, gem, Maven tai NuGet. Jokainen SDK generoidaan julkisesta OpenAPI-määrittelystä ja kattaa kaikki endpointit. cURL toimii yhtä hyvin.

    SDK-yleiskatsaus

  3. Luo lähetys

    Lähetä vastaanottaja, paketit ja toimitussäännön id. Sääntö antaa kuljetusyhtiön, kuljetuspalvelun ja lähettäjän osoitteen. Lähetä sitten lähetys, niin kuljetusyhtiö palauttaa osoitekortin ja seurantakoodin.

    Lähetykset API-viitteessä

  4. Kuuntele tapahtumia

    Ohjaa webhook palvelimellesi. Jokainen toimitus on POST-pyyntö, joka on allekirjoitettu raa'an rungon HMAC-SHA256-tiivisteellä. Sitä yritetään enintään 5 kertaa, ja jokainen yritys näkyy toimituslokissa.

    Webhookien pikaopas
curl https://api.zippendo.com/orgs/org_8f3kd92ld0/shipments \  -H "Authorization: Bearer $ZIPPENDO_API_TOKEN" \  -H "Content-Type: application/json" \  -d '{    "reference": "ORDER-1042",    "type": "outbound",    "shippingRuleId": "rule_3c4d5e6f",    "parties": [{      "type": "receiver",      "name": "Anna Jensen",      "address1": "Vesterbrogade 12",      "postalCode": "1620",      "city": "København V",      "countryCode": "DK",      "email": "[email protected]"    }],    "parcels": [{      "weight": 2.5,      "weightUnit": "kg",      "dimensions": { "length": 30, "width": 20, "height": 10 },      "orderLines": []    }]  }'

Jokaisessa virheessä on viestin lisäksi koneluettava koodi. Uudelleen yritetty webhook säilyttää saman X-Webhook-Id-arvon, joten kaksoiskappaleiden ohittaminen vaatii vain yhden haun.

Osoitekortit, seuranta ja noutopisteet omasta koodistasi.

Lue dokumentaatio

MCP, webhookit ja integraatiot yhdestä luettelosta

Yhdistä Claude, Cursor tai ChatGPT OAuthin kautta tai lähetä lähetystapahtumat Klaviyoon, Slackiin, Zapieriin ja Makeen ilman omaa liimakoodia.

SDK:t

7

kieltä, generoitu määrittelystä

Tapahtumat, joita voit kuunnella

  • order.created
  • shipment.created
  • shipment.dispatched
  • tracking.updated
  • shipment.error

Yksi pyyntö sisään, kaikki tapahtumat ulos

Luo lähetys toimitussäännön id:llä, niin kuljetusyhtiö, kuljetuspalvelu ja lähettäjän osoite päätetään puolestasi. Sen jälkeen jokainen muutos saapuu endpointiisi allekirjoitettuna webhookina.

MCP-palvelin agenteille

Osoita Claude, Cursor tai ChatGPT osoitteeseen api.zippendo.com/mcp, niin se luo lähetyksiä, seuraa paketteja ja lukee tilauksiasi hyväksymilläsi oikeuksilla.

Tarvitsetko vain kuljetusyhtiöt?

  • Osoitekortit
  • Seuranta
  • Noutopisteet
  • Toimitushintatarjoukset

API-käyttö

100%

palvelupaketeista, myös Free

Uudet kuljetusyhtiöt

1 viikko

on se aika, jossa tavallisesti kytkemme tarvitsemasi kuljetusyhtiön

Mihin seuraavaksi

  • REST API -pikaopas

    Tunnistaudu ja luo ensimmäinen lähetyksesi.

    Lue pikaopas

  • API-viite

    Kaikki endpointit, pyyntöjen rungot ja vastaukset sekä testiympäristö.

    Avaa API-viite

  • SDK:t

    TypeScript, Python, PHP, Go, Ruby, Java ja C#, generoitu samasta määrittelystä.

    Valitse kieli

  • Webhookit

    Allekirjoitetut toimitukset jokaisesta lähetys- ja tilaustapahtumasta.

    Määritä endpoint

  • Mukautetut myyntikanavat

    Oma verkkokauppasi tai ERP-järjestelmäsi tilauslähteenä, API:n kautta työnnettynä tai haettuna.

    Rakenna myyntikanava

  • MCP-palvelin

    Yhdistä Claude, Cursor tai ChatGPT tiliisi OAuthin kautta.

    Yhdistä agentti

Oppaat

  • Kuljetusyhtiöiden API-integraatio

    Mitä kuljetusyhtiöiden liittäminen itse vaatii ja milloin yksi lähetysrajapinta on helpompi tie.

    Lue opas

  • HS-koodit

    Löydä oikea tullinimike jokaiselle tuotteelle ja katso, mihin se merkitään tulliasiakirjoissa.

    Lue opas