getReceipt - запрос фискальных данных по заказу

Выполняется с помощью команды getReceipt. Этот запрос позволяет получить фискальные признаки по заказу для формирования чека на стороне Мерчанта. Параметры запроса:

json
urlencoded

Название	Описание	Формат	Обязательный
`key`	Идентификатор Продавца. Выдается продавцу с параметрами тестового/боевого доступа	Строка
`merchant_order_id`	Уникальный идентификатор платежа в системе theMAP	Строка (максимум 50 символов)
`receipt_id`	Идентификатор чека	Строка (максимум 50 символов)	¹

¹ В случае отсутствия в запросе, в ответе будут содержаться фискальные данные по последней транзакции по заказу

Название	Описание	Формат	Обязательный
`Key`	Идентификатор Продавца. Выдается Продавцу с параметрами тестового/боевого доступа	Строка
`OrderId`	Уникальный идентификатор платежа в системе theMAP	Строка (максимум 50 символов)
`ReceiptId`	Идентификатор чека	Строка (максимум 50 символов)	¹

Название	Описание	Фромат
`Id`	Идентификатор документа	Строка от 1 до 64 символов
`DeviceSN`	Заводской номер устройства пробившего чек	Строка до 20 символов
`DeviceRN`	Регистрационный номер устройства пробившего чек	Строка до 20 символов
`FsNumber`	Номер фискального накопителя	Строка 16 символов
`OFDName`	Наименование ОФД	Строка до 256 символов
`OFDWebsite`	Web-сайт ОФД	Строка до 58 символов
`OFDINN`	ИНН ОФД	Строка 12 символов
`OFDReceiptURL`	Ссылка на чек в ОФД	Строка
`FNSWebsite`	Web-сайт ФНС	Строка до 256 символов
`CompanyINN`	ИНН пользователя	Строка 12 символов
`CompanyName`	Наименование пользователя	Строка до 256 символов
`DocumentNumber`	Номер ФД	Число
`ShiftNumber`	Номер смены	Число
`DocumentIndex`	Номер чека за смену	Число
`ProcessedAt`	Время регистрации фискального документа в ФН	Время в виде строки в формате ISO8601
`Content`	Содержимое документа	Объект
├─ `Type`	Признак расчета 1 – Приход 2 – Возврат прихода 3 – Расход 4 – Возврат расхода	Число
├─ `Positions`	Список предметов расчета	Массив объектов
├── `Quantity`	Количество предмета расчета	Число
├── `Price`	Цена за единицу предмета расчета с учетом скидок и наценок	Число
├── `Tax`	Ставка НДС. Целое число от 1 до 6. 1 – ставка НДС 20% 2 – ставка НДС 10% 3 – ставка НДС расч. 20/120 4 – ставка НДС расч. 10/110 5 – ставка НДС 0% 6 – НДС не облагается	Число
├── `Text`	Наименование предмета расчета	Строка до 128 символов
├── `SubjectType`	Признак предмета расчета 1 – Товар 2 – Подакцизный товар 3 – Работа 4 – Услуга 5 – Ставка азартной игры 6 – Выигрыш азартной игры 7 – Лотерейный билет 8 – Выигрыш лотереи 9 – Предоставление РИД 10 – Платеж 11 – Агентское вознаграждение 12 – Выплата 13 – Иной предмет расчета 14 – Имущественное право 15 – Внереализационный доход 16 – Иные платежи и взносы 17 – Торговый сбор 18 – Курортный сбор 19 – Залог 20 – Расход 21 – Взносы на обязательное пенсионное страхование ИП 22 – Взносы на обязательное пенсионное страхование 23 – Взносы на обязательное медицинское страхование ИП 24 – Взносы на обязательное медицинское страхование 25 – Взносы на обязательное социальное страхование 26 – Платеж казино	Число
├── `AgentType`	Признак агента	Число
├── `Supplier`	Данные поставщика	Объект
├─── `name`	Наименование поставщика	Строка
├─── `inn`	ИНН поставщика	Строка
├─── `phone_numbers`	Список номеров телефонов	Массив строк
├─ `CheckClose`	Параметры закрытия чека	Объект
├── `Payments`	Оплаты	Массив объектов
├─── `Type`	Тип оплаты 1 – сумма по чеку наличными 2 – сумма по чеку безналичными 14 – сумма по чеку предоплатой (зачетом аванса и (или) предыдущих платежей), ЕНВД 15 – сумма по чеку постоплатой (в кредит) 16 – сумма по чеку (БСО) встречным предоставлением	Число
├─── `Amount`	Значение дополнительного реквизита пользователя	Число
├── `TaxationSystem`	Система налогообложения 0 – Общая, ОСН 1 – Упрощенная доход, УСН доход 2 – Упрощенная доход минус расход, УСН доход - расход 3 – Единый налог на вмененный доход 4 – Единый сельскохозяйственный налог, ЕСН 5 – Патентная система налогообложения, Патент	Число
├─ `CustomerContact`	Телефон или электронный адрес покупателя	Строка до 64 символов
`Change`	Сдача	Десятичное число с точностью до 2 символов после точки
`Fp`	Фискальный признак	Строка 10 символов

Пример ответа на успешный запрос(если в ответе у заказа несколько чеков, вернётся массив значений в этом же формате, для получения единственного чека указывайте receipt_id):

{
  "Id": "1atY16Z3wr62fhMogQmFwIDaa4C",
  "DeviceSN": "1400000000001093",
  "DeviceRN": "0000000400054952",
  "FsNumber": "9999078900001341",
  "OFDName": "ООО \"Ярус\" (\"ОФД-Я\")",
  "OFDWebsite": "www.ofd-ya.ru",
  "OFDINN": "7728699517",
  "FNSWebsite": "www.nalog.ru",
  "CompanyINN": "9701015273",
  "CompanyName": "AutoTestMerchant",
  "DocumentNumber": 1586,
  "ShiftNumber": 5776,
  "DocumentIndex": 313,
  "ProcessedAt": "2020-04-22T14:47:00",
  "Content": {
    "Type": 1,
    "Positions": [
      {
        "Quantity": 1,
        "Price": 500,
        "Tax": 3,
        "Text": "Mock3",
        "SubjectType": 6
      },
      {
        "Quantity": 1,
        "Price": 500,
        "Tax": 5,
        "Text": "Mock2",
        "SubjectType": 5
      },
      {
        "Quantity": 1,
        "Price": 500,
        "Tax": 4,
        "Text": "Mock1",
        "SubjectType": 3
      },
      {
        "Quantity": 1,
        "Price": 500,
        "Tax": 3,
        "Text": "Mock4",
        "SubjectType": 1
      }
    ],
    "CheckClose": {
      "Payments": [
        {
          "Type": 2,
          "Amount": 2000
        }
      ],
      "TaxationSystem": 0
    },
    "CustomerContact": "s.davydov@mapcard.pro"
  },
  "Change": 0,
  "Fp": "505358752",
  "PaymentType": 2
}

Пример ответа на не успешный запрос:

{
  "Success": false,
  "ErrCode": "NOT_FOUND"
}