CloudKassir – отзывы экспертов и пользователей

Почему сумма закрывающих документов не соответствует сумме моей оплаты?

В первый месяц оказания услуг (месяц, в котором фискализирована касса) закрывающие документы предоставляются на* резерв кассы на 1 год,* фискальный накопитель,* аренду кассы за первый месяц действия пакета.Остаток аванса будет на ежемесячной основе закрываться УПД на аренду кассы в течение всех оставшихся месяцев действия пакета.

Пример:

Я оплатил 12.05.2021 пакет на сумму 48 990р. одним платежом, включающим:* резерв кассы на 1 год (01.05.2021 – 30.04.2022) на сумму 6 000р.,* фискальный накопитель на 3 года на сумму 12 990р.,* аренду кассы на 1 год (01.05.2021 – 30.04.2021)

на сумму 30 000р.Допустим, касса была фискализирована в мае 2021, тогда первый месяц оказания услуг – это май 2021 года.
За май 2021 года будут выставлены УПД на резерв кассы (6 000р.), фискальный накопитель (12 990р.) и аренду кассы за май 2021 (2 500р.) на общую сумму 21 490р.

Основные положения закона

• Необходимо использовать кассу нового образца с установленным фискальным накопителем (ФН).
• Необходимо заключить договор с оператором фискальных данных (ОФД) для передачи данных с ККТ в режиме онлайн в ФНС.
• Необходимо указывать в чеке все товарные позиции: наименование, цена, кол-во, сумма, ставка НДС.
• Необходимо подключить кассу к интернету.
• Необходимо выдавать чек покупателю непосредственно в момент расчета: для интернет-платежей с использованием банковской карты отправлять чек на e-mail или телефон.
• Необходимо менять ФН в двух случаях:
  • по истечении его срока действия;
  • при заполнении памяти до истечения срока действия;
    и хранить его в течение 5-ти лет.
• Нет необходимости заключать договор с ЦТО на обслуживание.
• Нет необходимости предъявлять кассу инспектору ФНС, все регистрационные действия можно выполнить дистанционно в личном кабинете налогоплательщика на сайте ФНС.

Agentdata

Данные агента, Тег ОФД 1223.

Agentsign

Признак агента, Тег ОФД 1057, 1222.Для корректного формирования при указаннии признака агента необходимо:В каждой товарной позиции указывать данные агента (AgentData, Тег 1223) и данные поставщика (PurveyorData, Тег 1224).

Amounts

Общая сумма платежа или возврата.
Должна содержать в себе, как минимум, один из следующих параметров.

Api кассы

API для касcы — программный интерфейс системы для взаимодействия с онлайн-кассой.

Causecorrection

Основание для коррекции

Cloudkassir – phpshop

Correctionreceiptdata

Параметры формирования чека/состав чека.

Correctionreceipttype

Correctiontype

Customerreceipt

Параметры формирования чека/состав чека.Объект CustomerReceipt также может быть передан в параметре Data с вызовом виджета, либо в любом другом платёжном методе CloudPayments (например, оплата по криптограмме, по токену, подтверждении оплаты, возвратах денежных средств, изменений подписки и др.) для формирования чека прихода при успешном платеже.

Industryrequisitecollection

Отраслевой реквизит чека

Items

Параметры услуг/товарных позиций в чеке.

Markpartquantity

Дробное количество маркированного товара

Method

Признак способа расчета.

Object

Признак предмета расчета.

Operationreceiptrequisite

Операционный реквизит чека

Productcodedata

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

Purveyordata

Данные поставщика платежного агента, Тег ОФД 1224.

Receipt

Выполняется после выдачи кассового чека.

Служит для информирования о сформированных онлайн-чеках: система отправляет запрос на адрес ТСП с информацией о чеке, а сайт должен зафиксировать информацию.

Параметры передаются в теле запроса, список представлен в следующей таблице:

В ответ на запрос система ожидает получить ответ в JSON формате с обязательным параметром code:

Код определяет результат обработки сервером ТСП уведомления о чеке и может принимать единственное значение:

Taxationsystem

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

Vatrate

Архитектура

API использует REST архитектуру. Параметры передаются методом POST в формате JSON, кодировке UTF-8 с обязательным указанием заголовка Content-Type: application/json.

Ответ система выдает в JSON формате, который как минимум включает в себя два параметра: Success и Message:

Первый параметр указывает на результат выполнения запроса – успешно или нет, второй может содержать дополнительную информацию.

Запрос статуса чека

Метод получения статуса чека.

Запрос статуса чека коррекции

Метод получения статуса чека.

Идемпотентность api

Идемпотентность — свойство API при повторном запросе выдавать тот же результат, что на первичный без повторной обработки. Это значит, что вы можете отправить несколько запросов к системе с одинаковым идентификатором, при этом обработан будет только один запрос, а все ответы будут идентичными. Таким образом реализуется защита от сетевых ошибок, которые приводят к созданию дублированных записей и действий.

Для включения идемпотентности необходимо в запросе к API передавать заголовок с ключом X-Request-ID, содержащий уникальный идентификатор. Формирование идентификатора запроса остается на вашей стороне — это может быть guid, комбинация из номера заказа, даты и суммы или любое другое значение на ваше усмотрение.

Каждый новый запрос, который необходимо обработать, должен включать новое значение X-Request-ID. Обработанный результат хранится в системе в течение 1 часа.

Изменение состояния кассы

Метод ручного управления состоянием кассы.
Касса может быть принудительно выключена (отправлена на техобслуживание) и включена (введена в эксплуатацию).

Как узнать информацию про состав счёта, который я получил от ооо «клаудкассир»?

Этот вопрос нужно адресовать менеджеру, ведущему Ваш пакет (бухгалтерия ООО «Клаудкассир» не владеет информацией о выставляемых партнёрам счетах).

Коды временных зон

В таблице ниже представлены коды временных зон для преобразования времени.

Коды ошибок

В таблице ниже представлены коды ошибок при формировании онлайн-чека.

Коды предупреждений

В таблице ниже представлены возможные коды предупреждений при попытке формирования чека, которые могут блокировать пробитие чека (в этом случае в ответе присутствует поле Warning с рекомендацией решения проблемы)

Момент отправки чека

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

На какую сумму выставляется закрывающий документ в случае, если услуга оказывалась не полный календарный месяц (первый/ последний месяц сотрудничества)?

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

Онлайн-касса

Мы используем кассы “MicroPay-ФАС” и “MicroPay-ФС” с подключением к любому оператору фискальных данных.

Операторы фискальных данных

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

Отправка покупателю онлайн-чека

На выбор покупателя кассовый чек необходимо отправить в письме на e-mail адрес или в СМС (Viber/WhatsApp/Telegram) сообщении на номер телефона. При формировании корректного запроса на отправку чека, при условии передачи e-mail адреса или номера телефона покупателя, или при самостоятельном создании чека из личного кабинета — все необходимые реквизиты система передает в уведомлении Receipt.

Получение данных кассы

Метод получения данных кассы.

Получение данных чека

Метод получения детализации чека.

Получение данных чека коррекции

Метод получения детализации чека.

Порядок подключения

Для подключения услуги онлайн-фискализации необходимо:

• Подключиться к сервису онлайн-фискализации CloudKassir.
• Получить квалифицированную электронную подпись для работы с сайтом ФНС.
• Зарегистрироваться в личном кабинете налоговой службы:
  — для юридических лиц
  — для индивидуальных предпринимателей
• Заключить договор на онлайн-фискализацию с CloudKassir.

После подписания договора и оплаты счета вам будут предоставлены номер ККТ и ФН для регистрации в ФНС.

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

{"Inn":"7708806062",//ИНН"InvoiceId":"1234567",//номерзаказа,необязательный"AccountId":"user@example.com",//идентификаторпользователя,необязательный"Type":"Income",//признакрасчета"CustomerReceipt":{"Items"://товарныепозициии[{"label":"Наименование товара 1",//наименованиетовараилиуслуги"price":100.00,//цена"quantity":1.00,//количество"amount":100.00,//сумма"vat":0,//ставкаНДС"method":0,//тег-1214признакспособарасчета-признакспособарасчета"object":0,//тег-1212признакпредметарасчета-признакпредметатовара,работы,услуги,платежа,выплаты,иногопредметарасчета"measurementUnit":"шт"//единицаизмерения},{"label":"Наименование товара 2",//наименованиетовараилиуслуги"price":200.00,//цена"quantity":2.00,//количество"amount":300.00,//суммасоскидкой25%"vat":10,//ставкаНДС"method":0,//тег-1214признакспособарасчета-признакспособарасчета"object":0,//тег-1212признакпредметарасчета-признакпредметатовара,работы,услуги,платежа,выплаты,иногопредметарасчета"measurementUnit":"шт",//единицаизмерения"excise":0.01,//тег-1229суммаакциза"countryOriginCode":"156",//тег-1230цифровойкодстраныпроисхождениятоваравсоответствиисОбщероссийскимклассификаторомстранмира3симв."customsDeclarationNumber":"54180656/1345865/3435625/23",//тег-1231регистрационныйномертаможеннойдекларации32симв."ProductCodeData"://данныемаркировкитовара{"CodeProductNomenclature":"3031303239303030303033343....a78495a4f6672754744773d3d"//HEXпредставлениештрих/баркодамаркировкицеликом(ТолькодлякассМикропэй)},"markPartQuantity"://дробноеколичествомаркированноготовара{"numerator":1,"denominator":4},"rawMarkCode":"010460043993125621JgXJ5.Tu001d8005112000u001d930001u001d923zbrLA==u001d24014276281","groupSeparator":"u001d"},{"label":"Наименование товара 3",//наименованиетовараилиуслуги"price":300.00,//цена"quantity":3.00,//количество"amount":900.00,//сумма"vat":20,//ставкаНДС"method":0,//тег-1214признакспособарасчета-признакспособарасчета"object":0,//тег-1212признакпредметарасчета-признакпредметатовара,работы,услуги,платежа,выплаты,иногопредметарасчета"measurementUnit":"шт",//единицаизмерения"AgentSign":6,//признакагента,тегОФД1222"AgentData"://данныеагента,тегофд1223{"AgentOperationName":null,//наименованиеоперациибанковскогоплатежногоагентаилибанковскогоплатежногосубагента,тегОФД1044"PaymentAgentPhone":null,//телефонплатежногоагента,тегОФД1073"PaymentReceiverOperatorPhone":null,//телефоноператорапоприемуплатежей,тегОФД1074"TransferOperatorPhone":null,//телефоноператораперевода,тегОФД1075"TransferOperatorName":null,//наименованиеоператораперевода,тегОФД1026"TransferOperatorAddress":null,//адресоператораперевода,тегОФД1005"TransferOperatorInn":null//ИННоператораперевода,тегОФД1016},"PurveyorData"://данныепоставщикаплатежногоагента,тегОФД1224{"Phone":" 74951234567",//телефонпоставщика,тегОФД1171"Name":"ООО Ромашка",//наименованиепоставщика,тегОФД1225"Inn":"1234567890"//ИННпоставщика,тегОФД1226}}],"calculationPlace":"www.my.ru",//Местоосуществлениярасчёта"taxationSystem":0,//системаналогообложения; необязательный, если у вас одна система налогообложения"email":"user@example.com",//e-mailпокупателя,еслинужноотправитьписьмосчеком"phone":"",//телефонпокупателявлюбомформате,еслинужноотправитьсообщениесоссылкойначек"customerInfo":"",//тег-1227Покупательнаименованиеорганизацииилифамилия,имя,отчество(приналичии),серияиномерпаспортапокупателя(клиента)"customerInn":"7708806063",//тег-1228ИННпокупателя"isBso":false,//чекявляетсябланкомстрогойотчётности"AgentSign":null,//признакагента,тегОФД1057"amounts":{"electronic":1300.00,//Суммаоплатыэлектроннымиденьгами"advancePayment":0.00,//Суммаизпредоплаты(зачетомаванса)(2знакапослезапятой)"credit":0.00,//Суммапостоплатой(вкредит)(2знакапослезапятой)"provision":0.00//Суммаоплатывстречнымпредоставлением(сертификаты,др.мат.ценности)(2знакапослезапятой)},"customerBirthday":"1992-12-26","customerStateCode":"443","customerDocType":"04","customerDoc":"Some doc value","customerPlace":"Kazan city","userRequisiteData":{"requisiteKey":"key string","requisiteValue":"value string"},"operationReceiptRequisite":{"operationIdentifier":7,"operationDate":"2022-03-21","operationData":"some data"},"industryRequisiteCollection":[{"code":"012","documentDate":"2022-03-21T11:29:26.714Z","documentNumber":"doc number value","requisiteValue":"requisite value"}]}}

Формирование чека является асинхронной операцией, поэтому в ответ на запрос API система сообщает, что чек поставлен в очередь и будет обработан кассой в течение нескольких секунд. Для получения результата операции, вы можете включить Receipt уведомление в личном кабинете. При постановке чека в очередь, ему присваивается уникальный идентификатор.

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

Пример ответа:запрос принят успешно (но имеется сообщение требующее внимания):

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

В случае ошибки в поле Model возвращается объект с полем ErrorCode (см. справочник)

Принцип работы и проверка уведомлений

Параметры передаются методом POST или GET в теле запроса в формате «ключ=значение».

Сводка изменений

Версия 3.3.2 от 21.03.2022

В этом разделе отражены изменения документа, внесенные с 18.11.2020 года.

Способ 1 – посредством эдо

1. Вы уже работаете с ЭДО

1.1. Если Вы уже получали от нас закрывающие документы по ЭДО:

1.2. Если ранее Вы не получали от нас закрывающие документы по ЭДО

2. Вы планируете начать работу с ЭДО

• Подключите этот сервис через любого оператора ЭДО (для ускорения работы с нами рекомендуем выбрать Контур.Диадок).
• Следуйте инструкции из п. 1.2 выше.

Стоимость

Стоимость услуг по онлайн-фискализации и сопровождению можно узнать на сайте CloudKassir и/или уточнить у менеджера.

Тестирование онлайн-чека

При работе в тестовом режиме кассовые чеки будут формироваться в демонстрационной ККТ с отладочным фискальным накопителем. После получения доступа в личный кабинет запросите у вашего персонального менеджера подключение тестовой кассы.

Тестовый метод

Для проверки взаимодействия с API можно вызвать тестовый метод.

Тип уведомления

В таблице ниже представлены тип уведомления.

Условия успешного создания чека

• в чеке есть хотя бы одна позиция;
• во всех позициях указано наименование;
• цена и сумма позиции не отрицательная;
• общая сумма всех позиций больше нуля;
• входная строка наименования товара длиной не более 128 символов, более длинные строки будут обрезаны;
• указанная система налогообложения должна совпадать с одним из вариантов, зарегистрированных в ККТ;
• числовые значения переданы с точностью не более двух знаков после запятой;
• передан ИНН, если он требуется в документации.

Фз-54

Закон 54-ФЗ “О применении контрольно-кассовой техники” с изменениями от 03.07.2022 предписывает интернет-сервисам при осуществлении расчетов с использованием электронного средства платежа (в т.ч. банковской картой) использовать контрольно-кассовую технику (ККТ) и отправлять покупателю электронный чек в момент расчета.

Фискализация кассы

Метод перевода интернет-кассы в фискальный режим работы (первичная регистрация).

Формирование кассового чека

Метод формирования кассового чека.

Формирование чека коррекции

Метод формирования чека коррекции.

Cloudkassir: аналоги, отзывы и интеграции с другими сервисами (март 2022)

Cloudkassir – отзывы экспертов и пользователей