محتويات الوثائق
بر وبحر Barr wa Bahr
آخر تحديث: مارس 2023 — Last updated: March 2023
تقدم شركة بر وبحر للشحن الدولي خدمات نقل البضائع بحرًا وبرًا من موانئ ومنافذ المملكة العربية السعودية إلى كل من العراق والأردن ومصر والمغرب وتركيا وإيطاليا وألمانيا وبريطانيا وأمريكا والصين والهند، وتناسب خدمات الشركة الشحنات الكبيرة والبضائع غير العاجلة حيث تنخفض التكلفة انخفاضًا ملحوظًا مقارنة بالشحن الجوي. تتوفر ثلاث خدمات هي الشحن البحري العادي (SEA_STD) والشحن البري العادي (LAND_STD) والشحن البحري السريع (SEA_EXP)، ومدة النقل 7-45 يومًا حسب الوجهة والظروف. تسلم البضائع إلى مستودعات الشركة في جدة أو الدمام أو الرياض قبل تاريخ الشحن بيومين على الأقل، ولا تقبل البضائع القابلة للاشتعال أو المواد الخاضعة لموافقات خاصة إلا بتنسيق مسبق مع قسم العمليات. للاطلاع على أسعار الخدمات راجع ملحق الأسعار.
يتم الربط عبر منصة منفذ من خلال نقطة نهاية واحدة POST /api/v1/carriers/BARR/passthrough مع ترويسة Authorization: Bearer ومفتاح الفريق، ويحدد الحقل action نوع العملية («rate» للتسعير و«ship» لإنشاء إرسالية)، وترسل البيانات بصيغة JSON وفق الجدول أدناه. لا تتوفر بيئة اختبارية منفصلة. لا تصدر الشركة بوليصة شحن إلكترونية للإرساليات وإنما يزود العميل برقم إرسالية consignment_no يستخدم للتتبع عبر منصة منفذ. لا تتوفر إشعارات مباشرة من الشركة وتصل تحديثات الحالة عبر منصة منفذ. للاستفسارات: قسم العمليات، هاتف 012-000-0000 تحويلة 3، من الأحد إلى الخميس.
جدول الحقول
| الحقل | الوصف | إلزامي |
|---|---|---|
| action | نوع العملية: «rate» للتسعير أو «ship» لإنشاء إرسالية | نعم |
| service | رمز الخدمة: SEA_STD أو LAND_STD أو SEA_EXP | نعم |
| weight | الوزن (كجم) | نعم |
| length | الطول | نعم |
| width | العرض | نعم |
| height | الارتفاع | نعم |
| origin_city | مدينة الالتقاط داخل المملكة | نعم |
| dest_country | رمز دولة الوجهة (حرفان) | نعم |
| dest_city | مدينة الوجهة | نعم |
| declared_value | القيمة المصرح بها | نعم |
| ship_date | تاريخ الشحن (١) | نعم |
| cod | مبلغ الدفع عند الاستلام | لا |
(١) صيغة التاريخ: يوم-شهر-سنة.
Barr wa Bahr provides sea and land freight from Saudi ports and border crossings to Iraq, Jordan, Egypt, Morocco, Turkey, Italy, Germany, the United Kingdom, the United States, China and India. Integration is via a single endpoint; the action field selects the operation. Field reference below.
Field reference (English)
| Field | Description | Req. |
|---|---|---|
| action | operation: rate or ship | Y |
| service | service code | Y |
| weight | weight (g) | Y |
| length | length | Y |
| width | width | Y |
| height | height | Y |
| origin_city | pickup city | Y |
| dest_country | destination country code (2 letters) | Y |
| dest_city | destination city | Y |
| declared_value | declared value | Y |
| ship_date | shipping date | Y |
| cod | cash on delivery amount | N |
مثال / Example
curl -X POST "https://manfath.example/api/v1/carriers/BARR/passthrough" \
-H "Authorization: Bearer mnf_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"action": "ship",
"service": "SEA_STD",
"weight": 18000,
"length": 600,
"width": 400,
"height": 350,
"origin_city": "Jeddah",
"dest_country": "EG",
"dest_city": "Alexandria",
"declared_value": 2500,
"ship_date": "02-04-2023",
"cod": 0
}'مثال الاستجابة / Example response
{
"status": "ok",
"consignment_no": "BB402118374",
"label": "none",
"message_ar": "تم إنشاء الإرسالية"
}تحفظ أرقام الإرساليات في سجلات العميل ويستخدم رقم الإرسالية للتتبع والفوترة. عند طلب التسعير (action = rate) يعاد مبلغ التسعيرة بالريال السعودي مع نطاق مدة النقل. تحتسب رسوم إضافية للمناطق النائية وللبضائع التي تتطلب مناولة خاصة وتظهر في الفاتورة الشهرية.
رموز الأخطاء / Error codes
| الرمز | الوصف |
|---|---|
| E_MISSING_FIELD_7734 | حقل مطلوب مفقود / missing required field |
| E_BAD_DATE_09 | صيغة التاريخ غير صحيحة / invalid date value |
| E_BAD_VALUE_23 | قيمة غير صالحة / invalid value |
| E_NO_COVERAGE_88 | خارج نطاق التغطية / outside coverage |
| E_BAD_REQUEST_11 | طلب غير صالح / bad request |