Skip to main content
Version: LIFE POS 5.0

Возвраты

Провести через API полноценную операцию возврата средств не получится — обязательно понадобится карта покупателя для проведения денег через эквайринг. Но по API вы можете добавить новый документ возврата оплаты по сделке. Рассказываем как работать с такими документами.

Оформить возврат​

Чтобы создать документ возврата. Для этого отправьте POST-запрос по адресу:

{base_url}/v5/orgs/{org_guid}/deals/sales/{deal_guid}/docs/money/refunds

base_url — адрес сервиса. Возможные значения:

  • https://api-dev.life-pos.ru — тестовый API,
  • https://api.life-pos.ru — рабочий API.

Тело запроса (знаком * отмечены обязательные поля):

  • for_payment — неиспользуемое поле;
  • processed_at * — дата создания документа;
  • sum_by_card * — объект Money, сумма безналичного возврата. Не должна превышать сумму безналичного платежа по сделке. Объект Money одержит поля:
    • value,
    • currency *,
    • type_of.
  • sum_by_cash * — объект Money, сумма наличного возврата. Не должна превышать сумму наличного платежа по сделке;
  • total_sum * — объект Money, общая сумма возврата. Не должна превышать общую сумму платежа по сделке;
  • positions — массив объектов MoneyOperationPosition, позиций сделки. Для полного возврата передайте все позиции исходной сделки, для частичного — хотя бы одну. Объект MoneyOperationPosition содержит поля:
    • paid_quantity * — количество товара,
    • paid_amount * — стоимость позиции (объект Money),
    • position * — объект DealPositionReference с идентификатором позиции,
    • type_of.
  • fiscal_document — объект IFiscalDocumentReference с идентификатором чека;
  • transactions — массив объектов ITransactionBaseReference с идентификаторами возвращаемых транзакций;
  • sale — объект SaleReference с идентификатором продажи.

Подробное описание запроса

Когда возврат будет оформлен, поменяйте статус сделки.
Как поменять статус сделки

Получить документ возврата​

Чтобы получить данные возврата для вашей системы учёта, отправьте GET-запрос по адресу:

{base_url}/v5/orgs/{org_guid}/deals/sales/{deal_guid}/docs/money/refunds/{doc_guid}

Адреса сервиса

Описание запроса

Изменить документ возврата​

Когда возврат будет фискализирован, добавьте данные чека в документ возврата PATCH-запросом по адресу:

{base_url}/v5/orgs/{org_guid}/deals/sales/{deal_guid}/docs/money/refunds/{doc_guid}

Адреса сервиса

Описание запроса

Удалить и восстановить возврат​

Документ возврата нельзя удалить навсегда, но можно перенести в архив. Он исчезнет из интерфейса вашей учётной программы, но сохранится на сервере LIFE POS. Для этого отправьте DEL-запрос по адресу:

{base_url}/v5/orgs/{org_guid}/deals/sales/{deal_guid}/docs/money/refunds/{doc_guid}

Адреса сервиса

Описание запроса

Чтобы восстановить архивный документ, отправьте POST-запрос по адресу:

{base_url}/v5/orgs/{org_guid}/deals/sales/{deal_guid}/docs/money/refunds/{doc_guid}:unarchive

Описание запроса

Теперь вы знаете, как работать с возвратами. В следующей статье обсудим работу с сотрудниками.