Сессии коррекции
Бывает так, что в момент оплаты на точке нет интернета. Платёж невозможно провести сразу, но он фиксируется в системе и будет проведён позже, когда связь восстановится. Тогда в момент списания возникает прямая сессия коррекции. Также она возникает, когда вы печатаете чек коррекции — например, если в момент продажи кассовый чек пробить не удалось. Если же вы корректируете возврат, возникает обратная сессия коррекции.
Как и обратные сессии, все сессии коррекции должны быть привязаны к тем сессиям, которые они корректируют. Для этого в описании операций, проведённых в рамках сессии, в объекте payment parts используются объекты primary_sale_session
и primary_payment_part
соответственно. Передайте в них guid
и type_of
объектов, на которые хотите сослаться.
Исправить ошибку
Чтобы создать новую сессию коррекции, отправьте POST-запрос по адресу:
- Прямая
- Обратная
{base_url}/orgs/{org_guid}/deals/sales/{deal_guid}/sessions/direct-correction
{base_url}/orgs/{org_guid}/deals/sales/{deal_guid}/sessions/reversal-correction
Описание запроса прямой сессии Описание запроса обратной сессии
base_url
— адрес сервиса. Возможные значения:https://api-dev.life-pos.ru
— тестовый API,https://api.life-pos.ru
— рабочий API.
Получить данные о коррекции
Чтобы получить список всех сессий, связанных с продажей, отправьте GET-запрос по адресу:
{base_url}/orgs/{org_guid}/deals/sales/{deal_guid}/sessions
Данные выводятся постранично, по 20 записей на страницу. Если нужно получить данные второй страницы, возьмите из ответа значение параметра next_page_token
и отправьте новый запрос, передав это значение в параметре page_token
. Продолжайте до тех пор, пока параметр next_page_token
не придёт пустым.
Например, вы запросили данные о сотрудниках и получили такой ответ:
“next_page_token”: “OdDEFa2CzpYdp1CmlO9s9mjBn4NkUZB3CXKOtNfQWM0”,
“page_number”: 1,
“pages_total”: 2,
“items_per_page”: 20,
“items_total”: 27,
В ответе представлены только записи 1–20. Чтобы посмотреть записи с 21 по 27, отправьте новый GET-запрос, указав page_token=“OdDEFa2CzpYdp1CmlO9s9mjBn4NkUZB3CXKOtNfQWM0”
.
В запросе есть необязательный параметр selection
. Это фильтр сессий по их статусу. Если параметр не передан, по умолчанию используется значение alive_only
, то есть в ответе придут только данные сессий, не перенесённых в архив. Чтобы посмотреть весь список сессий или только архивные данные, укажите значение all
или archived_only
соответственно.
Чтобы получить данные конкретной коррекции, отправьте GET-запрос по адресу:
- Прямая
- Обратная
{base_url}/orgs/{org_guid}/deals/sales/{deal_guid}/sessions/direct-correction
{base_url}/orgs/{org_guid}/deals/sales/{deal_guid}/sessions/reversal-correction
Описание запроса прямой сессии Описание запроса обратной сессии
session_guid
— идентификатор сессии. Можно получить в списке всех сессий, связанных с продажей.
Отредактировать коррекцию
Когда коррекция будет фискализирована, добавьте данные чека в описание сессии PATCH-запросом по адресу:
- Прямая
- Обратная
{base_url}/orgs/{org_guid}/deals/sales/{deal_guid}/sessions/direct-correction
{base_url}/orgs/{org_guid}/deals/sales/{deal_guid}/sessions/reversal-correction
Описание запроса прямой сессии Описание запроса обратной сессии
Удалить и восстановить коррекцию
Сессию нельзя удалить навсегда, но можно перенести в архив. Она исчезнет из интерфейса вашей учётной программы, но сохранится на сервере LIFE POS. Для этого отправьте DEL-запрос по адресу:
- Прямая
- Обратная
{base_url}/orgs/{org_guid}/deals/sales/{deal_guid}/sessions/direct-correction
{base_url}/orgs/{org_guid}/deals/sales/{deal_guid}/sessions/reversal-correction
Описание запроса прямой сессии Описание запроса обратной сессии
Чтобы восстановить архивную сессию, отправьте POST-запрос по адресу:
- Прямая
- Обратная
{base_url}/orgs/{org_guid}/deals/sales/{deal_guid}/sessions/direct-correction:unarchive
{base_url}/orgs/{org_guid}/deals/sales/{deal_guid}/sessions/reversal-correction:unarchive
Описание запроса прямой сессии Описание запроса обратной сессии
Теперь вы знаете, как работать с возвратами. В следующей статье обсудим экспорт отчётов.