انشر تكامل نظامك
على متجرة.

بوالص ERP والإرجاع والاستبدال

في المتاجر المجهزة والمفعّل لها هذا العقد، يستطيع تطبيق ERP عادي تسجيل بوليصة أمامية تم حجزها مسبقًا عبر PUT /api/app-center/v1/orders/{id}/fulfillment بصلاحية orders.write وترويسة Idempotency-Key فريدة. القراءة عبر GET للمسار نفسه بصلاحية orders.read. أرسل awb_number، واختياريًا tracking_number وtracking_link برابط HTTPS وlabel_url لملف PDF عام. التسجيل لا يحجز شحنة ولا يغيّر حالة الطلب أو المدفوعات أو المخزون. التعارض مع بوليصة موجودة أو تطبيق آخر يعيد 409؛ يستطيع التطبيق المالك تحديث التتبع أو إصلاح الملصق بنفس البوليصة ومفتاح جديد.

يستقبل ERP بصلاحية returns.read أحداث return.created وreturn.updated المدعومة. تتضمن قراءة المرتجع request_kind بالقيم return أو exchange أو mixed، وreturn_context الذي يربط return_id وoriginal_order_id وexchange_id وreplacement_order_id وexchange_state والمنتجات المرتجعة والبديلة والشحنات المرتبطة. قراءة الطلب وأحداثه تتضمن return_contexts؛ وتحدد is_replacement أن الطلب بديل. أرقام إجراءات المرتجع قابلة للتعديل لكل متجر وليست قيمًا موحدة.

اختيار إرجاع أو استبدال لا ينشئ شحنات تلقائيًا. يحدد التاجر المنتجات البديلة، ويستوفي متطلبات الرصيد أو الدفع، ويعتمد الطلب البديل، ثم يطلب صراحةً الشحنة العكسية والشحنة الأمامية البديلة. يستقبل تطبيق الشحن فقط shipment.creating باتجاه return أو forward مع return_context المشترك عند الربط، ولا يستقبل أحداث المرتجعات العامة دون returns.read. تُرفق بوليصة كل شحنة ويُحدّث تتبعها منفصلًا. قراءة GET /shipments/{id} تُحدّث روابط الشحنات بعد إنشاء الطرف الآخر.

رقم shipment_id في App Center فريد عبر المتاجر داخل البيئة نفسها، مع بقاء الوصول مقيدًا بالتثبيت المالك. أرقام الشحنات الداخلية وorder_id وreturn_id وexchange_id محلية للمتجر؛ احفظها مع store_id. راجع مرجع API للأمثلة وحدود PDF وإعادة المحاولة والتوفر.