Für Agentenentwickler & KI-gestützte Unternehmen

Machen Sie reale Geschäftsabläufe für Ihre Agenten nutzbar.

Ihr Agent erkennt die Zusammenhänge. Ysend verbindet Aufträge, Bestand, Lagerarbeit und Versandfortschritt. So wird aus einer digitalen Entscheidung ein konkreter nächster Schritt im Betrieb.

Ihr Agent oder Ihre Anwendung
Ysend API + TypeScript SDK
  • Bestand
  • Aufträge
  • Sendungen
  1. Lagerteams
  2. Übergabe an den Transportdienstleister
  3. Zustellfortschritt

Entwickeln Sie mit vertrauten Geschäftsobjekten.

Das TypeScript SDK stellt Bestand, Aufträge und Sendungen als typisierte Fachbereiche bereit. Beginnen Sie mit einem kleinen serverseitigen Leseablauf und klären Sie anschließend, welche Operationen Ihre Integration benötigt.

Serverseitiges TypeScript · SDK über Ihr autorisiertes Entwicklerportal erhältlich
import { Ysend } from "@ysend/sdk";

const ysend = new Ysend({
  baseUrl: process.env.YSEND_API_BASE_URL!,
  apiKey: process.env.YSEND_API_KEY!,
});

const stock = await ysend.inventory.listBalances({ page: 1, pageSize: 20 });
const orders = await ysend.orders.list({ status: "Open", page: 1, pageSize: 20 });
const shipments = await ysend.shipments.list({ page: 1, pageSize: 20 });
Ein erfolgreicher Import kann abgelehnte Zeilen enthalten.

Prüfen Sie den Grund, korrigieren Sie die Zeile oder Zuordnung und reichen Sie sie erneut ein.

Serverseitiges Beispiel: result beschreibt den Import. queuePage enthält eine Seite der Quarantäne des Kontos; weitere Seiten abrufen und Zeilen dem jeweiligen Stapel zuordnen.
import type {
  Ysend, ImportPortalOrdersInput,
  CorrectPortalOrderImportRowInput, ResubmitOrderImportInput,
} from "@ysend/sdk";

export async function importBatch(
  ysend: Ysend, input: ImportPortalOrdersInput, operationKey: string,
) {
  const result = await ysend.orders.importManual(input, operationKey);
  // Quarantined rows are not imported orders. null means a count was not returned.
  return { imported: result.imported ?? null, quarantined: result.quarantined ?? null };
}

export async function listExceptionPage(ysend: Ysend, page: number) {
  // Tenant-wide queue, not this batch's results. Review further pages as needed.
  // Match batchReference and orderCode before choosing an exception to correct.
  return ysend.orders.listQuarantine({ page, pageSize: 20 });
}

export async function correctOrder(
  ysend: Ysend, exceptionId: number,
  correction: CorrectPortalOrderImportRowInput, operationKey: string,
) {
  // Saves the correction only. A separate, authorised action must resubmit it.
  await ysend.orders.correctQuarantinedRow(
    exceptionId, correction, operationKey,
  );
}

export async function resubmitOrder(
  ysend: Ysend, exceptionId: number,
  resubmission: ResubmitOrderImportInput, operationKey: string,
) {
  // Use this resubmission's own stable key; inspect the returned counts again.
  const result = await ysend.orders.resubmitQuarantinedRow(
    exceptionId, resubmission, operationKey,
  );
  return { imported: result.imported ?? null, quarantined: result.quarantined ?? null };
}

Die Technik hinter dem Ablauf

Ihr Agent kann über die Ysend-API Bestände lesen, Aufträge senden, zu korrigierende Aufträge prüfen und anschließend Sendungen verfolgen und Retouren anlegen. Wiederholt er eine Änderung, verwendet er denselben Anfrageschlüssel, damit nichts doppelt angelegt wird.

Auch mobil im Blick

Berechtigte Teams verfolgen Aufträge und Retouren im mobilen Händlerbereich. Lagerpersonal nutzt die unterstützten Scanabläufe auf Handhelds.

Anwendungen

Den Ablauf verfolgen

So funktioniert Ihr Geschäft.

Wer diesen Schritt übernimmtIhre Anwendung / Ihr Agent

01. Anhand verfügbaren Bestands entscheiden, SKU für SKU.

Lesen Sie vor der Bedarfsübermittlung den Bestand des betreffenden Lagers. Ihre Anwendung berücksichtigt bestehende Belegungen und wendet ihre Verkaufsregeln auf die verfügbare Menge an, bevor sie neue Aufträge vorschlägt.

Die nächste Entscheidung

Ihre Anwendung kann diesen Bedarf vorschlagen. Physische Lagerprozesse steuern weiterhin den Bestand.

Wer diesen Schritt übernimmtIhre Integration → Ysend-Aufträge

02. Den Stapel importieren und das Ergebnis prüfen.

Senden Sie bekannte Produktreferenzen, Empfängerdaten und Mengen mit einer stabilen Stapelreferenz. Das Ergebnis trennt angenommene von korrekturbedürftigen Zeilen; eine erfolgreiche Anfrage allein reicht nicht.

Die nächste Entscheidung

Lassen Sie angenommene Aufträge weiterlaufen. Prüfen Sie die Ausnahmen vor Abschluss des Stapels.

Wer diesen Schritt übernimmtIhre Integration und Katalogprüfung

03. Referenzen korrigieren und ausdrücklich erneut übermitteln.

Prüfen Sie die seitenweise abrufbare Ausnahmewarteschlange Ihres Kontos. Klären und korrigieren Sie jede betroffene Produktreferenz; übermitteln Sie die Zeile mit einem eigenen stabilen Wiederholungsschlüssel für diesen Vorgang erneut.

Die nächste Entscheidung

Korrektur und erneute Übermittlung sind getrennte Aktionen. Bestätigen Sie beide Ergebnisse vor Abschluss.

Wer diesen Schritt übernimmtLagerpersonal

04. Aus angenommenen Aufträgen echte Pakete machen.

Das Lager kommissioniert und verpackt den angenommenen Bedarf. Mitarbeitende identifizieren Produkte und führen erforderliche Kontrollen aus; Ihr Agent verfolgt den Fortschritt, statt physische Arbeit selbst als erledigt zu markieren.

Die nächste Entscheidung

Fehlende Scans oder Verpackungsabweichungen klärt das Lager vor Übergabe des betroffenen Pakets an den Transport.

Wer diesen Schritt übernimmtIhre Anwendung und Kundendienst

05. Anhand von Versandnachweisen den Handlungsbedarf erkennen.

Ihre Anwendung speichert die Sendungskennung aus ihrer Integration oder Betriebsübergabe und liest damit die Sendung. Der SDK-Abruf benötigt die bekannte Kennung und ermittelt keine Auftrags-Sendungs-Verknüpfung.

Die nächste Entscheidung

Ihre Anwendung wendet ihre Kommunikationsregeln auf die verfügbaren Sendungsereignisse an.

Wer diesen Schritt übernimmtKundendienst → Retourenteam

06. Nachbetreuung mit dem ursprünglichen Auftrag verbinden.

Meldet ein Kunde nach der Zustellung einen Schaden, eröffnen Sie eine auftragsbezogene Retoure und ergänzen Sie Belege. Das Retourenteam erfasst die physische Bearbeitung; Ihr Unternehmen entscheidet daraus über die kaufmännische Lösung.

Die nächste Entscheidung

Die Retoure eröffnet die Nachbetreuung. Prüfung, Bestandsverwendung und mögliche Erstattung bleiben getrennte Entscheidungen.

Was in Ihre Kostenplanung gehört

Lagerleistungen
Wareneingang, Lagerung, Kommissionierung, Verpackung und Material mit dem Betrieb vereinbaren.
Transport und Nachbetreuung
Paketdaten, Ziele, Zustellabweichungen und Retourenbearbeitung getrennt betrachten.
Ihre Automatisierung
Agentenhosting, Modellnutzung, Shop und Kundendienst in Ihr Geschäftsmodell einrechnen.

Was den ersten Ablauf startklar macht

  1. Zugriff und Katalog

    Ein serverseitiger Schlüssel besitzt die vorgesehenen Berechtigungen; Produktreferenzen führen zu den richtigen Lagerartikeln.

  2. Vollständiger Teststapel

    Angenommene Zeilen lesen, eine Ausnahme finden, korrigieren und die ausdrückliche erneute Übermittlung bestätigen.

  3. Vollständiger Kundenfall

    Ihr Team verbindet Auftrag, Sendung und Retoure und benennt Verantwortliche für jede offene Entscheidung.

Vor dem Start

Kann ich mein eigenes Agenten-Framework anbinden?

Wir prüfen die Anbindung Ihrer Anwendung anhand der unterstützten APIs und der erforderlichen Kontoberechtigungen. Das SDK ist ein Baustein für die Integration. Der Zugriff externer Agenten wird mit dem Ysend-Team vorbereitet.

Ersetzt ein Agent das Lagerteam?

Agenten können mit bereitgestellten Betriebsdaten und unterstützten Aktionen arbeiten. Für die physische Warenbearbeitung, kaufmännische Entscheidungen und freigabepflichtige Vorgänge bleiben die jeweils zuständigen Teams und Kontrollen verantwortlich.

Wie erhalte ich das SDK?

Das SDK wird als versioniertes Paket über das autorisierte Entwicklerportal bereitgestellt. Beim Onboarding stimmen wir Ihre Umgebung, Zugangsdaten und den Integrationsumfang ab.

Den nächsten Schritt planen

Beginnen Sie mit einem konkreten Geschäftsablauf.

Beschreiben Sie, was Ihr Agent lesen und welche Aktionen er koordinieren soll. Teilen Sie uns mit, wo Aufträge und Bestände heute verwaltet werden. Wir planen die Anbindung gemeinsam mit Ihrem Team.

Den ersten Einsatz vorbereiten

  • Katalog, Lager und Integrationsumfang abstimmen.
  • Einen typischen Auftrag samt Ausnahmefall testen.
  • Die zulässigen Entscheidungen Ihrer Anwendung festlegen.