PREXSELL logo
Документація

Замовлення

Тут ви дізнаєтесь як створити замовлення і отримати квитки для обраної пропозиції.

Підрозділ створення замовлення передбачає що Ви здійснили запит для отримання пропозицій і обрали одну з них.

Здійснення замовлення відбувається у два етапа:

  1. Створення замовлення

  2. Оплата або бронювання замовлення

Створення замовлення

Для створення замовлення вам обовязково потрібні наступні дані:

  • String
    це є обраної пропозиції, наприклад він може починатися з . Більше інформації щодо пропозицій Ви можете отримати у розділі пропозиції;

  • String
    Ім'я пасажира;

  • String
    Прізвище пасажира;

  • String
    Номер телефону пасажира. Може бути кілька. номер вказуються з кодом країни без +, наприклад . Випадок з кількома номерами буде розглянутий трохи нище під час формування мутації;

  • DateTime
    фактична дата відправлення яка була вказана під час пошуку пропозицій. Повинна бути у форматі ISO 8601, наприклад . Наразі час неважливий;

  • Number
    сума передоплати внесена пасажиром

  • String
    Валюта в якій Ви бажаєте створити замовлення, наприклад ;

  • String
    у Вашому випадку це завжди буде .


Тепер формуємо змінні до мутації. В даному випадку ми вказуємо 2 номера телефона. У випадку з кількома пасажирами добавляємо додатковий ітем у таблицю :


І власне саму мутацію. В даному випадку нас цікавить квитків для настуного кроку:


Вище вказаний обов'язковий набір даних котрі потрібно відправити на сервер для створення замовлення. Більше інформації можете отримати з точок доступу.


Оплата або бронювання замовлення

Після успішного операції зі створенням замовлення квитки уже є у системі, але під статусом "неоплачені". Для зміни статусу оплати квитка(-ів) ми використовуємо наступні мутації:

  • - для зміни статусу квитка(-ів) на заброньований. В даному випадку ми оплата за квиток здійснюється при посадці у водія;

  • - для зміни статусу квитка(-ів) на передоплачений. В даному випадку часткова оплата приймалась через агента.

  • - для зміни статусу квитка(-ів) на оплачений. В даному випадку оплата приймалась через агента.

Для двох оперцій вище нам потрібно лише квитка(-ів) з попереднього кроку. А тепер формуємо запит для оплати квитка:


У змінній ми можемо передавати id кількох квитків.

А тепер формуємо мутацію. Ми хочемо отримати тільки у відповідь, натомість Ви можете обрати будь що, що пропонує schema:


Більш детальнішу інформацію щодо запитів Ви можете отримати за точкою доступу у переглядачі.


Зміна статусу квитка (за погодженням з нашим менеджером)

Після успішного операції зі створенням замовлення квитки створенні під статусом . Для зміни статусу оплати квитка використовуйте наступну мутацію:


У змінній передаємо id квитка. А у обраний статус.

Як партнера вас цікавлять наступні можливі статуси:

  • - замовлення підтверджене, пасажир буде їхати;

  • - замовлення не підтверджене, невідомо чи пасажир буде їхати;

  • - замовлення скасоване. (аналогічно до мутації)


Більш детальнішу інформацію щодо запитів Ви можете отримати за точкою доступу у переглядачі.


Статус замовлення

- підтверджене замовлення диспетчером, зазвичай за день два до відправлення рейсу;

- скасоване замовлення. При скасуванні замовлення архівується;

- підтверджене замовлення самим пасажиром через сайт;

- була спроба підтвердити замовлення диспетчером, але не вдалося (наприклад пасажир не відповів на дзвінок);

- автоматичний статус після створення замовлення;

- створений запит на повернення коштів за квиток;

- статус призначається після помилки під час створення замовлення.


Статус оплати замовлення

- пасажир оплатив замовлення повністю;

- замовлення заброньоване, оплата здійснюється у водія під час посадки;

- пасажир вніс передоплату до замовлення під час його створення;

- автоматичний статус для всіх створених замовлень. Якщо цей статус не буде в подальшому змінений, замовлення буде видалене диспетчером.