На сегодня уже готов обмен данными товаров и категорий, в ближайших планах — получение заказов. Сервис написан на Go, ставится на сервер, рядом с сайтом. У сервиса настраивается доступ к базе данных OpenCart и порт на котором он слушает запросы. Авторизация возможна через токен, который вписывается в конфиг, или через токен, который настраивается в самом OpenCart — в админке, в разделе настроек API.

Из плюсов, которые я вижу в сравнении с родным API: скорость работы, сервис отделен от сайта и не грузит Апач, или на чем крутится сайт, данные валидируются и, если что-то не так, приходит ошибка, о результате загрузки приходит статус — успех или нет, текст ошибки, если она есть.

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

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

Ссылка на GitHub: https://github.com/ruslan-hut/ocapi

Событие, на которое нужно подписаться: ua.com.programmer.qrscanner.BARCODE_SCANNED

Пример того, как выглядит получение данных по подписке на событие:

class BarcodeReceiver : BroadcastReceiver() {
    override fun onReceive(context: Context, intent: Intent) {
        if (intent.action == "ua.com.programmer.qrscanner.BARCODE_SCANNED") {
            val barcodeValue = intent.getStringExtra("BARCODE_VALUE")
            val barcodeFormat = intent.getStringExtra("BARCODE_FORMAT")
            // Handle the received barcode data
            Toast.makeText(context, "Scanned: $barcodeValue ($barcodeFormat)", Toast.LENGTH_LONG).show()
        }
    }
}

Чтобы событие пришло, в манифесте нужно оформить подписку:

<receiver android:name=".BarcodeReceiver">
    <intent-filter>
        <action android:name="ua.com.programmer.qrscanner.BARCODE_SCANNED" />
    </intent-filter>
</receiver>

Напоминаю, что такое QR сканер: приложение открывает при запуске экран камеры и ищет в кадре штрих-коды, QR коды и прочие форматы. Анализ изображения делает Google ML-kit, это библиотека с машинным обучением, какая то часть библиотеки тренируется на входящих данных, то есть, в теории, считывание однотипных данных должно со временем улучшаться. Побочный эфект использования ML — хорошие результаты получаются на хорошем железе, слабый телефон может туго соображать.

Ссылка на приложение на маркете: QR сканер.

Код приложения открыт, можно использовать его как пример реализации сканера в своем приложении. Репозиторий приложения: https://github.com/ruslan-hut/QRScan

Как это работает?

Основная идея проста: сервис взаимодействует с Telegram и имеет собственный API к которому может обращаться 1С, может быть развернут локально или в облаке. Главное отличие от реализации рассылки непосредственно в конфигурации 1С — это возможность обращаться к сервису из нескольких баз. То есть несколько независимых источников могут делать рассылку в одного и того же бота в Телеграм. При этом управление пользователями, подписка-отписка — на стороне сервиса. Алгоритм работы:

• В 1С формируется сообщение, которое нужно отправить.
• POST-запросом передает его в API сервиса.
• Сервис автоматически отправляет уведомление через Telegram-бота подписчикам.

Ключевые особенности:

• Минимальные требования — сервис не требует сложной интеграции.
• Поддержка всех версий 1С — работает даже на старых конфигурациях (например, 7.7).
• Гибкость развертывания — можно запустить на любой ОС (Windows, Linux, macOS).
• Низкая нагрузка на систему — сервис написан на Go, что обеспечивает высокую производительность.
• Безопасность — отправка сообщений осуществляется с авторизацией по токену.

Возможности применения:

• Оповещения об ошибках и сбоях: сервис может автоматически отправлять уведомления об ошибках в журнале событий 1С в Telegram.
• Сообщения пользователям: можно использовать для рассылки важных уведомлений сотрудникам.
• Оповещения о статусе заказов, платежей и других событиях в бизнес-процессах.
• На что еще хватит фантазии.

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

Репозиторий проекта на GitHub: https://github.com/ruslan-hut/mittere

Последовательность действий такая:

• сгенерировать код который будет использоваться как граница блоков данных, boundary; разделитель будет состоять из двух тире, префикса и этого кода
• данные — пары ключ-значение, записать в тело, разделяя строками с разделителем, внутри блока данных записывается имя данных и, через пустую строку, значение
• последний разделитель записать с добавлением двух тире в конце
• посчитать размер тела и сформировать заголовки, в заголовке нужно указать код, сгенерированный на первом шаге
• отправить запрос

Теперь то же самое, в виде кода:

Function PostFormData(Conn, Path, Data, StatusCode=0, Err=Undefined) Export
	
	Err = Undefined;

	StatusCode = 0;
	
	If TypeOf(Data) <> Type("Structure") Then
			
		Err = "Unsupported form data for POST request";
		Return "";
	
	EndIf;
	
	Boundary = "Boundary" + StrReplace(String(New UUID()), "-", "");
	Splitter = "--" + Boundary;
	
	Body = New MemoryStream();
	Writer = New DataWriter(Body);
	For Each Param In Data Do
	
		Writer.WriteLine(Splitter);
		Writer.WriteLine("Content-Disposition: form-data; name=""" + Param.Key + """");
		Writer.WriteLine("");
		Writer.WriteLine(Param.Value);
	
	EndDo; 
	Writer.WriteLine("" + Splitter + "--");
	
	Writer.Close();
	Size = Format(Body.Size(), "NG=0");
	
	BinaryData = Body.CloseAndGetBinaryData();
	
	Headers = New Map;
	Headers.Insert("Content-Type", "multipart/form-data; boundary=" + Boundary);
	Headers.Insert("Content-Length", Size);
	
	Req = New HTTPRequest(Path, Headers);
	Req.SetBodyFromBinaryData(BinaryData);
		
	Try
	
		Resp = Conn.POST(Req);
	
	Except
		
		Err = ""+Path+": "+BriefErrorDescription(ErrorInfo());
		Return "";
	
	EndTry;
	
	StatusCode = Resp.StatusCode;
	
	Return Resp.GetBodyAsString();

EndFunction // PostFormData()

Функция принимает объект HTTPСоединение, путь и данные в виде структуры. Переменные StatusCode и Err нужны чтобы вернуть статус ответа и ошибку если что то пошло не так. Генерируется код на основании которого составляется разделитель Splitter, затем, с помощью объекта MemoryStream (ПотокВПамяти) записывается тело запроса.

В 1С 7.7 такого простого способа нет. Когда мне это было нужно, я добавил отправку мультипарт данных через вспомогательное внешнее приложение (ссылка).

Принцип работы простой. Нужно положить рядом с программой конфиг, в котором один параметр: base_url, это корневой адрес сервера куда будем делать запрос. При запуске нужно указать два ключа: url и method, это адрес ресурса и имя метода. Программа выполнит запрос, полученные данные пересоберет в CSV и значения перекодирует в кодировку Windows-1251, результат будет сохранен в файл output.csv. Чтобы отправить что-то, нужно перед запуском сформировать CSV в вин-кодировке и положить в файл с именем input.csv рядом с программой. При выполнении POST или PUT запроса, файл будет преобразован в JSON, utf8 и передан на сервер.

// пример выполнения POST запроса
call.exe -url=api/1c/product -method=POST

// для выполнения GET запроса параметр method можно не указывать
call.exe -url=api/1c/catalog

Если нужна авторизация, поддерживается Bearer токен, в заголовке запроса. Токен нужно добавить в конфигурацию — параметр bearer_token. Пример файла конфигурации и запросов есть в репозитории на GitHub.

Вот и все. Напомню, что по стандарту CSV должен содержать первую строку с именами полей, дальше строки с элементами данных. Ну и на текущей стадии это не совсем универсальное решение, я его использую на конкретном API и, может, не учитываю каких-то нюансов. Если это еще кому-то пригодится и будут идеи, пишите.

• Наименование: произвольное название настроек, оно будет видно в заголовке меню и при выполенении обмена данными.
• Тип подключения: HTTP service для работы по HTTP или HTTPS протоколу.
• Адрес сервера: IP адрес или имя сервера.
• Имя базы данных: имя под которым база данных опубликована на веб-сервере.
• Имя пользователя: имя пользователя для авторизации на веб-сервере.
• Пароль: пароль для авторизации на веб-сервере.

Если сервером базы данных выступает 1С, именем пользователя и паролем будут учетные данные пользователя для входа в базу 1С. В общем случае с помощью указанных имени-пароля выполняется Basic-авторизация. Если для доступа к серверу авторизация не нужна, имя и пароль нужно оставить пустыми.

Для подключения по протоколу HTTPS нужно указать протокол в адресной строке, а если используется нестандартный порт, его тоже нужно указать в строке адреса:

https://my.test.server:8000

Также возможно указать полный путь к публикации, например:

https://my.test.server:8000/db/base

в таком случае «Имя базы данных» нужно оставить пустым.

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

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

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

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

Чеки, оформленные на телефоне можно просматривать и получать копии, для этого добавлен новый пункт в меню заказа — Просмотр чека. Стандартными средствами телефона можно отправить копию чека через мессенджер или электронную почту.

Немного технических подробностей. При обмене, от сервера, Агент должен получить в составе опций новые параметры:

• fiscalNumber — фискальный номер, для Чекбокса это номер лицензии кассы с которой будет работать телефон
• fiscalCashier — номер кассира, для Чекбокса — пин код кассира
• fiscalDeviceId — идентификатор устройства, должен быть уникальным для каждой кассы
• fiscalProvider — идентификатор сервиса фискализации, в текущей версии возможено только значение «Checkbox»

Кроме этих параметров добавлен новый набор данных — paymen_types, он содержит записи с доступными для пользователя типами оплаты. Тип оплаты это объект со следующими полями:

• payment_type — код типа оплаты, для наличного расчета должен начинаться с «CASH», все другие будут считаться безналичными при регистации чека
• is_fiscal — 1 или 0, признак необходимости регистрации фискального чека
• is_default — 1 или 0, тип оплаты по умолчанию для нового документа
• description — строковое представление для пользователя

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

Формируемые чеки и отчеты запрашиваются из сервиса в виде файлов изображений PNG и при получении выводятся на просмотр стандартными средствами телефона, например через Галерею Google фото.

Расскажу из чего состоит реализация на стороне 1С.

В HTTP сервис нужно добавить новый шаблон, например «/print/{documentId}», по такому пути телефон будет запрашивать печатную форму и передавать идентификатор документа.

По полученному идентификатору необходимо найти документ и вызвать стандартную процедуру печати — сформировать табличный документ. Здесь, при необходимости, можно предусмотреть печать какой-то определённой печатной формы, например с наложенным изображением подписи-печати. Табличный документ теперь можно сохранить в виде временного файла, файл преобразовать в текст с помощью кодировки Base64 и этот текст вставить в поле JSON ответа. Вот пример кода, основные операции выделены рамкой.

В этом примере Результат — это структура, которая затем преобразуется в JSON и передается в ответ на запрос от телефона.

Это пример ответа, который, в качестве теста, легко запросить через обычный браузер:

Полученные на телефоне данные файла легко преобразуются назад, в обычный файл, стандартными библиотеками. Приведенный пример кода работает в конфигурации Простой учет, посмотреть, как это работает на практике, можно в приложении Агент, в документе Заказ добавлена кнопка меню «Печать».

Чтобы обмен изменениями работал, необходимо следующее:

• в составе опций передать на устройство параметр differentialUpdates = true
• при поступлении от Агента запроса get с типом данных diff сформировать и отправить данные с изменениями

Для данных с изменениями поддерживается пакетная передача, если за один раз передаются не все данные, нужно передать параметр more=[НомерЭлемента], где НомерЭлемента больше нуля и будет добавлен к следующему запросу от устройства.

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

Обратите внимание, что в обработке выгружаются только сведения об основных начислениях, нет данных о начисленных больничных или отпускных, нет выплат частным предпринимателям в форме 1ДФ. Эти данные можно добавить вручную перед сдачей отчета.

02.02.2023: Выгрузка файлов обновлена, изменены коды схем XML.

Объединенная отчетность ЕСВ и 1ДФ
esv4df-2023.zip
Version: 2023.1

42.8 KiB
Загрузок: 18
Детали

Обработка для выгрузки данных по начисленной зарплате в новый объединенный отчет ЕСВ и 1ДФ. Полученные из обработки XML файлы можно загрузить в кабинет плательщика или любую программу для сдачи отчетности - Медок, Соната и пр.

Автор:	Руслан Хут
Платформы:	1C 7.7
Категория:	Бухгалтерский учет для Украины
Лицензия:	Freeware
Дата:	2 февраля, 2023