Коды ошибок веб-сервиса
Общие положения¶
Под ошибками понимается¶
ошибки (error), означающие неуспешное выполнение той или иной операции. Ошибки носят глобальный контекст.
предупреждения (warning), означающие либо частичное выполнение операции, либо сообщение о невозможности выполнения операции согласно установленным бизнес-процессам, что ошибкой не является.
Уровни ошибок¶
MixVel API предусматривает 3 уровня для передачи ошибок:
1-й уровень: Envelope/Body/Error/
Сюда относятся ошибки, связанные с:
-
Нарушением формата запроса (не соответствует XSD схеме).
-
Авторизацией (запрос не авторизован).
2-й уровень: Mixvel_[AirShopping]RS/Error
Здесь появляются ошибки, когда запрос полностью не обработан.
Сюда относятся ошибки, связанные с логической проверкой запроса и результатами обработки запроса, такие как:
- неверные даты вылета;
- отрицательное количество пассажиров;
- несуществующие станции;
- отсутствующий контент;
- и пр.
3-й уровень (Warning): Mixvel_[AirShopping]RS/Response/Warning
Запрос обработан, результат передан, но с рядом ограничений.
Структуры для передачи ошибок¶
В MixVel API реализована следующая структура:
Рисунок 40
ErrorType — логический тип ошибки. Принимает значения:
«BadRequest» — ошибка в запросе.
«InternalServerError» — ошибка на стороне MixVel API.
«ProviderError» — ошибка на стороне провайдера.
CanRetry — можно ли осуществить повтор отправки сообщения. Принимает значения «true» / «false».
RetryAfter — если CanRetry = true, указывается рекомендованное количество секунд, по прошествии которых необходимо повторить отправку запроса.
TicketId — в случае если MixVel порождает ticket в системе учета инцидентов, здесь будет передан его идентификатор.
Code — код ошибки. Коды ошибок приведены ниже по тексту настоящего руководства.
DescText — текстовое описание ошибки.
Перечень кодов ошибок¶
| № | ErrorCode | ErrorType | ErrorDesc |
| I. Auth | |||
| 1. | MIX-100100001 | BadRequest | InvalidUsernameOrPassword Неверный логин или пароль |
| 2. | MIX-100100002 | BadRequest | AuthenticationFailed Вам не доступен данный функционал. Пожалуйста, обратитесь в поддержку, чтобы проверить ваш доступ |
| II. Common | |||
| 1. | MIX-100100006 | BadRequest | BadXmlRequest XML request not being recognised/resolved. + xmlExceptionMessage |
| 2. | MIX-100100005 | BadRequest | EnvelopeValidation Структура запроса не соответствует XSD ({errorLevel}): {validationEvent.Message} |
| 3. | MIX-100100004 | BadRequest | DictionaryItemNotFound Значение ({standard}:{code}) элемента {entityCode} отсутствует в кодификаторах. Актуализируйте справочники MixVel |
| 4. | MIX-100100007 | BadRequest | OfferNotFound Предложения ({string.Join(',', invalidOfferIds)}) не найдены или срок действия истек |
| 5. | MIX-100100003 | BadRequest | OperationNotAllowed Метод запрещен |
| 6. | MIX-100000001 | InternalServerError | OperationCancelledByUser Запрос отменен пользователем |
| 7. | MIX-100200004 | BadRequest | RequestNotSupportedByProvider Request does not supported by Provider: {requestError} |
| 8. | MIX-100100008 | BadRequest | RequestNotSupportedByProvider Указанная валюта '{currency}' не поддерживается |
| 9. | MIX-100100009 | BadRequest | CurrencyNotAllowed Указанная валюта '{currency}' не установлена для Подразделения |
| 10. | MIX-100100010 | BadRequest | CurrencyNotAllowed Никакая валюта не установлена для Подразделения |
| 11. | MIX-100100011 | BadRequest | Concurrency Над запрошенным ресурсом происходит параллельное выполнение иной операции |
| 12. | MIX-100200002 | InternalServerError | InternalServiceError Внутренняя ошибка сервиса. Обратитесь в службу технической поддержки (неисправность № {mixvelTraceId}) |
| 13. | MIX-100200003 | BadRequest | OperationNotImplementedByProviderException Операция не поддерживается поставщиком |
| 14. | MIX-100200001 | InternalServerError | ServiceTemporarilyUnavailable Сервис временно недоступен. Повторите попытку через {retryAfterSec.ToString()} секунд |
| III. AirShopping | |||
| 1. | MIX-100102002 | BadRequest | UnsupportedRequest Поиск с использованием Mixvel_LocationID в настоящий момент не поддерживается. Повторите запрос с использованием кодов IATA и ТКП |
| 2. | MIX-100102003 | BadRequest | UnsupportedRequest Множественное указание промокодов на настоящий момент не поддерживается |
| 3. | MIX-100102004 | BadRequest | UnsupportedRequest Суммарное значение диапазонов дат не должно превышать {maxDateRange} |
| 4. | MIX-100102005 | BadRequest | UnsupportedRequest Количество младенцев, допускаемых к бесплатной перевозке, превышает максимально допустимое количество на одного взрослого пассажира |
| 5. | MIX-100102006 | BadRequest | UnsupportedRequest При указании нескольких ProgramCriteria обязательно заполнение OwnerCode для каждой программы |
| 6. | MIX-100102007 | BadRequest | UnsupportedRequest Для одного OwnerCode указано несколько ProgramCriteria |
| 7. | MIX-100102008 | BadRequest | UnsupportedRequest Для поиска по бренду необходимо дополнительно указать фильтр по АК для каждого сегмента |
| 8. | MIX-100102009 | BadRequest | UnsupportedRequest OriginDestRefID {key} не привязан к OriginDestCriteria |
| 9. | MIX-100102010 | BadRequest | UnsupportedRequest В запросе не указано ни одного пассажира (отсутствует PaxList) |
| 10. | MIX-100102011 | BadRequest | UnsupportedRequest Не указана категория пассажира |
| 11. | MIX-100102001 | BadRequest | ViolateDepartureDate Диапазон даты вылета в прошлом |
| 12. | MIX-100102002 | BadRequest | ViolateDepartureDate Диапазон даты вылета указан некорректно |
| 13. | MIX-100102012 | BadRequest | Недопустим одновременный ввод {nameof(ConnectionCriteriaType.MaximumConnectionQty)}='0' и {nameof(ConnectionCriteriaType.StationCriteria)} |
| IV. ServiceList | |||
| 1. | MIX-100104001 | BadRequest | UnsupportedRequest OfferRequest может содержать только один Offer |
| V. OfferPrice | |||
| 1. | MIX-100103002 | BadRequest | PassengerNotFound Пассажиры с идентификаторами '{string.Join(" ", paxIds)}' не найдены |
| 2. | MIX-100103001 | BadRequest | OfferIdIsNotActual Запрашиваемые рейсы для OfferId {offerId} неактуальны. Попробуйте выбрать другое предложение. |
| VI. OrderCreate | |||
| 1. | MIX-100107001 | BadRequest | OffersAlreadyReservedError Указанные предложения уже забронированы: {offerIds} |
| 2. | MIX-100107002 | BadRequest | InconsistentRequestError У предложения(-й) ({offerIds}) в запросе отсутствует родитель |
| 3. | MIX-100107003 | BadRequest | InconsistentRequestError Запрошенные(-й) OfferItemId {offerItemIds} не является частью предложения |
| 4. | MIX-100107004 | BadRequest | InconsistentRequestError Указанный(-е) OfferItemId {offerItemIds} отсутствует в запросе |
| 5. | MIX-100107005 | BadRequest | InconsistentRequestError Указанный в ремарке PaxSegmentRefID {remarkPaxSegmentId} не найден в бронируемом предложении |
| 6. | MIX-100107006 | BadRequest | InconsistentRequestError В запросе не указан ни один номер телефона |
| 7. | MIX-100107007 | BadRequest | InconsistentRequestError В запросе не указано ни одного контакта пассажира (отсутствует ContactInfoList) |
| 8. | MIX-100107008 | BadRequest | InconsistentRequestError В ремарке '{remarkType.ToString()}' {(isRequired ? "" : "не ")}требуется привязка к пассажиру |
| 9. | MIX-100107009 | BadRequest | InconsistentRequestError В ремарке '{remarkType.ToString()}' {(isRequired ? "" : "не ")}требуется привязка к сегменту |
| 10. | MIX-100107010 | BadRequest | InconsistentRequestError В ремарке '{remarkType}' {(isRequired ? "требуется" : "запрещен")} пользовательский текст |
| 11. | MIX-100107011 | BadRequest | InconsistentRequestError Для программы лояльности {loyalty} обязательно указание PaxSegmentRefID |
| 12. | MIX-100107012 | BadRequest | InconsistentRequestError Бронирование с одной картой лояльности на несколько предложений на данный момент не поддерживается |
| 13. | MIX-100107013 | BadRequest | InconsistentRequestError В предложениях используются разные формы оплаты |
| VII. OrderChange | |||
| 1. | MIX-100109001 | BadRequest | EnvelopeValidation В структуре запроса OrderChange.Request.ChangeOrder.UpdateOrderItem допустимо указывать одно из: AcceptOffer или DeleteOrderItemList. |
| 2. | MIX-100109002 | BadRequest | EnvelopeValidation Операция возврата возможна только для оплаченных заказов. |
| 3. | MIX-100109003 | BadRequest | InconsistentRequestError Предложение(-я) ({offerIds}) принадлежит другому родителю |
| 4. | MIX-100109004 | BadRequest | InconsistentRequestError Заказ(-ы) ({orderIds}) не найдены в запрошенной мультикорзине |
| 5. | MIX-100109005 | BadRequest | InconsistentRequestError Заказ {orderId} находится на статусе 'Оформлен'. Изменение данных указанных пассажиров в заказе невозможно. |
| 6. | MIX-100109006 | BadRequest | InconsistentRequestError Категория пассажира недоступна для добавления в бронирование. |
| 7. | MIX-100109007 | BadRequest | InconsistentRequestError Произошла ошибка при удалении данных пассажира(-ов). Операция недопустима. |
| 8. | MIX-100109008 | BadRequest | InconsistentRequestError Данного PaxID = '{paxId}' нет в указанном заказе |
| 9. | MIX-100109009 | BadRequest | InconsistentRequestError Данный PaxID = '{paxId}' задвоен |
| 10. | MIX-100109010 | BadRequest | InconsistentRequestError Данный ID контакта пассажира = '{contactId}' уже указан в заказе |
| 11. | MIX-100109011 | BadRequest | InconsistentRequestError Указанный в ремарке PaxRefID '{paxId}' не найден в заказе |
| 12. | MIX-100109012 | BadRequest | InconsistentRequestError Указанный в ремарке PaxSegmentRefID '{paxSegmentId}' не найден в заказе |
| 13. | MIX-100109013 | BadRequest | InconsistentRequestError Указанная ремарка '{type}' ({text}) не найдена в заказе |
| 14. | MIX-100109014 | BadRequest | InconsistentRequestError Указанная лояльность '{accountNumber}' не найдена в заказе. Выполните OrderRetrieve для получения актуального состояния заказа |
| 15. | MIX-100109015 | BadRequest | InconsistentRequestError Указанный для изменения документ '{docTypeRef}' не найден |
| 16. | MIX-100109016 | BadRequest | InconsistentRequestError Итоговая стоимость Вашего расчета на возврат изменилась. Повторите расчет |
| 17. | MIX-100109017 | BadRequest | InconsistentRequestError Заказ '{orderId}' не связан с пассажиром '{paxRefId}' |
| 18. | MIX-100109018 | BadRequest | InconsistentRequestError Ручной возврат возможен только для всех пассажиров заказа |
| 19. | MIX-100109019 | BadRequest | InconsistentRequestError Данный PaxID = '{paxId}', PaxSegmentID = '{paxSegmentId}' задвоен |
| 20. | MIX-100109020 | BadRequest | InconsistentRequestError Для операции ручного обмена/возврата необходимо передавать сегменты, запрошенные на OrderReshopRQ |
| 21. | MIX-100109021 | BadRequest | InconsistentRequestError Оценка ручного обмена/возврата произведена на все сегменты заказа, дополните детализацию стоимости на следующие сегменты: {string.Join(',', paxSegmentIds)} |
| 22. | MIX-100109022 | BadRequest | InconsistentRequestError Запрещено использовать негативные величины в ручном возврате |
| 23. | MIX-100109023 | BadRequest | InconsistentRequestError Запрещено использовать '{nameof(TaxOperationType)}.{nameof(TaxOperationType.Move)}' в ручном возврате |
| 24. | MIX-100109024 | BadRequest | InconsistentRequestError Ручной возврат возможен только для расчёта в ручном режиме |
| 25. | MIX-100109025 | BadRequest | InconsistentRequestError Автоматический возврат возможен только для расчёта в автоматическом режиме |
| 26. | MIX-100109026 | BadRequest | InconsistentRequestError OrderItem = '{orderItemRefId}' не ассоциирован с EMD |
| 27. | MIX-100109027 | BadRequest | InconsistentRequestError Для операции ручного возврата EMD необходимо передавать OrderItem, запрошенные на OrderReshopRQ |
| 28. | MIX-100109028 | BadRequest | InconsistentRequestError Операция недопустима для OrderItemID: {string.Join(',', orderItemIds)} |
| VIII. OrderCancel | |||
| 1. | MIX-100110003 | InconsistentRequestError | NoOrdersToCancel Купон EMD для OrderItem = '{string.Join(',', orderItemIds)}' отсутствует |
| 2. | MIX-1001100011 | BadRequest | NoOrdersToCancel Мультикорзина не содержит заказов, доступных для отмены |
| 3. | MIX-100110004 | BadRequest | NoOrdersToCancel Заказ не содержит EMD купонов, доступных для отмены |
| 4. | MIX-100110002 | BadRequest | OrderStatusMismatchError Заказ был изменен, воспользуетесь методом OrderRetrieve и повторите запрос в случае необходимости |
| IX. Reshop | |||
| 1. | MIX-100111007 | BadRequest | InconsistentRequestError Не указана форма оплаты |
| 2. | MIX-100111001 | BadRequest | PartialRefundNotSupported Оценка условий возврата возможна только для полностью оплаченной Мультикорзины |
| 3. | MIX-100111002 | BadRequest | OrderIsNotRefundable Возврат заказа не разрешен |
| 4. | MIX-100111003 | BadRequest | PassengerNotFound Пассажир {paxId} не найден |
| 5. | MIX-100111004 | BadRequest | PassengerNotFound Расчёт на обмен разрешён только для одного пассажира |
| 6. | MIX-100111005 | BadRequest | OrderIsAlreadyRefunded Заказ {orderId} уже был возвращен |
| 7. | MIX-100111006 | BadRequest | MixOrderHasNoOrderToRefund В Мультикорзине {mixOrderId} отсутствуют заказы для возврата |
| 8. | MIX-100111008 | BadRequest | InconsistentRequestError Документ с типом {docType} не найден у пассажира |
| 9. | MIX-100111009 | BadRequest | InconsistentRequestError Данный PaxSegmentID = '{paxSegmentRefId}' задвоен |
| 10. | MIX-100111010 | BadRequest | InconsistentRequestError Заказ '{orderId}' не имеет оплаченных билетов для обмена |
| 11. | MIX-100111011 | BadRequest | InconsistentRequestError Заказ должен быть оплачен '{orderId}' для оценки условий возврата |
| 12. | MIX-100111012 | BadRequest | InconsistentRequestError Указание формы оплаты при возврате запрещено |
| X. PriceCalendar | |||
| 1. | MIX-100006 | BadRequest | UnsupportedRequest FlightRequest может содержать максимум 2 OriginDestCriteria |
| 2. | MIX-100006 | BadRequest | UnsupportedRequest Календарь цен с использованием фильтра Exclude в настоящий момент не поддерживается |
| XI. OrderPayment | |||
| 1. | MIX-107004 | BadRequest | MixOrderNotAllowed Переданный к оплате Заказ MixVel (ID = {mixOrderId}) не соответствует Заказу заявленному Агентством |
| 2. | MIX-107005 | BadRequest | OrdersInFrozenState Заказ MixVel (ID = {mixOrderId}) в процессе оплаты |
| 3. | MIX-107007 | BadRequest | OrdersAlreadyPayedWithDifferentFop Произошла аннуляция полетных сегментов; Итоговая стоимость Вашего расчета на обмен изменилась. Повторите расчет |
| 4. | MIX-112001 | BadRequest | MixOrderHasAlreadyBeenPaid В мультикорзине нет заказов к оплате |
| 5. | MIX-107006 | BadRequest | HasUnconfirmedServices В заказе есть неподтверждённые допуслуги, воспользуетесь методом OrderRetrieve для просмотра и повторите запрос позднее |
| XII. PaymentValidation | |||
| 1. | MIX-107002 | BadRequest | InconsistentPaymentAmount Сумма к оплате ({paymentSum}) не соответствует полной сумме MixOrder ({orderSum}) |
| 2. | MIX-107002 | BadRequest | InconsistentPaymentAmount Указанная форма оплаты не соответствует форме оплаты созданного MixOrder |
| 3. | MIX-107003 | BadRequest | InconsistentPaymentCurCodes Валюта оплаты ({paymentCurCode}) не соответствует валюте MixOrder ({orderCurCode}) |
| 4. | MIX-111005 | BadRequest | NotPaymentRequest Payment request should not have PaxList specified |
| 5. | MIX-111005 | BadRequest | NotPaymentRequest Only full payment allowed |
| 6. | MIX-111005 | BadRequest | NotPaymentRequest Для частичной оплаты необходимо указать список заказов |
| XIII. Common for orders | |||
| 1. | MIX-100005 | BadRequest | OrderNotFound Заказ {orderId} не найден или срок его действия истек |
| 2. | MIX-100005 | BadRequest | OrderNotFound Заказы ({string.Join(',', orderIds)}) не найдены или срок действия истек |
| 3. | MIX-111001 | BadRequest | MixOrderNotFound Мультикорзина {mixOrderId} не найдена |
| 4. | MIX-111003 | BadRequest | OrderNotFoundByTicket Заказ по номеру билета {ticketNumber} не найден или срок его действия истек |
| 5. | MIX-111004 | BadRequest | OrdersNotInMixOrder Указанные заказы не содержатся в Мультикорзине: {string.Join(',', invalidOrderIds)} |
-
Error "НЕТ ВОЗМОЖНОСТИ ПОЛУЧИТЬ МЕСТА": говорит о наличии ограничений бронирования со стороны хоста. Данные ограничения устанавливает АК.
-
Error «ПРОДАЖА ЗАПРЕЩЕНА»: говорит о том что-либо рейс закрыт, либо нет мест. Ответ также приходит от АК.
