Перейти к содержимому

Чеки коррекции

Регистрация чеков коррекции в АТОЛ Онлайн v5 - операции sell_correction, buy_correction и их возвраты, объект correction_info.

Чеки коррекции регистрируются теми же запросами, что и обычные чеки, но с операциями sell_correction, buy_correction, sell_refund_correction, buy_refund_correction, и вместо объекта receipt передается объект correction.

http
POST https://online.atol.ru/possystem/v5/<group_code>/sell_correction
Content-Type: application/json; charset=utf-8
Token: <token>

Отличия от обычного чека

Верхний уровень запроса тот же (timestamp, external_id, service, ism_optional), но:

ПолеТипОбяз.Описание
correctionobjectДаЧек коррекции (вместо receipt)

Объект correction повторяет структуру receipt (company, items, payments, vats, cashier, cashier_inn, additional_check_props, total, additional_user_props, operating_check_props, sectoral_check_props, device_number, internet, timezone) со следующими отличиями:

  • client - обязателен только если в запросе указано internet: true (тогда должно быть заполнено хотя бы одно из полей email / phone).
  • correction_info - обязательный объект с данными коррекции.
  • Поле cashless_payments в чеке коррекции не используется.

Объект correction_info

ПолеТипОбяз.Тег ФФДОписание
typestringДа1173Тип коррекции: self - самостоятельная операция; instruction - операция по предписанию налогового органа об устранении выявленного нарушения
base_datestringДа1178Дата совершения корректируемого расчета, dd.mm.yyyy
base_numberstringНет1179Номер документа-основания для коррекции. Заполняется при коррекции по предписанию налогового органа (до 32 символов)

Пример запроса

json
{
  "timestamp": "03.06.2020 12:05:31",
  "external_id": "corr-2020-06-03-001",
  "service": { "callback_url": "https://shop.ru" },
  "correction": {
    "company": {
      "email": "email@ofd.ru",
      "sno": "osn",
      "inn": "5010051677",
      "payment_address": "shop-url.ru"
    },
    "correction_info": {
      "type": "self",
      "base_date": "23.11.2020"
    },
    "items": [
      {
        "name": "Ваш любимый товар",
        "price": 120,
        "quantity": 1.0,
        "measure": 0,
        "sum": 120,
        "payment_method": "full_payment",
        "payment_object": 1,
        "vat": { "type": "vat20", "sum": 20.0 }
      }
    ],
    "payments": [ { "type": 1, "sum": 120.0 } ],
    "vats": [ { "type": "vat20", "sum": 20.0 } ],
    "cashier": "кассир",
    "total": 120.0
  }
}

Ответ идентичен ответу регистрации документа: uuid, timestamp, status (wait / fail), error.

Когда нужен чек коррекции

Чек коррекции применяется, когда расчет был произведен без применения ККТ либо с ошибкой (например, не пробит чек при сбое). Тип self - вы сами обнаружили и исправляете ошибку; instruction - коррекция по предписанию ФНС (тогда заполняется base_number).