https://travelplatform.ru/docs/operations/avia/booking/pnr-create/Recent content in Создание бронирования on Travel API - ДокументацияHugoru-RUhttps://travelplatform.ru/docs/operations/avia/booking/pnr-create/request/Mon, 01 Jan 0001 00:00:00 +0000https://travelplatform.ru/docs/operations/avia/booking/pnr-create/request/<h1 id="параметры-запроса">Параметры запроса<a class="anchor" href="#%d0%bf%d0%b0%d1%80%d0%b0%d0%bc%d0%b5%d1%82%d1%80%d1%8b-%d0%b7%d0%b0%d0%bf%d1%80%d0%be%d1%81%d0%b0">#</a></h1> <p>Детальное описание всех параметров для запроса <code>/avia/pnr_create</code>.</p> <h2 id="обязательные-параметры">Обязательные параметры<a class="anchor" href="#%d0%be%d0%b1%d1%8f%d0%b7%d0%b0%d1%82%d0%b5%d0%bb%d1%8c%d0%bd%d1%8b%d0%b5-%d0%bf%d0%b0%d1%80%d0%b0%d0%bc%d0%b5%d1%82%d1%80%d1%8b">#</a></h2> <table> <thead> <tr> <th>Параметр</th> <th>Тип</th> <th>Описание</th> </tr> </thead> <tbody> <tr> <td><code>searchId</code></td> <td>string</td> <td>Идентификатор из <code>/avia/search</code></td> </tr> <tr> <td><code>offerItemId</code></td> <td>string</td> <td>Идентификатор выбранного предложения</td> </tr> <tr> <td><code>passengers</code></td> <td>array</td> <td>Данные пассажиров</td> </tr> </tbody> </table> <h3 id="структура-passengers">Структура passengers<a class="anchor" href="#%d1%81%d1%82%d1%80%d1%83%d0%ba%d1%82%d1%83%d1%80%d0%b0-passengers">#</a></h3> <table> <thead> <tr> <th>Поле</th> <th>Тип</th> <th>Обязательно</th> <th>Описание</th> </tr> </thead> <tbody> <tr> <td><code>id</code></td> <td>string</td> <td>Да</td> <td>Идентификатор пассажира в запросе</td> </tr> <tr> <td><code>lastName</code></td> <td>string</td> <td>Да</td> <td>Фамилия латиницей</td> </tr> <tr> <td><code>firstName</code></td> <td>string</td> <td>Да</td> <td>Имя латиницей</td> </tr> <tr> <td><code>middleName</code></td> <td>string</td> <td>Нет</td> <td>Отчество</td> </tr> <tr> <td><code>gender</code></td> <td>string</td> <td>Нет</td> <td>Пол (<code>male</code>, <code>female</code>)</td> </tr> <tr> <td><code>type</code></td> <td>string</td> <td>Нет</td> <td>Тип пассажира (<code>adt</code>, <code>chd</code>, <code>inf</code>)</td> </tr> <tr> <td><code>title</code></td> <td>string</td> <td>Нет</td> <td>Обращение (<code>MR</code>, <code>MRS</code>, <code>MS</code>)</td> </tr> <tr> <td><code>documents</code></td> <td>Document[]</td> <td>Да</td> <td>Документы пассажира</td> </tr> <tr> <td><code>contacts</code></td> <td>array</td> <td>Нет</td> <td>Контакты пассажира</td> </tr> <tr> <td><code>frequentFlyers</code></td> <td>array</td> <td>Нет</td> <td>Программы лояльности</td> </tr> </tbody> </table> <h3 id="структура-documents">Структура documents<a class="anchor" href="#%d1%81%d1%82%d1%80%d1%83%d0%ba%d1%82%d1%83%d1%80%d0%b0-documents">#</a></h3> <table> <thead> <tr> <th>Поле</th> <th>Тип</th> <th>Обязательно</th> <th>Описание</th> </tr> </thead> <tbody> <tr> <td><code>type</code></td> <td>DocumentType</td> <td>Да</td> <td>Тип документа (<code>internationalPassport</code>, <code>nationalPassport</code>, <code>birthCertificate</code>, <code>identityCard</code>, <code>notSet</code>)</td> </tr> <tr> <td><code>number</code></td> <td>string</td> <td>Да</td> <td>Номер документа</td> </tr> <tr> <td><code>lastName</code></td> <td>string</td> <td>Да</td> <td>Фамилия в документе (латиницей)</td> </tr> <tr> <td><code>firstName</code></td> <td>string</td> <td>Да</td> <td>Имя в документе (латиницей)</td> </tr> <tr> <td><code>middleName</code></td> <td>string</td> <td>Нет</td> <td>Отчество в документе</td> </tr> <tr> <td><code>series</code></td> <td>string</td> <td>Нет</td> <td>Серия документа (если применимо)</td> </tr> <tr> <td><code>birthDate</code></td> <td>date</td> <td>Нет</td> <td>Дата рождения (формат: YYYY-MM-DD)</td> </tr> <tr> <td><code>issueDate</code></td> <td>date</td> <td>Нет</td> <td>Дата выдачи (формат: YYYY-MM-DD)</td> </tr> <tr> <td><code>expireDate</code></td> <td>date</td> <td>Нет</td> <td>Срок действия (формат: YYYY-MM-DD)</td> </tr> <tr> <td><code>country</code></td> <td>string</td> <td>Да</td> <td>Страна выдачи (ISO 3166-1 alpha-2)</td> </tr> </tbody> </table> <h3 id="структура-contacts">Структура contacts<a class="anchor" href="#%d1%81%d1%82%d1%80%d1%83%d0%ba%d1%82%d1%83%d1%80%d0%b0-contacts">#</a></h3> <table> <thead> <tr> <th>Поле</th> <th>Тип</th> <th>Обязательно</th> <th>Описание</th> </tr> </thead> <tbody> <tr> <td><code>type</code></td> <td>ContactType</td> <td>Нет</td> <td>Тип контакта</td> </tr> <tr> <td><code>value</code></td> <td>string</td> <td>Да</td> <td>Значение</td> </tr> </tbody> </table> <p><strong>ContactType</strong> — возможные значения:</p>https://travelplatform.ru/docs/operations/avia/booking/pnr-create/response/Mon, 01 Jan 0001 00:00:00 +0000https://travelplatform.ru/docs/operations/avia/booking/pnr-create/response/<h1 id="структура-ответа">Структура ответа<a class="anchor" href="#%d1%81%d1%82%d1%80%d1%83%d0%ba%d1%82%d1%83%d1%80%d0%b0-%d0%be%d1%82%d0%b2%d0%b5%d1%82%d0%b0">#</a></h1> <p>Детальное описание структуры ответа от <code>/avia/pnr_create</code>.</p> <h2 id="основная-структура">Основная структура<a class="anchor" href="#%d0%be%d1%81%d0%bd%d0%be%d0%b2%d0%bd%d0%b0%d1%8f-%d1%81%d1%82%d1%80%d1%83%d0%ba%d1%82%d1%83%d1%80%d0%b0">#</a></h2> <p>Ответ содержит идентификатор созданного бронирования и основные данные PNR.</p> <table> <thead> <tr> <th>Поле</th> <th>Тип</th> <th>Описание</th> </tr> </thead> <tbody> <tr> <td><code>bookingId</code></td> <td>guid</td> <td>Идентификатор созданного бронирования (формат UUID)</td> </tr> <tr> <td><code>pnrLocator</code></td> <td>string</td> <td>Локатор PNR (код бронирования в GDS)</td> </tr> <tr> <td><code>pnrKey</code></td> <td>string</td> <td>Ключ PNR (используется в Sirena)</td> </tr> <tr> <td><code>pnrOrderId</code></td> <td>string</td> <td>Идентификатор заказа у поставщика</td> </tr> <tr> <td><code>supplier</code></td> <td>Supplier</td> <td>Поставщик, через которого создано бронирование (см. <a href="https://travelplatform.ru/docs/operations/common-types/system/#supplier">Supplier</a>)</td> </tr> </tbody> </table> <hr> <h2 id="примеры-ответов">Примеры ответов<a class="anchor" href="#%d0%bf%d1%80%d0%b8%d0%bc%d0%b5%d1%80%d1%8b-%d0%be%d1%82%d0%b2%d0%b5%d1%82%d0%be%d0%b2">#</a></h2> <h3 id="успешный-ответ">Успешный ответ<a class="anchor" href="#%d1%83%d1%81%d0%bf%d0%b5%d1%88%d0%bd%d1%8b%d0%b9-%d0%be%d1%82%d0%b2%d0%b5%d1%82">#</a></h3> <div class="highlight"><pre tabindex="0" style="background-color:#fff;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-json" data-lang="json"><span style="display:flex;"><span style="white-space:pre;-webkit-user-select:none;user-select:none;margin-right:0.4em;padding:0 0.4em 0 0.4em;color:#7f7f7f">1</span><span>{ </span></span><span style="display:flex;"><span style="white-space:pre;-webkit-user-select:none;user-select:none;margin-right:0.4em;padding:0 0.4em 0 0.4em;color:#7f7f7f">2</span><span> &#34;bookingId&#34;: <span style="color:#a31515">&#34;019a0c82-5d2b-7a5e-84fe-56357a57df66&#34;</span>, </span></span><span style="display:flex;"><span style="white-space:pre;-webkit-user-select:none;user-select:none;margin-right:0.4em;padding:0 0.4em 0 0.4em;color:#7f7f7f">3</span><span> &#34;pnrLocator&#34;: <span style="color:#a31515">&#34;28C2D3&#34;</span>, </span></span><span style="display:flex;"><span style="white-space:pre;-webkit-user-select:none;user-select:none;margin-right:0.4em;padding:0 0.4em 0 0.4em;color:#7f7f7f">4</span><span> &#34;pnrOrderId&#34;: <span style="color:#a31515">&#34;69120-251022-OTT5447&#34;</span> </span></span><span style="display:flex;"><span style="white-space:pre;-webkit-user-select:none;user-select:none;margin-right:0.4em;padding:0 0.4em 0 0.4em;color:#7f7f7f">5</span><span>}</span></span></code></pre></div><hr> <h2 id="типичные-ошибки">Типичные ошибки<a class="anchor" href="#%d1%82%d0%b8%d0%bf%d0%b8%d1%87%d0%bd%d1%8b%d0%b5-%d0%be%d1%88%d0%b8%d0%b1%d0%ba%d0%b8">#</a></h2> <table> <thead> <tr> <th>Код ошибки</th> <th>Причина</th> <th>Решение</th> </tr> </thead> <tbody> <tr> <td><code>OFFER_NOT_AVAILABLE</code></td> <td>Предложение недоступно</td> <td>Выполните новый поиск</td> </tr> <tr> <td><code>INVALID_PASSENGER_DATA</code></td> <td>Некорректные данные пассажира</td> <td>Проверьте формат данных</td> </tr> <tr> <td><code>SEARCH_EXPIRED</code></td> <td>Поиск устарел</td> <td>Выполните новый поиск</td> </tr> </tbody> </table> <hr> <h2 id="связанные-операции">Связанные операции<a class="anchor" href="#%d1%81%d0%b2%d1%8f%d0%b7%d0%b0%d0%bd%d0%bd%d1%8b%d0%b5-%d0%be%d0%bf%d0%b5%d1%80%d0%b0%d1%86%d0%b8%d0%b8">#</a></h2> <ul> <li><strong><a href="https://travelplatform.ru/docs/operations/avia/ticketing/ticket-issue/">Выписка билета</a></strong> - оформление билетов</li> <li><strong><a href="https://travelplatform.ru/docs/operations/avia/booking/pnr-retrieve/">Получение PNR</a></strong> - получение деталей бронирования</li> <li><strong><a href="https://travelplatform.ru/docs/operations/avia/booking/pnr-cancel/">Отмена PNR</a></strong> - отмена бронирования</li> </ul>