Статуси замовлення: портал і 1С

Хто переводить статус

Менеджер, кнопки сторінки замовлення: «Погодити і виставити рахунок» і «Скасувати» - з «нове» або «очікує уточнення»; «Повернути на уточнення» - лише з «нове»; далі «Позначити оплаченим», «Відправити», «Виконано»
Клієнт: лише скасувати і лише «нове». Інша зміна - 403, інший статус - 409 (PATCH /api/orders/[id])
1С: документ можна завершити чи позначити на видалення і в самій 1С, з будь-якого статусу; портал покаже це після наступного знімка
Перехід менеджера сервер не звіряє: порядок тримають кнопки, PATCH приймає будь-яку мітку статусу
PART_PAID: код, мітка і місце на стрічці клієнта є, а кнопки, яка його ставить чи знімає, немає
Замовлення з черги (документа в 1С ще немає) не змінюється: 409 ORDER_NOT_IN_BAS_YET

Що розрізняє 1С, а що лише портал

orderStatusFrom бере з документа ЗаказПокупателя дві ознаки, саме в такому порядку: DeletionMark -> CANCELLED, стан «Завершений» -> DONE. Усе інше, зокрема «В роботі», - NEW або проміжний статус із сайдкара
WEIGH_PENDING, READY_TO_PAY, PAID, PART_PAID, IN_TRANSIT живуть лише в order_sidecar.status_code; у документ при такій зміні пишеться «В роботі»
Запис: спершу 1С, потім сайдкар. Читання: сайдкар накладається на знімок 1С; DONE і CANCELLED з 1С сильніші за нього, проміжний статус сайдкара сильніший за NEW (overlayStatus)
Власні «виконано» і «скасовано» порталу видно одразу із сайдкара, доки знімок 1С старший за дію (запас 10 хв); далі авторитет - знімок
«Завершений» портал впізнає за GUID елемента довідника станів; зараз це константа, знята з тестової бази
DONE і CANCELLED кінцеві для кнопок порталу. Якщо документ знову відкрили в 1С (зняли «Завершений» чи позначку видалення), після наступного знімка портал покаже «нове» або проміжний статус із сайдкара

Скасування: сьогодні і в роботі

Сьогодні портал скасовує через OData: розпроводить проведений документ, ставить DeletionMark = true, у сайдкар пише CANCELLED
Читає скасування теж лише за DeletionMark. Позначений документ з міткою тесту чи сіду в коментарі до знімка і списку не потрапляє
Сервіс розширення POST /orders/{orderId}/cancel скасовує як сама конфігурація (ЗаказОтменен): розпроведення, стан «Завершений», ВариантЗавершения = Отменен, без позначки видалення
Такий документ main читає за станом «Завершений», тобто показує «виконано»
У роботі, ще не в main (пунктир): orderStatusFrom перевіряє ВариантЗавершения = «Отменен» раніше за стан і дає CANCELLED
У роботі, за проєктом адаптера: з ORDERS_CHANGE_VIA=service скасування піде через сервіс /cancel, проміжний статус писатиметься лише в сайдкар, «виконано» - і далі через OData. Читання за «Отменен» має вийти раніше за цей перемикач

Що бачить клієнт

Бейдж з українською міткою статусу (на вузлах вона в лапках) і стрічку з шести кроків: нове, уточнення, до оплати, оплачено, в дорозі, виконано
«частково оплачено» стоїть на кроці «оплачено»
«готове до оплати»: блок «Рахунок на оплату» із сумою документа
«скасовано»: замість стрічки - «Замовлення скасовано. Якщо це помилка, напишіть менеджеру.»
Сам клієнт може скасувати лише «нове», додати позицію - у «нове» й «очікує уточнення»
Поки документа в 1С немає, замість статусу показано стан передачі в облік