למפתחי סוכנים ולעסקים הנעזרים בבינה מלאכותית

תנו לסוכנים שלכם פעילות עסקית שאפשר לבצע.

הסוכן שלכם מחבר בין המידע. 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 מסופק כחבילה בעלת גרסה דרך פורטל המפתחים המורשה. נאשר את הסביבה, פרטי ההזדהות והיקף האינטגרציה בתהליך ההצטרפות.

תכננו את הצעד הבא

התחילו מתהליך עסקי אמיתי אחד.

ספרו לנו מה הסוכן צריך לקרוא, אילו פעולות עליו לתאם והיכן מנוהלים ההזמנות והמלאי כיום. נמפה את החיבור יחד עם הצוות שלכם.

הכנה לפעולה הראשונה

  • סכמו את הקטלוג, המחסן והיקף האינטגרציה.
  • בדקו הזמנה מייצגת ואת מסלול החריגה שלה.
  • הגדירו אילו החלטות האפליקציה שלכם רשאית לקבל.