Для разработчиков агентов и бизнеса с поддержкой ИИ

Дайте агентам реальные бизнес-задачи.

Ваш агент связывает информацию. Ysend связывает заказы, остатки, работу склада и ход доставки, чтобы за цифровым решением следовал реальный операционный шаг.

Ваш агент или приложение
Ysend API + TypeScript SDK
  • Остатки
  • Заказы
  • Отправления
  1. Складские команды
  2. Передача перевозчику
  3. Ход доставки

Разрабатывайте на знакомых бизнес-объектах.

TypeScript SDK предоставляет типизированные разделы для остатков, заказов и отправлений. Начните с небольшого серверного сценария чтения, затем проверьте операции, необходимые вашей интеграции.

Серверный TypeScript · SDK поставляется через портал разработчика с авторизованным доступом
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 });
Импорт может завершиться успешно с отклонёнными строками.

Изучите причину, исправьте строку или её сопоставление и отправьте повторно.

Пример на стороне сервера: result описывает импорт. queuePage содержит одну страницу очереди карантина аккаунта; переберите страницы и сопоставьте строки с нужной партией.
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 };
}

Технология, на которой строится процесс

Ваш агент может через API Ysend читать остатки, отправлять заказы, просматривать заказы, которые нужно исправить, а затем следить за отправлениями и оформлять возвраты. Повторяя изменение, он использует тот же ключ запроса, чтобы ничего не создалось дважды.

Всегда под рукой

Уполномоченные команды следят за заказами и возвратами в мобильном пространстве продавца; складские сотрудники используют поддерживаемое сканирование на терминалах.

Приложения

Проследить операцию

Как работает ваш бизнес.

Кто выполняет этот шагВаше приложение / агент

01. Решайте по доступному запасу, для каждого SKU.

Прочитайте остаток в области склада до передачи спроса. До предложения новых заказов приложение применяет свои правила продаж к доступному запасу после существующих обязательств.

Следующее решение

Ваше приложение может предложить этот спрос. Складской запас остаётся под контролем физических операций.

Кто выполняет этот шагВаша интеграция → заказы Ysend

02. Импортируйте партию и прочитайте результат.

Отправьте распознанные артикулы, данные получателей и количества со стабильным идентификатором партии. Ответ отделяет принятые строки от удержанных для исправления; одного успешного запроса недостаточно.

Следующее решение

Разрешите принятым заказам продолжить обработку. Проверьте отклонения до признания партии завершённой.

Кто выполняет этот шагВаша интеграция и проверяющий каталог

03. Исправьте артикулы, затем явно отправьте повторно.

Просмотрите постраничную очередь изолированных строк аккаунта и найдите затронутые записи. Разрешите каждый артикул, исправьте строку и отправьте её снова с отдельным стабильным ключом повтора для этой операции.

Следующее решение

Исправление и повторная отправка — отдельные действия. Подтвердите каждый результат до закрытия отклонения.

Кто выполняет этот шагОператор склада

04. Превратите принятые заказы в физические посылки.

Склад проводит принятый спрос через комплектацию и упаковку. Операторы идентифицируют товар и выполняют проверки; агент следит за заказом, а не сам отмечает физическую работу выполненной.

Следующее решение

Складские сотрудники устраняют недостающее сканирование или отклонение упаковки до передачи затронутой посылки в перевозку.

Кто выполняет этот шагВаше приложение и поддержка клиентов

05. Определяйте нужное внимание по подтверждениям отправления.

Приложение сохраняет идентификатор отправления из интеграции или операционной передачи, затем читает это отправление. Чтению отправления в SDK нужен известный идентификатор; оно не обнаруживает связь заказа с отправлением.

Следующее решение

Приложение применяет свои правила общения по доступным событиям отправления.

Кто выполняет этот шагПоддержка клиентов → команда возвратов

06. Сохраняйте связь обслуживания с исходным заказом.

Если покупатель сообщает о повреждении после доставки, откройте возврат по заказу и добавьте подтверждения. Команда возвратов фиксирует физическую обработку; ваш бизнес решает коммерческий ответ по этой записи.

Следующее решение

Открытый возврат — начало обслуживания. Осмотр, решение о запасе и возврат денег остаются отдельными решениями.

Что включить в модель затрат

Выполнение заказов
Согласуйте приёмку, хранение, комплектацию, упаковку и материалы с операционной командой.
Перевозка и сопровождение
Проверяйте характеристики посылок, направления, отклонения доставки и обработку возвратов отдельно.
Ваша автоматизация
Включите в бизнес-модель расходы на размещение агента, модели, магазин и поддержку клиентов.

Что нужно для готовности первой операции

  1. Доступ и каталог

    Серверный ключ имеет нужные области доступа, а артикулы соответствуют правильным складским товарам.

  2. Полная тестовая партия

    Вы можете прочитать принятые строки, найти изолированную строку, исправить и подтвердить её явную повторную отправку.

  3. Полный клиентский случай

    Команда может связать заказ с отправлением и возвратом, назначив ответственного за каждое нерешённое решение.

Перед началом работы

Можно подключить собственный агентный фреймворк?

Мы проверяем подключение вашего приложения к поддерживаемым API с учётом необходимых прав аккаунта. SDK — компонент интеграции; доступ внешних агентов готовится с командой Ysend.

Заменяет ли агент складскую команду?

Агенты могут работать с предоставленными операционными данными и поддерживаемыми действиями. Физическая обработка, коммерческие решения и операции, требующие согласования, остаются за ответственными командами и их средствами контроля.

Как получить SDK?

SDK предоставляется как версионированный пакет через авторизованный портал разработчика. При подключении мы подтверждаем среду, учётные данные и область интеграции.

Спланируйте следующий шаг

Начните с одного реального бизнес-процесса.

Расскажите, какие данные агент должен читать, какие действия координировать и где сейчас ведутся заказы и остатки. Мы спланируем подключение вместе с вашей командой.

Подготовить первую операцию

  • Согласуйте каталог, склад и область интеграции.
  • Проверьте типичный заказ и путь его отклонений.
  • Определите, какие решения может принимать ваше приложение.