Zippendo

Dla programistów

API wysyłkowe, z którym twój zespół naprawdę lubi pracować

REST API do etykiet, śledzenia przesyłek i punktów odbioru u wszystkich twoich przewoźników. Używaj go obok aplikacji Zippendo albo samodzielnie, gdy twój system potrzebuje tylko połączeń z przewoźnikami. SDK w siedmiu językach, podpisany webhook dla każdego zdarzenia i serwer MCP, dzięki któremu również agent AI może nadać paczkę.

Od tokenu do etykiety w czterech krokach.

Utwórz token, zainstaluj SDK lub użyj cURL i wyślij przesyłkę metodą POST. Wskazana reguła wysyłki wybiera przewoźnika i usługę. Nadaj przesyłkę, a etykieta wróci jako dokument, który możesz wydrukować lub wysłać do Zippendo Printer.

  1. Utwórz token API

    Otwórz ustawienia API w panelu. Tokeny zaczynają się od zipp_, są pokazywane tylko raz i można je ograniczyć do jednej marki.

    Ustawienia API
  2. Zainstaluj SDK albo nie

    npm, pip, Composer, go get, gem, Maven lub NuGet. Każde SDK jest generowane z publicznej specyfikacji OpenAPI i obejmuje każdy endpoint. cURL sprawdza się równie dobrze.

    Przegląd SDK
  3. Utwórz przesyłkę

    Wyślij odbiorcę, paczki i id reguły wysyłki. Reguła dostarcza przewoźnika, usługę i adres nadawcy. Potem nadaj przesyłkę, a przewoźnik zwróci etykietę i numer przesyłki.

    Przesyłki w dokumentacji
  4. Nasłuchuj zdarzeń

    Skieruj webhook na swój serwer. Każde doręczenie to żądanie POST podpisane HMAC-SHA256 surowej treści, ponawiane do 5 razy, a każda próba trafia do dziennika doręczeń.

    Szybki start z webhookami
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": []    }]  }'

Każdy błąd ma obok komunikatu kod czytelny dla maszyn. Ponowiony webhook zachowuje ten sam X-Webhook-Id, więc pomijanie duplikatów to jedno wyszukanie.

Etykiety, śledzenie przesyłek i punkty odbioru z twojego własnego kodu.

MCP, webhooki i integracje z jednego katalogu

Połącz Claude, Cursor lub ChatGPT przez OAuth albo wysyłaj zdarzenia przesyłek do Klaviyo, Slack, Zapier i Make bez pisania kodu pośredniczącego.

SDK

7

języków, generowanych ze specyfikacji

Zdarzenia, których możesz nasłuchiwać

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

Jedno żądanie na wejściu, każde zdarzenie na wyjściu

Utwórz przesyłkę z id reguły wysyłki, a przewoźnik, usługa i adres nadawcy zostaną wybrane za ciebie. Potem każda zmiana trafia na twój endpoint jako podpisany webhook.

Serwer MCP dla agentów

Skieruj Claude, Cursor lub ChatGPT na api.zippendo.com/mcp, a agent będzie tworzył przesyłki, śledził paczki i czytał twoje zamówienia z uprawnieniami, które zatwierdzisz.

Potrzebujesz tylko przewoźników?

  • Etykiety
  • Śledzenie przesyłek
  • Punkty odbioru
  • Wyceny wysyłki

Dostęp do API

100%

planów, łącznie z Free

Nowi przewoźnicy

1 tydzień

tyle zwykle zajmuje nam podłączenie przewoźnika, którego potrzebujesz

Co dalej

  • Dokumentacja API

    Każdy endpoint, treść żądania i odpowiedź, z interaktywnym środowiskiem testowym.

    Otwórz dokumentację
  • SDK

    TypeScript, Python, PHP, Go, Ruby, Java i C#, generowane z tej samej specyfikacji.

    Wybierz język
  • Własne kanały sprzedaży

    Twój własny sklep lub ERP jako źródło zamówień, wysyłanych do nas lub pobieranych przez API.

    Zbuduj kanał
  • Serwer MCP

    Połącz Claude, Cursor lub ChatGPT ze swoim kontem przez OAuth.

    Połącz agenta

Poradniki

  • Integracja z API przewoźników

    Czego wymaga samodzielna integracja z przewoźnikami i kiedy jedno API wysyłkowe jest prostszą drogą.

    Przeczytaj poradnik
  • kody HS

    Znajdź właściwy kod taryfy celnej dla każdego produktu i sprawdź, gdzie wpisać go w dokumentach celnych.

    Przeczytaj poradnik