نسخه جدید APIهای ارسال منتشر شد — پایان پشتیبانی از نسخه‌های قبلی

به اطلاع توسعه‌دهندگان عزیز می‌رساند که APIهای قدیمی ارسال (Shipping) منسوخ شده و APIهای جدید جایگزین آن‌ها شده‌اند.

---

📛 APIهای منسوخ شده (Deprecated)

چهار API زیر از تاریخ ۱ اردیبهشت ۱۴۰۵ از دسترس خارج خواهند شد:

1. دریافت لیست روش‌های ارسال GET /v1/shipping-methods
2. دریافت روش‌های ارسال پیش‌فرض GET /v1/shipping-methods/defaults
3. دریافت روش‌های ارسال فعال غرفه GET /v1/vendors/{vendor_id}/shipping-methods
4. به‌روزرسانی روش ارسال PUT /v1/vendors/{vendor_id}/shipping-methods

---

✅ APIهای جدید جایگزین

سیستم جدید ارسال با معماری کاملاً بازطراحی شده و قابلیت‌های پیشرفته‌تر، از طریق APIهای زیر در دسترس است:

🔹 مدیریت پروفایل‌های ارسال (Profiles)

GET    /v1/shipping/profiles                          # دریافت لیست پروفایل‌های غرفه
POST   /v1/shipping/profiles                          # ایجاد پروفایل جدید
GET    /v1/shipping/profiles/{profile_id}             # دریافت جزئیات یک پروفایل
PATCH  /v1/shipping/profiles/{profile_id}             # به‌روزرسانی پروفایل
DELETE /v1/shipping/profiles/{profile_id}             # حذف پروفایل

🔹 مدیریت زون‌های ارسال (Zones)

GET    /v1/shipping/zones/{zone_id}                   # دریافت جزئیات یک زون
PATCH  /v1/shipping/zones/{zone_id}                   # به‌روزرسانی زون
DELETE /v1/shipping/zones/{zone_id}                   # حذف زون
POST   /v1/shipping/profiles/{profile_id}/zones       # ایجاد زون در پروفایل
GET    /v1/shipping/profiles/{profile_id}/zones       # دریافت زون‌های یک پروفایل

🔹 مدیریت نرخ‌های دستی (Own Rates)

POST   /v1/shipping/zones/{zone_id}/own-rates         # ایجاد نرخ دستی در زون
GET    /v1/shipping/zones/{zone_id}/own-rates         # دریافت نرخ‌های دستی زون
GET    /v1/shipping/own-rates/{own_rate_id}           # دریافت جزئیات یک نرخ دستی
PUT    /v1/shipping/own-rates/{own_rate_id}           # به‌روزرسانی نرخ دستی
DELETE /v1/shipping/own-rates/{own_rate_id}           # حذف نرخ دستی
GET    /v1/shipping/own-rates/delivery-estimates      # دریافت تخمین‌های زمان تحویل

🔹 مدیریت نرخ‌های حامل (Carrier Rates)

POST   /v1/shipping/zones/{zone_id}/carrier-rates     # ایجاد نرخ حامل در زون
PUT    /v1/shipping/zones/{zone_id}/carrier-rates     # تنظیم نرخ‌های حامل زون
GET    /v1/shipping/zones/{zone_id}/carrier-rates     # دریافت نرخ‌های حامل زون
GET    /v1/shipping/carrier-rates/{carrier_rate_id}   # دریافت جزئیات نرخ حامل
PATCH  /v1/shipping/carrier-rates/{carrier_rate_id}   # به‌روزرسانی نرخ حامل
DELETE /v1/shipping/carrier-rates/{carrier_rate_id}   # حذف نرخ حامل

🔹 مدیریت حامل‌ها (Carriers)

GET /v1/shipping/carriers                              # دریافت لیست حامل‌ها
GET /v1/shipping/vendor-carriers                       # دریافت لیست حامل‌های غرفه

🔹 مدیریت محصولات در پروفایل

GET    /v1/shipping/profile-products                   # دریافت محصولات پروفایل
POST   /v1/shipping/profiles/{profile_id}/products     # افزودن محصول به پروفایل
GET    /v1/shipping/profiles/{profile_id}/products     # دریافت محصولات یک پروفایل
DELETE /v1/shipping/profile-products/{product_id}      # حذف محصول از پروفایل

🔹 مدیریت قوانین ارسال رایگان

GET    /v1/shipping/profile-products/{product_id}/free-shipping-rules    # دریافت قوانین ارسال رایگان محصول
PATCH  /v1/shipping/profile-products/free-shipping-rules                 # به‌روزرسانی دسته‌ای قوانین ارسال رایگان

🔹 استراتژی و تنظیمات

GET /v1/shipping/profile-strategy                      # دریافت استراتژی پروفایل
PUT /v1/shipping/profile-strategy                      # تنظیم استراتژی پروفایل

🔹 مکان‌ها و مناطق

GET /v1/shipping/locations                             # دریافت لیست مکان‌ها
GET /v1/shipping/profiles/{profile_id}/zones/unrecovered-locations  # دریافت مکان‌های پوشش داده نشده

🔹 اطلاعات ارسال محصول

GET /v1/shipping/profile-products/{product_id}/shipping-info  # دریافت اطلاعات ارسال محصول

---

📝 راهنمای مهاجرت

1. بررسی مستندات: لطفاً به مستندات API ارسال مراجعه کنید
2. زمان‌بندی: تا قبل از ۱ اردیبهشت ۱۴۰۵ مهاجرت را تکمیل کنید

---

📞 پشتیبانی

در صورت نیاز به راهنمایی یا سوال:

• گروه پشتیبانی بله

با تشکر از همکاری شما، تیم توسعه‌دهندگان باسلام

---

تاریخ اعلام: فروردین ۱۴۰۵