Возвраты

> СерверККМ V4 > REST API > Работа с ККМ
Дата обновления: 23 июля 2026 г.

POST check

Печать чек возврата продажи или покупки.

URL: {{HTTPRoot}}/check

Тело запроса

{
    "DeviceName": "{device}",
    "Cashier": {
      "Name": "Иванов А.И.",
      "Vatin": "7722345678"
    },
    "PaymentType": 2,
    "TaxVariant": 1,
    "Customer": {
    "Info": "ООО 'Рога и Копыта",
    "email": "kuznicov@mail.ru",
    "Vatin": "500100732259"
  },
    "Payments": {
      "Cash": "90"
    },
  "Positions": [
    {
      "FiscalString": {
        "Name": "Бутылка с водой 1л.",
        "Quantity": 1,
        "MeasurementUnit": "шт",
        "PriceWithDiscount": "60",
        "SumWithDiscount": "60",
        "DiscountSum": 0,
        "Department": 1,
        "Tax": "20",
        "TaxSum": "0.00",
        "SignMethodCalculation": 1,
        "SignCalculationObject": 10
      }
    },
    {
      "FiscalString": {
        "Name": "SIMTEK манжета переходная D50х32",
        "Quantity": 1,
        "MeasurementUnit": "шт",
        "PriceWithDiscount": "21.85",
        "SumWithDiscount": "21.85",
        "DiscountSum": 0,
        "Department": 1,
        "Tax": "none",
        "TaxSum": "0.00",
        "SignMethodCalculation": 1,
        "SignCalculationObject": 10
      }
    }
  ]
}

Смотрите документацию POST-запрос check

Тело ответа

Успешный ответ (200 OK)

{
    "Result": {
        "datetime": "2026-05-24T04:34:32.2772086+08:00",
        "deviceName": "Atol",
        "docId": "d2a43efe-b4b9-4db5-aa7f-8358c31344ad",
        "fnsUrl": "nalog.ru",
        "fnNumber": "0123123123123",
        "rnNumber": "00031415926",
        "fiscalDatetime": "20260524043400",
        "fiscalSign": "5847203916",
        "shiftNumber": 41,
        "fiscalNumber": 367
    },
    "Code": 0,
    "Description": "OK",
    "Success": true
}

Смотрите документацию POST-запрос check

Примеры ошибок

709 — Устройство не найдено,

{
    "Code": 709,
    "Description": "Устройство не найдено",
    "Success": false
}

8 — Недостаточная сумма оплаты,

{
    "Code": 8,
    "Description": "Недостаточная сумма оплаты",
    "Success": false
}

4 — Не указано имя ККТ,

{
    "Code": 4,
    "Description": "Не указано имя ККТ",
    "Success": false
}

14 — 24 часа кассовой смены истекли

{
    "Code": 14,
    "Description": "24 часа кассовой смены истекли",
    "Success": false
}

POST check

Печать чека возврата аванса (предоплаты)

URL: {{HTTPRoot}}/check

Тело запроса

{
    "DeviceName": "{device}",
    "Electronically": false,
    "Cashier": {
        "Name": "Иванов",
        "Vatin": "7722345678"
    },
    "Customer": {
      "Info": "ТЦ `Титан`",
      "Vatin": "500100732259",
      "email": "kuznicov@mail.ru"
     },
    "PaymentType": 2,
    "TaxVariant": 2,
    "Payments": {
        "AdvancePayment": 10,
        "Cash": 0,
        "CashProvision": 0,
        "Credit": 0,
        "ElectronicPayment": 0
    },
    "Positions": [
        {
            "FiscalString": {
                "Department": 2,
                "DiscountSum": 0,
                "Name": "Выдано: Розничный покупатель",
                "PriceWithDiscount": 10,
                "Quantity": 1,
                "SignCalculationObject": 10,
                "SignMethodCalculation": 3,
                "SumWithDiscount": 10,
                "Tax": "120",
                "TaxSum": 0
            }
        }
    ]
}

Смотрите документацию POST-запрос check

Тело ответа

Успешный ответ (200 OK)

{
    "Result": {
        "datetime": "2026-05-24T11:00:29.1706702+08:00",
        "deviceName": "Atol",
        "docId": "72b8e217-66d7-419d-b394-18cb9dc23a6a",
        "fnsUrl": "nalog.ru",
        "fnNumber": "0123123123123",
        "rnNumber": "00031415926",
        "fiscalDatetime": "20260524110000",
        "fiscalSign": "5847203916",
        "shiftNumber": 41,
        "fiscalNumber": 368
    },
    "Code": 0,
    "Description": "OK",
    "Success": true
}

Смотрите документацию POST-запрос check

Примеры ошибок

55 — Требуется открытая смена

{
    "Code": 55,
    "Description": "Требуется открытая смена",
    "Success": false
}

7 — Сумма безналичной оплаты больше суммы

{
    "Code": 7,
    "Description": "Сумма безналичной оплаты больше суммы чека: Atol: драйвер: DeviceNetBase.Device.Atolv10FR: Сумма не наличных платежей превышает сумму чека",
    "Success": false
}

709 — Устройство не найдено,

{
    "Code": 709,
    "Description": "Устройство не найдено",
    "Success": false
}

4 — Не указано имя ККТ

{
    "Code": 4,
    "Description": "Не указано имя ККТ",
    "Success": false
}

14 — 24 часа кассовой смены истекли

{
    "Code": 14,
    "Description": "24 часа кассовой смены истекли",
    "Success": false
}

POST check/async

Асинхронное выполнение печати чека возврата. Поддерживает привязку к исходному документу по фискальному признаку (ФП).

URL: {{HTTPRoot}}/check/async

Тело запроса

{
    "DeviceName": "{device}",
  "DocId": "1be955bd-593c-4b1a-a9e1-4fb4481398fa",   
  "Cashier": {
    "Name": "Иванов А.И.",
    "Vatin": "7722345678"
  },
    "Customer": {
    "Info": "ООО 'Рога и Копыта",
    "email": "kuznicov@mail.ru",
    "Vatin": "500100732259"
  },
  "PaymentType": 2,                 
  "TaxVariant": 0,                  
  "Electronically": false,
  "AdditionalAttribute": "1775661887",  
  "Payments": {
    "Cash": 90,
    "ElectronicPayment": 0,
    "AdvancePayment": 0,
    "Credit": 0,
    "CashProvision": 0
  },
  "Positions": [
    {
      "FiscalString": {
        "Name": "Бутылка с водой 1л.",
        "Quantity": 1,
        "PriceWithDiscount": 73.18,
        "SumWithDiscount": 73.18,
        "DiscountSum": 0,
        "Department": 1,
        "Tax": "20",
        "TaxSum": 0,
        "SignMethodCalculation": 4,
        "SignCalculationObject": 4
      }
    }
  ]
}

Смотрите документацию POST-запрос check

Тело ответа

Успешный ответ (200 OK)

{
    "Result": "1be955bd-593c-4b1a-a9e1-4fb4481398fa",
    "Code": 0,
    "Description": "OK",
    "Success": true
}

Поле Result

Имя поля	Тип	Назначение	Пример
Result	string	Идентификатор документа	“bed54268-b7ec-4982-b86c-b7f67841d883”

Примеры ошибок

709 — Устройство не найдено,

{
    "Code": 709,
    "Description": "Устройство не найдено",
    "Success": false
}

4 — Не указано имя ККТ

{
    "Code": 4,
    "Description": "Не указано имя ККТ",
    "Success": false
}