Bestellungen & Sendungen
Erstellen, lesen, verfolgen; verbindliche Angebote und Labelkauf.
Entwickler
Eine API, ein SDK, Webhooks, die ankommen.
Sie greifen mit einem aktivierten Konto auf die API zu; das TypeScript-SDK steht mit Ihren Schlüsseln im Entwicklerportal zum Download bereit.
Loslegen
In drei Schritten starten
- Ein Konto-Schlüssel
Sie erstellen ihn im Entwicklerportal, sobald Ihr Konto aktiviert ist.
- Das TypeScript-SDK
Versioniert, aus dem Portal heruntergeladen, mit angezeigtem Fingerabdruck.
- Ihr erster Aufruf
Erstellen Sie eine Sendung, erhalten Sie die Tracking-URL.
Webhooks
Webhooks, die ankommen
Sie erstellen ein Abonnement, testen es mit einem Ping und lesen den Zustellverlauf. Jedes Ereignis verlässt eine Outbox und wird bis zur Zustellung erneut versucht; was dauerhaft fehlschlägt, bleibt im Dead-Letter sichtbar.
Umfang
Was die API abdeckt
Sendungsverfolgung
Spediteur-Ereignisse, öffentliche Tracking-Seite.
Katalog & Bestand
Artikelnummern, SKU-Zuordnung, Bestandsposition.
Retouren
Retouren mit Fotos und Wiedereinlagerung.
Gehosteter Checkout
Zeitfenster, Packstationen, Gutscheine.
EDI & AS2
EDI X12, PIVOT/EANCOM, AS2-Empfang.
Partnerschlüssel
Konto-Schlüssel, Partnerschlüssel
Ihre Konto-Schlüssel erstellen und erneuern Sie im Entwicklerportal. Partnerbezogene Schlüssel — für einen Spediteur oder ein Lager des Netzwerks — werden von einem Ysend-Administrator ausgestellt, mit auf das Konto begrenztem Umfang.
import { YsendClient } from "@ysend/sdk";
const ysend = new YsendClient({ apiKey: process.env.YSEND_API_KEY });
const shipment = await ysend.shipments.create({
orderRef: "SHIP-2026-0501",
parcels: [{ weightKg: 1.2 }],
to: { country: "FR", postalCode: "06700" },
});
console.log(shipment.trackingUrl);API-Zugang erhalten
Ein aktiviertes Konto gibt Ihnen Zugriff auf die API, das SDK und die Webhooks.