Сдача товарооборота

POST /api/external/v2/sc/{sc_id}/shops/{shop_id}/turnover BASIC

Метод для арендаторов, у которых нет онлайн-кассы или чьи данные не доходят до нас через ОФД. Переданное значение попадает в поле manual_turnover продаж по месяцам и участвует в расчёте OCR.

Параметры#

Имя	Тип	Обяз.	Описание
`sc_id`	string, в пути	да	Идентификатор центра
`shop_id`	string, в пути	да	Идентификатор точки этого центра
`month`	date	да	Любая дата внутри месяца, `YYYY-MM-DD`. Месяц берётся целиком
`turnover`	integer	да	Оборот за месяц в копейках
`receipts_count`	integer	нет	Количество чеков за месяц
`visitors_count`	integer	нет	Количество посетителей за месяц

Суммы в копейках. В API v1 этот метод принимал рубли, поэтому при переносе интеграции значение нужно умножить на 100.

Месяц заводится автоматически, если его ещё нет. Повторный вызов за тот же месяц перезаписывает значения, а не добавляет второе: метод идемпотентен по паре «точка + месяц».

Будущий месяц отклоняется. Граница считается в таймзоне торговой точки.

bash

curl -X POST "https://api.rentu.ru/api/external/v2/sc/{sc_id}/shops/{shop_id}/turnover" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "month": "2026-07-01",
    "turnover": 12345600,
    "receipts_count": 42,
    "visitors_count": 500
  }'

Ответ#

Статус 200 OK. Метод идемпотентен по паре «точка + месяц»: повторный вызов перезаписывает значение.

json

{
  "success": true,
  "data": {
    "shop_id": "6a1f2c3d4e5f60718293a4b5",
    "month": "2026-07",
    "manual_turnover": 12345600,
    "manual_receipts_count": 42,
    "manual_visitors_count": 500
  }
}

Что происходит после записи#

Точка, по которой пришёл оборот, отмечается как активная и получает источник данных «ручной ввод». Пересчитывается OCR, если у точки заведена аренда. Запись попадает в журнал ручного ввода от имени сотрудника, которому принадлежит ключ.

Ошибки#

Код	HTTP	Когда
`not_found`	404	Точки нет в этом центре
`validation_error`	422	Месяц в будущем, отрицательная сумма, неразобранная дата