Jedno API · wszyscy kurierzy

Wszyscy kurierzy.Jedno API.

Deliverio ujednolica API InPost, DHL, DPD, GLS i innych do jednego, spójnego interfejsu. Twórz przesyłki, generuj etykiety i śledź paczki — synchronicznie lub asynchronicznie.

Pierwsze 20 przesyłek gratis
8+wspieranych kurierów
0,05 złza etykietę
Tracking gratisbez limitów zapytań
POST /v1/shipments
# Jedno żądanie — dowolny kurier curl -X POST https://api.deliverio.org/v1/shipments \ -H "Authorization: Bearer dlv_live_•••" \ -d '{ "mode": "sync", "carrier": "inpost", "to": { "point": "KRA010" }, "parcel": { "weight": 1200 } }'
● 201 Created · etykieta w ~600 ms { "id": "shp_8Kd2x", "tracking_number": "6200410...", "label_url": "https://.../label.pdf", "status": "confirmed" }

Jedna integracja. Wszyscy najwięksi przewoźnicy.

Możliwości

Wszystko, czego potrzebujesz do wysyłki — w jednym API.

Przestań utrzymywać osobne integracje dla każdego kuriera. Deliverio robi to za Ciebie.

Ujednolicone API

Jeden format żądań i odpowiedzi dla wszystkich przewoźników. Zmiana kuriera to zmiana jednego pola.

RESTJSONwebhooks

Etykiety na żądanie

Gotowe do druku etykiety PDF i ZPL. Synchronicznie w odpowiedzi lub asynchronicznie przez webhook.

PDFZPLsync / async

Tracking w czasie rzeczywistym

Znormalizowane statusy ze wszystkich kurierów plus webhooki o zmianach. Całkowicie za darmo.

webhooks0 zł

Sync i async

Potrzebujesz etykiety natychmiast? Tryb sync. Masowa wysyłka w tle? Tryb async w kolejce.

202 Acceptedqueue

Niezawodność i retry

Idempotentne żądania, automatyczne ponawianie i failover. Awaria API kuriera nie zatrzyma Twojej wysyłki.

idempotencyretry

SDK i dokumentacja

Biblioteki dla Node, Python, PHP i innych. Przejrzysta dokumentacja i sandbox do testów.

NodePythonPHP
Jak to działa

Sync czy async — Ty decydujesz.

Ten sam endpoint, jedno pole mode. Wybierz natychmiastową odpowiedź albo przetwarzanie w tle.

Synchronicznie

mode: "sync"

Etykieta wraca w tej samej odpowiedzi. Idealne do checkoutu i pojedynczych przesyłek.

1
Wysyłasz żądaniePOST /v1/shipments z danymi paczki.
2
Deliverio woła kurieraTłumaczymy żądanie i czekamy na odpowiedź przewoźnika.
3
Dostajesz etykietę201 Created z numerem i linkiem do etykiety.

0,05 zł za etykietę · odpowiedź zwykle poniżej 1 s

Asynchronicznie

mode: "async"

Przyjmujemy żądanie natychmiast i przetwarzamy w tle. Idealne do masowej wysyłki.

1
Wysyłasz żądaniePojedynczo lub wsadowo, z tym samym formatem.
2
Odpowiedź 202 AcceptedDostajesz id przesyłki ze statusem queued. Żadnego czekania.
3
Webhook z etykietąGdy etykieta jest gotowa, wysyłamy zdarzenie label.ready.

0,03 zł za etykietę · skaluje się do tysięcy paczek

Developer-first

Integracja w kilka minut.

Czyste SDK, przewidywalne odpowiedzi i sandbox. Ten sam kod działa dla każdego kuriera.

Jeden klucz, wszyscy kurierzySkonfiguruj raz, przełączaj przewoźnika polem carrier.
Idempotencja w standardzieBezpieczne ponawianie bez ryzyka duplikatów przesyłek.
Sandbox bez kosztówTestuj na kluczu testowym — płacisz dopiero na produkcji.
curl -X POST https://api.deliverio.org/v1/shipments \
  -H "Authorization: Bearer $DELIVERIO_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "sync",
    "carrier": "dhl",
    "to":     { "name": "Jan Kowalski", "point": "KRA010" },
    "parcel": { "weight": 1200, "dims": [40,30,20] }
  }'
import { Deliverio } from "@deliverio/sdk";

const dlv = new Deliverio(process.env.DELIVERIO_KEY);

const shipment = await dlv.shipments.create({
  mode:    "sync",
  carrier: "dhl",
  to:      { name: "Jan Kowalski", point: "KRA010" },
  parcel:  { weight: 1200 },
});

console.log(shipment.label_url, shipment.tracking_number);
from deliverio import Deliverio

dlv = Deliverio(api_key=os.environ["DELIVERIO_KEY"])

shipment = dlv.shipments.create(
    mode="async",
    carrier="dpd",
    to={"name": "Jan Kowalski", "point": "KRA010"},
    parcel={"weight": 1200},
)

print(shipment.id, shipment.status)  # -> queued
$dlv = new Deliverio\Client(getenv('DELIVERIO_KEY'));

$shipment = $dlv->shipments->create([
  'mode'    => 'sync',
  'carrier' => 'gls',
  'to'      => ['name' => 'Jan Kowalski', 'point' => 'KRA010'],
  'parcel'  => ['weight' => 1200],
]);

echo $shipment->label_url;
Cennik

Płacisz tylko za etykiety.

Bez abonamentu, bez opłat startowych, bez ukrytych kosztów. Rozliczenie za faktyczne użycie.

Etykieta sync
0,05zł / etykietę

Etykieta generowana natychmiast w odpowiedzi na żądanie.

  • Odpowiedź zwykle poniżej 1 sekundy
  • Etykieta PDF / ZPL od ręki
  • Idealne do checkoutu
Najtaniej
Etykieta async
0,03zł / etykietę

Przesyłka w kolejce, etykieta dostarczana webhookiem.

  • Najniższa cena za etykietę
  • Wysyłka wsadowa tysięcy paczek
  • Webhook label.ready
Tracking
0 złna zawsze

Śledzenie statusów i webhooki — całkowicie za darmo.

  • Znormalizowane statusy kurierów
  • Webhooki o zmianach statusu
  • Bez limitu zapytań

Pierwsze 20 przesyłek gratis — testuj bez karty. Potem płacisz tylko za wygenerowane etykiety, rozliczenie miesięczne. Tracking zawsze za darmo.

FAQ

Częste pytania

W trybie sync etykieta wraca w tej samej odpowiedzi HTTP — najlepsze do pojedynczych przesyłek i checkoutu. W trybie async przyjmujemy żądanie natychmiast (202 Accepted), przetwarzamy w tle, a gotową etykietę dostarczamy webhookiem — idealne do masowej wysyłki. Async jest też tańszy: 0,03 zł zamiast 0,05 zł.

Możesz korzystać z własnych umów kurierskich, podłączając swoje dane dostępowe do Deliverio. Integracja, mapowanie pól i utrzymanie API leży po naszej stronie — Ty używasz jednego, spójnego interfejsu niezależnie od przewoźnika.

Tracking jest całkowicie darmowy — bez limitu zapytań i bez opłat za webhooki o zmianie statusu. Płacisz wyłącznie za wygenerowane etykiety.

Zwracamy etykiety w PDF (A4 i 10×15 cm) oraz ZPL do drukarek termicznych Zebra. Format wybierasz w żądaniu, niezależnie od kuriera.

Tak. Każde konto dostaje klucz testowy (dlv_test_…), który symuluje pełen przepływ tworzenia przesyłek, etykiet i trackingu bez żadnych kosztów. Płacisz dopiero za etykiety wygenerowane kluczem produkcyjnym.

Jedno API. Wszyscy kurierzy. Zacznij dziś.

Pobierz klucz testowy i wyślij pierwszą przesyłkę w mniej niż 5 minut.

$ npm i @deliverio/sdk