راهنمای جامع عیب‌یابی و کدهای خطا

۹ از ۱۱v1.2.0

توسعه‌دهندگان گرامی، در صورت بروز خطا در هر یک از وب‌سرویس‌ها، پاسخ سرور حاوی یک کد عددی تحت عنوان error_code خواهد بود. لطفاً بر اساس جداول تفکیک‌شده زیر، علت خطا و راهکار رفع آن را در سیستم خود پیاده‌سازی کنید:

راهکارهای فنی و بیزینسی ارائه‌شده در این جداول به گونه‌ای طراحی شده‌اند که فرآیند رفع خطا را در سریع‌ترین زمان ممکن و به صورت خودمختار (Self-serve) مدیریت کنند و در اکثر مواقع مشکل را کاملاً برطرف می‌سازند. با این حال، اگر به هر دلیلی راهکار پیشنهادی در جدول کارساز نبود یا با شرایط خاصی مواجه شدید، می‌توانید جهت بررسی زیرساختی و حل مشکل، مستقیماً با تیم محصول (Product) و تیم فنی دیجی‌اکسپرس ارتباط برقرار کنید تا فرآیند به صورت مشترک مورد بررسی قرار گیرد.

خطاهای عمومی، دسترسی و محدودیت‌های سیستم (General & Permissions)

۷ ردیف
ERROR_CODE_NO_RECORD_FOUND
عنوان سیستمی (Error Key)
1009
شرح بیزینسی خطا
رکورد یافت نشد.
راهکار رفع خطا
شناسه ارسالی (مانند کد مرسوله، آدرس یا روت) در سیستم وجود ندارد. صحت شناسه را بررسی کنید.
ERROR_CODE_MAX_DAILY_ORDER_LIMIT_EXCEEDED_FOR_USER
عنوان سیستمی (Error Key)
1011
شرح بیزینسی خطا
سقف سفارش روزانه تکمیل شده است.
راهکار رفع خطا
تعداد سفارش‌های مجاز روزانه حساب شما به پایان رسیده است. جهت افزایش سقف با پشتیبانی تماس بگیرید.
ERROR_CODE_WE_HAVE_ALREADY_RECEIVED_THIS_MESSAGE_BEFORE
عنوان سیستمی (Error Key)
1090
شرح بیزینسی خطا
درخواست/پیام تکراری است.
راهکار رفع خطا
این درخواست قبلاً پردازش شده است. از ارسال مجدد ریکوئست‌های کاملاً یکسان خودداری کنید.
ERROR_CODE_WE_ARE_BUSY_AT_THE_MOMENT_PLEASE_DO_RETRY
عنوان سیستمی (Error Key)
1095
شرح بیزینسی خطا
سرور در حال حاضر مشغول است.
راهکار رفع خطا
ترافیک موقت روی دیتابیس؛ درخواست را با مکانیزم Retry (مثلاً با فاصله چند ثانیه) مجدداً ارسال کنید.
ERROR_CODE_FEATURE_IS_BLOCKED
عنوان سیستمی (Error Key)
1133
شرح بیزینسی خطا
این قابلیت مسدود است.
راهکار رفع خطا
دسترسی به این متد یا ویژگی خاص برای اکانت شما فعال یا مجاز نیست.
ERROR_CODE_USER_DO_NOT_HAVE_PERMISSION_TO_EXECUTE_COMMAND
عنوان سیستمی (Error Key)
1169
شرح بیزینسی خطا
عدم داشتن لایه دسترسی (Permission)
راهکار رفع خطا
توکن ارسالی مجاز به انجام این عملیات روی این شناسه نیست. از صحت هدر احراز هویت مطمئن شوید.
ERROR_CODE_BAD_SEARCH_PARAMETERS_PROVIDED
عنوان سیستمی (Error Key)
1122
شرح بیزینسی خطا
پارامترهای جستجو نامعبر است.
راهکار رفع خطا
فیلدهای فیلتر یا کوئری‌استرینگ در متدهای جستجو با ساختار داک همخوانی ندارند.

خطاهای ثبت، ویرایش و ساختار کدهای مرجع (Order & Reference Validation)

۱۴ ردیف
ERROR_CODE_EACH_CONSIGNOR_COULD_USE_UNIQUE_PARCEL_REFERENCE_CODE_ONCE
عنوان سیستمی (Error Key)
1027
شرح بیزینسی خطا
کد مرجع بسته تکراری است.
راهکار رفع خطا
فیلد parcel_reference قبلاً برای بسته دیگری استفاده شده. این کد باید در سطح سیستم شما کاملاً یکتا باشد.
ERROR_CODE_EACH_CONSIGNOR_COULD_USE_UNIQUE_SHIPMENT_REFERENCE_CODE_ONCE
عنوان سیستمی (Error Key)
1028
شرح بیزینسی خطا
کد مرجع سفارش تکراری است.
راهکار رفع خطا
فیلد shipment_reference تکراری است. هر سفارش ارسالی به دیجی‌اکسپرس نیازمند یک شناسه یکتای جدید است.
ERROR_CODE_INVALID_PARCEL_CONSIGNOR_REFERENCE_ID
عنوان سیستمی (Error Key)
1042
شرح بیزینسی خطا
شناسه مرجع بسته نامعتبر است.
راهکار رفع خطا
فرمت یا کاراکترهای استفاده شده در فیلد شناسه مرجع بسته سمت فرستنده مجاز نیست.
ERROR_CODE_ONLY_IN_DRAFT_ORDER_COULD_SEAL_AND_REQUEST_ROUTE
عنوان سیستمی (Error Key)
1057
شرح بیزینسی خطا
نهایی‌سازی فقط در وضعیت Draft مجاز است.
راهکار رفع خطا
سفارش تغییر وضعیت داده است؛ پلمب و درخواست روت فقط برای سفارش‌های در وضعیت پیش‌نویس ممکن است.
ERROR_CODE_ORDER_COULD_ONLY_BE_SYNCED_WHEN_IT_IS_AWAITING_TO_BE_SYNCED
عنوان سیستمی (Error Key)
1058
شرح بیزینسی خطا
سفارش در وضعیت انتظار برای سینک نیست.
راهکار رفع خطا
فراخوانی متد همگام‌سازی (Sync) در این وضعیتِ سفارش نامعقول است.
ERROR_CODE_SHIPMENT_CODE_MUST_HAVE_AT_LEAST_7_CHARS
عنوان سیستمی (Error Key)
1074
شرح بیزینسی خطا
کد سفارش باید حداقل 7 کاراکتر باشد.
راهکار رفع خطا
طول رشته ارسالی برای کد سفارش فرستنده کوتاه است (حداقل 7 کاراکتر درج شود).
ERROR_CODE_SHIPMENT_CODE_PREFIX_MUST_BE_ONLY_ALPHABET_AT_LEAST_2_AND_AT_MOST_4_CHARS
عنوان سیستمی (Error Key)
1075
شرح بیزینسی خطا
پیشوند کد سفارش باید 2 تا 4 کاراکتر متنی باشد.
راهکار رفع خطا
بخش پیشوند کد سفارش را اصلاح کنید؛ فقط حروف الفبای انگلیسی بین 2 تا 4 کاراکتر مجاز است.
ERROR_CODE_SHIPMENT_CONSIGNOR_REFERENCE_CODE_MUST_BE_ONLY_NUMBERS_AT_LEAST_5_AND_AT_MOST_15_CHARS
عنوان سیستمی (Error Key)
1076
شرح بیزینسی خطا
کد مرجع باید فقط عدد (5 تا 15 رقم) باشد.
راهکار رفع خطا
ساختار فیلد مرجع را تغییر دهید؛ کاراکترهای متنی یا علائم را حذف کرده و طول آن را بررسی کنید.
ERROR_CODE_SHIPMENT_COULD_ONLY_BE_EDITED_WHEN_IS_IN_DRAFT
عنوان سیستمی (Error Key)
1078
شرح بیزینسی خطا
سفارش خارج از وضعیت Draft قابل ویرایش نیست.
راهکار رفع خطا
فرآیند عملیاتی سفارش آغاز شده و قفل است؛ امکان تغییر اطلاعات سفارش وجود ندارد.
ERROR_CODE_SHIPMENT_CONSIGNOR_REFERENCE_IS_MANDATORY
عنوان سیستمی (Error Key)
1093
شرح بیزینسی خطا
ارسال کد مرجع سفارش اجباری است.
راهکار رفع خطا
فیلد شناسه مرجع سفارش سمت کانساینر خالی ارسال شده است؛ درج آن الزامی است.
ERROR_CODE_INVALID_PARCEL_CODE
عنوان سیستمی (Error Key)
1099
شرح بیزینسی خطا
بارکد یا کد بسته نامعتبر است.
راهکار رفع خطا
فرمت فیلد parcel_code ارسالی با استانداردهای تعریف‌شده سیستم لجستیک همخوانی ندارد.
ERROR_CODE_INVALID_BUSINESS_NAME
عنوان سیستمی (Error Key)
1101
شرح بیزینسی خطا
نام کسب‌وکار (بیزینس) نامعتبر است.
راهکار رفع خطا
نام تجاری ارسال شده در درخواست با اطلاعات ثبت شده در پنل مطابقت ندارد.
ERROR_CODE_SHIPMENT_REFERENCE_ID_IS_ALREADY_TAKEN_BY_SOME_OTHER_CONSIGNOR_WITH_SAME_PARCEL_PREFIX
عنوان سیستمی (Error Key)
1112
شرح بیزینسی خطا
شناسه مرجع سفارش توسط فرستنده دیگری رزرو شده است.
راهکار رفع خطا
به دلیل تداخل پیشوند بارکد و شناسه، باید شناسه مرجع سفارش خود را تغییر دهید.
ERROR_CODE_GIVEN_ORDER_FEATURES_MUST_NOT_BE_EMPTY
عنوان سیستمی (Error Key)
1123
شرح بیزینسی خطا
ویژگی‌های سفارش نباید خالی باشد.
راهکار رفع خطا
آرایه یا شیء مربوط به ویژگی‌های سفارش (order_features) را پر کنید.

خطاهای مشخصات فردی، آدرس و اطلاعات جغرافیایی (Identity & Address Validation)

۲۸ ردیف
ERROR_CODE_CARGO_SUBMITTER_PERSON_IS_MANDATORY_FOR_REQUESTING_ROUTE
عنوان سیستمی (Error Key)
1001
شرح بیزینسی خطا
مشخصات تحویل‌دهنده بار اجباری است.
راهکار رفع خطا
هنگام درخواست روت، شیء مربوط به مشخصات فرد فرستنده/تحویل‌دهنده را پر کنید.
ERROR_CODE_EITHER_ORIGIN_SHIPPING_POINT_ID_OR_PICKUP_ADDRESS_IS_MANDATORY_FOR_ROUTE_REQUEST
عنوان سیستمی (Error Key)
1002
شرح بیزینسی خطا
اطلاعات آدرس یا هاب مبدأ ارسال نشده است.
راهکار رفع خطا
باید مشخص کنید بار از کدام نقطه جمع‌آوری می‌شود (shipping_point_id یا آدرس کامل مبدأ).
ERROR_CODE_EITHER_DESTINATION_SHIPPING_POINT_ID_OR_ADDRESS_IS_MANDATORY_FOR_ROUTE_REQUEST
عنوان سیستمی (Error Key)
1003
شرح بیزینسی خطا
اطلاعات آدرس یا هاب مقصد ارسال نشده است.
راهکار رفع خطا
تعیین نقطه تحویل نهایی یا آدرس متنی مقصد در درخواست کاملاً الزامی است.
ERROR_CODE_CARGO_SUBMITTER_PERSON_IS_MANDATORY
عنوان سیستمی (Error Key)
1012
شرح بیزینسی خطا
اطلاعات شخص ارسال‌کننده اجباری است.
راهکار رفع خطا
فیلدهای نام و مشخصات فردی فرستنده محموله نباید خالی یا تهی (null) باشد.
ERROR_CODE_CITY_ID_IS_MANDATORY
عنوان سیستمی (Error Key)
1019
شرح بیزینسی خطا
شناسه شهر اجباری است.
راهکار رفع خطا
فیلد city_id (کد یکتای شهر طبق مستندات) ارسال نشده است.
ERROR_CODE_COULD_NOT_RESOLVE_ADDRESS_TO_LAT_LNG
عنوان سیستمی (Error Key)
1022
شرح بیزینسی خطا
عدم انطباق آدرس متنی با لوکیشن.
راهکار رفع خطا
سیستم نتوانست آدرس متنی را به لوکیشن نقشه تبدیل کند. فیلد Lat/Lng را دقیق‌تر ارسال کنید.
CODE_CAN_NOT_LOCATE_ORIGIN_OR_DESTINATION
عنوان سیستمی (Error Key)
1181
شرح بیزینسی خطا
موقعیت مبدأ یا مقصد قابل تشخیص نیست.
راهکار رفع خطا
اطلاعات آدرس مبدأ و مقصد، شهر، آدرس کامل، مختصات جغرافیایی و origin_point_id / destination_point_id را بررسی کنید. در صورتی که از مختصات استفاده می‌کنید، مقدار latitude و longitude باید معتبر و داخل محدوده سرویس‌دهی باشند.
ERROR_CODE_EITHER_DESTINATION_POINT_OR_ADDRESS_IS_MANDATORY_FOR_ROUTE_REQUEST
عنوان سیستمی (Error Key)
1029
شرح بیزینسی خطا
مقصد یا آدرس نهایی الزامی است.
راهکار رفع خطا
در درخواست روت، تعیین لوکیشن هاب مقصد یا آدرس مشتری اجباری است.
ERROR_CODE_EITHER_ORIGIN_POINT_OR_PICKUP_ADDRESS_IS_MANDATORY_FOR_ROUTE_REQUEST
عنوان سیستمی (Error Key)
1030
شرح بیزینسی خطا
مبدأ یا آدرس جمع‌آوری الزامی است.
راهکار رفع خطا
در درخواست روت، تعیین لوکیشن هاب مبدأ یا آدرس فرستنده اجباری است.
ERROR_CODE_FULL_ADDRESS_IS_MANDATORY
عنوان سیستمی (Error Key)
1031
شرح بیزینسی خطا
آدرس متنی کامل اجباری است.
راهکار رفع خطا
فیلد مربوط به شرح آدرس متنی نباید خالی یا کمتر از حد مجاز باشد.
ERROR_CODE_INVALID_BUILDING_NUMBER
عنوان سیستمی (Error Key)
1032
شرح بیزینسی خطا
پلاک ساختمان نامعتبر است.
راهکار رفع خطا
فرمت فیلد پلاک اشتباه است؛ فقط اعداد و کاراکترهای مجاز پلاک را ارسال کنید.
ERROR_CODE_INVALID_CITY_ID
عنوان سیستمی (Error Key)
1033
شرح بیزینسی خطا
شناسه شهر در سیستم وجود ندارد.
راهکار رفع خطا
کد شهر ارسالی معتبر نیست؛ جدول کدهای شهر مجاز دیجی‌اکسپرس را بررسی کنید.
ERROR_CODE_INVALID_DESCRIPTION
عنوان سیستمی (Error Key)
1034
شرح بیزینسی خطا
توضیحات ارسالی نامعتبر است.
راهکار رفع خطا
فیلد متن توضیحات (Description) حاوی کاراکترهای غیرمجاز یا طول غیراستاندارد است.
ERROR_CODE_INVALID_FULL_ADDRESS
عنوان سیستمی (Error Key)
1036
شرح بیزینسی خطا
آدرس متنی نامعقول است.
راهکار رفع خطا
طول آدرس ارسالی خیلی کوتاه است یا کلمات نامفهوم دارد؛ آدرس پستی دقیق را وارد کنید.
ERROR_CODE_INVALID_LATITUDE
عنوان سیستمی (Error Key)
1037
شرح بیزینسی خطا
عرض جغرافیایی (Latitude) نامعتبر است.
راهکار رفع خطا
مقدار فیلد latitude خارج از رنج استاندارد جی‌پی‌اس (فرمت اعشاری لوکیشن) است.
ERROR_CODE_INVALID_LONGITUDE
عنوان سیستمی (Error Key)
1038
شرح بیزینسی خطا
طول جغرافیایی (Longitude) نامعتبر است.
راهکار رفع خطا
مقدار فیلد longitude خارج از رنج استاندارد جی‌پی‌اس است.
ERROR_CODE_INVALID_MOBILE
عنوان سیستمی (Error Key)
1039
شرح بیزینسی خطا
شماره موبایل نامعتبر است.
راهکار رفع خطا
شماره موبایل باید حتماً 11 رقم و با فرمت استاندارد ایران (مثل 09xxxxxxxxx) شروع شود.
ERROR_CODE_INVALID_NATIONAL_CODE
عنوان سیستمی (Error Key)
1041
شرح بیزینسی خطا
کد ملی نامعتبر است.
راهکار رفع خطا
کد ملی ارسالی فاقد صحت‌سنجی 10 رقمی الگوریتم ثبت‌احوال است. آن را اصلاح کنید.
ERROR_CODE_INVALID_PERSON_NAME
عنوان سیستمی (Error Key)
1043
شرح بیزینسی خطا
نام شخص نامعتبر است.
راهکار رفع خطا
نام وارد شده نباید حاوی اعداد، علائم خاص یا طول خیلی کوتاه باشد.
ERROR_CODE_INVALID_POSTAL_CODE
عنوان سیستمی (Error Key)
1044
شرح بیزینسی خطا
کد پستی نامعتبر است.
راهکار رفع خطا
کد پستی باید دقیقاً یک رشته عددی 10 رقمی بدون فاصله یا خط تیره باشد.
ERROR_CODE_INVALID_SHIPPING_POINT_ID
عنوان سیستمی (Error Key)
1046
شرح بیزینسی خطا
شناسه نقطه لجستیکی نامعتبر است.
راهکار رفع خطا
شناسه هاب یا نقطه ارسال (shipping_point_id) در سیستم دیجی‌اکسپرس یافت نشد.
ERROR_CODE_LATITUDE_LONGITUDE_IS_MANDATORY
عنوان سیستمی (Error Key)
1050
شرح بیزینسی خطا
ارسال Lat/Lng روی نقشه اجباری است.
راهکار رفع خطا
برای ثبت لوکیشن دقیق، ارسال همزمان فیلدهای طول و عرض جغرافیایی الزامی است.
ERROR_CODE_MOBILE_IS_MANDATORY
عنوان سیستمی (Error Key)
1052
شرح بیزینسی خطا
شماره تلفن همراه ارسال نشده است.
راهکار رفع خطا
درج فیلد شماره موبایل برای فرستنده/گیرنده در این متد اجباری است.
ERROR_CODE_RECIPIENT_PERSON_IS_MANDATORY
عنوان سیستمی (Error Key)
1070
شرح بیزینسی خطا
اطلاعات شخص گیرنده اجباری است.
راهکار رفع خطا
نام و مشخصات فردی تحویل‌گیرنده نهایی کالا در درخواست وجود ندارد.
ERROR_CODE_REQUESTING_ROUTE_NEEDS_CARGO_SUBMITTER_PERSON_FOR_PICKUP_SHIPMENT
عنوان سیستمی (Error Key)
1071
شرح بیزینسی خطا
فرستنده بار برای سفارش پیکاپ الزامی است.
راهکار رفع خطا
در سفارش‌های نقشه جمع‌آوری (Pickup)، مشخصات فرد فرستنده برای درخواست مسیر الزامی است.
ERROR_CODE_MOBILE_NUMBER_IS_ALREADY_VERIFIED_FOR_ANOTHER_USER
عنوان سیستمی (Error Key)
1104
شرح بیزینسی خطا
شماره موبایل قبلاً توسط کاربر دیگری تایید شده.
راهکار رفع خطا
این شماره تلفن همراه یک‌بار در سیستم ثبت شده و امکان انتساب مجدد آن وجود ندارد.
ERROR_CODE_PROVIDED_LAT_LNG_IS_NOT_WITHIN_COUNTRY
عنوان سیستمی (Error Key)
1124
شرح بیزینسی خطا
مختصات خارج از مرزهای کشور است.
راهکار رفع خطا
لوکیشن جغرافیایی (Lat/Lng) ارسالی روی نقشه خارج از مرزهای ایران قرار دارد.
ERROR_CODE_EITHER_DESTINATION_SHIPPING_POINT_ID_OR_ADDRESS_IS_MANDATORY_FOR_SHIPMENT_COORDINATION
عنوان سیستمی (Error Key)
1167
شرح بیزینسی خطا
آدرس یا هاب مقصد برای هماهنگی الزامی است.
راهکار رفع خطا
در متد هماهنگی ارسال، ثبت لوکیشن نقطه مقصد یا آدرس فیزیکی آن الزامی است.

خطاهای مشخصات فیزیکی، ابعاد، وزن و سایزبندی بسته‌ها (Dimensions & Metrics)

۱۴ ردیف
ERROR_CODE_ALL_3_DIMENSIONS_IS_MANDATORY
عنوان سیستمی (Error Key)
1013
شرح بیزینسی خطا
ارسال هر 3 بعد بسته اجباری است.
راهکار رفع خطا
فیلدهای طول (length)، عرض (width) و ارتفاع (height) همگی باید ارسال شوند.
ERROR_CODE_INVALID_DIMENSION
عنوان سیستمی (Error Key)
1035
شرح بیزینسی خطا
ابعاد بسته غیرمجاز است.
راهکار رفع خطا
اعداد ارسالی برای ابعاد فیزیکی بسته (طول، عرض، ارتفاع) صفر یا منفی یا غیرمعقول است.
ERROR_CODE_INVALID_UNIT
عنوان سیستمی (Error Key)
1047
شرح بیزینسی خطا
واحد اندازه‌گیری نامعتبر است.
راهکار رفع خطا
واحد انتخاب شده برای وزن یا ابعاد منطبق بر استانداردهای داک (سانتی‌متر/گرم) نیست.
ERROR_CODE_INVALID_VOLUME
عنوان سیستمی (Error Key)
1048
شرح بیزینسی خطا
حجم مرسوله نامعتبر است.
راهکار رفع خطا
مقدار فیلد حجم (volume) ارسالی صفر یا عددی منفی و غیراستاندارد است.
ERROR_CODE_INVALID_WEIGHT
عنوان سیستمی (Error Key)
1049
شرح بیزینسی خطا
وزن مرسوله نامعتبر است.
راهکار رفع خطا
وزن بسته ارسالی (weight) نباید صفر یا منفی باشد (مقدار را به گرم اصلاح کنید).
ERROR_CODE_WEIGHT_IS_MANDATORY
عنوان سیستمی (Error Key)
1091
شرح بیزینسی خطا
فیلد وزن بسته اجباری است.
راهکار رفع خطا
وزن بسته ارسال نشده است؛ درج وزن دقیق برای محاسبات لجستیکی الزامی است.
ERROR_CODE_SIZE_TIER_IS_NOT_VALID
عنوان سیستمی (Error Key)
1097
شرح بیزینسی خطا
گروه سایز مرسوله نامعتبر است.
راهکار رفع خطا
مقدار فیلد size_tier ارسالی خارج از مقادیر مجاز سیستم (کوچک، متوسط، بزرگ و...) است.
ERROR_CODE_EITHER_WEIGHT_OR_VOLUME_EXCEEDED_MAX_VALUE_FOR_SIZE_TIER
عنوان سیستمی (Error Key)
1098
شرح بیزینسی خطا
وزن/حجم فراتر از حد گروه سایز است.
راهکار رفع خطا
ابعاد یا وزن ارسالی از سقف مجازِ سایز تایر انتخابی بزرگتر است. گروه سایز را بزرگتر کنید.
ERROR_CODE_YOU_COULD_EITHER_PASS_VOLUME_IN_CM3_OR_VOLUME_DIMENSIONS
عنوان سیستمی (Error Key)
1126
شرح بیزینسی خطا
تداخل در نحوه اعلام حجم بسته.
راهکار رفع خطا
همزمان فیلد حجم کل و ابعاد 3 گانه را فرستاده‌اید؛ فقط از یک روش حجم را اعلام کنید.
ERROR_CODE_ALL_PARCELS_AS_SINGLE_BOX_ESTIMATED_MUST_BE_PASSED_AN_string_OF_3_DIMENSIONS_IN_CM
عنوان سیستمی (Error Key)
1136
شرح بیزینسی خطا
نیاز به آرایه ابعاد 3 گانه جعبه فرضی.
راهکار رفع خطا
در تخمین تجمیعی، ابعاد جعبه فرضی باید به صورت یک آرایه 3 عددی دقیق (به سانتی‌متر) ارسال شود.
ERROR_CODE_EITHER_PASS_SIZE_TIER_DIRECTLY_OR_BY_PASSING_VALID_MIN_MAX_BOX_DIMENSIONS_AND_WEIGHT
عنوان سیستمی (Error Key)
1138
شرح بیزینسی خطا
نقص در روش تعیین مشخصات سایز.
راهکار رفع خطا
یا فیلد size_tier را مستقیم بفرستید یا حداقل/حداکثر ابعاد و وزن معتبر جعبه را درج کنید.
ERROR_CODE_DESCRIBED_BOXES_AS_MIN_AND_MAX_COULD_NOT_BE_IN_TWO_DIFFERENT_SIZE_TIERS
عنوان سیستمی (Error Key)
1139
شرح بیزینسی خطا
تفاوت گروه سایز جعبه مینیمم و ماکسیمم.
راهکار رفع خطا
محدوده ابعاد کوچکترین و بزرگترین جعبه ارسالی نباید در دو گروه سایز متفاوت قرار گیرد.
ERROR_CODE_UPDATING_PARCEL_SIZE_TIER_IN_NORMAL_SIZE_TIER_IS_NOT_POSSIBLE
عنوان سیستمی (Error Key)
1159
شرح بیزینسی خطا
عدم امکان به‌روزرسانی در سایز استاندارد.
راهکار رفع خطا
تغییرات گروه سایز بسته در شرایط سایزبندی استاندارد فعلی مقدور نیست.
ERROR_CODE_UPDATING_PARCEL_SIZE_TIER_TO_NORMAL_SIZE_TIER_IS_NOT_POSSIBLE
عنوان سیستمی (Error Key)
1160
شرح بیزینسی خطا
تغییر گروه سایز به سایز نرمال مجاز نیست.
راهکار رفع خطا
امکان تبدیل مستقیم و به‌روزرسانی گروه سایز فعلی به حالت نرمال وجود ندارد.

خطاهای زمانی، تاریخ آماده‌سازی و پنجره‌های توزیع (Scheduling & Time Windows)

۲۲ ردیف
ERROR_CODE_SHIPMENT_PROMISE_END_DATE_MUST_BE_AFTER_START_DATE
عنوان سیستمی (Error Key)
1000
شرح بیزینسی خطا
تاریخ پایان بازه تحویل قبل از شروع است.
راهکار رفع خطا
فیلد promise_end_date را اصلاح کنید؛ زمان پایان بازه باید بعد از زمان شروع باشد.
ERROR_CODE_DATE_RANGE_START_IS_LATER_THAN_ITS_END
عنوان سیستمی (Error Key)
1010
شرح بیزینسی خطا
زمان شروع بازه بعد از زمان پایان است.
راهکار رفع خطا
محدوده تاریخ ارسالی منطقی نیست؛ زمان شروع جلوتر از زمان پایان ست شده است.
ERROR_CODE_CARGO_READY_DATE_MUST_BE_FORMATTED_CORRECTLY
عنوان سیستمی (Error Key)
1016
شرح بیزینسی خطا
فرمت تاریخ آماده‌سازی بار اشتباه است.
راهکار رفع خطا
تاریخ فیلد ready_date را به فرمت استاندارد سیستم (مثلاً ISO 8601 یا فرمت داک) تغییر دهید.
ERROR_CODE_DATE_MUST_BE_FORMATTED_CORRECTLY
عنوان سیستمی (Error Key)
1024
شرح بیزینسی خطا
فرمت تاریخ ارسالی نامعتبر است.
راهکار رفع خطا
ساختار رشته متنی مربوط به فیلد تاریخ ارسالی در درخواست را بازبینی و اصلاح کنید.
ERROR_CODE_DATE_RANGE_MUST_CONTAIN_START_AND_END
عنوان سیستمی (Error Key)
1025
شرح بیزینسی خطا
بازه تاریخ فاقد شروع یا پایان است.
راهکار رفع خطا
شیء محدوده تاریخ ارسالی ناقص است؛ باید هردو پارامتر شروع و پایان فرستاده شوند.
ERROR_CODE_DATE_RANGE_START_MUST_BE_BEFORE_END
عنوان سیستمی (Error Key)
1026
شرح بیزینسی خطا
شروع محدوده زمان باید قبل از پایان باشد.
راهکار رفع خطا
شرط منطقی توالی زمانی رعایت نشده است؛ ساختار گام‌های بازه تاریخ را چک کنید.
ERROR_CODE_READY_DATE_IS_MANDATORY_FOR_ROUTE_REQUEST
عنوان سیستمی (Error Key)
1068
شرح بیزینسی خطا
تاریخ آماده‌سازی بار برای روت الزامی است.
راهکار رفع خطا
فیلد ready_date (زمانی که بار آماده پیکاپ است) را در درخواست روتینگ پر کنید.
ERROR_CODE_READY_DATE_MUST_BE_BEFORE_PROMISE_RANGE_END
عنوان سیستمی (Error Key)
1069
شرح بیزینسی خطا
تاریخ آمادگی بار باید قبل از بازه تحویل باشد.
راهکار رفع خطا
زمان آماده بودن بار نمی‌تواند بعد از زمان وعده داده شده به مشتری جهت تحویل کالا باشد.
ERROR_CODE_SHIPMENT_PROMISE_DATE_RANGE_MUST_BE_WITHIN_SAME_DAY_CAUSE_DSH_DOES_NOT_SUPPORT
عنوان سیستمی (Error Key)
1082
شرح بیزینسی خطا
بازه تحویل حتماً باید در یک روز باشد.
راهکار رفع خطا
شروع و پایان بازه تحویل باید متعلق به یک تاریخ (یک روز واحد) باشد. بازه چند روزه مجاز نیست.
ERROR_CODE_DATE_RANGE_DID_NOT_HAVE_ACCEPTABLE_DELTA
عنوان سیستمی (Error Key)
1096
شرح بیزینسی خطا
فاصله (Delta) بازه تاریخ غیرمجاز است.
راهکار رفع خطا
فاصله زمانی بین شروع و پایان بازه انتخابی شما از سقف یا کف مجاز سیستم خارج است.
ERROR_CODE_INVALID_PROMISE_DATE_RANGE
عنوان سیستمی (Error Key)
1110
شرح بیزینسی خطا
بازه وعده تحویل (Promise Range) نامعقول است.
راهکار رفع خطا
محدوده تاریخ انتخابی برای زمان تحویل به مشتری در تقویم کاری لجستیک مجاز نیست.
ERROR_CODE_INVALID_READY_DATE
عنوان سیستمی (Error Key)
1111
شرح بیزینسی خطا
تاریخ آماده‌سازی بار غیرمجاز است.
راهکار رفع خطا
زمان اعلام شده برای آماده بودن کالا با سیاست‌های زمان‌بندی روتینگ همخوانی ندارد.
ERROR_CODE_READY_DATE_CANNOT_BE_IN_THE_PAST
عنوان سیستمی (Error Key)
1120
شرح بیزینسی خطا
تاریخ آماده‌سازی بار مربوط به گذشته است.
راهکار رفع خطا
زمان فیلد ready_date گذشته است؛ این زمان را به ساعت جاری یا زمان آینده تغییر دهید.
ERROR_CODE_CONSIGNOR_OFF_DATES_MUST_BE_FORMATTED_CORRECTLY
عنوان سیستمی (Error Key)
1137
شرح بیزینسی خطا
فرمت تاریخ روزهای تعطیل کانساینر اشتباه است.
راهکار رفع خطا
ساختار دیتای روزهای تعطیلی اعلام شده سمت خود را به فرمت استاندارد داک تغییر دهید.
ERROR_CODE_SHIPPING_TIME_WINDOW_IS_EXPIRED
عنوان سیستمی (Error Key)
1143
شرح بیزینسی خطا
پنجره زمانی ارسال منقضی شده است.
راهکار رفع خطا
بازه زمانی (Time Window) تخصیص یافته منقضی شده است و امکان استفاده از آن وجود ندارد.
ERROR_CODE_SHIPPING_TIME_WINDOW_NOT_FOUND
عنوان سیستمی (Error Key)
1144
شرح بیزینسی خطا
پنجره زمانی ارسال یافت نشد.
راهکار رفع خطا
شناسه پنجره زمانی ارسال ارسالی در سیستم لجستیک معتبر یا موجود نیست.
ERROR_CODE_AT_LEAST_ONE_TOKEN_IN_SHIPPING_TIME_WINDOWS_IS_ALREADY_USED
عنوان سیستمی (Error Key)
1148
شرح بیزینسی خطا
توکن پنجره زمانی قبلاً استفاده شده است.
راهکار رفع خطا
توکن ارسالی برای پنجره زمانی ارسال سوخته است؛ هر توکن تنها یک‌بار قابل استفاده است.
ERROR_CODE_SHIPPING_TIME_WINDOW_DOES_NOT_BELONG_TO_REQUESTER_USER
عنوان سیستمی (Error Key)
1149
شرح بیزینسی خطا
پنجره زمانی متعلق به حساب شما نیست.
راهکار رفع خطا
این توکن یا پنجره زمانی ارسال برای کانساینر دیگری صادر شده و حق استفاده از آن را ندارید.
ERROR_CODE_SHIPPING_TIME_WINDOW_TOKEN_IS_NOT_FOR_THIS_SHIPMENT_OR_USER
عنوان سیستمی (Error Key)
1173
شرح بیزینسی خطا
توکن پنجره زمانی مربوط به این سفارش نیست.
راهکار رفع خطا
توکن ارسالی با شناسه سفارشی که قصد اعمال آن را دارید همخوانی ندارد.
ERROR_CODE_SHIPPING_TIME_WINDOW_TOKEN_IS_ALREADY_FINALIZED
عنوان سیستمی (Error Key)
1174
شرح بیزینسی خطا
توکن پنجره زمانی نهایی شده است.
راهکار رفع خطا
این توکن پنجره زمانی پیش از این بسته شده و چرخه عمر آن به پایان رسیده است.
CODE_SHIPPING_TIME_WINDOW_TOKEN_COULD_ONLY_BE_FINALIZED_IN_AWAIT_START
عنوان سیستمی (Error Key)
1182
شرح بیزینسی خطا
توکن پنجره زمانی فقط در وضعیت مجاز قابل نهایی‌سازی است.
راهکار رفع خطا
این توکن فقط زمانی قابل نهایی‌سازی است که در وضعیت Await Start باشد. وضعیت فعلی سفارش یا توکن را بررسی کنید و فقط در مرحله مجاز، فرآیند نهایی‌سازی Shipping Time Window را انجام دهید.
CODE_TOKEN_SHIPPING_TIME_WINDOW_IS_ALREADY_USED
عنوان سیستمی (Error Key)
1183
شرح بیزینسی خطا
توکن پنجره زمانی قبلاً استفاده شده است.
راهکار رفع خطا
هر توکن Shipping Time Window فقط یک‌بار قابل استفاده است. برای ثبت سفارش جدید یا تلاش مجدد، ابتدا یک پنجره زمانی جدید دریافت کنید و از توکن جدید استفاده کنید.

خطاهای وضعیت مرسوله، بارکدها و اسکن بسته‌ها (Parcel Status & Scannables)

۱۹ ردیف
ERROR_CODE_PARCEL_CODE_DOES_NOT_BELONG_TO_SHIPMENT
عنوان سیستمی (Error Key)
1005
شرح بیزینسی خطا
کد بسته متعلق به این سفارش نیست.
راهکار رفع خطا
بارکد بسته‌ای که ارسال کرده‌اید در لیست بسته‌های زیرمجموعه این سفارش (Shipment) پیدا نشد.
ERROR_CODE_NO_PARCEL_FOUND_WITH_GIVEN_CODE
عنوان سیستمی (Error Key)
1006
شرح بیزینسی خطا
بسته‌ای با این بارکد یافت نشد.
راهکار رفع خطا
بارکد یا کد بسته ارسالی در کل سیستم وجود ندارد. صحت شناسه بارکد را چک کنید.
ERROR_CODE_NO_REGISTERED_PARCEL_EXCEPTION
عنوان سیستمی (Error Key)
1056
شرح بیزینسی خطا
خطای عدم وجود بسته ثبت شده.
راهکار رفع خطا
درخواست در حالی ارسال شده که هیچ بسته‌ای برای این سفارش به ثبت نرسیده است.
ERROR_CODE_ORDER_LABEL_NOT_READY_YET_EXCEPTION
عنوان سیستمی (Error Key)
1059
شرح بیزینسی خطا
لیبل سفارش هنوز آماده نشده است.
راهکار رفع خطا
فایل یا دیتای لیبل هنوز توسط موتور سیستم کامپایل نشده؛ لحظاتی دیگر مجدداً متد را صدا بزنید.
ERROR_CODE_PARCEL_AND_SHIPMENTS_COUNT_THRESHOLD_IS_EXCEEDED_IN_ORDER
عنوان سیستمی (Error Key)
1060
شرح بیزینسی خطا
تعداد بسته‌ها فراتر از حد مجاز سفارش است.
راهکار رفع خطا
تعداد پارسل‌های اضافه شده به این سفارش از سقف مجاز سیستم برای یک فاکتور بیشتر است.
ERROR_CODE_PARCEL_CODE_DOES_NOT_BELONG_TO_ANY_SHIPMENT_IN_ORDER
عنوان سیستمی (Error Key)
1061
شرح بیزینسی خطا
کد بسته متعلق به هیچ سفارشی در این فاکتور نیست.
راهکار رفع خطا
این کد بسته اساساً در این مجموعه سفارش ثبت نشده و هویتی ندارد.
ERROR_CODE_PARCEL_CODE_MUST_BE_UNIQUE_FOR_EACH_CONSIGNOR
عنوان سیستمی (Error Key)
1062
شرح بیزینسی خطا
کد بسته در سطح کانساینر باید یکتا باشد.
راهکار رفع خطا
شما این بارکد بسته (parcel_code) را قبلاً در سفارش دیگری برای خود استفاده کرده‌اید.
ERROR_CODE_PARCEL_IS_NOT_READY_YET_EXCEPTION
عنوان سیستمی (Error Key)
1064
شرح بیزینسی خطا
بسته هنوز در وضعیت آماده قرار نگرفته است.
راهکار رفع خطا
مرسوله مراحل پردازش اولیه را طی نکرده و آمادگی لازم جهت ورود به این مرحله را ندارد.
ERROR_CODE_PARCEL_IS_NOT_REGISTERED_EXCEPTION
عنوان سیستمی (Error Key)
1065
شرح بیزینسی خطا
مرسوله ثبت نشده است.
راهکار رفع خطا
رفتارهای عملیاتی روی بسته‌ای درخواست شده که اصلاً فرآیند رجیستر آن انجام نشده است.
ERROR_CODE_PARCEL_STATUS_DOES_NOT_MATCH_OUR_EXPECTATION_HERE
عنوان سیستمی (Error Key)
1066
شرح بیزینسی خطا
وضعیت مرسوله با این متد همخوانی ندارد.
راهکار رفع خطا
وضعیت فعلی بسته (مثلاً توزیع شده) با عملیات درخواستی شما (مثلاً ویرایش) در تضاد است.
ERROR_CODE_SHIPMENT_MUST_HAVE_AT_LEAST_ONE_PARCEL_TO_REQUEST_ROUTE
عنوان سیستمی (Error Key)
1080
شرح بیزینسی خطا
سفارش برای مسیردهی باید حداقل یک بسته داشته باشد.
راهکار رفع خطا
نمی‌توان برای سفارشِ بدون بسته (Shipment خالی) درخواست روت و مسیریابی لجستیکی کرد.
ERROR_CODE_SOME_PARCELS_OF_SHIPMENT_ARE_NOT_READY_TO_SELECT_ROUTE_SO_NON_WILL
عنوان سیستمی (Error Key)
1084
شرح بیزینسی خطا
برخی بسته‌ها آماده روت نیستند؛ لغو کل مسیردهی.
راهکار رفع خطا
به دلیل آماده نبودن وضعیت یکی از بسته‌ها، فرآیند مسیریابی برای کل سفارش متوقف شد.
ERROR_CODE_PARCEL_WITH_ID_OR_UNIQUE_REFERENCE_ID_NOT_FOUND
عنوان سیستمی (Error Key)
1115
شرح بیزینسی خطا
بسته با این شناسه یا کد مرجع یافت نشد.
راهکار رفع خطا
شناسه سیستمی یا کد مرجع اختصاصی بسته ارسالی در پایگاه داده وجود ندارد.
ERROR_CODE_PARCEL_CONSIGNOR_REFERENCE_ID_IS_NOW_ALLOWED_TO_BE_DUPLICATED_IN_A_SHIPMENT
عنوان سیستمی (Error Key)
1119
شرح بیزینسی خطا
هم‌پوشانی و تکرار کد مرجع بسته در یک سفارش.
راهکار رفع خطا
نمی‌توانید دو بسته مجزا در یک سفارش واحد را با یک کد مرجع یکسان ارسال کنید.
ERROR_CODE_SCANNABLE_CODE_NOT_FOUND
عنوان سیستمی (Error Key)
1127
شرح بیزینسی خطا
بارکد قابل اسکن یافت نشد.
راهکار رفع خطا
شناسه بارکد متنی ارسالی که ناوگان اسکن می‌کند، در سیستم لجستیک رجیستر نشده است.
ERROR_CODE_MORE_THAN_ONE_PARCEL_CODE_FOUND_WITH_GIVEN_SCANNABLE
عنوان سیستمی (Error Key)
1128
شرح بیزینسی خطا
تداخل و یافتن بیش از یک بسته با این بارکد.
راهکار رفع خطا
دیتای مخدوش؛ یک بارکد اسکن شونده به طور خطایی به دو بسته متفاوت منتسب شده است.
CODE_DUPLICATE_SCANNABLE_CODE
عنوان سیستمی (Error Key)
1179
شرح بیزینسی خطا
کد قابل اسکن تکراری است.
راهکار رفع خطا
مقدارهای ارسالی در scannable_codes باید در سطح کل سیستم دیجیاکسپرس یکتا باشند. کدهای تکراری را حذف یا با کدهای یکتای جدید جایگزین کنید. همچنین مطمئن شوید داخل همان آرایه نیز یک مقدار دوبار ارسال نشده باشد.
CODE_INVALID_SCANNABLE_CODE
عنوان سیستمی (Error Key)
1180
شرح بیزینسی خطا
کد قابل اسکن نامعتبر است.
راهکار رفع خطا
مقدارهای scannable_codes را از نظر نوع داده، طول و فرمت بررسی کنید. هر مقدار باید به‌صورت string ارسال شود و طول آن بین ۱۲ تا ۳۶ کاراکتر باشد.
ERROR_CODE_PARCELS_TOTAL_WEIGH_OR_VOLUME_OR_SIZE_TIER_DOES_NOT_MATCH_REGISTERED_SHIPPING_TIME_WINDOW_MAX_CAPACITY_ESTIMATION
عنوان سیستمی (Error Key)
1150
شرح بیزینسی خطا
عدم تطابق مجموع وزن/حجم بسته‌ها با تخمین ظرفیت پنجره زمانی.
راهکار رفع خطا
مجموع فیزیکی بسته‌های واقعی فرستاده شده از سقف ظرفیتی که در پنجره زمانی رزرو کرده بودید فراتر رفته است.

خطاهای ظرفیت انبوه، فرآیندهای مَس و مهندسی روتینگ (Mass & Route Engine)

۱۶ ردیف
ERROR_CODE_EITHER_PARCELS_OR_MAX_SHIPMENT_CAPACITY_ESTIMATION_IS_MANDATORY_FOR_ROUTE_REQUEST
عنوان سیستمی (Error Key)
1100
شرح بیزینسی خطا
ارسال اطلاعات بسته‌ها یا تخمین سقف ظرفیت اجباری است.
راهکار رفع خطا
برای درخواست روت، یا اطلاعات پارسل‌ها یا سقف تخمین ظرفیت سفارش را ارسال کنید.
ERROR_CODE_ADD_PARCEL_IS_NOT_ALLOWED_WHEN_ESTIMATED_CAPACITY_IS_NOT_RESERVED
عنوان سیستمی (Error Key)
1105
شرح بیزینسی خطا
افزودن بسته در صورت عدم رزرو ظرفیت تخمینی مجاز نیست.
راهکار رفع خطا
ابتدا باید ظرفیت تخمینی سفارش رزرو شود تا بتوان بسته جدید به آن اضافه کرد.
ERROR_CODE_SHIPMENT_MASS_USED_VOLUME_EXCEEDED_MAX_MASS_VOLUME_WHILE_ADDING_PARCEL
عنوان سیستمی (Error Key)
1106
شرح بیزینسی خطا
حجم کل سفارش از سقف حجم تخمینی رزرو شده بیشتر می‌شود.
راهکار رفع خطا
بسته جدید حجم کل سفارش را از سقف حجم تخمینی رزرو شده بالاتر می‌برد.
ERROR_CODE_SHIPMENT_MASS_USED_WEIGHT_EXCEEDED_TOTAL_WEIGHT_WHILE_ADDING_PARCEL
عنوان سیستمی (Error Key)
1107
شرح بیزینسی خطا
وزن کل سفارش از سقف وزن تخمینی رزرو شده بیشتر می‌شود.
راهکار رفع خطا
بسته جدید وزن کل سفارش را از سقف وزن تخمینی رزرو شده بالاتر می‌برد.
ERROR_CODE_ADD_PARCEL_TO_ROUTE_ENGINE_FOR_PRE_RESERVED_CAPACITY_FAILED
عنوان سیستمی (Error Key)
1108
شرح بیزینسی خطا
خطا در افزودن بسته به موتور مسیریابی برای ظرفیت پیش‌رزرو.
راهکار رفع خطا
فرآیند افزودن بسته به موتور مسیریابی با خطا مواجه شد؛ پارامترها را بررسی کنید.
ERROR_CODE_MASS_DOES_NOT_HAVE_A_SELECTED_ROUTE
عنوان سیستمی (Error Key)
1109
شرح بیزینسی خطا
سفارش انبوه (Mass) فاقد مسیر انتخاب شده است.
راهکار رفع خطا
فرآیند مسیریابی برای این بخش از سفارش‌های تجمیعی نهایی نشده است.
CODE_NO_ROUTE_WERE_FOUND
عنوان سیستمی (Error Key)
1178
شرح بیزینسی خطا
روت مناسب برای این سفارش پیدا نشد.
راهکار رفع خطا
اطلاعات مبدأ، مقصد، تاریخ آماده‌سازی بار، بازه تحویل، وزن، ابعاد و سطح سرویس را بررسی کنید. در صورتی که اطلاعات درست است، ممکن است در حال حاضر برای این مسیر یا ظرفیت موردنظر، امکان مسیریابی وجود نداشته باشد.
ERROR_CODE_REMOVE_PARCEL_WITH_PRE_RESERVED_CAPACITY_IS_NOT_ALLOWED_WHEN_MASS_STATUS_IS_NOT_RESERVED
عنوان سیستمی (Error Key)
1113
شرح بیزینسی خطا
حذف بسته از ظرفیت پیش‌رزرو در این وضعیت مجاز نیست.
راهکار رفع خطا
وضعیت فعلی مَس سفارش اجازه کم کردن یا حذف بسته از ظرفیت رزرو شده را نمی‌دهد.
ERROR_CODE_REMOVE_PARCEL_FROM_ROUTE_ENGINE_FOR_PRE_RESERVED_CAPACITY_FAILED
عنوان سیستمی (Error Key)
1114
شرح بیزینسی خطا
خطا در حذف بسته از موتور مسیریابی برای ظرفیت پیش‌رزرو.
راهکار رفع خطا
فرآیند حذف مرسوله از موتور روتینگ با خطا مواجه شد.
ERROR_CODE_SHIPMENT_MASS_STATUS_IS_NOT_RESERVED
عنوان سیستمی (Error Key)
1129
شرح بیزینسی خطا
وضعیت مَس سفارش در حالت رزرو شده نیست.
راهکار رفع خطا
عملیات درخواستی نیازمند وضعیت رزرو برای دیتای تجمیعی سفارش است.
ERROR_CODE_SHIPMENT_MASS_ROUTE_START_AFTER_IS_NOT_PASSED_YET
عنوان سیستمی (Error Key)
1130
شرح بیزینسی خطا
زمان آغاز روت سفارش تجمیعی هنوز فرانرسیده است.
راهکار رفع خطا
بر اساس زمان‌بندی روت، هنوز زمان شروع حرکت این بخش عملیاتی آغاز نشده است.
ERROR_CODE_SHIPMENT_MASS_HAS_PARCEL_SO_IT_SHOULD_NOT_BE_IDLE_AFTER_ROUTE_START
عنوان سیستمی (Error Key)
1131
شرح بیزینسی خطا
سفارش دارای بسته است و نباید بعد از شروع روت معطل (Idle) بماند.
راهکار رفع خطا
ناهماهنگی در چرخه لجستیک؛ سفارش با وجود داشتن بسته، وضعیت غیرفعال دارد.
ERROR_CODE_CURRENTLY_CANT_MARK_MASS_AS_IDLE_FOR_HAVING_NO_PARCELS_AFTER_ROUTE_START_FROM_POINT
عنوان سیستمی (Error Key)
1134
شرح بیزینسی خطا
عدم امکان تغییر وضعیت مَس به معطل به دلیل نداشتن بسته پس از آغاز روت.
راهکار رفع خطا
تغییر وضعیت به دایل یا معطل پس از خروج ناوگان از هاب لجستیکی مقدور نیست.
ERROR_CODE_YOU_CANNOT_PASS_ESTIMATED_CAP_OR_PARCELS_WHILE_ESTIMATED_CAP_IS_ALREADY_DEFINED BY TOKEN
عنوان سیستمی (Error Key)
1141
شرح بیزینسی خطا
عدم امکان ارسال مجدد ظرفیت تخمینی وقتی با توکن تعریف شده.
راهکار رفع خطا
تداخل اطلاعات؛ ظرفیت پیش از این توسط توکن معین شده و نیاز به ارسال مجدد ظرفیت یا پارسل‌ها نیست.
ERROR_CODE_YOU_CANNOT_PASS_SERVICE_LEVEL_READY_DATE_PROMISE_ORIGIN_OR_DESTINATION_WHILE_THEY ALREADY SET INSIDE TOKEN
عنوان سیستمی (Error Key)
1142
شرح بیزینسی خطا
عدم امکان ارسال متغیرهای اصلی سفارش وقتی درون توکن ست شده‌اند.
راهکار رفع خطا
فیلدهای اصلی مانند سطح سرویس، تاریخ آمادگی و مبدأ/مقصد درون توکن قفل شده‌اند و نباید در بادی فرستاده شوند.
ERROR_CODE_ADD_OR_REMOVE_PARCEL_NOT_ALLOWED_AFTER_MASS_ROUTE_START
عنوان سیستمی (Error Key)
1147
شرح بیزینسی خطا
افزودن یا حذف بسته پس از آغاز حرکت روت تجمیعی ممنوع است.
راهکار رفع خطا
فرآیند بارگیری و حرکت روت شروع شده است؛ هرگونه کم یا زیاد کردن مرسولات قفل است.

خطاهای فرآیند لغو سفارش (Cancellation Errors)

۸ ردیف
ERROR_CODE_CANCELLING_A_DELIVERED_SHIPMENT_IS_NOT_POSSIBLE
عنوان سیستمی (Error Key)
1014
شرح بیزینسی خطا
سفارش تحویل شده و قابل لغو نیست.
راهکار رفع خطا
سفارش مراحل نهایی را طی کرده و تحویل مشتری شده است؛ امکان لغو وجود ندارد.
ERROR_CODE_CANCELLING_SHIPMENT_WITH_PARCELS_HAVING_THESE_STATUSES_IS_NOT_POSSIBLE
عنوان سیستمی (Error Key)
1015
شرح بیزینسی خطا
وضعیت بسته‌ها اجازه لغو سفارش را نمی‌دهد.
راهکار رفع خطا
بسته‌ها در وضعیتی از چرخه توزیع هستند که عملیات لغو سیستمی آن‌ها مسدود شده است.
ERROR_CODE_CANCELLING_A_SHIPMENT_WITH_AT_LEAST_ONE_PARCEL_COORDINATED_TO_CONSIGNOR_IS_NOT_POSSIBLE
عنوان سیستمی (Error Key)
1M03
شرح بیزینسی خطا
لغو سفارش به دلیل هماهنگی مرسوله جهت بازگشت مقدور نیست.
راهکار رفع خطا
حداقل یکی از بسته‌ها در مسیر برگشت به فرستنده (کانساینر) قرار دارد و کل سفارش لغو نمی‌شود.
ERROR_CODE_SHIPMENT_IS_ALREADY_CANCELLED
عنوان سیستمی (Error Key)
1145
شرح بیزینسی خطا
سفارش از قبل لغو شده است.
راهکار رفع خطا
درخواست لغو برای سفارشی ارسال شده که پیش از این وضعیت لغو شده (Canceled) را گرفته است.
ERROR_CODE_NOT_CANCELABLE_CAUSE_SHIPMENT_NOT_FOUND_IN_ROUTE_ENGINE
عنوان سیستمی (Error Key)
1151
شرح بیزینسی خطا
سفارش در موتور مسیریابی لجستیک یافت نشد.
راهکار رفع خطا
سفارش جهت فرآیند لغو در موتور لجستیکی معتبر یا موجود نیست.
ERROR_CODE_NOT_CANCELABLE_CAUSE_SHIPMENT_IS_ALREADY_DELIVERED_IN_ROUTE_ENGINE
عنوان سیستمی (Error Key)
1152
شرح بیزینسی خطا
موتور لجستیک وضعیت سفارش را تحویل‌شده می‌داند.
راهکار رفع خطا
فرآیند توزیع پایان یافته و ثبت سیستمی شده است؛ امکان لغو وجود ندارد.
ERROR_CODE_NOT_CANCELABLE_BECAUSE OF_PROVIDER_DISAPPROVAL_IN_ROUTE_ENGINE
عنوان سیستمی (Error Key)
1153
شرح بیزینسی خطا
عدم تایید لغو توسط پیمانکار/تامین‌کننده لجستیکی.
راهکار رفع خطا
درخواست لغو توسط موتور اصلی یا شریک لجستیکی توزیع‌کننده رد شده است.
returning_or_returned
عنوان سیستمی (Error Key)
1103
شرح بیزینسی خطا
امکان لغو وجود ندارد؛ مرسوله در فرآیند عودت یا بازگشت به فرستنده (سلر) است.
راهکار رفع خطا
-

خطاهای فرآیند هماهنگی مجدد و تغییرات وضعیت (Coordination & Data Fixes)

۲۸ ردیف
ERROR_CODE_EITHER_NEW_PROMISE_RANGE_OR_NEW_RECIPIENT_ADDRESS_IS_REQUIRED_FOR_COORDINATION
عنوان سیستمی (Error Key)
1004
شرح بیزینسی خطا
ارسال بازه جدید یا آدرس جدید برای هماهنگی الزامی است.
راهکار رفع خطا
در متد هماهنگی مجدد، باید حداقل یکی از فیلدهای آدرس جدید یا بازه زمان جدید ارسال شود.
ERROR_CODE_COORDINATING_TO_A_LOCATION_OR_POINT_OUTSIDE_THE_ORIGINAL_DESTINATION_CITY_IS_NOT_ALLOWED
عنوان سیستمی (Error Key)
1007
شرح بیزینسی خطا
هماهنگی به شهری خارج از شهر مقصد اولیه مجاز نیست.
راهکار رفع خطا
در تغییر آدرس هماهنگی، نمی‌توانید شهر مقصد را به شهری غیر از شهر اولیه سفارش تغییر دهید.
ERROR_CODE_CHANGING_PROMISE_DATE_IS_ONLY_ACCEPTABLE_FOR_COORDINATION_IN_DRAFT_STATUS
عنوان سیستمی (Error Key)
1017
شرح بیزینسی خطا
تغییر تاریخ وعده تحویل فقط در وضعیت Draft هماهنگی مجاز است.
راهکار رفع خطا
وضعیت پرونده هماهنگی سفارش تغییر کرده و دیگر امکان ویرایش تاریخ تحویل وجود ندارد.
ERROR_CODE_CHANGING_RECIPIENT_ADDRESS_IS_ONLY_ACCEPTABLE_FOR_COORDINATION_IN_DRAFT_STATUS
عنوان سیستمی (Error Key)
1018
شرح بیزینسی خطا
تغییر آدرس گیرنده فقط در وضعیت Draft هماهنگی مجاز است.
راهکار رفع خطا
آدرس مشتری تنها زمانی در هماهنگی قابل تغییر است که وضعیت پرونده روی پیش‌نویس باشد.
ERROR_CODE_COORDINATION_CASE_COULD_BE_DROPPED_ONLY_IF_IS_IN_DRAFT_STATUS
عنوان سیستمی (Error Key)
1020
شرح بیزینسی خطا
حذف پرونده هماهنگی فقط در وضعیت Draft مجاز است.
راهکار رفع خطا
امکان بستن یا رها کردن فرآیند کوردی‌نیشن باز شده در این مرحله وجود ندارد.
ERROR_CODE_COORDINATION_CASES_COULD_BE_EDITED_ONLY_IN_DRAFT_STATUS
عنوان سیستمی (Error Key)
1021
شرح بیزینسی خطا
ویرایش هماهنگی فقط در وضعیت پیش‌نویس (Draft) مقدور است.
راهکار رفع خطا
تغییرات و ادیت در فیلدهای پرونده هماهنگی در این سطح از چرخه عملیات قفل است.
ERROR_CODE_CURRENTLY_LOCATED_POINT_ID_IS_MANDATORY_FOR_TRIGGERING_COORDINATION
عنوان سیستمی (Error Key)
1023
شرح بیزینسی خطا
شناسه نقطه استقرار فعلی بار برای آغاز هماهنگی الزامی است.
راهکار رفع خطا
باید شناسه مکان یا هابی که بار در حال حاضر در آنجا قرار دارد را ارسال کنید.
ERROR_CODE_NEW_PROMISE_RANGE_IS_MANDATORY_FOR_TRIGGERING_COORDINATION_CASE
عنوان سیستمی (Error Key)
1055
شرح بیزینسی خطا
بازه جدید وعده تحویل برای ایجاد پرونده هماهنگی اجباری است.
راهکار رفع خطا
فیلد زمان‌بندی جدید ارسال کالا را در درخواست هماهنگی پر کنید.
ERROR_CODE_PARCEL_COULD_NOT_BE_COORDINATED_FROM_CURRENT_STATUS
عنوان سیستمی (Error Key)
1063
شرح بیزینسی خطا
بسته از وضعیت فعلی‌اش امکان ورود به فرآیند هماهنگی را ندارد.
راهکار رفع خطا
وضعیت فعلی مرسوله اجازه ایجاد فرآیند هماهنگی مجدد (Coordination) را صادر نمی‌کند.
ERROR_CODE_SETTING_CURRENT_SHIPPING_POINT_ID_IS_ONLY_ACCEPTABLE_FOR_COORDINATION_IN_DRAFT_STATUS
عنوان سیستمی (Error Key)
1072
شرح بیزینسی خطا
تنظیم شناسه هاب فعلی فقط در وضعیت Draft هماهنگی ممکن است.
راهکار رفع خطا
اعمال شناسه هاب جاری کالا تنها در حالت پیش‌نویس پرونده هماهنگی مجاز است.
ERROR_CODE_SETTING_RECIPIENT_PERSON_FOR_COORDINATION_WITH_RETURN_TO_CONSIGNOR_SOURCE_IS_NOT_POSSIBLE
عنوان سیستمی (Error Key)
1073
شرح بیزینسی خطا
تغییر گیرنده برای بارهای در مسیر بازگشت به فرستنده مجاز نیست.
راهکار رفع خطا
وقتی بار در وضعیت مرجوعی به کانساینر (RTC) قرار گرفته، تغییر نام تحویل‌گیرنده خطاست.
ERROR_CODE_SHIPMENT_IS_NOT_ELIGIBLE_FOR_REVIVING
عنوان سیستمی (Error Key)
1079
شرح بیزینسی خطا
سفارش در وضعیت قابل Revive نیست.
راهکار رفع خطا
Revive فقط زمانی مجاز است که Shipment قبلی با همین consignor_unique_reference_id به یک وضعیت نهایی ناموفق رسیده باشد. اگر Shipment قبلی موفق باشد یا همچنان در جریان فرآیند عملیاتی قرار داشته باشد، امکان Revive وجود ندارد.
ERROR_CODE_THERE_IS_NO_OPEN_COORDINATION_CASE_FOR_PARCEL_AT_THE_MOMENT
عنوان سیستمی (Error Key)
1086
شرح بیزینسی خطا
هیچ پرونده هماهنگی بازی برای این بسته وجود ندارد.
راهکار رفع خطا
متدهای مربوط به هماهنگی را زمانی صدا زده‌اید که هیچ کیسِ بازی برای این مرسوله ثبت نشده است.
ERROR_CODE_TRIGGERING_NEW_COORDINATION_IS_NOT_ALLOWED_WHILE_PREVIOUS_COORDINATION_AWAITING_CANDIDATE_ROUTES
عنوان سیستمی (Error Key)
1087
شرح بیزینسی خطا
عدم امکان ایجاد هماهنگی جدید وقتی هماهنگی قبلی منتظر روت است.
راهکار رفع خطا
تا زمان تعیین تکلیف و مسیردهی کیس هماهنگی قبلی، امکان ایجاد درخواست جدید وجود ندارد.
ERROR_CODE_TRIGGERING_NONE_RTC_WHILE_ALREADY_COORDINATED_TO_RTC_NOT_ALLOWED
عنوان سیستمی (Error Key)
1088
شرح بیزینسی خطا
تغییر وضعیت از مرجوعی به ارسال عادی در فرآیند هماهنگی مجاز نیست.
راهکار رفع خطا
سفارش وارد لوپ مرجوع به فرستنده (Return to Consignor) شده و نمی‌توان آن را دوباره به مسیر توزیع عادی برگرداند.
ERROR_CODE_ADD_OR_REMOVE_PARCEL_NOT_POSSIBLE_FOR_COORDINATED_SHIPMENT
عنوان سیستمی (Error Key)
1125
شرح بیزینسی خطا
عدم امکان کم یا زیاد کردن بسته‌ها برای سفارش هماهنگ‌شده.
راهکار رفع خطا
سفارشی که فرآیند هماهنگی مجدد آن نهایی شده، امکان تغییر در تعداد بسته‌هایش وجود ندارد.
ERROR_CODE_PARCEL_COULD_NOT_BE_COORDINATED_FORWARD_IN_CANCEL_WHILE_BEING_DELIVERING_STATUS
عنوان سیستمی (Error Key)
1146
شرح بیزینسی خطا
عدم امکان فرآیند رو به جلوی هماهنگی برای بسته‌های در حال توزیع.
راهکار رفع خطا
مرسوله در مرحله مایل آخر و به سفیر سپرده شده؛ امکان تغییر مسیر هماهنگی قفل است.
ERROR_CODE_COORDINATING_SHIPMENT_IS_NOT_POSSIBLE_WITH_CANCELED_PARCELS
عنوان سیستمی (Error Key)
1161
شرح بیزینسی خطا
هماهنگی سفارش با وجود بسته‌های لغو شده امکان‌پذیر نیست.
راهکار رفع خطا
سفارش حاوی پارسل‌های لغو شده (Canceled) است و قابلیت ورود به فرآیند هماهنگی را ندارد.
ERROR_CODE_COORDINATING_SHIPMENT_IS_NOT_POSSIBLE_WITH_IDLE_PARCELS
عنوان سیستمی (Error Key)
1162
شرح بیزینسی خطا
هماهنگی سفارش با بسته‌های معطل (Idle) مجاز نیست.
راهکار رفع خطا
بسته‌ها در وضعیت نامشخص و راکد لجستیکی هستند؛ وضعیت آن‌ها را تعیین تکلیف کنید.
ERROR_CODE_COORDINATING_SHIPMENT_IS_NOT_POSSIBLE_WITH_PARCELS_WITHOUT_SELECTED_ROUTE
عنوان سیستمی (Error Key)
1163
شرح بیزینسی خطا
هماهنگی سفارش برای بسته‌های بدون مسیر مشخص مجاز نیست.
راهکار رفع خطا
ابتدا باید فرآیند انتخاب مسیر و روتینگ بسته‌ها انجام شود تا هماهنگی معنا پیدا کند.
ERROR_CODE_COORDINATING_SHIPMENT_IS_NOT_POSSIBLE_WITH_PARCELS_IN_THE_FINAL_RIDE
عنوان سیستمی (Error Key)
1164
شرح بیزینسی خطا
هماهنگی سفارش با بسته‌های سوار بر خودروی توزیع نهایی ممنوع است.
راهکار رفع خطا
کالا در آخرین مرحله توزیع فیزیکی است؛ پرونده هماهنگی مجدد در این گام قفل است.
ERROR_CODE_COORDINATING_SHIPMENT_IS_NOT_POSSIBLE_WITH_DELIVERED_PARCELS
عنوان سیستمی (Error Key)
1165
شرح بیزینسی خطا
هماهنگی سفارش با بسته‌های تحویل داده شده ممنوع است.
راهکار رفع خطا
کالا پیش از این به مشتری تحویل شده؛ ایجاد کیس هماهنگی مجدد معنایی ندارد.
ERROR_CODE_COORDINATING_SHIPMENT_IS_NOT_ELIGIBLE_IN_ROUTE_ENGINE
عنوان سیستمی (Error Key)
1166
شرح بیزینسی خطا
سفارش واجد شرایط هماهنگی در موتور روتینگ نیست.
راهکار رفع خطا
ساختار یا وضعیت لجستیکی سفارش توسط هسته روتینگ برای هماهنگی مجدد رد شده است.
ERROR_CODE_PARCEL_DATA_FIX_REASON_IS_MANDATORY
عنوان سیستمی (Error Key)
1168
شرح بیزینسی خطا
ذکر دلیل برای اصلاح داده‌ها (Data Fix) الزامی است.
راهکار رفع خطا
هنگام فراخوانی متدهای اصلاح داده مرسوله، ارسال فیلد متنی علت تغییرات اجباری است.
ERROR_CODE_PARCEL_COULD_NOT_BE_DATA_FIXED_FROM_CURRENT_STATUS
عنوان سیستمی (Error Key)
1170
شرح بیزینسی خطا
عدم امکان اصلاح داده بسته از وضعیت فعلی آن.
راهکار رفع خطا
وضعیت جاری مرسوله در سیستم اجازه اعمال متد دیتای‌فیکس (اصلاح داده پشتبانی) را نمی‌دهد.
ERROR_CODE_REPETITIVE_DATA_FIX
عنوان سیستمی (Error Key)
1171
شرح بیزینسی خطا
درخواست اصلاح داده تکراری است.
راهکار رفع خطا
فرآیند دیتای‌فیکس با پارامترهای مشابه قبلاً روی این بسته اعمال شده و تکرار آن خطا است.
ERROR_CODE_PARCEL_COULD_NOT_BE_DATA_FIXED_TO_DELIVERED_FROM_RETURNED_STATUS
عنوان سیستمی (Error Key)
1172
شرح بیزینسی خطا
عدم امکان تغییر وضعیت مرسوله مرجوعی به تحویل‌شده از طریق اصلاح داده.
راهکار رفع خطا
بسته‌ای که وضعیت نهایی مرجوع‌شده (Returned) گرفته را نمی‌توان به تحویل‌شده تغییر داد.
ERROR_CODE_ADD_OR_REMOVE_PARCEL_NOT_POSSIBLE_FOR_COORDINATED_SHIPMENT
عنوان سیستمی (Error Key)
1125
شرح بیزینسی خطا
تغییر در تعداد بسته‌های سفارشِ هماهنگ‌شده مجاز نیست.
راهکار رفع خطا
سفارش فاز کوردی‌نیشن را گذرانده و ساختار تعداد اقلام آن کاملاً قفل و غیرقابل تغییر است.

خطاهای مالی، هزینه توزیع و پرداخت در محل (Finance & COD)

۱۰ ردیف
ERROR_CODE_INVALID_MONEY
عنوان سیستمی (Error Key)
1040
شرح بیزینسی خطا
مبلغ مالی ارسالی نامعتبر است.
راهکار رفع خطا
ساختار عدد ارسالی فیلد مالی را بررسی کنید (نباید منفی، کاراکتر متنی یا خارج از رنج باشد).
ERROR_CODE_MONEY_CANNOT_BE_NEGATIVE
عنوان سیستمی (Error Key)
1053
شرح بیزینسی خطا
مبلغ مالی نمی‌تواند عدد منفی باشد.
راهکار رفع خطا
فیلدهای مربوط به ارزش کالا یا COD حتماً باید صفر یا یک عدد مثبت صحیح باشند.
ERROR_CODE_MONEY_IS_MANDATORY
عنوان سیستمی (Error Key)
1054
شرح بیزینسی خطا
ارسال فیلد مبلغ مالی اجباری است.
راهکار رفع خطا
مبالغ مالی مورد نیاز متد (مانند ارزش مرسوله) ارسال نشده است؛ درج آن الزامی است.
ERROR_CODE_MONEY_VALUE_CANNOT_BE_FLOAT
عنوان سیستمی (Error Key)
1121
شرح بیزینسی خطا
مبلغ مالی نباید اعشاری (Float) باشد.
راهکار رفع خطا
مبالغ را اصلاح کنید؛ سیستم مبالغ را به صورت عدد صحیح به ریال می‌پذیرد (ریال اعشار ندارد).
ERROR_CODE_USER_IS_NOT_ALLOWED_TO_SET_PAYABLE_PRICE
عنوان سیستمی (Error Key)
1135
شرح بیزینسی خطا
عدم داشتن دسترسی برای تعیین مبلغ قابل پرداخت.
راهکار رفع خطا
اکانت شما اجازه تعیین یا تغییر قیمت هزینه پرداختی کالا در محل را ندارد.
ERROR_CODE_UPDATING_PAYABLE_PRICE_OF_A_DELIVERED_SHIPMENT_IS_NOT_POSSIBLE
عنوان سیستمی (Error Key)
1089
شرح بیزینسی خطا
عدم امکان تغییر مبلغ برای سفارش تحویل‌شده.
راهکار رفع خطا
فرآیند مالی سفارش تحویل‌شده بسته شده است و تغییر مبلغ قابل دریافت از مشتری ممکن نیست.
ERROR_CODE_UPDATING_PAYABLE_PRICE_TO_LARGER_AMOUNTS_IS_NOT_POSSIBLE
عنوان سیستمی (Error Key)
1156
شرح بیزینسی خطا
عدم امکان افزایش مبلغ به مقادیر بیشتر در این مرحله.
راهکار رفع خطا
سیاست‌های مالی سیستم اجازه افزایش قیمت فاکتور و هزینه COD را در این وضعیت عملیاتی نمی‌دهد.
ERROR_CODE_UPDATING_PAYABLE_PRICE_REJECTED_BY_PROVIDER
عنوان سیستمی (Error Key)
1157
شرح بیزینسی خطا
تغییر قیمت توسط تامین‌کننده لجستیک رد شد.
راهکار رفع خطا
درخواست تغییر هزینه توسط نهاد لجستیکی پردازنده‌ مرسوله تایید نشده است.
ERROR_CODE_UPDATING_PAYABLE_PRICE_IS_NOT_POSSIBLE_IN_CURRENT_STATUS
عنوان سیستمی (Error Key)
1158
شرح بیزینسی خطا
وضعیت فعلی سفارش اجازه تغییر قیمت را نمی‌دهد.
راهکار رفع خطا
برای تغییر مبلغ فاکتور دیر شده است؛ سفارش در وضعیتی است که مقادیر مالی آن فیکس شده‌اند.
ERROR_CODE_UPDATING_PAYABLE_PRICE_REJECTED_BY_FINANCE
عنوان سیستمی (Error Key)
1175
شرح بیزینسی خطا
مخالفت واحد مالی دیجی‌اکسپرس با تغییر قیمت.
راهکار رفع خطا
درخواست اصلاح مالی فاکتور کالا توسط کور-سیستم مالی رد گردید.