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

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

• Термінологія
• Запитання про замовлення
• Структура API запиту:
• Частота запитів
• Функція статусу замовлення (Order STatus) (oper=ost)

Термінологія

• Користувач у цьому розділі означає організацію/фірму, яка використовує AyMINE для автоматизації процесів
• Клієнт означає клієнт користувача – фірму, якій були доступні послуги API або клієнтського порталу

Запитання про замовлення

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

Структура API запиту:

• AyMINE-адреса або унікальна адреса (якщо система ведеться по домену користувача)
• Унікальна адреса служби
• Параметри запиту
• Ідентифікатор служби (ідентифікатор можна змінити в налаштуваннях системи в будь-який час і таким чином заблокувати послугу)
• Ідентифікатор клієнта (Клієнта) – це ідентифікатор розподілу один для всіх послуг, що надаються в налаштуваннях клієнта. Змінюючи або скасовуючи наданий ідентифікатор, можна заблокувати послугу/дозволити конкретному клієнту).
• oper – одна з операцій інтерфейсу
• enc – кодування відповіді: plain – звичайний текст, b64 – кодується в base64
• format – повернутий формат відповіді: xml, js

Частота запитів

API не стежить за тим, як часто надсилається запит, але стежить

• Максимально дозволена кількість запитів за годину – після перевищення буде повертатися код помилки
• Максимально дозволена кількість запитів на день – після перевищення буде повертатися код помилки
• Кількість невдалих входів з IP-адреси – після перевищення інтерфейс перестане повністю відповідати, а адреса буде заблокована

Обмеження встановлюються індивідуально. Загалом, рекомендації не називати інтерфейс частіше, ніж 1 х 2 хвилини.

Функція статусу замовлення (Order STatus) (oper=ost)

Повернені статуси замовлень:

• CE – (Customer / Error) – замовлення вимагає завершення / ремонту через портал клієнта. До тих пір, поки замовник на порталі не буде відремонтований і підтверджений, він не обробляється внутрішньо.
• PR – (Prepare) – Замовлення готується внутрішньо або з якоїсь причини (наприклад, відсутній товар) не може бути включене в експедицію
• DL – (Доставка) – Замовлення вже доставлено
• _CO – (Completed) – Замовлення оброблено і товар доставлено, Замовлення переведено в цей стан після підтвердження того, що воно було передано кінцевому одержувачу. У разі прийняття товару на продаж, стан змінюється після прийняття.
• DE – (Deleted) – Виключено з обробки

За угодою інтерфейс може повертати додаткову інформацію:

• Вибраний вид транспорту
• Запланований термін доставки (дата + час)
• Статус оплати