> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryoto.com/llms.txt
> Use this file to discover all available pages before exploring further.

# الربط مع أنظمة ERP

> اربط نظام ERP مع OTO: حدّد أي نظام يملك أي بيانات، وما الذي ينتقل بينهما، والمعرّفات المهمة، وكيف يُبنى الربط.

نظام ERP هو عادةً المرجع الرسمي لما تملكه الشركة وما عليها من التزامات. أما OTO فهي المرجع الرسمي لكل ما هو في حركة. وربط النظامين يتلخص في الاتفاق على النقطة التي ينتهي عندها كل منهما.

## رسم الحدود

عمليات الربط التي تفشل هي تلك التي يعتقد فيها كلا النظامين أنه مالك المعلومة نفسها. أما الناجحة فترسم حدودًا وتلتزم بها.

| يملكه نظام ERP | تملكه OTO |
| - | - |
| البيانات الأساسية للمنتجات: ما الموجود، وما اسمه، وكم تكلفته | مكان كل وحدة فعليًا، وما هو محجوز منها لطلب معيَّن |
| السجلات المالية والفواتير والضريبة | سجلات الشحنات، ورسوم شركات الشحن، وإثبات التسليم |
| المشتريات والعلاقات مع الموردين | استلام الواردات مقابل أمر الشراء |
| العميل بوصفه كيانًا محاسبيًا | العميل بوصفه عنوان توصيل ورقم جوال |

> [!WARNING]
>
> **حدَّد من يملك المخزون، والتزم بقرارك**
>
> هذا هو القرار الذي يحدد ما إذا كانت عملية الربط ستسير بهدوء أم ستبقى محل خلاف دائم. إذا كان نظام ERP هو مالك المخزون، تُبلغ OTO عن الحركات ويتولى النظام المطابقة. وإذا كانت OTO هي المالكة، يستقبل نظام ERP الحركات ولا يكتب فوقها.
>
> ما لا ينجح هو أن يكتب النظامان مستويات المخزون للـ SKU نفسه في الموقع نفسه. والعرَض هو أرقام لا تتطابق بنمط لا يستطيع أحد تفسيره، ويصعب جدًا حلّه بعد أن يتراكم سجل ربع سنة.

## ما الذي يعبر الحدود؟

| التدفق | الاتجاه | نقاط النهاية |
| - | - | - |
| **المنتجات** | من ERP إلى OTO | `createProduct`, `productList` |
| **مستويات المخزون** | أيُّ اتجاه، بحسب القرار أعلاه | `updateStockQuantity`, `checkInventoryStock`, `checkGlobalStock` |
| **الطلبات** | من ERP إلى OTO | `createOrder`, `updateOrder` |
| **أحداث تجهيز الطلبات** | من OTO إلى ERP | [خدمات الويب هوك](https://docs.tryoto.com/ar/integrations/webhooks.md): `orderStatus`, `shipmentError` |
| **تكاليف الشحن** | من OTO إلى ERP | `shipmentTransactions`, `getShippingPriceTransactionsList` |
| **الواردات والتحويلات** | من ERP إلى OTO | `createInventoryOrder` |

تتطلب نقاط نهاية إدارة المخزون الإضافة الخاصة بـ WMS. وتوفرها حسب الباقة موضح في [فهرس نقاط النهاية](https://docs.tryoto.com/ar/developers/rest-api-reference.md).

## المعرّفان اللذان يهمّان

| | |
| - | - |
| **SKU** | نقطة الربط لكل ما يتعلق بالمنتجات. إذا اختلف نظام ERP وOTO على SKU، يتعطل المخزون والطلبات معًا في آن واحد. |
| **رمز المركز** | نقطة الربط لكل ما يتعلق بالمواقع. تُربط المنشآت والمواقع في نظام ERP لديك بـ[مراكز](https://docs.tryoto.com/ar/modules/hubs-management/overview.md) OTO من خلال هذا الرمز. |

> [!TIP]
>
> **عشر دقائق مع المسؤول عن نظام ERP، قبل إنشاء أول مركز**
>
> تحديد رموز المراكز والـ SKU لا يكلف شيئًا، أما تغييرها فمكلف؛ لأن كل عملية ربط وكل ملف استيراد وكل سجل سابق يعتمد عليها.
>
> والبديل هو إعادة تسمية شاملة بعد ستة أشهر، مع جدول ربط يحدّثه أحدهم يدويًا في الأثناء.

## ثلاث طرق لبناء الربط مع نظام ERP

على عكس [قنوات البيع](https://docs.tryoto.com/ar/integrations/sales-channels.md)، لا تتوفر عمليات ربط ERP في كتالوج بالخدمة الذاتية. هناك ثلاث طرق، والثالثة هي التي يسلكها معظم عملاء باقة الأعمال فعليًا.

| الطريقة | آلية العمل | مناسبة لـ |
| - | - | - |
| **تبنيه بنفسك** | يعمل مطوروك على [REST API](https://docs.tryoto.com/ar/developers/overview.md) و[خدمات الويب هوك](https://docs.tryoto.com/ar/integrations/webhooks.md) وفق وتيرتكم الخاصة. | الفرق التي لديها مطورون داخليون ونظام ERP مفهوم جيدًا. |
| **يبنيه شريك ERP الخاص بك** | يوسِّع المُدمج الذي يدير نظام ERP لديك النظامَ ليتصل بـ OTO. | الشركات التي يُدار نظام ERP لديها من طرف ثالث. |
| **تبنيه OTO لك** | توفِّر نقاط النهاية الخاصة بنظامك وقواعد العمل؛ وتطوِّر OTO موصِّلًا عليها مخصصًا لحسابك. | عملاء باقة الأعمال، والأنظمة المخصصة أو الداخلية، وكل ما له متطلبات غير مألوفة. |

### عمليات ربط مخصصة تبنيها OTO

حين لا يتوفر لنظام ما موصِّل جاهز (نظام ERP داخلي، أو نظام WMS مخصص، أو حزمة برمجية قطاعية لا يستخدمها غيرك)، يمكن لـ OTO أن تبني الربط بنفسها بدلًا من أن تسلّمك API وتتمنى لك التوفيق.

الفكرة بسيطة: **أنت تتيح نقاط النهاية، وOTO ترتبط بها.** يُطوَّر الموصِّل لحسابك وفق متطلبات عملك، وتتم صيانته كجزء من إعداداتك، لا كمشروع ينتهي ثم يتقادم.

| ما تحتاجه OTO منك | لماذا؟ |
| - | - |
| **توثيق نقاط النهاية** | الاستدعاءات التي يتيحها نظامك، مع بنية الطلب والاستجابة. |
| **التوثيق (Authentication)** | كيف سيعرِّف الموصِّل نفسه، وبيانات اعتماد لبيئة غير البيئة الفعلية. |
| **بيئة تجريبية** | مكان للبناء عليه غير نظام ERP الفعلي لديك. |
| **ربط الحقول** | أي حقولك هو الـ SKU وأيها رمز الموقع، وكيف تقابل حالاتُك حالاتِ OTO. |
| **قواعد العمل** | من يملك المخزون، ومتى يُعدّ الطلب مؤكدًا، وماذا يحدث عند التجهيز الجزئي، وكيف تُقيَّد المرتجعات. |

> [!TIP]
>
> **قواعد العمل هي ما يستغرق الوقت، لا الشيفرة**
>
> كتابة موصِّل لنقطة نهاية موثَّقة عمل روتيني. ما يستغرق الوقت هو القرارات التي تقع خلفه، وهي قرارات تخص عملك، فلا يملك اتخاذها غيرك.
>
> أن تأتي وقد حسمتها مسبقًا هو أكثر ما يُقصِّر مدة الربط: من يملك المخزون، وماذا يعني التجهيز الجزئي في حساباتك، وهل يُعدّ الطلب مؤكدًا عند إنشائه أم عند انتقائه. الفرق التي تأتي وقد حسمت هذه الأمور تُنجز الربط في جزء صغير من الوقت الذي تحتاجه فرق تكتشفها أثناء البناء.

> [!NOTE]
>
> **يعمل ذلك في الاتجاهين**
>
> ينطبق النهج نفسه على الأنظمة التي تحتاج إلى *إرسال* البيانات إلى OTO (نظام ERP يُنشئ الطلبات، أو نظام POS يُبلغ عن المخزون)، والأنظمة التي تحتاج إلى *استقبالها* منها (نظام مالي يستقبل تكاليف الشحن، أو مستودع بيانات BI يستقبل أحداث تجهيز الطلبات).
>
> ولا يقتصر الأمر على أنظمة ERP. فأنظمة [POS](https://docs.tryoto.com/ar/integrations/pos-systems.md) وWMS وأنظمة إدارة الطلبات الداخلية والأدوات الداخلية المخصصة تُربط جميعها بالطريقة نفسها.

يُحدَّد نطاق عمليات الربط المخصصة تجاريًا. تحدَّث مع مسؤول حسابك، أو راسِلنا على [support@tryoto.com](mailto:support@tryoto.com) مع وصف للنظام وما تحتاج إلى نقله بينه وبين OTO.

## الحضور إلى النقاش باستعداد

إذا كنت في مرحلة التقييم، فالسؤال المفيد ليس «هل ترتبطون بـ X؟»، بل «هذا هو النظام الذي يملك المخزون، وهذه رموز مواقعنا، وهذا نظام تسمية SKU لدينا، وهذا ما يتيحه نظام ERP لدينا». هذا النقاش قصير. أما الآخر فلا.

## صفحات ذات صلة

* [المطورون](https://docs.tryoto.com/ar/developers/overview.md): التوثيق ونطاق الـ API.
* [مزامنة المخزون](https://docs.tryoto.com/ar/modules/inventory-management/inventory-sync.md): كيف يُحسب المخزون ويُرسَل.
* [إدارة المراكز](https://docs.tryoto.com/ar/modules/hubs-management/overview.md): رموز المراكز.
* [أنظمة POS](https://docs.tryoto.com/ar/integrations/pos-systems.md): المقابل في المتاجر الفعلية.


## Related topics

- [إضافة المستودعات والفروع وإعدادها](https://docs.tryoto.com/ar/modules/hubs-management/hubs-management.md)
- [الربط مع أنظمة POS](https://docs.tryoto.com/ar/integrations/pos-systems.md)
- [الباقات والأسعار والإضافات](https://docs.tryoto.com/ar/pricing/plans-and-packaging.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.