Онлайн-кассы и электронные чеки

Начиная с версии 5.8, модуль «Приём платежей» содержит раздел «Кассы и чеки» для интеграции системы с различными сервисами аренды контрольно-кассовых машин (ККМ), появившимися в связи с началом действия закона 54-ФЗ с 1 июля 2017 года (подробнее об этом можно прочитать на сайте 54-fz.ru).

Кроме прямого взаимодействия системы управления с покупными или арендными кассами, возможен способ работы через платежные системы, поддерживающие онлайн-кассы. О настройке интеграций с платежными системами читайте в разделе Настройка платежей.

В меню модуля имеются пункты «Кассы» для настройки касс и «Чеки» для просмотра информации о чеках и операций с ними.

Кассы

На вкладке «Кассы — Настройки» предлагается задать общие настройки для кассовых сервисов.

• Выставлять чеки  — использовать ли функционал интеграции с кассовыми сервисами. Поскольку с 1 июля 2017 года законодательство обязывает все интернет-магазины выписывать чеки при онлайн оплате, необходимо оставить настройку включенной, если только ваш магазин не находится вне правового поля Российской Федерации.
• ИНН  — укажите ИНН.
• Система налогообложения  — выберите систему налогообложения из представленных вариантов.
• Используемый кассовый сервис  — выберите кассовый сервис, с которым Вы заключали договор и который хотите использовать для передачи данных платежей.

Если все настройки заполнены, вы увидите ссылку «К настройкам кассового сервиса». Пройдите по ней и укажите настройки в соответствии с данными, предоставленными сервисом.

АТОЛ Онлайн

Сайт сервиса: online.atol.ru

Чтобы подключить сервис, необходимо оформить подключение к кассе или кассовой ферме на сайте АТОЛ онлайн и заполнить данные для подключения в настройках кассового сервиса.

Класс интеграции с сервисом: nc_payment_register_atol

KKM Server

Сайт сервиса: kkmserver.ru/KkmServer

Чтобы подключить сервис, необходима подключенная и настроенная касса, которая поддерживается сервисом (список поддерживаемых устройств на официальном сайте), а также установленная и настроенная на работу с этой кассой программа «ККМ web-сервер», последнюю версию которой можно скачать на официальном сайте.

На компьютере, к которому физически подключена касса, устанавливается программа «ККМ web-сервер». С сервера на компьютер с кассой прокладывается соединение так, чтобы магазин, расположенный на сервере, мог отправлять «ККМ web-серверу» запросы на печать чеков.

Если у компьютера, к которому подключен кассовый аппарат, нет постоянного публичного IP-адреса, а также для безопасности можно о настроить подключение через VPN-туннель между сервером и кассовым компьютером (например, при помощи программы SoftEther VPN).

Настройки кассового сервиса:

Класс интеграции с сервисом: nc_payment_register_kkmserver

Штрих-М: Чекопечать

Сайт сервиса: shtrih-m.ru

Чтобы подключить сервис, необходима подключенная и настроенная касса, которая поддерживается сервисом (сервис поддерживает кассы как моделей Штрих, так и Атол), установленная и настроенная на работу с этой кассой программа "Штрих‑М: Чекопечать".

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

Для ее корректной работы необходима настроеная папка, общая между сервером, где установлен интернет-магазин, и компьютером, к которому подключена касса. Сделать это можно настроив туннель соединения между сервером и кассовым компьютером через VPN, например, при помощи программы SoftEther VPN

Если вы выбрали печать чеков при помощи кассового сериса Штрих, данные для печати чеков будут сохраняться в папке /netcat_files/checks/. Именно она и должна быть настроена как общая.

Класс интеграции с сервисом: nc_payment_register_shtrih

E-COM kassa

Сайт сервиса: www.ecomkassa.ru

Чтобы начать пользоваться сервисом, необходимо зарегистрироваться на сайте www.ecomkassa.ru и приобрести онлайн-кассу (Штрих или Атол) в личное пользование.

Класс интеграции с сервисом: nc_payment_register_ecomkassa

CloudKassir

Сайт сервиса: cloudkassir.ru

Порядок подключения: https://developers.cloudkassir.ru/#poryadok-podklyucheniya

Класс интеграции с сервисом: nc_payment_register_cloudkassir

КОМТЕТ Касса

Сайт сервиса: kassa.komtet.ru

Сервис предоставляет возможность работать с кассами в собственности от разных производителей и предоставляет услуги по аренде касс.

Ознакомиться с доступными вариантами решений можно в разделе «Интеграция».

Класс интеграции с сервисом: nc_payment_register_provider_komtetkassa

Чеки

На странице «Чеки» можно увидеть список всех проведённых чеков.

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

Чеки, проведенные с ошибками, выделены в таблице красным цветом. Текст ошибки и другие данные, которые вернул сервер кассового сервиса, можно уточнить на странице просмотра информации о чеке или вкладке «Журнал событий».

Журнал событий

На вкладке «Журнал событий» представлен список всех событий, относящихся к проведению чеков. События, относящиеся к ошибкам проведения чеков, подсвечены красным цветом, а сообщение содержит полный ответ сервера.

Добавление пользовательских сервисов

В системе существует возможность добавления собственных кассовых сервисов. Чтобы это сделать, необходимо:

• Создать класс, наследующий nc_payment_register_provider, и организовать его подключение при необходимости.
  В названии класса используйте префикс, уникальный для разработчика класса (например, название компании-разработчика или имя сайта). Далее для примера будет использоваться название класса my_register_provider_test.
• Добавить новый элемент в список «Кассы» (Classificator_PaymentRegister), указав в поле Дополнительное значение имя класса для интеграции с кассовым сервисом (например, my_register_provider_test).

Структура класса:

<?php

class my_register_provider_test extends nc_payment_register_provider {

    /**
     * @var array массив с перечислением параметров кассового сервиса
     *   [ название_настройки => описание ]
     *   Для названий настроек (ключ массива) используйте префикс
     *   'MyCompany_PaymentRegister' (вместо 'MyCompany' подставьте префикс
     *   разработчика класса).
     *   Указанные в self::$settings параметры можно будет настроить в панели
     *   управления. Значения можно получить внутри класса при помощи метода
     *   get_setting(), например:
     *   $this->get_setting('MyCompany_PaymentRegisterTestFirstParam');
     */
    static protected $settings = array(
        'MyCompany_PaymentRegisterTestFirstParam' => 'Параметр 1',
        'MyCompany_PaymentRegisterTestAnotherParam1' => 'Параметр 2',
    );

    /**
     * Обработка нового чека (отправка запроса на создание чека в ККМ)
     *
     * @param nc_payment_receipt $receipt
     */
    public function process_receipt(nc_payment_receipt $receipt) {
        // Метод должен отправить в кассовый сервис данные чека.

        // Получение типа операции:
        $operation = $receipt->get('operation');
        if ($operation === nc_payment::OPERATION_SELL) {
            echo 'признак расчёта: приход';
        } else if ($operation === nc_payment::OPERATION_SELL_REFUND) {
            echo 'признак расчёта: возврат приход';
        }

        // Получение счёта, по которому осуществляется оплата:
        $invoice = $receipt->get_invoice();

        // Получение информации о покупателе:
        // — адрес электронной почты, а если его нет — номер телефона;
        //   если нет никаких контактных данных, то адрес unclaimed-receipts@домен.сайта
        $customer_contacts = $invoice->get_customer_contact_for_receipt();
        // — адрес электронной почты
        $customer_email = $invoice->get('customer_email');
        // — телефон в нормализованном международном формате (E.164 — с «+», без пробелов)
        $customer_phone = $invoice->get('customer_phone');

        // Получение списка позиций в счёте (чеке):
        $items = $receipt->get_items();
        /** @var nc_payment_invoice_item $item */
        foreach ($items as $item) {
            echo 'Название:      ' . $item->get('name');
            echo 'Цена за 1 шт.: ' . $item->get('item_price'); // с учётом скидок, включая НДС
            echo 'Количество:    ' . $item->get('qty');
            echo 'Стоимость:     ' . $item->get('total_price');
            echo 'Ставка НДС, %: ' . $item->get('vat_rate'); // NULL, если не облагается
            echo 'Сумма НДС:     ' . $item->get('total_vat_amount');
        }
    }

    /**
     * Обработка обратного запроса от кассового сервиса
     */
    public function process_callback() {
        // Если кассовый сервис выполняет обратный запрос (например, для подтверждения
        // создания чека), используйте в качестве адреса для него скрипт
        // /netcat/modules/payment/register/callback.php с необходимыми параметрами
        // (например, идентификатором чека). При запросе на данный адрес
        // будет выполнен метод process_callback() класса выбранного для сайта
        // кассового сервиса.
    }

    /**
     * Выполнение задач при периодическом запуске скрипта из планировщика:
     * например, закрытие и открытие смены, запрос статуса
     */
    public function execute_cron_tasks() {
    }

}

Пример добавления автозагрузки класса в /netcat/modules/default/function.inc.php:

<?php
// Файл /netcat/modules/default/function.inc.php
// (класс кассового сервиса — my_register_provider_test, находится в
// файле /netcat/modules/default/my_register_provider_test.php)
spl_autoload_register(function($class) {
    if ($class == 'my_register_provider_test') {
        include __DIR__ . '/my_register_provider_test.php';
    }
});