Change Passenger Info
متد DoChange
وبسرویس DoChange جهت ویرایش اطلاعات مسافر مورد استفاده قرار میگیرد. در حال حاضر، امکان اعمال تغییرات زیر از طریق این وبسرویس فراهم است:
- تغییر عنوان مسافر (آقا / خانم):
در حال حاضر این نوع تغییر رایگان بوده و مشمول هزینه نمیباشد. - تغییر نام مسافر (حداکثر یک یا دو کاراکتر):
امکانپذیری این تغییر بسته به تنظیمات تأمینکننده خدمات است و مشمول هزینه میباشد. هدف اصلی استفاده از این متد، محاسبه هزینه جریمه تغییر نام مسافر است. - تغییر اطلاعات گذرنامه شامل شماره گذرنامه، تاریخ انقضا و محل صدور:
در حال حاضر این نوع تغییر رایگان بوده و مشمول هزینه نمیباشد.
توجه: سرویس «تغییر اطلاعات مسافر» ممکن است برای برخی از تأمینکنندگان غیرفعال باشد. در چنین شرایطی، هنگام فراخوانی متد GetPenalty، خطای Error1033-ChangePassengerInfoAccessDenied به عنوان پاسخ بازگردانده خواهد شد. در صورت دریافت این خطا، امکان تغییر اطلاعات مسافر از طریق وبسرویس وجود ندارد و لازم است تغییرات موردنظر بهصورت مستقیم با تأمینکننده مربوطه انجام شود.
API Endpoint
https://{SupplierWebsiteUrl}/api/Partners/Flight/ChangePassengerInfo/V1/DoChange post
Request Parameters
نمونه کلاس Request به زبان سی شارپ در پروژه Partners.Contracts (دانلود) در پوشه زیر موجود است:
\Flight\ChangePassengerInfo\V1\DoChange\RequestModel
string
string
رمز عبور به صورت MD5 شده
Pnr
string
رفرنس رزروی که میخواهید یک یا همه ی مسافران آن را استرداد نمایید
List(Passenger)
string
این شناسه بهصورت یکتا برای هر مسافر تعریف میشود و در خروجی متدهای زیر قابل دسترسی است:
PassengerNewData
complex type
اطلاعات جدیدی که می خواهید برای مسافر ثبت شود
string
جنسیت مسافر که مقدار آن میتواند یکی از دو حالت زیر باشد:
M: مردF: زن
string
نام مسافر
string
نام خانوادگی مسافر
complex type
اطلاعات گذرنامه مسافر
Number
string
شماره گذرنامه مسافر
string
تارخ انقضا گذرنامه با فرمت yyyy-MM-dd و به صورت میلادی.
string
کد ISO دو حرفی یا سه حرفی محل صدور گذرنامه مسافر
جهت مشاهده کد ISO کشور ها اینجا کلیک نمایید.
به عنوان مثال برای ایران می توانید یکی از مقدارهای IR یا IRN را وارد نمایید.
TotalPenalty
decimal
Culture
string
مشخص میکند پیامهای خطا بر اساس کدام زبان خروجی داده شوند. مقدار این فیلد میتواند یکی از گزینههای en-US، ar-IQ یا fa-IR باشد.
{
"Username": "TestDev1",
"Password": "25f9e794323b453885f5181f1b624d0b",
"Pnr": "AG3B2V",
"PassengerList": [{
"Id": "ae3c2436-4be8-48b3-a3f1-1b2c2c03c32d",
"PassengerNewData": {
"GenderType": "M",
"FirstName": "SEYEDEHKIANA",
"LastName": "MOSTAMAND",
"Passport": null
}
}, {
"Id": "f0ecdce9-3734-4074-80ac-e3f0c173afd7",
"PassengerNewData": {
"GenderType": "F",
"FirstName": "MOHADESEH",
"LastName": "ASHRAFVAGHEFI",
"Passport": null
}
}
],
"TotalPenalty": 2000000.0,
"Culture": "fa-IR"
}
{
"Username": "TestDev1",
"Password": "25f9e794323b453885f5181f1b624d0b",
"Pnr": "I54848",
"PassengerList": [{
"Id": "355e2df8-fae0-4cad-86f4-5d511b9008bc",
"PassengerNewData": {
"GenderType": "M",
"FirstName": "ABED",
"LastName": "HOSSEYNI",
"Passport": {
"Number": "A56753465",
"ExpiryDate": "2029-11-20",
"PlaceOfIssueCountryCode": "IR"
}
}
}
],
"TotalPenalty": 0.0,
"Culture": "fa-IR"
}
Response common exceptions
در جدول زیر لیستی از خطاهایی که ممکن است بعد از فراخوانی این متد برگشت داده شود، فهرست شده است.
| ExceptionType | توضیح خطا |
|---|---|
Error1032-ReservationChangePassengerInfoIsDoneOnceBefore | این رزرو قبلا اصلاح شده است و امکان ویرایش مجدد آن وجود ندارد. |
Error1033-ChangePassengerInfoAccessDenied | سرویس ویرایش اطلاعات مسافران روی سیستم تامین کننده فعال نیست. |
Error1034-PenaltyMismatch | مبلغ جریمه ارسال شده با جریمه تعریف شده در سیستم مطابقت ندارد. |
Exception | خطای نامشخص. جهت دریافت اطلاعات بیشتر باید به ErrorMessage داخل json برگشتی مراجعه نمود. |