لمطوّري الوكلاء والشركات التي تستعين بالذكاء الاصطناعي

امنحوا وكلاءكم أعمالاً يمكنهم تنفيذها.

يربط وكيلكم المعلومات ببعضها. وتربط 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 };
}

التقنية وراء سير العمل

يمكن لوكيلك عبر واجهة Ysend البرمجية قراءة المخزون وإرسال الطلبات ومراجعة الطلبات التي تحتاج إلى تصحيح، ثم متابعة الشحنات وفتح المرتجعات. وعندما يعيد تنفيذ تغيير، يستخدم مفتاح الطلب نفسه حتى لا يُنشأ أي شيء مرتين.

في متناول أيديكم

تتابع الفرق المخوّلة الطلبات والمرتجعات في مساحة التاجر على الهاتف؛ ويستخدم موظفو المستودع مسارات المسح المدعومة بالأجهزة المحمولة.

التطبيقات

تتبّع العملية

كيف تعمل أعمالكم.

من ينفّذ هذه الخطوةتطبيقك / وكيلك

01. اتخذ القرار بناءً على المخزون المتاح، لكل SKU على حدة.

اقرأ الرصيد ضمن نطاق المستودع قبل إرسال الطلبات. يطبّق تطبيقك قواعد البيع على المخزون المتاح بعد الالتزامات القائمة قبل اقتراح طلبات جديدة.

القرار التالي

يمكن لتطبيقك اقتراح هذه الطلبات. يظل مخزون المستودع خاضعًا للعمليات المادية.

من ينفّذ هذه الخطوةالتكامل لديك ← طلبات Ysend

02. استورد الدفعة واقرأ النتيجة.

أرسل مراجع المنتجات المعروفة وبيانات المستلمين والكميات بمرجع دفعة ثابت. تفصل الاستجابة الصفوف المقبولة عن المحتجزة للتصحيح؛ نجاح الطلب التقني وحده لا يكفي.

القرار التالي

دع الطلبات المقبولة تتقدّم. راجع الاستثناءات قبل اعتبار الدفعة مكتملة.

من ينفّذ هذه الخطوةالتكامل لديك ومراجع الكتالوج

03. صحّح المراجع، ثم أعد الإرسال صراحةً.

راجع قائمة العزل المقسّمة إلى صفحات في الحساب وحدّد الصفوف المعنية. عالج كل مرجع منتج، وصحّح الصف، ثم أعد إرساله بمفتاح إعادة محاولة ثابت ومميّز لتلك العملية.

القرار التالي

التصحيح وإعادة الإرسال إجراءان منفصلان. أكّد نتيجة كل منهما قبل إغلاق الاستثناء.

من ينفّذ هذه الخطوةمشغّل المستودع

04. حوّل الطلبات المقبولة إلى طرود فعلية.

ينفّذ المستودع الطلبات المقبولة عبر الالتقاط والتعبئة. يحدّد المشغّلون المنتج ويكملون الفحوص المطلوبة؛ ويتابع وكيلك تقدّم الطلب بدل أن يعلن بنفسه اكتمال العمل المادي.

القرار التالي

يعالج موظفو المستودع المسح الناقص أو استثناء التعبئة قبل تسليم الطرد المعني للنقل.

من ينفّذ هذه الخطوةتطبيقك وخدمة العملاء

05. استخدم أدلة الشحن لتحديد من يحتاج إلى المتابعة.

يحتفظ تطبيقك بمعرّف الشحنة الذي يوفّره التكامل أو التسليم التشغيلي، ثم يقرأ تلك الشحنة. تتطلّب قراءة الشحنة عبر SDK هذا المعرّف المعروف؛ ولا تكتشف رابطًا بين الطلب والشحنة.

القرار التالي

يطبّق تطبيقك قواعد التواصل لديه باستخدام أحداث الشحنة المتاحة.

من ينفّذ هذه الخطوةخدمة العملاء ← فريق المرتجعات

06. أبقِ خدمة ما بعد البيع مرتبطة بالطلب الأصلي.

عندما يبلّغ عميل عن تلف بعد التسليم، افتح إرجاعًا مرتبطًا بذلك الطلب وأضف الأدلة. يسجّل فريق المرتجعات المعالجة المادية؛ وتحدّد شركتك الاستجابة التجارية بناءً على هذا السجل.

القرار التالي

فتح الإرجاع هو بداية خدمة ما بعد البيع. يظل الفحص وتحديد مصير المخزون وأي استرداد مالي قرارات منفصلة.

ما يجب تضمينه في نموذج التكاليف

تنفيذ الطلبات
اتفق مع فريق العمليات على الاستلام والتخزين والالتقاط والتعبئة والمواد.
النقل وخدمة ما بعد البيع
راجع خصائص الطرود والوجهات واستثناءات التسليم ومعالجة المرتجعات كلًا على حدة.
الأتمتة لديك
أدرج استضافة الوكيل واستخدام النموذج والمتجر وتكاليف خدمة العملاء في نموذج أعمالك.

ما يلزم لجاهزية أول عملية

  1. الوصول والكتالوج

    يحمل مفتاح الخادم النطاقات المطلوبة، وتشير مراجع منتجاتك إلى الأصناف الصحيحة في المستودع.

  2. دفعة اختبار مكتملة

    يمكنك قراءة الصفوف المقبولة والعثور على صف معزول وتصحيحه وتأكيد إعادة إرساله الصريحة.

  3. حالة عميل متكاملة

    يمكن لفريقك ربط الطلب بشحنته وإرجاعه، مع مسؤول عن كل قرار لم يُحسم.

قبل البدء

هل يمكنني ربط إطار الوكلاء الخاص بي؟

نتحقق من اتصال تطبيقكم بواجهات API المدعومة وصلاحيات الحساب المطلوبة. حزمة SDK لبنة للتكامل؛ ويُجهّز وصول الوكلاء الخارجيين مع فريق Ysend.

هل يحل الوكيل محل فريق المستودع؟

يمكن للوكلاء العمل بالبيانات التشغيلية المتاحة والإجراءات المدعومة. وتبقى المناولة الفعلية والقرارات التجارية والعمليات التي تتطلب موافقة تحت مسؤولية فرقها وضوابطها.

كيف أحصل على SDK؟

تُقدّم حزمة SDK بإصدار محدد عبر بوابة المطوّرين المخوّلة. نؤكد بيئتكم وبيانات الاعتماد ونطاق التكامل أثناء الإعداد.

خطّطوا للخطوة التالية

ابدؤوا بسير عمل حقيقي واحد.

أخبرونا بما يجب أن يقرأه الوكيل، والإجراءات التي ينبغي أن ينسّقها، ومكان إدارة الطلبات والمخزون حالياً. سنحدد مسار الربط مع فريقكم.

التحضير لأول عملية

  • اتفق على الكتالوج والمستودع ونطاق التكامل.
  • اختبر طلبًا ممثلًا ومسار الاستثناء الخاص به.
  • حدّد القرارات التي يمكن لتطبيقك اتخاذها.