Dla twórców agentów i firm wspieranych przez AI

Daj swoim agentom możliwość obsługi rzeczywistych procesów biznesowych.

Twój agent łączy informacje. Ysend łączy zamówienia, zapasy, pracę magazynu i postęp wysyłki. Dzięki temu cyfrowa decyzja prowadzi do konkretnego następnego kroku w operacjach.

Twój agent lub aplikacja
Ysend API + TypeScript SDK
  • Zapasy
  • Zamówienia
  • Przesyłki
  1. Zespoły magazynowe
  2. Przekazanie przewoźnikowi
  3. Postęp dostawy

Twórz rozwiązania oparte na znanych obiektach biznesowych.

TypeScript SDK udostępnia zapasy, zamówienia i przesyłki jako domeny z określonymi typami danych. Zacznij od niewielkiego procesu odczytu po stronie serwera, a następnie uzgodnij operacje potrzebne Twojej integracji.

TypeScript po stronie serwera · SDK udostępniany przez portal dla programistów po autoryzacji dostępu
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 });
Udany import może zawierać odrzucone wiersze.

Sprawdź przyczynę, popraw wiersz lub powiązanie i prześlij go ponownie.

Przykład po stronie serwera: result opisuje import. queuePage to jedna strona kolejki kwarantanny konta; pobierz kolejne strony i przyporządkuj wiersze do właściwej partii.
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 };
}

Technologia stojąca za procesem

Twój agent może przez API Ysend odczytywać stany, wysyłać zamówienia, przeglądać zamówienia do poprawy, a potem śledzić wysyłki i otwierać zwroty. Gdy ponawia zmianę, używa tego samego klucza żądania, aby nic nie powstało dwa razy.

Zawsze pod ręką

Uprawnione zespoły śledzą zamówienia i zwroty w mobilnym obszarze sprzedawcy. Magazynierzy korzystają z obsługiwanych procesów skanowania na terminalach.

Aplikacje

Prześledź operację

Jak działa Twój biznes.

Kto wykonuje ten krokTwoja aplikacja / agent

01. Decyduj na podstawie dostępnego zapasu, dla każdego SKU.

Przed przekazaniem popytu odczytaj stan właściwego magazynu. Aplikacja uwzględnia istniejące rezerwacje i stosuje własne reguły sprzedaży do dostępnego zapasu, zanim zaproponuje nowe zamówienia.

Następna decyzja

Aplikacja może zaproponować ten popyt. Fizyczne operacje magazynowe nadal kontrolują zapas.

Kto wykonuje ten krokTwoja integracja → zamówienia Ysend

02. Zaimportuj partię i odczytaj wynik.

Prześlij rozpoznawane symbole produktów, dane odbiorców i ilości ze stałym identyfikatorem partii. Odpowiedź rozdziela przyjęte wiersze i wiersze zatrzymane do poprawy; samo powodzenie żądania nie wystarcza.

Następna decyzja

Pozwól kontynuować przyjętym zamówieniom. Sprawdź wyjątki przed uznaniem partii za kompletną.

Kto wykonuje ten krokTwoja integracja i kontroler katalogu

03. Popraw symbole i jawnie prześlij ponownie.

Przejrzyj stronicowaną kolejkę wyjątków konta i znajdź właściwe wiersze. Wyjaśnij każdy symbol, popraw dane i prześlij wiersz ponownie z odrębnym stałym kluczem ponowienia dla tej operacji.

Następna decyzja

Poprawa i ponowne przesłanie to osobne czynności. Potwierdź każdy wynik przed zamknięciem wyjątku.

Kto wykonuje ten krokOperator magazynu

04. Zamień przyjęte zamówienia w fizyczne paczki.

Magazyn kompletuje i pakuje przyjęty popyt. Pracownicy identyfikują produkt i wykonują wymagane kontrole; agent śledzi postęp, zamiast samodzielnie oznaczać pracę fizyczną jako zakończoną.

Następna decyzja

Magazyn wyjaśnia brak skanu lub błąd pakowania przed przekazaniem danej paczki do transportu.

Kto wykonuje ten krokTwoja aplikacja i obsługa klienta

05. Ustal potrzebne działania na podstawie wysyłki.

Aplikacja zachowuje identyfikator przesyłki przekazany przez integrację lub w toku obsługi operacyjnej, a następnie odczytuje tę przesyłkę. Odczyt SDK potrzebuje znanego identyfikatora; nie wykrywa powiązania zamówienia z przesyłką.

Następna decyzja

Aplikacja stosuje własne reguły komunikacji na podstawie dostępnych zdarzeń przesyłki.

Kto wykonuje ten krokObsługa klienta → zespół zwrotów

06. Powiąż obsługę posprzedażową z pierwotnym zamówieniem.

Gdy klient zgłasza uszkodzenie po doręczeniu, otwórz zwrot przy tym zamówieniu i dodaj dowody. Zespół zwrotów rejestruje obsługę fizyczną; Twoja firma na tej podstawie podejmuje decyzję handlową.

Następna decyzja

Otwarcie zwrotu rozpoczyna obsługę. Inspekcja, dyspozycja zapasu i ewentualny zwrot pieniędzy pozostają osobnymi decyzjami.

Co uwzględnić w modelu kosztów

Realizacja logistyczna
Uzgodnij z operacją przyjęcie, składowanie, kompletację, pakowanie i materiały.
Transport i obsługa posprzedażowa
Oddzielnie oceń parametry paczek, miejsca dostawy, problemy doręczenia i obsługę zwrotów.
Twoja automatyzacja
Uwzględnij hosting agenta, użycie modeli, sklep i obsługę klienta w swoim modelu biznesowym.

Co przygotowuje pierwszą operację

  1. Dostęp i katalog

    Klucz serwerowy ma właściwe uprawnienia, a symbole prowadzą do odpowiednich artykułów magazynowych.

  2. Pełna partia próbna

    Potrafisz odczytać przyjęte wiersze, znaleźć wyjątek, poprawić go i potwierdzić jawne ponowne przesłanie.

  3. Pełna sprawa klienta

    Zespół łączy zamówienie z przesyłką i zwrotem oraz przypisuje właściciela każdej otwartej decyzji.

Zanim zaczniesz

Czy mogę podłączyć własny framework agentów?

Weryfikujemy połączenie Twojej aplikacji z obsługiwanymi API i wymaganymi uprawnieniami konta. SDK jest elementem integracji. Dostęp agentów zewnętrznych przygotowujemy wspólnie z zespołem Ysend.

Czy agent zastępuje zespół magazynowy?

Agenci mogą korzystać z udostępnionych danych operacyjnych i obsługiwanych działań. Fizyczna obsługa towarów, decyzje handlowe i operacje wymagające zatwierdzenia nadal mają własne zespoły odpowiedzialne i mechanizmy kontroli.

Jak uzyskać SDK?

SDK jest udostępniany jako wersjonowany pakiet przez portal dla programistów po autoryzacji dostępu. Podczas wdrożenia potwierdzamy środowisko, dane uwierzytelniające i zakres integracji.

Zaplanuj następny krok

Zacznij od jednego rzeczywistego procesu biznesowego.

Powiedz nam, co agent ma odczytywać, jakie działania powinien koordynować oraz gdzie dziś zarządzasz zamówieniami i zapasami. Zaplanujemy połączenie wspólnie z Twoim zespołem.

Przygotuj pierwszą operację

  • Uzgodnij katalog, magazyn i zakres integracji.
  • Przetestuj typowe zamówienie oraz ścieżkę wyjątku.
  • Określ decyzje dozwolone Twojej aplikacji.