Pangaea version v2.X.X

URI Parameters

• c_group_id: required(integer)

  Id группы касс

Headers

• Authorization: required(string)

  Формат – BasicAuth с кодировкой текста utf-8

  Именем пользователя должен быть actor_id, а паролем actor_token.

  Для формирования заголовка нужно соединить имя пользователя и пароль с помощью символа :, закодировать получившуюся строку в base64 и добавить префикс Basic с пробелом

  Example:

  actor_id=1234567
  actor_token=gmFjyQg5zG88gBt3oy41qQPwk

  Basic MTIzNDU2NzpnbUZqeVFnNXpHODhnQnQzb3k0MXFRUHdr

URI Parameters

• c_group_id: required(integer)

  Id группы касс

• receipt_id: required(string)

  Идентификатор чека.

  Должен быть в формате UUIDv4 без -, буквы в нижнем регистре.

  Каждый запрос создания чека должен содержать уникальный id

Headers

• Authorization: required(string)

  Формат – BasicAuth с кодировкой текста utf-8

  Именем пользователя должен быть actor_id, а паролем actor_token.

  Для формирования заголовка нужно соединить имя пользователя и пароль с помощью символа :, закодировать получившуюся строку в base64 и добавить префикс Basic с пробелом

  Example:

  actor_id=1234567
  actor_token=gmFjyQg5zG88gBt3oy41qQPwk

  Basic MTIzNDU2NzpnbUZqeVFnNXpHODhnQnQzb3k0MXFRUHdr

• Content-type: required(string)

  Example:

  application/json; charset=utf-8

Body

Media type: application/json

Type: object

• type: required(integer - minimum: 1 - maximum: 4)

  [Тег 1054] Признак расчета

  Возможные значения:

  • 1 – Приход (продажа товаров/услуг)
  • 2 – Возврат прихода
  • 3 – Расход
  • 4 – Возврат расхода
• items: required(array of object - minItems: 1)

  Items: items

  • type: required(integer - minimum: 1 - maximum: 19)

    [Тег 1212] Признак предмета расчета

    Перечень возможных значений

    • 1 – ТОВАР
      о реализуемом товаре, за исключением подакцизного товара
    • 2 – ПОДАКЦИЗНЫЙ ТОВАР
      о реализуемом подакцизном товаре
    • 3 – РАБОТА
      о выполняемой работе
    • 4 – УСЛУГА
      об оказываемой услуге
    • 5 – СТАВКА АЗАРТНОЙ ИГРЫ
      о приеме ставок при осуществлении деятельности по проведению азартных игр
    • 6 – ВЫИГРЫШ АЗАРТНОЙ ИГРЫ
      о выплате денежных средств в виде выигрыша при осуществлении деятельности по проведению азартных игр
    • 7 – ЛОТЕРЕЙНЫЙ БИЛЕТ
      о приеме денежных средств при реализации лотерейных билетов, электронных лотерейных билетов, приеме лотерейных ставок при осуществлении деятельности по проведению лотерей
    • 8 – ВЫИГРЫШ ЛОТЕРЕИ
      о выплате денежных средств в виде выигрыша при осуществлении деятельности по проведению лотереи
    • 9 – ПРЕДОСТАВЛЕНИЕ РИД
      о предоставлении прав на использование результатов интеллектуальной деятельности или средств индивидуализации
    • 10 – ПЛАТЕЖ
      об авансе, задатке, предоплате, кредите, взносе в счет оплаты, пени, штрафе, вознаграждении, бонусе и ином аналогичном предмете расчета
    • 11 – АГЕНТСКОЕ ВОЗНАГРАЖДЕНИЕ
      о вознаграждении пользователя, являющегося платежным агентом (субагентом), банковским платежным агентом (субагентом), комиссионером, поверенным или иным агентом
    • 12 – СОСТАВНОЙ ПРЕДМЕТ РАСЧЕТА
      о предмете расчета, состоящем из предметов, каждому из которых может быть присвоено значение от 1 до 11
    • 13 – ИНОЙ ПРЕДМЕТ РАСЧЕТА
      о предмете расчета, не относящемуся к предметам расчета, которым может быть присвоено значение от 1 до 12 и от 14 до 18
    • 14 – ИМУЩЕСТВЕННОЕ ПРАВО
      о передаче имущественных прав
    • 15 – ВНЕРЕАЛИЗАЦИОННЫЙ ДОХОД
      о внереализационном доходе
      Для этого значения поле name должно содержать одно из особых значений
    • 16 – СТРАХОВЫЕ ВЗНОСЫ
      о суммах расходов, уменьшающих сумму налога (авансовых платежей) в соответствии с пунктом 3.1 статьи 346.21 Налогового кодекса Российской Федерации
      Для этого значения поле name должно содержать одно из особых значений
    • 17 – ТОРГОВЫЙ СБОР
      о суммах уплаченного торгового сбора
    • 18 – КУРОРТНЫЙ СБОР
      о курортном сборе
    • 19 – ЗАЛОГ
      о залоге
    
    
  • name: required(string - minLength: 1 - maxLength: 128)

    [Тег 1030] Наименование предмета расчета

  • price: required(number - minimum: 0)

    [Тег 1079] Цена за единицу предмета расчета с учетом скидок, наценок и НДС (в рублях)

  • quantity: required(number - minimum: 0)

    [Тег 1023] Количество предмета расчета

  • amount: required(number - minimum: 0)

    [Тег 1043] Стоимость предмета расчета с учетом скидок и наценок

    Значение этого поля должно отличаться от price * quantity не более, чем на 1 копейку, иначе запрос будет отклонен

  • payment_method: required(integer - minimum: 1 - maximum: 7)

    [Тег 1214] Признак способа расчета

    • 1 – ПРЕДОПЛАТА 100%
      Полная предварительная оплата до момента передачи предмета расчета
    • 2 – ПРЕДОПЛАТА
      Частичная предварительная оплата до момента передачи предмета расчета
    • 3 – АВАНС
    • 4 – ПОЛНЫЙ РАСЧЕТ
      Полная оплата, в том числе с учетом аванса (предварительной оплаты) в момент передачи предмета расчета
    • 5 – ЧАСТИЧНЫЙ РАСЧЕТ И КРЕДИТ
      Частичная оплата предмета расчета в момент его передачи с последующей оплатой в кредит
    • 6 – ПЕРЕДАЧА В КРЕДИТ
      Передача предмета расчета без его оплаты в момент его передачи с последующей оплатой в кредит
    • 7 – ОПЛАТА КРЕДИТА
      Оплата предмета расчета после его передачи с оплатой в кредит (оплата кредита)
  • vat: required(integer - minimum: 1 - maximum: 6)

    [Тег 1199] Ставка НДС

    • 1 – Ставка НДС 20%
    • 2 – Ставка НДС 10%
    • 3 – Ставка НДС расч. 20/120
    • 4 – Ставка НДС расч. 10/110
    • 5 – Ставка НДС 0%
    • 6 – НДС не облагается
  • marking: (object)

    Данные маркировки.

    Поле можно отправить только в случае, когда type равно 1 (о реализуемом товаре, за исключением подакцизного товара), 2 (о реализуемом подакцизном товаре), 12 (составной предмет расчета)

    При отправке этого поля, значение поля quantity должно быть равно 1, иначе запрос отклоняется

    Properties
    • code: required(string)

      Код маркировки

      Отправляется текстовое представление кода маркировки, считанное сканером. Сервис самостоятельно распознает и преобразует эти данные в значение тега 1162

      Принимаются символы, которых нет среди разрешенных в приказе ФНС (/_), но есть в спецификации Data Matrix, поскольку они тоже используются Честным Знаком

      В данный момент реализована поддержка, как минимум, таких форматов маркировки:

      • Код товара средства идентификации мехового изделия
      • DataMatrix (длина – 29 символов)
      • DataMatrix (разделитель – \u001D aka GS)
      • DataMatrix (разделитель – пробел)
      • DataMatrix (без разделителей, где длина элементной строки ИП 21 равна 13)
  • customs_info: (object)

    Таможенная информация.

    Объект либо включается целиком со всеми полями, либо не включается вовсе.

    Если страной происхождения товаров не является Российская Федерация, то customs_info должно быть указано.

    Если страной происхождения товаров группа стран (например, Евросоюз), то customs_info не включается.

    Если товар был изготовлен в Российской Федерации с использованием частей, страной происхождения которых не является Российская Федерация, то customs_info не включается.

    В случаях осуществления расчетов между организациями и (или) индивидуальными предпринимателями, customs_info включается, если пользователь имеет обязанность, предусмотренную пунктом 3 статьи 169 Налогового кодекса Российской Федерации.

    Если товар был упакован в Российской Федерации, а изготовлен извне, то страной происхождения такого товара является страна изготовления.

    Properties
    • decl_num: required(string - minLength: 1 - maxLength: 32)

      [Тег 1231] Номер таможенной декларации

    • origin_country_code: required(string - minLength: 3 - maxLength: 3)

      [Тег 1230] Цифровой код страны происхождения товара в соответствии с Общероссийским классификатором стран мира

• taxation: required(one of 1, 2, 4, 16, 32)

  [Тег 1055] Система налогообложения.

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

  Доступные системы налогообложения можно получить запросом GET /c_groups/{c_group_id}

  Возможные значения:

  • 1 – ОРН
  • 2 – УСН доход
  • 4 – УСН доход - расход
  • 16 – ЕСН
  • 32 – ПСН
• amount: required(object)

  Сумма этих полей должна совпадать с суммой полей amount каждого предмета расчета, с точностью до количества рублей, иначе запрос будет отклонен

  Тег 1020 формируется как точная сумма полей внутри

  Теги 1102, 1103, 1104, 1105, 1106, 1107 рассчитываются автоматически

  Properties
  • cashless: (number - minimum: 0)

    [Тег 1081] Сумма электронными (в рублях)

  • prepayment: (number - minimum: 0)

    [Тег 1215] Сумма предоплатой (зачетом аванса) (в рублях)

• notify: required(array of NotifyAddress - minItems: 1 - maxItems: 1)

  Адреса клиентов, куда будут отосланы уведомления о чеке

  Items: NotifyAddress

  • type: required(one of email, phone)

    Возможные значения:

    • email
    • phone
  • value: required(string - maxLength: 100)

    Номер телефона должен быть в формате E.164 (номер начинается с плюса и содержит только цифры), иначе запрос отклоняется

• customer: (object)

  Поля tin и info обязательны к отправке, если покупатель является юр. лицом

  Properties
  • tin: (string - minLength: 10 - maxLength: 12)

    [Тег 1228] ИНН организации или покупателя (клиента)

    Если покупателю (клиенту) не присвоен ИНН на территории РФ, то должно отправляться значение 000000000000

  • name: (string - minLength: 1 - maxLength: 256)

    [Тег 1227] Наименование организации или фамилия, имя, отчество (при наличии), серия и номер паспорта покупателя (клиента)

• cashier: (object)

  Данные кассира (человека, сформировавшего чек)

  Если чек создается в автоматическом режиме, то данное поле не отправляется.

  В каждой смене может быть только один кассир, поэтому если кассир в текущей смене отличается от отправленного в чеке, то смена закроется и откроется заново, что займет дополнительное время.

  Если смена открыта без кассира, а чек отправлен с кассиром (или наоборот), то это вызовет переоткрытие смены.

  Если два кассира имеют одинаковое поле name, но только один из них имеет поле tin, то это вызовет переоткрытие смены.

  Properties
  • name: required(string - minLength: 1 - maxLength: 64)

    [Тег 1021] Должность и фамилия лица, осуществившего расчет с покупателем (клиентом), оформившего кассовый чек (БСО) и выдавшего (передавшего) его покупателю (клиенту)

  • tin: (string - minLength: 10 - maxLength: 12)

    [Тег 1203] ИНН лица, осуществившего расчет с покупателем (клиентом), оформившего кассовый чек (БСО) и выдавшего (передавшего) его покупателю (клиенту)

• loc: required(object)
  • billing_place: required(string)

    [Тег 1187] Значение одного из места расчетов, которое доступно группе касс

    Касса регистрируется на определенное место расчетов (сайт).

    Если она регистрируется на несколько сайтов, то при регистрации их адреса разделяются ;. В этом случае чек может содержать один из этих сайтов

    Список доступных мест расчетов (сайтов) можно получить с помощью GET /c_groups/{c_group_id}

Example:

{
  "type": 1,
  "items": [
    {
      "type": 1,
      "name": "Безделушка",
      "price": 14,
      "quantity": 2,
      "amount": 28,
      "vat": 6,
      "payment_method": 4
    }
  ],
  "amount": {
    "cashless": 28
  },
  "taxation": 4,
  "notify": [
    {
      "type": "email",
      "value": "[email protected]"
    }
  ],
  "loc": {
    "billing_place": "https://example.com"
  }
}

URI Parameters

• c_group_id: required(integer)

  Id группы касс

• receipt_id: required(string)

  Идентификатор чека.

  Должен быть в формате UUIDv4 без -, буквы в нижнем регистре.

  Каждый запрос создания чека должен содержать уникальный id

Headers

• Authorization: required(string)

  Формат – BasicAuth с кодировкой текста utf-8

  Именем пользователя должен быть actor_id, а паролем actor_token.

  Для формирования заголовка нужно соединить имя пользователя и пароль с помощью символа :, закодировать получившуюся строку в base64 и добавить префикс Basic с пробелом

  Example:

  actor_id=1234567
  actor_token=gmFjyQg5zG88gBt3oy41qQPwk

  Basic MTIzNDU2NzpnbUZqeVFnNXpHODhnQnQzb3k0MXFRUHdr

• Content-type: required(string)

  Example:

  application/json; charset=utf-8

Body

Media type: application/json

Type: object

• type: required(integer - minimum: 1 - maximum: 4)

  [Тег 1054] Признак расчета

  Возможные значения:

  • 1 – Приход (продажа товаров/услуг)
  • 2 – Возврат прихода
  • 3 – Расход
  • 4 – Возврат расхода
• items: required(array of object - minItems: 1)

  Items: items

  • type: required(integer - minimum: 1 - maximum: 19)

    [Тег 1212] Признак предмета расчета

    Перечень возможных значений

    • 1 – ТОВАР
      о реализуемом товаре, за исключением подакцизного товара
    • 2 – ПОДАКЦИЗНЫЙ ТОВАР
      о реализуемом подакцизном товаре
    • 3 – РАБОТА
      о выполняемой работе
    • 4 – УСЛУГА
      об оказываемой услуге
    • 5 – СТАВКА АЗАРТНОЙ ИГРЫ
      о приеме ставок при осуществлении деятельности по проведению азартных игр
    • 6 – ВЫИГРЫШ АЗАРТНОЙ ИГРЫ
      о выплате денежных средств в виде выигрыша при осуществлении деятельности по проведению азартных игр
    • 7 – ЛОТЕРЕЙНЫЙ БИЛЕТ
      о приеме денежных средств при реализации лотерейных билетов, электронных лотерейных билетов, приеме лотерейных ставок при осуществлении деятельности по проведению лотерей
    • 8 – ВЫИГРЫШ ЛОТЕРЕИ
      о выплате денежных средств в виде выигрыша при осуществлении деятельности по проведению лотере
    • 9 – ПРЕДОСТАВЛЕНИЕ РИД
      о предоставлении прав на использование результатов интеллектуальной деятельности или средств индивидуализации
    • 10 – ПЛАТЕЖ
      об авансе, задатке, предоплате, кредите, взносе в счет оплаты, пени, штрафе, вознаграждении, бонусе и ином аналогичном предмете расчета
    • 11 – АГЕНТСКОЕ ВОЗНАГРАЖДЕНИЕ
      о вознаграждении пользователя, являющегося платежным агентом (субагентом), банковским платежным агентом (субагентом), комиссионером, поверенным или иным агентом
    • 12 – СОСТАВНОЙ ПРЕДМЕТ РАСЧЕТА
      о предмете расчета, состоящем из предметов, каждому из которых может быть присвоено значение от 1 до 11
    • 13 – ИНОЙ ПРЕДМЕТ РАСЧЕТА
      о предмете расчета, не относящемуся к предметам расчета, которым может быть присвоено значение от 1 до 12 и от 14 до 18
    • 14 – ИМУЩЕСТВЕННОЕ ПРАВО
      о передаче имущественных прав
    • 15 – ВНЕРЕАЛИЗАЦИОННЫЙ ДОХОД
      о внереализационном доходе
      Для этого значения поле name должно содержать одно из особых значений
    • 16 – СТРАХОВЫЕ ВЗНОСЫ
      о суммах расходов, уменьшающих сумму налога (авансовых платежей) в соответствии с пунктом 3.1 статьи 346.21 Налогового кодекса Российской Федерации
      Для этого значения поле name должно содержать одно из особых значений
    • 17 – ТОРГОВЫЙ СБОР
      о суммах уплаченного торгового сбора
    • 18 – КУРОРТНЫЙ СБОР
      о курортном сборе
    • 19 – ЗАЛОГ
      о залоге
    
    
  • name: required(string - minLength: 1 - maxLength: 128)

    [Тег 1030] Наименование предмета расчета

  • price: required(number - minimum: 0)

    [Тег 1079] Цена за единицу предмета расчета с учетом скидок, наценок и НДС (в рублях)

  • quantity: required(number - minimum: 0)

    [Тег 1023] Количество предмета расчета

  • amount: required(number - minimum: 0)

    [Тег 1043] Стоимость предмета расчета с учетом скидок и наценок

    Значение этого поля должно отличаться от price * quantity не более, чем на 1 копейку, иначе запрос будет отклонен

  • payment_method: required(integer - minimum: 1 - maximum: 7)

    [Тег 1214] Признак способа расчета

    • 1 – ПРЕДОПЛАТА 100%
      Полная предварительная оплата до момента передачи предмета расчета
    • 2 – ПРЕДОПЛАТА
      Частичная предварительная оплата до момента передачи предмета расчета
    • 3 – АВАНС
    • 4 – ПОЛНЫЙ РАСЧЕТ
      Полная оплата, в том числе с учетом аванса (предварительной оплаты) в момент передачи предмета расчета
    • 5 – ЧАСТИЧНЫЙ РАСЧЕТ И КРЕДИТ
      Частичная оплата предмета расчета в момент его передачи с последующей оплатой в кредит
    • 6 – ПЕРЕДАЧА В КРЕДИТ
      Передача предмета расчета без его оплаты в момент его передачи с последующей оплатой в кредит
    • 7 – ОПЛАТА КРЕДИТА
      Оплата предмета расчета после его передачи с оплатой в кредит (оплата кредита)
  • vat: required(integer - minimum: 1 - maximum: 6)

    [Тег 1199] Ставка НДС

    • 1 – Ставка НДС 20%
    • 2 – Ставка НДС 10%
    • 3 – Ставка НДС расч. 20/120
    • 4 – Ставка НДС расч. 10/110
    • 5 – Ставка НДС 0%
    • 6 – НДС не облагается
• taxation: required(one of 1, 2, 4, 16, 32)

  [Тег 1055] Система налогообложения.

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

  Доступные системы налогообложения можно получить запросом GET /c_groups/{c_group_id}

  Возможные значения:

  • 1 – ОРН
  • 2 – УСН доход
  • 4 – УСН доход - расход
  • 16 – ЕСН
  • 32 – ПСН
• amount: required(object)

  Сумма этих полей должна совпадать с суммой полей amount каждого предмета расчета, с точностью до количества рублей, иначе запрос будет отклонен

  Тег 1020 формируется как точная сумма полей внутри

  Теги 1102, 1103, 1104, 1105, 1106, 1107 рассчитываются автоматически

  Properties
  • cashless: (number - minimum: 0)

    [Тег 1081] Сумма электронными (в рублях)

  • cash: (number - minimum: 0)

    [Тег 1031] Сумма наличиными (в рублях)

• cashier: (object)

  Данные кассира (человека, сформировавшего чек)

  Если чек создается в автоматическом режиме, то данное поле не отправляется.

  В каждой смене может быть только один кассир, поэтому если кассир в текущей смене отличается от отправленного в чеке, то смена закроется и откроется заново, что займет дополнительное время.

  Если смена открыта без кассира, а чек отправлен с кассиром (или наоборот), то это вызовет переоткрытие смены.

  Если два кассира имеют одинаковое поле name, но только один из них имеет поле tin, то это вызовет переоткрытие смены.

  Properties
  • name: required(string - minLength: 1 - maxLength: 64)

    [Тег 1021] Должность и фамилия лица, осуществившего расчет с покупателем (клиентом), оформившего кассовый чек (БСО) и выдавшего (передавшего) его покупателю (клиенту)

  • tin: (string - minLength: 10 - maxLength: 12)

    [Тег 1203] ИНН лица, осуществившего расчет с покупателем (клиентом), оформившего кассовый чек (БСО) и выдавшего (передавшего) его покупателю (клиенту)

• loc: required(object)
  • machine_num: required(string - maxLength: 20)

    [Тег 1036] Номер одного из автоматов, который доступен группе касс

    При регистрации кассы в налоговой касса привязывается к определенным автоматам, которые она может обслуживать. Для каждого автомата указывается его номер, адрес и место установки (место установки уточняет, где находится автомат, в рамках указанного адреса).

    Фискализация чеков из других источников запрещена. Если автомат меняет адрес или место установки, то кассу необходимо перерегистрировать.

    Список доступных номеров автоматов можно получить с помощью GET /c_groups/{c_group_id}

Example:

{
  "type": 1,
  "items": [
    {
      "type": 1,
      "name": "Безделушка",
      "price": 15,
      "quantity": 3,
      "amount": 30,
      "vat": 6,
      "payment_method": 4
    }
  ],
  "amount": {
    "cash": 30
  },
  "taxation": 4,
  "loc": {
    "machine_num": "1234124123"
  }
}

URI Parameters

• c_group_id: required(integer)

  Id группы касс

• receipt_id: required(string)

  Идентификатор чека.

  Должен быть в формате UUIDv4 без -, буквы в нижнем регистре.

  Каждый запрос создания чека должен содержать уникальный id

Headers

• Authorization: required(string)

  Формат – BasicAuth с кодировкой текста utf-8

  Именем пользователя должен быть actor_id, а паролем actor_token.

  Для формирования заголовка нужно соединить имя пользователя и пароль с помощью символа :, закодировать получившуюся строку в base64 и добавить префикс Basic с пробелом

  Example:

  actor_id=1234567
  actor_token=gmFjyQg5zG88gBt3oy41qQPwk

  Basic MTIzNDU2NzpnbUZqeVFnNXpHODhnQnQzb3k0MXFRUHdr

• Content-type: required(string)

  Example:

  application/json; charset=utf-8

Body

Media type: application/json

Type: object

• type: required(integer - minimum: 1 - maximum: 4)

  [Тег 1054] Признак расчета

  Возможные значения:

  • 1 – Приход (продажа товаров/услуг)
  • 2 – Возврат прихода
  • 3 – Расход
  • 4 – Возврат расхода
• items: required(array of object - minItems: 1)

  Items: items

  • type: required(integer - minimum: 1 - maximum: 19)

    [Тег 1212] Признак предмета расчета

    Перечень возможных значений

    • 1 – ТОВАР
      о реализуемом товаре, за исключением подакцизного товара
    • 2 – ПОДАКЦИЗНЫЙ ТОВАР
      о реализуемом подакцизном товаре
    • 3 – РАБОТА
      о выполняемой работе
    • 4 – УСЛУГА
      об оказываемой услуге
    • 5 – СТАВКА АЗАРТНОЙ ИГРЫ
      о приеме ставок при осуществлении деятельности по проведению азартных игр
    • 6 – ВЫИГРЫШ АЗАРТНОЙ ИГРЫ
      о выплате денежных средств в виде выигрыша при осуществлении деятельности по проведению азартных игр
    • 7 – ЛОТЕРЕЙНЫЙ БИЛЕТ
      о приеме денежных средств при реализации лотерейных билетов, электронных лотерейных билетов, приеме лотерейных ставок при осуществлении деятельности по проведению лотерей
    • 8 – ВЫИГРЫШ ЛОТЕРЕИ
      о выплате денежных средств в виде выигрыша при осуществлении деятельности по проведению лотере
    • 9 – ПРЕДОСТАВЛЕНИЕ РИД
      о предоставлении прав на использование результатов интеллектуальной деятельности или средств индивидуализации
    • 10 – ПЛАТЕЖ
      об авансе, задатке, предоплате, кредите, взносе в счет оплаты, пени, штрафе, вознаграждении, бонусе и ином аналогичном предмете расчета
    • 11 – АГЕНТСКОЕ ВОЗНАГРАЖДЕНИЕ
      о вознаграждении пользователя, являющегося платежным агентом (субагентом), банковским платежным агентом (субагентом), комиссионером, поверенным или иным агентом
    • 12 – СОСТАВНОЙ ПРЕДМЕТ РАСЧЕТА
      о предмете расчета, состоящем из предметов, каждому из которых может быть присвоено значение от 1 до 11
    • 13 – ИНОЙ ПРЕДМЕТ РАСЧЕТА
      о предмете расчета, не относящемуся к предметам расчета, которым может быть присвоено значение от 1 до 12 и от 14 до 18
    • 14 – ИМУЩЕСТВЕННОЕ ПРАВО
      о передаче имущественных прав
    • 15 – ВНЕРЕАЛИЗАЦИОННЫЙ ДОХОД
      о внереализационном доходе
      Для этого значения поле name должно содержать одно из особых значений
    • 16 – СТРАХОВЫЕ ВЗНОСЫ
      о суммах расходов, уменьшающих сумму налога (авансовых платежей) в соответствии с пунктом 3.1 статьи 346.21 Налогового кодекса Российской Федерации
      Для этого значения поле name должно содержать одно из особых значений
    • 17 – ТОРГОВЫЙ СБОР
      о суммах уплаченного торгового сбора
    • 18 – КУРОРТНЫЙ СБОР
      о курортном сборе
    • 19 – ЗАЛОГ
      о залоге
    
    
  • name: required(string - minLength: 1 - maxLength: 128)

    [Тег 1030] Наименование предмета расчета

  • price: required(number - minimum: 0)

    [Тег 1079] Цена за единицу предмета расчета с учетом скидок, наценок и НДС (в рублях)

  • quantity: required(number - minimum: 0)

    [Тег 1023] Количество предмета расчета

  • amount: required(number - minimum: 0)

    [Тег 1043] Стоимость предмета расчета с учетом скидок и наценок

    Значение этого поля должно отличаться от price * quantity не более, чем на 1 копейку, иначе запрос будет отклонен

  • payment_method: required(integer - minimum: 1 - maximum: 7)

    [Тег 1214] Признак способа расчета

    • 1 – ПРЕДОПЛАТА 100%
      Полная предварительная оплата до момента передачи предмета расчета
    • 2 – ПРЕДОПЛАТА
      Частичная предварительная оплата до момента передачи предмета расчета
    • 3 – АВАНС
    • 4 – ПОЛНЫЙ РАСЧЕТ
      Полная оплата, в том числе с учетом аванса (предварительной оплаты) в момент передачи предмета расчета
    • 5 – ЧАСТИЧНЫЙ РАСЧЕТ И КРЕДИТ
      Частичная оплата предмета расчета в момент его передачи с последующей оплатой в кредит
    • 6 – ПЕРЕДАЧА В КРЕДИТ
      Передача предмета расчета без его оплаты в момент его передачи с последующей оплатой в кредит
    • 7 – ОПЛАТА КРЕДИТА
      Оплата предмета расчета после его передачи с оплатой в кредит (оплата кредита)
  • vat: required(integer - minimum: 1 - maximum: 6)

    [Тег 1199] Ставка НДС

    • 1 – Ставка НДС 20%
    • 2 – Ставка НДС 10%
    • 3 – Ставка НДС расч. 20/120
    • 4 – Ставка НДС расч. 10/110
    • 5 – Ставка НДС 0%
    • 6 – НДС не облагается
  • customs_info: (object)

    Таможенная информация.

    Объект либо включается целиком со всеми полями, либо не включается вовсе.

    Если страной происхождения товаров не является Российская Федерация, то customs_info должно быть указано.

    Если страной происхождения товаров группа стран (например, Евросоюз), то customs_info не включается.

    Если товар был изготовлен в Российской Федерации с использованием частей, страной происхождения которых не является Российская Федерация, то customs_info не включается.

    В случаях осуществления расчетов между организациями и (или) индивидуальными предпринимателями, customs_info включается, если пользователь имеет обязанность, предусмотренную пунктом 3 статьи 169 Налогового кодекса Российской Федерации.

    Если товар был упакован в Российской Федерации, а изготовлен извне, то страной происхождения такого товара является страна изготовления.

    Properties
    • decl_num: required(string - minLength: 1 - maxLength: 32)

      [Тег 1231] Номер таможенной декларации

    • origin_country_code: required(string - minLength: 3 - maxLength: 3)

      [Тег 1230] Цифровой код страны происхождения товара в соответствии с Общероссийским классификатором стран мира

  • agent: (union of SimpleAgent or PayingAgent or BankPayingAgent)

    Данные агента.

    Отправляется только в случае, если организация выступает агентом по данному предмету расчета

    Простые агенты

    • type: required(one of 16, 32, 64)

      [Тег 1222] Признак агента

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

      Возможные значения:

      • 16 – Поверенный
      • 32 – Коммисионер
      • 64 – Иной агент
    • supplier: required(object)

      Данные поставщика

      Properties
      • phones: required(array of Phone)

        [Тег 1171] Номера контактных телефонов поставщика

        Номер телефона должен быть в формате E.164 (номер начинается с плюса и содержит только цифры), иначе запрос отклоняется

      • name: required(string - minLength: 1 - maxLength: 256)

        [Тег 1225] Наименование поставщика

      • tin: required(string - minLength: 10 - maxLength: 12)

        [Тег 1226] ИНН поставщика

        Если поставщику не присвоен ИНН на территории РФ, то должно отправляться значение 000000000000

    Платежный агент (субагент)

    • type: required(one of 4, 8)

      [Тег 1222] Признак агента

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

      Возможные значения:

      • 4 – Платежный агент
      • 8 – Платежный субагент
    • supplier: required(object)

      Данные поставщика

      Properties
      • phones: required(array of Phone)

        [Тег 1171] Номера контактных телефонов поставщика

        Номер телефона должен быть в формате E.164 (номер начинается с плюса и содержит только цифры), иначе запрос отклоняется

      • name: required(string - minLength: 1 - maxLength: 256)

        [Тег 1225] Наименование поставщика

      • tin: required(string - minLength: 10 - maxLength: 12)

        [Тег 1226] ИНН поставщика

        Если поставщику не присвоен ИНН на территории РФ, то должно отправляться значение 000000000000

    • paying_agent: required(object)

      Данные платежного агента

      Properties
      • phones: required(array of Phone)

        [Тег 1073] Номера телефонов платежного агента, платежного субагента, банковского платежного агента, банковского платежного субагента

        Номер телефона должен быть в формате E.164 (номер начинается с плюса и содержит только цифры), иначе запрос отклоняется

    • payment_operator: required(object)

      Данные оператора по приему платежей

      Properties
      • phones: required(array of Phone)

        [Тег 1074] Номера контактных телефонов оператора по приему платежей

        Номер телефона должен быть в формате E.164 (номер начинается с плюса и содержит только цифры), иначе запрос отклоняется

    Банк. платежный агент (субагент)

    • type: required(one of 1, 2)

      [Тег 1222] Признак агента

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

      Возможные значения:

      • 1 – Банк. платежный агент
      • 2 – Банк. платежный субагент
    • supplier: required(object)

      Данные получателя средств

      Properties
      • phones: required(array of Phone)

        [Тег 1171] Номера контактных телефонов поставщика

        Номер телефона должен быть в формате E.164 (номер начинается с плюса и содержит только цифры), иначе запрос отклоняется

      • name: required(string - minLength: 1 - maxLength: 256)

        [Тег 1225] Наименование поставщика

      • tin: required(string - minLength: 10 - maxLength: 12)

        [Тег 1226] ИНН поставщика

        Если поставщику не присвоен ИНН на территории РФ, то должно отправляться значение 000000000000

    • paying_agent: required(object)

      Данные платежного агента

      Properties
      • phones: required(array of Phone)

        [Тег 1073] Номера телефонов платежного агента, платежного субагента, банковского платежного агента, банковского платежного субагента

        Номер телефона должен быть в формате E.164 (номер начинается с плюса и содержит только цифры), иначе запрос отклоняется

      • operation: required(string - maxLength: 24)

        [Тег 1044] Наименование операции агента

    • money_transfer_operator: required(object)

      Данные оператора по переводу денежных средств

      Properties
      • phones: required(array of Phone)

        [Тег 1075] Номера телефонов оператора по переводу денежных средств

        Номер телефона должен быть в формате E.164 (номер начинается с плюса и содержит только цифры), иначе запрос отклоняется

      • name: required(string - minLength: 1 - maxLength: 64)

        [Тег 1026] Наименование оператора по переводу денежных средств

      • tin: required(string - minLength: 10 - maxLength: 12)

        [Тег 1016] ИНН оператора перевода

      • address: required(string - minLength: 1 - maxLength: 256)

        [Тег 1005] Место нахождения (адрес) оператора по переводу денежных средств

• taxation: required(one of 1, 2, 4, 16, 32)

  [Тег 1055] Система налогообложения.

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

  Доступные системы налогообложения можно получить запросом GET /c_groups/{c_group_id}

  Возможные значения:

  • 1 – ОРН
  • 2 – УСН доход
  • 4 – УСН доход - расход
  • 16 – ЕСН
  • 32 – ПСН
• amount: required(object)

  Сумма этих полей должна совпадать с суммой полей amount каждого предмета расчета, с точностью до количества рублей, иначе запрос будет отклонен

  Тег 1020 формируется как точная сумма полей внутри

  Теги 1102, 1103, 1104, 1105, 1106, 1107 рассчитываются автоматически

  Properties
  • cashless: (number - minimum: 0)

    [Тег 1081] Сумма электронными (в рублях)

  • prepayment: (number - minimum: 0)

    [Тег 1215] Сумма предоплатой (зачетом аванса) (в рублях)

• notify: required(array of NotifyAddress - minItems: 1 - maxItems: 1)

  Адреса клиентов, куда будут отосланы уведомления о чеке

  Items: NotifyAddress

  • type: required(one of email, phone)

    Возможные значения:

    • email
    • phone
  • value: required(string - maxLength: 100)

    Номер телефона должен быть в формате E.164 (номер начинается с плюса и содержит только цифры), иначе запрос отклоняется

• customer: (object)

  Поля tin и info обязательны к отправке, если покупатель является юр. лицом

  Properties
  • tin: (string - minLength: 10 - maxLength: 12)

    [Тег 1228] ИНН организации или покупателя (клиента)

    Если покупателю (клиенту) не присвоен ИНН на территории РФ, то должно отправляться значение 000000000000

  • name: (string - minLength: 1 - maxLength: 256)

    [Тег 1227] Наименование организации или фамилия, имя, отчество (при наличии), серия и номер паспорта покупателя (клиента)

• cashier: (object)

  Данные кассира (человека, сформировавшего чек)

  Если чек создается в автоматическом режиме, то данное поле не отправляется.

  В каждой смене может быть только один кассир, поэтому если кассир в текущей смене отличается от отправленного в чеке, то смена закроется и откроется заново, что займет дополнительное время.

  Если смена открыта без кассира, а чек отправлен с кассиром (или наоборот), то это вызовет переоткрытие смены.

  Если два кассира имеют одинаковое поле name, но только один из них имеет поле tin, то это вызовет переоткрытие смены.

  Properties
  • name: required(string - minLength: 1 - maxLength: 64)

    [Тег 1021] Должность и фамилия лица, осуществившего расчет с покупателем (клиентом), оформившего кассовый чек (БСО) и выдавшего (передавшего) его покупателю (клиенту)

  • tin: (string - minLength: 10 - maxLength: 12)

    [Тег 1203] ИНН лица, осуществившего расчет с покупателем (клиентом), оформившего кассовый чек (БСО) и выдавшего (передавшего) его покупателю (клиенту)

• loc: required(object)
  • billing_place: required(string)

    [Тег 1187] Значение одного из места расчетов, которое доступно группе касс

    Касса регистрируется на определенное место расчетов (сайт).

    Если она регистрируется на несколько сайтов, то при регистрации их адреса разделяются ;. В этом случае чек может содержать один из этих сайтов

    Список доступных мест расчетов (сайтов) можно получить с помощью GET /c_groups/{c_group_id}

Examples:

{
  "type": 1,
  "items": [
    {
      "type": 1,
      "name": "Безделушка",
      "price": 14,
      "quantity": 2,
      "amount": 28,
      "vat": 6,
      "payment_method": 4
    }
  ],
  "amount": {
    "cashless": 28
  },
  "taxation": 4,
  "notify": [
    {
      "type": "email",
      "value": "[email protected]"
    }
  ],
  "loc": {
    "billing_place": "https://example.com"
  }
}

{
  "type": 1,
  "items": [
    {
      "type": 1,
      "name": "Безделушка",
      "price": 14,
      "quantity": 2,
      "amount": 28,
      "vat": 6,
      "payment_method": 4,
      "agent": {
        "type": 32,
        "supplier": {
          "phones": [
            "+70495356290",
            "+78658542230"
          ],
          "name": "ООО \"Центнер\"",
          "tin": "430913167793"
        }
      }
    }
  ],
  "amount": {
    "cashless": 28
  },
  "taxation": 4,
  "notify": [
    {
      "type": "email",
      "value": "[email protected]"
    }
  ],
  "loc": {
    "billing_place": "https://example.com"
  }
}

{
  "type": 1,
  "items": [
    {
      "type": 1,
      "name": "Безделушка",
      "price": 14,
      "quantity": 2,
      "amount": 28,
      "vat": 6,
      "payment_method": 4,
      "agent": {
        "type": 4,
        "supplier": {
          "phones": [
            "+79061119858"
          ],
          "name": "ООО \"Центнер\"",
          "tin": "430913167793"
        },
        "paying_agent": {
          "phones": [
            "+76070631408"
          ]
        },
        "payment_operator": {
          "phones": [
            "+70495356290",
            "+78658542230"
          ]
        }
      }
    }
  ],
  "amount": {
    "cashless": 28
  },
  "taxation": 4,
  "notify": [
    {
      "type": "email",
      "value": "[email protected]"
    }
  ],
  "loc": {
    "billing_place": "https://example.com"
  }
}

{
  "type": 1,
  "items": [
    {
      "type": 1,
      "name": "Безделушка",
      "price": 14,
      "quantity": 2,
      "amount": 28,
      "vat": 6,
      "payment_method": 4,
      "agent": {
        "type": 1,
        "supplier": {
          "phones": [
            "+70495356290",
            "+78658542230"
          ],
          "name": "ООО \"Центнер\"",
          "tin": "430913167793"
        },
        "money_transfer_operator": {
          "phones": [
            "+74368176579"
          ],
          "name": "ООО \"Лексиканум\"",
          "tin": "366021190670",
          "address": "к. Одинцово, ш. Космодемьянской, д. 307 к. 694, 382236"
        },
        "paying_agent": {
          "phones": [
            "+76070631408"
          ],
          "operation": "Выдача наличных"
        }
      }
    }
  ],
  "amount": {
    "cashless": 28
  },
  "taxation": 4,
  "notify": [
    {
      "type": "email",
      "value": "[email protected]"
    }
  ],
  "loc": {
    "billing_place": "https://example.com"
  }
}

URI Parameters

• c_group_id: required(integer)

  Id группы касс

• receipt_id: required(string)

  Уникальный идентификатор чека

Headers

• Authorization: required(string)

  Формат – BasicAuth с кодировкой текста utf-8

  Именем пользователя должен быть actor_id, а паролем actor_token.

  Для формирования заголовка нужно соединить имя пользователя и пароль с помощью символа :, закодировать получившуюся строку в base64 и добавить префикс Basic с пробелом

  Example:

  actor_id=1234567
  actor_token=gmFjyQg5zG88gBt3oy41qQPwk

  Basic MTIzNDU2NzpnbUZqeVFnNXpHODhnQnQzb3k0MXFRUHdr

URI Parameters

• c_group_id: required(integer)

  Id группы касс

• receipt_id: required(string)

  Уникальный идентификатор чека

Headers

• Authorization: required(string)

  Формат – BasicAuth с кодировкой текста utf-8

  Именем пользователя должен быть actor_id, а паролем actor_token.

  Для формирования заголовка нужно соединить имя пользователя и пароль с помощью символа :, закодировать получившуюся строку в base64 и добавить префикс Basic с пробелом

  Example:

  actor_id=1234567
  actor_token=gmFjyQg5zG88gBt3oy41qQPwk

  Basic MTIzNDU2NzpnbUZqeVFnNXpHODhnQnQzb3k0MXFRUHdr